@eventmodelers/cli 2.0.53 → 2.0.55

package/cli.js

@@ -44,7 +44,7 @@ import { defaultAgentName, withInstanceSuffix } from './shared/build-kit/lib/age
 import { acquireAgentId } from './shared/build-kit/lib/agent-lock.js';
 import { readEvents, appendEvent, locationOf } from './shared/build-kit/lib/slice-events.js';
 import { findPromptEvent, replayRequest } from './shared/build-kit/lib/prompt-replay.js';
-import { prunableEvents, pruneLog, rememberPruneAnswer, shouldOfferPrune } from './shared/build-kit/lib/event-prune.js';
+import { clearLog, prunableEvents, pruneLog, rememberPruneAnswer, shouldOfferPrune } from './shared/build-kit/lib/event-prune.js';
 import { fold } from './shared/build-kit/lib/slice-state.js';
 import { filterEvents, baselineIds, formatEvent, formatPayload, sliceTitles, summarize } from './shared/build-kit/lib/events-view.js';
 import { stableGlobalAgentId } from './lib/global-agent-id.js';
@@ -4525,7 +4525,7 @@ credentialFlags(program
       // path with no stream-json parsing to gate. RALPH_LOCAL is read by ralph.js's startRalph to force
       // the local-only branch even when .eventmodelers/config.json has valid credentials.
       // RALPH_AGENT_ID/RALPH_AGENT_NAME (--id/--name) are read there too.
-      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '', RALPH_SYNC: opts.sync ? '1' : '', RALPH_LOCAL: opts.local ? '1' : '', RALPH_HANDOVER: opts.handover ? '1' : '', RALPH_STATUS_TRIGGER: opts.statusTrigger ? String(opts.statusTrigger).trim() : '', RALPH_FEATURE: opts.feature ? String(opts.feature).trim() : '', RALPH_AGENT_ID: identity.agentId ?? '', RALPH_AGENT_NAME: identity.agentName ?? '', ...(typeof localAiTarget === 'string' ? { LOCAL_AI_TARGET: localAiTarget } : {}), ...(typeof opts.exec === 'string' ? { RALPH_EXEC_CMD: opts.exec } : {}), ...(acpAgent ? { RALPH_ACP_AGENT: opts.acpAgent ?? '', RALPH_ACP_CMD: opts.acpCmd ?? '' } : {}) } });
+      execSync(cmd, { cwd: kitDir, stdio: 'inherit', env: { ...process.env, RALPH_VERBOSE: opts.verbose ? '1' : '', RALPH_SYNC: opts.sync ? '1' : '', RALPH_LOCAL: opts.local ? '1' : '', RALPH_HANDOVER: opts.handover ? '1' : '', RALPH_STATUS_TRIGGER: opts.statusTrigger ? String(opts.statusTrigger).trim() : '', RALPH_FEATURE: opts.feature ? String(opts.feature).trim() : '', EVENTMODELERS_KIT_DIR: kitDir, RALPH_AGENT_ID: identity.agentId ?? '', RALPH_AGENT_NAME: identity.agentName ?? '', ...(typeof localAiTarget === 'string' ? { LOCAL_AI_TARGET: localAiTarget } : {}), ...(typeof opts.exec === 'string' ? { RALPH_EXEC_CMD: opts.exec } : {}), ...(acpAgent ? { RALPH_ACP_AGENT: opts.acpAgent ?? '', RALPH_ACP_CMD: opts.acpCmd ?? '' } : {}) } });
     } catch (err) {
       process.exit(err.status || 1);
     }
@@ -5296,10 +5296,27 @@ program
     console.log(`✅ Pushed status change to the board (node ${slice.id}).`);
   });
 
+// The kit directory the run loop pinned for its agent (EVENTMODELERS_KIT_DIR, set by `eventmodelers run`), or null.
+// An agent's shell cwd drifts; the loop's does not. A stale value (directory gone) is ignored rather than trusted.
+function pinnedKitDir() {
+  const dir = process.env.EVENTMODELERS_KIT_DIR;
+  return dir && existsSync(dir) ? resolve(dir) : null;
+}
+
+// Where an agent-side command resolves the project from: the pinned kit's project, else the shell's cwd.
+function agentCwd() {
+  const pinned = pinnedKitDir();
+  return pinned ? dirname(pinned) : process.cwd();
+}
+
 // The kit a command that records events works against: a build kit if one is installed, else the modeling
 // kit. The build kit wins when both are installed — the modeling agent never runs these commands itself
 // (its Bash is an allowlist); it states its learnings in its reply and `runModeling` records them.
 function requireBuildKitDir(cwd) {
+  // The run loop exports the kit it runs in. Trust it over the shell's cwd: the build agent may `cd` elsewhere in the
+  // project (an app with a root kit and a web/ kit) and its commands must still reach the kit that holds the claim.
+  const pinned = pinnedKitDir();
+  if (pinned) return pinned;
   const installed = findAllInstalledKitDirs(cwd);
   const kitDir = installed.find((d) => !d.endsWith(MODELING_KIT.kitDirName)) ?? installed.find((d) => d.endsWith(MODELING_KIT.kitDirName));
   if (!kitDir) {
@@ -5325,7 +5342,7 @@ program
   .description("For a build agent: record the outcome of the slice the run loop is building (Done, Waiting, Blocked, ...). The loop owns the slice's status on the board and pushes it when the build ends — never edit index.json or call update-slice-status for a loop build.")
   .option('--slice <idOrTitle>', 'The slice, when the loop has claimed more than one (default: the one it is building)')
   .action((status, opts, command) => {
-    const cwd = process.cwd();
+    const cwd = agentCwd();
     // `Handover` is the old name of `Waiting`; older skills and prompts still say it
     const wanted = status.toLowerCase() === 'handover' ? 'waiting' : status.toLowerCase();
     const canonical = SLICE_STATUSES.find((s) => s.value.toLowerCase() === wanted)?.value;
@@ -5359,7 +5376,7 @@ program
       console.error('❌ Action must be `check` or `record`.');
       process.exit(1);
     }
-    const cwd = process.cwd();
+    const cwd = agentCwd();
     const kitDir = requireBuildKitDir(cwd);
     let wanted = opts.slice;
     if (!wanted) {
@@ -5367,7 +5384,7 @@ program
       if (claimed.length !== 1) {
         if (!claimed.length) {
           // Where it looked: an agent running from another kit's directory finds no claim in that kit's log.
-          try { appendEvent(kitDir, { type: 'claim-not-found', command: 'build-baseline', claimed: 0, ...locationOf(kitDir, cwd) }, agentEventMeta(cwd, kitDir, command)); } catch { /* best effort */ }
+          try { appendEvent(kitDir, { type: 'claim-not-found', command: 'build-baseline', claimed: 0, ...locationOf(kitDir, process.cwd()) }, agentEventMeta(cwd, kitDir, command)); } catch { /* best effort */ }
         }
         console.error(`❌ ${claimed.length ? `${claimed.length} slices are claimed` : 'No slice is claimed by the run loop'} — name the slice with --slice.`);
         process.exit(1);
@@ -5432,7 +5449,7 @@ program
   .option('--merge <ids>', 'Replace these learnings (comma-separated ids) by one with the given text — the curator\'s tool')
   .option('--reason <reason>', 'Why — recorded with a retraction or a merge')
   .action((text, opts, command) => {
-    const cwd = process.cwd();
+    const cwd = agentCwd();
     const kitDir = requireBuildKitDir(cwd);
     const meta = agentEventMeta(cwd, kitDir, command);
     try {
@@ -5465,7 +5482,7 @@ program
   .option('--slice <idOrTitle>', 'The slice it is about (default: the one the run loop has claimed)')
   .option('--tag <tag>', 'Label the info (repeatable)', (tag, tags) => [...tags, tag], [])
   .action(async (text, opts, command) => {
-    const cwd = process.cwd();
+    const cwd = agentCwd();
     const kitDir = requireBuildKitDir(cwd);
     const meta = agentEventMeta(cwd, kitDir, command);
     try {
@@ -5508,6 +5525,9 @@ program
   .option('--verbose', 'Print each event\'s payload under its line — for a tool call, the input it was sent (recorded by runs started with --verbose). Also shows the baseline events: the kit\'s first look at each slice (a fresh kit records every slice already on the board), which are hidden by default. `--type board-observed` and `--json` show them too.')
   .option('--state', 'Print the state the log folds to (slices, queue, open prompts, learnings) instead of the events')
   .option('--prune', 'Delete the events nothing reads any more — the journal of finished prompts — and stop. Slice state, learnings and open prompts are kept; the same prune a run offers at every 1000 events.')
+  .option('--clear', "Delete the whole log, state included, so the kit starts over (it looks at the board again; attempt counts, blocks and failure history are gone). Lists what it would delete and stops unless --yes is given. Refuses while a run holds a claim, unless --force.")
+  .option('--yes', 'With --clear: really delete')
+  .option('--force', 'With --clear: delete even while a run holds a claim')
   .option('--follow', 'Keep running and print events as they are appended')
   .option('--watch', 'Same as --follow')
   .action(async (opts) => {
@@ -5521,6 +5541,19 @@ program
     const prototypeLog = join(cwd, '.prototype');
     const inPrototype = !opts.global && !opts.kit && !findInstalledKitDir(cwd) && existsSync(join(prototypeLog, 'events.log'));
     const kitDir = opts.global ? globalLog : opts.kit ? resolve(cwd, opts.kit) : inPrototype ? prototypeLog : requireBuildKitDir(cwd);
+    if (opts.clear) {
+      try {
+        const where = relative(cwd, kitDir) || kitDir;
+        const { removed } = clearLog(kitDir, { force: opts.force, dryRun: !opts.yes });
+        console.log(opts.yes
+          ? `Cleared ${removed} events from ${where}.`
+          : `Would delete all ${removed} events from ${where} — state included. Nothing was deleted; run again with --yes to do it.`);
+      } catch (err) {
+        console.error(`❌ ${err.message}`);
+        process.exit(1);
+      }
+      return;
+    }
     if (opts.prune) {
       try {
         const { removed, kept } = pruneLog(kitDir);
@@ -5631,7 +5664,7 @@ program
   .description('Print the recorded learnings — what .build-kit/AGENTS.md says. With --ids, one line each with the id to retract it by.')
   .option('--ids', 'One line per learning: id, topic, text')
   .action((opts, command) => {
-    const cwd = process.cwd();
+    const cwd = agentCwd();
     const kitDir = requireBuildKitDir(cwd);
     syncLearnings({ kitDir, meta: agentEventMeta(cwd, kitDir, command) });
     const all = listLearnings(kitDir);

package/package.json

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

package/shared/build-kit/lib/event-prune.js

@@ -7,8 +7,9 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'fs';
 import { isDeepStrictEqual } from 'util';
 import { join } from 'path';
-import { EVENTS_DIR, INDEX_FILE, readEvents } from './slice-events.js';
+import { EVENTS_DIR, INDEX_FILE, SEQ_FILE, readEvents } from './slice-events.js';
 import { fold } from './slice-state.js';
+import { isProcessAlive } from './slice-run.js';
 
 export const PRUNE_EVERY = 1000;
 const ASKED_FILE = '.prune-asked'; // inside events/, which readEvents never lists and the kit's git rules already cover
@@ -40,6 +41,24 @@ export function pruneLog(kitDir) {
   return { removed: doomed.size, kept: rest.length };
 }
 
+// Deletes the whole log — every event, state included — so the kit starts over as if freshly installed: it looks at
+// the board again and every slice's attempt count, block and failure history is gone. Refuses while a live process
+// holds a claim (its build would end without a trace) unless `force`. Returns { removed, liveClaims }; with
+// `dryRun` nothing is deleted.
+export function clearLog(kitDir, { force = false, dryRun = false } = {}) {
+  const events = readEvents(kitDir);
+  const liveClaims = Object.entries(fold(events).slices)
+    .filter(([, s]) => s.claim && isProcessAlive(s.claim.pid))
+    .map(([id, s]) => s.claim.title ?? id);
+  if (liveClaims.length && !force) throw new Error(`a run is building ${liveClaims.join(', ')} — stop it first, or pass --force`);
+  if (dryRun) return { removed: events.length, liveClaims };
+  const dir = join(kitDir, EVENTS_DIR);
+  rmSync(dir, { recursive: true, force: true });
+  rmSync(join(kitDir, INDEX_FILE), { force: true });
+  rmSync(join(kitDir, SEQ_FILE), { force: true });
+  return { removed: events.length, liveClaims };
+}
+
 // Asked when the log has reached a multiple of PRUNE_EVERY it has not been asked at yet — 1000, then 2000, … — so a
 // "no" is not repeated on every start. `remember` records the size the answer was given at.
 const askedPath = (kitDir) => join(kitDir, EVENTS_DIR, ASKED_FILE);