@mutmutco/cli 4.1.12 → 4.1.14

package/dist/main.cjs

@@ -803,6 +803,8 @@ var init_house_map = __esm({
       "skill-lesson": "learning",
       "closure-rate": "learning",
       // closure rate per loop kind, computed at read (#4440)
+      pickup: "learning",
+      // cloud-agent adoption gate (#5708)
       // --- core — the front door itself ---------------------------------------------------------------
       commands: "core",
       whoami: "core",
@@ -5978,7 +5980,7 @@ init_clean_exit();
 init_error_codes();
 
 // src/parse-error-hints.ts
-var TARGET_SELECTOR_FLAGS = /* @__PURE__ */ new Set(["--repo", "--ref", "--target", "--project", "--issue"]);
+var TARGET_SELECTOR_FLAGS = /* @__PURE__ */ new Set(["--repo", "--ref", "--target", "--project", "--issue", "--number"]);
 function targetFlagValueFromArgv(flag, argv) {
   const i = argv.indexOf(flag);
   if (i < 0) return void 0;
@@ -6000,6 +6002,33 @@ function unknownTargetFlagMessage(flag, positional) {
   return `unknown option '${flag}' \u2014 this command takes its target as a positional: ${positional}`;
 }
 
+// src/unknown-command-domain-hints.ts
+var GUIDES = /* @__PURE__ */ new Map([
+  [
+    "oracle issue:search",
+    {
+      hint: "no `oracle issue search` \u2014 friction reports dedup server-side via `mmi-cli learning report`; new issues accept `--idempotency-key` on `oracle issue create`; bounded label/state filters use `oracle issue list`",
+      expected: ["learning report", "oracle issue create", "oracle issue list"],
+      did_you_mean: "learning report"
+    }
+  ]
+]);
+var BLOCKED_SUGGESTIONS = /* @__PURE__ */ new Map([
+  ["oracle issue:search", ["oracle repo-index search"]]
+]);
+function unknownCommandDomainGuide(parentPath, token) {
+  if (!parentPath || !token) return void 0;
+  return GUIDES.get(`${parentPath}:${token}`);
+}
+function blockedUnknownCommandSuggestions(parentPath, token) {
+  if (!parentPath || !token) return [];
+  return BLOCKED_SUGGESTIONS.get(`${parentPath}:${token}`) ?? [];
+}
+function filterUnknownCommandCandidates(parentPath, token, candidates) {
+  const blocked = new Set(blockedUnknownCommandSuggestions(parentPath, token));
+  return blocked.size ? candidates.filter((p) => !blocked.has(p)) : [...candidates];
+}
+
 // src/session-start.ts
 var import_node_fs8 = require("node:fs");
 var import_node_path6 = require("node:path");
@@ -6874,7 +6903,7 @@ var COMMAND_LADDER_WRITES = [
 ];
 var COMMAND_LADDER_READS = [
   // #5483: `show` aliases `view` for board-verb callers; advertise the canonical read plus the alias.
-  { gh: "gh issue view <N>", replacement: "mmi-cli oracle issue view <N> (alias: show)" },
+  { gh: "gh issue view <N>", replacement: "mmi-cli oracle issue view <N> (aliases: show, get)" },
   { gh: "gh pr view <N>", replacement: "mmi-cli devops pr view <N>" },
   { gh: "gh pr checks <N>", replacement: "mmi-cli devops pr checks-wait <N>" }
 ];
@@ -13152,10 +13181,10 @@ var rollout_plan_default = {
     note: "The v4.0.0 stamp happens at cut time (D6e #4463); until then the candidate is the origin/development head artifacts (built cli/dist + npm pack), identity proven by dist content hash (D6a)."
   },
   baseline: {
-    version: "4.1.12",
-    tag: "v4.1.12",
-    commit: "306701c103b7",
-    npm: "@mutmutco/cli@4.1.12"
+    version: "4.1.14",
+    tag: "v4.1.14",
+    commit: "e91bb87d9ce0",
+    npm: "@mutmutco/cli@4.1.14"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -13172,14 +13201,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.1.12"
+          v3Target: "v4.1.14"
         }
       ],
       rollbackTrigger: "Any red inside the post-contract soak window: `devops train gate` FAIL attributable to the v4 doors, Hub endpoint health probe failure, a pre-v4 client admitted instead of receiving actionable HTTP 426, or npm consumer install/doctor failure on the v4-only dist.",
       rollback: {
         independent: true,
-        mechanism: "npm dist-tag latest -> 4.1.12 and redeploy the Hub Lambda from tag v4.1.12 (306701c103b7); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.1.12 (@mutmutco/cli@4.1.12, tag commit 306701c103b7 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.1.14 and redeploy the Hub Lambda from tag v4.1.14 (e91bb87d9ce0); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.1.14 (@mutmutco/cli@4.1.14, tag commit e91bb87d9ce0 \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -15938,9 +15967,13 @@ async function withCheckoutRestoredAfterRelease(deps, result, startBranch) {
   return { ...result, checkout, ...localSync ? { localSync } : {} };
 }
 var HUB_REPO3 = "mutmutco/MMI-Hub";
+var JERV_HUB_REPO = "mutmutco/Jerv-Hub";
 function isHubControlRepo(repo) {
   return repo.toLowerCase() === HUB_REPO3.toLowerCase();
 }
+function isJervHubRepo(repo) {
+  return repo.toLowerCase() === JERV_HUB_REPO.toLowerCase();
+}
 function supportsReleaseAbort(_repo, meta, _branchHints) {
   return DEPLOY_MODELS.includes(meta.deployModel);
 }
@@ -16653,6 +16686,42 @@ function appendPublishDispatch(deploy, publish) {
     deployStatus: deploy.deployStatus === "failure" || publish.deployStatus === "failure" ? "failure" : deploy.deployStatus === "pending" || publish.deployStatus === "pending" ? "pending" : "success"
   };
 }
+async function appendJervGatewayReleaseDeploy(deps, repo, tag, tagSha, dispatch) {
+  if (!isJervHubRepo(repo)) return dispatch;
+  if (dispatch.deployStatus !== "success") {
+    return {
+      ...dispatch,
+      note: `${dispatch.note}; Jerv Gateway deploy deferred until package publication is proven green`
+    };
+  }
+  try {
+    const output = await deps.run("bash", ["scripts/jerv-gateway-release-deploy.sh", "--tag", tag]);
+    const receipt = output.trim().split(/\r?\n/).reverse().map((line) => {
+      try {
+        return JSON.parse(line);
+      } catch {
+        return null;
+      }
+    }).find((value) => value?.schema === "jerv-gateway/release-deploy-v1");
+    if (!receipt || receipt.tag !== tag || receipt.commit !== tagSha || receipt.status !== "healthy") {
+      throw new Error("helper receipt did not match the released tag and commit");
+    }
+    return {
+      ...dispatch,
+      note: `${dispatch.note}; Jerv Gateway deployed ${tagSha.slice(0, 12)} and passed health checks`,
+      workflowRuns: [...dispatch.workflowRuns ?? [], { workflow: "jerv-gateway", conclusion: "success" }],
+      deployStatus: "success"
+    };
+  } catch (error) {
+    const detail = (error instanceof Error ? error.message : String(error)).split(/\r?\n/, 1)[0].slice(0, 240);
+    return {
+      ...dispatch,
+      note: `${dispatch.note}; Jerv Gateway deploy FAILED (${detail})`,
+      workflowRuns: [...dispatch.workflowRuns ?? [], { workflow: "jerv-gateway", conclusion: "failure" }],
+      deployStatus: "failure"
+    };
+  }
+}
 async function watchOwnWorkflowRuns(deps, repo, targets, since, headSha, enumerateSha = false) {
   const workflowRuns = [];
   for (const target of targets) {
@@ -17366,6 +17435,7 @@ async function completeMainRelease(deps, ctx, meta, deployModel, watch, options,
   const deployDispatch = await dispatchDeploy(deps, ctx, "main", "main", deployModel, watch, autoRunSince, releaseSha, "report", meta.publishDir);
   const publishDispatch = deployDispatch.deployStatus === "success" ? await dispatchPublishIfRequired(deps, ctx, meta, deployModel, "main", tag, watch, "report") : null;
   let dispatch = appendPublishDispatch(deployDispatch, publishDispatch);
+  dispatch = await appendJervGatewayReleaseDeploy(deps, ctx.repo, tag, releaseSha, dispatch);
   if (!publishDispatch && deployDispatch.deployStatus !== "success" && meta.publishRequired && (deployModel === "tenant-container" || deployModel === "solo-container")) {
     const reason = deployDispatch.deployStatus === "failure" ? "box deploy failed \u2014 redeploy the box before publishing" : "box deploy not confirmed (run with --watch) \u2014 publish after the box deploy lands";
     dispatch = {
@@ -17504,9 +17574,14 @@ async function runReleaseResume(deps, options = {}) {
     const rcAlignment2 = !directTrack && branchHints.hasRcBranch ? await alignRcForward(deps, ctx, tag) : void 0;
     if (rcAlignment2) steps2.push(`rc alignment: ${rcAlignment2.status}`);
     const historicalDeploy = await deriveHistoricalDeployStatus(deps, ctx, deployModel, tagSha);
+    const dispatch2 = await appendJervGatewayReleaseDeploy(deps, ctx.repo, tag, tagSha, {
+      note: `historical ${deployModel} deploy/publish status: ${historicalDeploy}`,
+      deployStatus: historicalDeploy
+    });
+    if (isJervHubRepo(ctx.repo)) steps2.push(dispatch2.note);
     const state2 = resumeStateOf(deriveTrainFollowUpStatus({
       projectInfo: "ok",
-      deploy: deployFollowUpOutcome(historicalDeploy),
+      deploy: deployFollowUpOutcome(dispatch2.deployStatus),
       rcRetirement: "ok",
       alignment: alignmentFollowUpOutcome(devRollForward2, rcAlignment2),
       foldPort: "ok"
@@ -17519,6 +17594,7 @@ async function runReleaseResume(deps, options = {}) {
       steps: steps2,
       devRollForward: devRollForward2,
       rcAlignment: rcAlignment2,
+      dispatch: dispatch2,
       note: state2 === "failed" ? `release ${tag} was already published, but its deploy/publish on the release SHA FAILED \u2014 re-run the failed job (do NOT re-tag); the protected alignment PRs were reused` : state2 === "pending" ? `release ${tag} was already published; reused its protected alignment PRs, but a deploy/publish or alignment follow-up is unresolved \u2014 watch it to completion` : `release ${tag} was already published; alignment is complete and the deploy on the release SHA is proven green`
     };
   }
@@ -17551,7 +17627,8 @@ async function runReleaseResume(deps, options = {}) {
   const autoRunSince = (deps.now ?? Date.now)();
   const deployDispatch = await dispatchDeploy(deps, ctx, "main", "main", deployModel, watch, autoRunSince, tagSha, "report", meta.publishDir);
   const publishDispatch = deployDispatch.deployStatus === "success" ? await dispatchPublishIfRequired(deps, ctx, meta, deployModel, "main", tag, watch, "report") : null;
-  const dispatch = appendPublishDispatch(deployDispatch, publishDispatch);
+  let dispatch = appendPublishDispatch(deployDispatch, publishDispatch);
+  dispatch = await appendJervGatewayReleaseDeploy(deps, ctx.repo, tag, tagSha, dispatch);
   steps.push(`dispatched the ${deployModel} deploy path`);
   const devRollForward = await rollDevelopmentForward(deps, ctx, tag);
   steps.push(`development roll-forward: ${devRollForward.status}`);
@@ -20617,13 +20694,13 @@ var CONTENT_LABELS_AND_ASSIGNEES = `
               labels(first: ${ITEM_LABELS_PAGE}) { pageInfo { hasNextPage } nodes { name } }
               assignees(first: ${ITEM_ASSIGNEES_PAGE}) { pageInfo { hasNextPage } nodes { login } }`;
 var PROJECT_ITEMS_QUERY = `
-query($owner: String!, $number: Int!, $after: String) {
+query($owner: String!, $number: Int!, $after: String, $query: String) {
   viewer { login }
   organization(login: $owner) {
     projectV2(number: $number) {
       id
       title
-      items(first: 100, after: $after) {
+      items(first: 100, after: $after, query: $query) {
         pageInfo { hasNextPage endCursor }
         nodes {
           id
@@ -20663,6 +20740,23 @@ query($owner: String!, $number: Int!, $after: String) {
     }
   }
 }`;
+var ACTIVE_BOARD_ITEMS_FILTER = "-status:Done -is:closed";
+var DOCTOR_BOARD_ITEMS_FILTER = "-status:Done";
+var ARCHIVE_BOARD_ITEMS_FILTER = "status:Done is:closed";
+var retireBoardItemsFilter = (repo) => `repo:"${repo}"`;
+function boardItemsSearchFilter(options) {
+  if (options.activeOnly) return ACTIVE_BOARD_ITEMS_FILTER;
+  switch (options.purpose?.kind) {
+    case "doctor":
+      return DOCTOR_BOARD_ITEMS_FILTER;
+    case "archive":
+      return ARCHIVE_BOARD_ITEMS_FILTER;
+    case "retire":
+      return retireBoardItemsFilter(options.purpose.repo);
+    default:
+      return void 0;
+  }
+}
 var SINGLE_ITEM_CONTENT_FRAGMENT = `
         id
         number
@@ -20866,13 +20960,14 @@ function renderBoardReport(report) {
 }
 function shouldSkipInactiveBoardNode(node, cfg) {
   const content = node.content;
-  if (content && "state" in content && content.state === "CLOSED") return true;
+  if (content && "state" in content && (content.state === "CLOSED" || content.state === "MERGED")) return true;
   const status = parseSingleSelectFields(node.fieldValues?.nodes, cfg).status?.name;
   return status === "Done";
 }
 async function collectBoardItems(cfg, options, deps) {
   const client = deps.client ?? defaultGitHubClient();
   const currentRepo = await resolveCurrentRepo(options, deps);
+  const itemsQuery = boardItemsSearchFilter(options);
   const warnings = [];
   const nodes = [];
   let viewer = "";
@@ -20883,7 +20978,7 @@ async function collectBoardItems(cfg, options, deps) {
   let pageCount = 0;
   do {
     try {
-      const page = await fetchProjectPage(client, cfg, after);
+      const page = await fetchProjectPage(client, cfg, after, itemsQuery);
       viewer ||= page.viewer.login;
       const project2 = page.organization?.projectV2;
       if (!project2) throw new Error(`project ${cfg.projectOwner}#${cfg.projectNumber} not found`);
@@ -21111,7 +21206,7 @@ async function removeRepoBoardItems(options, deps = {}) {
   const cfg = resolveBoardConfig(options.config);
   const client = deps.client ?? defaultGitHubClient();
   const repo = options.repo;
-  const collected = await collectBoardItems(cfg, { repo, activeOnly: false }, deps);
+  const collected = await collectBoardItems(cfg, { repo, purpose: { kind: "retire", repo } }, deps);
   const board = { owner: cfg.projectOwner, number: cfg.projectNumber, id: collected.projectId };
   const matches = collected.items.filter((it) => it.repository.toLowerCase() === repo.toLowerCase());
   const removed = [];
@@ -21133,7 +21228,7 @@ async function removeRepoBoardItems(options, deps = {}) {
 async function archiveClosedDoneBoardItems(options, deps = {}) {
   const cfg = resolveBoardConfig(options.config);
   const client = deps.client ?? defaultGitHubClient();
-  const collected = await collectBoardItems(cfg, { repo: options.repo, activeOnly: false }, deps);
+  const collected = await collectBoardItems(cfg, { repo: options.repo, purpose: { kind: "archive" } }, deps);
   const candidates = collected.items.filter((item) => item.status === "Done" && item.state === "CLOSED");
   const result = {
     board: { owner: cfg.projectOwner, number: cfg.projectNumber, id: collected.projectId },
@@ -21504,11 +21599,12 @@ async function setBoardPriorityForSelector(options, deps = {}) {
   }
   return { ref: `${options.selector.repo}#${options.selector.number}`, itemId, priority };
 }
-async function fetchProjectPage(client, cfg, after) {
+async function fetchProjectPage(client, cfg, after, itemsQuery) {
   return client.graphql(PROJECT_ITEMS_QUERY, {
     owner: cfg.projectOwner,
     number: cfg.projectNumber,
-    ...after ? { after } : {}
+    ...after ? { after } : {},
+    ...itemsQuery ? { query: itemsQuery } : {}
   });
 }
 function isGraphQLNotFound(e) {
@@ -21991,6 +22087,9 @@ function openPullsFetcher(client) {
     return pulls;
   };
 }
+async function readClaimLiveness(client, repo, number) {
+  return gatherClaimLiveness(client, repo, number, openPullsFetcher(client));
+}
 async function gatherClaimLiveness(client, repo, number, fetchOpenPulls) {
   const out = { failed: [] };
   try {
@@ -22086,7 +22185,7 @@ var DOCTOR_CONCURRENCY = 4;
 async function boardDoctor(options, deps = {}) {
   const cfg = resolveBoardConfig(options.config);
   const client = deps.client ?? defaultGitHubClient();
-  const collected = await collectBoardItems(cfg, { repo: options.repo, activeOnly: false }, deps);
+  const collected = await collectBoardItems(cfg, { repo: options.repo, purpose: { kind: "doctor" } }, deps);
   const concurrency = Math.max(1, options.concurrency ?? DOCTOR_CONCURRENCY);
   const findings = [];
   const result = { scanned: collected.items.length, findings: 0, fixed: 0, failed: 0, items: [], liveClaims: [] };
@@ -22381,6 +22480,7 @@ var PRIMARY_GROUPS = [
   ["Coordinate and improve", ["wave", "report", "skill-lesson", "closure-rate"]]
 ];
 var OPERATIONAL_TOP_LEVEL = /* @__PURE__ */ new Set(["org", "runtime", "plugin"]);
+var CAMPAIGN_ORCHESTRATOR_TOP_LEVEL = /* @__PURE__ */ new Set(["pickup"]);
 var SUPPORT_PRIMARY = /* @__PURE__ */ new Set(["doctor", "whoami", "commands", "explain", "docs", "repo-index", "find", "tests", "spawn", "dist", "wave", "report", "skill-lesson", "closure-rate"]);
 var TOP_LEVEL_ORDER = /* @__PURE__ */ new Map();
 var HELP_GROUP_ORDER = /* @__PURE__ */ new Map();
@@ -22391,6 +22491,7 @@ for (const [helpGroup, names] of PRIMARY_GROUPS) {
 }
 HELP_GROUP_ORDER.set("Operations", HELP_GROUP_ORDER.size);
 for (const name of OPERATIONAL_TOP_LEVEL) TOP_LEVEL_ORDER.set(name, topLevelPosition++);
+for (const name of CAMPAIGN_ORCHESTRATOR_TOP_LEVEL) TOP_LEVEL_ORDER.set(name, topLevelPosition++);
 var PATH_OVERRIDES = {
   // #4184: the estate-search door reads as Orient, while rebuild/publish/gc/sync-estate stay
   // Setup and support — that split is the point.
@@ -22439,6 +22540,7 @@ var COMMAND_OWNERSHIP = {
   report: { module_owner: "cli/src/report.ts", consumer: "campaign-orchestrator" },
   "skill-lesson": { module_owner: "cli/src/skill-lesson.ts", consumer: "campaign-orchestrator" },
   "closure-rate": { module_owner: "cli/src/learning-closure-rate.ts", consumer: "campaign-orchestrator" },
+  pickup: { module_owner: "cli/src/learning-pickup.ts", consumer: "campaign-orchestrator" },
   org: { module_owner: "cli/src/command-consolidation.ts", consumer: "org-operator" },
   runtime: { module_owner: "cli/src/command-consolidation.ts", consumer: "runtime-operator" },
   plugin: { module_owner: "cli/src/plugin-guard-io.ts", consumer: "host-runtime" }
@@ -22471,6 +22573,14 @@ function primaryMetadata(name) {
 function topLevelMetadata(name) {
   const primary = primaryMetadata(name);
   if (primary) return primary;
+  if (CAMPAIGN_ORCHESTRATOR_TOP_LEVEL.has(name)) {
+    return {
+      category: "support",
+      discovery: "all-only",
+      help_group: "Coordinate and improve",
+      ...commandOwnership(name)
+    };
+  }
   if (!OPERATIONAL_TOP_LEVEL.has(name)) {
     throw new Error(`command taxonomy: unclassified top-level command "${name}"`);
   }
@@ -36110,9 +36220,12 @@ function catalogCommandPaths(manifest) {
   return acc;
 }
 function nearestExplainTargets(query, paths, limit = 5) {
-  const all = [...paths];
+  const parentPath = query.includes(" ") ? query.slice(0, query.lastIndexOf(" ")) : void 0;
+  const leaf = query.includes(" ") ? query.slice(query.lastIndexOf(" ") + 1) : query;
+  const guide = unknownCommandDomainGuide(parentPath, leaf);
+  if (guide) return guide.expected.slice(0, limit);
+  const all = filterUnknownCommandCandidates(parentPath, leaf, [...paths]);
   const leafOf = (p) => p.slice(p.lastIndexOf(" ") + 1);
-  const leaf = leafOf(query);
   const exactLeaf = all.filter((p) => p !== query && leafOf(p) === leaf).sort();
   if (exactLeaf.length) return exactLeaf.slice(0, limit);
   const out = [];
@@ -36238,13 +36351,15 @@ function registerExplainCommand(program3) {
     const commandPath3 = commandArgs.join(" ");
     const command = findCommandInManifest(manifest, commandPath3);
     if (!command) {
+      const parentPath = commandArgs.length > 1 ? commandArgs.slice(0, -1).join(" ") : void 0;
+      const guide = unknownCommandDomainGuide(parentPath, commandArgs.at(-1));
       const nearest = nearestExplainTargets(commandPath3, catalogCommandPaths(manifest));
       fail(`explain: unknown command "${commandPath3}"`, {
         code: ERROR_CODES.ERR_NOT_FOUND,
         ...nearest.length ? {
           expected: nearest,
-          did_you_mean: nearest[0],
-          corrected_command: `mmi-cli explain ${nearest[0]} --json`
+          did_you_mean: guide?.did_you_mean ?? nearest[0],
+          corrected_command: `mmi-cli explain ${guide?.did_you_mean ?? nearest[0]} --json`
         } : {}
       });
       return;
@@ -36985,6 +37100,130 @@ function registerSessionReport(program3) {
   });
 }
 
+// src/learning-pickup.ts
+init_cli_shared();
+init_github_client();
+var LEARNING_PICKUP_CMD = ["mmi-cli", "learning", "pickup"].join(" ");
+var LEARNING_CLAIM_MARKER_LIVE_MS = 24 * 60 * 6e4;
+function isLearningChannelItem(labels) {
+  return labels.includes(LEARNING_LABEL) || loopKindOf(labels) !== void 0;
+}
+function claimEvidenceBlocksLearningAdoption(evidence) {
+  if (evidence.failed.includes("comments")) return true;
+  if (!evidence.marker) return false;
+  if (evidence.sessionState === "live") return true;
+  if (evidence.openPr || evidence.branch) return true;
+  if (evidence.failed.length > 0) return true;
+  if (evidence.sessionState !== "dead" && evidence.markerAgeMs !== void 0 && evidence.markerAgeMs < LEARNING_CLAIM_MARKER_LIVE_MS) {
+    return true;
+  }
+  return false;
+}
+function evaluateLearningAdoption(input) {
+  if (!isLearningChannelItem(input.labels)) {
+    return { adoptable: false, learning: false, reason: "issue is not in the learning channel" };
+  }
+  if (String(input.state).toUpperCase() === "CLOSED") {
+    return { adoptable: false, learning: true, reason: "issue is closed" };
+  }
+  if (input.status === "In Progress" || input.status === "In Review") {
+    const owners = input.assignees.length ? [...input.assignees] : void 0;
+    const ownerPhrase = owners?.length ? `@${owners.join(", @")}` : "an active board owner";
+    return {
+      adoptable: false,
+      learning: true,
+      reason: `${input.status} \u2014 held by ${ownerPhrase}`,
+      ...owners ? { owners } : {}
+    };
+  }
+  if (input.assignees.length > 0) {
+    const owners = [...input.assignees];
+    return {
+      adoptable: false,
+      learning: true,
+      reason: `assigned to @${owners.join(", @")}`,
+      owners
+    };
+  }
+  if (input.claim && claimEvidenceBlocksLearningAdoption(input.claim)) {
+    const claimHolder = input.claim.marker ? describeClaimMarker(input.claim.marker) : void 0;
+    return {
+      adoptable: false,
+      learning: true,
+      reason: claimHolder ? `live claim marker from ${claimHolder}` : "claim marker evidence is unreadable \u2014 deferring adoption",
+      ...claimHolder ? { claimHolder } : {},
+      ...input.claim.marker ? { claimMarker: input.claim.marker } : {}
+    };
+  }
+  return { adoptable: true, learning: true };
+}
+async function probeLearningAdoption(deps, selector) {
+  const cfg = await deps.loadBoardConfig();
+  if (!cfg?.sagaApiUrl) {
+    throw new Error("learning pickup: Hub API URL not configured \u2014 board read required for adoption probe");
+  }
+  const item = await showBoardItem(
+    { config: cfg, selector: String(selector.number), repo: selector.repo },
+    { client: deps.client }
+  );
+  const claim = await readClaimLiveness(deps.client, item.repository, item.number);
+  const verdict = evaluateLearningAdoption({
+    labels: item.labels,
+    state: item.state,
+    status: item.status,
+    assignees: item.assignees,
+    claim
+  });
+  return { ...verdict, repo: item.repository, number: item.number, ref: item.ref };
+}
+function registerLearningPickupCommand(program3) {
+  withExamples(
+    program3.command("pickup").description(
+      "probe whether a learning-channel issue is free for cloud-agent adoption \u2014 refuses when a live claim marker or assigned In Progress owner already holds it (#5708)"
+    ).option("--repo <owner/repo>", "repo holding the issue").option("--number <n>", "issue number").argument("[ref]", "issue ref (#N or owner/repo#N)").option("--json", "print the structured adoption verdict JSON").action(async (ref, o) => {
+      const defaultRepo = await resolveRepo(o.repo);
+      if (!defaultRepo) return fail("learning pickup: could not resolve repo \u2014 pass --repo owner/repo");
+      let selector;
+      try {
+        if (ref) {
+          selector = parseIssueSelector(ref, defaultRepo);
+        } else if (o.number) {
+          selector = { repo: defaultRepo, number: Number.parseInt(o.number, 10) };
+          if (!Number.isFinite(selector.number)) throw new Error("invalid --number");
+        } else {
+          throw new Error("pass an issue ref or --number");
+        }
+      } catch (e) {
+        return fail(`learning pickup: ${e.message}`);
+      }
+      try {
+        const verdict = await probeLearningAdoption(
+          {
+            client: defaultGitHubClient(),
+            loadBoardConfig: async () => loadConfigOrDiscover()
+          },
+          selector
+        );
+        if (o.json) console.log(JSON.stringify(verdict, null, 2));
+        else if (verdict.adoptable) {
+          console.log(`${verdict.ref} is adoptable for learning automation`);
+        } else {
+          const owner = "owners" in verdict && verdict.owners?.length ? ` (owner: @${verdict.owners.join(", @")})` : "claimHolder" in verdict && verdict.claimHolder ? ` (claim: ${verdict.claimHolder})` : "";
+          console.log(`${verdict.ref} is not adoptable \u2014 ${verdict.reason}${owner}`);
+        }
+        if (!verdict.adoptable) process.exitCode = 2;
+      } catch (e) {
+        return fail(`learning pickup: ${e.message}`);
+      }
+    }),
+    [
+      LEARNING_PICKUP_CMD + " mutmutco/Jerv-JervCode#2395 --json",
+      LEARNING_PICKUP_CMD + " --repo mutmutco/MMI-Hub --number 42"
+    ],
+    "exit code 2 means defer or refuse \u2014 the learning lane must not implement the issue"
+  );
+}
+
 // ../infra/src/fleet-health.ts
 function uniqueRepos(repos) {
   const unique = /* @__PURE__ */ new Map();
@@ -40733,7 +40972,14 @@ function unknownCommandCandidates(parent, allPaths) {
 function resolveParseHint() {
   if (lastParseErrorKind === "unknown-command") {
     const parent = resolveCommandFromArgv(program2, process.argv.slice(2));
-    const candidates = unknownCommandCandidates(parent, allCommandPaths());
+    const parentPath = parent ? canonicalPathFor(commandPath2(parent)) ?? commandPath2(parent) : void 0;
+    const guide = unknownCommandDomainGuide(parentPath, lastUnknownCommand);
+    if (guide) return `(${guide.hint}. ${DISCOVERY_HINT})`;
+    const candidates = filterUnknownCommandCandidates(
+      parentPath,
+      lastUnknownCommand,
+      unknownCommandCandidates(parent, allCommandPaths())
+    );
     const path3 = lastUnknownCommand ? suggestCommandPath(lastUnknownCommand, candidates) : void 0;
     const canonical = path3 ? canonicalPathFor(path3) ?? path3 : void 0;
     if (canonical) return `(did you mean \`mmi-cli ${canonical}\`? ${DISCOVERY_HINT})`;
@@ -42075,7 +42321,7 @@ function resolveCreateSurface(opts) {
 function surfaceWaived() {
   return rawFlag("--no-surface");
 }
-var issue = program2.command("issue").description("issues \u2014 create and view with structured JSON (view; show is an alias for board-verb callers). Claims are board mutations: use `oracle board claim`, never `oracle issue claim`");
+var issue = program2.command("issue").description("issues \u2014 create and view with structured JSON (view; show and get alias view for board-verb/gh-shaped callers). Claims are board mutations: use `oracle board claim`, never `oracle issue claim`");
 withExamples(mutating(
   issue.command("create").description("create an issue (type \u2014 label) and print {number,url,label} JSON").addOption(new Option("--type <type>", "bug | feature | task (sets the matching label; required unless --batch)").choices([...ISSUE_TYPES])).option("--title <title>", "issue title").option("--title-file <path|->", "read the issue title from a UTF-8 file, or from stdin with -").option("--body <body>", "issue body (markdown)").option("--body-file <path|->", "read issue body from a UTF-8 file. `-` (stdin) needs a heredoc, which the agent inline-body guard denies (#1473/#2125) \u2014 prefer a real path; a title with backticks needs --title-file for the same reason (#3381)").option("--priority <priority>", "urgent | high | medium | low (defaults to medium; sets the board Priority field only \u2014 never a priority:* label, #416)").option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--label <label...>", "extra label(s) to attach (repeatable; auto-created if missing)").option("--surface <surface>", "issue surface, with or without the surface: prefix (#3789). Required when the target repo runs the one-surface-label board rule; any value satisfies it, so this is not a closed enum").option("--no-surface", "file without a surface label on a repo that requires one \u2014 for a genuinely exempt filing (e.g. a coop proof issue that spans every surface)").option("--parent <ref>", "file as a native sub-issue of this parent (#123, owner/repo#123, or URL)").option("--no-related", "skip the auto related-issues comment"),
   // --dry-run/--validate-only plan: resolve the same title source and validate the same type, priority,
@@ -42236,7 +42482,7 @@ async function readParentField(number, repo) {
   }
   return resolveParentField(payload);
 }
-issue.command("view <number>").alias("show").description('read an issue as structured JSON \u2014 the mmi-cli path for non-board issue reads (#2347). --comments folds in every comment; --context also adds linkedPrs + children (the one-shot "load the whole item" read, #2894). `show` is an alias (#5483)').option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json [fields...]", 'gh --json field list (overrides the default field set). Accepts commas, spaces, or repeated --json flags \u2014 in PowerShell an unquoted comma list is an array literal, so QUOTE it: --json "number,title,body,url"').option("--comments", 'include every comment (body + comments in one call) \u2014 the agentic "read the whole item before working it" read (#2894)').option("--context", "full working context in one call: implies --comments and also adds linkedPrs and, for an epic, a children summary (#2894)").action(async (number, o) => {
+issue.command("view <number>").aliases(["show", "get"]).description('read an issue as structured JSON \u2014 the mmi-cli path for non-board issue reads (#2347). --comments folds in every comment; --context also adds linkedPrs + children (the one-shot "load the whole item" read, #2894). `show` and `get` alias view (#5483/#5706)').option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json [fields...]", 'gh --json field list (overrides the default field set). Accepts commas, spaces, or repeated --json flags \u2014 in PowerShell an unquoted comma list is an array literal, so QUOTE it: --json "number,title,body,url"').option("--comments", 'include every comment (body + comments in one call) \u2014 the agentic "read the whole item before working it" read (#2894)').option("--context", "full working context in one call: implies --comments and also adds linkedPrs and, for an epic, a children summary (#2894)").action(async (number, o) => {
   const n = Number(number);
   if (!Number.isInteger(n) || n <= 0) return fail("issue view: <number> must be a positive integer");
   const repo = await resolveRepo(o.repo);
@@ -43155,6 +43401,7 @@ registerExplainCommand(program2);
 registerPrLifecycleCommands(program2);
 registerSessionReport(program2);
 registerLearningClosureRateCommand(program2);
+registerLearningPickupCommand(program2);
 registerBoardCommands(program2);
 registerStageCommands(program2);
 var GH_TRAIN_TIMEOUT_MS = 3e4;
@@ -43162,10 +43409,11 @@ var GH_RUN_WATCH_TIMEOUT_MS = 20 * 6e4;
 var NODE_PREPARE_TIMEOUT_MS = 10 * 6e4;
 var NODE_VERIFY_TIMEOUT_MS = 5 * 6e4;
 var NPM_TRAIN_TIMEOUT_MS = 6e4;
+var JERV_GATEWAY_DEPLOY_TIMEOUT_MS = 20 * 6e4;
 function trainApplyDeps() {
   return {
     run: async (file, args) => {
-      const timeout = file === "node" && args[1] === "prepare" ? NODE_PREPARE_TIMEOUT_MS : file === "node" && args[1] === "verify" ? NODE_VERIFY_TIMEOUT_MS : file === "npm" ? NPM_TRAIN_TIMEOUT_MS : file !== "gh" ? GIT_TIMEOUT_MS : args[0] === "run" && args[1] === "watch" ? GH_RUN_WATCH_TIMEOUT_MS : GH_TRAIN_TIMEOUT_MS;
+      const timeout = file === "node" && args[1] === "prepare" ? NODE_PREPARE_TIMEOUT_MS : file === "node" && args[1] === "verify" ? NODE_VERIFY_TIMEOUT_MS : file === "npm" ? NPM_TRAIN_TIMEOUT_MS : file === "bash" && args[0] === "scripts/jerv-gateway-release-deploy.sh" ? JERV_GATEWAY_DEPLOY_TIMEOUT_MS : file !== "gh" ? GIT_TIMEOUT_MS : args[0] === "run" && args[1] === "watch" ? GH_RUN_WATCH_TIMEOUT_MS : GH_TRAIN_TIMEOUT_MS;
       try {
         return isWin2 && file === "npm" ? (await execFileP2("cmd.exe", ["/c", "npm", ...args], { timeout })).stdout : (await execFileP2(file, args, { timeout })).stdout;
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "4.1.12",
+  "version": "4.1.14",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",