@gethmy/agent 1.45.0 → 1.47.0

package/README.md

@@ -19,10 +19,6 @@ Built for **failsafe auto mode**: crashed daemons recover on restart, misconfigu
 npm i -g @gethmy/cli
 hmy agent
 
-# Or the daemon package alone
-npm install -g @gethmy/agent
-harmony-agent
-
 # Or nothing installed at all (works with any package manager)
 npx @gethmy/agent@latest
 ```
@@ -30,12 +26,11 @@ npx @gethmy/agent@latest
 Install when the machine is yours; use `npx` for a container, a CI step or a
 one-off. Both forms stay supported.
 
-> **Always pin `@latest`.** A bare `npx @gethmy/agent` reuses any previously
-> cached version that satisfies the spec — so an old install in `~/.npm/_npx`
-> can shadow the current release and you'll get stale startup logs and CLI
-> behavior. `npx @gethmy/agent@latest` re-resolves to the newest published
-> version. If you ever suspect a stale run, clear the cache with
-> `rm -rf ~/.npm/_npx` (or install globally to skip npx caching entirely).
+> **`npx` can serve a stale build.** The npx cache keeps serving the version it
+> first installed, `@latest` included — a restart six minutes after 1.38.0
+> published still ran 1.37.0 — so you get stale startup logs and CLI behavior.
+> If you suspect a stale run, clear the cache with `rm -rf ~/.npm/_npx`, or
+> install `@gethmy/cli` and run `hmy agent` to skip npx caching entirely.
 
 ## Configuration
 

package/dist/cli.js

@@ -1103,9 +1103,14 @@ var init_commentSerializer = __esm(() => {
 });
 
 // ../harmony-shared/src/connectCommands.ts
-var HMY_INSTALL_URL = "https://gethmy.com/install.sh", HMY_INSTALL_COMMAND;
+function hmyConnectCommand(projectSlug) {
+  const slug = projectSlug?.trim();
+  return slug ? `${CONNECT_VERB} ${slug}` : CONNECT_VERB;
+}
+var HMY_INSTALL_URL = "https://gethmy.com/install.sh", HMY_INSTALL_COMMAND, HMY_AGENT_COMMAND = "hmy agent", CONNECT_VERB = "hmy connect", HOSTED_MCP_URL = "https://mcp.gethmy.com/mcp", HOSTED_MCP_CONFIG;
 var init_connectCommands = __esm(() => {
   HMY_INSTALL_COMMAND = `curl -fsSL ${HMY_INSTALL_URL} | bash`;
+  HOSTED_MCP_CONFIG = JSON.stringify({ mcpServers: { harmony: { type: "http", url: HOSTED_MCP_URL } } }, null, 2);
 });
 
 // ../harmony-shared/src/constants.ts
@@ -1578,6 +1583,18 @@ function own(source, key) {
   return Object.hasOwn(source, key) ? source[key] : undefined;
 }
 
+// ../harmony-shared/src/packageCommands.ts
+function npxArgs(pkg, args) {
+  return ["-y", `${SCOPE}/${pkg}@latest`, ...args];
+}
+function npxCommand(pkg, args = []) {
+  return ["npx", ...npxArgs(pkg, args)].join(" ");
+}
+var SCOPE = "@gethmy", HMY_NPM_INSTALL_COMMAND;
+var init_packageCommands = __esm(() => {
+  HMY_NPM_INSTALL_COMMAND = `npm i -g ${SCOPE}/cli`;
+});
+
 // ../harmony-shared/src/parsedState.ts
 function parseJsonWithoutPrototypes(text) {
   return JSON.parse(text, (_key, value) => {
@@ -2575,6 +2592,7 @@ var init_src = __esm(() => {
   init_gateEvaluate();
   init_logger();
   init_memoryQuery();
+  init_packageCommands();
   init_playbookAutoBind();
   init_playbookCatalog();
   init_playbookStage();
@@ -3516,7 +3534,7 @@ function agentIdentifier(workerId) {
 function endStatusForCancel(reason) {
   return reason === "human_stop" ? "cancelled" : "paused";
 }
-var DEFAULT_FINDING_AUTHORS, DEFAULT_AGENT_CONFIG, IN_PROGRESS_COLUMN = "In Progress", NEED_REVIEW_LABEL = "Need Review", NEED_REVIEW_LABEL_COLOR = "#f59e0b", REVIEW_FAILURE_REASON_MAX = 300, AGENT_NAME = "Harmony Agent", DAEMON_IDENTIFIER_BASE = "harmony-daemon", NOTICE_IDENTIFIER;
+var DEFAULT_FINDING_AUTHORS, DEFAULT_HUMAN_STAGE_HOLD_MINUTES = 60, DEFAULT_AGENT_CONFIG, IN_PROGRESS_COLUMN = "In Progress", NEED_REVIEW_LABEL = "Need Review", NEED_REVIEW_LABEL_COLOR = "#f59e0b", REVIEW_FAILURE_REASON_MAX = 300, AGENT_NAME = "Harmony Agent", DAEMON_IDENTIFIER_BASE = "harmony-daemon", NOTICE_IDENTIFIER;
 var init_types = __esm(() => {
   init_src();
   init_board_review();
@@ -3548,12 +3566,12 @@ var init_types = __esm(() => {
       postSummary: true
     },
     claude: {
-      model: "claude-opus-5",
+      model: "claude-opus-5-5",
       escalateModel: "claude-fable-5-1",
       escalateAfterAttempts: 2,
       tiers: {
         simple: "claude-sonnet-5",
-        advanced: "claude-opus-5",
+        advanced: "claude-opus-5-5",
         research: "claude-fable-5-1"
       },
       scoreBands: DEFAULT_SCORE_BANDS,
@@ -3660,7 +3678,12 @@ var init_types = __esm(() => {
       runLogDays: 30
     },
     planning: DEFAULT_PLANNING_CONFIG,
-    playbooks: { enabled: true, humanStageColumns: [], metrics: {} },
+    playbooks: {
+      enabled: true,
+      humanStageColumns: [],
+      humanStageHoldMinutes: DEFAULT_HUMAN_STAGE_HOLD_MINUTES,
+      metrics: {}
+    },
     contractFirst: DEFAULT_CONTRACT_CONFIG,
     boardReview: DEFAULT_BOARD_REVIEW_CONFIG,
     sweep: {
@@ -4041,13 +4064,13 @@ function loadDaemonConfig() {
   const projectId = getActiveProjectId(repoRoot);
   const userEmail = getUserEmail();
   if (!workspaceId) {
-    throw new Error(`No active workspace configured in ${contextSource.path}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No active workspace configured in ${contextSource.path}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   if (!projectId) {
-    throw new Error(`No active project configured in ${contextSource.path}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No active project configured in ${contextSource.path}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   if (!userEmail) {
-    throw new Error(`No user email configured in ${contextSource.globalPath}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No user email configured in ${contextSource.globalPath}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   let agentOverrides = {};
   let agentName = "Harmony Agent";
@@ -4160,6 +4183,7 @@ function createApiClient(config) {
 }
 var TAG5 = "config", NOT_A_REPOSITORY_EXIT = 128, warnedLegacyConfigDir = false;
 var init_config = __esm(() => {
+  init_src();
   init_config_merge();
   init_config_validation();
   init_paths();
@@ -8817,7 +8841,7 @@ class StateStore {
     const rec = this.getCard(cardId);
     if (!rec)
       return;
-    if (rec.attempts === 0 && !rec.ciRepairAttempts && rec.ciRepairParkedAt == null && (!clearTurns || !rec.totalTurns && !rec.runStarts)) {
+    if (rec.attempts === 0 && !rec.ciRepairAttempts && rec.ciRepairParkedAt == null && rec.stageHold == null && (!clearTurns || !rec.totalTurns && !rec.runStarts)) {
       return;
     }
     rec.attempts = 0;
@@ -8827,6 +8851,7 @@ class StateStore {
       rec.totalTurns = 0;
     if (clearTurns)
       rec.runStarts = 0;
+    rec.stageHold = null;
     await this.persist();
   }
   getCiRepairAttempts(cardId) {
@@ -8909,6 +8934,29 @@ class StateStore {
   getCardRunStarts(cardId) {
     return this.getCard(cardId)?.runStarts ?? 0;
   }
+  getStageHold(cardId) {
+    return this.getCard(cardId)?.stageHold ?? null;
+  }
+  async recordStageHold(cardId, hold) {
+    const rec = this.ensureCard(cardId);
+    const prior = rec.stageHold ?? null;
+    const announced = prior != null && prior.stageId === hold.stageId && prior.reason === hold.reason;
+    rec.stageHold = cloneWithoutPrototype({
+      stageId: hold.stageId,
+      reason: hold.reason,
+      until: hold.untilMs,
+      announcedAt: announced ? prior.announcedAt : Date.now()
+    });
+    await this.persist();
+    return { announced };
+  }
+  async clearStageHold(cardId) {
+    const rec = this.getCard(cardId);
+    if (!rec || rec.stageHold == null)
+      return;
+    rec.stageHold = null;
+    await this.persist();
+  }
   getCardCostCents(cardId) {
     return this.getCard(cardId)?.totalCostCents ?? 0;
   }
@@ -10219,6 +10267,27 @@ class SleepGuard {
 var TAG26 = "sleep-guard";
 var init_sleep_guard = () => {};
 
+// src/stage-hold.ts
+function classifyStageHold(card, hold, nowMs) {
+  if (!hold)
+    return { kind: "none" };
+  if (!card.current_stage || card.current_stage !== hold.stageId) {
+    return { kind: "stale" };
+  }
+  if (nowMs >= hold.until)
+    return { kind: "lapsed" };
+  const remainingMin = Math.ceil((hold.until - nowMs) / 60000);
+  return {
+    kind: "holding",
+    detail: `parked on human-owned stage "${hold.stageId}" — holding for ~${remainingMin}m`
+  };
+}
+function stageHoldUntil(holdMinutes, nowMs) {
+  if (!Number.isFinite(holdMinutes) || holdMinutes <= 0)
+    return nowMs;
+  return nowMs + holdMinutes * 60000;
+}
+
 // src/unblock.ts
 import { log as log30 } from "@gethmy/harness";
 async function fetchBlocksLinks(client, cardId) {
@@ -11455,6 +11524,29 @@ var init_stage_advance = __esm(() => {
 });
 
 // src/workspace-model-config.ts
+function layerPlatformDefaults(platform, ws) {
+  if (!platform)
+    return ws ?? null;
+  if (!ws)
+    return platform;
+  const merged = { ...platform };
+  for (const [key, value] of Object.entries(ws)) {
+    if (value !== null && value !== undefined) {
+      merged[key] = value;
+    }
+  }
+  if (platform.tiers || ws.tiers) {
+    const tiers = {};
+    for (const layer of [platform.tiers, ws.tiers]) {
+      for (const [tier, model] of Object.entries(layer ?? {})) {
+        if (model)
+          tiers[tier] = model;
+      }
+    }
+    merged.tiers = tiers;
+  }
+  return merged;
+}
 function workspaceConfigToPartial(ws) {
   const claude = {};
   if (ws.implement_model)
@@ -11503,6 +11595,15 @@ function resolveEffectiveAgentConfig(cfg, ws) {
   const withWorkspace = ws ? mergeAgentConfig(DEFAULT_AGENT_CONFIG, workspaceConfigToPartial(ws)) : DEFAULT_AGENT_CONFIG;
   return mergeAgentConfig(mergeAgentConfig(withWorkspace, cfg.agentOverrides), cfg.repoAgentOverrides);
 }
+function withdrawnMapFrom(models) {
+  const withdrawn = {};
+  for (const m of models) {
+    if (m.status === "withdrawn" && m.replaced_by) {
+      withdrawn[m.id] = m.replaced_by;
+    }
+  }
+  return withdrawn;
+}
 var init_workspace_model_config = __esm(() => {
   init_config_merge();
   init_types();
@@ -11977,7 +12078,7 @@ class Worker {
       stageCtx = await this.resolveStageContext(card);
       if (stageCtx.kind === "hold") {
         this.held = true;
-        await this.holdStageCard(card, stageCtx.reason, stageCtx.wait);
+        await this.holdStageCard(card, stageCtx.reason, stageCtx.wait, stageCtx.wait);
         return;
       }
       if (stageCtx.kind === "fanout") {
@@ -12535,15 +12636,35 @@ class Worker {
       }
     }
   }
-  async holdStageCard(card, reason, wait = false) {
+  async holdStageCard(card, reason, wait = false, armCooldown = false) {
     log34.info(this.tag, `Holding #${card.short_id}: ${reason}`);
     await this.stateStore.decrementAttempt(card.id);
-    try {
-      await this.client.addComment(card.id, reason, {
-        commentType: "blocker",
-        agentSessionId: this.sessionId ?? undefined
-      });
-    } catch {}
+    let announced = false;
+    const holdStage = armCooldown ? card.current_stage : null;
+    if (holdStage) {
+      try {
+        const recorded = await this.stateStore.recordStageHold(card.id, {
+          stageId: holdStage,
+          reason,
+          untilMs: stageHoldUntil(this.config.playbooks.humanStageHoldMinutes ?? DEFAULT_HUMAN_STAGE_HOLD_MINUTES, Date.now())
+        });
+        announced = recorded.announced;
+      } catch (err) {
+        log34.warn(this.tag, `stage hold not recorded on #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+      }
+    }
+    if (announced) {
+      log34.debug(this.tag, `#${card.short_id} already carries this blocker — not reposting`);
+    } else {
+      try {
+        await this.client.addComment(card.id, reason, {
+          commentType: "blocker",
+          agentSessionId: this.sessionId ?? undefined
+        });
+      } catch {
+        await this.stateStore.clearStageHold(card.id).catch(() => {});
+      }
+    }
     try {
       await runTransition(this.client, card, {
         removeLabels: ["agent"],
@@ -13970,19 +14091,10 @@ class Pool {
     this.reviewQueue = new PriorityQueue(config);
     this.budget = new BudgetGuard(config.budget, this.stateStore);
     const workspaceModels = daemonConfig ? new WorkspaceModelCache(async () => {
-      const { config: wsConfig } = await client.getWorkspaceModelConfig(workspaceId);
-      return wsConfig ?? null;
-    }) : undefined;
-    const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => {
-      const { models } = await client.getModelCatalog();
-      const withdrawn = {};
-      for (const m of models) {
-        if (m.status === "withdrawn" && m.replaced_by) {
-          withdrawn[m.id] = m.replaced_by;
-        }
-      }
-      return withdrawn;
+      const { config: wsConfig, platformDefaults } = await client.getWorkspaceModelConfig(workspaceId);
+      return layerPlatformDefaults(platformDefaults, wsConfig);
     }) : undefined;
+    const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => withdrawnMapFrom((await client.getModelCatalog()).models)) : undefined;
     const reportedConfig = daemonConfig ? new ReportedConfigCache(client, effectiveModelReport(config)) : undefined;
     for (let i = 0;i < config.poolSize; i++) {
       this.implWorkers.push(new Worker(i, config, client, this.identity, () => {
@@ -14038,6 +14150,14 @@ class Pool {
           await this.emitWaiting(card.id, `Paused — Anthropic API limit, retrying in ~${Math.round(cooldownMs / 1000)}s`);
           return;
         }
+        const stageHold = classifyStageHold(card, this.stateStore.getStageHold(card.id), Date.now());
+        if (stageHold.kind === "holding") {
+          log36.debug(TAG32, `#${card.short_id} held — ${stageHold.detail}`);
+          return;
+        }
+        if (stageHold.kind === "stale") {
+          await this.stateStore.clearStageHold(card.id);
+        }
         const decision = this.budget.check(card.id);
         if (!decision.allow) {
           if (decision.reason === "daily_budget") {
@@ -14736,6 +14856,7 @@ var init_pool = __esm(() => {
   init_unblock();
   init_worker();
   init_workspace_model_cache();
+  init_workspace_model_config();
 });
 
 // src/port-registry.ts
@@ -14974,6 +15095,8 @@ var init_repo_dirs = __esm(() => {
 
 // src/card-trust.ts
 function isTrustedCardAuthor(card, trustedAuthors) {
+  if (card.source != null)
+    return false;
   return card.created_by != null && trustedAuthors.has(card.created_by);
 }
 
@@ -15033,7 +15156,7 @@ async function reclaimPreReviewStrands(opts) {
       continue;
     const daemonBranch = daemonBranches.get(card.id);
     if (!isTrustedCardAuthor(card, trustedAuthors) && daemonBranch !== branch) {
-      log40.debug(TAG36, `#${card.short_id} - skipped: author ${card.created_by ?? "(none)"} is not trusted, and ${daemonBranch ? `the card records ${branch} while this daemon pushed ${daemonBranch}` : "this daemon has pushed no branch for it"}`);
+      log40.debug(TAG36, `#${card.short_id} - skipped: ${card.source != null ? `card was filed externally (source: ${card.source})` : `author ${card.created_by ?? "(none)"} is not trusted`}, and ${daemonBranch ? `the card records ${branch} while this daemon pushed ${daemonBranch}` : "this daemon has pushed no branch for it"}`);
       continue;
     }
     const labels = resolveCardLabels(card, labelMap);
@@ -15271,7 +15394,7 @@ function rankSweepCandidates(opts) {
       continue;
     }
     if (!isTrustedCardAuthor(card, trustedAuthors)) {
-      skip2(card, "untrusted_author", card.created_by == null ? "card has no recorded author" : `author ${card.created_by} is not in sweep.trustedAuthors`);
+      skip2(card, "untrusted_author", card.source != null ? `card was filed externally (source: ${card.source})` : card.created_by == null ? "card has no recorded author" : `author ${card.created_by} is not in sweep.trustedAuthors`);
       continue;
     }
     if (card.assigned_agent_id != null) {
@@ -16107,6 +16230,93 @@ var init_reconcile = __esm(() => {
   init_types();
 });
 
+// src/startup-model.ts
+function describeStartupModel(config, layers, withdrawn) {
+  const workspace = layers?.workspace ?? null;
+  const platform = layers?.platform ?? null;
+  const database = layerPlatformDefaults(platform, workspace);
+  const claude = resolveEffectiveAgentConfig(config, database).claude;
+  const pinned = ownObject(config.agentOverrides, "claude");
+  const pinnedTiers = ownObject(pinned, "tiers");
+  const pinnedModel = ownString(pinned, "model");
+  let source = "built-in default";
+  if (pinnedModel)
+    source = "config.json";
+  else if (workspace?.implement_model)
+    source = "workspace";
+  else if (platform?.implement_model)
+    source = "platform";
+  const warnings = [];
+  const pins = [
+    ["claude.model", pinnedModel, database?.implement_model],
+    [
+      "claude.escalateModel",
+      ownString(pinned, "escalateModel"),
+      database?.escalate_model
+    ],
+    ...TIERS.map((tier) => [
+      `claude.tiers.${tier}`,
+      ownString(pinnedTiers, tier),
+      database?.tiers?.[tier]
+    ])
+  ];
+  for (const [key, local, db] of pins) {
+    if (local && db && local !== db) {
+      warnings.push(`config.json pins ${key} to "${local}", which overrides the database default "${db}" — remove it from config.json to follow the app's model settings`);
+    }
+  }
+  const effective = [
+    ["claude.model", claude.model],
+    ["claude.escalateModel", claude.escalateModel],
+    ...TIERS.map((tier) => [`claude.tiers.${tier}`, claude.tiers[tier]])
+  ];
+  for (const [key, id] of effective) {
+    const replacement = withdrawn?.[id];
+    if (replacement) {
+      warnings.push(`${key} resolves to "${id}", which is withdrawn in the model catalog — runs use its replacement "${replacement}"; update the setting to match`);
+    }
+  }
+  return {
+    model: claude.model,
+    escalateModel: claude.escalateModel,
+    reviewModel: config.agent.claude.reviewModel,
+    source,
+    resolved: layers !== null && withdrawn !== null,
+    warnings
+  };
+}
+async function resolveStartupModel(config, client) {
+  const [layers, withdrawn] = await Promise.all([
+    client.getWorkspaceModelConfig(config.workspaceId).then(({ config: workspace, platformDefaults }) => ({
+      workspace,
+      platform: platformDefaults ?? null
+    })).catch(() => null),
+    client.getModelCatalog().then(({ models }) => withdrawnMapFrom(models)).catch(() => null)
+  ]);
+  return describeStartupModel(config, layers, withdrawn);
+}
+function ownObject(source, key) {
+  if (typeof source !== "object" || source === null)
+    return {};
+  const value = own(source, key);
+  return typeof value === "object" && value !== null ? value : {};
+}
+function ownString(source, key) {
+  const value = own(source, key);
+  return typeof value === "string" && value !== "" ? value : undefined;
+}
+function startupModelLine(m) {
+  const models = m.model === m.escalateModel ? m.model : `${m.model} → ${m.escalateModel} on retry/high · review ${m.reviewModel}`;
+  const origin = m.resolved ? `from ${m.source}` : `from ${m.source}; database model settings unreachable, a pickup may resolve differently`;
+  return `${models} (${origin})`;
+}
+var TIERS;
+var init_startup_model = __esm(() => {
+  init_src();
+  init_workspace_model_config();
+  TIERS = ["simple", "advanced", "research"];
+});
+
 // src/startup-banner.ts
 var exports_startup_banner = {};
 __export(exports_startup_banner, {
@@ -16122,6 +16332,7 @@ function prettyBanner(config, version) {
   let projectName;
   let gitProvider;
   let httpPort;
+  let model;
   let failed = false;
   let rendered = false;
   return {
@@ -16134,6 +16345,9 @@ function prettyBanner(config, version) {
     setHttpPort(port) {
       httpPort = port;
     },
+    setModel(resolved) {
+      model = resolved;
+    },
     check(message) {
       checks.push({ kind: "ok", message });
     },
@@ -16155,6 +16369,7 @@ function prettyBanner(config, version) {
         projectName,
         gitProvider,
         httpPort,
+        model,
         checks,
         readyMessage: message
       });
@@ -16164,12 +16379,13 @@ function prettyBanner(config, version) {
 }
 function jsonBanner(config, version) {
   log45.info(TAG41, `Harmony Agent Daemon v${version} starting...`);
-  log45.info(TAG41, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Model: ${config.agent.claude.model} | Runner: ${config.agent.runner} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
+  log45.info(TAG41, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Runner: ${config.agent.runner} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
   log45.info(TAG41, `Config: ${contextSourceLine(config)}`);
   if (config.agent.review.enabled) {
     log45.info(TAG41, `Review: enabled | Columns: ${config.agent.review.pickupColumns.join(", ")} | → ${config.agent.review.moveToColumn} / ${config.agent.review.failColumn}`);
   }
   let failed = false;
+  let modelLogged = false;
   return {
     setProjectName(_name) {},
     setGitProvider(provider) {
@@ -16178,6 +16394,10 @@ function jsonBanner(config, version) {
     setHttpPort(port) {
       log45.info(TAG41, `HTTP server on port ${port}`);
     },
+    setModel(resolved) {
+      modelLogged = true;
+      log45.info(TAG41, `Model: ${startupModelLine(resolved)}`);
+    },
     check(message) {
       log45.info(TAG41, message);
     },
@@ -16190,6 +16410,8 @@ function jsonBanner(config, version) {
     async ready(message) {
       if (failed)
         return;
+      if (!modelLogged)
+        log45.info(TAG41, `Model: ${localModelLine(config)}`);
       log45.info(TAG41, message);
     }
   };
@@ -16201,6 +16423,7 @@ function renderPretty(input) {
     projectName,
     gitProvider,
     httpPort,
+    model,
     checks,
     readyMessage
   } = input;
@@ -16208,7 +16431,7 @@ function renderPretty(input) {
   lines.push("");
   lines.push(titleRule(`Harmony Agent Daemon v${version}`));
   lines.push("");
-  for (const row of configRows(config, projectName, gitProvider, httpPort)) {
+  for (const row of configRows(config, projectName, gitProvider, httpPort, model)) {
     lines.push(`  ${dim(row.label.padEnd(9))} ${row.value}`);
   }
   lines.push("");
@@ -16222,7 +16445,7 @@ function renderPretty(input) {
   return lines.join(`
 `);
 }
-function configRows(config, projectName, gitProvider, httpPort) {
+function configRows(config, projectName, gitProvider, httpPort, model) {
   const rows = [];
   const projectLabel = projectName ? `${projectName} (${shortenId(config.projectId)})` : shortenId(config.projectId);
   rows.push({ label: "Project", value: projectLabel });
@@ -16231,8 +16454,7 @@ function configRows(config, projectName, gitProvider, httpPort) {
   const reviewEnabled = config.agent.review.enabled;
   const poolDesc = reviewEnabled ? `Pool ${config.agent.poolSize} impl + ${config.agent.review.poolSize} review` : `Pool ${config.agent.poolSize} impl`;
   const flowDesc = reviewEnabled ? `Pickup ${config.agent.pickupColumns[0]} → ${config.agent.completion.moveToColumn} → ${config.agent.review.moveToColumn}` : `Pickup ${config.agent.pickupColumns.join(", ")}`;
-  const { model, escalateModel, reviewModel } = config.agent.claude;
-  const modelDesc = model === escalateModel ? model : `${model} → ${escalateModel} on retry/high · review ${reviewModel}`;
+  const modelDesc = model ? startupModelLine(model) : localModelLine(config);
   rows.push({
     label: "Model",
     value: `${modelDesc}  ·  ${poolDesc}  ·  ${flowDesc}`
@@ -16266,6 +16488,11 @@ function titleRule(title) {
   const suffix = "─".repeat(Math.max(3, RULE_WIDTH - prefix.length - title.length - surround.length));
   return dim(`${prefix}${title}${surround}${suffix}`);
 }
+function localModelLine(config) {
+  const { model, escalateModel, reviewModel } = config.agent.claude;
+  const models = model === escalateModel ? model : `${model} → ${escalateModel} on retry/high · review ${reviewModel}`;
+  return `${models} (local config only; database model settings not read)`;
+}
 function runnerDesc(runner) {
   return runner === "sdk" ? "sdk (Agent SDK)" : "cli (Claude CLI)";
 }
@@ -16286,6 +16513,7 @@ function yellow(s) {
 var TAG41 = "daemon", RULE_WIDTH = 70, ANSI;
 var init_startup_banner = __esm(() => {
   init_port_registry();
+  init_startup_model();
   ANSI = {
     reset: "\x1B[0m",
     dim: "\x1B[2m",
@@ -17643,6 +17871,11 @@ async function main() {
   } catch (err) {
     log50.warn(TAG46, `Could not report model config: ${err instanceof Error ? err.message : String(err)}`);
   }
+  const startupModel = await resolveStartupModel(config, client);
+  banner.setModel(startupModel);
+  for (const warning of startupModel.warnings) {
+    banner.warn(warning);
+  }
   migrateConfigDir();
   try {
     migrateLegacyStateFile({
@@ -17965,6 +18198,7 @@ var init_src2 = __esm(() => {
   init_recovery();
   init_review_worktree();
   init_startup_banner();
+  init_startup_model();
   init_state_migration();
   init_state_store();
   init_stream_parser_selftest();
@@ -18082,7 +18316,7 @@ var init_head_anchor = () => {};
 
 // src/merge-cleanup.ts
 import { execFileSync as execFileSync11 } from "node:child_process";
-import { existsSync as existsSync7, realpathSync as realpathSync2, statSync as statSync6 } from "node:fs";
+import { existsSync as existsSync7, lstatSync as lstatSync3, realpathSync as realpathSync2, statSync as statSync6 } from "node:fs";
 import { basename, dirname as dirname7, isAbsolute, resolve as resolve6, sep as sep4 } from "node:path";
 import { cleanupWorktree as cleanupWorktree6, GIT_NO_HOOKS as GIT_NO_HOOKS12, log as log52 } from "@gethmy/harness";
 function canonicalize(p) {
@@ -18187,8 +18421,20 @@ function classifyWorktreeRegistration(worktreePath, cwd) {
 function isRegisteredWorktree(worktreePath, cwd) {
   return classifyWorktreeRegistration(worktreePath, cwd).kind === "registered";
 }
+function pathAbsent(p) {
+  try {
+    lstatSync3(p);
+    return false;
+  } catch {
+    return true;
+  }
+}
 function cleanupMergedWorktree(args) {
-  if (!isRegisteredWorktree(args.worktreePath, args.cwd)) {
+  const registration = classifyWorktreeRegistration(args.worktreePath, args.cwd);
+  if (registration.kind === "unregistered" && pathAbsent(args.worktreePath)) {
+    return { removed: true, alreadyGone: true };
+  }
+  if (registration.kind !== "registered") {
     const reason = `refusing to clean up ${args.worktreePath} — git does not list it as a ` + `worktree of the repository at ${args.cwd}, and removing a path git ` + `does not manage would be a recursive delete of an unknown directory. ` + `Pass the worktree path Step B5 created, and re-run from the ` + `repository root.`;
     log52.warn(TAG48, reason);
     return { removed: false, reason };
@@ -18461,7 +18707,8 @@ async function finish(deps) {
         deps.emit({
           type: "cleaned",
           worktree: worktreePath,
-          branch: branchGone ? branch : null
+          branch: branchGone ? branch : null,
+          ...out.alreadyGone ? { alreadyRemoved: true } : {}
         });
       }
     } catch (err) {
@@ -18632,6 +18879,7 @@ var init_scan_commands = __esm(() => {
 });
 
 // src/cli.ts
+init_src();
 init_package_version();
 import { readFileSync as readFileSync11, realpathSync as realpathSync4 } from "node:fs";
 import { dirname as dirname8, join as join10 } from "node:path";
@@ -18911,7 +19159,7 @@ async function reportBuildFreshness(version) {
   }
   if (published === version)
     return;
-  process.stderr.write(`preflight: npm serves ${published}. If that is NEWER than the build above, this one is stale — ` + `\`npm i -g @gethmy/agent@latest\`, or clear the npx cache (\`rm -rf ~/.npm/_npx\`), because \`@latest\` alone does not re-resolve it.
+  process.stderr.write(`preflight: npm serves ${published}. If that is NEWER than the build above, this one is stale — ` + `\`${HMY_NPM_INSTALL_COMMAND}\` and run it as \`${HMY_AGENT_COMMAND}\`, or clear the npx cache (\`rm -rf ~/.npm/_npx\`), because \`@latest\` alone does not re-resolve it.
 `);
 }
 async function doctorCommand() {

package/dist/index.js

@@ -1102,9 +1102,14 @@ var init_commentSerializer = __esm(() => {
 });
 
 // ../harmony-shared/src/connectCommands.ts
-var HMY_INSTALL_URL = "https://gethmy.com/install.sh", HMY_INSTALL_COMMAND;
+function hmyConnectCommand(projectSlug) {
+  const slug = projectSlug?.trim();
+  return slug ? `${CONNECT_VERB} ${slug}` : CONNECT_VERB;
+}
+var HMY_INSTALL_URL = "https://gethmy.com/install.sh", HMY_INSTALL_COMMAND, HMY_AGENT_COMMAND = "hmy agent", CONNECT_VERB = "hmy connect", HOSTED_MCP_URL = "https://mcp.gethmy.com/mcp", HOSTED_MCP_CONFIG;
 var init_connectCommands = __esm(() => {
   HMY_INSTALL_COMMAND = `curl -fsSL ${HMY_INSTALL_URL} | bash`;
+  HOSTED_MCP_CONFIG = JSON.stringify({ mcpServers: { harmony: { type: "http", url: HOSTED_MCP_URL } } }, null, 2);
 });
 
 // ../harmony-shared/src/constants.ts
@@ -1577,6 +1582,18 @@ function own(source, key) {
   return Object.hasOwn(source, key) ? source[key] : undefined;
 }
 
+// ../harmony-shared/src/packageCommands.ts
+function npxArgs(pkg, args) {
+  return ["-y", `${SCOPE}/${pkg}@latest`, ...args];
+}
+function npxCommand(pkg, args = []) {
+  return ["npx", ...npxArgs(pkg, args)].join(" ");
+}
+var SCOPE = "@gethmy", HMY_NPM_INSTALL_COMMAND;
+var init_packageCommands = __esm(() => {
+  HMY_NPM_INSTALL_COMMAND = `npm i -g ${SCOPE}/cli`;
+});
+
 // ../harmony-shared/src/parsedState.ts
 function parseJsonWithoutPrototypes(text) {
   return JSON.parse(text, (_key, value) => {
@@ -2574,6 +2591,7 @@ var init_src = __esm(() => {
   init_gateEvaluate();
   init_logger();
   init_memoryQuery();
+  init_packageCommands();
   init_playbookAutoBind();
   init_playbookCatalog();
   init_playbookStage();
@@ -3515,7 +3533,7 @@ function agentIdentifier(workerId) {
 function endStatusForCancel(reason) {
   return reason === "human_stop" ? "cancelled" : "paused";
 }
-var DEFAULT_FINDING_AUTHORS, DEFAULT_AGENT_CONFIG, IN_PROGRESS_COLUMN = "In Progress", NEED_REVIEW_LABEL = "Need Review", NEED_REVIEW_LABEL_COLOR = "#f59e0b", REVIEW_FAILURE_REASON_MAX = 300, AGENT_NAME = "Harmony Agent", DAEMON_IDENTIFIER_BASE = "harmony-daemon", NOTICE_IDENTIFIER;
+var DEFAULT_FINDING_AUTHORS, DEFAULT_HUMAN_STAGE_HOLD_MINUTES = 60, DEFAULT_AGENT_CONFIG, IN_PROGRESS_COLUMN = "In Progress", NEED_REVIEW_LABEL = "Need Review", NEED_REVIEW_LABEL_COLOR = "#f59e0b", REVIEW_FAILURE_REASON_MAX = 300, AGENT_NAME = "Harmony Agent", DAEMON_IDENTIFIER_BASE = "harmony-daemon", NOTICE_IDENTIFIER;
 var init_types = __esm(() => {
   init_src();
   init_board_review();
@@ -3547,12 +3565,12 @@ var init_types = __esm(() => {
       postSummary: true
     },
     claude: {
-      model: "claude-opus-5",
+      model: "claude-opus-5-5",
       escalateModel: "claude-fable-5-1",
       escalateAfterAttempts: 2,
       tiers: {
         simple: "claude-sonnet-5",
-        advanced: "claude-opus-5",
+        advanced: "claude-opus-5-5",
         research: "claude-fable-5-1"
       },
       scoreBands: DEFAULT_SCORE_BANDS,
@@ -3659,7 +3677,12 @@ var init_types = __esm(() => {
       runLogDays: 30
     },
     planning: DEFAULT_PLANNING_CONFIG,
-    playbooks: { enabled: true, humanStageColumns: [], metrics: {} },
+    playbooks: {
+      enabled: true,
+      humanStageColumns: [],
+      humanStageHoldMinutes: DEFAULT_HUMAN_STAGE_HOLD_MINUTES,
+      metrics: {}
+    },
     contractFirst: DEFAULT_CONTRACT_CONFIG,
     boardReview: DEFAULT_BOARD_REVIEW_CONFIG,
     sweep: {
@@ -4040,13 +4063,13 @@ function loadDaemonConfig() {
   const projectId = getActiveProjectId(repoRoot);
   const userEmail = getUserEmail();
   if (!workspaceId) {
-    throw new Error(`No active workspace configured in ${contextSource.path}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No active workspace configured in ${contextSource.path}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   if (!projectId) {
-    throw new Error(`No active project configured in ${contextSource.path}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No active project configured in ${contextSource.path}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   if (!userEmail) {
-    throw new Error(`No user email configured in ${contextSource.globalPath}. Run \`hmy connect\` first (no install: \`npx @gethmy/mcp connect\`).`);
+    throw new Error(`No user email configured in ${contextSource.globalPath}. Run \`${hmyConnectCommand()}\` first (no install: \`${npxCommand("mcp", ["connect"])}\`).`);
   }
   let agentOverrides = {};
   let agentName = "Harmony Agent";
@@ -4159,6 +4182,7 @@ function createApiClient(config) {
 }
 var TAG5 = "config", NOT_A_REPOSITORY_EXIT = 128, warnedLegacyConfigDir = false;
 var init_config = __esm(() => {
+  init_src();
   init_config_merge();
   init_config_validation();
   init_paths();
@@ -8816,7 +8840,7 @@ class StateStore {
     const rec = this.getCard(cardId);
     if (!rec)
       return;
-    if (rec.attempts === 0 && !rec.ciRepairAttempts && rec.ciRepairParkedAt == null && (!clearTurns || !rec.totalTurns && !rec.runStarts)) {
+    if (rec.attempts === 0 && !rec.ciRepairAttempts && rec.ciRepairParkedAt == null && rec.stageHold == null && (!clearTurns || !rec.totalTurns && !rec.runStarts)) {
       return;
     }
     rec.attempts = 0;
@@ -8826,6 +8850,7 @@ class StateStore {
       rec.totalTurns = 0;
     if (clearTurns)
       rec.runStarts = 0;
+    rec.stageHold = null;
     await this.persist();
   }
   getCiRepairAttempts(cardId) {
@@ -8908,6 +8933,29 @@ class StateStore {
   getCardRunStarts(cardId) {
     return this.getCard(cardId)?.runStarts ?? 0;
   }
+  getStageHold(cardId) {
+    return this.getCard(cardId)?.stageHold ?? null;
+  }
+  async recordStageHold(cardId, hold) {
+    const rec = this.ensureCard(cardId);
+    const prior = rec.stageHold ?? null;
+    const announced = prior != null && prior.stageId === hold.stageId && prior.reason === hold.reason;
+    rec.stageHold = cloneWithoutPrototype({
+      stageId: hold.stageId,
+      reason: hold.reason,
+      until: hold.untilMs,
+      announcedAt: announced ? prior.announcedAt : Date.now()
+    });
+    await this.persist();
+    return { announced };
+  }
+  async clearStageHold(cardId) {
+    const rec = this.getCard(cardId);
+    if (!rec || rec.stageHold == null)
+      return;
+    rec.stageHold = null;
+    await this.persist();
+  }
   getCardCostCents(cardId) {
     return this.getCard(cardId)?.totalCostCents ?? 0;
   }
@@ -10218,6 +10266,27 @@ class SleepGuard {
 var TAG26 = "sleep-guard";
 var init_sleep_guard = () => {};
 
+// src/stage-hold.ts
+function classifyStageHold(card, hold, nowMs) {
+  if (!hold)
+    return { kind: "none" };
+  if (!card.current_stage || card.current_stage !== hold.stageId) {
+    return { kind: "stale" };
+  }
+  if (nowMs >= hold.until)
+    return { kind: "lapsed" };
+  const remainingMin = Math.ceil((hold.until - nowMs) / 60000);
+  return {
+    kind: "holding",
+    detail: `parked on human-owned stage "${hold.stageId}" — holding for ~${remainingMin}m`
+  };
+}
+function stageHoldUntil(holdMinutes, nowMs) {
+  if (!Number.isFinite(holdMinutes) || holdMinutes <= 0)
+    return nowMs;
+  return nowMs + holdMinutes * 60000;
+}
+
 // src/unblock.ts
 import { log as log30 } from "@gethmy/harness";
 async function fetchBlocksLinks(client, cardId) {
@@ -11454,6 +11523,29 @@ var init_stage_advance = __esm(() => {
 });
 
 // src/workspace-model-config.ts
+function layerPlatformDefaults(platform, ws) {
+  if (!platform)
+    return ws ?? null;
+  if (!ws)
+    return platform;
+  const merged = { ...platform };
+  for (const [key, value] of Object.entries(ws)) {
+    if (value !== null && value !== undefined) {
+      merged[key] = value;
+    }
+  }
+  if (platform.tiers || ws.tiers) {
+    const tiers = {};
+    for (const layer of [platform.tiers, ws.tiers]) {
+      for (const [tier, model] of Object.entries(layer ?? {})) {
+        if (model)
+          tiers[tier] = model;
+      }
+    }
+    merged.tiers = tiers;
+  }
+  return merged;
+}
 function workspaceConfigToPartial(ws) {
   const claude = {};
   if (ws.implement_model)
@@ -11502,6 +11594,15 @@ function resolveEffectiveAgentConfig(cfg, ws) {
   const withWorkspace = ws ? mergeAgentConfig(DEFAULT_AGENT_CONFIG, workspaceConfigToPartial(ws)) : DEFAULT_AGENT_CONFIG;
   return mergeAgentConfig(mergeAgentConfig(withWorkspace, cfg.agentOverrides), cfg.repoAgentOverrides);
 }
+function withdrawnMapFrom(models) {
+  const withdrawn = {};
+  for (const m of models) {
+    if (m.status === "withdrawn" && m.replaced_by) {
+      withdrawn[m.id] = m.replaced_by;
+    }
+  }
+  return withdrawn;
+}
 var init_workspace_model_config = __esm(() => {
   init_config_merge();
   init_types();
@@ -11976,7 +12077,7 @@ class Worker {
       stageCtx = await this.resolveStageContext(card);
       if (stageCtx.kind === "hold") {
         this.held = true;
-        await this.holdStageCard(card, stageCtx.reason, stageCtx.wait);
+        await this.holdStageCard(card, stageCtx.reason, stageCtx.wait, stageCtx.wait);
         return;
       }
       if (stageCtx.kind === "fanout") {
@@ -12534,15 +12635,35 @@ class Worker {
       }
     }
   }
-  async holdStageCard(card, reason, wait = false) {
+  async holdStageCard(card, reason, wait = false, armCooldown = false) {
     log34.info(this.tag, `Holding #${card.short_id}: ${reason}`);
     await this.stateStore.decrementAttempt(card.id);
-    try {
-      await this.client.addComment(card.id, reason, {
-        commentType: "blocker",
-        agentSessionId: this.sessionId ?? undefined
-      });
-    } catch {}
+    let announced = false;
+    const holdStage = armCooldown ? card.current_stage : null;
+    if (holdStage) {
+      try {
+        const recorded = await this.stateStore.recordStageHold(card.id, {
+          stageId: holdStage,
+          reason,
+          untilMs: stageHoldUntil(this.config.playbooks.humanStageHoldMinutes ?? DEFAULT_HUMAN_STAGE_HOLD_MINUTES, Date.now())
+        });
+        announced = recorded.announced;
+      } catch (err) {
+        log34.warn(this.tag, `stage hold not recorded on #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+      }
+    }
+    if (announced) {
+      log34.debug(this.tag, `#${card.short_id} already carries this blocker — not reposting`);
+    } else {
+      try {
+        await this.client.addComment(card.id, reason, {
+          commentType: "blocker",
+          agentSessionId: this.sessionId ?? undefined
+        });
+      } catch {
+        await this.stateStore.clearStageHold(card.id).catch(() => {});
+      }
+    }
     try {
       await runTransition(this.client, card, {
         removeLabels: ["agent"],
@@ -13969,19 +14090,10 @@ class Pool {
     this.reviewQueue = new PriorityQueue(config);
     this.budget = new BudgetGuard(config.budget, this.stateStore);
     const workspaceModels = daemonConfig ? new WorkspaceModelCache(async () => {
-      const { config: wsConfig } = await client.getWorkspaceModelConfig(workspaceId);
-      return wsConfig ?? null;
-    }) : undefined;
-    const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => {
-      const { models } = await client.getModelCatalog();
-      const withdrawn = {};
-      for (const m of models) {
-        if (m.status === "withdrawn" && m.replaced_by) {
-          withdrawn[m.id] = m.replaced_by;
-        }
-      }
-      return withdrawn;
+      const { config: wsConfig, platformDefaults } = await client.getWorkspaceModelConfig(workspaceId);
+      return layerPlatformDefaults(platformDefaults, wsConfig);
     }) : undefined;
+    const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => withdrawnMapFrom((await client.getModelCatalog()).models)) : undefined;
     const reportedConfig = daemonConfig ? new ReportedConfigCache(client, effectiveModelReport(config)) : undefined;
     for (let i = 0;i < config.poolSize; i++) {
       this.implWorkers.push(new Worker(i, config, client, this.identity, () => {
@@ -14037,6 +14149,14 @@ class Pool {
           await this.emitWaiting(card.id, `Paused — Anthropic API limit, retrying in ~${Math.round(cooldownMs / 1000)}s`);
           return;
         }
+        const stageHold = classifyStageHold(card, this.stateStore.getStageHold(card.id), Date.now());
+        if (stageHold.kind === "holding") {
+          log36.debug(TAG32, `#${card.short_id} held — ${stageHold.detail}`);
+          return;
+        }
+        if (stageHold.kind === "stale") {
+          await this.stateStore.clearStageHold(card.id);
+        }
         const decision = this.budget.check(card.id);
         if (!decision.allow) {
           if (decision.reason === "daily_budget") {
@@ -14735,6 +14855,7 @@ var init_pool = __esm(() => {
   init_unblock();
   init_worker();
   init_workspace_model_cache();
+  init_workspace_model_config();
 });
 
 // src/port-registry.ts
@@ -14973,6 +15094,8 @@ var init_repo_dirs = __esm(() => {
 
 // src/card-trust.ts
 function isTrustedCardAuthor(card, trustedAuthors) {
+  if (card.source != null)
+    return false;
   return card.created_by != null && trustedAuthors.has(card.created_by);
 }
 
@@ -15032,7 +15155,7 @@ async function reclaimPreReviewStrands(opts) {
       continue;
     const daemonBranch = daemonBranches.get(card.id);
     if (!isTrustedCardAuthor(card, trustedAuthors) && daemonBranch !== branch) {
-      log40.debug(TAG36, `#${card.short_id} - skipped: author ${card.created_by ?? "(none)"} is not trusted, and ${daemonBranch ? `the card records ${branch} while this daemon pushed ${daemonBranch}` : "this daemon has pushed no branch for it"}`);
+      log40.debug(TAG36, `#${card.short_id} - skipped: ${card.source != null ? `card was filed externally (source: ${card.source})` : `author ${card.created_by ?? "(none)"} is not trusted`}, and ${daemonBranch ? `the card records ${branch} while this daemon pushed ${daemonBranch}` : "this daemon has pushed no branch for it"}`);
       continue;
     }
     const labels = resolveCardLabels(card, labelMap);
@@ -15270,7 +15393,7 @@ function rankSweepCandidates(opts) {
       continue;
     }
     if (!isTrustedCardAuthor(card, trustedAuthors)) {
-      skip2(card, "untrusted_author", card.created_by == null ? "card has no recorded author" : `author ${card.created_by} is not in sweep.trustedAuthors`);
+      skip2(card, "untrusted_author", card.source != null ? `card was filed externally (source: ${card.source})` : card.created_by == null ? "card has no recorded author" : `author ${card.created_by} is not in sweep.trustedAuthors`);
       continue;
     }
     if (card.assigned_agent_id != null) {
@@ -16106,6 +16229,93 @@ var init_reconcile = __esm(() => {
   init_types();
 });
 
+// src/startup-model.ts
+function describeStartupModel(config, layers, withdrawn) {
+  const workspace = layers?.workspace ?? null;
+  const platform = layers?.platform ?? null;
+  const database = layerPlatformDefaults(platform, workspace);
+  const claude = resolveEffectiveAgentConfig(config, database).claude;
+  const pinned = ownObject(config.agentOverrides, "claude");
+  const pinnedTiers = ownObject(pinned, "tiers");
+  const pinnedModel = ownString(pinned, "model");
+  let source = "built-in default";
+  if (pinnedModel)
+    source = "config.json";
+  else if (workspace?.implement_model)
+    source = "workspace";
+  else if (platform?.implement_model)
+    source = "platform";
+  const warnings = [];
+  const pins = [
+    ["claude.model", pinnedModel, database?.implement_model],
+    [
+      "claude.escalateModel",
+      ownString(pinned, "escalateModel"),
+      database?.escalate_model
+    ],
+    ...TIERS.map((tier) => [
+      `claude.tiers.${tier}`,
+      ownString(pinnedTiers, tier),
+      database?.tiers?.[tier]
+    ])
+  ];
+  for (const [key, local, db] of pins) {
+    if (local && db && local !== db) {
+      warnings.push(`config.json pins ${key} to "${local}", which overrides the database default "${db}" — remove it from config.json to follow the app's model settings`);
+    }
+  }
+  const effective = [
+    ["claude.model", claude.model],
+    ["claude.escalateModel", claude.escalateModel],
+    ...TIERS.map((tier) => [`claude.tiers.${tier}`, claude.tiers[tier]])
+  ];
+  for (const [key, id] of effective) {
+    const replacement = withdrawn?.[id];
+    if (replacement) {
+      warnings.push(`${key} resolves to "${id}", which is withdrawn in the model catalog — runs use its replacement "${replacement}"; update the setting to match`);
+    }
+  }
+  return {
+    model: claude.model,
+    escalateModel: claude.escalateModel,
+    reviewModel: config.agent.claude.reviewModel,
+    source,
+    resolved: layers !== null && withdrawn !== null,
+    warnings
+  };
+}
+async function resolveStartupModel(config, client) {
+  const [layers, withdrawn] = await Promise.all([
+    client.getWorkspaceModelConfig(config.workspaceId).then(({ config: workspace, platformDefaults }) => ({
+      workspace,
+      platform: platformDefaults ?? null
+    })).catch(() => null),
+    client.getModelCatalog().then(({ models }) => withdrawnMapFrom(models)).catch(() => null)
+  ]);
+  return describeStartupModel(config, layers, withdrawn);
+}
+function ownObject(source, key) {
+  if (typeof source !== "object" || source === null)
+    return {};
+  const value = own(source, key);
+  return typeof value === "object" && value !== null ? value : {};
+}
+function ownString(source, key) {
+  const value = own(source, key);
+  return typeof value === "string" && value !== "" ? value : undefined;
+}
+function startupModelLine(m) {
+  const models = m.model === m.escalateModel ? m.model : `${m.model} → ${m.escalateModel} on retry/high · review ${m.reviewModel}`;
+  const origin = m.resolved ? `from ${m.source}` : `from ${m.source}; database model settings unreachable, a pickup may resolve differently`;
+  return `${models} (${origin})`;
+}
+var TIERS;
+var init_startup_model = __esm(() => {
+  init_src();
+  init_workspace_model_config();
+  TIERS = ["simple", "advanced", "research"];
+});
+
 // src/startup-banner.ts
 var exports_startup_banner = {};
 __export(exports_startup_banner, {
@@ -16121,6 +16331,7 @@ function prettyBanner(config, version) {
   let projectName;
   let gitProvider;
   let httpPort;
+  let model;
   let failed = false;
   let rendered = false;
   return {
@@ -16133,6 +16344,9 @@ function prettyBanner(config, version) {
     setHttpPort(port) {
       httpPort = port;
     },
+    setModel(resolved) {
+      model = resolved;
+    },
     check(message) {
       checks.push({ kind: "ok", message });
     },
@@ -16154,6 +16368,7 @@ function prettyBanner(config, version) {
         projectName,
         gitProvider,
         httpPort,
+        model,
         checks,
         readyMessage: message
       });
@@ -16163,12 +16378,13 @@ function prettyBanner(config, version) {
 }
 function jsonBanner(config, version) {
   log45.info(TAG41, `Harmony Agent Daemon v${version} starting...`);
-  log45.info(TAG41, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Model: ${config.agent.claude.model} | Runner: ${config.agent.runner} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
+  log45.info(TAG41, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Runner: ${config.agent.runner} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
   log45.info(TAG41, `Config: ${contextSourceLine(config)}`);
   if (config.agent.review.enabled) {
     log45.info(TAG41, `Review: enabled | Columns: ${config.agent.review.pickupColumns.join(", ")} | → ${config.agent.review.moveToColumn} / ${config.agent.review.failColumn}`);
   }
   let failed = false;
+  let modelLogged = false;
   return {
     setProjectName(_name) {},
     setGitProvider(provider) {
@@ -16177,6 +16393,10 @@ function jsonBanner(config, version) {
     setHttpPort(port) {
       log45.info(TAG41, `HTTP server on port ${port}`);
     },
+    setModel(resolved) {
+      modelLogged = true;
+      log45.info(TAG41, `Model: ${startupModelLine(resolved)}`);
+    },
     check(message) {
       log45.info(TAG41, message);
     },
@@ -16189,6 +16409,8 @@ function jsonBanner(config, version) {
     async ready(message) {
       if (failed)
         return;
+      if (!modelLogged)
+        log45.info(TAG41, `Model: ${localModelLine(config)}`);
       log45.info(TAG41, message);
     }
   };
@@ -16200,6 +16422,7 @@ function renderPretty(input) {
     projectName,
     gitProvider,
     httpPort,
+    model,
     checks,
     readyMessage
   } = input;
@@ -16207,7 +16430,7 @@ function renderPretty(input) {
   lines.push("");
   lines.push(titleRule(`Harmony Agent Daemon v${version}`));
   lines.push("");
-  for (const row of configRows(config, projectName, gitProvider, httpPort)) {
+  for (const row of configRows(config, projectName, gitProvider, httpPort, model)) {
     lines.push(`  ${dim(row.label.padEnd(9))} ${row.value}`);
   }
   lines.push("");
@@ -16221,7 +16444,7 @@ function renderPretty(input) {
   return lines.join(`
 `);
 }
-function configRows(config, projectName, gitProvider, httpPort) {
+function configRows(config, projectName, gitProvider, httpPort, model) {
   const rows = [];
   const projectLabel = projectName ? `${projectName} (${shortenId(config.projectId)})` : shortenId(config.projectId);
   rows.push({ label: "Project", value: projectLabel });
@@ -16230,8 +16453,7 @@ function configRows(config, projectName, gitProvider, httpPort) {
   const reviewEnabled = config.agent.review.enabled;
   const poolDesc = reviewEnabled ? `Pool ${config.agent.poolSize} impl + ${config.agent.review.poolSize} review` : `Pool ${config.agent.poolSize} impl`;
   const flowDesc = reviewEnabled ? `Pickup ${config.agent.pickupColumns[0]} → ${config.agent.completion.moveToColumn} → ${config.agent.review.moveToColumn}` : `Pickup ${config.agent.pickupColumns.join(", ")}`;
-  const { model, escalateModel, reviewModel } = config.agent.claude;
-  const modelDesc = model === escalateModel ? model : `${model} → ${escalateModel} on retry/high · review ${reviewModel}`;
+  const modelDesc = model ? startupModelLine(model) : localModelLine(config);
   rows.push({
     label: "Model",
     value: `${modelDesc}  ·  ${poolDesc}  ·  ${flowDesc}`
@@ -16265,6 +16487,11 @@ function titleRule(title) {
   const suffix = "─".repeat(Math.max(3, RULE_WIDTH - prefix.length - title.length - surround.length));
   return dim(`${prefix}${title}${surround}${suffix}`);
 }
+function localModelLine(config) {
+  const { model, escalateModel, reviewModel } = config.agent.claude;
+  const models = model === escalateModel ? model : `${model} → ${escalateModel} on retry/high · review ${reviewModel}`;
+  return `${models} (local config only; database model settings not read)`;
+}
 function runnerDesc(runner) {
   return runner === "sdk" ? "sdk (Agent SDK)" : "cli (Claude CLI)";
 }
@@ -16285,6 +16512,7 @@ function yellow(s) {
 var TAG41 = "daemon", RULE_WIDTH = 70, ANSI;
 var init_startup_banner = __esm(() => {
   init_port_registry();
+  init_startup_model();
   ANSI = {
     reset: "\x1B[0m",
     dim: "\x1B[2m",
@@ -17642,6 +17870,11 @@ async function main() {
   } catch (err) {
     log50.warn(TAG46, `Could not report model config: ${err instanceof Error ? err.message : String(err)}`);
   }
+  const startupModel = await resolveStartupModel(config, client);
+  banner.setModel(startupModel);
+  for (const warning of startupModel.warnings) {
+    banner.warn(warning);
+  }
   migrateConfigDir();
   try {
     migrateLegacyStateFile({
@@ -17964,6 +18197,7 @@ var init_src2 = __esm(() => {
   init_recovery();
   init_review_worktree();
   init_startup_banner();
+  init_startup_model();
   init_state_migration();
   init_state_store();
   init_stream_parser_selftest();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/agent",
-  "version": "1.45.0",
+  "version": "1.47.0",
   "description": "Push-based agent daemon for Harmony — picks up assigned cards, builds them in isolated git worktrees, and opens PRs. It runs where you put it.",
   "type": "module",
   "main": "dist/index.js",
@@ -45,8 +45,8 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.178",
-    "@gethmy/harness": "1.19.0",
-    "@gethmy/mcp": "3.15.0",
+    "@gethmy/harness": "1.19.1",
+    "@gethmy/mcp": "3.16.0",
     "@supabase/supabase-js": "2.95.3"
   },
   "devDependencies": {