@unimatrix27/ralph-harness 1.0.0

package/dist/lib/gh-runner.js

@@ -0,0 +1,50 @@
+// gh-runner — thin subprocess wrapper around the `gh` CLI.
+//
+// Exists so github-state-mutator (and any future caller) can be unit-tested
+// by mocking exactly one module instead of stubbing a binary on PATH.
+//
+// Contract:
+//   runGh(args)  — spawn `gh <args...>`, return { stdout, stderr, exitCode }.
+//   runGhJson(args) — same, but JSON.parse the stdout (caller still passes
+//                     `--json` to gh; this just parses the result).
+//
+// Both functions throw GhRunnerError on non-zero exit. Callers that need to
+// branch on a non-zero exit (none today) can catch and inspect .exitCode.
+import { spawnSync } from "node:child_process";
+const MODULE_PREFIX = "gh-runner";
+export class GhRunnerError extends Error {
+    exitCode;
+    stderr;
+    constructor(exitCode, stderr, message) {
+        super(message);
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.name = "GhRunnerError";
+    }
+}
+export function runGh(args) {
+    const r = spawnSync("gh", args, { encoding: "utf8" });
+    if (r.error) {
+        throw new GhRunnerError(-1, "", `${MODULE_PREFIX}: failed to spawn gh: ${r.error.message}`);
+    }
+    const result = {
+        stdout: r.stdout ?? "",
+        stderr: r.stderr ?? "",
+        exitCode: r.status ?? -1,
+    };
+    if (result.exitCode !== 0) {
+        throw new GhRunnerError(result.exitCode, result.stderr, `${MODULE_PREFIX}: gh ${args.join(" ")} failed (exit ${result.exitCode}): ${result.stderr.trim()}`);
+    }
+    return result;
+}
+export function runGhJson(args) {
+    const { stdout } = runGh(args);
+    try {
+        return JSON.parse(stdout);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new GhRunnerError(0, "", `${MODULE_PREFIX}: could not parse gh stdout as JSON: ${detail}`);
+    }
+}
+//# sourceMappingURL=gh-runner.js.map

package/dist/lib/gh-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh-runner.js","sourceRoot":"","sources":["../../src/lib/gh-runner.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,4EAA4E;AAC5E,sEAAsE;AACtE,EAAE;AACF,YAAY;AACZ,8EAA8E;AAC9E,2EAA2E;AAC3E,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,aAAa,GAAG,WAAW,CAAC;AAQlC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IACA;IAFlB,YACkB,QAAgB,EAChB,MAAc,EAC9B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QAI9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,KAAK,CAAC,IAAuB;IAC3C,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,aAAa,CACrB,CAAC,CAAC,EACF,EAAE,EACF,GAAG,aAAa,yBAAyB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAa;QACvB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;QACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;KACzB,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,aAAa,CACrB,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,MAAM,EACb,GAAG,aAAa,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CAAc,IAAuB;IAC5D,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAM,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,aAAa,CACrB,CAAC,EACD,EAAE,EACF,GAAG,aAAa,wCAAwC,MAAM,EAAE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/github-state-mutator.d.ts

@@ -0,0 +1,11 @@
+import { GhRunnerError, runGh, type GhResult } from "./gh-runner.js";
+export declare const MODULE_PREFIX = "github-state-mutator";
+export declare function moduleErr(message: string): string;
+export declare function swapLabel(repo: string, num: number, from: string, to: string): void;
+export declare function commentIssue(repo: string, num: number, body: string): void;
+export declare function findOrCreateMilestoneLogIssue(repo: string, milestone: string): number;
+export declare function appendCavemanLog(repo: string, logNum: number, issueNum: number, summary: string, gotcha?: string): void;
+export declare function milestoneLogBody(milestone: string): string;
+export { GhRunnerError, runGh };
+export type { GhResult };
+//# sourceMappingURL=github-state-mutator.d.ts.map

package/dist/lib/github-state-mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-state-mutator.d.ts","sourceRoot":"","sources":["../../src/lib/github-state-mutator.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,aAAa,EACb,KAAK,EACL,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAaD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAuBN;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1E;AAKD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,MAAM,CAqCR;AAID,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAIN;AAID,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ1D;AA0FD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/lib/github-state-mutator.js

@@ -0,0 +1,179 @@
+// github-state-mutator — idempotent wrappers around `gh` for the four state
+// mutations the orchestrator needs:
+//
+//   swapLabel(repo, num, from, to)
+//   commentIssue(repo, num, body)
+//   findOrCreateMilestoneLogIssue(repo, milestone)  — returns issue number
+//   appendCavemanLog(repo, logNum, issueNum, summary, gotcha?)
+//
+// Idempotency contract (must match lib/github-state-mutator.sh — bash module
+// is still sourced by the EC2 orchestrator until slice 5 cuts it over):
+//
+//   - swapLabel: when the issue already has `to` and not `from`, no `gh issue
+//     edit` call is made (verified by the test matrix).
+//   - findOrCreateMilestoneLogIssue: a second call with the same milestone
+//     name returns the existing issue number without invoking `gh issue
+//     create`.
+//   - commentIssue / appendCavemanLog are append-only by design — every call
+//     posts. The milestone-log workflow relies on this (one comment per
+//     iteration). This matches the bash contract; deduping would be a
+//     regression for the consumer.
+//
+// Errors go to stderr via moduleErr() so callers can grep on the prefix.
+//
+// Exit codes are surfaced by the CLI (ralph-gsm), not this module:
+//   0  success
+//   2  usage / missing required argument                   (CLI only)
+//   non-zero  propagated from gh via GhRunnerError         (CLI only)
+import { GhRunnerError, runGh, } from "./gh-runner.js";
+export const MODULE_PREFIX = "github-state-mutator";
+export function moduleErr(message) {
+    return `${MODULE_PREFIX}: error: ${message}`;
+}
+// swapLabel — remove `from` if present, add `to` if missing. No gh-edit call
+// at all when the target state already matches.
+export function swapLabel(repo, num, from, to) {
+    const view = runGh([
+        "issue",
+        "view",
+        String(num),
+        "--repo",
+        repo,
+        "--json",
+        "labels",
+    ]);
+    const parsed = parseLabelsJson(view.stdout, repo, num);
+    const names = new Set(parsed.labels.map((l) => l.name));
+    const hasFrom = names.has(from);
+    const hasTo = names.has(to);
+    if (!hasFrom && hasTo)
+        return;
+    const args = ["issue", "edit", String(num), "--repo", repo];
+    if (hasFrom)
+        args.push("--remove-label", from);
+    if (!hasTo)
+        args.push("--add-label", to);
+    runGh(args);
+}
+// commentIssue — post a comment. Append-only (see contract above).
+export function commentIssue(repo, num, body) {
+    runGh(["issue", "comment", String(num), "--repo", repo, "--body", body]);
+}
+// findOrCreateMilestoneLogIssue — find by exact title `[log] <milestone>`
+// (filtered to the meta:milestone-log label). Create if missing. Echo the
+// issue number.
+export function findOrCreateMilestoneLogIssue(repo, milestone) {
+    const title = `[log] ${milestone}`;
+    const list = runGh([
+        "issue",
+        "list",
+        "--repo",
+        repo,
+        "--label",
+        "meta:milestone-log",
+        "--state",
+        "all",
+        "--json",
+        "number,title",
+        "--limit",
+        "100",
+    ]);
+    const items = parseIssueList(list.stdout, repo);
+    const existing = items.find((i) => i.title === title);
+    if (existing)
+        return existing.number;
+    const body = milestoneLogBody(milestone);
+    const create = runGh([
+        "issue",
+        "create",
+        "--repo",
+        repo,
+        "--title",
+        title,
+        "--label",
+        "meta:milestone-log",
+        "--body",
+        body,
+    ]);
+    return parseIssueNumberFromUrl(create.stdout);
+}
+// appendCavemanLog — post one caveman-format comment on the milestone-log
+// issue. Empty/missing gotcha renders as `-`.
+export function appendCavemanLog(repo, logNum, issueNum, summary, gotcha) {
+    const g = gotcha && gotcha.length > 0 ? gotcha : "-";
+    const line = `#${issueNum} | ${summary} | ${g}`;
+    commentIssue(repo, logNum, line);
+}
+// ---- internals ----
+export function milestoneLogBody(milestone) {
+    return `This issue is the cross-iteration learnings log for milestone '${milestone}'.
+
+Each ralph-harness implementation iteration appends one comment in caveman format:
+
+    #<issue> | <one-line summary> | <gotcha or '-'>
+
+Do not close manually — the harness reads recent comments here for prior-iteration context.`;
+}
+function parseLabelsJson(stdout, repo, num) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(moduleErr(`swap_label: could not parse labels for ${repo}#${num}: ${detail}`));
+    }
+    if (!parsed ||
+        typeof parsed !== "object" ||
+        !Array.isArray(parsed.labels)) {
+        throw new Error(moduleErr(`swap_label: unexpected labels payload for ${repo}#${num}`));
+    }
+    const rawLabels = parsed.labels;
+    const labels = [];
+    for (const l of rawLabels) {
+        if (l && typeof l === "object" && typeof l.name === "string") {
+            labels.push({ name: l.name });
+        }
+    }
+    return { labels };
+}
+function parseIssueList(stdout, repo) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(moduleErr(`find_or_create_milestone_log_issue: could not parse issue list for ${repo}: ${detail}`));
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(moduleErr(`find_or_create_milestone_log_issue: expected array from gh issue list, got ${typeof parsed}`));
+    }
+    const out = [];
+    for (const i of parsed) {
+        if (i &&
+            typeof i === "object" &&
+            typeof i.number === "number" &&
+            typeof i.title === "string") {
+            out.push({
+                number: i.number,
+                title: i.title,
+            });
+        }
+    }
+    return out;
+}
+function parseIssueNumberFromUrl(stdout) {
+    // `gh issue create` prints the new issue URL on stdout — last path segment
+    // is the issue number.
+    const trimmed = stdout.trim();
+    const tail = trimmed.split("/").pop() ?? "";
+    const n = Number.parseInt(tail, 10);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(moduleErr(`find_or_create_milestone_log_issue: could not parse issue number from gh stdout: ${trimmed}`));
+    }
+    return n;
+}
+// Re-export so the CLI can use a single import surface.
+export { GhRunnerError, runGh };
+//# sourceMappingURL=github-state-mutator.js.map

package/dist/lib/github-state-mutator.js.map

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

package/dist/lib/phase-result-schemas.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+export declare const MODULE_PREFIX = "phase-result-schemas";
+export declare class SchemaError extends Error {
+    readonly path?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, path?: string | undefined, cause?: unknown | undefined);
+}
+export declare const DecisionPickedSchema: z.ZodObject<{
+    status: z.ZodLiteral<"PICKED">;
+    issue: z.ZodNumber;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const DecisionNoneSchema: z.ZodObject<{
+    status: z.ZodLiteral<"NONE">;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const DecisionAllBlockedSchema: z.ZodObject<{
+    status: z.ZodLiteral<"ALL_BLOCKED">;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const DecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"PICKED">;
+    issue: z.ZodNumber;
+    reasoning: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"NONE">;
+    reasoning: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"ALL_BLOCKED">;
+    reasoning: z.ZodString;
+}, z.core.$strip>], "status">;
+export type Decision = z.infer<typeof DecisionSchema>;
+export declare const ImplPrOpenedSchema: z.ZodObject<{
+    status: z.ZodLiteral<"PR_OPENED">;
+    issue: z.ZodNumber;
+    pr_number: z.ZodNumber;
+    pr_url: z.ZodString;
+    branch: z.ZodString;
+}, z.core.$strip>;
+export declare const ImplAgentStuckSchema: z.ZodObject<{
+    status: z.ZodLiteral<"AGENT_STUCK">;
+    issue: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const ImplResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"PR_OPENED">;
+    issue: z.ZodNumber;
+    pr_number: z.ZodNumber;
+    pr_url: z.ZodString;
+    branch: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"AGENT_STUCK">;
+    issue: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>], "status">;
+export type ImplResult = z.infer<typeof ImplResultSchema>;
+export declare const ReviewNoReviewSchema: z.ZodObject<{
+    status: z.ZodLiteral<"NO_REVIEW">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReviewRevisionAppliedSchema: z.ZodObject<{
+    status: z.ZodLiteral<"REVISION_APPLIED">;
+    summary: z.ZodString;
+    gotcha: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReviewResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"NO_REVIEW">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"REVISION_APPLIED">;
+    summary: z.ZodString;
+    gotcha: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "status">;
+export type ReviewResult = z.infer<typeof ReviewResultSchema>;
+export declare const MilestoneLogSchema: z.ZodUnion<readonly [z.ZodObject<{
+    milestone: z.ZodString;
+    log_issue: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$strict>]>;
+export type MilestoneLog = z.infer<typeof MilestoneLogSchema>;
+export declare function parseDecision(raw: string): Decision;
+export declare function parseImplResult(raw: string): ImplResult;
+export declare function parseReviewResult(raw: string): ReviewResult;
+export declare function parseMilestoneLog(raw: string): MilestoneLog;
+export declare function readDecision(path: string): Decision;
+export declare function readImplResult(path: string): ImplResult;
+export declare function readReviewResult(path: string): ReviewResult;
+export declare function readMilestoneLog(path: string): MilestoneLog;
+//# sourceMappingURL=phase-result-schemas.d.ts.map

package/dist/lib/phase-result-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-result-schemas.d.ts","sourceRoot":"","sources":["../../src/lib/phase-result-schemas.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,CAAC,EAAE,MAAM;aACb,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAID,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;6BAIzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;6BAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;6BAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAmB9D,eAAO,MAAM,kBAAkB;;;oDAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAwC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE3D;AAiCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE3D"}

package/dist/lib/phase-result-schemas.js

@@ -0,0 +1,180 @@
+// phase-result-schemas — Zod schemas + parser helpers for the four contract
+// JSON files the harness writes during a single iteration:
+//
+//   /tmp/ralph/decision.json         (discovery output)
+//   /tmp/ralph/issue.json            (full gh payload of the picked issue)
+//   /tmp/ralph/milestone-log.json    (cross-iteration log pointer)
+//   /tmp/ralph/impl-result.json      (implementation output)
+//   /tmp/ralph/review-result.json    (review output)
+//   /tmp/ralph/crafted-prompt.md     (the impl call's input — text, not JSON)
+//
+// The orchestrator branches on the discriminated `status` field of each
+// JSON output. Validation here exists so an off-by-one in claude's output
+// surfaces as a typed error in the orchestrator (exit 3, missing/invalid
+// contract file) rather than an opaque later crash.
+//
+// Public surface:
+//   DecisionSchema       (PICKED | NONE | ALL_BLOCKED)
+//   ImplResultSchema     (PR_OPENED | AGENT_STUCK)
+//   ReviewResultSchema   (NO_REVIEW | REVISION_APPLIED)
+//   MilestoneLogSchema   ({} | {milestone, log_issue})
+//   parseDecision / parseImplResult / parseReviewResult / parseMilestoneLog
+//   readDecision / readImplResult / readReviewResult / readMilestoneLog
+//
+// Parsers throw `SchemaError` on a parse failure with a human-readable
+// summary; readers add the file path to the message so a CloudWatch grep
+// shows which contract file misbehaved.
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+export const MODULE_PREFIX = "phase-result-schemas";
+export class SchemaError extends Error {
+    path;
+    cause;
+    constructor(message, path, cause) {
+        super(message);
+        this.path = path;
+        this.cause = cause;
+        this.name = "SchemaError";
+    }
+}
+// ---- Decision -------------------------------------------------------
+export const DecisionPickedSchema = z.object({
+    status: z.literal("PICKED"),
+    issue: z.number().int().positive(),
+    reasoning: z.string(),
+});
+export const DecisionNoneSchema = z.object({
+    status: z.literal("NONE"),
+    reasoning: z.string(),
+});
+export const DecisionAllBlockedSchema = z.object({
+    status: z.literal("ALL_BLOCKED"),
+    reasoning: z.string(),
+});
+export const DecisionSchema = z.discriminatedUnion("status", [
+    DecisionPickedSchema,
+    DecisionNoneSchema,
+    DecisionAllBlockedSchema,
+]);
+// ---- Implementation result -----------------------------------------
+export const ImplPrOpenedSchema = z.object({
+    status: z.literal("PR_OPENED"),
+    issue: z.number().int().positive(),
+    pr_number: z.number().int().positive(),
+    pr_url: z.string().url(),
+    branch: z.string().min(1),
+});
+export const ImplAgentStuckSchema = z.object({
+    status: z.literal("AGENT_STUCK"),
+    issue: z.number().int().positive(),
+    reason: z.string(),
+});
+export const ImplResultSchema = z.discriminatedUnion("status", [
+    ImplPrOpenedSchema,
+    ImplAgentStuckSchema,
+]);
+// ---- Review result -------------------------------------------------
+export const ReviewNoReviewSchema = z.object({
+    status: z.literal("NO_REVIEW"),
+    reason: z.string().optional(),
+});
+export const ReviewRevisionAppliedSchema = z.object({
+    status: z.literal("REVISION_APPLIED"),
+    summary: z.string(),
+    gotcha: z.string().optional(),
+});
+export const ReviewResultSchema = z.discriminatedUnion("status", [
+    ReviewNoReviewSchema,
+    ReviewRevisionAppliedSchema,
+]);
+// ---- Milestone log -------------------------------------------------
+//
+// Two valid shapes:
+//   {}                                 — discovery returned NONE/ALL_BLOCKED
+//                                        OR the picked issue had no milestone
+//   {milestone: string, log_issue: int|null}
+//
+// `log_issue` may be `null` when discovery picked an issue without a
+// milestone (the bash port emitted that explicitly).
+const MilestoneLogPresentSchema = z.object({
+    milestone: z.string(),
+    log_issue: z.number().int().positive().nullable(),
+});
+const MilestoneLogEmptySchema = z.object({}).strict();
+export const MilestoneLogSchema = z.union([
+    MilestoneLogPresentSchema,
+    MilestoneLogEmptySchema,
+]);
+// ---- parser helpers -----------------------------------------------
+function parseWith(schema, raw, what) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new SchemaError(`${MODULE_PREFIX}: ${what} is not valid JSON: ${detail}`, undefined, err);
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw new SchemaError(`${MODULE_PREFIX}: ${what} failed schema validation: ${formatZodError(result.error)}`, undefined, result.error);
+    }
+    return result.data;
+}
+function formatZodError(err) {
+    return err.issues
+        .map((i) => {
+        const path = i.path.length === 0 ? "<root>" : i.path.join(".");
+        return `${path}: ${i.message}`;
+    })
+        .join("; ");
+}
+export function parseDecision(raw) {
+    return parseWith(DecisionSchema, raw, "decision.json");
+}
+export function parseImplResult(raw) {
+    return parseWith(ImplResultSchema, raw, "impl-result.json");
+}
+export function parseReviewResult(raw) {
+    return parseWith(ReviewResultSchema, raw, "review-result.json");
+}
+export function parseMilestoneLog(raw) {
+    return parseWith(MilestoneLogSchema, raw, "milestone-log.json");
+}
+// ---- readers --------------------------------------------------------
+//
+// readers wrap parsers with a file-read step. They re-throw SchemaError
+// with the path attached so a CloudWatch grep tells the operator which
+// contract file misbehaved.
+function readContractFile(path, parse) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new SchemaError(`${MODULE_PREFIX}: could not read ${path}: ${detail}`, path, err);
+    }
+    try {
+        return parse(raw);
+    }
+    catch (err) {
+        if (err instanceof SchemaError) {
+            throw new SchemaError(`${err.message} (path: ${path})`, path, err.cause);
+        }
+        throw err;
+    }
+}
+export function readDecision(path) {
+    return readContractFile(path, parseDecision);
+}
+export function readImplResult(path) {
+    return readContractFile(path, parseImplResult);
+}
+export function readReviewResult(path) {
+    return readContractFile(path, parseReviewResult);
+}
+export function readMilestoneLog(path) {
+    return readContractFile(path, parseMilestoneLog);
+}
+//# sourceMappingURL=phase-result-schemas.js.map

package/dist/lib/phase-result-schemas.js.map

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

package/dist/lib/post-hoc-agent-stuck-checker.d.ts

@@ -0,0 +1,26 @@
+import type { AwsClients } from "./aws-clients.js";
+import type { Sink } from "./structured-log-emitter.js";
+export declare const MODULE_PREFIX = "post-hoc-agent-stuck-checker";
+export type CheckResult = {
+    kind: "ClearTermination";
+    prNumber?: number;
+} | {
+    kind: "NoPickedIssueRecoverable";
+} | {
+    kind: "AgentStuckLabelApplied";
+    issue: number;
+};
+export interface CheckOptions {
+    clients: AwsClients;
+    targetRepo: string;
+    launchTag: string;
+    instanceId: string;
+    logGroup: string;
+    agentStuckLabel: string;
+    info?: Sink;
+}
+export declare function findPrWithLaunchTag(repo: string, launchTag: string): Promise<number | null>;
+export declare function fetchPickedIssue(clients: AwsClients, logGroup: string, instanceId: string): Promise<number | null>;
+export declare function applyAgentStuckLabel(repo: string, issue: number, label: string, info: Sink): boolean;
+export declare function postHocCheck(opts: CheckOptions): Promise<CheckResult>;
+//# sourceMappingURL=post-hoc-agent-stuck-checker.d.ts.map

package/dist/lib/post-hoc-agent-stuck-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-hoc-agent-stuck-checker.d.ts","sourceRoot":"","sources":["../../src/lib/post-hoc-agent-stuck-checker.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAExD,eAAO,MAAM,aAAa,iCAAiC,CAAC;AAE5D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAYD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxB;AAKD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB;AAMD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,GACT,OAAO,CAqBT;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAgCtB"}