@nahisaho/musubix-codegraph 3.7.3 → 3.8.0

package/dist/storage/index.d.ts

@@ -6,4 +6,5 @@
  */
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
+export { KnowledgeAdapter, type KnowledgeAdapterOptions } from './knowledge-adapter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/storage/index.js

@@ -6,5 +6,5 @@
  */
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
-// export { KnowledgeAdapter } from './knowledge-adapter.js'; // TODO: Implement @musubix/knowledge integration
+export { KnowledgeAdapter } from './knowledge-adapter.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,+GAA+G"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAgC,MAAM,wBAAwB,CAAC"}

package/dist/storage/knowledge-adapter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @nahisaho/musubix-codegraph - Knowledge Store Adapter
+ *
+ * Adapts @musubix/knowledge's KnowledgeStore to the codegraph StorageAdapter interface.
+ * Maps codegraph entities/relations to knowledge graph entities/relations.
+ *
+ * @see REQ-CG-API-005
+ * @see DES-CG-006
+ */
+import type { StorageAdapter, StorageStats, Entity, Relation, GraphQuery } from '../types.js';
+import type { KnowledgeStore } from '@musubix/knowledge';
+/**
+ * Options for KnowledgeAdapter
+ */
+export interface KnowledgeAdapterOptions {
+    /** Whether to auto-save after each mutation (default: false) */
+    autoSave?: boolean;
+}
+/**
+ * Knowledge Store adapter for codegraph
+ *
+ * Bridges @musubix/knowledge's KnowledgeStore to the codegraph StorageAdapter
+ * interface, allowing codegraph data to be persisted in the knowledge graph.
+ *
+ * @example
+ * ```typescript
+ * import { createKnowledgeStore } from '@musubix/knowledge';
+ * import { KnowledgeAdapter } from '@nahisaho/musubix-codegraph/storage';
+ *
+ * const store = createKnowledgeStore('.knowledge');
+ * const adapter = new KnowledgeAdapter(store);
+ * await adapter.initialize();
+ *
+ * await adapter.saveEntity(entity);
+ * const retrieved = await adapter.getEntity(entity.id);
+ * ```
+ */
+export declare class KnowledgeAdapter implements StorageAdapter {
+    private store;
+    private options;
+    private initialized;
+    private filePathSet;
+    constructor(store: KnowledgeStore, options?: KnowledgeAdapterOptions);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    saveEntity(entity: Entity): Promise<void>;
+    getEntity(id: string): Promise<Entity | null>;
+    queryEntities(query: GraphQuery): Promise<Entity[]>;
+    deleteEntity(id: string): Promise<void>;
+    saveRelation(relation: Relation): Promise<void>;
+    getRelations(entityId: string, direction?: 'in' | 'out' | 'both'): Promise<Relation[]>;
+    deleteRelation(id: string): Promise<void>;
+    bulkSave(entities: Entity[], relations: Relation[]): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<StorageStats>;
+    /**
+     * Rebuild the file path index from stored entities
+     */
+    private rebuildFilePathIndex;
+    /**
+     * Save all pending changes to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Check if the adapter is initialized
+     */
+    isInitialized(): boolean;
+}
+//# sourceMappingURL=knowledge-adapter.d.ts.map

package/dist/storage/knowledge-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/knowledge-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+GD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAqB;gBAE5B,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,uBAA4B;IAWlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM7C,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwCnD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,IAAI,GAAG,KAAK,GAAG,MAAe,GACxC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAYhB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAsBvC;;OAEG;YACW,oBAAoB;IAWlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}

package/dist/storage/knowledge-adapter.js

@@ -0,0 +1,312 @@
+/**
+ * @nahisaho/musubix-codegraph - Knowledge Store Adapter
+ *
+ * Adapts @musubix/knowledge's KnowledgeStore to the codegraph StorageAdapter interface.
+ * Maps codegraph entities/relations to knowledge graph entities/relations.
+ *
+ * @see REQ-CG-API-005
+ * @see DES-CG-006
+ */
+/** Relation types shared between codegraph and knowledge */
+const SHARED_RELATION_TYPES = new Set([
+    'implements',
+    'depends_on',
+]);
+/**
+ * Map a codegraph RelationType to a knowledge RelationType.
+ * Shared types map directly; others map to 'related_to'.
+ */
+function toKnowledgeRelationType(type) {
+    if (SHARED_RELATION_TYPES.has(type)) {
+        return type;
+    }
+    return 'related_to';
+}
+/**
+ * Convert a codegraph Entity to a knowledge Entity
+ */
+function toKnowledgeEntity(entity) {
+    const now = new Date().toISOString();
+    const tags = [];
+    if (entity.language)
+        tags.push(`lang:${entity.language}`);
+    if (entity.type)
+        tags.push(`kind:${entity.type}`);
+    if (entity.communityId)
+        tags.push(`community:${entity.communityId}`);
+    return {
+        id: `code-node:${entity.id}`,
+        type: 'code',
+        name: entity.name,
+        description: entity.docstring,
+        properties: {
+            entityType: entity.type,
+            qualifiedName: entity.qualifiedName,
+            namespace: entity.namespace,
+            filePath: entity.filePath,
+            startLine: entity.startLine,
+            endLine: entity.endLine,
+            signature: entity.signature,
+            sourceCode: entity.sourceCode,
+            communityId: entity.communityId,
+            language: entity.language,
+            metadata: entity.metadata,
+        },
+        tags,
+        createdAt: entity.createdAt?.toISOString() ?? now,
+        updatedAt: entity.updatedAt?.toISOString() ?? now,
+    };
+}
+/**
+ * Convert a knowledge Entity back to a codegraph Entity
+ */
+function fromKnowledgeEntity(kEntity) {
+    const props = kEntity.properties;
+    return {
+        id: String(kEntity.id).replace(/^code-node:/, ''),
+        type: props.entityType ?? 'unknown',
+        name: kEntity.name,
+        qualifiedName: props.qualifiedName,
+        namespace: props.namespace,
+        filePath: props.filePath,
+        startLine: props.startLine,
+        endLine: props.endLine,
+        signature: props.signature,
+        docstring: kEntity.description,
+        sourceCode: props.sourceCode,
+        communityId: props.communityId,
+        language: props.language,
+        metadata: props.metadata ?? {},
+        createdAt: kEntity.createdAt ? new Date(kEntity.createdAt) : undefined,
+        updatedAt: kEntity.updatedAt ? new Date(kEntity.updatedAt) : undefined,
+    };
+}
+/**
+ * Convert a codegraph Relation to a knowledge Relation
+ */
+function toKnowledgeRelation(relation) {
+    return {
+        id: `code-rel:${relation.id}`,
+        source: `code-node:${relation.sourceId}`,
+        target: `code-node:${relation.targetId}`,
+        type: toKnowledgeRelationType(relation.type),
+        properties: {
+            relationType: relation.type,
+            weight: relation.weight,
+            metadata: relation.metadata,
+        },
+    };
+}
+/**
+ * Convert a knowledge Relation back to a codegraph Relation
+ */
+function fromKnowledgeRelation(kRelation) {
+    const props = kRelation.properties ?? {};
+    return {
+        id: String(kRelation.id).replace(/^code-rel:/, ''),
+        sourceId: String(kRelation.source).replace(/^code-node:/, ''),
+        targetId: String(kRelation.target).replace(/^code-node:/, ''),
+        type: props.relationType ?? 'references',
+        weight: props.weight ?? 1,
+        metadata: props.metadata ?? {},
+    };
+}
+/**
+ * Knowledge Store adapter for codegraph
+ *
+ * Bridges @musubix/knowledge's KnowledgeStore to the codegraph StorageAdapter
+ * interface, allowing codegraph data to be persisted in the knowledge graph.
+ *
+ * @example
+ * ```typescript
+ * import { createKnowledgeStore } from '@musubix/knowledge';
+ * import { KnowledgeAdapter } from '@nahisaho/musubix-codegraph/storage';
+ *
+ * const store = createKnowledgeStore('.knowledge');
+ * const adapter = new KnowledgeAdapter(store);
+ * await adapter.initialize();
+ *
+ * await adapter.saveEntity(entity);
+ * const retrieved = await adapter.getEntity(entity.id);
+ * ```
+ */
+export class KnowledgeAdapter {
+    store;
+    options;
+    initialized = false;
+    filePathSet = new Set();
+    constructor(store, options = {}) {
+        this.store = store;
+        this.options = {
+            autoSave: options.autoSave ?? false,
+        };
+    }
+    // =========================================================================
+    // Lifecycle
+    // =========================================================================
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.store.load();
+        // Rebuild the file path set from existing entities
+        await this.rebuildFilePathIndex();
+        this.initialized = true;
+    }
+    async close() {
+        if (this.options.autoSave) {
+            await this.store.save();
+        }
+        this.filePathSet.clear();
+        this.initialized = false;
+    }
+    // =========================================================================
+    // Entity Operations
+    // =========================================================================
+    async saveEntity(entity) {
+        const kEntity = toKnowledgeEntity(entity);
+        await this.store.putEntity(kEntity);
+        if (entity.filePath) {
+            this.filePathSet.add(entity.filePath);
+        }
+        if (this.options.autoSave) {
+            await this.store.save();
+        }
+    }
+    async getEntity(id) {
+        const kEntity = await this.store.getEntity(`code-node:${id}`);
+        if (!kEntity)
+            return null;
+        return fromKnowledgeEntity(kEntity);
+    }
+    async queryEntities(query) {
+        // Use the knowledge store's query to get code entities
+        const allCodeEntities = await this.store.query({
+            type: 'code',
+        });
+        let results = allCodeEntities.map(fromKnowledgeEntity);
+        // Filter by entity types
+        if (query.entityTypes && query.entityTypes.length > 0) {
+            results = results.filter((e) => query.entityTypes.includes(e.type));
+        }
+        // Filter by file path
+        if (query.filePath) {
+            const normalizedPath = query.filePath.toLowerCase();
+            results = results.filter((e) => e.filePath?.toLowerCase() === normalizedPath);
+        }
+        // Text search
+        if (query.textSearch) {
+            const searchLower = query.textSearch.toLowerCase();
+            results = results.filter((e) => e.name.toLowerCase().includes(searchLower) ||
+                e.id.toLowerCase().includes(searchLower) ||
+                e.docstring?.toLowerCase().includes(searchLower));
+        }
+        // Apply limit
+        if (query.limit && query.limit > 0) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    async deleteEntity(id) {
+        // Remove entity from knowledge store (which also removes related relations)
+        await this.store.deleteEntity(`code-node:${id}`);
+        if (this.options.autoSave) {
+            await this.store.save();
+        }
+    }
+    // =========================================================================
+    // Relation Operations
+    // =========================================================================
+    async saveRelation(relation) {
+        const kRelation = toKnowledgeRelation(relation);
+        try {
+            await this.store.addRelation(kRelation);
+            if (this.options.autoSave) {
+                await this.store.save();
+            }
+        }
+        catch {
+            // If source/target entity not found in knowledge store, silently skip
+            // This can happen when relations reference entities not yet saved
+        }
+    }
+    async getRelations(entityId, direction = 'both') {
+        const kRelations = await this.store.getRelations(`code-node:${entityId}`, direction);
+        // Only return relations that belong to codegraph (prefixed with code-rel:)
+        return kRelations
+            .filter((r) => String(r.id).startsWith('code-rel:'))
+            .map(fromKnowledgeRelation);
+    }
+    async deleteRelation(id) {
+        await this.store.removeRelation(`code-rel:${id}`);
+        if (this.options.autoSave) {
+            await this.store.save();
+        }
+    }
+    // =========================================================================
+    // Bulk Operations
+    // =========================================================================
+    async bulkSave(entities, relations) {
+        for (const entity of entities) {
+            await this.saveEntity(entity);
+        }
+        for (const relation of relations) {
+            await this.saveRelation(relation);
+        }
+    }
+    async clear() {
+        // Query all code entities and delete them
+        const codeEntities = await this.store.query({ type: 'code' });
+        for (const entity of codeEntities) {
+            await this.store.deleteEntity(entity.id);
+        }
+        this.filePathSet.clear();
+        if (this.options.autoSave) {
+            await this.store.save();
+        }
+    }
+    // =========================================================================
+    // Statistics
+    // =========================================================================
+    async getStats() {
+        const codeEntities = await this.store.query({ type: 'code' });
+        let relationCount = 0;
+        for (const entity of codeEntities) {
+            const rels = await this.store.getRelations(entity.id, 'out');
+            relationCount += rels.filter((r) => String(r.id).startsWith('code-rel:')).length;
+        }
+        return {
+            entityCount: codeEntities.length,
+            relationCount,
+            fileCount: this.filePathSet.size,
+        };
+    }
+    // =========================================================================
+    // Internal Helpers
+    // =========================================================================
+    /**
+     * Rebuild the file path index from stored entities
+     */
+    async rebuildFilePathIndex() {
+        this.filePathSet.clear();
+        const codeEntities = await this.store.query({ type: 'code' });
+        for (const entity of codeEntities) {
+            const filePath = entity.properties.filePath;
+            if (typeof filePath === 'string') {
+                this.filePathSet.add(filePath);
+            }
+        }
+    }
+    /**
+     * Save all pending changes to disk
+     */
+    async save() {
+        await this.store.save();
+    }
+    /**
+     * Check if the adapter is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+}
+//# sourceMappingURL=knowledge-adapter.js.map

package/dist/storage/knowledge-adapter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/musubix-codegraph",
-  "version": "3.7.3",
+  "version": "3.8.0",
   "description": "MUSUBIX CodeGraph - Multi-language Code Graph Analysis Engine supporting 16 programming languages with PR generation",
   "type": "module",
   "main": "dist/index.js",
@@ -39,6 +39,14 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  },
   "keywords": [
     "codegraph",
     "ast",
@@ -85,17 +93,18 @@
     "tree-sitter-scala": "^0.21.0",
     "tree-sitter-lua": "^2.1.3"
   },
+  "peerDependencies": {
+    "@musubix/knowledge": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@musubix/knowledge": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@musubix/knowledge": "^3.7.3",
     "@types/node": "^20.0.0",
     "typescript": "^5.3.0",
     "vitest": "^4.0.16"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src --ext .ts",
-    "clean": "rm -rf dist"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 nahisaho
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.