@magnusekdahl/parallix 1.2.1 → 1.3.0

package/lib/review/review-prompts.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Assemble review and act-on-review prompts for the autonomous review loop.
  * Owned by the Node workflow harness (ADR 0037 / task-089).
@@ -6,61 +7,78 @@
  * (same pattern as active.js / draft.js). Full verbose prompts are kept
  * for --dry-run diagnostics and human/manual invocation.
  */
-
-const fs = require('fs');
-const path = require('path');
-const { getMissionYear, getPrimaryBranch, missionPathForSlug } = require('../core/mission-utils');
-const { resolveArtifactDir } = require('./review-artifacts');
-
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_ENTRYPOINTS = void 0;
+exports.reviewEntrypoint = reviewEntrypoint;
+exports.actOnReviewEntrypoint = actOnReviewEntrypoint;
+exports.buildReviewPrompt = buildReviewPrompt;
+exports.buildActOnReviewPrompt = buildActOnReviewPrompt;
+exports.buildCompactReviewPrompt = buildCompactReviewPrompt;
+exports.buildCompactActOnReviewPrompt = buildCompactActOnReviewPrompt;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const mission_utils_js_1 = require("../core/mission-utils.js");
+const review_artifacts_js_1 = require("./review-artifacts.js");
 const REVIEW_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'review.md');
 const ACT_ON_REVIEW_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'act-on-review.md');
 const REVIEW_VERBOSE_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'review-verbose.md');
 const ACT_ON_REVIEW_VERBOSE_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'act-on-review-verbose.md');
-
-/**
- * Slash-command / entrypoint used to invoke the review skill for each agent family.
- * Moved from scripts/autonomous-review.sh prompt_entrypoint_for() into Node.
- */
-/**
- * @typedef {{review: string, actOnReview: string}} PromptEntry
- * @typedef {{codex: PromptEntry, claude: PromptEntry, mistral: PromptEntry, custom: PromptEntry, autonomous: PromptEntry}} PromptEntrypoints
- */
-
-/** @type {PromptEntrypoints} */
-const PROMPT_ENTRYPOINTS = {
-  codex:  { review: '$review all',                           actOnReview: '$act-on-review' },
-  claude: { review: '/review all',                           actOnReview: '/act-on-review' },
-  mistral: { review: '$review all',                           actOnReview: '$act-on-review' },
-  custom: { review: '$review all',                           actOnReview: '$act-on-review' },
-  autonomous: { review: '$review all',                       actOnReview: '$act-on-review' }
+exports.PROMPT_ENTRYPOINTS = {
+    codex: { review: '$review all', actOnReview: '$act-on-review' },
+    claude: { review: '/review all', actOnReview: '/act-on-review' },
+    mistral: { review: '$review all', actOnReview: '/act-on-review' },
+    custom: { review: '$review all', actOnReview: '/act-on-review' },
+    autonomous: { review: '$review all', actOnReview: '/act-on-review' }
 };
-
 /** @param {string} agent */
 function reviewEntrypoint(agent) {
-  const entry = /** @type {PromptEntry} */ (/** @type {{[key: string]: PromptEntry}} */ (PROMPT_ENTRYPOINTS)[agent]);
-  if (!entry) {throw new Error(`Unknown agent family for review entrypoint: ${agent}`);}
-  return entry.review;
+    const entry = exports.PROMPT_ENTRYPOINTS[agent];
+    if (!entry) {
+        throw new Error(`Unknown agent family for review entrypoint: ${agent}`);
+    }
+    return entry.review;
 }
-
 /** @param {string} agent */
 function actOnReviewEntrypoint(agent) {
-  const entry = /** @type {PromptEntry} */ (/** @type {{[key: string]: PromptEntry}} */ (PROMPT_ENTRYPOINTS)[agent]);
-  if (!entry) {throw new Error(`Unknown agent family for act-on-review entrypoint: ${agent}`);}
-  return entry.actOnReview;
+    const entry = exports.PROMPT_ENTRYPOINTS[agent];
+    if (!entry) {
+        throw new Error(`Unknown agent family for act-on-review entrypoint: ${agent}`);
+    }
+    return entry.actOnReview;
 }
-
-/**
- * Build the prompt sent to the reviewer agent for a given round.
- *
- * @param {object} opts
- * @param {string} opts.reviewer      - Reviewer agent family (codex|claude)
- * @param {string} opts.branch        - Mission branch name (e.g. 'mission/task-089')
- * @param {string} opts.implementer   - Implementer agent family
- * @param {string} opts.focus         - Review focus (default: 'all')
- * @param {number} opts.attempt       - Round number (1-based)
- * @param {string} [opts.repoRoot]    - Absolute repo root path
- * @returns {string}
- */
 /**
  * @param {string} slug
  * @param {string} [repoRoot]
@@ -68,176 +86,123 @@ function actOnReviewEntrypoint(agent) {
  * @returns {string}
  */
 function resolveMissionPath(slug, repoRoot, missionPathOverride) {
-  // `--mission <path>` override: when the caller points the review loop at a
-  // mission contract in a non-standard location, agents must read that file
-  // instead of the slug-derived standard path (task-1272 SC7).
-  if (missionPathOverride) {return missionPathOverride;}
-  const root = repoRoot || process.cwd();
-  try {
-    return missionPathForSlug(root, slug);
-  } catch (_) {
-    const year = getMissionYear(slug, root);
-    return path.join(root, 'docs', 'missions', String(year), slug, 'MISSION.md');
-  }
+    if (missionPathOverride) {
+        return missionPathOverride;
+    }
+    const root = repoRoot || process.cwd();
+    try {
+        return (0, mission_utils_js_1.missionPathForSlug)(root, slug);
+    }
+    catch {
+        const year = (0, mission_utils_js_1.getMissionYear)(slug, root);
+        return path.join(root, 'docs', 'missions', String(year), slug, 'MISSION.md');
+    }
 }
-
 /** @param {string} [repoRoot] */
 function resolvePrimaryBranch(repoRoot) {
-  try {
-    return getPrimaryBranch(repoRoot || process.cwd());
-  } catch (_) {
-    return 'main';
-  }
+    try {
+        return (0, mission_utils_js_1.getPrimaryBranch)(repoRoot || process.cwd());
+    }
+    catch {
+        return 'main';
+    }
 }
-
 /**
  * @param {{reviewer: string, branch: string, implementer: string, focus?: string, attempt: number, repoRoot?: string, missionPath?: string}} opts
  * @returns {string}
  */
 function buildReviewPrompt({ reviewer, branch, implementer, focus = 'all', attempt, repoRoot = '', missionPath: missionPathOverride }) {
-  const entrypoint = reviewEntrypoint(reviewer);
-  const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
-  const slug = branch.replace(/^mission\//, '');
-  const year = getMissionYear(slug, repoRoot || process.cwd());
-  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
-  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
-
-  const template = fs.readFileSync(REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
-  return template
-    .replaceAll('{{branch}}',           branch)
-    .replaceAll('{{reviewer}}',         reviewer)
-    .replaceAll('{{implementer}}',      implementer)
-    .replaceAll('{{focus}}',            focus)
-    .replaceAll('{{attempt}}',          String(attempt))
-    .replaceAll('{{slug}}',             slug)
-    .replaceAll('{{missionPath}}',      missionPath)
-    .replaceAll('{{artifactDir}}',      artifactDir)
-    .replaceAll('{{primaryBranch}}',    resolvePrimaryBranch(repoRoot))
-    .replaceAll('{{review_entrypoint}}', entrypoint)
-    .replaceAll('YYYY',                year)
-    .replaceAll('{{repo_line}}',        repoLine ? repoLine.trim() + '\n- ' : '');
+    const entrypoint = reviewEntrypoint(reviewer);
+    const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
+    const slug = branch.replace(/^mission\//, '');
+    const year = (0, mission_utils_js_1.getMissionYear)(slug, repoRoot || process.cwd());
+    const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+    const artifactDir = (0, review_artifacts_js_1.resolveArtifactDir)(repoRoot || process.cwd());
+    const template = fs.readFileSync(REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
+    return template
+        .replaceAll('{{branch}}', branch)
+        .replaceAll('{{reviewer}}', reviewer)
+        .replaceAll('{{implementer}}', implementer)
+        .replaceAll('{{focus}}', focus)
+        .replaceAll('{{attempt}}', String(attempt))
+        .replaceAll('{{slug}}', slug)
+        .replaceAll('{{missionPath}}', missionPath)
+        .replaceAll('{{artifactDir}}', artifactDir)
+        .replaceAll('{{primaryBranch}}', resolvePrimaryBranch(repoRoot))
+        .replaceAll('{{review_entrypoint}}', entrypoint)
+        .replaceAll('YYYY', year)
+        .replaceAll('{{repo_line}}', repoLine ? repoLine.trim() + '\n- ' : '');
 }
-
-/**
- * Build the prompt sent back to the implementer agent after a review round.
- *
- * @param {object} opts
- * @param {string} opts.implementer   - Implementer agent family
- * @param {string} opts.branch        - Mission branch name
- * @param {number} opts.attempt       - Round number (1-based)
- * @param {string} [opts.repoRoot]    - Absolute repo root path
- * @returns {string}
- */
 /**
  * @param {{implementer: string, branch: string, attempt: number, repoRoot?: string, missionPath?: string}} opts
  * @returns {string}
  */
 function buildActOnReviewPrompt({ implementer, branch, attempt, repoRoot = '', missionPath: missionPathOverride }) {
-  const entrypoint = actOnReviewEntrypoint(implementer);
-  const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
-  const slug = branch.replace(/^mission\//, '');
-  const year = getMissionYear(slug, repoRoot || process.cwd());
-  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
-  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
-
-  const template = fs.readFileSync(ACT_ON_REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
-  return template
-    .replaceAll('{{branch}}',                  branch)
-    .replaceAll('{{implementer}}',             implementer)
-    .replaceAll('{{attempt}}',                 String(attempt))
-    .replaceAll('{{slug}}',                    slug)
-    .replaceAll('{{missionPath}}',             missionPath)
-    .replaceAll('{{artifactDir}}',             artifactDir)
-    .replaceAll('{{primaryBranch}}',           resolvePrimaryBranch(repoRoot))
-    .replaceAll('{{act_on_review_entrypoint}}', entrypoint)
-    .replaceAll('YYYY',                       year)
-    .replaceAll('{{repo_line}}',               repoLine ? repoLine.trim() + '\n- ' : '');
+    const entrypoint = actOnReviewEntrypoint(implementer);
+    const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
+    const slug = branch.replace(/^mission\//, '');
+    const year = (0, mission_utils_js_1.getMissionYear)(slug, repoRoot || process.cwd());
+    const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+    const artifactDir = (0, review_artifacts_js_1.resolveArtifactDir)(repoRoot || process.cwd());
+    const template = fs.readFileSync(ACT_ON_REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
+    return template
+        .replaceAll('{{branch}}', branch)
+        .replaceAll('{{implementer}}', implementer)
+        .replaceAll('{{attempt}}', String(attempt))
+        .replaceAll('{{slug}}', slug)
+        .replaceAll('{{missionPath}}', missionPath)
+        .replaceAll('{{artifactDir}}', artifactDir)
+        .replaceAll('{{primaryBranch}}', resolvePrimaryBranch(repoRoot))
+        .replaceAll('{{act_on_review_entrypoint}}', entrypoint)
+        .replaceAll('YYYY', year)
+        .replaceAll('{{repo_line}}', repoLine ? repoLine.trim() + '\n- ' : '');
 }
-
-
-/**
- * Node-invoked reviewer prompt built from parallix/prompts/review.md template.
- * Uses the same template-substitution pattern as active.js (execute.md).
- *
- * @param {object} opts
- * @param {string} opts.reviewer      - Reviewer agent family
- * @param {string} opts.branch        - Mission branch name
- * @param {string} opts.implementer   - Implementer agent family
- * @param {string} opts.focus         - Review focus (default: 'all')
- * @param {number} opts.attempt       - Round number (1-based)
- * @param {string} [opts.repoRoot]    - Absolute repo root path (unused but kept for API symmetry)
- * @param {string} [opts.actualReviewer] - The actual agent family launched (overrides reviewer for identity text, TASK-1051)
- * @returns {string}
- */
 /**
  * @param {{reviewer: string, branch: string, implementer: string, focus?: string, attempt: number, actualReviewer?: string, repoRoot?: string, missionPath?: string}} opts
  * @returns {string}
  */
 function buildCompactReviewPrompt({ reviewer, branch, implementer, focus = 'all', attempt, actualReviewer, repoRoot = '', missionPath: missionPathOverride }) {
-  const slug = branch.replace(/^mission\//, '');
-  const finalReviewer = actualReviewer || reviewer;
-  const year = getMissionYear(slug, repoRoot || process.cwd());
-  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
-  const primaryBranch = resolvePrimaryBranch(repoRoot);
-  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
-  const template = fs.readFileSync(REVIEW_PROMPT_PATH, 'utf8');
-  return template
-    .replaceAll('{{branch}}',           branch)
-    .replaceAll('{{reviewer}}',         finalReviewer)
-    .replaceAll('{{implementer}}',      implementer)
-    .replaceAll('{{focus}}',            focus)
-    .replaceAll('{{attempt}}',          String(attempt))
-    .replaceAll('{{slug}}',             slug)
-    .replaceAll('{{missionPath}}',      missionPath)
-    .replaceAll('{{artifactDir}}',      artifactDir)
-    .replaceAll('{{primaryBranch}}',    primaryBranch)
-    .replaceAll('YYYY',                year)
-    .replaceAll('{{review_entrypoint}}', reviewEntrypoint(finalReviewer));
+    const slug = branch.replace(/^mission\//, '');
+    const finalReviewer = actualReviewer || reviewer;
+    const year = (0, mission_utils_js_1.getMissionYear)(slug, repoRoot || process.cwd());
+    const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+    const primaryBranch = resolvePrimaryBranch(repoRoot);
+    const artifactDir = (0, review_artifacts_js_1.resolveArtifactDir)(repoRoot || process.cwd());
+    const template = fs.readFileSync(REVIEW_PROMPT_PATH, 'utf8');
+    return template
+        .replaceAll('{{branch}}', branch)
+        .replaceAll('{{reviewer}}', finalReviewer)
+        .replaceAll('{{implementer}}', implementer)
+        .replaceAll('{{focus}}', focus)
+        .replaceAll('{{attempt}}', String(attempt))
+        .replaceAll('{{slug}}', slug)
+        .replaceAll('{{missionPath}}', missionPath)
+        .replaceAll('{{artifactDir}}', artifactDir)
+        .replaceAll('{{primaryBranch}}', primaryBranch)
+        .replaceAll('YYYY', year)
+        .replaceAll('{{review_entrypoint}}', reviewEntrypoint(finalReviewer));
 }
-
-/**
- * Node-invoked act-on-review prompt built from parallix/prompts/act-on-review.md template.
- *
- * @param {object} opts
- * @param {string} opts.implementer   - Implementer agent family
- * @param {string} opts.branch        - Mission branch name
- * @param {number} opts.attempt       - Round number (1-based)
- * @param {string} [opts.reviewOutcome] - Outcome of latest review (e.g. 'REQUEST_CHANGES')
- * @param {string} [opts.repoRoot]    - Absolute repo root path
- * @param {string} [opts.actualImplementer] - The actual agent family launched (overrides implementer for identity text, TASK-1051)
- * @returns {string}
- */
 /**
  * @param {{implementer: string, branch: string, attempt: number, reviewOutcome?: string, actualImplementer?: string, repoRoot?: string, missionPath?: string}} opts
  * @returns {string}
  */
 function buildCompactActOnReviewPrompt({ implementer, branch, attempt, reviewOutcome = '?', actualImplementer, repoRoot = '', missionPath: missionPathOverride }) {
-  const slug = branch.replace(/^mission\//, '');
-  const finalImplementer = actualImplementer || implementer;
-  const year = getMissionYear(slug, repoRoot || process.cwd());
-  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
-  const primaryBranch = resolvePrimaryBranch(repoRoot);
-  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
-  const template = fs.readFileSync(ACT_ON_REVIEW_PROMPT_PATH, 'utf8');
-  return template
-    .replaceAll('{{branch}}',                  branch)
-    .replaceAll('{{implementer}}',             finalImplementer)
-    .replaceAll('{{attempt}}',                 String(attempt))
-    .replaceAll('{{slug}}',                    slug)
-    .replaceAll('{{missionPath}}',             missionPath)
-    .replaceAll('{{artifactDir}}',             artifactDir)
-    .replaceAll('{{primaryBranch}}',           primaryBranch)
-    .replaceAll('{{review_outcome}}',          reviewOutcome)
-    .replaceAll('YYYY',                       year)
-    .replaceAll('{{act_on_review_entrypoint}}', actOnReviewEntrypoint(finalImplementer));
+    const slug = branch.replace(/^mission\//, '');
+    const finalImplementer = actualImplementer || implementer;
+    const year = (0, mission_utils_js_1.getMissionYear)(slug, repoRoot || process.cwd());
+    const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+    const primaryBranch = resolvePrimaryBranch(repoRoot);
+    const artifactDir = (0, review_artifacts_js_1.resolveArtifactDir)(repoRoot || process.cwd());
+    const template = fs.readFileSync(ACT_ON_REVIEW_PROMPT_PATH, 'utf8');
+    return template
+        .replaceAll('{{branch}}', branch)
+        .replaceAll('{{implementer}}', finalImplementer)
+        .replaceAll('{{attempt}}', String(attempt))
+        .replaceAll('{{slug}}', slug)
+        .replaceAll('{{missionPath}}', missionPath)
+        .replaceAll('{{artifactDir}}', artifactDir)
+        .replaceAll('{{primaryBranch}}', primaryBranch)
+        .replaceAll('{{review_outcome}}', reviewOutcome)
+        .replaceAll('YYYY', year)
+        .replaceAll('{{act_on_review_entrypoint}}', actOnReviewEntrypoint(finalImplementer));
 }
-
-module.exports = {
-  PROMPT_ENTRYPOINTS,
-  reviewEntrypoint,
-  actOnReviewEntrypoint,
-  buildReviewPrompt,
-  buildActOnReviewPrompt,
-  buildCompactReviewPrompt,
-  buildCompactActOnReviewPrompt
-};

package/lib/review/review-prompts.ts

@@ -0,0 +1,182 @@
+/**
+ * Assemble review and act-on-review prompts for the autonomous review loop.
+ * Owned by the Node workflow harness (ADR 0037 / task-089).
+ *
+ * Node-invoked agent prompts read from parallix/prompts/*.md templates
+ * (same pattern as active.js / draft.js). Full verbose prompts are kept
+ * for --dry-run diagnostics and human/manual invocation.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { getMissionYear, getPrimaryBranch, missionPathForSlug } from '../core/mission-utils.js';
+import { resolveArtifactDir } from './review-artifacts.js';
+
+const REVIEW_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'review.md');
+const ACT_ON_REVIEW_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'act-on-review.md');
+const REVIEW_VERBOSE_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'review-verbose.md');
+const ACT_ON_REVIEW_VERBOSE_PROMPT_PATH = path.join(__dirname, '..', '..', 'prompts', 'act-on-review-verbose.md');
+
+type PromptEntry = { review: string; actOnReview: string };
+type PromptEntrypoints = { codex: PromptEntry; claude: PromptEntry; mistral: PromptEntry; custom: PromptEntry; autonomous: PromptEntry };
+
+export const PROMPT_ENTRYPOINTS: PromptEntrypoints = {
+  codex:  { review: '$review all',                           actOnReview: '$act-on-review' },
+  claude: { review: '/review all',                           actOnReview: '/act-on-review' },
+  mistral: { review: '$review all',                           actOnReview: '/act-on-review' },
+  custom: { review: '$review all',                           actOnReview: '/act-on-review' },
+  autonomous: { review: '$review all',                       actOnReview: '/act-on-review' }
+};
+
+/** @param {string} agent */
+export function reviewEntrypoint(agent: string): string {
+  const entry = (PROMPT_ENTRYPOINTS as Record<string, PromptEntry>)[agent];
+  if (!entry) { throw new Error(`Unknown agent family for review entrypoint: ${agent}`); }
+  return entry.review;
+}
+
+/** @param {string} agent */
+export function actOnReviewEntrypoint(agent: string): string {
+  const entry = (PROMPT_ENTRYPOINTS as Record<string, PromptEntry>)[agent];
+  if (!entry) { throw new Error(`Unknown agent family for act-on-review entrypoint: ${agent}`); }
+  return entry.actOnReview;
+}
+
+/**
+ * @param {string} slug
+ * @param {string} [repoRoot]
+ * @param {string} [missionPathOverride]
+ * @returns {string}
+ */
+function resolveMissionPath(slug: string, repoRoot?: string, missionPathOverride?: string): string {
+  if (missionPathOverride) { return missionPathOverride; }
+  const root = repoRoot || process.cwd();
+  try {
+    return missionPathForSlug(root, slug);
+  } catch {
+    const year = getMissionYear(slug, root);
+    return path.join(root, 'docs', 'missions', String(year), slug, 'MISSION.md');
+  }
+}
+
+/** @param {string} [repoRoot] */
+function resolvePrimaryBranch(repoRoot?: string): string {
+  try {
+    return getPrimaryBranch(repoRoot || process.cwd());
+  } catch {
+    return 'main';
+  }
+}
+
+/**
+ * @param {{reviewer: string, branch: string, implementer: string, focus?: string, attempt: number, repoRoot?: string, missionPath?: string}} opts
+ * @returns {string}
+ */
+export function buildReviewPrompt({ reviewer, branch, implementer, focus = 'all', attempt, repoRoot = '', missionPath: missionPathOverride }: {
+  reviewer: string; branch: string; implementer: string; focus?: string; attempt: number; repoRoot?: string; missionPath?: string;
+}): string {
+  const entrypoint = reviewEntrypoint(reviewer);
+  const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
+  const slug = branch.replace(/^mission\//, '');
+  const year = getMissionYear(slug, repoRoot || process.cwd());
+  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
+
+  const template = fs.readFileSync(REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
+  return template
+    .replaceAll('{{branch}}',           branch)
+    .replaceAll('{{reviewer}}',         reviewer)
+    .replaceAll('{{implementer}}',      implementer)
+    .replaceAll('{{focus}}',            focus)
+    .replaceAll('{{attempt}}',          String(attempt))
+    .replaceAll('{{slug}}',             slug)
+    .replaceAll('{{missionPath}}',      missionPath)
+    .replaceAll('{{artifactDir}}',      artifactDir)
+    .replaceAll('{{primaryBranch}}',    resolvePrimaryBranch(repoRoot))
+    .replaceAll('{{review_entrypoint}}', entrypoint)
+    .replaceAll('YYYY',                year)
+    .replaceAll('{{repo_line}}',        repoLine ? repoLine.trim() + '\n- ' : '');
+}
+
+/**
+ * @param {{implementer: string, branch: string, attempt: number, repoRoot?: string, missionPath?: string}} opts
+ * @returns {string}
+ */
+export function buildActOnReviewPrompt({ implementer, branch, attempt, repoRoot = '', missionPath: missionPathOverride }: {
+  implementer: string; branch: string; attempt: number; repoRoot?: string; missionPath?: string;
+}): string {
+  const entrypoint = actOnReviewEntrypoint(implementer);
+  const repoLine = repoRoot ? `\noperate from repo root: ${repoRoot}` : '';
+  const slug = branch.replace(/^mission\//, '');
+  const year = getMissionYear(slug, repoRoot || process.cwd());
+  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
+
+  const template = fs.readFileSync(ACT_ON_REVIEW_VERBOSE_PROMPT_PATH, 'utf8');
+  return template
+    .replaceAll('{{branch}}',                  branch)
+    .replaceAll('{{implementer}}',             implementer)
+    .replaceAll('{{attempt}}',                 String(attempt))
+    .replaceAll('{{slug}}',                    slug)
+    .replaceAll('{{missionPath}}',             missionPath)
+    .replaceAll('{{artifactDir}}',             artifactDir)
+    .replaceAll('{{primaryBranch}}',           resolvePrimaryBranch(repoRoot))
+    .replaceAll('{{act_on_review_entrypoint}}', entrypoint)
+    .replaceAll('YYYY',                       year)
+    .replaceAll('{{repo_line}}',               repoLine ? repoLine.trim() + '\n- ' : '');
+}
+
+/**
+ * @param {{reviewer: string, branch: string, implementer: string, focus?: string, attempt: number, actualReviewer?: string, repoRoot?: string, missionPath?: string}} opts
+ * @returns {string}
+ */
+export function buildCompactReviewPrompt({ reviewer, branch, implementer, focus = 'all', attempt, actualReviewer, repoRoot = '', missionPath: missionPathOverride }: {
+  reviewer: string; branch: string; implementer: string; focus?: string; attempt: number; actualReviewer?: string; repoRoot?: string; missionPath?: string;
+}): string {
+  const slug = branch.replace(/^mission\//, '');
+  const finalReviewer = actualReviewer || reviewer;
+  const year = getMissionYear(slug, repoRoot || process.cwd());
+  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+  const primaryBranch = resolvePrimaryBranch(repoRoot);
+  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
+  const template = fs.readFileSync(REVIEW_PROMPT_PATH, 'utf8');
+  return template
+    .replaceAll('{{branch}}',           branch)
+    .replaceAll('{{reviewer}}',         finalReviewer)
+    .replaceAll('{{implementer}}',      implementer)
+    .replaceAll('{{focus}}',            focus)
+    .replaceAll('{{attempt}}',          String(attempt))
+    .replaceAll('{{slug}}',             slug)
+    .replaceAll('{{missionPath}}',      missionPath)
+    .replaceAll('{{artifactDir}}',      artifactDir)
+    .replaceAll('{{primaryBranch}}',    primaryBranch)
+    .replaceAll('YYYY',                year)
+    .replaceAll('{{review_entrypoint}}', reviewEntrypoint(finalReviewer));
+}
+
+/**
+ * @param {{implementer: string, branch: string, attempt: number, reviewOutcome?: string, actualImplementer?: string, repoRoot?: string, missionPath?: string}} opts
+ * @returns {string}
+ */
+export function buildCompactActOnReviewPrompt({ implementer, branch, attempt, reviewOutcome = '?', actualImplementer, repoRoot = '', missionPath: missionPathOverride }: {
+  implementer: string; branch: string; attempt: number; reviewOutcome?: string; actualImplementer?: string; repoRoot?: string; missionPath?: string;
+}): string {
+  const slug = branch.replace(/^mission\//, '');
+  const finalImplementer = actualImplementer || implementer;
+  const year = getMissionYear(slug, repoRoot || process.cwd());
+  const missionPath = resolveMissionPath(slug, repoRoot, missionPathOverride);
+  const primaryBranch = resolvePrimaryBranch(repoRoot);
+  const artifactDir = resolveArtifactDir(repoRoot || process.cwd());
+  const template = fs.readFileSync(ACT_ON_REVIEW_PROMPT_PATH, 'utf8');
+  return template
+    .replaceAll('{{branch}}',                  branch)
+    .replaceAll('{{implementer}}',             finalImplementer)
+    .replaceAll('{{attempt}}',                 String(attempt))
+    .replaceAll('{{slug}}',                    slug)
+    .replaceAll('{{missionPath}}',             missionPath)
+    .replaceAll('{{artifactDir}}',             artifactDir)
+    .replaceAll('{{primaryBranch}}',           primaryBranch)
+    .replaceAll('{{review_outcome}}',          reviewOutcome)
+    .replaceAll('YYYY',                       year)
+    .replaceAll('{{act_on_review_entrypoint}}', actOnReviewEntrypoint(finalImplementer));
+}