@unbrained/pm-cli 2026.7.13 → 2026.7.14

package/dist/cli-bundle/chunks/{chunk-TGGTXC52.js → chunk-TH7U4KLY.js}

@@ -5,14 +5,14 @@ import {
   deleteItem,
   readSettings,
   toItemRecord
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/cli/commands/delete.js
 import path from "node:path";
@@ -52,4 +52,4 @@ async function runDelete(id, options, global2) {
 export {
   runDelete
 };
-//# sourceMappingURL=chunk-TGGTXC52.js.map
+//# sourceMappingURL=chunk-TH7U4KLY.js.map

package/dist/cli-bundle/chunks/{chunk-LP4UATP6.js → chunk-TWLDBKQU.js}

@@ -1,10 +1,10 @@
 import {
   normalizeItemId
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/item/parent-reference-policy.js
 !(function() {
@@ -107,4 +107,4 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-LP4UATP6.js.map
+//# sourceMappingURL=chunk-TWLDBKQU.js.map

package/dist/cli-bundle/chunks/{chunk-OTZ3C2NE.js → chunk-TZ2PSLLT.js}

@@ -1,12 +1,12 @@
 
-!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]="87c74fe9-9c49-5520-9658-60d42438cff2")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="584aa37d-a8a7-5b1c-83cc-06948ba76568")}catch(e){}}();
 import {
   dedupeLinkedArtifacts,
   normalizeLinkedPath,
   renameArtifactsResultKey,
   runLinkedArtifacts,
   sortLinkedArtifacts
-} from "./chunk-FCVVMAEX.js";
+} from "./chunk-P6MYFH6K.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -16,7 +16,7 @@ import {
   mutateItem,
   readLocatedItem,
   readSettings
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -24,12 +24,14 @@ import {
   isPathWithinDirectory,
   pathExists,
   resolveItemTypeRegistry,
-  resolvePmRoot
-} from "./chunk-TGG7YGMC.js";
+  resolvePmRoot,
+  resolveWorkspaceRoot
+} from "./chunk-GXXC7QSK.js";
 
-// dist/cli/commands/files.js
+// dist/sdk/files.js
 import fs from "node:fs/promises";
 import path from "node:path";
+var RELATIVE_REFERENCE_SCAN_MAX_CHARS = 32768;
 function normalizeCandidatePathForOutput(value) {
   return normalizeLinkedPath(path.normalize(value));
 }
@@ -83,10 +85,14 @@ function extractRawPathReferences(references) {
   const relativePattern = /(?:\.{1,2}[\\/])?(?:(?:[A-Za-z0-9_.@-]+[\\/])+[A-Za-z0-9_.@-]+|[A-Za-z0-9_.@-]+\.[A-Za-z0-9][A-Za-z0-9._-]*)/gu;
   for (const reference of references) {
     const seenInField = /* @__PURE__ */ new Set();
-    for (const pattern of [absolutePattern, relativePattern]) {
+    const boundedRelativeValue = reference.value.slice(0, RELATIVE_REFERENCE_SCAN_MAX_CHARS);
+    for (const [pattern, input] of [
+      [absolutePattern, reference.value],
+      [relativePattern, boundedRelativeValue]
+    ]) {
       pattern.lastIndex = 0;
-      for (const match of reference.value.matchAll(pattern)) {
-        const token = cleanupPathToken(match[0] ?? "");
+      for (const match of input.matchAll(pattern)) {
+        const token = cleanupPathToken(match[0]);
         if (!token || seenInField.has(token)) {
           continue;
         }
@@ -97,8 +103,8 @@ function extractRawPathReferences(references) {
   }
   return rawReferences;
 }
-async function resolveDiscoveredFile(rawPath, projectRoot) {
-  const absolutePath = path.isAbsolute(rawPath) ? path.resolve(rawPath) : path.resolve(projectRoot, rawPath);
+async function resolveDiscoveredFile(rawPath, workspaceRoot, invocationRoot = workspaceRoot) {
+  const absolutePath = path.isAbsolute(rawPath) ? path.resolve(rawPath) : path.resolve(invocationRoot, rawPath);
   let stats;
   try {
     stats = await fs.stat(absolutePath);
@@ -109,7 +115,7 @@ async function resolveDiscoveredFile(rawPath, projectRoot) {
     return void 0;
   }
   const [canonicalProjectRoot, canonicalAbsolutePath] = await Promise.all([
-    realpathForContainment(projectRoot),
+    realpathForContainment(workspaceRoot),
     realpathForContainment(absolutePath)
   ]);
   if (isPathWithinDirectory(canonicalProjectRoot, canonicalAbsolutePath)) {
@@ -127,16 +133,23 @@ async function resolveDiscoveredFile(rawPath, projectRoot) {
     scope: "global"
   };
 }
-async function discoverReferencedFiles(document, projectRoot) {
-  const existingResolvedKeys = new Set((document.metadata.files ?? []).map((entry) => linkedFileResolvedKey(entry, projectRoot)));
+async function discoverReferencedFiles(document, workspaceRoot, invocationRoot = workspaceRoot) {
+  const existingResolvedKeys = new Set((document.metadata.files ?? []).map((entry) => linkedFileResolvedKey(entry, workspaceRoot)));
   const grouped = /* @__PURE__ */ new Map();
   const rawReferences = extractRawPathReferences(collectItemTextReferences(document));
-  for (const reference of rawReferences) {
-    const resolved = await resolveDiscoveredFile(reference.value, projectRoot);
+  const resolvedByValue = /* @__PURE__ */ new Map();
+  await Promise.all([...new Set(rawReferences.map((reference) => reference.value))].map(async (value) => {
+    resolvedByValue.set(value, await resolveDiscoveredFile(value, workspaceRoot, invocationRoot));
+  }));
+  const resolvedReferences = rawReferences.map((reference) => ({
+    reference,
+    resolved: resolvedByValue.get(reference.value)
+  }));
+  for (const { reference, resolved } of resolvedReferences) {
     if (!resolved) {
       continue;
     }
-    const key = linkedFileResolvedKey(resolved, projectRoot);
+    const key = linkedFileResolvedKey(resolved, workspaceRoot);
     const existing = grouped.get(key) ?? {
       path: resolved.path,
       scope: resolved.scope,
@@ -167,6 +180,7 @@ async function discoverReferencedFiles(document, projectRoot) {
   });
 }
 var _testOnly = {
+  relativeReferenceScanMaxChars: RELATIVE_REFERENCE_SCAN_MAX_CHARS,
   normalizeCandidatePathForOutput,
   realpathForContainment,
   linkedFileResolvedKey,
@@ -188,6 +202,7 @@ async function runFiles(id, options, global) {
 }
 async function runFilesDiscover(id, options, global) {
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  const workspaceRoot = resolveWorkspaceRoot(pmRoot);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
   }
@@ -198,7 +213,7 @@ async function runFilesDiscover(id, options, global) {
     throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
   }
   const loaded = await readLocatedItem(located, { schema: settings.schema });
-  const candidates = await discoverReferencedFiles(loaded.document, process.cwd());
+  const candidates = await discoverReferencedFiles(loaded.document, workspaceRoot, process.cwd());
   const addableCandidates = candidates.filter((candidate) => candidate.status === "addable");
   const skippedExisting = candidates.filter((candidate) => candidate.status === "already_linked");
   const requestedApply = options.apply === true;
@@ -226,6 +241,8 @@ async function runFilesDiscover(id, options, global) {
     scope: candidate.scope,
     note
   }));
+  let appliedAdds = [];
+  const appliedCandidateIndices = /* @__PURE__ */ new Set();
   const result = await mutateItem({
     pmRoot,
     settings,
@@ -236,16 +253,18 @@ async function runFilesDiscover(id, options, global) {
     force: options.force,
     mutate(document) {
       const next = [...document.metadata.files ?? []];
-      const existingResolvedKeys = new Set(next.map((entry) => linkedFileResolvedKey(entry, process.cwd())));
-      const appliedAdds = [];
-      for (const add of discoveredAdds) {
-        const resolvedKey = linkedFileResolvedKey(add, process.cwd());
+      const existingResolvedKeys = new Set(next.map((entry) => linkedFileResolvedKey(entry, workspaceRoot)));
+      appliedAdds = [];
+      appliedCandidateIndices.clear();
+      for (const [index, add] of discoveredAdds.entries()) {
+        const resolvedKey = linkedFileResolvedKey(add, workspaceRoot);
         if (existingResolvedKeys.has(resolvedKey)) {
           continue;
         }
         next.push(add);
         existingResolvedKeys.add(resolvedKey);
         appliedAdds.push(add);
+        appliedCandidateIndices.add(index);
       }
       const deduped = dedupeLinkedArtifacts(next);
       const normalized = options.appendStable ? deduped : sortLinkedArtifacts(deduped);
@@ -265,8 +284,10 @@ async function runFilesDiscover(id, options, global) {
     }
   });
   const files = result.item.files ?? [];
-  const addedResolvedKeys = new Set(discoveredAdds.map((entry) => linkedFileResolvedKey(entry, process.cwd())));
-  const added = files.filter((entry) => addedResolvedKeys.has(linkedFileResolvedKey(entry, process.cwd())));
+  const addedResolvedKeys = new Set(appliedAdds.map((entry) => linkedFileResolvedKey(entry, workspaceRoot)));
+  const added = files.filter((entry) => addedResolvedKeys.has(linkedFileResolvedKey(entry, workspaceRoot)));
+  const skippedDuringApply = addableCandidates.filter((_candidate, index) => !appliedCandidateIndices.has(index));
+  const allSkippedExisting = [...skippedExisting, ...skippedDuringApply];
   return {
     id: result.item.id,
     files,
@@ -276,10 +297,10 @@ async function runFilesDiscover(id, options, global) {
     candidate_count: candidates.length,
     addable_count: addableCandidates.length,
     added_count: added.length,
-    skipped_existing_count: skippedExisting.length,
+    skipped_existing_count: allSkippedExisting.length,
     candidates,
     added,
-    skipped_existing: skippedExisting
+    skipped_existing: allSkippedExisting
   };
 }
 
@@ -288,6 +309,6 @@ export {
   runFiles,
   runFilesDiscover
 };
-//# sourceMappingURL=chunk-OTZ3C2NE.js.map
+//# sourceMappingURL=chunk-TZ2PSLLT.js.map
 
-//# debugId=87c74fe9-9c49-5520-9658-60d42438cff2
+//# debugId=584aa37d-a8a7-5b1c-83cc-06948ba76568

package/dist/cli-bundle/chunks/chunk-TZ2PSLLT.js.map

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

package/dist/cli-bundle/chunks/{chunk-UK222BHQ.js → chunk-TZRTLMWM.js}

@@ -2,7 +2,7 @@
 !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]="995076bc-3f7f-5d6c-ba7e-30c43a08674c")}catch(e){}}();
 import {
   collectBlockedByIds
-} from "./chunk-KR5EHAN4.js";
+} from "./chunk-X3GYR4P2.js";
 import {
   buildItemNotFoundError,
   isTerminalStatus,
@@ -12,7 +12,7 @@ import {
   readLocatedItem,
   readSettings,
   toItemRecord
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -21,7 +21,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/close.js
 function toAuthor(candidate, defaultAuthor) {
@@ -458,6 +458,6 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-UK222BHQ.js.map
+//# sourceMappingURL=chunk-TZRTLMWM.js.map
 
 //# debugId=995076bc-3f7f-5d6c-ba7e-30c43a08674c

package/dist/cli-bundle/chunks/{chunk-6E6S2X6S.js → chunk-UB2QYSTO.js}

@@ -7,7 +7,7 @@ import {
   lintProjectProfile,
   resolveProfileCatalog,
   resolveProfileEntry
-} from "./chunk-CJVQ4XIG.js";
+} from "./chunk-HAMLIWAF.js";
 import {
   parseNestedSettingValue,
   readNestedSettingValue,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-DJAGYYCQ.js";
 import {
   ensureTypeFolderScaffold
-} from "./chunk-S6CXUSYC.js";
+} from "./chunk-UGTVWL3E.js";
 import {
   normalizeAddFieldInput,
   normalizeAddStatusInput,
@@ -26,16 +26,16 @@ import {
   serializeStatusDefsFile,
   upsertField,
   upsertStatusDef
-} from "./chunk-AHA4POA6.js";
+} from "./chunk-ABRCOSDC.js";
 import {
   CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS
-} from "./chunk-GQ2CQNGI.js";
+} from "./chunk-N3CMP4NI.js";
 import {
   normalizeAddTypeInput,
   parseItemTypesFile,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-3P3RFJIQ.js";
+} from "./chunk-3TL7WOEF.js";
 import {
   acquireLock,
   getActiveExtensionRegistrations,
@@ -44,7 +44,7 @@ import {
   resolveGovernanceKnobs,
   runActiveOnWriteHooks,
   writeSettings
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -56,7 +56,7 @@ import {
   readFileIfExists,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/profile.js
 import path2 from "node:path";
@@ -832,6 +832,6 @@ export {
   formatProfileLintHuman,
   formatProfileApplyHuman
 };
-//# sourceMappingURL=chunk-6E6S2X6S.js.map
+//# sourceMappingURL=chunk-UB2QYSTO.js.map
 
 //# debugId=a881d2f4-ed91-55ba-b881-706e0f472cd0

package/dist/cli-bundle/chunks/{chunk-S6CXUSYC.js → chunk-UGTVWL3E.js}

@@ -18,7 +18,7 @@ import {
   serializeStatusDefsFile,
   upsertField,
   upsertStatusDef
-} from "./chunk-AHA4POA6.js";
+} from "./chunk-ABRCOSDC.js";
 import {
   assertAliasesAvailable,
   assertTypeFolderAvailable,
@@ -29,7 +29,7 @@ import {
   removeItemType,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-3P3RFJIQ.js";
+} from "./chunk-3TL7WOEF.js";
 import {
   acquireLock,
   getActiveExtensionRegistrations,
@@ -38,7 +38,7 @@ import {
   readSettings,
   resolveGovernanceKnobs,
   runActiveOnWriteHooks
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -54,7 +54,7 @@ import {
   resolveRuntimeStatusRegistry,
   toDefaultFolder,
   writeFileAtomic
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/schema.js
 import path from "node:path";
@@ -1234,6 +1234,6 @@ export {
   formatSchemaInferTypesHuman,
   _testOnlySchemaCommand
 };
-//# sourceMappingURL=chunk-S6CXUSYC.js.map
+//# sourceMappingURL=chunk-UGTVWL3E.js.map
 
 //# debugId=46e1dd18-6b92-508e-98ca-4914b8c2edc5

package/dist/cli-bundle/chunks/{chunk-BNS6QHTZ.js → chunk-UJ4HJYWL.js}

@@ -1,7 +1,7 @@
 import {
   isTerminalStatus,
   normalizeStatusForRegistry
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 
 // dist/core/item/actionability.js
 !(function() {
@@ -129,4 +129,4 @@ export {
   collectBlockedByIds,
   computeActionabilityReport
 };
-//# sourceMappingURL=chunk-BNS6QHTZ.js.map
+//# sourceMappingURL=chunk-UJ4HJYWL.js.map

package/dist/cli-bundle/chunks/{chunk-BYVOEJPQ.js → chunk-UKUIIBDW.js}

@@ -9,15 +9,15 @@ import {
   TYPE_PRESET_DEFINITIONS,
   normalizeAddFieldInput,
   normalizeAddStatusInput
-} from "./chunk-2QNOWOIB.js";
+} from "./chunk-DO5RGJXT.js";
 import {
   normalizeAddTypeInput
-} from "./chunk-KQJVTQVK.js";
+} from "./chunk-ANSJHDOZ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   toErrorMessage
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/profile/profile-presets.js
 !(function() {
@@ -680,4 +680,4 @@ export {
   PROFILE_LINT_CODES,
   lintProjectProfile
 };
-//# sourceMappingURL=chunk-BYVOEJPQ.js.map
+//# sourceMappingURL=chunk-UKUIIBDW.js.map

package/dist/cli-bundle/chunks/{chunk-SGDBVR7X.js → chunk-UVBA6F5A.js}

@@ -4,7 +4,7 @@ import {
   parseAnnotationTextInput,
   resolveAnnotationInput,
   runAnnotationCommand
-} from "./chunk-BVCF4ULV.js";
+} from "./chunk-4RXTMU57.js";
 
 // dist/cli/commands/learnings.js
 async function runLearnings(id, options, global) {
@@ -30,6 +30,6 @@ async function runLearnings(id, options, global) {
 export {
   runLearnings
 };
-//# sourceMappingURL=chunk-SGDBVR7X.js.map
+//# sourceMappingURL=chunk-UVBA6F5A.js.map
 
 //# debugId=1bec9be5-4967-5914-933d-cf3ebd310ca5

package/dist/cli-bundle/chunks/{chunk-DZRZMBBF.js → chunk-VJTAEIPC.js}

@@ -3,11 +3,11 @@ import {
 } from "./chunk-YRYYFGV3.js";
 import {
   parseLimit
-} from "./chunk-OWW2KXOV.js";
+} from "./chunk-YQYG2V23.js";
 import {
   createStdinTokenResolver,
   parseCsvKv
-} from "./chunk-HR2MQAO5.js";
+} from "./chunk-WD6MSYMP.js";
 import {
   getActiveExtensionRegistrations,
   locateItem,
@@ -15,7 +15,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -23,7 +23,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/sdk/annotations.js
 import { readFile } from "node:fs/promises";
@@ -313,4 +313,4 @@ export {
   runAnnotationCommand,
   resolveAnnotationIndex
 };
-//# sourceMappingURL=chunk-DZRZMBBF.js.map
+//# sourceMappingURL=chunk-VJTAEIPC.js.map

package/dist/cli-bundle/chunks/{chunk-74PWVJON.js → chunk-W6HZ55JO.js}

@@ -1,6 +1,6 @@
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/governance/metadata-coverage.js
 !(function() {
@@ -262,4 +262,4 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-74PWVJON.js.map
+//# sourceMappingURL=chunk-W6HZ55JO.js.map

package/dist/cli-bundle/chunks/{chunk-HR2MQAO5.js → chunk-WD6MSYMP.js}

@@ -1,13 +1,13 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/item/parse.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] = "8763cf00-d6d8-5e91-94d2-f65fb3321909");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "fb39edac-1965-5a52-9c0c-c4330fe3a8c7");
   } catch (e2) {
   }
 })();
@@ -345,6 +345,14 @@ function parseOptionalNumber(raw, optionName) {
   }
   return value;
 }
+function parseOptionalNonNegativeInteger(raw, optionName) {
+  const trimmed = raw.trim();
+  const value = Number(trimmed);
+  if (trimmed === "" || !Number.isInteger(value) || value < 0) {
+    throw new PmCliError(`Invalid ${optionName} value "${raw}". Expected a non-negative integer.`, EXIT_CODE.USAGE);
+  }
+  return value;
+}
 
 export {
   parseTags,
@@ -354,6 +362,7 @@ export {
   looksLikeGenericKeyValueEntry,
   assertNoUnknownCsvKeys,
   createStdinTokenResolver,
-  parseOptionalNumber
+  parseOptionalNumber,
+  parseOptionalNonNegativeInteger
 };
-//# sourceMappingURL=chunk-HR2MQAO5.js.map
+//# sourceMappingURL=chunk-WD6MSYMP.js.map