@mycodemap/mycodemap 0.1.1 → 0.2.0

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"}

package/dist/domain/services/CodeGraphBuilder.js

@@ -0,0 +1,121 @@
+// [META] since:2026-03 | owner:architecture-team | stable:true
+// [WHY] Domain service: CodeGraphBuilder - builds CodeGraph from analysis results
+// ============================================
+// 领域服务：代码图构建器 - 从分析结果构建代码图
+// ============================================
+import { randomUUID } from 'crypto';
+import { Project } from '../entities/Project.js';
+import { Module } from '../entities/Module.js';
+import { Symbol as SymbolEntity } from '../entities/Symbol.js';
+import { Dependency } from '../entities/Dependency.js';
+import { CodeGraph } from '../entities/CodeGraph.js';
+/**
+ * 代码图构建服务
+ *
+ * 职责：
+ * - 从分析结果构建领域模型
+ * - 生成唯一标识符
+ * - 建立实体间关系
+ * - 确保数据一致性
+ */
+export class CodeGraphBuilder {
+    moduleIdMap = new Map(); // path -> id
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * 构建代码图
+     * @param projectName - 项目名称
+     * @param projectRoot - 项目根路径
+     * @param moduleResults - 模块分析结果列表
+     */
+    build(projectName, projectRoot, moduleResults) {
+        // 创建项目
+        const project = new Project(this.generateId('proj'), projectName, projectRoot);
+        // 创建代码图
+        const codeGraph = new CodeGraph(project);
+        // 第一遍：创建模块并建立路径到 ID 的映射
+        for (const result of moduleResults) {
+            const moduleId = this.generateId('mod');
+            this.moduleIdMap.set(result.info.path, moduleId);
+            const module = new Module(moduleId, project.id, result.info.path, this.detectLanguage(result.info.path), {
+                lines: result.info.stats.lines,
+                codeLines: result.info.stats.codeLines,
+                commentLines: result.info.stats.commentLines,
+                blankLines: result.info.stats.blankLines,
+            });
+            codeGraph.addModule(module);
+        }
+        // 第二遍：创建符号
+        for (const result of moduleResults) {
+            const moduleId = this.moduleIdMap.get(result.info.path);
+            if (!moduleId)
+                continue;
+            for (const symbolInfo of result.info.symbols) {
+                const symbol = new SymbolEntity(this.generateId('sym'), moduleId, symbolInfo.name, symbolInfo.kind, symbolInfo.location, symbolInfo.visibility);
+                codeGraph.addSymbol(symbol);
+            }
+        }
+        // 第三遍：创建依赖关系
+        for (const result of moduleResults) {
+            const sourceId = this.moduleIdMap.get(result.info.path);
+            if (!sourceId)
+                continue;
+            for (const dep of result.dependencies) {
+                const targetId = this.moduleIdMap.get(dep.targetPath);
+                if (!targetId)
+                    continue; // 外部依赖，跳过
+                const dependency = new Dependency(this.generateId('dep'), sourceId, targetId, dep.type);
+                try {
+                    codeGraph.addDependency(dependency);
+                }
+                catch {
+                    // 依赖已存在，忽略
+                }
+            }
+        }
+        return codeGraph;
+    }
+    /**
+     * 从 CodeMap JSON 重建代码图
+     */
+    rebuildFromJSON(data) {
+        return CodeGraph.fromInterface(data);
+    }
+    /**
+     * 生成唯一 ID
+     */
+    generateId(prefix) {
+        return `${prefix}_${randomUUID().replace(/-/g, '').slice(0, 16)}`;
+    }
+    /**
+     * 根据文件路径检测语言
+     */
+    detectLanguage(filePath) {
+        const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+        const languageMap = {
+            'ts': 'typescript',
+            'tsx': 'typescript',
+            'js': 'javascript',
+            'jsx': 'javascript',
+            'py': 'python',
+            'go': 'go',
+            'java': 'java',
+            'rs': 'rust',
+            'cpp': 'cpp',
+            'cc': 'cpp',
+            'c': 'c',
+            'h': 'c',
+            'hpp': 'cpp',
+        };
+        return languageMap[ext] ?? 'unknown';
+    }
+    /**
+     * 创建构建器的工厂方法
+     */
+    static create(options) {
+        return new CodeGraphBuilder(options);
+    }
+}
+//# sourceMappingURL=CodeGraphBuilder.js.map

package/dist/domain/services/CodeGraphBuilder.js.map

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

package/dist/infrastructure/parser/implementations/GoParser.d.ts

@@ -0,0 +1,25 @@
+import type { ParseOptions, ParseResult } from '../../../interface/types/parser.js';
+import type { ModuleSymbol, ImportInfo, ExportInfo } from '../../../interface/types/index.js';
+import { ParserBase } from '../interfaces/ParserBase.js';
+/**
+ * Go 语言解析器
+ *
+ * TODO-DEBT [L1] [日期:2026-03-17] [作者:AI] [原因:MVP阶段仅实现框架]
+ * 问题：目前仅返回空结果
+ * 风险：无法实际解析 Go 代码
+ * 偿还计划：V1.0 实现完整 Go 解析器
+ */
+export declare class GoParser extends ParserBase {
+    readonly languageId: "go";
+    readonly fileExtensions: string[];
+    readonly name = "Go Parser";
+    protected supportedFeatures: Set<"call-graph" | "cross-file-analysis" | "complexity-metrics">;
+    protected doInitialize(): Promise<void>;
+    protected doDispose(): Promise<void>;
+    parseFile(filePath: string, content: string, options?: ParseOptions): Promise<ParseResult>;
+    extractImports(content: string): Promise<ImportInfo[]>;
+    extractExports(content: string): Promise<ExportInfo[]>;
+    extractSymbols(content: string): Promise<ModuleSymbol[]>;
+    private getLineNumber;
+}
+//# sourceMappingURL=GoParser.d.ts.map

package/dist/infrastructure/parser/implementations/GoParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoParser.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/parser/implementations/GoParser.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EACV,UAAU,EAEX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAc,MAAM,6BAA6B,CAAC;AAErE;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,QAAQ,CAAC,UAAU,EAAG,IAAI,CAAU;IACpC,QAAQ,CAAC,cAAc,WAAU;IACjC,QAAQ,CAAC,IAAI,eAAe;IAE5B,SAAS,CAAC,iBAAiB,mEAIf;cAEI,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAI7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAkDjB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwCtD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuBtD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwC9D,OAAO,CAAC,aAAa;CAGtB"}