@unbrained/pm-cli 2026.6.30 → 2026.7.2

package/dist/cli-bundle/chunks/get-GIBRUUOP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/get.ts"],"sourcesContent":["/**\n * @module cli/commands/get\n *\n * Implements the pm get command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { buildItemNotFoundError, listAllFrontMatterLight, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport type { ItemFrontMatter, LinkedDoc, LinkedFile, LinkedTest } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { runList } from \"./list.js\";\n\ninterface ClaimHistoryContext {\n  ts: string;\n  author: string;\n  message: string | null;\n}\n\ninterface ClaimHistoryEntry {\n  op: string;\n  ts: string;\n  author: string;\n  message?: string;\n}\n\ninterface ClaimStateContext {\n  claimed: boolean;\n  assignee: string | null;\n  last_claim: ClaimHistoryContext | null;\n  last_release: ClaimHistoryContext | null;\n}\n\ninterface ChildRollupContext {\n  count: number;\n  active: number;\n  by_status: Record<string, number>;\n}\n\n// GH-155 (pm-gcm3): only container types get the inline child rollup so leaf\n// item reads keep avoiding the corpus scan that the rollup requires.\nconst CHILD_ROLLUP_TYPES = new Set([\"milestone\", \"epic\"]);\n\n/**\n * Documents the get result payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetResult {\n  // `body` lives inside `item` (alongside `description`/`acceptance_criteria`)\n  // for parity with `pm list --include-body`, so agents reliably find it at\n  // `.item.body` in JSON output instead of a top-level sibling.\n  item: Partial<ItemFrontMatter> & { body?: string };\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n  children?: ChildRollupContext;\n  tree?: {\n    root_id: string;\n    root_title: string | null;\n    depth_limit: number | null;\n    count: number;\n    items: Record<string, unknown>[];\n  };\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\n/**\n * Documents the get options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\n  tree?: boolean;\n  treeDepth?: string;\n}\n\nfunction toClaimHistoryContext(\n  entry: ClaimHistoryEntry,\n): ClaimHistoryContext {\n  return {\n    ts: entry.ts,\n    author: entry.author,\n    message: entry.message ?? null,\n  };\n}\n\nfunction resolveClaimStateContext(\n  assigneeValue: string | undefined,\n  history: ClaimHistoryEntry[],\n): ClaimStateContext {\n  const assignee = assigneeValue?.trim();\n  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;\n  const lastClaim = [...history].reverse().find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history].reverse().find((entry) => entry.op === \"release\");\n  return {\n    claimed: normalizedAssignee !== null,\n    assignee: normalizedAssignee,\n    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,\n    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,\n  };\n}\n\nfunction parseGetDepth(raw: string | undefined): GetDepth {\n  if (raw === undefined || raw.trim().length === 0) {\n    return \"standard\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized === \"full\") {\n    return \"deep\";\n  }\n  if (GET_DEPTH_VALUES.includes(normalized as GetDepth)) {\n    return normalized as GetDepth;\n  }\n  throw new PmCliError(\"Get --depth must be one of brief|standard|deep|full\", EXIT_CODE.USAGE);\n}\n\nfunction projectItemForDepth(item: ItemFrontMatter, depth: GetDepth): Partial<ItemFrontMatter> {\n  if (depth === \"deep\") {\n    return item;\n  }\n  const {\n    comments: _comments,\n    notes: _notes,\n    learnings: _learnings,\n    files: _files,\n    tests: _tests,\n    docs: _docs,\n    reminders: _reminders,\n    events: _events,\n    ...projected\n  } = item;\n  return projected;\n}\n\nfunction parseGetFields(raw: string | undefined): string[] | null {\n  if (raw === undefined) {\n    return null;\n  }\n  const fields = raw\n    .split(\",\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Get --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  return fields;\n}\n\nfunction normalizeGetField(field: string): string {\n  return field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n}\n\nfunction validateGetFields(fields: string[] | null, runtimeMetadataKeys: Iterable<string>): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([...FRONT_MATTER_KEY_ORDER, ...runtimeMetadataKeys]);\n  const allowedRootFields = new Set([\"body\", \"linked\", \"claim_state\", \"children\"]);\n  const allowedLinkedFields = new Set([\"linked.files\", \"linked.tests\", \"linked.docs\"]);\n  const allowedClaimStateFields = new Set([\"claim_state.claimed\", \"claim_state.assignee\", \"claim_state.last_claim\", \"claim_state.last_release\"]);\n  const unknown = fields.filter((field) => {\n    const normalized = normalizeGetField(field);\n    return (\n      !itemFields.has(normalized) &&\n      !allowedRootFields.has(normalized) &&\n      !allowedLinkedFields.has(normalized) &&\n      !allowedClaimStateFields.has(normalized)\n    );\n  });\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      code: \"unknown_field_projection\",\n      examples: [\n        \"pm get <id> --fields id,title,status,type,updated_at\",\n        \"pm get <id> --fields id,title,claim_state\",\n        \"pm get <id> --fields id,title,body,linked.files\",\n      ],\n    });\n  }\n}\n\nfunction projectItemForFields(item: ItemFrontMatter, fields: string[]): Partial<ItemFrontMatter> {\n  const source = toItemRecord(item);\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n    if (normalized === \"body\" || normalized === \"linked\" || normalized.startsWith(\"linked.\")) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemFrontMatter>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return fields?.some((field) => field === name || field === `item.${name}`) ?? false;\n}\n\nfunction fieldsIncludeRoot(fields: string[], name: string): boolean {\n  return fields.some((field) => field === name || field.startsWith(`${name}.`));\n}\n\ninterface ResolvedGetProjection {\n  depth: GetDepth;\n  treeDepth: number | undefined;\n  fields: string[] | null;\n  fieldProjection: boolean;\n}\n\ninterface GetItemContext {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  locatedId: string;\n  metadata: ItemFrontMatter;\n  body: string;\n}\n\nfunction resolveGetProjection(options: GetOptions): ResolvedGetProjection {\n  if (options.full && (options.fields !== undefined || options.depth !== undefined)) {\n    throw new PmCliError(\"Get projection options are mutually exclusive; remove the extra projection flag and retry.\", EXIT_CODE.USAGE);\n  }\n  if (options.tree !== true && options.treeDepth !== undefined) {\n    throw new PmCliError(\"Get --tree-depth requires --tree\", EXIT_CODE.USAGE);\n  }\n  return {\n    depth: options.full ? \"deep\" : parseGetDepth(options.depth),\n    treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, \"--tree-depth\") : undefined,\n    fields: parseGetFields(options.fields),\n    fieldProjection: options.fields !== undefined,\n  };\n}\n\nasync function loadGetItemContext(id: string, global: GlobalOptions): Promise<GetItemContext> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  return {\n    pmRoot,\n    settings,\n    typeToFolder: typeRegistry.type_to_folder,\n    locatedId: located.id,\n    metadata: loaded.document.metadata,\n    body: loaded.document.body,\n  };\n}\n\nfunction validateGetProjectionFields(fields: string[] | null, settings: Awaited<ReturnType<typeof readSettings>>): void {\n  const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);\n  validateGetFields(fields, runtimeMetadataKeys);\n}\n\nfunction shouldIncludeGetField(params: {\n  fieldProjection: boolean;\n  depth: GetDepth;\n  fields: string[] | null;\n  field: \"body\" | \"linked\" | \"claim_state\" | \"children\";\n  itemType?: string;\n}): boolean {\n  const { fieldProjection, depth, fields, field, itemType } = params;\n  if (fieldProjection) {\n    if (field === \"body\" || field === \"linked\") {\n      return fieldsInclude(fields, field);\n    }\n    return fieldsIncludeRoot(fields as string[], field);\n  }\n  if (field === \"children\") {\n    return depth !== \"brief\" && CHILD_ROLLUP_TYPES.has(itemType as string);\n  }\n  return depth !== \"brief\";\n}\n\nasync function resolveGetClaimState(context: GetItemContext, includeClaimState: boolean): Promise<ClaimStateContext | undefined> {\n  if (!includeClaimState) {\n    return undefined;\n  }\n  const historyPath = getHistoryPath(context.pmRoot, context.locatedId);\n  const history = await readHistoryEntries(historyPath, context.locatedId);\n  return resolveClaimStateContext(context.metadata.assignee, history);\n}\n\nfunction attachGetLinked(\n  result: GetResult,\n  context: GetItemContext,\n  fields: string[] | null,\n  includeLinked: boolean,\n): void {\n  const includeLinkedFiles = includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests = includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs = includeLinked || fieldsInclude(fields, \"linked.docs\");\n  if (!includeLinked && !includeLinkedFiles && !includeLinkedTests && !includeLinkedDocs) {\n    return;\n  }\n  result.linked = {\n    files: includeLinkedFiles ? context.metadata.files ?? [] : [],\n    tests: includeLinkedTests ? context.metadata.tests ?? [] : [],\n    docs: includeLinkedDocs ? context.metadata.docs ?? [] : [],\n  };\n}\n\nasync function buildGetChildrenRollup(context: GetItemContext, includeChildren: boolean): Promise<ChildRollupContext | undefined> {\n  if (!includeChildren) {\n    return undefined;\n  }\n  const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);\n  const corpus = await listAllFrontMatterLight(\n    context.pmRoot,\n    context.settings.item_format,\n    context.typeToFolder,\n    undefined,\n    context.settings.schema,\n  );\n  const byStatus: Record<string, number> = {};\n  let active = 0;\n  let count = 0;\n  const locatedId = context.locatedId.trim().toLowerCase();\n  for (const candidate of corpus) {\n    const parentId = typeof candidate.parent === \"string\" ? candidate.parent.trim().toLowerCase() : \"\";\n    if (parentId !== locatedId) continue;\n    const candidateStatus = candidate.status.trim().toLowerCase();\n    count += 1;\n    byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;\n    if (!isTerminalStatus(candidateStatus, statusRegistry)) {\n      active += 1;\n    }\n  }\n  return { count, active, by_status: byStatus };\n}\n\nasync function buildGetTree(\n  context: GetItemContext,\n  options: GetOptions,\n  treeDepth: number | undefined,\n  global: GlobalOptions,\n): Promise<GetResult[\"tree\"] | undefined> {\n  if (options.tree !== true) {\n    return undefined;\n  }\n  const subtree = await runList(\n    undefined,\n    {\n      parent: context.locatedId,\n      tree: true,\n      treeDepth: treeDepth === undefined ? undefined : String(treeDepth),\n      full: true,\n    },\n    global,\n  );\n  return {\n    root_id: context.locatedId,\n    root_title: context.metadata.title,\n    depth_limit: treeDepth ?? null,\n    count: subtree.count,\n    items: subtree.items.map((entry) => toItemRecord(entry)),\n  };\n}\n\n/**\n * Implements run get for the public runtime surface of this module.\n */\nexport async function runGet(id: string, global: GlobalOptions, options: GetOptions = {}): Promise<GetResult> {\n  const projection = resolveGetProjection(options);\n  const context = await loadGetItemContext(id, global);\n  validateGetProjectionFields(projection.fields, context.settings);\n  const includeBody = shouldIncludeGetField({ ...projection, field: \"body\" });\n  const includeLinked = shouldIncludeGetField({ ...projection, field: \"linked\" });\n  const includeClaimState = shouldIncludeGetField({ ...projection, field: \"claim_state\" });\n  const itemType = context.metadata.type.trim().toLowerCase();\n  const includeChildren = shouldIncludeGetField({ ...projection, field: \"children\", itemType });\n  const claimState = await resolveGetClaimState(context, includeClaimState);\n  const result: GetResult = {\n    item: projection.fieldProjection\n      ? projectItemForFields(context.metadata, projection.fields as string[])\n      : projectItemForDepth(context.metadata, projection.depth),\n  };\n  if (includeBody) {\n    result.item.body = context.body;\n  }\n  attachGetLinked(result, context, projection.fields, includeLinked);\n  if (claimState) {\n    result.claim_state = claimState;\n  }\n  result.children = await buildGetChildrenRollup(context, includeChildren);\n  result.tree = await buildGetTree(context, options, projection.treeDepth, global);\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"6ca42fbb-ef56-50b9-a64a-2e34cbb0ee9a"}

package/dist/cli-bundle/chunks/{get-AWK324RS.js → get-IOVAN6RU.js}

@@ -1,21 +1,26 @@
 import {
   readHistoryEntries
-} from "./chunk-IBU2LLWM.js";
-import "./chunk-E2Q2ULMR.js";
+} from "./chunk-A6VOGKBA.js";
+import "./chunk-N2JSWVWG.js";
+import {
+  runList
+} from "./chunk-W47SML5B.js";
+import "./chunk-R23CSHGI.js";
+import "./chunk-36UGKF4O.js";
 import {
   parseIntegerLimit
-} from "./chunk-7L6TXOOC.js";
+} from "./chunk-JMK5GCK2.js";
 import {
   buildItemNotFoundError,
   listAllFrontMatterLight,
   locateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-LBH7UYKY.js";
+} from "./chunk-JXAUVO6X.js";
 import {
   isTerminalStatus
-} from "./chunk-ZFIEEDTJ.js";
-import "./chunk-MLHX6DN5.js";
+} from "./chunk-IEEJQCZ4.js";
+import "./chunk-AIAIXG7I.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -29,13 +34,13 @@ import {
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry
-} from "./chunk-SNUK7H5J.js";
+} from "./chunk-7NSPKJUS.js";
 
 // dist/cli/commands/get.js
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "31e24598-6203-517a-945d-f07fbc69689e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ed20649d-dbe4-5e6b-9e36-2ff9e8eb0260");
   } catch (e2) {
   }
 })();
@@ -134,16 +139,21 @@ function fieldsInclude(fields, name) {
 function fieldsIncludeRoot(fields, name) {
   return fields.some((field) => field === name || field.startsWith(`${name}.`));
 }
-async function runGet(id, global2, options = {}) {
+function resolveGetProjection(options) {
   if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
     throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.", EXIT_CODE.USAGE);
   }
   if (options.tree !== true && options.treeDepth !== void 0) {
     throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
   }
-  const depth = options.full ? "deep" : parseGetDepth(options.depth);
-  const treeDepth = options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0;
-  const fields = parseGetFields(options.fields);
+  return {
+    depth: options.full ? "deep" : parseGetDepth(options.depth),
+    treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0,
+    fields: parseGetFields(options.fields),
+    fieldProjection: options.fields !== void 0
+  };
+}
+async function loadGetItemContext(id, global2) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -155,89 +165,119 @@ async function runGet(id, global2, options = {}) {
     throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);
   }
   const loaded = await readLocatedItem(located, { schema: settings.schema });
-  const runtimeMetadataKeys = [];
-  for (const field of resolveRuntimeFieldRegistry(settings.schema).definitions) {
-    runtimeMetadataKeys.push(field.metadata_key);
-  }
+  return {
+    pmRoot,
+    settings,
+    typeToFolder: typeRegistry.type_to_folder,
+    locatedId: located.id,
+    metadata: loaded.document.metadata,
+    body: loaded.document.body
+  };
+}
+function validateGetProjectionFields(fields, settings) {
+  const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);
   validateGetFields(fields, runtimeMetadataKeys);
-  const files = loaded.document.metadata.files ?? [];
-  const tests = loaded.document.metadata.tests ?? [];
-  const docs = loaded.document.metadata.docs ?? [];
-  const fieldProjection = fields !== null;
-  const includeBody = !fieldProjection ? depth !== "brief" : fieldsInclude(fields, "body");
-  const includeLinked = !fieldProjection ? depth !== "brief" : fieldsInclude(fields, "linked");
+}
+function shouldIncludeGetField(params) {
+  const { fieldProjection, depth, fields, field, itemType } = params;
+  if (fieldProjection) {
+    if (field === "body" || field === "linked") {
+      return fieldsInclude(fields, field);
+    }
+    return fieldsIncludeRoot(fields, field);
+  }
+  if (field === "children") {
+    return depth !== "brief" && CHILD_ROLLUP_TYPES.has(itemType);
+  }
+  return depth !== "brief";
+}
+async function resolveGetClaimState(context, includeClaimState) {
+  if (!includeClaimState) {
+    return void 0;
+  }
+  const historyPath = getHistoryPath(context.pmRoot, context.locatedId);
+  const history = await readHistoryEntries(historyPath, context.locatedId);
+  return resolveClaimStateContext(context.metadata.assignee, history);
+}
+function attachGetLinked(result, context, fields, includeLinked) {
   const includeLinkedFiles = includeLinked || fieldsInclude(fields, "linked.files");
   const includeLinkedTests = includeLinked || fieldsInclude(fields, "linked.tests");
   const includeLinkedDocs = includeLinked || fieldsInclude(fields, "linked.docs");
-  const includeClaimState = !fieldProjection ? depth !== "brief" : fieldsIncludeRoot(fields, "claim_state");
-  let claimState;
-  if (includeClaimState) {
-    const historyPath = getHistoryPath(pmRoot, located.id);
-    let history = [];
-    try {
-      history = await readHistoryEntries(historyPath, located.id);
-    } catch {
-      history = [];
+  if (!includeLinked && !includeLinkedFiles && !includeLinkedTests && !includeLinkedDocs) {
+    return;
+  }
+  result.linked = {
+    files: includeLinkedFiles ? context.metadata.files ?? [] : [],
+    tests: includeLinkedTests ? context.metadata.tests ?? [] : [],
+    docs: includeLinkedDocs ? context.metadata.docs ?? [] : []
+  };
+}
+async function buildGetChildrenRollup(context, includeChildren) {
+  if (!includeChildren) {
+    return void 0;
+  }
+  const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);
+  const corpus = await listAllFrontMatterLight(context.pmRoot, context.settings.item_format, context.typeToFolder, void 0, context.settings.schema);
+  const byStatus = {};
+  let active = 0;
+  let count = 0;
+  const locatedId = context.locatedId.trim().toLowerCase();
+  for (const candidate of corpus) {
+    const parentId = typeof candidate.parent === "string" ? candidate.parent.trim().toLowerCase() : "";
+    if (parentId !== locatedId)
+      continue;
+    const candidateStatus = candidate.status.trim().toLowerCase();
+    count += 1;
+    byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;
+    if (!isTerminalStatus(candidateStatus, statusRegistry)) {
+      active += 1;
     }
-    claimState = resolveClaimStateContext(loaded.document.metadata.assignee, history);
   }
+  return { count, active, by_status: byStatus };
+}
+async function buildGetTree(context, options, treeDepth, global2) {
+  if (options.tree !== true) {
+    return void 0;
+  }
+  const subtree = await runList(void 0, {
+    parent: context.locatedId,
+    tree: true,
+    treeDepth: treeDepth === void 0 ? void 0 : String(treeDepth),
+    full: true
+  }, global2);
+  return {
+    root_id: context.locatedId,
+    root_title: context.metadata.title,
+    depth_limit: treeDepth ?? null,
+    count: subtree.count,
+    items: subtree.items.map((entry) => toItemRecord(entry))
+  };
+}
+async function runGet(id, global2, options = {}) {
+  const projection = resolveGetProjection(options);
+  const context = await loadGetItemContext(id, global2);
+  validateGetProjectionFields(projection.fields, context.settings);
+  const includeBody = shouldIncludeGetField({ ...projection, field: "body" });
+  const includeLinked = shouldIncludeGetField({ ...projection, field: "linked" });
+  const includeClaimState = shouldIncludeGetField({ ...projection, field: "claim_state" });
+  const itemType = context.metadata.type.trim().toLowerCase();
+  const includeChildren = shouldIncludeGetField({ ...projection, field: "children", itemType });
+  const claimState = await resolveGetClaimState(context, includeClaimState);
   const result = {
-    item: fieldProjection ? projectItemForFields(loaded.document.metadata, fields) : projectItemForDepth(loaded.document.metadata, depth)
+    item: projection.fieldProjection ? projectItemForFields(context.metadata, projection.fields) : projectItemForDepth(context.metadata, projection.depth)
   };
   if (includeBody) {
-    result.item.body = loaded.document.body;
-  }
-  if (includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {
-    result.linked = {
-      files: includeLinkedFiles ? files : [],
-      tests: includeLinkedTests ? tests : [],
-      docs: includeLinkedDocs ? docs : []
-    };
+    result.item.body = context.body;
   }
+  attachGetLinked(result, context, projection.fields, includeLinked);
   if (claimState) {
     result.claim_state = claimState;
   }
-  const itemType = loaded.document.metadata.type.trim().toLowerCase();
-  const includeChildren = fieldProjection ? fieldsIncludeRoot(fields, "children") : depth !== "brief" && CHILD_ROLLUP_TYPES.has(itemType);
-  if (includeChildren) {
-    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-    const corpus = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
-    const byStatus = {};
-    let active = 0;
-    let count = 0;
-    const locatedId = located.id.trim().toLowerCase();
-    for (const candidate of corpus) {
-      const parentId = typeof candidate.parent === "string" ? candidate.parent.trim().toLowerCase() : "";
-      if (parentId !== locatedId)
-        continue;
-      const candidateStatus = candidate.status.trim().toLowerCase();
-      count += 1;
-      byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;
-      if (!isTerminalStatus(candidateStatus, statusRegistry)) {
-        active += 1;
-      }
-    }
-    result.children = { count, active, by_status: byStatus };
-  }
-  if (options.tree === true) {
-    const { runList } = await import("./list-Y6AU5BJS.js");
-    const subtree = await runList(void 0, {
-      parent: located.id,
-      tree: true,
-      treeDepth: treeDepth === void 0 ? void 0 : String(treeDepth),
-      full: true
-    }, global2);
-    result.tree = {
-      root_id: located.id,
-      root_title: loaded.document.metadata.title,
-      depth_limit: treeDepth ?? null,
-      count: subtree.count,
-      items: subtree.items.map((entry) => toItemRecord(entry))
-    };
-  }
+  result.children = await buildGetChildrenRollup(context, includeChildren);
+  result.tree = await buildGetTree(context, options, projection.treeDepth, global2);
   return result;
 }
 export {
   runGet
 };
-//# sourceMappingURL=get-AWK324RS.js.map
+//# sourceMappingURL=get-IOVAN6RU.js.map

package/dist/cli-bundle/chunks/get-IOVAN6RU.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/get.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/get\n *\n * Implements the pm get command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { buildItemNotFoundError, listAllFrontMatterLight, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport type { ItemFrontMatter, LinkedDoc, LinkedFile, LinkedTest } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { runList } from \"./list.js\";\n\ninterface ClaimHistoryContext {\n  ts: string;\n  author: string;\n  message: string | null;\n}\n\ninterface ClaimHistoryEntry {\n  op: string;\n  ts: string;\n  author: string;\n  message?: string;\n}\n\ninterface ClaimStateContext {\n  claimed: boolean;\n  assignee: string | null;\n  last_claim: ClaimHistoryContext | null;\n  last_release: ClaimHistoryContext | null;\n}\n\ninterface ChildRollupContext {\n  count: number;\n  active: number;\n  by_status: Record<string, number>;\n}\n\n// GH-155 (pm-gcm3): only container types get the inline child rollup so leaf\n// item reads keep avoiding the corpus scan that the rollup requires.\nconst CHILD_ROLLUP_TYPES = new Set([\"milestone\", \"epic\"]);\n\n/**\n * Documents the get result payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetResult {\n  // `body` lives inside `item` (alongside `description`/`acceptance_criteria`)\n  // for parity with `pm list --include-body`, so agents reliably find it at\n  // `.item.body` in JSON output instead of a top-level sibling.\n  item: Partial<ItemFrontMatter> & { body?: string };\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n  children?: ChildRollupContext;\n  tree?: {\n    root_id: string;\n    root_title: string | null;\n    depth_limit: number | null;\n    count: number;\n    items: Record<string, unknown>[];\n  };\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\n/**\n * Documents the get options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\n  tree?: boolean;\n  treeDepth?: string;\n}\n\nfunction toClaimHistoryContext(\n  entry: ClaimHistoryEntry,\n): ClaimHistoryContext {\n  return {\n    ts: entry.ts,\n    author: entry.author,\n    message: entry.message ?? null,\n  };\n}\n\nfunction resolveClaimStateContext(\n  assigneeValue: string | undefined,\n  history: ClaimHistoryEntry[],\n): ClaimStateContext {\n  const assignee = assigneeValue?.trim();\n  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;\n  const lastClaim = [...history].reverse().find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history].reverse().find((entry) => entry.op === \"release\");\n  return {\n    claimed: normalizedAssignee !== null,\n    assignee: normalizedAssignee,\n    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,\n    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,\n  };\n}\n\nfunction parseGetDepth(raw: string | undefined): GetDepth {\n  if (raw === undefined || raw.trim().length === 0) {\n    return \"standard\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized === \"full\") {\n    return \"deep\";\n  }\n  if (GET_DEPTH_VALUES.includes(normalized as GetDepth)) {\n    return normalized as GetDepth;\n  }\n  throw new PmCliError(\"Get --depth must be one of brief|standard|deep|full\", EXIT_CODE.USAGE);\n}\n\nfunction projectItemForDepth(item: ItemFrontMatter, depth: GetDepth): Partial<ItemFrontMatter> {\n  if (depth === \"deep\") {\n    return item;\n  }\n  const {\n    comments: _comments,\n    notes: _notes,\n    learnings: _learnings,\n    files: _files,\n    tests: _tests,\n    docs: _docs,\n    reminders: _reminders,\n    events: _events,\n    ...projected\n  } = item;\n  return projected;\n}\n\nfunction parseGetFields(raw: string | undefined): string[] | null {\n  if (raw === undefined) {\n    return null;\n  }\n  const fields = raw\n    .split(\",\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Get --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  return fields;\n}\n\nfunction normalizeGetField(field: string): string {\n  return field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n}\n\nfunction validateGetFields(fields: string[] | null, runtimeMetadataKeys: Iterable<string>): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([...FRONT_MATTER_KEY_ORDER, ...runtimeMetadataKeys]);\n  const allowedRootFields = new Set([\"body\", \"linked\", \"claim_state\", \"children\"]);\n  const allowedLinkedFields = new Set([\"linked.files\", \"linked.tests\", \"linked.docs\"]);\n  const allowedClaimStateFields = new Set([\"claim_state.claimed\", \"claim_state.assignee\", \"claim_state.last_claim\", \"claim_state.last_release\"]);\n  const unknown = fields.filter((field) => {\n    const normalized = normalizeGetField(field);\n    return (\n      !itemFields.has(normalized) &&\n      !allowedRootFields.has(normalized) &&\n      !allowedLinkedFields.has(normalized) &&\n      !allowedClaimStateFields.has(normalized)\n    );\n  });\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      code: \"unknown_field_projection\",\n      examples: [\n        \"pm get <id> --fields id,title,status,type,updated_at\",\n        \"pm get <id> --fields id,title,claim_state\",\n        \"pm get <id> --fields id,title,body,linked.files\",\n      ],\n    });\n  }\n}\n\nfunction projectItemForFields(item: ItemFrontMatter, fields: string[]): Partial<ItemFrontMatter> {\n  const source = toItemRecord(item);\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n    if (normalized === \"body\" || normalized === \"linked\" || normalized.startsWith(\"linked.\")) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemFrontMatter>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return fields?.some((field) => field === name || field === `item.${name}`) ?? false;\n}\n\nfunction fieldsIncludeRoot(fields: string[], name: string): boolean {\n  return fields.some((field) => field === name || field.startsWith(`${name}.`));\n}\n\ninterface ResolvedGetProjection {\n  depth: GetDepth;\n  treeDepth: number | undefined;\n  fields: string[] | null;\n  fieldProjection: boolean;\n}\n\ninterface GetItemContext {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  locatedId: string;\n  metadata: ItemFrontMatter;\n  body: string;\n}\n\nfunction resolveGetProjection(options: GetOptions): ResolvedGetProjection {\n  if (options.full && (options.fields !== undefined || options.depth !== undefined)) {\n    throw new PmCliError(\"Get projection options are mutually exclusive; remove the extra projection flag and retry.\", EXIT_CODE.USAGE);\n  }\n  if (options.tree !== true && options.treeDepth !== undefined) {\n    throw new PmCliError(\"Get --tree-depth requires --tree\", EXIT_CODE.USAGE);\n  }\n  return {\n    depth: options.full ? \"deep\" : parseGetDepth(options.depth),\n    treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, \"--tree-depth\") : undefined,\n    fields: parseGetFields(options.fields),\n    fieldProjection: options.fields !== undefined,\n  };\n}\n\nasync function loadGetItemContext(id: string, global: GlobalOptions): Promise<GetItemContext> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  return {\n    pmRoot,\n    settings,\n    typeToFolder: typeRegistry.type_to_folder,\n    locatedId: located.id,\n    metadata: loaded.document.metadata,\n    body: loaded.document.body,\n  };\n}\n\nfunction validateGetProjectionFields(fields: string[] | null, settings: Awaited<ReturnType<typeof readSettings>>): void {\n  const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);\n  validateGetFields(fields, runtimeMetadataKeys);\n}\n\nfunction shouldIncludeGetField(params: {\n  fieldProjection: boolean;\n  depth: GetDepth;\n  fields: string[] | null;\n  field: \"body\" | \"linked\" | \"claim_state\" | \"children\";\n  itemType?: string;\n}): boolean {\n  const { fieldProjection, depth, fields, field, itemType } = params;\n  if (fieldProjection) {\n    if (field === \"body\" || field === \"linked\") {\n      return fieldsInclude(fields, field);\n    }\n    return fieldsIncludeRoot(fields as string[], field);\n  }\n  if (field === \"children\") {\n    return depth !== \"brief\" && CHILD_ROLLUP_TYPES.has(itemType as string);\n  }\n  return depth !== \"brief\";\n}\n\nasync function resolveGetClaimState(context: GetItemContext, includeClaimState: boolean): Promise<ClaimStateContext | undefined> {\n  if (!includeClaimState) {\n    return undefined;\n  }\n  const historyPath = getHistoryPath(context.pmRoot, context.locatedId);\n  const history = await readHistoryEntries(historyPath, context.locatedId);\n  return resolveClaimStateContext(context.metadata.assignee, history);\n}\n\nfunction attachGetLinked(\n  result: GetResult,\n  context: GetItemContext,\n  fields: string[] | null,\n  includeLinked: boolean,\n): void {\n  const includeLinkedFiles = includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests = includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs = includeLinked || fieldsInclude(fields, \"linked.docs\");\n  if (!includeLinked && !includeLinkedFiles && !includeLinkedTests && !includeLinkedDocs) {\n    return;\n  }\n  result.linked = {\n    files: includeLinkedFiles ? context.metadata.files ?? [] : [],\n    tests: includeLinkedTests ? context.metadata.tests ?? [] : [],\n    docs: includeLinkedDocs ? context.metadata.docs ?? [] : [],\n  };\n}\n\nasync function buildGetChildrenRollup(context: GetItemContext, includeChildren: boolean): Promise<ChildRollupContext | undefined> {\n  if (!includeChildren) {\n    return undefined;\n  }\n  const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);\n  const corpus = await listAllFrontMatterLight(\n    context.pmRoot,\n    context.settings.item_format,\n    context.typeToFolder,\n    undefined,\n    context.settings.schema,\n  );\n  const byStatus: Record<string, number> = {};\n  let active = 0;\n  let count = 0;\n  const locatedId = context.locatedId.trim().toLowerCase();\n  for (const candidate of corpus) {\n    const parentId = typeof candidate.parent === \"string\" ? candidate.parent.trim().toLowerCase() : \"\";\n    if (parentId !== locatedId) continue;\n    const candidateStatus = candidate.status.trim().toLowerCase();\n    count += 1;\n    byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;\n    if (!isTerminalStatus(candidateStatus, statusRegistry)) {\n      active += 1;\n    }\n  }\n  return { count, active, by_status: byStatus };\n}\n\nasync function buildGetTree(\n  context: GetItemContext,\n  options: GetOptions,\n  treeDepth: number | undefined,\n  global: GlobalOptions,\n): Promise<GetResult[\"tree\"] | undefined> {\n  if (options.tree !== true) {\n    return undefined;\n  }\n  const subtree = await runList(\n    undefined,\n    {\n      parent: context.locatedId,\n      tree: true,\n      treeDepth: treeDepth === undefined ? undefined : String(treeDepth),\n      full: true,\n    },\n    global,\n  );\n  return {\n    root_id: context.locatedId,\n    root_title: context.metadata.title,\n    depth_limit: treeDepth ?? null,\n    count: subtree.count,\n    items: subtree.items.map((entry) => toItemRecord(entry)),\n  };\n}\n\n/**\n * Implements run get for the public runtime surface of this module.\n */\nexport async function runGet(id: string, global: GlobalOptions, options: GetOptions = {}): Promise<GetResult> {\n  const projection = resolveGetProjection(options);\n  const context = await loadGetItemContext(id, global);\n  validateGetProjectionFields(projection.fields, context.settings);\n  const includeBody = shouldIncludeGetField({ ...projection, field: \"body\" });\n  const includeLinked = shouldIncludeGetField({ ...projection, field: \"linked\" });\n  const includeClaimState = shouldIncludeGetField({ ...projection, field: \"claim_state\" });\n  const itemType = context.metadata.type.trim().toLowerCase();\n  const includeChildren = shouldIncludeGetField({ ...projection, field: \"children\", itemType });\n  const claimState = await resolveGetClaimState(context, includeClaimState);\n  const result: GetResult = {\n    item: projection.fieldProjection\n      ? projectItemForFields(context.metadata, projection.fields as string[])\n      : projectItemForDepth(context.metadata, projection.depth),\n  };\n  if (includeBody) {\n    result.item.body = context.body;\n  }\n  attachGetLinked(result, context, projection.fields, includeLinked);\n  if (claimState) {\n    result.claim_state = claimState;\n  }\n  result.children = await buildGetChildrenRollup(context, includeChildren);\n  result.tree = await buildGetTree(context, options, projection.treeDepth, global);\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}