@prestyj/cli 5.28.1 → 5.29.0

package/dist/utils/process.js

@@ -1,4 +1,5 @@
 import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import path from "node:path";
 const DEFAULT_TASKKILL_TIMEOUT_MS = 5_000;
 function getEnvCaseInsensitive(env, name) {
@@ -74,4 +75,101 @@ function killSingleProcess(pid, kill) {
         // Process already exited.
     }
 }
+/** `[pid, ppid]` for every live process, from `/proc` (Linux) or `ps`. */
+function readProcessTable(platform) {
+    if (platform === "linux") {
+        try {
+            const rows = [];
+            for (const name of readdirSync("/proc")) {
+                if (!/^\d+$/.test(name))
+                    continue;
+                try {
+                    // `pid (comm) state ppid …` — comm may contain spaces/parens, so
+                    // parse from the LAST `)`.
+                    const stat = readFileSync(`/proc/${name}/stat`, "utf-8");
+                    const ppid = parseInt(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1] ?? "", 10);
+                    if (!Number.isNaN(ppid))
+                        rows.push([Number(name), ppid]);
+                }
+                catch {
+                    // Exited mid-scan.
+                }
+            }
+            if (rows.length > 0)
+                return rows;
+        }
+        catch {
+            // No readable /proc — fall through to ps.
+        }
+    }
+    // Absolute path when present: a bare `ps` is resolvable through a PATH we
+    // do not control.
+    const ps = existsSync("/bin/ps") ? "/bin/ps" : "ps";
+    const res = spawnSync(ps, ["-A", "-o", "pid=", "-o", "ppid="], {
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 5_000,
+    });
+    if (res.status !== 0 || typeof res.stdout !== "string")
+        return [];
+    const rows = [];
+    for (const line of res.stdout.split("\n")) {
+        const [pid, ppid] = line.trim().split(/\s+/).map(Number);
+        if (Number.isInteger(pid) && Number.isInteger(ppid))
+            rows.push([pid, ppid]);
+    }
+    return rows;
+}
+/**
+ * Every live descendant of `pid` (breadth-first, excluding `pid` itself),
+ * found by parent links — so it also covers children that left the process
+ * group, unlike a group kill. POSIX only; returns `[]` on Windows, where
+ * shell pids (msys) do not map onto the native process table.
+ */
+export function listDescendantPids(pid, options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform === "win32")
+        return [];
+    const table = options.readTable ? options.readTable() : readProcessTable(platform);
+    const children = new Map();
+    for (const [child, parent] of table) {
+        if (child === parent)
+            continue;
+        const list = children.get(parent);
+        if (list)
+            list.push(child);
+        else
+            children.set(parent, [child]);
+    }
+    const seen = new Set();
+    const queue = [pid];
+    while (queue.length > 0) {
+        for (const child of children.get(queue.shift()) ?? []) {
+            if (child === pid || seen.has(child))
+                continue;
+            seen.add(child);
+            queue.push(child);
+        }
+    }
+    return [...seen];
+}
+/**
+ * Signal every descendant of `pid` without touching `pid` itself — stops a
+ * persistent shell's running command while the shell survives. Returns how
+ * many processes were signalled.
+ */
+export function signalDescendants(pid, signal, options = {}) {
+    const kill = options.kill ?? process.kill;
+    let signalled = 0;
+    for (const child of listDescendantPids(pid, options)) {
+        try {
+            kill(child, signal);
+            signalled++;
+        }
+        catch {
+            // Already gone.
+        }
+    }
+    return signalled;
+}
 //# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prestyj/cli",
-  "version": "5.28.1",
+  "version": "5.29.0",
   "type": "module",
   "description": "CLI coding agent with OAuth authentication for Anthropic, OpenAI, and Gemini",
   "license": "MIT",
@@ -115,10 +115,10 @@
     "typescript-language-server": "^5.3.0",
     "wrap-ansi": "^10.0.0",
     "zod": "^4.5.4",
-    "@prestyj/agent": "5.28.1",
-    "@prestyj/pixel": "4.3.101",
-    "@prestyj/core": "5.28.1",
-    "@prestyj/ai": "5.28.1"
+    "@prestyj/ai": "5.29.0",
+    "@prestyj/agent": "5.29.0",
+    "@prestyj/core": "5.29.0",
+    "@prestyj/pixel": "4.3.101"
   },
   "optionalDependencies": {
     "@huggingface/transformers": "4.2.0",

package/assets/motion/references/motion-language.md

@@ -1,128 +0,0 @@
-# Motion language
-
-Use this for every video you design. The user's brand kit, references or a
-chosen library look override any default below. These are principles, not a
-house look. Choose the concept, palette and type fresh for every video; never
-copy an earlier video's.
-
-## The bar
-
-Make a showcase piece, as if the best motion designers will judge it frame by
-frame. Ambition means deliberate craft, not length or effect count. Every
-colour, word, cut and ease needs a reason. Cut generic defaults: plain fades,
-slowly drifting gradients, text that slides up and sits there. Judge it as the
-kind of video it is: an explainer by how clearly it teaches, a tribute by how
-it honours its subject, a launch by how it makes people want the product.
-
-## Plan first
-
-Before writing code, decide these and record them in the `Concept` and
-`Language` lines of `frame.md`. A few lines is enough; nobody approves them.
-
-- **Concept**: the idea the video demonstrates, in one sentence. Show it; don't
-  just state it.
-- **Motif**: one shape or element that recurs and links every scene.
-- **Register**: the tone (calm, playful, urgent, tender, precise…) and what it
-  means for size, speed, easing and colour. Take it from the brief, the brand
-  and the viewing context.
-- **Palette**: each colour's role.
-- **Type**: each family's role.
-- **Beat**: tempo, arc and frame rate.
-
-## Principles
-
-**Register.** Map the tone to motion before choosing anything else. Quiet,
-steady motion carries information and reading; expressive motion is saved for
-the moments that matter, because it only reads as special against calm. These
-pairings are illustrative, not presets: calm is long, soft moves and few of
-them; playful is springy overshoot, squash and stretch; luxurious is slow and
-precise with generous space; urgent is fast moves and hard cuts; tender is
-warm, slow and held; technical is precise and snapping.
-
-**Continuity.** Each scene hands something to the next: a shape, a word, a
-colour field or a camera move. Prefer match cuts and shape handoffs to
-cross-fades. The `type-as-spatial-handoff` study in [README.md](README.md) shows
-type becoming the next scene.
-
-**Palette.** A few colours, each with a role, derived from the brand, subject or
-references. How many, how saturated and how often the frame changes colour
-follow the register: full-frame colour blocks that change on most cuts suit a
-loud, kinetic piece; a calm, tender or documentary piece holds a steadier field
-and lets one accent carry attention. Gradients and glows are seasoning, not the
-base. Keep text readable.
-
-**No harmful flashing.** Anything flashing over more than about 3% of the frame
-counts. Keep light/dark swaps, and swaps to and from saturated red, to at most
-six in any one second (three flashes): faster flashing can trigger seizures,
-and `motion_check` fails it. A swap on every beat at 120 BPM is fine; a white
-flash frame on every half-beat is not.
-
-**Type.** Choose faces for the register and the reading job. Size follows the
-viewing context and how much there is to read: a kinetic poster can set one to
-three huge words per shot; an explainer, documentary or lyric video sets whole
-lines at a comfortable reading size. Size type against the frame's shorter side
-(in vertical video, the width inside the safe margins) and check that the
-longest word fits. Animate weight and width axes as motion, not only position
-and opacity. Use one display family, at most one contrasting voice, such as an
-italic serif, and small uppercase tracked mono for labels and UI where the
-subject calls for it. Bundled axes (see `fonts.mjs list` and its specimen):
-weight and width in Mona Sans, Hubot Sans, Anybody, Archivo, Bricolage
-Grotesque and Martian Mono; italics in Fraunces and Newsreader. Brand fonts win.
-
-**Motion.** Smooth by default, bounce by choice. Entrances settle on the
-critically damped spring or `power3.out` / `expo.out`; exits `power3.in`; moves
-`power3.inOut` or `expo.inOut`. Overshoot (`back.out`, `elastic.out` or an
-underdamped spring) is a register chosen for playful or physical work, never
-the default; see [easing](runtime/gsap-easing-and-stagger.md). Durations follow
-the register: roughly 0.15–0.5 s for snappy, energetic or technical motion, and
-0.6–1.5 s or longer for calm, luxurious or tender work. Staggers run 0.012–0.06 s
-for type and longer for larger elements. Use real animation principles where
-they help: anticipation before big moves, squash and stretch on impact, arcs
-instead of straight paths, overlapping action, follow-through and smears on fast
-moves. Lead with one movement at a time, with smaller overlapping motion under
-it. Every move starts, travels and lands on purpose; nothing drifts without a
-reason.
-
-**Pace.** Keep time on a grid: the track's beats (`hf beats`) when there is
-music, otherwise a tempo chosen for the register. Cut by how much there is to
-take in, not by the grid alone: a simple image can last one beat; a line to
-read or an idea to grasp holds for several. Meaningful text stays still and
-readable for at least the longer of 0.8 s and one second per 15 characters,
-longer for the key line; repeated or decorative words can go faster. Vary the
-density (build, release, rest) so the video is neither always fast nor always
-slow. Shape the whole to its form, with a beginning, development, peak and
-resolution even in five seconds. Illustratively: a launch builds to its
-product, an explainer steps through its idea, a lyric video follows the song's
-sections, a tribute lets each moment breathe. End on a composed frame held long
-enough to read, and declare that hold in the hold plan before checking.
-
-**3D, when the subject earns it.** One hero object whose material, light and
-camera come from the concept and register, not a stock tech look; add
-supporting elements only when they mean something. Resolve 3D back to flat 2D to
-hand off to the next scene. Use the bundled Three.js (`three.mjs`); no 3D by
-default.
-
-**Chrome, when it suits.** A small persistent mono layer (labels, timecode,
-chapter name, a progress bar with markers) makes a tech subject feel like a pro
-tool. Leave it out elsewhere.
-
-**Frame rate.** 30 fps suits most work. Use 60 fps when fast, dense motion or
-scrolling UI must read smoothly; it doubles render time. Renders carry no
-motion blur, so fast moves stutter at 24 fps: keep 24 fps for slow, filmic or
-handmade work.
-
-**Truth.** Show only real product UI, numbers and claims from the user's
-sources.
-
-## Building blocks
-
-Library looks (`library.mjs list looks`) are complete palette, type and rhythm
-systems; when one fits the concept, it replaces the palette and type choices
-above. Library pieces are optional building blocks.
-
-## Check against the plan
-
-When `motion_check` returns frames, compare them with the plan in `frame.md` as
-well as the technical results. A lost motif, an off-palette colour, a generic
-transition or unreadable type is a concrete defect: fix it and check the new
-render.

package/assets/motion/skills/video-qa/SKILL.md

@@ -1,89 +0,0 @@
----
-name: video-qa
-description: One output-checking pass for a rendered Motion video. Use motion_check for technical checks and rendered images, inspect them in this session, fix concrete defects and deliver. No independent AI reviewer or creative approval ceremony.
----
-
-# Check the actual output once
-
-Judge the render against the plan in `frame.md` (its `Concept` and `Language`) and the approved inputs, not an alternative creative direction. The check finds defects; it is not an invitation to add effects, retime the motion or redesign the layout.
-
-## 1. Check the current export
-
-Call `motion_check` with:
-
-- `project`: the current HyperFrames project folder.
-- `output`: the actual rendered MP4, inside the workspace.
-- `windows`: representative motion/transition windows, each with `label`, `start` and `end` in seconds. Use the video's own timings; each window spans at least two frames and at most ten seconds, up to twelve windows.
-- `holds`: only when the video has a deliberate static section (an end card, reading hold or pause you designed), the path to its render-bound hold plan (format below). Write it before this first call; an undeclared deliberate hold is flagged as frozen and costs a second full check.
-- `slideshowRequested`: true only when the user actually requested a slideshow; never use it to hide broken motion.
-- `range`: only for an export longer than 180 seconds or a targeted diagnostic, a start/end range of at most 180 seconds. Report the inspected range honestly; do not claim full-video visual coverage.
-- `spot`: true for a quick check of a targeted fix or small edit. Put short `windows` around the moments you changed, at most 240 rendered frames in total (4 s at 60 fps). The layout check then covers every rendered frame inside them, far faster than the full check, while the pixel, hold and audio checks still cover the whole export. A spot result is never delivery verification: once it is clean, run the full check (without `spot`) once on the export you deliver.
-
-The tool runs HyperFrames `check` (which already includes lint), decoded-pixel analysis with `motion-check.mjs` including canvas/WebGL, a flash check of the whole export against the WCAG 2.3.1 limits, and audio analysis only when audio exists. It returns technical results and actual rendered overview, phone-size and consecutive-frame images **to you**, the working agent.
-
-Do not precede or follow it with another lint/check/audio/frame-extraction checklist. Diagnosing a specific failure it reported, or looking at a few frames while building, is part of the work, not a second check. Do not call the legacy `motion_review` prepare/submit workflow. No subagent, separate model critique, approval score or chapter registration is needed.
-
-## 2. Inspect what was returned
-
-Check the attached images for:
-
-- Correct user text, images, branding and permitted substitutions.
-- Missing media, overflow, clipping and unreadable text.
-- The planned motion and timing, including intended holds.
-- Representative entrance, active and exit frames for each scene.
-- The plan: the motif carries through, colours stay on palette, transitions are deliberate and type stays readable.
-
-Still images do not prove pacing at normal speed or that audio was heard. Use actual playback/listening only when needed and available; state the limit otherwise. Technical success is not proof of visual quality. Missing evidence is unverified, not PASS.
-
-If the tool fails, its check details list each problem with where and when it occurs, plus renderer notes such as undeclared fonts. Use them to diagnose the concrete problem; do not rerun the check by hand to see them. Runtime command details live in [technical diagnostics](../../references/runtime/lint-validate-inspect.md); they are troubleshooting references, not an extra mandatory pass. Never introduce generic drift, extra effects or layout changes just to satisfy a heuristic. If a real accessibility requirement conflicts with the plan, fix the accessibility problem.
-
-## 3. Fix only a concrete defect
-
-A failed check or visibly wrong output warrants a targeted fix, a new versioned render and a spot check of the fixed moments, then one full check once they are clean. An unchanged export does not need checking again unless you corrected its hold plan; that re-check reuses the passing source audit, so it is quick. Do not iterate toward subjective perfection or route the result to another reviewer. Report an unresolved blocker as draft/unverified rather than looping indefinitely or declaring success.
-
-The tool measures audio, reports its integrated loudness and true peak, and rejects non-finite levels or clipping; it does not normalize the file. Follow the user's delivery loudness target when they give one. Do not add audio to silent work or force every supplied animation through a generic -14 LUFS mix.
-
-A flash failure names when it happens and how fast. Retime or soften that moment: at most three light/dark or red swaps in any second, a smaller flashing area, or a smaller brightness difference. Never ship it, and never mark it as a hold to get past it.
-
-### Intentional holds
-
-Declare only deliberate static intervals: an end card, a reading hold or another still section you designed on purpose. The hold plan binds to the current video, so an old plan cannot excuse freezes in a changed export:
-
-```json
-{
-  "version": 1,
-  "videoSha256": "<SHA-256 of this exact export>",
-  "holds": [{ "start": 13, "end": 15, "reason": "End card hold" }]
-}
-```
-
-When a hold is stale, the check lists where the pixels actually freeze; correct the plan from those times instead of guessing. Do not mark the whole video as a hold to suppress broken animation. Retain any existing meaningful motion assertions; do not invent a new assertion sidecar for every video.
-
-## 4. Deliver
-
-Deliver the actual versioned MP4 in this order. The written message is what the user reads to understand what they got, so it is your final message: no `ask_user` card at delivery, which would come before the message and hide it.
-
-1. Reveal the file:
-
-   ```bash
-   <node> "<motion bin>/reveal.mjs" renders/<file>.mp4
-   ```
-
-2. Write the delivery message as your final message, in plain words:
-   - One bold line on what they got, in their words: length, shape, where it fits, how it ends.
-   - One line on anything you assumed, so a wrong guess is easy to spot.
-   - What the checks mean for their viewers, never the standard or tool names; those stay in `frame.md`. Mention only checks that actually ran and passed.
-   - What couldn't be checked, plainly. Do not claim full playback or audio listening from sampled images.
-   - After a new video, one closing sentence naming the two or three changes they're most likely to want. Don't make them unasked.
-
-Illustrative delivery message, to adapt rather than copy:
-
-> **A 15-second tall video for Instagram, with upbeat music, ending on your logo.** I assumed it's for people who don't know the shop yet, so it leads with the bread rather than the name.
->
-> It's safe for people sensitive to flashing lights, all the text fits on screen with enough contrast to read, and the sound stays clean at its loudest moments. I checked it frame by frame, but I can't watch it the way you will, so play it once on your phone before you share it.
->
-> If you'd like, I can add your address and opening hours, use your real logo, or make a wide version for your website.
-
-If they gave a loudness target, say whether it was met. Report what you designed for but no check measures, such as keeping text clear of Instagram's or TikTok's buttons, as your choice ("I kept the text clear of Instagram's buttons"), never as a check result. If something couldn't be checked: "I couldn't listen to the sound, so play it once on your phone first."
-
-No automatic posters, share copy, extra formats or launch packages.

package/dist/core/ideal-review-subagent.d.ts

@@ -1,56 +0,0 @@
-import type { Message } from "@prestyj/ai";
-import type { IdealReviewStats } from "./ideal-review.js";
-/**
- * Independent pre-final review — the Codex Guardian pattern. The in-thread
- * Ideal review asks the acting model to audit its own work, armed with its own
- * justifications for why it is done; a fresh-context reviewer sees only the
- * request, the changed files and the outcome evidence, so it catches what
- * self-review rationalizes away.
- *
- * The reviewer is spawned as a read-only child agent on the session's ACTIVE
- * model (`model` is forced at spawn time, never a "fast" or review model).
- * Findings are injected as a follow-up the acting agent must address; a CLEAN
- * verdict injects nothing, so a passing review costs one bounded wait and no
- * extra turn. On spawn failure or timeout the in-thread review remains the
- * fallback — the feature degrades, never blocks.
- *
- * The reviewer's time is capped by its OWN worker, not by the harness killing
- * it: on reaching REVIEWER_TURN_TIMEOUT_MS it gets one tool-free turn to give
- * its verdict on what it has examined. Killing it from outside discarded all
- * of that — large reviews ended "Interrupted" with no verdict at all.
- */
-/** Read-only toolset — the reviewer examines, it never repairs. */
-export declare const REVIEWER_TOOLS: readonly ["read", "grep", "find", "ls", "code_search", "source_path"];
-/**
- * How long the reviewer may examine the work before it must give its verdict.
- * Reviews of large changes (a dozen or more files, ~1,000 changed lines) need
- * longer to read everything; a verdict on the most central files beats none.
- */
-export declare const REVIEWER_TURN_TIMEOUT_MS = 120000;
-/**
- * Harness backstop: the reviewer's working time, its recovery turn, and
- * headroom for the result to arrive. Reached only if the child hangs.
- */
-export declare const REVIEWER_WAIT_MS: number;
-/**
- * Ideal review score at which the independent reviewer is worth its latency.
- * Below this the in-thread review alone is proportionate.
- */
-export declare const INDEPENDENT_REVIEW_SCORE_THRESHOLD = 6;
-export interface ReviewerTaskInput {
-    originalRequest: string;
-    changedFiles: readonly string[];
-    stats: IdealReviewStats;
-    triggerReasons: readonly string[];
-}
-export declare function buildReviewerTask(input: ReviewerTaskInput): string;
-export interface ReviewerFindings {
-    clean: boolean;
-    findings: string[];
-}
-/**
- * Parse the reviewer's terminal output. Returns null when the reply carries no
- * usable verdict marker — treated as a failed review, never as a pass.
- */
-export declare function parseReviewerFindings(output: string): ReviewerFindings | null;
-export declare function buildIndependentReviewMessage(findings: readonly string[]): Message;

package/dist/core/ideal-review-subagent.js

@@ -1,112 +0,0 @@
-import { SUB_AGENT_TIMEOUT_RECOVERY_MS } from "../tools/subagent-shared.js";
-/**
- * Independent pre-final review — the Codex Guardian pattern. The in-thread
- * Ideal review asks the acting model to audit its own work, armed with its own
- * justifications for why it is done; a fresh-context reviewer sees only the
- * request, the changed files and the outcome evidence, so it catches what
- * self-review rationalizes away.
- *
- * The reviewer is spawned as a read-only child agent on the session's ACTIVE
- * model (`model` is forced at spawn time, never a "fast" or review model).
- * Findings are injected as a follow-up the acting agent must address; a CLEAN
- * verdict injects nothing, so a passing review costs one bounded wait and no
- * extra turn. On spawn failure or timeout the in-thread review remains the
- * fallback — the feature degrades, never blocks.
- *
- * The reviewer's time is capped by its OWN worker, not by the harness killing
- * it: on reaching REVIEWER_TURN_TIMEOUT_MS it gets one tool-free turn to give
- * its verdict on what it has examined. Killing it from outside discarded all
- * of that — large reviews ended "Interrupted" with no verdict at all.
- */
-/** Read-only toolset — the reviewer examines, it never repairs. */
-export const REVIEWER_TOOLS = ["read", "grep", "find", "ls", "code_search", "source_path"];
-/**
- * How long the reviewer may examine the work before it must give its verdict.
- * Reviews of large changes (a dozen or more files, ~1,000 changed lines) need
- * longer to read everything; a verdict on the most central files beats none.
- */
-export const REVIEWER_TURN_TIMEOUT_MS = 120_000;
-/**
- * Harness backstop: the reviewer's working time, its recovery turn, and
- * headroom for the result to arrive. Reached only if the child hangs.
- */
-export const REVIEWER_WAIT_MS = REVIEWER_TURN_TIMEOUT_MS + SUB_AGENT_TIMEOUT_RECOVERY_MS + 20_000;
-/**
- * Ideal review score at which the independent reviewer is worth its latency.
- * Below this the in-thread review alone is proportionate.
- */
-export const INDEPENDENT_REVIEW_SCORE_THRESHOLD = 6;
-export function buildReviewerTask(input) {
-    const files = input.changedFiles
-        .slice(0, 20)
-        .map((f) => `- ${f}`)
-        .join("\n");
-    const reasons = input.triggerReasons.join(", ");
-    return [
-        "You are an independent code reviewer with fresh context. Another coding agent claims to have " +
-            "completed the task below. Examine its work and report whether the claim holds.",
-        "",
-        `Task given to that agent: ${input.originalRequest.slice(0, 2000)}`,
-        "",
-        "Files it changed:",
-        files,
-        "",
-        `Harness-observed activity: ${input.stats.changedLines} changed lines, ` +
-            `${input.stats.toolCalls} tool calls (${input.stats.toolFailures} failed), ` +
-            `${input.stats.turns} turns. Review triggered because: ${reasons}.`,
-        "",
-        "Read the changed files (and any sibling files needed to judge them). Check the work against " +
-            "the task: correctness, completeness, obvious edge cases, over-editing beyond what the task " +
-            "asked for, leftover TODOs or dead code, and changes that contradict each other.",
-        "Judge the CONTENT of the changed files against the request. Do NOT report the surrounding " +
-            "environment (missing package.json, tooling not installed, unrelated files) unless the request " +
-            "itself demanded those.",
-        "You are READ-ONLY: do not edit, write, or run commands. Judge only what is on disk.",
-        "Your time is limited: examine the files most central to the task first. If time runs out " +
-            "you will be asked for your verdict on what you have examined so far.",
-        "",
-        "BEGIN your reply with EXACTLY this format (elaborate only after it):",
-        "VERDICT: CLEAN",
-        "or",
-        "VERDICT: ISSUES",
-        "FINDINGS:",
-        "- <one line per concrete finding, each naming the file>",
-    ].join("\n");
-}
-/**
- * Parse the reviewer's terminal output. Returns null when the reply carries no
- * usable verdict marker — treated as a failed review, never as a pass.
- */
-export function parseReviewerFindings(output) {
-    const verdict = /VERDICT:\s*(CLEAN|ISSUES)\b/im.exec(output)?.[1]?.toUpperCase();
-    if (!verdict)
-        return null;
-    const findingsBlock = /FINDINGS:\s*\n([\s\S]*)$/i.exec(output)?.[1] ?? "";
-    const findings = findingsBlock
-        .split("\n")
-        .map((line) => line.replace(/^\s*[-*]\s*/, "").trim())
-        .filter((line) => line.length > 0 && line.toUpperCase() !== "NONE")
-        .slice(0, 10);
-    if (verdict === "CLEAN")
-        return { clean: true, findings: [] };
-    if (findings.length === 0)
-        return {
-            clean: false,
-            findings: [
-                "The reviewer flagged issues but did not list them — re-examine the changed files yourself.",
-            ],
-        };
-    return { clean: false, findings };
-}
-export function buildIndependentReviewMessage(findings) {
-    return {
-        role: "user",
-        provenance: { source: "runtime", kind: "review_follow_up", visibility: "hidden" },
-        content: "An independent reviewer (fresh context, no knowledge of your reasoning) examined the changed " +
-            "files against the original request and disagrees that the work is complete:\n" +
-            findings.map((finding) => `- ${finding}`).join("\n") +
-            "\nAddress each finding now — fix what is real, and if a finding is wrong, verify why before " +
-            "dismissing it. Then give your final response.",
-    };
-}
-//# sourceMappingURL=ideal-review-subagent.js.map

package/dist/core/ideal-review-subagent.js.map

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

package/dist/core/ideal-review.d.ts

@@ -1,82 +0,0 @@
-import type { Message } from "@prestyj/ai";
-export interface IdealReviewStats {
-    changedLines: number;
-    toolCalls: number;
-    toolFailures: number;
-    turns: number;
-    writeCalls: number;
-    editCalls: number;
-    bashCalls: number;
-}
-export interface IdealReviewDecision {
-    shouldReview: boolean;
-    score: number;
-    reasons: string[];
-}
-export interface ReviewCoverageEvidence {
-    expected: string[];
-    covered: string[];
-    missing: string[];
-}
-/**
- * Harness-owned proof that every successfully changed file was opened with the
- * read tool after Ideal review began. Model-authored claims never enter it.
- */
-export declare class ReviewCoverageTracker {
-    private readonly cwd;
-    private readonly fileExists;
-    private readonly expected;
-    private readonly covered;
-    private active;
-    /**
-     * `fileExists` is injectable for tests and defaults to the real filesystem.
-     * A file the run created and then deleted can never be re-read, so without
-     * this check it stayed in `missing` forever and the coverage gate re-injected
-     * the same follow-up on every turn.
-     */
-    constructor(cwd: string, fileExists?: (p: string) => boolean);
-    reset(): void;
-    /** Successful mutations are retained before and during review. */
-    recordChanged(filePath: string): void;
-    /** Start the evidence window; reads observed before this call never count. */
-    start(changedFiles?: Iterable<string>): void;
-    /** Called only by the successful read-tool callback. */
-    recordRead(filePath: string): void;
-    evidence(): ReviewCoverageEvidence;
-    private normalize;
-    private display;
-}
-export declare function buildReviewCoverageMessage(missingFiles: readonly string[]): Message;
-/**
- * Coverage follow-ups spent before the gate gives up. The gate is fail-closed,
- * but a file the agent genuinely cannot read (permissions, a path outside the
- * workspace, a race with an external delete) must not cost an unbounded number
- * of identical turns — it escalates once and lets the run finish.
- */
-export declare const MAX_REVIEW_COVERAGE_INJECTIONS = 2;
-/**
- * Terminal coverage message: stop demanding reads, require an honest statement
- * of what went unverified in the final answer.
- */
-export declare function buildReviewCoverageEscalationMessage(missingFiles: readonly string[]): Message;
-/**
- * Put the harness-owned read checklist on the first Ideal review turn. The
- * fail-closed follow-up remains as a fallback, but compliant reviews can now
- * gather all evidence before emitting their single user-facing final answer.
- */
-export declare function withReviewCoverageRequirements(message: Message, missingFiles: readonly string[]): Message;
-export declare const IDEAL_REVIEW_PROMPT: string;
-export declare function evaluateIdealReview(stats: IdealReviewStats): IdealReviewDecision;
-export declare function buildIdealReviewMessage(reasons: readonly string[], driftedFiles?: readonly string[]): Message;
-/**
- * Test-drift detector \u2014 the one stranding signal a typechecker is blind to.
- * Given the set of files the run mutated, return the source files whose sibling
- * test exists on disk but was NOT touched this run (a green-but-stale test).
- *
- * Pure structural check: no sibling test on disk \u2192 no signal, so it stays
- * silent on projects (or files) without co-located tests. `fileExists` is
- * injectable for tests; paths are resolved against `cwd` so relative tool paths
- * and absolute ones compare consistently.
- */
-export declare function detectTestDrift(touchedFiles: Iterable<string>, cwd: string, fileExists?: (p: string) => boolean): string[];
-export declare function shouldCountAsRiskyTool(toolName: string): boolean;