@hanzlaa/rcode 4.1.0 → 4.1.1

package/cli/index.js

@@ -33,6 +33,7 @@ const COMMANDS = {
   team: require('./team'),
   agent: require('./agent'),
   doctor: require('./doctor'),
+  workflow: require('./workflow'),  // lifecycle bridge for non-Claude runtimes
   'set-profile': require('./set-profile'),
   'set-mode': require('./set-mode'),
   config: require('./config'),
@@ -68,6 +69,21 @@ Usage:
   context        Memory bank freshness (--check | --refresh | --install-hook)
   github-sync    Sync .rcode/ phases/epics/stories to GitHub (dry-run default)
 
+🔄 LIFECYCLE (Codex / Copilot / Grok bridge)
+  workflow list                List all lifecycle workflow names
+  workflow show <name>         Print a workflow's full instructions to stdout
+  workflow show new-project    → project setup + ROADMAP
+  workflow show create-prd     → write / update the PRD
+  workflow show discuss-phase  → gather phase context
+  workflow show plan           → create a SPRINT plan
+  workflow show execute-sprint → execute a SPRINT
+  workflow show verify-phase   → verify phase completion
+  workflow show retrospective  → retrospective + velocity
+  workflow show ship           → deploy / release workflow
+
+  Non-Claude agents: pipe to your agent instead of using slash commands.
+  Example: rcode workflow show plan | codex run -
+
 👥 TEAM
   team           List the team roster
   digest         Print compact digests for all agents

package/cli/install.js

@@ -847,6 +847,7 @@ function ensureRcodeGitignore(target, options = {}) {
     '.rcode/brain/best-practices/',
     '',
     '# Runtime noise',
+    'node_modules/',
     '.rcode/state.json.lock',
     '.planning/debug/',
     '.planning/_backup/',

package/cli/workflow.js

@@ -0,0 +1,97 @@
+/**
+ * rcode workflow [list|show <name>] — lifecycle bridge for non-Claude runtimes.
+ *
+ * Codex, Copilot, Grok, and other non-Claude agents cannot invoke slash
+ * commands directly. This command exposes rcode's lifecycle workflows as
+ * readable markdown so any agent can follow the same process:
+ *
+ *   rcode workflow list               → list available workflow names
+ *   rcode workflow show <name>        → print workflow markdown to stdout
+ *   rcode workflow show plan          → print the plan workflow
+ *
+ * An agent consuming `rcode workflow show <name>` should treat the output
+ * as its operative instructions for that lifecycle step (the same content
+ * Claude Code loads when a slash command fires).
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Canonical lifecycle order shown in help output
+const LIFECYCLE_ORDER = [
+  'new-project',
+  'create-prd',
+  'discuss-phase',
+  'plan',
+  'execute-sprint',
+  'verify-phase',
+  'retrospective',
+  'ship',
+];
+
+module.exports = function workflow(args, { packageRoot }) {
+  const workflowsDir = path.join(packageRoot, 'rcode', 'workflows');
+
+  const subcommand = args[0];
+
+  if (!subcommand || subcommand === 'list' || subcommand === '--list') {
+    return listWorkflows(workflowsDir);
+  }
+
+  if (subcommand === 'show' || subcommand === 'get' || subcommand === 'run') {
+    const name = args[1];
+    if (!name) {
+      console.error('Usage: rcode workflow show <name>');
+      console.error('       rcode workflow list');
+      process.exit(1);
+    }
+    return showWorkflow(workflowsDir, name);
+  }
+
+  // Treat bare `rcode workflow <name>` as show
+  return showWorkflow(workflowsDir, subcommand);
+};
+
+function listWorkflows(workflowsDir) {
+  const all = fs.readdirSync(workflowsDir)
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.replace(/\.md$/, ''))
+    .sort();
+
+  // Show lifecycle commands first, then remaining alphabetically
+  const lifecycle = LIFECYCLE_ORDER.filter(n => all.includes(n));
+  const rest = all.filter(n => !LIFECYCLE_ORDER.includes(n));
+
+  console.log('🕌 rcode lifecycle workflows\n');
+  console.log('Core lifecycle (in order):');
+  lifecycle.forEach(n => console.log(`  rcode workflow show ${n}`));
+  if (rest.length) {
+    console.log('\nOther workflows:');
+    rest.forEach(n => console.log(`  rcode workflow show ${n}`));
+  }
+  console.log('\nUsage: rcode workflow show <name>  — print the full workflow instructions');
+}
+
+function showWorkflow(workflowsDir, name) {
+  const candidates = [
+    path.join(workflowsDir, `${name}.md`),
+    path.join(workflowsDir, `rcode-${name}.md`),
+  ];
+
+  for (const p of candidates) {
+    if (fs.existsSync(p)) {
+      process.stdout.write(fs.readFileSync(p, 'utf8'));
+      return;
+    }
+  }
+
+  // Not found — list available and exit non-zero
+  const available = fs.readdirSync(workflowsDir)
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.replace(/\.md$/, ''))
+    .sort()
+    .join(', ');
+  console.error(`Error: workflow '${name}' not found.`);
+  console.error(`Available: ${available}`);
+  process.exit(1);
+}