@kody-ade/kody-engine 0.4.64 → 0.4.66

package/dist/bin/kody.js

@@ -312,10 +312,559 @@ var init_verifyMcp = __esm({
   }
 });
 
+// src/issue.ts
+import { execFileSync as execFileSync3 } from "child_process";
+function ghToken() {
+  return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
+}
+function gh(args, options) {
+  const token = ghToken();
+  const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
+  return execFileSync3("gh", args, {
+    encoding: "utf-8",
+    timeout: API_TIMEOUT_MS,
+    cwd: options?.cwd,
+    env,
+    input: options?.input,
+    stdio: options?.input ? ["pipe", "pipe", "pipe"] : ["inherit", "pipe", "pipe"]
+  }).trim();
+}
+function getIssue(issueNumber, cwd) {
+  const output = gh(["issue", "view", String(issueNumber), "--json", "number,title,body,comments,labels"], { cwd });
+  const parsed = JSON.parse(output);
+  if (typeof parsed?.title !== "string") {
+    throw new Error(`Issue #${issueNumber}: unexpected response shape`);
+  }
+  return {
+    number: parsed.number ?? issueNumber,
+    title: parsed.title,
+    body: parsed.body ?? "",
+    comments: (parsed.comments ?? []).map((c) => ({
+      body: c.body ?? "",
+      author: c.author?.login ?? "unknown",
+      createdAt: c.createdAt ?? ""
+    })),
+    labels: Array.isArray(parsed.labels) ? parsed.labels.map((l) => l.name ?? "").filter((n) => n.length > 0) : []
+  };
+}
+function stripKodyMentions(body) {
+  return body.replace(/(@)(kody)/gi, "$1\u200B$2");
+}
+function postIssueComment(issueNumber, body, cwd) {
+  try {
+    gh(["issue", "comment", String(issueNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
+  } catch (err) {
+    process.stderr.write(
+      `[kody] failed to post comment on #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+function truncate2(s, maxBytes) {
+  if (s.length <= maxBytes) return s;
+  return `${s.slice(0, maxBytes)}\u2026 (+${s.length - maxBytes} chars)`;
+}
+function parsePrNumber(url) {
+  const m = url.match(/\/pull\/(\d+)(?:[/?#]|$)/);
+  if (!m) return null;
+  const n = parseInt(m[1], 10);
+  return Number.isFinite(n) ? n : null;
+}
+function getPr(prNumber, cwd) {
+  const output = gh(["pr", "view", String(prNumber), "--json", "number,title,body,headRefName,baseRefName,state"], {
+    cwd
+  });
+  const parsed = JSON.parse(output);
+  if (typeof parsed?.title !== "string") {
+    throw new Error(`PR #${prNumber}: unexpected response shape`);
+  }
+  return {
+    number: parsed.number ?? prNumber,
+    title: parsed.title,
+    body: parsed.body ?? "",
+    headRefName: String(parsed.headRefName ?? ""),
+    baseRefName: String(parsed.baseRefName ?? ""),
+    state: String(parsed.state ?? "")
+  };
+}
+function getPrDiff(prNumber, cwd) {
+  try {
+    return gh(["pr", "diff", String(prNumber)], { cwd });
+  } catch (err) {
+    process.stderr.write(
+      `[kody] failed to fetch diff for PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return "";
+  }
+}
+function getPrReviews(prNumber, cwd) {
+  try {
+    const output = gh(["pr", "view", String(prNumber), "--json", "reviews"], { cwd });
+    const parsed = JSON.parse(output);
+    if (!Array.isArray(parsed?.reviews)) return [];
+    return parsed.reviews.map(
+      (r) => ({
+        body: r.body ?? "",
+        state: r.state ?? "",
+        author: r.author?.login ?? "unknown",
+        submittedAt: r.submittedAt ?? ""
+      })
+    );
+  } catch {
+    return [];
+  }
+}
+function getPrComments(prNumber, cwd) {
+  try {
+    const output = gh(["pr", "view", String(prNumber), "--json", "comments"], { cwd });
+    const parsed = JSON.parse(output);
+    if (!Array.isArray(parsed?.comments)) return [];
+    return parsed.comments.map((c) => ({
+      body: c.body ?? "",
+      author: c.author?.login ?? "unknown",
+      createdAt: c.createdAt ?? ""
+    })).filter((c) => c.body.trim().length > 0);
+  } catch {
+    return [];
+  }
+}
+function isReviewShaped(body) {
+  return VERDICT_HEADING.test(body);
+}
+function getPrLatestReviewBody(prNumber, cwd) {
+  const reviews = getPrReviews(prNumber, cwd).filter((r) => r.body.trim().length > 0).map((r) => ({ body: r.body, at: r.submittedAt }));
+  const comments = getPrComments(prNumber, cwd).filter((c) => isReviewShaped(c.body)).map((c) => ({ body: c.body, at: c.createdAt }));
+  const all = [...reviews, ...comments].sort((a, b) => (b.at || "").localeCompare(a.at || ""));
+  if (all.length > 0) return all[0].body;
+  const pr = getPr(prNumber, cwd);
+  return pr.body;
+}
+function postPrReviewComment(prNumber, body, cwd) {
+  try {
+    gh(["pr", "comment", String(prNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
+  } catch (err) {
+    process.stderr.write(
+      `[kody] failed to post review comment on PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+var API_TIMEOUT_MS, VERDICT_HEADING;
+var init_issue = __esm({
+  "src/issue.ts"() {
+    "use strict";
+    API_TIMEOUT_MS = 3e4;
+    VERDICT_HEADING = /(^|\n)\s*#{1,6}\s*Verdict\s*:/i;
+  }
+});
+
+// src/prompt.ts
+import * as fs13 from "fs";
+import * as path12 from "path";
+function loadProjectConventions(projectDir) {
+  const out = [];
+  for (const rel of CONVENTION_FILES) {
+    const abs = path12.join(projectDir, rel);
+    if (!fs13.existsSync(abs)) continue;
+    let content;
+    try {
+      content = fs13.readFileSync(abs, "utf-8");
+    } catch {
+      continue;
+    }
+    const truncated = content.length > CONVENTIONS_PER_FILE_MAX_BYTES;
+    if (truncated) content = `${content.slice(0, CONVENTIONS_PER_FILE_MAX_BYTES)}
+
+\u2026 (truncated)`;
+    out.push({ path: rel, content, truncated });
+  }
+  return out;
+}
+function parseAgentResult(finalText) {
+  const text = (finalText || "").trim();
+  if (!text)
+    return {
+      done: false,
+      commitMessage: "",
+      prSummary: "",
+      feedbackActions: "",
+      planDeviations: "",
+      priorArt: "",
+      failureReason: "agent produced no final message",
+      markerMissing: false
+    };
+  const MARKDOWN_PREFIX = "[\\s>*_#`~\\-]*";
+  const FAILED_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}FAILED${MARKDOWN_PREFIX}\\s*:\\s*(.+?)\\s*$`, "is");
+  const DONE_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}DONE\\b`, "i");
+  const failedMatch = text.match(FAILED_RE);
+  if (failedMatch) {
+    return {
+      done: false,
+      commitMessage: "",
+      prSummary: "",
+      feedbackActions: "",
+      planDeviations: "",
+      priorArt: "",
+      failureReason: stripMarkdownEmphasis(failedMatch[1]),
+      markerMissing: false
+    };
+  }
+  const hasDoneMarker = DONE_RE.test(text);
+  const hasCommitMsg = /^[\s>*_#`~-]*COMMIT_MSG\s*:/im.test(text);
+  const hasPrSummary = /^[\s>*_#`~-]*PR_SUMMARY\s*:/im.test(text);
+  const markerMissing = !hasDoneMarker && !hasCommitMsg && !hasPrSummary;
+  const commitMatch = text.match(/^[\s>*_#`~-]*COMMIT_MSG[\s>*_#`~-]*\s*:\s*(.+)$/im);
+  const commitMessage = commitMatch ? stripMarkdownEmphasis(commitMatch[1]) : "";
+  const feedbackActions = extractBlock(
+    text,
+    /(?:^|\n)[ \t]*FEEDBACK_ACTIONS\s*:[ \t]*\n/i,
+    /(?:^|\n)[ \t]*(?:PLAN_DEVIATIONS|COMMIT_MSG|PR_SUMMARY|PRIOR_ART)\s*:/i
+  );
+  let planDeviations = extractBlock(
+    text,
+    /(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*\n/i,
+    /(?:^|\n)[ \t]*(?:COMMIT_MSG|PR_SUMMARY|FEEDBACK_ACTIONS|PRIOR_ART)\s*:/i
+  );
+  if (!planDeviations) {
+    const inline = text.match(/(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
+    if (inline) planDeviations = inline[1].trim();
+  }
+  let priorArt = "";
+  const priorArtInline = text.match(/(?:^|\n)[ \t]*PRIOR_ART\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
+  if (priorArtInline) priorArt = priorArtInline[1].trim();
+  const summaryStart = text.search(/(^|\n)[ \t]*PR_SUMMARY\s*:[ \t]*\n/i);
+  let prSummary = "";
+  if (summaryStart !== -1) {
+    const afterMarker = text.slice(summaryStart).replace(/^[\s\S]*?PR_SUMMARY\s*:[ \t]*\n/i, "");
+    prSummary = afterMarker.replace(/\n\s*```\s*$/g, "").replace(/```\s*$/g, "").trim();
+  }
+  return {
+    done: true,
+    commitMessage,
+    prSummary,
+    feedbackActions,
+    planDeviations,
+    priorArt,
+    failureReason: "",
+    markerMissing
+  };
+}
+function stripMarkdownEmphasis(s) {
+  return s.trim().replace(/^[*_`~]+|[*_`~]+$/g, "").trim();
+}
+function extractBlock(text, startMarker, endMarker) {
+  const startIdx = text.search(startMarker);
+  if (startIdx === -1) return "";
+  const afterStart = text.slice(startIdx).replace(startMarker, "");
+  const endIdx = afterStart.search(endMarker);
+  const body = endIdx === -1 ? afterStart : afterStart.slice(0, endIdx);
+  return body.replace(/\n\s*```\s*$/g, "").trim();
+}
+var CONVENTIONS_PER_FILE_MAX_BYTES, CONVENTION_FILES;
+var init_prompt = __esm({
+  "src/prompt.ts"() {
+    "use strict";
+    CONVENTIONS_PER_FILE_MAX_BYTES = 3e4;
+    CONVENTION_FILES = ["CLAUDE.md", "AGENTS.md"];
+  }
+});
+
+// src/scripts/loadConventions.ts
+var loadConventions_exports = {};
+__export(loadConventions_exports, {
+  loadConventions: () => loadConventions
+});
+var loadConventions;
+var init_loadConventions = __esm({
+  "src/scripts/loadConventions.ts"() {
+    "use strict";
+    init_prompt();
+    loadConventions = async (ctx) => {
+      if (Array.isArray(ctx.data.conventions)) return;
+      const conventions = loadProjectConventions(ctx.cwd);
+      ctx.data.conventions = conventions;
+      if (conventions.length > 0) {
+        process.stderr.write(`[kody] loaded conventions: ${conventions.map((c) => c.path).join(", ")}
+`);
+      }
+    };
+  }
+});
+
+// src/scripts/loadCoverageRules.ts
+var loadCoverageRules_exports = {};
+__export(loadCoverageRules_exports, {
+  loadCoverageRules: () => loadCoverageRules
+});
+var loadCoverageRules;
+var init_loadCoverageRules = __esm({
+  "src/scripts/loadCoverageRules.ts"() {
+    "use strict";
+    loadCoverageRules = async (ctx) => {
+      if (Array.isArray(ctx.data.coverageRules)) return;
+      ctx.data.coverageRules = ctx.config.testRequirements ?? [];
+    };
+  }
+});
+
+// src/scripts/loadMemoryContext.ts
+var loadMemoryContext_exports = {};
+__export(loadMemoryContext_exports, {
+  loadMemoryContext: () => loadMemoryContext
+});
+import * as fs27 from "fs";
+import * as path26 from "path";
+function collectPages(memoryAbs) {
+  const out = [];
+  walkMd(memoryAbs, (file) => {
+    let stat;
+    try {
+      stat = fs27.statSync(file);
+    } catch {
+      return;
+    }
+    let raw;
+    try {
+      raw = fs27.readFileSync(file, "utf-8");
+    } catch {
+      return;
+    }
+    const fm = raw.match(/^---\s*\n([\s\S]*?)\n---/);
+    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path26.basename(file, ".md");
+    const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
+    out.push({
+      relPath: path26.relative(memoryAbs, file),
+      title,
+      updated,
+      content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
+      mtime: stat.mtimeMs
+    });
+  });
+  return out;
+}
+function extractQueryTerms(ctx) {
+  const terms = [];
+  const issue = ctx.data.issue;
+  const pr = ctx.data.pr;
+  if (issue?.title) terms.push(...tokenize(issue.title));
+  if (pr?.title) terms.push(...tokenize(pr.title));
+  return Array.from(new Set(terms)).slice(0, 20);
+}
+function tokenize(s) {
+  return s.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((t) => t.length >= 3);
+}
+function scorePages(pages, terms) {
+  return pages.map((p) => {
+    const haystack = `${p.title} ${p.content}`.toLowerCase();
+    let score = 0;
+    for (const t of terms) {
+      if (haystack.includes(t)) score++;
+    }
+    return { p, score };
+  }).sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    return b.p.mtime - a.p.mtime;
+  }).map((x) => x.p);
+}
+function sortByRecency(pages) {
+  return [...pages].sort((a, b) => {
+    if (a.updated && b.updated && a.updated !== b.updated) {
+      return b.updated.localeCompare(a.updated);
+    }
+    return b.mtime - a.mtime;
+  });
+}
+function formatBlock(pages) {
+  if (pages.length === 0) return "";
+  const lines = [
+    "# Project memory (`.kody/memory/`)",
+    "",
+    "Pages from prior memorize ticks. Treat as advisory context \u2014 confirm against the codebase before acting.",
+    ""
+  ];
+  let total = 0;
+  for (const p of pages) {
+    const block = [`## ${p.title} \u2014 \`${p.relPath}\``, "", p.content].join("\n");
+    if (total + block.length > TOTAL_MAX_BYTES) {
+      lines.push("_\u2026 (further pages truncated to fit budget)_");
+      break;
+    }
+    lines.push(block);
+    lines.push("");
+    total += block.length;
+  }
+  return lines.join("\n");
+}
+function walkMd(root, visit) {
+  const stack = [root];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    let names;
+    try {
+      names = fs27.readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const name of names) {
+      if (name.startsWith(".")) continue;
+      const full = path26.join(dir, name);
+      let stat;
+      try {
+        stat = fs27.statSync(full);
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        stack.push(full);
+        continue;
+      }
+      if (stat.isFile() && full.endsWith(".md")) visit(full);
+    }
+  }
+}
+var MEMORY_DIR_RELATIVE, MAX_PAGES, PER_PAGE_MAX_BYTES, TOTAL_MAX_BYTES, TRUNCATED_SUFFIX, loadMemoryContext;
+var init_loadMemoryContext = __esm({
+  "src/scripts/loadMemoryContext.ts"() {
+    "use strict";
+    MEMORY_DIR_RELATIVE = ".kody/memory";
+    MAX_PAGES = 8;
+    PER_PAGE_MAX_BYTES = 4e3;
+    TOTAL_MAX_BYTES = 24e3;
+    TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
+    loadMemoryContext = async (ctx) => {
+      if (typeof ctx.data.memoryContext === "string") return;
+      const memoryAbs = path26.join(ctx.cwd, MEMORY_DIR_RELATIVE);
+      if (!fs27.existsSync(memoryAbs)) {
+        ctx.data.memoryContext = "";
+        return;
+      }
+      let pages = [];
+      try {
+        pages = collectPages(memoryAbs);
+      } catch {
+        ctx.data.memoryContext = "";
+        return;
+      }
+      if (pages.length === 0) {
+        ctx.data.memoryContext = "";
+        return;
+      }
+      const queryTerms = extractQueryTerms(ctx);
+      const ranked = queryTerms.length > 0 ? scorePages(pages, queryTerms) : sortByRecency(pages);
+      const top = ranked.slice(0, MAX_PAGES);
+      ctx.data.memoryContext = formatBlock(top);
+    };
+  }
+});
+
+// src/scripts/loadPriorArt.ts
+var loadPriorArt_exports = {};
+__export(loadPriorArt_exports, {
+  loadPriorArt: () => loadPriorArt
+});
+function parsePrNumbers(raw) {
+  if (!raw) return [];
+  const trimmed = raw.trim();
+  if (!trimmed) return [];
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter((n) => typeof n === "number" && Number.isInteger(n) && n > 0);
+  } catch {
+    return [];
+  }
+}
+function fetchPrBlock(prNumber, cwd) {
+  try {
+    const metaRaw = gh(["pr", "view", String(prNumber), "--json", "title,state,url,mergedAt,closedAt"], { cwd });
+    const meta = JSON.parse(metaRaw);
+    const diff = truncate3(safeGh(["pr", "diff", String(prNumber)], cwd), PER_PR_DIFF_MAX_BYTES);
+    const commentsRaw = safeGh(["pr", "view", String(prNumber), "--json", "comments,reviews"], cwd);
+    const commentsBlock = formatReviewComments(commentsRaw);
+    const lines = [
+      `## Prior art: PR #${prNumber} \u2014 ${meta.title ?? "(no title)"} [${meta.state ?? "unknown"}]`,
+      meta.url ? meta.url : "",
+      "",
+      "### Diff",
+      "```diff",
+      diff || "(empty)",
+      "```"
+    ];
+    if (commentsBlock) {
+      lines.push("");
+      lines.push("### Review comments");
+      lines.push(commentsBlock);
+    }
+    return lines.filter((l) => l !== "").join("\n");
+  } catch (err) {
+    return `## Prior art: PR #${prNumber}
+_Could not fetch \u2014 ${err instanceof Error ? err.message : String(err)}_`;
+  }
+}
+function safeGh(args, cwd) {
+  try {
+    return gh(args, { cwd });
+  } catch {
+    return "";
+  }
+}
+function truncate3(s, max) {
+  return s.length <= max ? s : s.slice(0, max) + TRUNCATED_SUFFIX2;
+}
+function formatReviewComments(raw) {
+  if (!raw) return "";
+  try {
+    const parsed = JSON.parse(raw);
+    const out = [];
+    for (const c of parsed.comments ?? []) {
+      if (!c.body) continue;
+      out.push(`- **${c.author?.login ?? "unknown"}**: ${c.body.replace(/\n/g, " ").slice(0, 500)}`);
+    }
+    for (const r of parsed.reviews ?? []) {
+      if (!r.body && !r.state) continue;
+      const state = r.state ? ` (${r.state})` : "";
+      const body = r.body ? `: ${r.body.replace(/\n/g, " ").slice(0, 500)}` : "";
+      out.push(`- **${r.author?.login ?? "unknown"}**${state}${body}`);
+    }
+    return out.join("\n");
+  } catch {
+    return "";
+  }
+}
+var PER_PR_DIFF_MAX_BYTES, TOTAL_MAX_BYTES2, TRUNCATED_SUFFIX2, loadPriorArt;
+var init_loadPriorArt = __esm({
+  "src/scripts/loadPriorArt.ts"() {
+    "use strict";
+    init_issue();
+    PER_PR_DIFF_MAX_BYTES = 8e3;
+    TOTAL_MAX_BYTES2 = 3e4;
+    TRUNCATED_SUFFIX2 = "\n\n\u2026 (truncated)";
+    loadPriorArt = async (ctx, _profile, args) => {
+      if (typeof ctx.data.priorArt === "string") return;
+      const artifactName = typeof args?.artifactName === "string" ? args.artifactName : "priorArt";
+      const state = ctx.data.taskState;
+      const artifact = state?.artifacts?.[artifactName];
+      const prNumbers = parsePrNumbers(artifact?.content);
+      if (prNumbers.length === 0) {
+        ctx.data.priorArt = "";
+        return;
+      }
+      const blocks = [];
+      for (const n of prNumbers) {
+        const block = fetchPrBlock(n, ctx.cwd);
+        if (block) blocks.push(block);
+      }
+      const joined = blocks.join("\n\n---\n\n");
+      ctx.data.priorArt = joined.length > TOTAL_MAX_BYTES2 ? joined.slice(0, TOTAL_MAX_BYTES2) + TRUNCATED_SUFFIX2 : joined;
+    };
+  }
+});
+
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.64",
+  version: "0.4.66",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1754,177 +2303,177 @@ function parseCommentArgs(rest, inputs) {
     const boolHit = inputs.find((s) => s.type === "bool" && s.flag === `--${t}` && args[s.name] === void 0);
     if (boolHit) {
       args[boolHit.name] = true;
-      continue;
-    }
-    unmatched.push(t);
-  }
-  return { args, leftover: unmatched.join(" ") };
-}
-function findInputByFlag(inputs, key) {
-  return inputs.find((s) => s.name === key || s.flag === `--${key}`);
-}
-function coerceBare(spec, value) {
-  if (spec.type === "int") {
-    const n = parseInt(value, 10);
-    return Number.isNaN(n) ? value : n;
-  }
-  if (spec.type === "bool") {
-    const v = value.toLowerCase();
-    return v === "true" || v === "1" || v === "yes";
-  }
-  return value;
-}
-
-// src/issue.ts
-import { execFileSync as execFileSync3 } from "child_process";
-var API_TIMEOUT_MS = 3e4;
-function ghToken() {
-  return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
-}
-function gh(args, options) {
-  const token = ghToken();
-  const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync3("gh", args, {
-    encoding: "utf-8",
-    timeout: API_TIMEOUT_MS,
-    cwd: options?.cwd,
-    env,
-    input: options?.input,
-    stdio: options?.input ? ["pipe", "pipe", "pipe"] : ["inherit", "pipe", "pipe"]
-  }).trim();
-}
-function getIssue(issueNumber, cwd) {
-  const output = gh(["issue", "view", String(issueNumber), "--json", "number,title,body,comments,labels"], { cwd });
-  const parsed = JSON.parse(output);
-  if (typeof parsed?.title !== "string") {
-    throw new Error(`Issue #${issueNumber}: unexpected response shape`);
-  }
-  return {
-    number: parsed.number ?? issueNumber,
-    title: parsed.title,
-    body: parsed.body ?? "",
-    comments: (parsed.comments ?? []).map((c) => ({
-      body: c.body ?? "",
-      author: c.author?.login ?? "unknown",
-      createdAt: c.createdAt ?? ""
-    })),
-    labels: Array.isArray(parsed.labels) ? parsed.labels.map((l) => l.name ?? "").filter((n) => n.length > 0) : []
-  };
-}
-function stripKodyMentions(body) {
-  return body.replace(/(@)(kody)/gi, "$1\u200B$2");
-}
-function postIssueComment(issueNumber, body, cwd) {
-  try {
-    gh(["issue", "comment", String(issueNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
-  } catch (err) {
-    process.stderr.write(
-      `[kody] failed to post comment on #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
-`
-    );
+      continue;
+    }
+    unmatched.push(t);
   }
+  return { args, leftover: unmatched.join(" ") };
 }
-function truncate2(s, maxBytes) {
-  if (s.length <= maxBytes) return s;
-  return `${s.slice(0, maxBytes)}\u2026 (+${s.length - maxBytes} chars)`;
+function findInputByFlag(inputs, key) {
+  return inputs.find((s) => s.name === key || s.flag === `--${key}`);
 }
-function parsePrNumber(url) {
-  const m = url.match(/\/pull\/(\d+)(?:[/?#]|$)/);
-  if (!m) return null;
-  const n = parseInt(m[1], 10);
-  return Number.isFinite(n) ? n : null;
+function coerceBare(spec, value) {
+  if (spec.type === "int") {
+    const n = parseInt(value, 10);
+    return Number.isNaN(n) ? value : n;
+  }
+  if (spec.type === "bool") {
+    const v = value.toLowerCase();
+    return v === "true" || v === "1" || v === "yes";
+  }
+  return value;
 }
-function getPr(prNumber, cwd) {
-  const output = gh(["pr", "view", String(prNumber), "--json", "number,title,body,headRefName,baseRefName,state"], {
-    cwd
-  });
-  const parsed = JSON.parse(output);
-  if (typeof parsed?.title !== "string") {
-    throw new Error(`PR #${prNumber}: unexpected response shape`);
+
+// src/kody-cli.ts
+init_issue();
+
+// src/executor.ts
+import { execFileSync as execFileSync29, spawn as spawn5 } from "child_process";
+import * as fs31 from "fs";
+import * as path29 from "path";
+init_events();
+
+// src/lifecycleLabels.ts
+init_issue();
+
+// src/profile.ts
+import * as fs9 from "fs";
+import * as path8 from "path";
+
+// src/profile-error.ts
+var ProfileError = class extends Error {
+  constructor(profilePath, message) {
+    super(`Invalid profile at ${profilePath}:
+  ${message}`);
+    this.profilePath = profilePath;
+    this.name = "ProfileError";
   }
-  return {
-    number: parsed.number ?? prNumber,
-    title: parsed.title,
-    body: parsed.body ?? "",
-    headRefName: String(parsed.headRefName ?? ""),
-    baseRefName: String(parsed.baseRefName ?? ""),
-    state: String(parsed.state ?? "")
-  };
+  profilePath;
+};
+
+// src/lifecycles/prBranch.ts
+var VALID_CONTEXTS = /* @__PURE__ */ new Set(["task", "ci-fix", "minimal"]);
+var CONTEXT_BUNDLES = {
+  task: ["loadTaskState", "loadConventions", "loadPriorArt", "loadMemoryContext", "loadCoverageRules"],
+  "ci-fix": ["loadTaskState", "loadConventions", "loadCoverageRules"],
+  minimal: []
+};
+function prBranchLifecycle(profile, profilePath) {
+  const cfg = validateConfig(profile.lifecycleConfig, profilePath);
+  const before = [];
+  if (cfg.sync) before.push({ script: "syncFlow" });
+  before.push({
+    script: "setLifecycleLabel",
+    with: {
+      label: cfg.label.name,
+      color: cfg.label.color,
+      description: cfg.label.description
+    }
+  });
+  const contextBundle = buildContextBundle(cfg.context, cfg.contextExtras);
+  const afterPreflight = cfg.context === "minimal" && cfg.contextExtras.length === 0 ? [{ script: "composePrompt" }] : [...contextBundle, { script: "composePrompt" }];
+  profile.scripts.preflight = [...before, ...profile.scripts.preflight, ...afterPreflight];
+  const beforePostflight = [{ script: "parseAgentResult" }];
+  const verifyChain = cfg.verify ? [{ script: "verify" }, { script: "checkCoverageWithRetry" }, { script: "abortUnfinishedGitOps" }] : [];
+  const tail = [
+    ...verifyChain,
+    { script: "commitAndPush" },
+    { script: "ensurePr" },
+    { script: "postIssueComment" },
+    { script: "writeRunSummary" },
+    { script: "saveTaskState" }
+  ];
+  if (cfg.mirrorState) tail.push({ script: "mirrorStateToPr" });
+  if (cfg.advance) tail.push({ script: "advanceFlow" });
+  profile.scripts.postflight = [...beforePostflight, ...profile.scripts.postflight, ...tail];
 }
-function getPrDiff(prNumber, cwd) {
-  try {
-    return gh(["pr", "diff", String(prNumber)], { cwd });
-  } catch (err) {
-    process.stderr.write(
-      `[kody] failed to fetch diff for PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
-`
-    );
-    return "";
+function buildContextBundle(context, extras) {
+  const base = CONTEXT_BUNDLES[context] ?? [];
+  if (base.length === 0 && extras.length === 0) return [];
+  const out = [];
+  let extrasInserted = false;
+  for (const name of base) {
+    out.push({ script: name });
+    if (name === "loadTaskState" && extras.length > 0) {
+      for (const e of extras) out.push({ script: e });
+      extrasInserted = true;
+    }
   }
+  if (!extrasInserted && extras.length > 0) {
+    out.unshift(...extras.map((e) => ({ script: e })));
+  }
+  return out;
 }
-function getPrReviews(prNumber, cwd) {
-  try {
-    const output = gh(["pr", "view", String(prNumber), "--json", "reviews"], { cwd });
-    const parsed = JSON.parse(output);
-    if (!Array.isArray(parsed?.reviews)) return [];
-    return parsed.reviews.map(
-      (r) => ({
-        body: r.body ?? "",
-        state: r.state ?? "",
-        author: r.author?.login ?? "unknown",
-        submittedAt: r.submittedAt ?? ""
-      })
+function validateConfig(raw, profilePath) {
+  if (!raw) {
+    throw new ProfileError(profilePath, `lifecycle "pr-branch" requires "lifecycleConfig" with a "label" object`);
+  }
+  const label = raw.label;
+  if (!label || typeof label !== "object" || Array.isArray(label)) {
+    throw new ProfileError(profilePath, `lifecycle "pr-branch": lifecycleConfig.label must be an object`);
+  }
+  const lbl = label;
+  for (const k of ["name", "color", "description"]) {
+    if (typeof lbl[k] !== "string" || lbl[k].length === 0) {
+      throw new ProfileError(profilePath, `lifecycle "pr-branch": lifecycleConfig.label.${k} must be a non-empty string`);
+    }
+  }
+  const context = raw.context === void 0 ? "task" : raw.context;
+  if (typeof context !== "string" || !VALID_CONTEXTS.has(context)) {
+    throw new ProfileError(
+      profilePath,
+      `lifecycle "pr-branch": lifecycleConfig.context must be one of: ${[...VALID_CONTEXTS].join(" | ")}`
     );
-  } catch {
-    return [];
   }
-}
-function getPrComments(prNumber, cwd) {
-  try {
-    const output = gh(["pr", "view", String(prNumber), "--json", "comments"], { cwd });
-    const parsed = JSON.parse(output);
-    if (!Array.isArray(parsed?.comments)) return [];
-    return parsed.comments.map((c) => ({
-      body: c.body ?? "",
-      author: c.author?.login ?? "unknown",
-      createdAt: c.createdAt ?? ""
-    })).filter((c) => c.body.trim().length > 0);
-  } catch {
-    return [];
+  let contextExtras = [];
+  if (raw.contextExtras !== void 0) {
+    if (!Array.isArray(raw.contextExtras) || raw.contextExtras.some((s) => typeof s !== "string" || !s)) {
+      throw new ProfileError(
+        profilePath,
+        `lifecycle "pr-branch": lifecycleConfig.contextExtras must be an array of non-empty strings`
+      );
+    }
+    contextExtras = raw.contextExtras;
   }
+  return {
+    label: {
+      name: lbl.name,
+      color: lbl.color,
+      description: lbl.description
+    },
+    context,
+    contextExtras,
+    sync: parseBool(raw, profilePath, "sync", true),
+    verify: parseBool(raw, profilePath, "verify", true),
+    advance: parseBool(raw, profilePath, "advance", true),
+    mirrorState: parseBool(raw, profilePath, "mirrorState", false)
+  };
 }
-var VERDICT_HEADING = /(^|\n)\s*#{1,6}\s*Verdict\s*:/i;
-function isReviewShaped(body) {
-  return VERDICT_HEADING.test(body);
-}
-function getPrLatestReviewBody(prNumber, cwd) {
-  const reviews = getPrReviews(prNumber, cwd).filter((r) => r.body.trim().length > 0).map((r) => ({ body: r.body, at: r.submittedAt }));
-  const comments = getPrComments(prNumber, cwd).filter((c) => isReviewShaped(c.body)).map((c) => ({ body: c.body, at: c.createdAt }));
-  const all = [...reviews, ...comments].sort((a, b) => (b.at || "").localeCompare(a.at || ""));
-  if (all.length > 0) return all[0].body;
-  const pr = getPr(prNumber, cwd);
-  return pr.body;
+function parseBool(raw, profilePath, key, def) {
+  if (raw[key] === void 0) return def;
+  if (typeof raw[key] !== "boolean") {
+    throw new ProfileError(profilePath, `lifecycle "pr-branch": lifecycleConfig.${key} must be a boolean`);
+  }
+  return raw[key];
 }
-function postPrReviewComment(prNumber, body, cwd) {
-  try {
-    gh(["pr", "comment", String(prNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
-  } catch (err) {
-    process.stderr.write(
-      `[kody] failed to post review comment on PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
-`
+
+// src/lifecycles/index.ts
+var REGISTRY = {
+  "pr-branch": prBranchLifecycle
+};
+function applyLifecycle(profile, profilePath) {
+  if (!profile.lifecycle) return;
+  const expander = REGISTRY[profile.lifecycle];
+  if (!expander) {
+    throw new ProfileError(
+      profilePath,
+      `unknown "lifecycle": "${profile.lifecycle}". Registered: ${Object.keys(REGISTRY).sort().join(", ")}`
     );
   }
+  expander(profile, profilePath);
 }
 
-// src/executor.ts
-import { execFileSync as execFileSync29, spawn as spawn5 } from "child_process";
-import * as fs31 from "fs";
-import * as path29 from "path";
-init_events();
-
 // src/profile.ts
-import * as fs9 from "fs";
-import * as path8 from "path";
 var VALID_INPUT_TYPES = /* @__PURE__ */ new Set(["int", "string", "bool", "enum"]);
 var VALID_PERMISSION_MODES = /* @__PURE__ */ new Set(["default", "acceptEdits", "plan", "bypassPermissions"]);
 var VALID_ROLES = /* @__PURE__ */ new Set(["primitive", "orchestrator", "container", "watch", "utility"]);
@@ -1940,6 +2489,8 @@ var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "inputs",
   "claudeCode",
   "cliTools",
+  "lifecycle",
+  "lifecycleConfig",
   "scripts",
   "outputContract",
   "inputArtifacts",
@@ -1949,17 +2500,9 @@ var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "output",
   // legacy JSON name for outputArtifacts source
   "children",
-  "resetBetweenChildren"
+  "resetBetweenChildren",
+  "preloadContext"
 ]);
-var ProfileError = class extends Error {
-  constructor(profilePath, message) {
-    super(`Invalid profile at ${profilePath}:
-  ${message}`);
-    this.profilePath = profilePath;
-    this.name = "ProfileError";
-  }
-  profilePath;
-};
 function loadProfile(profilePath) {
   if (!fs9.existsSync(profilePath)) {
     throw new ProfileError(profilePath, "file not found");
@@ -1997,6 +2540,23 @@ function loadProfile(profilePath) {
     phase = r.phase;
   }
   const children = parseContainerChildren(profilePath, role, r.children);
+  let lifecycle;
+  if (r.lifecycle !== void 0) {
+    if (typeof r.lifecycle !== "string" || r.lifecycle.length === 0) {
+      throw new ProfileError(profilePath, `"lifecycle" must be a non-empty string`);
+    }
+    lifecycle = r.lifecycle;
+  }
+  let lifecycleConfig;
+  if (r.lifecycleConfig !== void 0) {
+    if (!r.lifecycleConfig || typeof r.lifecycleConfig !== "object" || Array.isArray(r.lifecycleConfig)) {
+      throw new ProfileError(profilePath, `"lifecycleConfig" must be an object`);
+    }
+    lifecycleConfig = r.lifecycleConfig;
+  }
+  if (lifecycleConfig && !lifecycle) {
+    throw new ProfileError(profilePath, `"lifecycleConfig" is only meaningful when "lifecycle" is set`);
+  }
   const profile = {
     name: requireString(profilePath, r, "name"),
     describe: typeof r.describe === "string" ? r.describe : "",
@@ -2007,6 +2567,8 @@ function loadProfile(profilePath) {
     inputs: parseInputs(profilePath, r.inputs),
     claudeCode: parseClaudeCode(profilePath, r.claudeCode),
     cliTools: parseCliTools(profilePath, r.cliTools),
+    lifecycle,
+    lifecycleConfig,
     scripts: parseScripts(profilePath, r.scripts),
     outputContract: r.outputContract,
     inputArtifacts: parseInputArtifacts(profilePath, r.input),
@@ -2016,8 +2578,14 @@ function loadProfile(profilePath) {
     // container child sees a clean tracked tree (see executor.ts).
     // Containers opt out by setting `"resetBetweenChildren": false`.
     resetBetweenChildren: typeof r.resetBetweenChildren === "boolean" ? r.resetBetweenChildren : true,
+    // Phase 5 in-process handoff opt-in. Default false; containers
+    // flip to true after end-to-end verification.
+    preloadContext: r.preloadContext === true,
     dir: path8.dirname(profilePath)
   };
+  if (lifecycle) {
+    applyLifecycle(profile, profilePath);
+  }
   return profile;
 }
 function validateScriptReferences(profile, registeredScripts) {
@@ -3077,129 +3645,25 @@ function checkCoverage(addedFiles, requirements) {
       const expected = renderSiblingPath(file, req.requireSibling);
       if (!addedSet.has(expected)) {
         misses.push({ file, expectedTest: expected });
-      }
-      break;
-    }
-  }
-  return misses;
-}
-function formatMissesForFeedback(misses) {
-  if (misses.length === 0) return "";
-  const lines = ["The following files were added without a sibling test file:"];
-  for (const m of misses) lines.push(`- \`${m.file}\` \u2192 expected \`${m.expectedTest}\``);
-  lines.push("");
-  lines.push(
-    "Add the missing test files. Each should cover the new file's public API with at least a happy path and one failure path. Then re-emit DONE / COMMIT_MSG / PR_SUMMARY."
-  );
-  return lines.join("\n");
-}
-
-// src/prompt.ts
-import * as fs13 from "fs";
-import * as path12 from "path";
-var CONVENTIONS_PER_FILE_MAX_BYTES = 3e4;
-var CONVENTION_FILES = ["CLAUDE.md", "AGENTS.md"];
-function loadProjectConventions(projectDir) {
-  const out = [];
-  for (const rel of CONVENTION_FILES) {
-    const abs = path12.join(projectDir, rel);
-    if (!fs13.existsSync(abs)) continue;
-    let content;
-    try {
-      content = fs13.readFileSync(abs, "utf-8");
-    } catch {
-      continue;
-    }
-    const truncated = content.length > CONVENTIONS_PER_FILE_MAX_BYTES;
-    if (truncated) content = `${content.slice(0, CONVENTIONS_PER_FILE_MAX_BYTES)}
-
-\u2026 (truncated)`;
-    out.push({ path: rel, content, truncated });
-  }
-  return out;
-}
-function parseAgentResult(finalText) {
-  const text = (finalText || "").trim();
-  if (!text)
-    return {
-      done: false,
-      commitMessage: "",
-      prSummary: "",
-      feedbackActions: "",
-      planDeviations: "",
-      priorArt: "",
-      failureReason: "agent produced no final message",
-      markerMissing: false
-    };
-  const MARKDOWN_PREFIX = "[\\s>*_#`~\\-]*";
-  const FAILED_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}FAILED${MARKDOWN_PREFIX}\\s*:\\s*(.+?)\\s*$`, "is");
-  const DONE_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}DONE\\b`, "i");
-  const failedMatch = text.match(FAILED_RE);
-  if (failedMatch) {
-    return {
-      done: false,
-      commitMessage: "",
-      prSummary: "",
-      feedbackActions: "",
-      planDeviations: "",
-      priorArt: "",
-      failureReason: stripMarkdownEmphasis(failedMatch[1]),
-      markerMissing: false
-    };
-  }
-  const hasDoneMarker = DONE_RE.test(text);
-  const hasCommitMsg = /^[\s>*_#`~-]*COMMIT_MSG\s*:/im.test(text);
-  const hasPrSummary = /^[\s>*_#`~-]*PR_SUMMARY\s*:/im.test(text);
-  const markerMissing = !hasDoneMarker && !hasCommitMsg && !hasPrSummary;
-  const commitMatch = text.match(/^[\s>*_#`~-]*COMMIT_MSG[\s>*_#`~-]*\s*:\s*(.+)$/im);
-  const commitMessage = commitMatch ? stripMarkdownEmphasis(commitMatch[1]) : "";
-  const feedbackActions = extractBlock(
-    text,
-    /(?:^|\n)[ \t]*FEEDBACK_ACTIONS\s*:[ \t]*\n/i,
-    /(?:^|\n)[ \t]*(?:PLAN_DEVIATIONS|COMMIT_MSG|PR_SUMMARY|PRIOR_ART)\s*:/i
-  );
-  let planDeviations = extractBlock(
-    text,
-    /(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*\n/i,
-    /(?:^|\n)[ \t]*(?:COMMIT_MSG|PR_SUMMARY|FEEDBACK_ACTIONS|PRIOR_ART)\s*:/i
-  );
-  if (!planDeviations) {
-    const inline = text.match(/(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
-    if (inline) planDeviations = inline[1].trim();
-  }
-  let priorArt = "";
-  const priorArtInline = text.match(/(?:^|\n)[ \t]*PRIOR_ART\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
-  if (priorArtInline) priorArt = priorArtInline[1].trim();
-  const summaryStart = text.search(/(^|\n)[ \t]*PR_SUMMARY\s*:[ \t]*\n/i);
-  let prSummary = "";
-  if (summaryStart !== -1) {
-    const afterMarker = text.slice(summaryStart).replace(/^[\s\S]*?PR_SUMMARY\s*:[ \t]*\n/i, "");
-    prSummary = afterMarker.replace(/\n\s*```\s*$/g, "").replace(/```\s*$/g, "").trim();
+      }
+      break;
+    }
   }
-  return {
-    done: true,
-    commitMessage,
-    prSummary,
-    feedbackActions,
-    planDeviations,
-    priorArt,
-    failureReason: "",
-    markerMissing
-  };
-}
-function stripMarkdownEmphasis(s) {
-  return s.trim().replace(/^[*_`~]+|[*_`~]+$/g, "").trim();
+  return misses;
 }
-function extractBlock(text, startMarker, endMarker) {
-  const startIdx = text.search(startMarker);
-  if (startIdx === -1) return "";
-  const afterStart = text.slice(startIdx).replace(startMarker, "");
-  const endIdx = afterStart.search(endMarker);
-  const body = endIdx === -1 ? afterStart : afterStart.slice(0, endIdx);
-  return body.replace(/\n\s*```\s*$/g, "").trim();
+function formatMissesForFeedback(misses) {
+  if (misses.length === 0) return "";
+  const lines = ["The following files were added without a sibling test file:"];
+  for (const m of misses) lines.push(`- \`${m.file}\` \u2192 expected \`${m.expectedTest}\``);
+  lines.push("");
+  lines.push(
+    "Add the missing test files. Each should cover the new file's public API with at least a happy path and one failure path. Then re-emit DONE / COMMIT_MSG / PR_SUMMARY."
+  );
+  return lines.join("\n");
 }
 
 // src/scripts/checkCoverageWithRetry.ts
+init_prompt();
 var checkCoverageWithRetry = async (ctx) => {
   const reqs = ctx.data.coverageRules ?? [];
   if (reqs.length === 0) {
@@ -3508,11 +3972,13 @@ function formatToolsUsage(profile) {
 }
 
 // src/scripts/createQaGoal.ts
+init_issue();
 import { execFileSync as execFileSync10 } from "child_process";
 import * as fs16 from "fs";
 import * as path16 from "path";
 
 // src/scripts/postReviewResult.ts
+init_issue();
 function detectVerdict(body) {
   const m = body.match(/##\s*Verdict\s*:\s*(PASS|CONCERNS|FAIL)\b/i);
   if (!m) return "UNKNOWN";
@@ -4051,6 +4517,9 @@ QA_GOAL_TARGETED=(no manifest issue) (id: ${goalId}, verdict: ${verdict})
   ctx.output.exitCode = verdict === "FAIL" ? 1 : 0;
 };
 
+// src/goal/operations.ts
+init_issue();
+
 // src/goal/labels.ts
 function goalLabel(goalId) {
   return `goal:${goalId}`;
@@ -4955,7 +5424,11 @@ function stripQuotes(value) {
   return value;
 }
 
+// src/scripts/jobState/contentsApiBackend.ts
+init_issue();
+
 // src/scripts/issueStateComment.ts
+init_issue();
 function isStateEnvelope(x) {
   if (x === null || typeof x !== "object") return false;
   const o = x;
@@ -5419,6 +5892,7 @@ function listJobSlugs(absDir) {
 }
 
 // src/scripts/dispatchJobTicks.ts
+init_issue();
 var dispatchJobTicks = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const label = String(args?.label ?? "");
@@ -5506,6 +5980,7 @@ var dispatchNextTask = async (ctx) => {
 };
 
 // src/pr.ts
+init_issue();
 function prMergeStatus(prNumber, cwd) {
   try {
     const out = gh(
@@ -5852,6 +6327,7 @@ var finalizeGoal = async (ctx) => {
 };
 
 // src/scripts/finishFlow.ts
+init_issue();
 import { execFileSync as execFileSync14 } from "child_process";
 var TERMINAL_PHASE = {
   "review-passed": { phase: "shipped", status: "succeeded" },
@@ -6140,6 +6616,9 @@ function sleepMs(ms) {
   }
 }
 
+// src/scripts/fixCiFlow.ts
+init_issue();
+
 // src/workflow.ts
 import { execFileSync as execFileSync17 } from "child_process";
 var GH_TIMEOUT_MS = 3e4;
@@ -6293,6 +6772,7 @@ function tryPostPr(prNumber, body, cwd) {
 }
 
 // src/scripts/fixFlow.ts
+init_issue();
 var fixFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
   const pr = getPr(prNumber, ctx.cwd);
@@ -6659,22 +7139,9 @@ Nothing to do. All files already present. (Use --force to overwrite.)
   ctx.output.exitCode = 0;
 };
 
-// src/scripts/loadConventions.ts
-var loadConventions = async (ctx) => {
-  if (Array.isArray(ctx.data.conventions)) return;
-  const conventions = loadProjectConventions(ctx.cwd);
-  ctx.data.conventions = conventions;
-  if (conventions.length > 0) {
-    process.stderr.write(`[kody] loaded conventions: ${conventions.map((c) => c.path).join(", ")}
-`);
-  }
-};
-
-// src/scripts/loadCoverageRules.ts
-var loadCoverageRules = async (ctx) => {
-  if (Array.isArray(ctx.data.coverageRules)) return;
-  ctx.data.coverageRules = ctx.config.testRequirements ?? [];
-};
+// src/scripts/index.ts
+init_loadConventions();
+init_loadCoverageRules();
 
 // src/goal/state.ts
 import * as fs25 from "fs";
@@ -6791,6 +7258,7 @@ var loadGoalState = async (ctx) => {
 };
 
 // src/scripts/loadIssueContext.ts
+init_issue();
 var DEFAULT_COMMENT_LIMIT = 12;
 var DEFAULT_COMMENT_MAX_BYTES = 16e3;
 var loadIssueContext = async (ctx) => {
@@ -6820,6 +7288,7 @@ var loadIssueContext = async (ctx) => {
 };
 
 // src/scripts/loadIssueStateComment.ts
+init_issue();
 var loadIssueStateComment = async (ctx, _profile, args) => {
   const marker = String(args?.marker ?? "");
   if (!marker) {
@@ -6890,237 +7359,9 @@ function humanizeSlug(slug) {
   return slug.split(/[-_]+/).filter((s) => s.length > 0).map((s) => s[0].toUpperCase() + s.slice(1)).join(" ");
 }
 
-// src/scripts/loadMemoryContext.ts
-import * as fs27 from "fs";
-import * as path26 from "path";
-var MEMORY_DIR_RELATIVE = ".kody/memory";
-var MAX_PAGES = 8;
-var PER_PAGE_MAX_BYTES = 4e3;
-var TOTAL_MAX_BYTES = 24e3;
-var TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
-var loadMemoryContext = async (ctx) => {
-  if (typeof ctx.data.memoryContext === "string") return;
-  const memoryAbs = path26.join(ctx.cwd, MEMORY_DIR_RELATIVE);
-  if (!fs27.existsSync(memoryAbs)) {
-    ctx.data.memoryContext = "";
-    return;
-  }
-  let pages = [];
-  try {
-    pages = collectPages(memoryAbs);
-  } catch {
-    ctx.data.memoryContext = "";
-    return;
-  }
-  if (pages.length === 0) {
-    ctx.data.memoryContext = "";
-    return;
-  }
-  const queryTerms = extractQueryTerms(ctx);
-  const ranked = queryTerms.length > 0 ? scorePages(pages, queryTerms) : sortByRecency(pages);
-  const top = ranked.slice(0, MAX_PAGES);
-  ctx.data.memoryContext = formatBlock(top);
-};
-function collectPages(memoryAbs) {
-  const out = [];
-  walkMd(memoryAbs, (file) => {
-    let stat;
-    try {
-      stat = fs27.statSync(file);
-    } catch {
-      return;
-    }
-    let raw;
-    try {
-      raw = fs27.readFileSync(file, "utf-8");
-    } catch {
-      return;
-    }
-    const fm = raw.match(/^---\s*\n([\s\S]*?)\n---/);
-    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path26.basename(file, ".md");
-    const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
-    out.push({
-      relPath: path26.relative(memoryAbs, file),
-      title,
-      updated,
-      content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
-      mtime: stat.mtimeMs
-    });
-  });
-  return out;
-}
-function extractQueryTerms(ctx) {
-  const terms = [];
-  const issue = ctx.data.issue;
-  const pr = ctx.data.pr;
-  if (issue?.title) terms.push(...tokenize(issue.title));
-  if (pr?.title) terms.push(...tokenize(pr.title));
-  return Array.from(new Set(terms)).slice(0, 20);
-}
-function tokenize(s) {
-  return s.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((t) => t.length >= 3);
-}
-function scorePages(pages, terms) {
-  return pages.map((p) => {
-    const haystack = `${p.title} ${p.content}`.toLowerCase();
-    let score = 0;
-    for (const t of terms) {
-      if (haystack.includes(t)) score++;
-    }
-    return { p, score };
-  }).sort((a, b) => {
-    if (b.score !== a.score) return b.score - a.score;
-    return b.p.mtime - a.p.mtime;
-  }).map((x) => x.p);
-}
-function sortByRecency(pages) {
-  return [...pages].sort((a, b) => {
-    if (a.updated && b.updated && a.updated !== b.updated) {
-      return b.updated.localeCompare(a.updated);
-    }
-    return b.mtime - a.mtime;
-  });
-}
-function formatBlock(pages) {
-  if (pages.length === 0) return "";
-  const lines = [
-    "# Project memory (`.kody/memory/`)",
-    "",
-    "Pages from prior memorize ticks. Treat as advisory context \u2014 confirm against the codebase before acting.",
-    ""
-  ];
-  let total = 0;
-  for (const p of pages) {
-    const block = [`## ${p.title} \u2014 \`${p.relPath}\``, "", p.content].join("\n");
-    if (total + block.length > TOTAL_MAX_BYTES) {
-      lines.push("_\u2026 (further pages truncated to fit budget)_");
-      break;
-    }
-    lines.push(block);
-    lines.push("");
-    total += block.length;
-  }
-  return lines.join("\n");
-}
-function walkMd(root, visit) {
-  const stack = [root];
-  while (stack.length > 0) {
-    const dir = stack.pop();
-    let names;
-    try {
-      names = fs27.readdirSync(dir);
-    } catch {
-      continue;
-    }
-    for (const name of names) {
-      if (name.startsWith(".")) continue;
-      const full = path26.join(dir, name);
-      let stat;
-      try {
-        stat = fs27.statSync(full);
-      } catch {
-        continue;
-      }
-      if (stat.isDirectory()) {
-        stack.push(full);
-        continue;
-      }
-      if (stat.isFile() && full.endsWith(".md")) visit(full);
-    }
-  }
-}
-
-// src/scripts/loadPriorArt.ts
-var PER_PR_DIFF_MAX_BYTES = 8e3;
-var TOTAL_MAX_BYTES2 = 3e4;
-var TRUNCATED_SUFFIX2 = "\n\n\u2026 (truncated)";
-var loadPriorArt = async (ctx, _profile, args) => {
-  if (typeof ctx.data.priorArt === "string") return;
-  const artifactName = typeof args?.artifactName === "string" ? args.artifactName : "priorArt";
-  const state = ctx.data.taskState;
-  const artifact = state?.artifacts?.[artifactName];
-  const prNumbers = parsePrNumbers(artifact?.content);
-  if (prNumbers.length === 0) {
-    ctx.data.priorArt = "";
-    return;
-  }
-  const blocks = [];
-  for (const n of prNumbers) {
-    const block = fetchPrBlock(n, ctx.cwd);
-    if (block) blocks.push(block);
-  }
-  const joined = blocks.join("\n\n---\n\n");
-  ctx.data.priorArt = joined.length > TOTAL_MAX_BYTES2 ? joined.slice(0, TOTAL_MAX_BYTES2) + TRUNCATED_SUFFIX2 : joined;
-};
-function parsePrNumbers(raw) {
-  if (!raw) return [];
-  const trimmed = raw.trim();
-  if (!trimmed) return [];
-  try {
-    const parsed = JSON.parse(trimmed);
-    if (!Array.isArray(parsed)) return [];
-    return parsed.filter((n) => typeof n === "number" && Number.isInteger(n) && n > 0);
-  } catch {
-    return [];
-  }
-}
-function fetchPrBlock(prNumber, cwd) {
-  try {
-    const metaRaw = gh(["pr", "view", String(prNumber), "--json", "title,state,url,mergedAt,closedAt"], { cwd });
-    const meta = JSON.parse(metaRaw);
-    const diff = truncate3(safeGh(["pr", "diff", String(prNumber)], cwd), PER_PR_DIFF_MAX_BYTES);
-    const commentsRaw = safeGh(["pr", "view", String(prNumber), "--json", "comments,reviews"], cwd);
-    const commentsBlock = formatReviewComments(commentsRaw);
-    const lines = [
-      `## Prior art: PR #${prNumber} \u2014 ${meta.title ?? "(no title)"} [${meta.state ?? "unknown"}]`,
-      meta.url ? meta.url : "",
-      "",
-      "### Diff",
-      "```diff",
-      diff || "(empty)",
-      "```"
-    ];
-    if (commentsBlock) {
-      lines.push("");
-      lines.push("### Review comments");
-      lines.push(commentsBlock);
-    }
-    return lines.filter((l) => l !== "").join("\n");
-  } catch (err) {
-    return `## Prior art: PR #${prNumber}
-_Could not fetch \u2014 ${err instanceof Error ? err.message : String(err)}_`;
-  }
-}
-function safeGh(args, cwd) {
-  try {
-    return gh(args, { cwd });
-  } catch {
-    return "";
-  }
-}
-function truncate3(s, max) {
-  return s.length <= max ? s : s.slice(0, max) + TRUNCATED_SUFFIX2;
-}
-function formatReviewComments(raw) {
-  if (!raw) return "";
-  try {
-    const parsed = JSON.parse(raw);
-    const out = [];
-    for (const c of parsed.comments ?? []) {
-      if (!c.body) continue;
-      out.push(`- **${c.author?.login ?? "unknown"}**: ${c.body.replace(/\n/g, " ").slice(0, 500)}`);
-    }
-    for (const r of parsed.reviews ?? []) {
-      if (!r.body && !r.state) continue;
-      const state = r.state ? ` (${r.state})` : "";
-      const body = r.body ? `: ${r.body.replace(/\n/g, " ").slice(0, 500)}` : "";
-      out.push(`- **${r.author?.login ?? "unknown"}**${state}${body}`);
-    }
-    return out.join("\n");
-  } catch {
-    return "";
-  }
-}
+// src/scripts/index.ts
+init_loadMemoryContext();
+init_loadPriorArt();
 
 // src/scripts/loadTaskContext.ts
 init_events();
@@ -7291,6 +7532,7 @@ function parsePrNumber3(prUrl) {
 }
 
 // src/scripts/notifyTerminal.ts
+init_issue();
 var notifyTerminal = async (ctx, _profile, _agentResult, args) => {
   const issueNumber = ctx.args.issue;
   if (!issueNumber || issueNumber <= 0) return;
@@ -7322,6 +7564,7 @@ function composeBody({ label, exit, prUrl, reason, dryRun }) {
 }
 
 // src/scripts/openQaIssue.ts
+init_issue();
 var QA_LABEL = "kody:qa-report";
 function qaAction2(verdict, payload) {
   const type = verdict === "PASS" ? "QA_PASS" : verdict === "CONCERNS" ? "QA_CONCERNS" : verdict === "FAIL" ? "QA_FAIL" : "QA_COMPLETED";
@@ -7423,6 +7666,7 @@ QA_REPORT_POSTED=${created.url} (verdict: ${verdict})
 };
 
 // src/scripts/parseAgentResult.ts
+init_prompt();
 var parseAgentResult2 = async (ctx, profile, agentResult) => {
   if (!agentResult) {
     ctx.data.agentDone = false;
@@ -7665,6 +7909,9 @@ var persistFlowState = async (ctx) => {
   }
 };
 
+// src/scripts/postIssueComment.ts
+init_issue();
+
 // src/scripts/prOutcome.ts
 function readPrOutcome(data) {
   const raw = data.prResult;
@@ -7800,6 +8047,7 @@ function postWith(type, n, body, cwd) {
 }
 
 // src/scripts/postPlanComment.ts
+init_issue();
 var postPlanComment = async (ctx) => {
   if (!ctx.data.agentDone) return;
   const targetType = ctx.data.commentTargetType;
@@ -7830,6 +8078,7 @@ Comment \`kody run\` (prefixed with \`@\`) to execute this plan.`;
 }
 
 // src/scripts/postResearchComment.ts
+init_issue();
 var postResearchComment = async (ctx) => {
   if (!ctx.data.agentDone) return;
   const targetType = ctx.data.commentTargetType;
@@ -8011,6 +8260,7 @@ var resolveArtifacts = async (ctx, profile) => {
 
 // src/scripts/resolveFlow.ts
 import { execFileSync as execFileSync21 } from "child_process";
+init_issue();
 var CONFLICT_DIFF_MAX_BYTES = 4e4;
 var resolveFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
@@ -8159,6 +8409,7 @@ function pushEmptyCommit(branch, cwd) {
 }
 
 // src/deployments.ts
+init_issue();
 function findPreviewDeploymentUrl(prNumber, cwd) {
   const sha = getPrHeadSha(prNumber, cwd);
   if (!sha) return null;
@@ -8311,6 +8562,7 @@ var resolveQaUrl = async (ctx) => {
 
 // src/scripts/revertFlow.ts
 import { execFileSync as execFileSync23 } from "child_process";
+init_issue();
 var SHA_RE = /^[0-9a-f]{4,40}$/i;
 var revertFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
@@ -8423,6 +8675,7 @@ function tryPostPr4(prNumber, body, cwd) {
 }
 
 // src/scripts/reviewFlow.ts
+init_issue();
 var reviewFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
   const pr = getPr(prNumber, ctx.cwd);
@@ -8450,6 +8703,7 @@ function tryPostPr5(prNumber, body, cwd) {
 }
 
 // src/scripts/runFlow.ts
+init_issue();
 var runFlow = async (ctx) => {
   const issueNumber = ctx.args.issue;
   const issue = getIssue(issueNumber, ctx.cwd);
@@ -8736,6 +8990,7 @@ var stageMergeConflicts = async (ctx) => {
 };
 
 // src/scripts/startFlow.ts
+init_issue();
 import { execFileSync as execFileSync25 } from "child_process";
 var API_TIMEOUT_MS9 = 3e4;
 var startFlow = async (ctx, profile, _agentResult, args) => {
@@ -8785,6 +9040,7 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
 
 // src/scripts/syncFlow.ts
 import { execFileSync as execFileSync26 } from "child_process";
+init_issue();
 var syncFlow = async (ctx, _profile, args) => {
   const announceOnSuccess = Boolean(args?.announceOnSuccess);
   const prNumber = ctx.args.pr;
@@ -9028,6 +9284,7 @@ function downgrade2(ctx, reason) {
 }
 
 // src/scripts/waitForCi.ts
+init_issue();
 import { execFileSync as execFileSync27 } from "child_process";
 var API_TIMEOUT_MS10 = 3e4;
 var waitForCi = async (ctx, _profile, _agentResult, args) => {
@@ -10040,6 +10297,32 @@ async function runContainerLoop(profile, ctx, input) {
   const runChild = input.__runChild ?? ((name, opts) => runExecutable(name, opts));
   const reader = input.__readTaskState ?? readTaskState;
   const issueNumber = ctx.args.issue;
+  let preloadedSnapshot;
+  if (profile.preloadContext) {
+    try {
+      const { loadConventions: loadConventions2 } = await Promise.resolve().then(() => (init_loadConventions(), loadConventions_exports));
+      const { loadPriorArt: loadPriorArt2 } = await Promise.resolve().then(() => (init_loadPriorArt(), loadPriorArt_exports));
+      const { loadMemoryContext: loadMemoryContext2 } = await Promise.resolve().then(() => (init_loadMemoryContext(), loadMemoryContext_exports));
+      const { loadCoverageRules: loadCoverageRules2 } = await Promise.resolve().then(() => (init_loadCoverageRules(), loadCoverageRules_exports));
+      await loadConventions2(ctx, profile);
+      await loadPriorArt2(ctx, profile);
+      await loadMemoryContext2(ctx, profile);
+      await loadCoverageRules2(ctx, profile);
+      preloadedSnapshot = {};
+      for (const k of ["issue", "conventions", "priorArt", "memoryContext", "coverageRules", "taskContext"]) {
+        if (ctx.data[k] !== void 0) preloadedSnapshot[k] = ctx.data[k];
+      }
+      process.stderr.write(
+        `[kody container] preloadContext: snapshot keys=${Object.keys(preloadedSnapshot).join(",")}
+`
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`[kody container] preloadContext failed (falling back to per-child loads): ${msg}
+`);
+      preloadedSnapshot = void 0;
+    }
+  }
   let currentIdx = 0;
   let iteration = 0;
   let knownPrUrl;
@@ -10121,7 +10404,10 @@ async function runContainerLoop(profile, ctx, input) {
           config: input.config,
           skipConfig: input.skipConfig,
           verbose: input.verbose,
-          quiet: input.quiet
+          quiet: input.quiet,
+          // Phase 5 in-process handoff — undefined when preloadContext
+          // is off, so children fall back to their own loaders.
+          preloadedData: preloadedSnapshot
         });
         emitEvent(input.cwd, {
           executable: profile.name,
@@ -10287,6 +10573,7 @@ function flattenConfig(obj, prefix = "") {
 }
 
 // src/kody-cli.ts
+init_issue();
 var CI_HELP = `kody ci \u2014 minimal-YAML autonomous engineer (CI preflight + run)
 
 Usage: