@unbrained/pm-cli 2026.7.13 → 2026.7.14

package/dist/cli/commands/files.js

@@ -1,300 +1,10 @@
 /**
  * @module cli/commands/files
  *
- * Implements the pm files command surface and its agent-facing runtime behavior.
+ * Re-exports the public SDK file-link primitive for CLI presentation wiring.
  */
 
-!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]="3a8f4027-c8bd-5e07-ba5f-edcf43224e09")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { pathExists } from "../../core/fs/fs-utils.js";
-import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
-import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { locateItem, mutateItem, readLocatedItem, } from "../../core/store/item-store.js";
-import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-import { resolveAuthor } from "../../core/shared/author.js";
-import { isPathWithinDirectory } from "../../core/fs/path-utils.js";
-import { dedupeLinkedArtifacts, normalizeLinkedPath, renameArtifactsResultKey, runLinkedArtifacts, sortLinkedArtifacts, } from "./linked-artifacts.js";
-function normalizeCandidatePathForOutput(value) {
-    return normalizeLinkedPath(path.normalize(value));
-}
-async function realpathForContainment(inputPath) {
-    try {
-        return await fs.realpath(inputPath);
-    }
-    catch {
-        return path.resolve(inputPath);
-    }
-}
-function linkedFileResolvedKey(linkedFile, projectRoot) {
-    const resolvedPath = path.isAbsolute(linkedFile.path)
-        ? path.resolve(linkedFile.path)
-        : path.resolve(projectRoot, linkedFile.path);
-    return `${normalizeCandidatePathForOutput(resolvedPath)}::${linkedFile.scope}`;
-}
-function collectTextReferences(value, fieldPath, references) {
-    if (typeof value === "string") {
-        const trimmed = value.trim();
-        if (trimmed.length > 0) {
-            references.push({ field: fieldPath, value: trimmed });
-        }
-        return;
-    }
-    if (Array.isArray(value)) {
-        value.forEach((entry, index) => collectTextReferences(entry, `${fieldPath}[${index}]`, references));
-        return;
-    }
-    if (typeof value === "object" && value !== null) {
-        for (const [key, nested] of Object.entries(value)) {
-            /* c8 ignore next -- root-level object traversal always carries a non-empty field path in current callers. */
-            collectTextReferences(nested, fieldPath ? `${fieldPath}.${key}` : key, references);
-        }
-    }
-}
-function collectItemTextReferences(document) {
-    const references = [];
-    collectTextReferences(document.metadata, "metadata", references);
-    collectTextReferences(document.body, "body", references);
-    return references;
-}
-function cleanupPathToken(value) {
-    let next = value.trim();
-    next = next.replace(/^[`"'<([{]+/u, "");
-    next = next.replace(/[`"'>)\]},;!?]+$/u, "");
-    next = next.replace(/[.]+$/u, "");
-    next = next.replace(/:(?:\d+)(?::\d+)?$/u, "");
-    next = next.replace(/[.]+$/u, "");
-    return next;
-}
-function extractRawPathReferences(references) {
-    const rawReferences = [];
-    const absolutePattern = /(?:[A-Za-z]:[\\/]|\/)[^\s"'`<>()[\]{},;]+/gu;
-    const relativePattern = /(?:\.{1,2}[\\/])?(?:(?:[A-Za-z0-9_.@-]+[\\/])+[A-Za-z0-9_.@-]+|[A-Za-z0-9_.@-]+\.[A-Za-z0-9][A-Za-z0-9._-]*)/gu;
-    for (const reference of references) {
-        const seenInField = new Set();
-        for (const pattern of [absolutePattern, relativePattern]) {
-            pattern.lastIndex = 0;
-            for (const match of reference.value.matchAll(pattern)) {
-                /* c8 ignore next -- RegExp match arrays always expose capture [0]. */
-                const token = cleanupPathToken(match[0] ?? "");
-                if (!token || seenInField.has(token)) {
-                    continue;
-                }
-                seenInField.add(token);
-                rawReferences.push({ field: reference.field, value: token });
-            }
-        }
-    }
-    return rawReferences;
-}
-async function resolveDiscoveredFile(rawPath, projectRoot) {
-    const absolutePath = path.isAbsolute(rawPath)
-        ? path.resolve(rawPath)
-        : path.resolve(projectRoot, rawPath);
-    let stats;
-    try {
-        stats = await fs.stat(absolutePath);
-    }
-    catch {
-        return undefined;
-    }
-    if (!stats.isFile()) {
-        return undefined;
-    }
-    const [canonicalProjectRoot, canonicalAbsolutePath] = await Promise.all([
-        realpathForContainment(projectRoot),
-        realpathForContainment(absolutePath),
-    ]);
-    if (isPathWithinDirectory(canonicalProjectRoot, canonicalAbsolutePath)) {
-        const relativePath = path.relative(canonicalProjectRoot, canonicalAbsolutePath);
-        if (!relativePath ||
-            relativePath.startsWith("..") ||
-            path.isAbsolute(relativePath)) {
-            return undefined;
-        }
-        return {
-            path: normalizeCandidatePathForOutput(relativePath),
-            scope: "project",
-        };
-    }
-    return {
-        path: normalizeCandidatePathForOutput(absolutePath),
-        scope: "global",
-    };
-}
-async function discoverReferencedFiles(document, projectRoot) {
-    const existingResolvedKeys = new Set((document.metadata.files ?? []).map((entry) => linkedFileResolvedKey(entry, projectRoot)));
-    const grouped = new Map();
-    const rawReferences = extractRawPathReferences(collectItemTextReferences(document));
-    for (const reference of rawReferences) {
-        const resolved = await resolveDiscoveredFile(reference.value, projectRoot);
-        if (!resolved) {
-            continue;
-        }
-        const key = linkedFileResolvedKey(resolved, projectRoot);
-        const existing = grouped.get(key) ?? {
-            path: resolved.path,
-            scope: resolved.scope,
-            sourceFields: new Set(),
-            originalPaths: new Set(),
-            sourceCount: 0,
-        };
-        existing.sourceFields.add(reference.field);
-        existing.originalPaths.add(reference.value);
-        existing.sourceCount += 1;
-        grouped.set(key, existing);
-    }
-    return [...grouped.entries()]
-        .map(([key, entry]) => ({
-        path: entry.path,
-        scope: entry.scope,
-        status: existingResolvedKeys.has(key)
-            ? "already_linked"
-            : "addable",
-        source_count: entry.sourceCount,
-        source_fields: [...entry.sourceFields].sort((left, right) => left.localeCompare(right)),
-        original_paths: [...entry.originalPaths].sort((left, right) => left.localeCompare(right)),
-    }))
-        .sort((left, right) => {
-        const byStatus = left.status.localeCompare(right.status);
-        if (byStatus !== 0)
-            return byStatus;
-        const byPath = left.path.localeCompare(right.path);
-        if (byPath !== 0)
-            return byPath;
-        /* c8 ignore next -- path+status collisions are uncommon in deterministic fixtures. */
-        return left.scope.localeCompare(right.scope);
-    });
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    normalizeCandidatePathForOutput,
-    realpathForContainment,
-    linkedFileResolvedKey,
-    collectTextReferences,
-    collectItemTextReferences,
-    cleanupPathToken,
-    extractRawPathReferences,
-    resolveDiscoveredFile,
-    discoverReferencedFiles,
-};
-/** Implements run files for the public runtime surface of this module. */
-export async function runFiles(id, options, global) {
-    const result = await runLinkedArtifacts(id, options, global, {
-        metadataKey: "files",
-        op: "files_add",
-        bareNoun: "file",
-        supportsAppendStable: true,
-    });
-    return renameArtifactsResultKey(result, "files");
-}
-/** Implements run files discover for the public runtime surface of this module. */
-export async function runFilesDiscover(id, options, 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);
-    }
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
-    /* c8 ignore next -- not-found behavior is validated by CLI integration coverage. */
-    if (!located) {
-        throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
-    }
-    const loaded = await readLocatedItem(located, { schema: settings.schema });
-    const candidates = await discoverReferencedFiles(loaded.document, process.cwd());
-    const addableCandidates = candidates.filter((candidate) => candidate.status === "addable");
-    const skippedExisting = candidates.filter((candidate) => candidate.status === "already_linked");
-    const requestedApply = options.apply === true;
-    const note = options.note?.trim() || "discovered from item text";
-    if (!requestedApply || addableCandidates.length === 0) {
-        const files = loaded.document.metadata.files ?? [];
-        return {
-            id: located.id,
-            files,
-            changed: false,
-            apply: requestedApply,
-            count: files.length,
-            candidate_count: candidates.length,
-            addable_count: addableCandidates.length,
-            added_count: 0,
-            skipped_existing_count: skippedExisting.length,
-            candidates,
-            added: [],
-            skipped_existing: skippedExisting,
-        };
-    }
-    const author = resolveAuthor(options.author, settings.author_default);
-    const discoveredAdds = addableCandidates.map((candidate) => ({
-        path: candidate.path,
-        scope: candidate.scope,
-        note,
-    }));
-    const result = await mutateItem({
-        pmRoot,
-        settings,
-        id,
-        op: "files_discover",
-        author,
-        message: options.message ?? "Discover referenced file links",
-        force: options.force,
-        mutate(document) {
-            const next = [...(document.metadata.files ?? [])];
-            const existingResolvedKeys = new Set(next.map((entry) => linkedFileResolvedKey(entry, process.cwd())));
-            const appliedAdds = [];
-            for (const add of discoveredAdds) {
-                const resolvedKey = linkedFileResolvedKey(add, process.cwd());
-                /* c8 ignore next -- duplicate-key race paths are exercised in broader CLI race tests. */
-                if (existingResolvedKeys.has(resolvedKey)) {
-                    continue;
-                }
-                next.push(add);
-                existingResolvedKeys.add(resolvedKey);
-                appliedAdds.push(add);
-            }
-            const deduped = dedupeLinkedArtifacts(next);
-            /* c8 ignore next -- appendStable branch is covered through runFiles command contract tests. */
-            const normalized = options.appendStable
-                ? deduped
-                : sortLinkedArtifacts(deduped);
-            if (normalized.length > 0) {
-                document.metadata.files = normalized;
-            }
-            else {
-                delete document.metadata.files;
-            }
-            return {
-                /* c8 ignore next -- no-op mutation responses may emit empty changedFields for skipped discover batches. */
-                changedFields: appliedAdds.length > 0 ? ["files"] : [],
-                /* c8 ignore next -- warning emission is exercised by race-aware integration tests. */
-                warnings: appliedAdds.length !== discoveredAdds.length
-                    ? [
-                        `files_discover_skipped_existing:${discoveredAdds.length - appliedAdds.length}`,
-                    ]
-                    : [],
-            };
-        },
-    });
-    const files = result.item.files ?? [];
-    const addedResolvedKeys = new Set(discoveredAdds.map((entry) => linkedFileResolvedKey(entry, process.cwd())));
-    const added = files.filter((entry) => addedResolvedKeys.has(linkedFileResolvedKey(entry, process.cwd())));
-    return {
-        id: result.item.id,
-        files,
-        changed: added.length > 0,
-        apply: true,
-        count: files.length,
-        candidate_count: candidates.length,
-        addable_count: addableCandidates.length,
-        added_count: added.length,
-        skipped_existing_count: skippedExisting.length,
-        candidates,
-        added,
-        skipped_existing: skippedExisting,
-    };
-}
+!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]="358bc01c-a706-559c-8c34-214a1610d8b5")}catch(e){}}();
+export * from "../../sdk/files.js";
 //# sourceMappingURL=files.js.map
-//# debugId=3a8f4027-c8bd-5e07-ba5f-edcf43224e09
+//# debugId=358bc01c-a706-559c-8c34-214a1610d8b5

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

@@ -1 +1 @@
-{"version":3,"file":"files.js","sources":["cli/commands/files.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/files\n *\n * Implements the pm files command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { isPathWithinDirectory } from \"../../core/fs/path-utils.js\";\nimport type { ItemDocument, LinkedFile, LinkScope } from \"../../types/index.js\";\nimport {\n  dedupeLinkedArtifacts,\n  normalizeLinkedPath,\n  renameArtifactsResultKey,\n  runLinkedArtifacts,\n  sortLinkedArtifacts,\n  type LinkedArtifactResult,\n  type LinkedPathValidation,\n} from \"./linked-artifacts.js\";\n\n/** Documents the files command options payload exchanged by command, SDK, and package integrations. */\nexport interface FilesCommandOptions {\n  /** Value that configures or reports add for this contract. */\n  add?: string[];\n  /** Value that configures or reports add glob for this contract. */\n  addGlob?: string[];\n  /** Value that configures or reports remove for this contract. */\n  remove?: string[];\n  /** Value that configures or reports migrate for this contract. */\n  migrate?: string[];\n  /** GH-170 (pm-pfnx): standalone note applied to every --add/--add-glob link in this invocation. */\n  note?: string;\n  /** Value that configures or reports list for this contract. */\n  list?: boolean;\n  /** Value that configures or reports append stable for this contract. */\n  appendStable?: boolean;\n  /** Value that configures or reports validate paths for this contract. */\n  validatePaths?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the files discover options payload exchanged by command, SDK, and package integrations. */\nexport interface FilesDiscoverOptions {\n  /** Value that configures or reports apply for this contract. */\n  apply?: boolean;\n  /** Value that configures or reports append stable for this contract. */\n  appendStable?: boolean;\n  /** Value that configures or reports note for this contract. */\n  note?: string;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the files discovery candidate payload exchanged by command, SDK, and package integrations. */\nexport interface FilesDiscoveryCandidate {\n  /** Filesystem path used for path resolution. */\n  path: string;\n  /** Value that configures or reports scope for this contract. */\n  scope: LinkScope;\n  /** Lifecycle state reported for status. */\n  status: \"addable\" | \"already_linked\";\n  /** Number of source entries represented by this result. */\n  source_count: number;\n  /** Value that configures or reports source fields for this contract. */\n  source_fields: string[];\n  /** Value that configures or reports original paths for this contract. */\n  original_paths: string[];\n}\n\n/** Documents the files result payload exchanged by command, SDK, and package integrations. */\nexport interface FilesResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports files for this contract. */\n  files: LinkedFile[];\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Value that configures or reports migrations applied for this contract. */\n  migrations_applied?: number;\n  /** Value that configures or reports validation for this contract. */\n  validation?: LinkedPathValidation;\n}\n\n/** Documents the files discover result payload exchanged by command, SDK, and package integrations. */\nexport interface FilesDiscoverResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports files for this contract. */\n  files: LinkedFile[];\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports apply for this contract. */\n  apply: boolean;\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Number of candidate entries represented by this result. */\n  candidate_count: number;\n  /** Number of addable entries represented by this result. */\n  addable_count: number;\n  /** Number of added entries represented by this result. */\n  added_count: number;\n  /** Number of skipped existing entries represented by this result. */\n  skipped_existing_count: number;\n  /** Value that configures or reports candidates for this contract. */\n  candidates: FilesDiscoveryCandidate[];\n  /** Value that configures or reports added for this contract. */\n  added: LinkedFile[];\n  /** Value that configures or reports skipped existing for this contract. */\n  skipped_existing: FilesDiscoveryCandidate[];\n}\n\ninterface TextReference {\n  field: string;\n  value: string;\n}\n\ninterface RawPathReference {\n  field: string;\n  value: string;\n}\n\nfunction normalizeCandidatePathForOutput(value: string): string {\n  return normalizeLinkedPath(path.normalize(value));\n}\n\nasync function realpathForContainment(inputPath: string): Promise<string> {\n  try {\n    return await fs.realpath(inputPath);\n  } catch {\n    return path.resolve(inputPath);\n  }\n}\n\nfunction linkedFileResolvedKey(\n  linkedFile: Pick<LinkedFile, \"path\" | \"scope\">,\n  projectRoot: string,\n): string {\n  const resolvedPath = path.isAbsolute(linkedFile.path)\n    ? path.resolve(linkedFile.path)\n    : path.resolve(projectRoot, linkedFile.path);\n  return `${normalizeCandidatePathForOutput(resolvedPath)}::${linkedFile.scope}`;\n}\n\nfunction collectTextReferences(\n  value: unknown,\n  fieldPath: string,\n  references: TextReference[],\n): void {\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.length > 0) {\n      references.push({ field: fieldPath, value: trimmed });\n    }\n    return;\n  }\n  if (Array.isArray(value)) {\n    value.forEach((entry, index) =>\n      collectTextReferences(entry, `${fieldPath}[${index}]`, references),\n    );\n    return;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    for (const [key, nested] of Object.entries(value)) {\n      /* c8 ignore next -- root-level object traversal always carries a non-empty field path in current callers. */\n      collectTextReferences(\n        nested,\n        fieldPath ? `${fieldPath}.${key}` : key,\n        references,\n      );\n    }\n  }\n}\n\nfunction collectItemTextReferences(document: ItemDocument): TextReference[] {\n  const references: TextReference[] = [];\n  collectTextReferences(document.metadata, \"metadata\", references);\n  collectTextReferences(document.body, \"body\", references);\n  return references;\n}\n\nfunction cleanupPathToken(value: string): string {\n  let next = value.trim();\n  next = next.replace(/^[`\"'<([{]+/u, \"\");\n  next = next.replace(/[`\"'>)\\]},;!?]+$/u, \"\");\n  next = next.replace(/[.]+$/u, \"\");\n  next = next.replace(/:(?:\\d+)(?::\\d+)?$/u, \"\");\n  next = next.replace(/[.]+$/u, \"\");\n  return next;\n}\n\nfunction extractRawPathReferences(\n  references: TextReference[],\n): RawPathReference[] {\n  const rawReferences: RawPathReference[] = [];\n  const absolutePattern = /(?:[A-Za-z]:[\\\\/]|\\/)[^\\s\"'`<>()[\\]{},;]+/gu;\n  const relativePattern =\n    /(?:\\.{1,2}[\\\\/])?(?:(?:[A-Za-z0-9_.@-]+[\\\\/])+[A-Za-z0-9_.@-]+|[A-Za-z0-9_.@-]+\\.[A-Za-z0-9][A-Za-z0-9._-]*)/gu;\n  for (const reference of references) {\n    const seenInField = new Set<string>();\n    for (const pattern of [absolutePattern, relativePattern]) {\n      pattern.lastIndex = 0;\n      for (const match of reference.value.matchAll(pattern)) {\n        /* c8 ignore next -- RegExp match arrays always expose capture [0]. */\n        const token = cleanupPathToken(match[0] ?? \"\");\n        if (!token || seenInField.has(token)) {\n          continue;\n        }\n        seenInField.add(token);\n        rawReferences.push({ field: reference.field, value: token });\n      }\n    }\n  }\n  return rawReferences;\n}\n\nasync function resolveDiscoveredFile(\n  rawPath: string,\n  projectRoot: string,\n): Promise<Pick<LinkedFile, \"path\" | \"scope\"> | undefined> {\n  const absolutePath = path.isAbsolute(rawPath)\n    ? path.resolve(rawPath)\n    : path.resolve(projectRoot, rawPath);\n  let stats;\n  try {\n    stats = await fs.stat(absolutePath);\n  } catch {\n    return undefined;\n  }\n  if (!stats.isFile()) {\n    return undefined;\n  }\n  const [canonicalProjectRoot, canonicalAbsolutePath] = await Promise.all([\n    realpathForContainment(projectRoot),\n    realpathForContainment(absolutePath),\n  ]);\n  if (isPathWithinDirectory(canonicalProjectRoot, canonicalAbsolutePath)) {\n    const relativePath = path.relative(\n      canonicalProjectRoot,\n      canonicalAbsolutePath,\n    );\n    if (\n      !relativePath ||\n      relativePath.startsWith(\"..\") ||\n      path.isAbsolute(relativePath)\n    ) {\n      return undefined;\n    }\n    return {\n      path: normalizeCandidatePathForOutput(relativePath),\n      scope: \"project\",\n    };\n  }\n  return {\n    path: normalizeCandidatePathForOutput(absolutePath),\n    scope: \"global\",\n  };\n}\n\nasync function discoverReferencedFiles(\n  document: ItemDocument,\n  projectRoot: string,\n): Promise<FilesDiscoveryCandidate[]> {\n  const existingResolvedKeys = new Set(\n    (document.metadata.files ?? []).map((entry) =>\n      linkedFileResolvedKey(entry, projectRoot),\n    ),\n  );\n  const grouped = new Map<\n    string,\n    {\n      path: string;\n      scope: LinkScope;\n      sourceFields: Set<string>;\n      originalPaths: Set<string>;\n      sourceCount: number;\n    }\n  >();\n  const rawReferences = extractRawPathReferences(\n    collectItemTextReferences(document),\n  );\n  for (const reference of rawReferences) {\n    const resolved = await resolveDiscoveredFile(reference.value, projectRoot);\n    if (!resolved) {\n      continue;\n    }\n    const key = linkedFileResolvedKey(resolved, projectRoot);\n    const existing = grouped.get(key) ?? {\n      path: resolved.path,\n      scope: resolved.scope,\n      sourceFields: new Set<string>(),\n      originalPaths: new Set<string>(),\n      sourceCount: 0,\n    };\n    existing.sourceFields.add(reference.field);\n    existing.originalPaths.add(reference.value);\n    existing.sourceCount += 1;\n    grouped.set(key, existing);\n  }\n  return [...grouped.entries()]\n    .map(([key, entry]) => ({\n      path: entry.path,\n      scope: entry.scope,\n      status: existingResolvedKeys.has(key)\n        ? (\"already_linked\" as const)\n        : (\"addable\" as const),\n      source_count: entry.sourceCount,\n      source_fields: [...entry.sourceFields].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n      original_paths: [...entry.originalPaths].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    }))\n    .sort((left, right) => {\n      const byStatus = left.status.localeCompare(right.status);\n      if (byStatus !== 0) return byStatus;\n      const byPath = left.path.localeCompare(right.path);\n      if (byPath !== 0) return byPath;\n      /* c8 ignore next -- path+status collisions are uncommon in deterministic fixtures. */\n      return left.scope.localeCompare(right.scope);\n    });\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  normalizeCandidatePathForOutput,\n  realpathForContainment,\n  linkedFileResolvedKey,\n  collectTextReferences,\n  collectItemTextReferences,\n  cleanupPathToken,\n  extractRawPathReferences,\n  resolveDiscoveredFile,\n  discoverReferencedFiles,\n};\n\n/** Implements run files for the public runtime surface of this module. */\nexport async function runFiles(\n  id: string,\n  options: FilesCommandOptions,\n  global: GlobalOptions,\n): Promise<FilesResult> {\n  const result: LinkedArtifactResult = await runLinkedArtifacts(\n    id,\n    options,\n    global,\n    {\n      metadataKey: \"files\",\n      op: \"files_add\",\n      bareNoun: \"file\",\n      supportsAppendStable: true,\n    },\n  );\n  return renameArtifactsResultKey(result, \"files\") as unknown as FilesResult;\n}\n\n/** Implements run files discover for the public runtime surface of this module. */\nexport async function runFilesDiscover(\n  id: string,\n  options: FilesDiscoverOptions,\n  global: GlobalOptions,\n): Promise<FilesDiscoverResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const located = await locateItem(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  /* c8 ignore next -- not-found behavior is validated by CLI integration coverage. */\n  if (!located) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const candidates = await discoverReferencedFiles(\n    loaded.document,\n    process.cwd(),\n  );\n  const addableCandidates = candidates.filter(\n    (candidate) => candidate.status === \"addable\",\n  );\n  const skippedExisting = candidates.filter(\n    (candidate) => candidate.status === \"already_linked\",\n  );\n  const requestedApply = options.apply === true;\n  const note = options.note?.trim() || \"discovered from item text\";\n\n  if (!requestedApply || addableCandidates.length === 0) {\n    const files = loaded.document.metadata.files ?? [];\n    return {\n      id: located.id,\n      files,\n      changed: false,\n      apply: requestedApply,\n      count: files.length,\n      candidate_count: candidates.length,\n      addable_count: addableCandidates.length,\n      added_count: 0,\n      skipped_existing_count: skippedExisting.length,\n      candidates,\n      added: [],\n      skipped_existing: skippedExisting,\n    };\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const discoveredAdds: LinkedFile[] = addableCandidates.map((candidate) => ({\n    path: candidate.path,\n    scope: candidate.scope,\n    note,\n  }));\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"files_discover\",\n    author,\n    message: options.message ?? \"Discover referenced file links\",\n    force: options.force,\n    mutate(document) {\n      const next = [...(document.metadata.files ?? [])];\n      const existingResolvedKeys = new Set(\n        next.map((entry) => linkedFileResolvedKey(entry, process.cwd())),\n      );\n      const appliedAdds: LinkedFile[] = [];\n      for (const add of discoveredAdds) {\n        const resolvedKey = linkedFileResolvedKey(add, process.cwd());\n        /* c8 ignore next -- duplicate-key race paths are exercised in broader CLI race tests. */\n        if (existingResolvedKeys.has(resolvedKey)) {\n          continue;\n        }\n        next.push(add);\n        existingResolvedKeys.add(resolvedKey);\n        appliedAdds.push(add);\n      }\n      const deduped = dedupeLinkedArtifacts(next);\n      /* c8 ignore next -- appendStable branch is covered through runFiles command contract tests. */\n      const normalized = options.appendStable\n        ? deduped\n        : sortLinkedArtifacts(deduped);\n      if (normalized.length > 0) {\n        document.metadata.files = normalized;\n      } else {\n        delete document.metadata.files;\n      }\n      return {\n        /* c8 ignore next -- no-op mutation responses may emit empty changedFields for skipped discover batches. */\n        changedFields: appliedAdds.length > 0 ? [\"files\"] : [],\n        /* c8 ignore next -- warning emission is exercised by race-aware integration tests. */\n        warnings:\n          appliedAdds.length !== discoveredAdds.length\n            ? [\n                `files_discover_skipped_existing:${discoveredAdds.length - appliedAdds.length}`,\n              ]\n            : [],\n      };\n    },\n  });\n\n  const files = result.item.files ?? [];\n  const addedResolvedKeys = new Set(\n    discoveredAdds.map((entry) => linkedFileResolvedKey(entry, process.cwd())),\n  );\n  const added = files.filter((entry) =>\n    addedResolvedKeys.has(linkedFileResolvedKey(entry, process.cwd())),\n  );\n  return {\n    id: result.item.id,\n    files,\n    changed: added.length > 0,\n    apply: true,\n    count: files.length,\n    candidate_count: candidates.length,\n    addable_count: addableCandidates.length,\n    added_count: added.length,\n    skipped_existing_count: skippedExisting.length,\n    candidates,\n    added,\n    skipped_existing: skippedExisting,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3a8f4027-c8bd-5e07-ba5f-edcf43224e09"}
+{"version":3,"file":"files.js","sources":["cli/commands/files.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/files\n *\n * Re-exports the public SDK file-link primitive for CLI presentation wiring.\n */\nexport * from \"../../sdk/files.js\";\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,cAAc,oBAAoB,CAAC","debugId":"358bc01c-a706-559c-8c34-214a1610d8b5"}

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]="903d7aec-5680-585b-86ba-9e39a81810a8")}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]="233ec299-06cd-50e0-8ff5-bfbd40fe8bb2")}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";
@@ -16,6 +16,7 @@ import { PmCliError } from "../../core/shared/errors.js";
 import { buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, } from "../../core/store/item-store.js";
 import { getHistoryPath, getSettingsPath, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
+import { recordContextUsageTouches } from "../../sdk/context-usage.js";
 import { parseIntegerLimit } from "../shared-parsers.js";
 import { readHistoryEntries } from "./history.js";
 import { runList } from "./list.js";
@@ -304,7 +305,19 @@ export async function runGet(id, global, options = {}) {
     }
     result.children = await buildGetChildrenRollup(context, includeChildren);
     result.tree = await buildGetTree(context, options, projection.treeDepth, global);
+    try {
+        await recordContextUsageTouches({
+            pmRoot: context.pmRoot,
+            author: (process.env.PM_AUTHOR ?? context.settings.author_default).trim() ||
+                "unknown",
+            itemIds: [context.locatedId],
+            intent: "get",
+        });
+    }
+    catch {
+        // Derived usage feedback must never make the source-of-truth read fail.
+    }
     return result;
 }
 //# sourceMappingURL=get.js.map
-//# debugId=903d7aec-5680-585b-86ba-9e39a81810a8
+//# debugId=233ec299-06cd-50e0-8ff5-bfbd40fe8bb2

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 {\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport {\n  EXIT_CODE,\n  ITEM_METADATA_KEY_ORDER,\n} from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  buildItemNotFoundError,\n  listAllItemMetadataLight,\n  locateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport {\n  getHistoryPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport type {\n  ItemMetadata,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n} 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/** Documents the get result payload exchanged by command, SDK, and package integrations. */\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  /** Value that configures or reports item for this contract. */\n  item: Partial<ItemMetadata> & { body?: string };\n  /** Value that configures or reports linked for this contract. */\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  /** Value that configures or reports claim state for this contract. */\n  claim_state?: ClaimStateContext;\n  /** Value that configures or reports children for this contract. */\n  children?: ChildRollupContext;\n  /** Value that configures or reports tree for this contract. */\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/** Documents the get options payload exchanged by command, SDK, and package integrations. */\nexport interface GetOptions {\n  /** Value that configures or reports depth for this contract. */\n  depth?: string;\n  /** Value that configures or reports fields for this contract. */\n  fields?: string;\n  /** Value that configures or reports full for this contract. */\n  full?: boolean;\n  /** Value that configures or reports tree for this contract. */\n  tree?: boolean;\n  /** Value that configures or reports tree depth for this contract. */\n  treeDepth?: string;\n}\n\nfunction toClaimHistoryContext(entry: ClaimHistoryEntry): 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]\n    .reverse()\n    .find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history]\n    .reverse()\n    .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(\n    \"Get --depth must be one of brief|standard|deep|full\",\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction projectItemForDepth(\n  item: ItemMetadata,\n  depth: GetDepth,\n): Partial<ItemMetadata> {\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(\n      \"Get --fields requires a comma-separated list of field names\",\n      EXIT_CODE.USAGE,\n    );\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(\n  fields: string[] | null,\n  runtimeMetadataKeys: Iterable<string>,\n): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([\n    ...ITEM_METADATA_KEY_ORDER,\n    ...runtimeMetadataKeys,\n  ]);\n  const allowedRootFields = new Set([\n    \"body\",\n    \"linked\",\n    \"claim_state\",\n    \"children\",\n  ]);\n  const allowedLinkedFields = new Set([\n    \"linked.files\",\n    \"linked.tests\",\n    \"linked.docs\",\n  ]);\n  const allowedClaimStateFields = new Set([\n    \"claim_state.claimed\",\n    \"claim_state.assignee\",\n    \"claim_state.last_claim\",\n    \"claim_state.last_release\",\n  ]);\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(\n      `Unknown get --fields value(s): ${unknown.join(\", \")}`,\n      EXIT_CODE.USAGE,\n      {\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}\n\nfunction projectItemForFields(\n  item: ItemMetadata,\n  fields: string[],\n): Partial<ItemMetadata> {\n  const source = toItemRecord(item);\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\")\n      ? field.slice(\"item.\".length)\n      : field;\n    if (\n      normalized === \"body\" ||\n      normalized === \"linked\" ||\n      normalized.startsWith(\"linked.\")\n    ) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemMetadata>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return (\n    fields?.some((field) => field === name || field === `item.${name}`) ?? false\n  );\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: ItemMetadata;\n  body: string;\n}\n\nfunction resolveGetProjection(options: GetOptions): ResolvedGetProjection {\n  if (\n    options.full &&\n    (options.fields !== undefined || options.depth !== undefined)\n  ) {\n    throw new PmCliError(\n      \"Get projection options are mutually exclusive; remove the extra projection flag and retry.\",\n      EXIT_CODE.USAGE,\n    );\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:\n      options.tree === true\n        ? parseIntegerLimit(options.treeDepth, \"--tree-depth\")\n        : undefined,\n    fields: parseGetFields(options.fields),\n    fieldProjection: options.fields !== undefined,\n  };\n}\n\nasync function loadGetItemContext(\n  id: string,\n  global: GlobalOptions,\n): Promise<GetItemContext> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const located = await locateItem(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      typeRegistry.type_to_folder,\n    );\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(\n  fields: string[] | null,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): void {\n  const runtimeMetadataKeys = resolveRuntimeFieldRegistry(\n    settings.schema,\n  ).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(\n  context: GetItemContext,\n  includeClaimState: boolean,\n): 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 =\n    includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests =\n    includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs =\n    includeLinked || fieldsInclude(fields, \"linked.docs\");\n  if (\n    !includeLinked &&\n    !includeLinkedFiles &&\n    !includeLinkedTests &&\n    !includeLinkedDocs\n  ) {\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(\n  context: GetItemContext,\n  includeChildren: boolean,\n): Promise<ChildRollupContext | undefined> {\n  if (!includeChildren) {\n    return undefined;\n  }\n  const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);\n  const corpus = await listAllItemMetadataLight(\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 =\n      typeof candidate.parent === \"string\"\n        ? candidate.parent.trim().toLowerCase()\n        : \"\";\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/** Implements run get for the public runtime surface of this module. */\nexport async function runGet(\n  id: string,\n  global: GlobalOptions,\n  options: GetOptions = {},\n): 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({\n    ...projection,\n    field: \"linked\",\n  });\n  const includeClaimState = shouldIncludeGetField({\n    ...projection,\n    field: \"claim_state\",\n  });\n  const itemType = context.metadata.type.trim().toLowerCase();\n  const includeChildren = shouldIncludeGetField({\n    ...projection,\n    field: \"children\",\n    itemType,\n  });\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(\n    context,\n    options,\n    projection.treeDepth,\n    global,\n  );\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"903d7aec-5680-585b-86ba-9e39a81810a8"}
+{"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 {\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport {\n  EXIT_CODE,\n  ITEM_METADATA_KEY_ORDER,\n} from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  buildItemNotFoundError,\n  listAllItemMetadataLight,\n  locateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport {\n  getHistoryPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { recordContextUsageTouches } from \"../../sdk/context-usage.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport type {\n  ItemMetadata,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n} 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/** Documents the get result payload exchanged by command, SDK, and package integrations. */\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  /** Value that configures or reports item for this contract. */\n  item: Partial<ItemMetadata> & { body?: string };\n  /** Value that configures or reports linked for this contract. */\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  /** Value that configures or reports claim state for this contract. */\n  claim_state?: ClaimStateContext;\n  /** Value that configures or reports children for this contract. */\n  children?: ChildRollupContext;\n  /** Value that configures or reports tree for this contract. */\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/** Documents the get options payload exchanged by command, SDK, and package integrations. */\nexport interface GetOptions {\n  /** Value that configures or reports depth for this contract. */\n  depth?: string;\n  /** Value that configures or reports fields for this contract. */\n  fields?: string;\n  /** Value that configures or reports full for this contract. */\n  full?: boolean;\n  /** Value that configures or reports tree for this contract. */\n  tree?: boolean;\n  /** Value that configures or reports tree depth for this contract. */\n  treeDepth?: string;\n}\n\nfunction toClaimHistoryContext(entry: ClaimHistoryEntry): 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]\n    .reverse()\n    .find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history]\n    .reverse()\n    .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(\n    \"Get --depth must be one of brief|standard|deep|full\",\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction projectItemForDepth(\n  item: ItemMetadata,\n  depth: GetDepth,\n): Partial<ItemMetadata> {\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(\n      \"Get --fields requires a comma-separated list of field names\",\n      EXIT_CODE.USAGE,\n    );\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(\n  fields: string[] | null,\n  runtimeMetadataKeys: Iterable<string>,\n): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([\n    ...ITEM_METADATA_KEY_ORDER,\n    ...runtimeMetadataKeys,\n  ]);\n  const allowedRootFields = new Set([\n    \"body\",\n    \"linked\",\n    \"claim_state\",\n    \"children\",\n  ]);\n  const allowedLinkedFields = new Set([\n    \"linked.files\",\n    \"linked.tests\",\n    \"linked.docs\",\n  ]);\n  const allowedClaimStateFields = new Set([\n    \"claim_state.claimed\",\n    \"claim_state.assignee\",\n    \"claim_state.last_claim\",\n    \"claim_state.last_release\",\n  ]);\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(\n      `Unknown get --fields value(s): ${unknown.join(\", \")}`,\n      EXIT_CODE.USAGE,\n      {\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}\n\nfunction projectItemForFields(\n  item: ItemMetadata,\n  fields: string[],\n): Partial<ItemMetadata> {\n  const source = toItemRecord(item);\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\")\n      ? field.slice(\"item.\".length)\n      : field;\n    if (\n      normalized === \"body\" ||\n      normalized === \"linked\" ||\n      normalized.startsWith(\"linked.\")\n    ) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemMetadata>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return (\n    fields?.some((field) => field === name || field === `item.${name}`) ?? false\n  );\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: ItemMetadata;\n  body: string;\n}\n\nfunction resolveGetProjection(options: GetOptions): ResolvedGetProjection {\n  if (\n    options.full &&\n    (options.fields !== undefined || options.depth !== undefined)\n  ) {\n    throw new PmCliError(\n      \"Get projection options are mutually exclusive; remove the extra projection flag and retry.\",\n      EXIT_CODE.USAGE,\n    );\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:\n      options.tree === true\n        ? parseIntegerLimit(options.treeDepth, \"--tree-depth\")\n        : undefined,\n    fields: parseGetFields(options.fields),\n    fieldProjection: options.fields !== undefined,\n  };\n}\n\nasync function loadGetItemContext(\n  id: string,\n  global: GlobalOptions,\n): Promise<GetItemContext> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const located = await locateItem(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      typeRegistry.type_to_folder,\n    );\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(\n  fields: string[] | null,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): void {\n  const runtimeMetadataKeys = resolveRuntimeFieldRegistry(\n    settings.schema,\n  ).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(\n  context: GetItemContext,\n  includeClaimState: boolean,\n): 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 =\n    includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests =\n    includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs =\n    includeLinked || fieldsInclude(fields, \"linked.docs\");\n  if (\n    !includeLinked &&\n    !includeLinkedFiles &&\n    !includeLinkedTests &&\n    !includeLinkedDocs\n  ) {\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(\n  context: GetItemContext,\n  includeChildren: boolean,\n): Promise<ChildRollupContext | undefined> {\n  if (!includeChildren) {\n    return undefined;\n  }\n  const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);\n  const corpus = await listAllItemMetadataLight(\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 =\n      typeof candidate.parent === \"string\"\n        ? candidate.parent.trim().toLowerCase()\n        : \"\";\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/** Implements run get for the public runtime surface of this module. */\nexport async function runGet(\n  id: string,\n  global: GlobalOptions,\n  options: GetOptions = {},\n): 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({\n    ...projection,\n    field: \"linked\",\n  });\n  const includeClaimState = shouldIncludeGetField({\n    ...projection,\n    field: \"claim_state\",\n  });\n  const itemType = context.metadata.type.trim().toLowerCase();\n  const includeChildren = shouldIncludeGetField({\n    ...projection,\n    field: \"children\",\n    itemType,\n  });\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(\n    context,\n    options,\n    projection.treeDepth,\n    global,\n  );\n  try {\n    await recordContextUsageTouches({\n      pmRoot: context.pmRoot,\n      author:\n        (process.env.PM_AUTHOR ?? context.settings.author_default).trim() ||\n        \"unknown\",\n      itemIds: [context.locatedId],\n      intent: \"get\",\n    });\n  } catch {\n    // Derived usage feedback must never make the source-of-truth read fail.\n  }\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"233ec299-06cd-50e0-8ff5-bfbd40fe8bb2"}

package/dist/cli/commands/list.js

@@ -4,7 +4,7 @@
  * Implements the pm list 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]="48d2d75b-8dc2-5a29-885c-99f54699889c")}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]="6cf4aa0a-5582-5ed3-aff1-4a363ec0eda7")}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";
@@ -551,11 +551,10 @@ function parseAssigneeFilter(raw) {
     }
     return normalized;
 }
-// `pm list` keeps lenient status parsing (an unknown token is passed through
-// verbatim and simply matches nothing) so custom/unknown statuses never error;
-// the shared CSV parser resolves the open/closed/canceled workflow-group aliases.
+// Resolve built-in, runtime, and workflow-group aliases through the shared
+// registry, rejecting typos instead of returning a misleading empty result.
 function resolveStatusFilter(status, statusRegistry) {
-    return parseStatusFilterCsv(status, statusRegistry, { strict: false });
+    return parseStatusFilterCsv(status, statusRegistry, { strict: true });
 }
 function assertListAssigneeFilters(assigneeFilter, assigneeModeFilter) {
     if (assigneeFilter &&
@@ -1072,4 +1071,4 @@ export const _testOnly = {
     withTreeMetadata,
 };
 //# sourceMappingURL=list.js.map
-//# debugId=48d2d75b-8dc2-5a29-885c-99f54699889c
+//# debugId=6cf4aa0a-5582-5ed3-aff1-4a363ec0eda7