Repository navigation
v5.4.5
CLI 契约收敛版(批次 B/C)+ 外部 Agent 授权档位——旁挂 agent 免确认通道打通,CLI 命令形态/文档/审计三线对齐。
新增:外部 Agent 授权档位 --grant
- 三档授权(readonly / semi / full)(里程碑 5.4.5-AC-grant):程序内
full_auto只作用于AgentSession,MCP 路径原无授权入口 ⇒ 旁挂 agent 无法声明「已获完全授权」,批量作业需十余次人工确认。新增--grant命令行 /AUTOLINK_AGENT_GRANT环境变量(优先级:命令行 > 环境变量 > 默认semi)。readonly:仅 AUTO 放行;semi:AUTO+NOTIFY 放行、CONFIRM 走门禁;full:全放行。- 铁律(AG-3):
full不豁免编译态屏蔽规则 —— 授权管「要不要确认」,模式管「可不可见」,二者正交。 - fail-fast:
full+ 无--audit路径 ⇒ 拒绝启动(授权必须可追溯);授权写入审计(granted/granted-full/grant-denied)。 - 落点:
mcp_server/manager.py(GRANTS/_permission_gate重写 /enable(grant=))+mcp_server/run.py(--grant)。
行为变更(批次 B:命令形态与文档对齐)
- 三段式 action → 真·多级子命令树(AL-CLI-O6):
aidc:project:*由aidc:project:create冒号形态改为aidc project create;plan:aidc:*→plan aidc export|import(plan aidc自身仍是可执行 action,前缀复用)。- 关键修复:
parser._subparsers是_ArgumentGroup(非_SubParsersAction),取子命令表须走._subparsers._group_actions[0].choices(旧._name_parser_map恒空 ⇒ 域帮助一直打印不出)。 - 67 action 全量解析 0 错配。
- 受影响:脚本中
aidc:project:create/plan:aidc:export需改为多级命令形态。
- 关键修复:
修复(批次 C:能力对齐)
- 审计
ok语义修正(AL-P1-2):execute()的audit_log(..., ok=True)由「handler 未抛异常即成功」改为按classify_exit(result)判定 ⇒ 失败体({"error":...}/success:false/ 空结果)正确记ok:false+error。此前审计日志将业务失败记成成功,失真。 ACTION_PARAM_SCHEMA补全(AL-P1-4):由 45/67 补至 67/67,补齐ai:*/aidc:project:*/plan:aidc*/skills:*/rack:optimize/share:snapshot/design:from-gpus/cli:info的具名 flag(此前只能走通用--json)。- 注意:
plan:aidc:export的导出格式改名--export-format(避免与 CLI 全局输出形态--format json/ndjson/text撞名)。
- 注意:
新增(门禁与文档)
scripts/check_cli_contract.py(AL-CLI-A5):CLI 契约守卫,四项检查:①退出码常量取值 ②禁裸sys.exit(<数字>)③docs/cli.md域表 ↔ 注册表对账(真值源engine.list_registered_actions())④三级命令文档可见。接入.github/workflows/ci.yml。docs/cli.md重写:域速查表更新为实测 24 域 67 action(原「18 域 37 action」);补三级子命令示例;审计段补ok语义修正说明。- 新增
AGENT.md/CLAUDE.md+agent-skills/(27 份) 面向旁挂 Agent 的技能包入库。 - 新增
tests/backend/test_cli_contract.py(13 用例,含负向断言)。