@unbrained/pm-cli 2026.5.31 → 2026.6.5

package/dist/cli-bundle/chunks/{files-WVOX67PE.js.map → files-MXYS5W4M.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/files.ts"],
   "sourcesContent": ["import 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 { locateItem, mutateItem, readLocatedItem } 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 LinkedPathAuditEntry,\n  type LinkedPathValidation,\n} from \"./linked-artifacts.js\";\n\nexport interface FilesCommandOptions {\n  add?: string[];\n  addGlob?: string[];\n  remove?: string[];\n  migrate?: string[];\n  list?: boolean;\n  appendStable?: boolean;\n  validatePaths?: boolean;\n  audit?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface FilesDiscoverOptions {\n  apply?: boolean;\n  appendStable?: boolean;\n  note?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface FilesDiscoveryCandidate {\n  path: string;\n  scope: LinkScope;\n  status: \"addable\" | \"already_linked\";\n  source_count: number;\n  source_fields: string[];\n  original_paths: string[];\n}\n\nexport interface FilesResult {\n  id: string;\n  files: LinkedFile[];\n  changed: boolean;\n  count: number;\n  migrations_applied?: number;\n  validation?: LinkedPathValidation;\n  audit?: LinkedPathAuditEntry[];\n}\n\nexport interface FilesDiscoverResult {\n  id: string;\n  files: LinkedFile[];\n  changed: boolean;\n  apply: boolean;\n  count: number;\n  candidate_count: number;\n  addable_count: number;\n  added_count: number;\n  skipped_existing_count: number;\n  candidates: FilesDiscoveryCandidate[];\n  added: LinkedFile[];\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(linkedFile: Pick<LinkedFile, \"path\" | \"scope\">, projectRoot: string): 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(value: unknown, fieldPath: string, references: TextReference[]): 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) => collectTextReferences(entry, `${fieldPath}[${index}]`, references));\n    return;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    for (const [key, nested] of Object.entries(value)) {\n      collectTextReferences(nested, fieldPath ? `${fieldPath}.${key}` : key, references);\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(references: TextReference[]): 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        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) ? path.resolve(rawPath) : 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(canonicalProjectRoot, canonicalAbsolutePath);\n    if (!relativePath || relativePath.startsWith(\"..\") || path.isAbsolute(relativePath)) {\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(document: ItemDocument, projectRoot: string): Promise<FilesDiscoveryCandidate[]> {\n  const existingResolvedKeys = new Set((document.metadata.files ?? []).map((entry) => linkedFileResolvedKey(entry, projectRoot)));\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(collectItemTextReferences(document));\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) ? (\"already_linked\" as const) : (\"addable\" as const),\n      source_count: entry.sourceCount,\n      source_fields: [...entry.sourceFields].sort((left, right) => left.localeCompare(right)),\n      original_paths: [...entry.originalPaths].sort((left, right) => left.localeCompare(right)),\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      return left.scope.localeCompare(right.scope);\n    });\n}\n\nexport async function runFiles(id: string, options: FilesCommandOptions, global: GlobalOptions): Promise<FilesResult> {\n  const result: LinkedArtifactResult = await runLinkedArtifacts(id, options, global, {\n    metadataKey: \"files\",\n    op: \"files_add\",\n    bareNoun: \"file\",\n    supportsAppendStable: true,\n  });\n  return renameArtifactsResultKey(result, \"files\") as unknown as FilesResult;\n}\n\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(`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 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(loaded.document, process.cwd());\n  const addableCandidates = candidates.filter((candidate) => candidate.status === \"addable\");\n  const skippedExisting = candidates.filter((candidate) => candidate.status === \"already_linked\");\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(next.map((entry) => linkedFileResolvedKey(entry, process.cwd())));\n      const appliedAdds: LinkedFile[] = [];\n      for (const add of discoveredAdds) {\n        const resolvedKey = linkedFileResolvedKey(add, process.cwd());\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      const normalized = options.appendStable ? deduped : sortLinkedArtifacts(deduped);\n      if (normalized.length > 0) {\n        document.metadata.files = normalized;\n      } else {\n        delete document.metadata.files;\n      }\n      return {\n        changedFields: appliedAdds.length > 0 ? [\"files\"] : [],\n        warnings: appliedAdds.length !== discoveredAdds.length ? [`files_discover_skipped_existing:${discoveredAdds.length - appliedAdds.length}`] : [],\n      };\n    },\n  });\n\n  const files = result.item.files ?? [];\n  const addedResolvedKeys = new Set(discoveredAdds.map((entry) => linkedFileResolvedKey(entry, process.cwd())));\n  const added = files.filter((entry) => addedResolvedKeys.has(linkedFileResolvedKey(entry, process.cwd())));\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"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["global", "files"]
 }

package/dist/cli-bundle/chunks/gc-GT552UJH.js

@@ -0,0 +1,178 @@
+
+!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]="3ebcb88b-3dec-5748-a0a5-5396eb6852a8")}catch(e){}}();
+import {
+  nowIso
+} from "./chunk-NQP3ECKF.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  runActiveOnIndexHooks,
+  runActiveOnReadHooks,
+  runActiveOnWriteHooks
+} from "./chunk-4LTBNUYT.js";
+
+// dist/cli/commands/gc.js
+import fs from "node:fs/promises";
+import path from "node:path";
+var GC_SCOPE_VALUES = ["index", "embeddings", "runtime"];
+var GC_TARGETS = [
+  {
+    scope: "index",
+    relativePath: "index/manifest.json",
+    kind: "file"
+  },
+  {
+    scope: "embeddings",
+    relativePath: "search/embeddings.jsonl",
+    kind: "file"
+  },
+  {
+    scope: "embeddings",
+    relativePath: "search/vectorization-status.json",
+    kind: "file"
+  },
+  {
+    scope: "embeddings",
+    relativePath: "search/lancedb",
+    kind: "directory"
+  },
+  {
+    scope: "runtime",
+    relativePath: "runtime/test-runs",
+    kind: "directory"
+  }
+];
+function isErrno(error, code) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+async function removeCacheFile(pmRoot, target, dryRun) {
+  const relativePath = target.relativePath;
+  const absolutePath = path.join(pmRoot, relativePath);
+  const warnings = await runActiveOnReadHooks({
+    path: absolutePath,
+    scope: "project"
+  });
+  try {
+    const stats = await fs.stat(absolutePath);
+    if (target.kind === "file" && !stats.isFile()) {
+      return {
+        removed: false,
+        warnings: [...warnings, `not_a_file:${relativePath}`]
+      };
+    }
+    if (target.kind === "directory" && !stats.isDirectory()) {
+      return {
+        removed: false,
+        warnings: [...warnings, `not_a_directory:${relativePath}`]
+      };
+    }
+    if (dryRun) {
+      return {
+        removed: true,
+        warnings
+      };
+    }
+    if (target.kind === "file") {
+      await fs.unlink(absolutePath);
+    } else {
+      await fs.rm(absolutePath, { recursive: true, force: true });
+    }
+    const writeWarnings = await runActiveOnWriteHooks({
+      path: absolutePath,
+      scope: "project",
+      op: "gc:remove"
+    });
+    return {
+      removed: true,
+      warnings: [...warnings, ...writeWarnings]
+    };
+  } catch (error) {
+    if (isErrno(error, "ENOENT")) {
+      return {
+        removed: false,
+        warnings
+      };
+    }
+    throw error;
+  }
+}
+function parseScopes(raw) {
+  if (!raw || raw.length === 0) {
+    return [...GC_SCOPE_VALUES];
+  }
+  const tokens = raw.flatMap((entry) => entry.split(",")).map((entry) => entry.trim().toLowerCase()).filter((entry) => entry.length > 0);
+  if (tokens.length === 0) {
+    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(",")})`, EXIT_CODE.USAGE);
+  }
+  const resolved = /* @__PURE__ */ new Set();
+  for (const token of tokens) {
+    if (!GC_SCOPE_VALUES.includes(token)) {
+      throw new PmCliError(`Invalid --scope value "${token}". Expected one or more of: ${GC_SCOPE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+    }
+    resolved.add(token);
+  }
+  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));
+}
+function buildGcGuidance(params) {
+  const guidance = [];
+  if (params.dryRun) {
+    guidance.push("Dry-run preview only: no cache artifacts were deleted.");
+  }
+  const searchScopeSelected = params.scopes.includes("index") || params.scopes.includes("embeddings");
+  const searchArtifactsAffected = params.removed.some((entry) => entry === "index/manifest.json" || entry === "search/embeddings.jsonl" || entry === "search/vectorization-status.json" || entry === "search/lancedb");
+  if (searchScopeSelected && searchArtifactsAffected) {
+    guidance.push('Search artifacts were removed; run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.');
+  }
+  return guidance;
+}
+async function runGc(global, options = {}) {
+  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);
+  }
+  await readSettings(pmRoot);
+  const dryRun = options.dryRun === true;
+  const scopes = parseScopes(options.scope);
+  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));
+  const removed = [];
+  const retained = [];
+  const warnings = [];
+  for (const target of selectedTargets) {
+    const result = await removeCacheFile(pmRoot, target, dryRun);
+    if (result.removed) {
+      removed.push(target.relativePath);
+    } else {
+      retained.push(target.relativePath);
+    }
+    warnings.push(...result.warnings);
+  }
+  warnings.push(...await runActiveOnIndexHooks({
+    mode: dryRun ? "gc:dry-run" : "gc",
+    total_items: selectedTargets.length
+  }));
+  const guidance = buildGcGuidance({
+    dryRun,
+    scopes,
+    removed
+  });
+  return {
+    ok: warnings.length === 0,
+    dry_run: dryRun,
+    scope: scopes,
+    removed,
+    retained,
+    warnings,
+    guidance,
+    generated_at: nowIso()
+  };
+}
+export {
+  runGc
+};
+//# sourceMappingURL=gc-GT552UJH.js.map
+
+//# debugId=3ebcb88b-3dec-5748-a0a5-5396eb6852a8

package/dist/cli-bundle/chunks/gc-GT552UJH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/gc.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.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 { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\"index\", \"embeddings\", \"runtime\"] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n] as const;\n\nexport interface GcCommandOptions {\n  dryRun?: boolean;\n  scope?: string[];\n}\n\nexport interface GcResult {\n  ok: boolean;\n  dry_run: boolean;\n  scope: GcScope[];\n  removed: string[];\n  retained: string[];\n  warnings: string[];\n  guidance: string[];\n  generated_at: string;\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`, EXIT_CODE.USAGE);\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected = params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  return guidance;\n}\n\nexport async function runGc(global: GlobalOptions, options: GcCommandOptions = {}): Promise<GcResult> {\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\n  await readSettings(pmRoot);\n  const dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3ebcb88b-3dec-5748-a0a5-5396eb6852a8"}

package/dist/cli-bundle/chunks/{gc-JWNF66EC.js → gc-QNBRJG6H.js}

@@ -1,6 +1,6 @@
 import {
   nowIso
-} from "./chunk-PVNQLCIS.js";
+} from "./chunk-RANZIID5.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -11,7 +11,7 @@ import {
   runActiveOnIndexHooks,
   runActiveOnReadHooks,
   runActiveOnWriteHooks
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-SRVKTWPR.js";
 
 // dist/cli/commands/gc.js
 import fs from "node:fs/promises";
@@ -178,4 +178,4 @@ async function runGc(global2, options = {}) {
 export {
   runGc
 };
-//# sourceMappingURL=gc-JWNF66EC.js.map
+//# sourceMappingURL=gc-QNBRJG6H.js.map

package/dist/cli-bundle/chunks/{get-LTK3HOCQ.js → get-CINFEUIY.js}

@@ -1,21 +1,20 @@
 import {
   readHistoryEntries
-} from "./chunk-LRBOHPUE.js";
-import "./chunk-JFWUHHS2.js";
-import "./chunk-SEXQN4KL.js";
+} from "./chunk-WIKR7KFL.js";
+import "./chunk-S3CV7JGJ.js";
+import "./chunk-K47WAYQV.js";
 import {
   buildItemNotFoundError,
   locateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-BUPWJ3IJ.js";
-import "./chunk-4AEZR5EJ.js";
-import "./chunk-CEFIVZPG.js";
-import "./chunk-MD7K4JYF.js";
+} from "./chunk-XG7RJYHV.js";
+import "./chunk-KA24HME7.js";
+import "./chunk-HPH6X4ZZ.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-WDPXDQFG.js";
-import "./chunk-PVNQLCIS.js";
+} from "./chunk-4PJQSECJ.js";
+import "./chunk-RANZIID5.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -27,13 +26,13 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeFieldRegistry
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-SRVKTWPR.js";
 
 // dist/cli/commands/get.js
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2fa975eb-d60c-56d2-91a2-9b312b469016");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "808844af-e84f-5fd7-97c3-e4c81ff86193");
   } catch (e2) {
   }
 })();
@@ -59,7 +58,7 @@ function resolveClaimStateContext(assigneeValue, history) {
 }
 function parseGetDepth(raw) {
   if (raw === void 0 || raw.trim().length === 0) {
-    return "deep";
+    return "standard";
   }
   const normalized = raw.trim().toLowerCase();
   if (normalized === "full") {
@@ -162,7 +161,7 @@ async function runGet(id, global2, options = {}) {
   const includeLinkedFiles = includeLinked || fieldsInclude(fields, "linked.files");
   const includeLinkedTests = includeLinked || fieldsInclude(fields, "linked.tests");
   const includeLinkedDocs = includeLinked || fieldsInclude(fields, "linked.docs");
-  const includeClaimState = !fieldProjection || fieldsIncludeRoot(fields, "claim_state");
+  const includeClaimState = !fieldProjection ? depth !== "brief" : fieldsIncludeRoot(fields, "claim_state");
   let claimState;
   if (includeClaimState) {
     const historyPath = getHistoryPath(pmRoot, located.id);
@@ -177,10 +176,10 @@ async function runGet(id, global2, options = {}) {
   const result = {
     item: fieldProjection ? projectItemForFields(loaded.document.metadata, fields) : projectItemForDepth(loaded.document.metadata, depth)
   };
-  if (!fieldProjection || includeBody) {
-    result.body = includeBody ? loaded.document.body : "";
+  if (includeBody) {
+    result.body = loaded.document.body;
   }
-  if (!fieldProjection || includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {
+  if (includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {
     result.linked = {
       files: includeLinkedFiles ? files : [],
       tests: includeLinkedTests ? tests : [],
@@ -195,4 +194,4 @@ async function runGet(id, global2, options = {}) {
 export {
   runGet
 };
-//# sourceMappingURL=get-LTK3HOCQ.js.map
+//# sourceMappingURL=get-CINFEUIY.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/get.ts"],
+  "sourcesContent": ["import { 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 } from \"../../core/schema/runtime-schema.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, 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 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\nexport interface GetResult {\n  item: Partial<ItemFrontMatter>;\n  body?: string;\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\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\"]);\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\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  const depth = options.full ? \"deep\" : parseGetDepth(options.depth);\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.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  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/get-WXMLRG7M.js

@@ -0,0 +1,194 @@
+
+!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]="ee4af23f-e74f-5512-a4da-786f9a459b45")}catch(e){}}();
+import {
+  readHistoryEntries
+} from "./chunk-V3JQ4IPL.js";
+import "./chunk-ASQM3IF5.js";
+import "./chunk-GFWHHMVV.js";
+import {
+  buildItemNotFoundError,
+  locateItem,
+  readLocatedItem,
+  toItemRecord
+} from "./chunk-CWT53EYT.js";
+import "./chunk-SSFMJCPF.js";
+import "./chunk-KBG47ZOY.js";
+import {
+  resolveItemTypeRegistry
+} from "./chunk-SZQCER6S.js";
+import "./chunk-NQP3ECKF.js";
+import {
+  EXIT_CODE,
+  FRONT_MATTER_KEY_ORDER,
+  PmCliError,
+  getActiveExtensionRegistrations,
+  getHistoryPath,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  resolveRuntimeFieldRegistry
+} from "./chunk-4LTBNUYT.js";
+
+// dist/cli/commands/get.js
+var GET_DEPTH_VALUES = ["brief", "standard", "deep"];
+function toClaimHistoryContext(entry) {
+  return {
+    ts: entry.ts,
+    author: entry.author,
+    message: entry.message ?? null
+  };
+}
+function resolveClaimStateContext(assigneeValue, history) {
+  const assignee = assigneeValue?.trim();
+  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;
+  const lastClaim = [...history].reverse().find((entry) => entry.op === "claim");
+  const lastRelease = [...history].reverse().find((entry) => entry.op === "release");
+  return {
+    claimed: normalizedAssignee !== null,
+    assignee: normalizedAssignee,
+    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,
+    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null
+  };
+}
+function parseGetDepth(raw) {
+  if (raw === void 0 || raw.trim().length === 0) {
+    return "standard";
+  }
+  const normalized = raw.trim().toLowerCase();
+  if (normalized === "full") {
+    return "deep";
+  }
+  if (GET_DEPTH_VALUES.includes(normalized)) {
+    return normalized;
+  }
+  throw new PmCliError("Get --depth must be one of brief|standard|deep|full", EXIT_CODE.USAGE);
+}
+function projectItemForDepth(item, depth) {
+  if (depth === "deep") {
+    return item;
+  }
+  const { comments: _comments, notes: _notes, learnings: _learnings, files: _files, tests: _tests, docs: _docs, reminders: _reminders, events: _events, ...projected } = item;
+  return projected;
+}
+function parseGetFields(raw) {
+  if (raw === void 0) {
+    return null;
+  }
+  const fields = raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+  if (fields.length === 0) {
+    throw new PmCliError("Get --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
+  }
+  return fields;
+}
+function normalizeGetField(field) {
+  return field.startsWith("item.") ? field.slice("item.".length) : field;
+}
+function validateGetFields(fields, runtimeMetadataKeys) {
+  if (fields === null) {
+    return;
+  }
+  const itemFields = /* @__PURE__ */ new Set([...FRONT_MATTER_KEY_ORDER, ...runtimeMetadataKeys]);
+  const allowedRootFields = /* @__PURE__ */ new Set(["body", "linked", "claim_state"]);
+  const allowedLinkedFields = /* @__PURE__ */ new Set(["linked.files", "linked.tests", "linked.docs"]);
+  const allowedClaimStateFields = /* @__PURE__ */ new Set(["claim_state.claimed", "claim_state.assignee", "claim_state.last_claim", "claim_state.last_release"]);
+  const unknown = fields.filter((field) => {
+    const normalized = normalizeGetField(field);
+    return !itemFields.has(normalized) && !allowedRootFields.has(normalized) && !allowedLinkedFields.has(normalized) && !allowedClaimStateFields.has(normalized);
+  });
+  if (unknown.length > 0) {
+    throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
+      code: "unknown_field_projection",
+      examples: [
+        "pm get <id> --fields id,title,status,type,updated_at",
+        "pm get <id> --fields id,title,claim_state",
+        "pm get <id> --fields id,title,body,linked.files"
+      ]
+    });
+  }
+}
+function projectItemForFields(item, fields) {
+  const source = toItemRecord(item);
+  const projected = {};
+  for (const field of fields) {
+    const normalized = field.startsWith("item.") ? field.slice("item.".length) : field;
+    if (normalized === "body" || normalized === "linked" || normalized.startsWith("linked.")) {
+      continue;
+    }
+    projected[normalized] = source[normalized];
+  }
+  return projected;
+}
+function fieldsInclude(fields, name) {
+  return fields?.some((field) => field === name || field === `item.${name}`) ?? false;
+}
+function fieldsIncludeRoot(fields, name) {
+  return fields.some((field) => field === name || field.startsWith(`${name}.`));
+}
+async function runGet(id, global, options = {}) {
+  if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
+    throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.", EXIT_CODE.USAGE);
+  }
+  const depth = options.full ? "deep" : parseGetDepth(options.depth);
+  const fields = parseGetFields(options.fields);
+  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);
+  if (!located) {
+    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);
+  }
+  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");
+  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 = [];
+    }
+    claimState = resolveClaimStateContext(loaded.document.metadata.assignee, history);
+  }
+  const result = {
+    item: fieldProjection ? projectItemForFields(loaded.document.metadata, fields) : projectItemForDepth(loaded.document.metadata, depth)
+  };
+  if (includeBody) {
+    result.body = loaded.document.body;
+  }
+  if (includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {
+    result.linked = {
+      files: includeLinkedFiles ? files : [],
+      tests: includeLinkedTests ? tests : [],
+      docs: includeLinkedDocs ? docs : []
+    };
+  }
+  if (claimState) {
+    result.claim_state = claimState;
+  }
+  return result;
+}
+export {
+  runGet
+};
+//# sourceMappingURL=get-WXMLRG7M.js.map
+
+//# debugId=ee4af23f-e74f-5512-a4da-786f9a459b45

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/get.ts"],"sourcesContent":["import { 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 } from \"../../core/schema/runtime-schema.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, 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 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\nexport interface GetResult {\n  item: Partial<ItemFrontMatter>;\n  body?: string;\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\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\"]);\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\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  const depth = options.full ? \"deep\" : parseGetDepth(options.depth);\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.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  return result;\n}\n"],"names":[],"mappings":"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","debugId":"ee4af23f-e74f-5512-a4da-786f9a459b45"}