pier-setup 0.3.1 → 0.4.2

package/README.md

@@ -23,10 +23,13 @@ pier ships as **two halves**, installed separately:
 
 ### Highlights
 
-- **Todo loop**: `todo_write` with full-replace semantics, session JSONL as source of truth, correct branch rollback; live pane-title projection `▶i ○p ■b ✓c (N/M) · current task`; TUI widget is an activity-anchored window (the in_progress entry and its surrounding context stay visible as work moves down the list); `/todos` command (including unblock)
+- **Todo loop**: `todo_write` with full-replace semantics, session JSONL as source of truth, correct branch rollback; live pane-title projection `▶i ○p ■b ✓c (N/M) · current task`; `/todos` command (including unblock)
 - **Todo anti-freeze**: an all-completed list unchanged for ≥6 turns flips the read hook from recitation to a rewrite warning; after ≥1h it archives — first offering one rewrite window with old entries as reference, then (if ignored) a final notice that clears the list (rm persisted to JSONL; the empty guard takes over — multi-step work must re-track); `/todos` still shows history, session JSONL untouched
 - **Interactive subagents**: every subagent = an isolated pi session in its own pane (separate context window); **a human can enter that pane and talk to it directly** (fix bugs, take over, answer ask_user_question)
-- **Subagent output preview**: `subagent(action: "output", agentId)` returns what a running background subagent has printed since the previous call — an in-memory per-pane cursor computes the delta (`agent.read`, falling back to `pane.read` on older herdr), and the result carries status, revision, truncation and a `restart` flag for scrolled/cleared buffers, so the master can notice a stuck worker instead of waiting for settlement
+- **Delegation identity** (D111): spawn hands the worker a `PI_HERDR_DELEGATION` context (parent pane/session, taskId, task, role), replayed env > worker marker > branch fold; the worker's system prompt gains a `pier-delegation` section (identity + one stable delivery contract), its transcript opens with an "⟵ delegated by master …" card, and its pane title carries an `↳` prefix; `pi-parent`/`pi-task` herdr tokens ride their own report batch, the dashboard groups workers under their master, and blocked alerts name the edge (`worker ← master`)
+- **Task slugs** (D112): spawn allocates a task slug (numbered on collision); tool outputs print `slug@paneId` and `agentId` accepts the bare slug, bare pane id, or the combined form (the slug part survives a revive that changed the pane). A master bash call that sleeps ≥60 s while background workers run gets a note that the settlement notice arrives on its own (D125; the earlier `report_progress` tool was never called and is gone)
+- **Unified TUI status strip** (D113/D114): the resident widget is one line per agent — self as `▶ current item ✓done/total`, each running subagent as `↳ slug ▶ current item ✓d/n` (blocked shows the task + reason; settled rows never occupy the strip; a fully completed self list hides the widget instead of showing a bare `✓N/N`); workers push their full todo list over the pipe on every `todo_write` (event-driven, no polling), and `/pier-tree` opens the complete delegation tree (your todos + every worker's full list + settled nodes) in the shared Pier **popup** — the same singleton panel as `/dashboard`, opened on its `Tree` tab (inside the popup, `1`/`2`/`Tab` switch views; an explicit `/pier-tree overlay` keeps the independent full-window pane; non-Herdr falls back to the in-pane notify view); `/dashboard` opens the same panel on its `Dashboard` tab
+- **Subagent output preview**: `subagent(action: "output", agentId)` returns what a running background subagent has printed since the previous call — an in-memory per-pane cursor computes the delta (`agent.read`, falling back to `pane.read` on older herdr), and the result carries status, revision, truncation and a `restart` flag for scrolled/cleared buffers, so the master can notice a stuck worker instead of waiting for settlement. TUI chrome (frames, footer) is stripped; once the worker has finished, the complete transcript report replaces the pane's lossy rendered copy, and a later settlement notice points at that delivery instead of repeating it (D124)
 - **Soft write-locks**: per-pane lock beacons on `write`/`edit` paths; cross-pane conflicts warn (default) or block (`PI_HERDR_WRITE_LOCK=1`). The warning lists every holder; `/locks` is the human view of the same table (`herdr agent list` exposes the raw tokens to agents)
 - **Role profiles**: built-in `master` / `worker-default`; custom roles as `.pi-herdr/roles/<name>.json`; toolset converges per role (deny rules are not bypassable)
 - **Human gate**: subagent `ask_user_question` → sidebar blocked marker + notification; manual takeover (ESC-interrupt then typing) is heuristically detected so the master pauses/returns management automatically
@@ -45,8 +48,8 @@ pier ships as **two halves**, installed separately:
 ### Requirements
 
 - Node ≥ 22
-- pi ≥ 0.86.0 (`@earendil-works/pi-coding-agent`) — dynamic toolset (transcript-backed `setActiveTools` deltas) and role switching require it
-- herdr ≥ 0.9.0 (macOS / Linux / Windows; Windows is preview beta)
+- pi ≥ 1.3.0 (`@earendil-works/pi-coding-agent`) — `before_agent_start.messageType` and resumed-session active tools
+- herdr ≥ 0.9.5 (macOS / Linux / Windows; Windows is preview beta) — native `pane.focused`, self-reported resume, and shutdown-safe session saves
 
 ### One-shot install (recommended)
 
@@ -162,16 +165,15 @@ Runtime policies and operational limits are centralized in `runtime-policy.ts` (
 |---|---|---|---|
 | `PIER_SUBAGENT_TIMEOUT_MS` | `600000` | ms | Subagent inactivity budget / overall timeout before forced termination |
 | `PIER_SETTLEMENT_WINDOW_MS` | `60000` | ms | Settlement notice window, machine injection grace period, and takeover idle threshold |
-| `PIER_OBSERVATION_WINDOW_MS` | `30000` | ms | Post-settle observation window before auto-consuming finished subagents |
+| `PIER_OBSERVATION_WINDOW_MS` | `30000` | ms | Post-settle observation window before auto-consuming finished subagents; skipped when the worker's transcript already holds a finalized answer and its pane is idle |
 | `PIER_FOREGROUND_PATIENCE_MS` | `300000` | ms | Foreground execution patience before auto-demoting a subagent to background |
 | `PIER_GC_TICK_MS` | `30000` | ms | Subagent garbage collection ticker interval |
 | `PIER_POLL_INTERVAL_MS` | `30000` | ms | State observation polling interval for subagent state transitions |
 | `PIER_READY_TIMEOUT_MS` | `90000` | ms | Subagent pane pipe readiness wait (exponential backoff; a pane that exited fails immediately with its last output attached) |
 | `PIER_SESSION_TTL_SECONDS` | `600` | s | Session retention TTL after subagent exit before GC cleanup |
 | `PIER_GIT_TIMEOUT_MS` | `10000` | ms | Execution timeout for git operations (worktree creation, diff summary, cleanup) |
-| `PIER_FOCUS_POLL_MS` | `1500` / `0` | ms | Focus sampling for heat layout (`0` disables). Default 1500ms on Herdr <0.9.1; 0 (event-first) on 0.9.1+ |
 | `PIER_TERM_READ_MAX` | `8000` | chars | Maximum terminal buffer characters read per operation |
-| `PIER_TERM_IDLE_MS` | `1800000` | ms | Idle time before pier nudges about an open terminal |
+| `PIER_TERM_IDLE_MS` | `300000` | ms | Idle time before the second terminal-cleanup nudge (one is sent at turn end for a terminal used that turn) |
 | `PIER_TODO_GRACE_MS` | `30000` | ms | Settle grace before the unfinished-todo reminder |
 | `PIER_TRACE` | – | flag | Write diagnostics (tool renderers, swallowed errors) to stderr |
 | `PIER_JEV_ENABLE` | `0` | flag | Jev decision layer (TypeSafe System One classification) master switch; every call site fails open — see `docs/rfc-jev-integration.md` |
@@ -189,15 +191,26 @@ processes stay as they are (`PI_HERDR_SUBAGENT`, `PI_HERDR_ROLE_MANIFEST`, `PI_H
 `/pier-config doctor` lists every option with its effective value and where it came from, plus the
 errors pier deliberately swallowed this session.
 
-**Focus heat:** Herdr 0.9.0 resolved mouse focus in the client and did not deliver `pane.focused`
-to plugins, so each pane sampled `layout.export → focused_pane_id` and replayed the workbench
-event. Herdr 0.9.1+ delivers `pane.focused` natively, so the poller defaults off. Override with
-`PIER_FOCUS_POLL_MS`; `PIER_WORKBENCH_ROOT` points at a relocated plugin checkout.
+**Focus heat:** Herdr 0.9.5 delivers `pane.focused` natively, so pier starts no per-pane sampler;
+the workbench receives the event directly. `PIER_WORKBENCH_ROOT` points at a relocated plugin checkout.
+
+**Upstream tracking:** pi 1.3 / herdr 0.9.5 impact, version-floor cleanup, and the next extension
+directions (remote machines, native worktrees, plugin actions):
+**[docs/rfc-upstream-absorption-2026-10.md](docs/rfc-upstream-absorption-2026-10.md)**.
 
 ### Efficiency mechanisms (D100–D103, opt-in)
 
 Three token-saving mechanisms ship **disabled by default** and are safe to try one at a time:
 
+**Origin — credit where due**: the mechanism ideas and names come from NVIDIA's
+[SoL-Pi](https://github.com/NVlabs/SoL-Pi) ([paper](https://arxiv.org/abs/2609.20519) ·
+[blog](https://nvlabs.github.io/SoL-Pi/)) — four harness-level efficiency mechanisms surfaced by
+scaled auto-research loops. pier adopts three of them (ObservationPack / EPR / OCC; the fourth,
+Action Fusion, is not adopted) and re-implements them on its own stack, extending the originals
+with a jev decision layer (small System One classifications at the diagnostic gate, excerpt-window
+pick, and settle attribution — [rfc-jev-integration.md](docs/rfc-jev-integration.md)), role gating,
+and the 4-plane efficiency config with per-mechanism JSONL telemetry (D100–D103).
+
 - **ObservationPack** — large tool outputs are projected as placeholders after the first `fullSends` requests, with paged retrieval via `obs_recall` (session JSONL stays untouched).
 - **EPR** — long diagnostic (`bash` test/build) logs are reduced in-process to a byte-verified evidence receipt; the raw log is archived first and stays readable.
 - **OCC** — `todo_write` boundaries drive pi's native compaction under a KV-cache cost model, carrying unfinished tasks across the compaction.

package/install.mjs

@@ -100,6 +100,11 @@ function tryRun(cmd, args) {
   try { run(cmd, args); return true; } catch (e) { log(`  (${e.message.split('\n')[0]})`); return false; }
 }
 
+/** Same as tryRun without the diagnostic line, for feature probes whose failure is expected. */
+function tryRunQuiet(cmd, args) {
+  try { run(cmd, args); return true; } catch { return false; }
+}
+
 function parseVersion(s) {
   const m = String(s).match(/(\d+)\.(\d+)\.(\d+)/);
   return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
@@ -145,13 +150,13 @@ function checkEnv() {
   if (major < 22) die(`node ≥ 22 required, found ${process.versions.node}`);
   log(`✓ node ${process.versions.node}`);
   const piVersion = (() => { try { return parseVersion(run('pi', ['--version'])); } catch { return null; } })();
-  if (!piVersion || !geVersion(piVersion, [0, 86, 0])) {
-    die(`pi ≥ 0.86.0 required${piVersion ? `, found ${piVersion.join('.')}` : ' (pi not found or not runnable)'}. Install: npm i -g @earendil-works/pi-coding-agent`);
+  if (!piVersion || !geVersion(piVersion, [1, 3, 0])) {
+    die(`pi ≥ 1.3.0 required${piVersion ? `, found ${piVersion.join('.')}` : ' (pi not found or not runnable)'}. Install: npm i -g @earendil-works/pi-coding-agent`);
   }
   log(`✓ pi ${piVersion.join('.')}`);
   const herdrVersion = (() => { try { return parseVersion(run('herdr', ['--version'])); } catch { return null; } })();
-  if (!herdrVersion || !geVersion(herdrVersion, [0, 9, 0])) {
-    die(`herdr ≥ 0.9.0 required${herdrVersion ? `, found ${herdrVersion.join('.')}` : ' (herdr not found)'}. Install: https://herdr.dev/`);
+  if (!herdrVersion || !geVersion(herdrVersion, [0, 9, 5])) {
+    die(`herdr ≥ 0.9.5 required${herdrVersion ? `, found ${herdrVersion.join('.')}` : ' (herdr not found)'}. Install: https://herdr.dev/`);
   }
   log(`✓ herdr ${herdrVersion.join('.')}`);
   return { piVersion, herdrVersion };
@@ -245,16 +250,57 @@ function pkgDirFromExtPath(extPath) {
   return null;
 }
 
-function herdrPluginInfo() {
-  let out;
-  try { out = run('herdr', ['plugin', 'list']); } catch { return { installed: false, spec: null, sha: null }; }
-  const line = out.split(/\r?\n/).find((l) => l.includes('pier.workbench'));
-  if (!line) return { installed: false, spec: null, sha: null };
+const HERDR_PLUGIN_ID = 'pier.workbench';
+const HERDR_PLUGIN_NAME = 'pier-workbench';
+const NOT_INSTALLED = Object.freeze({ installed: false, spec: null, sha: null, version: null, source: null, enabled: false });
+
+/** `plugin list --json` (herdr 0.9.5+): returns undefined for a malformed payload, null when the
+ *  plugin is absent, so the caller can fall back to the text listing on older binaries. */
+function parseHerdrPluginJson(out) {
+  let parsed;
+  try { parsed = JSON.parse(out); } catch { return undefined; }
+  const plugins = parsed?.result?.plugins ?? parsed?.plugins;
+  if (!Array.isArray(plugins)) return undefined;
+  const p = plugins.find((x) => x && (x.plugin_id === HERDR_PLUGIN_ID || x.name === HERDR_PLUGIN_NAME));
+  if (!p) return null;
+  const source = p.source && typeof p.source === 'object' ? p.source : {};
+  const kind = typeof source.kind === 'string' ? source.kind : null;
+  const root = typeof p.plugin_root === 'string' ? p.plugin_root : null;
+  const commit = typeof source.commit === 'string' ? source.commit : null;
+  const spec = kind === 'local'
+    ? `local:${root ?? p.manifest_path ?? ''}`
+    : (typeof p.version === 'string' ? `v${p.version}` : (kind ?? 'installed'));
+  return {
+    installed: true,
+    spec,
+    sha: commit ? commit.slice(0, 7) : null,
+    version: typeof p.version === 'string' ? p.version : null,
+    source: kind,
+    enabled: p.enabled === true,
+  };
+}
+
+function parseHerdrPluginText(out) {
+  const line = out.split(/\r?\n/).find((l) => l.includes(HERDR_PLUGIN_ID));
+  if (!line) return NOT_INSTALLED;
   const bracket = line.match(/\[([^\]]+)\]/);
   const spec = bracket ? bracket[1] : line.trim();
   const at = spec.lastIndexOf('@');
   const fullSha = at >= 0 && !spec.startsWith('local:') ? spec.slice(at + 1) : null;
-  return { installed: true, spec, sha: fullSha ? fullSha.slice(0, 7) : null };
+  return { installed: true, spec, sha: fullSha ? fullSha.slice(0, 7) : null, version: null, source: spec.startsWith('local:') ? 'local' : null, enabled: false };
+}
+
+function herdrPluginInfo() {
+  try {
+    const out = run('herdr', ['plugin', 'list', '--json']);
+    const parsed = parseHerdrPluginJson(out);
+    if (parsed !== undefined) return parsed ?? NOT_INSTALLED;
+  } catch { /* older herdr or no server; fall through to the text listing */ }
+  try {
+    return parseHerdrPluginText(run('herdr', ['plugin', 'list']));
+  } catch {
+    return NOT_INSTALLED;
+  }
 }
 
 function collectStatus() {
@@ -328,7 +374,13 @@ function update() {
     if (tryRun('pi', ['update', piSource()])) log(`✓ pi extension updated (${piSource()})`);
     else if (tryRun('pi', ['install', piSource()])) log(`✓ pi extension installed (${piSource()})`);
     else { console.error('✗ pi update/install failed'); log(`  manual: pi update ${piSource()}`); process.exitCode = 1; }
-    if (tryRun('herdr', ['plugin', 'install', HERDR_SPEC, '--yes'])) log(`✓ herdr plugin updated (${HERDR_SPEC})`);
+    // 0.9.4+ updates the GitHub checkout in place without disturbing running plugin panes.
+    // Only try it for an installed, non-local plugin; otherwise install from the configured spec.
+    const existing = herdrPluginInfo();
+    const updated = (existing.installed && existing.source !== 'local'
+      && tryRunQuiet('herdr', ['plugin', 'update', HERDR_PLUGIN_ID, '--yes']))
+      || tryRunQuiet('herdr', ['plugin', 'install', HERDR_SPEC, '--yes']);
+    if (updated) log(`✓ herdr plugin updated (${HERDR_SPEC})`);
     else { console.error('✗ herdr plugin update failed'); log(`  manual: herdr plugin install ${HERDR_SPEC} --yes`); process.exitCode = 1; }
   }
   log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pier-setup",
-  "version": "0.3.1",
+  "version": "0.4.2",
   "description": "One-shot installer for pier: install / update / version / uninstall for pi-pier + pier.workbench",
   "license": "MIT",
   "type": "module",
@@ -31,8 +31,9 @@
     "packages/*"
   ],
   "scripts": {
+    "build:workbench": "tsc -p packages/pier-workbench/tsconfig.build.json",
     "typecheck": "tsc --noEmit -p packages/pier-ext/tsconfig.json",
-    "test": "npm run typecheck && node --test \"packages/*/test/*.test.ts\"",
+    "test": "npm run build:workbench && npm run typecheck && node --test \"packages/*/test/*.test.ts\"",
     "test:mutation": "stryker run",
     "prepare": "node ./install.mjs --prepare"
   },
@@ -42,7 +43,6 @@
     "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
     "@deepseek-ai/cordis-plugin-timer": "^1.1.3",
     "@stryker-mutator/core": "^10.0.0",
-    "@stryker-mutator/typescript-checker": "^10.0.0",
     "typescript": "~5.9.3"
   },
   "pi": {