spectra-cli 4.1.1

package/dist/utils/specify-template-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specify-template-sync.js","sourceRoot":"","sources":["../../src/utils/specify-template-sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,kBAAkB,GAAG;IACzB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,uBAAuB;IACvB,0BAA0B;IAC1B,wBAAwB;IACxB,uBAAuB;IACvB,8BAA8B;IAC9B,2BAA2B;IAC3B,gCAAgC;IAChC,iCAAiC;CACzB,CAAC;AAeX,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,6BAA6B;QAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,kDAAkD,CAAC;QAC3E,gCAAgC;QAChC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,0BAA0B,CAAC;QACnD,uCAAuC;QACvC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,4CAA4C,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,YAAoB,EACpB,UAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAChE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,UAAyC,EAAE;IAE3C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAClE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,YAAY,IAAI,kBAAkB,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/watcher/file-watcher.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 文件监听核心模块
+ * 封装 chokidar v4.x，提供 debounce、.gitignore 过滤和变更分类能力
+ */
+/** 变更文件分类 */
+export type ChangeCategory = 'code' | 'docs' | 'config';
+/** 单个文件变更事件 */
+export interface FileChangeEvent {
+    /** 变更文件的绝对路径 */
+    path: string;
+    /** 文件类型分类 */
+    category: ChangeCategory;
+}
+/** FileWatcher 初始化选项 */
+export interface WatchOptions {
+    /** 监听的项目根目录 */
+    projectRoot: string;
+    /** debounce 时长（毫秒），默认 3000 */
+    debounceMs?: number;
+    /** 是否打印详细日志 */
+    verbose?: boolean;
+}
+/** 控制台输出分类标签 */
+export declare const CATEGORY_LABEL: Record<ChangeCategory, string>;
+/**
+ * 按文件扩展名判断变更分类
+ */
+export declare function classifyChange(filePath: string): ChangeCategory;
+/**
+ * 读取并解析 .gitignore 文件，合并内置默认忽略规则
+ * @param projectRoot 项目根目录
+ * @returns 忽略规则字符串数组（用于 chokidar ignored 选项）
+ */
+export declare function loadIgnorePatterns(projectRoot: string): string[];
+/** 文件变更回调签名 */
+type OnChangeCallback = (files: FileChangeEvent[]) => void;
+/**
+ * 文件监听器
+ * 优先使用 chokidar v4.x；初始化失败时降级到 fs.watch 递归轮询（5 秒间隔）
+ */
+export declare class FileWatcher {
+    private readonly projectRoot;
+    private readonly debounceMs;
+    private readonly verbose;
+    private readonly ignoredPatterns;
+    private debounceTimer;
+    private pendingChanges;
+    private onChange;
+    private watcher;
+    constructor(options: WatchOptions, onChange: OnChangeCallback);
+    /**
+     * 启动文件监听
+     * 优先尝试 chokidar，失败时降级到 fs.watch
+     */
+    start(): Promise<void>;
+    /**
+     * 停止文件监听，清理计时器和 watcher
+     */
+    stop(): Promise<void>;
+    /**
+     * 尝试使用 chokidar v4.x 启动监听
+     * chokidar v4.x 是 ESM-only，必须用动态 import()
+     */
+    private startChokidar;
+    /**
+     * 降级到 fs.watch 递归模式
+     * 用于 chokidar 初始化失败的情况
+     */
+    private startFsWatch;
+    /**
+     * 处理原始文件变更事件
+     * 将文件加入 pendingChanges，并重置 debounce 计时器
+     */
+    private handleRawChange;
+}
+export {};
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,aAAa;AACb,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD,eAAe;AACf,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2BD,gBAAgB;AAChB,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAIzD,CAAC;AAMF;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAehE;AAMD,eAAe;AACf,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;AAE3D;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAG3C,OAAO,CAAC,aAAa,CAA8C;IAEnE,OAAO,CAAC,cAAc,CAA0B;IAEhD,OAAO,CAAC,QAAQ,CAAmB;IAInC,OAAO,CAAC,OAAO,CAAa;gBAEhB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB;IAQ7D;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B;;;OAGG;YACW,aAAa;IA4C3B;;;OAGG;IACH,OAAO,CAAC,YAAY;IA0BpB;;;OAGG;IACH,OAAO,CAAC,eAAe;CA2BxB"}

package/dist/watcher/file-watcher.js

@@ -0,0 +1,233 @@
+/**
+ * 文件监听核心模块
+ * 封装 chokidar v4.x，提供 debounce、.gitignore 过滤和变更分类能力
+ */
+import { readFileSync, existsSync, watch as fsWatch } from 'node:fs';
+import { resolve, extname, normalize, sep } from 'node:path';
+// ---------------------------------------------------------------------------
+// 扩展名分类映射
+// ---------------------------------------------------------------------------
+/** 代码文件扩展名集合 */
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.go', '.rs', '.java', '.kt', '.swift',
+    '.rb', '.php', '.c', '.cpp', '.h', '.cs',
+]);
+/** 文档文件扩展名集合 */
+const DOC_EXTENSIONS = new Set([
+    '.md', '.mdx', '.txt', '.rst', '.adoc',
+]);
+/** 配置文件扩展名集合 */
+const CONFIG_EXTENSIONS = new Set([
+    '.json', '.yaml', '.yml', '.toml', '.env',
+    '.ini', '.xml', '.lock',
+]);
+/** 内置默认忽略规则 */
+const DEFAULT_IGNORED = ['.git', 'node_modules', 'dist', 'specs', '_meta'];
+/** 控制台输出分类标签 */
+export const CATEGORY_LABEL = {
+    code: '[代码变更]',
+    docs: '[文档变更]',
+    config: '[配置变更]',
+};
+// ---------------------------------------------------------------------------
+// 工具函数
+// ---------------------------------------------------------------------------
+/**
+ * 按文件扩展名判断变更分类
+ */
+export function classifyChange(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (CODE_EXTENSIONS.has(ext))
+        return 'code';
+    if (DOC_EXTENSIONS.has(ext))
+        return 'docs';
+    if (CONFIG_EXTENSIONS.has(ext))
+        return 'config';
+    // 默认归为代码变更
+    return 'code';
+}
+/**
+ * 读取并解析 .gitignore 文件，合并内置默认忽略规则
+ * @param projectRoot 项目根目录
+ * @returns 忽略规则字符串数组（用于 chokidar ignored 选项）
+ */
+export function loadIgnorePatterns(projectRoot) {
+    const gitignorePath = resolve(projectRoot, '.gitignore');
+    const patterns = [...DEFAULT_IGNORED];
+    if (existsSync(gitignorePath)) {
+        const lines = readFileSync(gitignorePath, 'utf-8').split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // 跳过注释行和空行
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            patterns.push(trimmed);
+        }
+    }
+    return patterns;
+}
+/**
+ * 文件监听器
+ * 优先使用 chokidar v4.x；初始化失败时降级到 fs.watch 递归轮询（5 秒间隔）
+ */
+export class FileWatcher {
+    projectRoot;
+    debounceMs;
+    verbose;
+    ignoredPatterns;
+    // debounce 计时器
+    debounceTimer = null;
+    // 待处理的变更文件集
+    pendingChanges = new Set();
+    // 变更回调
+    onChange;
+    // chokidar watcher 或 fs.FSWatcher 实例（类型宽松以兼容两种后端）
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    watcher = null;
+    constructor(options, onChange) {
+        this.projectRoot = options.projectRoot;
+        this.debounceMs = options.debounceMs ?? 3000;
+        this.verbose = options.verbose ?? false;
+        this.ignoredPatterns = loadIgnorePatterns(options.projectRoot);
+        this.onChange = onChange;
+    }
+    /**
+     * 启动文件监听
+     * 优先尝试 chokidar，失败时降级到 fs.watch
+     */
+    async start() {
+        try {
+            await this.startChokidar();
+        }
+        catch (err) {
+            console.warn('[watch] chokidar 初始化失败，降级到原生 fs.watch（轮询间隔 5 秒）');
+            if (this.verbose) {
+                console.warn('[watch] 降级原因:', err instanceof Error ? err.message : String(err));
+            }
+            this.startFsWatch();
+        }
+    }
+    /**
+     * 停止文件监听，清理计时器和 watcher
+     */
+    async stop() {
+        // 清理 debounce 计时器，避免泄漏
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        this.pendingChanges.clear();
+        if (this.watcher) {
+            // chokidar watcher 有 close() 方法（返回 Promise）
+            // fs.FSWatcher 有 close() 方法（同步）
+            try {
+                const result = this.watcher.close();
+                if (result instanceof Promise) {
+                    await result;
+                }
+            }
+            catch {
+                // 关闭时忽略错误
+            }
+            this.watcher = null;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // 私有方法
+    // ---------------------------------------------------------------------------
+    /**
+     * 尝试使用 chokidar v4.x 启动监听
+     * chokidar v4.x 是 ESM-only，必须用动态 import()
+     */
+    async startChokidar() {
+        // 动态导入 chokidar（ESM-only 包，必须用 dynamic import）
+        const chokidar = await import('chokidar');
+        const watchFn = chokidar.watch ?? chokidar.default?.watch;
+        if (typeof watchFn !== 'function') {
+            throw new Error('chokidar.watch 不是函数，包版本可能不兼容');
+        }
+        this.watcher = watchFn(this.projectRoot, {
+            ignored: this.ignoredPatterns,
+            ignoreInitial: true, // 启动时不触发已有文件的 add 事件
+            persistent: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 200,
+                pollInterval: 100,
+            },
+        });
+        // 挂载文件变更事件（add/change/unlink）
+        this.watcher.on('add', (filePath) => this.handleRawChange(filePath));
+        this.watcher.on('change', (filePath) => this.handleRawChange(filePath));
+        this.watcher.on('unlink', (filePath) => this.handleRawChange(filePath));
+        // Task 2：挂载 error 事件处理器，防止未捕获异常导致进程 crash
+        this.watcher.on('error', (err) => {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            console.error(`[watch] 文件监听器错误: ${errMsg}`);
+            if (this.verbose) {
+                console.error(err);
+            }
+        });
+        if (this.verbose) {
+            console.log(`[watch] chokidar 启动，监听目录: ${this.projectRoot}`);
+            console.log(`[watch] 忽略规则: ${this.ignoredPatterns.join(', ')}`);
+        }
+        // Task 3：等待 chokidar 完成初始目录扫描后再 resolve，保证 ready 后才打印"已就绪"
+        await new Promise((resolve) => {
+            this.watcher.once('ready', resolve);
+        });
+    }
+    /**
+     * 降级到 fs.watch 递归模式
+     * 用于 chokidar 初始化失败的情况
+     */
+    startFsWatch() {
+        // fs.watch 的 recursive 选项在 Node.js 20+ 全平台支持
+        this.watcher = fsWatch(this.projectRoot, { recursive: true }, (_eventType, filename) => {
+            if (!filename)
+                return;
+            const fullPath = resolve(this.projectRoot, filename);
+            // 简单过滤：检查路径是否包含忽略规则中的路径片段
+            const normalizedFull = normalize(fullPath);
+            const pathParts = normalizedFull.split(sep);
+            const shouldIgnore = this.ignoredPatterns.some((pattern) => {
+                // 去除尾部路径分隔符，取基础名称做路径分段匹配，避免 false-positive
+                const patternBase = pattern.replace(/[/\\]+$/, '');
+                return pathParts.includes(patternBase);
+            });
+            if (shouldIgnore)
+                return;
+            this.handleRawChange(fullPath);
+        });
+        if (this.verbose) {
+            console.log(`[watch] fs.watch 降级模式启动，监听目录: ${this.projectRoot}`);
+        }
+    }
+    /**
+     * 处理原始文件变更事件
+     * 将文件加入 pendingChanges，并重置 debounce 计时器
+     */
+    handleRawChange(filePath) {
+        this.pendingChanges.add(filePath);
+        if (this.verbose) {
+            console.log(`[watch] 检测到变更: ${filePath}`);
+        }
+        // 重置 debounce 计时器
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => {
+            // 快照当前变更集，清空内部状态
+            const snapshot = new Set(this.pendingChanges);
+            this.pendingChanges.clear();
+            this.debounceTimer = null;
+            // 构建 FileChangeEvent 数组并触发回调
+            const events = Array.from(snapshot).map((p) => ({
+                path: p,
+                category: classifyChange(p),
+            }));
+            this.onChange(events);
+        }, this.debounceMs);
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/watcher/file-watcher.js.map

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

package/dist/watcher/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * watcher 模块公开 API 导出
+ */
+export { FileWatcher, classifyChange, loadIgnorePatterns, CATEGORY_LABEL } from './file-watcher.js';
+export type { FileChangeEvent, WatchOptions, ChangeCategory } from './file-watcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/watcher/index.js

@@ -0,0 +1,5 @@
+/**
+ * watcher 模块公开 API 导出
+ */
+export { FileWatcher, classifyChange, loadIgnorePatterns, CATEGORY_LABEL } from './file-watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/grammars/manifest.json

@@ -0,0 +1,28 @@
+{
+  "abiVersion": 14,
+  "webTreeSitterVersion": "0.24.7",
+  "wasmsPackageVersion": "0.1.13",
+  "generatedAt": "2026-03-17T09:56:48Z",
+  "grammars": {
+    "python": {
+      "wasmFile": "tree-sitter-python.wasm",
+      "sha256": "9056d0fb0c337810d019fae350e8167786119da98f0f282aceae7ab89ee8253b"
+    },
+    "go": {
+      "wasmFile": "tree-sitter-go.wasm",
+      "sha256": "9963ca89b616eaf04b08a43bc1fb0f07b85395bec313330851f1f1ead2f755b6"
+    },
+    "java": {
+      "wasmFile": "tree-sitter-java.wasm",
+      "sha256": "637aac4415fb39a211a4f4292d63c66b5ce9c32fa2cd35464af4f681d91b9a1f"
+    },
+    "typescript": {
+      "wasmFile": "tree-sitter-typescript.wasm",
+      "sha256": "8515404dceed38e1ed86aa34b09fcf3379fff1b4ff9dd3967bcd6d1eb5ac3d8f"
+    },
+    "javascript": {
+      "wasmFile": "tree-sitter-javascript.wasm",
+      "sha256": "63812b9e275d26851264734868d27a1656bd44a2ef6eb3e85e6b03728c595ab5"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "spectra-cli",
+  "version": "4.1.1",
+  "description": "通过 AST 静态分析 + LLM 混合流水线，将源代码逆向工程为结构化 Spec 文档的多语言代码分析平台",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "spectra": "dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "grammars/",
+    "queries/",
+    "scripts/lifecycle-runner.cjs",
+    "plugins/",
+    "templates/",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "tsx scripts/inline-d3.ts",
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:e2e": "vitest run --project e2e",
+    "lint": "tsc --noEmit",
+    "docs:sync:agents": "node scripts/sync-agent-docs.mjs",
+    "repo:sync": "node scripts/repo-sync.mjs",
+    "repo:check": "node scripts/repo-check.mjs",
+    "release:sync": "node scripts/sync-release-contracts.mjs",
+    "release:check": "node scripts/validate-release-contracts.mjs",
+    "baseline:collect": "node scripts/baseline-collect.mjs",
+    "baseline:diff": "node scripts/baseline-diff.mjs",
+    "hooks:install": "bash scripts/install-hooks.sh",
+    "hooks:check": "bash scripts/check-plugin-sync.sh",
+    "worktree:sync-local-state": "bash scripts/sync-worktree-local-state.sh",
+    "spec-driver:check:wrappers": "node plugins/spec-driver/scripts/validate-wrapper-sources.mjs --project-root . --json",
+    "spectra:sync:skills": "node plugins/spectra/scripts/sync-skill-mirrors.mjs --project-root . --json",
+    "spectra:check:skills": "node plugins/spectra/scripts/validate-skill-sources.mjs --project-root . --json",
+    "codex:spec-driver:install": "bash plugins/spec-driver/scripts/codex-skills.sh install",
+    "codex:spec-driver:install:global": "bash plugins/spec-driver/scripts/codex-skills.sh install --global",
+    "codex:spec-driver:remove": "bash plugins/spec-driver/scripts/codex-skills.sh remove",
+    "codex:spec-driver:remove:global": "bash plugins/spec-driver/scripts/codex-skills.sh remove --global",
+    "release:publish": "npm publish",
+    "release:publish:dry": "npm publish --dry-run",
+    "prepublishOnly": "npm run release:check && npm run repo:check && npm run build && npx vitest run",
+    "postinstall": "node scripts/lifecycle-runner.cjs postinstall",
+    "preuninstall": "node scripts/lifecycle-runner.cjs preuninstall"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "chokidar": "^4.0.3",
+    "dependency-cruiser": "^16.8.0",
+    "graphology": "^0.26.0",
+    "graphology-communities-louvain": "^2.0.2",
+    "graphology-types": "^0.24.8",
+    "handlebars": "^4.7.8",
+    "p-limit": "^6.1.0",
+    "ts-morph": "^24.0.0",
+    "web-tree-sitter": "^0.24.7",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "@vitest/coverage-v8": "^3.0.4",
+    "d3-force": "^3.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "optionalDependencies": {
+    "@huggingface/transformers": "^3.x"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/plugins/spec-driver/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "spec-driver",
+  "version": "4.0.0",
+  "description": "自治研发编排器——支持 feature/implement/story/fix/resume/sync/doc/refactor 八种模式自动执行 Spec-Driven Development 全流程，基于 orchestration.yaml 配置驱动编排，含 6 个质量门禁、sync 确定性合并引擎，以及项目级 orchestration overrides 分层定制",
+  "author": {
+    "name": "Connor Lu"
+  },
+  "license": "MIT",
+  "keywords": [
+    "orchestrator",
+    "spec-driven",
+    "autonomous",
+    "claude-code",
+    "spec-driver"
+  ]
+}