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
2026-06-02 19:19:55 +08:00
parent 071283df8f
commit a773bac28c
179 changed files with 21855 additions and 0 deletions

139
packages/cli/src/index.ts Executable file
View File

@@ -0,0 +1,139 @@
/**
* CliEntrypoint - Main air CLI entry
* DD §17. Routes argv→command. All side effects through RuntimeApp.
*
* Usage: air <command> [args...]
*
* Commands (DD §17 table):
* run [project] Start a session (spawns TUI)
* init Initialize a new project
* doctor [--fix] Run diagnostics
* provider <list|current> Show provider config (read-only)
* resume [id] Resume a session
* compact [tokens] Trigger context compaction
* history Show session history
* session <list|inspect> Manage sessions
* restore --file|--time|--session Restore state
* e2e Run validation suite
* release Release readiness check
*
* @module packages/cli
*/
import { runCommand } from './commands/run.js'
import { initCommand } from './commands/init.js'
import { doctorCommand } from './commands/doctor.js'
import { providerCommand } from './commands/provider.js'
import { resumeCommand } from './commands/resume.js'
import { compactCommand } from './commands/compact.js'
import { historyCommand } from './commands/history.js'
import { sessionCommand } from './commands/session.js'
import { restoreCommand } from './commands/restore.js'
import { e2eCommand } from './commands/e2e.js'
import { releaseCommand } from './commands/release.js'
export async function main(argv: string[]): Promise<void> {
const args = argv.slice(2)
const command = args[0]
const rest = args.slice(1)
switch (command) {
case 'run':
await runCommand(rest[0])
break
case 'init':
await initCommand(rest[0])
break
case 'doctor':
await doctorCommand({
fix: rest.includes('--fix'),
bundle: rest.includes('--bundle'),
scope: rest.find(a => a.startsWith('--scope='))?.split('=')[1]
})
break
case 'provider':
providerCommand(rest[0] || 'current')
break
case 'resume':
resumeCommand(rest[0])
break
case 'compact':
compactCommand(rest[0] ? parseInt(rest[0]) : undefined)
break
case 'history':
historyCommand()
break
case 'session':
sessionCommand(rest[0] as 'list' | 'inspect', rest[1])
break
case 'restore':
restoreCommand({
file: rest.find(a => a.startsWith('--file='))?.split('=')[1],
time: rest.find(a => a.startsWith('--time='))?.split('=')[1],
session: rest.find(a => a.startsWith('--session='))?.split('=')[1]
})
break
case 'e2e':
e2eCommand()
break
case 'release':
case 'release:check':
releaseCommand()
break
case 'help':
case '--help':
case '-h':
default:
printHelp()
break
}
}
function printHelp(): void {
console.log(`
AirCoding V1.0.0 Alpha
Usage: air <command> [args...]
Commands:
run [project] Start a session (spawns TUI)
init Initialize a new AirCoding project
doctor [--fix] Run diagnostic checks
provider list List configured providers (read-only)
provider current Show current provider/model
resume [id] Resume a previous session
compact [tokens] Trigger context compaction
history Show session history
session list List active sessions
session inspect <id> Inspect a session
restore --file=<f> Restore a file from git
restore --time=<ISO> Restore to a point in time
e2e Run end-to-end validation
release Release readiness check
help Show this help
Environment:
AIRCODING_PROJECT_ROOT Default project path
AIRCODING_PROVIDER Default AI provider
AIRCODING_MODEL Default AI model
`)
}
// Run CLI if this is the main module
if (process.argv[1]?.includes('air') || process.argv[1]?.includes('cli')) {
main(process.argv).catch((error) => {
console.error('Fatal:', error)
process.exit(1)
})
}