@hanzlaa/rcode 3.2.1 → 3.3.0

package/cli/generate-command-skills.cjs

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+/**
+ * Install-time generator: skill stubs that mirror slash commands.
+ *
+ * WHY: VS Code's Claude Code extension lists `.claude/skills/` in its
+ * sidebar, but slash commands at `.claude/commands/rihal/` are only
+ * reachable via the `/` autocomplete. Users coming from GSD (which ships
+ * a skill per command) expect to see lifecycle commands like `rihal-do`
+ * in the sidebar.
+ *
+ * This script creates ONE skill stub per slash command at install time,
+ * unless a real skill with the same name already exists at the source.
+ * The stubs live at the install destination only (`.claude/skills/`) —
+ * they are NEVER committed to the rcode source tree. That keeps the
+ * source codebase free of duplication while letting the sidebar feel
+ * full.
+ *
+ * Each generated stub is marked with `generated: true` and
+ * `generated-by: rcode-install` in frontmatter so it can be detected
+ * and refreshed on subsequent installs without confusing real skills.
+ *
+ * Run: node scripts/generate-command-skills.cjs <package-root> <target-skills-dir>
+ *      (called from cli/install.js)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Curated list of commands that get skill stubs. Not every command
+ * deserves a sidebar entry — only the user-facing entry points and
+ * lifecycle verbs. Internal sub-commands stay slash-only.
+ */
+const SIDEBAR_COMMANDS = new Set([
+  'do', 'status', 'progress', 'next', 'plan', 'execute',
+  'council', 'discuss', 'ship', 'audit', 'autonomous',
+  'session-report', 'forensics', 'health', 'debug',
+  'verify-phase', 'verify-work', 'review', 'code-review',
+  'new-project', 'new-milestone', 'milestone-summary',
+  'note', 'add-todo', 'check-todos', 'pause-work', 'resume-work',
+]);
+
+function parseFrontmatter(text) {
+  if (!text.startsWith('---\n')) return {};
+  const end = text.indexOf('\n---\n', 4);
+  if (end === -1) return {};
+  const block = text.slice(4, end);
+  const fm = {};
+  for (const raw of block.split('\n')) {
+    const m = raw.match(/^([a-zA-Z_-]+):\s*(.+)$/);
+    if (m) fm[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, '');
+  }
+  return fm;
+}
+
+function discoverRealSkills(packageRoot) {
+  const out = new Set();
+  const buckets = ['core', 'agents'];
+  for (const bucket of buckets) {
+    const dir = path.join(packageRoot, 'rihal', 'skills', bucket);
+    if (!fs.existsSync(dir)) continue;
+    for (const entry of fs.readdirSync(dir)) {
+      if (entry.startsWith('rihal-')) out.add(entry);
+    }
+  }
+  // actions are nested by phase
+  const actionsDir = path.join(packageRoot, 'rihal', 'skills', 'actions');
+  if (fs.existsSync(actionsDir)) {
+    for (const phase of fs.readdirSync(actionsDir)) {
+      const phaseDir = path.join(actionsDir, phase);
+      if (!fs.statSync(phaseDir).isDirectory()) continue;
+      for (const entry of fs.readdirSync(phaseDir)) {
+        if (entry.startsWith('rihal-')) out.add(entry);
+      }
+    }
+  }
+  return out;
+}
+
+function generateStub(cmdName, commandFm, version) {
+  const desc = commandFm.description || `Slash command shortcut for /rihal:${cmdName}.`;
+  const triggers = [
+    `rihal ${cmdName}`,
+    `rihal:${cmdName}`,
+    `/rihal:${cmdName}`,
+  ];
+
+  return `---
+name: rihal-${cmdName}
+description: >
+  ${desc.replace(/\n/g, ' ')}
+  Sidebar entry — invokes the same workflow as /rihal:${cmdName}.
+triggers:
+${triggers.map((t) => `  - "${t}"`).join('\n')}
+user-invocable: true
+generated: true
+generated-by: rcode-install-v${version}
+source: rihal/commands/${cmdName}.md
+---
+
+<!--
+AUTO-GENERATED at install time by scripts/generate-command-skills.cjs.
+Do NOT edit this file directly — your changes will be overwritten on the next
+install or update. To customise, create a sibling \`.local.md\` file (which
+is preserved across installs) or modify the source command at
+rihal/commands/${cmdName}.md.
+
+This stub exists so the slash command /rihal:${cmdName} appears in VS Code's
+Claude Code sidebar (which lists skills only, not slash commands). The
+behaviour is identical to /rihal:${cmdName} — both invoke the workflow at
+.rihal/workflows/${cmdName}.md.
+-->
+
+## Overview
+
+Sidebar entry for the \`/rihal:${cmdName}\` slash command. Phrase-activated alternative invocation route.
+
+## Workflow
+
+Read and execute \`@.rihal/workflows/${cmdName}.md\` end-to-end. The behaviour is the same as invoking \`/rihal:${cmdName}\` directly.
+
+## Output Format
+
+Identical to \`/rihal:${cmdName}\`. See the workflow file for the canonical output spec.
+
+## Examples
+
+**Happy path** — say "rihal ${cmdName}" or "/rihal:${cmdName}" → workflow runs identically either way.
+
+**Negative — looking for the canonical command file** — see \`rihal/commands/${cmdName}.md\` (the source of truth) and \`rihal/workflows/${cmdName}.md\` (the orchestration logic).
+
+## Memory Bank Hooks
+
+- **Reads:** whatever \`.rihal/workflows/${cmdName}.md\` reads
+- **Writes:** whatever the workflow writes
+- This stub itself is read-only — it just dispatches to the workflow.
+`;
+}
+
+function main(packageRoot, targetSkillsDir, version) {
+  if (!fs.existsSync(targetSkillsDir)) {
+    fs.mkdirSync(targetSkillsDir, { recursive: true });
+  }
+
+  const realSkills = discoverRealSkills(packageRoot);
+  const commandsDir = path.join(packageRoot, 'rihal', 'commands');
+  if (!fs.existsSync(commandsDir)) {
+    console.warn(`[generate-command-skills] commands dir not found: ${commandsDir}`);
+    return { generated: 0, skipped: 0 };
+  }
+
+  let generated = 0;
+  let skipped = 0;
+
+  for (const file of fs.readdirSync(commandsDir)) {
+    if (!file.endsWith('.md')) continue;
+    if (file.startsWith('_')) continue; // internal aliases / metadata
+    const cmdName = file.replace(/\.md$/, '');
+    if (!SIDEBAR_COMMANDS.has(cmdName)) { skipped++; continue; }
+
+    const skillName = `rihal-${cmdName}`;
+    if (realSkills.has(skillName)) {
+      // A real skill with this name exists in the source tree — don't shadow it
+      skipped++;
+      continue;
+    }
+
+    const cmdPath = path.join(commandsDir, file);
+    const cmdText = fs.readFileSync(cmdPath, 'utf8');
+    const cmdFm = parseFrontmatter(cmdText);
+
+    const stubDir = path.join(targetSkillsDir, skillName);
+    const stubFile = path.join(stubDir, 'SKILL.md');
+
+    // Idempotency: only overwrite if the file is missing OR is a previously
+    // generated stub (has the marker). Never clobber a user's hand-edited file.
+    if (fs.existsSync(stubFile)) {
+      const existing = fs.readFileSync(stubFile, 'utf8');
+      if (!/^generated:\s*true/m.test(existing)) {
+        skipped++;
+        continue;
+      }
+    }
+
+    fs.mkdirSync(stubDir, { recursive: true });
+    fs.writeFileSync(stubFile, generateStub(cmdName, cmdFm, version), 'utf8');
+    generated++;
+  }
+
+  return { generated, skipped };
+}
+
+if (require.main === module) {
+  const [packageRoot, targetSkillsDir, version = '0.0.0'] = process.argv.slice(2);
+  if (!packageRoot || !targetSkillsDir) {
+    console.error('Usage: generate-command-skills.cjs <package-root> <target-skills-dir> [version]');
+    process.exit(2);
+  }
+  const { generated, skipped } = main(packageRoot, targetSkillsDir, version);
+  console.log(`✓ ${generated} sidebar skill stub${generated === 1 ? '' : 's'} generated, ${skipped} skipped (already real skills or out of curated set)`);
+}
+
+module.exports = { main, SIDEBAR_COMMANDS };

package/cli/install.js

@@ -1619,7 +1619,24 @@ async function install(opts) {
 
   // Install v1-style phrase-activated skills (scaffold-project, create-prd,
   // retrospective, etc.) into .claude/skills/ alongside the v2 agents/commands.
-  const skillsInstalled = installSkills(PACKAGE_ROOT, opts.target);
+  let skillsInstalled = installSkills(PACKAGE_ROOT, opts.target);
+
+  // Generate install-time skill stubs that mirror sidebar-worthy slash commands.
+  // Source codebase stays clean — these stubs only exist at the install
+  // destination, marked with `generated: true` so they refresh idempotently.
+  // See cli/generate-command-skills.cjs for rationale.
+  try {
+    const { main: generateCommandSkills } = require(path.join(PACKAGE_ROOT, 'cli', 'generate-command-skills.cjs'));
+    const stubsDir = path.join(opts.target, '.claude', 'skills');
+    const result = generateCommandSkills(PACKAGE_ROOT, stubsDir, readPackageVersion());
+    if (result.generated > 0) {
+      console.log('  ' + dim(`${result.generated} sidebar skill stub${result.generated === 1 ? '' : 's'} generated for command discoverability`));
+      skillsInstalled += result.generated;
+    }
+  } catch (err) {
+    // Non-fatal: install succeeds without sidebar stubs
+    console.log('  ' + dim(`(sidebar stub generation skipped: ${err.message})`));
+  }
 
   // Seed .planning/ with starter ROADMAP + STATE so workflows work immediately
   const starterSeeded = seedStarterPlanning(opts.target, opts.projectName);

package/dist/rcode.js

@@ -17015,7 +17015,18 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
         path2.join(configDir, "files-manifest.csv"),
         generateFilesManifest(plan, opts.target)
       );
-      const skillsInstalled = installSkills(PACKAGE_ROOT2, opts.target);
+      let skillsInstalled = installSkills(PACKAGE_ROOT2, opts.target);
+      try {
+        const { main: generateCommandSkills } = require(path2.join(PACKAGE_ROOT2, "cli", "generate-command-skills.cjs"));
+        const stubsDir = path2.join(opts.target, ".claude", "skills");
+        const result = generateCommandSkills(PACKAGE_ROOT2, stubsDir, readPackageVersion());
+        if (result.generated > 0) {
+          console.log("  " + dim(`${result.generated} sidebar skill stub${result.generated === 1 ? "" : "s"} generated for command discoverability`));
+          skillsInstalled += result.generated;
+        }
+      } catch (err) {
+        console.log("  " + dim(`(sidebar stub generation skipped: ${err.message})`));
+      }
       const starterSeeded = seedStarterPlanning(opts.target, opts.projectName);
       installBrainScaffold(PACKAGE_ROOT2, opts.target);
       const gitignoreReport = ensureRcodeGitignore(opts.target, { commitPlanning: opts.commitPlanning });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "rcode — the memory bank for AI-driven SaaS teams. Persistent project context, distinctive engineering personas, and phase-based workflows. Built by Rihal. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {