@eventmodelers/cli 1.0.12 → 1.0.14

package/README.md

@@ -105,6 +105,7 @@ npx @eventmodelers/cli re-init                      # refresh an already-install
 npx @eventmodelers/cli run                          # start the agent loop (ralph-claude.js) from the installed kit dir
 npx @eventmodelers/cli run --ollama                 # same, via local Ollama (ralph-ollama.js)
 npx @eventmodelers/cli run --bash                   # bash-only loop, no realtime (ralph.sh)
+npx @eventmodelers/cli run --local                  # skip platform config/credential lookup entirely — local-only, no board sync
 npx @eventmodelers/cli fetch --context <name>                     # pull full slice detail for one context on the board into <kit-dir>/.slices/
 npx @eventmodelers/cli fetch --context <name> --slice-id <id>     # same, then print just that slice
 npx @eventmodelers/cli fetch --context <name> --slice-title <title> # same, then print just the slice matching this title
@@ -312,13 +313,16 @@ npx @eventmodelers/cli listen --port 4000            # same, on a different port
 ```bash
 npx @eventmodelers/cli re-init                      # refresh the installed build kit (.build-kit/) + its skills
 npx @eventmodelers/cli re-init --modeling            # refresh the modeling kit (.agent-modeling-kit/) + its skills
+npx @eventmodelers/cli re-init --stack supabase      # override which stack to refresh from (manifest missing/stale, or switching stacks)
 ```
 
 `re-init` re-runs `init` against whichever stack `install-manifest.json` says was installed (no need to pass `--stack` again), but skips step 2 of `init` entirely — the root project scaffold (`package.json`, `src/`, `server.ts`, `docker-compose.yml`, etc.) and the root `CLAUDE.md` router are never touched. Use it after upgrading the CLI to pick up fixes to `ralph.js`/`ralph.sh`/skills without re-scaffolding a project you've since built on top of.
 
+Pass `--stack <name>` to override the stack instead of relying on the manifest — useful if the manifest is missing/stale, or you want to point a `.build-kit` install at a different built-in stack's templates. It's mutually exclusive with `--modeling`.
+
 Credentials are left alone unless you pass `--force` — same rule `init` already follows when everything required is already configured. `--global` defaults to however skills were originally installed; pass it explicitly to move them.
 
-If the kit dir predates install-manifest.json tracking, or was installed via `init --git <url>` (a community/custom stack, not one of the built-in `STACKS` keys), `re-init` can't tell what to re-copy and tells you to re-run the original `init` command by hand instead.
+If the kit dir predates install-manifest.json tracking, or was installed via `init --git <url>` (a community/custom stack, not one of the built-in `STACKS` keys), and you don't pass `--stack` yourself, `re-init` can't tell what to re-copy and tells you to re-run the original `init` command by hand instead.
 
 ### Uninstall
 

package/cli.js

@@ -1635,12 +1635,23 @@ credentialFlags(program
   .command('re-init')
   .description('Refresh an already-installed kit from the current CLI version — re-copies skills and the kit dir (.build-kit or .agent-modeling-kit) so you pick up script/skill updates after upgrading. Unlike `init`, never touches the project root scaffold or the root CLAUDE.md router, and leaves existing credentials alone unless --force is passed.')
   .option('--modeling', 'Refresh the modeling kit (.agent-modeling-kit) instead of a build kit')
+  .option('--stack <name>', `Override which stack to refresh from (${Object.keys(REINITIABLE_STACKS).join(', ')}) instead of the one recorded in install-manifest.json — use this when the manifest is missing/stale, or to switch a .build-kit install to a different stack`)
   .option('--global', 'Re-install skills into ~/.claude/skills/ instead of the project — defaults to however they were originally installed')
   .option('-f, --force', 'Re-prompt for credentials even if a config already has everything required — overwrites the existing config.json'))
   .action(async (opts, command) => {
     const globalOpts = command.optsWithGlobals();
     const targetDir = process.cwd();
 
+    if (opts.modeling && opts.stack) {
+      console.error('❌ --modeling and --stack are mutually exclusive — pick one.');
+      process.exit(1);
+    }
+
+    if (opts.stack && !REINITIABLE_STACKS[opts.stack]) {
+      console.error(`❌ Unknown stack "${opts.stack}". Available: ${Object.keys(REINITIABLE_STACKS).join(', ')}`);
+      process.exit(1);
+    }
+
     const kitDirName = opts.modeling ? MODELING_KIT.kitDirName : STACKS.node.kitDirName;
     const kitDir = join(targetDir, kitDirName);
 
@@ -1650,12 +1661,12 @@ credentialFlags(program
     }
 
     const manifest = readJsonSafe(join(kitDir, '.eventmodelers', 'install-manifest.json'));
-    const stackKey = opts.modeling ? MODELING_KIT.key : manifest.stack;
+    const stackKey = opts.modeling ? MODELING_KIT.key : (opts.stack || manifest.stack);
     const stackCfg = stackKey ? REINITIABLE_STACKS[stackKey] : null;
 
     if (!stackCfg) {
       console.error(`❌ Can't tell which stack ${relative(targetDir, kitDir)} was installed from (${manifest.stack ? `"${manifest.stack}" isn't one re-init recognizes — likely a --git community stack` : 'its install manifest predates this tracking, or is missing'}).`);
-      console.error('   Re-run the original `init --git <url> --stack <name>` command by hand instead.');
+      console.error('   Pass --stack <name> explicitly, or re-run the original `init --git <url> --stack <name>` command by hand instead.');
       process.exit(1);
     }
 
@@ -1761,6 +1772,7 @@ program
   .option('--ollama', 'Use ralph-ollama.js instead of the default Claude runner (build-kit stacks only)')
   .option('--bash', 'Use the bash-only ralph.sh loop (build-kit stacks only, no realtime)')
   .option('--modeling', 'Keep one Claude process warm across prompts instead of spawning a fresh one per task, for low-latency voice/live use. Modeling-kit installs only — there is no cold-spawn/tasks.json loop for modeling-kit. Built into the CLI, not a per-project file.')
+  .option('--local', 'Skip platform config/credential lookup entirely and run the local-only loop (no board sync, no realtime agent) — even if .eventmodelers/config.json has credentials (build-kit stacks only)')
   .option('--verbose', 'Log every tool call\'s full input (commands, skill args, file paths) and assistant reasoning text. Default is condensed, high-level per-step logging only.')
   .action(async (opts) => {
     const cwd = process.cwd();
@@ -1788,6 +1800,10 @@ program
         console.error('❌ --modeling is mutually exclusive with --bash/--ollama — those select a build-kit runner, which --modeling has no use for.');
         process.exit(1);
       }
+      if (opts.local) {
+        console.error('❌ --modeling has no local-only mode — it is always driven by the org-wide realtime prompt queue, so --local has no use for it.');
+        process.exit(1);
+      }
       if (!modelingKitDir) {
         console.error(`❌ --modeling only supports a modeling-kit install (${MODELING_KIT.kitDirName}/) — it subscribes to the org-wide prompt queue, which build-kit stacks don't have. Use \`eventmodelers run\` (optionally with --ollama/--bash) for build-kit's slice-status loop instead.`);
         process.exit(1);
@@ -1839,9 +1855,11 @@ program
     console.log(`▶ Starting ${relative(cwd, runnerPath)}...\n`);
     const cmd = runner.endsWith('.sh') ? `"${runnerPath}"` : `node "${runnerPath}"`;
     try {
-      // Only ralph-claude.js reads this — the bash loop and the ollama executor have
-      // their own separate output paths with no stream-json parsing to gate.
-      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '' } });
+      // Only ralph-claude.js reads RALPH_VERBOSE — the bash loop and the ollama executor have
+      // their own separate output paths with no stream-json parsing to gate. RALPH_LOCAL is
+      // read by all three runners (ralph.js's startRalph, and ralph.sh directly) to force the
+      // local-only branch even when .eventmodelers/config.json has valid credentials.
+      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '', RALPH_LOCAL: opts.local ? '1' : '' } });
     } catch (err) {
       process.exit(err.status || 1);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventmodelers/cli",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Eventmodelers CLI — real-time Claude agent + skills for Claude Code, for any stack (Node, Supabase, Axon, Cratis, or modeling-only)",
   "type": "module",
   "bin": {

package/shared/build-kit/lib/ralph.js

@@ -397,15 +397,19 @@ async function ralphLoop(kitDir, cfg, onTask, onPlannedSlice) {
 
 export { loadLocalConfig, fetchPlatformConfig, retryOn401, startRealtimeAgent };
 
-export async function startRalph({ kitDir, projectDir, onTask, onPlannedSlice, agentType = 'BUILD', queueAllStatuses = false }) {
+export async function startRalph({ kitDir, projectDir, onTask, onPlannedSlice, agentType = 'BUILD', queueAllStatuses = false, localOnly = false }) {
   const local = loadLocalConfig(kitDir);
   local.agentId = ensureAgentId(kitDir, agentType);
 
   console.log(`Ralph — kit: ${kitDir}`);
   console.log(`         project: ${projectDir}`);
 
-  if (!hasCredentials(local)) {
-    console.log(`         mode: local-only (no platform sync)\n`);
+  // localOnly (set via `eventmodelers run --local`) forces this branch even when
+  // credentials are present — it skips fetchPlatformConfig's network call to
+  // ${baseUrl}/api/config and startRealtimeAgent entirely, so the loop never
+  // reaches out to the platform at all.
+  if (localOnly || !hasCredentials(local)) {
+    console.log(`         mode: local-only (no platform sync)${localOnly ? ' — forced by --local' : ''}\n`);
     await ralphLoop(kitDir, local, onTask, onPlannedSlice);
     return;
   }

package/shared/build-kit/ralph-claude.js

@@ -96,6 +96,7 @@ startRalph({
   projectDir,
   onTask: runClaude,
   onPlannedSlice: runClaude,
+  localOnly: process.env.RALPH_LOCAL === '1',
 }).catch((err) => {
   console.error('[ralph] Fatal:', err);
   process.exit(1);

package/shared/build-kit/ralph-ollama.js

@@ -33,6 +33,7 @@ startRalph({
   projectDir,
   onTask: runOllama,
   // onPlannedSlice omitted — ollama-agent manages its own task queue
+  localOnly: process.env.RALPH_LOCAL === '1',
 }).catch((err) => {
   console.error('[ralph] Fatal:', err);
   process.exit(1);

package/shared/build-kit/ralph.sh

@@ -21,7 +21,10 @@ BACKEND_PROMPT_FILE="$KIT_DIR/lib/backend-prompt.md"
 AGENT_SCRIPT="$KIT_DIR/lib/agent.sh"
 
 HAS_CREDENTIALS=true
-if [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
+if [[ "${RALPH_LOCAL:-}" == "1" ]]; then
+  echo "[ralph] --local — platform sync disabled." >&2
+  HAS_CREDENTIALS=false
+elif [[ ! -f "$KIT_DIR/.eventmodelers/config.json" ]]; then
   echo "[ralph] Note: no .eventmodelers/config.json found — platform sync disabled." >&2
   echo "        To enable board sync, follow: https://app.eventmodelers.ai/documentation#build" >&2
   echo "        Code generation from local slice definitions will still run." >&2