pier-setup 0.3.0 → 0.3.1

package/README.md

@@ -19,7 +19,7 @@ pier ships as **two halves**, installed separately:
 | Half | Package | Role |
 |---|---|---|
 | **pi extension** | `packages/pier-ext` (npm: [`pi-pier`](https://www.npmjs.com/package/pi-pier), [pi.dev gallery](https://pi.dev/packages/pi-pier)) | Injects `todo_write` / `subagent` / `terminal` / `ask_user_question` tools into a pi session, and reports pane state over the herdr socket API |
-| **herdr plugin** | `packages/pier-workbench` (`pier.workbench`) | Workspace bootstrap, blocked human-gate notifications, focus heat layout (focused pane grows in place) |
+| **herdr plugin** | `packages/pier-workbench` (`pier.workbench`) | Blocked human-gate notifications, focus heat layout (focused pane grows in place), ops dashboard + sidebar agent view |
 
 ### Highlights
 
@@ -30,7 +30,7 @@ pier ships as **two halves**, installed separately:
 - **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
-- **Ask picker**: a `multi: true` question renders as an interactive toggle list (space toggles a row, `a` toggles all, enter confirms, esc declines, live selection count) with the free-text row pinned last; `allowOther: false` gives pure choice. The typed-index prompt remains the fallback for RPC mode and older pi
+- **Ask picker**: every choice question renders through one pier-owned picker in the TUI — single-select (arrows + enter/space pick the highlighted row) and `multi: true` toggle list (checkboxes: space toggles, `a` toggles all, live selection count) share the same framed chrome, `recommended` seeds the cursor (and pre-checks in multi), and the free-text row stays last; `allowOther: false` gives pure choice. The host select dialog and typed-index prompts remain the fallbacks for RPC mode and older pi
 - **Blocking dialogs mark the pane**: pi's `ui_prompt_start` / `ui_prompt_end` events cover the inherently blocking `ctx.ui` dialogs (`select` / `confirm` / `input` / `editor`), so a dialog from *any* extension marks the pane blocked and emits the `herdr:blocked` edge; nested gates coalesce, and the ask tool no longer needs its 5s refresh heartbeat. `custom` is deliberately excluded — pi routes resident overlays through it too (pier's own slim-frame overlay never calls `done()`), which used to leave a working pane marked blocked for the whole session
 - **Role gate stops early**: a denied worker tool call returns `terminate`, so a batch whose results are all terminating ends without another model round trip
 - **Transcript cards**: pier's own session entries (todo edits, subagent/terminal registries, role manifests, soft approvals) and its reminder messages render as compact cards instead of raw JSON — entry/message renderers, no pi-tui dependency
@@ -45,7 +45,7 @@ pier ships as **two halves**, installed separately:
 ### Requirements
 
 - Node ≥ 22
-- pi ≥ 0.84.4 (`@earendil-works/pi-coding-agent`)
+- 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)
 
 ### One-shot install (recommended)
@@ -56,7 +56,7 @@ No clone needed — run the npm package directly:
 npx pier-setup@latest            # user mode: pi install npm:pi-pier + herdr plugin install
 npx pier-setup@latest version    # local vs npm latest (installer / pi-pier / herdr plugin)
 npx pier-setup@latest update     # refresh both halves in place (does not uninstall first)
-npx pier-setup@latest uninstall  # --purge also drops boot-config.json
+npx pier-setup@latest uninstall
 
 npm i -g pier-setup              # or install globally, then: pier-setup / version / update
 ```
@@ -70,15 +70,13 @@ Dev mode still requires cloning the repo:
 git clone https://github.com/July24/pier && cd pier
 node install.mjs install --dev   # local-path pi install + herdr plugin link; code changes are live
 node install.mjs version --dev
-node install.mjs update --dev    # rewrite boot-config only; pull the repo yourself
+node install.mjs update --dev    # re-check env + versions; pull the repo yourself
 ```
 
-The script verifies the environment (node / pi / herdr versions), probes pi's node
-and cli.js absolute paths, generates boot-config.json (user mode stores it in the
-herdr plugin config dir, so reinstalls don't lose it), and registers both halves.
+The script verifies the environment (node / pi / herdr versions) and registers both halves.
 
 `update` re-runs `pi update npm:pi-pier` (falls back to `pi install`) and
-`herdr plugin install … --yes`, then rewrites boot-config. Override sources with
+`herdr plugin install … --yes`. Override sources with
 `--pi-spec=` / `--herdr-spec=` (npm publishing or forks). `pier-setup --help`
 lists every command.
 
@@ -131,15 +129,7 @@ pi overwrites tools/commands by name; event listeners stack. Two todo or subagen
 **Designed coexistence:** herdr’s official `herdr:pi` reporter. Keep it. pier emits `herdr:blocked` so that plugin remains lifecycle authority.
 
 - **other agents inside herdr (claude code / codex etc.)**: tabs without a pi pane
-  are excluded from heat reflow; blocked notifications are pi-only; master-tab
-  auto-bootstrap can be disabled with `autoBootstrap: false` in boot-config.
-
-### Bootstrap config (workbench half)
-
-Master-tab bootstrap needs local node / pi paths: `pier-setup` generates
-them automatically; manually, copy `packages/pier-workbench/scripts/boot-config.example.json`
-(placeholders for both macOS and Windows). User mode reads it from
-`herdr plugin config-dir pier.workbench`; dev mode from `packages/pier-workbench/scripts/boot-config.json`.
+  are excluded from heat reflow; blocked notifications are pi-only.
 
 ### Usage
 
@@ -153,7 +143,7 @@ them automatically; manually, copy `packages/pier-workbench/scripts/boot-config.
 ```
 packages/
   pier-ext/        # pi extension (npm: pi-pier): todo/subagent tools, herdr client, vocab authority, skill
-  pier-workbench/  # herdr plugin (pier.workbench): workspace bootstrap + blocked notify + heat layout
+  pier-workbench/  # herdr plugin (pier.workbench): blocked notify + heat layout + ops dashboard
 docs/              # install guide, configuration overview, role profile docs, sidebar role config
 ```
 
@@ -161,7 +151,7 @@ docs/              # install guide, configuration overview, role profile docs, s
 
 ```sh
 npm install --ignore-scripts
-npm test          # node --test, 809 unit tests (planner / todo replay / anti-freeze staleness / session tail / GC / lifecycle / renderers / ask picker / subagent output / jev decision layer: diagnostic gate, notice ranking, excerpt windows)
+npm test          # node --test, 733 unit tests (planner / todo replay / anti-freeze staleness / session tail / GC / lifecycle / renderers / ask picker / subagent output / jev decision layer: diagnostic gate, notice ranking, excerpt windows)
 ```
 
 ## Configuration
@@ -218,10 +208,10 @@ PI_HERDR_OBS_PACK_ENABLE=1 PI_HERDR_OBS_PACK_LOG=1 pi   # start here
 
 Full quick start, what to watch in `efficiency-logs/*.jsonl`, rollback steps and a feedback template: **[docs/efficiency-trial.md](docs/efficiency-trial.md)**.
 
-Everything above (plus roles, pi settings, boot-config and the `PIER_*`/`PI_HERDR_*` env knobs) is also inspectable in-session:
+Everything above (plus roles, pi settings and the `PIER_*`/`PI_HERDR_*` env knobs) is also inspectable in-session:
 
 ```text
-/pier-config            # 5-plane index; hands a guided change to the agent
+/pier-config            # 4-plane index; hands a guided change to the agent
 /pier-config show all   # effective value + source (env > workspace > user > default) per key
 /pier-config check      # validation across planes   ·   /pier-config doc → written report
 ```
@@ -241,6 +231,6 @@ MIT
 
 ---
 
-> 💡 **For contributors**: `.gitignore` is tracked in the repository. Note that `packages/pier-workbench/scripts/boot-config.json` is machine-local (see the `.example.json` template), and `docs/research/` contains local research notes ignored by `.gitignore`.
+> 💡 **For contributors**: `.gitignore` is tracked in the repository. `docs/research/` contains local research notes ignored by `.gitignore`.
 >
 > **Naming convention**: the brand is **pier** (repo/packages/plugin); runtime protocol identifiers keep the **`pi-herdr`** prefix (`.pi-herdr/roles/` dir, `pi-herdr.subs` session custom entries, `~/.pi/agent/herdr-pi/roles/` user dir) — they persist with user sessions/config files, renaming would break existing data, so they are the compatibility layer.

package/install.mjs

@@ -3,25 +3,23 @@
  * pier one-shot installer / uninstaller / updater / version inspector (cross-platform: macOS / Linux / Windows).
  *
  * Usage:
- *   node install.mjs install  [--dev] [--hmr-dev] [--force]   # Install (default command, 'install' can be omitted)
- *   node install.mjs update   [--dev] [--hmr-dev]             # Refresh both halves in place to latest release (no prior uninstall)
- *   node install.mjs version  [--json]                        # Local vs npm latest
- *   node install.mjs uninstall [--dev] [--purge]              # Uninstall; --purge deletes boot-config.json as well
+ *   node install.mjs install  [--dev]                        # Install (default command, 'install' can be omitted)
+ *   node install.mjs update   [--dev]                        # Refresh both halves in place to latest release (no prior uninstall)
+ *   node install.mjs version  [--json]                       # Local vs npm latest
+ *   node install.mjs uninstall [--dev]                       # Uninstall both halves
  *   node install.mjs --prepare                                # npm prepare: hooksPath + repo root bin link
  *   node install.mjs --help
  *
  * Modes:
  *   User mode (default): pi install npm:pi-pier
  *                   + herdr plugin install July24/pier/packages/pier-workbench --yes
- *                   boot-config.json written to herdr plugin config-dir; extPath points to pi-installed
- *                   pi-pier (~/.pi/agent/npm/...), not the repo path inside pier-setup package.
  *   --dev Development mode: pi install <repo>/packages/pier-ext + herdr plugin link <repo>/packages/pier-workbench
- *                   (linked directory is live; code edits take effect immediately; update only rewrites boot-config).
+ *                   (linked directory is live; code edits take effect immediately).
  * Distribution specs can be overridden via --pi-spec= / --herdr-spec= (for npm publish or fork scenarios).
  * Failure semantics: Each step provides manual equivalent command; step failure does not abort reporting (exitCode=1).
  */
 import { execFileSync } from 'node:child_process';
-import { chmodSync, existsSync, mkdirSync, readFileSync, realpathSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -29,7 +27,6 @@ import { fileURLToPath } from 'node:url';
 const ROOT = resolve(dirname(fileURLToPath(import.meta.url)));
 const EXT_DIR = join(ROOT, 'packages', 'pier-ext');
 const WB_DIR = join(ROOT, 'packages', 'pier-workbench');
-const DEV_BOOT_CONFIG = join(WB_DIR, 'scripts', 'boot-config.json');
 const EXT_PATH = join(EXT_DIR, 'src', 'index.ts');
 const IS_WIN = process.platform === 'win32';
 const COMMANDS = ['install', 'uninstall', 'update', 'version', 'help'];
@@ -141,10 +138,6 @@ function npmLatest(name) {
   }
 }
 
-/** Herdr plugin config directory (boot-config destination in user mode; semantic path exists once plugin is registered). */
-function herdrConfigDir() {
-  try { return run('herdr', ['plugin', 'config-dir', 'pier.workbench']); } catch { return null; }
-}
 
 /* ── Environment check (pre-install) ────────────────────────────────── */
 function checkEnv() {
@@ -152,8 +145,8 @@ 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, 84, 4])) {
-    die(`pi ≥ 0.84.4 required${piVersion ? `, found ${piVersion.join('.')}` : ' (pi not found or not runnable)'}. Install: npm i -g @earendil-works/pi-coding-agent`);
+  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`);
   }
   log(`✓ pi ${piVersion.join('.')}`);
   const herdrVersion = (() => { try { return parseVersion(run('herdr', ['--version'])); } catch { return null; } })();
@@ -167,26 +160,6 @@ function checkEnv() {
 /** pi extension source: user mode uses git/npm spec, dev mode uses local directory. */
 const piSource = () => (dev ? EXT_DIR : PI_SPEC);
 
-/* ── boot-config detection and writing ────────────────────────────── */
-function probePiRuntime() {
-  const piBin = which('pi');
-  // bin is a node shim: realpath resolves to .../pi-coding-agent/dist/cli.js (npm layout, isomorphic win/posix)
-  if (piBin) {
-    try {
-      const real = realpathSync(piBin);
-      if (real.endsWith('cli.js') && existsSync(real)) {
-        return { piCli: real, piNode: process.execPath };
-      }
-    } catch { /* fall back to fallback */ }
-  }
-  // npm root -g fallback: when pi is not in PATH (e.g. nvm shim), construct from global npm layout
-  try {
-    const gRoot = run('npm', ['root', '-g']);
-    const cand = join(gRoot, '@earendil-works', 'pi-coding-agent', 'dist', 'cli.js');
-    if (existsSync(cand)) return { piCli: cand, piNode: process.execPath };
-  } catch { /* npm unavailable */ }
-  return null;
-}
 
 function piAgentDir() {
   return process.env.PI_CODING_AGENT_DIR || join(homedir(), '.pi', 'agent');
@@ -260,47 +233,6 @@ function resolveUserExtPath() {
   return extPathFromPiList();
 }
 
-function writeBootConfig(hmrDev, force) {
-  const probed = probePiRuntime();
-  if (!probed) die('cannot locate pi cli.js (tried: pi shim realpath, npm root -g). Fill boot-config.json manually.');
-  let extPath;
-  if (dev) {
-    if (!existsSync(EXT_PATH)) die(`pier-ext entry missing: ${EXT_PATH} (repo layout broken?)`);
-    extPath = EXT_PATH;
-  } else {
-    extPath = resolveUserExtPath();
-    if (!extPath) die(`cannot locate installed pier-ext (npm:pi-pier / git clone). Did \`pi install ${piSource()}\` succeed?`);
-  }
-
-  const config = {
-    mainTabLabel: 'main',
-    piNode: probed.piNode,
-    piCli: probed.piCli,
-    extPath,
-    workbenchPluginId: 'pier.workbench',
-    hmrDev,
-  };
-
-  const target = dev ? DEV_BOOT_CONFIG : join(herdrConfigDir() ?? die('cannot resolve herdr plugin config-dir (is pier.workbench installed?)'), 'boot-config.json');
-  if (existsSync(target) && !force) {
-    let existing = null;
-    try { existing = JSON.parse(readFileSync(target, 'utf8')); } catch { /* treated as corrupted */ }
-    if (existing) {
-      log(`• ${target} exists, diff (existing → new):`);
-      for (const k of Object.keys(config)) {
-        if (existing[k] !== config[k]) log(`    ${k}: ${JSON.stringify(existing[k])} → ${JSON.stringify(config[k])}`);
-      }
-      log('  kept existing (use --force to overwrite)');
-      return;
-    }
-  }
-  mkdirSync(dirname(target), { recursive: true });
-  writeFileSync(target, JSON.stringify(config, null, 2) + '\n');
-  log(`✓ boot-config.json ${force ? 'overwritten (--force)' : 'written'} → ${target}`);
-  log(`  piNode = ${config.piNode}`);
-  log(`  piCli  = ${config.piCli}`);
-  log(`  extPath = ${config.extPath}`);
-}
 
 function pkgDirFromExtPath(extPath) {
   let d = dirname(extPath);
@@ -344,17 +276,17 @@ function usage() {
   log(`pier-setup — install / update / inspect pier (pi-pier + pier.workbench)
 
 Usage:
-  pier-setup [install] [--dev] [--hmr-dev] [--force]
-  pier-setup update    [--dev] [--hmr-dev]
+  pier-setup [install] [--dev]
+  pier-setup update    [--dev]
   pier-setup version   [--json]
-  pier-setup uninstall [--dev] [--purge]
+  pier-setup uninstall [--dev]
 
   npx pier-setup@latest          # recommended user install
   npx pier-setup@latest update   # refresh both halves to newest release
   npx pier-setup@latest version  # local vs npm latest
 
   --pi-spec= / --herdr-spec= override distribution sources
-  --dev  local link (clone); update only rewrites boot-config`);
+  --dev  local link (clone); the linked directories are live`);
 }
 
 function version() {
@@ -390,25 +322,20 @@ function update() {
   if (latestSetup && me && cmpSemver(me, latestSetup) < 0) {
     log(`⚠ installer ${me} < latest ${latestSetup} — re-run: npx pier-setup@latest update`);
   }
-  const hmrDev = flags.has('--hmr-dev');
   if (dev) {
-    log('dev mode: local link is live; pull the repo yourself. Refreshing boot-config only.');
-    writeBootConfig(hmrDev, true);
+    log('dev mode: local link is live; pull the repo yourself (no installer-managed files to refresh).');
   } else {
     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})`);
     else { console.error('✗ herdr plugin update failed'); log(`  manual: herdr plugin install ${HERDR_SPEC} --yes`); process.exitCode = 1; }
-    writeBootConfig(hmrDev, true);
   }
   log('');
   version();
 }
 
 function install() {
-  const hmrDev = flags.has('--hmr-dev');
-  const force = flags.has('--force');
   checkEnv();
   removeLegacyGitRegistration();
 
@@ -417,40 +344,31 @@ function install() {
     else { console.error('✗ pi install failed'); log(`  manual: pi install ${EXT_DIR}`); process.exitCode = 1; }
     if (tryRun('herdr', ['plugin', 'link', WB_DIR])) log('✓ herdr plugin linked (packages/pier-workbench, local)');
     else { console.error('✗ herdr plugin link failed'); log(`  manual: herdr plugin link ${WB_DIR}`); process.exitCode = 1; }
-    writeBootConfig(hmrDev, force);
   } else {
     if (tryRun('pi', ['install', piSource()])) log(`✓ pi extension installed (${PI_SPEC})`);
     else { console.error('✗ pi install failed'); log(`  manual: pi install ${PI_SPEC}`); process.exitCode = 1; }
     if (tryRun('herdr', ['plugin', 'install', HERDR_SPEC, '--yes'])) log(`✓ herdr plugin installed (${HERDR_SPEC})`);
     else { console.error('✗ herdr plugin install failed'); log(`  manual: herdr plugin install ${HERDR_SPEC}`); process.exitCode = 1; }
-    writeBootConfig(hmrDev, force);
   }
 
   log(`
 pier installed (${dev ? 'dev mode: local paths, code changes are live' : 'user mode: managed checkouts'}). Next:
-  1. start herdr, open/create a workspace — the main tab auto-bootstraps a pi session
+  1. start herdr, open/create a workspace and run \`pi\` inside a pane
   2. inside pi, ask the model to use todo_write / subagent tools`);
 }
 
 function uninstall() {
-  const purge = flags.has('--purge');
   if (tryRun('pi', ['remove', piSource()])) log('✓ pi extension removed');
   else { console.error('✗ pi remove failed'); log(`  manual: pi remove ${piSource()}`); process.exitCode = 1; }
 
   if (dev) {
     if (tryRun('herdr', ['plugin', 'unlink', 'pier.workbench'])) log('✓ herdr plugin unlinked (files kept)');
     else { console.error('✗ herdr plugin unlink failed'); log('  manual: herdr plugin unlink pier.workbench'); process.exitCode = 1; }
-    if (purge && existsSync(DEV_BOOT_CONFIG)) { rmSync(DEV_BOOT_CONFIG); log('✓ dev boot-config.json purged'); }
   } else {
     if (tryRun('herdr', ['plugin', 'uninstall', 'pier.workbench'])) log('✓ herdr plugin uninstalled (managed checkout removed)');
     else { console.error('✗ herdr plugin uninstall failed'); log('  manual: herdr plugin uninstall pier.workbench'); process.exitCode = 1; }
-    if (purge) {
-      const dir = herdrConfigDir();
-      const f = dir ? join(dir, 'boot-config.json') : null;
-      if (f && existsSync(f)) { rmSync(f); log('✓ boot-config.json purged'); }
-    }
   }
-  log(`\npier uninstalled.${purge ? '' : ' (boot-config.json kept; use --purge to remove)'}`);
+  log('\npier uninstalled.');
 }
 
 if (command === 'help' || flags.has('--help') || flags.has('-h')) usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pier-setup",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "One-shot installer for pier: install / update / version / uninstall for pi-pier + pier.workbench",
   "license": "MIT",
   "type": "module",