@hanzlaa/rcode 3.4.5 → 3.4.7

package/cli/generate-command-skills.cjs

@@ -32,11 +32,23 @@ const path = require('path');
  * 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',
+  // Navigation & status
+  'do', 'status', 'progress', 'next', 'health',
+  // Core planning & execution
+  'plan', 'execute', 'add-phase', 'discuss-phase', 'complete-milestone',
+  'plan-milestone-gaps', 'autonomous',
+  // Project setup
   'new-project', 'new-milestone', 'milestone-summary',
+  // Sprint workflow
+  'sprint-planning', 'sprint-status', 'execute-sprint', 'dev-story',
+  'create-story', 'create-epics-and-stories',
+  // Discussion & council
+  'council', 'discuss', 'prfaq',
+  // Quality & review
+  'ship', 'audit', 'verify-phase', 'verify-work', 'review', 'code-review',
+  'feature-drift', 'ui-phase', 'ui-review',
+  // Utility
+  'debug', 'session-report', 'forensics', 'map-codebase', 'quick',
   'note', 'add-todo', 'check-todos', 'pause-work', 'resume-work',
 ]);
 

package/cli/install.js

@@ -137,6 +137,12 @@ function parseArgs(argv) {
     // #199 — git pre-commit hook. null = install if .git/ present (default).
     // Set false by --no-git-hooks, true by --git-hooks.
     gitHooks: null,
+    // global install mode — targets ~/.claude/, skips per-project artifacts
+    global: false,
+    // silent — suppress non-error output (used by postinstall auto-run)
+    silent: false,
+    // noPrompt — skip all interactive prompts (used by postinstall auto-run)
+    noPrompt: false,
   };
   const positional = [];
   for (let i = 0; i < argv.length; i++) {
@@ -162,6 +168,9 @@ function parseArgs(argv) {
     else if (arg === '--no-backup') opts.noBackup = true;             // #381
     else if (arg === '--no-git-hooks') opts.gitHooks = false;         // #199
     else if (arg === '--git-hooks') opts.gitHooks = true;             // #199
+    else if (arg === '--global') opts.global = true;
+    else if (arg === '--silent') opts.silent = true;
+    else if (arg === '--no-prompt') opts.noPrompt = true;
     else if (!arg.startsWith('--')) positional.push(arg);
   }
   if (positional[0]) {
@@ -305,6 +314,7 @@ function detectIdeSignals(target) {
  */
 async function resolveIde(opts) {
   if (opts.ideProvided) return [opts.ide];            // user passed --ide, respect it
+  if (opts.noPrompt || opts.global) return ['claude']; // auto-install: always claude
   if (opts.yes || !process.stdin.isTTY) {
     // #182 — non-interactive mode: install into every detected IDE, not just
     // the default claude. The interactive flow already preselects detected
@@ -352,6 +362,7 @@ async function resolveIde(opts) {
  */
 async function resolveCommitPlanning(opts) {
   if (opts.commitPlanning !== null) return opts.commitPlanning;
+  if (opts.noPrompt || opts.global) return false; // global install: no planning artifacts
   if (opts.yes || !process.stdin.isTTY) return true; // non-interactive default
 
   const choice = await clack.select({
@@ -408,7 +419,7 @@ function getPathsForIde(ide, target) {
     case 'claude':
       return {
         agentsDir: path.join(target, '.claude', 'agents'),
-        commandsDir: path.join(target, '.claude', 'commands', 'rihal'),
+        commandsDir: path.join(target, '.claude', 'commands'),
         workflowsDir: path.join(target, '.rihal', 'workflows'),
         referencesDir: path.join(target, '.rihal', 'references'),
         binDir: path.join(target, '.rihal', 'bin'),
@@ -971,10 +982,15 @@ function buildInstallPlan(ide = 'claude', target = process.cwd()) {
   }
 
   // Commands — IDE-specific
+  // Claude: output as .claude/commands/rihal-{name}.md (hyphen namespace → /rihal-name)
+  // Cursor/Gemini: keep original flat name inside their rihal/ subdirectory
   for (const f of walkFiles(path.join(SOURCE_ROOT, 'commands'))) {
     const rel = path.relative(path.join(SOURCE_ROOT, 'commands'), f);
     const ext = ide === 'cursor' ? '.mdc' : '.md';
-    const outName = path.basename(f, '.md') + ext;
+    const baseName = path.basename(f, '.md');
+    const outName = ide === 'claude'
+      ? `rihal-${baseName}${ext}`
+      : baseName + ext;
     plan.push({ src: f, rel: path.join(relCommands, path.dirname(rel), outName), ide, cursor: ide === 'cursor' });
   }
 
@@ -1050,7 +1066,7 @@ function filterPlanByModules(plan, moduleNames) {
     if (!mod) { console.warn(`  ⚠ Unknown module: ${modName}`); continue; }
     for (const a of mod.agents) allowed.add(path.join('.claude', 'agents', a));
     for (const w of mod.workflows) allowed.add(path.join('.rihal', 'workflows', w));
-    for (const c of mod.commands) allowed.add(path.join('.claude', 'commands', 'rihal', c));
+    for (const c of mod.commands) allowed.add(path.join('.claude', 'commands', `rihal-${c}`));
     for (const r of mod.references) allowed.add(path.join('.rihal', 'references', r));
   }
   // Always include bin/ (shared infrastructure, not module-specific)
@@ -1649,6 +1665,27 @@ async function install(opts) {
     console.log('');
   }
 
+  // In global install mode (~/.claude/), skip per-project artifacts — those are
+  // created by `rcode install` inside each project directory at project-init time.
+  // Global install only ships the read-only tooling: commands, skills, workflows, bin.
+  if (opts.global) {
+    // Still write the manifest so the global install is traceable/upgradeable
+    const configDir = path.join(opts.target, '.rihal', '_config');
+    ensureDir(configDir);
+    fs.writeFileSync(path.join(configDir, 'manifest.yaml'), generateInstallManifest(opts));
+    // Install skills + sidebar stubs globally
+    let skillsInstalled = installSkills(PACKAGE_ROOT, opts.target);
+    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());
+      skillsInstalled += result.generated;
+    } catch { /* non-fatal */ }
+    console.log('');
+    console.log(`  ${dim(`${skillsInstalled} skills installed globally`)}`);
+    return 0;
+  }
+
   // Write .rihal/_config/manifest.yaml + agent-manifest.csv + files-manifest.csv
   const configDir = path.join(opts.target, '.rihal', '_config');
   ensureDir(configDir);
@@ -1858,7 +1895,12 @@ async function install(opts) {
       agentCount = fs.readdirSync(agentsDir).filter(f => (f.startsWith('rihal-') || f.startsWith('rcode-')) && (f.endsWith('.md') || f.endsWith('.mdc'))).length;
     }
     if (fs.existsSync(commandsDir)) {
-      commandCount = fs.readdirSync(commandsDir).filter(f => f.endsWith('.md') || f.endsWith('.mdc')).length;
+      commandCount = fs.readdirSync(commandsDir).filter(f => f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))).length;
+    }
+    // Clean up legacy .claude/commands/rihal/ colon-namespace directory if it exists
+    const legacyColonDir = path.join(opts.target, '.claude', 'commands', 'rihal');
+    if (primaryIde === 'claude' && fs.existsSync(legacyColonDir)) {
+      fs.rmSync(legacyColonDir, { recursive: true, force: true });
     }
   } catch {}
 

package/cli/postinstall.js

@@ -1,18 +1,78 @@
 /**
- * rihal-code postinstall hook — runs automatically after `npm install`
+ * rihal-code postinstall hook — runs automatically after `npm install -g`
+ *
+ * Auto-installs commands, skills, workflows, and bin tools into the global
+ * Claude Code directory (~/.claude/) so every project can use rihal immediately
+ * without needing a per-project `rcode install` run.
+ *
+ * Artifacts (.planning/, STATE.md, ROADMAP.md) are always created in the
+ * project CWD at runtime — the global install only ships read-only tooling.
  */
 
-// Only print the welcome if not running in CI/test environments
+'use strict';
+const os = require('os');
+const path = require('path');
+
+// Skip in CI or test environments
 if (process.env.CI || process.env.NODE_ENV === 'test') {
   process.exit(0);
 }
 
-console.log(`
+// Only auto-install when invoked as a global package (npm install -g).
+// A local devDependency install should not touch the user's ~/.claude/.
+const isGlobalInstall = (() => {
+  try {
+    // npm sets npm_config_global=true for global installs
+    if (process.env.npm_config_global === 'true') return true;
+    // Fallback: check if the install prefix is a global npm prefix
+    const prefix = process.env.npm_config_prefix || '';
+    const home = os.homedir();
+    if (prefix && !prefix.startsWith(home) && !prefix.includes('node_modules')) return true;
+    return false;
+  } catch {
+    return false;
+  }
+})();
+
+const globalTarget = path.join(os.homedir(), '.claude');
+
+if (isGlobalInstall) {
+  // Run the global install in the background so npm output isn't blocked
+  const { install } = require('./install.js');
+  install({
+    target: globalTarget,
+    ides: ['claude'],
+    ide: 'claude',
+    yes: true,
+    noPrompt: true,
+    commitPlanning: false,
+    global: true,        // signal: skip per-project artifacts (STATE.md, ROADMAP.md, .planning/)
+    silent: false,
+  }).then((code) => {
+    if (code === 0) {
+      console.log(`\n✓ Rihal commands + skills installed globally → ${globalTarget}`);
+      console.log('  All /rihal-* commands are now available in every project.\n');
+    } else {
+      console.warn(`\n⚠ Global auto-install exited with code ${code}. Run 'rcode install' manually if needed.\n`);
+    }
+    printWelcome();
+  }).catch((err) => {
+    console.warn(`\n⚠ Global auto-install failed: ${err.message}`);
+    console.warn('  Run "rcode install" manually to set up rihal commands.\n');
+    printWelcome();
+  });
+} else {
+  printWelcome();
+}
+
+function printWelcome() {
+  console.log(`
 🕌 Rihal Code installed.
 
-First-time setup:
-  rcode install      # set up agents + slash commands
-  rcode tiers        # see the tier map
+Commands are available globally in every Claude Code project.
+To set up per-project state + planning structure, run inside your project:
+
+  rcode install      # creates .rihal/config.yaml, .planning/, STATE.md
 
 🌱 The Golden Path (say these phrases in your AI IDE):
   1. "scaffold a new project"     → rihal-scaffold-project
@@ -28,5 +88,5 @@ More:
   rcode dashboard    # view-only Diwan on :7717
 
 Docs: https://github.com/hanzlahabib/rihal-code
-Tiers: docs/TIERS.md   ·   Standards: docs/STANDARDS.md
 `);
+}