spectra-cli 4.1.1

package/dist/panoramic/api-surface/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/panoramic/api-surface/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,eAAe,GAAG,KAAK,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,oBAAoB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG;IACxE,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC,CAAC;AAMF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG;IACxE,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC,CAAC"}

package/dist/panoramic/api-surface/types.js

@@ -0,0 +1,7 @@
+/**
+ * API Surface 类型定义
+ *
+ * 公开类型 + 跨模块共享的内部类型。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/panoramic/api-surface/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/panoramic/api-surface/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/panoramic/api-surface/utils.d.ts

@@ -0,0 +1,29 @@
+import type { FileCollectionOptions } from './types.js';
+export declare const HTTP_METHODS: readonly ["get", "post", "put", "patch", "delete", "options", "head", "trace"];
+export declare const HTTP_METHOD_SET: Set<string>;
+export declare const TSOA_HTTP_DECORATORS: Map<string, string>;
+export declare const DEFAULT_IGNORE_DIRS: Set<string>;
+export declare const OPENAPI_FILE_PATTERN: RegExp;
+export declare const AUTH_HINT_PATTERN: RegExp;
+export declare const GENERIC_TAG_SEGMENTS: Set<string>;
+export declare const TS_SOURCE_EXTENSIONS: string[];
+export declare const PYTHON_EXTENSIONS: string[];
+export declare function toPosixPath(filePath: string): string;
+export declare function uniqueStrings(items: Iterable<string>): string[];
+export declare function getRelativePath(projectRoot: string, filePath: string): string;
+export declare function collectProjectFiles(projectRoot: string, options: FileCollectionOptions): string[];
+export declare function detectProjectName(projectRoot: string): string;
+export declare function joinUrlPaths(...segments: string[]): string;
+export declare function splitTopLevel(text: string, separator?: string): string[];
+export declare function extractBalancedContent(text: string, openParenIndex: number): {
+    content: string;
+    endIndex: number;
+} | null;
+export declare function stripWrappingQuotes(text: string): string | null;
+export declare function getNamedArgumentValue(argsText: string, key: string): string | undefined;
+export declare function getPositionalArguments(argsText: string): string[];
+export declare function extractStringArray(text: string | undefined): string[];
+export declare function extractDependencyNames(text: string): string[];
+export declare function tryReadFile(filePath: string): string | null;
+export declare function resolvePythonModulePath(fromFile: string, specifier: string, projectRoot: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/panoramic/api-surface/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/panoramic/api-surface/utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASxD,eAAO,MAAM,YAAY,gFASf,CAAC;AAEX,eAAO,MAAM,eAAe,aAA4C,CAAC;AACzE,eAAO,MAAM,oBAAoB,qBAQ/B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAW9B,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAAgE,CAAC;AAClG,eAAO,MAAM,iBAAiB,QAA8E,CAAC;AAC7G,eAAO,MAAM,oBAAoB,aAAmB,CAAC;AACrD,eAAO,MAAM,oBAAoB,UAAiD,CAAC;AACnF,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAMzC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAM/D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,EAAE,CA4CV;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA2B7D;AAMD,wBAAgB,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,EAAE,CA4DrE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C9C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAcrE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D;AAMD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoC/G"}

package/dist/panoramic/api-surface/utils.js

@@ -0,0 +1,340 @@
+/**
+ * API Surface 通用辅助函数与常量
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('api-surface-utils');
+// ============================================================
+// 常量
+// ============================================================
+export const HTTP_METHODS = [
+    'get',
+    'post',
+    'put',
+    'patch',
+    'delete',
+    'options',
+    'head',
+    'trace',
+];
+export const HTTP_METHOD_SET = new Set([...HTTP_METHODS, 'all']);
+export const TSOA_HTTP_DECORATORS = new Map([
+    ['Get', 'GET'],
+    ['Post', 'POST'],
+    ['Put', 'PUT'],
+    ['Patch', 'PATCH'],
+    ['Delete', 'DELETE'],
+    ['Options', 'OPTIONS'],
+    ['Head', 'HEAD'],
+]);
+export const DEFAULT_IGNORE_DIRS = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.nuxt',
+    '__pycache__',
+    '.venv',
+    'venv',
+]);
+export const OPENAPI_FILE_PATTERN = /(?:^|[-_.])(openapi|swagger)(?:[-_.].*)?\.(json|yaml|yml)$/i;
+export const AUTH_HINT_PATTERN = /(auth|guard|jwt|session|passport|protected|require|permission|token|acl)/i;
+export const GENERIC_TAG_SEGMENTS = new Set(['api']);
+export const TS_SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.cts'];
+export const PYTHON_EXTENSIONS = ['.py'];
+// ============================================================
+// 文件/路径工具
+// ============================================================
+export function toPosixPath(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+export function uniqueStrings(items) {
+    return [...new Set([...items]
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0))];
+}
+export function getRelativePath(projectRoot, filePath) {
+    return toPosixPath(path.relative(projectRoot, filePath));
+}
+export function collectProjectFiles(projectRoot, options) {
+    const results = [];
+    const allowedExtensions = new Set((options.extensions ?? []).map((ext) => ext.toLowerCase()));
+    const fileNamePattern = options.fileNamePattern;
+    function walk(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch (err) {
+            logger.debug(`目录遍历失败，静默跳过: ${dir} — ${String(err)}`);
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (DEFAULT_IGNORE_DIRS.has(entry.name)) {
+                    continue;
+                }
+                walk(fullPath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            const ext = path.extname(entry.name).toLowerCase();
+            const matchesExt = allowedExtensions.size === 0 || allowedExtensions.has(ext);
+            const matchesName = fileNamePattern ? fileNamePattern.test(entry.name) : true;
+            if (matchesExt && matchesName) {
+                results.push(fullPath);
+            }
+        }
+    }
+    walk(projectRoot);
+    results.sort();
+    return results;
+}
+export function detectProjectName(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            if (typeof pkg.name === 'string' && pkg.name.trim().length > 0) {
+                return pkg.name.trim();
+            }
+        }
+        catch (err) {
+            logger.debug(`package.json 解析失败，使用默认项目名称: ${String(err)}`);
+        }
+    }
+    const pyprojectPath = path.join(projectRoot, 'pyproject.toml');
+    if (fs.existsSync(pyprojectPath)) {
+        try {
+            const content = fs.readFileSync(pyprojectPath, 'utf-8');
+            const match = content.match(/^\s*name\s*=\s*["']([^"']+)["']/m);
+            if (match?.[1]) {
+                return match[1];
+            }
+        }
+        catch (err) {
+            logger.debug(`pyproject.toml 读取失败，使用默认项目名称: ${String(err)}`);
+        }
+    }
+    return path.basename(projectRoot);
+}
+// ============================================================
+// URL/文本解析工具
+// ============================================================
+export function joinUrlPaths(...segments) {
+    const parts = [];
+    for (const segment of segments) {
+        const trimmed = segment.trim();
+        if (!trimmed || trimmed === '/') {
+            continue;
+        }
+        const cleaned = trimmed.replace(/^\/+|\/+$/g, '');
+        if (cleaned.length > 0) {
+            parts.push(cleaned);
+        }
+    }
+    if (parts.length === 0) {
+        return '/';
+    }
+    return `/${parts.join('/')}`.replace(/\/{2,}/g, '/');
+}
+export function splitTopLevel(text, separator = ',') {
+    const result = [];
+    let current = '';
+    let parenDepth = 0;
+    let bracketDepth = 0;
+    let braceDepth = 0;
+    let quote = null;
+    let escape = false;
+    for (const ch of text) {
+        if (quote) {
+            current += ch;
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (ch === '\\') {
+                escape = true;
+            }
+            else if (ch === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === '\'' || ch === '`') {
+            quote = ch;
+            current += ch;
+            continue;
+        }
+        if (ch === '(')
+            parenDepth++;
+        else if (ch === ')')
+            parenDepth--;
+        else if (ch === '[')
+            bracketDepth++;
+        else if (ch === ']')
+            bracketDepth--;
+        else if (ch === '{')
+            braceDepth++;
+        else if (ch === '}')
+            braceDepth--;
+        if (ch === separator &&
+            parenDepth === 0 &&
+            bracketDepth === 0 &&
+            braceDepth === 0) {
+            const piece = current.trim();
+            if (piece.length > 0) {
+                result.push(piece);
+            }
+            current = '';
+            continue;
+        }
+        current += ch;
+    }
+    const tail = current.trim();
+    if (tail.length > 0) {
+        result.push(tail);
+    }
+    return result;
+}
+export function extractBalancedContent(text, openParenIndex) {
+    let depth = 0;
+    let quote = null;
+    let escape = false;
+    for (let i = openParenIndex; i < text.length; i++) {
+        const ch = text[i];
+        if (quote) {
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (ch === '\\') {
+                escape = true;
+                continue;
+            }
+            if (ch === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === '\'' || ch === '`') {
+            quote = ch;
+            continue;
+        }
+        if (ch === '(') {
+            depth++;
+            continue;
+        }
+        if (ch === ')') {
+            depth--;
+            if (depth === 0) {
+                return {
+                    content: text.slice(openParenIndex + 1, i),
+                    endIndex: i,
+                };
+            }
+        }
+    }
+    return null;
+}
+export function stripWrappingQuotes(text) {
+    const trimmed = text.trim();
+    const match = trimmed.match(/^(["'`])([\s\S]*)\1$/);
+    return match ? match[2] : null;
+}
+export function getNamedArgumentValue(argsText, key) {
+    for (const part of splitTopLevel(argsText)) {
+        const eqIndex = part.indexOf('=');
+        if (eqIndex <= 0) {
+            continue;
+        }
+        const name = part.slice(0, eqIndex).trim();
+        if (name === key) {
+            return part.slice(eqIndex + 1).trim();
+        }
+    }
+    return undefined;
+}
+export function getPositionalArguments(argsText) {
+    return splitTopLevel(argsText).filter((part) => !/^[a-zA-Z_]\w*\s*=/.test(part));
+}
+export function extractStringArray(text) {
+    if (!text) {
+        return [];
+    }
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) {
+        const single = stripWrappingQuotes(trimmed);
+        return single ? [single] : [];
+    }
+    const inner = trimmed.slice(1, -1);
+    return splitTopLevel(inner)
+        .map((part) => stripWrappingQuotes(part))
+        .filter((item) => item !== null);
+}
+export function extractDependencyNames(text) {
+    const names = [];
+    const dependsPattern = /\b(?:Depends|Security)\(\s*([A-Za-z_]\w*)/g;
+    let match;
+    while ((match = dependsPattern.exec(text)) !== null) {
+        names.push(match[1]);
+    }
+    return uniqueStrings(names);
+}
+// ============================================================
+// 文件读取/模块解析
+// ============================================================
+export function tryReadFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        logger.debug(`文件读取失败: ${filePath} — ${String(err)}`);
+        return null;
+    }
+}
+export function resolvePythonModulePath(fromFile, specifier, projectRoot) {
+    let candidateBase;
+    if (specifier.startsWith('.')) {
+        let level = 0;
+        while (specifier[level] === '.') {
+            level++;
+        }
+        let baseDir = path.dirname(fromFile);
+        for (let i = 1; i < level; i++) {
+            baseDir = path.dirname(baseDir);
+        }
+        const remainder = specifier.slice(level);
+        candidateBase = remainder.length > 0
+            ? path.join(baseDir, ...remainder.split('.'))
+            : baseDir;
+    }
+    else {
+        candidateBase = path.join(projectRoot, ...specifier.split('.'));
+    }
+    const candidates = [
+        `${candidateBase}.py`,
+        path.join(candidateBase, '__init__.py'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                return path.resolve(candidate);
+            }
+        }
+        catch (err) {
+            logger.debug(`Python 模块路径解析失败: ${candidate} — ${String(err)}`);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=utils.js.map

package/dist/panoramic/api-surface/utils.js.map

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

package/dist/panoramic/batch-project-docs.d.ts

@@ -0,0 +1,101 @@
+import type { ProjectContext } from './interfaces.js';
+import { type ArchitectureNarrativeOutput, type BatchGeneratedDocSummary } from './pipelines/architecture-narrative.js';
+import { type AdrIndexOutput } from './pipelines/adr-decision-pipeline.js';
+import { buildComponentView } from './builders/component-view-builder.js';
+import { buildDynamicScenarios } from './builders/dynamic-scenarios-builder.js';
+import { type CostSummary } from '../batch/cost-summary.js';
+import { type GenerateProductUxDocsResult } from './pipelines/product-ux-docs.js';
+import type { ArchitectureOverviewOutput } from './generators/architecture-overview-generator.js';
+import type { ArchitectureIROutput } from './generators/architecture-ir-generator.js';
+import type { PatternHintsOutput } from './models/pattern-hints-model.js';
+import type { RuntimeTopologyOutput } from './generators/runtime-topology-generator.js';
+import type { BatchMode } from './qa/types.js';
+export interface BatchProjectDocsResult {
+    projectContext: ProjectContext;
+    generatedDocs: BatchGeneratedDocSummary[];
+    /**
+     * Feature 133（adversarial-review post-fix）：reading / code-only 模式
+     * 跳过整个产品文档 pipeline 后此字段为 undefined；full 模式必填。
+     */
+    architectureNarrative?: ArchitectureNarrativeOutput;
+    qualityInputs: BatchDocsQualityInputs;
+    /** Feature 101: 供 graph-persistence 消费的 Architecture IR（可选） */
+    architectureIR?: ArchitectureIROutput['ir'];
+}
+export interface BatchDocsQualityInputs {
+    projectRoot: string;
+    outputDir: string;
+    projectContext: ProjectContext;
+    generatedDocs: BatchGeneratedDocSummary[];
+    /**
+     * Feature 133（adversarial-review post-fix）：reading / code-only 模式
+     * 跳过整个 narrative 生成时此字段为 undefined；下游 generateDocsQualityReport
+     * 等消费方需处理 undefined 情况
+     */
+    architectureNarrative?: ArchitectureNarrativeOutput;
+    architectureOverview?: ArchitectureOverviewOutput;
+    patternHints?: PatternHintsOutput;
+    componentView?: ReturnType<typeof buildComponentView>;
+    dynamicScenarios?: ReturnType<typeof buildDynamicScenarios>;
+    runtimeTopology?: RuntimeTopologyOutput;
+    adrIndex?: AdrIndexOutput;
+    productOverview?: GenerateProductUxDocsResult['overview'];
+    userJourneys?: GenerateProductUxDocsResult['journeys'];
+    featureBriefIndex?: GenerateProductUxDocsResult['featureBriefIndex'];
+    /** docs-bundle manifest 所在目录（默认 outputDir） */
+    manifestSearchDir?: string;
+    /** Feature 127：LLM 成本汇总，存在时在 quality-report.md 追加"LLM 成本与预算"节 */
+    costSummary?: CostSummary;
+}
+/**
+ * F5：reading 模式跳过的 generator ID 集合（产品文档层 + 架构推断层）
+ *
+ * Feature 133 P0-2 修复：原集合只列了 5 个 generator，导致 reading 模式实测
+ * 1047s 远超 SC-001 的 120s 目标。reading 模式应该让用户"快速读懂代码"，
+ * 不需要架构 IR / 产品文档 / 事件面 / 故事流等重型推断；只产出 modules/
+ * 下的 spec + _meta 索引即可。
+ *
+ * Post-review 修复：导出常量供测试共享，消除 3 处拷贝维护负担（DRY）。
+ */
+export declare const READING_SKIP_IDS: ReadonlySet<string>;
+/**
+ * F5：code-only 模式跳过的 generator ID 集合
+ * Feature 133 P0-2 后：reading 与 code-only 在 generator 跳过上等价；保留
+ * 独立常量便于未来分化（如 code-only 进一步禁用模块 spec LLM enrichment）。
+ */
+export declare const CODE_ONLY_SKIP_IDS: ReadonlySet<string>;
+export interface GenerateBatchProjectDocsOptions {
+    projectRoot: string;
+    outputDir: string;
+    /** specs 根目录（用于扫描模块 specs，默认 outputDir） */
+    specsRootDir?: string;
+    /** F5：批处理运行模式（full | reading | code-only，默认 full） */
+    mode?: BatchMode;
+    /**
+     * Feature 135 Bug 1：是否显式启用 ADR pipeline。
+     * v4.0.1 临时禁用（默认 false），evidence-binding 重构完成后（v4.1）恢复默认。
+     * 需用 CLI `--enable-adr` 显式开启。
+     */
+    enableAdr?: boolean;
+    /**
+     * Feature 140 FR-010 — README 全量内容（来自 extraction-pipeline，仅 --include-docs=true 时存在）。
+     * 透传给 architecture-narrative pipeline 作为 shared header；
+     * Step 4 (Phase 3b) MapReduce 集成时本字段会注入 narrative cluster orchestrator 的
+     * Map prompt sharedHeader 中（仅 anthropicClient 同时提供时启用 LLM 增强）。
+     */
+    readmeContent?: string;
+    /**
+     * Feature 140 Step 4 (Phase 3b, T32-T34) — Anthropic SDK 客户端（可选）。
+     * 提供时 architecture-narrative pipeline 会在 template 渲染基础上调用 enrichNarrativeWithLLM
+     * 4 段 LLM（Map / Reduce / Critique / Refine）+ domain-words 校验，让 narrative
+     * 包含项目特有抽象名而非通用模板。
+     * **Fail-safe**：LLM 失败 / domain-words 不达标 → 静默 fallback 到既有 template 输出，
+     * 不阻断 batch 主流程（caller 可通过 ArchitectureNarrativeOutput.critiqueResult 字段
+     * 观察是否启用了 LLM 路径）。
+     * 不提供时（默认）保持纯 template 行为（向后兼容）。
+     */
+    anthropicClient?: import('@anthropic-ai/sdk').default;
+}
+export declare function generateBatchProjectDocs(options: GenerateBatchProjectDocsOptions): Promise<BatchProjectDocsResult>;
+export declare function generateDocsQualityReport(options: BatchDocsQualityInputs): BatchGeneratedDocSummary;
+//# sourceMappingURL=batch-project-docs.d.ts.map

package/dist/panoramic/batch-project-docs.d.ts.map

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