@skillkit/cli 1.12.0 → 1.13.0

package/dist/index.d.ts

@@ -483,6 +483,14 @@ declare class MemoryCommand extends Command {
      * Show memory configuration
      */
     private showConfig;
+    /**
+     * Sync learnings to CLAUDE.md
+     */
+    private syncClaudeMd;
+    /**
+     * Show memory index (progressive disclosure Layer 1)
+     */
+    private showIndex;
     /**
      * Format relevance/effectiveness score with color
      */

package/dist/index.js

@@ -5384,7 +5384,10 @@ import {
   initializeMemoryDirectory,
   getMemoryStatus,
   createMemoryCompressor,
-  createMemoryInjector
+  createMemoryInjector,
+  createClaudeMdUpdater,
+  syncGlobalClaudeMd,
+  createProgressiveDisclosureManager
 } from "@skillkit/core";
 var MemoryCommand = class extends Command26 {
   static paths = [["memory"], ["mem"]];
@@ -5395,17 +5398,19 @@ var MemoryCommand = class extends Command26 {
       captured from coding sessions across all AI agents.
 
       Subcommands:
-      - status:   Show current memory status
-      - search:   Search memories by query
-      - list:     List all learnings
-      - show:     Show a specific learning
-      - compress: Compress observations into learnings
-      - export:   Export a learning as a skill
-      - import:   Import memories from another project
-      - clear:    Clear session observations
-      - add:      Manually add a learning
-      - rate:     Rate a learning's effectiveness
-      - config:   Configure memory settings
+      - status:      Show current memory status
+      - search:      Search memories by query
+      - list:        List all learnings
+      - show:        Show a specific learning
+      - compress:    Compress observations into learnings
+      - export:      Export a learning as a skill
+      - import:      Import memories from another project
+      - clear:       Clear session observations
+      - add:         Manually add a learning
+      - rate:        Rate a learning's effectiveness
+      - sync-claude: Sync learnings to CLAUDE.md
+      - index:       Show memory index (progressive disclosure)
+      - config:      Configure memory settings
     `,
     examples: [
       ["Show memory status", "$0 memory status"],
@@ -5418,7 +5423,9 @@ var MemoryCommand = class extends Command26 {
       ["Export as skill", "$0 memory export <id> --name my-skill"],
       ["Clear session", "$0 memory clear"],
       ["Add manual learning", '$0 memory add --title "..." --content "..."'],
-      ["Rate effectiveness", "$0 memory rate <id> 85"]
+      ["Rate effectiveness", "$0 memory rate <id> 85"],
+      ["Sync to CLAUDE.md", "$0 memory sync-claude"],
+      ["Show memory index", "$0 memory index"]
     ]
   });
   // Subcommand (status, search, list, show, compress, export, import, clear, add, rate, config)
@@ -5500,9 +5507,13 @@ var MemoryCommand = class extends Command26 {
         return this.rateLearning();
       case "config":
         return this.showConfig();
+      case "sync-claude":
+        return this.syncClaudeMd();
+      case "index":
+        return this.showIndex();
       default:
         console.error(chalk18.red(`Unknown action: ${action}`));
-        console.log(chalk18.gray("Available actions: status, search, list, show, compress, export, import, clear, add, rate, config"));
+        console.log(chalk18.gray("Available actions: status, search, list, show, compress, export, import, clear, add, rate, sync-claude, index, config"));
         return 1;
     }
   }
@@ -5981,6 +5992,117 @@ ${learning.title}
     console.log();
     return 0;
   }
+  /**
+   * Sync learnings to CLAUDE.md
+   */
+  async syncClaudeMd() {
+    const projectPath = process.cwd();
+    if (this.global) {
+      if (this.dryRun) {
+        console.log(chalk18.gray("(Dry run - previewing global CLAUDE.md sync)\n"));
+      }
+      const result2 = this.dryRun ? { updated: false, path: "~/.claude/CLAUDE.md", learningsAdded: 0, learningSummaries: [], previousLearnings: 0 } : syncGlobalClaudeMd({ minEffectiveness: 60 });
+      if (this.dryRun) {
+        const globalStore = new LearningStore("global");
+        const learnings = globalStore.getAll().filter((l) => (l.effectiveness ?? 0) >= 60 || l.useCount >= 3).slice(0, 20);
+        console.log(chalk18.cyan(`Would add ${learnings.length} learnings to global CLAUDE.md`));
+        for (const l of learnings.slice(0, 5)) {
+          console.log(`  ${chalk18.gray("\u25CF")} ${l.title}`);
+        }
+        if (learnings.length > 5) {
+          console.log(chalk18.gray(`  ... and ${learnings.length - 5} more`));
+        }
+        return 0;
+      }
+      if (result2.updated) {
+        console.log(chalk18.green(`\u2713 Updated global CLAUDE.md with ${result2.learningsAdded} learnings`));
+        console.log(chalk18.gray(`  Path: ${result2.path}`));
+      } else {
+        console.log(chalk18.yellow("No learnings to sync to global CLAUDE.md"));
+      }
+      return 0;
+    }
+    const updater = createClaudeMdUpdater(projectPath);
+    if (this.dryRun) {
+      const preview = updater.preview({ minEffectiveness: 60 });
+      console.log(chalk18.gray("(Dry run preview)\n"));
+      if (!preview.wouldUpdate) {
+        console.log(chalk18.yellow("No learnings to sync to CLAUDE.md"));
+        return 0;
+      }
+      console.log(chalk18.cyan(`Would add ${preview.learnings.length} learnings to CLAUDE.md
+`));
+      for (const learning of preview.learnings.slice(0, 5)) {
+        console.log(`  ${chalk18.gray("\u25CF")} ${learning.title}`);
+      }
+      if (preview.learnings.length > 5) {
+        console.log(chalk18.gray(`  ... and ${preview.learnings.length - 5} more`));
+      }
+      console.log(chalk18.bold("\nFormatted section preview:"));
+      console.log(chalk18.gray("\u2500".repeat(50)));
+      console.log(preview.formattedSection.slice(0, 500));
+      if (preview.formattedSection.length > 500) {
+        console.log(chalk18.gray("..."));
+      }
+      return 0;
+    }
+    const result = updater.update({ minEffectiveness: 60 });
+    if (result.updated) {
+      console.log(chalk18.green(`\u2713 Updated CLAUDE.md with ${result.learningsAdded} learnings`));
+      console.log(chalk18.gray(`  Path: ${result.path}`));
+      if (this.verbose && result.learningSummaries.length > 0) {
+        console.log(chalk18.cyan("\nLearnings added:"));
+        for (const title of result.learningSummaries.slice(0, 10)) {
+          console.log(`  ${chalk18.gray("\u25CF")} ${title}`);
+        }
+      }
+    } else {
+      console.log(chalk18.yellow("No learnings to sync to CLAUDE.md"));
+    }
+    return 0;
+  }
+  /**
+   * Show memory index (progressive disclosure Layer 1)
+   */
+  async showIndex() {
+    const projectPath = process.cwd();
+    const manager = createProgressiveDisclosureManager(projectPath);
+    let maxResults = 50;
+    if (this.limit) {
+      const parsed = parseInt(this.limit, 10);
+      if (isNaN(parsed) || parsed <= 0) {
+        console.log(chalk18.red("Invalid --limit value. Must be a positive number."));
+        return 1;
+      }
+      maxResults = parsed;
+    }
+    const index = manager.getIndex({ includeGlobal: this.global, maxResults });
+    if (this.json) {
+      console.log(JSON.stringify(index, null, 2));
+      return 0;
+    }
+    console.log(chalk18.bold(`
+Memory Index (${index.length} entries)
+`));
+    if (index.length === 0) {
+      console.log(chalk18.gray("No learnings found."));
+      return 0;
+    }
+    const displayLimit = this.limit ? parseInt(this.limit, 10) : 20;
+    const displayed = index.slice(0, displayLimit);
+    for (const entry of displayed) {
+      const effectiveness = entry.effectiveness !== void 0 ? ` [${this.formatScore(entry.effectiveness)}%]` : "";
+      const scope = entry.scope === "global" ? chalk18.magenta("[G]") : chalk18.blue("[P]");
+      console.log(`${scope} ${chalk18.gray(entry.id.slice(0, 8))} ${entry.title}${chalk18.green(effectiveness)}`);
+      console.log(`   Tags: ${entry.tags.join(", ")} | Uses: ${entry.useCount}`);
+    }
+    if (index.length > displayLimit) {
+      console.log(chalk18.gray(`
+... and ${index.length - displayLimit} more (use --limit to show more)`));
+    }
+    console.log(chalk18.gray('\nUse "skillkit memory show <id>" to view full details'));
+    return 0;
+  }
   /**
    * Format relevance/effectiveness score with color
    */
@@ -140130,6 +140252,8 @@ var ServeCommand = class extends Command52 {
       console.log(colors.muted(`  GET  /trending        - Top skills`));
       console.log(colors.muted(`  GET  /categories      - Skill categories`));
       console.log(colors.muted(`  GET  /cache/stats     - Cache statistics`));
+      console.log(colors.muted(`  GET  /docs            - Interactive API docs`));
+      console.log(colors.muted(`  GET  /openapi.json    - OpenAPI specification`));
       console.log("");
       console.log(colors.muted("Press Ctrl+C to stop"));
       await new Promise(() => {