@eventmodelers/cli 0.0.8 → 0.0.10

package/README.md

@@ -199,6 +199,8 @@ npx @eventmodelers/cli init-config --global         # same, but writes organizat
 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 listen                       # start the code-export listener (code-export.mjs) from the installed kit dir
+npx @eventmodelers/cli listen --port 4000           # same, on a different port
 npx @eventmodelers/cli stacks                       # list available stacks
 npx @eventmodelers/cli status                       # check what's installed
 npx @eventmodelers/cli config                       # print the fully resolved config (file + env), token masked
@@ -207,6 +209,8 @@ npx @eventmodelers/cli uninstall                    # remove everything init/ini
 
 `run` is a thin dispatcher — it just finds the installed kit dir (whatever it's named for the stack) and execs the runner file already sitting in it. The agent loop's actual logic stays in the scaffolded `<kit-dir>/`, not in this package, since you (and the agent itself, via `AGENT.md`) may customize those files per project.
 
+`listen` is the same kind of dispatcher, but for `<kit-dir>/code-export.mjs` — a local HTTP server (port 3001 by default) that the eventmodelers board UI posts slice/screen data to, which then gets written under `<kit-dir>/.slices/`.
+
 ### Uninstall
 
 Every `init`/`init-modeling` run writes an install manifest into `<kit-dir>/.eventmodelers/install-manifest.json` recording exactly what it put down. `uninstall` reads that manifest back and removes only:

package/cli.js

@@ -636,7 +636,7 @@ async function installStack(stackKey, stackCfg, options = {}) {
 // `overrides` are values passed directly on the command line (--token, --board-id,
 // --organization-id, --base-url) — the most explicit source available, so they
 // win over both the config file and env vars before we even check what's missing.
-async function configureCredentials({ config, configPath, targetDir, requiredFields, boardIdOptional, overrides = {}, print, skipGitignore = false }) {
+async function configureCredentials({ config, configPath, targetDir, requiredFields, boardIdOptional, overrides = {}, print, skipGitignore = false, force = false }) {
   config = { ...config };
   for (const [field, value] of Object.entries(overrides)) {
     if (value) config[field] = value;
@@ -661,7 +661,7 @@ async function configureCredentials({ config, configPath, targetDir, requiredFie
     }
   }
 
-  const stillMissing = requiredFields.some((f) => !config[f]);
+  const stillMissing = force || requiredFields.some((f) => !config[f]);
   if (stillMissing && print) {
     console.log('\n  ℹ️  --print — skipping credential prompt, missing fields must be set via flags, EVENTMODELERS_* env vars, or config.json');
   } else if (stillMissing) {
@@ -909,6 +909,23 @@ program
   .option('--config <path>', 'Path to an explicit config.json, overriding directory-based resolution (individual fields can also be set via EVENTMODELERS_* env vars, which always win)')
   .option('--print', 'Print follow-up commands (e.g. claude mcp add) instead of prompting to run them');
 
+// Commands exempt from the "is a kit installed here?" gate below: init/init-modeling
+// are what installs one in the first place, init-config only ever touches credentials,
+// and stacks/status/config/uninstall are read-only or cleanup commands that are
+// meant to work — and report something useful — whether or not a kit is present.
+const NO_INIT_REQUIRED = new Set(['init', 'init-modeling', 'init-config', 'stacks', 'status', 'config', 'uninstall']);
+
+program.hook('preAction', (_thisCommand, actionCommand) => {
+  if (NO_INIT_REQUIRED.has(actionCommand.name())) return;
+  if (findInstalledKitDir(process.cwd())) return;
+
+  console.error(`❌ No eventmodelers kit installed in this directory (checked: ${KIT_DIR_NAMES.join(', ')}).`);
+  console.error('   Run one of these first:');
+  console.error(`     npx @eventmodelers/cli init --stack <name>   (${Object.keys(STACKS).join(', ')})`);
+  console.error('     npx @eventmodelers/cli init-modeling');
+  process.exit(1);
+});
+
 // Shared by init/init-modeling/init-config: direct command-line credentials,
 // Protractor-style (--base-url=..., not a generic --param key=value passthrough) —
 // self-documenting in --help and typo-safe. These win over both the config file
@@ -1009,6 +1026,7 @@ credentialFlags(program
         overrides: {},
         print: globalOpts.print,
         skipGitignore: true,
+        force: true,
       });
 
       // configureCredentials' generic paste/manual flow may have picked up
@@ -1030,6 +1048,7 @@ credentialFlags(program
         boardIdOptional: true,
         overrides,
         print: globalOpts.print,
+        force: true,
       });
     }
   });
@@ -1043,10 +1062,6 @@ program
   .action(async (opts) => {
     const cwd = process.cwd();
     const kitDir = findInstalledKitDir(cwd);
-    if (!kitDir) {
-      console.error(`❌ No installed kit dir found (checked: ${KIT_DIR_NAMES.join(', ')}) — run \`eventmodelers init\` first.`);
-      process.exit(1);
-    }
 
     const pickedCount = [opts.bash, opts.ollama, opts.realTime].filter(Boolean).length;
     if (pickedCount > 1) {
@@ -1085,6 +1100,29 @@ program
     }
   });
 
+program
+  .command('listen')
+  .description('Start the code-export listener (code-export.mjs) from the installed kit dir — receives slice/screen data pushed from the eventmodelers board UI and writes it into .slices/')
+  .option('--port <port>', 'Port to listen on (default 3001, or $PORT)')
+  .action((opts) => {
+    const cwd = process.cwd();
+    const kitDir = findInstalledKitDir(cwd);
+
+    const serverPath = join(kitDir, 'code-export.mjs');
+    if (!existsSync(serverPath)) {
+      console.error(`❌ ${relative(cwd, serverPath)} not found.`);
+      process.exit(1);
+    }
+
+    console.log(`▶ Starting ${relative(cwd, serverPath)}...\n`);
+    const env = opts.port ? { ...process.env, PORT: opts.port } : process.env;
+    try {
+      execSync(`node "${serverPath}"`, { cwd: kitDir, stdio: 'inherit', env });
+    } catch (err) {
+      process.exit(err.status || 1);
+    }
+  });
+
 program
   .command('stacks')
   .description('List available stacks (for `init --stack`)')

package/package.json

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