spectra-cli 4.1.1

package/dist/panoramic/parsers/yaml-config-parser.js

@@ -0,0 +1,356 @@
+/**
+ * YamlConfigParser — YAML 配置文件解析器
+ *
+ * 解析 YAML 配置文件（.yaml/.yml）中的键值对，
+ * 提取配置项路径、类型、默认值和注释说明。
+ *
+ * 解析策略：
+ * - 行级正则匹配 key: value 结构
+ * - 缩进堆栈跟踪嵌套层级，构建点号分隔的 keyPath
+ * - 上方注释行和行内注释均可作为 description
+ * - 上方注释优先于行内注释
+ * - 空行隔断注释与配置项的关联
+ *
+ * 容错降级：解析失败返回 { entries: [] }
+ */
+import { AbstractConfigParser } from './abstract-config-parser.js';
+import { inferType, stripQuotes } from './types.js';
+import { CommentTracker } from './comment-tracker.js';
+/**
+ * YAML 配置文件解析器
+ * 继承 AbstractConfigParser，只需实现 parseContent()
+ */
+export class YamlConfigParser extends AbstractConfigParser {
+    id = 'yaml-config';
+    name = 'YAML Config Parser';
+    filePatterns = ['**/*.yaml', '**/*.yml'];
+    /**
+     * 从 YAML 配置文件内容解析为 ConfigEntry 数组
+     */
+    parseContent(content) {
+        return parseYamlContent(content);
+    }
+}
+/**
+ * 解析受限 YAML 文档为 JS 风格的嵌套对象。
+ *
+ * 目标覆盖：
+ * - map / list 结构
+ * - Compose 常见短语法与长语法
+ * - inline array / inline object
+ *
+ * 非目标：
+ * - anchor / alias / merge key
+ * - 多文档 YAML
+ */
+export function parseYamlDocument(content) {
+    const lines = tokenizeYamlLines(content);
+    if (lines.length === 0) {
+        return {};
+    }
+    const state = { index: 0 };
+    const parsed = parseYamlBlock(lines, state, lines[0].indent);
+    return isYamlObject(parsed) ? parsed : {};
+}
+/**
+ * 解析 YAML 文件内容为 ConfigEntry 数组
+ * 使用行级正则解析，提取键值对、缩进层级和注释
+ *
+ * @param content - YAML 文件的文本内容
+ * @returns ConfigEntry 数组
+ */
+export function parseYamlContent(content) {
+    const entries = [];
+    const lines = content.split('\n');
+    // 用缩进堆栈跟踪当前路径
+    const pathStack = [];
+    const tracker = new CommentTracker();
+    for (const line of lines) {
+        const trimmed = line.trimEnd();
+        // 空行重置 pending comment
+        if (trimmed.trim() === '') {
+            tracker.reset();
+            continue;
+        }
+        // 纯注释行
+        if (/^\s*#/.test(trimmed)) {
+            const commentText = trimmed.replace(/^\s*#\s*/, '');
+            tracker.append(commentText);
+            continue;
+        }
+        // 匹配 key: value 或 key: (纯嵌套头)
+        const match = trimmed.match(/^(\s*)([\w][\w.-]*)\s*:\s*(.*?)$/);
+        if (!match) {
+            tracker.reset();
+            continue;
+        }
+        const indent = match[1].length;
+        const key = match[2];
+        let rawValue = match[3];
+        // 提取行内注释
+        let inlineComment = '';
+        const commentMatch = rawValue.match(/^(.*?)\s+#\s+(.*)$/);
+        if (commentMatch) {
+            rawValue = commentMatch[1].trim();
+            inlineComment = commentMatch[2];
+        }
+        // 更新路径堆栈
+        while (pathStack.length > 0 && pathStack[pathStack.length - 1].indent >= indent) {
+            pathStack.pop();
+        }
+        pathStack.push({ indent, key });
+        // 构建完整 keyPath
+        const keyPath = pathStack.map((p) => p.key).join('.');
+        // 有值 -> 叶节点
+        if (rawValue !== '') {
+            const cleanValue = stripQuotes(rawValue);
+            const pendingComment = tracker.consume();
+            const description = pendingComment || inlineComment;
+            entries.push({
+                keyPath,
+                type: inferType(cleanValue),
+                defaultValue: cleanValue,
+                description,
+            });
+        }
+        else {
+            // 无值 -> 父节点（不作为 entry，但保留在堆栈中）
+            tracker.consume(); // 消费注释但不使用
+        }
+    }
+    return entries;
+}
+function tokenizeYamlLines(content) {
+    const lines = [];
+    for (const rawLine of content.split('\n')) {
+        const withoutComment = stripYamlComment(rawLine);
+        if (withoutComment.trim() === '') {
+            continue;
+        }
+        lines.push({
+            indent: rawLine.match(/^\s*/)?.[0].length ?? 0,
+            text: withoutComment.trim(),
+        });
+    }
+    return lines;
+}
+function parseYamlBlock(lines, state, indent) {
+    if (state.index >= lines.length) {
+        return {};
+    }
+    const current = lines[state.index];
+    if (current.text.startsWith('- ')) {
+        return parseYamlSequence(lines, state, indent);
+    }
+    return parseYamlMapping(lines, state, indent);
+}
+function parseYamlMapping(lines, state, indent) {
+    const result = {};
+    while (state.index < lines.length) {
+        const line = lines[state.index];
+        if (line.indent < indent) {
+            break;
+        }
+        if (line.indent > indent) {
+            state.index += 1;
+            continue;
+        }
+        if (line.text.startsWith('- ')) {
+            break;
+        }
+        state.index += 1;
+        parseYamlMappingEntry(result, line.text, indent, lines, state);
+    }
+    return result;
+}
+function parseYamlMappingEntry(target, text, indent, lines, state) {
+    const separatorIndex = findYamlSeparator(text);
+    if (separatorIndex < 0) {
+        return;
+    }
+    const key = text.slice(0, separatorIndex).trim();
+    const rawValue = text.slice(separatorIndex + 1).trim();
+    if (rawValue.length > 0) {
+        target[key] = parseYamlScalar(rawValue);
+        return;
+    }
+    const next = lines[state.index];
+    if (!next || next.indent <= indent) {
+        target[key] = {};
+        return;
+    }
+    target[key] = parseYamlBlock(lines, state, next.indent);
+}
+function parseYamlSequence(lines, state, indent) {
+    const result = [];
+    while (state.index < lines.length) {
+        const line = lines[state.index];
+        if (line.indent < indent) {
+            break;
+        }
+        if (line.indent !== indent || !line.text.startsWith('- ')) {
+            break;
+        }
+        state.index += 1;
+        const itemText = line.text.slice(2).trim();
+        if (itemText.length === 0) {
+            const next = lines[state.index];
+            if (next && next.indent > indent) {
+                result.push(parseYamlBlock(lines, state, next.indent));
+            }
+            else {
+                result.push(null);
+            }
+            continue;
+        }
+        const separatorIndex = findYamlSeparator(itemText);
+        if (separatorIndex >= 0) {
+            result.push(parseYamlSequenceObjectItem(itemText, indent + 2, lines, state));
+            continue;
+        }
+        result.push(parseYamlScalar(itemText));
+    }
+    return result;
+}
+function parseYamlSequenceObjectItem(firstLine, indent, lines, state) {
+    const result = {};
+    parseYamlMappingEntry(result, firstLine, indent, lines, state);
+    while (state.index < lines.length) {
+        const line = lines[state.index];
+        if (line.indent < indent) {
+            break;
+        }
+        if (line.indent > indent) {
+            state.index += 1;
+            continue;
+        }
+        if (line.text.startsWith('- ')) {
+            break;
+        }
+        state.index += 1;
+        parseYamlMappingEntry(result, line.text, indent, lines, state);
+    }
+    return result;
+}
+function parseYamlScalar(rawValue) {
+    const trimmed = rawValue.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith('\'') && trimmed.endsWith('\''))) {
+        return trimmed.slice(1, -1);
+    }
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (inner.length === 0) {
+            return [];
+        }
+        return splitInlineYamlCollection(inner).map((item) => parseYamlScalar(item));
+    }
+    if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (inner.length === 0) {
+            return {};
+        }
+        const objectValue = {};
+        for (const item of splitInlineYamlCollection(inner)) {
+            const separatorIndex = findYamlSeparator(item);
+            if (separatorIndex < 0)
+                continue;
+            const key = item.slice(0, separatorIndex).trim();
+            const value = item.slice(separatorIndex + 1).trim();
+            objectValue[key] = parseYamlScalar(value);
+        }
+        return objectValue;
+    }
+    if (trimmed === 'true')
+        return true;
+    if (trimmed === 'false')
+        return false;
+    if (trimmed === 'null' || trimmed === '~')
+        return null;
+    if (/^-?\d+$/.test(trimmed))
+        return Number(trimmed);
+    if (/^-?\d+\.\d+$/.test(trimmed))
+        return Number(trimmed);
+    return trimmed;
+}
+function stripYamlComment(line) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (char === '\'' && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (char === '#' && !inSingle && !inDouble) {
+            return line.slice(0, i).trimEnd();
+        }
+    }
+    return line;
+}
+function findYamlSeparator(text) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (char === '\'' && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (char === ':' && !inSingle && !inDouble) {
+            const next = text[i + 1];
+            if (next !== undefined && !/\s/.test(next)) {
+                continue;
+            }
+            return i;
+        }
+    }
+    return -1;
+}
+function splitInlineYamlCollection(content) {
+    const result = [];
+    let current = '';
+    let inSingle = false;
+    let inDouble = false;
+    let depth = 0;
+    for (const char of content) {
+        if (char === '\'' && !inDouble) {
+            inSingle = !inSingle;
+        }
+        else if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+        }
+        else if (!inSingle && !inDouble) {
+            if (char === '[' || char === '{') {
+                depth += 1;
+            }
+            else if (char === ']' || char === '}') {
+                depth -= 1;
+            }
+            else if (char === ',' && depth === 0) {
+                if (current.trim().length > 0) {
+                    result.push(current.trim());
+                }
+                current = '';
+                continue;
+            }
+        }
+        current += char;
+    }
+    if (current.trim().length > 0) {
+        result.push(current.trim());
+    }
+    return result;
+}
+function isYamlObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=yaml-config-parser.js.map

package/dist/panoramic/parsers/yaml-config-parser.js.map

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

package/dist/panoramic/pipelines/adr-decision-pipeline.d.ts

@@ -0,0 +1,74 @@
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import type { ArchitectureNarrativeOutput, BatchGeneratedDocSummary } from './architecture-narrative.js';
+import type { ArchitectureOverviewOutput } from '../generators/architecture-overview-generator.js';
+import type { PatternHintsOutput } from '../models/pattern-hints-model.js';
+export type AdrSourceType = 'architecture-narrative' | 'pattern-hints' | 'current-spec' | 'spec' | 'blueprint' | 'commit' | 'source-path' | 'architecture-overview';
+export interface AdrEvidenceRef {
+    sourceType: AdrSourceType;
+    label: string;
+    path?: string;
+    excerpt: string;
+}
+export interface AdrDraft {
+    decisionId: string;
+    slug: string;
+    title: string;
+    status: 'proposed';
+    category: 'runtime' | 'protocol' | 'extensibility' | 'quality' | 'product-facts' | 'deployment' | 'modularity' | 'storage';
+    confidence: 'high' | 'medium';
+    inferred: boolean;
+    sourceTypes: AdrSourceType[];
+    summary: string;
+    decision: string;
+    context: string[];
+    consequences: string[];
+    alternatives: string[];
+    evidence: AdrEvidenceRef[];
+}
+export interface AdrIndexOutput {
+    title: string;
+    generatedAt: string;
+    projectName: string;
+    summary: string[];
+    draftCount: number;
+    warnings: string[];
+    drafts: AdrDraft[];
+}
+export interface GenerateBatchAdrDocsOptions {
+    projectRoot: string;
+    outputDir: string;
+    projectContext: ProjectContext;
+    generatedDocs: BatchGeneratedDocSummary[];
+    architectureNarrative: ArchitectureNarrativeOutput;
+    architectureOverview?: ArchitectureOverviewOutput;
+    patternHints?: PatternHintsOutput;
+}
+export interface GenerateBatchAdrDocsResult {
+    index: AdrIndexOutput;
+    drafts: AdrDraft[];
+    warnings: string[];
+    writtenFiles: string[];
+}
+export declare function generateBatchAdrDocs(options: GenerateBatchAdrDocsOptions): GenerateBatchAdrDocsResult;
+/**
+ * AdrDecisionPipelineGenerator
+ *
+ * 将 generateBatchAdrDocs() 适配为 DocumentGenerator 接口。
+ * generate() 包含 fs 文件写出副作用（写出 ADR 草稿与索引）。
+ * render() 为纯 Markdown 摘要，不含 fs 调用。
+ *
+ * TInput: GenerateBatchAdrDocsOptions
+ * TOutput: GenerateBatchAdrDocsResult
+ */
+export declare class AdrDecisionPipelineGenerator implements DocumentGenerator<GenerateBatchAdrDocsOptions, GenerateBatchAdrDocsResult> {
+    readonly id: "adr-decision-pipeline";
+    readonly name: "ADR \u51B3\u7B56\u6D41\u6C34\u7EBF\u751F\u6210\u5668";
+    readonly description = "\u57FA\u4E8E\u67B6\u6784\u4E8B\u5B9E\u4E0E\u6A21\u5757 spec \u751F\u6210\u5019\u9009 ADR \u8349\u7A3F\u4E0E\u7D22\u5F15\uFF0C\u5E76\u5199\u51FA\u5230 outputDir/docs/adr/";
+    private readonly outputDir;
+    constructor(outputDir: string);
+    isApplicable(context: ProjectContext): boolean;
+    extract(context: ProjectContext): Promise<GenerateBatchAdrDocsOptions>;
+    generate(input: GenerateBatchAdrDocsOptions, _options?: GenerateOptions): Promise<GenerateBatchAdrDocsResult>;
+    render(output: GenerateBatchAdrDocsResult): string;
+}
+//# sourceMappingURL=adr-decision-pipeline.d.ts.map

package/dist/panoramic/pipelines/adr-decision-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-decision-pipeline.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/adr-decision-pipeline.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EAEzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,MAAM,MAAM,aAAa,GACrB,wBAAwB,GACxB,eAAe,GACf,cAAc,GACd,MAAM,GACN,WAAW,GACX,QAAQ,GACR,aAAa,GACb,uBAAuB,CAAC;AAE5B,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EACJ,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,qBAAqB,EAAE,2BAA2B,CAAC;IACnD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAwCD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAgD5B;AA6VD;;;;;;;;;GASG;AACH,qBAAa,4BACX,YAAW,iBAAiB,CAAC,2BAA2B,EAAE,0BAA0B,CAAC;IAErF,QAAQ,CAAC,EAAE,EAAG,uBAAuB,CAAU;IAC/C,QAAQ,CAAC,IAAI,EAAG,sDAAc,CAAU;IACxC,QAAQ,CAAC,WAAW,+KAA4D;IAEhF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAI7B,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAKxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAuBtE,QAAQ,CACZ,KAAK,EAAE,2BAA2B,EAClC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,0BAA0B,CAAC;IAKtC,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM;CA4BnD"}