spectra-cli 4.1.1

package/dist/batch/cost-summary.js.map

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

package/dist/batch/delta-regenerator.d.ts

@@ -0,0 +1,41 @@
+import type { DependencyGraph } from '../models/dependency-graph.js';
+import { type StoredModuleSpecSummary } from '../panoramic/builders/doc-graph-builder.js';
+import type { ModuleGroup } from './module-grouper.js';
+export type DeltaChangeReason = 'missing-spec' | 'metadata-missing' | 'skeleton-changed' | 'dependency-propagation' | 'mode-changed';
+export interface DeltaTargetState {
+    sourceTarget: string;
+    sourceFiles: string[];
+    currentHash?: string;
+    previousHash?: string;
+    reason: DeltaChangeReason;
+    impactedBy: string[];
+}
+export interface DeltaReport {
+    title: string;
+    generatedAt: string;
+    projectRoot: string;
+    mode: 'incremental' | 'full';
+    totalTargets: number;
+    regenerateTargets: string[];
+    directChanges: DeltaTargetState[];
+    propagatedChanges: DeltaTargetState[];
+    unchangedTargets: string[];
+    fallbackReason?: string;
+}
+export interface DeltaRegeneratorOptions {
+    projectRoot: string;
+    dependencyGraph: DependencyGraph;
+    moduleGroups: ModuleGroup[];
+    storedSpecs: StoredModuleSpecSummary[];
+    /**
+     * 当前批处理的有效模式（Bug 142）。
+     * 传入时启用 mode-aware cache：旧 spec（无 generatedByMode）或 mode 不匹配时强制 cache miss。
+     * 不传入时 mode 检查跳过（向后兼容旧调用方，如不区分模式的纯增量场景）。
+     */
+    effectiveMode?: 'full' | 'reading' | 'code-only';
+}
+export declare class DeltaRegenerator {
+    plan(options: DeltaRegeneratorOptions): Promise<DeltaReport>;
+    render(report: DeltaReport): string;
+}
+//# sourceMappingURL=delta-regenerator.d.ts.map

package/dist/batch/delta-regenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-regenerator.d.ts","sourceRoot":"","sources":["../../src/batch/delta-regenerator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;CAClD;AASD,qBAAa,gBAAgB;IACrB,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IA8IlE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;CAIpC"}

package/dist/batch/delta-regenerator.js

@@ -0,0 +1,267 @@
+/**
+ * DeltaRegenerator
+ * 基于当前源码骨架哈希、既有 module spec 摘要和依赖图，推导增量重生成计划。
+ */
+import { createHash } from 'node:crypto';
+import * as path from 'node:path';
+import { analyzeFiles } from '../core/ast-analyzer.js';
+import { buildDocGraph, resolveSpecForSource, } from '../panoramic/builders/doc-graph-builder.js';
+import { loadTemplate } from '../panoramic/utils/template-loader.js';
+const ROOT_MODULE_RE = /^root(?:--.+)?$/;
+export class DeltaRegenerator {
+    async plan(options) {
+        const snapshots = await collectCurrentSnapshots(options.projectRoot, options.moduleGroups);
+        const generatedAt = new Date().toISOString();
+        if (snapshots.length === 0) {
+            return {
+                title: 'Delta Regeneration Report',
+                generatedAt,
+                projectRoot: options.projectRoot,
+                mode: 'incremental',
+                totalTargets: 0,
+                regenerateTargets: [],
+                directChanges: [],
+                propagatedChanges: [],
+                unchangedTargets: [],
+            };
+        }
+        if (options.storedSpecs.length === 0) {
+            const directChanges = snapshots.map((snapshot) => ({
+                sourceTarget: snapshot.sourceTarget,
+                sourceFiles: snapshot.sourceFiles,
+                currentHash: snapshot.currentHash,
+                previousHash: snapshot.previousHash,
+                reason: 'missing-spec',
+                impactedBy: [],
+            }));
+            return buildReport({
+                generatedAt,
+                projectRoot: options.projectRoot,
+                mode: 'full',
+                directChanges,
+                propagatedChanges: [],
+                unchangedTargets: [],
+                fallbackReason: 'no-existing-specs',
+                totalTargets: snapshots.length,
+            });
+        }
+        const docGraph = buildDocGraph({
+            projectRoot: options.projectRoot,
+            dependencyGraph: options.dependencyGraph,
+            moduleSpecs: [],
+            existingSpecs: options.storedSpecs,
+        });
+        const sourceFileToTarget = new Map();
+        const snapshotsByTarget = new Map();
+        for (const snapshot of snapshots) {
+            snapshotsByTarget.set(snapshot.sourceTarget, snapshot);
+            for (const sourceFile of snapshot.sourceFiles) {
+                sourceFileToTarget.set(sourceFile, snapshot.sourceTarget);
+            }
+        }
+        const directChanges = detectDirectChanges(snapshots, options.storedSpecs, options.effectiveMode);
+        if (directChanges.length === 0) {
+            return buildReport({
+                generatedAt,
+                projectRoot: options.projectRoot,
+                mode: 'incremental',
+                directChanges: [],
+                propagatedChanges: [],
+                unchangedTargets: snapshots.map((snapshot) => snapshot.sourceTarget).sort((a, b) => a.localeCompare(b)),
+                totalTargets: snapshots.length,
+            });
+        }
+        const directTargets = new Set(directChanges.map((entry) => entry.sourceTarget));
+        const reverseEdges = buildReverseEdges(options.dependencyGraph);
+        const propagationMap = new Map();
+        const directSourceFiles = new Set(directChanges.flatMap((entry) => entry.sourceFiles));
+        const queue = [...directSourceFiles];
+        const visited = new Set(queue);
+        while (queue.length > 0) {
+            const sourceFile = queue.shift();
+            for (const dependentFile of reverseEdges.get(sourceFile) ?? []) {
+                if (!visited.has(dependentFile)) {
+                    visited.add(dependentFile);
+                    queue.push(dependentFile);
+                }
+                const owner = sourceFileToTarget.get(dependentFile)
+                    ?? resolveSpecForSource(dependentFile, docGraph.specs)?.sourceTarget;
+                if (!owner || directTargets.has(owner)) {
+                    continue;
+                }
+                if (!propagationMap.has(owner)) {
+                    propagationMap.set(owner, new Set());
+                }
+                const impactedBy = sourceFileToTarget.get(sourceFile)
+                    ?? resolveSpecForSource(sourceFile, docGraph.specs)?.sourceTarget;
+                if (impactedBy) {
+                    propagationMap.get(owner).add(impactedBy);
+                }
+            }
+        }
+        const propagatedChanges = [...propagationMap.entries()]
+            .map(([sourceTarget, impactedBy]) => {
+            const snapshot = snapshotsByTarget.get(sourceTarget);
+            return {
+                sourceTarget,
+                sourceFiles: snapshot?.sourceFiles ?? [],
+                currentHash: snapshot?.currentHash,
+                previousHash: snapshot?.previousHash,
+                reason: 'dependency-propagation',
+                impactedBy: [...impactedBy].sort((a, b) => a.localeCompare(b)),
+            };
+        })
+            .sort((a, b) => a.sourceTarget.localeCompare(b.sourceTarget));
+        const regenerateTargets = new Set([
+            ...directChanges.map((entry) => entry.sourceTarget),
+            ...propagatedChanges.map((entry) => entry.sourceTarget),
+        ]);
+        const unchangedTargets = snapshots
+            .map((snapshot) => snapshot.sourceTarget)
+            .filter((sourceTarget) => !regenerateTargets.has(sourceTarget))
+            .sort((a, b) => a.localeCompare(b));
+        return buildReport({
+            generatedAt,
+            projectRoot: options.projectRoot,
+            mode: 'incremental',
+            directChanges,
+            propagatedChanges,
+            unchangedTargets,
+            totalTargets: snapshots.length,
+        });
+    }
+    render(report) {
+        const template = loadTemplate('delta-report.hbs', import.meta.url);
+        return template(report);
+    }
+}
+async function collectCurrentSnapshots(projectRoot, moduleGroups) {
+    const snapshots = [];
+    for (const group of moduleGroups) {
+        if (ROOT_MODULE_RE.test(group.name)) {
+            for (const filePath of group.files) {
+                const normalizedFile = normalizeProjectPath(filePath);
+                snapshots.push({
+                    sourceTarget: normalizedFile,
+                    sourceFiles: [normalizedFile],
+                    currentHash: await computeSkeletonHash(projectRoot, [filePath]),
+                });
+            }
+            continue;
+        }
+        snapshots.push({
+            sourceTarget: normalizeProjectPath(group.dirPath),
+            sourceFiles: group.files.map((filePath) => normalizeProjectPath(filePath)).sort((a, b) => a.localeCompare(b)),
+            currentHash: await computeSkeletonHash(projectRoot, group.files),
+        });
+    }
+    return snapshots.sort((a, b) => a.sourceTarget.localeCompare(b.sourceTarget));
+}
+async function computeSkeletonHash(projectRoot, files) {
+    if (files.length === 0) {
+        return undefined;
+    }
+    const analyzed = await analyzeFiles(files.map((filePath) => path.join(projectRoot, filePath)));
+    if (analyzed.length === 0) {
+        return undefined;
+    }
+    if (analyzed.length === 1) {
+        return analyzed[0]?.hash;
+    }
+    const combinedContent = analyzed
+        .slice()
+        .sort((left, right) => left.filePath.localeCompare(right.filePath))
+        .map((skeleton) => skeleton.hash)
+        .join('');
+    return createHash('sha256').update(combinedContent).digest('hex');
+}
+function detectDirectChanges(snapshots, storedSpecs, effectiveMode) {
+    const storedByTarget = new Map(storedSpecs.map((spec) => [spec.sourceTarget, spec]));
+    return snapshots
+        .flatMap((snapshot) => {
+        const stored = storedByTarget.get(snapshot.sourceTarget);
+        if (!stored) {
+            return [{
+                    sourceTarget: snapshot.sourceTarget,
+                    sourceFiles: snapshot.sourceFiles,
+                    currentHash: snapshot.currentHash,
+                    previousHash: undefined,
+                    reason: 'missing-spec',
+                    impactedBy: [],
+                }];
+        }
+        snapshot.previousHash = stored.skeletonHash;
+        if (!stored.skeletonHash || !snapshot.currentHash) {
+            return [{
+                    sourceTarget: snapshot.sourceTarget,
+                    sourceFiles: snapshot.sourceFiles,
+                    currentHash: snapshot.currentHash,
+                    previousHash: stored.skeletonHash,
+                    reason: 'metadata-missing',
+                    impactedBy: [],
+                }];
+        }
+        if (stored.skeletonHash !== snapshot.currentHash) {
+            return [{
+                    sourceTarget: snapshot.sourceTarget,
+                    sourceFiles: snapshot.sourceFiles,
+                    currentHash: snapshot.currentHash,
+                    previousHash: stored.skeletonHash,
+                    reason: 'skeleton-changed',
+                    impactedBy: [],
+                }];
+        }
+        // Bug 142：mode-aware cache 检查（仅当调用方传入 effectiveMode 时启用）。
+        // 旧 spec（缺失 generatedByMode）或 mode 不匹配 → 强制 cache miss（安全降级）。
+        // 不假设旧 spec 与当前 mode 兼容，宁可多生成一次。
+        if (effectiveMode !== undefined) {
+            if (!stored.generatedByMode || stored.generatedByMode !== effectiveMode) {
+                return [{
+                        sourceTarget: snapshot.sourceTarget,
+                        sourceFiles: snapshot.sourceFiles,
+                        currentHash: snapshot.currentHash,
+                        previousHash: stored.skeletonHash,
+                        reason: 'mode-changed',
+                        impactedBy: [],
+                    }];
+            }
+        }
+        return [];
+    })
+        .sort((left, right) => left.sourceTarget.localeCompare(right.sourceTarget));
+}
+function buildReverseEdges(graph) {
+    const reverse = new Map();
+    for (const edge of graph.edges) {
+        if (!reverse.has(edge.to)) {
+            reverse.set(edge.to, []);
+        }
+        reverse.get(edge.to).push(edge.from);
+    }
+    for (const [source, dependents] of reverse) {
+        dependents.sort((a, b) => a.localeCompare(b));
+        reverse.set(source, [...new Set(dependents)]);
+    }
+    return reverse;
+}
+function buildReport(input) {
+    return {
+        title: 'Delta Regeneration Report',
+        generatedAt: input.generatedAt,
+        projectRoot: input.projectRoot,
+        mode: input.mode,
+        totalTargets: input.totalTargets,
+        regenerateTargets: [
+            ...input.directChanges.map((entry) => entry.sourceTarget),
+            ...input.propagatedChanges.map((entry) => entry.sourceTarget),
+        ].sort((a, b) => a.localeCompare(b)),
+        directChanges: input.directChanges,
+        propagatedChanges: input.propagatedChanges,
+        unchangedTargets: input.unchangedTargets,
+        fallbackReason: input.fallbackReason,
+    };
+}
+function normalizeProjectPath(inputPath) {
+    return inputPath.split(path.sep).join('/');
+}
+//# sourceMappingURL=delta-regenerator.js.map

package/dist/batch/delta-regenerator.js.map

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

package/dist/batch/directory-classifier.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 目录分类枚举
+ * source：核心源码目录（生成 spec 的目标）
+ * test：测试目录
+ * example：示例/演示代码
+ * vendor：第三方依赖或打包产物
+ * config：配置文件目录
+ * docs：文档目录
+ */
+export type DirectoryCategory = 'source' | 'test' | 'example' | 'vendor' | 'config' | 'docs';
+/**
+ * 目录分类结果
+ */
+export interface DirectoryClassification {
+    /** 目录路径（相对于项目根或绝对路径） */
+    dirPath: string;
+    /** 分类结果 */
+    category: DirectoryCategory;
+    /** 分类置信度（0-1） */
+    confidence: number;
+    /** 分类依据（用于调试和审计） */
+    signals: DirectorySignal[];
+    /** 是否为用户覆盖（user override） */
+    isUserOverride: boolean;
+}
+/**
+ * 分类信号（单个证据）
+ */
+export interface DirectorySignal {
+    /** 信号类型 */
+    type: 'name_pattern' | 'content_feature' | 'import_reference';
+    /** 信号指向的分类 */
+    suggestedCategory: DirectoryCategory;
+    /** 信号权重（0-1） */
+    weight: number;
+    /** 信号描述 */
+    description: string;
+}
+/**
+ * 目录分类选项
+ */
+export interface DirectoryClassifierOptions {
+    /**
+     * 用户显式排除的目录（优先级最高，强制分类为非 source）
+     * 支持精确目录名或 glob 前缀
+     */
+    excludeDirs?: string[];
+    /**
+     * 用户显式包含的目录（即使被自动排除，也强制分类为 source）
+     */
+    includeDirs?: string[];
+    /**
+     * 最低置信度阈值（低于此值时保守地归为 source）
+     * 默认 0.6
+     */
+    minConfidence?: number;
+}
+/**
+ * 对单个目录进行分类
+ *
+ * @param dirPath - 目录路径
+ * @param importingFiles - 外部文件对该目录的 import 引用集合（用于 import 信号）
+ * @param options - 分类选项（用户覆盖等）
+ * @returns 目录分类结果
+ */
+export declare function classifyDirectory(dirPath: string, importingFiles?: Set<string>, options?: DirectoryClassifierOptions): DirectoryClassification;
+/**
+ * 批量对目录列表进行分类
+ *
+ * @param dirPaths - 目录路径数组
+ * @param importGraphEdges - 模块间 import 边（{from: 导入方文件路径, to: 被导入目录路径}）
+ * @param options - 分类选项
+ * @returns 每个目录的分类结果
+ */
+export declare function classifyDirectories(dirPaths: string[], importGraphEdges?: Array<{
+    from: string;
+    to: string;
+}>, options?: DirectoryClassifierOptions): DirectoryClassification[];
+//# sourceMappingURL=directory-classifier.d.ts.map

package/dist/batch/directory-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-classifier.d.ts","sourceRoot":"","sources":["../../src/batch/directory-classifier.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;IAC9D,cAAc;IACd,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA2MD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,GAAG,CAAC,MAAM,CAAa,EACvC,OAAO,GAAE,0BAA+B,GACvC,uBAAuB,CA4DzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,gBAAgB,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAM,EAC1D,OAAO,GAAE,0BAA+B,GACvC,uBAAuB,EAAE,CAuB3B"}