@kody-ade/kody-engine 0.4.65 → 0.4.67

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.65",
+  version: "0.4.67",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1775,153 +2324,18 @@ function coerceBare(spec, value) {
   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)}
-`
-    );
-  }
-}
-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 [];
-  }
-}
-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 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/kody-cli.ts
+init_issue();
 
 // src/executor.ts
-import { execFileSync as execFileSync29, spawn as spawn5 } from "child_process";
+import { execFileSync as execFileSync29, spawn as spawn6 } 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";
@@ -2086,7 +2500,8 @@ var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "output",
   // legacy JSON name for outputArtifacts source
   "children",
-  "resetBetweenChildren"
+  "resetBetweenChildren",
+  "preloadContext"
 ]);
 function loadProfile(profilePath) {
   if (!fs9.existsSync(profilePath)) {
@@ -2163,6 +2578,9 @@ 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) {
@@ -3236,120 +3654,16 @@ function checkCoverage(addedFiles, requirements) {
 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();
-  }
-  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();
+  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) {
@@ -3658,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";
@@ -4201,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}`;
@@ -5105,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;
@@ -5569,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 ?? "");
@@ -5656,6 +5980,7 @@ var dispatchNextTask = async (ctx) => {
 };
 
 // src/pr.ts
+init_issue();
 function prMergeStatus(prNumber, cwd) {
   try {
     const out = gh(
@@ -6002,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" },
@@ -6290,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;
@@ -6443,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);
@@ -6809,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";
@@ -6922,356 +7239,130 @@ var loadGoalState = async (ctx) => {
     ctx.data.goal = {
       id: goalId,
       state: state.state,
-      lastDispatchedIssue: state.lastDispatchedIssue,
-      // Cache the full parsed object so saveGoalState can preserve `extra`.
-      raw: state,
-      // `phase`, `childTasks`, `openTaskPrs`, `leafPr` are populated by
-      // deriveGoalPhase later in the chain. Initialize to undefined so
-      // runWhen on `data.goal.phase` can match correctly.
-      phase: void 0,
-      defaultBranch: ctx.config.git.defaultBranch
-    };
-  } catch (err) {
-    process.stdout.write(`[goal-tick] ${err instanceof Error ? err.message : String(err)}
-`);
-    ctx.skipAgent = true;
-    ctx.output.exitCode = 0;
-    ctx.output.reason = "no goal state to tick";
-  }
-};
-
-// src/scripts/loadIssueContext.ts
-var DEFAULT_COMMENT_LIMIT = 12;
-var DEFAULT_COMMENT_MAX_BYTES = 16e3;
-var loadIssueContext = async (ctx) => {
-  const issueNumber = ctx.args.issue;
-  if (typeof issueNumber !== "number" || issueNumber <= 0) {
-    throw new Error("loadIssueContext: ctx.args.issue (positive integer) is required");
-  }
-  const preloaded = ctx.data.issue;
-  if (preloaded && typeof preloaded === "object" && preloaded.number === issueNumber) {
-    if (!ctx.data.commentTargetType) ctx.data.commentTargetType = "issue";
-    if (!ctx.data.commentTargetNumber) ctx.data.commentTargetNumber = issueNumber;
-    return;
-  }
-  const issue = getIssue(issueNumber, ctx.cwd);
-  const cfgCtx = ctx.config.issueContext ?? {};
-  const limit = cfgCtx.commentLimit ?? DEFAULT_COMMENT_LIMIT;
-  const maxBytes = cfgCtx.commentMaxBytes ?? DEFAULT_COMMENT_MAX_BYTES;
-  const sorted = [...issue.comments].sort((a, b) => a.createdAt < b.createdAt ? 1 : -1);
-  const kept = sorted.slice(0, limit);
-  const commentsFormatted = kept.length === 0 ? "(no comments yet)" : kept.map((c) => `- **${c.author}** (${c.createdAt}):
-  ${truncate2(c.body, maxBytes).replace(/\n/g, "\n  ")}`).join("\n\n");
-  const labels = issue.labels ?? [];
-  const labelsFormatted = labels.length === 0 ? "(no labels)" : labels.map((l) => `\`${l}\``).join(", ");
-  ctx.data.issue = { ...issue, commentsFormatted, labelsFormatted };
-  ctx.data.commentTargetType = "issue";
-  ctx.data.commentTargetNumber = issueNumber;
-};
-
-// src/scripts/loadIssueStateComment.ts
-var loadIssueStateComment = async (ctx, _profile, args) => {
-  const marker = String(args?.marker ?? "");
-  if (!marker) {
-    throw new Error("loadIssueStateComment: `with.marker` is required");
-  }
-  const issueArg = String(args?.issueArg ?? "issue");
-  const issueNumber = Number(ctx.args[issueArg]);
-  if (!Number.isFinite(issueNumber) || issueNumber <= 0) {
-    throw new Error(`loadIssueStateComment: ctx.args.${issueArg} must be a positive integer`);
-  }
-  const owner = ctx.config.github.owner;
-  const repo = ctx.config.github.repo;
-  if (!owner || !repo) {
-    throw new Error("loadIssueStateComment: ctx.config.github.owner/repo must be set");
-  }
-  const issue = getIssue(issueNumber, ctx.cwd);
-  const loaded = findStateComment2(owner, repo, issueNumber, marker, ctx.cwd);
-  ctx.data.stateMarker = marker;
-  ctx.data.issueIntent = issue.body;
-  ctx.data.issueTitle = issue.title;
-  ctx.data.issueNumber = String(issueNumber);
-  ctx.data.issueStateComment = loaded;
-  ctx.data.issueStateJson = loaded ? JSON.stringify(loaded.state, null, 2) : "null";
-};
-
-// src/scripts/loadJobFromFile.ts
-import * as fs26 from "fs";
-import * as path25 from "path";
-var loadJobFromFile = async (ctx, _profile, args) => {
-  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
-  const slugArg = String(args?.slugArg ?? "job");
-  const slug = String(ctx.args[slugArg] ?? "").trim();
-  if (!slug) {
-    throw new Error(`loadJobFromFile: ctx.args.${slugArg} must be a non-empty slug`);
-  }
-  const absPath = path25.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs26.existsSync(absPath)) {
-    throw new Error(`loadJobFromFile: job file not found: ${absPath}`);
-  }
-  const raw = fs26.readFileSync(absPath, "utf-8");
-  const { title, body } = parseJobFile(raw, slug);
-  const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
-  const loaded = await backend.load(slug);
-  ctx.data.jobSlug = slug;
-  ctx.data.jobTitle = title;
-  ctx.data.jobIntent = body;
-  ctx.data.jobState = loaded;
-  ctx.data.jobStateJson = JSON.stringify(loaded.state, null, 2);
-};
-function parseJobFile(raw, slug) {
-  let stripped = raw;
-  if (stripped.startsWith("---\n")) {
-    const end = stripped.indexOf("\n---\n", 4);
-    if (end !== -1) {
-      stripped = stripped.slice(end + 5);
-    }
-  }
-  const trimmed = stripped.trim();
-  const firstLine2 = trimmed.split("\n", 1)[0] ?? "";
-  const h1 = /^#\s+(.+?)\s*$/.exec(firstLine2);
-  if (h1) {
-    const rest = trimmed.slice(firstLine2.length).replace(/^\n+/, "");
-    return { title: h1[1].trim(), body: rest };
-  }
-  return { title: humanizeSlug(slug), body: trimmed };
-}
-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);
-    }
+      lastDispatchedIssue: state.lastDispatchedIssue,
+      // Cache the full parsed object so saveGoalState can preserve `extra`.
+      raw: state,
+      // `phase`, `childTasks`, `openTaskPrs`, `leafPr` are populated by
+      // deriveGoalPhase later in the chain. Initialize to undefined so
+      // runWhen on `data.goal.phase` can match correctly.
+      phase: void 0,
+      defaultBranch: ctx.config.git.defaultBranch
+    };
+  } catch (err) {
+    process.stdout.write(`[goal-tick] ${err instanceof Error ? err.message : String(err)}
+`);
+    ctx.skipAgent = true;
+    ctx.output.exitCode = 0;
+    ctx.output.reason = "no goal state to tick";
   }
-}
+};
 
-// 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 = "";
+// src/scripts/loadIssueContext.ts
+init_issue();
+var DEFAULT_COMMENT_LIMIT = 12;
+var DEFAULT_COMMENT_MAX_BYTES = 16e3;
+var loadIssueContext = async (ctx) => {
+  const issueNumber = ctx.args.issue;
+  if (typeof issueNumber !== "number" || issueNumber <= 0) {
+    throw new Error("loadIssueContext: ctx.args.issue (positive integer) is required");
+  }
+  const preloaded = ctx.data.issue;
+  if (preloaded && typeof preloaded === "object" && preloaded.number === issueNumber) {
+    if (!ctx.data.commentTargetType) ctx.data.commentTargetType = "issue";
+    if (!ctx.data.commentTargetNumber) ctx.data.commentTargetNumber = issueNumber;
     return;
   }
-  const blocks = [];
-  for (const n of prNumbers) {
-    const block = fetchPrBlock(n, ctx.cwd);
-    if (block) blocks.push(block);
+  const issue = getIssue(issueNumber, ctx.cwd);
+  const cfgCtx = ctx.config.issueContext ?? {};
+  const limit = cfgCtx.commentLimit ?? DEFAULT_COMMENT_LIMIT;
+  const maxBytes = cfgCtx.commentMaxBytes ?? DEFAULT_COMMENT_MAX_BYTES;
+  const sorted = [...issue.comments].sort((a, b) => a.createdAt < b.createdAt ? 1 : -1);
+  const kept = sorted.slice(0, limit);
+  const commentsFormatted = kept.length === 0 ? "(no comments yet)" : kept.map((c) => `- **${c.author}** (${c.createdAt}):
+  ${truncate2(c.body, maxBytes).replace(/\n/g, "\n  ")}`).join("\n\n");
+  const labels = issue.labels ?? [];
+  const labelsFormatted = labels.length === 0 ? "(no labels)" : labels.map((l) => `\`${l}\``).join(", ");
+  ctx.data.issue = { ...issue, commentsFormatted, labelsFormatted };
+  ctx.data.commentTargetType = "issue";
+  ctx.data.commentTargetNumber = issueNumber;
+};
+
+// src/scripts/loadIssueStateComment.ts
+init_issue();
+var loadIssueStateComment = async (ctx, _profile, args) => {
+  const marker = String(args?.marker ?? "");
+  if (!marker) {
+    throw new Error("loadIssueStateComment: `with.marker` is required");
+  }
+  const issueArg = String(args?.issueArg ?? "issue");
+  const issueNumber = Number(ctx.args[issueArg]);
+  if (!Number.isFinite(issueNumber) || issueNumber <= 0) {
+    throw new Error(`loadIssueStateComment: ctx.args.${issueArg} must be a positive integer`);
+  }
+  const owner = ctx.config.github.owner;
+  const repo = ctx.config.github.repo;
+  if (!owner || !repo) {
+    throw new Error("loadIssueStateComment: ctx.config.github.owner/repo must be set");
   }
-  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;
+  const issue = getIssue(issueNumber, ctx.cwd);
+  const loaded = findStateComment2(owner, repo, issueNumber, marker, ctx.cwd);
+  ctx.data.stateMarker = marker;
+  ctx.data.issueIntent = issue.body;
+  ctx.data.issueTitle = issue.title;
+  ctx.data.issueNumber = String(issueNumber);
+  ctx.data.issueStateComment = loaded;
+  ctx.data.issueStateJson = loaded ? JSON.stringify(loaded.state, null, 2) : "null";
 };
-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 [];
+
+// src/scripts/loadJobFromFile.ts
+import * as fs26 from "fs";
+import * as path25 from "path";
+var loadJobFromFile = async (ctx, _profile, args) => {
+  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
+  const slugArg = String(args?.slugArg ?? "job");
+  const slug = String(ctx.args[slugArg] ?? "").trim();
+  if (!slug) {
+    throw new Error(`loadJobFromFile: ctx.args.${slugArg} must be a non-empty slug`);
   }
-}
-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);
+  const absPath = path25.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs26.existsSync(absPath)) {
+    throw new Error(`loadJobFromFile: job file not found: ${absPath}`);
+  }
+  const raw = fs26.readFileSync(absPath, "utf-8");
+  const { title, body } = parseJobFile(raw, slug);
+  const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
+  const loaded = await backend.load(slug);
+  ctx.data.jobSlug = slug;
+  ctx.data.jobTitle = title;
+  ctx.data.jobIntent = body;
+  ctx.data.jobState = loaded;
+  ctx.data.jobStateJson = JSON.stringify(loaded.state, null, 2);
+};
+function parseJobFile(raw, slug) {
+  let stripped = raw;
+  if (stripped.startsWith("---\n")) {
+    const end = stripped.indexOf("\n---\n", 4);
+    if (end !== -1) {
+      stripped = stripped.slice(end + 5);
     }
-    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 "";
+  const trimmed = stripped.trim();
+  const firstLine2 = trimmed.split("\n", 1)[0] ?? "";
+  const h1 = /^#\s+(.+?)\s*$/.exec(firstLine2);
+  if (h1) {
+    const rest = trimmed.slice(firstLine2.length).replace(/^\n+/, "");
+    return { title: h1[1].trim(), body: rest };
   }
+  return { title: humanizeSlug(slug), body: trimmed };
 }
-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 "";
-  }
+function humanizeSlug(slug) {
+  return slug.split(/[-_]+/).filter((s) => s.length > 0).map((s) => s[0].toUpperCase() + s.slice(1)).join(" ");
 }
 
+// src/scripts/index.ts
+init_loadMemoryContext();
+init_loadPriorArt();
+
 // src/scripts/loadTaskContext.ts
 init_events();
 
@@ -7441,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;
@@ -7472,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";
@@ -7573,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;
@@ -7815,6 +7909,9 @@ var persistFlowState = async (ctx) => {
   }
 };
 
+// src/scripts/postIssueComment.ts
+init_issue();
+
 // src/scripts/prOutcome.ts
 function readPrOutcome(data) {
   const raw = data.prResult;
@@ -7950,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;
@@ -7980,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;
@@ -8161,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;
@@ -8309,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;
@@ -8461,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;
@@ -8573,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);
@@ -8600,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);
@@ -8886,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) => {
@@ -8933,8 +9038,167 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
   }
 }
 
+// src/scripts/startLocalServer.ts
+import { spawn as spawn3 } from "child_process";
+import { existsSync as existsSync26, readFileSync as readFileSync24 } from "fs";
+import { join as join27 } from "path";
+var READY_TIMEOUT_MS = 12e4;
+var READY_POLL_MS = 1e3;
+var INSTALL_TIMEOUT_MS = 3e5;
+var FETCH_TIMEOUT_MS = 2e3;
+var DEFAULT_PORT = 3e3;
+var startLocalServer = async (ctx) => {
+  if (urlAlreadyResolved(ctx)) {
+    process.stderr.write("[kody startLocalServer] preview URL already set \u2014 skipping\n");
+    return;
+  }
+  const pkg = readPackageJson(ctx.cwd);
+  if (!pkg) return;
+  const scriptName = pickScript(pkg.scripts);
+  if (!scriptName) {
+    process.stderr.write("[kody startLocalServer] no dev/start script in package.json \u2014 skipping\n");
+    return;
+  }
+  const pm = detectPackageManager2(ctx.cwd);
+  const port = pickPort();
+  await ensureDependenciesInstalled(pm, ctx.cwd);
+  const url = `http://localhost:${port}`;
+  process.stderr.write(`[kody startLocalServer] spawning '${pm} run ${scriptName}' on ${url}
+`);
+  const child = spawnServer(pm, scriptName, port, ctx.cwd);
+  registerProcessCleanup(child);
+  const ready = await waitForReady(url, READY_TIMEOUT_MS);
+  if (!ready) {
+    safeKill(child);
+    throw new Error(
+      `startLocalServer: dev server at ${url} did not become reachable within ${READY_TIMEOUT_MS}ms`
+    );
+  }
+  process.env.PREVIEW_URL = url;
+  ctx.data.qaServerPid = child.pid;
+  ctx.data.qaServerScript = scriptName;
+  process.stderr.write(`[kody startLocalServer] ready: ${url}
+`);
+};
+function urlAlreadyResolved(ctx) {
+  const fromFlag = typeof ctx.args.previewUrl === "string" ? ctx.args.previewUrl.trim() : "";
+  if (fromFlag.length > 0) return true;
+  const fromEnv = (process.env.PREVIEW_URL ?? "").trim();
+  return fromEnv.length > 0;
+}
+function readPackageJson(cwd) {
+  const path32 = join27(cwd, "package.json");
+  if (!existsSync26(path32)) {
+    process.stderr.write("[kody startLocalServer] no package.json \u2014 skipping\n");
+    return null;
+  }
+  try {
+    const raw = JSON.parse(readFileSync24(path32, "utf8"));
+    return { scripts: raw.scripts ?? {} };
+  } catch (err) {
+    process.stderr.write(
+      `[kody startLocalServer] could not parse package.json: ${err.message}
+`
+    );
+    return null;
+  }
+}
+function pickScript(scripts) {
+  if (typeof scripts.dev === "string" && scripts.dev.length > 0) return "dev";
+  if (typeof scripts.start === "string" && scripts.start.length > 0) return "start";
+  return null;
+}
+function detectPackageManager2(cwd) {
+  if (existsSync26(join27(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync26(join27(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function pickPort() {
+  const fromEnv = Number((process.env.PREVIEW_PORT ?? "").trim());
+  if (Number.isInteger(fromEnv) && fromEnv > 0) return fromEnv;
+  return DEFAULT_PORT;
+}
+async function ensureDependenciesInstalled(pm, cwd) {
+  if (existsSync26(join27(cwd, "node_modules"))) return;
+  process.stderr.write(`[kody startLocalServer] installing dependencies via ${pm}
+`);
+  await runOnce(pm, installArgs(pm), cwd, INSTALL_TIMEOUT_MS);
+}
+function installArgs(pm) {
+  if (pm === "pnpm") return ["install", "--frozen-lockfile"];
+  if (pm === "yarn") return ["install", "--frozen-lockfile"];
+  return ["ci"];
+}
+function spawnServer(pm, scriptName, port, cwd) {
+  const child = spawn3(pm, ["run", scriptName], {
+    cwd,
+    env: { ...process.env, PORT: String(port), NODE_ENV: "development" },
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: false
+  });
+  child.stdout?.on("data", (b) => process.stderr.write(`[qa-server] ${b.toString("utf8")}`));
+  child.stderr?.on("data", (b) => process.stderr.write(`[qa-server] ${b.toString("utf8")}`));
+  return child;
+}
+function registerProcessCleanup(child) {
+  const cleanup = () => safeKill(child);
+  process.on("exit", cleanup);
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+}
+function safeKill(child) {
+  try {
+    child.kill("SIGTERM");
+  } catch {
+  }
+}
+async function runOnce(cmd, args, cwd, timeoutMs) {
+  await new Promise((resolve4, reject) => {
+    const c = spawn3(cmd, args, { cwd, stdio: "inherit" });
+    const timer = setTimeout(() => {
+      try {
+        c.kill("SIGKILL");
+      } catch {
+      }
+      reject(new Error(`${cmd} ${args.join(" ")} timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    c.on("exit", (code) => {
+      clearTimeout(timer);
+      if (code === 0) {
+        resolve4();
+        return;
+      }
+      reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code}`));
+    });
+    c.on("error", (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
+async function waitForReady(url, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await probe(url)) return true;
+    await sleep2(READY_POLL_MS);
+  }
+  return false;
+}
+async function probe(url) {
+  try {
+    const res = await fetch(url, { method: "GET", signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    return res.status < 500;
+  } catch {
+    return false;
+  }
+}
+function sleep2(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
 // 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;
@@ -9062,7 +9326,7 @@ var verify = async (ctx) => {
 };
 
 // src/scripts/verifyReproFails.ts
-import { spawn as spawn3 } from "child_process";
+import { spawn as spawn4 } from "child_process";
 var TEST_TIMEOUT_MS = 10 * 60 * 1e3;
 var TAIL_CHARS2 = 8e3;
 var ANSI_RE2 = /\x1B\[[0-?]*[ -/]*[@-~]/g;
@@ -9131,7 +9395,7 @@ function stripAnsi2(s) {
 }
 function runCommand2(command, cwd) {
   return new Promise((resolve4) => {
-    const child = spawn3(command, {
+    const child = spawn4(command, {
       cwd,
       shell: true,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" },
@@ -9178,6 +9442,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) => {
@@ -9193,17 +9458,17 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
     return;
   }
   const fixCiAttempts = state?.core.attempts?.["fix-ci"] ?? 0;
-  await sleep2(initialWaitSeconds * 1e3);
+  await sleep3(initialWaitSeconds * 1e3);
   const deadline = Date.now() + timeoutMinutes * 6e4;
   let lastSummary = "";
   while (Date.now() < deadline) {
     const rows = fetchChecks(prNumber, ctx.cwd);
     if (rows === null) {
-      await sleep2(pollSeconds * 1e3);
+      await sleep3(pollSeconds * 1e3);
       continue;
     }
     if (rows.length === 0) {
-      await sleep2(pollSeconds * 1e3);
+      await sleep3(pollSeconds * 1e3);
       continue;
     }
     const summary = summarize(rows);
@@ -9246,7 +9511,7 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
       tryPostPr7(prNumber, `\u2705 kody waitForCi: all ${rows.length} checks green on PR #${prNumber}`, ctx.cwd);
       return;
     }
-    await sleep2(pollSeconds * 1e3);
+    await sleep3(pollSeconds * 1e3);
   }
   ctx.data.action = mkAction("CI_TIMEOUT", {
     reason: `CI did not complete within ${timeoutMinutes} minutes`,
@@ -9298,12 +9563,12 @@ function tryPostPr7(prNumber, body, cwd) {
   } catch {
   }
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((res) => setTimeout(res, ms));
 }
 
 // src/scripts/warmupMcp.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 var PER_SERVER_TIMEOUT_MS = 6e4;
 var PER_REQUEST_TIMEOUT_MS = 2e4;
 var warmupMcp = async (_ctx, profile) => {
@@ -9325,7 +9590,7 @@ var warmupMcp = async (_ctx, profile) => {
   }
 };
 async function warmupOne(command, args, env) {
-  const child = spawn4(command, args, {
+  const child = spawn5(command, args, {
     stdio: ["pipe", "pipe", "pipe"],
     env: env ? { ...process.env, ...env } : process.env
   });
@@ -9565,6 +9830,7 @@ var preflightScripts = {
   buildSyntheticPlugin,
   resolveArtifacts,
   discoverQaContext,
+  startLocalServer,
   resolvePreviewUrl,
   resolveQaUrl,
   composePrompt,
@@ -10087,7 +10353,7 @@ async function runShellEntry(entry, ctx, profile) {
     env[`KODY_CFG_${k}`] = v;
   }
   const timeoutMs = resolveShellTimeoutMs(entry);
-  const child = spawn5("bash", [shellPath, ...positional], {
+  const child = spawn6("bash", [shellPath, ...positional], {
     cwd: ctx.cwd,
     env,
     stdio: ["pipe", "pipe", "pipe"],
@@ -10190,6 +10456,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;
@@ -10271,7 +10563,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,
@@ -10437,6 +10732,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:
@@ -10520,7 +10816,7 @@ function resolveAuthToken(env = process.env) {
   if (token && !env.GH_TOKEN) env.GH_TOKEN = token;
   return token;
 }
-function detectPackageManager2(cwd) {
+function detectPackageManager3(cwd) {
   if (fs32.existsSync(path30.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
   if (fs32.existsSync(path30.join(cwd, "yarn.lock"))) return "yarn";
   if (fs32.existsSync(path30.join(cwd, "bun.lockb"))) return "bun";
@@ -10722,7 +11018,7 @@ ${CI_HELP}`);
 `);
     resolveAuthToken();
     reactToTriggerComment(cwd);
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager3(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     if (!args.skipInstall) {
@@ -10794,7 +11090,7 @@ async function runScheduledFanOut(cwd, args, opts) {
     if (n > 0) process.stdout.write(`\u2192 kody: unpacked ${n} secret(s) from ALL_SECRETS
 `);
     resolveAuthToken();
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager3(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     if (!args.skipInstall) {