@basou/core 0.29.0 → 0.31.0

package/dist/index.js

@@ -1,5 +1,14 @@
-// src/adapters/claude-code/claude-code-adapter.ts
+// src/adapters/command-lookup.ts
 import { spawn } from "child_process";
+async function isOnPath(command) {
+  return new Promise((resolve3) => {
+    const child = spawn("which", [command], { stdio: "ignore" });
+    child.on("error", () => resolve3(false));
+    child.on("exit", (code) => resolve3(code === 0));
+  });
+}
+
+// src/adapters/claude-code/claude-code-adapter.ts
 var claudeCodeAdapterMetadata = {
   kind: "claude-code-adapter",
   version: "0.1.0"
@@ -10,13 +19,6 @@ async function resolveClaudeCodeCommand(lookup = isOnPath) {
   }
   throw new Error("Claude Code CLI not found in PATH. Install claude-code (or claude) first.");
 }
-async function isOnPath(command) {
-  return new Promise((resolve3) => {
-    const child = spawn("which", [command], { stdio: "ignore" });
-    child.on("error", () => resolve3(false));
-    child.on("exit", (code) => resolve3(code === 0));
-  });
-}
 function summarizeAdapterOutput(_stream, _raw) {
   throw new Error("adapter_output summary is not implemented in this release");
 }
@@ -33,6 +35,7 @@ function shellQuote(value) {
 function buildStopHookCommand(options) {
   const flags = [];
   if (options.block === true) flags.push("--block");
+  if (options.requireReview === true) flags.push("--require-review");
   if (options.minEdits !== void 0) flags.push(`--min-edits ${options.minEdits}`);
   const suffix = flags.length > 0 ? ` ${flags.join(" ")}` : "";
   return `node ${shellQuote(options.cliEntry)} hook stop${suffix} 2>/dev/null || true`;
@@ -218,6 +221,14 @@ var CAPTURE_VERB = /(?:decision\s+(?:capture|record)|note)\b/;
 var CAPTURE_COMMAND_PATTERN = new RegExp(
   `(?:^|[\\n;&|(])\\s*${CAPTURE_INVOCATION.source}\\s+${CAPTURE_VERB.source}`
 );
+var SHIP_ACT_PATTERN = /(?:^|[\n;&|(])\s*(?:git\s+push|git\s+merge|gh\s+pr\s+(?:create|merge))(?![-\w])/;
+var DRY_RUN_PUSH_PATTERN = /(?:^|[\n;&|(])\s*git\s+push\b[^\n;&|()]*?\s-(?:-dry-run|n)\b/;
+function isShipAct(command) {
+  return SHIP_ACT_PATTERN.test(command) && !DRY_RUN_PUSH_PATTERN.test(command);
+}
+var REVIEW_RECORD_PATTERN = new RegExp(
+  `(?:^|[\\n;&|(])\\s*${CAPTURE_INVOCATION.source}\\s+review\\s+record\\b`
+);
 var FILE_EDIT_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "NotebookEdit"]);
 function evaluateStopHook(input) {
   const minEdits = input.minEdits ?? DEFAULT_STOP_HOOK_MIN_EDITS;
@@ -225,6 +236,7 @@ function evaluateStopHook(input) {
     return {
       kind: "silent",
       reason: "stop_hook_active",
+      review: { fires: false, reason: "stop_hook_active" },
       commandCount: 0,
       fileCount: 0,
       decisionPointCount: 0
@@ -233,6 +245,8 @@ function evaluateStopHook(input) {
   let commandCount = 0;
   let fileCount = 0;
   let captured = false;
+  let shipped = false;
+  let reviewed = false;
   for (const record of input.records) {
     if (readString2(record.type) !== "assistant") continue;
     for (const tool of toolUsesOf2(record)) {
@@ -242,7 +256,11 @@ function evaluateStopHook(input) {
         commandCount += 1;
         const toolInput = isObject2(tool.input) ? tool.input : void 0;
         const command = toolInput !== void 0 ? readString2(toolInput.command) : void 0;
-        if (command !== void 0 && CAPTURE_COMMAND_PATTERN.test(command)) captured = true;
+        if (command !== void 0) {
+          if (CAPTURE_COMMAND_PATTERN.test(command)) captured = true;
+          if (isShipAct(command)) shipped = true;
+          if (REVIEW_RECORD_PATTERN.test(command)) reviewed = true;
+        }
       } else if (FILE_EDIT_TOOLS.has(name)) {
         fileCount += 1;
       }
@@ -250,14 +268,21 @@ function evaluateStopHook(input) {
   }
   const decisionPointCount = countUncapturedDecisionPoints(input.records);
   const counts = { commandCount, fileCount, decisionPointCount };
+  const review = evaluateReviewGate({ shipped, reviewed, fileCount, minEdits });
   if (captured) {
-    return { kind: "silent", reason: "already_captured", ...counts };
+    return { kind: "silent", reason: "already_captured", review, ...counts };
   }
   const substantive = fileCount >= minEdits || decisionPointCount > 0;
   if (!substantive) {
-    return { kind: "silent", reason: "not_substantive", ...counts };
+    return { kind: "silent", reason: "not_substantive", review, ...counts };
   }
-  return { kind: "nudge", additionalContext: renderNudge(counts), ...counts };
+  return { kind: "nudge", additionalContext: renderNudge(counts), review, ...counts };
+}
+function evaluateReviewGate(input) {
+  if (!input.shipped) return { fires: false, reason: "no_ship_act" };
+  if (input.fileCount < input.minEdits) return { fires: false, reason: "not_substantive_code" };
+  if (input.reviewed) return { fires: false, reason: "already_reviewed" };
+  return { fires: true, additionalContext: renderReviewNudge() };
 }
 function renderNudge(counts) {
   const did = [];
@@ -280,6 +305,14 @@ function renderNudge(counts) {
     "If nothing is worth capturing, just stop \u2014 do not invent decisions."
   ].join("\n");
 }
+function renderReviewNudge() {
+  return [
+    "This session shipped code (a push / PR / merge) after substantive edits but recorded no review.",
+    "An adversarial / second-opinion review before shipping is the discipline here. If a review ran, record it now so it lands on the durable trail:",
+    '  - run `basou review record` and pipe a JSON object: { "reviewer": "...", "target": "...", with optional "verdict" / "findings" / "blocked" } (an explicit "blocked": [] records that you blocked nothing).',
+    "If no review ran, that is the gap this is meant to catch \u2014 review before relying on this. If a review genuinely was not warranted, just stop \u2014 do not fabricate a review record."
+  ].join("\n");
+}
 function readString2(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
@@ -606,6 +639,16 @@ function toolUses(record) {
   return result;
 }
 
+// src/adapters/codex/codex-adapter.ts
+var codexAdapterMetadata = {
+  kind: "codex-adapter",
+  version: "0.1.0"
+};
+async function resolveCodexCommand(lookup = isOnPath) {
+  if (await lookup("codex")) return { command: "codex" };
+  throw new Error("Codex CLI not found in PATH. Install codex first.");
+}
+
 // src/adapters/codex/rollout-importer.ts
 var CODEX_IMPORT_SOURCE = "codex-import";
 function codexRolloutToImportPayload(records, options) {
@@ -867,7 +910,10 @@ import { z as z2 } from "zod";
 
 // src/schemas/shared.schema.ts
 import { z } from "zod";
-var SchemaVersionSchema = z.literal("0.1.0");
+var SchemaVersionSchema = z.string().regex(/^0\.\d+\.\d+$/, {
+  message: "unsupported .basou format version: this basou reads format major 0 (0.x.y). If this workspace was written by a newer basou, upgrade basou to open it."
+});
+var CacheVersionSchema = z.literal("0.1.0");
 var IsoTimestampSchema = z.string().datetime({ offset: true });
 var createPrefixedIdSchema = (prefix) => {
   const refiner = (value) => isValidPrefixedId(value) && value.startsWith(`${prefix}_`);
@@ -887,14 +933,14 @@ var EventSourceSchema = z.string().min(1);
 
 // src/schemas/approval.schema.ts
 var ApprovalStatusSchema = z2.enum(["pending", "approved", "rejected", "expired"]);
-var ApprovalSchema = z2.object({
+var ApprovalSchema = z2.looseObject({
   schema_version: SchemaVersionSchema,
   id: ApprovalIdSchema,
   session_id: SessionIdSchema,
   created_at: IsoTimestampSchema,
   status: ApprovalStatusSchema,
   risk_level: RiskLevelSchema,
-  action: z2.object({ kind: z2.string() }).passthrough(),
+  action: z2.looseObject({ kind: z2.string() }).passthrough(),
   reason: z2.string(),
   expires_at: IsoTimestampSchema.nullable().default(null),
   // The four fields below are null while `status === "pending"` and set
@@ -1196,6 +1242,25 @@ var NoteAddedEventSchema = BaseEventSchema.extend({
   // surface. Optional so pre-existing note_added events remain valid.
   kind: z3.enum(["note", "next_step"]).optional()
 });
+var ReviewFindingSchema = z3.object({
+  title: z3.string().min(1),
+  severity: z3.enum(["high", "medium", "low"]).optional(),
+  location: z3.string().min(1).optional(),
+  summary: z3.string().min(1).optional()
+});
+var ReviewBlockedSchema = z3.object({
+  title: z3.string().min(1),
+  reason: z3.enum(["spec-deviation", "design-reversal"]),
+  why: z3.string().min(1).optional()
+});
+var ReviewRecordedEventSchema = BaseEventSchema.extend({
+  type: z3.literal("review_recorded"),
+  reviewer: z3.string().min(1),
+  target: z3.string().min(1),
+  verdict: z3.enum(["pass", "needs-attention", "fail"]).optional(),
+  findings: z3.array(ReviewFindingSchema).optional(),
+  blocked: z3.array(ReviewBlockedSchema).optional()
+});
 var AdapterOutputEventSchema = BaseEventSchema.extend({
   type: z3.literal("adapter_output"),
   stream: z3.enum(["stdout", "stderr"]),
@@ -1223,6 +1288,7 @@ var EventSchema = z3.discriminatedUnion("type", [
   TaskDeletedEventSchema,
   TaskArchivedEventSchema,
   NoteAddedEventSchema,
+  ReviewRecordedEventSchema,
   AdapterOutputEventSchema
 ]);
 
@@ -1521,12 +1587,13 @@ var SessionStatusSchema = z4.enum([
 var SessionSourceKindSchema = z4.enum([
   "claude-code-adapter",
   "claude-code-import",
+  "codex-adapter",
   "codex-import",
   "human",
   "import",
   "terminal"
 ]);
-var SessionSourceSchema = z4.object({
+var SessionSourceSchema = z4.looseObject({
   kind: SessionSourceKindSchema,
   version: z4.literal("0.1.0"),
   // Optional id of the originating session in the SOURCE tool's own
@@ -1542,20 +1609,20 @@ var SessionSourceSchema = z4.object({
   // fresh import or `--force`).
   source_size_bytes: z4.number().int().nonnegative().optional()
 });
-var InvocationSchema = z4.object({
+var InvocationSchema = z4.looseObject({
   command: z4.string().min(1),
   args: z4.array(z4.string()).default([]),
   // Nullable to record signal-terminated runs where the child has no exit
   // code; the same nullability is mirrored in CommandExecutedEventSchema.
   exit_code: z4.number().int().nullable()
 });
-var SessionMetricsSchema = z4.object({
+var SessionMetricsSchema = z4.looseObject({
   output_tokens: z4.number().int().nonnegative().optional(),
   input_tokens: z4.number().int().nonnegative().optional(),
   cached_input_tokens: z4.number().int().nonnegative().optional(),
   reasoning_output_tokens: z4.number().int().nonnegative().optional(),
   active_time_ms: z4.number().int().nonnegative().optional(),
-  active_intervals: z4.array(z4.object({ start: IsoTimestampSchema, end: IsoTimestampSchema })).optional(),
+  active_intervals: z4.array(z4.looseObject({ start: IsoTimestampSchema, end: IsoTimestampSchema })).optional(),
   active_gap_cap_ms: z4.number().int().nonnegative().optional(),
   active_time_method: z4.string().optional(),
   machine_active_time_ms: z4.number().int().nonnegative().optional()
@@ -1564,7 +1631,7 @@ var SessionIntegritySchema = z4.object({
   head_hash: z4.string(),
   event_count: z4.number().int().nonnegative()
 }).strict();
-var SessionInnerSchema = z4.object({
+var SessionInnerSchema = z4.looseObject({
   id: SessionIdSchema,
   label: z4.string().optional(),
   task_id: TaskIdSchema.nullable().optional(),
@@ -1582,7 +1649,7 @@ var SessionInnerSchema = z4.object({
   metrics: SessionMetricsSchema.optional(),
   integrity: SessionIntegritySchema.optional()
 });
-var SessionSchema = z4.object({
+var SessionSchema = z4.looseObject({
   schema_version: SchemaVersionSchema,
   session: SessionInnerSchema
 });
@@ -2082,12 +2149,16 @@ import * as fsp from "fs/promises";
 // src/schemas/status.schema.ts
 import { z as z5 } from "zod";
 var StatusSchema = z5.object({
-  schema_version: SchemaVersionSchema,
+  // status.json is a rebuildable cache: exact-match-or-rebuild, not the
+  // durable forward-compat gate.
+  schema_version: CacheVersionSchema,
   generated_at: IsoTimestampSchema,
   workspace: z5.object({
     id: WorkspaceIdSchema,
     name: z5.string().min(1),
-    basou_version: z5.literal("0.1.0")
+    // Mirrors the manifest's basou_version, so it uses the same
+    // forward-compatible format gate (accept 0.x.y) rather than a literal.
+    basou_version: SchemaVersionSchema
   }).strict(),
   directories_present: z5.object({
     sessions: z5.boolean(),
@@ -2447,7 +2518,7 @@ import { z as z8 } from "zod";
 // src/schemas/task.schema.ts
 import { z as z6 } from "zod";
 var TaskStatusSchema = z6.enum(["planned", "in_progress", "done", "cancelled"]);
-var TaskInnerSchema = z6.object({
+var TaskInnerSchema = z6.looseObject({
   id: TaskIdSchema,
   title: z6.string().min(1),
   label: z6.string().min(1).optional(),
@@ -2476,7 +2547,7 @@ var TaskInnerSchema = z6.object({
    */
   linked_sessions: z6.array(SessionIdSchema).default([])
 });
-var TaskSchema = z6.object({
+var TaskSchema = z6.looseObject({
   schema_version: SchemaVersionSchema,
   task: TaskInnerSchema
 });
@@ -2726,7 +2797,8 @@ var TaskIndexEntrySchema = z7.object({
   updated_at: IsoTimestampSchema
 }).strict();
 var TaskIndexSchema = z7.object({
-  schema_version: SchemaVersionSchema,
+  // Rebuildable cache: exact-match-or-rebuild, not the durable forward-compat gate.
+  schema_version: CacheVersionSchema,
   tasks: z7.array(TaskIndexEntrySchema),
   last_rebuilt_at: IsoTimestampSchema
 }).strict();
@@ -4664,8 +4736,7 @@ import { lstat as lstat3 } from "fs/promises";
 import { z as z9 } from "zod";
 var ProjectSchema = z9.looseObject({
   name: z9.string().optional(),
-  description: z9.string().optional(),
-  repository_url: z9.string().nullable().optional()
+  description: z9.string().optional()
 });
 var CapabilitiesSchema = z9.looseObject({
   enabled: z9.array(z9.string())
@@ -4723,7 +4794,11 @@ var WorkspaceMetaSchema = z9.looseObject({
 });
 var ManifestSchema = z9.looseObject({
   schema_version: SchemaVersionSchema,
-  basou_version: z9.literal("0.1.0"),
+  // Same forward-compatible format gate as schema_version (accept 0.x.y, gate a
+  // higher major with an upgrade error) rather than a hard literal. `basou_version`
+  // is a format stamp, not the npm/product version; consolidating it with
+  // schema_version is a candidate cleanup for the M4 freeze pass.
+  basou_version: SchemaVersionSchema,
   workspace: WorkspaceMetaSchema,
   project: ProjectSchema,
   capabilities: CapabilitiesSchema,
@@ -4747,8 +4822,7 @@ function createManifest(input) {
   const workspaceId = input.workspaceId ?? prefixedUlid("ws");
   const project = {
     ...input.projectName !== void 0 ? { name: input.projectName } : {},
-    ...input.projectDescription !== void 0 ? { description: input.projectDescription } : {},
-    ...input.repositoryUrl !== void 0 ? { repository_url: input.repositoryUrl } : {}
+    ...input.projectDescription !== void 0 ? { description: input.projectDescription } : {}
   };
   const manifest = {
     schema_version: "0.1.0",
@@ -4778,6 +4852,7 @@ function createManifest(input) {
 async function writeManifest(paths, manifest, options) {
   const force = options?.force === true;
   const validated = ManifestSchema.parse(manifest);
+  delete validated.project.repository_url;
   if (!force) {
     let existed = false;
     try {
@@ -6867,6 +6942,159 @@ async function findReviewGaps(input) {
   };
 }
 
+// src/review/review-record.ts
+var VALID_VERDICTS = /* @__PURE__ */ new Set(["pass", "needs-attention", "fail"]);
+var VALID_SEVERITIES = /* @__PURE__ */ new Set(["high", "medium", "low"]);
+var VALID_BLOCK_REASONS = /* @__PURE__ */ new Set(["spec-deviation", "design-reversal"]);
+var ALLOWED_KEYS = /* @__PURE__ */ new Set([
+  "reviewer",
+  "target",
+  "verdict",
+  "findings",
+  "blocked"
+]);
+var ALLOWED_FINDING_KEYS = /* @__PURE__ */ new Set([
+  "title",
+  "severity",
+  "location",
+  "summary"
+]);
+var ALLOWED_BLOCKED_KEYS = /* @__PURE__ */ new Set(["title", "reason", "why"]);
+var REVIEW_RECORD_NO_INPUT_HINT = "No input: pipe a JSON object describing the review to stdin or pass --file <path>.";
+function parseReviewRecordInput(raw) {
+  if (raw.trim().length === 0) {
+    throw new Error(REVIEW_RECORD_NO_INPUT_HINT);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`Input is not valid JSON: ${detail}`);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("Input must be a single JSON object describing one review.");
+  }
+  const obj = parsed;
+  for (const key of Object.keys(obj)) {
+    if (!ALLOWED_KEYS.has(key)) {
+      throw new Error(
+        `Unknown field '${key}'. Allowed: reviewer, target, verdict, findings, blocked.`
+      );
+    }
+  }
+  const reviewer = requireNonEmptyString(obj.reviewer, "reviewer");
+  const target = requireNonEmptyString(obj.target, "target");
+  const out = { reviewer, target };
+  if (obj.verdict !== void 0) {
+    if (typeof obj.verdict !== "string" || !VALID_VERDICTS.has(obj.verdict)) {
+      throw new Error(`verdict must be one of pass, needs-attention, fail, got '${obj.verdict}'.`);
+    }
+    out.verdict = obj.verdict;
+  }
+  if (obj.findings !== void 0) {
+    out.findings = parseFindings(obj.findings);
+  }
+  if (obj.blocked !== void 0) {
+    out.blocked = parseBlocked(obj.blocked);
+  }
+  return out;
+}
+function parseFindings(value) {
+  if (!Array.isArray(value)) {
+    throw new Error("findings must be an array of objects.");
+  }
+  return value.map((item, i) => {
+    if (typeof item !== "object" || item === null || Array.isArray(item)) {
+      throw new Error(`findings[${i}] must be a JSON object.`);
+    }
+    const obj = item;
+    for (const key of Object.keys(obj)) {
+      if (!ALLOWED_FINDING_KEYS.has(key)) {
+        throw new Error(
+          `findings[${i}]: unknown field '${key}'. Allowed: title, severity, location, summary.`
+        );
+      }
+    }
+    const finding = {
+      title: requireNonEmptyString(obj.title, `findings[${i}].title`)
+    };
+    if (obj.severity !== void 0) {
+      if (typeof obj.severity !== "string" || !VALID_SEVERITIES.has(obj.severity)) {
+        throw new Error(
+          `findings[${i}].severity must be one of high, medium, low, got '${obj.severity}'.`
+        );
+      }
+      finding.severity = obj.severity;
+    }
+    if (obj.location !== void 0) {
+      finding.location = requireNonEmptyString(obj.location, `findings[${i}].location`);
+    }
+    if (obj.summary !== void 0) {
+      finding.summary = requireNonEmptyString(obj.summary, `findings[${i}].summary`);
+    }
+    return finding;
+  });
+}
+function parseBlocked(value) {
+  if (!Array.isArray(value)) {
+    throw new Error("blocked must be an array of objects.");
+  }
+  return value.map((item, i) => {
+    if (typeof item !== "object" || item === null || Array.isArray(item)) {
+      throw new Error(`blocked[${i}] must be a JSON object.`);
+    }
+    const obj = item;
+    for (const key of Object.keys(obj)) {
+      if (!ALLOWED_BLOCKED_KEYS.has(key)) {
+        throw new Error(`blocked[${i}]: unknown field '${key}'. Allowed: title, reason, why.`);
+      }
+    }
+    if (typeof obj.reason !== "string" || !VALID_BLOCK_REASONS.has(obj.reason)) {
+      throw new Error(
+        `blocked[${i}].reason must be one of spec-deviation, design-reversal, got '${obj.reason}'.`
+      );
+    }
+    const blocked = {
+      title: requireNonEmptyString(obj.title, `blocked[${i}].title`),
+      reason: obj.reason
+    };
+    if (obj.why !== void 0) {
+      blocked.why = requireNonEmptyString(obj.why, `blocked[${i}].why`);
+    }
+    return blocked;
+  });
+}
+function requireNonEmptyString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${field} must be a non-empty string.`);
+  }
+  return value;
+}
+function buildReviewRecordedEvent(input) {
+  const { review } = input;
+  return {
+    schema_version: "0.1.0",
+    id: input.eventId,
+    session_id: input.sessionId,
+    occurred_at: input.occurredAt,
+    source: "local-cli",
+    type: "review_recorded",
+    reviewer: review.reviewer,
+    target: review.target,
+    ...review.verdict !== void 0 ? { verdict: review.verdict } : {},
+    ...review.findings !== void 0 ? { findings: review.findings } : {},
+    ...review.blocked !== void 0 ? { blocked: review.blocked } : {}
+  };
+}
+var LABEL_FRAGMENT_MAX = 40;
+function buildReviewRecordLabel(review) {
+  return `Ad-hoc review: ${truncate(review.reviewer)} -> ${truncate(review.target)}`;
+}
+function truncate(value) {
+  return value.length > LABEL_FRAGMENT_MAX ? `${value.slice(0, LABEL_FRAGMENT_MAX - 3)}...` : value;
+}
+
 // src/runtime/child-process-runner.ts
 import { spawn as spawn2 } from "child_process";
 var DEFAULT_KILL_GRACE_MS = 5e3;
@@ -7249,6 +7477,8 @@ var GENERATED_START = "<!-- BASOU:GENERATED:START -->";
 var GENERATED_END = "<!-- BASOU:GENERATED:END -->";
 var PROTOCOL_START = "<!-- BASOU:PROTOCOLS:START -->";
 var PROTOCOL_END = "<!-- BASOU:PROTOCOLS:END -->";
+var ORIENTATION_START = "<!-- BASOU:ORIENTATION:START -->";
+var ORIENTATION_END = "<!-- BASOU:ORIENTATION:END -->";
 var DEFAULT_MARKERS = { start: GENERATED_START, end: GENERATED_END };
 async function readMarkdownFile(filePath) {
   try {
@@ -7773,8 +8003,11 @@ export {
   IsoTimestampSchema,
   JSON_SCHEMA_VERSION,
   ManifestSchema,
+  ORIENTATION_END,
+  ORIENTATION_START,
   PROTOCOL_END,
   PROTOCOL_START,
+  REVIEW_RECORD_NO_INPUT_HINT,
   RiskLevelSchema,
   STOP_HOOK_TIMEOUT_SECONDS,
   STUCK_THRESHOLD_MS,
@@ -7803,6 +8036,8 @@ export {
   assertBasouRootSafe,
   basouPaths,
   buildJsonSchemas,
+  buildReviewRecordLabel,
+  buildReviewRecordedEvent,
   buildStatusSnapshot,
   buildStopHookCommand,
   chainEvents,
@@ -7812,6 +8047,7 @@ export {
   classifySuspect,
   claudeCodeAdapterMetadata,
   claudeTranscriptToImportPayload,
+  codexAdapterMetadata,
   codexRolloutToImportPayload,
   computeWorkStats,
   createAdHocSessionWithEvent,
@@ -7853,6 +8089,7 @@ export {
   overwriteYamlFile,
   parseDuration,
   parseMarkers,
+  parseReviewRecordInput,
   pathBasename,
   planArchive,
   planGitignore,
@@ -7885,6 +8122,7 @@ export {
   replayEvents,
   resolveBasouRepositoryRoot,
   resolveClaudeCodeCommand,
+  resolveCodexCommand,
   resolveRepositoryRoot,
   resolveSessionId,
   resolveTaskId,