@skillkit/cli 1.11.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
      */
@@ -1240,6 +1248,16 @@ declare class SkillMdCheckCommand extends Command {
     private scanDir;
 }
 
+declare class ServeCommand extends Command {
+    static paths: string[][];
+    static usage: clipanion.Usage;
+    port: string;
+    host: string;
+    corsOrigin: string;
+    cacheTtl: string;
+    execute(): Promise<number>;
+}
+
 declare const loadSkillMetadata: typeof loadSkillMetadata$1;
 declare const saveSkillMetadata: typeof saveSkillMetadata$1;
 declare function getSearchDirs(agentType?: AgentType): string[];
@@ -1247,4 +1265,4 @@ declare function getInstallDir(global?: boolean, agentType?: AgentType): string;
 declare function getAgentConfigPath(agentType?: AgentType): string;
 declare function initProject(agentType?: AgentType): Promise<void>;
 
-export { AICommand, AgentAvailableCommand, AgentCommand, AgentCreateCommand, AgentFromSkillCommand, AgentInstallCommand, AgentListCommand, AgentShowCommand, AgentSyncCommand, AgentTranslateCommand, AgentValidateCommand, AuditCommand, CICDCommand, CheckCommand, CommandAvailableCommand, CommandCmd, CommandInstallCommand, ContextCommand, CreateCommand, DisableCommand, EnableCommand, FindCommand, FixCommand, GuidelineCommand, GuidelineCreateCommand, GuidelineDisableCommand, GuidelineEnableCommand, GuidelineListCommand, GuidelineRemoveCommand, GuidelineShowCommand, HookCommand, HookTemplateApplyCommand, HookTemplateListCommand, HookTemplateShowCommand, InitCommand, InstallCommand, LearnCommand, ListCommand, ManifestAddCommand, ManifestCommand, ManifestGenerateCommand, ManifestInitCommand, ManifestInstallCommand, ManifestRemoveCommand, MarketplaceCommand, MemoryCommand, MeshCommand, MessageCommand, MethodologyCommand, PatternApproveCommand, PatternClusterCommand, PatternExportCommand, PatternFeedbackCommand, PatternImportCommand, PatternRejectCommand, PatternStatusCommand, PauseCommand, PlanCommand, PluginCommand, PrimerCommand, ProfileCommand, ProfileCreateCommand, ProfileListCommand, ProfileRemoveCommand, PublishCommand, PublishSubmitCommand, QuickCommand, ReadCommand, RecommendCommand, RemoveCommand, ResumeCommand, RunCommand, SessionCommand, SessionCompleteCommand, SessionInProgressCommand, SessionListCommand, SessionLoadCommand, SessionNoteCommand, SessionStartCommand, SessionStatusCommand, SettingsCommand, SkillMdCheckCommand, SkillMdInitCommand, SkillMdValidateCommand, StatusCommand, SyncCommand, TeamCommand, TestCommand, TranslateCommand, TreeCommand, UICommand, UpdateCommand, ValidateCommand, WorkflowCreateCommand, WorkflowListCommand, WorkflowPipelineCommand, WorkflowPipelineListCommand, WorkflowRunCommand, getAgentConfigPath, getInstallDir, getSearchDirs, initProject, loadSkillMetadata, saveSkillMetadata };
+export { AICommand, AgentAvailableCommand, AgentCommand, AgentCreateCommand, AgentFromSkillCommand, AgentInstallCommand, AgentListCommand, AgentShowCommand, AgentSyncCommand, AgentTranslateCommand, AgentValidateCommand, AuditCommand, CICDCommand, CheckCommand, CommandAvailableCommand, CommandCmd, CommandInstallCommand, ContextCommand, CreateCommand, DisableCommand, EnableCommand, FindCommand, FixCommand, GuidelineCommand, GuidelineCreateCommand, GuidelineDisableCommand, GuidelineEnableCommand, GuidelineListCommand, GuidelineRemoveCommand, GuidelineShowCommand, HookCommand, HookTemplateApplyCommand, HookTemplateListCommand, HookTemplateShowCommand, InitCommand, InstallCommand, LearnCommand, ListCommand, ManifestAddCommand, ManifestCommand, ManifestGenerateCommand, ManifestInitCommand, ManifestInstallCommand, ManifestRemoveCommand, MarketplaceCommand, MemoryCommand, MeshCommand, MessageCommand, MethodologyCommand, PatternApproveCommand, PatternClusterCommand, PatternExportCommand, PatternFeedbackCommand, PatternImportCommand, PatternRejectCommand, PatternStatusCommand, PauseCommand, PlanCommand, PluginCommand, PrimerCommand, ProfileCommand, ProfileCreateCommand, ProfileListCommand, ProfileRemoveCommand, PublishCommand, PublishSubmitCommand, QuickCommand, ReadCommand, RecommendCommand, RemoveCommand, ResumeCommand, RunCommand, ServeCommand, SessionCommand, SessionCompleteCommand, SessionInProgressCommand, SessionListCommand, SessionLoadCommand, SessionNoteCommand, SessionStartCommand, SessionStatusCommand, SettingsCommand, SkillMdCheckCommand, SkillMdInitCommand, SkillMdValidateCommand, StatusCommand, SyncCommand, TeamCommand, TestCommand, TranslateCommand, TreeCommand, UICommand, UpdateCommand, ValidateCommand, WorkflowCreateCommand, WorkflowListCommand, WorkflowPipelineCommand, WorkflowPipelineListCommand, WorkflowRunCommand, getAgentConfigPath, getInstallDir, getSearchDirs, initProject, loadSkillMetadata, saveSkillMetadata };

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
    */
@@ -140068,6 +140190,83 @@ var SkillMdCheckCommand = class extends Command51 {
   }
 };
 
+// src/commands/serve.ts
+init_onboarding();
+import { Command as Command52, Option as Option50 } from "clipanion";
+var ServeCommand = class extends Command52 {
+  static paths = [["serve"], ["server"]];
+  static usage = Command52.Usage({
+    description: "Start the SkillKit REST API server for skill discovery",
+    details: `
+      Launches a local HTTP server that exposes the SkillKit skill catalog
+      via a REST API. Useful for integrating with other tools, building
+      custom UIs, or enabling agent-native skill discovery.
+    `,
+    examples: [
+      ["Start server on default port", "$0 serve"],
+      ["Start on custom port", "$0 serve --port 8080"],
+      ["Start with custom CORS", '$0 serve --cors "http://localhost:3000"']
+    ]
+  });
+  port = Option50.String("--port,-p", "3737", {
+    description: "Port to listen on"
+  });
+  host = Option50.String("--host,-H", "0.0.0.0", {
+    description: "Host to bind to"
+  });
+  corsOrigin = Option50.String("--cors", "*", {
+    description: "CORS allowed origin"
+  });
+  cacheTtl = Option50.String("--cache-ttl", "86400000", {
+    description: "Cache TTL in milliseconds"
+  });
+  async execute() {
+    header("SkillKit API Server");
+    const skills = (skills_default.skills || []).map((skill) => ({
+      name: skill.name,
+      description: skill.description,
+      source: skill.source || "",
+      repo: skill.repo,
+      tags: skill.tags,
+      category: skill.category
+    }));
+    step(`Loading ${skills.length} skills from marketplace`);
+    const portNum = parseInt(this.port, 10) || 3737;
+    const cacheTtlMs = parseInt(this.cacheTtl, 10) || 864e5;
+    try {
+      const { startServer } = await import("@skillkit/api");
+      await startServer({
+        port: portNum,
+        host: this.host,
+        corsOrigin: this.corsOrigin,
+        cacheTtlMs,
+        skills
+      });
+      step(`Server running at ${colors.cyan(`http://${this.host}:${portNum}`)}`);
+      console.log("");
+      console.log(colors.muted("Endpoints:"));
+      console.log(colors.muted(`  GET  /health          - Server health check`));
+      console.log(colors.muted(`  GET  /search?q=...    - Search skills`));
+      console.log(colors.muted(`  POST /search          - Search with filters`));
+      console.log(colors.muted(`  GET  /skills/:o/:r/:id - Get specific skill`));
+      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(() => {
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(colors.error(`Failed to start server: ${message}`));
+      return 1;
+    }
+    return 0;
+  }
+};
+
 // src/index.ts
 init_helpers();
 export {
@@ -140143,6 +140342,7 @@ export {
   RemoveCommand,
   ResumeCommand,
   RunCommand,
+  ServeCommand,
   SessionCommand,
   SessionCompleteCommand,
   SessionInProgressCommand,