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>
This commit is contained in:
AirCoding
167
packages/contracts/src/worker-result.ts
Executable file
167
packages/contracts/src/worker-result.ts
Executable file
@@ -0,0 +1,167 @@
|
||||
/**
|
||||
* AirCoding Worker Result Contracts
|
||||
*
|
||||
* Implements WorkerStatus, WorkerResult, ExecutorResult, ReviewerResult,
|
||||
* DebuggerResult, CompactorResult, ExperienceMinerResult, BlockerReport,
|
||||
* Risk, FollowUpTask per interface-contracts-v1.md §11 and system-detailed-design.md §3.
|
||||
*/
|
||||
|
||||
// Import types needed for these interfaces
|
||||
import type {
|
||||
TaskID,
|
||||
AgentID,
|
||||
ArtifactID,
|
||||
EvidenceRefID,
|
||||
SummaryID,
|
||||
MessageID,
|
||||
UUID,
|
||||
} from './ids.js'
|
||||
import type { AgentType } from './runtime.js'
|
||||
import type { ArtifactRef } from './artifact.js'
|
||||
import type { EvidenceRef } from './evidence.js'
|
||||
|
||||
// Re-export for external consumers
|
||||
export type {
|
||||
TaskID,
|
||||
AgentID,
|
||||
ArtifactID,
|
||||
EvidenceRefID,
|
||||
SummaryID,
|
||||
MessageID,
|
||||
UUID,
|
||||
}
|
||||
export type { AgentType }
|
||||
export type { ArtifactRef }
|
||||
export type { EvidenceRef }
|
||||
|
||||
/**
|
||||
* Status values for worker results.
|
||||
* Per DD §22.1: status ∈ {completed, failed, blocked, cancelled}
|
||||
*/
|
||||
export type WorkerStatus = 'completed' | 'failed' | 'blocked' | 'cancelled'
|
||||
|
||||
/**
|
||||
* Result of a verification check performed by a worker.
|
||||
*/
|
||||
export interface VerificationResult {
|
||||
name: string
|
||||
status: 'passed' | 'failed' | 'skipped' | 'unknown'
|
||||
evidence_ref_ids?: EvidenceRefID[]
|
||||
notes?: string
|
||||
}
|
||||
|
||||
/**
|
||||
* Risk identified during worker execution.
|
||||
*/
|
||||
export interface Risk {
|
||||
severity: 'low' | 'medium' | 'high'
|
||||
summary: string
|
||||
}
|
||||
|
||||
/**
|
||||
* Follow-up task created as a result of worker execution.
|
||||
*/
|
||||
export interface FollowUpTask {
|
||||
title: string
|
||||
description: string
|
||||
type?: 'execute' | 'review' | 'debug' | 'compact' | 'mine_experience' | 'docs'
|
||||
}
|
||||
|
||||
/**
|
||||
* Generic worker result container.
|
||||
* Per DD §22.1: status ∈ {completed, failed, blocked, cancelled}
|
||||
*/
|
||||
export interface WorkerResult<TResult = unknown> {
|
||||
task_id: TaskID
|
||||
agent_id: AgentID
|
||||
agent_type: AgentType
|
||||
status: WorkerStatus
|
||||
summary: string
|
||||
changed_files: string[]
|
||||
diff_ref?: ArtifactID
|
||||
artifacts: ArtifactRef[]
|
||||
verification: VerificationResult[]
|
||||
risks: Risk[]
|
||||
follow_up_tasks: FollowUpTask[]
|
||||
evidence_refs: EvidenceRef[]
|
||||
result: TResult
|
||||
}
|
||||
|
||||
/**
|
||||
* Result from an Executor worker.
|
||||
*/
|
||||
export interface ExecutorResult {
|
||||
implementation_summary: string
|
||||
changed_files: string[]
|
||||
verification_commands: string[]
|
||||
}
|
||||
|
||||
/**
|
||||
* A single finding from a reviewer.
|
||||
*/
|
||||
export interface ReviewFinding {
|
||||
severity: 'low' | 'medium' | 'high'
|
||||
category: 'correctness' | 'security' | 'scope' | 'architecture' | 'test' | 'maintainability'
|
||||
message: string
|
||||
file?: string
|
||||
line?: number
|
||||
evidence_ref_ids?: EvidenceRefID[]
|
||||
}
|
||||
|
||||
/**
|
||||
* Result from a Reviewer worker.
|
||||
*/
|
||||
export interface ReviewerResult {
|
||||
verdict: 'approved' | 'changes_requested' | 'blocked'
|
||||
findings: ReviewFinding[]
|
||||
}
|
||||
|
||||
/**
|
||||
* Report documenting a blocker that prevented task completion.
|
||||
*/
|
||||
export interface BlockerReport {
|
||||
impact_level: 'implementation' | 'interface' | 'architecture' | 'product' | 'permission' | 'environment' | 'policy'
|
||||
reason: string
|
||||
required_decision: string
|
||||
options?: Array<{ label: string; tradeoff: string }>
|
||||
evidence_ref_ids?: EvidenceRefID[]
|
||||
suggested_default?: string
|
||||
}
|
||||
|
||||
/**
|
||||
* Result from a Debugger worker.
|
||||
*/
|
||||
export interface DebuggerResult {
|
||||
diagnosis: string
|
||||
root_cause?: string
|
||||
fixed: boolean
|
||||
blocker?: BlockerReport
|
||||
}
|
||||
|
||||
/**
|
||||
* Result from a Compactor worker.
|
||||
*/
|
||||
export interface CompactorResult {
|
||||
summary_id: SummaryID
|
||||
range_start_message_id?: MessageID
|
||||
range_end_message_id?: MessageID
|
||||
token_estimate_before?: number
|
||||
token_estimate_after?: number
|
||||
}
|
||||
|
||||
/**
|
||||
* A candidate memory extracted by the experience miner.
|
||||
*/
|
||||
export interface MemoryCandidate {
|
||||
candidate_id: UUID
|
||||
memory_type: 'project_rule' | 'toolchain_rule' | 'skill_update' | 'debug_experience'
|
||||
summary: string
|
||||
evidence_ref_ids?: EvidenceRefID[]
|
||||
}
|
||||
|
||||
/**
|
||||
* Result from an ExperienceMiner worker.
|
||||
*/
|
||||
export interface ExperienceMinerResult {
|
||||
candidates: MemoryCandidate[]
|
||||
}
|
||||
Reference in New Issue
Block a user