pi-better-harness 0.1.9 → 0.1.12

package/README.md

@@ -4,7 +4,7 @@
 
 ## Quick Answer
 
-Use `pi-better-harness` when you want the full background-work bundle for Pi in one install. It loads:
+Use `pi-better-harness` when you want the full background-work set for Pi. It manages:
 
 - `pi-better-subagents` for detached, sandboxed subagent runs.
 - `pi-better-background-tasks` for durable shell tasks and watchers.
@@ -18,43 +18,46 @@ Use `pi-better-harness` when you want the full background-work bundle for Pi in
 
 ## Install
 
+Install the three extensions as standalone Pi packages, so Pi displays and manages each by its own package name:
+
 ```sh
-pi install npm:pi-better-harness
+npx pi-better-harness install
 ```
 
-Try it for one run without saving it to Pi settings:
+For project-local Pi settings:
 
 ```sh
-pi -e npm:pi-better-harness
+npx pi-better-harness install --local
 ```
 
-## Install Individual Packages
+The bundled installation remains available for compatibility:
 
 ```sh
-pi install npm:pi-better-subagents
-pi install npm:pi-better-background-tasks
-pi install npm:pi-better-goal
+pi install npm:pi-better-harness
 ```
 
 ## When To Use
 
-Use this package when you want all three core extensions loaded together. Install an individual package instead when you only need subagents, shell task supervision, or goal tracking.
+Use the installer when you want all three core extensions with standalone package identities. Install an individual package instead when you only need subagents, shell task supervision, or goal tracking.
 
 ## Compatibility
 
 | Requirement | Support |
 |-------------|---------|
 | Pi | Required |
-| Install method | `pi install npm:pi-better-harness` |
+| Recommended install | `npx pi-better-harness install` |
 | Development runtime | Node.js 22+ |
 
 ## Update Or Remove
 
+Remove all three standalone packages:
+
 ```sh
-pi update npm:pi-better-harness
-pi remove npm:pi-better-harness
+npx pi-better-harness uninstall
 ```
 
+Add `--local` to remove them from project-local settings.
+
 ## More Detail
 
 - Repository: https://github.com/1aboveio/pi-better-harness

package/bin/pi-better-harness.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from "../lib/cli.mjs";
+
+process.exitCode = run(process.argv.slice(2));

package/extensions/background-tasks/index.ts

@@ -0,0 +1 @@
+export { default } from "../../node_modules/pi-better-background-tasks/src/index.ts";

package/extensions/goal/index.ts

@@ -0,0 +1 @@
+export { default } from "../../node_modules/pi-better-goal/src/index.ts";

package/extensions/subagents/index.ts

@@ -0,0 +1 @@
+export { default } from "../../node_modules/pi-better-subagents/index.ts";

package/lib/cli.mjs

@@ -0,0 +1,62 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const { version } = JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf8"));
+
+export const componentPackages = [
+  "pi-better-subagents",
+  "pi-better-background-tasks",
+  "pi-better-goal",
+];
+
+const usage = `Usage: pi-better-harness <install|uninstall> [--local]
+
+Commands:
+  install      Configure all Pi Better Harness component packages
+  uninstall    Remove all Pi Better Harness component packages
+
+Options:
+  -l, --local  Use project-local Pi settings
+  -h, --help   Show this help
+  -v, --version  Show the package version`;
+
+export function run(argv, options = {}) {
+  const spawn = options.spawn ?? spawnSync;
+  const stdout = options.stdout ?? process.stdout;
+  const stderr = options.stderr ?? process.stderr;
+
+  if (argv.includes("--help") || argv.includes("-h")) {
+    stdout.write(`${usage}\n`);
+    return 0;
+  }
+  if (argv.includes("--version") || argv.includes("-v")) {
+    stdout.write(`${version}\n`);
+    return 0;
+  }
+
+  const local = argv.includes("--local") || argv.includes("-l");
+  const positional = argv.filter((arg) => !["--local", "-l"].includes(arg));
+  const command = positional[0];
+  if (!command || positional.length !== 1 || !["install", "uninstall"].includes(command)) {
+    stderr.write(`${usage}\n`);
+    return 2;
+  }
+
+  const piCommand = process.platform === "win32" ? "pi.cmd" : "pi";
+  const piAction = command === "install" ? "install" : "remove";
+  for (const packageName of componentPackages) {
+    const args = [piAction, `npm:${packageName}`, ...(local ? ["--local"] : [])];
+    const result = spawn(piCommand, args, { stdio: "inherit" });
+    if (result.error) {
+      stderr.write(`Failed to run Pi for ${packageName}: ${result.error.message}\n`);
+      return 1;
+    }
+    if (result.status !== 0) {
+      return result.status ?? 1;
+    }
+  }
+  return 0;
+}

package/node_modules/pi-better-background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-background-tasks",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Pi extension for durable background shell tasks, watchers, logs, and status inspection.",
   "license": "MIT",
   "type": "module",

package/node_modules/pi-better-goal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-goal",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Pi extension for goal tracking with background-aware continuation.",
   "license": "MIT",
   "type": "module",

package/node_modules/pi-better-subagents/index.ts

@@ -30,7 +30,7 @@ import {
     type BackgroundWorkRow,
 } from "./shared-navigator.ts";
 import { spawnDetached, type SpawnResult } from "./spawn.ts";
-import { parseRun, resetParseRunCursor, type Usage } from "./parse.ts";
+import { parseRun, resetParseRunCursor, tailLog, type Usage } from "./parse.ts";
 import { finalizeRun as finalizeRunCore } from "./finalization.ts";
 import { loadConfig, normalizeTools, resolveExtensionPath, SAFE_DEFAULT_TOOLS, SAFE_CLEAN_TOOLS, DEFAULT_MAX_CONCURRENT } from "./config.ts";
 import { resolveExtensions, extensionArgs } from "./extensions.ts";
@@ -659,8 +659,7 @@ function isTerminalNavigatorStatus(status: string): boolean {
 }
 
 /** Live detail snapshot for one run (registry + log parse + health). */
-function navigatorDetail(id: string) {
-    const now = Date.now();
+function navigatorDetail(id: string, now: number = Date.now()) {
     return buildNavigatorDetail(id, {
         readMeta,
         effectiveStatus,
@@ -742,9 +741,10 @@ function subagentWorkRows(now: number): BackgroundWorkRow[] {
     });
 }
 
-function subagentWorkDetail(id: string, now: number): BackgroundWorkDetail | null {
-    const detail = navigatorDetail(id);
+function subagentWorkDetail(id: string, now: number, options?: { logTailLines?: number }): BackgroundWorkDetail | null {
+    const detail = navigatorDetail(id, now);
     if (!detail) return null;
+    const logTailLines = options?.logTailLines ?? 10;
     const metadata = [
         { label: "provider", value: "Subagents" },
         { label: "model", value: detail.effort ? `${detail.model} · effort ${detail.effort}` : detail.model },
@@ -762,7 +762,11 @@ function subagentWorkDetail(id: string, now: number): BackgroundWorkDetail | nul
         statusTone: statusTone(detail.status),
         subtitle: detail.currentTool ? `current tool ${detail.currentTool}` : undefined,
         metadata,
-        evidence: { label: "output", text: detail.output || "(no output yet)" },
+        // The shared navigator refreshes this provider once a second while the
+        // detail overlay is open. Read the selected logical tail rows each
+        // time so the evidence behaves like `tail -f`, not a single parsed
+        // activity/result snapshot.
+        evidence: { label: "log tail", text: tailLog(id, logTailLines) },
         footerActions: [detail.status === "running" || detail.status === "orphaned" ? "x stop" : "x dismiss"],
     };
 }
@@ -775,7 +779,7 @@ function ensureSubagentProvider(): void {
         priority: 10,
         visibleCount: () => navigatorRunningCount(),
         listRows: (now) => subagentWorkRows(now),
-        detail: (id, now) => subagentWorkDetail(id, now),
+        detail: (id, now, options) => subagentWorkDetail(id, now, options),
         armCloseLabel: (row) => row.status === "running" || row.status === "orphaned" ? "x again to stop" : "x again to dismiss",
         close: (id) => {
             const outcome = navigatorCloseRun(id) as { action: string; id: string; status?: string };

package/node_modules/pi-better-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-subagents",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Pi extension for detached, sandboxed subagent runs that keep the foreground session free.",
   "license": "MIT",
   "type": "module",

package/node_modules/pi-better-subagents/parse.ts

@@ -26,7 +26,7 @@ import {
     readSync,
     statSync,
 } from "node:fs";
-import { readBoundedTail } from "./shared-log-utils.ts";
+import { readBoundedTail, tailTerminalDisplay } from "./shared-log-utils.ts";
 import { readAppendedLines, type LogCursor } from "./log-cursor.ts";
 import { logPathFor } from "./registry.ts";
 
@@ -89,13 +89,11 @@ interface TailRead {
  */
 const readTail: (path: string, maxBytes: number) => TailRead = readBoundedTail;
 
-/** Last `n` lines of a run's log, or a placeholder if empty/unreadable. */
+/** Last `n` terminal display rows of a run's log, or a placeholder if empty/unreadable. */
 export function tailLog(id: string, n: number, maxBytes = maxRawTailBytes()): string {
     const tail = readTail(logPathFor(id), maxBytes);
     if (tail.error || tail.text.trim() === "") return "(no output yet)";
-    const lines = tail.text.split("\n");
-    const kept = lines.slice(Math.max(0, lines.length - n));
-    const out = kept.join("\n").trim();
+    const out = tailTerminalDisplay(tail.text, n).trim();
     return out === "" ? "(no output yet)" : out;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-harness",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Pi extension bundle for subagents, durable background tasks, and goal tracking.",
   "license": "MIT",
   "type": "module",
@@ -14,9 +14,9 @@
   ],
   "pi": {
     "extensions": [
-      "node_modules/pi-better-subagents/index.ts",
-      "node_modules/pi-better-background-tasks/src/index.ts",
-      "node_modules/pi-better-goal/src/index.ts"
+      "extensions/subagents/index.ts",
+      "extensions/background-tasks/index.ts",
+      "extensions/goal/index.ts"
     ],
     "image": "https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/pi-better-harness.png"
   },
@@ -29,16 +29,23 @@
     "url": "https://github.com/1aboveio/pi-better-harness/issues"
   },
   "homepage": "https://github.com/1aboveio/pi-better-harness/tree/main/packages/pi-better-harness#readme",
+  "bin": {
+    "pi-better-harness": "./bin/pi-better-harness.mjs"
+  },
   "files": [
-    "README.md"
+    "README.md",
+    "bin/*.mjs",
+    "lib/*.mjs",
+    "extensions/**/*.ts"
   ],
   "scripts": {
-    "prepack": "node ../../scripts/stage-harness-dependencies.mjs"
+    "prepack": "node ../../scripts/stage-harness-dependencies.mjs",
+    "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "pi-better-background-tasks": "0.1.9",
-    "pi-better-goal": "0.1.9",
-    "pi-better-subagents": "0.1.9"
+    "pi-better-background-tasks": "0.1.12",
+    "pi-better-goal": "0.1.12",
+    "pi-better-subagents": "0.1.12"
   },
   "bundledDependencies": [
     "pi-better-background-tasks",