claudecode-omc 5.6.3 → 5.6.5

package/src/cli/skill-index.js

@@ -0,0 +1,209 @@
+/* eslint-disable no-console */
+const fs = require('fs');
+const fsp = require('fs/promises');
+const path = require('path');
+const os = require('os');
+const { getProjectRoot } = require('../config/paths');
+
+const INDEX_FILENAME = '_index.md';
+const MAX_DESCRIPTION_CHARS = 280;
+
+/**
+ * Parse YAML frontmatter from a SKILL.md, returning { name, description }.
+ *
+ * Handles:
+ *  - `key: value` single-line
+ *  - `key: >-` or `key: |` folded/literal block scalars (collects indented
+ *    continuation lines, joined with spaces)
+ *  - quoted values: stripped of surrounding quotes
+ *
+ * Returns null if frontmatter is missing or name field is absent.
+ */
+function parseFrontmatter(skillFile) {
+  if (!fs.existsSync(skillFile)) return null;
+
+  const content = fs.readFileSync(skillFile, 'utf8');
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return null;
+
+  const lines = match[1].split('\n');
+  const meta = {};
+  let currentKey = null;
+  let blockMode = false; // when value is `>-` or `|`
+
+  for (const raw of lines) {
+    if (!raw.trim()) continue;
+
+    // top-level key: detect by leading non-whitespace + colon
+    const keyMatch = raw.match(/^([a-zA-Z_-][\w-]*)\s*:\s*(.*)$/);
+    const isIndented = /^\s/.test(raw);
+
+    if (keyMatch && !isIndented) {
+      currentKey = keyMatch[1];
+      const valueRaw = keyMatch[2].trim();
+      if (valueRaw === '>-' || valueRaw === '>' || valueRaw === '|' || valueRaw === '|-') {
+        meta[currentKey] = '';
+        blockMode = true;
+      } else {
+        meta[currentKey] = stripQuotes(valueRaw);
+        blockMode = false;
+      }
+    } else if (currentKey && (blockMode || isIndented)) {
+      // continuation line
+      const continued = raw.trim();
+      if (continued) {
+        meta[currentKey] = (meta[currentKey] ? meta[currentKey] + ' ' : '') + continued;
+      }
+    }
+  }
+
+  if (!meta.name) return null;
+  return meta;
+}
+
+function stripQuotes(s) {
+  if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+    return s.slice(1, -1);
+  }
+  return s;
+}
+
+function truncateDescription(desc) {
+  if (!desc) return '';
+  // Collapse whitespace
+  const flat = desc.replace(/\s+/g, ' ').trim();
+  if (flat.length <= MAX_DESCRIPTION_CHARS) return flat;
+  // Truncate at sentence boundary if possible
+  const truncated = flat.slice(0, MAX_DESCRIPTION_CHARS);
+  const lastPeriod = truncated.lastIndexOf('.');
+  if (lastPeriod > MAX_DESCRIPTION_CHARS * 0.6) {
+    return truncated.slice(0, lastPeriod + 1);
+  }
+  return truncated + '…';
+}
+
+function escapeTableCell(s) {
+  return (s || '').replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+
+/**
+ * Scan a directory of skills (each subdir contains SKILL.md) and return
+ * sorted list of { name, description }.
+ */
+function buildEntries(skillsDir) {
+  if (!fs.existsSync(skillsDir)) return [];
+
+  const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+  const items = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name.startsWith('_') || entry.name.startsWith('.')) continue;
+
+    const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');
+    const meta = parseFrontmatter(skillFile);
+    if (!meta) {
+      process.stderr.write(`  skipped: ${entry.name} (no frontmatter)\n`);
+      continue;
+    }
+    items.push({
+      name: meta.name,
+      description: truncateDescription(meta.description),
+    });
+  }
+
+  items.sort((a, b) => a.name.localeCompare(b.name));
+  return items;
+}
+
+/**
+ * Render entries as a Markdown table with a header preamble.
+ */
+function renderIndex(skillsDir, entries) {
+  const lines = [];
+  lines.push('# Skill Index');
+  lines.push('');
+  lines.push(`Auto-generated by \`omc-manage skill index\`. Do not edit by hand —`);
+  lines.push(`rerun \`omc-manage skill index\` after adding or removing skills.`);
+  lines.push('');
+  lines.push(`Source directory: \`${skillsDir.replace(os.homedir(), '~')}\``);
+  lines.push(`Generated: ${new Date().toISOString()}`);
+  lines.push(`Entries: ${entries.length}`);
+  lines.push('');
+  lines.push('## Usage for LLMs');
+  lines.push('');
+  lines.push('`grep -i "<keyword>" _index.md` to find skills matching an intent.');
+  lines.push('Each row is `name | description` — both fields searchable.');
+  lines.push('');
+  lines.push('| Skill | Description |');
+  lines.push('|---|---|');
+  for (const e of entries) {
+    lines.push(`| \`${escapeTableCell(e.name)}\` | ${escapeTableCell(e.description)} |`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * Build and write the index. Returns { path, count }.
+ */
+async function buildAndWriteIndex(skillsDir, { quiet = false } = {}) {
+  const entries = buildEntries(skillsDir);
+  const indexPath = path.join(skillsDir, INDEX_FILENAME);
+  await fsp.writeFile(indexPath, renderIndex(skillsDir, entries), 'utf8');
+  if (!quiet) {
+    console.log(`  wrote ${indexPath.replace(os.homedir(), '~')} (${entries.length} entries)`);
+  }
+  return { path: indexPath, count: entries.length };
+}
+
+/**
+ * Resolve the skills install directory for the given scope.
+ */
+function resolveSkillsDir(scope) {
+  if (scope === 'project') {
+    const root = getProjectRoot();
+    return path.join(root, '.claude', 'skills');
+  }
+  // default: user scope
+  return path.join(os.homedir(), '.claude', 'skills');
+}
+
+/**
+ * CLI entrypoint: `omc-manage skill index [--scope user|project] [--quiet]`
+ */
+async function indexCommand(args, flags = {}) {
+  const scope = flags.scope || 'user';
+  if (scope !== 'user' && scope !== 'project') {
+    console.error(`Error: invalid --scope "${scope}" (expected user or project)`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const skillsDir = resolveSkillsDir(scope);
+  if (!fs.existsSync(skillsDir)) {
+    console.error(`Error: skills directory not found: ${skillsDir}`);
+    console.error('Run `omc-manage setup` first to install skills.');
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(`omc-manage skill index`);
+  console.log(`======================`);
+  console.log(`Scope: ${scope}`);
+  console.log(`Target: ${skillsDir.replace(os.homedir(), '~')}`);
+  console.log('');
+
+  const result = await buildAndWriteIndex(skillsDir, { quiet: flags.quiet });
+
+  console.log('');
+  console.log(`Indexed ${result.count} skills.`);
+}
+
+module.exports = {
+  indexCommand,
+  buildAndWriteIndex,
+  resolveSkillsDir,
+  parseFrontmatter, // exported for tests
+  truncateDescription, // exported for tests
+};

package/src/cli/skill.js

@@ -271,6 +271,10 @@ async function skill(args, flags = {}) {
   if (cmd === 'recommend') {
     return recommend(args, flags);
   }
+  if (cmd === 'index') {
+    const { indexCommand } = require('./skill-index');
+    return indexCommand(args.slice(1), flags);
+  }
 
   // Fall through to artifact subcommands (list, prefer, conflicts)
   flags.type = 'skills';