@gethmy/agent 1.45.0 → 1.46.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();
@@ -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)
@@ -11977,7 +12069,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 +12627,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,8 +14082,8 @@ 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;
+      const { config: wsConfig, platformDefaults } = await client.getWorkspaceModelConfig(workspaceId);
+      return layerPlatformDefaults(platformDefaults, wsConfig);
     }) : undefined;
     const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => {
       const { models } = await client.getModelCatalog();
@@ -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) {
@@ -18082,7 +18205,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 +18310,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 +18596,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 +18768,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 +19048,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();
@@ -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)
@@ -11976,7 +12068,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 +12626,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,8 +14081,8 @@ 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;
+      const { config: wsConfig, platformDefaults } = await client.getWorkspaceModelConfig(workspaceId);
+      return layerPlatformDefaults(platformDefaults, wsConfig);
     }) : undefined;
     const modelCatalog = daemonConfig ? new WorkspaceModelCache(async () => {
       const { models } = await client.getModelCatalog();
@@ -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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/agent",
-  "version": "1.45.0",
+  "version": "1.46.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": {