spectra-cli 4.1.1

package/dist/models/code-skeleton.d.ts

@@ -0,0 +1,394 @@
+/**
+ * CodeSkeleton 及相关嵌套实体的 Zod Schema 定义
+ * 流水线第一阶段输出：AST 提取的文件结构中间表示
+ */
+import { z } from 'zod';
+export declare const ExportKindSchema: z.ZodEnum<["function", "class", "interface", "type", "enum", "const", "variable", "struct", "trait", "protocol", "data_class", "module"]>;
+export type ExportKind = z.infer<typeof ExportKindSchema>;
+export declare const MemberKindSchema: z.ZodEnum<["method", "property", "getter", "setter", "constructor", "classmethod", "staticmethod", "associated_function"]>;
+export type MemberKind = z.infer<typeof MemberKindSchema>;
+export declare const VisibilitySchema: z.ZodEnum<["public", "protected", "private"]>;
+export type Visibility = z.infer<typeof VisibilitySchema>;
+export declare const ParserUsedSchema: z.ZodEnum<["ts-morph", "tree-sitter", "baseline", "reconstructed"]>;
+export type ParserUsed = z.infer<typeof ParserUsedSchema>;
+export declare const LanguageSchema: z.ZodEnum<["typescript", "javascript", "python", "go", "java", "rust", "kotlin", "cpp", "ruby", "swift"]>;
+export type Language = z.infer<typeof LanguageSchema>;
+/** class/interface 成员信息 */
+export declare const MemberInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<["method", "property", "getter", "setter", "constructor", "classmethod", "staticmethod", "associated_function"]>;
+    signature: z.ZodString;
+    jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodOptional<z.ZodEnum<["public", "protected", "private"]>>;
+    isStatic: z.ZodBoolean;
+    isAbstract: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+    signature: string;
+    isStatic: boolean;
+    jsDoc?: string | null | undefined;
+    visibility?: "public" | "protected" | "private" | undefined;
+    isAbstract?: boolean | undefined;
+}, {
+    name: string;
+    kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+    signature: string;
+    isStatic: boolean;
+    jsDoc?: string | null | undefined;
+    visibility?: "public" | "protected" | "private" | undefined;
+    isAbstract?: boolean | undefined;
+}>;
+export type MemberInfo = z.infer<typeof MemberInfoSchema>;
+/** 导出符号 */
+export declare const ExportSymbolSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<["function", "class", "interface", "type", "enum", "const", "variable", "struct", "trait", "protocol", "data_class", "module"]>;
+    signature: z.ZodString;
+    jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    typeParameters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    isDefault: z.ZodBoolean;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    members: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["method", "property", "getter", "setter", "constructor", "classmethod", "staticmethod", "associated_function"]>;
+        signature: z.ZodString;
+        jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        visibility: z.ZodOptional<z.ZodEnum<["public", "protected", "private"]>>;
+        isStatic: z.ZodBoolean;
+        isAbstract: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+        signature: string;
+        isStatic: boolean;
+        jsDoc?: string | null | undefined;
+        visibility?: "public" | "protected" | "private" | undefined;
+        isAbstract?: boolean | undefined;
+    }, {
+        name: string;
+        kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+        signature: string;
+        isStatic: boolean;
+        jsDoc?: string | null | undefined;
+        visibility?: "public" | "protected" | "private" | undefined;
+        isAbstract?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+    signature: string;
+    isDefault: boolean;
+    startLine: number;
+    endLine: number;
+    jsDoc?: string | null | undefined;
+    typeParameters?: string[] | undefined;
+    members?: {
+        name: string;
+        kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+        signature: string;
+        isStatic: boolean;
+        jsDoc?: string | null | undefined;
+        visibility?: "public" | "protected" | "private" | undefined;
+        isAbstract?: boolean | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+    signature: string;
+    isDefault: boolean;
+    startLine: number;
+    endLine: number;
+    jsDoc?: string | null | undefined;
+    typeParameters?: string[] | undefined;
+    members?: {
+        name: string;
+        kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+        signature: string;
+        isStatic: boolean;
+        jsDoc?: string | null | undefined;
+        visibility?: "public" | "protected" | "private" | undefined;
+        isAbstract?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type ExportSymbol = z.infer<typeof ExportSymbolSchema>;
+/** 导入引用 */
+export declare const ImportReferenceSchema: z.ZodObject<{
+    moduleSpecifier: z.ZodString;
+    isRelative: z.ZodBoolean;
+    resolvedPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    namedImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    defaultImport: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isTypeOnly: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    moduleSpecifier: string;
+    isRelative: boolean;
+    isTypeOnly: boolean;
+    resolvedPath?: string | null | undefined;
+    namedImports?: string[] | undefined;
+    defaultImport?: string | null | undefined;
+}, {
+    moduleSpecifier: string;
+    isRelative: boolean;
+    isTypeOnly: boolean;
+    resolvedPath?: string | null | undefined;
+    namedImports?: string[] | undefined;
+    defaultImport?: string | null | undefined;
+}>;
+export type ImportReference = z.infer<typeof ImportReferenceSchema>;
+/** 解析错误 */
+export declare const ParseErrorSchema: z.ZodObject<{
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    message: z.ZodString;
+    affectedSymbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    line: number;
+    column: number;
+    affectedSymbols?: string[] | undefined;
+}, {
+    message: string;
+    line: number;
+    column: number;
+    affectedSymbols?: string[] | undefined;
+}>;
+export type ParseError = z.infer<typeof ParseErrorSchema>;
+/** AST 提取的文件结构中间表示 */
+export declare const CodeSkeletonSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    language: z.ZodEnum<["typescript", "javascript", "python", "go", "java", "rust", "kotlin", "cpp", "ruby", "swift"]>;
+    loc: z.ZodNumber;
+    exports: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<["function", "class", "interface", "type", "enum", "const", "variable", "struct", "trait", "protocol", "data_class", "module"]>;
+        signature: z.ZodString;
+        jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typeParameters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        isDefault: z.ZodBoolean;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+        members: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            kind: z.ZodEnum<["method", "property", "getter", "setter", "constructor", "classmethod", "staticmethod", "associated_function"]>;
+            signature: z.ZodString;
+            jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            visibility: z.ZodOptional<z.ZodEnum<["public", "protected", "private"]>>;
+            isStatic: z.ZodBoolean;
+            isAbstract: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }, {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        signature: string;
+        isDefault: boolean;
+        startLine: number;
+        endLine: number;
+        jsDoc?: string | null | undefined;
+        typeParameters?: string[] | undefined;
+        members?: {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }[] | undefined;
+    }, {
+        name: string;
+        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        signature: string;
+        isDefault: boolean;
+        startLine: number;
+        endLine: number;
+        jsDoc?: string | null | undefined;
+        typeParameters?: string[] | undefined;
+        members?: {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }[] | undefined;
+    }>, "many">;
+    imports: z.ZodArray<z.ZodObject<{
+        moduleSpecifier: z.ZodString;
+        isRelative: z.ZodBoolean;
+        resolvedPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        namedImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        defaultImport: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        isTypeOnly: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        moduleSpecifier: string;
+        isRelative: boolean;
+        isTypeOnly: boolean;
+        resolvedPath?: string | null | undefined;
+        namedImports?: string[] | undefined;
+        defaultImport?: string | null | undefined;
+    }, {
+        moduleSpecifier: string;
+        isRelative: boolean;
+        isTypeOnly: boolean;
+        resolvedPath?: string | null | undefined;
+        namedImports?: string[] | undefined;
+        defaultImport?: string | null | undefined;
+    }>, "many">;
+    parseErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        message: z.ZodString;
+        affectedSymbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        line: number;
+        column: number;
+        affectedSymbols?: string[] | undefined;
+    }, {
+        message: string;
+        line: number;
+        column: number;
+        affectedSymbols?: string[] | undefined;
+    }>, "many">>;
+    hash: z.ZodString;
+    analyzedAt: z.ZodString;
+    parserUsed: z.ZodEnum<["ts-morph", "tree-sitter", "baseline", "reconstructed"]>;
+    moduleDoc: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+    loc: number;
+    exports: {
+        name: string;
+        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        signature: string;
+        isDefault: boolean;
+        startLine: number;
+        endLine: number;
+        jsDoc?: string | null | undefined;
+        typeParameters?: string[] | undefined;
+        members?: {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }[] | undefined;
+    }[];
+    imports: {
+        moduleSpecifier: string;
+        isRelative: boolean;
+        isTypeOnly: boolean;
+        resolvedPath?: string | null | undefined;
+        namedImports?: string[] | undefined;
+        defaultImport?: string | null | undefined;
+    }[];
+    hash: string;
+    analyzedAt: string;
+    parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+    parseErrors?: {
+        message: string;
+        line: number;
+        column: number;
+        affectedSymbols?: string[] | undefined;
+    }[] | undefined;
+    moduleDoc?: string | undefined;
+}, {
+    filePath: string;
+    language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+    loc: number;
+    exports: {
+        name: string;
+        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        signature: string;
+        isDefault: boolean;
+        startLine: number;
+        endLine: number;
+        jsDoc?: string | null | undefined;
+        typeParameters?: string[] | undefined;
+        members?: {
+            name: string;
+            kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+            signature: string;
+            isStatic: boolean;
+            jsDoc?: string | null | undefined;
+            visibility?: "public" | "protected" | "private" | undefined;
+            isAbstract?: boolean | undefined;
+        }[] | undefined;
+    }[];
+    imports: {
+        moduleSpecifier: string;
+        isRelative: boolean;
+        isTypeOnly: boolean;
+        resolvedPath?: string | null | undefined;
+        namedImports?: string[] | undefined;
+        defaultImport?: string | null | undefined;
+    }[];
+    hash: string;
+    analyzedAt: string;
+    parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+    parseErrors?: {
+        message: string;
+        line: number;
+        column: number;
+        affectedSymbols?: string[] | undefined;
+    }[] | undefined;
+    moduleDoc?: string | undefined;
+}>;
+export type CodeSkeleton = z.infer<typeof CodeSkeletonSchema>;
+/**
+ * 代码切片的优先级枚举
+ * P1：公开导出函数（最高优先级）
+ * P2：被多处 import 的内部函数
+ * P3：含复杂控制流的函数
+ */
+export declare enum CodeSlicePriority {
+    P1_PUBLIC_EXPORT = 1,
+    P2_MULTI_IMPORT = 2,
+    P3_COMPLEX_CONTROL_FLOW = 3
+}
+/**
+ * 函数体的控制流骨架切片
+ * 包含条件分支结构、核心调用链和关键常量引用
+ * 去除了注释、空行和具体实现细节
+ */
+export interface CodeSlice {
+    /** 来源文件路径 */
+    filePath: string;
+    /** 函数或方法名称 */
+    symbolName: string;
+    /** 函数签名 */
+    signature: string;
+    /** 控制流骨架行（保留 if/for/try/return/调用，移除注释和空行） */
+    controlFlowLines: string[];
+    /** 优先级（数值越小优先级越高） */
+    priority: CodeSlicePriority;
+    /** 估算的 token 数 */
+    estimatedTokens: number;
+    /** 原始起始行号（1-based） */
+    startLine: number;
+    /** 原始结束行号（1-based） */
+    endLine: number;
+}
+//# sourceMappingURL=code-skeleton.d.ts.map

package/dist/models/code-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-skeleton.d.ts","sourceRoot":"","sources":["../../src/models/code-skeleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB,2IAc3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,4HAU3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,+CAA6C,CAAC;AAC3E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,qEAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc,2GAYzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,2BAA2B;AAC3B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,WAAW;AACX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,WAAW;AACX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,WAAW;AACX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,sBAAsB;AACtB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,gBAAgB,IAAI;IACpB,eAAe,IAAI;IACnB,uBAAuB,IAAI;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/models/code-skeleton.js

@@ -0,0 +1,119 @@
+/**
+ * CodeSkeleton 及相关嵌套实体的 Zod Schema 定义
+ * 流水线第一阶段输出：AST 提取的文件结构中间表示
+ */
+import { z } from 'zod';
+// --- 枚举 ---
+export const ExportKindSchema = z.enum([
+    'function',
+    'class',
+    'interface',
+    'type',
+    'enum',
+    'const',
+    'variable',
+    // 多语言扩展（前向兼容）
+    'struct',
+    'trait',
+    'protocol',
+    'data_class',
+    'module',
+]);
+export const MemberKindSchema = z.enum([
+    'method',
+    'property',
+    'getter',
+    'setter',
+    'constructor',
+    // 多语言扩展（前向兼容）
+    'classmethod',
+    'staticmethod',
+    'associated_function',
+]);
+export const VisibilitySchema = z.enum(['public', 'protected', 'private']);
+export const ParserUsedSchema = z.enum([
+    'ts-morph',
+    'tree-sitter',
+    'baseline',
+    'reconstructed',
+]);
+export const LanguageSchema = z.enum([
+    'typescript',
+    'javascript',
+    // 多语言扩展（前向兼容）
+    'python',
+    'go',
+    'java',
+    'rust',
+    'kotlin',
+    'cpp',
+    'ruby',
+    'swift',
+]);
+// --- 嵌套实体 ---
+/** class/interface 成员信息 */
+export const MemberInfoSchema = z.object({
+    name: z.string().min(1),
+    kind: MemberKindSchema,
+    signature: z.string().min(1),
+    jsDoc: z.string().nullable().optional(),
+    visibility: VisibilitySchema.optional(),
+    isStatic: z.boolean(),
+    isAbstract: z.boolean().optional(),
+});
+/** 导出符号 */
+export const ExportSymbolSchema = z.object({
+    name: z.string().min(1),
+    kind: ExportKindSchema,
+    signature: z.string().min(1),
+    jsDoc: z.string().nullable().optional(),
+    typeParameters: z.array(z.string()).optional(),
+    isDefault: z.boolean(),
+    startLine: z.number().int().positive(),
+    endLine: z.number().int().positive(),
+    members: z.array(MemberInfoSchema).optional(),
+});
+/** 导入引用 */
+export const ImportReferenceSchema = z.object({
+    moduleSpecifier: z.string().min(1),
+    isRelative: z.boolean(),
+    resolvedPath: z.string().nullable().optional(),
+    namedImports: z.array(z.string()).optional(),
+    defaultImport: z.string().nullable().optional(),
+    isTypeOnly: z.boolean(),
+});
+/** 解析错误 */
+export const ParseErrorSchema = z.object({
+    line: z.number().int().positive(),
+    column: z.number().int().nonnegative(),
+    message: z.string().min(1),
+    affectedSymbols: z.array(z.string()).optional(),
+});
+// --- 主实体 ---
+/** AST 提取的文件结构中间表示 */
+export const CodeSkeletonSchema = z.object({
+    filePath: z.string().regex(/\.(ts|tsx|js|jsx|py|pyi|go|java|kt|kts|rs|cpp|cc|cxx|c|h|hpp|rb|swift)$/),
+    language: LanguageSchema,
+    loc: z.number().int().positive(),
+    exports: z.array(ExportSymbolSchema),
+    imports: z.array(ImportReferenceSchema),
+    parseErrors: z.array(ParseErrorSchema).optional(),
+    hash: z.string().regex(/^[0-9a-f]{64}$/),
+    analyzedAt: z.string().datetime(),
+    parserUsed: ParserUsedSchema,
+    moduleDoc: z.string().optional(),
+});
+// --- 代码切片（FR-001, FR-004, FR-010）---
+/**
+ * 代码切片的优先级枚举
+ * P1：公开导出函数（最高优先级）
+ * P2：被多处 import 的内部函数
+ * P3：含复杂控制流的函数
+ */
+export var CodeSlicePriority;
+(function (CodeSlicePriority) {
+    CodeSlicePriority[CodeSlicePriority["P1_PUBLIC_EXPORT"] = 1] = "P1_PUBLIC_EXPORT";
+    CodeSlicePriority[CodeSlicePriority["P2_MULTI_IMPORT"] = 2] = "P2_MULTI_IMPORT";
+    CodeSlicePriority[CodeSlicePriority["P3_COMPLEX_CONTROL_FLOW"] = 3] = "P3_COMPLEX_CONTROL_FLOW";
+})(CodeSlicePriority || (CodeSlicePriority = {}));
+//# sourceMappingURL=code-skeleton.js.map

package/dist/models/code-skeleton.js.map

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