@musubix/knowledge 3.0.0

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @musubix/knowledge - Git-Native Knowledge Store
+ *
+ * File-based knowledge graph management for MUSUBIX v3.0
+ *
+ * @packageDocumentation
+ */
+/**
+ * Entity types in the knowledge graph
+ */
+export type EntityType = 'requirement' | 'design' | 'task' | 'code' | 'decision' | 'pattern' | 'constraint';
+/**
+ * Relation types between entities
+ */
+export type RelationType = 'implements' | 'depends_on' | 'traces_to' | 'related_to' | 'derives_from' | 'conflicts_with';
+/**
+ * Entity in the knowledge graph
+ */
+export interface Entity {
+    /** Unique identifier (e.g., "REQ-001", "DES-001") */
+    id: string;
+    /** Entity type */
+    type: EntityType;
+    /** Display name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Additional properties */
+    properties: Record<string, unknown>;
+    /** Tags for categorization */
+    tags: string[];
+    /** Creation timestamp (ISO 8601) */
+    createdAt: string;
+    /** Last update timestamp (ISO 8601) */
+    updatedAt: string;
+}
+/**
+ * Relation between entities
+ */
+export interface Relation {
+    /** Unique identifier */
+    id: string;
+    /** Source entity ID */
+    source: string;
+    /** Target entity ID */
+    target: string;
+    /** Relation type */
+    type: RelationType;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+/**
+ * Knowledge graph structure
+ */
+export interface KnowledgeGraph {
+    /** Schema version */
+    version: '1.0.0';
+    /** Metadata */
+    metadata: {
+        lastModified: string;
+        entityCount: number;
+        relationCount: number;
+    };
+    /** Entities by ID */
+    entities: Record<string, Entity>;
+    /** Relations */
+    relations: Relation[];
+}
+/**
+ * Filter for querying entities
+ */
+export interface QueryFilter {
+    /** Filter by entity type */
+    type?: EntityType | EntityType[];
+    /** Filter by tags (AND) */
+    tags?: string[];
+    /** Filter by property values */
+    properties?: Record<string, unknown>;
+    /** Text search in name/description */
+    text?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Options for search
+ */
+export interface SearchOptions {
+    /** Fields to search */
+    fields?: ('name' | 'description' | 'tags')[];
+    /** Case sensitive search */
+    caseSensitive?: boolean;
+    /** Maximum results */
+    limit?: number;
+}
+/**
+ * Options for graph traversal
+ */
+export interface TraverseOptions {
+    /** Maximum depth */
+    depth?: number;
+    /** Relation types to follow */
+    relationTypes?: RelationType[];
+    /** Direction */
+    direction?: 'out' | 'in' | 'both';
+}
+/**
+ * Knowledge Store interface
+ */
+export interface KnowledgeStore {
+    getEntity(id: string): Promise<Entity | undefined>;
+    putEntity(entity: Entity): Promise<void>;
+    deleteEntity(id: string): Promise<boolean>;
+    addRelation(relation: Relation): Promise<void>;
+    removeRelation(id: string): Promise<boolean>;
+    getRelations(entityId: string, direction?: 'in' | 'out' | 'both'): Promise<Relation[]>;
+    query(filter: QueryFilter): Promise<Entity[]>;
+    search(text: string, options?: SearchOptions): Promise<Entity[]>;
+    getSubgraph(rootId: string, depth: number): Promise<KnowledgeGraph>;
+    traverse(startId: string, options?: TraverseOptions): Promise<Entity[]>;
+    save(): Promise<void>;
+    load(): Promise<void>;
+    getStats(): {
+        entityCount: number;
+        relationCount: number;
+        types: Record<EntityType, number>;
+    };
+}
+/**
+ * Create a new knowledge store
+ */
+export declare function createKnowledgeStore(basePath: string): KnowledgeStore;
+/**
+ * File-based knowledge store implementation
+ */
+export declare class FileKnowledgeStore implements KnowledgeStore {
+    private basePath;
+    private graph;
+    private loaded;
+    constructor(basePath: string);
+    private createEmptyGraph;
+    private getGraphPath;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    getEntity(id: string): Promise<Entity | undefined>;
+    putEntity(entity: Entity): Promise<void>;
+    deleteEntity(id: string): Promise<boolean>;
+    addRelation(relation: Relation): Promise<void>;
+    removeRelation(id: string): Promise<boolean>;
+    getRelations(entityId: string, direction?: 'in' | 'out' | 'both'): Promise<Relation[]>;
+    query(filter: QueryFilter): Promise<Entity[]>;
+    search(text: string, options?: SearchOptions): Promise<Entity[]>;
+    getSubgraph(rootId: string, depth: number): Promise<KnowledgeGraph>;
+    traverse(startId: string, options?: TraverseOptions): Promise<Entity[]>;
+    getStats(): {
+        entityCount: number;
+        relationCount: number;
+        types: Record<EntityType, number>;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,275 @@
+/**
+ * @musubix/knowledge - Git-Native Knowledge Store
+ *
+ * File-based knowledge graph management for MUSUBIX v3.0
+ *
+ * @packageDocumentation
+ */
+// ============================================================
+// Factory Function
+// ============================================================
+/**
+ * Create a new knowledge store
+ */
+export function createKnowledgeStore(basePath) {
+    return new FileKnowledgeStore(basePath);
+}
+// ============================================================
+// Implementation
+// ============================================================
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * File-based knowledge store implementation
+ */
+export class FileKnowledgeStore {
+    basePath;
+    graph;
+    loaded = false;
+    constructor(basePath) {
+        this.basePath = basePath;
+        this.graph = this.createEmptyGraph();
+    }
+    createEmptyGraph() {
+        return {
+            version: '1.0.0',
+            metadata: {
+                lastModified: new Date().toISOString(),
+                entityCount: 0,
+                relationCount: 0,
+            },
+            entities: {},
+            relations: [],
+        };
+    }
+    getGraphPath() {
+        return path.join(this.basePath, 'graph.json');
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(this.getGraphPath(), 'utf-8');
+            this.graph = JSON.parse(content);
+            this.loaded = true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.graph = this.createEmptyGraph();
+                this.loaded = true;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    async save() {
+        await fs.mkdir(this.basePath, { recursive: true });
+        this.graph.metadata.lastModified = new Date().toISOString();
+        this.graph.metadata.entityCount = Object.keys(this.graph.entities).length;
+        this.graph.metadata.relationCount = this.graph.relations.length;
+        await fs.writeFile(this.getGraphPath(), JSON.stringify(this.graph, null, 2), 'utf-8');
+    }
+    async getEntity(id) {
+        if (!this.loaded)
+            await this.load();
+        return this.graph.entities[id];
+    }
+    async putEntity(entity) {
+        if (!this.loaded)
+            await this.load();
+        const now = new Date().toISOString();
+        const existing = this.graph.entities[entity.id];
+        this.graph.entities[entity.id] = {
+            ...entity,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+    }
+    async deleteEntity(id) {
+        if (!this.loaded)
+            await this.load();
+        if (!this.graph.entities[id]) {
+            return false;
+        }
+        delete this.graph.entities[id];
+        // Remove related relations
+        this.graph.relations = this.graph.relations.filter(r => r.source !== id && r.target !== id);
+        return true;
+    }
+    async addRelation(relation) {
+        if (!this.loaded)
+            await this.load();
+        // Validate entities exist
+        if (!this.graph.entities[relation.source]) {
+            throw new Error(`Source entity not found: ${relation.source}`);
+        }
+        if (!this.graph.entities[relation.target]) {
+            throw new Error(`Target entity not found: ${relation.target}`);
+        }
+        // Check for duplicates
+        const exists = this.graph.relations.some(r => r.source === relation.source &&
+            r.target === relation.target &&
+            r.type === relation.type);
+        if (!exists) {
+            this.graph.relations.push(relation);
+        }
+    }
+    async removeRelation(id) {
+        if (!this.loaded)
+            await this.load();
+        const index = this.graph.relations.findIndex(r => r.id === id);
+        if (index === -1)
+            return false;
+        this.graph.relations.splice(index, 1);
+        return true;
+    }
+    async getRelations(entityId, direction = 'both') {
+        if (!this.loaded)
+            await this.load();
+        return this.graph.relations.filter(r => {
+            if (direction === 'out')
+                return r.source === entityId;
+            if (direction === 'in')
+                return r.target === entityId;
+            return r.source === entityId || r.target === entityId;
+        });
+    }
+    async query(filter) {
+        if (!this.loaded)
+            await this.load();
+        let results = Object.values(this.graph.entities);
+        // Filter by type
+        if (filter.type) {
+            const types = Array.isArray(filter.type) ? filter.type : [filter.type];
+            results = results.filter(e => types.includes(e.type));
+        }
+        // Filter by tags
+        if (filter.tags && filter.tags.length > 0) {
+            results = results.filter(e => filter.tags.every(tag => e.tags.includes(tag)));
+        }
+        // Filter by text
+        if (filter.text) {
+            const searchText = filter.text.toLowerCase();
+            results = results.filter(e => e.name.toLowerCase().includes(searchText) ||
+                e.description?.toLowerCase().includes(searchText));
+        }
+        // Apply pagination
+        const offset = filter.offset ?? 0;
+        const limit = filter.limit ?? results.length;
+        return results.slice(offset, offset + limit);
+    }
+    async search(text, options) {
+        if (!this.loaded)
+            await this.load();
+        const searchText = options?.caseSensitive ? text : text.toLowerCase();
+        const fields = options?.fields ?? ['name', 'description', 'tags'];
+        let results = Object.values(this.graph.entities).filter(e => {
+            for (const field of fields) {
+                if (field === 'name') {
+                    const value = options?.caseSensitive ? e.name : e.name.toLowerCase();
+                    if (value.includes(searchText))
+                        return true;
+                }
+                if (field === 'description' && e.description) {
+                    const value = options?.caseSensitive ? e.description : e.description.toLowerCase();
+                    if (value.includes(searchText))
+                        return true;
+                }
+                if (field === 'tags') {
+                    const matched = e.tags.some(tag => {
+                        const value = options?.caseSensitive ? tag : tag.toLowerCase();
+                        return value.includes(searchText);
+                    });
+                    if (matched)
+                        return true;
+                }
+            }
+            return false;
+        });
+        if (options?.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    async getSubgraph(rootId, depth) {
+        if (!this.loaded)
+            await this.load();
+        const visited = new Set();
+        const entities = {};
+        const relations = [];
+        const traverse = async (id, currentDepth) => {
+            if (currentDepth > depth || visited.has(id))
+                return;
+            visited.add(id);
+            const entity = this.graph.entities[id];
+            if (!entity)
+                return;
+            entities[id] = entity;
+            const rels = await this.getRelations(id, 'both');
+            for (const rel of rels) {
+                if (!relations.some(r => r.id === rel.id)) {
+                    relations.push(rel);
+                }
+                const nextId = rel.source === id ? rel.target : rel.source;
+                await traverse(nextId, currentDepth + 1);
+            }
+        };
+        await traverse(rootId, 0);
+        return {
+            version: '1.0.0',
+            metadata: {
+                lastModified: new Date().toISOString(),
+                entityCount: Object.keys(entities).length,
+                relationCount: relations.length,
+            },
+            entities,
+            relations,
+        };
+    }
+    async traverse(startId, options) {
+        if (!this.loaded)
+            await this.load();
+        const depth = options?.depth ?? 3;
+        const direction = options?.direction ?? 'both';
+        const relationTypes = options?.relationTypes;
+        const visited = new Set();
+        const results = [];
+        const visit = async (id, currentDepth) => {
+            if (currentDepth > depth || visited.has(id))
+                return;
+            visited.add(id);
+            const entity = this.graph.entities[id];
+            if (!entity)
+                return;
+            results.push(entity);
+            const rels = await this.getRelations(id, direction);
+            for (const rel of rels) {
+                if (relationTypes && !relationTypes.includes(rel.type))
+                    continue;
+                const nextId = rel.source === id ? rel.target : rel.source;
+                await visit(nextId, currentDepth + 1);
+            }
+        };
+        await visit(startId, 0);
+        return results;
+    }
+    getStats() {
+        const types = {
+            requirement: 0,
+            design: 0,
+            task: 0,
+            code: 0,
+            decision: 0,
+            pattern: 0,
+            constraint: 0,
+        };
+        for (const entity of Object.values(this.graph.entities)) {
+            types[entity.type]++;
+        }
+        return {
+            entityCount: Object.keys(this.graph.entities).length,
+            relationCount: this.graph.relations.length,
+            types,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqKH,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,QAAQ,CAAS;IACjB,KAAK,CAAiB;IACtB,MAAM,GAAY,KAAK,CAAC;IAEhC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACvC,CAAC;IAEO,gBAAgB;QACtB,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtC,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,CAAC;aACjB;YACD,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;YAChE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;YACnD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC1E,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAChE,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,YAAY,EAAE,EACnB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EACnC,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEhD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG;YAC/B,GAAG,MAAM;YACT,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;YACrC,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/B,2BAA2B;QAC3B,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CACxC,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAkB;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,uBAAuB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAC5B,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAC5B,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAC9B,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,EAAU;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE/B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,YAAmC,MAAM;QAC5E,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACrC,IAAI,SAAS,KAAK,KAAK;gBAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;YACtD,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;YACrD,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEjD,iBAAiB;QACjB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC3B,MAAM,CAAC,IAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAChD,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7C,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC3B,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACzC,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAClD,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QAE7C,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAuB;QAChD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,MAAM,UAAU,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAElE,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;oBACrB,MAAM,KAAK,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrE,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,OAAO,IAAI,CAAC;gBAC9C,CAAC;gBACD,IAAI,KAAK,KAAK,aAAa,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;oBAC7C,MAAM,KAAK,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;oBACnF,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;wBAAE,OAAO,IAAI,CAAC;gBAC9C,CAAC;gBACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;oBACrB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;wBAChC,MAAM,KAAK,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;wBAC/D,OAAO,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;oBACpC,CAAC,CAAC,CAAC;oBACH,IAAI,OAAO;wBAAE,OAAO,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,KAAa;QAC7C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,MAAM,QAAQ,GAAG,KAAK,EAAE,EAAU,EAAE,YAAoB,EAAE,EAAE;YAC1D,IAAI,YAAY,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEpB,QAAQ,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;YAEtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC1C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC3D,MAAM,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE1B,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;gBACzC,aAAa,EAAE,SAAS,CAAC,MAAM;aAChC;YACD,QAAQ;YACR,SAAS;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,OAAyB;QACvD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,MAAM,CAAC;QAC/C,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;QAE7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG,KAAK,EAAE,EAAU,EAAE,YAAoB,EAAE,EAAE;YACvD,IAAI,YAAY,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM;gBAAE,OAAO;YAEpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACpD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,aAAa,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACjE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC3D,MAAM,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAExB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAA+B;YACxC,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,CAAC;QAED,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM;YACpD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM;YAC1C,KAAK;SACN,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@musubix/knowledge",
+  "version": "3.0.0",
+  "description": "Git-Native Knowledge Store for MUSUBIX - File-based knowledge graph management",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "musubix",
+    "knowledge-graph",
+    "git-native",
+    "file-based"
+  ],
+  "author": "nahisaho",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nahisaho/MUSUBIX.git",
+    "directory": "packages/knowledge"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  }
+}