spectra-cli 4.1.1

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

@@ -0,0 +1,238 @@
+/**
+ * ApiSurfaceGenerator — API Surface Reference 生成器
+ *
+ * 优先级固定为：
+ * 1. 读取現有 OpenAPI / Swagger 产物
+ * 2. 静态解析 FastAPI / tsoa 元数据
+ * 3. Express AST fallback
+ *
+ * 实现 DocumentGenerator<ApiSurfaceInput, ApiSurfaceOutput> 接口。
+ */
+import { Project } from 'ts-morph';
+import { loadTemplate } from '../utils/template-loader.js';
+import { collectProjectFiles, detectProjectName, joinUrlPaths, OPENAPI_FILE_PATTERN, PYTHON_EXTENSIONS, tryReadFile, TS_SOURCE_EXTENSIONS, uniqueStrings, } from './utils.js';
+import { collectAuthHints, dedupeEndpoints, deriveTags, extractPathParameters } from './endpoint-utils.js';
+import { extractFromSchema } from './openapi-extractor.js';
+import { extractFromFrameworkIntrospection } from './framework-introspection.js';
+import { analyzeExpressFile } from './express-extractor.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('api-surface-generator');
+// ============================================================
+// Express 高层提取（使用 express-extractor 的 analyzeExpressFile）
+// ============================================================
+function resolveExpressRouters(analyses) {
+    const resolved = new Map();
+    const byFile = new Map(analyses.map((analysis) => [analysis.filePath, analysis]));
+    for (const analysis of analyses) {
+        for (const router of analysis.routers.values()) {
+            const mounts = [];
+            for (const mount of router.mounts) {
+                let targetId;
+                if (analysis.routers.has(mount.targetLocalName)) {
+                    targetId = analysis.routers.get(mount.targetLocalName).id;
+                }
+                else {
+                    const binding = analysis.imports.get(mount.targetLocalName);
+                    const importedAnalysis = binding ? byFile.get(binding.targetFile) : undefined;
+                    if (binding && importedAnalysis) {
+                        const localName = binding.exportName === 'default'
+                            ? importedAnalysis.defaultExport
+                            : importedAnalysis.namedExports.get(binding.exportName);
+                        if (localName && importedAnalysis.routers.has(localName)) {
+                            targetId = importedAnalysis.routers.get(localName).id;
+                        }
+                    }
+                }
+                if (targetId) {
+                    mounts.push({
+                        prefix: mount.prefix,
+                        middlewares: mount.middlewares,
+                        targetId,
+                    });
+                }
+            }
+            resolved.set(router.id, {
+                ...router,
+                mounts,
+            });
+        }
+    }
+    return resolved;
+}
+function extractFromExpressAst(projectRoot) {
+    const files = collectProjectFiles(projectRoot, { extensions: TS_SOURCE_EXTENSIONS });
+    if (files.length === 0) {
+        return null;
+    }
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: {
+            allowJs: true,
+        },
+    });
+    for (const filePath of files) {
+        try {
+            project.addSourceFileAtPath(filePath);
+        }
+        catch (err) {
+            logger.warn(`TS/JS 文件解析失败，已跳过: ${filePath}`, String(err));
+        }
+    }
+    const analyses = project.getSourceFiles()
+        .map((sourceFile) => analyzeExpressFile(projectRoot, sourceFile))
+        .filter((analysis) => analysis.routers.size > 0 ||
+        analysis.imports.size > 0);
+    const routers = resolveExpressRouters(analyses);
+    if (routers.size === 0) {
+        return null;
+    }
+    const parentCounts = new Map();
+    for (const router of routers.values()) {
+        parentCounts.set(router.id, parentCounts.get(router.id) ?? 0);
+        for (const mount of router.mounts) {
+            parentCounts.set(mount.targetId, (parentCounts.get(mount.targetId) ?? 0) + 1);
+        }
+    }
+    const roots = [...routers.values()].filter((router) => router.kind === 'app' || (parentCounts.get(router.id) ?? 0) === 0);
+    const endpoints = [];
+    const sourceFiles = new Set();
+    const visited = new Set();
+    function walk(routerId, prefix, inheritedMiddlewares) {
+        const router = routers.get(routerId);
+        if (!router) {
+            return;
+        }
+        for (const route of router.routes) {
+            const fullPath = joinUrlPaths(prefix, route.path);
+            const auth = collectAuthHints([...inheritedMiddlewares, ...route.middlewares]);
+            const tags = deriveTags(fullPath, route.sourceFile);
+            sourceFiles.add(route.sourceFile);
+            endpoints.push({
+                method: route.method,
+                path: fullPath,
+                parameters: extractPathParameters(fullPath),
+                responses: [{
+                        statusCode: '200',
+                        type: 'unknown',
+                    }],
+                responseType: 'unknown',
+                auth,
+                tags,
+                source: 'ast',
+                sourceFile: route.sourceFile,
+            });
+        }
+        for (const mount of router.mounts) {
+            const visitKey = `${routerId}->${mount.targetId}:${mount.prefix}`;
+            if (visited.has(visitKey)) {
+                continue;
+            }
+            visited.add(visitKey);
+            walk(mount.targetId, joinUrlPaths(prefix, mount.prefix), [...inheritedMiddlewares, ...mount.middlewares]);
+        }
+    }
+    const rootRouters = roots.length > 0 ? roots : [...routers.values()];
+    for (const root of rootRouters) {
+        walk(root.id, '', []);
+    }
+    const deduped = dedupeEndpoints(endpoints);
+    if (deduped.length === 0) {
+        return null;
+    }
+    return {
+        source: 'ast',
+        endpoints: deduped,
+        sourceFiles: [...sourceFiles].sort(),
+    };
+}
+// ============================================================
+// Generator 实现
+// ============================================================
+export class ApiSurfaceGenerator {
+    id = 'api-surface';
+    name = 'API Surface Reference 生成器';
+    description = '按 schema -> introspection -> ast 优先级生成 API Surface Reference';
+    async isApplicable(context) {
+        if (collectProjectFiles(context.projectRoot, {
+            extensions: ['.json', '.yaml', '.yml'],
+            fileNamePattern: OPENAPI_FILE_PATTERN,
+        }).length > 0) {
+            return true;
+        }
+        const sourceFiles = collectProjectFiles(context.projectRoot, {
+            extensions: [...TS_SOURCE_EXTENSIONS, ...PYTHON_EXTENSIONS],
+        });
+        for (const filePath of sourceFiles) {
+            const content = tryReadFile(filePath);
+            if (!content) {
+                continue;
+            }
+            if (/\bFastAPI\s*\(|\bAPIRouter\s*\(|@Route\s*\(|\bexpress\.Router\s*\(|\bRouter\s*\(|\.route\s*\(/.test(content)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async extract(context) {
+        const projectName = detectProjectName(context.projectRoot);
+        const schemaResult = extractFromSchema(context.projectRoot);
+        if (schemaResult) {
+            return {
+                projectName,
+                source: schemaResult.source,
+                endpoints: schemaResult.endpoints,
+                sourceFiles: schemaResult.sourceFiles,
+            };
+        }
+        const introspectionResult = extractFromFrameworkIntrospection(context.projectRoot);
+        if (introspectionResult) {
+            return {
+                projectName,
+                source: introspectionResult.source,
+                endpoints: introspectionResult.endpoints,
+                sourceFiles: introspectionResult.sourceFiles,
+            };
+        }
+        const astResult = extractFromExpressAst(context.projectRoot);
+        if (astResult) {
+            return {
+                projectName,
+                source: astResult.source,
+                endpoints: astResult.endpoints,
+                sourceFiles: astResult.sourceFiles,
+            };
+        }
+        return {
+            projectName,
+            source: 'ast',
+            endpoints: [],
+            sourceFiles: [],
+        };
+    }
+    async generate(input, _options) {
+        const endpoints = dedupeEndpoints(input.endpoints);
+        const byMethod = {};
+        for (const endpoint of endpoints) {
+            byMethod[endpoint.method] = (byMethod[endpoint.method] ?? 0) + 1;
+        }
+        const tags = uniqueStrings(endpoints.flatMap((endpoint) => endpoint.tags)).sort();
+        const totalParameters = endpoints.reduce((sum, endpoint) => sum + endpoint.parameters.length, 0);
+        return {
+            title: `API Surface Reference: ${input.projectName}`,
+            generatedAt: new Date().toISOString().split('T')[0],
+            projectName: input.projectName,
+            source: input.source,
+            endpoints,
+            totalEndpoints: endpoints.length,
+            totalParameters,
+            sourceFiles: uniqueStrings(input.sourceFiles).sort(),
+            byMethod,
+            tags,
+        };
+    }
+    render(output) {
+        const template = loadTemplate('api-surface.hbs', import.meta.url);
+        return template(output);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/panoramic/api-surface/openapi-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionResult } from './types.js';
+export declare function extractFromSchema(projectRoot: string): ExtractionResult | null;
+//# sourceMappingURL=openapi-extractor.d.ts.map

package/dist/panoramic/api-surface/openapi-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-extractor.d.ts","sourceRoot":"","sources":["../../../src/panoramic/api-surface/openapi-extractor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuNjH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA6F9E"}

package/dist/panoramic/api-surface/openapi-extractor.js

@@ -0,0 +1,247 @@
+/**
+ * OpenAPI / Swagger Schema 解析
+ */
+import * as path from 'node:path';
+import { collectProjectFiles, getRelativePath, HTTP_METHODS, OPENAPI_FILE_PATTERN, tryReadFile, uniqueStrings, } from './utils.js';
+import { dedupeEndpoints, renderResponseType } from './endpoint-utils.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('openapi-extractor');
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function decodeJsonPointerSegment(segment) {
+    return segment.replace(/~1/g, '/').replace(/~0/g, '~');
+}
+function resolveRef(doc, ref) {
+    if (typeof ref !== 'string' || !ref.startsWith('#/')) {
+        return null;
+    }
+    const segments = ref.slice(2).split('/').map(decodeJsonPointerSegment);
+    let current = doc;
+    for (const segment of segments) {
+        if (!isPlainObject(current) && !Array.isArray(current)) {
+            return null;
+        }
+        current = current[segment];
+    }
+    return current ?? null;
+}
+function dereference(doc, value) {
+    if (!isPlainObject(value) || typeof value.$ref !== 'string') {
+        return value;
+    }
+    const resolved = resolveRef(doc, value.$ref);
+    if (!resolved || !isPlainObject(resolved)) {
+        return value;
+    }
+    return {
+        ...resolved,
+        ...Object.fromEntries(Object.entries(value).filter(([key]) => key !== '$ref')),
+    };
+}
+function formatSchemaType(doc, schema) {
+    if (!schema) {
+        return 'unknown';
+    }
+    if (isPlainObject(schema) && typeof schema.$ref === 'string') {
+        const refSegments = schema.$ref.split('/');
+        return refSegments[refSegments.length - 1] ?? 'unknown';
+    }
+    const resolvedSchema = dereference(doc, schema);
+    if (!isPlainObject(resolvedSchema)) {
+        return 'unknown';
+    }
+    if (Array.isArray(resolvedSchema.oneOf) && resolvedSchema.oneOf.length > 0) {
+        return uniqueStrings(resolvedSchema.oneOf.map((item) => formatSchemaType(doc, item))).join(' | ');
+    }
+    if (Array.isArray(resolvedSchema.anyOf) && resolvedSchema.anyOf.length > 0) {
+        return uniqueStrings(resolvedSchema.anyOf.map((item) => formatSchemaType(doc, item))).join(' | ');
+    }
+    if (Array.isArray(resolvedSchema.allOf) && resolvedSchema.allOf.length > 0) {
+        return uniqueStrings(resolvedSchema.allOf.map((item) => formatSchemaType(doc, item))).join(' & ');
+    }
+    if (Array.isArray(resolvedSchema.enum) && resolvedSchema.enum.length > 0) {
+        return `enum(${resolvedSchema.enum.map(String).join(', ')})`;
+    }
+    if (resolvedSchema.type === 'array') {
+        return `${formatSchemaType(doc, resolvedSchema.items)}[]`;
+    }
+    if (resolvedSchema.type === 'object' && resolvedSchema.additionalProperties) {
+        return `Record<string, ${formatSchemaType(doc, resolvedSchema.additionalProperties)}>`;
+    }
+    if (typeof resolvedSchema.type === 'string') {
+        return resolvedSchema.type;
+    }
+    if (isPlainObject(resolvedSchema.properties)) {
+        return 'object';
+    }
+    return 'unknown';
+}
+function normalizeSchemaParameters(doc, rawParameters) {
+    const parameters = [];
+    for (const rawParameter of rawParameters) {
+        const parameter = dereference(doc, rawParameter);
+        if (!isPlainObject(parameter)) {
+            continue;
+        }
+        const name = typeof parameter.name === 'string' ? parameter.name : 'body';
+        const location = typeof parameter.in === 'string'
+            ? parameter.in
+            : 'unknown';
+        let type = 'unknown';
+        if (parameter.schema) {
+            type = formatSchemaType(doc, parameter.schema);
+        }
+        else if (parameter.content && isPlainObject(parameter.content)) {
+            const firstContent = Object.values(parameter.content)[0];
+            type = formatSchemaType(doc, isPlainObject(firstContent) ? firstContent.schema : undefined);
+        }
+        parameters.push({
+            name,
+            in: location,
+            type,
+            required: location === 'path' ? true : Boolean(parameter.required),
+            description: typeof parameter.description === 'string' ? parameter.description : undefined,
+        });
+    }
+    return parameters;
+}
+function extractRequestBodyParameter(doc, rawRequestBody) {
+    const requestBody = dereference(doc, rawRequestBody);
+    if (!isPlainObject(requestBody) || !isPlainObject(requestBody.content)) {
+        return [];
+    }
+    const preferredContent = requestBody.content['application/json'] ??
+        Object.values(requestBody.content)[0];
+    const schema = isPlainObject(preferredContent) ? preferredContent.schema : undefined;
+    return [{
+            name: 'body',
+            in: 'body',
+            type: formatSchemaType(doc, schema),
+            required: Boolean(requestBody.required),
+            description: typeof requestBody.description === 'string' ? requestBody.description : undefined,
+        }];
+}
+function extractSchemaResponses(doc, rawResponses) {
+    if (!isPlainObject(rawResponses)) {
+        return [];
+    }
+    const responses = [];
+    for (const [statusCode, rawValue] of Object.entries(rawResponses)) {
+        const response = dereference(doc, rawValue);
+        if (!isPlainObject(response)) {
+            continue;
+        }
+        let type = 'unknown';
+        if (isPlainObject(response.content)) {
+            const preferredContent = response.content['application/json'] ??
+                Object.values(response.content)[0];
+            type = formatSchemaType(doc, isPlainObject(preferredContent) ? preferredContent.schema : undefined);
+        }
+        else if (response.schema) {
+            type = formatSchemaType(doc, response.schema);
+        }
+        responses.push({
+            statusCode,
+            type,
+            description: typeof response.description === 'string' ? response.description : undefined,
+        });
+    }
+    const preferred = responses
+        .filter((response) => /^2\d\d$/.test(response.statusCode))
+        .sort((a, b) => a.statusCode.localeCompare(b.statusCode));
+    if (preferred.length > 0) {
+        return [...preferred, ...responses.filter((response) => !/^2\d\d$/.test(response.statusCode))];
+    }
+    return responses.sort((a, b) => a.statusCode.localeCompare(b.statusCode));
+}
+function extractSecuritySchemes(rawSecurity) {
+    if (!Array.isArray(rawSecurity)) {
+        return [];
+    }
+    const schemeNames = [];
+    for (const entry of rawSecurity) {
+        if (!isPlainObject(entry)) {
+            continue;
+        }
+        schemeNames.push(...Object.keys(entry));
+    }
+    return uniqueStrings(schemeNames).sort();
+}
+export function extractFromSchema(projectRoot) {
+    const schemaFiles = collectProjectFiles(projectRoot, {
+        extensions: ['.json', '.yaml', '.yml'],
+        fileNamePattern: OPENAPI_FILE_PATTERN,
+    });
+    const endpoints = [];
+    const sourceFiles = [];
+    for (const filePath of schemaFiles) {
+        if (path.extname(filePath).toLowerCase() !== '.json') {
+            continue;
+        }
+        const content = tryReadFile(filePath);
+        if (!content) {
+            continue;
+        }
+        let doc;
+        try {
+            doc = JSON.parse(content);
+        }
+        catch (err) {
+            logger.debug(`OpenAPI JSON 解析失败，跳过该文件: ${String(err)}`);
+            continue;
+        }
+        if (!isPlainObject(doc) || !isPlainObject(doc.paths)) {
+            continue;
+        }
+        const globalSecurity = extractSecuritySchemes(doc.security);
+        sourceFiles.push(getRelativePath(projectRoot, filePath));
+        for (const [rawPath, rawPathItem] of Object.entries(doc.paths)) {
+            if (!isPlainObject(rawPathItem)) {
+                continue;
+            }
+            const pathLevelParameters = normalizeSchemaParameters(doc, Array.isArray(rawPathItem.parameters) ? rawPathItem.parameters : []);
+            const pathLevelSecurity = extractSecuritySchemes(rawPathItem.security);
+            for (const method of HTTP_METHODS) {
+                const operation = rawPathItem[method];
+                if (!isPlainObject(operation)) {
+                    continue;
+                }
+                const operationParameters = normalizeSchemaParameters(doc, Array.isArray(operation.parameters) ? operation.parameters : []);
+                const requestBodyParameters = extractRequestBodyParameter(doc, operation.requestBody);
+                const responses = extractSchemaResponses(doc, operation.responses);
+                const tags = Array.isArray(operation.tags)
+                    ? operation.tags.filter((tag) => typeof tag === 'string')
+                    : [];
+                const auth = uniqueStrings([
+                    ...extractSecuritySchemes(operation.security),
+                    ...pathLevelSecurity,
+                    ...globalSecurity,
+                ]);
+                endpoints.push({
+                    method: method.toUpperCase(),
+                    path: rawPath,
+                    parameters: [...pathLevelParameters, ...operationParameters, ...requestBodyParameters],
+                    responses,
+                    responseType: renderResponseType(responses),
+                    auth,
+                    tags,
+                    source: 'schema',
+                    sourceFile: getRelativePath(projectRoot, filePath),
+                    summary: typeof operation.summary === 'string' ? operation.summary : undefined,
+                    operationId: typeof operation.operationId === 'string' ? operation.operationId : undefined,
+                });
+            }
+        }
+    }
+    const deduped = dedupeEndpoints(endpoints);
+    if (deduped.length === 0) {
+        return null;
+    }
+    return {
+        source: 'schema',
+        endpoints: deduped,
+        sourceFiles: uniqueStrings(sourceFiles).sort(),
+    };
+}
+//# sourceMappingURL=openapi-extractor.js.map

package/dist/panoramic/api-surface/openapi-extractor.js.map

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

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

@@ -0,0 +1,140 @@
+/**
+ * API Surface 类型定义
+ *
+ * 公开类型 + 跨模块共享的内部类型。
+ */
+export type ApiSource = 'schema' | 'introspection' | 'ast';
+export type ApiParameterLocation = 'path' | 'query' | 'body' | 'header' | 'cookie' | 'form' | 'unknown';
+export interface ApiParameter {
+    name: string;
+    in: ApiParameterLocation;
+    type: string;
+    required: boolean;
+    description?: string;
+}
+export interface ApiResponse {
+    statusCode: string;
+    type: string;
+    description?: string;
+}
+export interface ApiEndpoint {
+    method: string;
+    path: string;
+    parameters: ApiParameter[];
+    responses: ApiResponse[];
+    responseType: string;
+    auth: string[];
+    tags: string[];
+    source: ApiSource;
+    sourceFile?: string;
+    summary?: string;
+    operationId?: string;
+}
+export interface ApiSurfaceInput {
+    projectName: string;
+    source: ApiSource;
+    endpoints: ApiEndpoint[];
+    sourceFiles: string[];
+}
+export interface ApiSurfaceOutput {
+    title: string;
+    generatedAt: string;
+    projectName: string;
+    source: ApiSource;
+    endpoints: ApiEndpoint[];
+    totalEndpoints: number;
+    totalParameters: number;
+    sourceFiles: string[];
+    byMethod: Record<string, number>;
+    tags: string[];
+}
+export interface ExtractionResult {
+    source: ApiSource;
+    endpoints: ApiEndpoint[];
+    sourceFiles: string[];
+}
+export interface FileCollectionOptions {
+    extensions?: string[];
+    fileNamePattern?: RegExp;
+}
+export interface RouterImportBinding {
+    targetFile: string;
+    exportName: string;
+}
+export interface ExpressRouteDecl {
+    method: string;
+    path: string;
+    middlewares: string[];
+    sourceFile: string;
+}
+export interface ExpressMountDecl {
+    prefix: string;
+    middlewares: string[];
+    targetLocalName: string;
+}
+export interface ExpressRouterDef {
+    id: string;
+    filePath: string;
+    localName: string;
+    kind: 'app' | 'router';
+    routes: ExpressRouteDecl[];
+    mounts: ExpressMountDecl[];
+}
+export interface ExpressFileAnalysis {
+    filePath: string;
+    routers: Map<string, ExpressRouterDef>;
+    defaultExport?: string;
+    namedExports: Map<string, string>;
+    imports: Map<string, RouterImportBinding>;
+}
+export interface ResolvedExpressMount {
+    prefix: string;
+    middlewares: string[];
+    targetId: string;
+}
+export type ResolvedExpressRouterDef = Omit<ExpressRouterDef, 'mounts'> & {
+    mounts: ResolvedExpressMount[];
+};
+export interface FastApiRouteDecl {
+    method: string;
+    path: string;
+    parameters: ApiParameter[];
+    responseType: string;
+    auth: string[];
+    tags: string[];
+    summary?: string;
+    operationId?: string;
+    sourceFile: string;
+}
+export interface FastApiMountDecl {
+    prefix: string;
+    tags: string[];
+    auth: string[];
+    targetLocalName: string;
+}
+export interface FastApiRouterDef {
+    id: string;
+    filePath: string;
+    localName: string;
+    kind: 'app' | 'router';
+    prefix: string;
+    tags: string[];
+    auth: string[];
+    routes: FastApiRouteDecl[];
+    mounts: FastApiMountDecl[];
+}
+export interface FastApiFileAnalysis {
+    filePath: string;
+    routers: Map<string, FastApiRouterDef>;
+    imports: Map<string, RouterImportBinding>;
+}
+export interface ResolvedFastApiMount {
+    prefix: string;
+    tags: string[];
+    auth: string[];
+    targetId: string;
+}
+export type ResolvedFastApiRouterDef = Omit<FastApiRouterDef, 'mounts'> & {
+    mounts: ResolvedFastApiMount[];
+};
+//# sourceMappingURL=types.d.ts.map