ralphctl 0.16.0 → 0.17.0

package/README.md

@@ -433,7 +433,7 @@ Run `ralphctl <command> --help` for flag-level detail.
 
 **Further reading:**
 [AI Agent Harnesses: A Field Guide](https://lukasgrigis.dev/blog/guides/agent-harnesses/) — Lukas Grigis
-| [Harness Engineering for Coding Agent Users](https://martinfowler.com/articles/harness-engineering.html) — Martin Fowler (April 2026)
+| [Harness Engineering for Coding Agent Users](https://martinfowler.com/articles/harness-engineering.html) — Birgitta Böckeler, martinfowler.com (April 2026)
 | [Harness Design for Long-Running Application Development](https://www.anthropic.com/engineering/harness-design-long-running-apps) — Anthropic Engineering
 
 ---

package/dist/{cli-KZ4IYDKB.mjs → cli-CCNZ2VKB.mjs}

@@ -624,6 +624,7 @@ var CLAUDE_MODELS = [
   "claude-sonnet-5",
   "claude-opus-4-8",
   "claude-opus-4-8[1m]",
+  "claude-opus-5",
   "claude-fable-5",
   "claude-fable-5[1m]"
 ];
@@ -631,12 +632,12 @@ var isClaudeModel = (s) => CLAUDE_MODELS.includes(s);
 
 // src/domain/value/settings-models/codex.ts
 var CODEX_MODELS = [
+  "gpt-5.6-sol",
+  "gpt-5.6-terra",
+  "gpt-5.6-luna",
   "gpt-5.5",
   "gpt-5.4",
   "gpt-5.4-mini",
-  "gpt-5.3-codex-spark",
-  "gpt-5.3-codex",
-  "gpt-5.2",
   "codex-auto-review"
 ];
 var isCodexModel = (s) => CODEX_MODELS.includes(s);
@@ -650,13 +651,17 @@ var COPILOT_MODELS = [
   "gpt-5.4-mini",
   "gpt-5.4-nano",
   "gpt-5.5",
+  "gpt-5.6-sol",
+  "gpt-5.6-terra",
+  "gpt-5.6-luna",
   // Anthropic
   "claude-haiku-4.5",
   "claude-opus-4.5",
   "claude-opus-4.6",
-  "claude-opus-4.6-fast",
   "claude-opus-4.7",
   "claude-opus-4.8",
+  "claude-opus-4.8-fast",
+  "claude-opus-5",
   "claude-fable-5",
   "claude-sonnet-4.5",
   "claude-sonnet-4.6",
@@ -666,8 +671,11 @@ var COPILOT_MODELS = [
   "gemini-3-flash",
   "gemini-3.1-pro-preview",
   "gemini-3.5-flash",
+  "gemini-3.6-flash",
   // Microsoft
   "mai-code-1-flash",
+  // Moonshot
+  "kimi-k2.7-code",
   // Fine-tuned
   "raptor-mini-preview"
 ];
@@ -680,14 +688,16 @@ var FLOW_IDS = ["refine", "plan", "implement", "readiness", "ideate", "createPr"
 var CURRENT_SCHEMA_VERSION = 2;
 var LogLevelSchema = z.enum(["silent", "debug", "info", "warn", "error"]);
 var PROVIDER_CLAUDE_CODE = "claude-code";
+var PROVIDER_GITHUB_COPILOT = "github-copilot";
+var PROVIDER_OPENAI_CODEX = "openai-codex";
 var AiProviderSchema = z.enum([
   PROVIDER_CLAUDE_CODE,
-  "github-copilot",
-  "openai-codex"
+  PROVIDER_GITHUB_COPILOT,
+  PROVIDER_OPENAI_CODEX
 ]);
 var ClaudeEffortSchema = z.enum(["low", "medium", "high", "xhigh", "max"]);
 var CopilotEffortSchema = z.enum(["none", "low", "medium", "high", "xhigh", "max"]);
-var CodexEffortSchema = z.enum(["minimal", "low", "medium", "high"]);
+var CodexEffortSchema = z.enum(["low", "medium", "high", "xhigh", "max", "ultra"]);
 var GlobalEffortSchema = z.enum(["low", "medium", "high", "xhigh", "max"]);
 var CustomModelStringSchema = z.string().trim().min(1, "model id must be a non-empty trimmed string");
 var ClaudeModelSchema = z.union([z.enum(CLAUDE_MODELS), CustomModelStringSchema]);
@@ -699,12 +709,12 @@ var ClaudeFlowRowSchema = z.object({
   effort: ClaudeEffortSchema.optional()
 });
 var CopilotFlowRowSchema = z.object({
-  provider: z.literal("github-copilot"),
+  provider: z.literal(PROVIDER_GITHUB_COPILOT),
   model: CopilotModelSchema,
   effort: CopilotEffortSchema.optional()
 });
 var CodexFlowRowSchema = z.object({
-  provider: z.literal("openai-codex"),
+  provider: z.literal(PROVIDER_OPENAI_CODEX),
   model: CodexModelSchema,
   effort: CodexEffortSchema.optional()
 });
@@ -739,35 +749,43 @@ var seedLegacyCreatePrRow = (ai) => {
   if (!("provider" in refine)) return ai;
   return { ...aiObj, createPr: { ...refine } };
 };
-var RETIRED_CLAUDE_OPUS = "claude-opus-4-7";
-var SUCCESSOR_CLAUDE_OPUS = "claude-opus-4-8";
-var migrateRetiredOpusRow = (row) => {
+var RETIRED_MODEL_REMAPS = [
+  { provider: PROVIDER_CLAUDE_CODE, from: "claude-opus-4-7", to: "claude-opus-4-8" },
+  { provider: PROVIDER_GITHUB_COPILOT, from: "claude-opus-4.6-fast", to: "claude-opus-4.8-fast" },
+  { provider: PROVIDER_OPENAI_CODEX, from: "gpt-5.2", to: "gpt-5.5" },
+  { provider: PROVIDER_OPENAI_CODEX, from: "gpt-5.3-codex", to: "gpt-5.5" },
+  { provider: PROVIDER_OPENAI_CODEX, from: "gpt-5.3-codex-spark", to: "gpt-5.5" }
+];
+var RETIRED_CODEX_EFFORT = "minimal";
+var migrateStaleRow = (row) => {
   if (typeof row !== "object" || row === null) return row;
-  const rowObj = row;
-  if (rowObj["provider"] === PROVIDER_CLAUDE_CODE && rowObj["model"] === RETIRED_CLAUDE_OPUS) {
-    return { ...rowObj, model: SUCCESSOR_CLAUDE_OPUS };
+  let next = row;
+  const remap = RETIRED_MODEL_REMAPS.find((r) => next["provider"] === r.provider && next["model"] === r.from);
+  if (remap !== void 0) next = { ...next, model: remap.to };
+  if (next["provider"] === PROVIDER_OPENAI_CODEX && next["effort"] === RETIRED_CODEX_EFFORT) {
+    next = { ...next, effort: "low" };
   }
-  return row;
+  return next;
 };
-var migrateRetiredClaudeOpus = (ai) => {
+var migrateStaleAiRows = (ai) => {
   if (typeof ai !== "object" || ai === null) return ai;
   const aiObj = ai;
   const next = { ...aiObj };
   for (const flow of ["refine", "plan", "readiness", "ideate", "createPr"]) {
-    if (flow in next) next[flow] = migrateRetiredOpusRow(next[flow]);
+    if (flow in next) next[flow] = migrateStaleRow(next[flow]);
   }
   const implement = next["implement"];
   if (typeof implement === "object" && implement !== null) {
     const implObj = implement;
     next["implement"] = {
       ...implObj,
-      generator: migrateRetiredOpusRow(implObj["generator"]),
-      evaluator: migrateRetiredOpusRow(implObj["evaluator"])
+      generator: migrateStaleRow(implObj["generator"]),
+      evaluator: migrateStaleRow(implObj["evaluator"])
     };
   }
   return next;
 };
-var promoteLegacyAiRows = (ai) => migrateRetiredClaudeOpus(seedLegacyCreatePrRow(promoteLegacyImplementRow(ai)));
+var promoteLegacyAiRows = (ai) => migrateStaleAiRows(seedLegacyCreatePrRow(promoteLegacyImplementRow(ai)));
 var healHarnessCrossKnobs = (harness) => {
   if (typeof harness !== "object" || harness === null) return harness;
   const h = harness;
@@ -993,9 +1011,10 @@ var uniqueProvidersFromAi = (ai) => {
 
 // src/business/settings/defaults.ts
 var CLAUDE_SONNET = "claude-sonnet-5";
-var CLAUDE_OPUS = "claude-opus-4-8";
+var CLAUDE_OPUS = "claude-opus-5";
 var GPT_5_MINI = "gpt-5-mini";
 var GPT_5_4_MINI = "gpt-5.4-mini";
+var GPT_5_6_SOL = "gpt-5.6-sol";
 var DEFAULT_MODELS_BY_PROVIDER = {
   "claude-code": {
     refine: CLAUDE_SONNET,
@@ -1017,13 +1036,12 @@ var DEFAULT_MODELS_BY_PROVIDER = {
   },
   "openai-codex": {
     refine: GPT_5_4_MINI,
-    plan: "gpt-5.5",
-    // `gpt-5.3-codex` is deprecated for ChatGPT sign-in — the "reset implement to Codex" path
-    // rides the frontier default `gpt-5.5` instead, matching the CODEX_ONLY preset decision so
-    // the everyday autonomous loop works under ChatGPT auth and sits at the top of the ladder.
-    implement: "gpt-5.5",
+    plan: GPT_5_6_SOL,
+    // `gpt-5.6-sol` is the codex flagship (codex CLI ≥ 0.145); it tops the Codex escalation
+    // ladder, so the reset-to-codex implement default and the ladder top stay aligned.
+    implement: GPT_5_6_SOL,
     readiness: GPT_5_4_MINI,
-    ideate: "gpt-5.5",
+    ideate: GPT_5_6_SOL,
     createPr: GPT_5_4_MINI
   }
 };
@@ -1045,7 +1063,7 @@ var DEFAULT_SETTINGS = {
     ...defaultAiSettingsForProvider("claude-code"),
     implement: {
       generator: { provider: "claude-code", model: CLAUDE_OPUS },
-      evaluator: { provider: "openai-codex", model: "gpt-5.5" }
+      evaluator: { provider: "openai-codex", model: GPT_5_6_SOL }
     }
   },
   harness: {
@@ -3038,10 +3056,10 @@ var resolveWritableRoots = (session) => {
 };
 
 // src/domain/value/settings-models/suspended-models.ts
-var SUSPENDED_MODELS = ["claude-fable-5", "claude-fable-5[1m]"];
+var SUSPENDED_MODELS = [];
 var isSuspendedModel = (s) => SUSPENDED_MODELS.includes(s);
 var SUSPENSION_NOTE = "suspended";
-var suspendedModelMessage = (model) => `'${model}' is temporarily suspended by Anthropic (2026-06-12 export-control directive on Fable 5 / Mythos 5) \u2014 pick another model until access is restored`;
+var suspendedModelMessage = (model) => `'${model}' is temporarily suspended by its provider \u2014 pick another model until access is restored`;
 
 // src/integration/ai/providers/_engine/bounded-tail.ts
 var STDERR_TAIL_CAP = 16384;
@@ -3494,6 +3512,8 @@ var CONTEXT_WINDOW = {
   // Sonnet 5 always runs at its native 1M window on the Anthropic API — no `[1m]` selector, so
   // the bare id carries the 1M figure directly.
   "claude-sonnet-5": 1e6,
+  // Opus 5 — natively 1M in Claude Code — no `[1m]` selector; the bare id carries the figure.
+  "claude-opus-5": 1e6,
   // `[1m]` is Claude Code's 1M-token long-context selector — the window IS the id suffix.
   "claude-opus-4-8[1m]": 1e6,
   "claude-fable-5[1m]": 1e6
@@ -6004,7 +6024,7 @@ var createNpmVersionChecker = (deps) => {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.16.0",
+  version: "0.17.0",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code, GitHub Copilot, and OpenAI Codex across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -6120,18 +6140,25 @@ var CLI_METADATA = {
 
 // src/business/task/escalation-map.ts
 var DEFAULT_ESCALATION_MAP = {
-  // Claude (Claude-Code / Codex dash-form) — Haiku → Sonnet 5 → Opus; Sonnet 4.6 still climbs.
+  // Claude (Claude-Code dash-form) — Haiku → Sonnet 5 → Opus 5; legacy tiers chain through their
+  // own generation (Sonnet 4.6 → Opus 4.8 → Opus 5) and converge at the flagship.
   "claude-haiku-4-5": "claude-sonnet-5",
-  "claude-sonnet-5": "claude-opus-4-8",
+  "claude-sonnet-5": "claude-opus-5",
   "claude-sonnet-4-6": "claude-opus-4-8",
-  // Claude (Copilot dot-form) — Haiku → Sonnet 4.6 → Opus (Sonnet 5 shares the dash-form key above).
+  "claude-opus-4-8": "claude-opus-5",
+  // Claude (Copilot dot-form) — Haiku → Sonnet 4.6 → Opus 4.8. Opus 4.8 is deliberately the
+  // dot-form top: claude-opus-5 is plan-gated on Copilot, so the default ladder never steers a
+  // mid-task spawn into a model many accounts cannot use (add a rung via escalationMap to opt in).
   "claude-haiku-4.5": "claude-sonnet-4.6",
   "claude-sonnet-4.6": "claude-opus-4.8",
-  // Copilot/Codex GPT — mini variants step up to their full-tier frontier, and the
-  // economic full tier (`gpt-5.4`) climbs to the flagship.
+  // Copilot/Codex GPT — minis step to the 5.5 full tier; the 5.5/5.4 generation chains into the
+  // 5.6 family; within 5.6, luna → terra → sol (sol is the flagship top rung).
   "gpt-5-mini": "gpt-5.5",
   "gpt-5.4-mini": "gpt-5.5",
-  "gpt-5.4": "gpt-5.5"
+  "gpt-5.4": "gpt-5.5",
+  "gpt-5.5": "gpt-5.6-sol",
+  "gpt-5.6-luna": "gpt-5.6-terra",
+  "gpt-5.6-terra": "gpt-5.6-sol"
 };
 var mergeEscalationMap = (user) => ({
   ...DEFAULT_ESCALATION_MAP,
@@ -6155,7 +6182,9 @@ var escalationLadderCyclicFrom = (map, start) => {
   return false;
 };
 var EFFORT_ESCALATION_TARGET = "high";
+var CODEX_EFFORT_ESCALATION_TARGET = "xhigh";
 var EFFORT_AT_OR_ABOVE_TARGET = /* @__PURE__ */ new Set(["high", "xhigh", "max"]);
+var CODEX_EFFORT_AT_OR_ABOVE_TARGET = /* @__PURE__ */ new Set(["xhigh", "max", "ultra"]);
 var EFFORT_CAPABLE_PROVIDERS = /* @__PURE__ */ new Set([
   "claude-code",
   "github-copilot",
@@ -6179,8 +6208,12 @@ var claudeEffortRung = (model, currentEffort) => {
 var nextEffortRung = (provider, model, currentEffort) => {
   if (provider === void 0 || !EFFORT_CAPABLE_PROVIDERS.has(provider)) return void 0;
   if (provider === "claude-code") return claudeEffortRung(model, currentEffort);
-  if (currentEffort !== void 0 && EFFORT_AT_OR_ABOVE_TARGET.has(currentEffort)) return void 0;
-  return EFFORT_ESCALATION_TARGET;
+  if (provider === "github-copilot") {
+    if (currentEffort !== void 0 && EFFORT_AT_OR_ABOVE_TARGET.has(currentEffort)) return void 0;
+    return EFFORT_ESCALATION_TARGET;
+  }
+  if (currentEffort !== void 0 && CODEX_EFFORT_AT_OR_ABOVE_TARGET.has(currentEffort)) return void 0;
+  return CODEX_EFFORT_ESCALATION_TARGET;
 };
 
 // src/integration/ai/skills/_engine/filesystem-skills-adapter.ts
@@ -13978,7 +14011,7 @@ var resolveEffortForRow = (row, globalEffort) => {
   return _floorForProvider(globalEffort, row.provider);
 };
 var clampEffortToProvider = (effort, provider) => {
-  if (provider === "openai-codex" && (effort === "xhigh" || effort === "max")) return "high";
+  if (provider === "openai-codex" && effort === "max") return "xhigh";
   return effort;
 };
 var _floorForProvider = (effort, provider) => clampEffortToProvider(effort, provider);
@@ -16420,7 +16453,12 @@ var renderPlateauDirectiveSection = (plateauBreak) => {
     "Step back and rethink. Re-read the task contract and the prior critique, question the assumption",
     "that led the earlier attempts astray, and implement a **fundamentally different** solution \u2014 a",
     "different design, data flow, or code path. Then verify the failing criteria directly before",
-    "signalling completion."
+    "signalling completion.",
+    "",
+    "Before you choose that different approach, name which failure mode you were stuck in \u2014",
+    "re-exploring code you already understood, looping on the same failing edit, over-polishing",
+    "criteria that already pass, or fixing the wrong",
+    'location entirely \u2014 then change that specific behaviour, not just "try something different."'
   ].join("\n");
 };
 
@@ -18501,7 +18539,7 @@ var composeCriteriaHistory = (input) => {
 var requireNonEmpty = (field, message) => (v) => v.trim().length === 0 ? Result.error(new ValidationError({ field, value: v, message })) : Result.ok(v);
 var implementPromptDef = {
   templateName: "implement",
-  description: "One-shot task execution. The agent reads the task body, runs the verify script, and emits harness signals; the harness snapshots those signals into progress.md.",
+  description: "One-shot task execution. The agent reads the task body and emits harness signals; the harness runs the verify script as the post-task gate and snapshots the signals into progress.md.",
   parameters: {
     taskName: {
       placeholder: "TASK_NAME",
@@ -18732,7 +18770,7 @@ var generatorExampleSignals = [
     appliesTo: "config / io layer",
     timestamp: EXAMPLE_TS3
   },
-  { type: "task-verified", output: "$ pnpm test\n... 42 passed", timestamp: EXAMPLE_TS3 },
+  { type: "task-verified", output: "$ <project test command>\n... 42 passed", timestamp: EXAMPLE_TS3 },
   {
     type: COMMIT_MESSAGE_KIND,
     subject: "feat(foo): add helper for bar",
@@ -20399,7 +20437,7 @@ var evaluatorExampleSignals = [
         dimension: "correctness",
         passed: false,
         finding: "C1 command exited 1: empty-input test failed at src/foo.ts:23",
-        executionEvidence: "npm test -- src/foo.test.ts\n  \u2717 handles empty input (expected 400, got 500)\n  1 failing"
+        executionEvidence: "<project test command>\n  \u2717 handles empty input (expected 400, got 500)\n  1 failing"
       },
       { dimension: "completeness", passed: true, finding: "all declared steps shipped" },
       { dimension: "safety", passed: true, finding: "inputs validated at the request boundary" },
@@ -20407,7 +20445,11 @@ var evaluatorExampleSignals = [
       { dimension: "robustness", passed: true, finding: "error path retries the write once before surfacing" }
     ],
     criteria: [
-      { id: "C1", passed: false, evidence: "npm test exited 1 \u2014 empty-input case failed at src/foo.ts:23" },
+      {
+        id: "C1",
+        passed: false,
+        evidence: "<project test command> exited 1 \u2014 empty-input case failed at src/foo.ts:23"
+      },
       { id: "C2", passed: true, evidence: "request boundary validates input at src/foo.ts:11" }
     ],
     critique: "Correctness: add edge-case handling for empty input at src/foo.ts:23.",
@@ -27833,7 +27875,14 @@ var readinessPromptDef = {
   partials: {
     HARNESS_CONTEXT: "harness-context"
   },
-  expectedSignals: ["agents-md-proposal", "setup-skill-proposal", "verify-skill-proposal", "skill-suggestions", "note"]
+  expectedSignals: [
+    "agents-md-proposal",
+    "setup-skill-proposal",
+    "verify-skill-proposal",
+    "skill-suggestions",
+    "note",
+    "learning"
+  ]
 };
 var renderCurrentTool = (tool) => tool;
 var renderExistingContextFile = (body) => {
@@ -27958,20 +28007,20 @@ var readinessExampleSignals = [
   {
     type: "agents-md-proposal",
     tag: "claude-md",
-    content: "# Project Context\n\n## Build & Run\n\n`pnpm dev` \u2014 runs the dev server.",
+    content: "# Project Context\n\n## Build & Run\n\n`<dev server command>` \u2014 runs the dev server.",
     timestamp: EXAMPLE_TS6
   },
   {
     type: "setup-skill-proposal",
-    content: "# Setup\n\nRun `pnpm install` to install dependencies.",
+    content: "# Setup\n\nRun `<install command>` to install dependencies.",
     timestamp: EXAMPLE_TS6
   },
   {
     type: "verify-skill-proposal",
-    content: "# Verify\n\nRun `pnpm verify` (typecheck + lint + test).",
+    content: "# Verify\n\nRun `<verify command>` (typecheck + lint + test).",
     timestamp: EXAMPLE_TS6
   },
-  { type: "skill-suggestions", names: ["typescript-strict", "pnpm"], timestamp: EXAMPLE_TS6 }
+  { type: "skill-suggestions", names: ["typescript-strict", "code-style-conventions"], timestamp: EXAMPLE_TS6 }
 ];
 var readinessOutputContract = {
   schemaVersion: 1,
@@ -28287,8 +28336,7 @@ var resolveEffortForRow2 = (ai, flow) => {
   if (row.effort !== void 0) return row.effort;
   const globalEffort = ai.effort;
   if (globalEffort === void 0) return void 0;
-  if (row.provider === "openai-codex" && (globalEffort === "xhigh" || globalEffort === "max")) return "high";
-  return globalEffort;
+  return clampEffortToProvider(globalEffort, row.provider);
 };
 var PROVIDER_INFRASTRUCTURE_ERROR_CODES = /* @__PURE__ */ new Set([ErrorCode.Probe, ErrorCode.RateLimit]);
 var wrapProviderContinue = (eventBus, provider, inner) => ({
@@ -28564,17 +28612,17 @@ var EXAMPLE_TS7 = "2026-05-22T10:00:00.000Z";
 var EXAMPLE_SIGNALS2 = [
   {
     type: SETUP_SKILL_PROPOSAL,
-    content: "This repo pins tool versions with mise. Before editing anything, run mise install to activate the exact versions declared in mise.toml. Then run the project install command documented in CLAUDE.md to hydrate the dependency tree.",
+    content: "This repo pins tool versions with mise. Before editing anything, run mise install to activate the exact versions declared in mise.toml. Then run the project install command documented in the coding-agent context file to hydrate the dependency tree.",
     timestamp: EXAMPLE_TS7
   },
   {
     type: VERIFY_SKILL_PROPOSAL,
-    content: "Verification runs three gates in sequence documented in CLAUDE.md: typecheck, lint, then tests. A failure in any gate stops the chain; read the first failing gate output \u2014 later gates have not run yet.",
+    content: "Verification runs three gates in sequence documented in the coding-agent context file: typecheck, lint, then tests. A failure in any gate stops the chain; read the first failing gate output \u2014 later gates have not run yet.",
     timestamp: EXAMPLE_TS7
   },
   {
     type: "note",
-    text: "Skills authored from CLAUDE.md and mise.toml.",
+    text: "Skills authored from the coding-agent context file and mise.toml.",
     timestamp: EXAMPLE_TS7
   }
 ];
@@ -29024,23 +29072,23 @@ var wrapLegacyArray8 = (raw) => {
 };
 var EXAMPLE_TS8 = "2026-05-22T10:00:00.000Z";
 var EXAMPLE_SIGNALS3 = [
-  { type: "setup-script", command: "pnpm install", timestamp: EXAMPLE_TS8 },
+  { type: "setup-script", command: "<tool> install", timestamp: EXAMPLE_TS8 },
   {
     type: "verify-script",
-    command: "pnpm typecheck && pnpm lint && pnpm test",
+    command: "<tool> typecheck && <tool> lint && <tool> test",
     timestamp: EXAMPLE_TS8
   },
   {
     type: "verify-gates",
     gates: [
-      { pathPrefix: "services/api/", command: "pnpm --filter api test" },
-      { pathPrefix: "services/web/", command: "pnpm --filter web test" }
+      { pathPrefix: "services/api/", command: "<tool> --filter api test" },
+      { pathPrefix: "services/web/", command: "<tool> --filter web test" }
     ],
     timestamp: EXAMPLE_TS8
   },
   {
     type: "note",
-    text: "Commands lifted verbatim from CLAUDE.md.",
+    text: "Commands lifted verbatim from the coding-agent context file.",
     timestamp: EXAMPLE_TS8
   }
 ];
@@ -30848,7 +30896,7 @@ var evaluateTriggers = (triggers, inputs) => {
 var PROVIDER_EFFORT_LEVELS = {
   "claude-code": ["low", "medium", "high", "xhigh", "max"],
   "github-copilot": ["none", "low", "medium", "high", "xhigh", "max"],
-  "openai-codex": ["minimal", "low", "medium", "high"]
+  "openai-codex": ["low", "medium", "high", "xhigh", "max", "ultra"]
 };
 
 // src/application/ui/tui/views/flows-customize-picker.ts
@@ -36483,16 +36531,18 @@ var isPresetName = (raw) => PRESET_NAMES.includes(raw);
 var CLAUDE = "claude-code";
 var COPILOT = "github-copilot";
 var CODEX = "openai-codex";
-var OPUS = "claude-opus-4-8";
+var OPUS = "claude-opus-5";
 var SONNET = "claude-sonnet-5";
 var HAIKU = "claude-haiku-4-5";
 var COPILOT_OPUS = "claude-opus-4.8";
 var COPILOT_SONNET = "claude-sonnet-4.6";
 var GPT_5_MINI2 = "gpt-5-mini";
 var GPT_5_4_MINI2 = "gpt-5.4-mini";
+var GPT_5_6_SOL2 = "gpt-5.6-sol";
+var GPT_5_6_TERRA = "gpt-5.6-terra";
 var MIXED = {
   effort: "high",
-  refine: { provider: CODEX, model: "gpt-5.5" },
+  refine: { provider: CODEX, model: GPT_5_6_SOL2 },
   plan: { provider: COPILOT, model: COPILOT_SONNET, effort: "xhigh" },
   implement: {
     generator: { provider: CLAUDE, model: OPUS, effort: "xhigh" },
@@ -36530,16 +36580,14 @@ var COPILOT_ONLY = {
 };
 var CODEX_ONLY = {
   effort: "high",
-  refine: { provider: CODEX, model: "gpt-5.4" },
-  plan: { provider: CODEX, model: "gpt-5.5", effort: "high" },
+  refine: { provider: CODEX, model: GPT_5_6_TERRA },
+  plan: { provider: CODEX, model: GPT_5_6_SOL2, effort: "xhigh" },
   implement: {
-    // gpt-5.3-codex is deprecated for ChatGPT sign-in — implement now rides the frontier
-    // default so the everyday autonomous loop keeps working under ChatGPT auth.
-    generator: { provider: CODEX, model: "gpt-5.5", effort: "high" },
-    evaluator: { provider: CODEX, model: "gpt-5.5", effort: "high" }
+    generator: { provider: CODEX, model: GPT_5_6_SOL2, effort: "xhigh" },
+    evaluator: { provider: CODEX, model: GPT_5_6_SOL2, effort: "xhigh" }
   },
   readiness: { provider: CODEX, model: GPT_5_4_MINI2, effort: "medium" },
-  ideate: { provider: CODEX, model: "gpt-5.5" },
+  ideate: { provider: CODEX, model: GPT_5_6_SOL2 },
   createPr: { provider: CODEX, model: GPT_5_4_MINI2 }
 };
 var MIXED_ECONOMIC = {
@@ -36581,13 +36629,13 @@ var COPILOT_ECONOMIC = {
 var CODEX_ECONOMIC = {
   effort: "high",
   refine: { provider: CODEX, model: GPT_5_4_MINI2 },
-  plan: { provider: CODEX, model: "gpt-5.4", effort: "high" },
+  plan: { provider: CODEX, model: GPT_5_6_TERRA, effort: "high" },
   implement: {
-    generator: { provider: CODEX, model: "gpt-5.4", effort: "high" },
-    evaluator: { provider: CODEX, model: "gpt-5.4", effort: "high" }
+    generator: { provider: CODEX, model: GPT_5_6_TERRA, effort: "high" },
+    evaluator: { provider: CODEX, model: GPT_5_6_TERRA, effort: "high" }
   },
   readiness: { provider: CODEX, model: GPT_5_4_MINI2, effort: "medium" },
-  ideate: { provider: CODEX, model: "gpt-5.5" },
+  ideate: { provider: CODEX, model: GPT_5_6_TERRA },
   createPr: { provider: CODEX, model: GPT_5_4_MINI2 }
 };
 var CLAUDE_STRONG_GATE = {
@@ -36631,14 +36679,15 @@ var COPILOT_STRONG_GATE = {
 var CODEX_STRONG_GATE = {
   effort: "high",
   refine: { provider: CODEX, model: GPT_5_4_MINI2 },
-  plan: { provider: CODEX, model: "gpt-5.5", effort: "high" },
+  plan: { provider: CODEX, model: GPT_5_6_SOL2, effort: "xhigh" },
   implement: {
-    // Narrowest gate of the family: gpt-5.4 author climbs the single rung to the gpt-5.5 gate.
-    generator: { provider: CODEX, model: "gpt-5.4", effort: "high" },
-    evaluator: { provider: CODEX, model: "gpt-5.5", effort: "high" }
+    // Narrowest gate of the family: terra author climbs the single default-ladder rung to the
+    // sol gate.
+    generator: { provider: CODEX, model: GPT_5_6_TERRA, effort: "high" },
+    evaluator: { provider: CODEX, model: GPT_5_6_SOL2, effort: "xhigh" }
   },
   readiness: { provider: CODEX, model: GPT_5_4_MINI2, effort: "medium" },
-  ideate: { provider: CODEX, model: "gpt-5.5" },
+  ideate: { provider: CODEX, model: GPT_5_6_SOL2 },
   createPr: { provider: CODEX, model: GPT_5_4_MINI2 }
 };
 var MIXED_FAST = {
@@ -36679,19 +36728,19 @@ var COPILOT_FAST = {
 };
 var CODEX_FAST = {
   effort: "low",
-  refine: { provider: CODEX, model: GPT_5_4_MINI2, effort: "minimal" },
+  refine: { provider: CODEX, model: GPT_5_4_MINI2 },
   plan: { provider: CODEX, model: GPT_5_4_MINI2, effort: "low" },
   implement: {
     generator: { provider: CODEX, model: GPT_5_4_MINI2, effort: "low" },
     evaluator: { provider: CODEX, model: GPT_5_4_MINI2, effort: "low" }
   },
-  readiness: { provider: CODEX, model: GPT_5_4_MINI2, effort: "minimal" },
+  readiness: { provider: CODEX, model: GPT_5_4_MINI2 },
   ideate: { provider: CODEX, model: GPT_5_4_MINI2 },
-  createPr: { provider: CODEX, model: GPT_5_4_MINI2, effort: "minimal" }
+  createPr: { provider: CODEX, model: GPT_5_4_MINI2 }
 };
 var MIXED_FRONTIER = {
   effort: "max",
-  refine: { provider: CODEX, model: "gpt-5.5" },
+  refine: { provider: CODEX, model: GPT_5_6_SOL2 },
   plan: { provider: CLAUDE, model: OPUS, effort: "max" },
   implement: {
     generator: { provider: CLAUDE, model: OPUS, effort: "max" },
@@ -36699,7 +36748,7 @@ var MIXED_FRONTIER = {
   },
   readiness: { provider: CLAUDE, model: OPUS, effort: "high" },
   ideate: { provider: CLAUDE, model: OPUS },
-  createPr: { provider: CODEX, model: "gpt-5.5" }
+  createPr: { provider: CODEX, model: GPT_5_6_SOL2 }
 };
 var CLAUDE_FRONTIER = {
   effort: "max",
@@ -36726,17 +36775,16 @@ var COPILOT_FRONTIER = {
   createPr: { provider: COPILOT, model: COPILOT_OPUS }
 };
 var CODEX_FRONTIER = {
-  // Codex ceiling — global stays `high` so nothing implies a `max` codex row.
-  effort: "high",
-  refine: { provider: CODEX, model: "gpt-5.5" },
-  plan: { provider: CODEX, model: "gpt-5.5", effort: "high" },
+  effort: "max",
+  refine: { provider: CODEX, model: GPT_5_6_SOL2 },
+  plan: { provider: CODEX, model: GPT_5_6_SOL2, effort: "max" },
   implement: {
-    generator: { provider: CODEX, model: "gpt-5.5", effort: "high" },
-    evaluator: { provider: CODEX, model: "gpt-5.5", effort: "high" }
+    generator: { provider: CODEX, model: GPT_5_6_SOL2, effort: "max" },
+    evaluator: { provider: CODEX, model: GPT_5_6_SOL2, effort: "max" }
   },
-  readiness: { provider: CODEX, model: "gpt-5.5", effort: "high" },
-  ideate: { provider: CODEX, model: "gpt-5.5" },
-  createPr: { provider: CODEX, model: "gpt-5.5" }
+  readiness: { provider: CODEX, model: GPT_5_6_SOL2, effort: "high" },
+  ideate: { provider: CODEX, model: GPT_5_6_SOL2 },
+  createPr: { provider: CODEX, model: GPT_5_6_SOL2 }
 };
 var PRESETS = {
   mixed: { ai: MIXED, escalateOnPlateau: true },

package/dist/cli.mjs

@@ -2,5 +2,5 @@
 
 // src/index.ts
 process.env.NODE_ENV ??= "production";
-var { runCli } = await import("./cli-KZ4IYDKB.mjs");
+var { runCli } = await import("./cli-CCNZ2VKB.mjs");
 await runCli(process.argv);

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.16.0",
-  "generatedAt": "2026-07-18T13:59:00.834Z",
+  "packageVersion": "0.17.0",
+  "generatedAt": "2026-07-27T15:30:39.020Z",
   "assets": [
     "agent-definitions/ralphctl-evaluator.md",
     "agent-definitions/ralphctl-generator.md",

package/dist/prompts/_partials/conventions-agents-md.md

@@ -47,14 +47,14 @@ break the shared lockfile.
 
 ## Architecture
 
-- Clean Architecture: `domain → business → integration → application`. No reverse imports.
-- No barrel files (`index.ts` re-exports) — every import names its symbol explicitly.
+- <your layering rule> — e.g. which modules may import which, and which direction is forbidden.
+- <your module-boundary rule> — e.g. no barrel re-export files; every import names its symbol explicitly.
 
 ## Conventions
 
-- Business operations return a `Result` type — do not throw for domain errors.
-- All file writes go through the atomic-write helper in `business/io/`; direct `fs.writeFile`
-  is banned from business code.
+- <your error-handling convention> — e.g. return a typed result instead of throwing for domain errors.
+- <your I/O convention> — e.g. all writes go through one shared helper; direct filesystem calls
+  are banned elsewhere.
 
 ## Security