@hunyed15/codecgc 0.1.7 → 0.1.9

package/README.md

@@ -1,204 +1,179 @@
-# CodeCGC Release v0.1.2
+# CodeCGC
 
-## 📦 发布内容
+CodeCGC 是一个以 Claude 为主控入口的多模型开发编排层，用于把需求、规划、执行、审查和验收拆成可控的协作流程。
 
-本目录包含 CodeCGC 项目的完整发布版本，已修复所有 P0/P1 优先级 bug，并完成核心优化。
+它的核心分工是：Claude 负责需求、规划、设计、文档、审查、验收和工作流状态；Codex 负责后端实现和后端测试；Gemini 负责前端实现和前端测试。CodeCGC 通过项目级路由策略和 Claude 写入拦截 hook 来约束这些边界。
 
-## 📋 版本信息
+## 工作模型
 
-- **版本号**: 0.1.2
-- **发布日期**: 2026-05-04
-- **Python 要求**: >= 3.10
-- **Node.js 要求**: >= 20.0.0
+推荐主路径：
 
-## 🎯 本版本修复内容
-
-### P0 - 正确性修复 ✅
-1. **路由逻辑错误** - `first_pending_step_is_not_executable` 硬编码检查 step 1
-2. **路径提取误匹配** - `extract_target_paths_from_request` 误匹配日期/版本号
-
-### P1 - 可用性改进 ✅
-3. **步骤状态自动更新** - Review 后自动更新 checklist 步骤状态
-4. **Per-step timeout** - 支持在 checklist 中为每个步骤指定超时时间
-
-### P2 - 效率优化 ✅
-5. **YAML 解析器替换** - 用 PyYAML 替换手写解析器，删除 ~180 行代码
-6. **测试覆盖** - 添加 30+ 单元测试，覆盖核心逻辑
+```text
+Claude /cgc -> CodeCGC MCP -> CodeCGC runtime -> Codex 或 Gemini 执行器
+```
 
-## 📚 文档
+CLI 仍然保留，用于本地调试、CI 检查和 MCP 不可用时的回退执行。普通用户优先使用 Claude 内的 `/cgc`，或在命令行使用 `cgc`，不需要记住所有内部子命令。
 
-- **[QUICKSTART.md](QUICKSTART.md)** - 5 分钟快速上手指南
-- **[INSTALLATION.md](INSTALLATION.md)** - 完整安装与配置文档
-- **[codecgc/architecture/code-audit-2026-05-04.md](codecgc/architecture/code-audit-2026-05-04.md)** - 代码审计报告
+安全边界：Claude 可以维护需求、规划、文档、审查和工作流状态；产品代码实现必须经由 CodeCGC 路由到 Codex 或 Gemini。项目 hook 会拦截 `Edit`、`Write`、`MultiEdit`、`Bash` 和 `PowerShell`，防止 Claude 用直接编辑或 shell 写入绕过路由。
 
-## 🚀 快速开始
+## 安装
 
-### 1. 安装
+全局安装 CLI：
 
 ```bash
-# 从 npm 安装 CodeCGC
 npm install -g @hunyed15/codecgc --registry=https://registry.npmjs.org/
-
-# 安装 Python 依赖
-pip install pyyaml
-
-# 如自动集成未生效，可手动补执行
-cgc-install --mode user
 ```
 
-全局安装完成后，CodeCGC 会尝试自动写入 Claude 用户级集成到 `~/.claude`，包括：
-
-- `~/.claude/mcp.json`
-- `~/.claude/hooks/route-edit.ps1`
-- `~/.claude/commands/cgc*.md` 自定义 slash commands
-
-当前安装链路还会注册 3 个 MCP server：
-
-- `codecgc`：CodeCGC 编排器 MCP
-- `codex`：后端执行器 MCP
-- `gemini`：前端执行器 MCP
+全局安装只提供 `cgc*` 命令，不会默认写入用户级 Claude 配置。
 
-安装完成后，可以在 Claude 中直接使用：
-
-- `/cgc`
-- `/cgc-install`
-- `/cgc-status`
-- `/cgc-doctor`
-- `/cgc-plan`
-- `/cgc-build`
-- `/cgc-fix`
-- `/cgc-test`
-- `/cgc-review`
-- `/cgc-route`
-- `/cgc-history`
-- `/cgc-package-audit`
-- `/cgc-external-audit`
-- `/cgc-release-readiness`
-- `/cgc-lifecycle`
-
-当前这些 Claude commands 已调整为：
-
-- 优先走 `codecgc` MCP orchestrator
-- 只有在 MCP tool 路径不可用时，才回退到本地 CLI
-
-如果安装时 Python 尚未就绪，自动集成会跳过，此时可在安装 Python 后手动执行 `cgc-install --mode user`。
-
-### 2. 初始化项目
+然后在每个目标项目根目录执行项目级安装：
 
 ```bash
 cd your-project
 cgc-install
+cgc-start
+cgc-status
 cgc-doctor
 ```
 
-### 3. 开始使用
+在 Claude 中可以使用对应 slash command：
 
-```bash
-cgc "新增用户登录功能"
+```text
+/cgc-install
+/cgc-start
+/cgc-status
+/cgc-doctor
 ```
 
-详细步骤请参考 [QUICKSTART.md](QUICKSTART.md)
-
-## 📤 发布到 npm
+`/cgc-install` 和 `cgc-install` 默认都是项目级安装。它们会把集成文件写入当前项目，而不是写入 `~/.claude`。只有用户显式请求 user 模式时，才会处理用户级 Claude 集成。
+
+## 安装后生成的项目文件
+
+`cgc-install` 会在目标项目中创建或同步：
+
+```text
+.mcp.json
+model-routing.yaml
+.claude/
+  settings.local.json
+  hooks/
+    route-edit.ps1
+  commands/
+    cgc*.md
+.codex/
+  codecgcrc.json
+.gemini/
+  policies/
+    codecgc-policy.toml
+codecgc/
+  START_HERE.md
+  features/
+  issues/
+  execution/
+  requirements/
+  architecture/
+  roadmap/
+  compound/
+  docs/
+  reference/
+  fixtures/
+```
 
-### 手动发布
+在 CodeCGC 源码仓库中，`.mcp.json`、`.claude/settings.local.json`、`.claude/commands/`、`.codex/`、`.gemini/`、`codecgc/START_HERE.md` 以及实时 workflow 输出目录会被忽略，因为它们是机器相关或项目安装生成的内容。
 
-```bash
-npm login --registry=https://registry.npmjs.org/
-npm publish --access public --registry=https://registry.npmjs.org/
-```
+源码仓库会保留可发布运行时、参考文档、命令模板、测试 fixtures，以及 `.claude/hooks/route-edit.ps1` 这个 hook 模板。
 
-### GitHub 自动发布
+## 角色与路由策略
 
-本目录已包含 GitHub Actions 工作流：
+`model-routing.yaml` 是文件归属和写入权限的唯一策略来源：
 
-`/.github/workflows/publish-npm.yml`
+- Claude 可以写 orchestration 和 docs 路径。
+- Codex 可以写 backend 源码和 backend 测试。
+- Gemini 可以写 frontend 源码和 frontend 测试。
+- shared 路径使用 `split-first` 策略，必须先拆分再执行。
+- unknown 路径默认拒绝，直到它被明确加入 `model-routing.yaml`。
 
-触发方式：
+Claude hook 本身不承载业务逻辑。它只把 `Edit`、`Write`、`MultiEdit` 请求转发给 `scripts/codecgc_policy.py`，从而保证 hook 检查、任务构建和执行器派发使用同一套路由策略。
 
-```bash
-git tag v0.1.0
-git push origin v0.1.0
-```
+## 文档放置规则
 
-自动发布前提：
+普通项目文档放在 `docs/`，例如用户手册、API 文档、部署说明和 changelog。
 
-- GitHub 仓库已启用 Actions
-- 仓库 Secrets 中已设置 `NPM_TOKEN`
-- tag 版本必须与 `package.json` 中的 `version` 完全一致
+CodeCGC 工作流和治理产物放在 `codecgc/`：
 
-建议流程：
+- `codecgc/docs/`：CodeCGC 生成的指南类文档。
+- `codecgc/reference/`：稳定契约、参考说明和工具文档。
+- `codecgc/requirements/`：长期需求沉淀。
+- `codecgc/architecture/`：架构说明和系统图谱。
+- `codecgc/roadmap/`：路线图和阶段计划。
+- `codecgc/features/`：功能计划、checklist 和验收记录。
+- `codecgc/issues/`：问题报告、分析和修复计划。
+- `codecgc/execution/`：执行器审计记录。
 
-```bash
-# 1. 更新 package.json version
-# 2. 提交到 GitHub
-# 3. 打版本 tag
-git tag v0.1.0
-git push origin main --tags
-```
+## 日常使用
 
-## 📁 目录结构
+在 Claude 中：
 
+```text
+/cgc 在 src/components/LoginForm.tsx 中新增登录页
 ```
-release/
-├── README.md                    # 本文件
-├── QUICKSTART.md               # 快速开始指南
-├── INSTALLATION.md             # 完整安装文档
-├── package.json                # Node.js 包配置
-├── requirements.txt            # Python 核心依赖
-├── requirements-dev.txt        # Python 开发依赖
-├── pytest.ini                  # 测试配置
-├── model-routing.yaml          # 路由规则模板
-├── bin/                        # 命令行工具
-├── scripts/                    # Python 工作流脚本
-├── tests/                      # 单元测试
-├── codecgc/                    # 工作流产物模板
-├── codexmcp/                   # Codex MCP 服务器
-└── geminimcp/                  # Gemini MCP 服务器
-```
-
-## 🔧 依赖清单
 
-### Python 依赖
+在命令行中：
 
-**核心依赖**:
-- pyyaml>=6.0
+```bash
+cgc "在 src/components/LoginForm.tsx 中新增登录页"
+```
 
-**开发依赖**:
-- pytest>=8.0.0
-- pytest-cov>=4.1.0
+CodeCGC 会判断下一步应该是规划、执行、审查、继续还是关闭。只有当你已经明确知道当前阶段时，才需要直接使用子命令：
 
-### MCP 服务器
+```bash
+cgc-plan ...
+cgc-build ...
+cgc-fix ...
+cgc-test ...
+cgc-review ...
+cgc-route ...
+```
 
-1. **Codex MCP** - 后端代码执行器
-2. **Gemini MCP** - 前端代码执行器
+## 健康检查
 
-## ✅ 验证安装
+对已经安装 CodeCGC 的目标项目：
 
 ```bash
+cgc-status
 cgc-doctor
+cgc-external-status
+cgc-external-audit
 ```
 
-## 📝 更新日志
-
-### v0.1.0 (2026-05-04)
-
-**修复**:
-- 修复路由逻辑错误
-- 修复路径提取误匹配
-- Review 后自动更新步骤状态
-
-**新增**:
-- Per-step timeout 支持
-- 30+ 单元测试
+维护或发布 CodeCGC 包时：
 
-**优化**:
-- 用 PyYAML 替换手写解析器
+```bash
+python -m pytest tests --basetemp D:\tmp\codecgc-pytest
+python -m compileall -q scripts codecgcmcp\src codexmcp\src geminimcp\src
+python scripts\audit_codecgc_package_runtime.py --format json
+python scripts\audit_codecgc_release_readiness.py --format json
+npm pack --dry-run --json
+```
 
-## 📄 许可证
+`cgc-release-readiness` 会通过临时项目安装探针验证发布包可用性。源码仓库本身不需要提交项目级 `.mcp.json`、`.claude/settings.local.json`、`.codex/` 或 `.gemini/`。
 
-MIT License
+如果运行环境限制默认临时目录写入，可以显式指定探针目录：
 
----
+```bash
+set CODECGC_RELEASE_PROBE_ROOT=D:\tmp
+python scripts\audit_codecgc_release_readiness.py --format json
+```
 
-**感谢使用 CodeCGC！**
+## 参考文档
+
+- [快速开始](codecgc/reference/quickstart.md)
+- [新手入口](codecgc/reference/onboarding.md)
+- [操作指南](codecgc/reference/operation-guide.md)
+- [真实工作流闭环](codecgc/reference/real-workflow-loop.md)
+- [失败恢复闭环](codecgc/reference/recovery-loop.md)
+- [故障排查](codecgc/reference/troubleshooting.md)
+- [路径契约](codecgc/reference/path-contract.md)
+- [路由策略](codecgc/reference/policy-routing.md)
+- [项目结构](codecgc/reference/project-structure.md)
+- [维护者指南](codecgc/reference/maintainer-guide.md)

package/bin/cgc-external-status.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+process.env.CODECGC_BIN_NAME = "cgc-external-status";
+require("./codecgc.js");

package/bin/cgc-start.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+process.env.CODECGC_BIN_NAME = "cgc-start";
+require("./codecgc.js");

package/bin/codecgc.js

@@ -12,11 +12,13 @@ const invokedBinary = (process.env.CODECGC_BIN_NAME || path.basename(process.arg
 const packageJson = JSON.parse(readFileSync(path.join(repoRoot, "package.json"), "utf8"));
 const productVersion = packageJson.version || "0.0.0";
 const DIRECT_COMMANDS = new Set([
+  "start",
   "install",
   "status",
   "doctor",
   "package-audit",
   "external-audit",
+  "external-status",
   "release-readiness",
   "lifecycle",
   "history",
@@ -39,11 +41,13 @@ const helpText = `CodeCGC 命令入口
   cgc --request <text>
   cgc --latest
   cgc --slug <workflow-slug>
-  cgc-install [--mode local|user-dry-run|user|status|doctor] [--workspace <dir>] [--user-root <dir>]
+  cgc-start [--format json|summary] [--workspace <dir>]
+  cgc-install [--mode local|user-dry-run|user|status|doctor|start] [--workspace <dir>] [--user-root <dir>]
   cgc-status [--format json|summary]
   cgc-doctor [--format json|summary]
   cgc-package-audit [--format json|summary]
   cgc-external-audit [--format json|summary] [--workspace <dir>]
+  cgc-external-status [--format json|summary] [--workspace <dir>]
   cgc-release-readiness [--format json|summary] [--workspace <dir>]
   cgc-lifecycle [--format json|summary]
   cgc-history [--flow all|feature|issue] [--status all|open|closed] [--last <n>] [--format json|summary]
@@ -78,6 +82,8 @@ const helpText = `CodeCGC 命令入口
     cgc-route ...
   我想把 CodeCGC 安装或重新同步到当前项目
     cgc-install
+  我刚装完，想看当前项目下一步怎么开始
+    cgc-start
   我想知道集成面现在是否就绪
     cgc-status
   我想知道运行前置和执行器能不能真正启动
@@ -86,6 +92,8 @@ const helpText = `CodeCGC 命令入口
     cgc-package-audit
   我想确认第三方能力接入策略和本地 MCP 注册状态
     cgc-external-audit
+  我想快速查看第三方能力状态面板
+    cgc-external-status
   我想在发布或长期维护前跑一次总检查
     cgc-release-readiness
   我想快速判断当前仓库处于哪个生命周期阶段
@@ -98,11 +106,13 @@ const helpText = `CodeCGC 命令入口
     cgc-plan / cgc-build / cgc-fix / cgc-review / cgc-route
 
 命令职责:
+  cgc-start          显示当前项目的首次使用入口和下一步动作
   cgc-install        同步项目级或用户级集成面
   cgc-status         检查集成是否就绪，并给出下一步
   cgc-doctor         检查运行前置、执行器导入与项目集成状态
   cgc-package-audit  检查发布包是否覆盖运行时依赖
-  cgc-external-audit 检查外部能力白名单、接入状态与本地 MCP 观测结果
+  cgc-external-audit 检查外部能力白名单、接入声明与本地 MCP 观测一致性
+  cgc-external-status 查看外部能力状态面板与本地 MCP 观测结果
   cgc-release-readiness 汇总安装、运行时、发布包、外部接入与生命周期就绪状态
   cgc-lifecycle      汇总 roadmap、workflow 与 execution 的生命周期阶段
   cgc-history        只读汇总最近 feature / issue workflow 历史
@@ -117,9 +127,10 @@ const helpText = `CodeCGC 命令入口
 
 首次使用:
   1. 先在目标项目根目录执行 cgc-install
-  2. 再执行 cgc-status，必要时补 cgc-doctor
-  3. 然后直接使用 cgc "<自然语言需求>" 或 cgc-entry
-  4. 只有当你已经明确知道当前阶段时，再改用 cgc-plan / cgc-build / cgc-fix / cgc-test / cgc-review / cgc-route
+  2. 执行 cgc-start 查看项目本地入口说明
+  3. 再执行 cgc-status，必要时补 cgc-doctor
+  4. 然后直接使用 cgc "<自然语言需求>" 或 cgc-entry
+  5. 只有当你已经明确知道当前阶段时，再改用 cgc-plan / cgc-build / cgc-fix / cgc-test / cgc-review / cgc-route
 
 示例:
   cgc "新增一个登录页面，放在 src/components/LoginForm.tsx"
@@ -129,6 +140,7 @@ const helpText = `CodeCGC 命令入口
   cgc --request "现在下一步该做什么"
   cgc --latest
   cgc --slug 2026-05-01-demo-login-ui
+  cgc-start
   cgc-plan --flow feature --slug demo-login-ui --summary "Demo login UI feature" --target-path src/components/LoginForm.tsx --kind frontend
   cgc-build --slug 2026-05-01-demo-login-ui --step-number 1 --dry-run
   cgc-fix --slug 2026-05-01-demo-sync-bug --step-number 1 --dry-run
@@ -140,6 +152,7 @@ const helpText = `CodeCGC 命令入口
   cgc-status --format summary
   cgc-doctor --format summary
   cgc-package-audit --format summary
+  cgc-external-status --format summary
   cgc-external-audit --format summary
   cgc-release-readiness --format summary
   cgc-lifecycle --format summary
@@ -153,10 +166,36 @@ const helpText = `CodeCGC 命令入口
   CODECGC_WORKSPACE_ROOT  当当前 shell 目录不是目标项目根目录时，显式覆盖目标工作区
 `;
 
+const startHelpText = `CodeCGC Start
+
+用法:
+  cgc-start [--format <summary|json>] [--workspace <dir>]
+
+用途:
+  显示当前项目的首次使用入口、项目本地 onboarding 文件，以及下一步动作。
+
+默认行为:
+  不传 --format 时默认输出 summary，更适合安装后直接阅读。
+  该命令只读，不会修改项目文件。
+
+主要参数:
+  --workspace <dir>
+    显式指定目标项目根目录。默认使用当前 shell 所在目录。
+  --format <summary|json>
+    summary 用于新手入口摘要，json 用于调试或自动化消费。
+
+推荐用法:
+  cgc-install
+  cgc-start
+  cgc-status
+  cgc-doctor
+  cgc "新增一个登录页面，放在 src/components/LoginForm.tsx"
+`;
+
 const installHelpText = `CodeCGC 安装与自检
 
 用法:
-  cgc-install [--mode <local|user-dry-run|user|status|doctor>] [--workspace <dir>] [--user-root <dir>] [--format <json|summary>]
+  cgc-install [--mode <local|user-dry-run|user|status|doctor|start>] [--workspace <dir>] [--user-root <dir>] [--format <json|summary>]
 
 用途:
   准备、检查或修复 CodeCGC 在 Claude 与 MCP 启动链路上的集成面。
@@ -172,6 +211,8 @@ const installHelpText = `CodeCGC 安装与自检
     检查项目级集成是否就绪，并附带用户级集成预览状态。
   doctor
     检查运行前置、执行器可导入性，以及项目级集成是否就绪。
+  start
+    只读显示项目首次使用入口和下一步动作。
 
 主要参数:
   --workspace <dir>
@@ -183,12 +224,16 @@ const installHelpText = `CodeCGC 安装与自检
 
 推荐用法:
   cgc-install
+  cgc-start
   cgc-install --workspace D:\\Projects\\MyApp
+  cgc-install --mode start --format summary
   cgc-install --mode status --format summary
   cgc-install --mode doctor --format summary
   cgc-install --mode user-dry-run --user-root C:\\Users\\Admin\\.claude
 
 相关命令:
+  cgc-start
+    查看当前项目首次使用入口。
   cgc-status
     快速查看集成状态。
   cgc-doctor
@@ -227,6 +272,8 @@ const statusHelpText = `CodeCGC 安装状态
   cgc-status --format json
 
 相关命令:
+  cgc-start
+    查看当前项目首次使用入口。
   cgc-install
     同步或修复当前项目集成面。
   cgc-doctor
@@ -318,6 +365,30 @@ const externalAuditHelpText = `CodeCGC 外部能力审计
   cgc-external-audit --format json
 `;
 
+const externalStatusHelpText = `CodeCGC 外部能力状态面板
+
+用法:
+  cgc-external-status [--format <summary|json>] [--workspace <dir>]
+
+用途:
+  快速查看外部能力登记状态、规划项与本地 MCP 观测结果。
+
+默认行为:
+  不传 --format 时默认输出 summary，更适合日常维护检查。
+  只有在需要查看完整结构化数据时才建议改用 --format json。
+
+主要参数:
+  --workspace <dir>
+    显式指定目标项目根目录。默认使用当前 shell 所在目录。
+  --format <summary|json>
+    summary 用于快速查看面板，json 用于调试和自动化消费。
+
+推荐用法:
+  cgc-external-status
+  cgc-external-status --workspace D:\\Projects\\MyApp
+  cgc-external-status --format json
+`;
+
 const releaseReadinessHelpText = `CodeCGC Release Readiness
 
 用法:
@@ -594,22 +665,22 @@ const routeHelpText = `CodeCGC Workflow Route
 
 function findPython() {
   const override = (process.env.CODECGC_PYTHON_COMMAND || "").trim();
-  if (override) {
-    const probe = spawnSync(override, ["--version"], {
-      cwd: repoRoot,
-      encoding: "utf8",
-      shell: false,
-    });
-    if (probe.status === 0) {
-      return override;
+  const generatedMcpCommand = readGeneratedMcpPythonCommand();
+  for (const configured of [override, generatedMcpCommand]) {
+    if (configured) {
+      return configured;
     }
   }
-
-  const candidates = process.platform === "win32"
-    ? ["python", "py"]
-    : ["python3", "python"];
+  const candidates = [
+    ...(process.platform === "win32" ? ["python", "py"] : ["python3", "python"]),
+  ];
+  const seen = new Set();
 
   for (const command of candidates) {
+    if (seen.has(command)) {
+      continue;
+    }
+    seen.add(command);
     const probe = spawnSync(command, ["--version"], {
       cwd: repoRoot,
       encoding: "utf8",
@@ -622,6 +693,27 @@ function findPython() {
   return null;
 }
 
+function readGeneratedMcpPythonCommand() {
+  for (const mcpPath of [path.join(invocationCwd, ".mcp.json"), path.join(repoRoot, ".mcp.json")]) {
+    if (!existsSync(mcpPath)) {
+      continue;
+    }
+    try {
+      const payload = JSON.parse(readFileSync(mcpPath, "utf8"));
+      const servers = payload && payload.mcpServers;
+      if (servers && servers.codecgc && typeof servers.codecgc.command === "string") {
+        const command = servers.codecgc.command.trim();
+        if (command) {
+          return command;
+        }
+      }
+    } catch (_error) {
+      // Ignore malformed generated config and continue with normal Python discovery.
+    }
+  }
+  return "";
+}
+
 function run(command, commandArgs) {
   const commandEnv = {
     ...process.env,
@@ -1096,6 +1188,10 @@ function looksLikeEntryFlag(flag) {
   ]).has(flag);
 }
 
+function hasOption(argsList, optionName) {
+  return argsList.some((item) => item === optionName || item.startsWith(`${optionName}=`));
+}
+
 function shouldRouteRootInvocationToEntry(rawArgs) {
   if (rawArgs.length === 0) {
     return false;
@@ -1132,6 +1228,10 @@ function main() {
   }
 
   if (rest.length === 1 && (rest[0] === "--help" || rest[0] === "-h")) {
+    if (subcommand === "start") {
+      console.log(startHelpText);
+      return;
+    }
     if (subcommand === "install") {
       console.log(installHelpText);
       return;
@@ -1152,6 +1252,10 @@ function main() {
       console.log(externalAuditHelpText);
       return;
     }
+    if (subcommand === "external-status") {
+      console.log(externalStatusHelpText);
+      return;
+    }
     if (subcommand === "release-readiness") {
       console.log(releaseReadinessHelpText);
       return;
@@ -1216,6 +1320,18 @@ function main() {
     return;
   }
 
+  if (subcommand === "start") {
+    run(
+      python,
+      [
+        path.join(repoRoot, "scripts", "install_codecgc.py"),
+        "--mode",
+        "start",
+        ...rest,
+      ],
+    );
+  }
+
   if (subcommand === "install") {
     run(python, [path.join(repoRoot, "scripts", "install_codecgc.py"), ...rest]);
   }
@@ -1242,12 +1358,17 @@ function main() {
     );
   }
 
-  if (subcommand === "external-audit") {
+  if (subcommand === "external-audit" || subcommand === "external-status") {
+    const view = subcommand === "external-status" ? "status" : "audit";
+    const commandArgs = [...rest];
+    if (!hasOption(commandArgs, "--view")) {
+      commandArgs.push("--view", view);
+    }
     run(
       python,
       [
         path.join(repoRoot, "scripts", "audit_codecgc_external_capabilities.py"),
-        ...rest,
+        ...commandArgs,
       ],
     );
   }