@mutmutco/cli 3.21.0 → 3.23.0

package/dist/main.cjs

@@ -10237,6 +10237,11 @@ function resolvePrViewFields(tokens2, defaultPrFields) {
   const provided = tokens2 !== void 0 && tokens2.length > 0;
   return provided ? normalizeIssueViewJsonFields(tokens2) : defaultPrFields;
 }
+function ensureField(fields, field) {
+  const list = fields.split(",").map((f) => f.trim()).filter(Boolean);
+  if (!list.includes(field)) list.push(field);
+  return list.join(",");
+}
 
 // src/sub-issue.ts
 function parseIssueRef(ref) {
@@ -17278,6 +17283,39 @@ async function runPrForIssue(deps, issueRef, opts) {
   }
   return extractPrForIssueResponse(resp);
 }
+async function runIssueViewContext(deps, opts) {
+  const fields = opts.comments || opts.context ? ensureField(opts.jsonFields, "comments") : opts.jsonFields;
+  const base = await deps.ghJson(["issue", "view", String(opts.number), "--repo", opts.repo, "--json", fields], GH_LIST_TIMEOUT_MS);
+  if (!opts.context) return base;
+  const result = { ...base };
+  const ref = `${opts.repo}#${opts.number}`;
+  let partial = false;
+  try {
+    result.linkedPrs = await runPrForIssue(deps, ref, { repo: opts.repo });
+  } catch {
+    result.linkedPrs = [];
+    partial = true;
+  }
+  try {
+    const children = await runIssueChildren(deps, ref, { recursive: false, boardProjectId: opts.boardProjectId });
+    if (children.length) result.children = children;
+  } catch {
+    partial = true;
+  }
+  if (partial) result.partial = true;
+  return result;
+}
+async function runPrViewContext(deps, opts) {
+  let fields = opts.jsonFields;
+  if (opts.comments || opts.context) fields = ensureField(fields, "comments");
+  if (opts.context) fields = ensureField(fields, "closingIssuesReferences");
+  const base = await deps.ghJson(["pr", "view", String(opts.number), "--repo", opts.repo, "--json", fields], GH_LIST_TIMEOUT_MS);
+  if (!opts.context) return base;
+  const result = { ...base };
+  result.linkedIssues = Array.isArray(base.closingIssuesReferences) ? base.closingIssuesReferences : [];
+  delete result.closingIssuesReferences;
+  return result;
+}
 function queryFail(command, e) {
   if (e instanceof QueryReadError) {
     const code = e.code === "NOT_FOUND" ? ERROR_CODES.ERR_NOT_FOUND : e.code === "NO_AUTH" ? ERROR_CODES.ERR_NO_AUTH : ERROR_CODES.ERR_BAD_ENUM;
@@ -17311,15 +17349,18 @@ async function resolveBoardProjectId(repoOption) {
     return void 0;
   }
 }
-function registerQueryCommands(program3) {
-  const issue2 = program3.commands.find((c) => c.name() === "issue");
-  const pr2 = program3.commands.find((c) => c.name() === "pr");
-  if (!issue2 || !pr2) return;
-  const deps = {
+function queryDeps() {
+  return {
     ghJson: async (args, timeoutMs = GH_LIST_TIMEOUT_MS) => JSON.parse((await execFileP2("gh", args, { timeout: timeoutMs })).stdout),
     viewer: () => githubLogin(),
     resolveRepo: resolveRepo2
   };
+}
+function registerQueryCommands(program3) {
+  const issue2 = program3.commands.find((c) => c.name() === "issue");
+  const pr2 = program3.commands.find((c) => c.name() === "pr");
+  if (!issue2 || !pr2) return;
+  const deps = queryDeps();
   issue2.command("list").description("bounded issue read \u2014 filter by label/state/assignee (NO free-text search); always prints JSON").option("--label <label>", "filter by label").option("--state <state>", "open | closed | all", "open").option("--assignee <login>", "filter by assignee login").option("--limit <n>", "max issues to return (capped at 100)", (v) => Number(v), DEFAULT_LIMIT).option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json", "machine-readable output (already the default \u2014 accepted for contract uniformity)").action(async (o) => {
     try {
       const state = validateEnum("--state", ISSUE_STATES, o.state, "issue list");
@@ -21107,13 +21148,19 @@ withExamples(mutating(
   "--type is one of bug|feature|task.",
   "--dry-run and --validate-only pre-validate the create plan before any issue is written."
 ]);
-issue.command("view <number>").description("read an issue as structured JSON \u2014 the mmi-cli path for non-board issue reads (#2347)").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"').action(async (number, o) => {
+issue.command("view <number>").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)').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);
   if (!repo) return fail("issue view: could not resolve repo (pass --repo <owner/repo>)");
   const fields = normalizeIssueViewJsonFields(o.json);
   try {
+    if (o.comments || o.context) {
+      const boardProjectId = o.context ? await resolveBoardProjectId(o.repo) : void 0;
+      const data2 = await runIssueViewContext(queryDeps(), { number: n, repo, comments: Boolean(o.comments), context: Boolean(o.context), jsonFields: fields, boardProjectId });
+      console.log(JSON.stringify(data2));
+      return;
+    }
     const data = await ghJson(["issue", "view", String(n), "--repo", repo, "--json", fields]);
     console.log(JSON.stringify(data));
   } catch (e) {
@@ -21357,7 +21404,7 @@ withExamples(pr.command("create").description("create a PR and print {number,url
   "--head and --base default to the current branch and the repo default; only pass them to override.",
   "Use --body-file for multiline PR bodies instead of shell-escaped inline markdown."
 ]);
-pr.command("view <number>").description("read a PR as structured JSON (merged state, head/base, URL, merge commit) \u2014 the mmi-cli read path (#2347)").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 "state,baseRefName,mergeCommit"').action(async (number, o) => {
+pr.command("view <number>").description("read a PR as structured JSON (merged state, head/base, URL, merge commit) \u2014 the mmi-cli read path (#2347). --comments folds in every comment; --context also adds linkedIssues (the issues it closes/references, #2894)").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 "state,baseRefName,mergeCommit"').option("--comments", "include every comment (body + comments in one call) \u2014 read the whole PR before landing it (#2894)").option("--context", "full working context in one call: implies --comments and also adds linkedIssues (the issues the PR closes/references) (#2894)").action(async (number, o) => {
   const n = Number(number);
   if (!Number.isInteger(n) || n <= 0) return fail("pr view: <number> must be a positive integer");
   const repo = await resolveRepo(o.repo);
@@ -21365,6 +21412,11 @@ pr.command("view <number>").description("read a PR as structured JSON (merged st
   const defaultPrFields = "number,title,state,url,isDraft,mergeable,mergedAt,mergeCommit,headRefName,baseRefName,author,labels";
   const effective = resolvePrViewFields(o.json, defaultPrFields);
   try {
+    if (o.comments || o.context) {
+      const data2 = await runPrViewContext(queryDeps(), { number: n, repo, comments: Boolean(o.comments), context: Boolean(o.context), jsonFields: effective });
+      console.log(JSON.stringify(data2));
+      return;
+    }
     const data = await ghJson(["pr", "view", String(n), "--repo", repo, "--json", effective]);
     console.log(JSON.stringify(data));
   } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "3.21.0",
+  "version": "3.23.0",
   "description": "MMI Future CLI — the org dev toolbox (board, registry, keyless secrets, release train, bootstrap, doctor) and the cross-IDE engine the plugin's session-start hook drives.",
   "type": "module",
   "license": "UNLICENSED",