@prestyj/cli 5.28.0 → 5.29.0

package/dist/core/subagent-receipt.js

@@ -0,0 +1,276 @@
+import path from "node:path";
+/**
+ * Engine-generated receipt for a helper agent's report.
+ *
+ * The parent only ever saw a child's prose, and prose can cite files the child
+ * never opened. The receipt is built from the child's real tool-call events, so
+ * the model cannot write or forge it. It gives the parent checkable handles:
+ * which files the child read or changed, which commands it ran and how they
+ * exited, and which paths its report names that it never touched.
+ */
+/** Hard cap on the "Receipt (…)" line. */
+export const RECEIPT_MAX_CHARS = 600;
+/** Unbacked paths listed before "+N more". */
+export const UNBACKED_MAX_PATHS = 5;
+const TARGET_MAX_CHARS = 60;
+const COMMAND_MAX_CHARS = 40;
+const FILE_TOOLS = new Set(["read", "write", "edit"]);
+const MUTATING_TOOLS = new Set(["write", "edit"]);
+const ROOT_TOOLS = new Set(["grep", "find", "ls", "code_search"]);
+function str(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/** The one argument that identifies what a tool call acted on. */
+export function keyTarget(name, args = {}) {
+    switch (name) {
+        case "read":
+        case "write":
+        case "edit":
+            return str(args.file_path) ?? str(args.path) ?? "";
+        case "ls":
+            return str(args.path) ?? ".";
+        case "grep":
+        case "find":
+            return str(args.pattern) ?? "";
+        case "code_search":
+        case "web_search":
+            return str(args.query) ?? "";
+        case "code_nav":
+            return str(args.file) ?? "";
+        case "bash":
+            return (str(args.command) ?? "").split("\n")[0].trim();
+        case "web_fetch":
+            return str(args.url) ?? "";
+        case "source_path":
+            return str(args.package) ?? "";
+        case "subagent":
+        case "spawn_agent":
+            if (Array.isArray(args.tasks))
+                return `${args.tasks.length} tasks`;
+            return str(args.agent) ?? str(args.task_name) ?? "";
+        case "task_output":
+        case "task_stop":
+        case "task_send":
+            return str(args.id) ?? "";
+        case "skill":
+            return str(args.skill) ?? "";
+        default: {
+            const first = Object.values(args).find((value) => typeof value === "string" && value);
+            return typeof first === "string" ? first.split("\n")[0].trim() : "";
+        }
+    }
+}
+function rootOf(name, args) {
+    if (!ROOT_TOOLS.has(name))
+        return undefined;
+    return str(args.path) ?? ".";
+}
+/** Pairs tool_call_start/tool_call_end events by toolCallId. */
+export class ReceiptRecorder {
+    calls = [];
+    byId = new Map();
+    start(toolCallId, name, args) {
+        const toolName = typeof name === "string" && name ? name : "tool";
+        const toolArgs = args && typeof args === "object" ? args : {};
+        const call = {
+            name: toolName,
+            target: keyTarget(toolName, toolArgs),
+            root: rootOf(toolName, toolArgs),
+            outcome: "pending",
+        };
+        this.calls.push(call);
+        if (typeof toolCallId === "string" && toolCallId)
+            this.byId.set(toolCallId, call);
+    }
+    end(toolCallId, result, isError) {
+        if (typeof toolCallId !== "string")
+            return;
+        const call = this.byId.get(toolCallId);
+        if (!call)
+            return;
+        this.byId.delete(toolCallId);
+        call.outcome = isError ? "error" : "ok";
+        if (call.name === "bash" && typeof result === "string") {
+            const match = /^Exit code: (\S+)/.exec(result);
+            if (match)
+                call.exitCode = match[1];
+        }
+    }
+    reset() {
+        this.calls = [];
+        this.byId.clear();
+    }
+    snapshot() {
+        return this.calls.map((call) => ({ ...call }));
+    }
+    /** Receipt + unbacked-path block for a finished report. */
+    render(reportText, cwd) {
+        return buildHelperReceipt(this.calls, reportText, cwd);
+    }
+}
+function displayPath(raw, cwd) {
+    let shown = raw;
+    if (path.isAbsolute(raw)) {
+        const relative = path.relative(cwd, raw);
+        if (relative && !relative.startsWith("..") && !path.isAbsolute(relative))
+            shown = relative;
+    }
+    shown = shown.split(path.sep).join("/");
+    if (shown.length <= TARGET_MAX_CHARS)
+        return shown;
+    const parts = shown.split("/");
+    const tail = `…/${parts.slice(-2).join("/")}`;
+    return tail.length <= TARGET_MAX_CHARS ? tail : `…${shown.slice(-(TARGET_MAX_CHARS - 1))}`;
+}
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+function renderTarget(call, cwd) {
+    const { name, target } = call;
+    if (!target)
+        return "";
+    if (FILE_TOOLS.has(name) || name === "ls" || name === "code_nav") {
+        return displayPath(target, cwd);
+    }
+    if (name === "bash")
+        return `\`${clip(target, COMMAND_MAX_CHARS)}\``;
+    if (name === "grep" || name === "find" || name === "code_search" || name === "web_search") {
+        const root = call.root && call.root !== "." ? ` in ${displayPath(call.root, cwd)}` : "";
+        return `"${clip(target, TARGET_MAX_CHARS - 2)}"${root}`;
+    }
+    return clip(target, TARGET_MAX_CHARS);
+}
+function renderOutcome(call) {
+    if (call.name === "bash" && call.exitCode !== undefined)
+        return ` → exit ${call.exitCode}`;
+    if (call.outcome === "error")
+        return " ✗";
+    if (call.outcome === "pending")
+        return " (unfinished)";
+    if (MUTATING_TOOLS.has(call.name))
+        return " ✓";
+    return "";
+}
+/**
+ * `Receipt (N calls): read a.ts, b.ts · bash \`npm test\` → exit 0 · edit b.ts ✓`
+ * Groups by tool, collapses identical items as ×N, sorts tools and items
+ * alphabetically, and caps the line at RECEIPT_MAX_CHARS with "+N more".
+ */
+export function formatReceipt(calls, cwd) {
+    const header = `Receipt (${calls.length} call${calls.length === 1 ? "" : "s"})`;
+    if (calls.length === 0)
+        return `${header}: no tool calls`;
+    const groups = new Map();
+    for (const call of calls) {
+        const item = `${renderTarget(call, cwd)}${renderOutcome(call)}`.trim();
+        const group = groups.get(call.name) ?? new Map();
+        group.set(item, (group.get(item) ?? 0) + 1);
+        groups.set(call.name, group);
+    }
+    const items = [];
+    for (const tool of [...groups.keys()].sort()) {
+        const group = groups.get(tool);
+        for (const item of [...group.keys()].sort()) {
+            const count = group.get(item);
+            items.push({ tool, text: `${item}${count > 1 ? ` ×${count}` : ""}` });
+        }
+    }
+    let line = `${header}:`;
+    let lastTool;
+    for (let index = 0; index < items.length; index++) {
+        const { tool, text } = items[index];
+        const piece = tool === lastTool
+            ? `, ${text}`
+            : `${lastTool === undefined ? " " : " · "}${tool}${text ? ` ${text}` : ""}`;
+        const remaining = items.length - index - 1;
+        // Reserve room for the "+N more" suffix unless this is the last item.
+        const reserve = remaining > 0 ? ` · +${remaining} more`.length : 0;
+        if (line.length + piece.length + reserve > RECEIPT_MAX_CHARS) {
+            return `${line} · +${items.length - index} more`;
+        }
+        line += piece;
+        lastTool = tool;
+    }
+    return line;
+}
+const PATH_EXTENSIONS = "tsx|ts|mts|cts|jsx|js|mjs|cjs|json|jsonc|md|mdx|py|go|rs|java|kt|kts|cs|rb|php|swift|" +
+    "c|cc|cpp|h|hpp|m|sh|bash|zsh|ps1|yml|yaml|toml|ini|css|scss|sass|less|html|vue|svelte|" +
+    "sql|graphql|proto|txt|lock|xml|gradle|env";
+// A path-ish token: optional ./ ../ or / prefix, any directory segments, and a
+// file name ending in a known source extension, optionally followed by
+// :line[:col]. Lookbehind rejects mid-token starts (inside URLs, a.b.c chains).
+const PATH_RE = new RegExp(`(?<![\\w@:/.\\\\-])((?:\\.{1,2}/|/)?(?:[\\w@.-]+/)*[\\w@-][\\w@.-]*\\.(?:${PATH_EXTENSIONS}))` +
+    `(?::\\d+(?::\\d+)?)?(?![\\w/-])`, "g");
+const URL_RE = /\b[a-z][a-z0-9+.-]*:\/\/\S+/gi;
+/** Prose names, not files: "Node.js", "Next.js", "Vue.js". */
+const LIBRARY_NAME_RE = /^[A-Z][A-Za-z]*\.js$/;
+/** Paths a report mentions, de-duplicated, without :line suffixes. */
+export function extractReportPaths(reportText) {
+    const text = reportText.replace(URL_RE, " ");
+    const found = new Set();
+    for (const match of text.matchAll(PATH_RE)) {
+        const candidate = match[1];
+        if (LIBRARY_NAME_RE.test(candidate))
+            continue;
+        if (/^\.+$/.test(candidate))
+            continue;
+        found.add(candidate);
+    }
+    return [...found];
+}
+function isUnder(target, root) {
+    if (target === root)
+        return true;
+    const prefix = root.endsWith(path.sep) ? root : `${root}${path.sep}`;
+    return target.startsWith(prefix);
+}
+/**
+ * Paths the report names that the helper never read, wrote, edited, listed or
+ * searched. Conservative by design — anything plausibly touched is covered:
+ * exact resolved match, inside a grep/find/ls/code_search root, or (for a
+ * relative mention) the trailing segments of a touched file.
+ */
+export function findUnbackedPaths(reportText, calls, cwd) {
+    const files = [];
+    const roots = [];
+    for (const call of calls) {
+        if (call.outcome === "error")
+            continue;
+        if ((FILE_TOOLS.has(call.name) || call.name === "code_nav") && call.target) {
+            files.push(path.resolve(cwd, call.target));
+        }
+        if (call.root)
+            roots.push(path.resolve(cwd, call.root));
+    }
+    const unbacked = [];
+    for (const mention of extractReportPaths(reportText)) {
+        const resolved = path.resolve(cwd, mention);
+        if (files.includes(resolved))
+            continue;
+        if (roots.some((root) => isUnder(resolved, root)))
+            continue;
+        if (!path.isAbsolute(mention)) {
+            const suffix = `${path.sep}${path.normalize(mention).replace(/^(\.\.?[\\/])+/, "")}`;
+            if (files.some((file) => file.endsWith(suffix)))
+                continue;
+        }
+        unbacked.push(mention);
+    }
+    return unbacked.sort();
+}
+export function formatUnbacked(paths) {
+    if (paths.length === 0)
+        return undefined;
+    const shown = paths.slice(0, UNBACKED_MAX_PATHS).join(", ");
+    const more = paths.length > UNBACKED_MAX_PATHS ? `, +${paths.length - UNBACKED_MAX_PATHS} more` : "";
+    return `Not opened by this helper: ${shown}${more}`;
+}
+/** Full receipt block appended to a helper's result. */
+export function buildHelperReceipt(calls, reportText, cwd) {
+    const lines = [formatReceipt(calls, cwd)];
+    const unbacked = formatUnbacked(findUnbackedPaths(reportText, calls, cwd));
+    if (unbacked)
+        lines.push(unbacked);
+    return lines.join("\n");
+}
+//# sourceMappingURL=subagent-receipt.js.map

package/dist/core/subagent-receipt.js.map

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

package/dist/core/subagent-turn-record.d.ts

@@ -1,6 +1,8 @@
 export interface SubagentTurnRecord {
     status: "completed" | "interrupted" | "failed";
     output?: string;
+    /** Engine-built receipt of the turn's tool calls (see subagent-receipt.ts). */
+    receipt?: string;
     error?: string;
     model?: string;
     turn_count: number;

package/dist/core/subagent-turn-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-turn-record.js","sourceRoot":"","sources":["../../src/core/subagent-turn-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAYrC,SAAS,UAAU,CAAC,gBAAwB;IAC1C,4EAA4E;IAC5E,wEAAwE;IACxE,OAAO,GAAG,gBAAgB,YAAY,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,MAAM,GAAG,KAAoC,CAAC;IACpD,OAAO,CACL,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW;QAC5B,MAAM,CAAC,MAAM,KAAK,aAAa;QAC/B,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,WAAW;QACpB,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,QAAQ;QAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;QACzC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,QAAQ;QAC7C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QAC1C,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;QACvC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,gBAAoC,EACpC,MAA0B;IAE1B,IAAI,CAAC,gBAAgB;QAAE,OAAO;IAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,mCAAmC,EAAE;YAC3D,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,gBAAoC;IAEpC,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,gBAAgB;YAAE,OAAO,SAAS,CAAC;QACtE,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACzE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,gBAAoC;IACxE,IAAI,CAAC,gBAAgB;QAAE,OAAO;IAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"subagent-turn-record.js","sourceRoot":"","sources":["../../src/core/subagent-turn-record.ts"],"names":[],"mappings":"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"}

package/dist/core/test-impact.d.ts

@@ -0,0 +1,73 @@
+export interface TestImpactOptions {
+    now?: () => number;
+}
+/** Names a module exports, from its source text. */
+export declare function parseExports(source: string): Set<string>;
+export interface EditImpact {
+    /** Nearest test files reaching the changed file, relative to cwd, sorted. */
+    tests: string[];
+    /** Tests reaching it only through more layers of imports; counted, not listed. */
+    fartherTests: number;
+    /** One shell command per package that runs exactly those tests. */
+    commands: string[];
+    /** Exports the edit removed that some importer still imports by name. */
+    brokenCallers: Array<{
+        name: string;
+        importers: string[];
+    }>;
+}
+export declare class TestImpactIndex {
+    private readonly cwd;
+    private readonly entries;
+    private readonly importers;
+    private known;
+    private scannedAt;
+    private scanning;
+    /** Export sets captured just before a tool write, keyed by absolute path. */
+    private readonly preWriteExports;
+    /** Files whose reaching tests were already shown; later edits stay quiet. */
+    private readonly shown;
+    private readonly runnerCache;
+    private readonly now;
+    constructor(cwd: string, options?: TestImpactOptions);
+    /** Record a file's exports before a tool overwrites it. */
+    beforeWrite(absPath: string): Promise<void>;
+    /**
+     * Model-facing note for a just-written file: the tests that reach it (first
+     * edit of each file only) and importers left using a removed export (every
+     * time). Empty when there is nothing to say.
+     */
+    noteAfterWrite(absPath: string, content: string): Promise<string>;
+    /** Tests and commands covering a set of changed files (cwd-relative or absolute). */
+    impactFor(files: Iterable<string>, brokenCallers?: EditImpact["brokenCallers"]): Promise<EditImpact>;
+    private isSource;
+    private ensureScanned;
+    /**
+     * Source files under cwd, cwd-relative and sorted. `git ls-files` first: it
+     * applies every nested .gitignore and never walks ignored trees (measured on
+     * this repo: 17ms vs 12s for a directory walk that descends into build
+     * output before filtering). The walk is the fallback outside a git checkout.
+     */
+    private listSourceFiles;
+    private scan;
+    private resolveSpec;
+    private updateEntry;
+    private removeEntry;
+    /**
+     * Tests reaching `file`, nearest import layer first. A layer is added while
+     * the running total stays at or under {@link MAX_COMMAND_TESTS}, and the
+     * first layer that finds any test is always added. Without the cap a shared
+     * hub (a session object most tests construct) makes a leaf helper "reach"
+     * half the suite, and a list that long is a list nobody runs. `farther`
+     * counts the reaching tests left out.
+     */
+    private reachingTests;
+    private brokenCallers;
+    /** Nearest package.json's test runner (vitest or jest), walking up to cwd. */
+    private runnerFor;
+    private commandsFor;
+}
+/** The note appended to a successful edit/write result. Empty when nothing applies. */
+export declare function formatEditImpactNote(relPath: string, impact: EditImpact): string;
+/** One line for the verification demand: which tests reach the changed files, and how to run them. */
+export declare function formatImpactForVerification(impact: EditImpact): string;