@claude-collective/cli 0.2.0 → 0.8.0

package/dist/commands/new/skill.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+import {
+  loadGlobalConfig
+} from "../../chunk-QESUUPOE.js";
+import {
+  LOCAL_SKILLS_PATH
+} from "../../chunk-A3J6IAXK.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "../../chunk-SYQ7R2JO.js";
+import "../../chunk-TOPAIL5W.js";
+import {
+  directoryExists,
+  writeFile
+} from "../../chunk-MMDXNZPF.js";
+import {
+  init_esm_shims
+} from "../../chunk-DHET7RCE.js";
+
+// src/cli-v2/commands/new/skill.ts
+init_esm_shims();
+import { Args, Flags } from "@oclif/core";
+import path from "path";
+var DEFAULT_AUTHOR = "@local";
+var DEFAULT_CATEGORY = "local";
+var KEBAB_CASE_PATTERN = /^[a-z][a-z0-9-]*$/;
+function validateSkillName(name) {
+  if (!name || name.trim() === "") {
+    return "Skill name is required";
+  }
+  if (!KEBAB_CASE_PATTERN.test(name)) {
+    return "Skill name must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)";
+  }
+  return null;
+}
+function toTitleCase(kebabCase) {
+  return kebabCase.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+function generateSkillMd(name, author) {
+  const titleName = toTitleCase(name);
+  const skillId = `${name} (${author})`;
+  return `---
+name: ${skillId}
+description: Brief description of this skill
+---
+
+# ${titleName}
+
+> **Quick Guide:** Add a brief summary of what this skill teaches.
+
+---
+
+<critical_requirements>
+
+## CRITICAL: Before Using This Skill
+
+**(Add critical requirements here)**
+
+</critical_requirements>
+
+---
+
+**When to use:**
+
+- Add use cases here
+
+**Key patterns covered:**
+
+- Add patterns here
+
+---
+
+<patterns>
+
+## Core Patterns
+
+### Pattern 1: Example Pattern
+
+Add your patterns here.
+
+</patterns>
+
+---
+
+<critical_reminders>
+
+## CRITICAL REMINDERS
+
+**(Repeat critical requirements here)**
+
+</critical_reminders>
+`;
+}
+function generateMetadataYaml(name, author, category) {
+  const titleName = toTitleCase(name);
+  return `# yaml-language-server: $schema=https://raw.githubusercontent.com/claude-collective/skills/main/schemas/metadata.schema.json
+category: ${category}
+category_exclusive: false
+author: "${author}"
+version: 1
+cli_name: ${titleName}
+cli_description: Brief description
+usage_guidance: Use when <guidance>.
+tags:
+  - local
+  - custom
+`;
+}
+var NewSkill = class _NewSkill extends BaseCommand {
+  static summary = "Create a new local skill with proper structure";
+  static description = "Create a new local skill scaffold with SKILL.md and metadata.yaml files";
+  static args = {
+    name: Args.string({
+      description: "Name of the skill to create (kebab-case)",
+      required: true
+    })
+  };
+  static flags = {
+    ...BaseCommand.baseFlags,
+    author: Flags.string({
+      char: "a",
+      description: "Author identifier (e.g., @myhandle)",
+      required: false
+    }),
+    category: Flags.string({
+      char: "c",
+      description: "Skill category",
+      default: DEFAULT_CATEGORY
+    }),
+    force: Flags.boolean({
+      char: "f",
+      description: "Overwrite existing skill directory",
+      default: false
+    })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_NewSkill);
+    const projectDir = process.cwd();
+    this.log("");
+    this.log("Create New Skill");
+    this.log("");
+    const validationError = validateSkillName(args.name);
+    if (validationError) {
+      this.error(validationError, { exit: EXIT_CODES.INVALID_ARGS });
+    }
+    let author = flags.author;
+    if (!author) {
+      const globalConfig = await loadGlobalConfig();
+      author = globalConfig?.author || DEFAULT_AUTHOR;
+    }
+    const category = flags.category;
+    const skillDir = path.join(projectDir, LOCAL_SKILLS_PATH, args.name);
+    if (await directoryExists(skillDir)) {
+      if (!flags.force) {
+        this.error(
+          `Skill directory already exists: ${skillDir}
+Use --force to overwrite.`,
+          { exit: EXIT_CODES.ERROR }
+        );
+      }
+      this.warn(`Overwriting existing skill at ${skillDir}`);
+    }
+    this.log(`Skill name: ${args.name}`);
+    this.log(`Author: ${author}`);
+    this.log(`Category: ${category}`);
+    this.log(`Directory: ${skillDir}`);
+    this.log("");
+    if (flags["dry-run"]) {
+      this.log("[DRY RUN] Would create skill files");
+      return;
+    }
+    this.log("Creating skill files...");
+    try {
+      const skillMdContent = generateSkillMd(args.name, author);
+      const metadataContent = generateMetadataYaml(args.name, author, category);
+      const skillMdPath = path.join(skillDir, "SKILL.md");
+      const metadataPath = path.join(skillDir, "metadata.yaml");
+      await writeFile(skillMdPath, skillMdContent);
+      await writeFile(metadataPath, metadataContent);
+      this.log("");
+      this.logSuccess(`Created SKILL.md at ${skillMdPath}`);
+      this.logSuccess(`Created metadata.yaml at ${metadataPath}`);
+      this.log("");
+      this.log(
+        "Skill created successfully! Run 'cc compile' to include it in your agents."
+      );
+      this.log("");
+    } catch (error) {
+      this.error(
+        error instanceof Error ? error.message : "Unknown error occurred",
+        { exit: EXIT_CODES.ERROR }
+      );
+    }
+  }
+};
+export {
+  NewSkill as default,
+  generateMetadataYaml,
+  generateSkillMd,
+  toTitleCase,
+  validateSkillName
+};
+//# sourceMappingURL=skill.js.map

package/dist/commands/new/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli-v2/commands/new/skill.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { loadGlobalConfig } from \"../../lib/config.js\";\nimport { writeFile, directoryExists } from \"../../utils/fs.js\";\nimport { LOCAL_SKILLS_PATH } from \"../../consts.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\n\nconst DEFAULT_AUTHOR = \"@local\";\nconst DEFAULT_CATEGORY = \"local\";\nconst KEBAB_CASE_PATTERN = /^[a-z][a-z0-9-]*$/;\n\n/**\n * Validates that a skill name follows kebab-case convention.\n * Must start with lowercase letter, followed by lowercase letters, numbers, or hyphens.\n */\nexport function validateSkillName(name: string): string | null {\n  if (!name || name.trim() === \"\") {\n    return \"Skill name is required\";\n  }\n\n  if (!KEBAB_CASE_PATTERN.test(name)) {\n    return \"Skill name must be kebab-case (lowercase letters, numbers, and hyphens, starting with a letter)\";\n  }\n\n  return null;\n}\n\n/**\n * Converts kebab-case to Title Case.\n * e.g., \"my-patterns\" -> \"My Patterns\"\n */\nexport function toTitleCase(kebabCase: string): string {\n  return kebabCase\n    .split(\"-\")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\n/**\n * Generates the SKILL.md content with frontmatter.\n */\nexport function generateSkillMd(name: string, author: string): string {\n  const titleName = toTitleCase(name);\n  const skillId = `${name} (${author})`;\n\n  return `---\nname: ${skillId}\ndescription: Brief description of this skill\n---\n\n# ${titleName}\n\n> **Quick Guide:** Add a brief summary of what this skill teaches.\n\n---\n\n<critical_requirements>\n\n## CRITICAL: Before Using This Skill\n\n**(Add critical requirements here)**\n\n</critical_requirements>\n\n---\n\n**When to use:**\n\n- Add use cases here\n\n**Key patterns covered:**\n\n- Add patterns here\n\n---\n\n<patterns>\n\n## Core Patterns\n\n### Pattern 1: Example Pattern\n\nAdd your patterns here.\n\n</patterns>\n\n---\n\n<critical_reminders>\n\n## CRITICAL REMINDERS\n\n**(Repeat critical requirements here)**\n\n</critical_reminders>\n`;\n}\n\n/**\n * Generates the metadata.yaml content.\n */\nexport function generateMetadataYaml(\n  name: string,\n  author: string,\n  category: string,\n): string {\n  const titleName = toTitleCase(name);\n\n  return `# yaml-language-server: $schema=https://raw.githubusercontent.com/claude-collective/skills/main/schemas/metadata.schema.json\ncategory: ${category}\ncategory_exclusive: false\nauthor: \"${author}\"\nversion: 1\ncli_name: ${titleName}\ncli_description: Brief description\nusage_guidance: Use when <guidance>.\ntags:\n  - local\n  - custom\n`;\n}\n\nexport default class NewSkill extends BaseCommand {\n  static summary = \"Create a new local skill with proper structure\";\n  static description =\n    \"Create a new local skill scaffold with SKILL.md and metadata.yaml files\";\n\n  static args = {\n    name: Args.string({\n      description: \"Name of the skill to create (kebab-case)\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    author: Flags.string({\n      char: \"a\",\n      description: \"Author identifier (e.g., @myhandle)\",\n      required: false,\n    }),\n    category: Flags.string({\n      char: \"c\",\n      description: \"Skill category\",\n      default: DEFAULT_CATEGORY,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing skill directory\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(NewSkill);\n    const projectDir = process.cwd();\n\n    this.log(\"\");\n    this.log(\"Create New Skill\");\n    this.log(\"\");\n\n    // Validate skill name\n    const validationError = validateSkillName(args.name);\n    if (validationError) {\n      this.error(validationError, { exit: EXIT_CODES.INVALID_ARGS });\n    }\n\n    // Determine author: flag > global config > default\n    let author = flags.author;\n    if (!author) {\n      const globalConfig = await loadGlobalConfig();\n      author = globalConfig?.author || DEFAULT_AUTHOR;\n    }\n\n    const category = flags.category;\n\n    // Determine skill directory path\n    const skillDir = path.join(projectDir, LOCAL_SKILLS_PATH, args.name);\n\n    // Check if directory already exists\n    if (await directoryExists(skillDir)) {\n      if (!flags.force) {\n        this.error(\n          `Skill directory already exists: ${skillDir}\\nUse --force to overwrite.`,\n          { exit: EXIT_CODES.ERROR },\n        );\n      }\n      this.warn(`Overwriting existing skill at ${skillDir}`);\n    }\n\n    this.log(`Skill name: ${args.name}`);\n    this.log(`Author: ${author}`);\n    this.log(`Category: ${category}`);\n    this.log(`Directory: ${skillDir}`);\n    this.log(\"\");\n\n    if (flags[\"dry-run\"]) {\n      this.log(\"[DRY RUN] Would create skill files\");\n      return;\n    }\n\n    this.log(\"Creating skill files...\");\n\n    try {\n      // Generate file contents\n      const skillMdContent = generateSkillMd(args.name, author);\n      const metadataContent = generateMetadataYaml(args.name, author, category);\n\n      // Write files (writeFile automatically creates parent directories)\n      const skillMdPath = path.join(skillDir, \"SKILL.md\");\n      const metadataPath = path.join(skillDir, \"metadata.yaml\");\n\n      await writeFile(skillMdPath, skillMdContent);\n      await writeFile(metadataPath, metadataContent);\n\n      this.log(\"\");\n      this.logSuccess(`Created SKILL.md at ${skillMdPath}`);\n      this.logSuccess(`Created metadata.yaml at ${metadataPath}`);\n      this.log(\"\");\n      this.log(\n        \"Skill created successfully! Run 'cc compile' to include it in your agents.\",\n      );\n      this.log(\"\");\n    } catch (error) {\n      this.error(\n        error instanceof Error ? error.message : \"Unknown error occurred\",\n        { exit: EXIT_CODES.ERROR },\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/outdated.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+import {
+  hashFile
+} from "../chunk-MJSFR562.js";
+import {
+  loadSkillsMatrixFromSource
+} from "../chunk-DKGL77IY.js";
+import "../chunk-QGGSLMO3.js";
+import "../chunk-NGBFJJ7Q.js";
+import "../chunk-QESUUPOE.js";
+import {
+  LOCAL_SKILLS_PATH
+} from "../chunk-A3J6IAXK.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "../chunk-SYQ7R2JO.js";
+import "../chunk-TOPAIL5W.js";
+import {
+  fileExists,
+  listDirectories,
+  readFile
+} from "../chunk-MMDXNZPF.js";
+import {
+  init_esm_shims
+} from "../chunk-DHET7RCE.js";
+
+// src/cli-v2/commands/outdated.ts
+init_esm_shims();
+import { Flags } from "@oclif/core";
+import { printTable } from "@oclif/table";
+import path from "path";
+import { parse as parseYaml } from "yaml";
+async function readForkedFromMetadata(skillDir) {
+  const metadataPath = path.join(skillDir, "metadata.yaml");
+  if (!await fileExists(metadataPath)) {
+    return null;
+  }
+  const content = await readFile(metadataPath);
+  const metadata = parseYaml(content);
+  return metadata.forked_from ?? null;
+}
+async function getLocalSkillsWithMetadata(projectDir) {
+  const localSkillsPath = path.join(projectDir, LOCAL_SKILLS_PATH);
+  const result = /* @__PURE__ */ new Map();
+  if (!await fileExists(localSkillsPath)) {
+    return result;
+  }
+  const skillDirs = await listDirectories(localSkillsPath);
+  for (const dirName of skillDirs) {
+    const skillDir = path.join(localSkillsPath, dirName);
+    const forkedFrom = await readForkedFromMetadata(skillDir);
+    const skillId = forkedFrom?.skill_id ?? dirName;
+    result.set(skillId, { dirName, forkedFrom });
+  }
+  return result;
+}
+async function computeSourceHash(sourcePath, skillPath) {
+  const skillMdPath = path.join(sourcePath, "src", skillPath, "SKILL.md");
+  if (!await fileExists(skillMdPath)) {
+    return null;
+  }
+  return hashFile(skillMdPath);
+}
+async function compareSkills(projectDir, sourcePath, sourceSkills) {
+  const results = [];
+  const localSkills = await getLocalSkillsWithMetadata(projectDir);
+  for (const [skillId, { forkedFrom }] of localSkills) {
+    if (!forkedFrom) {
+      results.push({
+        id: skillId,
+        localHash: null,
+        sourceHash: null,
+        status: "local-only"
+      });
+      continue;
+    }
+    const localHash = forkedFrom.content_hash;
+    const sourceSkill = sourceSkills[forkedFrom.skill_id];
+    if (!sourceSkill) {
+      results.push({
+        id: forkedFrom.skill_id,
+        localHash,
+        sourceHash: null,
+        status: "local-only"
+      });
+      continue;
+    }
+    const sourceHash = await computeSourceHash(sourcePath, sourceSkill.path);
+    if (sourceHash === null) {
+      results.push({
+        id: forkedFrom.skill_id,
+        localHash,
+        sourceHash: null,
+        status: "local-only"
+      });
+      continue;
+    }
+    const status = localHash === sourceHash ? "current" : "outdated";
+    results.push({
+      id: forkedFrom.skill_id,
+      localHash,
+      sourceHash,
+      status
+    });
+  }
+  results.sort((a, b) => a.id.localeCompare(b.id));
+  return results;
+}
+function calculateSummary(results) {
+  return {
+    outdated: results.filter((r) => r.status === "outdated").length,
+    current: results.filter((r) => r.status === "current").length,
+    localOnly: results.filter((r) => r.status === "local-only").length
+  };
+}
+function formatHash(hash, isLocal) {
+  if (hash === null) {
+    return isLocal ? "(local)" : "-";
+  }
+  return hash;
+}
+var Outdated = class _Outdated extends BaseCommand {
+  static summary = "Check which local skills are out of date compared to source";
+  static description = "Compare local skills against their source repository to identify outdated skills that need updating";
+  static flags = {
+    ...BaseCommand.baseFlags,
+    json: Flags.boolean({
+      description: "Output results as JSON",
+      default: false
+    })
+  };
+  async run() {
+    const { flags } = await this.parse(_Outdated);
+    const projectDir = process.cwd();
+    try {
+      const localSkillsPath = path.join(projectDir, LOCAL_SKILLS_PATH);
+      if (!await fileExists(localSkillsPath)) {
+        if (flags.json) {
+          this.log(
+            JSON.stringify({
+              skills: [],
+              summary: { outdated: 0, current: 0, localOnly: 0 }
+            })
+          );
+        } else {
+          this.warn("No local skills found. Run `cc init` or `cc edit` first.");
+        }
+        return;
+      }
+      if (!flags.json) {
+        this.log("Loading skills...");
+      }
+      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({
+        sourceFlag: flags.source,
+        projectDir
+      });
+      if (!flags.json) {
+        this.log(`Loaded from ${isLocal ? "local" : "remote"}: ${sourcePath}`);
+      }
+      const sourceSkills = {};
+      for (const [skillId, skill] of Object.entries(matrix.skills)) {
+        if (!skill.local) {
+          sourceSkills[skillId] = { path: skill.path };
+        }
+      }
+      const results = await compareSkills(projectDir, sourcePath, sourceSkills);
+      const summary = calculateSummary(results);
+      if (flags.json) {
+        this.log(
+          JSON.stringify(
+            {
+              skills: results.map((r) => ({
+                id: r.id,
+                localHash: r.localHash,
+                sourceHash: r.sourceHash,
+                status: r.status
+              })),
+              summary: {
+                outdated: summary.outdated,
+                current: summary.current,
+                localOnly: summary.localOnly
+              }
+            },
+            null,
+            2
+          )
+        );
+      } else {
+        this.log("");
+        if (results.length === 0) {
+          this.logInfo("No local skills found to compare.");
+        } else {
+          printTable({
+            data: results.map((result) => ({
+              skill: result.id,
+              localHash: formatHash(result.localHash, true),
+              sourceHash: formatHash(result.sourceHash, false),
+              status: result.status
+            })),
+            columns: [
+              { key: "skill", name: "Skill" },
+              { key: "localHash", name: "Local Hash" },
+              { key: "sourceHash", name: "Source Hash" },
+              { key: "status", name: "Status" }
+            ],
+            headerOptions: { bold: true }
+          });
+          this.log("");
+          const parts = [];
+          if (summary.outdated > 0) {
+            parts.push(`${summary.outdated} outdated`);
+          }
+          if (summary.current > 0) {
+            parts.push(`${summary.current} current`);
+          }
+          if (summary.localOnly > 0) {
+            parts.push(`${summary.localOnly} local-only`);
+          }
+          this.log(`Summary: ${parts.join(", ")}`);
+        }
+        this.log("");
+      }
+      if (summary.outdated > 0) {
+        this.error("Some skills are outdated", { exit: EXIT_CODES.ERROR });
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (flags.json) {
+        this.error(JSON.stringify({ error: message }), {
+          exit: EXIT_CODES.ERROR
+        });
+      } else {
+        this.error(`Error: ${message}`, { exit: EXIT_CODES.ERROR });
+      }
+    }
+  }
+};
+export {
+  Outdated as default
+};
+//# sourceMappingURL=outdated.js.map

package/dist/commands/outdated.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli-v2/commands/outdated.ts"],"sourcesContent":["import { Flags } from \"@oclif/core\";\nimport { printTable } from \"@oclif/table\";\nimport path from \"path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSkillsMatrixFromSource } from \"../lib/source-loader.js\";\nimport { hashFile } from \"../lib/versioning.js\";\nimport { fileExists, readFile, listDirectories } from \"../utils/fs.js\";\nimport { LOCAL_SKILLS_PATH } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\n\n/**\n * Status values for skill comparison\n */\ntype SkillStatus = \"current\" | \"outdated\" | \"local-only\";\n\n/**\n * Result of comparing a local skill to its source\n */\ninterface SkillComparisonResult {\n  id: string;\n  localHash: string | null;\n  sourceHash: string | null;\n  status: SkillStatus;\n}\n\n/**\n * Summary counts for the comparison results\n */\ninterface ComparisonSummary {\n  outdated: number;\n  current: number;\n  localOnly: number;\n}\n\n/**\n * ForkedFrom metadata stored in local skill's metadata.yaml\n */\ninterface ForkedFromMetadata {\n  skill_id: string;\n  content_hash: string;\n  date: string;\n}\n\n/**\n * Local skill metadata structure\n */\ninterface LocalSkillMetadata {\n  forked_from?: ForkedFromMetadata;\n  [key: string]: unknown;\n}\n\n/**\n * Read forked_from metadata from a local skill's metadata.yaml\n */\nasync function readForkedFromMetadata(\n  skillDir: string,\n): Promise<ForkedFromMetadata | null> {\n  const metadataPath = path.join(skillDir, \"metadata.yaml\");\n\n  if (!(await fileExists(metadataPath))) {\n    return null;\n  }\n\n  const content = await readFile(metadataPath);\n  const metadata = parseYaml(content) as LocalSkillMetadata;\n\n  return metadata.forked_from ?? null;\n}\n\n/**\n * Get local skills with their forked_from metadata\n */\nasync function getLocalSkillsWithMetadata(\n  projectDir: string,\n): Promise<\n  Map<string, { dirName: string; forkedFrom: ForkedFromMetadata | null }>\n> {\n  const localSkillsPath = path.join(projectDir, LOCAL_SKILLS_PATH);\n  const result = new Map<\n    string,\n    { dirName: string; forkedFrom: ForkedFromMetadata | null }\n  >();\n\n  if (!(await fileExists(localSkillsPath))) {\n    return result;\n  }\n\n  const skillDirs = await listDirectories(localSkillsPath);\n\n  for (const dirName of skillDirs) {\n    const skillDir = path.join(localSkillsPath, dirName);\n    const forkedFrom = await readForkedFromMetadata(skillDir);\n\n    // Use the skill_id from forked_from if available, otherwise use directory name\n    const skillId = forkedFrom?.skill_id ?? dirName;\n\n    result.set(skillId, { dirName, forkedFrom });\n  }\n\n  return result;\n}\n\n/**\n * Compute source hash for a skill's SKILL.md file\n */\nasync function computeSourceHash(\n  sourcePath: string,\n  skillPath: string,\n): Promise<string | null> {\n  const skillMdPath = path.join(sourcePath, \"src\", skillPath, \"SKILL.md\");\n\n  if (!(await fileExists(skillMdPath))) {\n    return null;\n  }\n\n  return hashFile(skillMdPath);\n}\n\n/**\n * Compare local skills against source and determine status\n */\nasync function compareSkills(\n  projectDir: string,\n  sourcePath: string,\n  sourceSkills: Record<string, { path: string }>,\n): Promise<SkillComparisonResult[]> {\n  const results: SkillComparisonResult[] = [];\n  const localSkills = await getLocalSkillsWithMetadata(projectDir);\n\n  // Process local skills\n  for (const [skillId, { forkedFrom }] of localSkills) {\n    if (!forkedFrom) {\n      // Local-only skill (no forked_from metadata)\n      results.push({\n        id: skillId,\n        localHash: null,\n        sourceHash: null,\n        status: \"local-only\",\n      });\n      continue;\n    }\n\n    const localHash = forkedFrom.content_hash;\n    const sourceSkill = sourceSkills[forkedFrom.skill_id];\n\n    if (!sourceSkill) {\n      // Skill was forked from a source that no longer exists\n      results.push({\n        id: forkedFrom.skill_id,\n        localHash,\n        sourceHash: null,\n        status: \"local-only\",\n      });\n      continue;\n    }\n\n    const sourceHash = await computeSourceHash(sourcePath, sourceSkill.path);\n\n    if (sourceHash === null) {\n      // Source skill's SKILL.md not found\n      results.push({\n        id: forkedFrom.skill_id,\n        localHash,\n        sourceHash: null,\n        status: \"local-only\",\n      });\n      continue;\n    }\n\n    const status: SkillStatus =\n      localHash === sourceHash ? \"current\" : \"outdated\";\n\n    results.push({\n      id: forkedFrom.skill_id,\n      localHash,\n      sourceHash,\n      status,\n    });\n  }\n\n  // Sort results by skill ID\n  results.sort((a, b) => a.id.localeCompare(b.id));\n\n  return results;\n}\n\n/**\n * Calculate summary counts from comparison results\n */\nfunction calculateSummary(results: SkillComparisonResult[]): ComparisonSummary {\n  return {\n    outdated: results.filter((r) => r.status === \"outdated\").length,\n    current: results.filter((r) => r.status === \"current\").length,\n    localOnly: results.filter((r) => r.status === \"local-only\").length,\n  };\n}\n\n/**\n * Format hash for display\n */\nfunction formatHash(hash: string | null, isLocal: boolean): string {\n  if (hash === null) {\n    return isLocal ? \"(local)\" : \"-\";\n  }\n  return hash;\n}\n\nexport default class Outdated extends BaseCommand {\n  static summary =\n    \"Check which local skills are out of date compared to source\";\n  static description =\n    \"Compare local skills against their source repository to identify outdated skills that need updating\";\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    json: Flags.boolean({\n      description: \"Output results as JSON\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(Outdated);\n    const projectDir = process.cwd();\n\n    try {\n      // Check if local skills directory exists\n      const localSkillsPath = path.join(projectDir, LOCAL_SKILLS_PATH);\n      if (!(await fileExists(localSkillsPath))) {\n        if (flags.json) {\n          this.log(\n            JSON.stringify({\n              skills: [],\n              summary: { outdated: 0, current: 0, localOnly: 0 },\n            }),\n          );\n        } else {\n          this.warn(\"No local skills found. Run `cc init` or `cc edit` first.\");\n        }\n        return;\n      }\n\n      if (!flags.json) {\n        this.log(\"Loading skills...\");\n      }\n\n      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({\n        sourceFlag: flags.source,\n        projectDir,\n      });\n\n      if (!flags.json) {\n        this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n      }\n\n      // Build source skills map for lookup\n      const sourceSkills: Record<string, { path: string }> = {};\n      for (const [skillId, skill] of Object.entries(matrix.skills)) {\n        if (!skill.local) {\n          sourceSkills[skillId] = { path: skill.path };\n        }\n      }\n\n      // Compare local skills against source\n      const results = await compareSkills(projectDir, sourcePath, sourceSkills);\n      const summary = calculateSummary(results);\n\n      // Output results\n      if (flags.json) {\n        this.log(\n          JSON.stringify(\n            {\n              skills: results.map((r) => ({\n                id: r.id,\n                localHash: r.localHash,\n                sourceHash: r.sourceHash,\n                status: r.status,\n              })),\n              summary: {\n                outdated: summary.outdated,\n                current: summary.current,\n                localOnly: summary.localOnly,\n              },\n            },\n            null,\n            2,\n          ),\n        );\n      } else {\n        this.log(\"\");\n        if (results.length === 0) {\n          this.logInfo(\"No local skills found to compare.\");\n        } else {\n          // Use @oclif/table for table output\n          printTable({\n            data: results.map((result) => ({\n              skill: result.id,\n              localHash: formatHash(result.localHash, true),\n              sourceHash: formatHash(result.sourceHash, false),\n              status: result.status,\n            })),\n            columns: [\n              { key: \"skill\", name: \"Skill\" },\n              { key: \"localHash\", name: \"Local Hash\" },\n              { key: \"sourceHash\", name: \"Source Hash\" },\n              { key: \"status\", name: \"Status\" },\n            ],\n            headerOptions: { bold: true },\n          });\n\n          this.log(\"\");\n\n          // Display summary\n          const parts: string[] = [];\n          if (summary.outdated > 0) {\n            parts.push(`${summary.outdated} outdated`);\n          }\n          if (summary.current > 0) {\n            parts.push(`${summary.current} current`);\n          }\n          if (summary.localOnly > 0) {\n            parts.push(`${summary.localOnly} local-only`);\n          }\n          this.log(`Summary: ${parts.join(\", \")}`);\n        }\n        this.log(\"\");\n      }\n\n      // Exit with appropriate code if there are outdated skills\n      if (summary.outdated > 0) {\n        this.error(\"Some skills are outdated\", { exit: EXIT_CODES.ERROR });\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      if (flags.json) {\n        this.error(JSON.stringify({ error: message }), {\n          exit: EXIT_CODES.ERROR,\n        });\n      } else {\n        this.error(`Error: ${message}`, { exit: EXIT_CODES.ERROR });\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/search.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import {
+  loadSkillsMatrixFromSource
+} from "../chunk-DKGL77IY.js";
+import "../chunk-QGGSLMO3.js";
+import "../chunk-NGBFJJ7Q.js";
+import "../chunk-QESUUPOE.js";
+import "../chunk-A3J6IAXK.js";
+import {
+  BaseCommand
+} from "../chunk-SYQ7R2JO.js";
+import "../chunk-TOPAIL5W.js";
+import "../chunk-MMDXNZPF.js";
+import {
+  init_esm_shims
+} from "../chunk-DHET7RCE.js";
+
+// src/cli-v2/commands/search.ts
+init_esm_shims();
+import { Args, Flags } from "@oclif/core";
+import { printTable } from "@oclif/table";
+var MAX_DESCRIPTION_WIDTH = 50;
+function truncate(str, maxLength) {
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength - 3) + "...";
+}
+function matchesQuery(skill, query) {
+  const lowerQuery = query.toLowerCase();
+  if (skill.name.toLowerCase().includes(lowerQuery)) return true;
+  if (skill.id.toLowerCase().includes(lowerQuery)) return true;
+  if (skill.alias?.toLowerCase().includes(lowerQuery)) return true;
+  if (skill.description.toLowerCase().includes(lowerQuery)) return true;
+  if (skill.category.toLowerCase().includes(lowerQuery)) return true;
+  if (skill.tags.some((tag) => tag.toLowerCase().includes(lowerQuery))) {
+    return true;
+  }
+  return false;
+}
+function matchesCategory(skill, category) {
+  const lowerCategory = category.toLowerCase();
+  return skill.category.toLowerCase().includes(lowerCategory);
+}
+var Search = class _Search extends BaseCommand {
+  static summary = "Search available skills";
+  static description = "Search skills by name, description, category, or tags and display results in a table";
+  static args = {
+    query: Args.string({
+      description: "Search query (matches name, description, category, tags)",
+      required: true
+    })
+  };
+  static flags = {
+    ...BaseCommand.baseFlags,
+    category: Flags.string({
+      char: "c",
+      description: "Filter by category",
+      required: false
+    })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_Search);
+    try {
+      this.log("Loading skills...");
+      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({
+        sourceFlag: flags.source
+      });
+      this.log(`Loaded from ${isLocal ? "local" : "remote"}: ${sourcePath}`);
+      const allSkills = Object.values(matrix.skills);
+      let results = allSkills.filter(
+        (skill) => matchesQuery(skill, args.query)
+      );
+      if (flags.category) {
+        results = results.filter(
+          (skill) => matchesCategory(skill, flags.category)
+        );
+      }
+      results.sort((a, b) => a.name.localeCompare(b.name));
+      this.log("");
+      if (results.length === 0) {
+        this.warn(`No skills found matching "${args.query}"`);
+        if (flags.category) {
+          this.logInfo(`Category filter: ${flags.category}`);
+        }
+      } else {
+        this.logInfo(
+          `Found ${results.length} skill${results.length === 1 ? "" : "s"} matching "${args.query}"`
+        );
+        if (flags.category) {
+          this.logInfo(`Category filter: ${flags.category}`);
+        }
+        this.log("");
+        printTable({
+          data: results.map((skill) => ({
+            id: skill.alias || skill.id,
+            category: skill.category,
+            description: truncate(skill.description, MAX_DESCRIPTION_WIDTH)
+          })),
+          columns: [
+            { key: "id", name: "ID" },
+            { key: "category", name: "Category" },
+            { key: "description", name: "Description" }
+          ],
+          headerOptions: { bold: true }
+        });
+      }
+      this.log("");
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+};
+export {
+  Search as default
+};
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli-v2/commands/search.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport { printTable } from \"@oclif/table\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSkillsMatrixFromSource } from \"../lib/source-loader.js\";\nimport type { ResolvedSkill } from \"../types-matrix.js\";\n\n/**\n * Maximum description width for table output\n */\nconst MAX_DESCRIPTION_WIDTH = 50;\n\n/**\n * Truncate a string to a maximum length with ellipsis\n */\nfunction truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  return str.slice(0, maxLength - 3) + \"...\";\n}\n\n/**\n * Check if a skill matches the search query (case-insensitive)\n */\nfunction matchesQuery(skill: ResolvedSkill, query: string): boolean {\n  const lowerQuery = query.toLowerCase();\n\n  // Match against name\n  if (skill.name.toLowerCase().includes(lowerQuery)) return true;\n\n  // Match against ID\n  if (skill.id.toLowerCase().includes(lowerQuery)) return true;\n\n  // Match against alias\n  if (skill.alias?.toLowerCase().includes(lowerQuery)) return true;\n\n  // Match against description\n  if (skill.description.toLowerCase().includes(lowerQuery)) return true;\n\n  // Match against category\n  if (skill.category.toLowerCase().includes(lowerQuery)) return true;\n\n  // Match against tags\n  if (skill.tags.some((tag) => tag.toLowerCase().includes(lowerQuery))) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Check if a skill matches the category filter (case-insensitive)\n */\nfunction matchesCategory(skill: ResolvedSkill, category: string): boolean {\n  const lowerCategory = category.toLowerCase();\n  return skill.category.toLowerCase().includes(lowerCategory);\n}\n\nexport default class Search extends BaseCommand {\n  static summary = \"Search available skills\";\n  static description =\n    \"Search skills by name, description, category, or tags and display results in a table\";\n\n  static args = {\n    query: Args.string({\n      description: \"Search query (matches name, description, category, tags)\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    category: Flags.string({\n      char: \"c\",\n      description: \"Filter by category\",\n      required: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Search);\n\n    try {\n      this.log(\"Loading skills...\");\n\n      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({\n        sourceFlag: flags.source,\n      });\n\n      this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n\n      // Get all skills as array\n      const allSkills = Object.values(matrix.skills);\n\n      // Filter by query\n      let results = allSkills.filter((skill) =>\n        matchesQuery(skill, args.query),\n      );\n\n      // Apply category filter if provided\n      if (flags.category) {\n        results = results.filter((skill) =>\n          matchesCategory(skill, flags.category as string),\n        );\n      }\n\n      // Sort results by name\n      results.sort((a, b) => a.name.localeCompare(b.name));\n\n      // Display results\n      this.log(\"\");\n      if (results.length === 0) {\n        this.warn(`No skills found matching \"${args.query}\"`);\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n      } else {\n        this.logInfo(\n          `Found ${results.length} skill${results.length === 1 ? \"\" : \"s\"} matching \"${args.query}\"`,\n        );\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n        this.log(\"\");\n\n        // Use @oclif/table for table output\n        printTable({\n          data: results.map((skill) => ({\n            id: skill.alias || skill.id,\n            category: skill.category,\n            description: truncate(skill.description, MAX_DESCRIPTION_WIDTH),\n          })),\n          columns: [\n            { key: \"id\", name: \"ID\" },\n            { key: \"category\", name: \"Category\" },\n            { key: \"description\", name: \"Description\" },\n          ],\n          headerOptions: { bold: true },\n        });\n      }\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n"],"mappings":"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","names":[]}