@unbrained/pm-cli 2026.7.13 → 2026.7.14

package/dist/cli-bundle/chunks/{chunk-UTYNQ2WH.js → chunk-FS6UM5WH.js}

@@ -4,7 +4,7 @@ import {
   renameArtifactsResultKey,
   runLinkedArtifacts,
   sortLinkedArtifacts
-} from "./chunk-DGJF32JF.js";
+} from "./chunk-FIGXOCEQ.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -14,7 +14,7 @@ import {
   mutateItem,
   readLocatedItem,
   readSettings
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -22,19 +22,21 @@ import {
   isPathWithinDirectory,
   pathExists,
   resolveItemTypeRegistry,
-  resolvePmRoot
-} from "./chunk-XY3CC3EM.js";
+  resolvePmRoot,
+  resolveWorkspaceRoot
+} from "./chunk-AFWZRL7M.js";
 
-// dist/cli/commands/files.js
+// dist/sdk/files.js
 import fs from "node:fs/promises";
 import path from "node:path";
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3a8f4027-c8bd-5e07-ba5f-edcf43224e09");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "908d2bc5-1c0d-5e33-9b0a-1ac7ae9b687f");
   } catch (e2) {
   }
 })();
+var RELATIVE_REFERENCE_SCAN_MAX_CHARS = 32768;
 function normalizeCandidatePathForOutput(value) {
   return normalizeLinkedPath(path.normalize(value));
 }
@@ -88,10 +90,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;
         }
@@ -102,8 +108,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);
@@ -114,7 +120,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)) {
@@ -132,16 +138,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,
@@ -172,6 +185,7 @@ async function discoverReferencedFiles(document, projectRoot) {
   });
 }
 var _testOnly = {
+  relativeReferenceScanMaxChars: RELATIVE_REFERENCE_SCAN_MAX_CHARS,
   normalizeCandidatePathForOutput,
   realpathForContainment,
   linkedFileResolvedKey,
@@ -193,6 +207,7 @@ async function runFiles(id, options, global2) {
 }
 async function runFilesDiscover(id, options, global2) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.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);
   }
@@ -203,7 +218,7 @@ async function runFilesDiscover(id, options, global2) {
     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;
@@ -231,6 +246,8 @@ async function runFilesDiscover(id, options, global2) {
     scope: candidate.scope,
     note
   }));
+  let appliedAdds = [];
+  const appliedCandidateIndices = /* @__PURE__ */ new Set();
   const result = await mutateItem({
     pmRoot,
     settings,
@@ -241,16 +258,18 @@ async function runFilesDiscover(id, options, global2) {
     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);
@@ -270,8 +289,10 @@ async function runFilesDiscover(id, options, global2) {
     }
   });
   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,
@@ -281,10 +302,10 @@ async function runFilesDiscover(id, options, global2) {
     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
   };
 }
 
@@ -293,4 +314,4 @@ export {
   runFiles,
   runFilesDiscover
 };
-//# sourceMappingURL=chunk-UTYNQ2WH.js.map
+//# sourceMappingURL=chunk-FS6UM5WH.js.map

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

@@ -0,0 +1,7 @@
+{
+  "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"],
+  "mappings": "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",
+  "names": ["global", "files"]
+}

package/dist/cli-bundle/chunks/{chunk-U252II47.js → chunk-FTQLW4JD.js}

@@ -11,7 +11,7 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-YFGYDZRP.js";
+} from "./chunk-2GA3NK35.js";
 import {
   acquireLock,
   canonicalDocument,
@@ -26,7 +26,7 @@ import {
   resolveGovernanceKnobs,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -38,7 +38,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/history-redact.js
 import fs2 from "node:fs/promises";
@@ -644,6 +644,6 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-U252II47.js.map
+//# sourceMappingURL=chunk-FTQLW4JD.js.map
 
 //# debugId=5fcd4453-ef12-5c65-8c44-65b8af0cd97f