projectstore-claude 0.30.2 → 0.30.3

package/node_modules/projectstore/scripts/build-adapters.mjs

@@ -102,7 +102,7 @@ function skill(name, description, body, { runtime = true } = {}) {
 const COMMAND_OVERRIDES = {
   agents: {
     description:
-      "Register or remove ProjectStore's shared agents block, inspect its Codex model overlay, or configure per-role models. Arguments: <register | unregister | status | configure>.",
+      "Register or remove ProjectStore's shared agents block, inspect its Codex model overlay, or configure per-role models and efforts. Arguments: <register | unregister | status | configure>.",
     body: `You are managing ProjectStore's Codex agent integration. Require a bound project.
 
 ## register / unregister
@@ -117,19 +117,22 @@ report the envelope's result. Never edit the managed block by hand.
 
 Run \`plan --json --harness codex --surface agents_block --project "$PWD"\`,
 then \`agents show --json --project "$PWD"\`. Report the block state and each
-role's resolved model and source. The active overlay path returned by the core
-is authoritative.
+role's resolved model and effort, each with its source. The active overlay path
+returned by the core is authoritative.
 
 ## configure
 
-Ask for a default model and optional per-role model ids. Use actual Codex model
-ids supplied by the user or visible in the current host; do not translate model
-names from another harness. Preview the exact argv, ask for approval, then run
-\`agents configure --harness codex [--default <model>] [--agent
-<role>=<model> ...] --project "$PWD"\`. The core is the only writer. Do not pass
-an effort override: per-role effort is outside this integration's current
-contract. A configured model is consumed by the role-orchestration skills on
-their next spawn; no restart is needed.`,
+Ask for a default model and optional per-role model ids, then a default effort
+and optional per-role efforts. Use actual Codex model ids and levels supplied by
+the user or visible in the current host; do not translate model names from
+another harness. Preview the exact argv, ask for approval, then run
+\`configure --set agents.default=<model> --set agents.default.effort=<level>
+[--set agents.<role>=<model>] [--set agents.<role>.effort=<level>] ... --harness
+codex --project "$PWD"\`, after the same command with \`--dry-run\` showed its
+plan. \`-\` as a value clears one. The core is the only writer; a level the
+role's model does not list is written with a note in the plan. A configured
+model and effort are consumed by the role-orchestration skills on their next
+spawn; no restart is needed.`,
   },
   bind: {
     description:
@@ -232,13 +235,25 @@ function renderPassive(file) {
   return [join("skills", name, "SKILL.md"), skill(name, data.description || name, body)];
 }
 
+// The spawn's effort parameter is the target manifest's vocabulary: a
+// manifest without it cannot render a role that passes one, and says so
+// rather than guessing a name (as the clerk pin refuses a literal model).
+function effortParam() {
+  const p = TARGET.agent_translation?.effort?.spawn_param;
+  if (!p)
+    throw new Error(
+      `${TARGET.id}: agent_translation.effort.spawn_param is missing; a role skill cannot name the effort`,
+    );
+  return p;
+}
+
 function renderRole(file) {
   const { data, body } = frontmatter(read(file), file);
   const role = file.split("/").pop().replace(/\.md$/, "");
   const name = renderedName("agents", role);
-  const orchestration = `## Codex orchestration\n\nThis is a role-orchestration skill, not a native agent registration. Resolve the\nrole model by running:\n\n\`\`\`bash\nnode "\${PROJECTSTORE_CORE_ROOT}/bin/projectstore.mjs" agents model ${role} --json --project "$PWD"\n\`\`\`\n\nSpawn a collaboration agent for the bounded task. If the result names a model,\npass that model and use an empty or bounded context fork; otherwise inherit the\ncurrent model. Do not pass a reasoning-effort override: per-role effort belongs\nto a separate accepted story. Give the spawned agent the role contract below\nand the exact artifact/diff it must inspect. Wait for its final result.\n\n## Role contract\n\n`;
+  const orchestration = `## Codex orchestration\n\nThis is a role-orchestration skill, not a native agent registration. Resolve the\nrole's model and effort by running:\n\n\`\`\`bash\nnode "\${PROJECTSTORE_CORE_ROOT}/bin/projectstore.mjs" agents model ${role} --json --project "$PWD"\n\`\`\`\n\nSpawn a collaboration agent for the bounded task. If the result names a model,\npass that model and use an empty or bounded context fork; otherwise inherit the\ncurrent model. If the result names an effort, pass it as \`${effortParam()}\`,\nwith or without a model; otherwise pass none. Give the spawned agent the role\ncontract below and the exact artifact/diff it must inspect. Wait for its final\nresult.\n\n## Role contract\n\n`;
   const description = (data.description || `Run the ProjectStore ${role} role in a fresh collaboration agent.`).replace(
-    /^(?:Opus|Sonnet) \(max-effort\)\s+/,
+    /^(?:Opus|Sonnet) \([a-z]+-effort\)\s+/,
     "",
   );
   return [join("skills", name, "SKILL.md"), skill(name, description, orchestration + body)];

package/node_modules/projectstore/scripts/cli.mjs

@@ -71,6 +71,7 @@ import {
   readConfigAt,
   readOverlayAt,
   resolveAgentModel,
+  resolveAgentEffort,
   overlayId,
   layoutRoster,
   commandForm,
@@ -1407,8 +1408,9 @@ async function runScaffold(ctx) {
   return emit(true, scaffoldResult(plan, done), renderScaffoldPlan(plan, done, { env }), 0);
 }
 
-// agents model <name> — the model a plugin surface passes for that agent, from
-// the active harness's overlay (ADR-008's two terms); agents show — the overlay
+// agents model <name> — the model and effort a plugin surface passes for that
+// agent, from the active harness's overlay (ADR-008's two terms, once per
+// field; the effort ADR, decision 2); agents show — the overlay
 // as read, with the keys the allowlist rejected; agents configure — the one
 // writer, behind the same gate as install: naming --harness is the
 // confirmation, a bare non-TTY call refuses (layout spec, contracts 2–4).
@@ -1439,11 +1441,15 @@ async function runAgents(ctx) {
     const name = positionals[1];
     if (!name) return usage("agents model takes the agent's bare name (critic, planner, …)");
     const r = resolveAgentModel(project, name, { harness });
+    const e = resolveAgentEffort(project, name, { harness });
+    // The effort clause only when one resolves, so the line reads as it did
+    // for an overlay of models alone.
+    const effortText = e.effort ? `; effort ${e.effort} (${e.source})` : "";
     return emit(
       "agents model",
       true,
-      r,
-      `${name}: ${r.model ? `${r.model} (${r.source}, ${r.overlay})` : "no model configured — the agent's frontmatter decides"}\n`,
+      { ...r, effort: e.effort, effort_source: e.source },
+      `${name}: ${r.model ? `${r.model} (${r.source}, ${r.overlay})` : "no model configured — the agent's frontmatter decides"}${effortText}\n`,
     );
   }
   const before = readOverlayAt(project, harness);
@@ -1451,22 +1457,28 @@ async function runAgents(ctx) {
   if (sub === "show") {
     // Resolved per roster agent (per configured name when no layout loads), so
     // a reader reports what would run without restating the two-term rule.
-    const names = [...new Set([...(roster || []), ...Object.keys(before.agents.per_agent)])].sort();
+    const configured = [
+      ...new Set([...Object.keys(before.agents.per_agent), ...Object.keys(before.efforts.per_agent)]),
+    ];
+    const names = [...new Set([...(roster || []), ...configured])].sort();
     const resolved = Object.fromEntries(
       names.map((n) => {
         const r = resolveAgentModel(project, n, { harness });
-        return [n, { model: r.model, source: r.source }];
+        const e = resolveAgentEffort(project, n, { harness });
+        return [n, { model: r.model, source: r.source, effort: e.effort, effort_source: e.source }];
       }),
     );
-    const unknown = roster ? Object.keys(before.agents.per_agent).filter((n) => !roster.includes(n)) : [];
+    const unknown = roster ? configured.filter((n) => !roster.includes(n)) : [];
     const lines = [
       `overlay: ${before.path || "(none: no harness detected and none named)"}${before.path && !before.present ? " (absent)" : ""}`,
     ];
     if (before.unparseable) lines.push("  not valid JSON");
     if (before.agents.default) lines.push(`  default: ${before.agents.default}`);
+    if (before.efforts.default) lines.push(`  default effort: ${before.efforts.default}`);
+    const effortOf = (n) => (resolved[n].effort ? `, effort ${resolved[n].effort} (${resolved[n].effort_source})` : "");
     for (const n of names)
       lines.push(
-        `  ${n}: ${resolved[n].model ? `${resolved[n].model} (${resolved[n].source})` : "— (the agent's frontmatter)"}${unknown.includes(n) ? " — not in the roster: nothing runs under this name" : ""}`,
+        `  ${n}: ${resolved[n].model ? `${resolved[n].model} (${resolved[n].source})` : "— (the agent's frontmatter)"}${effortOf(n)}${unknown.includes(n) ? " — not in the roster: nothing runs under this name" : ""}`,
       );
     if (before.rejected.length) lines.push(`  ignored (not an overlay key): ${before.rejected.join(", ")}`);
     if (inBinding) lines.push("  the binding still carries an agents block — a pre-0.28 leftover; run upgrade");
@@ -1479,6 +1491,7 @@ async function runAgents(ctx) {
         present: before.present,
         unparseable: before.unparseable,
         agents: before.agents,
+        efforts: before.efforts,
         resolved,
         roster,
         unknown,
@@ -1535,7 +1548,16 @@ async function runAgents(ctx) {
       { harness, path: before.path, wrote: false, declined: true, agents: next, dropped },
       preview.join("\n") + "\n  nothing written.\n",
     );
-  const { path, after } = applyAgentsChange(project, harness, next);
+  const { path, after } = applyAgentsChange(project, harness, next, change.nextEfforts);
+  // Efforts join the envelope only where the overlay holds one, so a run over
+  // models alone answers exactly as it did before efforts existed.
+  const withEfforts =
+    after.efforts.default ||
+    Object.keys(after.efforts.per_agent).length ||
+    before.efforts.default ||
+    Object.keys(before.efforts.per_agent).length
+      ? { efforts: after.efforts, pinnedClerkEffort: change.pinnedClerkEffort }
+      : {};
   return emit(
     "agents configure",
     true,
@@ -1544,6 +1566,7 @@ async function runAgents(ctx) {
       path,
       wrote: true,
       agents: after.agents,
+      ...withEfforts,
       pinnedClerk,
       clerkPinUnavailable,
       dropped,

package/node_modules/projectstore/scripts/configure-menu.mjs

@@ -16,12 +16,15 @@
 
 import * as term from "./term.mjs";
 import { createMenu, renderMenu, seg, SMALLEST } from "./menu.mjs";
-import { knownModels, readLive } from "./models.mjs";
+import { knownModels, readLive, effortSpec, effortLevels } from "./models.mjs";
 import { loadHarness } from "./harness.mjs";
 import { readOverlayAt } from "./lib.mjs";
 
 const CLEAR = "-";
 
+// What an effort row sets: the settings panel's first sentence for it.
+const EFFORT = "How long the agent thinks before it answers: a higher level is slower and costs more.";
+
 // What each agent of the roster does: the settings panel's first sentence.
 const ROLE = Object.freeze({
   default: "The model for every agent that has none of its own.",
@@ -264,15 +267,17 @@ function agentsGroup(f, id, list, catalogs, { menu, now, caps: c }) {
     return d ? (menu?.() ? menu().eff(d) : d.value) : null;
   };
   for (const s of list) {
-    const name = s.key.slice(7);
+    const isEffort = s.rail === "effort";
+    const name = isEffort ? s.key.slice(7, -7) : s.key.slice(7);
     const isDefault = name === "default";
     if (s.source === "unparseable") {
       items.push({
         id: `${id}:${s.key}`,
         key: s.key,
         harness: id,
-        label: name,
-        title: `${display} · ${name}`,
+        label: isEffort ? "effort" : name,
+        ...(isEffort ? { indent: 2, path: `${name} · effort` } : {}),
+        title: `${display} · ${name}${isEffort ? " · effort" : ""}`,
         kind: "info",
         value: null,
         tag: SOURCE.unparseable,
@@ -280,6 +285,10 @@ function agentsGroup(f, id, list, catalogs, { menu, now, caps: c }) {
       });
       continue;
     }
+    if (isEffort) {
+      items.push(effortItem(h, display, id, s, name, isDefault, o, items, catalogs, { defaultNow, menu, now }));
+      continue;
+    }
     const item = {
       id: `${id}:${s.key}`,
       key: s.key,
@@ -314,11 +323,127 @@ function agentsGroup(f, id, list, catalogs, { menu, now, caps: c }) {
   return {
     title: `Agents · ${display}`,
     footer: file.split("/").pop(),
-    description: `Which model each projectstore agent runs on in ${display}${h?.agent_translation?.models?.spawn_takes === "id" ? `, in ${display}'s own model names` : ""}. A model set here goes to ${file}, which is committed, so it applies to everyone on this project. default covers every agent without a model of its own.`,
+    description: `Which model each projectstore agent runs on in ${display}${h?.agent_translation?.models?.spawn_takes === "id" ? `, in ${display}'s own model names` : ""}, and at what effort. A model or an effort set here goes to ${file}, which is committed, so it applies to everyone on this project. default covers every agent without one of its own.`,
     items,
   };
 }
 
+// An agent's effort row (the effort ADR, decision 4): under its model row,
+// its value its own level, else the default's, else what the harness does
+// with none; its values the levels of the model it will run on, a model
+// change waiting in the menu counted.
+function effortItem(h, display, id, s, name, isDefault, o, items, catalogs, { defaultNow, menu, now }) {
+  const es = effortSpec(h);
+  const own = isDefault ? o.efforts.default || null : o.efforts.per_agent[name] || null;
+  const eff = (it) => (it ? (menu?.() ? menu().eff(it) : it.value) : null);
+  const modelItem = items.find((x) => x.key === (isDefault ? "agents.default" : `agents.${name}`));
+  const defaultEffortItem = () => items.find((x) => x.key === "agents.default.effort");
+  // The model this agent will run on: its own, else the default's.
+  const runModel = () => eff(modelItem) || (isDefault ? null : defaultNow()) || null;
+  const defaultEffortNow = () => (isDefault ? null : eff(defaultEffortItem()));
+  const levelsNow = () => effortLevels(h, runModel(), catalogs[id]?.known || null);
+  // What runs when nothing is configured: the frontmatter's level, or, where
+  // a passed model's own default runs, that level when its list names it.
+  const unsetText = () => {
+    const m = runModel();
+    const d = es.unset.model_default && m ? levelsNow()?.default : null;
+    return d ? `${d} (${m}'s default)` : es.unset.value;
+  };
+  const unsetMeaning = es.unset.model_default
+    ? "each agent runs at its model's own default level"
+    : "each agent runs at its frontmatter's effort";
+  const item = {
+    id: `${id}:${s.key}`,
+    key: s.key,
+    harness: id,
+    label: "effort",
+    indent: 2,
+    path: `${name} · effort`,
+    title: `${display} · ${name} · effort`,
+    kind: "choice",
+    value: own,
+    tag: own ? (isDefault ? SOURCE.overlay : SOURCE.per_agent) : isDefault ? SOURCE.default : "",
+    display: (v) => {
+      if (v) return v;
+      const d = defaultEffortNow();
+      return d ? `${d} (default)` : unsetText();
+    },
+  };
+  item.describe = (v, changed) => {
+    if (changed) return `${EFFORT} In the file: ${item.display(item.value)}. After the change: ${item.display(v)}.`;
+    if (isDefault)
+      return `${EFFORT} ${v ? `Now: ${v}, for every agent without its own.` : `Now: not set, so ${unsetMeaning}.`}`;
+    if (v) return `${EFFORT} Now: ${v}, its own.`;
+    const d = defaultEffortNow();
+    return `${EFFORT} ${d ? `Now: ${d}, from default.` : `Now: ${item.display(null)}.`}`;
+  };
+  item.options = () =>
+    effortOptions(es, display, item, name, isDefault, levelsNow(), runModel(), defaultEffortNow(), menu);
+  item.caption = () => {
+    const l = levelsNow();
+    if (!l) return null;
+    if (l.from === "catalog")
+      return {
+        text: `levels of ${l.model}${l.source ? ` · ${l.source}` : ""}${l.at ? ` · checked ${checkedWhen(l.at, now())}` : ""}`,
+      };
+    return { text: `${display}'s levels` };
+  };
+  return item;
+}
+
+// An effort row's values: the levels, the value in the file when the list
+// lacks it, then the way back to the default. No free text and no refresh:
+// the levels come with the model list, whose frame refreshes it.
+function effortOptions(es, display, item, name, isDefault, levels, model, d, menu) {
+  const opts = (levels?.levels || []).map((l, i) => ({
+    value: l.id,
+    label: l.id,
+    kind: "value",
+    note: l.id === levels.default ? "default" : "",
+    section: i === 0 ? (levels.from === "catalog" ? `levels of ${model}` : `${display}'s levels`) : undefined,
+    description: [
+      l.description ? (/[.!?]$/.test(l.description) ? l.description : `${l.description}.`) : "",
+      l.id === levels.default ? `${model}'s own default.` : "",
+    ]
+      .filter(Boolean)
+      .join(" "),
+  }));
+  const m = menu?.();
+  for (const v of [item.value, m ? m.eff(item) : null])
+    if (v && !opts.some((o) => o.value === v))
+      opts.push({
+        value: v,
+        label: v,
+        note: "not in the list",
+        kind: "value",
+        section: opts.length ? undefined : "",
+        description: model
+          ? `Not a level ${model} lists. It is kept as it is.`
+          : `Not one of ${display}'s levels. It is kept as it is.`,
+      });
+  const meaning = es.unset.model_default ? "its model's own default level" : "its frontmatter's effort";
+  opts.push(
+    isDefault
+      ? {
+          value: null,
+          label: es.unset.row,
+          kind: "value",
+          section: "",
+          description: `Drops the default effort: each agent without its own runs at ${meaning}.`,
+        }
+      : {
+          value: null,
+          label: "use the default",
+          kind: "value",
+          section: "",
+          description: d
+            ? `Drops ${name}'s own effort: it runs at the default, ${d}.`
+            : `Drops ${name}'s own effort: it runs at ${meaning}.`,
+        },
+  );
+  return opts;
+}
+
 // The values frame's footer: the list's source and age, the host being
 // asked, or why nothing can be asked (the ADR, decisions 3 and 6).
 function caption(cat, now) {
@@ -502,8 +627,10 @@ export async function runMenu(ctx) {
   menu = createMenu({
     groups,
     onRefresh: (it) => it.harness && read(it.harness),
+    // A list is read from a model's frame only: an effort frame shows what is
+    // known, and its levels follow when a model's list is refreshed.
     onOpen: (it) => {
-      const cat = it.harness ? catalogs[it.harness] : null;
+      const cat = it.harness && !it.key?.endsWith(".effort") ? catalogs[it.harness] : null;
       if (cat?.known?.stale) read(it.harness);
     },
   });

package/node_modules/projectstore/scripts/configure.mjs

@@ -22,6 +22,7 @@ import {
 import {
   readOverlayAt,
   resolveAgentModel,
+  resolveAgentEffort,
   layoutRoster,
   readVaultConfigStrict,
   nextVaultConfig,
@@ -35,7 +36,15 @@ import { bandKeys, epicIds, planBand, applyBand } from "./band.mjs";
 import { planAgentsChange, applyAgentsChange } from "./agents-change.mjs";
 import { plan as planInstall, apply as applyInstall, planOptions, isInteractive } from "./install-harness.mjs";
 import { analyseLayout } from "./surfaces.mjs";
-import { knownModels, offListNote } from "./models.mjs";
+import {
+  knownModels,
+  offListNote,
+  effortSpec,
+  effortLevels,
+  offLevelNote,
+  standingLevelNote,
+  LEVEL,
+} from "./models.mjs";
 import { runMenu } from "./configure-menu.mjs";
 import { SMALLEST } from "./menu.mjs";
 
@@ -76,6 +85,7 @@ export function readFacts(project, { env = process.env, root, home = homedir() }
   return {
     project,
     home,
+    env,
     path,
     cfg,
     used,
@@ -108,6 +118,29 @@ export function settingsOf(f) {
     const o = readOverlayAt(f.project, h.id);
     const file = where(f, o.path);
     const base = { group: `agents:${h.id}`, harness: h.id, file, class: "changeable", team: true, writer: "overlay" };
+    // Each model setting is followed by its effort setting, where the harness
+    // passes one at spawn (the effort ADR, decisions 1 and 4). An effort that
+    // nothing configures reads as the harness says: the frontmatter's, or the
+    // model's own default level, named when its catalog entry is known.
+    const es = effortSpec(h);
+    const known = es?.unset?.model_default ? knownModels(h, { env: f.env, home: f.home }) : null;
+    // frontmatter: the agent's own; model_default: the passed model's own
+    // default, named; harness: the harness's own precedence (no model passed,
+    // or none whose default is known).
+    const unsetEffort = (model) => {
+      if (!es?.unset?.model_default) return { source: "frontmatter" };
+      const d = model ? effortLevels(h, model, known)?.default : null;
+      return d ? { source: "model_default", model_default: d } : { source: "harness" };
+    };
+    const effortRow = (key, effort, effortSource, model) =>
+      es &&
+      out.push({
+        ...base,
+        key,
+        value: effort || null,
+        ...(o.unparseable ? { source: "unparseable" } : effort ? { source: effortSource } : unsetEffort(model)),
+        rail: "effort",
+      });
     out.push({
       ...base,
       key: "agents.default",
@@ -115,7 +148,10 @@ export function settingsOf(f) {
       source: o.unparseable ? "unparseable" : o.agents.default ? "overlay" : "frontmatter",
       rail: "model",
     });
-    const names = [...new Set([...(f.roster || []), ...Object.keys(o.agents.per_agent)])];
+    effortRow("agents.default.effort", o.efforts.default, "overlay", o.agents.default);
+    const names = [
+      ...new Set([...(f.roster || []), ...Object.keys(o.agents.per_agent), ...Object.keys(o.efforts.per_agent)]),
+    ];
     for (const n of names) {
       const r = resolveAgentModel(f.project, n, { harness: h.id });
       out.push({
@@ -125,6 +161,8 @@ export function settingsOf(f) {
         source: o.unparseable ? "unparseable" : r.source || "frontmatter",
         rail: "model",
       });
+      const e = resolveAgentEffort(f.project, n, { harness: h.id });
+      effortRow(`agents.${n}.effort`, e.effort, e.source, r.model);
     }
   }
   if (f.slot)
@@ -239,11 +277,13 @@ function setForm(s, f) {
       ? "on|off"
       : s.key === "tags"
         ? "<a,b>"
-        : s.key.startsWith("agents.")
-          ? "<model>"
-          : s.key === "band.epic"
-            ? "<epic>"
-            : `<${s.key}>`;
+        : s.rail === "effort"
+          ? "<level>"
+          : s.key.startsWith("agents.")
+            ? "<model>"
+            : s.key === "band.epic"
+              ? "<epic>"
+              : `<${s.key}>`;
   const h = s.harness && f.used.length > 1 ? ` --harness ${s.harness}` : "";
   return `--set ${s.key}=${value}${h}`;
 }
@@ -266,8 +306,10 @@ export function resolveSets(f, sets, { harness = null, nearest = null } = {}) {
     const value = String(raw)
       .slice(at + 1)
       .trim();
-    const m = /^agents\.([a-z][a-z0-9-]*)(?:\.model)?$/.exec(key);
-    if (m) key = `agents.${m[1]}`;
+    // agents.<name> and agents.<name>.model are one key; agents.<name>.effort
+    // is a key of its own (the effort ADR, decision 4).
+    const m = /^agents\.([a-z][a-z0-9-]*)(?:\.(model|effort))?$/.exec(key);
+    if (m) key = m[2] === "effort" ? `agents.${m[1]}.effort` : `agents.${m[1]}`;
     if (seen.has(key)) return { usage: `${key} is named twice` };
     seen.add(key);
     if (m) {
@@ -280,6 +322,19 @@ export function resolveSets(f, sets, { harness = null, nearest = null } = {}) {
         else return { usage: `name the overlay: --harness <id> (this project uses ${harnessesNamed})` };
       }
       if (!harnessIds().includes(h)) return { usage: `unknown harness: ${h} — known: ${harnessIds().join(", ")}` };
+      if (m[2] === "effort") {
+        const manifest = loadHarness(h);
+        const es = effortSpec(manifest);
+        if (!es) return { usage: `${manifest?.display_name || h} takes no effort at spawn: ${key} has nothing to set` };
+        // A lowercase token, or - to clear; a level the harness does not list
+        // is written with a note, not refused (decision 5).
+        if (value !== CLEAR && !LEVEL.test(value))
+          return {
+            usage: `${key} takes a level (${es.levels.map((l) => l.id).join(", ")}), or ${CLEAR} to clear it, got ${value || "nothing"}`,
+          };
+        out.push({ key, writer: "overlay", harness: h, name, field: "effort", value: value === CLEAR ? null : value });
+        continue;
+      }
       if (!value) return { usage: `${key} takes a model, or ${CLEAR} to clear it` };
       out.push({ key, writer: "overlay", harness: h, name, value: value === CLEAR ? null : value });
       continue;
@@ -434,14 +489,19 @@ export function planChanges(f, changes, { env = process.env, home = homedir(), r
   for (const [h, list] of byHarness) {
     const before = readOverlayAt(f.project, h);
     if (before.unparseable) return refuse(`${before.path} is not valid JSON — fix or remove it first`);
-    const def = list.find((c) => c.name === "default");
+    const models = list.filter((c) => c.field !== "effort");
+    const efforts = list.filter((c) => c.field === "effort");
+    const def = models.find((c) => c.name === "default");
+    const defEffort = efforts.find((c) => c.name === "default");
     const change = planAgentsChange({
       before,
       harness: h,
       layout: f.cfg.layout,
       roster: f.roster,
       defaultModel: def ? def.value || "" : undefined,
-      agents: list.filter((c) => c.name !== "default").map((c) => `${c.name}=${c.value || ""}`),
+      agents: models.filter((c) => c.name !== "default").map((c) => `${c.name}=${c.value || ""}`),
+      defaultEffort: defEffort ? defEffort.value || "" : undefined,
+      efforts: efforts.filter((c) => c.name !== "default").map((c) => `${c.name}=${c.value || ""}`),
     });
     if (change.usage) return { usage: change.usage };
     if (change.same) continue;
@@ -452,11 +512,47 @@ export function planChanges(f, changes, { env = process.env, home = homedir(), r
     // 8 as amended 2026-10-13): the model may be newer than the list.
     // Only a model the run names gets the note: the clerk's pin does not.
     const known = knownModels(manifest, { env, home });
-    const named = new Map(list.map((c) => [c.name, c.value]));
+    const named = new Map(models.map((c) => [c.name, c.value]));
     const offList = (name, model) => (model && named.get(name) === model ? offListNote(manifest, model, known) : null);
     const notes = (...xs) => xs.filter(Boolean).join("; ") || null;
+    // Effort against the model each agent runs on after the run (the effort
+    // ADR, decision 5): a level the run names is checked on its own row; a
+    // model the run changes is checked against the level its agents keep, on
+    // the model's row; a default level the run names is checked against every
+    // agent that inherits it on a model of its own, on the default's row.
+    const ne = change.nextEfforts;
+    const namedEffort = new Map(efforts.map((c) => [c.name, c.value]));
+    const roster = [
+      ...new Set([...(f.roster || []), ...Object.keys(change.next.per_agent), ...Object.keys(ne.per_agent)]),
+    ];
+    const runModel = (n) => (n === "default" ? change.next.default : change.next.per_agent[n] || change.next.default);
+    const runEffort = (n) => (n === "default" ? ne.default : ne.per_agent[n] || ne.default) || null;
+    const levelNote = (n, level) =>
+      level && namedEffort.get(n) === level ? offLevelNote(manifest, level, runModel(n) || null, known) : null;
+    const inheritors = (level) =>
+      level && namedEffort.get("default") === level
+        ? roster
+            .filter(
+              (n) => !ne.per_agent[n] && change.next.per_agent[n] && change.next.per_agent[n] !== change.next.default,
+            )
+            .map((n) => standingLevelNote(manifest, n, level, runModel(n), known))
+            .filter(Boolean)
+            .join("; ") || null
+        : null;
+    // Agents a model change moves, and the level each keeps, when that level
+    // was not named by this run (a named one is checked on its own row).
+    const moved = (n) => {
+      const who = n === "default" ? ["default", ...roster.filter((r) => !change.next.per_agent[r])] : [n];
+      return (
+        who
+          .filter((a) => !namedEffort.has(a) && !(a !== "default" && !ne.per_agent[a] && namedEffort.has("default")))
+          .map((a) => standingLevelNote(manifest, a, runEffort(a), runModel(a) || null, known))
+          .filter(Boolean)
+          .join("; ") || null
+      );
+    };
     if (before.agents.default !== change.next.default) {
-      const listNote = offList("default", change.next.default);
+      const listNote = notes(offList("default", change.next.default), moved("default"));
       items.push({
         key: "agents.default",
         harness: h,
@@ -474,7 +570,7 @@ export function planChanges(f, changes, { env = process.env, home = homedir(), r
       const a = before.agents.per_agent[n] || null;
       const b = change.next.per_agent[n] || null;
       if (a === b) continue;
-      const listNote = offList(n, b);
+      const listNote = notes(offList(n, b), moved(n));
       items.push({
         key: `agents.${n}`,
         harness: h,
@@ -501,7 +597,43 @@ export function planChanges(f, changes, { env = process.env, home = homedir(), r
         team: true,
         note: `${display} declares no cheap model to pin the clerk to; set agents.clerk to name one`,
       });
-    steps.push({ writer: "overlay", harness: h, next: change.next });
+    const beforeEfforts = before.efforts;
+    if (beforeEfforts.default !== ne.default) {
+      const listNote = notes(levelNote("default", ne.default), inheritors(ne.default));
+      items.push({
+        key: "agents.default.effort",
+        harness: h,
+        display,
+        file,
+        before: shown(beforeEfforts.default),
+        after: shown(ne.default),
+        team: true,
+        note: listNote,
+        listNote,
+      });
+    }
+    const effortNames = new Set([...Object.keys(beforeEfforts.per_agent), ...Object.keys(ne.per_agent)]);
+    for (const n of [...effortNames].sort()) {
+      const a = beforeEfforts.per_agent[n] || null;
+      const b = ne.per_agent[n] || null;
+      if (a === b) continue;
+      const listNote = levelNote(n, b);
+      items.push({
+        key: `agents.${n}.effort`,
+        harness: h,
+        display,
+        file,
+        before: shown(a),
+        after: shown(b),
+        team: true,
+        note: notes(
+          change.pinnedClerkEffort && n === "clerk" ? "pinned: the clerk stays cheap under a strong default" : null,
+          listNote,
+        ),
+        listNote,
+      });
+    }
+    steps.push({ writer: "overlay", harness: h, next: change.next, nextEfforts: ne });
   }
 
   // The status line: install's own plan for the surface, with its flag item
@@ -602,7 +734,7 @@ export function applyChanges(f, steps, { env = process.env, home = homedir(), ro
         writeVaultConfig(f.vault, nextVaultConfig(now.cfg, s.patch, new Date().toISOString()));
         wrote.push(vaultConfigPath(f.vault));
       } else if (s.writer === "overlay") {
-        wrote.push(applyAgentsChange(f.project, s.harness, s.next).path);
+        wrote.push(applyAgentsChange(f.project, s.harness, s.next, s.nextEfforts).path);
       } else if (s.writer === "statusline") {
         const finished = [];
         try {
@@ -640,6 +772,8 @@ const SOURCE_TEXT = Object.freeze({
   per_agent: "per agent",
   default: "default",
   frontmatter: "its frontmatter",
+  model_default: "its model's own default",
+  harness: "the harness decides",
   binding: "binding",
   vault_config: "vault config",
   unparseable: "not valid JSON: fix the file to change it",
@@ -675,9 +809,11 @@ export function renderView(f, settings, { caps: c = term.PLAIN } = {}) {
           note:
             s.class === "other-verb"
               ? "changed by another command, below"
-              : s.class === "changeable" && !s.rail
-                ? `${SOURCE_TEXT[s.source] || s.source}; change it with ${s.set}`
-                : SOURCE_TEXT[s.source] || s.source,
+              : s.source === "model_default" && s.model_default
+                ? `${SOURCE_TEXT.model_default}, ${s.model_default}`
+                : s.class === "changeable" && !s.rail
+                  ? `${SOURCE_TEXT[s.source] || s.source}; change it with ${s.set}`
+                  : SOURCE_TEXT[s.source] || s.source,
         })),
       ),
     );
@@ -764,6 +900,7 @@ export async function runConfigure(ctx) {
     harness: s.harness || null,
     team: s.team,
     set: s.set,
+    ...(s.model_default ? { model_default: s.model_default } : {}),
   }));
   const interactive =
     !json && (ask ? true : isInteractive({ stdin, stdout, env, json })) && term.railAvailable(stdin, c);