cic-mcp-session

Session-scope esemény-/idővonal-/chunk-tár és provenance réteg a CIC agent-kontextus (cic-mcp-* család) számára.

A cic-mcp-* család trust-domain rétegezésében ez a komponens egyetlen beszélgetés/session kontextusát tárolja és szolgálja ki — nem canonical tudás, nem cross-session memória.

Mi ez és mi nem

Igen:

• SessionIngressEnvelope ingest

• raw event store

• turn/timeline projection

• chunk store

• source/provenance refs

• metadata index, full-text search, vector search

• session-scope context pack

• stabil SQL/API/MCP read tools

Nem:

• canonical tudás

• shared memory

• cross-session graph

• végleges döntésbányászat

• human review nélküli promotion

A komponensek közti pontos határt lásd: CLAUDE.md.

Related MCP server: MCP Context Server

Státusz

experimental — a repo a cic-mcp-factory job-lifecycle-én keresztül épül fel, kapacitás-jobonként. A teljes session-specifikus adatfolyam (ingress envelope, Postgres write-path, projection, chunk/embedding indexelés, FTS/vektor/hibrid retrieval, MCP read tool-ok) MÁR megépült és valódi Postgres ellen bizonyítva van (~17 capability-job, lásd output/session-*-report.md):

• SessionIngressEnvelope write-path: session_store/envelope_writer.py:165 (insert_envelope) — output/session-raw-event-store-report.md

• valódi hook-producer: hooks/log-event.py:303-304 (insert_envelope()-et hív) — output/session-hook-collector-report.md

• raw event store: session_raw.envelopes (output/session-postgres-schema.sql) — ugyanaz a riport

• worker loop (turn projection + chunk indexelés, ütemezve): session_store/turn_projector.py:300 (run_projection_batch), session_store/chunk_indexer.py:378 (run_indexing_batch), session_store/worker_loop.py:65,93 (run_one_iteration/run_loop) — output/session-turn-projector-report.md, output/session-chunk-indexer-report.md, output/session-worker-scheduler-report.md

• FTS / vektor / hibrid keresés: session_api.search_context(), search_context_vector(), search_context_hybrid() (output/session-retrieval-quality-migration.sql, output/session-vector-search-api-migration.sql, output/session-hybrid-search-api-migration.sql) — output/session-vector-search-api-report.md, output/session-hybrid-search-api-report.md

• session_api réteg (timeline, context pack, status, source refs): output/session-postgres-schema.sql + output/session-source-refs-api-migration.sql — output/session-source-refs-api-report.md

• 7 tool-os MCP szerver: mcp-server/session_server.py (search_session_context + search_session_context_fts/search_session_context_vector/get_session_timeline/ get_session_context_pack/get_session_status/get_session_source_refs) — output/session-mcp-tools-report.md, output/session-mcp-tools-remaining-report.md

• host-natív MCP indítás (.venv-host, nem a Docker-builder p_venv): .mcp.json.tpl — output/session-mcp-venv-fix-report.md

A dokumentált korlátok: a fenti komponensek production reachability-je jelenleg scaffold szintű — a write-path-ot és a worker-loop-ot semmilyen permanens, deployolt infrastruktúra (cron/systemd timer) nem hívja élesben (lásd output/session-worker-scheduler-report.md "Risks"), és a cic-session MCP szerver nincs bekötve semelyik éles orchestrátor/Claude Code session .mcp.json-jába (lásd output/session-mcp-config-wiring-report.md). A status: experimental ezt a reachability-rést jelzi, NEM a session-specifikus implementáció hiányát.

Kapcsolódó dokumentáció

• cic-mcp-factory factory-docs — a komponens tervezési alapja (architecture.md, acceptance-contract.md, execution-phases.md)

• cic-mcp-knowledge — a canonical réteg, amire ez a komponens sosem promote-ol automatikusan