@rpamis/comet 0.1.8 → 0.2.0

package/assets/skills-zh/comet-tweak/SKILL.md

@@ -26,7 +26,7 @@ Tweak 是 Comet 五阶段能力的预设工作流，不是独立的平行流程
 执行入口验证：
 
 ```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
 bash "$COMET_STATE" check <name> open
 ```
 
@@ -61,7 +61,7 @@ bash "$COMET_STATE" init <name> tweak
 1. 读取 `openspec/changes/<name>/tasks.md`，获取未完成任务列表
 2. 对每个未完成任务：
    - 根据任务描述修改目标文件
-   - 运行 `mvn spotless:apply` 格式化
+   - 运行项目格式化命令（如 `mvn spotless:apply`、`npm run format` 等）
    - 运行相关测试确认通过
    - 将 tasks.md 中对应 `- [ ]` 勾选为 `- [x]`
    - 提交代码，commit message 格式：`tweak: <简述变更>`
@@ -99,14 +99,16 @@ Tweak 流程为 **一次性连续执行**。调用 `/comet-tweak` 后，agent
 
 ## 升级条件
 
-执行过程中出现以下情况时，停止 tweak 流程，升级为完整 `/comet`：
+满足以下**任一**条件时，停止 tweak 流程，升级为完整 `/comet`：
 
-1. 需要新增 capability
-2. 需要架构调整
-3. 需要接口变化
-4. 影响范围扩大到 > 5 个文件
-5. 任务数超过 3 个
-6. 需要 delta spec
+| 条件 | 说明 |
+|------|------|
+| 改动涉及 **5+ 文件** | 超出小改动范围 |
+| 多模块协调修改 | 需要跨组件协调 |
+| 需要新增测试用例 **5+** | 变更复杂度上升 |
+| 配置项新增或删除 | 非值修改的配置变更 |
+| 需要新增 capability | 超出局部优化 |
+| 需要 delta spec | 影响了已有规格 |
 
 升级方式：在当前 change 基础上补充 Design Doc（执行 `/comet-design`），后续正常走完整流程。
 

package/assets/skills-zh/comet-verify/SKILL.md

@@ -1,116 +1,114 @@
----
-name: comet-verify
-description: "Comet 阶段 4：验证与收尾。用 /comet-verify 调用。验证实现符合设计，处理开发分支。"
----
-
-# Comet 阶段 4：验证与收尾（Verify）
-
-## 前置条件
-
-- 代码已提交（阶段 3 完成）
-- tasks.md 全部任务已完成
-
-## 步骤
-
-### 0. 入口状态验证（Entry Check）
-
-执行入口验证：
-
-```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
-bash "$COMET_STATE" check <name> verify
-```
-
-验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
-
-### 1. 改动规模评估
-
-执行规模评估：
-
-```bash
-bash "$COMET_STATE" scale <name>
-```
-
-脚本自动统计任务数、增量规格数、变更文件数，判断使用 light 或 full 验证模式，并设置 verify_mode 字段。
-
-### 2a. 轻量验证（小改动）
-
-当规模评估结果为"小"时，跳过 `openspec-verify-change`，直接执行以下检查：
-
-1. tasks.md 全部任务已完成 `[x]`
-2. 改动文件与 tasks.md 描述一致（`git diff --stat` 对照 tasks 内容）
-3. 编译通过（Maven 项目先执行 `mvn spotless:apply`，再执行 `mvn compile` 或等效命令）
-4. 相关测试通过
-5. 无明显安全问题（无硬编码密钥、无新增 unsafe 操作）
-
-**通过标准**：5 项全部 OK，无 CRITICAL 问题。
-
-**报告格式**：简表列出 5 项检查结果 + PASS/FAIL。
-
-**跳过项**（不在轻量验证中检查）：
-- spec scenario 覆盖率
-- design doc 一致性深度比对
-- code pattern consistency 建议
-- delta spec 与 design doc 漂移检测
-
-### 2b. 完整验证（大改动）
-
-当规模评估结果为"大"时：
-
-**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引验证。检查项：
-1. tasks.md 全部任务已完成（`[x]`）
-2. 实现符合 design.md 设计决策
-3. 实现符合 brainstorming 设计文档
-4. 能力规格场景全部通过
-5. proposal.md 目标已满足
-6. delta spec 与 design doc 无矛盾（若 Build 阶段有增量修改 spec，检查 design doc 是否有对应记录）
-7. `docs/superpowers/specs/` 关联的设计文档可定位（文件存在且与当前 change 相关）
-
-验证不通过时：报告缺失项，返回阶段 3 补充（调用 `/comet-build`）。
-
-**Spec 漂移处理**：
-- 若检查项 6 发现矛盾（delta spec 有内容但 design doc 未体现），提示用户：
-  - 选项 A：在 design doc 追加 "Implementation Divergence" 节记录偏差原因
-  - 选项 B：回退到 Build 阶段，补充 brainstorming 更新 design doc
-  - 选项 C：确认偏差可接受，继续验证（归档时 design doc 将标记为 `superseded-by-main-spec`）
-
-### 3. 收尾（Superpowers）
-
-**立即执行：** 使用 Skill 工具加载 `superpowers:finishing-a-development-branch` 技能。禁止跳过此步骤。
-
-如 `superpowers:finishing-a-development-branch` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
-
-技能加载后，按其指引收尾。分支处理选项：
-1. 本地合并到主分支
-2. 推送并创建 PR
-3. 保持分支（稍后处理）
-4. 丢弃工作
-
-**确认项**：
-- Maven 测试或构建命令前已执行 `mvn spotless:apply`
-- 全部测试通过
-- 无遗留的 spotless 格式问题
-- 无硬编码密钥或安全问题
-
-## 退出条件
-
-- 验证报告通过
-- 分支已处理
-- `.comet.yaml` 中 `verify_result` 已记录为 `pass`
-- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> verify`，全部 PASS 后才允许流转
-
-退出前运行 guard 自动流转：
-
-```bash
-bash $COMET_GUARD <change-name> verify --apply
-```
-
-状态文件自动更新为 `phase: archive`、`verify_result: pass`、`verified_at: YYYY-MM-DD`。
-
-## 自动流转
-
-退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
-
-> **REQUIRED NEXT SKILL:** 调用 `comet-archive` skill 进入归档阶段。
+---
+name: comet-verify
+description: "Comet 阶段 4：验证与收尾。用 /comet-verify 调用。验证实现符合设计，处理开发分支。"
+---
+
+# Comet 阶段 4：验证与收尾（Verify）
+
+## 前置条件
+
+- 代码已提交（阶段 3 完成）
+- tasks.md 全部任务已完成
+
+## 步骤
+
+### 0. 入口状态验证（Entry Check）
+
+执行入口验证：
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> verify
+```
+
+验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
+
+### 1. 改动规模评估
+
+执行规模评估：
+
+```bash
+bash "$COMET_STATE" scale <name>
+```
+
+脚本自动统计任务数、增量规格数、变更文件数，判断使用 light 或 full 验证模式，并设置 verify_mode 字段。
+
+### 2a. 轻量验证（小改动）
+
+当规模评估结果为"小"时，跳过 `openspec-verify-change`，直接执行以下检查：
+
+1. tasks.md 全部任务已完成 `[x]`
+2. 改动文件与 tasks.md 描述一致（`git diff --stat` 对照 tasks 内容）
+3. 编译通过（执行项目对应的构建命令，如 `npm run build`、`mvn compile`、`cargo build` 等）
+4. 相关测试通过
+5. 无明显安全问题（无硬编码密钥、无新增 unsafe 操作）
+
+**通过标准**：5 项全部 OK，无 CRITICAL 问题。
+
+**报告格式**：简表列出 5 项检查结果 + PASS/FAIL。
+
+**跳过项**（不在轻量验证中检查）：
+- spec scenario 覆盖率
+- design doc 一致性深度比对
+- code pattern consistency 建议
+- delta spec 与 design doc 漂移检测
+
+### 2b. 完整验证（大改动）
+
+当规模评估结果为"大"时：
+
+**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能。禁止跳过此步骤。
+
+技能加载后，按其指引验证。检查项：
+1. tasks.md 全部任务已完成（`[x]`）
+2. 实现符合 design.md 设计决策
+3. 实现符合 brainstorming 设计文档
+4. 能力规格场景全部通过
+5. proposal.md 目标已满足
+6. delta spec 与 design doc 无矛盾（若 Build 阶段有增量修改 spec，检查 design doc 是否有对应记录）
+7. `docs/superpowers/specs/` 关联的设计文档可定位（文件存在且与当前 change 相关）
+
+验证不通过时：报告缺失项，返回阶段 3 补充（调用 `/comet-build`）。
+
+**Spec 漂移处理**：
+- 若检查项 6 发现矛盾（delta spec 有内容但 design doc 未体现），提示用户：
+  - 选项 A：在 design doc 追加 "Implementation Divergence" 节记录偏差原因
+  - 选项 B：回退到 Build 阶段，补充 brainstorming 更新 design doc
+  - 选项 C：确认偏差可接受，继续验证（归档时 design doc 将标记为 `superseded-by-main-spec`）
+
+### 3. 收尾（Superpowers）
+
+**立即执行：** 使用 Skill 工具加载 `superpowers:finishing-a-development-branch` 技能。禁止跳过此步骤。
+
+如 `superpowers:finishing-a-development-branch` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
+
+技能加载后，按其指引收尾。分支处理选项：
+1. 本地合并到主分支
+2. 推送并创建 PR
+3. 保持分支（稍后处理）
+4. 丢弃工作
+
+**确认项**：
+- 全部测试通过
+- 无硬编码密钥或安全问题
+
+## 退出条件
+
+- 验证报告通过
+- 分支已处理
+- `.comet.yaml` 中 `verify_result` 已记录为 `pass`
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> verify`，全部 PASS 后才允许流转
+
+退出前运行 guard 自动流转：
+
+```bash
+bash $COMET_GUARD <change-name> verify --apply
+```
+
+状态文件自动更新为 `phase: archive`、`verify_result: pass`、`verified_at: YYYY-MM-DD`。
+
+## 自动流转
+
+退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
+
+> **REQUIRED NEXT SKILL:** 调用 `comet-archive` skill 进入归档阶段。

package/dist/cli/index.js

@@ -1,6 +1,9 @@
 import { Command } from 'commander';
 import { createRequire } from 'module';
-import { initCommand } from '../core/init.js';
+import { initCommand } from '../commands/init.js';
+import { statusCommand } from '../commands/status.js';
+import { doctorCommand } from '../commands/doctor.js';
+import { updateCommand } from '../commands/update.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../../package.json');
 const program = new Command();
@@ -14,8 +17,32 @@ program
     .option('--yes', 'Auto-install missing components, skip existing')
     .option('--skip-existing', 'Never overwrite existing components')
     .option('--overwrite', 'Overwrite manifest-managed files')
+    .option('--json', 'Output as JSON')
     .action(async (targetPath = '.', options) => {
     await initCommand(targetPath, options);
 });
+program
+    .command('status [path]')
+    .description('Show active changes and workflow status')
+    .option('--json', 'Output as JSON')
+    .action(async (targetPath = '.', options) => {
+    await statusCommand(targetPath, options);
+});
+program
+    .command('doctor [path]')
+    .description('Diagnose Comet installation health')
+    .option('--json', 'Output as JSON')
+    .action(async (targetPath = '.', options) => {
+    await doctorCommand(targetPath, options);
+});
+program
+    .command('update [path]')
+    .description('Update comet skill files to latest version')
+    .option('--json', 'Output as JSON')
+    .option('--language <lang>', 'Language for skills (en, zh)')
+    .option('--scope <scope>', 'Install scope (global, project)')
+    .action(async (targetPath = '.', options) => {
+    await updateCommand(targetPath, options);
+});
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,uDAAuD,CAAC;KACpE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,OAAO,EAAE,gDAAgD,CAAC;KACjE,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;KAChE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;KACzD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,uDAAuD,CAAC;KACpE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,OAAO,EAAE,gDAAgD,CAAC;KACjE,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;KAChE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;KACzD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;KAC3D,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;KAC5D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+interface DoctorOptions {
+    json?: boolean;
+}
+export declare function doctorCommand(targetPath: string, options?: DoctorOptions): Promise<void>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAmLA,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/commands/doctor.js

@@ -0,0 +1,168 @@
+import path from 'path';
+import { execSync } from 'child_process';
+import { promises as fs } from 'fs';
+import { fileExists, readDir } from '../utils/file-system.js';
+import { isCommandAvailable } from '../core/openspec.js';
+import { readManifest, getAssetsDir } from '../core/skills.js';
+import { PLATFORMS } from '../core/platforms.js';
+const VALID_YAML_FIELDS = new Set([
+    'workflow',
+    'phase',
+    'build_mode',
+    'isolation',
+    'verify_mode',
+    'verify_result',
+    'design_doc',
+    'plan',
+    'archived',
+    'verified_at',
+]);
+async function checkOpenSpecCli() {
+    if (!isCommandAvailable('openspec')) {
+        return {
+            check: 'openspec CLI',
+            status: 'warn',
+            message: 'not installed — install with: npm install -g @fission-ai/openspec@latest',
+        };
+    }
+    try {
+        const version = execSync('openspec --version', { stdio: 'pipe', timeout: 10_000 })
+            .toString()
+            .trim();
+        return { check: 'openspec CLI', status: 'pass', message: `installed (${version})` };
+    }
+    catch {
+        return { check: 'openspec CLI', status: 'pass', message: 'installed' };
+    }
+}
+async function checkWorkingDirs(projectPath) {
+    const specsDir = path.join(projectPath, 'docs', 'superpowers', 'specs');
+    const plansDir = path.join(projectPath, 'docs', 'superpowers', 'plans');
+    const specsExist = await fileExists(specsDir);
+    const plansExist = await fileExists(plansDir);
+    if (specsExist && plansExist) {
+        return { check: 'working directories', status: 'pass', message: 'present' };
+    }
+    if (!specsExist && !plansExist) {
+        return { check: 'working directories', status: 'fail', message: 'missing — run: comet init' };
+    }
+    const missing = [];
+    if (!specsExist)
+        missing.push('specs');
+    if (!plansExist)
+        missing.push('plans');
+    return {
+        check: 'working directories',
+        status: 'warn',
+        message: `partial (missing: ${missing.join(', ')})`,
+    };
+}
+async function checkSkillCompleteness(projectPath) {
+    const results = [];
+    const manifest = await readManifest();
+    let anyPlatform = false;
+    for (const platform of PLATFORMS) {
+        const skillsDir = path.join(projectPath, platform.skillsDir, 'skills');
+        if (!(await fileExists(skillsDir)))
+            continue;
+        anyPlatform = true;
+        const missing = [];
+        for (const relPath of manifest.skills) {
+            const fullPath = path.join(projectPath, platform.skillsDir, 'skills', relPath);
+            if (!(await fileExists(fullPath))) {
+                missing.push(relPath);
+            }
+        }
+        results.push(missing.length === 0
+            ? {
+                check: `skills: ${platform.name}`,
+                status: 'pass',
+                message: `complete (${manifest.skills.length} files)`,
+            }
+            : {
+                check: `skills: ${platform.name}`,
+                status: 'warn',
+                message: `missing ${missing.length}: ${missing.join(', ')}`,
+            });
+    }
+    if (!anyPlatform) {
+        results.push({
+            check: 'skills',
+            status: 'warn',
+            message: 'no platforms detected — run comet init',
+        });
+    }
+    return results;
+}
+async function checkScriptsPresent() {
+    const assetsDir = getAssetsDir();
+    const scriptsDir = path.join(assetsDir, 'skills', 'comet', 'scripts');
+    if (!(await fileExists(scriptsDir))) {
+        return { check: 'scripts present', status: 'warn', message: 'scripts directory not found' };
+    }
+    const entries = await readDir(scriptsDir);
+    const shFiles = entries.filter((e) => e.endsWith('.sh'));
+    return {
+        check: 'scripts executable',
+        status: 'pass',
+        message: `OK (${shFiles.length} scripts)`,
+    };
+}
+async function checkCometYamlValidity(projectPath) {
+    const changesDir = path.join(projectPath, 'openspec', 'changes');
+    if (!(await fileExists(changesDir)))
+        return [];
+    const entries = await readDir(changesDir);
+    const results = [];
+    for (const entry of entries) {
+        const yamlPath = path.join(changesDir, entry, '.comet.yaml');
+        if (!(await fileExists(yamlPath)))
+            continue;
+        const raw = await fs.readFile(yamlPath, 'utf-8');
+        const unknownFields = [];
+        for (const line of raw.split('\n')) {
+            const match = line.match(/^(\w[\w_]*):/);
+            if (match && !VALID_YAML_FIELDS.has(match[1])) {
+                unknownFields.push(match[1]);
+            }
+        }
+        results.push(unknownFields.length === 0
+            ? { check: `.comet.yaml: ${entry}`, status: 'pass', message: 'valid' }
+            : {
+                check: `.comet.yaml: ${entry}`,
+                status: 'fail',
+                message: `unknown field(s): ${unknownFields.join(', ')}`,
+            });
+    }
+    return results;
+}
+async function collectResults(projectPath) {
+    const results = [];
+    results.push(await checkOpenSpecCli());
+    results.push(await checkWorkingDirs(projectPath));
+    results.push(...(await checkSkillCompleteness(projectPath)));
+    results.push(await checkScriptsPresent());
+    results.push(...(await checkCometYamlValidity(projectPath)));
+    return results;
+}
+function icon(status) {
+    if (status === 'pass')
+        return '✓';
+    if (status === 'warn')
+        return '⚠';
+    return '✗';
+}
+export async function doctorCommand(targetPath, options = {}) {
+    const projectPath = path.resolve(targetPath);
+    const results = await collectResults(projectPath);
+    if (options.json) {
+        console.log(JSON.stringify({ results }, null, 2));
+        return;
+    }
+    console.log('Comet Doctor\n');
+    for (const r of results) {
+        console.log(`  ${icon(r.status)} ${r.check}: ${r.message}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,9 @@
+type InitOptions = {
+    yes?: boolean;
+    skipExisting?: boolean;
+    overwrite?: boolean;
+    json?: boolean;
+};
+export declare function initCommand(targetPath: string, options?: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAaA,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA8HF,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8G9F"}