@mycodemap/mycodemap 0.1.0 → 0.2.0

package/dist/domain/entities/Symbol.js

@@ -0,0 +1,130 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain entity: Symbol - represents a code symbol (function, class, interface, etc.)
+// ============================================
+// 领域实体：符号 - 表示代码符号（函数、类、接口等）
+// ============================================
+/**
+ * 符号领域实体
+ *
+ * 职责：
+ * - 维护符号身份信息
+ * - 记录符号类型和位置
+ * - 关联到所属模块
+ */
+export class Symbol {
+    id;
+    moduleId;
+    name;
+    kind;
+    location;
+    visibility;
+    constructor(id, moduleId, name, kind, location, visibility = 'public') {
+        this.id = id;
+        this.moduleId = moduleId;
+        this.name = name;
+        this.kind = kind;
+        this.location = location;
+        this.visibility = visibility;
+        this.validate();
+    }
+    /**
+     * 从接口数据创建符号实体
+     */
+    static fromInterface(data) {
+        return new Symbol(data.id, data.moduleId, data.name, data.kind, data.location, data.visibility);
+    }
+    /**
+     * 转换为接口数据
+     */
+    toInterface() {
+        return {
+            id: this.id,
+            moduleId: this.moduleId,
+            name: this.name,
+            kind: this.kind,
+            location: this.location,
+            visibility: this.visibility,
+        };
+    }
+    /**
+     * 重命名符号
+     */
+    rename(newName) {
+        if (!newName || newName.trim().length === 0) {
+            throw new Error('Symbol name cannot be empty');
+        }
+        this.name = newName.trim();
+    }
+    /**
+     * 更新位置信息
+     */
+    updateLocation(location) {
+        this.location = location;
+    }
+    /**
+     * 更改可见性
+     */
+    setVisibility(visibility) {
+        this.visibility = visibility;
+    }
+    /**
+     * 验证领域规则
+     */
+    validate() {
+        if (!this.id || this.id.trim().length === 0) {
+            throw new Error('Symbol ID cannot be empty');
+        }
+        if (!this.moduleId || this.moduleId.trim().length === 0) {
+            throw new Error('Module ID cannot be empty');
+        }
+        if (!this.name || this.name.trim().length === 0) {
+            throw new Error('Symbol name cannot be empty');
+        }
+        if (!this.location || !this.location.file) {
+            throw new Error('Symbol location cannot be empty');
+        }
+    }
+    /**
+     * 检查两个符号是否相同（基于 ID）
+     */
+    equals(other) {
+        return this.id === other.id;
+    }
+    /**
+     * 是否是导出符号（公开可见）
+     */
+    isExported() {
+        return this.visibility === 'public' || this.visibility === 'internal';
+    }
+    /**
+     * 是否是私有符号
+     */
+    isPrivate() {
+        return this.visibility === 'private';
+    }
+    /**
+     * 是否是类型定义（类、接口、类型别名等）
+     */
+    isTypeDefinition() {
+        return ['class', 'interface', 'type', 'enum'].includes(this.kind);
+    }
+    /**
+     * 是否是函数或方法
+     */
+    isFunction() {
+        return this.kind === 'function' || this.kind === 'method';
+    }
+    /**
+     * 获取符号的完全限定名
+     */
+    getQualifiedName() {
+        return `${this.location.file}::${this.name}`;
+    }
+    /**
+     * 创建符号快照（克隆）
+     */
+    snapshot() {
+        return new Symbol(this.id, this.moduleId, this.name, this.kind, { ...this.location }, this.visibility);
+    }
+}
+//# sourceMappingURL=Symbol.js.map

package/dist/domain/entities/Symbol.js.map

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

package/dist/domain/events/DomainEvent.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 领域事件基类
+ *
+ * 职责：
+ * - 记录事件发生时间
+ * - 提供事件身份标识
+ * - 支持事件追溯和审计
+ */
+export declare abstract class DomainEvent {
+    readonly id: string;
+    readonly occurredAt: Date;
+    readonly type: string;
+    constructor(type: string);
+    /**
+     * 获取事件描述
+     */
+    abstract getDescription(): string;
+    /**
+     * 转换为 JSON
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 模块添加事件
+ */
+export declare class ModuleAddedEvent extends DomainEvent {
+    readonly moduleId: string;
+    readonly path: string;
+    constructor(moduleId: string, path: string);
+    getDescription(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 模块移除事件
+ */
+export declare class ModuleRemovedEvent extends DomainEvent {
+    readonly moduleId: string;
+    readonly path: string;
+    constructor(moduleId: string, path: string);
+    getDescription(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 符号添加事件
+ */
+export declare class SymbolAddedEvent extends DomainEvent {
+    readonly symbolId: string;
+    readonly name: string;
+    readonly moduleId: string;
+    constructor(symbolId: string, name: string, moduleId: string);
+    getDescription(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 依赖添加事件
+ */
+export declare class DependencyAddedEvent extends DomainEvent {
+    readonly dependencyId: string;
+    readonly sourceId: string;
+    readonly targetId: string;
+    readonly dependencyType: string;
+    constructor(dependencyId: string, sourceId: string, targetId: string, dependencyType: string);
+    getDescription(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 循环依赖检测事件
+ */
+export declare class CycleDetectedEvent extends DomainEvent {
+    readonly cycleModules: string[];
+    readonly cycleLength: number;
+    constructor(cycleModules: string[], cycleLength: number);
+    getDescription(): string;
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=DomainEvent.d.ts.map

package/dist/domain/events/DomainEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainEvent.d.ts","sourceRoot":"","sources":["../../../src/domain/events/DomainEvent.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,8BAAsB,WAAW;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;IAMxB;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAEjC;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAE7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM;IAKvB,cAAc,IAAI,MAAM;IAIf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IAE/C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM;IAKvB,cAAc,IAAI,MAAM;IAIf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAE7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAFhB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM;IAK3B,cAAc,IAAI,MAAM;IAIf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ3C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IAEjD,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM;gBAHtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM;IAKjC,cAAc,IAAI,MAAM;IAIf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS3C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IAE/C,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM;gBADnB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,EAAE,MAAM;IAK9B,cAAc,IAAI,MAAM;IAIf,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C"}

package/dist/domain/events/DomainEvent.js

@@ -0,0 +1,153 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain event base class - represents something that happened in the domain
+// ============================================
+// 领域事件基类 - 表示领域中发生的事情
+// ============================================
+/**
+ * 领域事件基类
+ *
+ * 职责：
+ * - 记录事件发生时间
+ * - 提供事件身份标识
+ * - 支持事件追溯和审计
+ */
+export class DomainEvent {
+    id;
+    occurredAt;
+    type;
+    constructor(type) {
+        this.id = `${type}_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+        this.occurredAt = new Date();
+        this.type = type;
+    }
+    /**
+     * 转换为 JSON
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            type: this.type,
+            occurredAt: this.occurredAt.toISOString(),
+        };
+    }
+}
+/**
+ * 模块添加事件
+ */
+export class ModuleAddedEvent extends DomainEvent {
+    moduleId;
+    path;
+    constructor(moduleId, path) {
+        super('MODULE_ADDED');
+        this.moduleId = moduleId;
+        this.path = path;
+    }
+    getDescription() {
+        return `Module added: ${this.path} (${this.moduleId})`;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            moduleId: this.moduleId,
+            path: this.path,
+        };
+    }
+}
+/**
+ * 模块移除事件
+ */
+export class ModuleRemovedEvent extends DomainEvent {
+    moduleId;
+    path;
+    constructor(moduleId, path) {
+        super('MODULE_REMOVED');
+        this.moduleId = moduleId;
+        this.path = path;
+    }
+    getDescription() {
+        return `Module removed: ${this.path} (${this.moduleId})`;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            moduleId: this.moduleId,
+            path: this.path,
+        };
+    }
+}
+/**
+ * 符号添加事件
+ */
+export class SymbolAddedEvent extends DomainEvent {
+    symbolId;
+    name;
+    moduleId;
+    constructor(symbolId, name, moduleId) {
+        super('SYMBOL_ADDED');
+        this.symbolId = symbolId;
+        this.name = name;
+        this.moduleId = moduleId;
+    }
+    getDescription() {
+        return `Symbol added: ${this.name} (${this.symbolId}) in module ${this.moduleId}`;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            symbolId: this.symbolId,
+            name: this.name,
+            moduleId: this.moduleId,
+        };
+    }
+}
+/**
+ * 依赖添加事件
+ */
+export class DependencyAddedEvent extends DomainEvent {
+    dependencyId;
+    sourceId;
+    targetId;
+    dependencyType;
+    constructor(dependencyId, sourceId, targetId, dependencyType) {
+        super('DEPENDENCY_ADDED');
+        this.dependencyId = dependencyId;
+        this.sourceId = sourceId;
+        this.targetId = targetId;
+        this.dependencyType = dependencyType;
+    }
+    getDescription() {
+        return `Dependency added: ${this.sourceId} -> ${this.targetId} (${this.dependencyType})`;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            dependencyId: this.dependencyId,
+            sourceId: this.sourceId,
+            targetId: this.targetId,
+            dependencyType: this.dependencyType,
+        };
+    }
+}
+/**
+ * 循环依赖检测事件
+ */
+export class CycleDetectedEvent extends DomainEvent {
+    cycleModules;
+    cycleLength;
+    constructor(cycleModules, cycleLength) {
+        super('CYCLE_DETECTED');
+        this.cycleModules = cycleModules;
+        this.cycleLength = cycleLength;
+    }
+    getDescription() {
+        return `Cycle detected: ${this.cycleModules.join(' -> ')} (${this.cycleLength} modules)`;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            cycleModules: this.cycleModules,
+            cycleLength: this.cycleLength,
+        };
+    }
+}
+//# sourceMappingURL=DomainEvent.js.map

package/dist/domain/events/DomainEvent.js.map

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

package/dist/domain/index.d.ts

@@ -0,0 +1,10 @@
+export { Project } from './entities/Project.js';
+export { Module } from './entities/Module.js';
+export { Symbol as SymbolEntity } from './entities/Symbol.js';
+export { Dependency } from './entities/Dependency.js';
+export { CodeGraph } from './entities/CodeGraph.js';
+export { CodeGraphBuilder } from './services/CodeGraphBuilder.js';
+export { DomainEvent, ModuleAddedEvent, ModuleRemovedEvent, SymbolAddedEvent, DependencyAddedEvent, CycleDetectedEvent, } from './events/DomainEvent.js';
+export { CodeGraphRepository, RepositoryError, EntityNotFoundError, ConcurrencyConflictError, } from './repositories/CodeGraphRepository.js';
+export type { ModuleAnalysisResult } from './services/CodeGraphBuilder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAG/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,18 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain layer exports - central entry point for domain logic
+// ============================================
+// Domain 层导出 - 领域逻辑的中央入口点
+// ============================================
+// 领域实体
+export { Project } from './entities/Project.js';
+export { Module } from './entities/Module.js';
+export { Symbol as SymbolEntity } from './entities/Symbol.js';
+export { Dependency } from './entities/Dependency.js';
+export { CodeGraph } from './entities/CodeGraph.js';
+// 领域服务
+export { CodeGraphBuilder } from './services/CodeGraphBuilder.js';
+// 领域事件
+export { DomainEvent, ModuleAddedEvent, ModuleRemovedEvent, SymbolAddedEvent, DependencyAddedEvent, CycleDetectedEvent, } from './events/DomainEvent.js';
+// 仓库接口
+export { RepositoryError, EntityNotFoundError, ConcurrencyConflictError, } from './repositories/CodeGraphRepository.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oEAAoE;AACpE,+CAA+C;AAC/C,0BAA0B;AAC1B,+CAA+C;AAE/C,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO;AACP,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO;AACP,OAAO,EAEL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uCAAuC,CAAC"}

package/dist/domain/repositories/CodeGraphRepository.d.ts

@@ -0,0 +1,58 @@
+import type { CodeGraph } from '../entities/CodeGraph.js';
+/**
+ * 代码图仓库接口
+ *
+ * 职责：
+ * - 抽象代码图的持久化机制
+ * - 定义领域对象的存储和检索契约
+ * - 支持领域驱动设计的仓库模式
+ *
+ * 注意：实际实现由 Infrastructure 层提供
+ */
+export interface CodeGraphRepository {
+    /**
+     * 保存代码图
+     */
+    save(graph: CodeGraph): Promise<void>;
+    /**
+     * 根据项目 ID 加载代码图
+     */
+    findByProjectId(projectId: string): Promise<CodeGraph | null>;
+    /**
+     * 根据项目路径加载代码图
+     */
+    findByProjectPath(projectPath: string): Promise<CodeGraph | null>;
+    /**
+     * 检查项目是否存在
+     */
+    exists(projectId: string): Promise<boolean>;
+    /**
+     * 删除项目代码图
+     */
+    delete(projectId: string): Promise<void>;
+    /**
+     * 获取所有保存的项目 ID
+     */
+    getAllProjectIds(): Promise<string[]>;
+}
+/**
+ * 仓库错误
+ */
+export declare class RepositoryError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: string, cause?: unknown | undefined);
+}
+/**
+ * 实体未找到错误
+ */
+export declare class EntityNotFoundError extends RepositoryError {
+    constructor(entityType: string, entityId: string);
+}
+/**
+ * 并发冲突错误
+ */
+export declare class ConcurrencyConflictError extends RepositoryError {
+    constructor(entityType: string, entityId: string);
+}
+//# sourceMappingURL=CodeGraphRepository.d.ts.map

package/dist/domain/repositories/CodeGraphRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeGraphRepository.d.ts","sourceRoot":"","sources":["../../../src/domain/repositories/CodeGraphRepository.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE9D;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,IAAI,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAOjD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAOjD"}

package/dist/domain/repositories/CodeGraphRepository.js

@@ -0,0 +1,37 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Repository interface - abstracts persistence for CodeGraph aggregate
+// ============================================
+// 仓库接口：代码图聚合的持久化抽象
+// ============================================
+/**
+ * 仓库错误
+ */
+export class RepositoryError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'RepositoryError';
+    }
+}
+/**
+ * 实体未找到错误
+ */
+export class EntityNotFoundError extends RepositoryError {
+    constructor(entityType, entityId) {
+        super(`${entityType} with ID ${entityId} not found`, 'ENTITY_NOT_FOUND');
+        this.name = 'EntityNotFoundError';
+    }
+}
+/**
+ * 并发冲突错误
+ */
+export class ConcurrencyConflictError extends RepositoryError {
+    constructor(entityType, entityId) {
+        super(`${entityType} with ID ${entityId} has been modified by another process`, 'CONCURRENCY_CONFLICT');
+        this.name = 'ConcurrencyConflictError';
+    }
+}
+//# sourceMappingURL=CodeGraphRepository.js.map

package/dist/domain/repositories/CodeGraphRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeGraphRepository.js","sourceRoot":"","sources":["../../../src/domain/repositories/CodeGraphRepository.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6EAA6E;AAC7E,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AA8C/C;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,UAAkB,EAAE,QAAgB;QAC9C,KAAK,CACH,GAAG,UAAU,YAAY,QAAQ,YAAY,EAC7C,kBAAkB,CACnB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAC3D,YAAY,UAAkB,EAAE,QAAgB;QAC9C,KAAK,CACH,GAAG,UAAU,YAAY,QAAQ,uCAAuC,EACxE,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/domain/services/CodeGraphBuilder.d.ts

@@ -0,0 +1,50 @@
+import type { AnalysisOptions, ModuleInfo } from '../../interface/types/index.js';
+import { CodeGraph } from '../entities/CodeGraph.js';
+/**
+ * 模块分析结果
+ */
+export interface ModuleAnalysisResult {
+    info: ModuleInfo;
+    dependencies: Array<{
+        targetPath: string;
+        type: 'import' | 'inherit' | 'implement' | 'call' | 'type-ref';
+    }>;
+}
+/**
+ * 代码图构建服务
+ *
+ * 职责：
+ * - 从分析结果构建领域模型
+ * - 生成唯一标识符
+ * - 建立实体间关系
+ * - 确保数据一致性
+ */
+export declare class CodeGraphBuilder {
+    private moduleIdMap;
+    private options;
+    constructor(options: AnalysisOptions);
+    /**
+     * 构建代码图
+     * @param projectName - 项目名称
+     * @param projectRoot - 项目根路径
+     * @param moduleResults - 模块分析结果列表
+     */
+    build(projectName: string, projectRoot: string, moduleResults: ModuleAnalysisResult[]): CodeGraph;
+    /**
+     * 从 CodeMap JSON 重建代码图
+     */
+    rebuildFromJSON(data: ReturnType<CodeGraph['toInterface']>): CodeGraph;
+    /**
+     * 生成唯一 ID
+     */
+    private generateId;
+    /**
+     * 根据文件路径检测语言
+     */
+    private detectLanguage;
+    /**
+     * 创建构建器的工厂方法
+     */
+    static create(options: AnalysisOptions): CodeGraphBuilder;
+}
+//# sourceMappingURL=CodeGraphBuilder.d.ts.map

package/dist/domain/services/CodeGraphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeGraphBuilder.d.ts","sourceRoot":"","sources":["../../../src/domain/services/CodeGraphBuilder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAEX,MAAM,gCAAgC,CAAC;AAKxC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,KAAK,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;KAChE,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAIpC;;;;;OAKG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,oBAAoB,EAAE,GACpC,SAAS;IA8EZ;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,GAAG,SAAS;IAItE;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB;CAG1D"}