@unbrained/pm-cli 2026.7.13 → 2026.7.14

package/dist/cli-bundle/chunks/{chunk-H36FXA7B.js → chunk-DYEX6NFH.js}

@@ -9,7 +9,7 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-XMI2TRY5.js";
+} from "./chunk-4WREH7RT.js";
 import {
   acquireLock,
   canonicalDocument,
@@ -24,7 +24,7 @@ import {
   resolveGovernanceKnobs,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -36,7 +36,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/cli/commands/history-redact.js
 import fs2 from "node:fs/promises";
@@ -656,4 +656,4 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-H36FXA7B.js.map
+//# sourceMappingURL=chunk-DYEX6NFH.js.map

package/dist/cli-bundle/chunks/{chunk-G3IB5GTD.js → chunk-E2WC6S4P.js}

@@ -3,13 +3,13 @@ import {
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-L3VKY6R6.js";
+} from "./chunk-RA5AIAMP.js";
 import {
   runRestore
-} from "./chunk-WVUXNIYO.js";
+} from "./chunk-Q37E63AM.js";
 import {
   runUpdate
-} from "./chunk-5WEYOVZ7.js";
+} from "./chunk-OBDLEQG5.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -18,18 +18,19 @@ import {
 } from "./chunk-KWYX6ZIR.js";
 import {
   runList
-} from "./chunk-SRQLQUO6.js";
+} from "./chunk-6MHSBDGD.js";
 import {
   resolvePriority
-} from "./chunk-VL4LYTJN.js";
+} from "./chunk-OI4S4KCI.js";
 import {
   applyTagRemovals,
   mergeAdditiveTags,
+  parseOptionalNonNegativeInteger,
   parseTags
-} from "./chunk-HR2MQAO5.js";
+} from "./chunk-WD6MSYMP.js";
 import {
   buildInvalidTypeError
-} from "./chunk-KQJVTQVK.js";
+} from "./chunk-ANSJHDOZ.js";
 import {
   collectRuntimeUpdateFieldValues,
   getActiveExtensionRegistrations,
@@ -39,7 +40,7 @@ import {
   resolveIsoOrRelative,
   stableValueEquals,
   toItemRecord
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -52,13 +53,13 @@ import {
   resolveRuntimeStatusRegistry,
   resolveTypeName,
   toErrorMessage
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/cli/commands/update-many.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] = "aee29c00-c350-5f1d-9ad7-129538e5cf1a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "66fd8f1d-25f8-55fc-85ea-ea3000479f01");
   } catch (e2) {
   }
 })();
@@ -456,6 +457,9 @@ function assertPlannedUpdateValuesValid(update, settings, statusRegistry, pmRoot
   if (update.deadline !== void 0) {
     resolveIsoOrRelative(update.deadline, /* @__PURE__ */ new Date(), "deadline");
   }
+  if (update.estimatedMinutes !== void 0) {
+    parseOptionalNonNegativeInteger(update.estimatedMinutes, "estimated-minutes");
+  }
 }
 async function runUpdateManyRollback(params) {
   const checkpoint = await loadMutationCheckpoint(params.pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, params.rollbackId, UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION);
@@ -649,4 +653,4 @@ export {
   runUpdateMany,
   _testOnlyUpdateManyCommand
 };
-//# sourceMappingURL=chunk-G3IB5GTD.js.map
+//# sourceMappingURL=chunk-E2WC6S4P.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/update-many.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/update-many\n *\n * Implements the pm update many command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  createCheckpointId,\n  loadMutationCheckpoint,\n  restoreCheckpointItems,\n  writeMutationCheckpoint,\n  type MutationCheckpointItem,\n} from \"../../core/checkpoint/mutation-checkpoint.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport {\n  applyTagRemovals,\n  mergeAdditiveTags,\n  parseOptionalNonNegativeInteger,\n  parseTags,\n} from \"../../core/item/parse.js\";\nimport { resolvePriority } from \"../../core/item/priority.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport {\n  resolveItemTypeRegistry,\n  resolveTypeName,\n} from \"../../core/item/type-registry.js\";\nimport { collectRuntimeUpdateFieldValues } from \"../../core/schema/runtime-field-values.js\";\nimport { buildInvalidTypeError } from \"../../core/schema/item-types-file.js\";\nimport {\n  resolveItemTypesFilePath,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  type RuntimeFieldRegistry,\n  type RuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.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 { toErrorMessage } from \"../../core/shared/primitives.js\";\nimport { stableValueEquals } from \"../../core/shared/serialization.js\";\nimport { nowIso, resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport type { PmSettings } from \"../../types/index.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { ItemStatus } from \"../../types/index.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\nimport { runUpdate, type UpdateCommandOptions } from \"./update.js\";\n\nconst UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst UPDATE_MANY_CHECKPOINT_SUBDIR = \"update-many\";\n\nconst NON_MUTATION_UPDATE_OPTION_KEYS = new Set<PropertyKey>([\n  \"author\",\n  \"message\",\n  \"force\",\n  \"ownershipMetadataBypass\",\n  \"ownershipDependencyBypass\",\n]);\n\nconst UPDATE_MANY_MUTATION_FLAG_GUIDANCE = [\n  \"--status\",\n  \"--priority\",\n  \"--type\",\n  \"--tags\",\n  \"--description\",\n  \"--body\",\n  \"--deadline\",\n  \"--estimate\",\n  \"--assignee\",\n  \"--dep\",\n  \"--dep-remove\",\n  \"--comment\",\n  \"--note\",\n  \"--learning\",\n  \"--file\",\n  \"--test\",\n  \"--doc\",\n  \"--replace-deps\",\n  \"--replace-tests\",\n  \"--unset\",\n  \"--clear-*\",\n].join(\", \");\n\nconst UPDATE_OPTION_TO_ITEM_KEY: Partial<\n  Record<keyof UpdateCommandOptions, string>\n> = {\n  title: \"title\",\n  description: \"description\",\n  body: \"body\",\n  status: \"status\",\n  closeReason: \"close_reason\",\n  priority: \"priority\",\n  type: \"type\",\n  deadline: \"deadline\",\n  estimatedMinutes: \"estimated_minutes\",\n  acceptanceCriteria: \"acceptance_criteria\",\n  definitionOfReady: \"definition_of_ready\",\n  order: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  whyNow: \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blockedBy: \"blocked_by\",\n  blockedReason: \"blocked_reason\",\n  unblockNote: \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  reproSteps: \"repro_steps\",\n  resolution: \"resolution\",\n  expectedResult: \"expected_result\",\n  actualResult: \"actual_result\",\n  affectedVersion: \"affected_version\",\n  fixedVersion: \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customerImpact: \"customer_impact\",\n};\n\ninterface CollectionMutationPlanDefinition {\n  field: string;\n  addKey: keyof UpdateCommandOptions;\n  removeKey?: keyof UpdateCommandOptions;\n  clearKey: keyof UpdateCommandOptions;\n  replaceKey?: keyof UpdateCommandOptions;\n}\n\nconst COLLECTION_MUTATION_PLAN_DEFINITIONS: CollectionMutationPlanDefinition[] =\n  [\n    {\n      field: \"dependencies\",\n      addKey: \"dep\",\n      removeKey: \"depRemove\",\n      clearKey: \"clearDeps\",\n      replaceKey: \"replaceDeps\",\n    },\n    {\n      field: \"comments\",\n      addKey: \"comment\",\n      clearKey: \"clearComments\",\n    },\n    {\n      field: \"notes\",\n      addKey: \"note\",\n      clearKey: \"clearNotes\",\n    },\n    {\n      field: \"learnings\",\n      addKey: \"learning\",\n      clearKey: \"clearLearnings\",\n    },\n    {\n      field: \"files\",\n      addKey: \"file\",\n      clearKey: \"clearFiles\",\n    },\n    {\n      field: \"tests\",\n      addKey: \"test\",\n      clearKey: \"clearTests\",\n      replaceKey: \"replaceTests\",\n    },\n    {\n      field: \"docs\",\n      addKey: \"doc\",\n      clearKey: \"clearDocs\",\n    },\n    {\n      field: \"reminders\",\n      addKey: \"reminder\",\n      clearKey: \"clearReminders\",\n    },\n    {\n      field: \"events\",\n      addKey: \"event\",\n      clearKey: \"clearEvents\",\n    },\n    {\n      field: \"type_options\",\n      addKey: \"typeOption\",\n      clearKey: \"clearTypeOptions\",\n    },\n  ];\n\nconst UNSET_FIELD_ALIASES: Record<string, string> = {\n  close_reason: \"close_reason\",\n  \"close-reason\": \"close_reason\",\n  deadline: \"deadline\",\n  estimate: \"estimated_minutes\",\n  estimated_minutes: \"estimated_minutes\",\n  \"estimated-minutes\": \"estimated_minutes\",\n  acceptance_criteria: \"acceptance_criteria\",\n  \"acceptance-criteria\": \"acceptance_criteria\",\n  ac: \"acceptance_criteria\",\n  definition_of_ready: \"definition_of_ready\",\n  \"definition-of-ready\": \"definition_of_ready\",\n  order: \"order\",\n  rank: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  why_now: \"why_now\",\n  \"why-now\": \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blocked_by: \"blocked_by\",\n  \"blocked-by\": \"blocked_by\",\n  blocked_reason: \"blocked_reason\",\n  \"blocked-reason\": \"blocked_reason\",\n  unblock_note: \"unblock_note\",\n  \"unblock-note\": \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  repro_steps: \"repro_steps\",\n  \"repro-steps\": \"repro_steps\",\n  resolution: \"resolution\",\n  expected_result: \"expected_result\",\n  \"expected-result\": \"expected_result\",\n  actual_result: \"actual_result\",\n  \"actual-result\": \"actual_result\",\n  affected_version: \"affected_version\",\n  \"affected-version\": \"affected_version\",\n  fixed_version: \"fixed_version\",\n  \"fixed-version\": \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customer_impact: \"customer_impact\",\n  \"customer-impact\": \"customer_impact\",\n  type_options: \"type_options\",\n  \"type-options\": \"type_options\",\n  tags: \"tags\",\n};\n\ninterface UpdateManyCheckpoint {\n  schema_version: number;\n  id: string;\n  created_at: string;\n  author: string;\n  status_filter: string | null;\n  list_filters: Record<string, unknown>;\n  update_options: Record<string, unknown>;\n  items: MutationCheckpointItem[];\n}\n\n/** Documents the update many command options payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyCommandOptions {\n  /** Lifecycle state reported for status. */\n  status?: string;\n  /** Value that configures or reports list for this contract. */\n  list: ListOptions;\n  /** Value that configures or reports update for this contract. */\n  update: UpdateCommandOptions;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports rollback for this contract. */\n  rollback?: string;\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: boolean;\n}\n\ninterface PlannedChange {\n  field: string;\n  before: unknown;\n  after: unknown;\n}\n\ninterface PlannedItemDiff {\n  id: string;\n  changes: PlannedChange[];\n}\n\ninterface UpdateManyApplyResultRow {\n  id: string;\n  status: \"updated\" | \"failed\" | \"skipped\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface UpdateManyRollbackResultRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\n/** Documents the update many result payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyResult {\n  /** Value that configures or reports mode for this contract. */\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  /** Number of matched entries represented by this result. */\n  matched_count: number;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports filters for this contract. */\n  filters?: Record<string, unknown>;\n  /** Inputs that customize the planned update operation. */\n  planned_update_options?: Record<string, unknown>;\n  /** Value that configures or reports item plans for this contract. */\n  item_plans?: PlannedItemDiff[];\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  /** Number of updated entries represented by this result. */\n  updated_count?: number;\n  /** Number of skipped entries represented by this result. */\n  skipped_count?: number;\n  /** Number of failed entries represented by this result. */\n  failed_count?: number;\n  /** Number of restored entries represented by this result. */\n  restored_count?: number;\n  /** Value that configures or reports rollback checkpoint id for this contract. */\n  rollback_checkpoint_id?: string;\n  /** Value that configures or reports rows for this contract. */\n  rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];\n  /** Value that configures or reports ids for this contract. */\n  ids: string[];\n}\n\nfunction sanitizeUpdateOptionsForSummary(\n  options: UpdateCommandOptions,\n): Record<string, unknown> {\n  const summary: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options) as Array<\n    [keyof UpdateCommandOptions, unknown]\n  >) {\n    if (NON_MUTATION_UPDATE_OPTION_KEYS.has(key)) {\n      continue;\n    }\n    if (value === undefined) {\n      continue;\n    }\n    summary[key] = value;\n  }\n  return summary;\n}\n\nfunction hasAnyUpdateMutationInput(options: UpdateCommandOptions): boolean {\n  return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;\n}\n\nfunction toComparablePreviewValue(\n  optionKey: keyof UpdateCommandOptions,\n  value: unknown,\n): unknown {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (optionKey === \"priority\") {\n    const parsed = Number(String(value).trim());\n    return Number.isInteger(parsed) ? parsed : String(value).trim();\n  }\n  if (\n    optionKey === \"estimatedMinutes\" ||\n    optionKey === \"order\" ||\n    optionKey === \"rank\"\n  ) {\n    const parsed = Number(String(value).trim());\n    return Number.isFinite(parsed) ? parsed : String(value).trim();\n  }\n  if (optionKey === \"regression\") {\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  if (typeof value === \"string\") {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction normalizeUnsetField(rawField: string): string {\n  const normalized = rawField.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  return UNSET_FIELD_ALIASES[normalized] ?? normalized;\n}\n\nfunction areValuesEqual(left: unknown, right: unknown): boolean {\n  return stableValueEquals(left, right);\n}\n\nfunction normalizeCollectionBeforeValue(\n  field: string,\n  value: unknown,\n): unknown {\n  if (value !== undefined) {\n    return value;\n  }\n  if (field === \"type_options\") {\n    return {};\n  }\n  return [];\n}\n\nfunction collectionValueCount(field: string, value: unknown): number {\n  if (Array.isArray(value)) {\n    return value.length;\n  }\n  if (field === \"type_options\" && value && typeof value === \"object\") {\n    return Object.keys(value as Record<string, unknown>).length;\n  }\n  return 0;\n}\n\nfunction buildCollectionMutationPlans(\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange[] {\n  const changes: PlannedChange[] = [];\n  for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {\n    const addValues = update[definition.addKey];\n    const removeValues = definition.removeKey\n      ? update[definition.removeKey]\n      : undefined;\n    const addCount = Array.isArray(addValues) ? addValues.length : 0;\n    const removeCount = Array.isArray(removeValues) ? removeValues.length : 0;\n    const clear = update[definition.clearKey] === true;\n    const replace = definition.replaceKey\n      ? update[definition.replaceKey] === true\n      : false;\n    if (!clear && !replace && addCount === 0 && removeCount === 0) {\n      continue;\n    }\n\n    const before = normalizeCollectionBeforeValue(\n      definition.field,\n      row[definition.field],\n    );\n    const beforeCount = collectionValueCount(definition.field, before);\n    const operation = replace\n      ? \"replace\"\n      : clear\n        ? \"clear_or_reset\"\n        : removeCount > 0\n          ? \"merge_remove\"\n          : \"append\";\n    changes.push({\n      field: definition.field,\n      before,\n      after: {\n        operation,\n        clear,\n        replace,\n        add_count: addCount,\n        remove_count: removeCount,\n        before_count: beforeCount,\n      },\n    });\n  }\n  return changes;\n}\n\nfunction normalizeExistingTags(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value.filter((tag): tag is string => typeof tag === \"string\");\n}\n\n// Tags support three mutation modes that compose: --tags replaces, --add-tags\n// extends, --remove-tags prunes. Replicate runUpdate's resolution order so the\n// dry-run preview and the apply-mode actionable detection both account for\n// additive/subtractive tag mutations (a --add-tags-only update must NOT be\n// treated as a no-op skip).\nfunction buildTagMutationPlan(\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange | undefined {\n  const hasReplace = update.tags !== undefined;\n  const hasAdd = Array.isArray(update.addTags) && update.addTags.length > 0;\n  const hasRemove =\n    Array.isArray(update.removeTags) && update.removeTags.length > 0;\n  if (!hasReplace && !hasAdd && !hasRemove) {\n    return undefined;\n  }\n  const existing = normalizeExistingTags(row.tags);\n  const baseTags = hasReplace ? parseTags(update.tags as string) : existing;\n  const withAdditions = mergeAdditiveTags(baseTags, update.addTags);\n  const after = applyTagRemovals(withAdditions, update.removeTags)\n    .slice()\n    .sort((a, b) => a.localeCompare(b));\n  const before = existing.slice().sort((a, b) => a.localeCompare(b));\n  if (areValuesEqual(before, after)) {\n    return undefined;\n  }\n  return { field: \"tags\", before: existing, after };\n}\n\nfunction buildPlannedItemDiff(\n  item: ListedItem,\n  update: UpdateCommandOptions = {},\n  runtimeFieldRegistry: RuntimeFieldRegistry,\n): PlannedItemDiff {\n  const safeUpdate = update;\n  const row = toItemRecord(item);\n  const changes: PlannedChange[] = [];\n  const tagPlan = buildTagMutationPlan(row, safeUpdate);\n  if (tagPlan) {\n    changes.push(tagPlan);\n  }\n  for (const [optionKey, itemKey] of Object.entries(\n    UPDATE_OPTION_TO_ITEM_KEY,\n  ) as Array<[keyof UpdateCommandOptions, string]>) {\n    const candidate = safeUpdate[optionKey];\n    if (candidate === undefined) {\n      continue;\n    }\n    const before = row[itemKey];\n    const after = toComparablePreviewValue(optionKey, candidate);\n    if (areValuesEqual(before, after)) {\n      continue;\n    }\n    changes.push({\n      field: itemKey,\n      before,\n      after,\n    });\n  }\n  changes.push(...buildCollectionMutationPlans(row, safeUpdate));\n\n  const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(\n    safeUpdate as Record<string, unknown>,\n    runtimeFieldRegistry,\n    [\"update_many\"],\n  );\n  for (const [fieldKey, fieldValue] of Object.entries(runtimeFieldUpdates)) {\n    const before = row[fieldKey];\n    if (areValuesEqual(before, fieldValue)) {\n      continue;\n    }\n    changes.push({\n      field: fieldKey,\n      before,\n      after: fieldValue,\n    });\n  }\n\n  if (safeUpdate.unset && safeUpdate.unset.length > 0) {\n    for (const rawUnsetField of safeUpdate.unset) {\n      const field = normalizeUnsetField(rawUnsetField);\n      const before = row[field];\n      if (before === undefined) {\n        continue;\n      }\n      changes.push({\n        field,\n        before,\n        after: null,\n      });\n    }\n  }\n\n  return {\n    id: item.id,\n    changes,\n  };\n}\n\nfunction normalizeStatusFilter(\n  value: string | undefined,\n  statusRegistry: RuntimeStatusRegistry,\n): ItemStatus | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(value, statusRegistry);\n  if (!normalized) {\n    const allowedStatuses = statusRegistry.definitions.map(\n      (definition) => definition.id,\n    );\n    throw new PmCliError(\n      `Invalid --filter-status value \"${value}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction rejectBlankIdsFilter(list: ListOptions | undefined): void {\n  if (list?.ids != null && String(list.ids).trim().length === 0) {\n    throw new PmCliError(\n      \"--ids requires at least one non-empty item ID\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n// GH-256: validate planned scalar enum/format fields up front so a `--dry-run`\n// preview rejects globally-invalid values exactly as apply would (true\n// preview==apply parity), and so apply itself fails fast before creating an\n// orphan checkpoint. Only VALUE/ENUM/FORMAT correctness is checked here — these\n// are invalid regardless of the matched item. Per-item governance and\n// workflow-transition rules stay in the apply path (runUpdate). Each field is\n// validated only when the caller actually provided it, reusing the exact same\n// resolvers and error messages runUpdate raises so single/bulk/dry-run stay\n// consistent.\nfunction assertPlannedUpdateValuesValid(\n  update: UpdateCommandOptions,\n  settings: PmSettings,\n  statusRegistry: RuntimeStatusRegistry,\n  pmRoot: string,\n): void {\n  if (update.priority !== undefined) {\n    resolvePriority(update.priority);\n  }\n  if (update.type !== undefined) {\n    const typeRegistry = resolveItemTypeRegistry(\n      settings,\n      getActiveExtensionRegistrations(),\n    );\n    if (!resolveTypeName(update.type, typeRegistry)) {\n      throw new PmCliError(\n        buildInvalidTypeError(\n          update.type,\n          typeRegistry.types,\n          resolveItemTypesFilePath(pmRoot, settings.schema),\n        ),\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  if (\n    update.status !== undefined &&\n    !normalizeStatusInput(update.status, statusRegistry)\n  ) {\n    const allowedStatuses = statusRegistry.definitions.map(\n      (definition) => definition.id,\n    );\n    throw new PmCliError(\n      `Invalid --status value \"${update.status}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (update.deadline !== undefined) {\n    resolveIsoOrRelative(update.deadline, new Date(), \"deadline\");\n  }\n  if (update.estimatedMinutes !== undefined) {\n    parseOptionalNonNegativeInteger(\n      update.estimatedMinutes,\n      \"estimated-minutes\",\n    );\n  }\n}\n\nasync function runUpdateManyRollback(params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<UpdateManyResult> {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage =\n    params.options.update?.message ??\n    `Rollback update-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(\n    checkpoint.items,\n    (id, targetUpdatedAt) =>\n      runRestore(\n        id,\n        targetUpdatedAt,\n        {\n          author: params.options.update?.author,\n          message: restoreMessage,\n          force: params.options.update?.force ?? true,\n        },\n        params.global,\n      ),\n  );\n  return {\n    mode: \"rollback\",\n    matched_count: checkpoint.items.length,\n    dry_run: false,\n    rollback_checkpoint_id: checkpoint.id,\n    checkpoint: {\n      id: checkpoint.id,\n      created_at: checkpoint.created_at,\n      path: checkpoint.path,\n      rollback_command: `pm update-many --rollback ${checkpoint.id}`,\n    },\n    restored_count: rollback.restored_ids.length,\n    failed_count: rollback.failed_count,\n    rows: rollback.rows,\n    ids: rollback.restored_ids,\n  };\n}\n\nasync function writeUpdateManyCheckpoint(params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: UpdateManyCommandOptions;\n  statusFilter: string | undefined;\n  filters: Record<string, unknown>;\n  updateSummary: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<UpdateManyResult[\"checkpoint\"]> {\n  const checkpointPayload: UpdateManyCheckpoint = {\n    schema_version: UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.update?.author, \"unknown\"),\n    status_filter: params.statusFilter ?? null,\n    list_filters: params.filters,\n    update_options: params.updateSummary,\n    items: params.checkpointItems,\n  };\n  const checkpointPath = await writeMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.checkpointId,\n    checkpointPayload,\n  );\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm update-many --rollback ${params.checkpointId}`,\n  };\n}\n\n/** Implements run update many for the public runtime surface of this module. */\nexport async function runUpdateMany(\n  options: UpdateManyCommandOptions,\n  global: GlobalOptions,\n): Promise<UpdateManyResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);\n\n  const dryRun = options.dryRun === true;\n  const rollbackId =\n    typeof options.rollback === \"string\" ? options.rollback : undefined;\n  const updateSummary = sanitizeUpdateOptionsForSummary(options.update);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId) {\n    if (dryRun) {\n      throw new PmCliError(\n        \"--dry-run cannot be combined with --rollback\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (hasListFilters(options.list, options.status)) {\n      throw new PmCliError(\n        \"Rollback mode does not accept filter options\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (Object.keys(updateSummary).length > 0) {\n      throw new PmCliError(\n        \"Rollback mode does not accept update mutation flags\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return runUpdateManyRollback({ pmRoot, rollbackId, options, global });\n  }\n\n  if (!hasAnyUpdateMutationInput(options.update)) {\n    throw new PmCliError(\n      `No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  // GH-256: validate planned scalar values before listing/checkpointing so\n  // dry-run previews and apply both reject globally-invalid enum/format input.\n  assertPlannedUpdateValuesValid(\n    options.update,\n    settings,\n    statusRegistry,\n    pmRoot,\n  );\n\n  const statusFilter = normalizeStatusFilter(options.status, statusRegistry);\n  const listed = await runList(\n    statusFilter,\n    { ...options.list, includeBody: true },\n    global,\n  );\n  const planned = listed.items.map((item) =>\n    buildPlannedItemDiff(item, options.update, runtimeFieldRegistry),\n  );\n  const actionable = planned.filter((row) => row.changes.length > 0);\n  if (dryRun) {\n    return {\n      mode: \"dry_run\",\n      matched_count: listed.items.length,\n      dry_run: true,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      item_plans: planned,\n      ids: [],\n    };\n  }\n\n  if (actionable.length === 0) {\n    return {\n      mode: \"apply\",\n      matched_count: listed.items.length,\n      dry_run: false,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      updated_count: 0,\n      skipped_count: listed.items.length,\n      failed_count: 0,\n      rows: planned.map((row) => ({\n        id: row.id,\n        status: \"skipped\" as const,\n      })),\n      ids: [],\n    };\n  }\n\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    nowValue,\n  );\n  const checkpointEnabled = options.checkpoint !== false;\n  const checkpointItems: MutationCheckpointItem[] = listed.items\n    .filter((item) => actionable.some((candidate) => candidate.id === item.id))\n    .map((item) => ({\n      id: item.id,\n      target_updated_at: item.updated_at,\n    }));\n\n  let checkpointInfo: UpdateManyResult[\"checkpoint\"] | undefined;\n  if (checkpointEnabled) {\n    checkpointInfo = await writeUpdateManyCheckpoint({\n      pmRoot,\n      checkpointId,\n      nowValue,\n      options,\n      statusFilter,\n      filters: listed.filters,\n      updateSummary,\n      checkpointItems,\n    });\n  }\n\n  const applyRows: UpdateManyApplyResultRow[] = [];\n  const updatedIds: string[] = [];\n  const updateMessage =\n    options.update.message ?? `update-many apply ${checkpointId}`;\n  const actionableById = new Set(actionable.map((row) => row.id));\n  for (const item of listed.items) {\n    if (!actionableById.has(item.id)) {\n      applyRows.push({ id: item.id, status: \"skipped\" });\n      continue;\n    }\n    try {\n      const result = await runUpdate(\n        item.id,\n        {\n          ...options.update,\n          message: updateMessage,\n          runtimeFieldCommands: [\"update_many\"],\n        },\n        global,\n      );\n      applyRows.push({\n        id: item.id,\n        status: \"updated\",\n        changed_fields: result.changed_fields,\n        warnings: result.warnings,\n      });\n      updatedIds.push(item.id);\n    } catch (error: unknown) {\n      applyRows.push({\n        id: item.id,\n        status: \"failed\",\n        error: toErrorMessage(error),\n      });\n    }\n  }\n\n  const updatedCount = applyRows.filter(\n    (row) => row.status === \"updated\",\n  ).length;\n  const skippedCount = applyRows.filter(\n    (row) => row.status === \"skipped\",\n  ).length;\n  const failedCount = applyRows.filter((row) => row.status === \"failed\").length;\n\n  return {\n    mode: \"apply\",\n    matched_count: listed.items.length,\n    dry_run: false,\n    filters: listed.filters,\n    planned_update_options: updateSummary,\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    updated_count: updatedCount,\n    skipped_count: skippedCount,\n    failed_count: failedCount,\n    rows: applyRows,\n    ids: updatedIds,\n  };\n}\n\n/** Public contract for test only update many command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyUpdateManyCommand = {\n  assertPlannedUpdateValuesValid,\n  buildCollectionMutationPlans,\n  buildPlannedItemDiff,\n  buildTagMutationPlan,\n  collectionValueCount,\n  hasAnyUpdateMutationInput,\n  hasListFilters,\n  normalizeStatusFilter,\n  normalizeCollectionBeforeValue,\n  normalizeExistingTags,\n  normalizeUnsetField,\n  rejectBlankIdsFilter,\n  sanitizeUpdateOptionsForSummary,\n  toComparablePreviewValue,\n};\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-GAJ7U7B4.js → chunk-ERL2YFJ2.js}

@@ -14,7 +14,7 @@ import {
   recordAfterCommandAffectedItem,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
@@ -29,7 +29,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   writeFileAtomic
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/cli/commands/copy.js
 !(function() {
@@ -177,4 +177,4 @@ async function runCopy(sourceId, options, global2) {
 export {
   runCopy
 };
-//# sourceMappingURL=chunk-GAJ7U7B4.js.map
+//# sourceMappingURL=chunk-ERL2YFJ2.js.map

package/dist/cli-bundle/chunks/{chunk-FPEYOFEF.js → chunk-F7PSHRNO.js}

@@ -5,10 +5,10 @@ import {
   runActiveRendererOverride,
   runActiveServiceOverrideSync,
   setActiveCommandResult
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/core/output/mutation-projection.js
 var CHANGED_FIELDS_KEY = "changed_fields";
@@ -356,6 +356,6 @@ export {
   printResult,
   printError
 };
-//# sourceMappingURL=chunk-FPEYOFEF.js.map
+//# sourceMappingURL=chunk-F7PSHRNO.js.map
 
 //# debugId=346ad418-c2a4-5490-b54b-15e643b443b8

package/dist/cli-bundle/chunks/{chunk-UH7OLT6F.js → chunk-FDSBDNYE.js}

@@ -2,7 +2,7 @@ import {
   parseAnnotationTextInput,
   resolveAnnotationInput,
   runAnnotationCommand
-} from "./chunk-DZRZMBBF.js";
+} from "./chunk-VJTAEIPC.js";
 
 // dist/cli/commands/learnings.js
 !(function() {
@@ -35,4 +35,4 @@ async function runLearnings(id, options, global2) {
 export {
   runLearnings
 };
-//# sourceMappingURL=chunk-UH7OLT6F.js.map
+//# sourceMappingURL=chunk-FDSBDNYE.js.map

package/dist/cli-bundle/chunks/{chunk-DGJF32JF.js → chunk-FIGXOCEQ.js}

@@ -1,6 +1,3 @@
-import {
-  isRemoteLinkedArtifactReference
-} from "./chunk-CCAGZCZK.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -9,7 +6,7 @@ import {
   createStdinTokenResolver,
   looksLikeGenericKeyValueEntry,
   parseCsvKv
-} from "./chunk-HR2MQAO5.js";
+} from "./chunk-WD6MSYMP.js";
 import {
   splitCommaList
 } from "./chunk-D6HZN36B.js";
@@ -19,7 +16,7 @@ import {
   mutateItem,
   readLocatedItem,
   readSettings
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -27,17 +24,33 @@ import {
   getSettingsPath,
   pathExists,
   resolveItemTypeRegistry,
-  resolvePmRoot
-} from "./chunk-XY3CC3EM.js";
+  resolvePmRoot,
+  resolveWorkspaceRoot
+} from "./chunk-AFWZRL7M.js";
 
-// dist/cli/commands/linked-artifacts.js
+// dist/sdk/linked-artifacts.js
 import fs from "node:fs/promises";
 import path from "node:path";
 import fg from "fast-glob";
+
+// dist/core/validate/linked-artifact-reference.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] = "9a1727bc-f5d7-59f4-82e1-96af39fe11d2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "410cbb40-6054-5dfa-88ee-4a425c0dbb56");
+  } catch (e2) {
+  }
+})();
+var REMOTE_ARTIFACT_REFERENCE_PATTERN = /^[a-z][a-z0-9+.-]+:\/\//i;
+function isRemoteLinkedArtifactReference(path2) {
+  return REMOTE_ARTIFACT_REFERENCE_PATTERN.test(path2.trim());
+}
+
+// dist/sdk/linked-artifacts.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] = "839f67ed-2046-53b0-ba73-39d48038f2c9");
   } catch (e2) {
   }
 })();
@@ -173,12 +186,26 @@ function applyPathMigrations(artifactPath, migrations) {
 function normalizeLinkedPath(value) {
   return value.split(path.sep).join("/");
 }
-async function expandAddGlobEntries(entries) {
+function anchorLinkedPath(value, workspaceRoot, invocationRoot = process.cwd()) {
+  const trimmed = value.trim();
+  if (isRemoteLinkedArtifactReference(trimmed)) {
+    return trimmed;
+  }
+  if (path.isAbsolute(trimmed) || /^[A-Za-z]:[\\/]/.test(trimmed)) {
+    return normalizeLinkedPath(trimmed.replaceAll("\\", path.sep));
+  }
+  const invocationRelativeToWorkspace = path.relative(workspaceRoot, invocationRoot);
+  if (invocationRelativeToWorkspace.startsWith(`..${path.sep}`) || invocationRelativeToWorkspace === ".." || path.isAbsolute(invocationRelativeToWorkspace)) {
+    return normalizeLinkedPath(path.normalize(trimmed));
+  }
+  return normalizeLinkedPath(path.relative(workspaceRoot, path.resolve(invocationRoot, trimmed)));
+}
+async function expandAddGlobEntries(entries, workspaceRoot = process.cwd(), invocationRoot = process.cwd()) {
   const expanded = [];
   for (const entry of entries) {
     const absolutePattern = path.isAbsolute(entry.pattern);
     const matches = await fg(entry.pattern, {
-      cwd: process.cwd(),
+      cwd: invocationRoot,
       absolute: absolutePattern,
       onlyFiles: true,
       dot: true,
@@ -186,7 +213,7 @@ async function expandAddGlobEntries(entries) {
       followSymbolicLinks: true
     });
     const sortedMatches = [
-      ...new Set(matches.map((match) => normalizeLinkedPath(path.normalize(match))))
+      ...new Set(matches.map((match) => anchorLinkedPath(match, workspaceRoot, invocationRoot)))
     ].sort((left, right) => left.localeCompare(right));
     for (const matchedPath of sortedMatches) {
       expanded.push({
@@ -230,7 +257,7 @@ function dedupeLinkedArtifacts(artifacts) {
     note: entry.note?.trim() || void 0
   }));
 }
-async function validateLinkedPaths(paths) {
+async function validateLinkedPaths(paths, workspaceRoot = process.cwd()) {
   const uniquePaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));
   const existingFiles = [];
   const missingPaths = [];
@@ -241,7 +268,7 @@ async function validateLinkedPaths(paths) {
       remoteReferences.push(relativePath.trim());
       continue;
     }
-    const resolvedPath = path.isAbsolute(relativePath) ? relativePath : path.resolve(process.cwd(), relativePath);
+    const resolvedPath = path.isAbsolute(relativePath) ? relativePath : path.resolve(workspaceRoot, relativePath);
     try {
       const stats = await fs.stat(resolvedPath);
       if (stats.isFile()) {
@@ -309,13 +336,15 @@ async function buildLinkedArtifactResult(params) {
     changed: params.changed,
     count: params.artifacts.length,
     migrations_applied: params.migrationsApplied && params.migrationsApplied > 0 ? params.migrationsApplied : void 0,
-    validation: params.options.validatePaths ? await validateLinkedPaths(paths) : void 0
+    validation: params.options.validatePaths ? await validateLinkedPaths(paths, params.workspaceRoot) : void 0
   };
 }
 async function runLinkedArtifacts(id, options, global2, config) {
   const { metadataKey } = config;
   const stdinResolver = createStdinTokenResolver();
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  const workspaceRoot = resolveWorkspaceRoot(pmRoot);
+  const invocationRoot = process.cwd();
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
   }
@@ -325,11 +354,14 @@ async function runLinkedArtifacts(id, options, global2, config) {
   const resolvedAddGlobs = await stdinResolver.resolveList(options.addGlob, "--add-glob");
   const resolvedRemoves = await stdinResolver.resolveList(options.remove, "--remove");
   const resolvedMigrations = await stdinResolver.resolveList(options.migrate, "--migrate");
-  const parsedAdds = parseAddEntries(resolvedAdds, config.bareNoun);
+  const parsedAdds = parseAddEntries(resolvedAdds, config.bareNoun).map((entry) => ({
+    ...entry,
+    path: anchorLinkedPath(entry.path, workspaceRoot, invocationRoot)
+  }));
   const addGlobs = parseAddGlobEntries(resolvedAddGlobs);
-  const expandedGlobAdds = await expandAddGlobEntries(addGlobs);
+  const expandedGlobAdds = await expandAddGlobEntries(addGlobs, workspaceRoot, invocationRoot);
   const adds = applyStandaloneNote([...parsedAdds, ...expandedGlobAdds], options.note, parsedAdds.length > 0 || addGlobs.length > 0);
-  const removes = parseRemoveEntries(resolvedRemoves);
+  const removes = parseRemoveEntries(resolvedRemoves).map((entry) => anchorLinkedPath(entry, workspaceRoot, invocationRoot));
   const migrations = parseMigrateEntries(resolvedMigrations);
   const shouldMutate = adds.length > 0 || removes.length > 0 || migrations.length > 0;
   if (!shouldMutate) {
@@ -343,7 +375,8 @@ async function runLinkedArtifacts(id, options, global2, config) {
       id: located.id,
       artifacts: artifacts2,
       changed: false,
-      options
+      options,
+      workspaceRoot
     });
   }
   const author = resolveAuthor(options.author, settings.author_default);
@@ -381,7 +414,8 @@ async function runLinkedArtifacts(id, options, global2, config) {
     artifacts,
     changed: true,
     migrationsApplied: migrationCount,
-    options
+    options,
+    workspaceRoot
   });
 }
 function renameArtifactsResultKey(result, key) {
@@ -393,10 +427,21 @@ function renameArtifactsResultKey(result, key) {
 }
 
 export {
+  isRemoteLinkedArtifactReference,
+  ensureScope,
+  parseAddEntries,
+  parseAddGlobEntries,
+  parseRemoveEntries,
+  parseMigrateEntries,
+  applyPathMigrations,
   normalizeLinkedPath,
+  expandAddGlobEntries,
+  applyStandaloneNote,
+  artifactKey,
   sortLinkedArtifacts,
   dedupeLinkedArtifacts,
+  validateLinkedPaths,
   runLinkedArtifacts,
   renameArtifactsResultKey
 };
-//# sourceMappingURL=chunk-DGJF32JF.js.map
+//# sourceMappingURL=chunk-FIGXOCEQ.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../sdk/linked-artifacts.ts", "../../../../../../../../core/validate/linked-artifact-reference.ts"],
+  "sourcesContent": ["/**\n * @module sdk/linked-artifacts\n *\n * Implements the pm linked artifacts command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../core/extensions/index.js\";\nimport {\n  assertNoUnknownCsvKeys,\n  createStdinTokenResolver,\n  looksLikeGenericKeyValueEntry,\n  parseCsvKv,\n} from \"../core/item/parse.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { isRemoteLinkedArtifactReference } from \"../core/validate/linked-artifact-reference.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 { splitCommaList } from \"../core/shared/split-comma-list.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 { SCOPE_VALUES } from \"../types/index.js\";\nimport { resolveAuthor } from \"../core/shared/author.js\";\nimport type { LinkScope } from \"../types/index.js\";\n\n/** Restricts linked artifact values accepted by command, SDK, and storage contracts. */\nexport type LinkedArtifact = {\n  /** Filesystem path used for path resolution. */\n  path: string;\n  /** Value that configures or reports scope for this contract. */\n  scope: LinkScope;\n  /** Value that configures or reports note for this contract. */\n  note?: string;\n};\n\n/** Allowed CSV/markdown keys for each structured linked-artifact option (GH-258). */\nexport const LINKED_ARTIFACT_ADD_KEYS = [\"path\", \"scope\", \"note\"] as const;\n/** Public contract for linked artifact add glob keys, shared by SDK and presentation-layer consumers. */\nexport const LINKED_ARTIFACT_ADD_GLOB_KEYS = [\n  \"pattern\",\n  \"glob\",\n  \"path\",\n  \"scope\",\n  \"note\",\n] as const;\n/** Public contract for linked artifact remove keys, shared by SDK and presentation-layer consumers. */\nexport const LINKED_ARTIFACT_REMOVE_KEYS = [\"path\"] as const;\n/** Public contract for linked artifact migrate keys, shared by SDK and presentation-layer consumers. */\nexport const LINKED_ARTIFACT_MIGRATE_KEYS = [\"from\", \"to\"] as const;\n/** Keys that are valid on --add but meaningless on --remove (GH-277). Rejected with audit-trail guidance (--message) rather than the generic unknown-key error so agents are not left believing a removal note was recorded. */\nconst LINKED_ARTIFACT_REMOVE_UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\n  \"note\",\n  \"scope\",\n]);\n\n/** Documents the linked artifact command options payload exchanged by command, SDK, and package integrations. */\nexport interface LinkedArtifactCommandOptions {\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 link added by --add / --add-glob in the same invocation. A per-entry embedded note (the `path=...,note=...` pair syntax) takes precedence over this flag. Requires at least one --add/--add-glob; rejected otherwise. */\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 path migration payload exchanged by command, SDK, and package integrations. */\nexport interface PathMigration {\n  /** Value that configures or reports from for this contract. */\n  from: string;\n  /** Value that configures or reports to for this contract. */\n  to: string;\n}\n\n/** Documents the add glob entry payload exchanged by command, SDK, and package integrations. */\nexport interface AddGlobEntry {\n  /** Value that configures or reports pattern for this contract. */\n  pattern: string;\n  /** Value that configures or reports scope for this contract. */\n  scope: LinkScope;\n  /** Value that configures or reports note for this contract. */\n  note?: string;\n}\n\n/** Documents the linked path validation payload exchanged by command, SDK, and package integrations. */\nexport interface LinkedPathValidation {\n  /** Value that configures or reports checked for this contract. */\n  checked: number;\n  /** Value that configures or reports existing files for this contract. */\n  existing_files: string[];\n  /** Value that configures or reports missing paths for this contract. */\n  missing_paths: string[];\n  /** Value that configures or reports non file paths for this contract. */\n  non_file_paths: string[];\n  /** Remote references (https:// URLs and other `scheme://` paths) recorded as links — most often a PR/issue/design-doc URL added via `pm docs --add`. These are not local files, so they bypass the existence probe and are reported here rather than counted as missing. */\n  remote_references: string[];\n}\n\n/** Documents the linked artifact result payload exchanged by command, SDK, and package integrations. */\nexport interface LinkedArtifactResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\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  /** Value that configures or reports artifacts for this contract. */\n  artifacts: LinkedArtifact[];\n}\n\n/** Replaces the generic artifacts field with a resource-specific result key while retaining the remaining result contract. */\nexport type RenamedLinkedArtifactResult<\n  Result extends LinkedArtifactResult,\n  Key extends \"files\" | \"docs\",\n> = Omit<Result, \"artifacts\"> & { [Field in Key]: Result[\"artifacts\"] };\n\n/** Configuration that adapts the shared linked-artifact command core to a specific resource kind (files or docs) while preserving every behavioral detail of the original twin implementations. */\nexport interface LinkedArtifactKindConfig {\n  /** Metadata key under which the artifacts are stored (e.g. \"files\" | \"docs\"). */\n  metadataKey: \"files\" | \"docs\";\n  /** Mutation op recorded in history (e.g. \"files_add\" | \"docs_add\"). */\n  op: \"files_add\" | \"docs_add\";\n  /** Noun used in the \"bare <noun> path\" --add usage error (e.g. \"file\" | \"doc\"). */\n  bareNoun: \"file\" | \"doc\";\n  /** Whether this kind honors the append-stable option. files supports it; docs always sorts and must never expose append-stable behavior. */\n  supportsAppendStable: boolean;\n}\n\n/** Implements ensure scope for the public runtime surface of this module. */\nexport function ensureScope(raw: string | undefined): LinkScope {\n  const value = (raw ?? \"project\") as LinkScope;\n  if (!SCOPE_VALUES.includes(value)) {\n    throw new PmCliError(\n      `Invalid scope \"${raw}\". Valid scopes: ${SCOPE_VALUES.join(\", \")} (default: project).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/** Implements looks like structured path entry for the public runtime surface of this module. */\nexport function looksLikeStructuredPathEntry(raw: string): boolean {\n  if (raw.startsWith(\"```\") || raw.includes(\"\\n\")) {\n    return true;\n  }\n  if (/^(?:[-*+]\\s+)?(?:path|scope|note)\\s*[:=]/i.test(raw)) {\n    return true;\n  }\n  // A first-key typo (e.g. `lable=main,path=…`) must still be parsed so the\n  // unknown key is rejected rather than swallowed as a bare path (GH-258).\n  return looksLikeGenericKeyValueEntry(raw);\n}\n\nfunction expandBareCommaSeparatedAddEntries(raw: string[]): string[] {\n  return raw.flatMap((entry) => {\n    const trimmed = entry.trim();\n    if (\n      trimmed.length === 0 ||\n      looksLikeStructuredPathEntry(trimmed) ||\n      !trimmed.includes(\",\")\n    ) {\n      return [entry];\n    }\n    return splitCommaList(trimmed);\n  });\n}\n\n/** Implements parse add entries for the public runtime surface of this module. */\nexport function parseAddEntries(\n  raw: string[] | undefined,\n  bareNoun: \"file\" | \"doc\",\n): LinkedArtifact[] {\n  if (!raw) return [];\n  return expandBareCommaSeparatedAddEntries(raw).map((entry) => {\n    const trimmed = entry.trim();\n    const kv = looksLikeStructuredPathEntry(trimmed)\n      ? parseCsvKv(entry, \"--add\")\n      : { path: trimmed };\n    assertNoUnknownCsvKeys(kv, \"--add\", LINKED_ARTIFACT_ADD_KEYS);\n    if (!kv.path) {\n      throw new PmCliError(\n        `--add requires path=<value> or a bare ${bareNoun} path`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      path: kv.path,\n      scope: ensureScope(kv.scope),\n      note: kv.note?.trim() || undefined,\n    };\n  });\n}\n\n/** Implements parse add glob entries for the public runtime surface of this module. */\nexport function parseAddGlobEntries(raw: string[] | undefined): AddGlobEntry[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\n        \"--add-glob requires a glob pattern value\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (\n      trimmed.includes(\"=\") ||\n      /^(?:[-*+]\\s+)?(?:pattern|glob|path)\\s*[:=]/i.test(trimmed) ||\n      trimmed.startsWith(\"```\")\n    ) {\n      const kv = parseCsvKv(trimmed, \"--add-glob\");\n      assertNoUnknownCsvKeys(kv, \"--add-glob\", LINKED_ARTIFACT_ADD_GLOB_KEYS);\n      const pattern = kv.pattern?.trim() || kv.glob?.trim() || kv.path?.trim();\n      if (!pattern) {\n        throw new PmCliError(\n          \"--add-glob key/value form requires pattern=<glob>\",\n          EXIT_CODE.USAGE,\n        );\n      }\n      return {\n        pattern,\n        scope: ensureScope(kv.scope),\n        note: kv.note?.trim() || undefined,\n      };\n    }\n    return {\n      pattern: trimmed,\n      scope: \"project\",\n    };\n  });\n}\n\n/** Implements parse remove entries for the public runtime surface of this module. */\nexport function parseRemoveEntries(raw: string[] | undefined): string[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\"--remove requires a path value\", EXIT_CODE.USAGE);\n    }\n    if (\n      trimmed.includes(\"=\") ||\n      /^(?:[-*+]\\s+)?path\\s*[:=]/i.test(trimmed) ||\n      trimmed.startsWith(\"```\")\n    ) {\n      const kv = parseCsvKv(trimmed, \"--remove\");\n      // GH-277: --remove identifies an existing link by path only; it does not\n      // attach per-link metadata. Reject the --add-only keys with guidance toward\n      // the audit-trail path (--message) rather than the generic \"unrecognized\n      // key\" error, which left agents believing they had recorded a removal note.\n      const unsupportedRemoveKeys = Object.keys(kv).filter((key) =>\n        LINKED_ARTIFACT_REMOVE_UNSUPPORTED_KEYS.has(key.toLowerCase()),\n      );\n      if (unsupportedRemoveKeys.length > 0) {\n        throw new PmCliError(\n          `--remove identifies a linked artifact by path only and does not accept ${unsupportedRemoveKeys\n            .map((key) => `\"${key}\"`)\n            .join(\n              \", \",\n            )}. Pass just the path (path=<value>, path:<value>, or a bare path); record removal context with --message \"<why removed>\".`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      assertNoUnknownCsvKeys(kv, \"--remove\", LINKED_ARTIFACT_REMOVE_KEYS);\n      if (!kv.path) {\n        throw new PmCliError(\n          \"--remove key/value form requires path=<value>\",\n          EXIT_CODE.USAGE,\n        );\n      }\n      return kv.path;\n    }\n    return trimmed;\n  });\n}\n\n/** Implements parse migrate entries for the public runtime surface of this module. */\nexport function parseMigrateEntries(\n  raw: string[] | undefined,\n): PathMigration[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const kv = parseCsvKv(entry, \"--migrate\");\n    assertNoUnknownCsvKeys(kv, \"--migrate\", LINKED_ARTIFACT_MIGRATE_KEYS);\n    const from = kv.from?.trim();\n    const to = kv.to?.trim();\n    if (!from || !to) {\n      throw new PmCliError(\n        \"--migrate requires from=<value> and to=<value>\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { from, to };\n  });\n}\n\n/** Implements apply path migrations for the public runtime surface of this module. */\nexport function applyPathMigrations(\n  artifactPath: string,\n  migrations: PathMigration[],\n): string {\n  let next = artifactPath;\n  for (const migration of migrations) {\n    if (next.startsWith(migration.from)) {\n      next = `${migration.to}${next.slice(migration.from.length)}`;\n    }\n  }\n  return next;\n}\n\n/** Implements normalize linked path for the public runtime surface of this module. */\nexport function normalizeLinkedPath(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\n/** Anchor a local linked path to the project workspace while preserving remote references and absolute paths. */\nexport function anchorLinkedPath(\n  value: string,\n  workspaceRoot: string,\n  invocationRoot: string = process.cwd(),\n): string {\n  const trimmed = value.trim();\n  if (isRemoteLinkedArtifactReference(trimmed)) {\n    return trimmed;\n  }\n  if (path.isAbsolute(trimmed) || /^[A-Za-z]:[\\\\/]/.test(trimmed)) {\n    return normalizeLinkedPath(trimmed.replaceAll(\"\\\\\", path.sep));\n  }\n  const invocationRelativeToWorkspace = path.relative(\n    workspaceRoot,\n    invocationRoot,\n  );\n  if (\n    invocationRelativeToWorkspace.startsWith(`..${path.sep}`) ||\n    invocationRelativeToWorkspace === \"..\" ||\n    path.isAbsolute(invocationRelativeToWorkspace)\n  ) {\n    return normalizeLinkedPath(path.normalize(trimmed));\n  }\n  return normalizeLinkedPath(\n    path.relative(workspaceRoot, path.resolve(invocationRoot, trimmed)),\n  );\n}\n\n/** Implements expand add glob entries for the public runtime surface of this module. */\nexport async function expandAddGlobEntries(\n  entries: AddGlobEntry[],\n  workspaceRoot: string = process.cwd(),\n  invocationRoot: string = process.cwd(),\n): Promise<LinkedArtifact[]> {\n  const expanded: LinkedArtifact[] = [];\n  for (const entry of entries) {\n    const absolutePattern = path.isAbsolute(entry.pattern);\n    const matches = await fg(entry.pattern, {\n      cwd: invocationRoot,\n      absolute: absolutePattern,\n      onlyFiles: true,\n      dot: true,\n      unique: true,\n      followSymbolicLinks: true,\n    });\n    const sortedMatches = [\n      ...new Set(\n        matches.map((match) =>\n          anchorLinkedPath(match, workspaceRoot, invocationRoot),\n        ),\n      ),\n    ].sort((left, right) => left.localeCompare(right));\n    for (const matchedPath of sortedMatches) {\n      expanded.push({\n        path: matchedPath,\n        scope: entry.scope,\n        note: entry.note,\n      });\n    }\n  }\n  return expanded;\n}\n\n/** GH-170 (pm-pfnx): apply a standalone --note to the links added in this invocation. Semantics (documented on pm-pfnx): the note is attached to EVERY entry added via --add/--add-glob so a single flag annotates the whole batch predictably; a per-entry embedded `note=` wins over the standalone flag; and --note without any --add/--add-glob flag is a usage error because there is nothing to annotate (it never retro-edits existing links). `hasAddFlags` reflects flag presence, not match count, so a glob that legitimately matches zero files is not an error. */\nexport function applyStandaloneNote(\n  adds: LinkedArtifact[],\n  note: string | undefined,\n  hasAddFlags: boolean,\n): LinkedArtifact[] {\n  if (note === undefined) {\n    return adds;\n  }\n  if (!hasAddFlags) {\n    throw new PmCliError(\n      \"--note requires --add or --add-glob in the same invocation (the note annotates the links being added)\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  const trimmed = note.trim();\n  if (trimmed.length === 0) {\n    return adds;\n  }\n  return adds.map((entry) =>\n    entry.note === undefined ? { ...entry, note: trimmed } : entry,\n  );\n}\n\n/** Implements artifact key for the public runtime surface of this module. */\nexport function artifactKey(\n  value: Pick<LinkedArtifact, \"path\" | \"scope\">,\n): string {\n  return `${value.path}::${value.scope}`;\n}\n\n/** Implements sort linked artifacts for the public runtime surface of this module. */\nexport function sortLinkedArtifacts(\n  artifacts: LinkedArtifact[],\n): LinkedArtifact[] {\n  return [...artifacts].sort((left, right) => {\n    const byPath = left.path.localeCompare(right.path);\n    if (byPath !== 0) return byPath;\n    return left.scope.localeCompare(right.scope);\n  });\n}\n\n/** Implements dedupe linked artifacts for the public runtime surface of this module. */\nexport function dedupeLinkedArtifacts(\n  artifacts: LinkedArtifact[],\n): LinkedArtifact[] {\n  return [\n    ...new Map(artifacts.map((entry) => [artifactKey(entry), entry])).values(),\n  ].map((entry) => ({\n    ...entry,\n    note: entry.note?.trim() || undefined,\n  }));\n}\n\n/** Implements validate linked paths for the public runtime surface of this module. */\nexport async function validateLinkedPaths(\n  paths: string[],\n  workspaceRoot: string = process.cwd(),\n): Promise<LinkedPathValidation> {\n  const uniquePaths = [...new Set(paths)].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  const existingFiles: string[] = [];\n  const missingPaths: string[] = [];\n  const nonFilePaths: string[] = [];\n  const remoteReferences: string[] = [];\n  for (const relativePath of uniquePaths) {\n    // Remote references (https:// PR/issue/design-doc URLs) are not local\n    // files; report them separately (trimmed, to match buildFilesCheck's\n    // output shape) instead of probing a meaningless path.\n    if (isRemoteLinkedArtifactReference(relativePath)) {\n      remoteReferences.push(relativePath.trim());\n      continue;\n    }\n    const resolvedPath = path.isAbsolute(relativePath)\n      ? relativePath\n      : path.resolve(workspaceRoot, relativePath);\n    try {\n      const stats = await fs.stat(resolvedPath);\n      if (stats.isFile()) {\n        existingFiles.push(relativePath);\n      } else {\n        nonFilePaths.push(relativePath);\n      }\n    } catch (error: unknown) {\n      if (\n        typeof error === \"object\" &&\n        error !== null &&\n        \"code\" in error &&\n        (error as { code?: string }).code === \"ENOENT\"\n      ) {\n        missingPaths.push(relativePath);\n        continue;\n      }\n      nonFilePaths.push(relativePath);\n    }\n  }\n  return {\n    checked: uniquePaths.length,\n    existing_files: existingFiles,\n    missing_paths: missingPaths,\n    non_file_paths: nonFilePaths,\n    remote_references: remoteReferences,\n  };\n}\n\nfunction applyLinkedArtifactMigrations(\n  current: LinkedArtifact[],\n  adds: LinkedArtifact[],\n  removes: string[],\n  migrations: PathMigration[],\n): { adds: LinkedArtifact[]; removes: string[]; count: number } {\n  let count = 0;\n  for (let index = 0; index < current.length; index += 1) {\n    const migratedPath = applyPathMigrations(current[index].path, migrations);\n    if (migratedPath !== current[index].path) {\n      current[index] = { ...current[index], path: migratedPath };\n      count += 1;\n    }\n  }\n  const migratedAdds = adds.map((entry) => {\n    const migratedPath = applyPathMigrations(entry.path, migrations);\n    if (migratedPath !== entry.path) count += 1;\n    return { ...entry, path: migratedPath };\n  });\n  return {\n    adds: migratedAdds,\n    removes: removes.map((entry) => applyPathMigrations(entry, migrations)),\n    count,\n  };\n}\n\nfunction mergeLinkedArtifactChanges(\n  current: LinkedArtifact[],\n  adds: LinkedArtifact[],\n  removes: string[],\n  appendStable: boolean,\n): LinkedArtifact[] {\n  for (const add of adds) {\n    if (\n      !current.some(\n        (entry) => entry.path === add.path && entry.scope === add.scope,\n      )\n    ) {\n      current.push(add);\n    }\n  }\n  if (removes.length > 0) {\n    for (let index = current.length - 1; index >= 0; index -= 1) {\n      if (removes.includes(current[index].path)) current.splice(index, 1);\n    }\n  }\n  const deduped = dedupeLinkedArtifacts(current);\n  return appendStable ? deduped : sortLinkedArtifacts(deduped);\n}\n\nasync function buildLinkedArtifactResult(params: {\n  id: string;\n  artifacts: LinkedArtifact[];\n  changed: boolean;\n  migrationsApplied?: number;\n  options: LinkedArtifactCommandOptions;\n  workspaceRoot: string;\n}): Promise<LinkedArtifactResult> {\n  const paths = params.artifacts.map((entry) => entry.path);\n  return {\n    id: params.id,\n    artifacts: params.artifacts,\n    changed: params.changed,\n    count: params.artifacts.length,\n    migrations_applied:\n      params.migrationsApplied && params.migrationsApplied > 0\n        ? params.migrationsApplied\n        : undefined,\n    validation: params.options.validatePaths\n      ? await validateLinkedPaths(paths, params.workspaceRoot)\n      : undefined,\n  };\n}\n\n/** Shared linked-artifact list/mutate command core used by runFiles and runDocs. The kind config selects metadata key, op, bare-path noun, and whether append-stable ordering is honored, preserving each twin's exact semantics. */\nexport async function runLinkedArtifacts(\n  id: string,\n  options: LinkedArtifactCommandOptions,\n  global: GlobalOptions,\n  config: LinkedArtifactKindConfig,\n): Promise<LinkedArtifactResult> {\n  const { metadataKey } = config;\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const workspaceRoot = resolveWorkspaceRoot(pmRoot);\n  const invocationRoot = process.cwd();\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 resolvedAdds = await stdinResolver.resolveList(options.add, \"--add\");\n  const resolvedAddGlobs = await stdinResolver.resolveList(\n    options.addGlob,\n    \"--add-glob\",\n  );\n  const resolvedRemoves = await stdinResolver.resolveList(\n    options.remove,\n    \"--remove\",\n  );\n  const resolvedMigrations = await stdinResolver.resolveList(\n    options.migrate,\n    \"--migrate\",\n  );\n  const parsedAdds = parseAddEntries(resolvedAdds, config.bareNoun).map(\n    (entry) => ({\n      ...entry,\n      path: anchorLinkedPath(entry.path, workspaceRoot, invocationRoot),\n    }),\n  );\n  const addGlobs = parseAddGlobEntries(resolvedAddGlobs);\n  const expandedGlobAdds = await expandAddGlobEntries(\n    addGlobs,\n    workspaceRoot,\n    invocationRoot,\n  );\n  const adds = applyStandaloneNote(\n    [...parsedAdds, ...expandedGlobAdds],\n    options.note,\n    parsedAdds.length > 0 || addGlobs.length > 0,\n  );\n  const removes = parseRemoveEntries(resolvedRemoves).map((entry) =>\n    anchorLinkedPath(entry, workspaceRoot, invocationRoot),\n  );\n  const migrations = parseMigrateEntries(resolvedMigrations);\n  const shouldMutate =\n    adds.length > 0 || removes.length > 0 || migrations.length > 0;\n\n  if (!shouldMutate) {\n    const located = await locateItem(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const artifacts =\n      ((loaded.document.metadata as Record<string, unknown>)[metadataKey] as\n        | LinkedArtifact[]\n        | undefined) ?? [];\n    return buildLinkedArtifactResult({\n      id: located.id,\n      artifacts,\n      changed: false,\n      options,\n      workspaceRoot,\n    });\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: config.op,\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      const metadata = document.metadata as Record<string, unknown>;\n      const next = [\n        ...((metadata[metadataKey] as LinkedArtifact[] | undefined) ?? []),\n      ];\n      const migrated = applyLinkedArtifactMigrations(\n        next,\n        adds,\n        removes,\n        migrations,\n      );\n      const normalized = mergeLinkedArtifactChanges(\n        next,\n        migrated.adds,\n        migrated.removes,\n        config.supportsAppendStable && options.appendStable === true,\n      );\n      if (normalized.length > 0) {\n        metadata[metadataKey] = normalized;\n      } else {\n        delete metadata[metadataKey];\n      }\n      return {\n        changedFields: [metadataKey],\n        warnings:\n          migrated.count > 0\n            ? [`path_migrations_applied:${migrated.count}`]\n            : [],\n      };\n    },\n  });\n\n  const artifacts =\n    ((result.item as Record<string, unknown>)[metadataKey] as\n      | LinkedArtifact[]\n      | undefined) ?? [];\n  const migrationWarning = result.warnings.find((warning) =>\n    warning.startsWith(\"path_migrations_applied:\"),\n  );\n  const migrationCount = migrationWarning\n    ? Number(migrationWarning.slice(\"path_migrations_applied:\".length))\n    : 0;\n  return buildLinkedArtifactResult({\n    id: result.item.id,\n    artifacts,\n    changed: true,\n    migrationsApplied: migrationCount,\n    options,\n    workspaceRoot,\n  });\n}\n\n/** Re-key the generic `artifacts` field to the resource-specific name (files/docs) while preserving the original key order and presence so kind-specific result shapes (and their deterministic JSON key ordering) stay byte-identical. */\nexport function renameArtifactsResultKey<\n  Result extends LinkedArtifactResult,\n  const Key extends \"files\" | \"docs\",\n>(result: Result, key: Key): RenamedLinkedArtifactResult<Result, Key> {\n  const out: Record<string, unknown> = {};\n  for (const [field, value] of Object.entries(result)) {\n    out[field === \"artifacts\" ? key : field] = value;\n  }\n  return out as RenamedLinkedArtifactResult<Result, Key>;\n}\n", "/**\n * Remote-reference detection for linked artifacts (`pm files` / `pm docs`\n * `path` values).\n *\n * A linked artifact path is normally a workspace-relative or absolute local\n * filesystem path, but `pm docs --add` legitimately records *remote*\n * references too — most commonly an `https://` URL to a pull request, issue, or\n * external design doc. Such references are not local files, so they must never\n * be:\n * - probed with `fs.stat` for existence (the resolved path is meaningless),\n * - classified as `moved`/`deleted` by the stale-path classifier,\n * - counted among `missing_linked_paths` in `pm validate --check-files`, or\n * - pruned by `pm validate --prune-missing` — which would silently destroy an\n *   intentionally-recorded reference (project management = context management).\n *\n * Pure module: no filesystem or network access — callers pass the stored path\n * string and branch on the boolean result.\n */\n\n/**\n * Matches an RFC 3986 URI that carries an authority component\n * (`scheme://…`) — e.g. `https://`, `http://`, `ftp://`, `ssh://`, `file://`.\n *\n * The scheme is required to be at least two characters so a Windows drive\n * prefix (`C:/…`, which is a single letter followed by a single slash and never\n * `://`) can never be mistaken for a remote reference. A relative or absolute\n * POSIX path (`src/api.ts`, `/dev/null`) and a UNC path (`//server/share`) all\n * lack the `scheme://` shape and are correctly treated as local.\n */\nconst REMOTE_ARTIFACT_REFERENCE_PATTERN = /^[a-z][a-z0-9+.-]+:\\/\\//i;\n\n/** Return `true` when a linked-artifact path is a remote reference (a URL with a `scheme://` authority) rather than a local filesystem path. Whitespace is trimmed before matching so a stored `\" https://…\"` is still recognized. */\nexport function isRemoteLinkedArtifactReference(path: string): boolean {\n  return REMOTE_ARTIFACT_REFERENCE_PATTERN.test(path.trim());\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,QAAQ;;;;;;;;;;ACsBf,IAAM,oCAAoC;AAGpC,SAAU,gCAAgCA,OAAY;AAC1D,SAAO,kCAAkC,KAAKA,MAAK,KAAI,CAAE;AAC3D;;;;;;;;;;ADcO,IAAM,2BAA2B,CAAC,QAAQ,SAAS,MAAM;AAEzD,IAAM,gCAAgC;EAC3C;EACA;EACA;EACA;EACA;;AAGK,IAAM,8BAA8B,CAAC,MAAM;AAE3C,IAAM,+BAA+B,CAAC,QAAQ,IAAI;AAEzD,IAAM,0CAA+D,oBAAI,IAAI;EAC3E;EACA;CACD;AA+FK,SAAU,YAAY,KAAuB;AACjD,QAAM,QAAS,OAAO;AACtB,MAAI,CAAC,aAAa,SAAS,KAAK,GAAG;AACjC,UAAM,IAAI,WACR,kBAAkB,GAAG,oBAAoB,aAAa,KAAK,IAAI,CAAC,wBAChE,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAGM,SAAU,6BAA6B,KAAW;AACtD,MAAI,IAAI,WAAW,KAAK,KAAK,IAAI,SAAS,IAAI,GAAG;AAC/C,WAAO;EACT;AACA,MAAI,4CAA4C,KAAK,GAAG,GAAG;AACzD,WAAO;EACT;AAGA,SAAO,8BAA8B,GAAG;AAC1C;AAEA,SAAS,mCAAmC,KAAa;AACvD,SAAO,IAAI,QAAQ,CAAC,UAAS;AAC3B,UAAM,UAAU,MAAM,KAAI;AAC1B,QACE,QAAQ,WAAW,KACnB,6BAA6B,OAAO,KACpC,CAAC,QAAQ,SAAS,GAAG,GACrB;AACA,aAAO,CAAC,KAAK;IACf;AACA,WAAO,eAAe,OAAO;EAC/B,CAAC;AACH;AAGM,SAAU,gBACd,KACA,UAAwB;AAExB,MAAI,CAAC;AAAK,WAAO,CAAA;AACjB,SAAO,mCAAmC,GAAG,EAAE,IAAI,CAAC,UAAS;AAC3D,UAAM,UAAU,MAAM,KAAI;AAC1B,UAAM,KAAK,6BAA6B,OAAO,IAC3C,WAAW,OAAO,OAAO,IACzB,EAAE,MAAM,QAAO;AACnB,2BAAuB,IAAI,SAAS,wBAAwB;AAC5D,QAAI,CAAC,GAAG,MAAM;AACZ,YAAM,IAAI,WACR,yCAAyC,QAAQ,SACjD,UAAU,KAAK;IAEnB;AACA,WAAO;MACL,MAAM,GAAG;MACT,OAAO,YAAY,GAAG,KAAK;MAC3B,MAAM,GAAG,MAAM,KAAI,KAAM;;EAE7B,CAAC;AACH;AAGM,SAAU,oBAAoB,KAAyB;AAC3D,MAAI,CAAC;AAAK,WAAO,CAAA;AACjB,SAAO,IAAI,IAAI,CAAC,UAAS;AACvB,UAAM,UAAU,MAAM,KAAI;AAC1B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,WACR,4CACA,UAAU,KAAK;IAEnB;AACA,QACE,QAAQ,SAAS,GAAG,KACpB,8CAA8C,KAAK,OAAO,KAC1D,QAAQ,WAAW,KAAK,GACxB;AACA,YAAM,KAAK,WAAW,SAAS,YAAY;AAC3C,6BAAuB,IAAI,cAAc,6BAA6B;AACtE,YAAM,UAAU,GAAG,SAAS,KAAI,KAAM,GAAG,MAAM,KAAI,KAAM,GAAG,MAAM,KAAI;AACtE,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,WACR,qDACA,UAAU,KAAK;MAEnB;AACA,aAAO;QACL;QACA,OAAO,YAAY,GAAG,KAAK;QAC3B,MAAM,GAAG,MAAM,KAAI,KAAM;;IAE7B;AACA,WAAO;MACL,SAAS;MACT,OAAO;;EAEX,CAAC;AACH;AAGM,SAAU,mBAAmB,KAAyB;AAC1D,MAAI,CAAC;AAAK,WAAO,CAAA;AACjB,SAAO,IAAI,IAAI,CAAC,UAAS;AACvB,UAAM,UAAU,MAAM,KAAI;AAC1B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,WAAW,kCAAkC,UAAU,KAAK;IACxE;AACA,QACE,QAAQ,SAAS,GAAG,KACpB,6BAA6B,KAAK,OAAO,KACzC,QAAQ,WAAW,KAAK,GACxB;AACA,YAAM,KAAK,WAAW,SAAS,UAAU;AAKzC,YAAM,wBAAwB,OAAO,KAAK,EAAE,EAAE,OAAO,CAAC,QACpD,wCAAwC,IAAI,IAAI,YAAW,CAAE,CAAC;AAEhE,UAAI,sBAAsB,SAAS,GAAG;AACpC,cAAM,IAAI,WACR,0EAA0E,sBACvE,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,EACvB,KACC,IAAI,CACL,6HACH,UAAU,KAAK;MAEnB;AACA,6BAAuB,IAAI,YAAY,2BAA2B;AAClE,UAAI,CAAC,GAAG,MAAM;AACZ,cAAM,IAAI,WACR,iDACA,UAAU,KAAK;MAEnB;AACA,aAAO,GAAG;IACZ;AACA,WAAO;EACT,CAAC;AACH;AAGM,SAAU,oBACd,KAAyB;AAEzB,MAAI,CAAC;AAAK,WAAO,CAAA;AACjB,SAAO,IAAI,IAAI,CAAC,UAAS;AACvB,UAAM,KAAK,WAAW,OAAO,WAAW;AACxC,2BAAuB,IAAI,aAAa,4BAA4B;AACpE,UAAM,OAAO,GAAG,MAAM,KAAI;AAC1B,UAAM,KAAK,GAAG,IAAI,KAAI;AACtB,QAAI,CAAC,QAAQ,CAAC,IAAI;AAChB,YAAM,IAAI,WACR,kDACA,UAAU,KAAK;IAEnB;AACA,WAAO,EAAE,MAAM,GAAE;EACnB,CAAC;AACH;AAGM,SAAU,oBACd,cACA,YAA2B;AAE3B,MAAI,OAAO;AACX,aAAW,aAAa,YAAY;AAClC,QAAI,KAAK,WAAW,UAAU,IAAI,GAAG;AACnC,aAAO,GAAG,UAAU,EAAE,GAAG,KAAK,MAAM,UAAU,KAAK,MAAM,CAAC;IAC5D;EACF;AACA,SAAO;AACT;AAGM,SAAU,oBAAoB,OAAa;AAC/C,SAAO,MAAM,MAAM,KAAK,GAAG,EAAE,KAAK,GAAG;AACvC;AAGM,SAAU,iBACd,OACA,eACA,iBAAyB,QAAQ,IAAG,GAAE;AAEtC,QAAM,UAAU,MAAM,KAAI;AAC1B,MAAI,gCAAgC,OAAO,GAAG;AAC5C,WAAO;EACT;AACA,MAAI,KAAK,WAAW,OAAO,KAAK,kBAAkB,KAAK,OAAO,GAAG;AAC/D,WAAO,oBAAoB,QAAQ,WAAW,MAAM,KAAK,GAAG,CAAC;EAC/D;AACA,QAAM,gCAAgC,KAAK,SACzC,eACA,cAAc;AAEhB,MACE,8BAA8B,WAAW,KAAK,KAAK,GAAG,EAAE,KACxD,kCAAkC,QAClC,KAAK,WAAW,6BAA6B,GAC7C;AACA,WAAO,oBAAoB,KAAK,UAAU,OAAO,CAAC;EACpD;AACA,SAAO,oBACL,KAAK,SAAS,eAAe,KAAK,QAAQ,gBAAgB,OAAO,CAAC,CAAC;AAEvE;AAGA,eAAsB,qBACpB,SACA,gBAAwB,QAAQ,IAAG,GACnC,iBAAyB,QAAQ,IAAG,GAAE;AAEtC,QAAM,WAA6B,CAAA;AACnC,aAAW,SAAS,SAAS;AAC3B,UAAM,kBAAkB,KAAK,WAAW,MAAM,OAAO;AACrD,UAAM,UAAU,MAAM,GAAG,MAAM,SAAS;MACtC,KAAK;MACL,UAAU;MACV,WAAW;MACX,KAAK;MACL,QAAQ;MACR,qBAAqB;KACtB;AACD,UAAM,gBAAgB;MACpB,GAAG,IAAI,IACL,QAAQ,IAAI,CAAC,UACX,iBAAiB,OAAO,eAAe,cAAc,CAAC,CACvD;MAEH,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AACjD,eAAW,eAAe,eAAe;AACvC,eAAS,KAAK;QACZ,MAAM;QACN,OAAO,MAAM;QACb,MAAM,MAAM;OACb;IACH;EACF;AACA,SAAO;AACT;AAGM,SAAU,oBACd,MACA,MACA,aAAoB;AAEpB,MAAI,SAAS,QAAW;AACtB,WAAO;EACT;AACA,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,WACR,yGACA,UAAU,KAAK;EAEnB;AACA,QAAM,UAAU,KAAK,KAAI;AACzB,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;EACT;AACA,SAAO,KAAK,IAAI,CAAC,UACf,MAAM,SAAS,SAAY,EAAE,GAAG,OAAO,MAAM,QAAO,IAAK,KAAK;AAElE;AAGM,SAAU,YACd,OAA6C;AAE7C,SAAO,GAAG,MAAM,IAAI,KAAK,MAAM,KAAK;AACtC;AAGM,SAAU,oBACd,WAA2B;AAE3B,SAAO,CAAC,GAAG,SAAS,EAAE,KAAK,CAAC,MAAM,UAAS;AACzC,UAAM,SAAS,KAAK,KAAK,cAAc,MAAM,IAAI;AACjD,QAAI,WAAW;AAAG,aAAO;AACzB,WAAO,KAAK,MAAM,cAAc,MAAM,KAAK;EAC7C,CAAC;AACH;AAGM,SAAU,sBACd,WAA2B;AAE3B,SAAO;IACL,GAAG,IAAI,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,YAAY,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,OAAM;IACxE,IAAI,CAAC,WAAW;IAChB,GAAG;IACH,MAAM,MAAM,MAAM,KAAI,KAAM;IAC5B;AACJ;AAGA,eAAsB,oBACpB,OACA,gBAAwB,QAAQ,IAAG,GAAE;AAErC,QAAM,cAAc,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,UAClD,KAAK,cAAc,KAAK,CAAC;AAE3B,QAAM,gBAA0B,CAAA;AAChC,QAAM,eAAyB,CAAA;AAC/B,QAAM,eAAyB,CAAA;AAC/B,QAAM,mBAA6B,CAAA;AACnC,aAAW,gBAAgB,aAAa;AAItC,QAAI,gCAAgC,YAAY,GAAG;AACjD,uBAAiB,KAAK,aAAa,KAAI,CAAE;AACzC;IACF;AACA,UAAM,eAAe,KAAK,WAAW,YAAY,IAC7C,eACA,KAAK,QAAQ,eAAe,YAAY;AAC5C,QAAI;AACF,YAAM,QAAQ,MAAM,GAAG,KAAK,YAAY;AACxC,UAAI,MAAM,OAAM,GAAI;AAClB,sBAAc,KAAK,YAAY;MACjC,OAAO;AACL,qBAAa,KAAK,YAAY;MAChC;IACF,SAAS,OAAgB;AACvB,UACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS,UACtC;AACA,qBAAa,KAAK,YAAY;AAC9B;MACF;AACA,mBAAa,KAAK,YAAY;IAChC;EACF;AACA,SAAO;IACL,SAAS,YAAY;IACrB,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,mBAAmB;;AAEvB;AAEA,SAAS,8BACP,SACA,MACA,SACA,YAA2B;AAE3B,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;AACtD,UAAM,eAAe,oBAAoB,QAAQ,KAAK,EAAE,MAAM,UAAU;AACxE,QAAI,iBAAiB,QAAQ,KAAK,EAAE,MAAM;AACxC,cAAQ,KAAK,IAAI,EAAE,GAAG,QAAQ,KAAK,GAAG,MAAM,aAAY;AACxD,eAAS;IACX;EACF;AACA,QAAM,eAAe,KAAK,IAAI,CAAC,UAAS;AACtC,UAAM,eAAe,oBAAoB,MAAM,MAAM,UAAU;AAC/D,QAAI,iBAAiB,MAAM;AAAM,eAAS;AAC1C,WAAO,EAAE,GAAG,OAAO,MAAM,aAAY;EACvC,CAAC;AACD,SAAO;IACL,MAAM;IACN,SAAS,QAAQ,IAAI,CAAC,UAAU,oBAAoB,OAAO,UAAU,CAAC;IACtE;;AAEJ;AAEA,SAAS,2BACP,SACA,MACA,SACA,cAAqB;AAErB,aAAW,OAAO,MAAM;AACtB,QACE,CAAC,QAAQ,KACP,CAAC,UAAU,MAAM,SAAS,IAAI,QAAQ,MAAM,UAAU,IAAI,KAAK,GAEjE;AACA,cAAQ,KAAK,GAAG;IAClB;EACF;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,aAAS,QAAQ,QAAQ,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG;AAC3D,UAAI,QAAQ,SAAS,QAAQ,KAAK,EAAE,IAAI;AAAG,gBAAQ,OAAO,OAAO,CAAC;IACpE;EACF;AACA,QAAM,UAAU,sBAAsB,OAAO;AAC7C,SAAO,eAAe,UAAU,oBAAoB,OAAO;AAC7D;AAEA,eAAe,0BAA0B,QAOxC;AACC,QAAM,QAAQ,OAAO,UAAU,IAAI,CAAC,UAAU,MAAM,IAAI;AACxD,SAAO;IACL,IAAI,OAAO;IACX,WAAW,OAAO;IAClB,SAAS,OAAO;IAChB,OAAO,OAAO,UAAU;IACxB,oBACE,OAAO,qBAAqB,OAAO,oBAAoB,IACnD,OAAO,oBACP;IACN,YAAY,OAAO,QAAQ,gBACvB,MAAM,oBAAoB,OAAO,OAAO,aAAa,IACrD;;AAER;AAGA,eAAsB,mBACpB,IACA,SACAC,SACA,QAAgC;AAEhC,QAAM,EAAE,YAAW,IAAK;AACxB,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,QAAM,gBAAgB,qBAAqB,MAAM;AACjD,QAAM,iBAAiB,QAAQ,IAAG;AAClC,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WACR,iCAAiC,MAAM,wBACvC,UAAU,SAAS;EAEvB;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBACnB,UACA,gCAA+B,CAAE;AAEnC,QAAM,eAAe,MAAM,cAAc,YAAY,QAAQ,KAAK,OAAO;AACzE,QAAM,mBAAmB,MAAM,cAAc,YAC3C,QAAQ,SACR,YAAY;AAEd,QAAM,kBAAkB,MAAM,cAAc,YAC1C,QAAQ,QACR,UAAU;AAEZ,QAAM,qBAAqB,MAAM,cAAc,YAC7C,QAAQ,SACR,WAAW;AAEb,QAAM,aAAa,gBAAgB,cAAc,OAAO,QAAQ,EAAE,IAChE,CAAC,WAAW;IACV,GAAG;IACH,MAAM,iBAAiB,MAAM,MAAM,eAAe,cAAc;IAChE;AAEJ,QAAM,WAAW,oBAAoB,gBAAgB;AACrD,QAAM,mBAAmB,MAAM,qBAC7B,UACA,eACA,cAAc;AAEhB,QAAM,OAAO,oBACX,CAAC,GAAG,YAAY,GAAG,gBAAgB,GACnC,QAAQ,MACR,WAAW,SAAS,KAAK,SAAS,SAAS,CAAC;AAE9C,QAAM,UAAU,mBAAmB,eAAe,EAAE,IAAI,CAAC,UACvD,iBAAiB,OAAO,eAAe,cAAc,CAAC;AAExD,QAAM,aAAa,oBAAoB,kBAAkB;AACzD,QAAM,eACJ,KAAK,SAAS,KAAK,QAAQ,SAAS,KAAK,WAAW,SAAS;AAE/D,MAAI,CAAC,cAAc;AACjB,UAAM,UAAU,MAAM,WACpB,QACA,IACA,SAAS,WACT,SAAS,aACT,aAAa,cAAc;AAE7B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,WAAW,QAAQ,EAAE,cAAc,UAAU,SAAS;IAClE;AACA,UAAM,SAAS,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AACzE,UAAMC,aACF,OAAO,SAAS,SAAqC,WAAW,KAEhD,CAAA;AACpB,WAAO,0BAA0B;MAC/B,IAAI,QAAQ;MACZ,WAAAA;MACA,SAAS;MACT;MACA;KACD;EACH;AAEA,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AACpE,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI,OAAO;IACX;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,YAAM,WAAW,SAAS;AAC1B,YAAM,OAAO;QACX,GAAK,SAAS,WAAW,KAAsC,CAAA;;AAEjE,YAAM,WAAW,8BACf,MACA,MACA,SACA,UAAU;AAEZ,YAAM,aAAa,2BACjB,MACA,SAAS,MACT,SAAS,SACT,OAAO,wBAAwB,QAAQ,iBAAiB,IAAI;AAE9D,UAAI,WAAW,SAAS,GAAG;AACzB,iBAAS,WAAW,IAAI;MAC1B,OAAO;AACL,eAAO,SAAS,WAAW;MAC7B;AACA,aAAO;QACL,eAAe,CAAC,WAAW;QAC3B,UACE,SAAS,QAAQ,IACb,CAAC,2BAA2B,SAAS,KAAK,EAAE,IAC5C,CAAA;;IAEV;GACD;AAED,QAAM,YACF,OAAO,KAAiC,WAAW,KAEnC,CAAA;AACpB,QAAM,mBAAmB,OAAO,SAAS,KAAK,CAAC,YAC7C,QAAQ,WAAW,0BAA0B,CAAC;AAEhD,QAAM,iBAAiB,mBACnB,OAAO,iBAAiB,MAAM,2BAA2B,MAAM,CAAC,IAChE;AACJ,SAAO,0BAA0B;IAC/B,IAAI,OAAO,KAAK;IAChB;IACA,SAAS;IACT,mBAAmB;IACnB;IACA;GACD;AACH;AAGM,SAAU,yBAGd,QAAgB,KAAQ;AACxB,QAAM,MAA+B,CAAA;AACrC,aAAW,CAAC,OAAO,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACnD,QAAI,UAAU,cAAc,MAAM,KAAK,IAAI;EAC7C;AACA,SAAO;AACT;",
+  "names": ["path", "global", "artifacts"]
+}

package/dist/cli-bundle/chunks/{chunk-RQAY7C5T.js → chunk-FJZDA6MS.js}

@@ -16,7 +16,7 @@ import {
   recordAfterCommandAffectedItem,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
@@ -31,7 +31,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   writeFileAtomic
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/copy.js
 function selectAuthor(explicitAuthor, settingsAuthor) {
@@ -172,6 +172,6 @@ async function runCopy(sourceId, options, global) {
 export {
   runCopy
 };
-//# sourceMappingURL=chunk-RQAY7C5T.js.map
+//# sourceMappingURL=chunk-FJZDA6MS.js.map
 
 //# debugId=10297567-d434-5182-abfd-6c340c9fde5c

package/dist/cli-bundle/chunks/{chunk-B4TVNGRX.js → chunk-FO7GMJKG.js}

@@ -1,6 +1,6 @@
 import {
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-XFEIASAC.js";
+} from "./chunk-2QIQGYPW.js";
 import {
   DEFAULT_EXTENSION_PRIORITY,
   EXIT_CODE,
@@ -9,7 +9,7 @@ import {
   isPathWithinDirectory,
   levenshteinDistanceWithinLimit,
   pathExists
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/cli/argv-utils.js
 !(function() {
@@ -872,4 +872,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-B4TVNGRX.js.map
+//# sourceMappingURL=chunk-FO7GMJKG.js.map

package/dist/cli-bundle/chunks/chunk-FRQ63VPB.js

@@ -0,0 +1,5 @@
+
+!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]="45eac7fa-f181-5cca-93b7-cfb58909dbb3")}catch(e){}}();
+//# sourceMappingURL=chunk-FRQ63VPB.js.map
+
+//# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3