pi-subagents 0.69.0 → 0.70.0

package/src/watchdog/change-signature.js

@@ -0,0 +1,246 @@
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { PROJECT_SUBAGENTS_RELATIVE_DIR } from "../shared/artifacts.js";
+const IGNORED_CHANGE_PREFIXES = [`${PROJECT_SUBAGENTS_RELATIVE_DIR}/`, "tmp/", "node_modules/"];
+const IGNORED_CHANGE_PATHS = new Set([PROJECT_SUBAGENTS_RELATIVE_DIR, "tmp", "node_modules"]);
+const IGNORED_CHANGE_SEGMENTS = new Set([".git", "node_modules"]);
+const DEFAULT_MAX_HASH_FILE_BYTES = 64 * 1024 * 1024;
+const DEFAULT_MAX_HASH_TOTAL_BYTES = 64 * 1024 * 1024;
+const DEFAULT_MAX_HASH_ENTRIES = 2_000;
+const TRACKED_ENTRY_PROBE_MAX_BYTES = 1_024;
+function positiveEnvNumber(name, fallback) {
+    const parsed = Number(process.env[name]);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+// Read at call time (not module load) so tests can override env guards after
+// this module is imported.
+function maxHashFileBytes() {
+    return positiveEnvNumber("PI_SUBAGENTS_MAX_HASH_FILE_BYTES", DEFAULT_MAX_HASH_FILE_BYTES);
+}
+function maxHashTotalBytes() {
+    return positiveEnvNumber("PI_SUBAGENTS_MAX_HASH_TOTAL_BYTES", DEFAULT_MAX_HASH_TOTAL_BYTES);
+}
+function maxHashEntries() {
+    return positiveEnvNumber("PI_SUBAGENTS_MAX_HASH_ENTRIES", DEFAULT_MAX_HASH_ENTRIES);
+}
+function git(cwd, args) {
+    const result = spawnSync("git", ["-C", cwd, ...args], { encoding: "utf-8", maxBuffer: 10 * 1024 * 1024, windowsHide: true });
+    if (result.status !== 0)
+        return undefined;
+    return result.stdout;
+}
+function comparablePath(value) {
+    let resolved = path.resolve(value);
+    try {
+        resolved = fs.realpathSync.native(resolved);
+    }
+    catch {
+        // Keep the lexical path when canonicalization is unavailable.
+    }
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function isHomeRepoRoot(root) {
+    return comparablePath(root) === comparablePath(os.homedir());
+}
+/**
+ * Probe the index without asking Git to inspect the working tree. The output
+ * cap keeps this check bounded even for repositories with a very large index;
+ * an ENOBUFS result still proves that at least one tracked path exists.
+ */
+function hasTrackedEntries(root) {
+    const result = spawnSync("git", ["-C", root, "ls-files", "--cached", "--error-unmatch", "--", "."], {
+        encoding: "utf-8",
+        maxBuffer: TRACKED_ENTRY_PROBE_MAX_BYTES,
+        windowsHide: true,
+    });
+    const errorCode = result.error?.code;
+    if (result.status === 0 || errorCode === "ENOBUFS")
+        return true;
+    if (result.status === 1)
+        return false;
+    return undefined;
+}
+function normalizeRelPath(value) {
+    return value.replaceAll(path.sep, "/").replace(/^\.\//, "");
+}
+function ignoredRelPath(relPath) {
+    const normalized = normalizeRelPath(relPath);
+    return IGNORED_CHANGE_PATHS.has(normalized)
+        || IGNORED_CHANGE_PREFIXES.some((prefix) => normalized.startsWith(prefix))
+        || normalized.split("/").some((segment) => IGNORED_CHANGE_SEGMENTS.has(segment));
+}
+function useHashEntryBudget(budget) {
+    if (budget.entries >= budget.maxEntries)
+        return false;
+    budget.entries++;
+    return true;
+}
+function hashFile(filePath) {
+    return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+function largeFileHash(stat) {
+    return "large:" + stat.size + ":" + Math.floor(stat.mtimeMs);
+}
+function hashFileEntry(normalized, fullPath, stat, budget) {
+    let hash;
+    if (stat.size > maxHashFileBytes() || budget.bytes + stat.size > budget.maxBytes) {
+        hash = largeFileHash(stat);
+    }
+    else {
+        try {
+            hash = hashFile(fullPath);
+            budget.bytes += stat.size;
+        }
+        catch (error) {
+            const code = error.code;
+            // A file racing away between lstat and read: mirror the lstat ENOENT path.
+            if (code === "ENOENT")
+                return { path: normalized, state: "deleted" };
+            // Any other read failure (too-large, EACCES, EISDIR, ...) degrades to the
+            // metadata marker so one unreadable file never discards the whole signature.
+            hash = largeFileHash(stat);
+            if (code !== "ERR_FS_FILE_TOO_LARGE") {
+                console.warn("[pi-subagents] watchdog hashFile fell back to metadata for", normalized + ":", error?.message);
+            }
+        }
+    }
+    return { path: normalized, state: "file", mode: stat.mode & 0o777, size: stat.size, hash };
+}
+function gitWorktreeEntry(normalized, fullPath) {
+    const status = git(fullPath, ["status", "--porcelain=v1", "-z", "--untracked-files=no"]);
+    return {
+        path: normalized,
+        state: "git-worktree",
+        head: git(fullPath, ["rev-parse", "HEAD"])?.trim(),
+        dirty: Boolean(status),
+        statusKey: status ? createHash("sha256").update(status).digest("hex") : undefined,
+    };
+}
+function hashPath(root, relPath, budget) {
+    const normalized = normalizeRelPath(relPath);
+    if (!useHashEntryBudget(budget))
+        return { path: normalized, state: "skipped", reason: "entry-limit" };
+    const fullPath = path.join(root, normalized);
+    let stat;
+    try {
+        stat = fs.lstatSync(fullPath);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { path: normalized, state: "deleted" };
+        throw error;
+    }
+    if (stat.isSymbolicLink()) {
+        return { path: normalized, state: "symlink", target: fs.readlinkSync(fullPath) };
+    }
+    if (stat.isDirectory()) {
+        if (fs.existsSync(path.join(fullPath, ".git")))
+            return gitWorktreeEntry(normalized, fullPath);
+        const entries = fs.readdirSync(fullPath)
+            .map((entry) => normalizeRelPath(path.posix.join(normalized, entry)))
+            .filter((entry) => !ignoredRelPath(entry))
+            .sort();
+        const remainingEntries = Math.max(0, budget.maxEntries - budget.entries);
+        const selectedEntries = entries.slice(0, remainingEntries);
+        const childEntries = selectedEntries.map((entry) => hashPath(root, entry, budget));
+        if (selectedEntries.length < entries.length) {
+            childEntries.push({ path: normalized, state: "skipped-children", reason: "entry-limit", count: entries.length - selectedEntries.length });
+        }
+        return { path: normalized, state: "dir", entries: childEntries };
+    }
+    if (stat.isFile())
+        return hashFileEntry(normalized, fullPath, stat, budget);
+    return { path: normalized, state: "other", mode: stat.mode };
+}
+function parsePorcelainZ(raw) {
+    const tokens = raw.split("\0").filter(Boolean);
+    const entries = [];
+    for (let index = 0; index < tokens.length; index++) {
+        const token = tokens[index];
+        if (token.length < 4)
+            continue;
+        const status = token.slice(0, 2);
+        const relPath = token.slice(3);
+        const paths = [relPath];
+        if (status[0] === "R" || status[0] === "C") {
+            const originalPath = tokens[++index];
+            if (originalPath)
+                paths.push(originalPath);
+        }
+        entries.push({ status, paths });
+    }
+    return entries;
+}
+function buildRepoChangeSignature(root, statusOutput) {
+    const entries = parsePorcelainZ(statusOutput)
+        .map((entry) => ({
+        status: entry.status,
+        paths: entry.paths.map(normalizeRelPath).filter((relPath) => !ignoredRelPath(relPath)),
+    }))
+        .filter((entry) => entry.paths.length > 0)
+        .sort((a, b) => `${a.status} ${a.paths.join("\0")}`.localeCompare(`${b.status} ${b.paths.join("\0")}`));
+    const changedPaths = [...new Set(entries.flatMap((entry) => entry.paths))].sort();
+    const budget = { entries: 0, bytes: 0, maxEntries: maxHashEntries(), maxBytes: maxHashTotalBytes() };
+    const payload = entries.map((entry) => ({
+        status: entry.status,
+        paths: entry.paths,
+        content: entry.paths.map((relPath) => hashPath(root, relPath, budget)),
+    }));
+    const key = createHash("sha256").update(JSON.stringify(payload)).digest("hex");
+    return { root, key, changedPaths };
+}
+export function computeWatchdogRepoChangeSignature(cwd) {
+    const root = git(cwd, ["rev-parse", "--show-toplevel"])?.trim();
+    if (!root)
+        return undefined;
+    const skipUntracked = isHomeRepoRoot(root) || hasTrackedEntries(root) === false;
+    const statusOutput = git(root, [
+        "status",
+        "--porcelain=v1",
+        "-z",
+        `--untracked-files=${skipUntracked ? "no" : "all"}`,
+    ]);
+    if (statusOutput === undefined)
+        return undefined;
+    try {
+        return buildRepoChangeSignature(root, statusOutput);
+    }
+    catch (error) {
+        console.warn("[pi-subagents] watchdog repo change signature failed:", error?.message);
+        return undefined;
+    }
+}
+function toolNameFromMessage(message) {
+    const value = message.toolName ?? message.name;
+    return typeof value === "string" ? value : "";
+}
+function toolResultSucceeded(message) {
+    return message.isError !== true && message.error === undefined;
+}
+function messageIndicatesRepoEdit(message) {
+    if (!message || typeof message !== "object")
+        return false;
+    const input = message;
+    const role = input.role;
+    if (role !== "toolResult" && role !== "tool")
+        return false;
+    const toolName = toolNameFromMessage(input);
+    return (toolName === "edit" || toolName === "write") && toolResultSucceeded(input);
+}
+export function eventIndicatesRepoEdit(event) {
+    if (!event || typeof event !== "object")
+        return false;
+    const input = event;
+    if (input.type === "turn_end" || input.event === "turn_end") {
+        return [input.message, ...(Array.isArray(input.toolResults) ? input.toolResults : [])].some(messageIndicatesRepoEdit);
+    }
+    if (input.type === "tool_result" || input.event === "tool_result")
+        return messageIndicatesRepoEdit({ role: "toolResult", ...input });
+    if (input.type !== "tool_result_end" && input.event !== "tool_result_end")
+        return false;
+    return messageIndicatesRepoEdit(input.message);
+}
+//# sourceMappingURL=change-signature.js.map

package/src/watchdog/change-signature.js.map

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

package/src/watchdog/child-status.d.ts

@@ -0,0 +1,54 @@
+import type { ChildWatchdogProgress, ChildWatchdogWarningSummary } from "../shared/types.ts";
+import { type ResolvedWatchdogConfig, type WatchdogCadenceConfig, type WatchdogLspConfig } from "./types.ts";
+export declare const CHILD_WATCHDOG_WARNING_LIMIT = 20;
+export declare const CHILD_WATCHDOG_STATUS_EVENT = "subagent.watchdog.status";
+export declare const CHILD_WATCHDOG_PHASES: readonly ["idle", "reviewing", "stale", "failed"];
+export type ChildWatchdogPhase = typeof CHILD_WATCHDOG_PHASES[number];
+export interface ChildWatchdogConfig {
+    runId?: string;
+    agent?: string;
+    childIndex?: number;
+    watchdogTailTimeoutMs: number;
+    agentEndTimeoutMs: number;
+    maxWarnings: number | null;
+    model?: string;
+    thinking?: string | false;
+    lsp: WatchdogLspConfig;
+    stalemateRepeats: number;
+    /** Mid-run review cadence; everyNTools null means boundary reviews only. */
+    cadence: WatchdogCadenceConfig;
+}
+export interface ChildWatchdogStatusEvent {
+    type: typeof CHILD_WATCHDOG_STATUS_EVENT;
+    runId?: string;
+    agent?: string;
+    childIndex?: number;
+    stepIndex?: number;
+    seq: number;
+    phase: ChildWatchdogPhase;
+    ts: number;
+    reason?: string;
+    warning?: ChildWatchdogWarningSummary;
+}
+export type ChildWatchdogStateSnapshot = ChildWatchdogProgress;
+export declare function resolveChildWatchdogConfig(input: {
+    config: ResolvedWatchdogConfig;
+    agent?: string;
+    runId?: string;
+    childIndex?: number;
+}): ChildWatchdogConfig | undefined;
+export declare function decodeChildWatchdogConfig(raw: string | undefined): ChildWatchdogConfig | undefined;
+export declare function isChildWatchdogStatusEvent(value: unknown): value is ChildWatchdogStatusEvent;
+export declare function childWatchdogIsActive(snapshot: ChildWatchdogStateSnapshot | undefined): boolean;
+export declare function acceptChildWatchdogEvent(input: {
+    current: ChildWatchdogStateSnapshot | undefined;
+    event: ChildWatchdogStatusEvent;
+    runId?: string;
+    agent?: string;
+    childIndex?: number;
+}): ChildWatchdogStateSnapshot | undefined;
+/** An assistant turn marks earlier warnings addressed. Undefined when unchanged. */
+export declare function applyChildWatchdogMessage(current: ChildWatchdogStateSnapshot | undefined, message: unknown): ChildWatchdogStateSnapshot | undefined;
+export declare function unresolvedChildWatchdogBlockers(progress: Pick<ChildWatchdogProgress, "warnings"> | undefined): ChildWatchdogWarningSummary[];
+export declare function childWatchdogProgressForModel(progress: ChildWatchdogProgress | undefined): ChildWatchdogProgress | undefined;
+//# sourceMappingURL=child-status.d.ts.map

package/src/watchdog/child-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-status.d.ts","sourceRoot":"","sources":["../../../src/watchdog/child-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAA6D,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExK,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,eAAO,MAAM,2BAA2B,6BAA6B,CAAC;AAEtE,eAAO,MAAM,qBAAqB,mDAAoD,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,GAAG,EAAE,iBAAiB,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,OAAO,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,OAAO,2BAA2B,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,kBAAkB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAED,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAE/D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,mBAAmB,GAAG,SAAS,CAoBlC;AA8DD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CA6BlG;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAqB5F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,SAAS,GAAG,OAAO,CAG/F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAChD,KAAK,EAAE,wBAAwB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,0BAA0B,GAAG,SAAS,CAgBzC;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAGnJ;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,2BAA2B,EAAE,CAE5I;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAI5H"}

package/src/watchdog/child-status.js

@@ -0,0 +1,188 @@
+import { WATCHDOG_WARNING_CATEGORIES, WATCHDOG_WARNING_IMPORTANCES } from "./types.js";
+export const CHILD_WATCHDOG_WARNING_LIMIT = 20;
+export const CHILD_WATCHDOG_STATUS_EVENT = "subagent.watchdog.status";
+export const CHILD_WATCHDOG_PHASES = ["idle", "reviewing", "stale", "failed"];
+export function resolveChildWatchdogConfig(input) {
+    const override = input.agent ? input.config.children.overrides[input.agent] : undefined;
+    const enabled = input.config.enabled && (override?.enabled ?? input.config.children.enabled);
+    if (!enabled)
+        return undefined;
+    const model = override?.model ?? input.config.children.model;
+    const thinking = override?.thinking ?? input.config.children.thinking;
+    const cadence = override?.cadence ?? input.config.children.cadence ?? input.config.cadence;
+    return {
+        ...(input.runId ? { runId: input.runId } : {}),
+        ...(input.agent ? { agent: input.agent } : {}),
+        ...(input.childIndex !== undefined ? { childIndex: input.childIndex } : {}),
+        watchdogTailTimeoutMs: input.config.children.watchdogTailTimeoutMs,
+        agentEndTimeoutMs: input.config.agentEndTimeoutMs,
+        maxWarnings: input.config.maxWarnings,
+        ...(model ? { model } : {}),
+        ...(thinking !== undefined ? { thinking } : {}),
+        lsp: { ...input.config.lsp },
+        stalemateRepeats: input.config.stalemateRepeats,
+        cadence: { everyNTools: cadence.everyNTools ?? null },
+    };
+}
+function childConfigObject(value, field) {
+    if (value && typeof value === "object" && !Array.isArray(value))
+        return value;
+    throw new Error(`Invalid child watchdog config: ${field} must be an object.`);
+}
+function childConfigOptionalString(input, field) {
+    if (!(field in input))
+        return undefined;
+    const value = input[field];
+    if (typeof value === "string" && value.trim())
+        return value;
+    throw new Error(`Invalid child watchdog config: ${field} must be a non-empty string.`);
+}
+function childConfigOptionalIndex(input, field) {
+    if (!(field in input))
+        return undefined;
+    const value = input[field];
+    if (typeof value === "number" && Number.isInteger(value) && value >= 0)
+        return value;
+    throw new Error(`Invalid child watchdog config: ${field} must be a non-negative integer.`);
+}
+function childConfigPositiveInteger(input, field) {
+    const value = input[field];
+    if (typeof value === "number" && Number.isInteger(value) && value >= 1)
+        return value;
+    throw new Error(`Invalid child watchdog config: ${field} must be a positive integer.`);
+}
+function childConfigNullableNonNegativeInteger(input, field) {
+    const value = input[field];
+    if (value === null)
+        return null;
+    if (typeof value === "number" && Number.isInteger(value) && value >= 0)
+        return value;
+    throw new Error(`Invalid child watchdog config: ${field} must be null or a non-negative integer.`);
+}
+function childConfigCadence(value) {
+    const input = childConfigObject(value, "cadence");
+    const everyNTools = input.everyNTools;
+    if (everyNTools === null)
+        return { everyNTools: null };
+    if (typeof everyNTools === "number" && Number.isInteger(everyNTools) && everyNTools >= 5)
+        return { everyNTools };
+    throw new Error("Invalid child watchdog config: cadence.everyNTools must be null or an integer >= 5.");
+}
+function childConfigLsp(value) {
+    const input = childConfigObject(value, "lsp");
+    if (typeof input.enabled !== "boolean")
+        throw new Error("Invalid child watchdog config: lsp.enabled must be a boolean.");
+    if (typeof input.timeoutMs !== "number" || !Number.isInteger(input.timeoutMs) || input.timeoutMs < 1) {
+        throw new Error("Invalid child watchdog config: lsp.timeoutMs must be a positive integer.");
+    }
+    if (typeof input.maxFiles !== "number" || !Number.isInteger(input.maxFiles) || input.maxFiles < 1) {
+        throw new Error("Invalid child watchdog config: lsp.maxFiles must be a positive integer.");
+    }
+    if (typeof input.maxDiagnostics !== "number" || !Number.isInteger(input.maxDiagnostics) || input.maxDiagnostics < 0) {
+        throw new Error("Invalid child watchdog config: lsp.maxDiagnostics must be a non-negative integer.");
+    }
+    return {
+        enabled: input.enabled,
+        timeoutMs: input.timeoutMs,
+        maxFiles: input.maxFiles,
+        maxDiagnostics: input.maxDiagnostics,
+    };
+}
+export function decodeChildWatchdogConfig(raw) {
+    if (!raw)
+        return undefined;
+    const parsed = childConfigObject(JSON.parse(raw), "root");
+    if (Object.hasOwn(parsed, "fallbackModels")) {
+        throw new Error("Invalid child watchdog config: fallbackModels was removed; configure one model instead.");
+    }
+    if (parsed.enabled === false)
+        return undefined;
+    if ("enabled" in parsed && parsed.enabled !== true)
+        throw new Error("Invalid child watchdog config: enabled must be true or false.");
+    const thinking = parsed.thinking;
+    if (thinking !== undefined && typeof thinking !== "string" && thinking !== false) {
+        throw new Error("Invalid child watchdog config: thinking must be a string or false.");
+    }
+    const runId = childConfigOptionalString(parsed, "runId");
+    const agent = childConfigOptionalString(parsed, "agent");
+    const childIndex = childConfigOptionalIndex(parsed, "childIndex");
+    const model = childConfigOptionalString(parsed, "model");
+    return {
+        ...(runId ? { runId } : {}),
+        ...(agent ? { agent } : {}),
+        ...(childIndex !== undefined ? { childIndex } : {}),
+        watchdogTailTimeoutMs: childConfigPositiveInteger(parsed, "watchdogTailTimeoutMs"),
+        agentEndTimeoutMs: childConfigPositiveInteger(parsed, "agentEndTimeoutMs"),
+        maxWarnings: childConfigNullableNonNegativeInteger(parsed, "maxWarnings"),
+        ...(model ? { model } : {}),
+        ...(thinking !== undefined ? { thinking: thinking } : {}),
+        lsp: childConfigLsp(parsed.lsp),
+        stalemateRepeats: childConfigPositiveInteger(parsed, "stalemateRepeats"),
+        cadence: childConfigCadence(parsed.cadence),
+    };
+}
+export function isChildWatchdogStatusEvent(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const event = value;
+    const warningValue = event.warning;
+    const warning = warningValue;
+    const validWarning = warningValue === undefined || (warningValue !== null && typeof warningValue === "object" && !Array.isArray(warningValue)
+        && (warning.severity === "concern" || warning.severity === "blocker")
+        && typeof warning.importance === "string" && WATCHDOG_WARNING_IMPORTANCES.includes(warning.importance)
+        && typeof warning.category === "string" && WATCHDOG_WARNING_CATEGORIES.includes(warning.category)
+        && typeof warning.summary === "string" && typeof warning.evidence === "string" && typeof warning.recommendedAction === "string"
+        && typeof warning.addressed === "boolean" && typeof warning.stalemate === "boolean"
+        && (warning.displayedAt === undefined || typeof warning.displayedAt === "string"));
+    return event.type === CHILD_WATCHDOG_STATUS_EVENT
+        && typeof event.seq === "number"
+        && Number.isInteger(event.seq)
+        && event.seq >= 0
+        && typeof event.ts === "number"
+        && Number.isFinite(event.ts)
+        && typeof event.phase === "string"
+        && CHILD_WATCHDOG_PHASES.includes(event.phase)
+        && validWarning;
+}
+export function childWatchdogIsActive(snapshot) {
+    if (!snapshot)
+        return false;
+    return snapshot.phase === "reviewing";
+}
+export function acceptChildWatchdogEvent(input) {
+    if (input.runId !== undefined && input.event.runId !== input.runId)
+        return undefined;
+    if (input.agent !== undefined && input.event.agent !== input.agent)
+        return undefined;
+    const eventIndex = input.event.childIndex ?? input.event.stepIndex;
+    if (input.childIndex !== undefined && eventIndex !== input.childIndex)
+        return undefined;
+    if (input.current && input.event.seq <= input.current.seq)
+        return undefined;
+    const warnings = input.event.warning
+        ? [...(input.current?.warnings ?? []), input.event.warning].slice(-CHILD_WATCHDOG_WARNING_LIMIT)
+        : input.current?.warnings;
+    return {
+        phase: input.event.phase,
+        seq: input.event.seq,
+        lastUpdate: input.event.ts,
+        ...(input.event.reason ? { reason: input.event.reason } : {}),
+        ...(warnings?.length ? { warnings } : {}),
+    };
+}
+/** An assistant turn marks earlier warnings addressed. Undefined when unchanged. */
+export function applyChildWatchdogMessage(current, message) {
+    if (message?.role !== "assistant" || !current?.warnings?.some((entry) => !entry.addressed))
+        return undefined;
+    return { ...current, warnings: current.warnings.map((entry) => entry.addressed ? entry : { ...entry, addressed: true }) };
+}
+export function unresolvedChildWatchdogBlockers(progress) {
+    return (progress?.warnings ?? []).filter((warning) => warning.severity === "blocker" && (!warning.addressed || warning.stalemate));
+}
+export function childWatchdogProgressForModel(progress) {
+    if (!progress)
+        return undefined;
+    const warnings = (progress.warnings ?? []).filter((warning) => warning.importance === "high");
+    return { ...progress, warnings: warnings.length ? warnings : undefined };
+}
+//# sourceMappingURL=child-status.js.map

package/src/watchdog/child-status.js.map

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

package/src/watchdog/diff-tool.d.ts

@@ -0,0 +1,23 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type, type Static } from "typebox";
+export declare const WATCHDOG_DIFF_TOOL_NAME = "watchdog_diff";
+export declare const WATCHDOG_DIFF_MAX_CHARS = 24000;
+export interface WatchdogDiffBaseline {
+    root: string;
+    ref: string;
+}
+declare const WatchdogDiffParams: Type.TObject<{
+    path: Type.TOptional<Type.TString>;
+    stat: Type.TOptional<Type.TBoolean>;
+}>;
+type WatchdogDiffParams = Static<typeof WatchdogDiffParams>;
+/** HEAD at session start, so later child commits still show in the diff. */
+export declare function captureWatchdogDiffBaseline(cwd: string): WatchdogDiffBaseline | undefined;
+/** In a shared cwd, changes already pending when the session started also appear. */
+export declare function createWatchdogDiffTool(baseline: WatchdogDiffBaseline, options?: {
+    workingTreeAtLaunch?: boolean;
+}): AgentTool<typeof WatchdogDiffParams, {
+    chars: number;
+}>;
+export {};
+//# sourceMappingURL=diff-tool.d.ts.map

package/src/watchdog/diff-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-tool.d.ts","sourceRoot":"","sources":["../../../src/watchdog/diff-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAG9C,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,QAAA,MAAM,kBAAkB;;;EAGW,CAAC;AAEpC,KAAK,kBAAkB,GAAG,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAO5D,4EAA4E;AAC5E,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAQzF;AAiBD,qFAAqF;AACrF,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,SAAS,CAAC,OAAO,kBAAkB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCzD"}

package/src/watchdog/diff-tool.js

@@ -0,0 +1,84 @@
+import { spawnSync } from "node:child_process";
+import * as path from "node:path";
+import { Type } from "typebox";
+export const WATCHDOG_DIFF_TOOL_NAME = "watchdog_diff";
+export const WATCHDOG_DIFF_MAX_CHARS = 24_000;
+const MAX_UNTRACKED_FILES = 50;
+const WatchdogDiffParams = Type.Object({
+    path: Type.Optional(Type.String({ description: "Restrict the diff to one file or directory, relative to the repo root." })),
+    stat: Type.Optional(Type.Boolean({ description: "Return per-file change counts instead of the full diff." })),
+}, { additionalProperties: false });
+function runGit(root, args) {
+    const result = spawnSync("git", ["-C", root, ...args], { encoding: "utf-8", maxBuffer: 16 * 1024 * 1024, windowsHide: true });
+    return { ok: result.status === 0, stdout: result.stdout ?? "", stderr: (result.stderr ?? "").trim() };
+}
+/** HEAD at session start, so later child commits still show in the diff. */
+export function captureWatchdogDiffBaseline(cwd) {
+    const toplevel = runGit(cwd, ["rev-parse", "--show-toplevel"]);
+    if (!toplevel.ok)
+        return undefined;
+    const head = runGit(cwd, ["rev-parse", "HEAD"]);
+    if (!head.ok)
+        return undefined;
+    const root = toplevel.stdout.trim();
+    const ref = head.stdout.trim();
+    return root && ref ? { root, ref } : undefined;
+}
+function validatePath(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed.startsWith("-"))
+        throw new Error("watchdog_diff path must not start with '-'.");
+    if (path.isAbsolute(trimmed))
+        throw new Error("watchdog_diff path must be relative to the repo root.");
+    if (trimmed.split(/[\\/]/).includes(".."))
+        throw new Error("watchdog_diff path must not contain '..'.");
+    return trimmed;
+}
+function bound(text) {
+    if (text.length <= WATCHDOG_DIFF_MAX_CHARS)
+        return text;
+    const marker = `\n\n[... ${text.length - WATCHDOG_DIFF_MAX_CHARS} characters omitted; call again with a narrower path ...]`;
+    return `${text.slice(0, WATCHDOG_DIFF_MAX_CHARS - marker.length)}${marker}`;
+}
+/** In a shared cwd, changes already pending when the session started also appear. */
+export function createWatchdogDiffTool(baseline, options = {}) {
+    const workingTreeAtLaunch = options.workingTreeAtLaunch === true;
+    return {
+        name: WATCHDOG_DIFF_TOOL_NAME,
+        label: "Watchdog diff",
+        description: workingTreeAtLaunch
+            ? "Show the current staged and unstaged working-tree delta against reviewer-launch HEAD, plus untracked file paths. Committed ranges are not included. Optional path narrows it; stat:true returns per-file counts only."
+            : "Show the repository diff since the review baseline, plus untracked file paths. Optional path narrows it; stat:true returns per-file counts only.",
+        parameters: WatchdogDiffParams,
+        executionMode: "sequential",
+        async execute(_toolCallId, params) {
+            const pathFilter = validatePath(params.path);
+            const diff = runGit(baseline.root, ["diff", "--no-color", "--no-ext-diff", ...(params.stat === true ? ["--stat"] : []), baseline.ref, "--", ...(pathFilter ? [pathFilter] : [])]);
+            if (!diff.ok)
+                throw new Error(`git diff failed: ${diff.stderr || "unknown error"}`);
+            const untrackedResult = runGit(baseline.root, ["ls-files", "--others", "--exclude-standard", "-z", "--", ...(pathFilter ? [pathFilter] : [])]);
+            if (workingTreeAtLaunch) {
+                const currentHead = runGit(baseline.root, ["rev-parse", "HEAD"]);
+                if (!currentHead.ok || currentHead.stdout.trim() !== baseline.ref) {
+                    const text = "Reviewer-launch HEAD changed or is unavailable. Committed changes are unsupported; relaunch the reviewer or supply a diff artifact.";
+                    return { content: [{ type: "text", text }], details: { chars: text.length } };
+                }
+            }
+            const untracked = untrackedResult.ok ? untrackedResult.stdout.split("\0").filter(Boolean) : [];
+            const sections = [diff.stdout.trimEnd()];
+            if (untracked.length) {
+                const shown = untracked.slice(0, MAX_UNTRACKED_FILES);
+                sections.push(["Untracked files (use read to inspect):", ...shown.map((file) => ` ${file}`)].join("\n"));
+                if (untracked.length > shown.length)
+                    sections.push(`... ${untracked.length - shown.length} more untracked files`);
+            }
+            const text = bound(sections.filter(Boolean).join("\n\n")) || (workingTreeAtLaunch
+                ? `No working-tree changes against reviewer-launch HEAD ${baseline.ref.slice(0, 12)}. Committed changes are not included.`
+                : `No changes since baseline ${baseline.ref.slice(0, 12)}.`);
+            return { content: [{ type: "text", text }], details: { chars: text.length } };
+        },
+    };
+}
+//# sourceMappingURL=diff-tool.js.map