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
121
packages/contracts/src/tool.ts
Executable file
121
packages/contracts/src/tool.ts
Executable file
@@ -0,0 +1,121 @@
|
||||
// contracts §12 + §21 — Tool Contracts + Diagnostic Contracts
|
||||
// File: tool.ts — ToolCategory, ToolDefinition, ToolExecutor, StreamingToolExecutor,
|
||||
// ToolExecutionContext, ToolResultEnvelope, ToolEvent, ToolRegistry, Diagnostic
|
||||
// Merged: diagnostics.ts symbols per DD §3
|
||||
|
||||
import type { JsonSchema, JsonObject, UUID, ISOTimeString, SessionID, ProjectID, TaskID, AgentID, MessageID, ArtifactID, EvidenceRefID, CommandRunID } from "./ids.js"
|
||||
import type { AirError } from "./error.js"
|
||||
|
||||
// =============================================================================
|
||||
// contracts §12 — Tool Contracts
|
||||
// =============================================================================
|
||||
|
||||
export type ToolCategory =
|
||||
| "filesystem"
|
||||
| "shell"
|
||||
| "git"
|
||||
| "project"
|
||||
| "build"
|
||||
| "test"
|
||||
| "debug"
|
||||
| "static_analysis"
|
||||
| "gui"
|
||||
| "network"
|
||||
| "memory"
|
||||
| "context"
|
||||
| "artifact"
|
||||
| "permission"
|
||||
| "doctor"
|
||||
| "internal"
|
||||
|
||||
export interface ToolPermissionSpec {
|
||||
read_paths?: PathPolicy
|
||||
write_paths?: PathPolicy
|
||||
execute?: boolean
|
||||
network?: boolean
|
||||
system_sensitive?: boolean
|
||||
credentials?: boolean
|
||||
}
|
||||
|
||||
export interface PathPolicy {
|
||||
allow?: string[]
|
||||
deny?: string[]
|
||||
source?: string
|
||||
}
|
||||
|
||||
export interface ToolDefinition<I = unknown, O = unknown> {
|
||||
name: string
|
||||
version: number
|
||||
description: string
|
||||
input_schema: JsonSchema<I>
|
||||
output_schema: JsonSchema<O>
|
||||
category: ToolCategory
|
||||
permissions: ToolPermissionSpec
|
||||
streaming: boolean
|
||||
}
|
||||
|
||||
export interface ToolExecutor<I = unknown, O = unknown> {
|
||||
execute(input: I, context: ToolExecutionContext): Promise<ToolResultEnvelope<O>>
|
||||
}
|
||||
|
||||
export interface StreamingToolExecutor<I = unknown, O = unknown> {
|
||||
execute_streaming(input: I, context: ToolExecutionContext): AsyncIterable<ToolEvent>
|
||||
execute_final(input: I, context: ToolExecutionContext): Promise<ToolResultEnvelope<O>>
|
||||
}
|
||||
|
||||
export interface ToolExecutionContext {
|
||||
session_id: SessionID
|
||||
project_id: ProjectID
|
||||
task_id?: TaskID
|
||||
agent_id?: AgentID
|
||||
origin_message_id?: MessageID
|
||||
permission_template: string
|
||||
cwd?: string
|
||||
}
|
||||
|
||||
export interface ToolResultEnvelope<T = unknown> {
|
||||
status: "ok" | "error" | "cancelled"
|
||||
output?: T
|
||||
error?: AirError
|
||||
artifact_ids?: ArtifactID[]
|
||||
evidence_ref_ids?: EvidenceRefID[]
|
||||
metadata?: JsonObject
|
||||
}
|
||||
|
||||
export interface ToolEvent {
|
||||
type: "progress" | "artifact" | "result"
|
||||
payload: unknown
|
||||
}
|
||||
|
||||
export interface ToolRegistry {
|
||||
register<I, O>(definition: ToolDefinition<I, O>, executor: ToolExecutor<I, O>): void
|
||||
register_streaming<I, O>(definition: ToolDefinition<I, O>, executor: StreamingToolExecutor<I, O>): void
|
||||
call<I, O>(name: string, input: I, context: ToolExecutionContext): Promise<ToolResultEnvelope<O>>
|
||||
call_streaming<I, O>(name: string, input: I, context: ToolExecutionContext): AsyncIterable<ToolEvent | ToolResultEnvelope<O>>
|
||||
list(): ToolDefinition[]
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// contracts §21 — Diagnostic Contracts
|
||||
// =============================================================================
|
||||
|
||||
export type DiagnosticSeverity = "error" | "warning" | "info" | "hint"
|
||||
|
||||
export interface Diagnostic {
|
||||
diagnostic_id: UUID
|
||||
task_id?: TaskID
|
||||
agent_id?: AgentID
|
||||
command_run_id?: CommandRunID
|
||||
artifact_id?: ArtifactID
|
||||
language?: string
|
||||
toolchain?: string
|
||||
severity: DiagnosticSeverity
|
||||
file?: string
|
||||
line?: number
|
||||
column?: number
|
||||
code?: string
|
||||
message: string
|
||||
semantic_signature: string
|
||||
created_at: ISOTimeString
|
||||
metadata_json?: JsonObject
|
||||
}
|
||||
Reference in New Issue
Block a user