pi-daddy 0.48.3 → 0.49.0

package/extensions/runtime-snapshot.ts

@@ -5,6 +5,7 @@ import { openRuntimeSettlement, settlementHash } from "../src/governance/runtime
 import { reconcileDelegationCapacity } from "./session-capacity.ts";
 import { agentDir } from "../src/kernel/project-paths.ts";
 import type { GrantsSession } from "./session.ts";
+import { bindOperationFinals, operationFinal } from "./delegation-operations.ts";
 export const OPERATION_STATUS_EVENT = "pi-daddy:operation-status:v1";
 export const RUNTIME_SNAPSHOT_EVENT = "pi-daddy:runtime-snapshot:v1";
 export function registerRuntimeSnapshot(
@@ -99,6 +100,7 @@ export function registerRuntimeSnapshot(
       sessionId?: string;
       cwd?: string;
       operationId?: string;
+      includeFinal?: boolean;
       reply?: (value: unknown) => void;
     };
     if (
@@ -139,7 +141,12 @@ export function registerRuntimeSnapshot(
           lifecycle.runtimeSnapshotGeneration !== generation
         )
           throw Error("operation owner changed during read");
-        request.reply!({ ...envelope, qualified: true, operation });
+        request.reply!({
+          ...envelope,
+          qualified: true,
+          operation,
+          ...(request.includeFinal === true && operation ? { final: operationFinal(session, operation) } : {}),
+        });
       } catch (error) {
         request.reply!({ ...envelope, qualified: false, operation: null, reason: String(error) });
       }
@@ -172,6 +179,7 @@ export function registerRuntimeSnapshot(
         }
         if (sequence !== bindSequence || session.reloadLifecycle !== lifecycle) return;
         lifecycle.runtimeSettlement = runtime;
+        bindOperationFinals(session, sessionId, cwd);
         bound = { sessionId, cwd, lifecycle: session.reloadLifecycle };
       } catch (error) {
         if (sequence === bindSequence && session.reloadLifecycle === lifecycle) problem = String(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-daddy",
-  "version": "0.48.3",
+  "version": "0.49.0",
   "description": "Capability governance for pi sub-agents: spawn Agent Skills (SKILL.md) definitions whose allowed-tools becomes a grant that can only narrow going down a delegation tree, enforced by pi's own --tools allowlist, with an append-only ledger.",
   "keywords": [
     "pi-package",

package/src/cli.ts

@@ -50,6 +50,7 @@ Usage:
   pi-daddy report [--since <date>] [--definition <name>] [--model <id>]
                   [--group-by definition|model|thinking] [--json]
   pi-daddy outcomes                       append changed episode outcomes from Git and CI
+  pi-daddy diagnostics export <selection.json> <new-directory>  private filtered local evidence
   pi-daddy --help | --version
 
 init references skills already enabled in Pi at their installed or local paths. Legacy unregistered npm
@@ -61,8 +62,11 @@ stays unspawnable. Capabilities that can change your machine
             It never rewrites ${SETTINGS_REL} — delete that file if you want it regenerated.`;
 
 export interface ParsedArgs {
-  command: "init" | "ledger-repair" | "ledger-import" | "report" | "outcomes" | "help" | "version";
+  command:
+    "init" | "ledger-repair" | "ledger-import" | "report" | "outcomes" | "diagnostics-export" | "help" | "version";
   importTarget?: string;
+  selectionPath?: string;
+  exportDirectory?: string;
   /** `ledger repair <path>`: the ledger file; `yes` applies, otherwise preview only. */
   ledgerPath?: string;
   yes?: boolean;
@@ -91,6 +95,19 @@ export function parseArgs(argv: string[]): ParsedArgs {
   if (args.includes("--version") || args.includes("-v")) return { command: "version", force: false, errors: [] };
 
   const [command, ...tail] = args;
+  if (command === "diagnostics") {
+    const [verb, selectionPath, exportDirectory, ...extra] = tail;
+    if (
+      verb !== "export" ||
+      !selectionPath ||
+      !exportDirectory ||
+      selectionPath.startsWith("-") ||
+      exportDirectory.startsWith("-") ||
+      extra.length
+    )
+      return { command: "help", force: false, errors: ["diagnostics needs: export <selection.json> <new-directory>"] };
+    return { command: "diagnostics-export", force: false, errors: [], selectionPath, exportDirectory };
+  }
   if (command === "ledger") {
     // ADR-0076 PR 3d: `ledger repair <path> [--yes]` previews, --yes truncates; `ledger import <source> <target>`.
     const [verb, target, ...flags] = tail;
@@ -388,6 +405,12 @@ export async function main(
     console.log(USAGE);
     return 0;
   }
+  if (parsed.command === "diagnostics-export") {
+    const { exportDiagnostics } = await import("./products/diagnostic-export.ts");
+    const result = await exportDiagnostics(parsed.selectionPath!, parsed.exportDirectory!);
+    console.log(JSON.stringify(result));
+    return result.missing ? 1 : 0;
+  }
   if (parsed.command === "outcomes") {
     const cwd = process.cwd();
     const result = await updateEpisodeOutcomes({

package/src/index.ts

@@ -191,3 +191,5 @@ export {
   type WorkspacePins,
   type ParsedPin,
 } from "./kernel/workspace-pin.ts";
+
+export { exportDiagnostics, parseDiagnosticSelection, type DiagnosticSelection } from "./products/diagnostic-export.ts";

package/src/kernel/selected-definitions.ts

@@ -12,7 +12,8 @@ export interface SelectedCommand {
   name: string;
   sourceInfo?: { path?: string };
 }
-const phases = ["plan", "build", "review", "debug", "investigate"];
+const requiredPhases = ["plan", "build", "review", "debug", "investigate"];
+const phases = [...requiredPhases, "test-review"];
 const hash = (value: string) => createHash("sha256").update(value, "utf8").digest("hex");
 const object = (x: unknown): x is Record<string, unknown> => !!x && typeof x === "object" && !Array.isArray(x);
 const exact = (x: Record<string, unknown>, keys: string[]) =>
@@ -57,10 +58,10 @@ async function principalBinding(
     manifest.version !== 1 ||
     manifest.package !== "principal-pi-skills" ||
     !object(manifest.bindings) ||
-    !exact(manifest.bindings, phases)
+    !exact(manifest.bindings, Object.hasOwn(manifest.bindings, "test-review") ? phases : requiredPhases)
   )
     throw Error("invalid Principal binding manifest");
-  for (const name of phases) {
+  for (const name of Object.keys(manifest.bindings)) {
     const row = manifest.bindings[name];
     if (
       !object(row) ||
@@ -74,6 +75,7 @@ async function principalBinding(
     )
       throw Error("invalid Principal binding row");
   }
+  if (!Object.hasOwn(manifest.bindings, phase)) throw Error("selected Principal phase has no binding row");
   const row = manifest.bindings[phase] as Record<string, string>;
   const agentPath = join(root, row.agent);
   if (

package/src/products/dashboard-cli.ts

@@ -376,6 +376,17 @@ export async function runDashboard(argv = process.argv.slice(2), env: NodeJS.Pro
       notice = (await connection.change({ action: "set", edits: trimmed.slice(2).trim() }))
         ? "Session models updated"
         : connection.state.error || "Session controls unavailable";
+    } else if (trimmed.startsWith("limit ")) {
+      const edit = /^limit (wall|idle) ([0-9]+)$/.exec(trimmed);
+      if (!edit) notice = "Use limit wall <seconds> or limit idle <seconds>; 0 restores default";
+      else
+        notice = (await connection.change({
+          action: "set-limit",
+          key: edit[1] as "wall" | "idle",
+          seconds: Number(edit[2]),
+        }))
+          ? "Session limit updated for future children; running children unchanged"
+          : connection.state.error || "Settings unavailable";
     } else notice = display.input(line) ? "" : `Unknown command: ${trimmed}. Press ? for help.`;
     redraw();
   };
@@ -397,7 +408,7 @@ export async function runDashboard(argv = process.argv.slice(2), env: NodeJS.Pro
       redraw();
       return;
     }
-    const action = display.key(
+    let action = display.key(
       key.name === "return"
         ? "return"
         : ["up", "down", "escape", "tab"].includes(key.name || "")
@@ -409,6 +420,32 @@ export async function runDashboard(argv = process.argv.slice(2), env: NodeJS.Pro
       return;
     }
     if (action === "command") command = "";
+    if (action === "setting") {
+      const selected = display.screen.settingKey ?? "auto";
+      const settings = connection.state.snapshot?.settings;
+      if (!settings?.editable) notice = "Settings can only be changed in the connected owning parent";
+      else if (selected === "auto") action = "auto";
+      else if (selected === "wall" || selected === "idle") command = `limit ${selected} `;
+      else if (selected === "descendants") notice = "Startup only: set PI_DADDY_FANOUT before restarting Pi";
+      else if (selected === "depth") notice = "Startup only: set PI_DADDY_MAX_DEPTH before restarting Pi";
+      else if (selected === "perCall") notice = "Children per call is a fixed safety bound";
+      else if (!settings.jev.available)
+        notice = "JEV controls unavailable; load skill-harness in the parent Pi session";
+      else {
+        void connection
+          .change({ action: "set-jev", enabled: !(settings.jev.enabled || settings.jev.pending) })
+          .then((changed) => {
+            const jev = connection.state.snapshot?.settings?.jev;
+            notice = !changed
+              ? connection.state.error || "JEV change already pending"
+              : jev?.pending
+                ? "Complete JEV paid-call and LoRA-storage choices in the parent Pi session"
+                : jev?.error ||
+                  `JEV ${jev?.enabled ? "enabled" : "disabled"}; ${jev?.availability ?? "status unknown"}`;
+            redraw();
+          });
+      }
+    }
     if (action === "auto") {
       const snapshot = connection.state.snapshot;
       if (!snapshot) notice = "Daddy permission controls unavailable";

package/src/products/dashboard-display-controls.ts

@@ -1,3 +1,4 @@
+import { DASHBOARD_SETTING_KEYS } from "./dashboard-settings.ts";
 /** Local display controls; these never dispatch actions to an owner or change ledger state. */
 import { dashboardScreenState } from "./dashboard-screen.ts";
 import { ActivityTimelineAliases } from "./activity-timeline.ts";
@@ -16,16 +17,17 @@ export function createDashboardDisplayControls(details: boolean, ledger: boolean
   return {
     state,
     screen,
-    key(key: string): "auto" | "quit" | "command" | undefined {
+    key(key: string): "auto" | "quit" | "command" | "setting" | undefined {
       if (key === "a") return "auto";
       if (key === "q" || key === "ctrl-c") return "quit";
       if (key === ":") return "command";
+      if (screen.view === "settings" && (key === "return" || key === "d")) return "setting";
       if (key === "escape") {
         screen.view = screen.view === "version-details" ? "versions" : "main";
         state.activityDetail = undefined;
         screen.offset = 0;
-      } else if (key === "?" || key === "m" || key === "v") {
-        screen.view = key === "?" ? "help" : key === "v" ? "versions" : "models";
+      } else if (key === "?" || key === "m" || key === "v" || key === "s") {
+        screen.view = key === "?" ? "help" : key === "v" ? "versions" : key === "s" ? "settings" : "models";
         state.activityDetail = undefined;
         screen.offset = 0;
       } else if (key === "return" || key === "d") {
@@ -33,7 +35,11 @@ export function createDashboardDisplayControls(details: boolean, ledger: boolean
         screen.offset = 0;
       } else if (["up", "down", "j", "k"].includes(key)) {
         const delta = key === "up" || key === "k" ? -1 : 1;
-        if (screen.view === "versions") {
+        if (screen.view === "settings") {
+          const index = DASHBOARD_SETTING_KEYS.indexOf(screen.settingKey ?? "auto");
+          screen.settingKey =
+            DASHBOARD_SETTING_KEYS[Math.max(0, Math.min(DASHBOARD_SETTING_KEYS.length - 1, index + delta))];
+        } else if (screen.view === "versions") {
           const rows = screen.versionRows ?? [],
             index = rows.findIndex((row) => row.id === screen.versionId);
           screen.versionId = rows[Math.max(0, Math.min(rows.length - 1, index + delta))]?.id;

package/src/products/dashboard-screen.ts

@@ -1,3 +1,4 @@
+import { dashboardSettingsLines, type DashboardSettingKey } from "./dashboard-settings.ts";
 /** Height-bounded, task-first view. Permission state is always supplied by the owner. */
 import type { EcosystemVersionRow } from "./ecosystem-versions.ts";
 import type { DashboardProjection } from "./dashboard-projection.ts";
@@ -19,7 +20,8 @@ export interface DashboardItem {
   agent?: boolean;
 }
 export interface DashboardScreenState {
-  view: "main" | "details" | "models" | "help" | "versions" | "version-details";
+  view: "main" | "details" | "models" | "help" | "versions" | "version-details" | "settings";
+  settingKey?: DashboardSettingKey;
   versionId?: EcosystemVersionRow["id"];
   versionRows?: EcosystemVersionRow[];
   selectedKey?: string;
@@ -204,12 +206,14 @@ export function renderDashboardScreen(options: DashboardScreenOptions): string {
   const footer =
     options.command !== undefined
       ? [`: ${clean(options.command)}`]
-      : screen.view === "main" || screen.view === "versions"
-        ? ["↑↓ select · Enter details · a Auto", "m models · v versions · Tab filter · ?"]
-        : [
-            "↑↓ scroll · Esc back · a Auto",
-            screen.view === "details" ? "p prompt · f final · : command · ? help" : ": command · ? help",
-          ];
+      : screen.view === "settings"
+        ? ["↑↓ select · Enter toggle/edit · Esc back", "0 restores a default limit · s settings"]
+        : screen.view === "main" || screen.view === "versions"
+          ? ["↑↓ select · Enter details · a Auto", "m models · v versions · s settings · ?"]
+          : [
+              "↑↓ scroll · Esc back · a Auto",
+              screen.view === "details" ? "p prompt · f final · : command · ? help" : ": command · ? help",
+            ];
   const fixed = [
     header,
     session
@@ -223,7 +227,7 @@ export function renderDashboardScreen(options: DashboardScreenOptions): string {
       "DASHBOARD KEYS",
       "↑/↓ or j/k: select; Enter/d: details",
       "a: toggle Daddy permission Auto",
-      "m: session models; v: ecosystem versions",
+      "m: session models; v: ecosystem versions; s: settings",
       "h: show/hide finished history",
       "Tab: Everything / Agents / Skills / Needs-you",
       "p/f: selected retained prompt/final",
@@ -234,7 +238,9 @@ export function renderDashboardScreen(options: DashboardScreenOptions): string {
       "Auto does not enable JEV or change LoRA consent.",
       "Finished means observed completion, not acceptance.",
     );
-  else if (screen.view === "versions" || screen.view === "version-details") {
+  else if (screen.view === "settings") {
+    body.push(...dashboardSettingsLines(session?.settings, session?.auto.enabled, screen.settingKey ?? "auto"));
+  } else if (screen.view === "versions" || screen.view === "version-details") {
     body.push("VERSIONS");
     if (!session?.versions) body.push("Owner has not reported versions.");
     else if (screen.view === "versions") {
@@ -323,6 +329,11 @@ export function renderDashboardScreen(options: DashboardScreenOptions): string {
     if (row < screen.offset) screen.offset = row;
     else if (row + 1 >= screen.offset + room) screen.offset = Math.max(0, row + 2 - room);
   }
+  if (screen.view === "settings" && room > 0) {
+    const row = detailBody.findIndex((line) => line.startsWith(">"));
+    if (row < screen.offset) screen.offset = Math.max(0, row);
+    else if (row >= screen.offset + room) screen.offset = Math.max(0, row - room + 1);
+  }
   const offset =
     screen.view === "main" ? 0 : Math.max(0, Math.min(screen.offset, Math.max(0, detailBody.length - room)));
   screen.offset = offset;
@@ -337,7 +348,7 @@ export function renderDashboardScreen(options: DashboardScreenOptions): string {
       const safe = truncate(dashboardText(line), width);
       if (!options.color) return safe;
       const section =
-        /^(CURRENT REQUEST|LATEST REQUEST|CURRENT WORK|NEEDS YOU|NEEDS ATTENTION|WORK IN PROGRESS|HISTORY|VERSIONS|SESSION MODELS|DASHBOARD KEYS|MANAGE)/.test(
+        /^(CURRENT REQUEST|LATEST REQUEST|CURRENT WORK|NEEDS YOU|NEEDS ATTENTION|WORK IN PROGRESS|HISTORY|VERSIONS|SETTINGS|STARTUP LIMITS|SESSION MODELS|DASHBOARD KEYS|MANAGE)/.test(
           safe,
         );
       const code =

package/src/products/dashboard-session-client.ts

@@ -1,3 +1,4 @@
+import type { DashboardSettingsSnapshot } from "./dashboard-settings.ts";
 import type { EcosystemVersions } from "./ecosystem-versions.ts";
 import { createConnection } from "node:net";
 
@@ -6,12 +7,17 @@ export interface DashboardSessionSnapshot {
   cost: number | null;
   activity?: { rootId: string; path: string; taskId: string };
   versions?: EcosystemVersions;
+  settings?: DashboardSettingsSnapshot;
   auto: { enabled: boolean; source: "default" | "environment" | "session" };
   pendingApprovals: Array<{ id: string; subject: string; capability: string }>;
 }
 
 export type DashboardSessionAction =
-  { action: "get" } | { action: "set"; edits: string } | { action: "set-auto"; enabled: boolean };
+  | { action: "get" }
+  | { action: "set"; edits: string }
+  | { action: "set-auto"; enabled: boolean }
+  | { action: "set-jev"; enabled: boolean }
+  | { action: "set-limit"; key: "wall" | "idle"; seconds: number };
 
 export async function dashboardSessionRequest(
   socketPath: string,

package/src/products/dashboard-settings.ts

@@ -0,0 +1,72 @@
+/** Settings are owner observations; rendering never grants consent or changes execution. */
+export type DashboardSettingKey = "auto" | "jev" | "wall" | "idle" | "descendants" | "depth" | "perCall";
+export const DASHBOARD_SETTING_KEYS: DashboardSettingKey[] = [
+  "auto",
+  "jev",
+  "wall",
+  "idle",
+  "descendants",
+  "depth",
+  "perCall",
+];
+export interface DashboardJevState {
+  available: boolean;
+  enabled: boolean;
+  pending: boolean;
+  mode?: string;
+  storage?: string | null;
+  remaining?: number;
+  availability?: string;
+  providerReadiness?: string;
+  error?: string;
+}
+export interface DashboardSettingsSnapshot {
+  editable: boolean;
+  wallSeconds: number;
+  idleSeconds: number;
+  wallSource: "session" | "startup";
+  idleSource: "session" | "startup";
+  descendants: number;
+  reserved: number;
+  maxDepth: number;
+  perCall: number;
+  jev: DashboardJevState;
+}
+export function dashboardSettingsLines(
+  settings: DashboardSettingsSnapshot | undefined,
+  auto: boolean | undefined,
+  selected: DashboardSettingKey,
+): string[] {
+  if (!settings) return ["SETTINGS", "Owner settings unavailable. Reconnect from /grants dashboard."];
+  const row = (key: DashboardSettingKey, label: string) => `${key === selected ? ">" : " "} ${label}`;
+  const jev = settings.jev;
+  return [
+    "SETTINGS · current session",
+    row("auto", `Permission Auto: ${auto ? "ON" : "OFF"}`),
+    row(
+      "jev",
+      `JEV: ${jev.pending ? "waiting for consent" : !jev.available ? "unavailable" : jev.enabled ? "ON" : "OFF"}`,
+    ),
+    ...(jev.available
+      ? [
+          `  ${jev.availability ?? "unknown"} · ${jev.remaining ?? 0} paid calls left`,
+          `  Key: ${jev.providerReadiness ?? "unknown"}; storage: ${jev.storage ?? "not granted"}`,
+        ]
+      : ["  Load skill-harness to connect JEV controls."]),
+    ...(jev.error ? [`  ${jev.error}`] : []),
+    row("wall", `Child wall: ${settings.wallSeconds}s (${settings.wallSource})`),
+    row("idle", `Child idle: ${settings.idleSeconds}s (${settings.idleSource})`),
+    settings.editable
+      ? "Edits apply to future children from this parent."
+      : "Read-only: change settings in the owning parent.",
+    "Running children keep their captured limits.",
+    "JEV ON asks paid-call and LoRA-storage consent in Pi.",
+    "Auto never supplies that consent. No model token budget.",
+    "",
+    "STARTUP LIMITS · restart to change",
+    row("descendants", `Active descendants: ${settings.descendants} (${settings.reserved} reserved) · PI_DADDY_FANOUT`),
+    row("depth", `Maximum depth: ${settings.maxDepth} · PI_DADDY_MAX_DEPTH`),
+    row("perCall", `Children per call: ${settings.perCall} (fixed safety bound)`),
+    "s settings · m models · v versions",
+  ];
+}