speccore 8.3.349 → 8.3.366

package/dist/commands/analyze/modes.js.map

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

package/dist/commands/analyze/module.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyzeOptions } from './shared';
+export declare function analyzeModuleMode(options: AnalyzeOptions): Promise<void>;
+//# sourceMappingURL=module.d.ts.map

package/dist/commands/analyze/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/module.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD9E"}

package/dist/commands/analyze/module.js

@@ -0,0 +1,95 @@
+"use strict";
+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.analyzeModuleMode = analyzeModuleMode;
+/**
+ * analyze 模式：--module 功能模块级全局分析
+ * v8.3.341+: 从 analyzeCommand 抽出的模式早退块
+ * v8.3.359+: 从 analyze.ts 拆分（渐进重构批次 B，逻辑不搬家、行为不变）
+ */
+const logger_1 = require("../../utils/logger");
+const context_1 = require("../../core/context");
+const shared_1 = require("./shared");
+async function analyzeModuleMode(options) {
+    const iter = options.iteration || await (0, context_1.getDefaultIteration)();
+    if (!iter) {
+        logger_1.logger.error('请指定迭代: -I <iteration>');
+        return;
+    }
+    const iterDir = await (0, context_1.getIterationDir)(iter);
+    // 调用点已保证 options.module 非空（if (options.module)），此处断言恢复 narrowing
+    const moduleName = options.module;
+    const { analyzeModule, buildModuleAnalysisPrompt, listAnalyzedModules, listRequirementModules } = await Promise.resolve().then(() => __importStar(require('../../core/module-analyzer')));
+    const result = await analyzeModule(iterDir, moduleName);
+    logger_1.logger.info('');
+    if (result.exists) {
+        logger_1.logger.info(`🔄 功能模块重新分析: ${moduleName}`);
+        logger_1.logger.info(`   状态: 已存在于全局文档`);
+    }
+    else {
+        logger_1.logger.info(`🆕 功能模块新增分析: ${moduleName}`);
+        logger_1.logger.info(`   状态: 尚未在全局文档中分析`);
+        // 检查需求文档中是否存在该模块
+        const reqModules = await listRequirementModules(iterDir);
+        if (!reqModules.includes(moduleName)) {
+            logger_1.logger.warn(`⚠️ 需求文档中未找到功能模块 "${moduleName}"`);
+            logger_1.logger.info(`   需求中已有的模块: ${reqModules.slice(0, 10).join(', ')}${reqModules.length > 10 ? '...' : ''}`);
+            logger_1.logger.info(`   建议: 先确认模块名称是否正确，或在 010-requirements/features/ 中创建 ${moduleName}/SOURCE.md`);
+        }
+    }
+    logger_1.logger.info(`   涉及端: ${result.involvedPlatforms.join(', ') || '待确定'}`);
+    logger_1.logger.info(`   全局更新: ${result.globalUpdates.length} 项`);
+    logger_1.logger.info(`   各端更新: ${result.platformUpdates.length} 个端`);
+    logger_1.logger.info('');
+    if (options.prompt) {
+        const prompt = buildModuleAnalysisPrompt(iterDir, result, iter);
+        await (0, shared_1.emitAiPrompt)(iter, prompt, { mode: 'module-analysis' });
+        process.exitCode = 10;
+        return;
+    }
+    logger_1.logger.info('📋 全局文档更新:');
+    for (const up of result.globalUpdates) {
+        logger_1.logger.info(`   • ${up.action}: ${up.file}`);
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 各端文档更新:');
+    for (const pu of result.platformUpdates) {
+        logger_1.logger.info(`   • ${pu.platform}: ${pu.files.join(', ')}`);
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 下一步:');
+    logger_1.logger.info(`   speccore analyze --prompt -I ${iter} --module ${moduleName}`);
+}
+//# sourceMappingURL=module.js.map

package/dist/commands/analyze/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/commands/analyze/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,8CAmDC;AA7DD;;;;GAIG;AACH,+CAA4C;AAC5C,gDAA0E;AAC1E,qCAAwC;AAGjC,KAAK,UAAU,iBAAiB,CAAC,OAAuB;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,IAAA,6BAAmB,GAAE,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;QAAC,eAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EAAC,IAAI,CAAC,CAAC;IAC5C,iEAAiE;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAgB,CAAC;IAE5C,MAAM,EAAE,aAAa,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,GAAG,wDAAa,4BAA4B,GAAC,CAAC;IAC7I,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAExD,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,eAAM,CAAC,IAAI,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;QAC1C,eAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,eAAM,CAAC,IAAI,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;QAC1C,eAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEjC,iBAAiB;QACjB,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,eAAM,CAAC,IAAI,CAAC,oBAAoB,UAAU,GAAG,CAAC,CAAC;YAC/C,eAAM,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxG,eAAM,CAAC,IAAI,CAAC,wDAAwD,UAAU,YAAY,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,eAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACvE,eAAM,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;IACzD,eAAM,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5D,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,IAAA,qBAAY,EAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,eAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,eAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,eAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACxC,eAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,eAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,eAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,aAAa,UAAU,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/commands/analyze/overview.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyzeOptions } from './shared';
+export declare function analyzeOverviewMode(options: AnalyzeOptions): Promise<void>;
+//# sourceMappingURL=overview.d.ts.map

package/dist/commands/analyze/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/overview.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChF"}

package/dist/commands/analyze/overview.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeOverviewMode = analyzeOverviewMode;
+/**
+ * analyze 模式：--scope=overview 总览生成（--phase=skeleton|full）
+ * 含总览 Prompt 构建与 [DOC:xxx] 标记落盘。
+ * v8.3.341+: 从 analyzeCommand 抽出的模式早退块
+ * v8.3.359+: 从 analyze.ts 拆分（渐进重构批次 C，逻辑不搬家、行为不变）
+ */
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const logger_1 = require("../../utils/logger");
+const context_1 = require("../../core/context");
+const feature_metadata_1 = require("../../core/feature-metadata");
+const shared_1 = require("./shared");
+async function analyzeOverviewMode(options) {
+    const iter = options.iteration || await (0, context_1.getDefaultIteration)();
+    if (!iter) {
+        logger_1.logger.error('请指定迭代: -I <iteration>');
+        return;
+    }
+    const iterDir = await (0, context_1.getIterationDir)(iter);
+    // 扫描功能单元元数据
+    const metadata = await (0, feature_metadata_1.scanFeatureMetadata)(iterDir);
+    if (metadata.length === 0) {
+        logger_1.logger.warn('未找到功能单元，请先运行: speccore doc2spec --split');
+        return;
+    }
+    logger_1.logger.info(`📊 总览生成: ${iter}`);
+    logger_1.logger.info(`   功能单元: ${metadata.length} 个`);
+    // 构建总览输入
+    const overviewInput = await (0, feature_metadata_1.buildOverviewInput)(iter, metadata);
+    const coverage = (0, feature_metadata_1.calculatePlatformCoverage)(metadata);
+    const crossApis = (0, feature_metadata_1.findCrossFeatureApis)(metadata);
+    const phase = options.phase || 'skeleton';
+    // ── apply 模式：接收 AI 结果写入总览文件 ──
+    if (options.apply) {
+        await writeOverviewFiles(iterDir, options.apply, phase);
+        logger_1.logger.success(`✅ 总览已写入: ${iterDir}/020-specs/overview/`);
+        return;
+    }
+    // ── prompt 模式：生成 AI Prompt ──
+    const prompt = buildOverviewPrompt(overviewInput, coverage, crossApis, phase);
+    await (0, shared_1.emitAiPrompt)(iter, prompt, { mode: 'overview' });
+    process.exitCode = 10;
+}
+/**
+ * 构建总览生成 AI Prompt
+ */
+function buildOverviewPrompt(input, coverage, crossApis, phase) {
+    const isSkeleton = phase === 'skeleton';
+    let prompt = `# 任务: 生成迭代${isSkeleton ? '骨架' : '完整'}总览\n\n`;
+    prompt += `## 输入数据（CLI 自动提取，${input.features.length} 个功能单元）\n\n`;
+    prompt += `### 功能单元清单\n\n`;
+    prompt += `| 功能单元 | 涉及端 | 依赖 | 摘要 |\n`;
+    prompt += `| :--- | :--- | :--- | :--- |\n`;
+    for (const f of input.features) {
+        prompt += `| ${f.feature} | ${f.platforms.join(', ') || '-'} | ${f.dependencies.join(', ') || '无'} | ${f.summary.slice(0, 40)}${f.summary.length > 40 ? '...' : ''} |\n`;
+    }
+    prompt += `\n### 端覆盖统计\n\n`;
+    prompt += `| 端 | 覆盖功能单元数 |\n`;
+    prompt += `| :--- | :--- |\n`;
+    for (const [platform, count] of Object.entries(coverage)) {
+        prompt += `| ${platform} | ${count} |\n`;
+    }
+    if (crossApis.length > 0) {
+        prompt += `\n### 跨功能单元接口\n\n`;
+        prompt += `| 接口 | 被哪些功能引用 |\n`;
+        prompt += `| :--- | :--- |\n`;
+        for (const api of crossApis) {
+            prompt += `| ${api.path} | ${api.usedBy.join(', ')} |\n`;
+        }
+    }
+    if (isSkeleton) {
+        prompt += `\n## 生成要求（骨架总览）\n\n`;
+        prompt += `1. 生成 **功能地图**（Mermaid flowchart）：展示功能单元间的依赖关系\n`;
+        prompt += `2. 生成 **端覆盖总览表**：指出哪些端缺少功能覆盖\n`;
+        prompt += `3. 生成 **功能单元清单**：确认所有功能单元已识别\n`;
+        prompt += `4. 内容控制在 40-60 行\n`;
+        prompt += `5. 使用 [DOC:OVERVIEW] 标记输出\n`;
+    }
+    else {
+        prompt += `\n## 生成要求（完整总览）\n\n`;
+        prompt += `1. 生成 **系统架构图**（Mermaid）：服务拓扑 + 数据流\n`;
+        prompt += `2. 生成 **跨功能单元接口清单**：标注哪些接口被多个功能引用\n`;
+        prompt += `3. 生成 **实际依赖关系表**：基于接口调用关系\n`;
+        prompt += `4. 内容控制在 60-80 行\n`;
+        prompt += `5. 使用 [DOC:OVERVIEW] 和 [DOC:ARCHITECTURE] 标记输出\n`;
+    }
+    prompt += `\n## 输出格式\n\n`;
+    prompt += `\`\`\`markdown\n`;
+    prompt += `[DOC:OVERVIEW]\n`;
+    prompt += `# 迭代总览（${isSkeleton ? '骨架' : '完整'}）\n`;
+    prompt += `...\n`;
+    prompt += `\`\`\`\n`;
+    return prompt;
+}
+/**
+ * 写入总览文件（解析 AI 返回的 [DOC:xxx] 标记）
+ */
+async function writeOverviewFiles(iterDir, applyContent, phase) {
+    const specDir = (0, path_1.join)(iterDir, '020-specs');
+    const overviewDir = (0, path_1.join)(specDir, 'overview');
+    await (0, fs_extra_1.ensureDir)(overviewDir);
+    // 解析 [DOC:OVERVIEW] 和 [DOC:ARCHITECTURE] 标记
+    const overviewMatch = applyContent.match(/\[DOC:OVERVIEW\]([\s\S]*?)(?=\[DOC:|$)/);
+    const archMatch = applyContent.match(/\[DOC:ARCHITECTURE\]([\s\S]*?)(?=\[DOC:|$)/);
+    if (overviewMatch) {
+        const content = overviewMatch[1].trim();
+        const fileName = phase === 'skeleton' ? 'REQUIREMENT.md' : 'REQUIREMENT.md';
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(overviewDir, fileName), content);
+        logger_1.logger.info(`   📝 已写入: overview/${fileName}`);
+    }
+    if (archMatch) {
+        const content = archMatch[1].trim();
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(overviewDir, 'ARCHITECTURE.md'), content);
+        logger_1.logger.info(`   📝 已写入: overview/ARCHITECTURE.md`);
+    }
+    // 如果没有标记，直接写入 REQUIREMENT.md
+    if (!overviewMatch && !archMatch) {
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(overviewDir, 'REQUIREMENT.md'), applyContent.trim());
+        logger_1.logger.info(`   📝 已写入: overview/REQUIREMENT.md`);
+    }
+}
+//# sourceMappingURL=overview.js.map

package/dist/commands/analyze/overview.js.map

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

package/dist/commands/analyze/shared.d.ts

@@ -0,0 +1,53 @@
+export declare function emitAiPrompt(iter: string, prompt: string, meta?: Record<string, unknown>): Promise<void>;
+export interface AnalyzeOptions {
+    iteration?: string;
+    output?: string;
+    auto?: boolean;
+    interactive?: boolean;
+    platform?: string;
+    source?: string;
+    requirements?: string;
+    scope?: 'global' | 'iteration' | 'overview';
+    depth?: 'quick' | 'normal' | 'deep';
+    prompt?: boolean;
+    apply?: string;
+    withCode?: boolean;
+    noSource?: boolean;
+    sourceScope?: string;
+    supplement?: boolean;
+    feature?: string;
+    doc?: string;
+    auditFix?: boolean;
+    full?: boolean;
+    phase?: string;
+    applyPhase?: string;
+    pipeline?: boolean;
+    streaming?: boolean;
+    streamingPhase?: string;
+    incremental?: boolean;
+    reanalyze?: boolean;
+    addPlatform?: string;
+    contextGuard?: boolean;
+    estimateOnly?: boolean;
+    module?: string;
+    clarify?: boolean;
+    skipClarify?: boolean;
+    layer?: number;
+    deep?: string;
+    iterative?: boolean;
+    filter?: string;
+    docName?: string;
+    featureName?: string;
+    extractUnits?: boolean;
+    unit?: string;
+    autoUnits?: boolean;
+    consolidate?: boolean;
+    resumeUnits?: boolean;
+    merge?: boolean;
+    fromCode?: boolean;
+    verify?: boolean;
+    outDir?: string;
+}
+/** 解析 [DOC:xxx] 标记，提取文档名 → 内容 Map */
+export declare function parseDocMarkers(text: string): Map<string, string>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/analyze/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/shared.ts"],"names":[],"mappings":"AASA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlH;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBjE"}

package/dist/commands/analyze/shared.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitAiPrompt = emitAiPrompt;
+exports.parseDocMarkers = parseDocMarkers;
+/**
+ * analyze 命令共享件——模式分发与主流程的公共基础设施
+ * v8.3.359+: 从 analyze.ts 拆分（渐进重构批次 A：真共享件下沉）
+ */
+const ai_trace_1 = require("../../utils/ai-trace");
+// v8.3.264: AI 交棒统一出口——所有 [SPECCORE_PROMPT] 输出必留 prompt-out 轨迹，
+// 与 ai-trace 飞行记录仪的 apply-in/apply-done/apply-fail 配对，形成「发起→回传→落盘」闭环证据链。
+// 此前 14 处输出点仅 2 处埋点，澄清链等 12 处交棒全程无痕（ai-trace/ 目录空白即因此）。
+async function emitAiPrompt(iter, prompt, meta = {}) {
+    await (0, ai_trace_1.recordAiTrace)(iter, 'prompt-out', { promptLength: prompt.length, ...meta, prompt });
+    process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+}
+/** 解析 [DOC:xxx] 标记，提取文档名 → 内容 Map */
+function parseDocMarkers(text) {
+    const result = new Map();
+    const markerRegex = /\[DOC:([^\]]+)\]/g;
+    let match;
+    const positions = [];
+    while ((match = markerRegex.exec(text)) !== null) {
+        positions.push({ name: match[1].trim(), index: match.index });
+    }
+    for (let i = 0; i < positions.length; i++) {
+        const start = positions[i].index + `[DOC:${positions[i].name}]`.length;
+        const end = i < positions.length - 1 ? positions[i + 1].index : text.length;
+        const content = text.slice(start, end).trim();
+        result.set(positions[i].name, content);
+    }
+    return result;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/analyze/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/analyze/shared.ts"],"names":[],"mappings":";;AASA,oCAGC;AAqED,0CAkBC;AAnGD;;;GAGG;AACH,mDAAqD;AAErD,gEAAgE;AAChE,yEAAyE;AACzE,wDAAwD;AACjD,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,OAAgC,EAAE;IACjG,MAAM,IAAA,wBAAa,EAAC,IAAI,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC;AAoED,qCAAqC;AACrC,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,WAAW,GAAG,mBAAmB,CAAC;IACxC,IAAI,KAA6B,CAAC;IAClC,MAAM,SAAS,GAAsC,EAAE,CAAC;IAExD,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC;QACvE,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/analyze/units.d.ts

@@ -0,0 +1,46 @@
+import type { AnalyzeOptions } from './shared';
+export interface IterationUnit {
+    id: string;
+    name: string;
+    source: string;
+    sourceRange: {
+        startLine: number;
+        endLine: number;
+    };
+    content: string;
+    platforms?: string[];
+}
+export interface UnitAnalysis {
+    id: string;
+    name: string;
+    req: string;
+    tech: string;
+    test: string;
+    ui?: string;
+    risk?: string;
+    timestamp: string;
+}
+export declare const UNITS_CACHE_DIR = ".speccore/cache/unit-analysis";
+/** 从需求文档提取功能单元清单 */
+export declare function extractIterationUnits(iterDir: string): Promise<IterationUnit[]>;
+/** 保存单元分析结果到缓存 */
+export declare function saveUnitAnalysis(iteration: string, analysis: UnitAnalysis): Promise<void>;
+/** 读取已完成的单元分析 */
+export declare function loadUnitAnalyses(iteration: string): Promise<UnitAnalysis[]>;
+/** 检测未完成的单元分析 */
+export declare function detectPendingUnits(iteration: string, allUnits: IterationUnit[]): Promise<IterationUnit[]>;
+/** 汇总所有单元分析为统一报告（带 [DOC:xxx] 标记） */
+export declare function consolidateUnitAnalyses(iteration: string, units: IterationUnit[], analyses: UnitAnalysis[]): Promise<string>;
+/** 构建单个功能单元的深度分析 Prompt */
+export declare function buildUnitAnalysisPrompt(iterDir: string, iteration: string, unit: IterationUnit, allUnits: IterationUnit[]): Promise<string>;
+/**
+ * v8.3.234+: 生成并落盘「功能单元分析质量报告」——成功/失败清单 + 每单元产出物评分。
+ * 落盘到 020-specs/QUALITY_AUDIT.md；无可评单元时返回 null。
+ */
+export declare function buildAndSaveQualityReport(iterDir: string, iter: string, units: IterationUnit[]): Promise<string | null>;
+/**
+ * 功能单元聚焦分析主入口
+ * v8.3.341+: 从 analyzeCommand 抽出的模式早退块
+ */
+export declare function analyzeUnitModes(options: AnalyzeOptions, projectRoot: string): Promise<void>;
+//# sourceMappingURL=units.d.ts.map

package/dist/commands/analyze/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze/units.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,kCAAkC,CAAC;AAE/D,oBAAoB;AACpB,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkGrF;AAED,kBAAkB;AAClB,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/F;AAED,iBAAiB;AACjB,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBjF;AAED,iBAAiB;AACjB,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB/G;AAcD,oCAAoC;AACpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAmFjB;AAkBD,2BAA2B;AAC3B,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,MAAM,CAAC,CA0EjB;AAqPD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8D7H;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmPlG"}