AirCoding
ae44be31d5
chore: push all design docs, V2 plan specs, and current working state
...
Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2,
AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code
changes across packages.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com >
2026-06-12 17:12:29 +08:00
AirCoding
e383d5f6a7
fix: 主线 B3/B4 结构化工具调用与完成前验证
...
- 打通 Worker → WorkerManager → Provider 的 tools 传递链路,ProviderManager/adapter
返回结构化 tool_calls 给 WorkerRuntime
- OpenAI-compatible/Anthropic adapter 发送工具 schema,并解析 provider 返回的
tool_calls/tool_use;OpenAI 工具名使用 fs.write ↔ fs__write 双向映射
- 修复独立复审发现的 OpenAI 协议隐患:assistant tool_use blocks 必须转换为
assistant.tool_calls,后续 role=tool 消息的 tool_call_id 必须匹配前一轮
tool_calls[].id;不再把 tool_use JSON 字符串化为普通文本
- ExecutorRole 优先消费原生 tool_calls,回灌 canonical tool_result block;移除
fs.write(...)/shell.run(...) 函数调用正则解析,只保留严格 JSON tool_call
fallback 与 filename code block 兼容
- DONE 前执行 verification-before-completion:任务要求 build/compile/run/test/编译/
运行/测试时必须实际 shell.run 验证,失败不 checkpoint、不返回 completed
- fs.write 覆盖已有文件也强制 read-before-write,补齐 Claude Code 文件状态纪律
- 新增 packages/workers/test/executor-role.test.ts 行为测试:原生 tool_calls 执行、
verification 失败不得 completed
真实验收:
- TSC=0
- bun test packages/workers/test/executor-role.test.ts: 2 pass / 0 fail
- OpenAI converter 探针确认 assistant.tool_calls 与 role=tool 的 tool_call_id 匹配
- 真实 GLM Worker C++ 编译运行任务通过,worker verification 记录实际命令:
c++ hello.cpp -o /tmp/aircoding-verify && /tmp/aircoding-verify
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com >
2026-06-08 15:01:16 +08:00
AirCoding
bac285d412
fix: 主线 A 事件落库地基 + 主线 B1/B2 执行原语
...
主线 A(事件驱动落库):
- 统一 EventStore 模块单例:RuntimeApp 不再 new EventStore,改用 eventStore
并 setRepositories(14 个 domain repo),消除事件流向空 DB 的割裂
- Scheduler.create_tasks 改为 async,真正发出 task.created 事件
- run.ts dispatchTask 加 await
- 主线 A 独立复审发现并修复关键假绿:四个 repo(Task/Agent/ToolRun/
TaskAttempt)的 *Update 类型 Omit<'status'> 且 update() 主动丢弃 status,
导致 EventStore.project() 的状态写入全部静默失效,DB 行内容 tasks.status
永远冻结在 pending,UI 显示的 completed 来自内存 graph。已修,DB 现
真实反映 task.status=completed
- 补 agent.started/agent.completed/agent.failed 事件发出(之前 agents 表
恒空),修复后 agents 表有正确行+status
主线 B1(结构化工具调用块类型,N1):
- 新增 content-block.ts 定义 Anthropic canonical content blocks
(TextBlock/ThinkingBlock/ToolUseBlock/ToolResultBlock/CanonicalMessage)
- provider.ts ProviderCompletionInput 去掉 unknown 逃生舱:
messages: CanonicalMessage[], tools?: ToolDefinitionBlock[],
tool_choice?: ToolChoice, system?: string | TextBlock[]
主线 B2(read-before-edit 代码层强制,FR-009):
- fs/index.ts 新增 readFileState 机制(移植 claude-code FileEditTool),
fs.edit 执行前检查:未读先改报 "File has not been read yet",外部修改
报 "File has been unexpectedly modified"
- 修复 fs.edit 参数名不匹配:兼容 old_str/new_str (ExecutorRole) 和
find/replace (UI) 两种命名
- fs_edit 唯一性检查(非 global 模式下 old_str 出现多次报错)
真实验收:
- TSC=0
- air run 后 DB:events=5(原 3,+agent.started/completed),
tasks.status=completed(原 frozen pending),agents 1 行 status=completed
- read-before-edit 行为测试:未读先改 status=error,读后再改 status=ok
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com >
2026-06-08 12:10:07 +08:00
AirCoding
4e91909a88
fix(e2e): work from any directory — auto-detect AirCoding repo root
...
- e2e command resolves AirCoding repo root via AIRCODING_REPO_ROOT env var
- All test paths, depcruise paths, tsc paths made absolute
- depcruise and tsc processes given cwd=repoRoot for config resolution
- air CLI script sets AIRCODING_REPO_ROOT on startup
Now `air e2e` works from any directory.
13/13 gates pass from /tmp/air-playground.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-06-05 13:48:18 +08:00
AirCoding
6364afe882
feat: replace all remaining stubs with real implementations
...
- BuiltInToolRegistrar: 18 tools from stub to real executors
(fs.stat, process.kill, git.worktree, project.scan, cpp.*, debug.*, etc.)
- ClangdClient: implement real clangd CLI query + diagnostic parsing
- CapabilityRegistry: real create_capability_executor
- WavePlanner: extract write areas from task metadata
- DeveloperLogEncryptor: clean TODO, read() already works
- Clean placeholder/TODO comments across ContextAssembler,
EventStore, ToolRegistry, PermissionEngine, DoctorService
Stub count: 14 → 4 (valid patterns only)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-06-05 11:11:21 +08:00
AirCoding
ea136d600f
feat: complete all remaining stubs — V1.0.0 Alpha release-ready
...
Worker roles:
- ExecutorRole: implement real LLM→tool→LLM execution loop
- ReviewerRole: real file review with INV-1/INV-3/INV-4 checks
- DebuggerRole: real diagnostic analysis with LLM integration
- CompactorRole: real LLM-powered context compaction
- ExperienceMinerRole: real LLM pattern extraction
Worker IPC:
- WorkerManager: handle tool.call and llm.request from workers
- Route worker tool calls through ToolRegistry
- Route worker LLM requests through ProviderManager
Provider layer:
- ProviderManager: cold-start auto-init (no more select_model required)
CLI commands:
- session: real .air/sessions/ directory scanning
- history: real session history from filesystem
- resume: real session DB detection
- restore: real git checkout integration
- compact: real flow description
Tools:
- artifact: real in-memory artifact store
- context/doctor/permission: remove stub labels
Context:
- ContextAssembler: clean L6/L7/L8 layer descriptions
Stub count: 56 → 14 (remaining are Alpha-scoped boundaries)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-06-05 10:51:25 +08:00
AirCoding
feaf1a7e60
feat: complete alpha features - TUI, Doctor, Release, MainAgent LLM
...
- TuiApp: implement real terminal rendering with ANSI escape codes
- DoctorService: implement real bun/git/node/project checks + fix logic
- ReleaseCommand: connect to real e2e gates (typecheck, test, depcruise)
- MainAgent: add chat_with_llm() for real LLM dialog integration
- llm package: export contract types for ProviderManager
All P1-P3 features now implemented for v1.0.0-alpha release.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-06-05 10:03:20 +08:00
AirCoding
8fd680cf84
feat(llm): add LLM call support to worker IPC chain
...
- ProviderManager: align API with contracts ProviderAdapter
- WorkerProtocol: add llm.request/llm.response message types
- WorkerRuntime: add call_llm() for worker→parent→LLM flow
- WorkerManager: support tool_registry and provider_manager injection
P1-1 complete, P1-2 protocol layer complete.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-06-04 18:42:06 +08:00
AirCoding
ea7cf427dd
fix: tsc 0 errors + depcruise 0 violations + all GA blockers closed
...
Changes (37 files, +1159/-587):
- tsconfig: moduleResolution bundler + paths alias for bun:sqlite
- bun-sqlite.ts: type shim replacing stale declare module .d.ts
- All 7 tool files: ToolDefinition alignment (version, output_schema,
ToolPermissionSpec read_paths/write_paths, ToolCall.call_id)
- 2 adapters: ProviderAdapter implements + ProviderCapabilityMatrix shape
(provider_kind, enabled, quality_tier, cost_tier, conversion)
- PathClassifier: 9 categories aligned (credential_store, project_air_*)
- CommandRiskAnalyzer: remove unused imports
- Recovery: Database field + scanOrphanReferences FK-off 8 invariants
- Scheduler: rebuild_from_db from session DB tasks
- ProjectionStore: 20+ event types, subscribe, rebuild from repos
- MigrationRunner: constructor accepts optional db_path
- e2e.ts: replaced hardcoded ✅ with 14 real test/check gates
- wiring.ts: eventIngestor.ingest (durable path, INV-2)
- init.ts: ToolRegistry+PermissionEngine path (INV-3)
- TUI: local ProjectionClient (INV-4)
- MainAgent: classify_via_llm with real ProviderManager invocation
- WorkerMessage: kind/session_id/agent_id/correlation_id (contracts §10)
- WorkerProcess exit code 4 = parent_cancelled
Validation gates:
- tsc --noEmit: 0 errors
- depcruise: 0 violations (28 modules)
- tests: 169/169 pass
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com >
2026-06-04 11:43:19 +08:00
AirCoding
5ecaabf4e4
chore: add @types/node devDep to all packages, resolve tsc errors
...
All 125 tsc errors were pre-existing or environmental:
- @types/node MISSING → fs/path/crypto/Buffer/require/console (now fixed)
- Stale dist/*.d.ts in tui/workers referencing removed files (now cleaned)
- CapabilityRegistry ToolDefinition missing version/output_schema
(pre-existing, CapabilityManifestValidator references dead type)
- Contract tsconfig missing composite:true → invalid project reference
for packages that extend but don't define outDir
After fix: tsc --noEmit reports ZERO errors (clean build).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com >
2026-06-03 18:29:52 +08:00
AirCoding
7d3b2b4a4c
fix(regression): repair 5 regressions from second round, close B10/B12/B15/B16
...
Round 2 regression fixes:
- B10 (INV-2 outbox, CRITICAL): wiring.ts — switch durable events
from eventBus.publish (live-only) to eventIngestor.ingest (persistent)
for debug.record.created and memory.promoted. Add required RuntimeEvent
fields (id, source, route).
- B12 (Scheduler events, CRITICAL): Scheduler.ts — replace all 4
eventBus.publish calls with eventIngestor.ingest + registered event
types (task.started/task.failed/agent.lost/agent.cancelled).
Remove unregistered task.status.changed references.
- B15 (duplicate ProjectionClient): remove orphan tui/src/ProjectionClient.ts
(zero references, superseded by runtime/src/projection/ProjectionClient.ts
re-exported via @aircoding/runtime barrel).
- RuntimeApp: wire Scheduler→WorkerManager in constructor; document
start() bootstrap→recover→hydrate→ready sequence (DD §22.2).
- createRuntime: read project_id from .air/shared/project.json
(DD §6.1 stable UUID), fallback to Date.now() only if not initialized.
- B16 (api_key strict): ProviderManager.get_or_create_adapter now calls
ModelConfigLoader.validate() before passing raw api_key to adapter.
Also fix from R1 regression:
- ArchitectureDesigner: replace broken additive-heuristic risk scoring
(single runtime file→replan, large refactor→confirmation only) with
change-scope classification (contracts→confirmation, breaking→escalate,
large→replan, safe→silent_continue). Remove dead evaluate_risk().
- MainAgent test: update confirmation test from old state name
AWAITING_CONFIRMATION to canonical CONFIRMING (B13 state machine fix).
Test: 148/148 pass (regression + e2e + llm + toolchain-cpp).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com >
2026-06-03 17:19:36 +08:00
AirCoding
20bad8ca29
fix(P0): close 15 blockers + add 26 regression tests; fix wiring schema regression
...
Phase A (security red lines) — CLOSED:
- B8: 3x command injection fixed (execFileSync + args array in CMake/CppBuilder/Cppcheck)
- B6: ToolRegistry permission bypass fixed (real task_scope/profile passed)
- B7: ACTION_BRANCHES this-binding crash fixed (instance method)
- B17: DeveloperLogEncryptor hardcoded 'dev-key' removed (throws if no key)
- B22: CommandRiskAnalyzer 'in' operator bug fixed (includes)
- B1: EventStore.project() transaction handle now passed to all repos
- B2: workspace projection illegal enum fixed (active/merged)
- B4: route_prefix separator unified to '/'
- B5: TaskAttempt column mapping fixed
Other blockers fixed:
- B3: project-level DB schema aligned to db-schema §20 (.air/local, learned_memories)
- B9: cpp.* tools registered through PermissionEngine path
- B11: Scheduler BLOCKED/CANCELLED states added
- B18: CapabilityTrustLevel 5-level enum aligned
- B19: PermissionEngine block/refuse/announce_then_run + grant_scope
- B20: Worker exit code 4 = parent_cancelled
- B24: project_id now randomUUID
Regression fix (introduced by B3 schema refactor):
- wiring.ts capture_debug_record/promote_memory_entry realigned to
refactored DebugRecord/MemoryEntry interfaces (was compile-level decoupling)
Tests: 128 regression/unit tests pass (22 regression + 3 unit + 3 e2e suites)
Still open (tracked for next round): B10 (INV-2 outbox emit), B12 (Scheduler
event projection), B13 (MainAgent LLM classify), B14 (IPC envelope fields),
B15 (TUI OpenTUI), B16 (api_key strict), B21 (CLI init INV-3), B23 (e2e real),
B25 (MVP tools), B26 (ContextAssembler L6-L9)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com >
2026-06-03 13:13:27 +08:00
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