pi-daddy 0.28.0 → 0.32.1

package/dist/products/dashboard-cli.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+/**
+ * `pi-daddy-dashboard` — the read-only view of one ledger or activity timeline.
+ *
+ * It reads a file and renders it; it holds no authority and connects to nothing. The Herdr pane opened by
+ * `/grants dashboard` runs exactly this program with the ledger path in its environment.
+ */
+import { realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { createInterface } from "node:readline";
+import { parseDashboardLedger } from "./dashboard-projection.js";
+import { renderDashboard } from "./dashboard-render.js";
+import { ActivityTimelineAliases, defaultActivityTimelinePath, detailForTimeline, parseActivityTimeline, renderActivityTimeline, resolveActivityTaskSelector, } from "./activity-timeline.js";
+import { createDashboardDisplayControls } from "./dashboard-display-controls.js";
+import { adoptLegacyEnvironment, ENV_LEDGER, legacyEnvironmentWarning } from "../kernel/env-names.js";
+import { projectLedgerPath } from "../kernel/project-paths.js";
+export const DASHBOARD_PROTOCOL_VERSION = 1;
+export const ENV_DASHBOARD_LEDGER = ENV_LEDGER; // one ledger path variable for children and the dashboard (ADR-0076 PR 3b)
+export const ENV_DASHBOARD_PROTOCOL = "PI_DADDY_DASHBOARD_PROTOCOL";
+export const ENV_DASHBOARD_KEY = "PI_DADDY_DASHBOARD_KEY";
+export const DASHBOARD_REFRESH_MS = 250;
+function shellQuote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function setupFrame(cwd) {
+    const ledger = projectLedgerPath(cwd);
+    return [
+        "PI-DADDY",
+        "",
+        "pi-daddy is missing or its ledger is inactive in this workspace.",
+        "Nothing was installed or configured automatically.",
+        "",
+        "Run exactly:",
+        "  pi install npm:pi-daddy",
+        `  export PI_DADDY_LEDGER=${shellQuote(ledger)}`,
+        "  pi",
+        "",
+        "Then run /grants dashboard inside that Herdr-hosted pi session.",
+    ].join("\n");
+}
+function incompatibleFrame(protocol) {
+    return [
+        "PI-DADDY — INCOMPATIBLE DASHBOARD",
+        "",
+        `dashboard plugin protocol ${DASHBOARD_PROTOCOL_VERSION}; core requested ${protocol}.`,
+        "No execution state is rendered because assigning old fields new meaning would be unsafe.",
+        "Relink the dashboard from the same installed pi-daddy package, then retry /grants dashboard.",
+    ].join("\n");
+}
+async function renderTimelineFile(path, text, options) {
+    const timeline = parseActivityTimeline(text);
+    let content;
+    if (options.activityDetail)
+        try {
+            const taskKey = resolveActivityTaskSelector(timeline, options.activityDetail.taskKey, options.activityAliases);
+            if (!taskKey)
+                throw Error("TIMELINE_DETAIL_INVALID");
+            content = await detailForTimeline(path, taskKey, options.activityDetail.field);
+        }
+        catch (error) {
+            return `PI-DADDY — ACTIVITY DETAIL UNAVAILABLE\n${error instanceof Error ? error.message : String(error)}`;
+        }
+    return renderActivityTimeline(timeline, {
+        details: options.details,
+        history: options.history,
+        filter: options.filter,
+        color: options.color,
+        width: options.width,
+        aliases: options.activityAliases,
+        content,
+    });
+}
+export async function dashboardFrame(options) {
+    if (options.protocol !== undefined && options.protocol !== DASHBOARD_PROTOCOL_VERSION) {
+        return incompatibleFrame(options.protocol);
+    }
+    // The timeline is the default local surface. With no ledger configured, a missing timeline shows the setup
+    // frame so a pane opened before pi has run remains explanatory.
+    const configuredPath = options.ledgerPath ?? defaultActivityTimelinePath(options.cwd);
+    if (!options.ledgerPath) {
+        try {
+            const activityPath = resolve(options.cwd, configuredPath);
+            return await renderTimelineFile(activityPath, await readFile(activityPath, "utf8"), options);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return setupFrame(options.cwd);
+            return "PI-DADDY — ACTIVITY UNAVAILABLE\nTimeline could not be read; no substitute view was shown.";
+        }
+    }
+    const ledgerPath = resolve(options.cwd, configuredPath);
+    let text = "";
+    let waiting = false;
+    try {
+        text = await readFile(ledgerPath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            waiting = true;
+        else {
+            return [
+                "PI-DADDY — LEDGER UNAVAILABLE",
+                "",
+                `Configured ledger: ${ledgerPath}`,
+                `Could not read it: ${error instanceof Error ? error.message : String(error)}`,
+                "The dashboard did not substitute an empty tree for this failure.",
+            ].join("\n");
+        }
+    }
+    const rendered = text.trimStart().startsWith('{"version":1')
+        ? await renderTimelineFile(ledgerPath, text, options)
+        : renderDashboard(parseDashboardLedger(text, { now: options.now }), {
+            color: options.color,
+            width: options.width,
+            details: options.details,
+            history: options.history,
+        });
+    return waiting ? `${rendered}\n\nwaiting for ledger ${ledgerPath}` : rendered;
+}
+function parseArgs(argv) {
+    let once = false;
+    let details = false;
+    let color = Boolean(process.stdout.isTTY) && process.env.NO_COLOR === undefined;
+    let ledgerPath;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--once")
+            once = true;
+        else if (arg === "--details")
+            details = true;
+        else if (arg === "--no-color")
+            color = false;
+        else if (arg === "--ledger")
+            ledgerPath = argv[++index];
+        else
+            throw new Error(`unknown dashboard argument ${JSON.stringify(arg)}`);
+    }
+    return { once, details, color, ledgerPath };
+}
+export async function runDashboard(argv = process.argv.slice(2), env = process.env) {
+    const adoptedLegacy = adoptLegacyEnvironment(env);
+    if (adoptedLegacy.length > 0)
+        console.error(legacyEnvironmentWarning(adoptedLegacy));
+    const cli = parseArgs(argv);
+    const cwd = process.cwd();
+    const ledgerPath = cli.ledgerPath ?? (env[ENV_DASHBOARD_LEDGER]?.trim() || undefined);
+    const rawProtocol = env[ENV_DASHBOARD_PROTOCOL]?.trim();
+    const protocol = rawProtocol === undefined || rawProtocol === "" ? undefined : Number(rawProtocol);
+    const key = env[ENV_DASHBOARD_KEY]?.trim();
+    process.title = `pi-daddy-dashboard${key ? `:${key.slice(0, 12)}` : ""}`;
+    const display = createDashboardDisplayControls(cli.details, true);
+    let previous = "";
+    let notice = "";
+    let input = null;
+    const draw = async (clear) => {
+        const view = await dashboardFrame({
+            cwd,
+            ledgerPath,
+            protocol,
+            color: cli.color,
+            width: process.stdout.columns || 80,
+            ...display.state,
+            activityAliases: display.aliases,
+        });
+        const frame = notice ? `${notice}\n\n${view}` : view;
+        if (frame === previous && !clear)
+            return;
+        previous = frame;
+        const prompt = display.prompt();
+        const draft = input?.line ?? "";
+        process.stdout.write(clear ? `\u001b]0;PI-DADDY\u0007\u001b[2J\u001b[H${frame}\n\n${input ? prompt + draft : ""}` : `${frame}\n`);
+        if (input)
+            input.setPrompt(prompt);
+    };
+    if (cli.once) {
+        await draw(false);
+        return;
+    }
+    input = createInterface({ input: process.stdin, output: process.stdout, terminal: Boolean(process.stdin.isTTY) });
+    await draw(true);
+    let drawing = false;
+    const redraw = () => {
+        if (drawing)
+            return;
+        drawing = true;
+        void draw(true).finally(() => {
+            drawing = false;
+        });
+    };
+    input.on("line", (line) => {
+        // Rule 8: a line the display controls do not understand is said so, never swallowed.
+        notice = display.input(line) ? "" : `not a display command: ${JSON.stringify(line.trim())}. ${display.prompt()}`;
+        redraw();
+    });
+    const timer = setInterval(redraw, DASHBOARD_REFRESH_MS);
+    process.on("SIGWINCH", redraw);
+    await new Promise((settle) => {
+        const stop = () => {
+            clearInterval(timer);
+            input?.close();
+            process.off("SIGWINCH", redraw);
+            settle();
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+}
+const invoked = (() => {
+    try {
+        return process.argv[1] ? import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href : false;
+    }
+    catch {
+        return false;
+    }
+})();
+if (invoked) {
+    runDashboard().catch((error) => {
+        process.stderr.write(`pi-daddy dashboard failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=dashboard-cli.js.map

package/dist/products/dashboard-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-cli.js","sourceRoot":"","sources":["../../src/products/dashboard-cli.ts"],"names":[],"mappings":"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"}

package/dist/products/dashboard-display-controls.d.ts

@@ -0,0 +1,17 @@
+/** Local display controls; these never dispatch actions to an owner or change ledger state. */
+import { ActivityTimelineAliases } from "./activity-timeline.ts";
+export declare function createDashboardDisplayControls(details: boolean, ledger: boolean): {
+    state: {
+        details: boolean;
+        history: boolean;
+        filter?: "everything" | "agents" | "skills" | "needs-you";
+        activityDetail?: {
+            taskKey: string;
+            field: "prompt" | "final";
+        };
+    };
+    aliases: ActivityTimelineAliases;
+    input(line: string): boolean;
+    prompt(): string;
+};
+//# sourceMappingURL=dashboard-display-controls.d.ts.map

package/dist/products/dashboard-display-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-display-controls.d.ts","sourceRoot":"","sources":["../../src/products/dashboard-display-controls.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;;iBAEnE,OAAO;iBACP,OAAO;iBACP,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW;yBACxC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;SAAE;;;gBAOnD,MAAM,GAAG,OAAO;cAsBlB,MAAM;EAMnB"}

package/dist/products/dashboard-display-controls.js

@@ -0,0 +1,38 @@
+/** Local display controls; these never dispatch actions to an owner or change ledger state. */
+import { ActivityTimelineAliases } from "./activity-timeline.js";
+export function createDashboardDisplayControls(details, ledger) {
+    const state = { details, history: false, ...(ledger ? { filter: "everything" } : {}) };
+    // Held by the panel process, so a refresh or a newly observed root cannot renumber an already displayed alias.
+    const aliases = new ActivityTimelineAliases();
+    return {
+        state,
+        aliases,
+        input(line) {
+            const input = line.trim(), key = input.toLowerCase();
+            if (key === "d") {
+                state.details = !state.details;
+                return true;
+            }
+            if (ledger && key === "h") {
+                state.history = !state.history;
+                return true;
+            }
+            if (ledger && ["everything", "agents", "skills", "needs-you"].includes(key)) {
+                state.filter = key;
+                return true;
+            }
+            const detail = /^(p|f)\s+([^\s]{1,1400})$/i.exec(input);
+            if (ledger && detail) {
+                state.activityDetail = { field: detail[1].toLowerCase() === "p" ? "prompt" : "final", taskKey: detail[2] };
+                return true;
+            }
+            return false;
+        },
+        prompt() {
+            return ledger
+                ? `d Details / h ${state.history ? "Collapse" : "Expand"} history / Everything|Agents|Skills|Needs-you / p|f <r#/t# or root:task>, then Enter: `
+                : "Action number / d Details, then Enter: ";
+        },
+    };
+}
+//# sourceMappingURL=dashboard-display-controls.js.map

package/dist/products/dashboard-display-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-display-controls.js","sourceRoot":"","sources":["../../src/products/dashboard-display-controls.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,UAAU,8BAA8B,CAAC,OAAgB,EAAE,MAAe;IAC9E,MAAM,KAAK,GAKP,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACtF,+GAA+G;IAC/G,MAAM,OAAO,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAC9C,OAAO;QACL,KAAK;QACL,OAAO;QACP,KAAK,CAAC,IAAY;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,EACvB,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAC1B,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,MAAM,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5E,KAAK,CAAC,MAAM,GAAG,GAAuC,CAAC;gBACvD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,KAAK,CAAC,cAAc,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAE,EAAE,CAAC;gBAC7G,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM;YACJ,OAAO,MAAM;gBACX,CAAC,CAAC,iBAAiB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,wFAAwF;gBAChJ,CAAC,CAAC,yCAAyC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/products/dashboard-handshake.d.ts

@@ -0,0 +1,42 @@
+import { type DashboardOpenResult } from "./dashboard-herdr.ts";
+import type { HerdrExec } from "../executors/herdr-cli.ts";
+export type DashboardPromptChoice = "not-now" | "never";
+export declare function dashboardPreferencePath(agentDir: string): string;
+export interface DashboardHandshakeUI {
+    select(title: string, choices: string[]): Promise<string | undefined>;
+    notify(message: string, level?: "info" | "warning" | "error"): void;
+}
+export interface DashboardHandshakeInput {
+    mode: string;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    pid?: number;
+    exec?: HerdrExec;
+    cwd: string;
+    ledgerPath?: string;
+    pluginRoot: string;
+    preferencePath: string;
+    paneStatePath: string;
+    ui: DashboardHandshakeUI;
+}
+export type DashboardHandshakeOutcome = "not-applicable" | "suppressed" | "already-installed" | "installed" | "deferred" | "failed";
+export declare function offerDashboardHandshake(input: DashboardHandshakeInput): Promise<DashboardHandshakeOutcome>;
+export interface DashboardCommandInput {
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    pid?: number;
+    exec?: HerdrExec;
+    cwd: string;
+    ledgerPath?: string;
+    pluginRoot: string;
+    paneStatePath: string;
+}
+export type DashboardCommandResult = DashboardOpenResult | {
+    kind: "fallback";
+    frame: string;
+    visibleBesideCaller: false;
+};
+export declare function openDashboardCommand(input: DashboardCommandInput): Promise<DashboardCommandResult>;
+export declare function defaultDashboardPaths(agentDir: string): {
+    preferencePath: string;
+    paneStatePath: string;
+};
+//# sourceMappingURL=dashboard-handshake.d.ts.map

package/dist/products/dashboard-handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-handshake.d.ts","sourceRoot":"","sources":["../../src/products/dashboard-handshake.ts"],"names":[],"mappings":"AAGA,OAAO,EAQL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,CAAC;AAQxD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAkCD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,oBAAoB,CAAC;CAC1B;AAED,MAAM,MAAM,yBAAyB,GACnC,gBAAgB,GAAG,YAAY,GAAG,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9F,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAkFhH;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,sBAAsB,GAChC,mBAAmB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,KAAK,CAAA;CAAE,CAAC;AAYxF,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyBxG;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAKzG"}

package/dist/products/dashboard-handshake.js

@@ -0,0 +1,158 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { DASHBOARD_PLUGIN_ID, dashboardHerdrExec, dashboardPaneStatePath, inspectDashboardPlugin, linkDashboardPlugin, openOrReuseDashboard, verifyHerdrHost, } from "./dashboard-herdr.js";
+import { DASHBOARD_PROTOCOL_VERSION } from "./dashboard-cli.js";
+import { defaultActivityTimelinePath, parseActivityTimeline, renderActivityTimeline } from "./activity-timeline.js";
+export function dashboardPreferencePath(agentDir) {
+    return resolve(agentDir, "pi-daddy", "dashboard-preference.json");
+}
+async function loadPreference(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        if (parsed?.version !== 1 || !Number.isInteger(parsed.protocol) || !["not-now", "never"].includes(parsed.choice)) {
+            throw new Error("unsupported preference shape");
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw new Error(`dashboard preference ${path} is corrupt or unreadable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function savePreference(path, choice) {
+    const preference = {
+        version: 1,
+        protocol: DASHBOARD_PROTOCOL_VERSION,
+        choice,
+        recordedAt: new Date().toISOString(),
+    };
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(preference, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    await rename(temporary, path);
+}
+function quote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+export async function offerDashboardHandshake(input) {
+    if (input.mode !== "tui")
+        return "not-applicable";
+    const exec = input.exec ?? dashboardHerdrExec;
+    const host = await verifyHerdrHost({ env: input.env, pid: input.pid, exec });
+    if (!host.ok)
+        return "not-applicable";
+    try {
+        const preference = await loadPreference(input.preferencePath);
+        if (preference)
+            return "suppressed";
+        const plugin = await inspectDashboardPlugin(exec, input.pluginRoot);
+        // A compatible bundled panel is local software already chosen by the operator. Present it by default;
+        // pane identity makes this one panel per caller tab/session and --no-focus avoids focus theft.
+        if (plugin.state === "compatible") {
+            const opened = await openOrReuseDashboard({
+                exec,
+                host: host.host,
+                ledgerPath: input.ledgerPath ?? "",
+                cwd: input.cwd,
+                statePath: input.paneStatePath,
+                pluginRoot: input.pluginRoot,
+                allowInactive: true,
+            });
+            input.ui.notify(`pi-daddy dashboard ${opened.kind} in pane ${opened.paneId} without changing focus.`, "info");
+            return "already-installed";
+        }
+        const replacingDifferentPackage = plugin.state === "incompatible" && plugin.incompatibility === "package-root";
+        if (plugin.state !== "absent" && !replacingDifferentPackage) {
+            input.ui.notify(`pi-daddy dashboard: ${plugin.diagnostic}`, "error");
+            return "failed";
+        }
+        const affirmative = replacingDifferentPackage ? "Relink and open" : "Install and open";
+        const choices = replacingDifferentPackage ? [affirmative, "Not now"] : [affirmative, "Not now", "Never ask"];
+        const choice = await input.ui.select(replacingDifferentPackage
+            ? "The pi-daddy dashboard is linked from a different package. Relink this bundled copy and open it?"
+            : "Herdr detected. Install and open the pi-daddy dashboard?", choices);
+        if (!choices.includes(choice ?? "")) {
+            // Escape, timeout and UI teardown return undefined. None is an operator choice, so none may become a
+            // durable preference merely because the dialog disappeared.
+            input.ui.notify("pi-daddy dashboard: installation prompt dismissed; no preference was stored.", "info");
+            return "deferred";
+        }
+        if (choice !== affirmative) {
+            if (replacingDifferentPackage) {
+                input.ui.notify("pi-daddy dashboard: existing link unchanged; no preference was stored.", "info");
+                return "deferred";
+            }
+            const recorded = choice === "Never ask" ? "never" : "not-now";
+            await savePreference(input.preferencePath, recorded);
+            input.ui.notify(recorded === "never"
+                ? "pi-daddy dashboard: startup installation prompt disabled. /grants dashboard remains available."
+                : "pi-daddy dashboard: not installed. /grants dashboard will report the manual setup when requested.", "info");
+            return "deferred";
+        }
+        await linkDashboardPlugin(input.pluginRoot, exec);
+        const linked = await inspectDashboardPlugin(exec, input.pluginRoot);
+        if (linked.state !== "compatible")
+            throw new Error(linked.diagnostic);
+        const opened = await openOrReuseDashboard({
+            exec,
+            host: host.host,
+            ledgerPath: input.ledgerPath ?? "",
+            cwd: input.cwd,
+            statePath: input.paneStatePath,
+            pluginRoot: input.pluginRoot,
+            allowInactive: true,
+        });
+        input.ui.notify(`pi-daddy dashboard ${opened.kind} in pane ${opened.paneId} without changing focus.`, "info");
+        return "installed";
+    }
+    catch (error) {
+        input.ui.notify(`pi-daddy dashboard setup failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+        return "failed";
+    }
+}
+async function piFallback(cwd, reason) {
+    try {
+        return {
+            kind: "fallback",
+            visibleBesideCaller: false,
+            frame: `${reason}\n\n${renderActivityTimeline(parseActivityTimeline(await readFile(defaultActivityTimelinePath(cwd), "utf8")))}`,
+        };
+    }
+    catch {
+        return { kind: "fallback", visibleBesideCaller: false, frame: `${reason}\n\nNo local activity recorded yet.` };
+    }
+}
+export async function openDashboardCommand(input) {
+    const exec = input.exec ?? dashboardHerdrExec;
+    // A panel can only target this verified process; otherwise /grants dashboard renders the local Pi fallback.
+    const host = await verifyHerdrHost({ env: input.env, pid: input.pid, exec });
+    if (!host.ok)
+        return piFallback(input.cwd, `Herdr panel unavailable: ${host.diagnostic}`);
+    if (!input.ledgerPath?.trim())
+        return piFallback(input.cwd, "Herdr panel has no governance ledger; showing the local activity timeline.");
+    const plugin = await inspectDashboardPlugin(exec, input.pluginRoot);
+    if (plugin.state === "absent")
+        return piFallback(input.cwd, `Herdr panel is not linked. Run: herdr plugin link ${quote(resolve(input.pluginRoot))} --enabled`);
+    if (plugin.state === "disabled") {
+        throw new Error(`the pi-daddy Herdr plugin is disabled. Run: herdr plugin enable ${DASHBOARD_PLUGIN_ID}`);
+    }
+    if (plugin.state !== "compatible")
+        throw new Error(plugin.diagnostic);
+    return openOrReuseDashboard({
+        exec,
+        host: host.host,
+        ledgerPath: input.ledgerPath,
+        cwd: input.cwd,
+        statePath: input.paneStatePath,
+        pluginRoot: input.pluginRoot,
+    });
+}
+export function defaultDashboardPaths(agentDir) {
+    return {
+        preferencePath: dashboardPreferencePath(agentDir),
+        paneStatePath: dashboardPaneStatePath(agentDir),
+    };
+}
+//# sourceMappingURL=dashboard-handshake.js.map

package/dist/products/dashboard-handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-handshake.js","sourceRoot":"","sources":["../../src/products/dashboard-handshake.ts"],"names":[],"mappings":"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"}

package/dist/products/dashboard-herdr.d.ts

@@ -0,0 +1,55 @@
+import { type HerdrExec } from "../executors/herdr-cli.ts";
+export declare const DASHBOARD_PLUGIN_ID = "pi-daddy.dashboard";
+export declare const DASHBOARD_PLUGIN_ENTRYPOINT = "dashboard";
+export declare const DASHBOARD_HERDR_TIMEOUT_MS = 3000;
+/** Dashboard control calls are UI operations and must never hang pi session start. */
+export declare const dashboardHerdrExec: HerdrExec;
+export interface HerdrHost {
+    paneId: string;
+    tabId: string;
+    workspaceId: string;
+}
+export type HerdrHostResult = {
+    ok: true;
+    host: HerdrHost;
+    diagnostic: string;
+} | {
+    ok: false;
+    diagnostic: string;
+    host?: undefined;
+};
+export declare function verifyHerdrHost(options?: {
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    pid?: number;
+    exec?: HerdrExec;
+}): Promise<HerdrHostResult>;
+export type DashboardPluginState = "absent" | "disabled" | "compatible" | "incompatible" | "unavailable";
+export interface DashboardPluginStatus {
+    state: DashboardPluginState;
+    diagnostic: string;
+    incompatibility?: "package-root" | "protocol";
+    plugin?: Record<string, unknown>;
+}
+export declare function inspectDashboardPlugin(exec?: HerdrExec, expectedPluginRoot?: string): Promise<DashboardPluginStatus>;
+export declare function linkDashboardPlugin(pluginRoot: string, exec?: HerdrExec): Promise<void>;
+export interface DashboardOpenInput {
+    exec?: HerdrExec;
+    host: HerdrHost;
+    ledgerPath: string;
+    cwd: string;
+    statePath: string;
+    /** Expected bundled root; same-id plugins from another package are not invoked. */
+    pluginRoot?: string;
+    /** Installation handshake may open an explanatory pane before a ledger exists. */
+    allowInactive?: boolean;
+}
+export interface DashboardOpenResult {
+    kind: "opened" | "reused";
+    paneId: string;
+    tabId: string;
+    workspaceId: string;
+    visibleBesideCaller: boolean;
+}
+export declare function openOrReuseDashboard(input: DashboardOpenInput): Promise<DashboardOpenResult>;
+export declare function dashboardPaneStatePath(agentDir: string): string;
+//# sourceMappingURL=dashboard-herdr.d.ts.map

package/dist/products/dashboard-herdr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-herdr.d.ts","sourceRoot":"","sources":["../../src/products/dashboard-herdr.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,EAAE,SAa7B,CAAC;AAEL,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAS1G,wBAAsB,eAAe,CACnC,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;CACb,GACL,OAAO,CAAC,eAAe,CAAC,CAiD1B;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AACzG,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAQD,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,SAA8B,EACpC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAqDhC;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,SAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjH;AAsGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwHlG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D"}