npm package: @futdevpro/ccap
Description: CCAP Revisioned – Agent architektúra; CLI, server, client, e2e alprojektek.
Author: Future Development Program Ltd.
Latest version: 1.1.492

# 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](__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](__specifications/agentic-system/etalon/agentic-system.canvas).

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

| Fájl | Leírás |
|------|--------|
| [technical-specifications.md](__specifications/technical-specifications.md) | Tech stack, CLI commander, NPM global, monitoring |
| [scope/mvp1-and-vertical-slice.md](__specifications/scope/mvp1-and-vertical-slice.md) | MVP1 és vertical slice hatókör |
| [TODO.md](__specifications/TODO.md) | TODO lista |
| [BACKLOG.md](__specifications/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](__specifications/system/cli-commander.md), [NPM global és telepítés](__specifications/technical-specifications.md#npm-global-és-telepítés--req-tech-003), [Setup flow](__specifications/system/setup-flow.md).

---

## 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](__documentations/plans/1.0/master-plan-1.md), [master-plan-3.md](__documentations/plans/3.0/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](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](server/package.json)** | Backend (Express, agent, LLM, messaging, tools). |
| **[client/package.json](client/package.json)** | Frontend (Angular). |
| **[cli/package.json](cli/package.json)** | CLI (Commander, setup, parancsok). |
| **[e2e/package.json](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](__specifications/main.md).
- **CCAP usage:** Globális telepítés (`npm i -g @futdevpro/ccap`), majd `ccap start`; részletek: [CLI commander](__specifications/system/cli-commander.md), [Setup flow](__specifications/system/setup-flow.md).
- **Hol vannak a csomagok és scriptek:** Gyökér és alprojekt `package.json` fájlok (fenti táblázat).