chenchenandClaude Opus 4.8
32ebc2bb6d
Bring the client-facing API doc up to parity with heicode-sub-mode-flow-spec.md. Adds the interfaces/fields the spec planned but the API layer hadn't captured: - §3.1 create body: resource_bindings (mandatory git) + git_options (base_branch/mode/allowed_paths/write_mode) + X-Idempotency-Key; mandatory-git rule. - §5.2 NEW git_ref delivery reference (provider/repo/branch/commit_sha/tag/PR/ agent_branches) — how the client learns where to git pull. §4.1 workflow now returns git_ref + per-agent current_action/branch. Fixed orphaned 5.3 block; §5 reorganized (5.1 git / 5.2 git_ref / 5.3 non-code artifacts / 5.4 retired). - §6 rewritten as "修改/重做 (baseline = git)" table (messages/execute/redo/stop), local-edits retired. - §4b NEW planned SSE contract (event envelope, event types incl delivery.pushed, Last-Event-ID reconnect, polling fallback). - §7 deploy: formalized short-lived credential lease interface (POST .../lease, TTL/revoke/approval-gate, V2-encrypted). - §8 split into 8.1 web-console (session) and 8.2 client-facing V2-signed endpoints (list/get/create/secret/delete/lease) + binding metadata + precheck. - §4 verdict rule now keyed on git_ref; §0.1 flow + success criterion updated; §11 new error codes (SUB_GIT_BINDING_REQUIRED/LEASE_*/APPROVAL_REQUIRED/ BUDGET_EXCEEDED), legacy artifact codes struck through. budget_exceeded status. All not-yet-built items are marked 🔴 so the client can pre-wire to the contract. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Heicode Docs
当前 docs/ 只保留五类主线文档：
| 文档 | 用途 |
|---|---|
heicode.md |
Heicode 当前产品定位、系统边界和架构共识 |
plan.md |
按当前共识拆出的实施计划 |
heicode-runtime-auth-newapi-secret-design.md |
用户输入、登录用户复用、NewAPI 扣费映射、Azure Key Vault 凭证托管与短期凭证注入边界 |
heicode-manager-sub-swarm-progress-checklist.md |
Heicode Manager sub 模式、瀑布/敏捷、蜂群模式的已完成/未完成/依赖/风险/下一步进度清单 |
heicode-manager-standalone-execution-plan.md |
Heicode Manager 端可独立完成任务的执行计划、顺序、验收标准和边界 |
integration/Heicode-登录接口对接文档.md |
已上线登录接口对接文档 |
integration/agent-platform-request-contract.md |
Manager 请求 Agent 平台时携带的部署、日志、监控、事件与审计接口参数 |
deployment/azure-production-deploy-guardrails.md |
Azure VM / PostgreSQL / Redis / Agent / NewAPI 生产部署前的安全守卫、环境变量注入和验证计划 |
旧 Agent API 草案、旧里程碑、旧架构说明和旧上手材料不再作为实施依据。后续文档和实现以 heicode.md 与 plan.md 为准；生产部署操作以安全守卫文档约束，且不得覆盖产品/架构主线。
代码中的过渡期命名、旧接口注释或旧 UI 文案只作为现状参考；若与 heicode.md / plan.md 冲突，应先更新实现或另行补充当前主线文档，不得恢复旧 Agent/M1-M5 草案作为依据。