@musubix/knowledge 3.6.0 → 3.7.3

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/dist/integration/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Integration layer exports for knowledge
+ * @traceability TSK-INT-003
+ */
+export * from './types.js';
+export * from './skill-knowledge-bridge.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC"}

package/dist/integration/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Integration layer exports for knowledge
+ * @traceability TSK-INT-003
+ */
+export * from './types.js';
+export * from './skill-knowledge-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC"}

package/dist/integration/skill-knowledge-bridge.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Skill-Knowledge Bridge Implementation
+ * Integrates skills with Knowledge Graph
+ *
+ * @traceability TSK-INT-003, DES-v3.7.0 Section 9.4
+ */
+import type { SkillKnowledgeBridge, SkillKnowledgeBridgeConfig, SkillEntity, ContextQueryResult } from './types.js';
+/**
+ * Create a Skill-Knowledge Bridge instance
+ */
+export declare function createSkillKnowledgeBridge(config?: Partial<SkillKnowledgeBridgeConfig>): SkillKnowledgeBridge;
+/**
+ * Format session as markdown for display
+ */
+export declare function formatSessionAsMarkdown(session: SkillEntity): string;
+/**
+ * Format context query result as markdown
+ */
+export declare function formatContextAsMarkdown(result: ContextQueryResult): string;
+//# sourceMappingURL=skill-knowledge-bridge.d.ts.map

package/dist/integration/skill-knowledge-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-knowledge-bridge.d.ts","sourceRoot":"","sources":["../../src/integration/skill-knowledge-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,WAAW,EAIX,kBAAkB,EAMnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC/C,oBAAoB,CA2YtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAgCpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAwB1E"}

package/dist/integration/skill-knowledge-bridge.js

@@ -0,0 +1,388 @@
+/**
+ * @fileoverview Skill-Knowledge Bridge Implementation
+ * Integrates skills with Knowledge Graph
+ *
+ * @traceability TSK-INT-003, DES-v3.7.0 Section 9.4
+ */
+import { createKnowledgeStore } from '../index.js';
+import { DEFAULT_SKILL_KNOWLEDGE_BRIDGE_CONFIG, } from './types.js';
+/**
+ * Create a Skill-Knowledge Bridge instance
+ */
+export function createSkillKnowledgeBridge(config = {}) {
+    const fullConfig = {
+        ...DEFAULT_SKILL_KNOWLEDGE_BRIDGE_CONFIG,
+        ...config,
+    };
+    // Resolve home directory
+    const basePath = fullConfig.basePath.replace(/^~/, process.env.HOME ?? '');
+    const store = createKnowledgeStore(basePath);
+    /**
+     * Generate unique ID with prefix
+     */
+    function generateId(prefix) {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `${prefix}-${timestamp}-${random}`;
+    }
+    /**
+     * Convert SkillEntity to base Entity
+     */
+    function toBaseEntity(skill) {
+        // Map SkillEntityType to EntityType (use 'code' as fallback for skill-specific types)
+        const baseType = ['requirement', 'design', 'task', 'code', 'decision', 'pattern', 'constraint'].includes(skill.type)
+            ? skill.type
+            : 'code'; // Use 'code' as generic fallback
+        return {
+            id: skill.id,
+            type: baseType,
+            name: skill.name,
+            description: skill.description,
+            properties: {
+                ...skill.properties,
+                skillEntityType: skill.type, // Preserve original type
+            },
+            tags: skill.tags,
+            createdAt: '',
+            updatedAt: '',
+        };
+    }
+    /**
+     * Convert base Entity to SkillEntity
+     */
+    function fromBaseEntity(entity) {
+        const skillType = entity.properties.skillEntityType ?? entity.type;
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { skillEntityType, ...properties } = entity.properties;
+        return {
+            id: entity.id,
+            type: skillType,
+            name: entity.name,
+            description: entity.description,
+            properties: properties,
+            tags: entity.tags,
+        };
+    }
+    /**
+     * Calculate relevance score for context query
+     */
+    function calculateRelevance(entity, context) {
+        let score = 0;
+        // Session match
+        if (context.sessionId && entity.properties.kind === 'session') {
+            if (entity.id === context.sessionId) {
+                score += 0.5;
+            }
+        }
+        // Skill match
+        if (context.currentSkill && entity.properties.kind === 'skill') {
+            if (entity.name.toLowerCase().includes(context.currentSkill.toLowerCase())) {
+                score += 0.4;
+            }
+        }
+        // Keyword match
+        if (context.taskKeywords && context.taskKeywords.length > 0) {
+            const entityText = `${entity.name} ${entity.description ?? ''} ${JSON.stringify(entity.properties)}`.toLowerCase();
+            const matchedKeywords = context.taskKeywords.filter(k => entityText.includes(k.toLowerCase()));
+            score += 0.1 * matchedKeywords.length;
+        }
+        // Error context match for patterns
+        if (context.errorContext && entity.properties.kind === 'learned_pattern') {
+            const patternProps = entity.properties;
+            if (patternProps.problem.toLowerCase().includes(context.errorContext.toLowerCase())) {
+                score += 0.6;
+            }
+        }
+        // Recency boost for sessions
+        if (entity.properties.kind === 'session') {
+            const props = entity.properties;
+            const age = Date.now() - new Date(props.startedAt).getTime();
+            const dayMs = 24 * 60 * 60 * 1000;
+            if (age < dayMs) {
+                score += 0.2;
+            }
+            else if (age < 7 * dayMs) {
+                score += 0.1;
+            }
+        }
+        return Math.min(1, score);
+    }
+    return {
+        async storeSkillEntity(entity) {
+            await store.putEntity(toBaseEntity(entity));
+            if (fullConfig.autoSave) {
+                await store.save();
+            }
+        },
+        async getSkillEntity(id) {
+            const entity = await store.getEntity(id);
+            return entity ? fromBaseEntity(entity) : undefined;
+        },
+        async deleteSkillEntity(id) {
+            const result = await store.deleteEntity(id);
+            if (result && fullConfig.autoSave) {
+                await store.save();
+            }
+            return result;
+        },
+        async addSkillRelation(sourceId, targetId, type, properties) {
+            // Map to base relation type
+            const baseType = ['implements', 'depends_on', 'traces_to', 'related_to', 'derives_from', 'conflicts_with'].includes(type)
+                ? type
+                : 'related_to';
+            const relationId = `rel-${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 8)}`;
+            const relation = {
+                id: relationId,
+                source: sourceId,
+                target: targetId,
+                type: baseType,
+                properties: {
+                    ...properties,
+                    skillRelationType: type, // Preserve original type
+                },
+            };
+            await store.addRelation(relation);
+            if (fullConfig.autoSave) {
+                await store.save();
+            }
+        },
+        async querySkillContext(context) {
+            const maxResults = context.maxResults ?? fullConfig.maxContextEntities;
+            const allEntities = await store.query({});
+            const scored = [];
+            for (const entity of allEntities) {
+                const skillEntity = fromBaseEntity(entity);
+                const score = calculateRelevance(skillEntity, context);
+                if (score > 0) {
+                    scored.push({ entity: skillEntity, score });
+                }
+            }
+            // Sort by score and limit
+            scored.sort((a, b) => b.score - a.score);
+            const limited = scored.slice(0, maxResults);
+            // Determine query source
+            let querySource = 'related';
+            if (context.sessionId) {
+                querySource = 'session';
+            }
+            else if (context.errorContext) {
+                querySource = 'pattern';
+            }
+            return {
+                entities: limited.map(s => s.entity),
+                scores: new Map(limited.map(s => [s.entity.id, s.score])),
+                querySource,
+            };
+        },
+        async startSession(taskDescription) {
+            const sessionId = generateId('session');
+            const now = new Date().toISOString();
+            const session = {
+                id: sessionId,
+                type: 'session',
+                name: `Session ${sessionId}`,
+                description: taskDescription,
+                properties: {
+                    kind: 'session',
+                    startedAt: now,
+                    status: 'active',
+                    taskDescription,
+                    skillsUsed: [],
+                    checkpointCount: 0,
+                },
+                tags: ['session', 'active'],
+            };
+            await this.storeSkillEntity(session);
+            return sessionId;
+        },
+        async endSession(sessionId, status, skillsUsed) {
+            const session = await this.getSkillEntity(sessionId);
+            if (!session) {
+                throw new Error(`Session not found: ${sessionId}`);
+            }
+            const now = new Date().toISOString();
+            const props = session.properties;
+            const updated = {
+                ...session,
+                properties: {
+                    ...props,
+                    endedAt: now,
+                    status,
+                    skillsUsed,
+                },
+                tags: session.tags.filter(t => t !== 'active').concat(status),
+            };
+            await this.storeSkillEntity(updated);
+        },
+        async recordCheckpoint(sessionId, phase, snapshotPath) {
+            const checkpointId = generateId('checkpoint');
+            const checkpoint = {
+                id: checkpointId,
+                type: 'checkpoint',
+                name: `Checkpoint: ${phase}`,
+                description: `Checkpoint at phase ${phase} for session ${sessionId}`,
+                properties: {
+                    kind: 'checkpoint',
+                    sessionId,
+                    phase,
+                    snapshotPath,
+                    verified: false,
+                },
+                tags: ['checkpoint', phase],
+            };
+            await this.storeSkillEntity(checkpoint);
+            await this.addSkillRelation(checkpointId, sessionId, 'checkpoint_of');
+            // Update session checkpoint count
+            const session = await this.getSkillEntity(sessionId);
+            if (session) {
+                const props = session.properties;
+                props.checkpointCount += 1;
+                await this.storeSkillEntity(session);
+            }
+            return checkpointId;
+        },
+        async recordEvalResult(sessionId, evalType, results) {
+            const evalId = generateId('eval');
+            const evalResult = {
+                id: evalId,
+                type: 'eval_result',
+                name: `${evalType} Evaluation`,
+                description: `${evalType} evaluation result for session ${sessionId}`,
+                properties: {
+                    kind: 'eval_result',
+                    evalType,
+                    ...results,
+                },
+                tags: ['eval', evalType],
+            };
+            await this.storeSkillEntity(evalResult);
+            await this.addSkillRelation(evalId, sessionId, 'evaluated_by');
+            return evalId;
+        },
+        async getSessionHistory(limit = 10) {
+            const allEntities = await store.query({});
+            const sessions = allEntities
+                .map(fromBaseEntity)
+                .filter(e => e.type === 'session')
+                .sort((a, b) => {
+                const aTime = a.properties.startedAt;
+                const bTime = b.properties.startedAt;
+                return new Date(bTime).getTime() - new Date(aTime).getTime();
+            })
+                .slice(0, limit);
+            return sessions;
+        },
+        async getRelatedEntities(entityId, relationTypes, depth = 1) {
+            const related = await store.traverse(entityId, {
+                direction: 'both',
+                depth: depth,
+            });
+            const entities = related.map(fromBaseEntity);
+            if (relationTypes && relationTypes.length > 0) {
+                // Filter would need relation data - for now return all
+                return entities;
+            }
+            return entities;
+        },
+        async getStatistics() {
+            const allEntities = await store.query({});
+            const skillEntities = allEntities.map(fromBaseEntity);
+            const byType = {};
+            let completedSessions = 0;
+            let failedSessions = 0;
+            let totalCheckpoints = 0;
+            let totalLearnedPatterns = 0;
+            let totalSessionDuration = 0;
+            let sessionCount = 0;
+            for (const entity of skillEntities) {
+                byType[entity.type] = (byType[entity.type] ?? 0) + 1;
+                if (entity.type === 'session') {
+                    const props = entity.properties;
+                    sessionCount++;
+                    if (props.status === 'completed')
+                        completedSessions++;
+                    if (props.status === 'failed')
+                        failedSessions++;
+                    if (props.endedAt) {
+                        totalSessionDuration +=
+                            new Date(props.endedAt).getTime() - new Date(props.startedAt).getTime();
+                    }
+                }
+                else if (entity.type === 'checkpoint') {
+                    totalCheckpoints++;
+                }
+                else if (entity.type === 'learned_pattern') {
+                    totalLearnedPatterns++;
+                }
+            }
+            return {
+                totalEntities: skillEntities.length,
+                byType: byType,
+                totalSessions: sessionCount,
+                completedSessions,
+                failedSessions,
+                totalCheckpoints,
+                totalLearnedPatterns,
+                averageSessionDuration: sessionCount > 0
+                    ? totalSessionDuration / sessionCount
+                    : undefined,
+            };
+        },
+    };
+}
+/**
+ * Format session as markdown for display
+ */
+export function formatSessionAsMarkdown(session) {
+    if (session.type !== 'session') {
+        throw new Error('Entity is not a session');
+    }
+    const props = session.properties;
+    const lines = [
+        `# 📋 Session: ${session.id}`,
+        '',
+        `**Status**: ${props.status}`,
+        `**Started**: ${props.startedAt}`,
+    ];
+    if (props.endedAt) {
+        lines.push(`**Ended**: ${props.endedAt}`);
+        const duration = new Date(props.endedAt).getTime() - new Date(props.startedAt).getTime();
+        const minutes = Math.round(duration / 60000);
+        lines.push(`**Duration**: ${minutes} minutes`);
+    }
+    if (props.taskDescription) {
+        lines.push('', '## Task', props.taskDescription);
+    }
+    if (props.skillsUsed.length > 0) {
+        lines.push('', '## Skills Used');
+        props.skillsUsed.forEach(s => lines.push(`- ${s}`));
+    }
+    lines.push('', `**Checkpoints**: ${props.checkpointCount}`);
+    return lines.join('\n');
+}
+/**
+ * Format context query result as markdown
+ */
+export function formatContextAsMarkdown(result) {
+    if (result.entities.length === 0) {
+        return '📝 No relevant context found.\n';
+    }
+    const lines = [
+        `# 🔍 Context Query Result (${result.querySource})`,
+        '',
+        `Found ${result.entities.length} relevant entities:`,
+        '',
+    ];
+    for (const entity of result.entities) {
+        const score = result.scores.get(entity.id) ?? 0;
+        lines.push(`## ${entity.name}`);
+        lines.push(`- **Type**: ${entity.type}`);
+        lines.push(`- **Relevance**: ${(score * 100).toFixed(1)}%`);
+        if (entity.description) {
+            lines.push(`- **Description**: ${entity.description}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill-knowledge-bridge.js.map

package/dist/integration/skill-knowledge-bridge.js.map

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

package/dist/integration/types.d.ts

@@ -0,0 +1,216 @@
+/**
+ * @fileoverview Skill-Knowledge Bridge Types
+ * Integrates skills with Knowledge Graph
+ *
+ * @traceability TSK-INT-003, DES-v3.7.0 Section 9.4
+ */
+import type { EntityType, RelationType } from '../index.js';
+/**
+ * Skill entity types (extends base EntityType)
+ */
+export type SkillEntityType = EntityType | 'skill' | 'session' | 'checkpoint' | 'eval_result' | 'learned_pattern';
+/**
+ * Skill relation types (extends base RelationType)
+ */
+export type SkillRelationType = RelationType | 'executed_by' | 'checkpoint_of' | 'evaluated_by' | 'learned_from' | 'triggered_by';
+/**
+ * Skill entity for storing in knowledge graph
+ */
+export interface SkillEntity {
+    /** Unique identifier */
+    id: string;
+    /** Entity type */
+    type: SkillEntityType;
+    /** Display name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Properties specific to skill type */
+    properties: SkillEntityProperties;
+    /** Tags for categorization */
+    tags: string[];
+}
+/**
+ * Properties for different skill entity types
+ */
+export type SkillEntityProperties = SkillProperties | SessionProperties | CheckpointProperties | EvalResultProperties | LearnedPatternProperties;
+/**
+ * Skill definition properties
+ */
+export interface SkillProperties {
+    kind: 'skill';
+    version: string;
+    author?: string;
+    triggers: string[];
+    commands: string[];
+    successMetric?: string;
+    failureMetric?: string;
+}
+/**
+ * Session properties
+ */
+export interface SessionProperties {
+    kind: 'session';
+    startedAt: string;
+    endedAt?: string;
+    status: 'active' | 'completed' | 'failed' | 'abandoned';
+    taskDescription?: string;
+    skillsUsed: string[];
+    checkpointCount: number;
+}
+/**
+ * Checkpoint properties
+ */
+export interface CheckpointProperties {
+    kind: 'checkpoint';
+    sessionId: string;
+    phase: string;
+    snapshotPath: string;
+    verified: boolean;
+    verificationTime?: string;
+}
+/**
+ * Evaluation result properties
+ */
+export interface EvalResultProperties {
+    kind: 'eval_result';
+    evalType: 'capability' | 'regression' | 'human';
+    passAt1?: number;
+    passAt3?: number;
+    consecutiveAt3?: number;
+    testsPassed: number;
+    testsFailed: number;
+    notes?: string;
+}
+/**
+ * Learned pattern properties
+ */
+export interface LearnedPatternProperties {
+    kind: 'learned_pattern';
+    category: string;
+    problem: string;
+    solution: string;
+    confidence: number;
+    usageCount: number;
+    sourceSession?: string;
+}
+/**
+ * Skill context for queries
+ */
+export interface SkillQueryContext {
+    /** Current skill being executed */
+    currentSkill?: string;
+    /** Current session ID */
+    sessionId?: string;
+    /** Task keywords */
+    taskKeywords?: string[];
+    /** File paths being worked on */
+    filePaths?: string[];
+    /** Error context if any */
+    errorContext?: string;
+    /** Max results to return */
+    maxResults?: number;
+}
+/**
+ * Context query result
+ */
+export interface ContextQueryResult {
+    /** Relevant entities */
+    entities: SkillEntity[];
+    /** Relevance scores */
+    scores: Map<string, number>;
+    /** Query source (where the context came from) */
+    querySource: 'session' | 'pattern' | 'eval' | 'related';
+}
+/**
+ * Configuration for Skill-Knowledge Bridge
+ */
+export interface SkillKnowledgeBridgeConfig {
+    /** Base path for knowledge store */
+    basePath: string;
+    /** Auto-save on store operations */
+    autoSave: boolean;
+    /** Maximum context entities to return */
+    maxContextEntities: number;
+    /** Enable semantic search (if embedding service available) */
+    enableSemanticSearch: boolean;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_SKILL_KNOWLEDGE_BRIDGE_CONFIG: SkillKnowledgeBridgeConfig;
+/**
+ * Interface for Skill-Knowledge Bridge
+ */
+export interface SkillKnowledgeBridge {
+    /**
+     * Store a skill entity in the knowledge graph
+     */
+    storeSkillEntity(entity: SkillEntity): Promise<void>;
+    /**
+     * Get a skill entity by ID
+     */
+    getSkillEntity(id: string): Promise<SkillEntity | undefined>;
+    /**
+     * Delete a skill entity
+     */
+    deleteSkillEntity(id: string): Promise<boolean>;
+    /**
+     * Add relation between skill entities
+     */
+    addSkillRelation(sourceId: string, targetId: string, type: SkillRelationType, properties?: Record<string, unknown>): Promise<void>;
+    /**
+     * Query context relevant to current skill execution
+     */
+    querySkillContext(context: SkillQueryContext): Promise<ContextQueryResult>;
+    /**
+     * Record session start
+     */
+    startSession(taskDescription?: string): Promise<string>;
+    /**
+     * Record session end
+     */
+    endSession(sessionId: string, status: SessionProperties['status'], skillsUsed: string[]): Promise<void>;
+    /**
+     * Record checkpoint
+     */
+    recordCheckpoint(sessionId: string, phase: string, snapshotPath: string): Promise<string>;
+    /**
+     * Record evaluation result
+     */
+    recordEvalResult(sessionId: string, evalType: EvalResultProperties['evalType'], results: Omit<EvalResultProperties, 'kind' | 'evalType'>): Promise<string>;
+    /**
+     * Get session history
+     */
+    getSessionHistory(limit?: number): Promise<SkillEntity[]>;
+    /**
+     * Get related entities
+     */
+    getRelatedEntities(entityId: string, relationTypes?: SkillRelationType[], depth?: number): Promise<SkillEntity[]>;
+    /**
+     * Get statistics
+     */
+    getStatistics(): Promise<SkillKnowledgeStatistics>;
+}
+/**
+ * Statistics for skill knowledge
+ */
+export interface SkillKnowledgeStatistics {
+    /** Total entities */
+    totalEntities: number;
+    /** Entities by type */
+    byType: Record<SkillEntityType, number>;
+    /** Total sessions */
+    totalSessions: number;
+    /** Completed sessions */
+    completedSessions: number;
+    /** Failed sessions */
+    failedSessions: number;
+    /** Total checkpoints */
+    totalCheckpoints: number;
+    /** Total learned patterns */
+    totalLearnedPatterns: number;
+    /** Average session duration (ms) */
+    averageSessionDuration?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integration/types.d.ts.map

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

package/dist/integration/types.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Skill-Knowledge Bridge Types
+ * Integrates skills with Knowledge Graph
+ *
+ * @traceability TSK-INT-003, DES-v3.7.0 Section 9.4
+ */
+/**
+ * Default configuration
+ */
+export const DEFAULT_SKILL_KNOWLEDGE_BRIDGE_CONFIG = {
+    basePath: '~/.musubix/knowledge',
+    autoSave: true,
+    maxContextEntities: 20,
+    enableSemanticSearch: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/integration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integration/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmKH;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAA+B;IAC/E,QAAQ,EAAE,sBAAsB;IAChC,QAAQ,EAAE,IAAI;IACd,kBAAkB,EAAE,EAAE;IACtB,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@musubix/knowledge",
-  "version": "3.6.0",
+  "version": "3.7.3",
   "description": "Git-Native Knowledge Store for MUSUBIX - File-based knowledge graph management",
   "type": "module",
   "main": "dist/index.js",
@@ -14,13 +14,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit"
-  },
   "keywords": [
     "musubix",
     "knowledge-graph",
@@ -40,5 +33,12 @@
   "devDependencies": {
     "typescript": "^5.3.0",
     "vitest": "^4.0.16"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
   }
-}
+}