spectra-cli 4.1.1 → 4.2.0

package/dist/models/call-site.js

@@ -0,0 +1,60 @@
+/**
+ * CallSite — 单个函数调用位置的原始记录（CL-01 schema）。
+ *
+ * 由各语言 mapper 在 AST 抽取阶段产出（如 PythonMapper.extractCallSites），
+ * 由 call-resolver 在 buildUnifiedGraph 阶段消费，产出 calls 边。
+ *
+ * 设计层级（DAG 方向）：models → knowledge-graph → panoramic。
+ * 本文件位于 models 层，被 CodeSkeleton 与 UnifiedGraph 双向消费但不反向依赖任一上层。
+ */
+import { z } from 'zod';
+/**
+ * CalleeKind — 函数调用 callee 的分类。
+ *
+ * - `free`：模块顶层 callable（同模块函数 / 全局函数）
+ * - `member`：self.method() / Class.method() 形式
+ * - `cross-module`：通过 import 引入的外部 callee
+ * - `dunder`：__add__ / __radd__ 等运算符重载（binary_operator / unary_operator AST 派生）
+ * - `super`：super().method() 调用链
+ * - `decorator`：带参 decorator（@app.route("/x") 形式；bare decorator 不记录，CL-04）
+ * - `unresolved`：解析失败 / 无法定位 → call-resolver 进入 Stage 4 兜底
+ */
+export const CalleeKindSchema = z.enum([
+    'free',
+    'member',
+    'cross-module',
+    'dunder',
+    'super',
+    'decorator',
+    'unresolved',
+]);
+/**
+ * CallSite — 单个函数调用位置的原始记录。
+ *
+ * confidence **不在此 schema 上**：tier 由 call-resolver 在 4 阶段 resolution 后计算，
+ * CallSite 仅承载位置 + 分类 + caller 上下文等用于 resolver 决策的最小信息。
+ */
+export const CallSiteSchema = z.object({
+    /** callee 名称（如 "foo" / "method" / "__add__"） */
+    calleeName: z.string().min(1),
+    /** callee 分类（CL-01：必填，决定 resolver 进入哪个 Stage） */
+    calleeKind: CalleeKindSchema,
+    /** 调用所在源码行号（1-based，CL-01：必填，便于 cross-module debug） */
+    line: z.number().int().positive(),
+    /** 调用所在列号（CL-01：可选，节省 schema 字节） */
+    column: z.number().int().nonnegative().optional(),
+    /** caller 所在 function/class 上下文（如 "Value.__add__"，用于 member resolution） */
+    callerContext: z.string().optional(),
+    /**
+     * callee 限定符 — Codex P1 C-2 修订。
+     *
+     * 用于 attribute call（如 `Engine.helper()` / `numpy.array()` / `obj.method()`）的 receiver 名。
+     * resolver 会优先用此 qualifier 在 importIndex / classMemberIndex 中定位 callee 真实来源：
+     * - calleeKind=cross-module → calleeQualifier 是 module alias（如 "numpy"）
+     * - calleeKind=member（Class.method 形式）→ calleeQualifier 是类名（如 "Engine"）
+     * - calleeKind=member（self/cls.method）→ calleeQualifier=undefined（用 callerContext）
+     * - calleeKind=free / dunder / decorator / super / unresolved → 通常 undefined
+     */
+    calleeQualifier: z.string().optional(),
+});
+//# sourceMappingURL=call-site.js.map

package/dist/models/call-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-site.js","sourceRoot":"","sources":["../../src/models/call-site.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,MAAM;IACN,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,OAAO;IACP,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,gDAAgD;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,iDAAiD;IACjD,UAAU,EAAE,gBAAgB;IAC5B,uDAAuD;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,oCAAoC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD,2EAA2E;IAC3E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC;;;;;;;;;OASG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

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

@@ -3,6 +3,7 @@
  * 流水线第一阶段输出：AST 提取的文件结构中间表示
  */
 import { z } from 'zod';
+export { CallSiteSchema, type CallSite } from './call-site.js';
 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"]>;
@@ -77,7 +78,7 @@ export declare const ExportSymbolSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+    kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
     signature: string;
     isDefault: boolean;
     startLine: number;
@@ -95,7 +96,7 @@ export declare const ExportSymbolSchema: z.ZodObject<{
     }[] | undefined;
 }, {
     name: string;
-    kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+    kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
     signature: string;
     isDefault: boolean;
     startLine: number;
@@ -113,6 +114,19 @@ export declare const ExportSymbolSchema: z.ZodObject<{
     }[] | undefined;
 }>;
 export type ExportSymbol = z.infer<typeof ExportSymbolSchema>;
+/**
+ * Import 语义类型枚举（Feature 156 W1.0 / FR-28 / AC-11）。
+ *
+ * - 'static'：标准 ES Module 静态 import
+ * - 'dynamic'：动态 import() 调用
+ * - 'type-only'：仅类型导入（`import type { ... }`）
+ * - 'commonjs-require'：CommonJS require() 调用
+ *
+ * 注：ModuleEdge.importType 不含 'commonjs-require'，
+ * module-derivation 派生时会归并到 'static'（CommonJS 视为同步加载）。
+ */
+export declare const ImportSemanticTypeSchema: z.ZodEnum<["static", "dynamic", "type-only", "commonjs-require"]>;
+export type ImportSemanticType = z.infer<typeof ImportSemanticTypeSchema>;
 /** 导入引用 */
 export declare const ImportReferenceSchema: z.ZodObject<{
     moduleSpecifier: z.ZodString;
@@ -121,6 +135,13 @@ export declare const ImportReferenceSchema: z.ZodObject<{
     namedImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     defaultImport: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     isTypeOnly: z.ZodBoolean;
+    /**
+     * 语法类型（Feature 156 W1.0 新增；可选，向后兼容）。
+     * 由 import-resolver.detectImportType 派生；写入 CodeSkeleton.imports[].importType；
+     * deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence；
+     * module-derivation 在重建 ModuleEdge.importType 时读取此字段。
+     */
+    importType: z.ZodOptional<z.ZodEnum<["static", "dynamic", "type-only", "commonjs-require"]>>;
 }, "strip", z.ZodTypeAny, {
     moduleSpecifier: string;
     isRelative: boolean;
@@ -128,6 +149,7 @@ export declare const ImportReferenceSchema: z.ZodObject<{
     resolvedPath?: string | null | undefined;
     namedImports?: string[] | undefined;
     defaultImport?: string | null | undefined;
+    importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
 }, {
     moduleSpecifier: string;
     isRelative: boolean;
@@ -135,6 +157,7 @@ export declare const ImportReferenceSchema: z.ZodObject<{
     resolvedPath?: string | null | undefined;
     namedImports?: string[] | undefined;
     defaultImport?: string | null | undefined;
+    importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
 }>;
 export type ImportReference = z.infer<typeof ImportReferenceSchema>;
 /** 解析错误 */
@@ -196,7 +219,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
         signature: string;
         isDefault: boolean;
         startLine: number;
@@ -214,7 +237,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
-        kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+        kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
         signature: string;
         isDefault: boolean;
         startLine: number;
@@ -238,6 +261,13 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         namedImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         defaultImport: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         isTypeOnly: z.ZodBoolean;
+        /**
+         * 语法类型（Feature 156 W1.0 新增；可选，向后兼容）。
+         * 由 import-resolver.detectImportType 派生；写入 CodeSkeleton.imports[].importType；
+         * deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence；
+         * module-derivation 在重建 ModuleEdge.importType 时读取此字段。
+         */
+        importType: z.ZodOptional<z.ZodEnum<["static", "dynamic", "type-only", "commonjs-require"]>>;
     }, "strip", z.ZodTypeAny, {
         moduleSpecifier: string;
         isRelative: boolean;
@@ -245,6 +275,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         resolvedPath?: string | null | undefined;
         namedImports?: string[] | undefined;
         defaultImport?: string | null | undefined;
+        importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
     }, {
         moduleSpecifier: string;
         isRelative: boolean;
@@ -252,6 +283,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         resolvedPath?: string | null | undefined;
         namedImports?: string[] | undefined;
         defaultImport?: string | null | undefined;
+        importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
     }>, "many">;
     parseErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
         line: z.ZodNumber;
@@ -273,13 +305,35 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
     analyzedAt: z.ZodString;
     parserUsed: z.ZodEnum<["ts-morph", "tree-sitter", "baseline", "reconstructed"]>;
     moduleDoc: z.ZodOptional<z.ZodString>;
+    callSites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        calleeName: z.ZodString;
+        calleeKind: z.ZodEnum<["free", "member", "cross-module", "dunder", "super", "decorator", "unresolved"]>;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+        callerContext: z.ZodOptional<z.ZodString>;
+        calleeQualifier: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        calleeName: string;
+        calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+        line: number;
+        column?: number | undefined;
+        callerContext?: string | undefined;
+        calleeQualifier?: string | undefined;
+    }, {
+        calleeName: string;
+        calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+        line: number;
+        column?: number | undefined;
+        callerContext?: string | undefined;
+        calleeQualifier?: string | undefined;
+    }>, "many">>;
 }, "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";
+        kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
         signature: string;
         isDefault: boolean;
         startLine: number;
@@ -303,6 +357,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         resolvedPath?: string | null | undefined;
         namedImports?: string[] | undefined;
         defaultImport?: string | null | undefined;
+        importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
     }[];
     hash: string;
     analyzedAt: string;
@@ -314,13 +369,21 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         affectedSymbols?: string[] | undefined;
     }[] | undefined;
     moduleDoc?: string | undefined;
+    callSites?: {
+        calleeName: string;
+        calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+        line: number;
+        column?: number | undefined;
+        callerContext?: string | undefined;
+        calleeQualifier?: string | undefined;
+    }[] | 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";
+        kind: "function" | "type" | "class" | "interface" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
         signature: string;
         isDefault: boolean;
         startLine: number;
@@ -344,6 +407,7 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         resolvedPath?: string | null | undefined;
         namedImports?: string[] | undefined;
         defaultImport?: string | null | undefined;
+        importType?: "static" | "dynamic" | "type-only" | "commonjs-require" | undefined;
     }[];
     hash: string;
     analyzedAt: string;
@@ -355,6 +419,14 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
         affectedSymbols?: string[] | undefined;
     }[] | undefined;
     moduleDoc?: string | undefined;
+    callSites?: {
+        calleeName: string;
+        calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+        line: number;
+        column?: number | undefined;
+        callerContext?: string | undefined;
+        calleeQualifier?: string | undefined;
+    }[] | undefined;
 }>;
 export type CodeSkeleton = z.infer<typeof CodeSkeletonSchema>;
 /**

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

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

package/dist/models/code-skeleton.js

@@ -3,6 +3,9 @@
  * 流水线第一阶段输出：AST 提取的文件结构中间表示
  */
 import { z } from 'zod';
+// **Codex P0 W-2 修订** — 从同层 models/call-site.ts import，保持 DAG 方向（models 不反向依赖 knowledge-graph）
+import { CallSiteSchema } from './call-site.js';
+export { CallSiteSchema } from './call-site.js';
 // --- 枚举 ---
 export const ExportKindSchema = z.enum([
     'function',
@@ -73,6 +76,23 @@ export const ExportSymbolSchema = z.object({
     endLine: z.number().int().positive(),
     members: z.array(MemberInfoSchema).optional(),
 });
+/**
+ * Import 语义类型枚举（Feature 156 W1.0 / FR-28 / AC-11）。
+ *
+ * - 'static'：标准 ES Module 静态 import
+ * - 'dynamic'：动态 import() 调用
+ * - 'type-only'：仅类型导入（`import type { ... }`）
+ * - 'commonjs-require'：CommonJS require() 调用
+ *
+ * 注：ModuleEdge.importType 不含 'commonjs-require'，
+ * module-derivation 派生时会归并到 'static'（CommonJS 视为同步加载）。
+ */
+export const ImportSemanticTypeSchema = z.enum([
+    'static',
+    'dynamic',
+    'type-only',
+    'commonjs-require',
+]);
 /** 导入引用 */
 export const ImportReferenceSchema = z.object({
     moduleSpecifier: z.string().min(1),
@@ -81,6 +101,13 @@ export const ImportReferenceSchema = z.object({
     namedImports: z.array(z.string()).optional(),
     defaultImport: z.string().nullable().optional(),
     isTypeOnly: z.boolean(),
+    /**
+     * 语法类型（Feature 156 W1.0 新增；可选，向后兼容）。
+     * 由 import-resolver.detectImportType 派生；写入 CodeSkeleton.imports[].importType；
+     * deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence；
+     * module-derivation 在重建 ModuleEdge.importType 时读取此字段。
+     */
+    importType: ImportSemanticTypeSchema.optional(),
 });
 /** 解析错误 */
 export const ParseErrorSchema = z.object({
@@ -102,6 +129,8 @@ export const CodeSkeletonSchema = z.object({
     analyzedAt: z.string().datetime(),
     parserUsed: ParserUsedSchema,
     moduleDoc: z.string().optional(),
+    // FR-4 + CL-01：Feature 151 新增 — 函数调用点列表（optional，向后兼容旧 baseline）
+    callSites: z.array(CallSiteSchema).optional(),
 });
 // --- 代码切片（FR-001, FR-004, FR-010）---
 /**

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

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

package/dist/models/drift-item.d.ts

@@ -84,17 +84,17 @@ export declare const DriftSummarySchema: z.ZodObject<{
     removals: z.ZodNumber;
     modifications: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    low: number;
-    medium: number;
     high: number;
+    medium: number;
+    low: number;
     totalChanges: number;
     additions: number;
     removals: number;
     modifications: number;
 }, {
-    low: number;
-    medium: number;
     high: number;
+    medium: number;
+    low: number;
     totalChanges: number;
     additions: number;
     removals: number;