flowviant 0.117.0 → 0.124.1

package/bin/lib/workToolLog.mjs

@@ -8,7 +8,7 @@
  * the stream. Tested directly (workToolLog.test.mjs).
  */
 import { toolEventOf } from './runtimeEvents.mjs';
-import { scrub as envScrub } from './uplinkScrub.mjs';
+import { scrubCut, scrub as envScrub } from './uplinkScrub.mjs';
 
 /**
  * THE TURN'S TOOL LOG — the structured relay behind the transcript's
@@ -30,14 +30,74 @@ import { scrub as envScrub } from './uplinkScrub.mjs';
  *     because it is current state rather than scrollback.
  */
 export function createToolLog(cwd) {
-  const toolLog = { ev: [], dropped: 0 };
-  const pushToolEvent = (name, input) => {
+  const toolLog = { ev: [], dropped: 0, state: 'unknown' };
+  // IDs are correlation keys, never model-authored citations. Keep only bounded
+  // metadata; output supplies a fixed category and allowlisted reader diagnostic.
+  // Arbitrary output and file contents are discarded.
+  const correlated = new Map();
+  const refresh = () => {
+    toolLog.state = toolLog.state === 'partial' || toolLog.dropped || toolLog.recoveryDropped ? 'partial' :
+      toolLog.ev.length && toolLog.ev.every(e => e.outcome && e.outcome !== 'unknown') ? 'complete' : 'unknown';
+    const retained = new Set([...toolLog.ev, toolLog.firstFailure, ...(toolLog.recovery ?? [])]);
+    for (const [id, row] of correlated) if (!retained.has(row)) correlated.delete(id);
+  };
+  const observe = (e, meta) => {
+    const code = Number.isSafeInteger(meta.exitCode) ? meta.exitCode : undefined;
+    const failed = meta.isError === true || (code !== undefined && code !== 0);
+    e.outcome = !meta.result ? 'unknown' : failed ? 'failed' :
+      meta.runtime === 'codex' && code === undefined ? 'unknown' : 'success';
+    if (code !== undefined) e.exitCode = code;
+    if (failed) {
+      const output = scrubCut(meta.output ?? '', 16_384);
+      const guardAt = output.indexOf('flowviant: this turn is read-only, so ');
+      const guard = guardAt >= 0 ? output.slice(guardAt).split('\n', 1)[0] : undefined;
+      const diagnostic = guard ?? output.split('\n', 80).find(line => /^(?:[\w./ -]{1,160}: ){1,2}(?:No such file or directory|Permission denied|command not found)\.?$/.test(line) || (e.t === 'read' && /^(?:Error: )?(?:File does not exist|File not found|Permission denied)\.?(?: Note: your current working directory is [^\n]{1,400}\.)?$/.test(line)));
+      if (diagnostic) {
+        e.errorMessage = diagnostic.slice(0, 500);
+        if (diagnostic.length > 500) { e.errorTruncated = true; toolLog.state = 'partial'; }
+      }
+      e.errorCategory = guard && /a pipe|a glob|a redirect|a second command|an expansion|command substitution|brace expansion|a subshell/.test(guard) ? 'syntax_refusal' : /permission|denied|approval|not allowed|refus/i.test(output) ? 'denied' :
+        /command not found|not recognized|executable.*not found/i.test(output) ? 'unavailable_tool' :
+        /no such file|not found|does not exist|cannot find/i.test(output) ? 'missing_path' : 'tool_error';
+      if (!toolLog.firstFailure) {
+        toolLog.firstFailure = { ...e };
+        toolLog.recovery = [];
+      }
+    }
+  };
+  const pushToolEvent = (name, input, meta = {}) => {
+    const id = typeof meta.id === 'string' && meta.id && meta.id.length <= 160 ? meta.id : undefined;
+    const existing = id && correlated.get(id);
+    if (existing) {
+      if (meta.result) observe(existing, meta);
+      refresh();
+      return existing;
+    }
+    if (!name) {
+      toolLog.dropped = Math.min(1_000_000, toolLog.dropped + 1);
+      refresh();
+      return;
+    }
     // envScrub rides INTO the builder, which scrubs over a bounded
     // window BEFORE its caps — scrubbing after the cut both leaked a
     // boundary-straddling secret's prefix and grew a capped field
     // past the server's limits (review, 2026-09-01).
     const e = toolEventOf(name, input, cwd, envScrub);
     if (!e) return;
+    if (e.t !== 'plan') {
+      if (id) { e.id = scrubCut(id, 160); correlated.set(id, e); }
+      if (name === 'Read') for (const key of ['offset', 'limit']) {
+        if (Number.isSafeInteger(input?.[key]) && input[key] >= 0) e[key] = input[key];
+      }
+      if (toolLog.firstFailure) {
+        toolLog.recovery.push(e);
+        if (toolLog.recovery.length > 12) {
+          toolLog.recovery.shift();
+          toolLog.recoveryDropped = Math.min(1_000_000, (toolLog.recoveryDropped ?? 0) + 1);
+        }
+      }
+      observe(e, meta);
+    }
     if (e.t === 'plan') {
       const i = toolLog.ev.findIndex((x) => x.t === 'plan');
       if (i >= 0) toolLog.ev.splice(i, 1);
@@ -46,6 +106,11 @@ export function createToolLog(cwd) {
       const last = toolLog.ev[toolLog.ev.length - 1];
       const sameKey =
         last &&
+        !id && !last.id &&
+        last.outcome === e.outcome &&
+        last.exitCode === e.exitCode &&
+        last.errorCategory === e.errorCategory &&
+        last.offset === e.offset && last.limit === e.limit &&
         last.t === e.t &&
         last.p === e.p &&
         last.q === e.q &&
@@ -71,6 +136,8 @@ export function createToolLog(cwd) {
       const [shed] = toolLog.ev.splice(i, 1);
       toolLog.dropped = Math.min(1_000_000, toolLog.dropped + (shed?.n ?? 1));
     }
+    refresh();
+    return e;
   };
   return { toolLog, pushToolEvent };
 }

package/bin/lib/workTurnShape.mjs

@@ -1,3 +1,4 @@
+import { discoveryGuide } from './discoveryContract.mjs';
 /**
  * WHAT A TERMINAL TAB'S TURN IS — plain, plan, capture or build — decided
  * once, as data (audit 2026-10-10, F159). Pure: no I/O, no state.
@@ -145,8 +146,8 @@ const SYSTEMS = { plain: SYSTEM_WORK_PLAIN, capture: SYSTEM_CAPTURE, work: SYSTE
 /** The turn's opening message under its contract. The plain kickoff names no
  *  session id (WORK_TURN_KICKOFF_PLAIN takes none) — it has no tools to pass
  *  one to. */
-export const sessionTurnKickoff = (shape, { sessionId, sessionName, message, askedByName }) =>
-  KICKOFFS[shape.kickoff]({ sessionId, sessionName, message, askedByName });
+export const sessionTurnKickoff = (shape, { sessionId, sessionName, message, askedByName, interrupted = false }) =>
+  KICKOFFS[shape.kickoff]({ sessionId, sessionName, message, askedByName, interrupted });
 
 /**
  * The turn's system prompt: its contract with the project's knowledge
@@ -154,10 +155,11 @@ export const sessionTurnKickoff = (shape, { sessionId, sessionName, message, ask
  * server can show one (`artifactsAccepted`, read by the lane at spawn), and a
  * plan turn's sentence appended.
  */
-export const sessionTurnSystem = (shape, { knowledgeDir, artifactsAccepted }) => {
+export const sessionTurnSystem = (shape, { knowledgeDir, artifactsAccepted, runtime }) => {
   const contract = withProjectContext(SYSTEMS[shape.systemBase], {
     knowledgeDir,
     artifacts: shape.artifacts && artifactsAccepted,
   });
-  return shape.planSentence ? `${contract}\n\n${PLAN_TURN_SENTENCE}` : contract;
+  const discovery = shape.systemBase === 'capture' && runtime ? `\n\n${discoveryGuide(runtime, 'capture')}` : '';
+  return shape.planSentence ? `${contract}\n\n${PLAN_TURN_SENTENCE}` : contract + discovery;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowviant",
-  "version": "0.117.0",
+  "version": "0.124.1",
   "description": "Run your own coding CLIs as build agents for Flowviant — Claude Code, Codex or Antigravity, on your own credentials. Holds your sessions, keeps a worktree per tab, and ships branches on your word.",
   "type": "module",
   "bin": {
@@ -35,10 +35,14 @@
   "homepage": "https://flowviant.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/flowviant/cli.git"
+    "url": "git+https://github.com/Flowviant/flowviant.git",
+    "directory": "cli"
   },
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/flowviant/cli/issues"
+    "url": "https://github.com/Flowviant/flowviant/issues"
+  },
+  "devDependencies": {
+    "three": "0.180.0"
   }
 }

package/npm-shrinkwrap.json

@@ -1,59 +0,0 @@
-{
-  "name": "flowviant",
-  "version": "0.117.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "flowviant",
-      "version": "0.117.0",
-      "license": "MIT",
-      "dependencies": {
-        "libsodium-wrappers-sumo": "^0.8.4",
-        "ws": "^8.18.0"
-      },
-      "bin": {
-        "flowviant": "bin/cli.mjs"
-      },
-      "engines": {
-        "node": ">=20"
-      }
-    },
-    "node_modules/libsodium-sumo": {
-      "version": "0.8.4",
-      "resolved": "https://registry.npmjs.org/libsodium-sumo/-/libsodium-sumo-0.8.4.tgz",
-      "integrity": "sha512-TMtHShQfVVsaxDygyapvUC3o7YsPgXa/hRWeIgzyFz6w5k/1hirGptCxp1U7XwW3rCskaTTYKgV10v86UiGgNw==",
-      "license": "ISC"
-    },
-    "node_modules/libsodium-wrappers-sumo": {
-      "version": "0.8.4",
-      "resolved": "https://registry.npmjs.org/libsodium-wrappers-sumo/-/libsodium-wrappers-sumo-0.8.4.tgz",
-      "integrity": "sha512-ql7hcgulKZ3ekfa2DGAogcCKsWU0diA/0nArz1CFzh93WQdb46/Kj18ka/Hifq6uA3Ush34Pc6vU/6HXeRwUkg==",
-      "license": "ISC",
-      "dependencies": {
-        "libsodium-sumo": "^0.8.0"
-      }
-    },
-    "node_modules/ws": {
-      "version": "8.21.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.1.tgz",
-      "integrity": "sha512-+0NTnW77fFN/DjQi6k/Sq/Yvk4Sgajw7urW8V+asjXnRgDs9gyGkdb7EzgfhA4goXsRIZKE28fzIXBHEzhuiWw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=10.0.0"
-      },
-      "peerDependencies": {
-        "bufferutil": "^4.0.1",
-        "utf-8-validate": ">=5.0.2"
-      },
-      "peerDependenciesMeta": {
-        "bufferutil": {
-          "optional": true
-        },
-        "utf-8-validate": {
-          "optional": true
-        }
-      }
-    }
-  }
-}