@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/files-JPU3FNJ7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/files.ts"],"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 { 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\n/**\n * Documents the files command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface FilesCommandOptions {\n  add?: string[];\n  addGlob?: string[];\n  remove?: string[];\n  migrate?: string[];\n  /** GH-170 (pm-pfnx): standalone note applied to every --add/--add-glob link in this invocation. */\n  note?: string;\n  list?: boolean;\n  appendStable?: boolean;\n  validatePaths?: boolean;\n  audit?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the files discover options payload exchanged by command, SDK, and package integrations.\n */\nexport interface FilesDiscoverOptions {\n  apply?: boolean;\n  appendStable?: boolean;\n  note?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the files discovery candidate payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the files result payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the files discover result payload exchanged by command, SDK, and package integrations.\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      /* c8 ignore next -- root-level object traversal always carries a non-empty field path in current callers. */\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        /* 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) ? 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      /* c8 ignore next -- path+status collisions are uncommon in deterministic fixtures. */\n      return left.scope.localeCompare(right.scope);\n    });\n}\n\nexport const _testOnly = {\n  normalizeCandidatePathForOutput,\n  realpathForContainment,\n  linkedFileResolvedKey,\n  collectTextReferences,\n  collectItemTextReferences,\n  cleanupPathToken,\n  extractRawPathReferences,\n  resolveDiscoveredFile,\n  discoverReferencedFiles,\n};\n\n/**\n * Implements run files for the public runtime surface of this module.\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\n/**\n * Implements run files discover for the public runtime surface of this module.\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  /* 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(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        /* 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 ? deduped : 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: 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"],"names":["files"],"mappings":"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","debugId":"6179dd4d-1596-513b-a554-40cba753daff"}

package/dist/cli-bundle/chunks/focus-LFZ6IDBR.js

@@ -1,106 +0,0 @@
-
-!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]="879316e1-22fd-544f-a0d4-8d9d4ce1dfa8")}catch(e){}}();
-import {
-  clearFocusedItem,
-  getFocusedItem,
-  setFocusedItem
-} from "./chunk-PDXT6Q55.js";
-import {
-  buildItemNotFoundError,
-  locateItem,
-  readLocatedItem
-} from "./chunk-57C2RLW5.js";
-import {
-  normalizeItemId
-} from "./chunk-HK72NWAD.js";
-import "./chunk-FJRKQREY.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
-  readSettings
-} from "./chunk-US3T3W5J.js";
-import "./chunk-NNHHXJB2.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  resolveItemTypeRegistry,
-  resolvePmRoot
-} from "./chunk-YD5FML7K.js";
-
-// dist/cli/commands/focus.js
-async function ensureInitialized(pmRoot) {
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-}
-async function runFocus(id, options, global) {
-  const pmRoot = resolvePmRoot(process.cwd(), global.path);
-  await ensureInitialized(pmRoot);
-  const clear = options.clear === true;
-  if (clear) {
-    if (id !== void 0) {
-      throw new PmCliError("pm focus --clear does not take an item id. Use 'pm focus --clear' to clear focus or 'pm focus <id>' to set it.", EXIT_CODE.USAGE);
-    }
-    await clearFocusedItem(pmRoot);
-    return {
-      action: "clear",
-      focused_item: null,
-      title: null,
-      message: "Focus cleared. New items will not inherit a default parent."
-    };
-  }
-  if (id === void 0) {
-    const current = await getFocusedItem(pmRoot);
-    if (current === void 0) {
-      return {
-        action: "show",
-        focused_item: null,
-        title: null,
-        message: "No focus set. Use 'pm focus <id>' to set a default parent for new items."
-      };
-    }
-    const title2 = await resolveFocusedTitle(pmRoot, current);
-    return {
-      action: "show",
-      focused_item: current,
-      title: title2,
-      message: `Focused on ${current}${title2 ? ` (${title2})` : ""}. New items default --parent to it.`
-    };
-  }
-  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 normalizedId = normalizeItemId(located.id, settings.id_prefix);
-  const loaded = await readLocatedItem(located, { schema: settings.schema });
-  const title = nonEmptyTitleOrNull(loaded.document.metadata.title);
-  await setFocusedItem(pmRoot, normalizedId);
-  return {
-    action: "set",
-    focused_item: normalizedId,
-    title,
-    message: `Focused on ${normalizedId}${title ? ` (${title})` : ""}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`
-  };
-}
-async function resolveFocusedTitle(pmRoot, id) {
-  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) {
-    return null;
-  }
-  const loaded = await readLocatedItem(located, { schema: settings.schema });
-  return nonEmptyTitleOrNull(loaded.document.metadata.title);
-}
-function nonEmptyTitleOrNull(title) {
-  return title.trim().length > 0 ? title : null;
-}
-export {
-  runFocus
-};
-//# sourceMappingURL=focus-LFZ6IDBR.js.map
-
-//# debugId=879316e1-22fd-544f-a0d4-8d9d4ce1dfa8

package/dist/cli-bundle/chunks/focus-LFZ6IDBR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/focus.ts"],"sourcesContent":["/**\n * @module cli/commands/focus\n *\n * Implements the pm focus 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 { normalizeItemId } from \"../../core/item/id.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  clearFocusedItem,\n  getFocusedItem,\n  setFocusedItem,\n} from \"../../core/session/session-state.js\";\nimport { buildItemNotFoundError, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/**\n * Documents the focus options payload exchanged by command, SDK, and package integrations.\n */\nexport interface FocusOptions {\n  clear?: boolean;\n}\n\n/**\n * Documents the focus result payload exchanged by command, SDK, and package integrations.\n */\nexport interface FocusResult {\n  action: \"set\" | \"clear\" | \"show\";\n  focused_item: string | null;\n  title: string | null;\n  message: string;\n}\n\nasync function ensureInitialized(pmRoot: string): Promise<void> {\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\n/**\n * Implements run focus for the public runtime surface of this module.\n */\nexport async function runFocus(\n  id: string | undefined,\n  options: FocusOptions,\n  global: GlobalOptions,\n): Promise<FocusResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  await ensureInitialized(pmRoot);\n\n  const clear = options.clear === true;\n\n  if (clear) {\n    if (id !== undefined) {\n      throw new PmCliError(\n        \"pm focus --clear does not take an item id. Use 'pm focus --clear' to clear focus or 'pm focus <id>' to set it.\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    await clearFocusedItem(pmRoot);\n    return {\n      action: \"clear\",\n      focused_item: null,\n      title: null,\n      message: \"Focus cleared. New items will not inherit a default parent.\",\n    };\n  }\n\n  if (id === undefined) {\n    const current = await getFocusedItem(pmRoot);\n    if (current === undefined) {\n      return {\n        action: \"show\",\n        focused_item: null,\n        title: null,\n        message: \"No focus set. Use 'pm focus <id>' to set a default parent for new items.\",\n      };\n    }\n    const title = await resolveFocusedTitle(pmRoot, current);\n    return {\n      action: \"show\",\n      focused_item: current,\n      title,\n      message: `Focused on ${current}${title ? ` (${title})` : \"\"}. New items default --parent to it.`,\n    };\n  }\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 normalizedId = normalizeItemId(located.id, settings.id_prefix);\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const title = nonEmptyTitleOrNull(loaded.document.metadata.title);\n  await setFocusedItem(pmRoot, normalizedId);\n  return {\n    action: \"set\",\n    focused_item: normalizedId,\n    title,\n    message: `Focused on ${normalizedId}${title ? ` (${title})` : \"\"}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`,\n  };\n}\n\nasync function resolveFocusedTitle(pmRoot: string, id: string): Promise<string | null> {\n  // The tracker is already known to be initialized (ensureInitialized ran), so\n  // readSettings/locateItem behave like the `pm get` read path: a deleted/stale\n  // focused item simply locates to null and yields no title hint.\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    return null;\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  return nonEmptyTitleOrNull(loaded.document.metadata.title);\n}\n\nfunction nonEmptyTitleOrNull(title: string): string | null {\n  return title.trim().length > 0 ? title : null;\n}\n"],"names":["title"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,eAAe,kBAAkB,QAAc;AAC7C,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AACF;AAKA,eAAsB,SACpB,IACA,SACA,QAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,QAAM,kBAAkB,MAAM;AAE9B,QAAM,QAAQ,QAAQ,UAAU;AAEhC,MAAI,OAAO;AACT,QAAI,OAAO,QAAW;AACpB,YAAM,IAAI,WACR,kHACA,UAAU,KAAK;IAEnB;AACA,UAAM,iBAAiB,MAAM;AAC7B,WAAO;MACL,QAAQ;MACR,cAAc;MACd,OAAO;MACP,SAAS;;EAEb;AAEA,MAAI,OAAO,QAAW;AACpB,UAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,QAAI,YAAY,QAAW;AACzB,aAAO;QACL,QAAQ;QACR,cAAc;QACd,OAAO;QACP,SAAS;;IAEb;AACA,UAAMA,SAAQ,MAAM,oBAAoB,QAAQ,OAAO;AACvD,WAAO;MACL,QAAQ;MACR,cAAc;MACd,OAAAA;MACA,SAAS,cAAc,OAAO,GAAGA,SAAQ,KAAKA,MAAK,MAAM,EAAE;;EAE/D;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,aAAa,cAAc;AAClH,MAAI,CAAC,SAAS;AACZ,UAAM,MAAM,uBAAuB,QAAQ,IAAI,SAAS,WAAW,aAAa,cAAc;EAChG;AACA,QAAM,eAAe,gBAAgB,QAAQ,IAAI,SAAS,SAAS;AACnE,QAAM,SAAS,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AACzE,QAAM,QAAQ,oBAAoB,OAAO,SAAS,SAAS,KAAK;AAChE,QAAM,eAAe,QAAQ,YAAY;AACzC,SAAO;IACL,QAAQ;IACR,cAAc;IACd;IACA,SAAS,cAAc,YAAY,GAAG,QAAQ,KAAK,KAAK,MAAM,EAAE;;AAEpE;AAEA,eAAe,oBAAoB,QAAgB,IAAU;AAI3D,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,aAAa,cAAc;AAClH,MAAI,CAAC,SAAS;AACZ,WAAO;EACT;AACA,QAAM,SAAS,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AACzE,SAAO,oBAAoB,OAAO,SAAS,SAAS,KAAK;AAC3D;AAEA,SAAS,oBAAoB,OAAa;AACxC,SAAO,MAAM,KAAI,EAAG,SAAS,IAAI,QAAQ;AAC3C","debugId":"879316e1-22fd-544f-a0d4-8d9d4ce1dfa8"}

package/dist/cli-bundle/chunks/focus-WNMYCVYA.js

@@ -1,109 +0,0 @@
-import {
-  clearFocusedItem,
-  getFocusedItem,
-  setFocusedItem
-} from "./chunk-ZMD35NYG.js";
-import {
-  buildItemNotFoundError,
-  locateItem,
-  readLocatedItem
-} from "./chunk-3U3VEWK6.js";
-import {
-  normalizeItemId
-} from "./chunk-EZFKWSC7.js";
-import "./chunk-DRBV5UC2.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
-  readSettings
-} from "./chunk-P5YORJRH.js";
-import "./chunk-7C2O74AE.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  resolveItemTypeRegistry,
-  resolvePmRoot
-} from "./chunk-5VVUKE3U.js";
-
-// dist/cli/commands/focus.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] = "804f4d58-d2b5-586d-bada-ced419ae4a11");
-  } catch (e2) {
-  }
-})();
-async function ensureInitialized(pmRoot) {
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-}
-async function runFocus(id, options, global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  await ensureInitialized(pmRoot);
-  const clear = options.clear === true;
-  if (clear) {
-    if (id !== void 0) {
-      throw new PmCliError("pm focus --clear does not take an item id. Use 'pm focus --clear' to clear focus or 'pm focus <id>' to set it.", EXIT_CODE.USAGE);
-    }
-    await clearFocusedItem(pmRoot);
-    return {
-      action: "clear",
-      focused_item: null,
-      title: null,
-      message: "Focus cleared. New items will not inherit a default parent."
-    };
-  }
-  if (id === void 0) {
-    const current = await getFocusedItem(pmRoot);
-    if (current === void 0) {
-      return {
-        action: "show",
-        focused_item: null,
-        title: null,
-        message: "No focus set. Use 'pm focus <id>' to set a default parent for new items."
-      };
-    }
-    const title2 = await resolveFocusedTitle(pmRoot, current);
-    return {
-      action: "show",
-      focused_item: current,
-      title: title2,
-      message: `Focused on ${current}${title2 ? ` (${title2})` : ""}. New items default --parent to it.`
-    };
-  }
-  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 normalizedId = normalizeItemId(located.id, settings.id_prefix);
-  const loaded = await readLocatedItem(located, { schema: settings.schema });
-  const title = nonEmptyTitleOrNull(loaded.document.metadata.title);
-  await setFocusedItem(pmRoot, normalizedId);
-  return {
-    action: "set",
-    focused_item: normalizedId,
-    title,
-    message: `Focused on ${normalizedId}${title ? ` (${title})` : ""}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`
-  };
-}
-async function resolveFocusedTitle(pmRoot, id) {
-  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) {
-    return null;
-  }
-  const loaded = await readLocatedItem(located, { schema: settings.schema });
-  return nonEmptyTitleOrNull(loaded.document.metadata.title);
-}
-function nonEmptyTitleOrNull(title) {
-  return title.trim().length > 0 ? title : null;
-}
-export {
-  runFocus
-};
-//# sourceMappingURL=focus-WNMYCVYA.js.map

package/dist/cli-bundle/chunks/focus-WNMYCVYA.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/focus.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/focus\n *\n * Implements the pm focus 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 { normalizeItemId } from \"../../core/item/id.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  clearFocusedItem,\n  getFocusedItem,\n  setFocusedItem,\n} from \"../../core/session/session-state.js\";\nimport { buildItemNotFoundError, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/**\n * Documents the focus options payload exchanged by command, SDK, and package integrations.\n */\nexport interface FocusOptions {\n  clear?: boolean;\n}\n\n/**\n * Documents the focus result payload exchanged by command, SDK, and package integrations.\n */\nexport interface FocusResult {\n  action: \"set\" | \"clear\" | \"show\";\n  focused_item: string | null;\n  title: string | null;\n  message: string;\n}\n\nasync function ensureInitialized(pmRoot: string): Promise<void> {\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\n/**\n * Implements run focus for the public runtime surface of this module.\n */\nexport async function runFocus(\n  id: string | undefined,\n  options: FocusOptions,\n  global: GlobalOptions,\n): Promise<FocusResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  await ensureInitialized(pmRoot);\n\n  const clear = options.clear === true;\n\n  if (clear) {\n    if (id !== undefined) {\n      throw new PmCliError(\n        \"pm focus --clear does not take an item id. Use 'pm focus --clear' to clear focus or 'pm focus <id>' to set it.\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    await clearFocusedItem(pmRoot);\n    return {\n      action: \"clear\",\n      focused_item: null,\n      title: null,\n      message: \"Focus cleared. New items will not inherit a default parent.\",\n    };\n  }\n\n  if (id === undefined) {\n    const current = await getFocusedItem(pmRoot);\n    if (current === undefined) {\n      return {\n        action: \"show\",\n        focused_item: null,\n        title: null,\n        message: \"No focus set. Use 'pm focus <id>' to set a default parent for new items.\",\n      };\n    }\n    const title = await resolveFocusedTitle(pmRoot, current);\n    return {\n      action: \"show\",\n      focused_item: current,\n      title,\n      message: `Focused on ${current}${title ? ` (${title})` : \"\"}. New items default --parent to it.`,\n    };\n  }\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 normalizedId = normalizeItemId(located.id, settings.id_prefix);\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const title = nonEmptyTitleOrNull(loaded.document.metadata.title);\n  await setFocusedItem(pmRoot, normalizedId);\n  return {\n    action: \"set\",\n    focused_item: normalizedId,\n    title,\n    message: `Focused on ${normalizedId}${title ? ` (${title})` : \"\"}. New items default --parent to it (override with --parent or clear via 'pm focus --clear').`,\n  };\n}\n\nasync function resolveFocusedTitle(pmRoot: string, id: string): Promise<string | null> {\n  // The tracker is already known to be initialized (ensureInitialized ran), so\n  // readSettings/locateItem behave like the `pm get` read path: a deleted/stale\n  // focused item simply locates to null and yields no title hint.\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    return null;\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  return nonEmptyTitleOrNull(loaded.document.metadata.title);\n}\n\nfunction nonEmptyTitleOrNull(title: string): string | null {\n  return title.trim().length > 0 ? title : null;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,eAAe,kBAAkB,QAAc;AAC7C,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AACF;AAKA,eAAsB,SACpB,IACA,SACAA,SAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,QAAM,kBAAkB,MAAM;AAE9B,QAAM,QAAQ,QAAQ,UAAU;AAEhC,MAAI,OAAO;AACT,QAAI,OAAO,QAAW;AACpB,YAAM,IAAI,WACR,kHACA,UAAU,KAAK;IAEnB;AACA,UAAM,iBAAiB,MAAM;AAC7B,WAAO;MACL,QAAQ;MACR,cAAc;MACd,OAAO;MACP,SAAS;;EAEb;AAEA,MAAI,OAAO,QAAW;AACpB,UAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,QAAI,YAAY,QAAW;AACzB,aAAO;QACL,QAAQ;QACR,cAAc;QACd,OAAO;QACP,SAAS;;IAEb;AACA,UAAMC,SAAQ,MAAM,oBAAoB,QAAQ,OAAO;AACvD,WAAO;MACL,QAAQ;MACR,cAAc;MACd,OAAAA;MACA,SAAS,cAAc,OAAO,GAAGA,SAAQ,KAAKA,MAAK,MAAM,EAAE;;EAE/D;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,aAAa,cAAc;AAClH,MAAI,CAAC,SAAS;AACZ,UAAM,MAAM,uBAAuB,QAAQ,IAAI,SAAS,WAAW,aAAa,cAAc;EAChG;AACA,QAAM,eAAe,gBAAgB,QAAQ,IAAI,SAAS,SAAS;AACnE,QAAM,SAAS,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AACzE,QAAM,QAAQ,oBAAoB,OAAO,SAAS,SAAS,KAAK;AAChE,QAAM,eAAe,QAAQ,YAAY;AACzC,SAAO;IACL,QAAQ;IACR,cAAc;IACd;IACA,SAAS,cAAc,YAAY,GAAG,QAAQ,KAAK,KAAK,MAAM,EAAE;;AAEpE;AAEA,eAAe,oBAAoB,QAAgB,IAAU;AAI3D,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,aAAa,cAAc;AAClH,MAAI,CAAC,SAAS;AACZ,WAAO;EACT;AACA,QAAM,SAAS,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AACzE,SAAO,oBAAoB,OAAO,SAAS,SAAS,KAAK;AAC3D;AAEA,SAAS,oBAAoB,OAAa;AACxC,SAAO,MAAM,KAAI,EAAG,SAAS,IAAI,QAAQ;AAC3C;",
-  "names": ["global", "title"]
-}