speccore 5.4.3 → 5.5.0

package/dist/commands/sync.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * sync - 反向同步命令
+ * 检测代码与 Spec 的差异，更新 Spec 文件
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncCommand = syncCommand;
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const transaction_1 = require("../core/transaction");
+const reverse_sync_1 = require("../core/reverse-sync");
+async function syncCommand(options) {
+    if (!options.task && !options.iteration) {
+        logger_1.logger.error('请指定要同步的 Task 或期次。用法: speccore sync --task=<Task编号> [--auto]');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在检测 Spec 差异...');
+    spinner.start();
+    try {
+        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
+        if (!iteration) {
+            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
+            return;
+        }
+        if (options.dryRun) {
+            await dryRunSync(options, iteration);
+            // Show reverse sync preview in dry-run mode
+            const rootDir = process.cwd();
+            logger_1.logger.info('');
+            logger_1.logger.info('🔍 Scanning code for @spec annotations...');
+            const refs = await (await Promise.resolve().then(() => __importStar(require('../core/reverse-sync')))).scanCodeForSpecAnnotations(rootDir);
+            logger_1.logger.info(`   Found ${refs.length} @spec references in code`);
+            spinner.stop('差异分析完成（--dry-run 模式，未实际同步）');
+            return;
+        }
+        if (options.task) {
+            await syncTaskSpec(options.task, iteration, options.auto || false);
+        }
+        else {
+            await syncIterationSpec(iteration, options.auto || false);
+        }
+        spinner.stop('Spec 同步完成');
+        logger_1.logger.info('');
+        // Real time reverse sync: scan code → update TASK.md
+        const rootDir = process.cwd();
+        logger_1.logger.info('🔄 Reverse sync: scanning code for @spec annotations...');
+        const result = await (0, reverse_sync_1.reverseSync)(rootDir, iteration);
+        if (result.length > 0) {
+            logger_1.logger.success(`Reverse sync complete: ${result.length} tasks updated`);
+        }
+        else {
+            logger_1.logger.info('   No @spec references found in code');
+        }
+        logger_1.logger.info('💡 提示: 运行 speccore validate 确保同步后的 Spec 完整性');
+    }
+    catch (error) {
+        spinner.fail(`同步失败: ${error}`);
+        throw error;
+    }
+}
+async function dryRunSync(options, iteration) {
+    logger_1.logger.info('🔍 Spec 差异分析报告：');
+    logger_1.logger.info('');
+    if (options.task) {
+        await analyzeTaskDiff(options.task, iteration);
+    }
+    else {
+        logger_1.logger.info('📊 期次级差异分析：');
+        logger_1.logger.info(`   期次: ${iteration}`);
+        // 扫描所有任务
+        const iterDir = (0, path_1.join)(process.cwd(), iteration);
+        if (await (0, fs_extra_1.pathExists)(iterDir)) {
+            const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+            const entries = await readdir(iterDir);
+            const tasks = entries.filter((e) => e.startsWith('Task-'));
+            for (const task of tasks) {
+                await analyzeTaskDiff(task, iteration);
+            }
+        }
+    }
+}
+async function analyzeTaskDiff(task, iteration) {
+    const taskDir = (0, path_1.join)(process.cwd(), iteration, task);
+    if (!await (0, fs_extra_1.pathExists)(taskDir)) {
+        logger_1.logger.warn(`   任务 ${task} 目录不存在，跳过`);
+        return;
+    }
+    logger_1.logger.info(`📋 ${task}:`);
+    // 检查必需文件 + 内容分析
+    const checks = [
+        { file: '.task-type', label: '任务类型' },
+        { file: 'backend/REQ.md', label: '后端需求', check: (c) => c.includes('## 需求描述'), warn: '缺少需求描述章节' },
+        { file: 'backend/TECH.md', label: '后端方案', check: (c) => c.includes('## 技术'), warn: '缺少技术方案章节' },
+        { file: 'backend/TASK.md', label: '任务追踪', check: (c) => c.includes('变更履历'), warn: '缺少变更履历' },
+        { file: '_shared/API_CONTRACT.yaml', label: 'API契约', check: (c) => c.includes('api:') || c.includes('paths:'), warn: '缺少 API 定义' },
+    ];
+    for (const { file, label, check, warn } of checks) {
+        const filePath = (0, path_1.join)(taskDir, file);
+        if (await (0, fs_extra_1.pathExists)(filePath)) {
+            const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+            if (check && !check(content)) {
+                logger_1.logger.warn(`   ⚠️ ${label}: ${warn}`);
+            }
+            else {
+                logger_1.logger.info(`   ✅ ${label}`);
+            }
+        }
+        else {
+            logger_1.logger.warn(`   ❌ ${label}: 文件缺失`);
+        }
+    }
+}
+async function syncTaskSpec(task, iteration, auto) {
+    const taskDir = (0, path_1.join)(process.cwd(), iteration, task);
+    const tx = new transaction_1.FileTransaction();
+    if (!await (0, fs_extra_1.pathExists)(taskDir)) {
+        logger_1.logger.error(`任务目录不存在: ${taskDir}`);
+        return;
+    }
+    // 更新 TASK.md 中的变更履历
+    const taskMdPath = (0, path_1.join)(taskDir, 'backend', 'TASK.md');
+    if (await (0, fs_extra_1.pathExists)(taskMdPath)) {
+        let content = await (0, fs_extra_1.readFile)(taskMdPath, 'utf-8');
+        const now = new Date().toISOString().split('T')[0];
+        if (!auto) {
+            logger_1.logger.info(`当前 TASK.md 状态:`);
+            const historyMatch = content.match(/变更履历[\s\S]*?(?=\n##\s)/);
+            if (historyMatch) {
+                logger_1.logger.info(historyMatch[0].substring(0, 300));
+            }
+        }
+        // 自动模式下添加上下文更新记录（使用事务）
+        if (auto) {
+            const syncEntry = `| ${now} | auto | 自动反向同步: 更新 Spec 文件 | SpecCore |\n`;
+            const updated = content.replace(/(\| :--- \| :--- \| :--- \| :--- \|)/, `$1\n${syncEntry}`);
+            tx.write(taskMdPath, updated);
+        }
+    }
+    // 同步前端各平台 TASK.md
+    const frontendDir = (0, path_1.join)(taskDir, 'frontend');
+    if (await (0, fs_extra_1.pathExists)(frontendDir)) {
+        const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+        const platformDirs = await readdir(frontendDir, { withFileTypes: true });
+        for (const pd of platformDirs) {
+            if (pd.isDirectory()) {
+                const ftaskPath = (0, path_1.join)(frontendDir, pd.name, 'TASK.md');
+                if (await (0, fs_extra_1.pathExists)(ftaskPath) && auto) {
+                    let content = await (0, fs_extra_1.readFile)(ftaskPath, 'utf-8');
+                    const now = new Date().toISOString().split('T')[0];
+                    const syncEntry = `| ${now} | auto | 自动反向同步: 更新 Spec 文件 | SpecCore |\n`;
+                    const updated = content.replace(/(\| :--- \| :--- \| :--- \| :--- \|)/, `$1\n${syncEntry}`);
+                    tx.write(ftaskPath, updated);
+                }
+            }
+        }
+    }
+    // 提交事务 — 原子写入所有变更
+    if (tx.length > 0) {
+        await tx.commit();
+        logger_1.logger.info(`✅ 已同步: ${task}/ (${tx.length} 个文件，事务保护)`);
+    }
+}
+async function syncIterationSpec(iteration, auto) {
+    const iterDir = (0, path_1.join)(process.cwd(), iteration);
+    if (!await (0, fs_extra_1.pathExists)(iterDir)) {
+        logger_1.logger.error(`期次目录不存在: ${iterDir}`);
+        return;
+    }
+    const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+    const entries = await readdir(iterDir);
+    const tasks = entries.filter((e) => e.startsWith('Task-'));
+    const total = tasks.length;
+    logger_1.logger.info(`正在同步期次 ${iteration} 的 ${total} 个任务...`);
+    let synced = 0;
+    for (const task of tasks) {
+        await syncTaskSpec(task, iteration, auto);
+        synced++;
+    }
+    logger_1.logger.info(`✅ 已同步 ${synced}/${total} 个任务`);
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/template-add.d.ts

@@ -0,0 +1,12 @@
+/**
+ * template-add - 添加代码生成模板命令
+ * 将现有代码提取为可复用的模板，保存到 .speccore/PATTERNS/TEMPLATES/
+ */
+export interface TemplateAddOptions {
+    name?: string;
+    type?: string;
+    files?: string;
+    desc?: string;
+}
+export declare function templateAddCommand(options: TemplateAddOptions): Promise<void>;
+//# sourceMappingURL=template-add.d.ts.map

package/dist/commands/template-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-add.d.ts","sourceRoot":"","sources":["../../src/commands/template-add.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DnF"}

package/dist/commands/template-add.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * template-add - 添加代码生成模板命令
+ * 将现有代码提取为可复用的模板，保存到 .speccore/PATTERNS/TEMPLATES/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateAddCommand = templateAddCommand;
+const logger_1 = require("../utils/logger");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+async function templateAddCommand(options) {
+    if (!options.name) {
+        logger_1.logger.error('请提供模板名称。用法: speccore template-add --name "<模板名>" --type=<类型> --files=<文件路径>');
+        return;
+    }
+    if (!options.files) {
+        logger_1.logger.error('请提供代码文件路径。用法: speccore template-add --files=<文件路径>');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在添加代码模板...');
+    spinner.start();
+    try {
+        const templateType = options.type || 'crud';
+        const templateDir = (0, path_1.join)(process.cwd(), '.speccore', 'PATTERNS', 'TEMPLATES', templateType, options.name);
+        await (0, fs_extra_1.ensureDir)(templateDir);
+        // 复制代码文件
+        const filePaths = options.files.split(',').map((f) => f.trim());
+        for (const filePath of filePaths) {
+            const fileName = (0, path_1.basename)(filePath);
+            await (0, fs_extra_1.copy)(filePath, (0, path_1.join)(templateDir, fileName));
+            logger_1.logger.info(`✅ 已复制: ${fileName}`);
+        }
+        // 创建模板描述文件
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(templateDir, 'README.md'), `# ${options.name} 模板\n\n` +
+            `- **类型**: ${templateType}\n` +
+            `- **描述**: ${options.desc || '请补充模板描述'}\n` +
+            `- **创建日期**: ${new Date().toISOString().split('T')[0]}\n` +
+            `- **文件列表**:\n${filePaths.map((f) => `  - ${(0, path_1.basename)(f)}`).join('\n')}\n`);
+        // 更新 PATTERNS/README.md 索引
+        const patternsReadme = (0, path_1.join)(process.cwd(), '.speccore', 'PATTERNS', 'README.md');
+        if (await (0, fs_extra_1.pathExists)(patternsReadme)) {
+            let content = await (0, fs_extra_1.readFile)(patternsReadme, 'utf-8');
+            const entry = `| ${options.name} | ${templateType} | ${options.desc || '-'} | ${new Date().toISOString().split('T')[0]} |\n`;
+            if (!content.includes(options.name)) {
+                content += entry;
+                await (0, fs_extra_1.writeFile)(patternsReadme, content);
+            }
+        }
+        spinner.stop(`模板 "${options.name}" 已添加`);
+        logger_1.logger.info('');
+        logger_1.logger.info(`📄 模板详情:`);
+        logger_1.logger.info(`   名称: ${options.name}`);
+        logger_1.logger.info(`   类型: ${templateType}`);
+        logger_1.logger.info(`   位置: .speccore/PATTERNS/TEMPLATES/${templateType}/${options.name}/`);
+        logger_1.logger.info(`   文件数: ${filePaths.length}`);
+        if (options.desc) {
+            logger_1.logger.info(`   描述: ${options.desc}`);
+        }
+    }
+    catch (error) {
+        spinner.fail(`添加模板失败: ${error}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=template-add.js.map

package/dist/commands/template-add.js.map

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

package/dist/commands/welcome.d.ts

@@ -0,0 +1,9 @@
+/**
+ * welcome - 首次使用引导命令
+ * 交互式引导新用户完成第一个完整功能开发
+ */
+export interface WelcomeOptions {
+    force?: boolean;
+}
+export declare function welcomeCommand(options: WelcomeOptions): Promise<void>;
+//# sourceMappingURL=welcome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../src/commands/welcome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF3E"}

package/dist/commands/welcome.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * welcome - 首次使用引导命令
+ * 交互式引导新用户完成第一个完整功能开发
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.welcomeCommand = welcomeCommand;
+const logger_1 = require("../utils/logger");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+async function welcomeCommand(options) {
+    logger_1.logger.info('👋 欢迎使用 SpecCore！');
+    logger_1.logger.info('');
+    logger_1.logger.info('SpecCore 是一个面向 AI 原生团队的规范驱动研发工程框架。');
+    logger_1.logger.info('核心理念：Code by Spec, Not by Vibe.');
+    logger_1.logger.info('');
+    const spinner = new logger_1.Spinner('正在检测项目状态...');
+    spinner.start();
+    try {
+        const isInitialized = await checkInitialization();
+        if (!isInitialized || options.force) {
+            spinner.stop('项目未初始化，开始引导设置...');
+            await guideInit();
+        }
+        else {
+            spinner.stop('项目已初始化。');
+        }
+        // Step 2: 引导创建期次
+        logger_1.logger.info('');
+        logger_1.logger.info('📋 第二步：创建你的第一个期次');
+        logger_1.logger.info('');
+        logger_1.logger.info('期次是 SpecCore 的项目管理单元，通常按时间或功能划分。');
+        logger_1.logger.info('例如: 期次-2026-07-会议预定');
+        logger_1.logger.info('');
+        logger_1.logger.info('运行以下命令创建期次:');
+        logger_1.logger.info('  $ speccore iteration create --name "<期次名称>"');
+        logger_1.logger.info('');
+        // Step 3: 引导创建任务
+        logger_1.logger.info('📝 第三步：创建开发任务');
+        logger_1.logger.info('');
+        logger_1.logger.info('使用智能入口创建任务:');
+        logger_1.logger.info('  $ speccore spec "做一个用户登录功能，支持手机号+密码"');
+        logger_1.logger.info('');
+        logger_1.logger.info('或直接创建:');
+        logger_1.logger.info('  $ speccore task new --name "用户登录" --desc "手机号+密码登录"');
+        logger_1.logger.info('');
+        // Step 4: 引导查看和开发
+        logger_1.logger.info('⚡ 第四步：查看进度并开始开发');
+        logger_1.logger.info('');
+        logger_1.logger.info('查看项目状态:');
+        logger_1.logger.info('  $ speccore progress');
+        logger_1.logger.info('  $ speccore status');
+        logger_1.logger.info('');
+        logger_1.logger.info('生成执行计划:');
+        logger_1.logger.info('  $ speccore plan');
+        logger_1.logger.info('');
+        // Step 5: 审查和归档
+        logger_1.logger.info('✅ 第五步：审查和归档');
+        logger_1.logger.info('');
+        logger_1.logger.info('审查代码产出:');
+        logger_1.logger.info('  $ speccore validate');
+        logger_1.logger.info('');
+        logger_1.logger.info('归档已完成任务:');
+        logger_1.logger.info('  $ speccore archive --all');
+        logger_1.logger.info('');
+        // 常用命令速查
+        logger_1.logger.info('---');
+        logger_1.logger.info('📖 常用命令速查:');
+        logger_1.logger.info('');
+        logger_1.logger.info('| 场景 | 命令 |');
+        logger_1.logger.info('| :--- | :--- |');
+        logger_1.logger.info('| 自然语言入口 | speccore spec "<描述>" |');
+        logger_1.logger.info('| 查看进度 | speccore progress |');
+        logger_1.logger.info('| 创建任务 | speccore task new --name "<名称>" |');
+        logger_1.logger.info('| Bug 修复 | speccore bugfix --name "<Bug>" |');
+        logger_1.logger.info('| 需求变更 | speccore change --task=<Task> --desc="<描述>" |');
+        logger_1.logger.info('| 生成报告 | speccore report --format=html |');
+        logger_1.logger.info('| 查看帮助 | speccore help |');
+        logger_1.logger.info('');
+        logger_1.logger.info('💡 提示: 使用 speccore spec 可以通过自然语言描述自动执行！');
+        logger_1.logger.info('   例如: speccore spec "查看进度"');
+        logger_1.logger.info('   例如: speccore spec "开始干活"');
+    }
+    catch (error) {
+        spinner.fail(`引导初始化失败: ${error}`);
+        throw error;
+    }
+}
+async function checkInitialization() {
+    return await (0, fs_extra_1.pathExists)((0, path_1.join)(process.cwd(), '.speccore'));
+}
+async function guideInit() {
+    logger_1.logger.info('');
+    logger_1.logger.info('🔧 正在初始化 SpecCore 项目...');
+    const speccoreDir = (0, path_1.join)(process.cwd(), '.speccore');
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(speccoreDir, 'PROJECT'));
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(speccoreDir, 'PATTERNS'));
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(speccoreDir, 'ITERATIONS'));
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(speccoreDir, 'RULES'));
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(speccoreDir, 'local'));
+    // 创建基础配置
+    const context = {
+        currentIteration: '',
+        currentTask: '',
+        currentAssignee: '',
+        lastUpdated: new Date().toISOString(),
+        history: [],
+    };
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(speccoreDir, 'local', 'context.json'), JSON.stringify(context, null, 2));
+    // 创建 SETTINGS.md
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(speccoreDir, 'SETTINGS.md'), `# SpecCore 框架配置
+
+> 修改后，AI 将在下一次执行命令时自动生效。
+
+---
+
+## 1. 执行人追踪（Assignee Tracking）
+
+| 配置项 | 可选值 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| \`assignee.enabled\` | \`true\`/\`false\` | \`true\` | 是否启用执行人追踪 |
+| \`assignee.mode\` | \`strict\`/\`loose\`/\`off\` | \`loose\` | 强制程度 |
+
+### 模式说明
+| 模式 | 行为 |
+| :--- | :--- |
+| **\`strict\`** | 校验执行人与 Git 提交者，不一致时阻断命令执行 |
+| **\`loose\`** | 自动填写 Git 提交者，仅发出警告（推荐） |
+| **\`off\`** | 不读取、不校验、不推荐任何人 |
+
+## 2. 双向追溯配置
+
+| 配置项 | 可选值 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| \`trace.enabled\` | \`true\`/\`false\` | \`true\` | 是否启用双向追溯 |
+| \`trace.auto_annotate\` | \`true\`/\`false\` | \`true\` | 生成代码时是否自动添加 @spec 注释 |
+
+## 3. 其他配置
+
+| 配置项 | 可选值 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| \`archive.auto_cleanup\` | \`true\`/\`false\` | \`false\` | 归档时是否自动清理未使用的资源 |
+| \`plan.parallel_suggest\` | \`true\`/\`false\` | \`true\` | 是否自动推荐并行开发策略 |
+| \`validation.strict_mode\` | \`true\`/\`false\` | \`false\` | 合规性检查是否为严格模式 |
+| \`sync.auto_check\` | \`true\`/\`false\` | \`true\` | 开发完成后是否自动检查反向同步 |
+
+## 4. 配置变更记录
+
+| 日期 | 变更项 | 旧值 | 新值 | 变更人 |
+| :--- | :--- | :--- | :--- | :--- |
+`);
+    // 创建 ITERATIONS/README.md
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(speccoreDir, 'ITERATIONS', 'README.md'), `# 期次索引
+
+| 期次名称 | 时间范围 | 状态 | 负责人 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+`);
+    // 创建 PROJECT/TEAM.md
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(speccoreDir, 'PROJECT', 'TEAM.md'), `# 团队与 Git 映射
+
+| 成员 | Git 用户名 | 角色 | 技术栈 | 负责模块 |
+| :--- | :--- | :--- | :--- | :--- |
+`);
+    logger_1.logger.success('项目初始化完成！');
+}
+//# sourceMappingURL=welcome.js.map

package/dist/commands/welcome.js.map

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

package/dist/core/global-layer.d.ts

@@ -0,0 +1,124 @@
+/**
+ * GLOBAL 全量层管理核心模块
+ * 负责管理 GLOBAL/ 目录下的全量需求索引、项目映射、期次关联
+ */
+/** 需求状态 */
+export type ReqStatus = '📦 已有实现' | '✅ 已实现' | '🔄 进行中' | '🔲 待开发' | '🗑️ 已废弃';
+/** 项目类型 */
+export type ProjectType = 'backend' | 'web' | 'h5' | 'miniapp';
+/** 需求索引条目 */
+export interface ReqIndexEntry {
+    id: string;
+    project: string;
+    name: string;
+    status: ReqStatus;
+    version: string;
+    iteration: string;
+    task: string;
+    filePath: string;
+}
+/** 项目条目 */
+export interface ProjectEntry {
+    name: string;
+    type: ProjectType;
+    reqCount: number;
+    implemented: number;
+    inProgress: number;
+    pending: number;
+    lastImport: string;
+}
+/** 期次关联条目 */
+export interface IterationLink {
+    name: string;
+    reqs: string[];
+    status: string;
+    createdAt: string;
+}
+/** INDEX.md 解析后的全局索引 */
+export interface GlobalIndex {
+    reqs: ReqIndexEntry[];
+    projects: ProjectEntry[];
+    iterations: IterationLink[];
+    version: string;
+    lastUpdated: string;
+}
+/** 导入项目参数 */
+export interface ImportProjectParams {
+    project: string;
+    path: string;
+    type: ProjectType;
+}
+/** 需求变更条目 */
+export interface ReqChange {
+    reqId: string;
+    reqName: string;
+    project: string;
+    changeType: '新增' | '修改' | '废弃';
+    changeDesc: string;
+}
+declare function getGlobalDir(): string;
+declare function getIndexPath(): string;
+declare function getProjectReqPath(project: string): string;
+declare function getProjectMetaPath(project: string): string;
+/**
+ * 解析 GLOBAL/INDEX.md
+ */
+export declare function readGlobalIndex(): Promise<GlobalIndex>;
+/**
+ * 获取下一个需求编号
+ */
+export declare function getNextReqId(index: GlobalIndex): string;
+/**
+ * 递增全局版本号
+ */
+export declare function bumpGlobalVersion(currentVersion: string): string;
+/**
+ * 追加需求条目到 INDEX.md 的需求索引表
+ */
+export declare function appendReqToIndex(entry: ReqIndexEntry): Promise<void>;
+/**
+ * 更新 INDEX.md 中需求条目的状态、版本等信息
+ */
+export declare function updateReqInIndex(reqId: string, updates: Partial<ReqIndexEntry>): Promise<void>;
+/**
+ * 追加项目条目到 INDEX.md
+ */
+export declare function upsertProjectInIndex(project: ProjectEntry): Promise<void>;
+/**
+ * 追加期次关联到 INDEX.md
+ */
+export declare function appendIterationLink(link: IterationLink): Promise<void>;
+/**
+ * 更新 INDEX.md 版本信息
+ */
+export declare function updateIndexVersion(version: string): Promise<void>;
+/**
+ * 确保项目目录存在
+ */
+export declare function ensureProjectDir(project: string): Promise<void>;
+/**
+ * 写入项目需求文档
+ */
+export declare function writeProjectRequirements(project: string, projectType: ProjectType, requirements: {
+    name: string;
+    description: string;
+    id: string;
+}[], techStack?: string): Promise<ReqIndexEntry[]>;
+/**
+ * 写入项目元数据
+ */
+export declare function writeProjectMetadata(project: string, projectType: ProjectType, techStack?: string, repoUrl?: string): Promise<void>;
+/**
+ * 从指定项目中读取指定需求 ID 的详细内容
+ */
+export declare function readRequirementDetail(project: string, reqId: string): Promise<string>;
+/**
+ * 对比两个需求描述并返回变更清单
+ */
+export declare function diffRequirements(sourceTitle: string, sourceContent: string, targetContent: string): ReqChange[];
+/**
+ * 获取所有已导入项目的列表
+ */
+export declare function listProjectDirs(): Promise<string[]>;
+export { getGlobalDir, getIndexPath, getProjectReqPath, getProjectMetaPath };
+//# sourceMappingURL=global-layer.d.ts.map

package/dist/core/global-layer.d.ts.map

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