cognitive-core 0.1.2 → 0.2.0

package/references/skill-tree/examples/basic-usage.ts

@@ -3,24 +3,36 @@
  *
  * This example demonstrates:
  * - Creating a SkillBank
- * - Parsing Claude Code sessions
- * - Extracting skills (manual and automatic)
- * - Managing skill versions
+ * - Saving and managing skills
+ * - Version management
+ * - Serving layer with loadouts
+ * - Event handling
  */
 
 import {
   createSkillBank,
   type Skill,
-  type LLMProvider,
-  type Trajectory,
 } from '../src/index.js';
 
-// Example Claude Code session (simplified)
-const sampleSession = `{"type":"user","message":{"role":"user","content":"I'm getting a TypeScript error: Cannot find module './utils' when importing"}}
-{"type":"assistant","message":{"role":"assistant","content":"Let me investigate this import error. This is usually caused by missing file extensions in TypeScript with ES modules."}}
-{"type":"assistant","message":{"role":"assistant","content":"The issue is that TypeScript with ES modules requires explicit .js extensions in imports, even for .ts files."},"toolCalls":[{"name":"Edit","input":{"file_path":"src/index.ts","old_string":"import { helper } from './utils'","new_string":"import { helper } from './utils.js'"}}]}
-{"type":"result","toolUseId":"1","toolName":"Edit","result":"File edited successfully"}
-{"type":"assistant","message":{"role":"assistant","content":"I've fixed the import by adding the .js extension. This is required when using ES modules with TypeScript."}}`;
+// Helper to create a skill object
+function makeSkill(overrides: Partial<Skill> & { id: string; name: string }): Skill {
+  return {
+    version: '1.0.0',
+    description: '',
+    problem: '',
+    triggerConditions: [],
+    solution: '',
+    verification: '',
+    examples: [],
+    author: 'example',
+    tags: [],
+    createdAt: new Date(),
+    updatedAt: new Date(),
+    status: 'active',
+    metrics: { usageCount: 0, successRate: 0, feedbackScores: [] },
+    ...overrides,
+  };
+}
 
 async function main() {
   // ==========================================================================
@@ -29,50 +41,42 @@ async function main() {
   console.log('1. Creating SkillBank...');
 
   const skillBank = createSkillBank({
-    storage: {
-      type: 'filesystem',
-      basePath: './skills',
-      openSkillsCompatible: true,
-    },
+    storage: { basePath: './skills' },
   });
 
   await skillBank.initialize();
   console.log('   SkillBank initialized!\n');
 
   // ==========================================================================
-  // 2. Parse a Claude Code session
-  // ==========================================================================
-  console.log('2. Parsing session...');
-
-  const trajectory = await skillBank.parseSession(sampleSession);
-  console.log(`   Session ID: ${trajectory.sessionId}`);
-  console.log(`   Turns: ${trajectory.turns.length}`);
-  console.log(`   Agent: ${trajectory.metadata.agentType}\n`);
-
-  // ==========================================================================
-  // 3. Manual skill extraction
+  // 2. Save skills
   // ==========================================================================
-  console.log('3. Extracting skill manually...');
+  console.log('2. Saving skills...');
 
-  const extractionResult = await skillBank.extractManual(trajectory, {
-    suggestedName: 'typescript-esm-import-fix',
+  await skillBank.saveSkill(makeSkill({
+    id: 'typescript-esm-import-fix',
+    name: 'TypeScript ESM Import Fix',
     description: 'Fix TypeScript ES module import errors by adding .js extension',
+    problem: 'TypeScript with ES modules requires explicit .js extensions in imports',
+    solution: 'Add .js extension to all relative imports, even for .ts files.',
+    verification: 'Run tsc --noEmit to verify no import errors',
     tags: ['typescript', 'esm', 'imports'],
-  });
+  }));
+
+  await skillBank.saveSkill(makeSkill({
+    id: 'git-rebase-conflict',
+    name: 'Git Rebase Conflict Resolution',
+    description: 'Resolve conflicts during git rebase',
+    problem: 'Merge conflicts during rebase',
+    solution: 'Fix conflicts file by file, then git add and git rebase --continue.',
+    tags: ['git', 'rebase'],
+  }));
 
-  if (extractionResult.success && extractionResult.skill) {
-    console.log(`   Extracted: ${extractionResult.skill.name}`);
-    console.log(`   Confidence: ${extractionResult.confidence}`);
-    console.log(`   Version: ${extractionResult.skill.version}`);
-  } else {
-    console.log(`   Extraction failed: ${extractionResult.failureReason}`);
-  }
-  console.log();
+  console.log('   Saved 2 skills\n');
 
   // ==========================================================================
-  // 4. List and search skills
+  // 3. List and search skills
   // ==========================================================================
-  console.log('4. Listing skills...');
+  console.log('3. Listing skills...');
 
   const allSkills = await skillBank.listSkills();
   console.log(`   Total skills: ${allSkills.length}`);
@@ -81,110 +85,80 @@ async function main() {
   console.log(`   TypeScript skills: ${tsSkills.length}\n`);
 
   // ==========================================================================
-  // 5. Version management
+  // 4. Version management
   // ==========================================================================
-  if (extractionResult.skill) {
-    console.log('5. Creating new version...');
+  console.log('4. Creating new version...');
 
-    const updatedSkill = await skillBank.createVersion(
-      extractionResult.skill.id,
-      {
-        solution: extractionResult.skill.solution + '\n\nAlternatively, configure tsconfig.json with "moduleResolution": "bundler".',
-        notes: 'Updated with alternative solution using bundler resolution.',
-      },
-      {
-        bumpType: 'minor',
-        changelog: 'Added alternative solution using bundler module resolution',
-      }
-    );
+  const updatedSkill = await skillBank.createVersion(
+    'typescript-esm-import-fix',
+    {
+      solution: 'Add .js extension to relative imports.\n\nAlternatively, configure tsconfig.json with "moduleResolution": "bundler".',
+    },
+    {
+      bumpType: 'minor',
+      changelog: 'Added alternative solution using bundler module resolution',
+    }
+  );
 
-    console.log(`   New version: ${updatedSkill.version}`);
-    console.log(`   Parent version: ${updatedSkill.parentVersion}`);
+  console.log(`   New version: ${updatedSkill.version}`);
+  console.log(`   Parent version: ${updatedSkill.parentVersion}`);
 
-    // Get version history
-    const history = await skillBank.getVersionHistory(extractionResult.skill.id);
-    console.log(`   Version history: ${history.map((v) => v.version).join(', ')}\n`);
-  }
+  const history = await skillBank.getVersionHistory('typescript-esm-import-fix');
+  console.log(`   Version history: ${history.map((v) => v.version).join(', ')}\n`);
 
   // ==========================================================================
-  // 6. Fork a skill
+  // 5. Fork a skill
   // ==========================================================================
-  if (extractionResult.skill) {
-    console.log('6. Forking skill for React projects...');
+  console.log('5. Forking skill for React projects...');
 
-    const forkedSkill = await skillBank.forkSkill(extractionResult.skill.id, {
-      newId: 'react-typescript-esm-import-fix',
-      newName: 'React TypeScript ESM Import Fix',
-      reason: 'Specialized version for React/Next.js projects',
-    });
+  const forkedSkill = await skillBank.forkSkill('typescript-esm-import-fix', {
+    newId: 'react-typescript-esm-import-fix',
+    newName: 'React TypeScript ESM Import Fix',
+    reason: 'Specialized version for React/Next.js projects',
+  });
 
-    console.log(`   Forked: ${forkedSkill.name}`);
-    console.log(`   Derived from: ${forkedSkill.derivedFrom?.join(', ')}\n`);
-  }
+  console.log(`   Forked: ${forkedSkill.name}`);
+  console.log(`   Derived from: ${forkedSkill.derivedFrom?.join(', ')}\n`);
 
   // ==========================================================================
-  // 7. Get statistics
+  // 6. Serving layer
   // ==========================================================================
-  console.log('7. Skill bank statistics...');
+  console.log('6. Creating serving layer...');
 
-  const stats = await skillBank.getStats();
-  console.log(`   Total skills: ${stats.totalSkills}`);
-  console.log(`   Active: ${stats.byStatus.active}`);
-  console.log(`   Draft: ${stats.byStatus.draft}`);
-  console.log(`   Tags: ${Object.keys(stats.byTag).join(', ')}\n`);
+  const { server } = await skillBank.createServingLayer({
+    maxExpanded: 5,
+  });
+
+  await server.setLoadoutForTask('Fix TypeScript import error in ESM project');
+  const view = server.agentListLoadout();
+  console.log(`   Loadout skills: ${view.available.length}`);
+  console.log(`   System prompt length: ${server.renderSystemPrompt().length} chars\n`);
 
   // ==========================================================================
-  // 8. Event handling
+  // 7. Event handling
   // ==========================================================================
-  console.log('8. Setting up event handlers...');
+  console.log('7. Setting up event handlers...');
 
   const unsubscribe = skillBank.on((event) => {
     console.log(`   Event: ${event.type}`);
   });
 
-  // Trigger some events
-  if (extractionResult.skill) {
-    await skillBank.deprecateSkill(extractionResult.skill.id);
-  }
-
-  // Cleanup
+  await skillBank.deprecateSkill('git-rebase-conflict');
   unsubscribe();
-  console.log('\nDone!');
-}
 
-// ==========================================================================
-// Example: Custom LLM Provider for automatic extraction
-// ==========================================================================
-function createMockLLMProvider(): LLMProvider {
-  return {
-    name: 'mock-llm',
-
-    async complete(prompt: string): Promise<string> {
-      // In a real implementation, this would call an LLM API
-      return JSON.stringify({
-        candidates: [
-          {
-            name: 'extracted-skill',
-            description: 'Auto-extracted skill',
-            problem: 'Sample problem',
-            solution: 'Sample solution',
-            triggerConditions: [{ type: 'error', value: 'sample error' }],
-            verification: 'Verify it works',
-            turnRange: [0, 3],
-            confidence: 0.8,
-            reasoning: 'High confidence extraction',
-          },
-        ],
-      });
-    },
+  // ==========================================================================
+  // 8. Statistics
+  // ==========================================================================
+  console.log('\n8. Skill bank statistics...');
 
-    async completeStructured<T>(prompt: string, schema: object): Promise<T> {
-      // In a real implementation, this would use structured output
-      const response = await this.complete(prompt);
-      return JSON.parse(response) as T;
-    },
-  };
+  const stats = await skillBank.getStats();
+  console.log(`   Total skills: ${stats.totalSkills}`);
+  console.log(`   Active: ${stats.byStatus.active}`);
+  console.log(`   Deprecated: ${stats.byStatus.deprecated}`);
+  console.log(`   Tags: ${Object.keys(stats.byTag).join(', ')}`);
+
+  await skillBank.shutdown();
+  console.log('\nDone!');
 }
 
-// Run the example
 main().catch(console.error);