@unbrained/pm-cli 2026.6.30 → 2026.7.2

package/dist/cli/commands/get.js

@@ -4,7 +4,7 @@
  * Implements the pm get command surface and its agent-facing runtime behavior.
  */
 
-!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")}catch(e){}}();
+!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]="ed20649d-dbe4-5e6b-9e36-2ff9e8eb0260")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { toItemRecord } from "../../core/item/item-record.js";
@@ -18,6 +18,7 @@ import { getHistoryPath, getSettingsPath, resolvePmRoot } from "../../core/store
 import { readSettings } from "../../core/store/settings.js";
 import { parseIntegerLimit } from "../shared-parsers.js";
 import { readHistoryEntries } from "./history.js";
+import { runList } from "./list.js";
 // GH-155 (pm-gcm3): only container types get the inline child rollup so leaf
 // item reads keep avoiding the corpus scan that the rollup requires.
 const CHILD_ROLLUP_TYPES = new Set(["milestone", "epic"]);
@@ -121,19 +122,21 @@ function fieldsInclude(fields, name) {
 function fieldsIncludeRoot(fields, name) {
     return fields.some((field) => field === name || field.startsWith(`${name}.`));
 }
-/**
- * Implements run get for the public runtime surface of this module.
- */
-export async function runGet(id, global, options = {}) {
+function resolveGetProjection(options) {
     if (options.full && (options.fields !== undefined || options.depth !== undefined)) {
         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 !== undefined) {
         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") : undefined;
-    const fields = parseGetFields(options.fields);
+    return {
+        depth: options.full ? "deep" : parseGetDepth(options.depth),
+        treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : undefined,
+        fields: parseGetFields(options.fields),
+        fieldProjection: options.fields !== undefined,
+    };
+}
+async function loadGetItemContext(id, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     if (!(await pathExists(getSettingsPath(pmRoot)))) {
         throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -145,92 +148,122 @@ export async function runGet(id, global, 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 undefined;
+    }
+    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 undefined;
+    }
+    const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);
+    const corpus = await listAllFrontMatterLight(context.pmRoot, context.settings.item_format, context.typeToFolder, undefined, 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, global) {
+    if (options.tree !== true) {
+        return undefined;
+    }
+    const subtree = await runList(undefined, {
+        parent: context.locatedId,
+        tree: true,
+        treeDepth: treeDepth === undefined ? undefined : String(treeDepth),
+        full: true,
+    }, global);
+    return {
+        root_id: context.locatedId,
+        root_title: context.metadata.title,
+        depth_limit: treeDepth ?? null,
+        count: subtree.count,
+        items: subtree.items.map((entry) => toItemRecord(entry)),
+    };
+}
+/**
+ * Implements run get for the public runtime surface of this module.
+ */
+export async function runGet(id, global, options = {}) {
+    const projection = resolveGetProjection(options);
+    const context = await loadGetItemContext(id, global);
+    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, undefined, 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.js");
-        const subtree = await runList(undefined, {
-            parent: located.id,
-            tree: true,
-            treeDepth: treeDepth === undefined ? undefined : String(treeDepth),
-            full: true,
-        }, global);
-        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, global);
     return result;
 }
 //# sourceMappingURL=get.js.map
-//# debugId=31e24598-6203-517a-945d-f07fbc69689e
+//# debugId=ed20649d-dbe4-5e6b-9e36-2ff9e8eb0260

package/dist/cli/commands/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sources":["cli/commands/get.ts"],"sourceRoot":"/","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\";\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\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  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  const depth = options.full ? \"deep\" : parseGetDepth(options.depth);\n  const treeDepth = options.tree === true ? parseIntegerLimit(options.treeDepth, \"--tree-depth\") : undefined;\n  const fields = parseGetFields(options.fields);\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  const runtimeMetadataKeys: string[] = [];\n  for (const field of resolveRuntimeFieldRegistry(settings.schema).definitions) {\n    runtimeMetadataKeys.push(field.metadata_key);\n  }\n  validateGetFields(fields, runtimeMetadataKeys);\n  const files = loaded.document.metadata.files ?? [];\n  const tests = loaded.document.metadata.tests ?? [];\n  const docs = loaded.document.metadata.docs ?? [];\n  const fieldProjection = fields !== null;\n  const includeBody = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"body\");\n  const includeLinked = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"linked\");\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  const includeClaimState = !fieldProjection ? depth !== \"brief\" : fieldsIncludeRoot(fields, \"claim_state\");\n  let claimState: ClaimStateContext | undefined;\n  if (includeClaimState) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    let history: ClaimHistoryEntry[] = [];\n    try {\n      history = await readHistoryEntries(historyPath, located.id);\n    } catch {\n      history = [];\n    }\n    claimState = resolveClaimStateContext(loaded.document.metadata.assignee, history);\n  }\n  const result: GetResult = {\n    item: fieldProjection\n      ? projectItemForFields(loaded.document.metadata, fields)\n      : projectItemForDepth(loaded.document.metadata, depth),\n  };\n  if (includeBody) {\n    result.item.body = loaded.document.body;\n  }\n  if (includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {\n    result.linked = {\n      files: includeLinkedFiles ? files : [],\n      tests: includeLinkedTests ? tests : [],\n      docs: includeLinkedDocs ? docs : [],\n    };\n  }\n  if (claimState) {\n    result.claim_state = claimState;\n  }\n  const itemType = loaded.document.metadata.type.trim().toLowerCase();\n  const includeChildren = fieldProjection\n    ? fieldsIncludeRoot(fields, \"children\")\n    : depth !== \"brief\" && CHILD_ROLLUP_TYPES.has(itemType);\n  if (includeChildren) {\n    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n    const corpus = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n    const byStatus: Record<string, number> = {};\n    let active = 0;\n    let count = 0;\n    const locatedId = located.id.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    result.children = { count, active, by_status: byStatus };\n  }\n  if (options.tree === true) {\n    const { runList } = await import(\"./list.js\");\n    const subtree = await runList(\n      undefined,\n      {\n        parent: located.id,\n        tree: true,\n        treeDepth: treeDepth === undefined ? undefined : String(treeDepth),\n        full: true,\n      },\n      global,\n    );\n    result.tree = {\n      root_id: located.id,\n      root_title: loaded.document.metadata.title,\n      depth_limit: treeDepth ?? null,\n      count: subtree.count,\n      items: subtree.items.map((entry) => toItemRecord(entry)),\n    };\n  }\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"31e24598-6203-517a-945d-f07fbc69689e"}
+{"version":3,"file":"get.js","sources":["cli/commands/get.ts"],"sourceRoot":"/","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":"ed20649d-dbe4-5e6b-9e36-2ff9e8eb0260"}

package/dist/cli/commands/health.d.ts

@@ -1,4 +1,9 @@
+import { resolveEmbeddingProviders } from "../../core/search/providers.js";
+import { resolveSettingsWithSemanticRuntimeDefaults } from "../../core/search/semantic-defaults.js";
+import { buildVectorizationEmbeddingIdentity } from "../../core/search/vectorization-metadata.js";
+import { resolveVectorStores } from "../../core/search/vector-stores.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { PmSettings } from "../../types/index.js";
 import { buildCapabilityContractMetadata, collectUnknownCapabilityGuidance } from "./extension/doctor.js";
 type HealthStatus = "ok" | "warn";
 type MigrationRuntimeStatus = "pending" | "failed" | "applied";
@@ -117,6 +122,16 @@ declare function selectStaleItemDetail(values: string[], verboseStaleItems: bool
     truncated: boolean;
     total: number;
 };
+type VectorizationRuntimeDefaults = ReturnType<typeof resolveSettingsWithSemanticRuntimeDefaults>;
+type VectorizationProviderResolution = ReturnType<typeof resolveEmbeddingProviders>;
+type VectorizationStoreResolution = ReturnType<typeof resolveVectorStores>;
+interface VectorizationRuntimeSnapshot {
+    runtimeDefaults: VectorizationRuntimeDefaults;
+    providerResolution: VectorizationProviderResolution;
+    vectorStoreResolution: VectorizationStoreResolution;
+    runtimeEmbeddingIdentity: ReturnType<typeof buildVectorizationEmbeddingIdentity> | null;
+    semanticRuntimeAvailable: boolean;
+}
 declare function telemetryEnvFlagEnabled(envKey: "PM_TELEMETRY_DISABLED" | "PM_TELEMETRY_OTEL_DISABLED" | "PM_NO_TELEMETRY" | "PM_TELEMETRY_INLINE_FLUSH"): boolean;
 declare function normalizeEndpointForDisplay(rawEndpoint: string): string;
 declare function parseTelemetryQueue(raw: string): {
@@ -133,6 +148,7 @@ declare function probeTelemetryEndpointHealth(endpoint: string): Promise<{
     max_schema_version?: string;
     error?: string;
 }>;
+declare function buildVectorizationProviderDetails(settings: PmSettings, snapshot: VectorizationRuntimeSnapshot): Record<string, unknown>;
 /**
  * Implements run health for the public runtime surface of this module.
  */
@@ -140,6 +156,7 @@ export declare function runHealth(global: GlobalOptions, options?: RunHealthOpti
 export declare const _testOnlyHealthCommand: {
     buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary;
     buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata;
+    buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails;
     collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance;
     isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning;
     isDirectory: typeof isDirectory;