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 chat, ccap config, ccap status; 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).