spectra-cli 4.1.1

package/dist/panoramic/models/runtime-topology-model.d.ts

@@ -0,0 +1,145 @@
+/**
+ * RuntimeTopology shared model
+ *
+ * Feature 043 负责生产这份结构化运行时模型，Feature 045 直接消费它。
+ * 本文件只承载共享实体与归一化 helper，不包含 Markdown/模板细节。
+ */
+import type { ConfigEntry, DockerfileInfo } from '../parsers/types.js';
+export type RuntimeSourceKind = 'compose' | 'dockerfile' | 'env-file' | 'config';
+export type RuntimeStageRole = 'build' | 'runtime';
+export type RuntimeConfigFormat = 'env' | 'yaml' | 'toml';
+export type RuntimeConfigCategory = 'environment' | 'port' | 'image' | 'command' | 'volume' | 'general';
+export interface RuntimeEnvironmentVariable {
+    name: string;
+    value?: string;
+    sourceKind: RuntimeSourceKind;
+    sourceFile: string;
+    scope: 'global' | 'service' | 'stage';
+}
+export interface RuntimePortBinding {
+    target: string;
+    published?: string;
+    hostIp?: string;
+    protocol: string;
+    mode?: string;
+    raw: string;
+    sourceFile: string;
+}
+export interface RuntimeVolumeMount {
+    target: string;
+    source?: string;
+    type: 'bind' | 'volume' | 'tmpfs' | 'unknown';
+    readOnly: boolean;
+    raw: string;
+    sourceFile: string;
+}
+export interface RuntimeDependency {
+    service: string;
+    condition?: string;
+    required?: boolean;
+    sourceFile: string;
+}
+export interface RuntimeBuildStage {
+    name: string;
+    alias?: string;
+    index: number;
+    role: RuntimeStageRole;
+    baseImage: string;
+    sourceFile: string;
+    commands: string[];
+    environment: RuntimeEnvironmentVariable[];
+    exposedPorts: string[];
+    volumes: string[];
+    copiesFrom: string[];
+    workdir?: string;
+    command?: string;
+    entrypoint?: string;
+}
+export interface RuntimeImage {
+    name: string;
+    explicitImage?: string;
+    sourceFile: string;
+    buildContext?: string;
+    dockerfilePath?: string;
+    targetStage?: string;
+    stageNames: string[];
+}
+export interface RuntimeContainer {
+    name: string;
+    service: string;
+    sourceFile: string;
+    image?: string;
+    command?: string;
+    entrypoint?: string;
+    environment: RuntimeEnvironmentVariable[];
+    ports: RuntimePortBinding[];
+    volumes: RuntimeVolumeMount[];
+    dependsOn: string[];
+}
+export interface RuntimeService {
+    name: string;
+    sourceFile: string;
+    containerName: string;
+    image?: string;
+    buildContext?: string;
+    dockerfilePath?: string;
+    targetStage?: string;
+    stageNames: string[];
+    command?: string;
+    entrypoint?: string;
+    environment: RuntimeEnvironmentVariable[];
+    envFiles: string[];
+    ports: RuntimePortBinding[];
+    volumes: RuntimeVolumeMount[];
+    dependsOn: RuntimeDependency[];
+}
+export interface RuntimeConfigHint {
+    keyPath: string;
+    value: string;
+    sourceFile: string;
+    format: RuntimeConfigFormat;
+    category: RuntimeConfigCategory;
+    description?: string;
+}
+export interface RuntimeTopology {
+    projectName: string;
+    services: RuntimeService[];
+    images: RuntimeImage[];
+    containers: RuntimeContainer[];
+    stages: RuntimeBuildStage[];
+    configHints: RuntimeConfigHint[];
+    sourceFiles: string[];
+}
+export interface RuntimeTopologyStats {
+    totalServices: number;
+    totalImages: number;
+    totalContainers: number;
+    totalStages: number;
+    totalDependencies: number;
+    totalConfigHints: number;
+}
+/**
+ * Dockerfile 只有 build 信息时，为镜像生成稳定的本地名字。
+ */
+export declare function buildSyntheticImageName(serviceName: string): string;
+/**
+ * 将 shell 字符串/数组风格统一为文档友好的字符串。
+ */
+export declare function normalizeCommandValue(value: unknown): string | undefined;
+/**
+ * 运行时环境变量按声明顺序合并，后出现的覆盖前面的同名变量。
+ */
+export declare function mergeEnvironmentVariables(...sources: RuntimeEnvironmentVariable[][]): RuntimeEnvironmentVariable[];
+/**
+ * 从 DockerfileInfo 归一化运行时 stages。
+ */
+export declare function extractRuntimeBuildStages(dockerfile: DockerfileInfo, sourceFile: string, runtimeTargets?: Iterable<string>): RuntimeBuildStage[];
+/**
+ * 从配置项中过滤 runtime 相关提示。
+ */
+export declare function collectRuntimeConfigHints(entries: ConfigEntry[], sourceFile: string, format: RuntimeConfigFormat): RuntimeConfigHint[];
+/**
+ * 统计共享运行时模型的摘要信息。
+ */
+export declare function summarizeRuntimeTopology(topology: RuntimeTopology): RuntimeTopologyStats;
+//# sourceMappingURL=runtime-topology-model.d.ts.map

package/dist/panoramic/models/runtime-topology-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-topology-model.d.ts","sourceRoot":"","sources":["../../../src/panoramic/models/runtime-topology-model.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/models/runtime-topology-model.js

@@ -0,0 +1,300 @@
+// ============================================================
+// Helper utilities
+// ============================================================
+/**
+ * Dockerfile 只有 build 信息时，为镜像生成稳定的本地名字。
+ */
+export function buildSyntheticImageName(serviceName) {
+    return `${serviceName}:build`;
+}
+/**
+ * 将 shell 字符串/数组风格统一为文档友好的字符串。
+ */
+export function normalizeCommandValue(value) {
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => normalizeScalar(item))
+            .filter((item) => item.length > 0);
+        return parts.length > 0 ? parts.join(' ') : undefined;
+    }
+    const scalar = normalizeScalar(value);
+    return scalar.length > 0 ? scalar : undefined;
+}
+/**
+ * 运行时环境变量按声明顺序合并，后出现的覆盖前面的同名变量。
+ */
+export function mergeEnvironmentVariables(...sources) {
+    const merged = new Map();
+    for (const source of sources) {
+        for (const entry of source) {
+            merged.set(entry.name, entry);
+        }
+    }
+    return [...merged.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 从 DockerfileInfo 归一化运行时 stages。
+ */
+export function extractRuntimeBuildStages(dockerfile, sourceFile, runtimeTargets = []) {
+    const normalizedTargets = new Set([...runtimeTargets]
+        .map((target) => target.trim())
+        .filter((target) => target.length > 0));
+    const stages = dockerfile.stages.map((stage, index) => {
+        const name = stage.alias ?? `stage-${index + 1}`;
+        const commands = [];
+        const environment = [];
+        const exposedPorts = [];
+        const volumes = [];
+        const copiesFrom = new Set();
+        let workdir;
+        let command;
+        let entrypoint;
+        for (const instruction of stage.instructions) {
+            if (instruction.type === 'RUN') {
+                commands.push(instruction.args);
+            }
+            if (instruction.type === 'ENV') {
+                environment.push(...parseDockerEnvInstruction(instruction.args, sourceFile, name));
+            }
+            if (instruction.type === 'EXPOSE') {
+                exposedPorts.push(...parseDockerExposeInstruction(instruction.args));
+            }
+            if (instruction.type === 'VOLUME') {
+                volumes.push(...parseDockerVolumeInstruction(instruction.args));
+            }
+            if (instruction.type === 'WORKDIR') {
+                workdir = instruction.args.trim();
+            }
+            if (instruction.type === 'CMD') {
+                command = normalizeCommandValue(parseDockerCommandInstruction(instruction.args));
+            }
+            if (instruction.type === 'ENTRYPOINT') {
+                entrypoint = normalizeCommandValue(parseDockerCommandInstruction(instruction.args));
+            }
+            if (instruction.type === 'COPY' || instruction.type === 'ADD') {
+                const fromMatch = instruction.args.match(/--from=(\S+)/);
+                if (fromMatch?.[1]) {
+                    copiesFrom.add(fromMatch[1]);
+                }
+            }
+        }
+        return {
+            name,
+            alias: stage.alias,
+            index,
+            role: inferStageRole(name, stage.alias, index, dockerfile.stages.length, normalizedTargets),
+            baseImage: stage.baseImage,
+            sourceFile,
+            commands,
+            environment,
+            exposedPorts: uniqueSorted(exposedPorts),
+            volumes: uniqueSorted(volumes),
+            copiesFrom: [...copiesFrom].sort(),
+            workdir,
+            command,
+            entrypoint,
+        };
+    });
+    return stages;
+}
+/**
+ * 从配置项中过滤 runtime 相关提示。
+ */
+export function collectRuntimeConfigHints(entries, sourceFile, format) {
+    return entries
+        .filter((entry) => format === 'env' || isRuntimeRelevantKey(entry.keyPath))
+        .map((entry) => ({
+        keyPath: entry.keyPath,
+        value: entry.defaultValue,
+        sourceFile,
+        format,
+        category: inferRuntimeConfigCategory(entry.keyPath, format),
+        description: entry.description || undefined,
+    }));
+}
+/**
+ * 统计共享运行时模型的摘要信息。
+ */
+export function summarizeRuntimeTopology(topology) {
+    return {
+        totalServices: topology.services.length,
+        totalImages: topology.images.length,
+        totalContainers: topology.containers.length,
+        totalStages: topology.stages.length,
+        totalDependencies: topology.services.reduce((sum, service) => sum + service.dependsOn.length, 0),
+        totalConfigHints: topology.configHints.length,
+    };
+}
+// ============================================================
+// Internal helpers
+// ============================================================
+function normalizeScalar(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return '';
+}
+function uniqueSorted(values) {
+    return [...new Set(values.filter((value) => value.trim().length > 0))].sort();
+}
+function inferStageRole(name, alias, index, totalStages, runtimeTargets) {
+    if (runtimeTargets.size > 0) {
+        if (runtimeTargets.has(name) || (alias && runtimeTargets.has(alias))) {
+            return 'runtime';
+        }
+        return 'build';
+    }
+    return index === totalStages - 1 ? 'runtime' : 'build';
+}
+function parseDockerEnvInstruction(args, sourceFile, stageName) {
+    const entries = [];
+    const tokens = tokenizeShellLikeString(args);
+    if (tokens.every((token) => token.includes('='))) {
+        for (const token of tokens) {
+            const [name, ...rest] = token.split('=');
+            if (!name)
+                continue;
+            entries.push({
+                name,
+                value: rest.join('='),
+                sourceKind: 'dockerfile',
+                sourceFile,
+                scope: 'stage',
+            });
+        }
+        return entries;
+    }
+    if (tokens.length >= 2) {
+        entries.push({
+            name: tokens[0],
+            value: tokens.slice(1).join(' '),
+            sourceKind: 'dockerfile',
+            sourceFile,
+            scope: 'stage',
+        });
+    }
+    return entries.map((entry) => ({
+        ...entry,
+        sourceFile: `${sourceFile}#${stageName}`,
+    }));
+}
+function parseDockerExposeInstruction(args) {
+    return tokenizeShellLikeString(args)
+        .map((token) => token.trim())
+        .filter((token) => token.length > 0);
+}
+function parseDockerVolumeInstruction(args) {
+    const trimmed = args.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        return trimmed
+            .slice(1, -1)
+            .split(',')
+            .map((item) => item.trim().replace(/^['"]|['"]$/g, ''))
+            .filter((item) => item.length > 0);
+    }
+    return tokenizeShellLikeString(trimmed);
+}
+function parseDockerCommandInstruction(args) {
+    const trimmed = args.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (inner.length === 0)
+            return [];
+        return splitInlineCollection(inner).map((item) => item.replace(/^['"]|['"]$/g, ''));
+    }
+    return trimmed;
+}
+function tokenizeShellLikeString(value) {
+    const tokens = [];
+    let current = '';
+    let inSingle = false;
+    let inDouble = false;
+    for (const char of value.trim()) {
+        if (char === '\'' && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (/\s/.test(char) && !inSingle && !inDouble) {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+function splitInlineCollection(value) {
+    const items = [];
+    let current = '';
+    let inSingle = false;
+    let inDouble = false;
+    let depth = 0;
+    for (const char of value) {
+        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) {
+                    items.push(current.trim());
+                }
+                current = '';
+                continue;
+            }
+        }
+        current += char;
+    }
+    if (current.trim().length > 0) {
+        items.push(current.trim());
+    }
+    return items;
+}
+function isRuntimeRelevantKey(keyPath) {
+    return /(env|port|host|url|endpoint|image|docker|compose|command|entrypoint|cmd|volume|mount|listen|service)/i.test(keyPath);
+}
+function inferRuntimeConfigCategory(keyPath, format) {
+    if (format === 'env') {
+        return 'environment';
+    }
+    if (/port|listen/i.test(keyPath)) {
+        return 'port';
+    }
+    if (/image|docker|tag/i.test(keyPath)) {
+        return 'image';
+    }
+    if (/command|entrypoint|cmd/i.test(keyPath)) {
+        return 'command';
+    }
+    if (/volume|mount|path/i.test(keyPath)) {
+        return 'volume';
+    }
+    if (/env|host|url|endpoint|service/i.test(keyPath)) {
+        return 'environment';
+    }
+    return 'general';
+}
+//# sourceMappingURL=runtime-topology-model.js.map

package/dist/panoramic/models/runtime-topology-model.js.map

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

package/dist/panoramic/output-filenames.d.ts

@@ -0,0 +1,26 @@
+/**
+ * panoramic 项目级文档输出文件名映射
+ *
+ * 统一 batch 项目级编排、coverage audit 与 CLI 摘要使用的命名口径。
+ * `mock-readme` 仅作为接口设计验证，不纳入 batch 正式项目文档集合。
+ */
+declare const BATCH_PROJECT_OUTPUT_BASE_NAMES: Record<string, string>;
+export type BatchProjectGeneratorId = keyof typeof BATCH_PROJECT_OUTPUT_BASE_NAMES;
+export declare function isBatchProjectGeneratorId(generatorId: string): generatorId is BatchProjectGeneratorId;
+export declare function getBatchProjectOutputBaseName(generatorId: string): string;
+export declare function getBatchProjectOutputFileName(generatorId: string): string;
+export declare function listBatchProjectGeneratorIds(): BatchProjectGeneratorId[];
+/**
+ * batch 输出的子目录名称
+ * 用于将 specs/ 根目录下的文件组织到语义分类子目录中
+ */
+export declare const BATCH_OUTPUT_SUBDIRS: {
+    /** 模块级 Spec 文件 + 架构索引 */
+    readonly MODULES: "modules";
+    /** 项目级文档（架构、产品、质量等） */
+    readonly PROJECT: "project";
+    /** 系统元数据（batch 摘要、manifest、差量报告等） */
+    readonly META: "_meta";
+};
+export {};
+//# sourceMappingURL=output-filenames.d.ts.map

package/dist/panoramic/output-filenames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-filenames.d.ts","sourceRoot":"","sources":["../../src/panoramic/output-filenames.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAA,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAa3D,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,+BAA+B,CAAC;AAEnF,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,IAAI,uBAAuB,CAErG;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,4BAA4B,IAAI,uBAAuB,EAAE,CAExE;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B,yBAAyB;;IAEzB,uBAAuB;;IAEvB,qCAAqC;;CAE7B,CAAC"}

package/dist/panoramic/output-filenames.js

@@ -0,0 +1,48 @@
+/**
+ * panoramic 项目级文档输出文件名映射
+ *
+ * 统一 batch 项目级编排、coverage audit 与 CLI 摘要使用的命名口径。
+ * `mock-readme` 仅作为接口设计验证，不纳入 batch 正式项目文档集合。
+ */
+const BATCH_PROJECT_OUTPUT_BASE_NAMES = {
+    'config-reference': 'config-reference',
+    'data-model': 'data-model',
+    'workspace-index': 'workspace-index',
+    'cross-package-deps': 'cross-package-analysis',
+    'api-surface': 'api-surface',
+    'interface-surface': 'interface-surface',
+    'runtime-topology': 'runtime-topology',
+    'architecture-overview': 'architecture-overview',
+    'architecture-ir': 'architecture-ir',
+    'pattern-hints': 'pattern-hints',
+    'event-surface': 'event-surface',
+    'troubleshooting': 'troubleshooting',
+};
+export function isBatchProjectGeneratorId(generatorId) {
+    return generatorId in BATCH_PROJECT_OUTPUT_BASE_NAMES;
+}
+export function getBatchProjectOutputBaseName(generatorId) {
+    return BATCH_PROJECT_OUTPUT_BASE_NAMES[generatorId] ?? generatorId;
+}
+export function getBatchProjectOutputFileName(generatorId) {
+    return `${getBatchProjectOutputBaseName(generatorId)}.md`;
+}
+export function listBatchProjectGeneratorIds() {
+    return Object.keys(BATCH_PROJECT_OUTPUT_BASE_NAMES);
+}
+// ============================================================
+// batch 输出目录结构常量
+// ============================================================
+/**
+ * batch 输出的子目录名称
+ * 用于将 specs/ 根目录下的文件组织到语义分类子目录中
+ */
+export const BATCH_OUTPUT_SUBDIRS = {
+    /** 模块级 Spec 文件 + 架构索引 */
+    MODULES: 'modules',
+    /** 项目级文档（架构、产品、质量等） */
+    PROJECT: 'project',
+    /** 系统元数据（batch 摘要、manifest、差量报告等） */
+    META: '_meta',
+};
+//# sourceMappingURL=output-filenames.js.map

package/dist/panoramic/output-filenames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-filenames.js","sourceRoot":"","sources":["../../src/panoramic/output-filenames.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,+BAA+B,GAA2B;IAC9D,kBAAkB,EAAE,kBAAkB;IACtC,YAAY,EAAE,YAAY;IAC1B,iBAAiB,EAAE,iBAAiB;IACpC,oBAAoB,EAAE,wBAAwB;IAC9C,aAAa,EAAE,aAAa;IAC5B,mBAAmB,EAAE,mBAAmB;IACxC,kBAAkB,EAAE,kBAAkB;IACtC,uBAAuB,EAAE,uBAAuB;IAChD,iBAAiB,EAAE,iBAAiB;IACpC,eAAe,EAAE,eAAe;IAChC,eAAe,EAAE,eAAe;IAChC,iBAAiB,EAAE,iBAAiB;CACrC,CAAC;AAIF,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,WAAW,IAAI,+BAA+B,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,OAAO,+BAA+B,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAC/D,OAAO,GAAG,6BAA6B,CAAC,WAAW,CAAC,KAAK,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAA8B,CAAC;AACnF,CAAC;AAED,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,yBAAyB;IACzB,OAAO,EAAE,SAAS;IAClB,uBAAuB;IACvB,OAAO,EAAE,SAAS;IAClB,qCAAqC;IACrC,IAAI,EAAE,OAAO;CACL,CAAC"}

package/dist/panoramic/parser-registry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ArtifactParserRegistry — 非代码制品解析器注册中心（单例）
+ *
+ * 职责：
+ * - 维护 Parser id 到 ArtifactParser 实例的映射
+ * - 提供按 id 查询、全量列出、按文件路径匹配的能力
+ * - 检测 id 冲突（两阶段验证：格式校验 + 重复检测）
+ * - 管理 Parser 的启用/禁用状态
+ *
+ * 设计决策：
+ * - 继承 AbstractRegistry<ArtifactParser, ParserEntry> 复用通用逻辑
+ * - 单例模式镜像 GeneratorRegistry，保证全局唯一性
+ * - 启用/禁用状态由 Registry 拥有（独立 Map），不修改外部 Parser 实例
+ * - getByFilePattern 使用简单的扩展名/文件名匹配（无外部依赖）
+ *
+ * 生命周期：进程级单例，CLI 和 MCP 入口各自在启动时通过 bootstrapParsers() 完成注册。
+ */
+import type { z } from 'zod';
+import type { ArtifactParser } from './interfaces.js';
+import { AbstractRegistry } from './abstract-registry.js';
+/**
+ * list() 方法返回的只读数据视图
+ * 包含 Parser 实例引用和当前启用/禁用状态
+ */
+export interface ParserEntry {
+    /** Parser 实例引用（只读视图） */
+    readonly parser: ArtifactParser<any>;
+    /** 当前启用/禁用状态 */
+    readonly enabled: boolean;
+}
+/**
+ * Parser 的中心化注册中心
+ * 维护 id 到 ArtifactParser 实例的映射以及每个 Parser 的启用/禁用状态。
+ * 进程级单例，全局唯一。
+ */
+export declare class ArtifactParserRegistry extends AbstractRegistry<ArtifactParser<any>, ParserEntry> {
+    /** 单例实例 */
+    private static instance;
+    private constructor();
+    /**
+     * 获取或创建 Registry 单例
+     */
+    static getInstance(): ArtifactParserRegistry;
+    /**
+     * 重置单例（仅限测试使用）
+     * 重置后下次 getInstance() 返回新的空白实例。
+     */
+    static resetInstance(): void;
+    protected getMetadataSchema(): z.ZodSchema;
+    protected extractMetadata(item: ArtifactParser<any>): {
+        id: string;
+        name: string;
+        filePatterns: string[];
+    };
+    protected buildEntry(item: ArtifactParser<any>, enabled: boolean): ParserEntry;
+    /**
+     * 切换 Parser 的启用/禁用状态
+     * 重写基类方法以保持向后兼容的错误消息前缀
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * 根据文件路径匹配适用的 Parser 列表
+     *
+     * 匹配策略（简单扩展名/文件名匹配，不引入外部 glob 依赖）：
+     * - pattern 以 ** / 开头时：取 pattern 中最后一个 / 后的部分作为文件名匹配模式
+     * - 支持 *.ext 格式：匹配文件扩展名
+     * - 支持 .ext.* 格式：匹配以 .ext 开头的文件名（如 .env.local）
+     * - 支持精确文件名匹配（如 Dockerfile）
+     * - 支持 Filename.* 格式：匹配文件名前缀（如 Dockerfile.prod）
+     *
+     * 仅返回已启用的 Parser。
+     *
+     * @param filePath - 文件路径（绝对或相对）
+     * @returns 适用的 Parser 列表
+     */
+    getByFilePattern(filePath: string): ArtifactParser<any>[];
+    /**
+     * 简单的文件模式匹配
+     * 不引入 minimatch 等外部依赖，使用扩展名和文件名匹配
+     */
+    private matchPattern;
+}
+/**
+ * 启动 Parser 注册
+ * 在 CLI/MCP 入口最早时机调用，完成所有内置 Parser 的注册。
+ * 幂等：如果 Registry 已有 Parser 注册则跳过。
+ */
+export declare function bootstrapParsers(): void;
+//# sourceMappingURL=parser-registry.d.ts.map

package/dist/panoramic/parser-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-registry.d.ts","sourceRoot":"","sources":["../../src/panoramic/parser-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa1D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC5F,WAAW;IACX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAE9D,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B,SAAS,CAAC,iBAAiB,IAAI,CAAC,CAAC,SAAS;IAI1C,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;IAQ1G,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW;IAQ9E;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAW9C;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE;IAqBzD;;;OAGG;IACH,OAAO,CAAC,YAAY;CAwBrB;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAiBvC"}