@molecule/api-ai-tools 1.13.1 → 1.14.0

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-22T07:11:20.054Z
+Generated: 2026-10-23T00:59:47.543Z
 -->
 
 # @molecule/api-ai-tools
@@ -140,6 +140,13 @@ still names the deployed host (xr-molecule-flash-m103 +28:08).
 
 ```typescript
 interface LocatedCommandSegment {
+  /**
+   * Directory-scope ancestry supplied by the existing shell parse, outermost first.
+   * Parenthesized groups and nested `sh -c` strings have their own shell directory;
+   * braces share their parent's. Identities are opaque and local to this invocation.
+   * Absent for ordinary statements in the outer shell, preserving their existing shape.
+   */
+  shellScope?: readonly string[]
   /**
    * What the statement runs, or null when it only sets variables (`BASE=http://…` on its own):
    * that shape persists in the shell, so a caller following assignments across `;`/`&&` has to
@@ -148,6 +155,13 @@ interface LocatedCommandSegment {
   segment: CommandSegment | null
   /** The statement's own leading `NAME=value` words, as written (`TEST_MODE=fullstack`). */
   assignments: readonly string[]
+  /**
+   * Assignments whose values expand at this source statement, when different from
+   * inherited environment bindings. A nested `sh -c` carries outer bindings into
+   * every entry, but expands its caller's assignment values only before its first
+   * command. Absent when the ordinary `assignments` list is also the source list.
+   */
+  sourceAssignments?: readonly string[]
   /**
    * The offset in the command of the statement's first word, or null for a segment inside a
    * nested `sh -c '<command>'` string — its positions are offsets in THAT string, not in this
@@ -1491,6 +1505,19 @@ interface SuiteRunPipelinePlacement {
 }
 ```
 
+#### `RunningLogRead`
+
+A bounded, contiguous read of a running task's own log.
+
+```typescript
+interface RunningLogRead {
+  /** The log's last {@link RUNNING_LOG_READ_BYTES} bytes, contiguous, as one string. */
+  text: string
+  /** How many bytes the WHOLE log holds, or null when the read did not answer its size. */
+  bytes: number | null
+}
+```
+
 #### `FailedTest`
 
 One failed test, as a running suite's log names it.
@@ -1845,6 +1872,23 @@ function commandSegments(command: string): CommandSegment[]
 
 **Returns:** One entry per statement or pipeline stage that runs something, in order.
 
+#### `commandSubstitutions(command)`
+
+The direct executable command-substitution bodies in shell text, in source order.
+
+Uses the same quote, comment and heredoc boundaries as {@link executedCommands}.
+Single-quoted and escaped text is inert. Nested substitutions stay inside their
+parent's body so a caller can recurse with a separate working-directory scope
+for each body; a `cd` inside one must not affect its sibling or the outer shell.
+
+```typescript
+function commandSubstitutions(command: string): string[]
+```
+
+- `command` — The shell text to read, including any leading assignments.
+
+**Returns:** Each direct `$(…)` or backtick body, without its delimiters.
+
 #### `executedCommands(command)`
 
 Every command a shell command actually executes, at any depth — the statements themselves, the
@@ -2691,7 +2735,9 @@ positional selection the run carried (a spec file, a suite directory or a regex
 The re-run keeps the run's `> <file>` redirect only in the sense of keeping its OUTPUT there:
 the target is rewritten to a fresh sibling ({@link redirectRunnerOutputsToFreshFiles}), so a
 re-run never overwrites the log the run itself is the evidence for (xr-molecule-flash-m173) —
-and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429).
+and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429). A
+`tail`/`head`/`cat`/`grep` chained after the run that reads that exact log is shown the fresh
+sibling instead, so the re-run displays the run it performed (xr-molecule-flash-o03).
 
 `config` is the config the run was measured under ({@link withSuiteConfig}): the narrowed re-run
 carries it whenever the command itself does not, so a run that dropped `--config` cannot be
@@ -2890,6 +2936,26 @@ function moleculeDistReadNote(path: string): string | null
 
 **Returns:** The note, or null when the path is not inside a package's `dist`.
 
+#### `registeredTaskLogCommand(taskId)`
+
+The command that reads a REGISTERED background task's own log as one bounded contiguous window
+({@link runningLogReadCommand}), with the file its launch redirects to when the launch recorded
+one.
+
+The task id is the ownership: it is the handle `wait_for_task` returned, `/tmp/${taskId}.log` is
+the log this platform's launcher writes for it, and the redirect target is the file this
+process's own launch registered for that id — never a path parsed out of a command by the
+caller. A diagnosis that reads a running walk must not build a `/tmp` path of its own
+(xr-molecule-flash-l07: the wait's DISPLAY was diagnosed as if it were the log).
+
+```typescript
+function registeredTaskLogCommand(taskId: string): string | null
+```
+
+- `taskId` — The `mol-bg-…` handle the wait returned.
+
+**Returns:** The read command, or null when the handle is not a task id this platform minted.
+
 #### `shellInstalledPackageProbe(run)`
 
 Build an {@link InstalledPackageProbe} from a shell runner (a backend's
@@ -4213,6 +4279,42 @@ function runningCauseCommand(log: string, own?: string): string
 
 **Returns:** The shell command, safe to hand to the execution backend as-is.
 
+#### `runningLogReadCommand(log, own)`
+
+The shell command whose stdout is a bounded CONTIGUOUS read of a running task's own log: the
+log's byte size, then its last {@link RUNNING_LOG_READ_BYTES} bytes.
+
+{@link runningOutputSliceCommand} is the wrong read for a diagnosis, and l07 is the finding: it
+stitches the first 40 grep-selected failure lines to the last 1 000 bytes with a blank line
+between, so the tail is DISJOINT from the headers above it. Read as one log, the last numbered
+header absorbs whatever the tail starts with — a clipped skipped-test title became the cause of
+a genuine failure (xr-molecule-flash-l07). A contiguous window can only ever hold real
+neighbouring lines of one log.
+
+The size rides along so a caller can say when the window is only the log's end
+({@link parseRunningLogRead}); without it a tail reads as the whole run.
+
+```typescript
+function runningLogReadCommand(log: string, own?: string): string
+```
+
+- `log` — The task log path.
+- `own` — A file the command redirects its own output to, if any.
+
+**Returns:** The shell command, safe to hand to the execution backend as-is.
+
+#### `parseRunningLogRead(stdout)`
+
+The two parts of {@link runningLogReadCommand}'s answer.
+
+```typescript
+function parseRunningLogRead(stdout: string): RunningLogRead | null
+```
+
+- `stdout` — The command's stdout.
+
+**Returns:** The window and the whole log's byte size, or null when the size line is absent (the read did not run, so nothing may be said about the log).
+
 #### `repeatingFailure(log)`
 
 The cause repeating among a running suite's failures, or null.
@@ -5185,6 +5287,14 @@ Bytes of a running log a repeating-cause look reads back.
 const REPEATING_CAUSE_TAIL_BYTES: 40000
 ```
 
+#### `RUNNING_LOG_READ_BYTES`
+
+Bytes of a running log a diagnostic note reads back: one {@link REPEATING_CAUSE_TAIL_BYTES} window.
+
+```typescript
+const RUNNING_LOG_READ_BYTES: 40000
+```
+
 #### `REPEATING_FAILURE_MIN`
 
 DISTINCT tests that must share one signature before a running suite's repeating cause is named.

package/dist/command-position.d.ts

@@ -90,6 +90,18 @@ export interface ExecutedCommand {
     /** The program and its arguments as one line, what a pattern anchored at the program matches. */
     text: string;
 }
+/**
+ * The direct executable command-substitution bodies in shell text, in source order.
+ *
+ * Uses the same quote, comment and heredoc boundaries as {@link executedCommands}.
+ * Single-quoted and escaped text is inert. Nested substitutions stay inside their
+ * parent's body so a caller can recurse with a separate working-directory scope
+ * for each body; a `cd` inside one must not affect its sibling or the outer shell.
+ *
+ * @param command - The shell text to read, including any leading assignments.
+ * @returns Each direct `$(…)` or backtick body, without its delimiters.
+ */
+export declare function commandSubstitutions(command: string): string[];
 /**
  * Every command a shell command actually executes, at any depth — the statements themselves, the
  * body of a `sh -c '<command>'`, and the body of every command substitution (`$(…)`, backticks).
@@ -122,6 +134,13 @@ export declare function executedCommands(command: string): ExecutedCommand[];
  * still names the deployed host (xr-molecule-flash-m103 +28:08).
  */
 export interface LocatedCommandSegment {
+    /**
+     * Directory-scope ancestry supplied by the existing shell parse, outermost first.
+     * Parenthesized groups and nested `sh -c` strings have their own shell directory;
+     * braces share their parent's. Identities are opaque and local to this invocation.
+     * Absent for ordinary statements in the outer shell, preserving their existing shape.
+     */
+    shellScope?: readonly string[];
     /**
      * What the statement runs, or null when it only sets variables (`BASE=http://…` on its own):
      * that shape persists in the shell, so a caller following assignments across `;`/`&&` has to
@@ -130,6 +149,13 @@ export interface LocatedCommandSegment {
     segment: CommandSegment | null;
     /** The statement's own leading `NAME=value` words, as written (`TEST_MODE=fullstack`). */
     assignments: readonly string[];
+    /**
+     * Assignments whose values expand at this source statement, when different from
+     * inherited environment bindings. A nested `sh -c` carries outer bindings into
+     * every entry, but expands its caller's assignment values only before its first
+     * command. Absent when the ordinary `assignments` list is also the source list.
+     */
+    sourceAssignments?: readonly string[];
     /**
      * The offset in the command of the statement's first word, or null for a segment inside a
      * nested `sh -c '<command>'` string — its positions are offsets in THAT string, not in this

package/dist/command-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-position.d.ts","sourceRoot":"","sources":["../src/command-position.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-position.d.ts","sourceRoot":"","sources":["../src/command-position.ts"],"names":[],"mappings":"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"}

package/dist/command-position.js

@@ -32,10 +32,246 @@
  *
  * @module
  */
-/** A command's words, quotes kept whole — the same reading a printed-source check uses. */
-const WORD = /"(?:\\.|[^"\\])*"|'[^']*'|\S+/g;
 /** Shell words that stand alone: grouping, never an argument. */
 const GROUPING = new Set(['(', ')', '{', '}']);
+/** The index just past a single-quoted string that starts at `at` (its opening quote). */
+function singleQuotedEnd(text, at) {
+    const close = text.indexOf("'", at + 1);
+    return close === -1 ? text.length : close + 1;
+}
+/**
+ * The index just past a double-quoted string that starts at `at`. A command substitution or a
+ * backtick inside it is skipped as a unit, because a `"` inside one belongs to the nested command,
+ * not to this string (`DIR="$(cd "$(dirname "$0")" && pwd)"`).
+ */
+function doubleQuotedEnd(text, at) {
+    let i = at + 1;
+    while (i < text.length) {
+        const char = text[i] ?? '';
+        if (char === '\\') {
+            i += 2;
+            continue;
+        }
+        if (char === '"')
+            return i + 1;
+        if (char === '`') {
+            i = backtickEnd(text, i);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '(') {
+            i = substitutionEnd(text, i + 2);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '{') {
+            i = parameterEnd(text, i + 2);
+            continue;
+        }
+        i += 1;
+    }
+    return text.length;
+}
+/** The index just past a backtick substitution that starts at `at` (`\`` is literal, not a close). */
+function backtickEnd(text, at) {
+    let i = at + 1;
+    while (i < text.length) {
+        if (text[i] === '\\') {
+            i += 2;
+            continue;
+        }
+        if (text[i] === '`')
+            return i + 1;
+        i += 1;
+    }
+    return text.length;
+}
+/**
+ * The index just past a `$( … )` command substitution whose body starts at `at`. The body is NOT
+ * evaluated and its whitespace splits nothing: only its closing `)` is looked for, through quotes,
+ * escapes and nested substitutions. An unclosed substitution runs to the end of the text.
+ */
+function substitutionEnd(text, at) {
+    let depth = 1;
+    let i = at;
+    while (i < text.length) {
+        const char = text[i] ?? '';
+        // A `#` in the nested command starts a comment, so a `$(` or `)` inside it is data — the same
+        // reading `splitCommand` makes (`$(printf x # $(` opens nothing).
+        if (char === '#' && commentStartsAt(text, i)) {
+            const newline = text.indexOf('\n', i);
+            i = newline === -1 ? text.length : newline;
+            continue;
+        }
+        if (char === '\\') {
+            i += 2;
+            continue;
+        }
+        if (char === "'") {
+            i = singleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '"') {
+            i = doubleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '`') {
+            i = backtickEnd(text, i);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '(') {
+            i = substitutionEnd(text, i + 2);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '{') {
+            i = parameterEnd(text, i + 2);
+            continue;
+        }
+        if (char === '(')
+            depth += 1;
+        else if (char === ')') {
+            depth -= 1;
+            if (depth === 0)
+                return i + 1;
+        }
+        i += 1;
+    }
+    return text.length;
+}
+/** The index just past a `${ … }` parameter expansion whose body starts at `at`. */
+function parameterEnd(text, at) {
+    let depth = 1;
+    let i = at;
+    while (i < text.length) {
+        const char = text[i] ?? '';
+        if (char === '\\') {
+            i += 2;
+            continue;
+        }
+        if (char === "'") {
+            i = singleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '"') {
+            i = doubleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '`') {
+            i = backtickEnd(text, i);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '(') {
+            i = substitutionEnd(text, i + 2);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '{') {
+            depth += 1;
+            i += 2;
+            continue;
+        }
+        if (char === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return i + 1;
+        }
+        i += 1;
+    }
+    return text.length;
+}
+/**
+ * The index just past the shell word that starts at `at` (a non-whitespace character): a word ends
+ * at unquoted whitespace, and every quoted part, command substitution (`$( … )`, backticks),
+ * parameter expansion (`${ … }`) and process substitution (`<( … )`) inside it is skipped as a
+ * unit — so the spaces in `UID_VAL=h$(date +%s)` belong to that one word.
+ *
+ * Nothing is evaluated or expanded: this finds word BOUNDARIES only, and returns the text as
+ * written. A backslash-newline is a line continuation, so it ends the word and is skipped.
+ */
+function shellWordEnd(text, at) {
+    let i = at;
+    while (i < text.length) {
+        const char = text[i] ?? '';
+        if (/\s/.test(char))
+            break;
+        // Grouping punctuation is a shell operator, never part of the word beside it (`tail -25)`,
+        // `(npx …`), so a caller can step over the closer the way it always has.
+        if (GROUPING.has(char))
+            break;
+        if (char === '\\') {
+            if (text[i + 1] === '\n')
+                break;
+            i += 2;
+            continue;
+        }
+        if (char === "'") {
+            i = singleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '"') {
+            i = doubleQuotedEnd(text, i);
+            continue;
+        }
+        if (char === '`') {
+            i = backtickEnd(text, i);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '(') {
+            i = substitutionEnd(text, i + 2);
+            continue;
+        }
+        if (char === '$' && text[i + 1] === '{') {
+            i = parameterEnd(text, i + 2);
+            continue;
+        }
+        if ((char === '<' || char === '>') && text[i + 1] === '(') {
+            i = substitutionEnd(text, i + 2);
+            continue;
+        }
+        i += 1;
+    }
+    return i;
+}
+/** One text's shell words, quotes kept, grouping punctuation still its own word. */
+function shellWordSpans(text) {
+    const words = [];
+    let i = 0;
+    while (i < text.length) {
+        const char = text[i] ?? '';
+        if (char === '\\' && text[i + 1] === '\n') {
+            i += 2;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            i += 1;
+            continue;
+        }
+        if (GROUPING.has(char)) {
+            words.push({ text: char, start: i });
+            i += 1;
+            continue;
+        }
+        const end = shellWordEnd(text, i);
+        words.push({ text: text.slice(i, end), start: i });
+        i = end;
+    }
+    return words;
+}
+/**
+ * The words {@link segmentWords} keeps, with the offset each was written at: quotes kept whole,
+ * grouping words dropped, and a leading `(`/`{` taken off the first word. One walk answers both
+ * readings, so a caller splicing text at a word's offset and a caller matching that word can
+ * never disagree.
+ */
+function segmentWordSpans(text) {
+    const words = shellWordSpans(text).filter((word) => !GROUPING.has(word.text));
+    const first = words[0];
+    if (first !== undefined) {
+        const bare = first.text.replace(/^[({]+/, '');
+        if (bare === '')
+            words.shift();
+        else if (bare !== first.text)
+            words[0] = { text: bare, start: first.start + (first.text.length - bare.length) };
+    }
+    return words;
+}
 /**
  * A redirection written as ONE word, its target attached: `2>&1`, `>out.log`, `&>/dev/null`,
  * `<<'EOF'`. Matched against a word of the statement, so a redirect's target written as its own
@@ -707,6 +943,8 @@ function splitCommand(command) {
     const source = blankHeredocBodies(command);
     const parts = [];
     const substitutions = [];
+    const subshells = [];
+    const subshellOpens = [];
     /** Where each open `$(` body starts; -1 for a bare `(` opened inside one. */
     const subOpens = [];
     /** Where each open backtick body starts. */
@@ -855,11 +1093,18 @@ function splitCommand(command) {
         // `{ … }` writes through that group, so the depth travels with every character a caller
         // reading a redirect may ask about.
         if (char === '(' || char === '{') {
+            if (char === '(')
+                subshellOpens.push(i + 1);
             put(char);
             groupDepth += 1;
             continue;
         }
         if (char === ')' || char === '}') {
+            if (char === ')') {
+                const start = subshellOpens.pop();
+                if (start !== undefined)
+                    subshells.push({ start, end: i });
+            }
             groupDepth = Math.max(0, groupDepth - 1);
             put(char);
             continue;
@@ -903,7 +1148,9 @@ function splitCommand(command) {
         });
         lastAfter = part.after;
     }
-    return { parts: out, substitutions };
+    for (const start of subshellOpens)
+        subshells.push({ start, end: source.length });
+    return { parts: out, substitutions, subshells };
 }
 /**
  * A command's statements and pipeline stages — {@link splitCommand}'s parts on their own.
@@ -980,20 +1227,8 @@ function redirectTargetOf(text, depths, program, args) {
  * @returns The words.
  */
 function segmentWords(text) {
-    const words = text.match(WORD) ?? [];
-    const cleaned = words.filter((word) => !GROUPING.has(word));
-    const first = cleaned[0];
-    if (first !== undefined) {
-        const bare = first.replace(/^[({]+/, '');
-        if (bare === '')
-            cleaned.shift();
-        else
-            cleaned[0] = bare;
-    }
-    return cleaned;
+    return segmentWordSpans(text).map((word) => word.text);
 }
-/** {@link WORD} anchored at an offset, for walking a statement's raw words. */
-const WORD_AT = new RegExp(WORD.source, 'y');
 /**
  * A statement's own leading `NAME=value` words, and where they end.
  *
@@ -1008,19 +1243,25 @@ function leadingAssignments(text) {
     const words = [];
     let at = 0;
     for (let guard = 0; guard < MAX_WRAPPERS; guard++) {
-        while (at < text.length && /\s/.test(text[at] ?? ''))
+        while (at < text.length) {
+            if (text[at] === '\\' && text[at + 1] === '\n') {
+                at += 2;
+                continue;
+            }
+            if (!/\s/.test(text[at] ?? ''))
+                break;
             at += 1;
+        }
         // Grouping in front of the statement (`(npx …)`, `{ …`): not a word the shell assigns with.
         if (text[at] === '(' || text[at] === '{') {
             at += 1;
             continue;
         }
-        WORD_AT.lastIndex = at;
-        const match = WORD_AT.exec(text);
-        if (!match || !ENV_ASSIGNMENT.test(match[0]))
+        const word = text.slice(at, shellWordEnd(text, at));
+        if (!ENV_ASSIGNMENT.test(word))
             return { words, end: at };
-        words.push(match[0]);
-        at += match[0].length;
+        words.push(word);
+        at += word.length;
     }
     return { words, end: at };
 }
@@ -1117,6 +1358,31 @@ function executedCommandsOf(command, depth) {
     }
     return out;
 }
+/**
+ * The direct executable command-substitution bodies in shell text, in source order.
+ *
+ * Uses the same quote, comment and heredoc boundaries as {@link executedCommands}.
+ * Single-quoted and escaped text is inert. Nested substitutions stay inside their
+ * parent's body so a caller can recurse with a separate working-directory scope
+ * for each body; a `cd` inside one must not affect its sibling or the outer shell.
+ *
+ * @param command - The shell text to read, including any leading assignments.
+ * @returns Each direct `$(…)` or backtick body, without its delimiters.
+ */
+export function commandSubstitutions(command) {
+    if (typeof command !== 'string' || !command.trim())
+        return [];
+    const { substitutions } = splitCommand(command);
+    const bodies = [];
+    let parentEnd = -1;
+    for (const { start, end } of substitutions.sort((a, b) => a.start - b.start || b.end - a.end)) {
+        if (start < parentEnd)
+            continue;
+        bodies.push(command.slice(start, end));
+        parentEnd = end;
+    }
+    return bodies;
+}
 /**
  * Every command a shell command actually executes, at any depth — the statements themselves, the
  * body of a `sh -c '<command>'`, and the body of every command substitution (`$(…)`, backticks).
@@ -1154,29 +1420,7 @@ export function executedCommands(command) {
  * @returns The word's offset in `text`, or null when there is no such word.
  */
 function wordOffset(text, index) {
-    const placement = new RegExp(WORD.source, 'g');
-    let kept = 0;
-    let first = true;
-    for (let match = placement.exec(text); match !== null; match = placement.exec(text)) {
-        if (GROUPING.has(match[0]))
-            continue;
-        if (first) {
-            first = false;
-            const bare = match[0].replace(/^[({]+/, '');
-            // `segmentWords` shifts a first word that was nothing but grouping away, so the NEXT word
-            // is not stripped and is counted from zero.
-            if (bare === '')
-                continue;
-            if (kept === index)
-                return match.index + (match[0].length - bare.length);
-            kept += 1;
-            continue;
-        }
-        if (kept === index)
-            return match.index;
-        kept += 1;
-    }
-    return null;
+    return segmentWordSpans(text)[index]?.start ?? null;
 }
 /**
  * Every statement of a command, with its own assignments and where it sits — assignment-only
@@ -1289,9 +1533,9 @@ export function statementArgumentEnd(command, start, end) {
         }
         at = cursor - 1;
     }
-    const words = [...command.slice(start, at).matchAll(new RegExp(WORD.source, 'g'))].map((m) => ({
-        text: m[0],
-        index: start + (m.index ?? 0),
+    const words = shellWordSpans(command.slice(start, at)).map((word) => ({
+        text: word.text,
+        index: start + word.start,
     }));
     // A trailing redirection belongs to the statement but is not an argument of its program. An
     // option written after it would still parse, but the option belongs with the program's own
@@ -1404,7 +1648,8 @@ function locatedSegmentsOf(command, depth) {
     if (typeof command !== 'string' || depth > MAX_NESTING)
         return [];
     const out = [];
-    for (const part of splitSegments(command)) {
+    const { parts, subshells } = splitCommand(command);
+    for (const part of parts) {
         const words = segmentWords(part.text);
         const start = commandStart(words);
         const leading = leadingAssignments(part.text);
@@ -1428,6 +1673,12 @@ function locatedSegmentsOf(command, depth) {
                 : part.start + (wordOffset(part.text, start.envInsert) ?? leading.end),
             programOffset: words[start.at] === undefined ? null : part.start + (wordOffset(part.text, start.at) ?? 0),
         };
+        const scopeAt = placed.programOffset ?? part.start + (wordOffset(part.text, 0) ?? 0);
+        const shellScope = subshells
+            .filter(({ start, end }) => start <= scopeAt && scopeAt < end)
+            .sort((a, b) => a.start - b.start)
+            .map(({ start }) => `group:${start}`);
+        const scoped = shellScope.length === 0 ? {} : { shellScope };
         // The runner the word RUNS names, when that is not the word's own name (`node <path>/playwright`
         // is a `playwright` invocation, xr-molecule-flash-m179).
         const program = words[start.at] === undefined ? '' : (start.program ?? programName(words[start.at] ?? ''));
@@ -1441,9 +1692,14 @@ function locatedSegmentsOf(command, depth) {
                     continue;
                 out.push({
                     ...entry,
+                    shellScope: [...shellScope, `shell:${part.start}`, ...(entry.shellScope ?? [])],
                     // The variables this statement bound before the shell reached it are the nested
                     // command's too: `env BASE_URL=… sh -c '… npx playwright test …'` passes them down.
                     assignments: [...new Set([...assignments, ...entry.assignments])],
+                    sourceAssignments: [
+                        ...(i === 0 ? assignments : []),
+                        ...(entry.sourceAssignments ?? entry.assignments),
+                    ],
                     // A nested statement's positions are positions in the nested string, not in this
                     // command. The FIRST one keeps this statement's own separator: the shell reads the
                     // nested string where this statement stands.
@@ -1469,6 +1725,7 @@ function locatedSegmentsOf(command, depth) {
             if (assignments.length > 0)
                 out.push({
                     segment: null,
+                    ...scoped,
                     assignments,
                     ...placed,
                     programOffset: null,
@@ -1479,6 +1736,7 @@ function locatedSegmentsOf(command, depth) {
             continue;
         }
         out.push({
+            ...scoped,
             segment: {
                 program,
                 args,
@@ -1554,16 +1812,13 @@ export function withoutTimeoutWrapper(command, which) {
             continue;
         // Every word in front of the program: the assignments and the wrappers. The duration belongs
         // to the wrapper, so the walk has to see the words, not just the parse's total bound.
-        const prefix = command.slice(located.start, located.programOffset);
-        const words = [];
-        const at = new RegExp(WORD.source, 'g');
-        for (let match = at.exec(prefix); match !== null; match = at.exec(prefix)) {
-            words.push({
-                text: match[0],
-                start: located.start + match.index,
-                end: located.start + match.index + match[0].length,
-            });
-        }
+        const start = located.start;
+        const prefix = command.slice(start, located.programOffset);
+        const words = shellWordSpans(prefix).map((word) => ({
+            text: word.text,
+            start: start + word.start,
+            end: start + word.start + word.text.length,
+        }));
         for (let i = 0; i < words.length; i += 1) {
             const word = words[i];
             if (word === undefined || programName(word.text) !== 'timeout')

package/dist/suite-overlap.d.ts

@@ -87,7 +87,9 @@ export declare function withSuiteConfig(command: string, config: string | null |
  * The re-run keeps the run's `> <file>` redirect only in the sense of keeping its OUTPUT there:
  * the target is rewritten to a fresh sibling ({@link redirectRunnerOutputsToFreshFiles}), so a
  * re-run never overwrites the log the run itself is the evidence for (xr-molecule-flash-m173) —
- * and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429).
+ * and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429). A
+ * `tail`/`head`/`cat`/`grep` chained after the run that reads that exact log is shown the fresh
+ * sibling instead, so the re-run displays the run it performed (xr-molecule-flash-o03).
  *
  * `config` is the config the run was measured under ({@link withSuiteConfig}): the narrowed re-run
  * carries it whenever the command itself does not, so a run that dropped `--config` cannot be

package/dist/suite-overlap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suite-overlap.d.ts","sourceRoot":"","sources":["../src/suite-overlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAaH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS1F;AAoOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,GAAE,SAAS,aAAa,EAAO,GACjC,MAAM,CAgDR;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAmCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,aAAa,EAAO,GAAG,MAAM,CAe3F;AAwOD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAMV;AA2FD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAYtF"}
+{"version":3,"file":"suite-overlap.d.ts","sourceRoot":"","sources":["../src/suite-overlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAaH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS1F;AA4VD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,GAAE,SAAS,aAAa,EAAO,GACjC,MAAM,CAgDR;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAmCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,aAAa,EAAO,GAAG,MAAM,CAe3F;AAwOD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAMV;AA2FD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAYtF"}

package/dist/suite-overlap.js

@@ -180,9 +180,10 @@ function applyTextEdits(command, edits) {
  * @param statement - The statement's text.
  * @param offset - The statement's offset in the command.
  * @param words - The command's word spans.
+ * @param fresh - The exact old file → fresh file mapping the edits make, filled in here.
  * @returns The edits, in statement order.
  */
-function freshRedirectEdits(statement, offset, words) {
+function freshRedirectEdits(statement, offset, words, fresh) {
     const edits = [];
     for (const match of statement.matchAll(FILE_REDIRECT)) {
         const before = match[1] ?? '';
@@ -203,7 +204,9 @@ function freshRedirectEdits(statement, offset, words) {
             continue;
         const quote = single !== undefined || double !== undefined ? 1 : 0;
         const start = offset + (match.index ?? 0) + before.length + op.length + space.length + quote;
-        edits.push({ start, end: start + target.length, text: `${target}.rerun.log` });
+        const rewritten = `${target}.rerun.log`;
+        fresh.set(target, rewritten);
+        edits.push({ start, end: start + target.length, text: rewritten });
     }
     return edits;
 }
@@ -217,9 +220,10 @@ function freshRedirectEdits(statement, offset, words) {
  *
  * @param statement - The stage's text.
  * @param offset - The stage's offset in the command.
+ * @param fresh - The exact old file → fresh file mapping the edits make, filled in here.
  * @returns The edits, in stage order.
  */
-function freshTeeEdits(statement, offset) {
+function freshTeeEdits(statement, offset, fresh) {
     const words = [...statement.matchAll(ARGUMENT_WORD)].map((match) => ({
         text: match[0],
         start: offset + (match.index ?? 0),
@@ -233,10 +237,12 @@ function freshTeeEdits(statement, offset) {
         if (!bare || bare.startsWith('-') || DEVICE_TARGET.test(bare))
             continue;
         const quote = /^['"]/.test(word.text) ? 1 : 0;
+        const rewritten = `${bare}.rerun.log`;
+        fresh.set(bare, rewritten);
         edits.push({
             start: word.start + quote,
             end: word.start + word.text.length - quote,
-            text: `${bare}.rerun.log`,
+            text: rewritten,
         });
     }
     return edits;
@@ -283,6 +289,113 @@ function runnerOutputStatements(command) {
     }
     return statements;
 }
+/**
+ * Readers whose non-flag operands are ALL files: a display of the run's own report. Every one of
+ * them is read-only, so moving its operand with the file it reads cannot change what it does.
+ */
+const FILE_READERS = new Set(['cat', 'head', 'tail']);
+/**
+ * grep-family readers: their first non-flag operand is the pattern, and the words after it are the
+ * files they display — unless a `-e`/`-f` flag named the pattern already.
+ */
+const GREP_READERS = new Set(['egrep', 'fgrep', 'grep']);
+/** grep's pattern flags: the word after one is a pattern (or a pattern file), never a file. */
+const GREP_PATTERN_FLAGS = new Set(['-e', '--regexp', '-f', '--file']);
+/**
+ * The postlude statements that DISPLAY the run's own report, with the exact file that run wrote
+ * pointed at the fresh sibling the re-run writes instead.
+ *
+ * xr-molecule-flash-o03 (2026-10-22; the stale-READ arm m248 filed at +25:55): the recipe the
+ * platform handed the executor ended `> /tmp/e2e-local.log.rerun.log 2>&1; echo EXIT=$?; tail -80
+ * /tmp/e2e-local.log`. The writer moved to the fresh sibling and the trailing tail did not, so the
+ * narrowed re-run displayed the walk it was narrowed FROM — the builder followed that recipe at
+ * +19:16 and read the previous walk's failures as the result of the run it had just done.
+ *
+ * Only the EXACT file a runner statement (or its `tee`) wrote moves, and only in a statement AFTER
+ * the run: the setup in front of it keeps every byte (m429), and a read of any other file is left
+ * alone. The value is compared whole — `/tmp/full.log` never matches `/tmp/full.log.bak` — and
+ * inside shell quotes the operand's own quoting survives (`"/tmp/my walk.log"` stays quoted).
+ *
+ * The bound is deliberate: a display this reader set does not recognise (a `wc`, a path held in a
+ * variable, a path the command builds) is left exactly as written rather than guessed at. Those
+ * shapes are not the ones the platform emits, and rewriting a word by resemblance is how m429's
+ * setup redirect was corrupted.
+ *
+ * @param command - The composed command.
+ * @param statements - The statements carrying the run's own output.
+ * @param fresh - The exact old file → fresh file mapping the redirect edits made.
+ * @returns The edits, in statement order.
+ */
+function freshReportReadEdits(command, statements, fresh) {
+    if (fresh.size === 0)
+        return [];
+    const after = Math.max(...statements.map((statement) => statement.end));
+    const edits = [];
+    for (const entry of locatedCommandSegments(command)) {
+        const segment = entry.segment;
+        const start = entry.start;
+        const end = entry.end;
+        const programOffset = entry.programOffset;
+        // Only a statement the parse placed and that runs AFTER the walk can display its report.
+        if (segment === null || start === null || end === null)
+            continue;
+        if (start < after || programOffset === null)
+            continue;
+        const allFiles = FILE_READERS.has(segment.program);
+        const grep = GREP_READERS.has(segment.program);
+        if (!allFiles && !grep)
+            continue;
+        const text = command.slice(start, end);
+        const words = [...text.matchAll(ARGUMENT_WORD)].map((match) => ({
+            text: match[0],
+            start: start + (match.index ?? 0),
+        }));
+        // The program word's own span, so the walk starts exactly where the parse says it does.
+        const program = words.findIndex((word) => word.start === programOffset);
+        if (program < 0)
+            continue;
+        /** grep still owes its pattern: the first bare operand is that pattern, not a file. */
+        let patternPending = grep;
+        for (let i = program + 1; i < words.length; i += 1) {
+            const word = words[i];
+            if (word === undefined)
+                break;
+            if (ARGUMENT_REDIRECT_OPERATOR.test(word.text)) {
+                // The operator's target is where the display WRITES, not a file it reads.
+                i += 1;
+                continue;
+            }
+            if (ARGUMENT_REDIRECT.test(word.text))
+                continue;
+            const flag = unquoted(word.text);
+            if (flag.startsWith('-') && flag !== '-') {
+                if (grep) {
+                    if (GREP_PATTERN_FLAGS.has(flag)) {
+                        patternPending = false;
+                        i += 1;
+                    }
+                    else if (/^(?:--(?:regexp|file)=|-[ef].)/.test(flag))
+                        patternPending = false;
+                }
+                continue;
+            }
+            if (patternPending) {
+                patternPending = false;
+                continue;
+            }
+            const to = fresh.get(unquoted(word.text));
+            if (to === undefined)
+                continue;
+            const quote = /^['"]/.test(word.text) ? 1 : 0;
+            edits.push({
+                start: word.start + quote,
+                end: word.start + word.text.length - quote,
+                text: to,
+            });
+        }
+    }
+    return edits;
+}
 /**
  * The command with the SUITE RUN's own log files pointed at fresh siblings, and nothing else
  * changed.
@@ -302,6 +415,12 @@ function runnerOutputStatements(command) {
  * source asset it lays down are the same shape: their targets stay byte-for-byte, and so does
  * every statement chained after the run (`; echo EXIT $? > /tmp/done`).
  *
+ * Every statement chained after the run (`; echo EXIT $? > /tmp/done`) is postlude and keeps its
+ * own writes, but the DISPLAY of the run's report is part of the same run: a `tail`, `head`, `cat`
+ * or `grep` after the run that reads the exact file it wrote is pointed at the fresh sibling too
+ * ({@link freshReportReadEdits}), so a re-run shows its own output instead of the walk's
+ * (xr-molecule-flash-o03).
+ *
  * @param command - The composed command.
  * @returns The command whose suite-run redirects write to a fresh target.
  */
@@ -311,12 +430,14 @@ function redirectRunnerOutputsToFreshFiles(command) {
         return command;
     const words = wordSpans(command);
     const edits = [];
+    const fresh = new Map();
     for (const statement of statements) {
         const text = command.slice(statement.start, statement.end);
-        edits.push(...freshRedirectEdits(text, statement.start, words));
+        edits.push(...freshRedirectEdits(text, statement.start, words, fresh));
         if (statement.tee)
-            edits.push(...freshTeeEdits(text, statement.start));
+            edits.push(...freshTeeEdits(text, statement.start, fresh));
     }
+    edits.push(...freshReportReadEdits(command, statements, fresh));
     return applyTextEdits(command, edits);
 }
 /**
@@ -329,7 +450,9 @@ function redirectRunnerOutputsToFreshFiles(command) {
  * The re-run keeps the run's `> <file>` redirect only in the sense of keeping its OUTPUT there:
  * the target is rewritten to a fresh sibling ({@link redirectRunnerOutputsToFreshFiles}), so a
  * re-run never overwrites the log the run itself is the evidence for (xr-molecule-flash-m173) —
- * and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429).
+ * and the setup around the run keeps its own file writes untouched (xr-molecule-flash-m429). A
+ * `tail`/`head`/`cat`/`grep` chained after the run that reads that exact log is shown the fresh
+ * sibling instead, so the re-run displays the run it performed (xr-molecule-flash-o03).
  *
  * `config` is the config the run was measured under ({@link withSuiteConfig}): the narrowed re-run
  * carries it whenever the command itself does not, so a run that dropped `--config` cannot be

package/dist/tools.d.ts

@@ -59,6 +59,21 @@ export declare const SUITE_OVER_BUDGET_ADVICE: string;
  * @returns The note, or null when the path is not inside a package's `dist`.
  */
 export declare function moleculeDistReadNote(path: string): string | null;
+/**
+ * The command that reads a REGISTERED background task's own log as one bounded contiguous window
+ * ({@link runningLogReadCommand}), with the file its launch redirects to when the launch recorded
+ * one.
+ *
+ * The task id is the ownership: it is the handle `wait_for_task` returned, `/tmp/${taskId}.log` is
+ * the log this platform's launcher writes for it, and the redirect target is the file this
+ * process's own launch registered for that id — never a path parsed out of a command by the
+ * caller. A diagnosis that reads a running walk must not build a `/tmp` path of its own
+ * (xr-molecule-flash-l07: the wait's DISPLAY was diagnosed as if it were the log).
+ *
+ * @param taskId - The `mol-bg-…` handle the wait returned.
+ * @returns The read command, or null when the handle is not a task id this platform minted.
+ */
+export declare function registeredTaskLogCommand(taskId: string): string | null;
 /**
  * What the filesystem says about a write target under `node_modules` — the half
  * of the decision a path's spelling cannot make.

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAgS9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAudD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAgInE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AA2DlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAq/FxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAgS9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAudD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiInE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AA2DlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAq/FxF"}

package/dist/tools.js

@@ -703,7 +703,7 @@ async function backgroundTaskState(backend, command, seconds, ceilingMs) {
 }
 import { suiteCommandTarget } from './suite-overlap.js';
 import { diagnosisTraceCommand } from './trace-artifacts.js';
-import { addedRedactionMask, BRACE_GLOB_HINT, checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, earlyReturnCause, emptyCallError, expandBraceGlob, failureCausesNote, findPathArgs, findPatternArgs, fusedLine, htmlOutline, isCommandTimeout, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isReadOnlyInspection, isSuiteRunCommand, linesWithinSerialized, literalDirPrefix, logShowsInlineFailureBodies, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_CALL_CHARS, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, READ_RESULT_ENVELOPE_CHARS, redactSecrets, redactSecretsInCode, repeatedSuiteRunError, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningOutputSliceCommand, searchTimeoutError, serializedChars, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunBudgetCommand, suiteRunConfigCommand, suiteRunPipelinePlacement, suiteRunPriorityLaunch, TOOL_RESULT_CHARS, truncateMiddle, universalCause, whitespaceTolerantReplace, withoutSuiteTimeout, withPlaywrightRunReport, } from './utilities.js';
+import { addedRedactionMask, BRACE_GLOB_HINT, checkBlockedCommand, declaredBudgetSeconds, DEFAULT_SEARCH_EXCLUDED_DIRS, directoryReadHint, earlyReturnCause, emptyCallError, expandBraceGlob, failureCausesNote, findPathArgs, findPatternArgs, fusedLine, htmlOutline, isCommandTimeout, isEnvFilePath, isOutsideRoot, isPlaywrightRunCommand, isReadOnlyInspection, isSuiteRunCommand, linesWithinSerialized, literalDirPrefix, logShowsInlineFailureBodies, MAX_BATCH_READ_FILES, MAX_FIND_RESULTS, MAX_HTML_INLINE_CHARS, MAX_OUTPUT_SIZE, MAX_READ_CALL_CHARS, MAX_READ_RETURN_CHARS, MAX_READ_SIZE, MAX_SEARCH_CONTEXT_LINES, MAX_SEARCH_RESULTS, MAX_WRITE_SIZE, outputIsWithheldUntilExit, outputRedirectTarget, parseCheckCommand, parseCheckProblem, pathArgError, READ_RESULT_ENVELOPE_CHARS, redactSecrets, redactSecretsInCode, repeatedSuiteRunError, repeatingFailure, repeatingFailureNote, resolvePath, RUNNING_FAILURE_LINES, runningCauseCommand, runningLogReadCommand, runningOutputSliceCommand, searchTimeoutError, serializedChars, shellQuote, sliceLines, SMALL_FILE_WHOLE_CHARS, streamingBackgroundCommand, stripControlChars, suiteRunBudgetCommand, suiteRunConfigCommand, suiteRunPipelinePlacement, suiteRunPriorityLaunch, TOOL_RESULT_CHARS, truncateMiddle, universalCause, whitespaceTolerantReplace, withoutSuiteTimeout, withPlaywrightRunReport, } from './utilities.js';
 /**
  * How long exec_command waits for a command it backgrounded only because the
  * command asked for more than the tool's ceiling, before handing back a task id.
@@ -840,6 +840,25 @@ export function moleculeDistReadNote(path) {
             ? ' The declarations above are generated from it.'
             : ' For one signature, read the matching .d.ts file.'));
 }
+/**
+ * The command that reads a REGISTERED background task's own log as one bounded contiguous window
+ * ({@link runningLogReadCommand}), with the file its launch redirects to when the launch recorded
+ * one.
+ *
+ * The task id is the ownership: it is the handle `wait_for_task` returned, `/tmp/${taskId}.log` is
+ * the log this platform's launcher writes for it, and the redirect target is the file this
+ * process's own launch registered for that id — never a path parsed out of a command by the
+ * caller. A diagnosis that reads a running walk must not build a `/tmp` path of its own
+ * (xr-molecule-flash-l07: the wait's DISPLAY was diagnosed as if it were the log).
+ *
+ * @param taskId - The `mol-bg-…` handle the wait returned.
+ * @returns The read command, or null when the handle is not a task id this platform minted.
+ */
+export function registeredTaskLogCommand(taskId) {
+    if (!TASK_ID.test(taskId))
+        return null;
+    return runningLogReadCommand(`/tmp/${taskId}.log`, outputFileByTask.get(taskId));
+}
 /**
  * The `node_modules` entry a path goes through, and the package name after it
  * (`null` when the path IS the entry).

package/dist/utilities.d.ts

@@ -964,6 +964,42 @@ export declare const REPEATING_CAUSE_TAIL_BYTES = 40000;
  * @returns The shell command, safe to hand to the execution backend as-is.
  */
 export declare function runningCauseCommand(log: string, own?: string): string;
+/** Bytes of a running log a diagnostic note reads back: one {@link REPEATING_CAUSE_TAIL_BYTES} window. */
+export declare const RUNNING_LOG_READ_BYTES = 40000;
+/** A bounded, contiguous read of a running task's own log. */
+export interface RunningLogRead {
+    /** The log's last {@link RUNNING_LOG_READ_BYTES} bytes, contiguous, as one string. */
+    text: string;
+    /** How many bytes the WHOLE log holds, or null when the read did not answer its size. */
+    bytes: number | null;
+}
+/**
+ * The shell command whose stdout is a bounded CONTIGUOUS read of a running task's own log: the
+ * log's byte size, then its last {@link RUNNING_LOG_READ_BYTES} bytes.
+ *
+ * {@link runningOutputSliceCommand} is the wrong read for a diagnosis, and l07 is the finding: it
+ * stitches the first 40 grep-selected failure lines to the last 1 000 bytes with a blank line
+ * between, so the tail is DISJOINT from the headers above it. Read as one log, the last numbered
+ * header absorbs whatever the tail starts with — a clipped skipped-test title became the cause of
+ * a genuine failure (xr-molecule-flash-l07). A contiguous window can only ever hold real
+ * neighbouring lines of one log.
+ *
+ * The size rides along so a caller can say when the window is only the log's end
+ * ({@link parseRunningLogRead}); without it a tail reads as the whole run.
+ *
+ * @param log - The task log path.
+ * @param own - A file the command redirects its own output to, if any.
+ * @returns The shell command, safe to hand to the execution backend as-is.
+ */
+export declare function runningLogReadCommand(log: string, own?: string): string;
+/**
+ * The two parts of {@link runningLogReadCommand}'s answer.
+ *
+ * @param stdout - The command's stdout.
+ * @returns The window and the whole log's byte size, or null when the size line is absent (the
+ *   read did not run, so nothing may be said about the log).
+ */
+export declare function parseRunningLogRead(stdout: string): RunningLogRead | null;
 /**
  * DISTINCT tests that must share one signature before a running suite's repeating cause is named.
  * A test the log prints twice, or a test that failed twice, is still one test.

package/dist/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}

package/dist/utilities.js

@@ -536,9 +536,25 @@ const PRINTING_REPORTERS = new Set(['list', 'line', 'dot', 'basic', 'spec']);
  * edited `app/src` while the run was still walking — which voids the run.
  */
 export const PLAYWRIGHT_FAILURES_INLINE_ENV = 'PLAYWRIGHT_LIST_PRINT_FAILURES_INLINE';
+/**
+ * A step that stores the status of the step before it in a variable: `__proof_slow=$?`.
+ *
+ * The variable name is the shell's own (`[A-Za-z_][A-Za-z0-9_]*`) and the value is EXACTLY the
+ * special parameter, bare or double-quoted, so nothing else can be running here. A capture whose
+ * value is anything else — `x=$(rebuild)`, `x=$?; rm -rf …` (a separate statement anyway) — is a
+ * program, not a status, and is not one of these.
+ */
+const STATUS_CAPTURE_STEP = /^[A-Za-z_][A-Za-z0-9_]*=(?:\$\?|"\$\?"|\$\{\?\})$/;
+/**
+ * The arithmetic body `exit $((…))` may carry and still run nothing: variable names, numbers and
+ * arithmetic operators only. No `$`, backtick, `;` or comma is allowed, so no command substitution
+ * and no expansion of a variable into something that runs can hide in it.
+ */
+const STATUS_EXIT_ARITHMETIC = /^[A-Za-z0-9_|&+\-*/%^<>=!~() \t]*$/;
 /**
  * Whether a command step only reports or discards the status of the steps before it: `echo EXIT
- * $?`, `echo $?`, `printf …`, `true`, `exit 0`.
+ * $?`, `echo $?`, `printf …`, `true`, `exit 0`, a status capture (`__proof_slow=$?`), or an
+ * `exit $((a | b))` over statuses already captured.
  *
  * The shape models and the platform's own re-run notes send routinely ends on one of these —
  * `npx playwright test … > /tmp/pw.log 2>&1; echo EXIT $?` — and reading the split's last part as
@@ -548,12 +564,33 @@ export const PLAYWRIGHT_FAILURES_INLINE_ENV = 'PLAYWRIGHT_LIST_PRINT_FAILURES_IN
  * punctuation are not part of the step; {@link streamingBackgroundCommand} strips those before
  * asking, and strips them here too for the split it is given.
  *
+ * A status CAPTURE is the same kind of step, and the platform's own chained proof walks end on a
+ * run of them: `… <browser run>; __proof_slow=$?; echo __PROOF_EXIT__ …; exit $((__proof_fast |
+ * __proof_slow))` (`chainedProofCommand`, molecule-dev `post-deploy-proof-run.ts`). Reading the
+ * browser half as a status step is what lets the run keep its reporter, its machine report and the
+ * inline-failure switch — without it, every platform proof ran its browser suite on the request's
+ * own `line` reporter, which writes no ✓/✘ mark and no per-failure error into the log the wait
+ * reads (xr-molecule-flash-x03 +27:44).
+ *
+ * Only the two shapes whose whole value is the shell's own status are read this way; anything that
+ * could run — a command substitution, a backticked word, a suffix after the status — stays a step.
+ *
  * @param step - One statement of the command, as the `&&`/`||`/`;` split left it.
  * @returns True when the step runs nothing but a status report.
  */
 function isStatusOnlyStep(step) {
-    const text = step.replace(/[\s)}]+$/, '').trim();
-    return /^(?:echo|printf)\b/.test(text) || /^true$/.test(text) || /^exit(?:\s+\S+)?$/.test(text);
+    const text = step.trim();
+    // An enclosing group's closer is punctuation, not part of the step — but the `))` that closes an
+    // arithmetic expansion is part of the statement, so that shape is read off the text as written.
+    const withoutCloser = text.replace(/[\s)}]+$/, '');
+    if (/^(?:echo|printf)\b/.test(withoutCloser) || /^true$/.test(withoutCloser))
+        return true;
+    if (/^exit(?:\s+\S+)?$/.test(withoutCloser))
+        return true;
+    if (STATUS_CAPTURE_STEP.test(withoutCloser))
+        return true;
+    const arithmetic = /^exit\s+\$\(\((.*)\)\)$/.exec(text);
+    return arithmetic !== null && STATUS_EXIT_ARITHMETIC.test(arithmetic[1] ?? '');
 }
 /**
  * Rewrite a command about to run in the background so its log grows while it
@@ -2423,6 +2460,43 @@ export function runningCauseCommand(log, own) {
     const read = `cat ${log}${own ? ` ${shellQuote(own)}` : ''} 2>/dev/null`;
     return `${read} | tail -c ${REPEATING_CAUSE_TAIL_BYTES}`;
 }
+/** Bytes of a running log a diagnostic note reads back: one {@link REPEATING_CAUSE_TAIL_BYTES} window. */
+export const RUNNING_LOG_READ_BYTES = REPEATING_CAUSE_TAIL_BYTES;
+/**
+ * The shell command whose stdout is a bounded CONTIGUOUS read of a running task's own log: the
+ * log's byte size, then its last {@link RUNNING_LOG_READ_BYTES} bytes.
+ *
+ * {@link runningOutputSliceCommand} is the wrong read for a diagnosis, and l07 is the finding: it
+ * stitches the first 40 grep-selected failure lines to the last 1 000 bytes with a blank line
+ * between, so the tail is DISJOINT from the headers above it. Read as one log, the last numbered
+ * header absorbs whatever the tail starts with — a clipped skipped-test title became the cause of
+ * a genuine failure (xr-molecule-flash-l07). A contiguous window can only ever hold real
+ * neighbouring lines of one log.
+ *
+ * The size rides along so a caller can say when the window is only the log's end
+ * ({@link parseRunningLogRead}); without it a tail reads as the whole run.
+ *
+ * @param log - The task log path.
+ * @param own - A file the command redirects its own output to, if any.
+ * @returns The shell command, safe to hand to the execution backend as-is.
+ */
+export function runningLogReadCommand(log, own) {
+    const read = `cat ${log}${own ? ` ${shellQuote(own)}` : ''} 2>/dev/null`;
+    return `{ ${read} | wc -c; ${read} | tail -c ${RUNNING_LOG_READ_BYTES}; }`;
+}
+/**
+ * The two parts of {@link runningLogReadCommand}'s answer.
+ *
+ * @param stdout - The command's stdout.
+ * @returns The window and the whole log's byte size, or null when the size line is absent (the
+ *   read did not run, so nothing may be said about the log).
+ */
+export function parseRunningLogRead(stdout) {
+    const sized = /^\s*(\d+)\s*\n/.exec(stdout);
+    if (sized === null)
+        return null;
+    return { text: stdout.slice(sized[0].length), bytes: Number(sized[1]) };
+}
 /**
  * DISTINCT tests that must share one signature before a running suite's repeating cause is named.
  * A test the log prints twice, or a test that failed twice, is still one test.
@@ -2513,6 +2587,12 @@ function failureBody(block) {
         .map((l) => l.replace(ANSI_SGR, '').trim())
         .filter((l) => l &&
         !LIST_RESULT_LINE.test(l) &&
+        // A SKIPPED test's own row (`  -  41 [chromium] › user-fetch-errors.spec.ts:88:3 › …`) is
+        // a progress line, never a failure's body: a block with no body of its own is followed by
+        // whatever the reporter printed next, and that row became the failure's "cause" when the
+        // wait's stitched display was read as one log (xr-molecule-flash-l07). A `- waiting for`
+        // call-log line stays — it names the locator, and the dash carries no index.
+        !/^\s*-\s+\d+\s+/.test(l) &&
         !/^(?:at\s|\d+ \||>\s*\d+ \||\|)/.test(l) &&
         !/^Error Context:/.test(l));
 }
@@ -3870,14 +3950,14 @@ regressedSpecs = []) {
             'handler shape, a header or CORS.');
     }
     // A text that is the TAIL of a longer log says so in its first line (`…(N earlier characters
-    // omitted)`, the shape `background-tasks` writes when a log is capped): what it holds is not
+    // omitted)`, or bytes for a byte-bounded read): what it holds is not
     // the run's list of failures, only the part that survived the cut. Saying "N failures in this
     // run" over it reads as complete, and did: xr-molecule-flash-m123's collected 42 KB diagnosis
     // log was clipped to its last 8 KB, and this note grouped 2 of the run's 14 failures under
     // "fix every cause below" while the 11 that shared the run's one real cause were gone
     // (2026-10-17). The root fix is to hand this function the whole log; this says so when a
     // caller cannot.
-    const clipped = /^…\((\d+) earlier characters omitted\)/.exec(log);
+    const clipped = /^…\((\d+) earlier (characters|bytes) omitted\)/.exec(log);
     // The missing-header reading leads the list: four unrelated locators failing while every
     // snapshot shows the page painted and un-navigated is ONE fact about the route, and the list
     // below would otherwise read as four separate defects (xr-molecule-flash-m193 rewrote the
@@ -3887,7 +3967,7 @@ regressedSpecs = []) {
     const header = (missingHeader === null ? '' : `${missingHeader}\n`) +
         (clipped !== null
             ? `${total} failure${total === 1 ? '' : 's'} in the LAST part of this run’s log — its ` +
-                `first ${clipped[1]} characters were clipped, so a cause that failed earlier is ` +
+                `first ${clipped[1]} ${clipped[2]} were clipped, so a cause that failed earlier is ` +
                 `missing here. Fix every cause below${connections.length > 0 ? ' the app’s code can produce, and re-send the connection error once as it is' : ''}, ` +
                 `and read the whole run log before concluding:\n`
             : `${total} failure${total === 1 ? '' : 's'} in this run, grouped by cause — fix every cause ` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-tools",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",