@north-light/crouter 0.3.239 → 0.3.241

package/dist/commands/sys/context/admin/shell.js

@@ -1,7 +1,7 @@
-// The `crtr sys context admin` page: a snapshot rail, the document matrix, and
-// the dossier that edits one document's routing. The rail decides WHAT is being
-// planned, the matrix shows WHERE every document lands, and the dossier is the
-// only place a write starts.
+// The `crtr sys context admin` page: a rail, the document matrix, and the
+// dossier that edits one document's routing. The rail decides WHAT is being
+// planned and WHICH slice of it is shown, the matrix shows WHERE every document
+// lands, and the dossier is the only place a write starts.
 import { Input, matchesKey, truncateToWidth, visibleWidth, } from '@earendil-works/pi-tui';
 import { formatGesture, matchesPiTuiInput, } from '../../../../core/keybindings/index.js';
 import { runTuiPage } from '../../../../core/tui/page-host.js';
@@ -10,14 +10,26 @@ import { RUNGS, SURFACE_EVENTS, SURFACE_RUNGS, } from '../../../../core/substrat
 import { profileNameFor } from '../../../../core/substrate/subject-fields.js';
 import { editBufferInEditor } from '../../../../clients/inbox/review/roundtrip.js';
 import { capOwnerFor, moveDoc, readBody, readOnlyReason, toggleFlag, writeBody, writeCap, writeGate, writeRoutingLine, writeShortForm, writeSurfaces, } from './actions.js';
-import { axesOf, cycleAxis, setTypedAxis, renderAxes, typedAxisValue } from './axes-panel.js';
+import { axesOf, cycleAxis, cycleFacet, facetsOf, renderRail, setTypedAxis, typedAxisValue, } from './rail-panel.js';
 import { ContextDetailPanel } from './detail-panel.js';
 import { ContextDocsPanel, buildRows } from './docs-panel.js';
-import { PlanSet, plural } from './model.js';
+import { NO_FILTERS, costTotals } from './list-view.js';
+import { PlanSet, formatCost, plural } from './model.js';
 const RAIL_WIDTH = 26;
-const DOCS_WIDTH = 38;
 const RAIL_MIN_TOTAL_WIDTH = 86;
 const THREE_COLUMN_MIN_WIDTH = 112;
+/** Columns the two dividers between the three zones spend. */
+const DIVIDER_WIDTH = 6;
+/** Below the floor a row cannot hold a name beside the matrix; above the
+ *  ceiling extra width stops buying legibility and the dossier wants it. */
+const DOCS_MIN_WIDTH = 48;
+const DOCS_MAX_WIDTH = 100;
+const DOCS_SHARE = 0.45;
+/** The list's share of what is left after the rail and the dividers. */
+function docsWidthFor(width) {
+    const room = Math.max(1, width - RAIL_WIDTH - DIVIDER_WIDTH);
+    return Math.max(DOCS_MIN_WIDTH, Math.min(DOCS_MAX_WIDTH, Math.floor(room * DOCS_SHARE)));
+}
 export class ContextAdminShell {
     tui;
     terminalRows;
@@ -25,8 +37,12 @@ export class ContextAdminShell {
     suspendForChild;
     snapshot;
     plans;
-    zone = 'axes';
-    axisIndex = 0;
+    zone = 'rail';
+    railIndex = 0;
+    filters = NO_FILTERS;
+    rows = [];
+    /** The search field owns the keyboard while it is open. */
+    searching = false;
     docs;
     detail = new ContextDetailPanel();
     modal;
@@ -64,14 +80,23 @@ export class ContextAdminShell {
      *  the remaining events fill in behind it. */
     rebuild(selectedKey) {
         this.plans.plan(this.snapshot.event);
-        this.docs.setRows(buildRows(this.plans, this.snapshot.event), selectedKey ?? this.docs.selected?.key);
+        this.rows = buildRows(this.plans, this.snapshot.event);
+        this.docs.setRows(this.rows, this.snapshot.event, selectedKey ?? this.docs.selected?.key);
         this.syncDetail();
         this.plans.warm(() => {
-            this.docs.setRows(buildRows(this.plans, this.snapshot.event), this.docs.selected?.key);
+            this.rows = buildRows(this.plans, this.snapshot.event);
+            this.docs.setRows(this.rows, this.snapshot.event, this.docs.selected?.key);
             this.syncDetail();
             this.tui.requestRender();
         });
     }
+    /** A filter never re-plans: it is a question about the plan already computed,
+     *  which is what keeps a facet change instant on a corpus this size. */
+    setFilters(next) {
+        this.filters = next;
+        this.docs.setFilters(next);
+        this.syncDetail();
+    }
     syncDetail() {
         const row = this.docs.selected;
         const capOwner = row === undefined ? null : capOwnerFor(row.anchor, this.snapshot.profileId);
@@ -124,8 +149,8 @@ export class ContextAdminShell {
             this.handleModal(data);
             return;
         }
-        if (this.docs.ownsKeyboard && this.docs.handleInput(data)) {
-            this.syncDetail();
+        if (this.searching) {
+            this.handleSearch(data);
             return;
         }
         const step = this.cyclesEvent(data);
@@ -137,32 +162,48 @@ export class ContextAdminShell {
             this.close();
             return;
         }
-        if (this.zone === 'axes')
-            this.handleAxes(data);
+        if (this.zone === 'rail')
+            this.handleRail(data);
         else if (this.zone === 'docs')
             this.handleDocs(data);
         else
             this.handleDetail(data);
     }
-    handleAxes(data) {
+    /** The rail's rows are the snapshot axes followed by the filter facets, so
+     *  one cursor and one gesture drive both sections. */
+    handleRail(data) {
         const axes = axesOf(this.snapshot, profileNameFor(this.snapshot.profileId) ?? 'none');
-        this.axisIndex = Math.max(0, Math.min(this.axisIndex, axes.length - 1));
-        const axis = axes[this.axisIndex];
+        const facets = facetsOf(this.filters);
+        const total = axes.length + facets.length;
+        this.railIndex = Math.max(0, Math.min(this.railIndex, total - 1));
+        const axis = axes[this.railIndex];
+        const facet = facets[this.railIndex - axes.length];
+        const change = (delta) => {
+            if (axis !== undefined) {
+                if (axis.typed)
+                    this.openAxisField(axis.id, axis.label);
+                else
+                    this.setSnapshot(cycleAxis(this.snapshot, axis.id, delta));
+            }
+            else if (facet !== undefined) {
+                if (facet.typed)
+                    this.openSearch();
+                else
+                    this.setFilters(cycleFacet(this.filters, facet.id, delta));
+            }
+        };
         if (this.isDown(data)) {
-            this.axisIndex = Math.min(axes.length - 1, this.axisIndex + 1);
+            this.railIndex = Math.min(total - 1, this.railIndex + 1);
         }
         else if (this.isUp(data)) {
-            this.axisIndex = Math.max(0, this.axisIndex - 1);
+            this.railIndex = Math.max(0, this.railIndex - 1);
         }
         else if (matchesKey(data, 'space') || this.matches('crtr.setup.toggle', data)) {
-            if (axis.typed)
-                this.openAxisField(axis.id, axis.label);
-            else
-                this.setSnapshot(cycleAxis(this.snapshot, axis.id, 1));
+            change(1);
         }
         else if (this.isDescend(data)) {
-            if (matchesKey(data, 'enter') && axis.typed)
-                this.openAxisField(axis.id, axis.label);
+            if (matchesKey(data, 'enter') && (axis?.typed === true || facet?.typed === true))
+                change(1);
             else
                 this.zone = 'docs';
         }
@@ -171,11 +212,10 @@ export class ContextAdminShell {
         }
     }
     handleDocs(data) {
-        if (this.docs.handleInput(data)) {
-            this.syncDetail();
-            return;
+        if (data === '/' || matchesKey(data, '/')) {
+            this.openSearch();
         }
-        if (this.isDown(data)) {
+        else if (this.isDown(data)) {
             this.docs.move(1);
             this.syncDetail();
         }
@@ -183,18 +223,48 @@ export class ContextAdminShell {
             this.docs.move(-1);
             this.syncDetail();
         }
-        else if (matchesKey(data, 'd')) {
-            this.docs.toggleDeliveringOnly();
+        else if (matchesKey(data, 'space') || this.matches('crtr.setup.toggle', data)) {
+            this.docs.toggleGroup();
             this.syncDetail();
         }
         else if (this.isDescend(data)) {
-            if (this.docs.selected !== undefined)
+            if (this.docs.onGroup) {
+                this.docs.toggleGroup();
+                this.syncDetail();
+            }
+            else if (this.docs.selected !== undefined)
                 this.zone = 'detail';
         }
+        else if (matchesKey(data, 'escape') && this.filters.query !== '') {
+            this.setFilters({ ...this.filters, query: '' });
+        }
         else if (this.isAscend(data) || matchesKey(data, 'escape')) {
-            this.zone = 'axes';
+            this.zone = 'rail';
         }
     }
+    openSearch() {
+        this.searching = true;
+        this.zone = 'docs';
+        this.tui.requestRender();
+    }
+    /** Typing filters live, so the field is the list's own heading rather than a
+     *  modal over the rows it is selecting. */
+    handleSearch(data) {
+        if (matchesKey(data, 'escape')) {
+            this.searching = false;
+            this.setFilters({ ...this.filters, query: '' });
+        }
+        else if (matchesKey(data, 'enter')) {
+            this.searching = false;
+        }
+        else if (matchesKey(data, 'backspace')) {
+            this.setFilters({ ...this.filters, query: this.filters.query.slice(0, -1) });
+        }
+        else if (data.length === 1 && data.charCodeAt(0) >= 32) {
+            this.setFilters({ ...this.filters, query: this.filters.query + data });
+        }
+        this.tui.requestRender();
+    }
     handleDetail(data) {
         if (this.isDown(data))
             this.detail.move(1);
@@ -570,15 +640,15 @@ export class ContextAdminShell {
             return theme.fg('dim', 'y/enter confirm · n/esc cancel');
         if (this.modal?.kind === 'field')
             return theme.fg('dim', 'type · enter apply · esc cancel');
-        if (this.docs.ownsKeyboard)
-            return theme.fg('dim', 'type to filter · enter keep · esc clear');
+        if (this.searching)
+            return theme.fg('dim', 'type to search names · enter keep · esc clear');
         if (this.notice !== undefined)
             return theme.fg(this.notice.ok ? 'success' : 'warning', truncateToWidth(this.notice.text, width));
         const move = `${this.label('crtr.setup.list-down', 'j')}/${this.label('crtr.setup.list-up', 'k')}`;
-        const left = this.zone === 'axes'
-            ? `${move} axis · space change · enter documents`
+        const left = this.zone === 'rail'
+            ? `${move} row · space change · enter documents`
             : this.zone === 'docs'
-                ? `${move} doc · / filter · d ${this.docs.filteringDelivering ? 'all' : 'delivering'} · enter dossier`
+                ? `${move} row · space ${this.docs.onGroup ? 'open group' : 'group'} · / search · enter dossier`
                 : `${move} field · enter edit · e add · x remove · g gate · b body · u unlisted · s slash · m cap · r rename`;
         const right = `${this.label('crtr.setup.tab-next', 'tab')} event · ${this.label('crtr.setup.cancel', 'q')} close`;
         const gap = width - visibleWidth(left) - visibleWidth(right);
@@ -591,14 +661,26 @@ export class ContextAdminShell {
         const bodyHeight = Math.max(1, height - PAGE_CHROME_ROWS);
         const railVisible = width >= RAIL_MIN_TOTAL_WIDTH;
         const axes = axesOf(this.snapshot, profileNameFor(this.snapshot.profileId) ?? 'none');
-        this.axisIndex = Math.max(0, Math.min(this.axisIndex, axes.length - 1));
+        const facets = facetsOf(this.filters);
+        this.railIndex = Math.max(0, Math.min(this.railIndex, axes.length + facets.length - 1));
+        const rail = (railWidth) => renderRail({
+            axes,
+            facets,
+            index: this.railIndex,
+            width: railWidth,
+            height: bodyHeight,
+            focused: this.zone === 'rail',
+            matched: this.docs.visibleCount,
+            total: this.rows.length,
+        });
         let body;
         if (width >= THREE_COLUMN_MIN_WIDTH) {
-            const detailWidth = Math.max(1, width - RAIL_WIDTH - DOCS_WIDTH - 6);
-            const middle = columns(this.docs.render(DOCS_WIDTH, bodyHeight, this.zone === 'docs', this.plans), DOCS_WIDTH, this.modal === undefined
+            const docsWidth = docsWidthFor(width);
+            const detailWidth = Math.max(1, width - RAIL_WIDTH - docsWidth - DIVIDER_WIDTH);
+            const middle = columns(this.docs.render(docsWidth, bodyHeight, this.zone === 'docs', this.plans), docsWidth, this.modal === undefined
                 ? this.detail.render(detailWidth, bodyHeight, this.zone === 'detail')
                 : this.renderModal(detailWidth, bodyHeight), detailWidth);
-            body = columns(renderAxes(axes, this.axisIndex, RAIL_WIDTH, bodyHeight, this.zone === 'axes'), RAIL_WIDTH, middle, width - RAIL_WIDTH - 3);
+            body = columns(rail(RAIL_WIDTH), RAIL_WIDTH, middle, width - RAIL_WIDTH - 3);
         }
         else if (railVisible) {
             const panelWidth = width - RAIL_WIDTH - 3;
@@ -607,13 +689,13 @@ export class ContextAdminShell {
                 : this.zone === 'detail'
                     ? this.detail.render(panelWidth, bodyHeight, true)
                     : this.docs.render(panelWidth, bodyHeight, this.zone === 'docs', this.plans);
-            body = columns(renderAxes(axes, this.axisIndex, RAIL_WIDTH, bodyHeight, this.zone === 'axes'), RAIL_WIDTH, panel, panelWidth);
+            body = columns(rail(RAIL_WIDTH), RAIL_WIDTH, panel, panelWidth);
         }
         else if (this.modal !== undefined) {
             body = this.renderModal(width, bodyHeight);
         }
-        else if (this.zone === 'axes') {
-            body = renderAxes(axes, this.axisIndex, width, bodyHeight, true);
+        else if (this.zone === 'rail') {
+            body = rail(width);
         }
         else if (this.zone === 'detail') {
             body = this.detail.render(width, bodyHeight, true);
@@ -624,6 +706,7 @@ export class ContextAdminShell {
         const pending = SURFACE_EVENTS.filter((event) => this.plans.peek(event) === undefined).length;
         const meta = [
             this.snapshot.event,
+            this.costMeta(),
             pending > 0 ? `${plural(pending, 'event', 'events')} planning` : 'all events planned',
             this.edited.size > 0 ? `${plural(this.edited.size, 'doc', 'docs')} edited` : '',
         ]
@@ -631,6 +714,19 @@ export class ContextAdminShell {
             .join(' · ');
         return pageFrame({ width, height, title: 'crouter context', meta, body, footer: this.footer(width) });
     }
+    /** What the delivering documents spend on this event. An estimate, and a
+     *  floor on the rendered prompt: boot wraps these documents in its own intro
+     *  prose and catalog tree. */
+    costMeta() {
+        const { total, byRung } = costTotals(this.rows, this.snapshot.event);
+        if (total === 0)
+            return 'no documents delivered';
+        const split = ['content', 'preview', 'name']
+            .filter((rung) => byRung[rung] > 0)
+            .map((rung) => `${formatCost(byRung[rung]).replace('~', '')} ${rung}`)
+            .join(' · ');
+        return `docs load ${formatCost(total)} — ${split}`;
+    }
 }
 /** Every field here is an edit-or-accept, never a blank to retype, so the
  *  cursor lands at the end (`\x05`) — `setValue` alone leaves it at 0, where

package/dist/commands/sys/context/admin.js

@@ -10,6 +10,7 @@ import { ApiError } from '../../../api/index.js';
 import { cliClient } from '../../api-client.js';
 import { SURFACE_EVENTS } from '../../../core/substrate/schema.js';
 import { ambientMemoryTarget } from '../../../core/memory-resolver.js';
+import { getDefaultProfileId } from '../../../core/profiles/default-binding.js';
 import { resolveProfileOperand } from '../../../core/profiles/manifest.js';
 export const adminLeaf = defineLeaf({
     name: 'admin',
@@ -49,15 +50,16 @@ export const adminLeaf = defineLeaf({
         const ambient = ambientMemoryTarget();
         const profileId = input['profile']?.trim();
         const cwd = input['cwd']?.trim();
+        const resolvedCwd = cwd === undefined || cwd === '' ? (node?.cwd ?? ambient.cwd) : resolvePath(cwd);
         const seed = {
             kind: input['kind']?.trim() || node?.kind || 'general',
             mode: input['mode'] ?? node?.mode ?? 'base',
             lifecycle: node?.lifecycle ?? 'terminal',
             hasManager: node?.parent != null,
             profileId: profileId === undefined || profileId === ''
-                ? (node?.profile_id ?? ambient.profileId)
+                ? (node?.profile_id ?? ambient.profileId ?? getDefaultProfileId(resolvedCwd))
                 : resolveProfileOperand(profileId).profileId,
-            cwd: cwd === undefined || cwd === '' ? (node?.cwd ?? ambient.cwd) : resolvePath(cwd),
+            cwd: resolvedCwd,
             nodeId: node?.node_id ?? null,
             depth: node === null ? 0 : await spineDepth(node),
             event: (input['event'] ?? 'boot'),

package/dist/commands/sys/context/resolve.js

@@ -23,6 +23,7 @@ import { clearSessionCache } from '../../../core/substrate/session-cache.js';
 import { rungAtLeast, SURFACE_EVENTS, } from '../../../core/substrate/schema.js';
 import { scopeForCwd, profileNameFor } from '../../../core/substrate/subject-fields.js';
 import { resetScopeCache } from '../../../core/scope.js';
+import { getDefaultProfileId } from '../../../core/profiles/default-binding.js';
 export const resolveLeaf = defineLeaf({
     name: 'resolve',
     description: 'resolve what a configuration snapshot loads for one surface event',
@@ -95,7 +96,10 @@ export async function buildSnapshot(input) {
         ?? derived?.lifecycle
         ?? (mode === 'orchestrator' ? 'resident' : 'terminal');
     const cwd = resolveCwd(optionalString(input['cwd']) ?? derived?.cwd ?? process.cwd());
-    const profileId = optionalString(input['profile']) ?? node?.profile_id ?? ambientMemoryTarget().profileId;
+    const profileId = optionalString(input['profile'])
+        ?? node?.profile_id
+        ?? ambientMemoryTarget().profileId
+        ?? getDefaultProfileId(cwd);
     const hasManagerFlag = optionalString(input['hasManager']);
     return {
         subject: {

package/dist/core/bash-jobs.d.ts

@@ -14,6 +14,11 @@ export interface BashJobPaths {
     jobPgid: string;
     /** Human-readable label supplied with the bash call, when any. */
     jobPurpose: string;
+    /** Epoch-ms cancel deadline for an AUTO-backgrounded job. Present only when
+     * the valve backgrounded the job on its own; its presence marks the job as
+     * subject to the daemon's claim-or-cancel deadline. Absent for a deliberate
+     * handoff (tmux menu, broker termination), which runs to completion. */
+    jobDeadline: string;
 }
 /** A purpose is display text, never shell input. Keep the file-backed control
  * plane to one bounded, visible line so old or hand-written job directories
@@ -31,6 +36,17 @@ export declare function readJobPgid(contextDir: string, jobId: string): number |
 /** The optional human-readable job label. Jobs created before labels existed
  * have no file and deliberately project null. */
 export declare function readJobPurpose(contextDir: string, jobId: string): string | null;
+/** The auto-background cancel deadline (epoch ms), or undefined for a job with
+ * no deadline (a deliberate handoff, or a legacy job dir). A non-finite or
+ * malformed file reads as no deadline rather than an instant expiry. */
+export declare function readJobDeadlineMs(contextDir: string, jobId: string): number | undefined;
+/** Arm or move an auto-backgrounded job's cancel deadline to `deadlineMs`
+ * (epoch ms). Written by the valve at auto-handoff and rewritten when the
+ * owning node claims more time. */
+export declare function writeJobDeadlineMs(paths: BashJobPaths, deadlineMs: number): void;
+/** Drop a job's cancel deadline so it runs to completion — the node has claimed
+ * it. Best-effort: a job with no deadline file is already in this state. */
+export declare function clearJobDeadline(paths: BashJobPaths): void;
 /** Whether a persisted job supervisor process group is still present. EPERM
  *  means the group exists but cannot be signaled by this process; it is still
  *  live for the status surface. */
@@ -88,12 +104,19 @@ export interface BashJobStatus {
     purpose: string | null;
     startedAtMs: number;
     logPath: string;
+    /** Auto-background cancel deadline (epoch ms), or null for a job that runs to
+     * completion (a deliberate handoff, or one the node has claimed). */
+    deadlineAtMs: number | null;
 }
 /** Every live backgrounded bash job for this node — job.bg present, job.exit
  * absent — whether handed off by the menu, the valve deadline, or broker
  * termination. Read-only; never mutates. Skips malformed/partially-written
  * directories. Returns oldest-first by startedAtMs. */
 export declare function activeBackgroundBashJobs(contextDir: string): BashJobStatus[];
+/** Every live background job for this node whose auto-cancel deadline has
+ * passed at `now`. The daemon's deadline lane stops exactly these. A job with
+ * no deadline (deliberate handoff, or one the node claimed) never appears. */
+export declare function expiredAutoBackgroundBashJobs(contextDir: string, now: number): BashJobStatus[];
 export type BackgroundBashJobResult = 'backgrounded' | 'already-backgrounded' | 'finished' | 'missing';
 /** Atomically hand one foreground job to its detached supervisor. The rename
  * is the ownership decision: exactly one caller can move job.run to job.bg,

package/dist/core/bash-jobs.js

@@ -3,7 +3,7 @@
 // job.bg, while foreground completion renames it to job.done. The detached
 // supervisor can therefore outlive pi and still decide whether to report exit.
 import { randomBytes } from 'node:crypto';
-import { closeSync, existsSync, openSync, readdirSync, readFileSync, readSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { closeSync, existsSync, openSync, readdirSync, readFileSync, readSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 const MAX_BASH_JOB_PURPOSE_BYTES = 280;
 /** A purpose is display text, never shell input. Keep the file-backed control
@@ -42,6 +42,7 @@ export function bashJobPaths(contextDir, jobId) {
         jobDone: join(dir, 'job.done'),
         jobPgid: join(dir, 'job.pgid'),
         jobPurpose: join(dir, 'purpose'),
+        jobDeadline: join(dir, 'job.deadline'),
     };
 }
 /** The job's supervisor process group, or undefined for a job started before
@@ -65,6 +66,34 @@ export function readJobPurpose(contextDir, jobId) {
         return null;
     }
 }
+/** The auto-background cancel deadline (epoch ms), or undefined for a job with
+ * no deadline (a deliberate handoff, or a legacy job dir). A non-finite or
+ * malformed file reads as no deadline rather than an instant expiry. */
+export function readJobDeadlineMs(contextDir, jobId) {
+    try {
+        const n = Number(readFileSync(bashJobPaths(contextDir, jobId).jobDeadline, 'utf8').trim());
+        return Number.isFinite(n) ? n : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Arm or move an auto-backgrounded job's cancel deadline to `deadlineMs`
+ * (epoch ms). Written by the valve at auto-handoff and rewritten when the
+ * owning node claims more time. */
+export function writeJobDeadlineMs(paths, deadlineMs) {
+    writeFileSync(paths.jobDeadline, `${Math.trunc(deadlineMs)}\n`);
+}
+/** Drop a job's cancel deadline so it runs to completion — the node has claimed
+ * it. Best-effort: a job with no deadline file is already in this state. */
+export function clearJobDeadline(paths) {
+    try {
+        rmSync(paths.jobDeadline, { force: true });
+    }
+    catch {
+        /* best-effort — worst case the daemon cancels it at the old deadline */
+    }
+}
 /** Whether a persisted job supervisor process group is still present. EPERM
  *  means the group exists but cannot be signaled by this process; it is still
  *  live for the status surface. */
@@ -222,10 +251,23 @@ export function activeBackgroundBashJobs(contextDir) {
         catch {
             continue;
         }
-        jobs.push({ jobId, command, purpose: readJobPurpose(contextDir, jobId), startedAtMs, logPath: paths.jobLog });
+        jobs.push({
+            jobId,
+            command,
+            purpose: readJobPurpose(contextDir, jobId),
+            startedAtMs,
+            logPath: paths.jobLog,
+            deadlineAtMs: readJobDeadlineMs(contextDir, jobId) ?? null,
+        });
     }
     return jobs.sort((a, b) => a.startedAtMs - b.startedAtMs);
 }
+/** Every live background job for this node whose auto-cancel deadline has
+ * passed at `now`. The daemon's deadline lane stops exactly these. A job with
+ * no deadline (deliberate handoff, or one the node claimed) never appears. */
+export function expiredAutoBackgroundBashJobs(contextDir, now) {
+    return activeBackgroundBashJobs(contextDir).filter((job) => job.deadlineAtMs !== null && now >= job.deadlineAtMs);
+}
 /** Atomically hand one foreground job to its detached supervisor. The rename
  * is the ownership decision: exactly one caller can move job.run to job.bg,
  * while the supervisor races to move the same source to job.done. */

package/dist/core/canvas/browse/model.d.ts

@@ -55,15 +55,6 @@ export declare function buildTree(rows: DashboardRow[], rootIds: string[], child
  *  reaped node's parent so a non-leaf reap never orphans them out of view. No-op
  *  if the id is absent. */
 export declare function pruneNode(tree: Tree, id: string): void;
-/** Case-insensitive subsequence match: every char of `query` appears in `text`
- *  in order (gaps allowed). Empty query matches everything. Substrings are a
- *  subsequence, so this subsumes substring matching too. */
-export declare function fuzzyMatch(query: string, text: string): boolean;
-/** Indices in `text` consumed by a greedy left-to-right subsequence match of
- *  `query` — the same walk as `fuzzyMatch`, but returning WHICH chars matched so
- *  the renderer can highlight them. Empty set when `query` is empty OR does not
- *  fully match (no partial highlights). */
-export declare function matchIndices(query: string, text: string): Set<number>;
 /** One word-wrapped preview line: its text + the column indices WITHIN that text
  *  to highlight (the query match). */
 export interface SnippetLine {

package/dist/core/canvas/browse/model.js

@@ -5,6 +5,7 @@
 // access (dashboardRowsAll / listNodes / subscriptionsOf) into buildTree, then
 // drives flatten() on each keystroke.
 import { isFinishedWork, isLiveStatus, statusRank } from '../node-order.js';
+import { matchIndices } from '../../tui/fuzzy.js';
 export const TABS = ['All', 'Live', 'Dormant', 'Attention', 'Pinned'];
 export const SORTS = ['tree', 'attention', 'relevance', 'recency'];
 /** Does a node belong to this tab's slice?
@@ -119,43 +120,6 @@ export function pruneNode(tree, id) {
     }
     tree.nodes.delete(id);
 }
-// Fuzzy match
-/** Case-insensitive subsequence match: every char of `query` appears in `text`
- *  in order (gaps allowed). Empty query matches everything. Substrings are a
- *  subsequence, so this subsumes substring matching too. */
-export function fuzzyMatch(query, text) {
-    if (query === '')
-        return true;
-    const q = query.toLowerCase();
-    const t = text.toLowerCase();
-    let qi = 0;
-    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
-        if (t[ti] === q[qi])
-            qi++;
-    }
-    return qi === q.length;
-}
-/** Indices in `text` consumed by a greedy left-to-right subsequence match of
- *  `query` — the same walk as `fuzzyMatch`, but returning WHICH chars matched so
- *  the renderer can highlight them. Empty set when `query` is empty OR does not
- *  fully match (no partial highlights). */
-export function matchIndices(query, text) {
-    const out = new Set();
-    if (query === '')
-        return out;
-    const q = query.toLowerCase();
-    const t = text.toLowerCase();
-    let qi = 0;
-    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
-        if (t[ti] === q[qi]) {
-            out.add(ti);
-            qi++;
-        }
-    }
-    if (qi < q.length)
-        out.clear(); // no full match → no highlight
-    return out;
-}
 /** Chars of leading context kept before the match start when windowing. */
 const SNIPPET_LEAD = 12;
 /** The literal case-insensitive substring span in a conversation preview.

package/dist/core/canvas/browse/render.js

@@ -12,7 +12,8 @@
 // reverse) is allowed always. See detectColorCaps() for the gate, and the
 // canvas-browse color spec for the rationale + palette.
 import { STATUS_GLYPH, STATUS_COLOR, isFrozenRow, resolveNodeVisual, faultSummary } from '../status-glyph.js';
-import { TABS, matchIndices, promptText, previewSnippet } from './model.js';
+import { TABS, promptText, previewSnippet } from './model.js';
+import { matchIndices } from '../../tui/fuzzy.js';
 // Span/color primitives live in core/tui/draw.ts (one copy, shared with the
 // `crtr view` host). Re-export the color caps so browse's importers + tests keep
 // resolving them from this module.

package/dist/core/runtime/tmux-bindings.js

@@ -36,9 +36,10 @@ const LEAF_MENU_ACTIONS = {
     // default dialog-sized popup clipped both the rail and the models matrix.
     'crtr.tmux.menu.providers': { description: 'settings', action: { kind: 'popup', run: 'sys settings', size: { w: '90%', h: '85%' } } },
     'crtr.tmux.menu.plugins': { description: 'plugins', action: { kind: 'popup', run: 'pkg browse', size: { w: '90%', h: '85%' } } },
-    // Three zones side by side; the snapshot rail and document list both lose
-    // usable width before the dossier does, so this takes the settings size.
-    'crtr.tmux.menu.context-admin': { description: 'context surface', action: { kind: 'popup', run: 'sys context admin', size: { w: '90%', h: '85%' } } },
+    // Three zones side by side over a corpus of hundreds of documents: the list
+    // spends every column it is given on canonical names. Near-full rather than
+    // full, so the pane border still marks it as a popup.
+    'crtr.tmux.menu.context-admin': { description: 'context surface', action: { kind: 'popup', run: 'sys context admin', size: { w: '98%', h: '96%' } } },
     'crtr.tmux.menu.graph': { description: 'canvas graph', action: { kind: 'keys', keys: '/graph' } },
     'crtr.tmux.menu.focus-manager': { description: 'go to manager', action: { kind: 'command', run: 'surface node focus {manager}' } },
     'crtr.tmux.menu.copy-id': { description: 'copy node id', action: { kind: 'command', run: 'surface node id --pane {pane}' } },

package/dist/core/tui/fuzzy.d.ts

@@ -0,0 +1,9 @@
+/** Case-insensitive subsequence match: every char of `query` appears in `text`
+ *  in order (gaps allowed). Empty query matches everything. Substrings are a
+ *  subsequence, so this subsumes substring matching too. */
+export declare function fuzzyMatch(query: string, text: string): boolean;
+/** Indices in `text` consumed by a greedy left-to-right subsequence match of
+ *  `query` — the same walk as `fuzzyMatch`, but returning WHICH chars matched so
+ *  the renderer can highlight them. Empty set when `query` is empty OR does not
+ *  fully match (no partial highlights). */
+export declare function matchIndices(query: string, text: string): Set<number>;

package/dist/core/tui/fuzzy.js

@@ -0,0 +1,38 @@
+// Subsequence matching for TUI filters. One definition, shared by the canvas
+// browser and the context admin list, so the two surfaces cannot drift apart.
+/** Case-insensitive subsequence match: every char of `query` appears in `text`
+ *  in order (gaps allowed). Empty query matches everything. Substrings are a
+ *  subsequence, so this subsumes substring matching too. */
+export function fuzzyMatch(query, text) {
+    if (query === '')
+        return true;
+    const q = query.toLowerCase();
+    const t = text.toLowerCase();
+    let qi = 0;
+    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+        if (t[ti] === q[qi])
+            qi++;
+    }
+    return qi === q.length;
+}
+/** Indices in `text` consumed by a greedy left-to-right subsequence match of
+ *  `query` — the same walk as `fuzzyMatch`, but returning WHICH chars matched so
+ *  the renderer can highlight them. Empty set when `query` is empty OR does not
+ *  fully match (no partial highlights). */
+export function matchIndices(query, text) {
+    const out = new Set();
+    if (query === '')
+        return out;
+    const q = query.toLowerCase();
+    const t = text.toLowerCase();
+    let qi = 0;
+    for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+        if (t[ti] === q[qi]) {
+            out.add(ti);
+            qi++;
+        }
+    }
+    if (qi < q.length)
+        out.clear(); // no full match → no highlight
+    return out;
+}

package/dist/core/wake.d.ts

@@ -35,6 +35,9 @@ export type Recur = {
 };
 /** Cadence floor: reject any interval / cron min-spacing below this (AC-N4). */
 export declare const CADENCE_FLOOR_MS = 60000;
+/** Total ms for a relative-duration string (`90s`, `10m`, `1h30m`), or null if
+ * it is not one. */
+export declare function parseDurationMs(s: string): number | null;
 /**
  * Resolve a `<when>` to a single UTC `fireAt`:
  *   - relative duration (`90s`, `1h30m`)        -> now + Σ