Files
AirCoding/packages/runtime/src/projection/ProjectionStore.ts
AirCoding a773bac28c P0-P8: Full V1.0.0 Alpha implementation + audit reports
Implements 123 tasks across 9 phases (T-001..T-809) totaling 146 source files.

Monorepo (P0):
- 7-package Bun + Turborepo + TypeScript monorepo
- dependency-cruiser enforcing 7 forbidden edges + 5 deep-import rules

Contracts (P0):
- 16 type files (ids/error/event/runtime/ipc/task/worker-result/tool/artifact/evidence/project/provider/permission/ui/capability/platform)

Storage & Events (P1):
- DatabaseManager + MigrationRunner (19 tables, 22 indexes, 5 schema_meta seeds)
- 16 repositories (Repository<T,I,U> pattern, INV-1 status columns via EventStore.project only)
- EventSchemaRegistry (54 durable + 7 ephemeral), EventStore, EventBus, EventIngestor
- Project/Session/Artifact/Evidence stores + 8-step Recovery

Tools & Permission (P2):
- PathClassifier (8 categories), CommandRiskAnalyzer (10 categories), SecretRedactor
- PermissionEngine 6-layer evaluation (capability→profile→task_scope→risk→credential→user_prompt)
- ToolRegistry with 20+ tools across fs/shell/git/project/artifact/context/permission/doctor
- CapabilityManifestValidator + CapabilityRegistry

LLM & Context (P3):
- ModelConfigLoader, CapabilityMatrix, AnthropicCanonicalConverter
- AnthropicAdapter + OpenAICompatibleAdapter
- ProviderManager facade
- PromptLayerLoader (L0/L1/L3/L5), CompactionPolicy, ContextAssembler

Worker IPC & Scheduler (P4):
- WorkerProtocol (NDJSON), WorkerProcess (exit codes 0-5), WorkerManager (spawn/handshake)
- WorkerRuntime (INV-3: IPC only, no direct fs/shell/SQLite)
- 5 worker roles (Executor/Reviewer/Debugger/Compactor/ExperienceMiner)
- TaskGraph, WavePlanner, RetryPlanner, AgentMonitor, WorkspaceManager
- Scheduler (state machine), 8-step Recovery

C++ Toolchain (P5):
- DiagnosticParser, CppProjectDetector, CMakeConfigurator, CppBuilder
- CppTestRunner, CppcheckRunner, ClangdClient
- CppToolRegistrar + capability manifest

Projection & TUI (P6):
- ProjectionStore (hydrate/apply/snapshot/subscribe)
- TuiApp + 8 components (Session/Task/Agent/Tool/Diff/Evidence/Permission/Blocker/Hud)
- ProjectionClient in-process ref

Agents & Knowledge (P7):
- MainAgent, ArchitectureDesigner
- DebugKnowledgeStore + LearnedMemoryStore (single-writer, outbox model)
- Role integration wiring

CLI & Doctor & Release (P8):
- Logger + DeveloperLogEncryptor (AES-256-GCM)
- DoctorService (self_bootstrap first)
- RuntimeApp + ServiceRegistry
- 11 CLI commands: run/init/doctor/provider/resume/compact/history/session/restore/e2e/release
- CliEntrypoint + air<TODO>

Audit (in AirPlan/docs/):
- Deepseek开发阶段审计.md (97 findings)
- Opus开发阶段审计.md (140+ findings, 18 P0 blockers)
- MiniMaxM3开发阶段审计.md (18 P0 blockers, focuses on executability)
- AirPlan/TODO.md (technical debt + 42 TODOs by phase)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-02 19:19:55 +08:00

134 lines
3.3 KiB
TypeScript
Executable File

/**
* ProjectionStore - Domain projections for TUI consumption
*
* Implements contracts §17; DD §13.1.
*
* @module packages/runtime/src/projection/ProjectionStore
*/
import type { RuntimeEvent, SessionID } from '@aircoding/contracts'
export interface SessionProjection {
session_id: string
project_id: string
status: string
title?: string
tasks: TaskProjection[]
agents: AgentProjection[]
}
export interface TaskProjection {
id: string
type: string
status: string
title: string
retry_count: number
attempts: number
created_at: string
}
export interface AgentProjection {
id: string
type: string
status: string
task_id?: string
last_heartbeat?: string
}
export type ProjectionSubscriber = (projection: SessionProjection) => void
export class ProjectionStore {
private snapshot: Map<string, SessionProjection> = new Map()
private subscribers: ProjectionSubscriber[] = []
/**
* Hydrate projection from repositories.
*/
hydrate(session_id: string, data: {
session: { id: string; project_id: string; status: string; title?: string }
tasks: TaskProjection[]
agents: AgentProjection[]
}): void {
this.snapshot.set(session_id, {
session_id: data.session.id,
project_id: data.session.project_id,
status: data.session.status,
title: data.session.title,
tasks: data.tasks,
agents: data.agents
})
}
/**
* Apply an event to the projection (incrementally update).
*/
apply(event: RuntimeEvent): void {
const session_id = event.session_id
const proj = this.snapshot.get(session_id)
if (!proj) return
switch (event.type) {
case 'task.created': {
const p = event.payload as unknown as TaskProjection
proj.tasks.push(p)
break
}
case 'task.status.changed': {
const p = event.payload as { task_id: string; status: string }
const task = proj.tasks.find(t => t.id === p.task_id)
if (task) task.status = p.status
break
}
case 'agent.created': {
const p = event.payload as unknown as AgentProjection
proj.agents.push(p)
break
}
case 'agent.status.changed': {
const p = event.payload as { agent_id: string; status: string }
const agent = proj.agents.find(a => a.id === p.agent_id)
if (agent) agent.status = p.status
break
}
case 'session.status.changed': {
const p = event.payload as { status: string }
proj.status = p.status
break
}
}
this.notify(proj)
}
/**
* Get current snapshot for a session.
*/
get_snapshot(session_id: string): SessionProjection | undefined {
return this.snapshot.get(session_id)
}
/**
* Subscribe to projection updates.
*/
subscribe(subscriber: ProjectionSubscriber): () => void {
this.subscribers.push(subscriber)
return () => {
this.subscribers = this.subscribers.filter(s => s !== subscriber)
}
}
/**
* Full rebuild from DB (INV-5: from SQLite, not EventBus).
* TODO(P6): Query all repositories to rebuild projection from database state.
*/
rebuild(session_id: string): void {
// STUB: Would query SessionRepository, TaskRepository, AgentRepository etc.
}
private notify(projection: SessionProjection): void {
for (const sub of this.subscribers) {
sub(projection)
}
}
}