@futdevpro/ccap

CCAP Revisioned

Agent-architektúra: CLI, server, client és e2e alprojektek. A projekt követelményeit és technikai leírásait a specifikációk és a dokumentációk tartalmazzák.

Belépési pont: specifikációk

Fő specifikációs fájl (mindig innen indulj):

• __specifications/main.md – A teljes specifikációs index: business requirements, agentic system, run flow, messaging, LLM, compacting, contracts, stb. Az összes al-spec erre épül.

Etalon: Az agentic rendszer vizuális referenciája: Agentic System canvas.

Egyéb fontos specifikációs fájlok:

Fájl	Leírás
technical-specifications.md	Tech stack, CLI commander, NPM global, monitoring
scope/mvp1-and-vertical-slice.md	MVP1 és vertical slice hatókör
TODO.md	TODO lista
BACKLOG.md	Backlog elemek

A részletes specifikációk (agentic loop, run flow, context, tools, contracts, compacting, messaging, LLM, system) a main.md linkjein keresztül érhetők el.

CCAP használat (usage)

A CCAP parancssori alkalmazásként használható: globális telepítés után a ccap parancs indítja a rendszert és a kliens felületet.

• Telepítés: npm i -g @futdevpro/ccap (vagy pnpm add -g @futdevpro/ccap)
• Indítás: ccap start – egyszerre elindítja a frontend-et és a szervert
• Fő parancsok:
  • ccap start / ccap stop / ccap restart – server életciklus (a restart SIGKILL-fallback + port-free poll-lal, BUG-CLI-RESTART-UPDATE-001 cycle 721)
  • ccap update – npm update -g @futdevpro/ccap + restart, visible-status output (BUG-CLI-RESTART-UPDATE-001 cycle 725)
  • ccap repair – npm-install staging-leftover (.ccap-*) takarítás, ha egy korábbi npm install ENOTEMPTY-vel megbukott (BUG-CLI-RESTART-UPDATE-001 cycle 722)
  • ccap chat / ccap config / ccap status – chat, beállítás, állapot
  • A setup flow az első futtatáskor vagy hiányzó konfig esetén automatikusan felajánlódik.

Részletes usage és parancsok: CLI commander, NPM global és telepítés, Setup flow.

Dokumentációk

• __documentations/ – Session-jellegű és tervdokumentumok.
  • devs/ – Fejlesztési jegyzetek, implementációs összefoglalók (dátumozott fájlok).
  • plans/ – Master plan-ok és phase plan-ok (1.0, 2.0, 3.0), pl. master-plan-1.md, master-plan-3.md.
  • revs/ – Review dokumentumok.
  • CHANGELOG – Lezárt backlog-itemek archívuma (ha létezik a projektben).

Projekt szerkezet és package.json-ok

A monorepo több alprojektet foglal magában; mindegyiknek saját package.json-ja van:

Hely	Leírás
package.json	Gyökér: @futdevpro/ccap, bin ccap, scriptek a client/server/cli/e2e indításához, build-hez és test-hez.
server/package.json	Backend (Express, agent, LLM, messaging, tools).
client/package.json	Frontend (Angular).
cli/package.json	CLI (Commander, setup, parancsok).
e2e/package.json	E2E tesztek.

Gyakori parancsok (gyökérből):

• pnpm prep – Függőségek telepítése
• pnpm start – Client + server együtt (concurrently)
• pnpm test – CLI + server + client tesztek
• pnpm run build – CLI + server build, majd UI build a serverhez
• pnpm run test-e2e – E2E tesztek

A pontos scriptek és opciók a fenti package.json fájlokban találhatók.

Rövid összefoglaló

• Mit csinál a projekt: Agentic rendszer (agent loop, tool calling, context, compacting), multichannel messaging (pl. Discord), CLI és web kliens.
• Honnan indulj: __specifications/main.md.
• CCAP usage: Globális telepítés (npm i -g @futdevpro/ccap), majd ccap start; részletek: CLI commander, Setup flow.
• Hol vannak a csomagok és scriptek: Gyökér és alprojekt package.json fájlok (fenti táblázat).