jarvis-agent-factory 4.3.7 → 4.4.0

package/README.md

@@ -1,7 +1,7 @@
 # Jarvis Agent Factory · 贾维斯智能体工厂
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-v4.3.7-green)](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/releases)
+[![Version](https://img.shields.io/badge/version-v4.4.0-green)](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/releases)
 [![npm](https://img.shields.io/npm/v/jarvis-agent-factory)](https://www.npmjs.com/package/jarvis-agent-factory)
 [![Visual Primitives MCP](https://img.shields.io/badge/DeepSeek-Visual%20Primitives%20MCP-purple)](https://github.com/Wjl1224734792/visual-primitives-mcp)
 <br>💡 **纯文本模型（如 DeepSeek）主力用户** → 搭配 [Visual Primitives MCP](https://github.com/Wjl1224734792/visual-primitives-mcp) 获得视觉理解能力
@@ -9,7 +9,7 @@
 
 AI 编程助手配置集 + MCP 编排引擎。从想法到交付的完整软件开发流水线，<br>**仅支持 Claude Code**。
 
-> **v4.3.7** — 生产就绪：版本一致性修复、CI 强化、全部质量门闭合
+> **v4.4.0** — 新增 /cancel 取消指令，完善会话生命周期管理
 
 ## 快速开始
 
@@ -66,7 +66,7 @@ jarvis web                       # 启动 Web 面板（按需）
 流水线各阶段智能产出物按 Gate 存入对应子目录，临时文件统一管理：
 
 ```
-docs/
+.jarvis/
 ├── tmp/                    # 临时产物（截图、快照、导出的验证数据等，已 .gitignore 排除）
 ├── YYYY-MM-DD/             # ★ 日期分类目录（唯一合法格式）
 │   ├── requirements/       # Gate A — 需求文档
@@ -81,15 +81,15 @@ docs/
 
 | 目录 | 对应 Gate | 说明 |
 |------|----------|------|
-| `docs/tmp/` | 全部 | 过程临时产物，不入版本库 |
-| `docs/YYYY-MM-DD/requirements/` | Gate A | 需求澄清文档 |
-| `docs/YYYY-MM-DD/tasks/` | Gate B | 任务分解文档 |
-| `docs/YYYY-MM-DD/architecture/` | Gate B1 | 架构评审报告 |
-| `docs/YYYY-MM-DD/plans/` | Gate C | 执行计划 |
-| `docs/YYYY-MM-DD/implementation/` | Gate C-impl | 实现说明文档 |
-| `docs/YYYY-MM-DD/testing/` | Gate C2 | 测试用例与报告 |
-| `docs/YYYY-MM-DD/review/` | Gate D | 代码评审报告 |
-| `docs/YYYY-MM-DD/shipping/` | Gate E | 发布记录与版本日志 |
+| `.jarvis/tmp/` | 全部 | 过程临时产物，不入版本库 |
+| `.jarvis/YYYY-MM-DD/requirements/` | Gate A | 需求澄清文档 |
+| `.jarvis/YYYY-MM-DD/tasks/` | Gate B | 任务分解文档 |
+| `.jarvis/YYYY-MM-DD/architecture/` | Gate B1 | 架构评审报告 |
+| `.jarvis/YYYY-MM-DD/plans/` | Gate C | 执行计划 |
+| `.jarvis/YYYY-MM-DD/implementation/` | Gate C-impl | 实现说明文档 |
+| `.jarvis/YYYY-MM-DD/testing/` | Gate C2 | 测试用例与报告 |
+| `.jarvis/YYYY-MM-DD/review/` | Gate D | 代码评审报告 |
+| `.jarvis/YYYY-MM-DD/shipping/` | Gate E | 发布记录与版本日志 |
 
 ## 架构
 
@@ -175,7 +175,7 @@ GITHUB_TOKEN=xxx       # GitHub 个人访问令牌（sync-github-releases 需要
 | 流水线看板 | `#/dashboard` | 会话列表（任务名/指令标签/Gate状态）· MCP 平台接入状态 · 置顶/归档/删除 |
 | 归档记录 | `#/archive` | 已归档运行记录 · 按任务名搜索过滤 · 恢复到看板 · 永久删除 |
 | 智能体配置 | `#/agents` | MCP 接入指示 · Agent 搜索/筛选 · 模型/思考等级配置 · 文件同步 |
-| 项目介绍 | `/commands-reference.html` | 项目概览 · 40条指令流程详解 · 71个Agent目录 · 流水线架构 · 使用推荐 |
+| 项目介绍 | `/commands-reference.html` | 项目概览 · 31条指令流程详解 · 71个Agent目录 · 流水线架构 · 使用推荐 |
 
 侧边栏实时显示 Claude Code 的 MCP 连接状态：绿点 = 已接入，灰点 = 未接入。
 
@@ -325,7 +325,7 @@ test-doc-writer → test-executor → remediation-expert
 | | Claude Code |
 |---|:--:|
 | Agents | 71 |
-| Commands | 40 |
+| Commands | 30 |
 | Skills | 35 |
 | Pipeline | 15 条流水线（full/lite/frontend/backend/refactor/hotfix/migrate/evaluate/debug/research/release/ask/simplify/trace/improve） |
 | 钩子 | settings.json |
@@ -368,7 +368,7 @@ test-doc-writer → test-executor → remediation-expert
 
 ## 命令流程图
 
-每个 Claude Code 命令的完整介绍，包含项目概览、40条指令的详细流程（含 Gate 序列和 Agent spawn 关系）、71个智能体目录、流水线架构和使用推荐：[项目介绍页](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/blob/main/web/public/commands-reference.html)
+每个 Claude Code 命令的完整介绍，包含项目概览、31条指令的详细流程（含 Gate 序列和 Agent spawn 关系）、71个智能体目录、流水线架构和使用推荐：[项目介绍页](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/blob/main/web/public/commands-reference.html)
 
 | 分类 | 命令 | 流程图 | Gate 序列 |
 |------|------|--------|----------|

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-agent-factory",
-  "version": "4.3.7",
+  "version": "4.4.0",
   "description": "Jarvis Agent Factory CLI — Claude Code 多智能体 AI 编程助手配置安装器 | Multi-agent AI coding assistant config installer for Claude Code",
   "keywords": [
     "jarvis",

package/dist/src/cli/commands/deepinit.d.ts

@@ -0,0 +1,2 @@
+import type { CliOpts } from '../utils/args.js';
+export declare function execute(opts: CliOpts, positional: string[]): Promise<void>;

package/dist/src/cli/commands/deepinit.js

@@ -0,0 +1,98 @@
+import { resolve, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { scanDirectory, flattenTree, generateAll, generateAllParallel, generateAllSmart, writeDocs, generateIncremental, generateIncrementalParallel, validateHierarchy, scanDirectories, loadManifest, saveManifest, computeDiff, changedPaths, } from '../../deepinit/index.js';
+export async function execute(opts, positional) {
+    const target = resolve(positional[1] || process.cwd());
+    const force = opts.yes || false;
+    const smart = opts.smart || false;
+    const parallel = opts.parallel !== false; // Default: parallel on
+    const jobs = typeof opts.jobs === 'number' ? opts.jobs : 0; // 0 = unlimited
+    if (!existsSync(target)) {
+        console.error(`\n❌  Target directory does not exist: ${target}`);
+        process.exit(1);
+    }
+    const manifestPath = join(target, '.omc', 'deepinit-manifest.json');
+    const prevManifest = loadManifest(manifestPath);
+    const isFirstRun = !prevManifest;
+    console.log(`\n🔍 Scanning project tree: ${target}`);
+    const modeTags = [];
+    if (smart)
+        modeTags.push('smart dispatch');
+    if (parallel && !smart)
+        modeTags.push('parallel');
+    if (!parallel && !smart)
+        modeTags.push('sequential');
+    if (isFirstRun) {
+        console.log(`   (first run — full generation, ${modeTags.join(' + ')})\n`);
+    }
+    else {
+        console.log(`   (incremental — manifest from ${prevManifest.generatedAt}, ${modeTags.join(' + ')})\n`);
+    }
+    // 1. Scan directory tree
+    const root = scanDirectory(target);
+    if (!root) {
+        console.error('❌  No files found in target directory.');
+        process.exit(1);
+    }
+    const flat = flattenTree(root);
+    // 2. Scan manifest-structured directories for diff
+    const dirs = scanDirectories(target);
+    const diff = computeDiff(prevManifest?.directories ?? null, dirs);
+    const changed = new Set(changedPaths(diff));
+    // 3. Generate (full or incremental, smart/parallel/sequential)
+    let results;
+    if (isFirstRun || force) {
+        if (smart) {
+            results = generateAllSmart(flat, target);
+        }
+        else if (parallel) {
+            results = generateAllParallel(flat, target, jobs);
+        }
+        else {
+            results = generateAll(flat, target);
+        }
+    }
+    else {
+        if (parallel) {
+            results = generateIncrementalParallel(flat, changed, target, jobs);
+        }
+        else {
+            results = generateIncremental(flat, changed, target);
+        }
+    }
+    if (results.length === 0 && !isFirstRun) {
+        console.log('   No directories changed since last run.');
+        console.log(`\n✅ DeepInit complete (nothing to update).\n`);
+        return;
+    }
+    // 4. Write
+    const stats = writeDocs(results, { force });
+    // 5. Validate
+    const allDirs = flat.map(e => e.absPath);
+    const validation = validateHierarchy(target, allDirs.map(d => {
+        const rel = d.replace(target, '').replace(/^[/\\]/, '');
+        return rel || '.';
+    }));
+    // 6. Save manifest for next run
+    saveManifest(manifestPath, dirs);
+    // 7. Report
+    const dirCount = Object.keys(dirs).length;
+    const changedCount = diff.summary.added + diff.summary.modified + diff.summary.deleted;
+    console.log(`   Written:  ${stats.written} AGENTS.md${stats.skipped > 0 ? ` (${stats.skipped} skipped)` : ''}`);
+    console.log(`   Manifest: ${dirCount} directories tracked`);
+    console.log(`   Diff:     +${diff.summary.added} ~${diff.summary.modified} -${diff.summary.deleted} =${diff.summary.unchanged} unchanged (${changedCount} affected)`);
+    if (smart) {
+        console.log(`   Mode:     smart dispatch (deep file analysis + project type detection)`);
+    }
+    else if (parallel) {
+        console.log(`   Mode:     parallel (by-depth grouping${jobs > 0 ? `, ${jobs} jobs` : ''})`);
+    }
+    if (!validation.valid) {
+        console.log(`   ⚠  Validation: ${validation.issues.length} issues found`);
+        for (const issue of validation.issues.slice(0, 5)) {
+            console.log(`     - ${issue}`);
+        }
+    }
+    console.log(`\n✅ DeepInit complete.\n`);
+}
+//# sourceMappingURL=deepinit.js.map

package/dist/src/cli/commands/deepinit.js.map

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

package/dist/src/cli/index.js

@@ -16,6 +16,7 @@ const COMMANDS = {
     resolve: () => import('./commands/resolve.js'),
     doctor: () => import('./commands/doctor.js'),
     check: () => import('./commands/doctor.js'),
+    deepinit: () => import('./commands/deepinit.js'),
 };
 export async function run() {
     const { opts, positional } = parseArgs(process.argv.slice(2));

package/dist/src/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK3D,MAAM,QAAQ,GAA6C;IACzD,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,GAAG,EAAM,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAC1C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,EAAE,EAAO,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,KAAK,EAAI,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;CAC9C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,SAAS;IACT,IAAI,IAAI,CAAC,IAAI,EAAK,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACzD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,KAAK,WAAW,EAAE,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,eAAe,QAAQ,SAAS,CAAC,CAAC;QAChF,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAEpC,8CAA8C;IAC9C,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC5D,MAAM,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;IAC3B,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK3D,MAAM,QAAQ,GAA6C;IACzD,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,GAAG,EAAM,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAC1C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,EAAE,EAAO,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,MAAM,EAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC7C,IAAI,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAC3C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAC9C,MAAM,EAAI,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC9C,KAAK,EAAK,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAC9C,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;CACjD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,SAAS;IACT,IAAI,IAAI,CAAC,IAAI,EAAK,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACzD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,KAAK,WAAW,EAAE,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,eAAe,QAAQ,SAAS,CAAC,CAAC;QAChF,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAEpC,8CAA8C;IAC9C,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC5D,MAAM,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;IAC3B,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/cli/utils/args.d.ts

@@ -7,6 +7,12 @@ export interface CliOpts {
     globalExplicit: boolean;
     help?: boolean;
     version?: boolean;
+    /** DeepInit: 启用智能分派模式（深度文件分析 + 项目类型检测） */
+    smart?: boolean;
+    /** DeepInit: 禁用并行生成（默认启用） */
+    parallel?: boolean;
+    /** DeepInit: 并行任务数限制（0 = 无限制） */
+    jobs?: number;
 }
 /**
  * 手动解析命令行参数（不引入 Commander.js，遵循 ADR-5）
@@ -16,6 +22,9 @@ export interface CliOpts {
  *   -g, --global    全局安装
  *   -h, --help      显示帮助
  *   -v, --version   显示版本
+ *   --smart         DeepInit 智能分派模式
+ *   --no-parallel   DeepInit 禁用并行生成
+ *   --jobs <n>      DeepInit 并行任务数限制
  *
  * @param raw - process.argv.slice(2) 原始参数数组
  * @returns 解析后的选项和位置参数

package/dist/src/cli/utils/args.js

@@ -6,6 +6,9 @@
  *   -g, --global    全局安装
  *   -h, --help      显示帮助
  *   -v, --version   显示版本
+ *   --smart         DeepInit 智能分派模式
+ *   --no-parallel   DeepInit 禁用并行生成
+ *   --jobs <n>      DeepInit 并行任务数限制
  *
  * @param raw - process.argv.slice(2) 原始参数数组
  * @returns 解析后的选项和位置参数
@@ -13,7 +16,8 @@
 export function parseArgs(raw) {
     const opts = { yes: false, global: false, globalExplicit: false };
     const positional = [];
-    for (const a of raw) {
+    for (let i = 0; i < raw.length; i++) {
+        const a = raw[i];
         if (a === '-y' || a === '--yes') {
             opts.yes = true;
         }
@@ -29,6 +33,22 @@ export function parseArgs(raw) {
             opts.version = true;
             return { opts, positional };
         }
+        else if (a === '--smart') {
+            opts.smart = true;
+        }
+        else if (a === '--no-parallel') {
+            opts.parallel = false;
+        }
+        else if (a === '--jobs' && i + 1 < raw.length) {
+            const n = parseInt(raw[++i], 10);
+            if (!isNaN(n) && n > 0)
+                opts.jobs = n;
+        }
+        else if (a.startsWith('--jobs=')) {
+            const n = parseInt(a.slice(7), 10);
+            if (!isNaN(n) && n > 0)
+                opts.jobs = n;
+        }
         else {
             positional.push(a);
         }

package/dist/src/cli/utils/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../../src/cli/utils/args.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,MAAM,IAAI,GAAY,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../../src/cli/utils/args.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,MAAM,IAAI,GAAY,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/deepinit/generator.d.ts

@@ -0,0 +1,79 @@
+import type { DirEntry } from './scanner.js';
+export interface GenContext {
+    entry: DirEntry;
+    rootDir: string;
+    now: string;
+}
+/**
+ * 为单个目录生成 AGENTS.md 内容。
+ */
+export declare function generateAgentsMd(entry: DirEntry, parentRel: string | null, ctx: GenContext): string;
+/**
+ * 为单个目录生成 CLAUDE.md 内容（极简引导）。
+ * 仅当目录是根或包含 src/ 等关键目录时生成。
+ */
+export declare function generateClaudeMd(entry: DirEntry, hasParentAgents: boolean, ctx: GenContext): string;
+/**
+ * 生成整个目录树的文档文件（顺序模式，保证层级兼容）。
+ */
+export declare function generateAll(flatEntries: DirEntry[], rootDir: string): {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[];
+/**
+ * 并行生成整个目录树的文档文件。
+ * 按深度分层：同层目录并行处理，层间串行保证父子引用正确。
+ */
+export declare function generateAllParallel(flatEntries: DirEntry[], rootDir: string, concurrency?: number): {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[];
+/**
+ * 将生成的文档写入文件系统。
+ */
+export declare function writeDocs(results: {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[], opts?: {
+    force?: boolean;
+}): {
+    written: number;
+    skipped: number;
+};
+/**
+ * 增量生成：基于 manifest diff 结果，仅重新生成变化目录的文档。
+ * 祖先级联已在 computeDiff 中处理——变化的祖先目录自动包含在 changedRelPaths 中。
+ */
+export declare function generateIncremental(flatEntries: DirEntry[], changedRelPaths: Set<string>, rootDir: string): {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[];
+/**
+ * 并行增量生成：按深度分层，同层并行处理变更目录。
+ */
+export declare function generateIncrementalParallel(flatEntries: DirEntry[], changedRelPaths: Set<string>, rootDir: string, concurrency?: number): {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[];
+/**
+ * 验证生成的 AGENTS.md 层级完整性。
+ * 检查：父级引用可解析、无孤儿文件、目录覆盖完整。
+ */
+export declare function validateHierarchy(rootDir: string, generatedDirs: string[]): {
+    valid: boolean;
+    issues: string[];
+};
+/**
+ * Agent 智能分派模式：深度读取文件内容，检测项目类型，生成更精准的文档。
+ * 对应 OMC 的 explore agent（目录扫描）+ architect agent（文件分析）+ writer agent（内容生成）三层分派。
+ */
+export declare function generateAllSmart(flatEntries: DirEntry[], rootDir: string): {
+    dir: string;
+    agents: string;
+    claude: string | null;
+}[];