@unbrained/pm-cli 2026.7.5 → 2026.7.6

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

@@ -1,207 +0,0 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c47d06d6-06dd-59ff-bc33-96613e4fdde4")}catch(e){}}();
-import {
-  verifyHistoryChain
-} from "./chunk-BFVHCAOO.js";
-import {
-  hashDocument
-} from "./chunk-57C2RLW5.js";
-import {
-  getHistoryPath,
-  writeFileAtomic
-} from "./chunk-YD5FML7K.js";
-
-// dist/core/history/drift-scan.js
-import fs from "fs/promises";
-import { createHash } from "node:crypto";
-import path from "node:path";
-var DRIFT_CACHE_VERSION = 3;
-var DRIFT_CACHE_FILENAME = "history-drift-cache.json";
-function getDriftCachePath(pmRoot) {
-  return path.join(pmRoot, "runtime", DRIFT_CACHE_FILENAME);
-}
-async function loadDriftCache(pmRoot) {
-  try {
-    const raw = await fs.readFile(getDriftCachePath(pmRoot), "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== "object" || parsed.entries === null) {
-      return null;
-    }
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-function isErrno(error, code) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === code;
-}
-function hashContent(raw) {
-  return createHash("sha256").update(raw).digest("hex");
-}
-async function readHistoryContentHash(historyPath) {
-  const raw = await fs.readFile(historyPath, "utf8");
-  return hashContent(raw);
-}
-async function verifyHistoryStream(historyPath) {
-  const raw = await fs.readFile(historyPath, "utf8");
-  const contentHash = hashContent(raw);
-  if (raw.trim().length === 0) {
-    return null;
-  }
-  const entries = [];
-  let latestAfterHash = null;
-  for (const line of raw.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (trimmed.length === 0) {
-      continue;
-    }
-    const parsed = JSON.parse(trimmed);
-    if (typeof parsed.after_hash !== "string" || parsed.after_hash.trim().length === 0) {
-      throw new Error("missing after_hash");
-    }
-    entries.push(parsed);
-    latestAfterHash = parsed.after_hash;
-  }
-  if (!latestAfterHash) {
-    return null;
-  }
-  return {
-    latestAfterHash,
-    chainOk: verifyHistoryChain(entries).ok,
-    contentHash
-  };
-}
-function cacheMetadataMatches(cached, stat) {
-  return cached !== void 0 && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size;
-}
-async function loadFreshStreamVerification(itemId, historyPath, accumulator) {
-  try {
-    const loaded = await verifyHistoryStream(historyPath);
-    if (!loaded) {
-      accumulator.missingStreams.push(itemId);
-      return null;
-    }
-    return loaded;
-  } catch {
-    accumulator.unreadableStreams.push(itemId);
-    return null;
-  }
-}
-async function resolveStreamVerification(params) {
-  const cachedContentHash = typeof params.cached?.content_hash === "string" && params.cached.content_hash.length > 0 ? params.cached.content_hash : void 0;
-  const canUseCache = cacheMetadataMatches(params.cached, params.stat) && cachedContentHash !== void 0 && params.cached !== void 0;
-  if (!canUseCache || !params.cached) {
-    return {
-      verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),
-      cacheDirty: true
-    };
-  }
-  let currentContentHash;
-  if (params.verifyCacheHitByContent) {
-    try {
-      currentContentHash = await readHistoryContentHash(params.historyPath);
-    } catch {
-      params.accumulator.unreadableStreams.push(params.itemId);
-      return { verification: null, cacheDirty: false };
-    }
-  } else {
-    currentContentHash = cachedContentHash;
-  }
-  if (!params.verifyCacheHitByContent || currentContentHash === cachedContentHash) {
-    return {
-      verification: {
-        latestAfterHash: params.cached.latest_after_hash,
-        chainOk: params.cached.chain_ok,
-        contentHash: currentContentHash
-      },
-      cacheDirty: false
-    };
-  }
-  return {
-    verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),
-    cacheDirty: true
-  };
-}
-async function scanHistoryDrift(pmRoot, items, options = {}) {
-  const accumulator = {
-    missingStreams: [],
-    unreadableStreams: [],
-    hashMismatches: [],
-    chainMismatches: []
-  };
-  const cache = await loadDriftCache(pmRoot);
-  const previousEntries = cache?.entries ?? {};
-  const nextEntries = {};
-  let cacheDirty = false;
-  const verifyCacheHitByContent = options.cacheHitVerification !== "metadata";
-  for (const item of items) {
-    const historyPath = getHistoryPath(pmRoot, item.id);
-    let stat;
-    try {
-      stat = await fs.stat(historyPath);
-    } catch (error) {
-      if (isErrno(error, "ENOENT")) {
-        accumulator.missingStreams.push(item.id);
-      } else {
-        accumulator.unreadableStreams.push(item.id);
-      }
-      continue;
-    }
-    const cached = previousEntries[item.id];
-    const resolved = await resolveStreamVerification({
-      itemId: item.id,
-      historyPath,
-      stat,
-      cached,
-      verifyCacheHitByContent,
-      accumulator
-    });
-    cacheDirty ||= resolved.cacheDirty;
-    if (!resolved.verification) {
-      continue;
-    }
-    if (!resolved.verification.chainOk) {
-      accumulator.chainMismatches.push(item.id);
-    }
-    nextEntries[item.id] = {
-      mtime_ms: stat.mtimeMs,
-      ctime_ms: stat.ctimeMs,
-      size: stat.size,
-      content_hash: resolved.verification.contentHash,
-      latest_after_hash: resolved.verification.latestAfterHash,
-      chain_ok: resolved.verification.chainOk
-    };
-    const { body, ...frontMatter } = item;
-    const currentHash = hashDocument({
-      metadata: frontMatter,
-      body
-    });
-    if (currentHash !== resolved.verification.latestAfterHash) {
-      accumulator.hashMismatches.push(item.id);
-    }
-  }
-  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {
-    const cachePath = getDriftCachePath(pmRoot);
-    try {
-      await fs.mkdir(path.dirname(cachePath), { recursive: true });
-      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));
-    } catch {
-    }
-  }
-  const driftedItems = [
-    .../* @__PURE__ */ new Set([
-      ...accumulator.missingStreams,
-      ...accumulator.unreadableStreams,
-      ...accumulator.hashMismatches,
-      ...accumulator.chainMismatches
-    ])
-  ].sort((a, b) => a.localeCompare(b));
-  return { ...accumulator, driftedItems };
-}
-
-export {
-  scanHistoryDrift
-};
-//# sourceMappingURL=chunk-TT42JUMF.js.map
-
-//# debugId=c47d06d6-06dd-59ff-bc33-96613e4fdde4

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

@@ -1,165 +0,0 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e578f2d0-df56-5377-b6dd-eb1c1c999ab6")}catch(e){}}();
-import {
-  normalizeAddFieldInput,
-  normalizeAddStatusInput,
-  parseFieldsFile,
-  parseStatusDefsFile,
-  serializeFieldsFile,
-  serializeStatusDefsFile,
-  upsertField,
-  upsertStatusDef
-} from "./chunk-ZAHXPXVY.js";
-import {
-  parseNestedSettingValue,
-  readNestedSettingValue,
-  resolveNestedSettingDescriptor
-} from "./chunk-7LQKVMPA.js";
-import {
-  normalizeAddTypeInput,
-  parseItemTypesFile,
-  serializeItemTypesFile,
-  upsertItemType
-} from "./chunk-NER3KUUS.js";
-
-// dist/core/profile/profile-describe.js
-function describeProfileComposition(profile) {
-  return {
-    types: profile.types.length,
-    statuses: profile.statuses.length,
-    fields: profile.fields.length,
-    workflows: profile.workflows.length,
-    config: profile.config.length,
-    templates: profile.templates.length,
-    packages: profile.packages.length
-  };
-}
-function describeProjectProfile(profile) {
-  return {
-    name: profile.name,
-    title: profile.title,
-    summary: profile.summary,
-    composition: describeProfileComposition(profile),
-    types: profile.types.map((type) => lenientIdentifier(() => normalizeAddTypeInput(type).name, () => String(type.name ?? ""))),
-    statuses: profile.statuses.map((status) => lenientIdentifier(() => normalizeAddStatusInput(status).id, () => String(status.id ?? ""))),
-    fields: profile.fields.map((field) => lenientIdentifier(() => normalizeAddFieldInput(field).key, () => String(field.key ?? ""))),
-    workflows: profile.workflows.map((workflow) => workflow.type),
-    config: profile.config.map((entry) => `${entry.key}=${entry.value}`),
-    templates: profile.templates.map((template) => template.name),
-    packages: profile.packages.map((recommendation) => ({ spec: recommendation.spec, reason: recommendation.reason }))
-  };
-}
-function lenientIdentifier(normalize, raw) {
-  try {
-    return normalize();
-  } catch {
-    return raw();
-  }
-}
-
-// dist/core/profile/profile-plan.js
-function planSchemaComponent(initialFile, inputs, keyOf, serialize, upsert) {
-  let file = initialFile;
-  const changes = [];
-  for (const input of inputs) {
-    const before = serialize(file);
-    const result = upsert(file, input);
-    const after = serialize(result.file);
-    file = result.file;
-    const status = before === after ? "unchanged" : result.replaced ? "update" : "add";
-    changes.push({ key: keyOf(input), status });
-  }
-  return { file, changes, changed: changes.some((change) => change.status !== "unchanged") };
-}
-function canonicalTransitions(transitions) {
-  return JSON.stringify(transitions.map((pair) => pair.join("\0")).sort());
-}
-function planWorkflows(current, desired) {
-  const result = current.map((entry) => ({ ...entry }));
-  const changes = [];
-  for (const workflow of desired) {
-    const index = result.findIndex((entry) => entry.type === workflow.type);
-    const next = { type: workflow.type, allowed_transitions: workflow.allowed_transitions };
-    if (index < 0) {
-      result.push(next);
-      changes.push({ type: workflow.type, status: "add" });
-    } else if (canonicalTransitions(result[index].allowed_transitions) === canonicalTransitions(workflow.allowed_transitions)) {
-      changes.push({ type: workflow.type, status: "unchanged" });
-    } else {
-      result[index] = next;
-      changes.push({ type: workflow.type, status: "update" });
-    }
-  }
-  return { changes, result, changed: changes.some((change) => change.status !== "unchanged") };
-}
-function planConfig(profile, settings) {
-  const changes = [];
-  for (const entry of profile.config) {
-    const descriptor = resolveNestedSettingDescriptor(entry.key);
-    if (descriptor === void 0) {
-      throw new Error(`Profile "${profile.name}" references unknown config key "${entry.key}".`);
-    }
-    const parsed = parseNestedSettingValue(descriptor, entry.value);
-    if (!parsed.ok) {
-      throw new Error(`Profile "${profile.name}" config ${entry.key}: ${parsed.error.message}`);
-    }
-    const current = readNestedSettingValue(settings, descriptor);
-    const status = current === null ? "add" : current === parsed.parsed.value ? "unchanged" : "update";
-    changes.push({ key: descriptor.key, path: descriptor.path, value: parsed.parsed.value, status });
-  }
-  return { changes, changed: changes.some((change) => change.status !== "unchanged") };
-}
-function canonicalTemplateOptions(options) {
-  const sorted = Object.entries(options).sort(([left], [right]) => left.localeCompare(right));
-  return JSON.stringify(sorted);
-}
-function planTemplates(profile, existing) {
-  const changes = [];
-  for (const template of profile.templates) {
-    const current = existing.get(template.name);
-    let status;
-    if (current === void 0) {
-      status = "add";
-    } else if (canonicalTemplateOptions(current) === canonicalTemplateOptions(template.options)) {
-      status = "unchanged";
-    } else {
-      status = "update";
-    }
-    changes.push({ name: template.name, options: template.options, status });
-  }
-  return { changes, changed: changes.some((change) => change.status !== "unchanged") };
-}
-function planProfileApplication(profile, current) {
-  const types = planSchemaComponent(parseItemTypesFile(current.typesRaw), profile.types, (input) => normalizeAddTypeInput(input).name, serializeItemTypesFile, (file, input) => upsertItemType(file, normalizeAddTypeInput(input)));
-  const statuses = planSchemaComponent(parseStatusDefsFile(current.statusesRaw), profile.statuses, (input) => normalizeAddStatusInput(input).id, serializeStatusDefsFile, (file, input) => upsertStatusDef(file, normalizeAddStatusInput(input)));
-  const fields = planSchemaComponent(parseFieldsFile(current.fieldsRaw), profile.fields, (input) => normalizeAddFieldInput(input).key, serializeFieldsFile, (file, input) => upsertField(file, normalizeAddFieldInput(input)));
-  const workflows = planWorkflows(current.workflows, profile.workflows);
-  const config = planConfig(profile, current.settings);
-  const templates = planTemplates(profile, current.templates);
-  const packages = profile.packages.map((recommendation) => ({
-    spec: recommendation.spec,
-    reason: recommendation.reason,
-    status: current.installedPackages.has(recommendation.spec) ? "installed" : "recommended"
-  }));
-  const changed = types.changed || statuses.changed || fields.changed || workflows.changed || config.changed || templates.changed;
-  return {
-    profile: { name: profile.name, title: profile.title, summary: profile.summary },
-    types,
-    statuses,
-    fields,
-    workflows,
-    config,
-    templates,
-    packages,
-    changed
-  };
-}
-
-export {
-  describeProfileComposition,
-  describeProjectProfile,
-  planProfileApplication
-};
-//# sourceMappingURL=chunk-UHKX7I75.js.map
-
-//# debugId=e578f2d0-df56-5377-b6dd-eb1c1c999ab6

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../core/profile/profile-describe.ts","../../../../../../../../core/profile/profile-plan.ts"],"sourcesContent":["/**\n * @module core/profile/profile-describe\n *\n * Author-time *describe* primitive for a {@link ProjectProfileDefinition}: the\n * project-profile analogue of the extension surface's `describeExtensionBlueprint`.\n * It distills a profile into a deterministic, side-effect-free summary — the\n * per-dimension counts plus the resolved entry identifiers — so the CLI\n * `pm profile show`/`list` formatters and SDK consumers share one source of truth\n * for \"what does this profile stage?\" rather than each recomputing it inline.\n *\n * Identifier derivation deliberately mirrors what {@link module:core/profile/profile-plan}\n * upserts: item type names, status ids, and field keys all flow through the same\n * `normalizeAddTypeInput` / `normalizeAddStatusInput` / `normalizeAddFieldInput`\n * canonicalization the planner uses, so describe reports the exact ids/keys\n * `pm profile apply` stages (not the author's raw casing/spelling). Workflows,\n * config, templates, and packages surface their authored identity verbatim.\n *\n * Describe is intentionally lenient: it feeds read-only `pm profile show`/`list`,\n * so a semantically-invalid entry from an untrusted extension-contributed profile\n * (a built-in-named or empty type/status/field the normalizer rejects) falls back\n * to its raw identifier rather than throwing — surfacing the actual defect is the\n * job of {@link module:core/profile/profile-lint lintProjectProfile}, not describe.\n */\nimport { normalizeAddFieldInput } from \"../schema/fields-file.js\";\nimport { normalizeAddStatusInput } from \"../schema/status-defs-file.js\";\nimport { normalizeAddTypeInput } from \"../schema/item-types-file.js\";\nimport type { ProjectProfileDefinition } from \"./profile-presets.js\";\n\n/** Per-dimension counts summarizing how much a profile stages. */\nexport interface ProjectProfileComposition {\n  /** Number of item types the profile registers. */\n  types: number;\n  /** Number of custom statuses. */\n  statuses: number;\n  /** Number of custom fields. */\n  fields: number;\n  /** Number of per-type workflows. */\n  workflows: number;\n  /** Number of config knobs. */\n  config: number;\n  /** Number of create templates. */\n  templates: number;\n  /** Number of recommended packages. */\n  packages: number;\n}\n\n/** A package recommendation distilled to its spec and rationale. */\nexport interface ProjectProfilePackageSummary {\n  /** Catalog alias or install spec. */\n  spec: string;\n  /** Why the archetype benefits from the package. */\n  reason: string;\n}\n\n/** Deterministic summary of a profile's composition produced by {@link describeProjectProfile}. */\nexport interface ProjectProfileDescription {\n  /** Profile name. */\n  name: string;\n  /** Display title. */\n  title: string;\n  /** One-line archetype summary. */\n  summary: string;\n  /** Per-dimension counts. */\n  composition: ProjectProfileComposition;\n  /** Canonical item type names the profile registers. */\n  types: string[];\n  /** Custom status ids. */\n  statuses: string[];\n  /** Custom field keys. */\n  fields: string[];\n  /** Item types governed by a staged workflow. */\n  workflows: string[];\n  /** Config knobs as `key=value` pairs. */\n  config: string[];\n  /** Template names the profile stages. */\n  templates: string[];\n  /** Recommended package specs with rationale. */\n  packages: ProjectProfilePackageSummary[];\n}\n\n/**\n * Computes the per-dimension counts for a profile.\n */\nexport function describeProfileComposition(profile: ProjectProfileDefinition): ProjectProfileComposition {\n  return {\n    types: profile.types.length,\n    statuses: profile.statuses.length,\n    fields: profile.fields.length,\n    workflows: profile.workflows.length,\n    config: profile.config.length,\n    templates: profile.templates.length,\n    packages: profile.packages.length,\n  };\n}\n\n/**\n * Distills a profile definition into a deterministic composition summary. Pure\n * and tracker-independent; the resolved identifiers match exactly what\n * `pm profile apply` stages for each dimension.\n *\n * @param profile The profile definition to describe.\n * @returns The profile's metadata, per-dimension counts, and resolved entry\n *   identifiers.\n */\nexport function describeProjectProfile(profile: ProjectProfileDefinition): ProjectProfileDescription {\n  return {\n    name: profile.name,\n    title: profile.title,\n    summary: profile.summary,\n    composition: describeProfileComposition(profile),\n    types: profile.types.map((type) =>\n      lenientIdentifier(() => normalizeAddTypeInput(type).name, () => String(type.name ?? \"\")),\n    ),\n    statuses: profile.statuses.map((status) =>\n      lenientIdentifier(() => normalizeAddStatusInput(status).id, () => String(status.id ?? \"\")),\n    ),\n    fields: profile.fields.map((field) =>\n      lenientIdentifier(() => normalizeAddFieldInput(field).key, () => String(field.key ?? \"\")),\n    ),\n    workflows: profile.workflows.map((workflow) => workflow.type),\n    config: profile.config.map((entry) => `${entry.key}=${entry.value}`),\n    templates: profile.templates.map((template) => template.name),\n    packages: profile.packages.map((recommendation) => ({ spec: recommendation.spec, reason: recommendation.reason })),\n  };\n}\n\n/**\n * Resolves a dimension entry's identifier through the planner's canonicalizing\n * normalizer so describe reports exactly what `pm profile apply` stages, falling\n * back to the entry's raw identifier when the normalizer rejects a semantically\n * invalid value (a built-in-named or empty type/status/field) — surfacing the\n * defect is the job of {@link module:core/profile/profile-lint}, not describe.\n */\nfunction lenientIdentifier(normalize: () => string, raw: () => string): string {\n  try {\n    return normalize();\n  } catch {\n    return raw();\n  }\n}\n","/**\n * @module core/profile/profile-plan\n *\n * Pure planning for `pm profile apply`. Given a {@link ProjectProfileDefinition}\n * and a snapshot of the current tracker state, computes an idempotent diff across\n * every profile dimension (item types, statuses, fields, per-type workflows,\n * config knobs, templates, and package recommendations) without touching disk.\n *\n * Idempotency is structural: each schema component is upserted onto a clone and\n * the canonical serialization is compared before/after, so re-running `apply`\n * against an already-applied profile reports every entry as `unchanged` and the\n * command performs zero writes. The resulting files/settings the planner returns\n * are exactly what the apply step persists, guaranteeing the dry-run preview and\n * the real mutation never diverge.\n */\nimport {\n  normalizeAddTypeInput,\n  parseItemTypesFile,\n  serializeItemTypesFile,\n  upsertItemType,\n  type ItemTypesFile,\n} from \"../schema/item-types-file.js\";\nimport {\n  normalizeAddStatusInput,\n  parseStatusDefsFile,\n  serializeStatusDefsFile,\n  upsertStatusDef,\n  type StatusDefsFile,\n} from \"../schema/status-defs-file.js\";\nimport {\n  normalizeAddFieldInput,\n  parseFieldsFile,\n  serializeFieldsFile,\n  upsertField,\n  type FieldsFile,\n} from \"../schema/fields-file.js\";\nimport {\n  parseNestedSettingValue,\n  readNestedSettingValue,\n  resolveNestedSettingDescriptor,\n} from \"../config/nested-settings.js\";\nimport type { TypeWorkflowDefinition } from \"../../types.js\";\nimport type {\n  ProfileTemplateOptions,\n  ProjectProfileDefinition,\n} from \"./profile-presets.js\";\n\n/** Per-entry change classification used across every profile dimension. */\nexport type ProfileChangeStatus = \"add\" | \"update\" | \"unchanged\";\n\n/** A single staged change keyed by its component identifier. */\nexport interface ProfileComponentChange {\n  /** Component identity (type name, status id, field key, etc.). */\n  key: string;\n  /** Whether the entry is new, an overwrite, or already current. */\n  status: ProfileChangeStatus;\n}\n\n/** Plan for a file-backed schema component (types/statuses/fields). */\nexport interface ProfileSchemaPlan<TFile> {\n  /** Serialized file content to persist when `changed`. */\n  file: TFile;\n  /** Per-entry classifications in profile order. */\n  changes: ProfileComponentChange[];\n  /** True when at least one entry is add/update. */\n  changed: boolean;\n}\n\n/** A staged per-type workflow change plus the merged result list. */\nexport interface ProfileWorkflowChange {\n  /** Item type the workflow governs. */\n  type: string;\n  /** Whether the workflow is new, changed, or already current. */\n  status: ProfileChangeStatus;\n}\n\n/** Plan for the `schema.type_workflows` settings subtree. */\nexport interface ProfileWorkflowPlan {\n  /** Per-workflow classifications in profile order. */\n  changes: ProfileWorkflowChange[];\n  /** Full merged workflow list to persist when `changed`. */\n  result: TypeWorkflowDefinition[];\n  /** True when at least one workflow is add/update. */\n  changed: boolean;\n}\n\n/** A staged config knob plus the resolved settings path and typed value. */\nexport interface ProfileConfigChange {\n  /** Descriptor key (snake_case). */\n  key: string;\n  /** Dotted PmSettings path the value writes to. */\n  path: string;\n  /** Typed leaf value to persist. */\n  value: string | number | boolean;\n  /** Whether the leaf is new, changed, or already current. */\n  status: ProfileChangeStatus;\n}\n\n/** Plan for the nested-settings knobs a profile stages. */\nexport interface ProfileConfigPlan {\n  /** Per-knob classifications in profile order. */\n  changes: ProfileConfigChange[];\n  /** True when at least one knob is add/update. */\n  changed: boolean;\n}\n\n/** A staged create-template change. */\nexport interface ProfileTemplateChange {\n  /** Template name. */\n  name: string;\n  /** Option payload to persist for the template. */\n  options: ProfileTemplateOptions;\n  /** Whether the template is new, changed, or already current. */\n  status: ProfileChangeStatus;\n}\n\n/** Plan for the create templates a profile stages. */\nexport interface ProfileTemplatePlan {\n  /** Per-template classifications in profile order. */\n  changes: ProfileTemplateChange[];\n  /** True when at least one template is add/update. */\n  changed: boolean;\n}\n\n/** Advisory package recommendation with install status. */\nexport interface ProfilePackagePlan {\n  /** Catalog alias or install spec. */\n  spec: string;\n  /** Why the archetype benefits from the package. */\n  reason: string;\n  /** `installed` when already present, otherwise `recommended`. */\n  status: \"installed\" | \"recommended\";\n}\n\n/** Current tracker state the planner diffs the profile against. */\nexport interface ProfileCurrentState {\n  /** Raw `schema/types.json` content (or null when absent). */\n  typesRaw: string | null;\n  /** Raw status-defs file content (or null when absent). */\n  statusesRaw: string | null;\n  /** Raw fields file content (or null when absent). */\n  fieldsRaw: string | null;\n  /** Current `schema.type_workflows` entries. */\n  workflows: readonly TypeWorkflowDefinition[];\n  /** Settings object used to read current config leaf values. */\n  settings: unknown;\n  /** Existing stored template options keyed by template name. */\n  templates: ReadonlyMap<string, ProfileTemplateOptions>;\n  /** Install specs/aliases already present in the project. */\n  installedPackages: ReadonlySet<string>;\n}\n\n/** Complete idempotent plan for applying a profile. */\nexport interface ProfileApplicationPlan {\n  /** Identifying metadata for the planned profile. */\n  profile: { name: string; title: string; summary: string };\n  /** Item-type plan. */\n  types: ProfileSchemaPlan<ItemTypesFile>;\n  /** Status plan. */\n  statuses: ProfileSchemaPlan<StatusDefsFile>;\n  /** Field plan. */\n  fields: ProfileSchemaPlan<FieldsFile>;\n  /** Per-type workflow plan. */\n  workflows: ProfileWorkflowPlan;\n  /** Config-knob plan. */\n  config: ProfileConfigPlan;\n  /** Template plan. */\n  templates: ProfileTemplatePlan;\n  /** Advisory package recommendations. */\n  packages: ProfilePackagePlan[];\n  /** True when any dimension stages an add/update. */\n  changed: boolean;\n}\n\n/**\n * Plans a file-backed schema component by upserting each normalized input onto a\n * working clone and comparing canonical serializations to classify add/update/\n * unchanged. Shared by the type, status, and field planners.\n */\nfunction planSchemaComponent<TInput, TFile>(\n  initialFile: TFile,\n  inputs: readonly TInput[],\n  keyOf: (input: TInput) => string,\n  serialize: (file: TFile) => string,\n  upsert: (file: TFile, input: TInput) => { file: TFile; replaced: boolean },\n): ProfileSchemaPlan<TFile> {\n  let file = initialFile;\n  const changes: ProfileComponentChange[] = [];\n  for (const input of inputs) {\n    const before = serialize(file);\n    const result = upsert(file, input);\n    const after = serialize(result.file);\n    file = result.file;\n    const status: ProfileChangeStatus = before === after ? \"unchanged\" : result.replaced ? \"update\" : \"add\";\n    changes.push({ key: keyOf(input), status });\n  }\n  return { file, changes, changed: changes.some((change) => change.status !== \"unchanged\") };\n}\n\n/**\n * Canonicalizes an allowed-transition list to an order-independent string. The\n * transitions are a set of `[from, to]` pairs, so a stored list that merely\n * reorders the same pairs must not register as a spurious `update`.\n */\nfunction canonicalTransitions(transitions: readonly [string, string][]): string {\n  return JSON.stringify(transitions.map((pair) => pair.join(\"\u0000\")).sort());\n}\n\n/**\n * Plans the per-type workflow merge. A workflow whose transition set matches the\n * current entry (order-independent) is `unchanged`; a new type is `add`; a\n * changed transition set is `update`. The merged result preserves untouched\n * entries.\n */\nfunction planWorkflows(\n  current: readonly TypeWorkflowDefinition[],\n  desired: readonly TypeWorkflowDefinition[],\n): ProfileWorkflowPlan {\n  const result = current.map((entry) => ({ ...entry }));\n  const changes: ProfileWorkflowChange[] = [];\n  for (const workflow of desired) {\n    const index = result.findIndex((entry) => entry.type === workflow.type);\n    const next: TypeWorkflowDefinition = { type: workflow.type, allowed_transitions: workflow.allowed_transitions };\n    if (index < 0) {\n      result.push(next);\n      changes.push({ type: workflow.type, status: \"add\" });\n    } else if (canonicalTransitions(result[index].allowed_transitions) === canonicalTransitions(workflow.allowed_transitions)) {\n      changes.push({ type: workflow.type, status: \"unchanged\" });\n    } else {\n      result[index] = next;\n      changes.push({ type: workflow.type, status: \"update\" });\n    }\n  }\n  return { changes, result, changed: changes.some((change) => change.status !== \"unchanged\") };\n}\n\n/**\n * Plans config knobs by resolving each descriptor, coercing the value, and\n * comparing it against the current settings leaf. Throws a plain Error for an\n * unknown key or invalid value so the CLI can map it to a USAGE exit code.\n */\nfunction planConfig(profile: ProjectProfileDefinition, settings: unknown): ProfileConfigPlan {\n  const changes: ProfileConfigChange[] = [];\n  for (const entry of profile.config) {\n    const descriptor = resolveNestedSettingDescriptor(entry.key);\n    if (descriptor === undefined) {\n      throw new Error(`Profile \"${profile.name}\" references unknown config key \"${entry.key}\".`);\n    }\n    const parsed = parseNestedSettingValue(descriptor, entry.value);\n    if (!parsed.ok) {\n      throw new Error(`Profile \"${profile.name}\" config ${entry.key}: ${parsed.error.message}`);\n    }\n    // readNestedSettingValue returns `null` (never `undefined`) when the leaf is\n    // absent, so a null current is an unambiguous \"add\".\n    const current = readNestedSettingValue(settings, descriptor);\n    const status: ProfileChangeStatus =\n      current === null ? \"add\" : current === parsed.parsed.value ? \"unchanged\" : \"update\";\n    changes.push({ key: descriptor.key, path: descriptor.path, value: parsed.parsed.value, status });\n  }\n  return { changes, changed: changes.some((change) => change.status !== \"unchanged\") };\n}\n\n/**\n * Canonicalizes a template option payload to a key-order-independent string so a\n * profile's authored option order never produces a spurious `update` against the\n * key-sorted form `pm templates save` persists.\n */\nfunction canonicalTemplateOptions(options: ProfileTemplateOptions): string {\n  const sorted = Object.entries(options).sort(([left], [right]) => left.localeCompare(right));\n  return JSON.stringify(sorted);\n}\n\n/**\n * Plans create templates by comparing each profile template's option payload\n * against the stored template (if any). Equality is canonical so option key\n * ordering never produces a spurious `update`.\n */\nfunction planTemplates(\n  profile: ProjectProfileDefinition,\n  existing: ReadonlyMap<string, ProfileTemplateOptions>,\n): ProfileTemplatePlan {\n  const changes: ProfileTemplateChange[] = [];\n  for (const template of profile.templates) {\n    const current = existing.get(template.name);\n    let status: ProfileChangeStatus;\n    if (current === undefined) {\n      status = \"add\";\n    } else if (canonicalTemplateOptions(current) === canonicalTemplateOptions(template.options)) {\n      status = \"unchanged\";\n    } else {\n      status = \"update\";\n    }\n    changes.push({ name: template.name, options: template.options, status });\n  }\n  return { changes, changed: changes.some((change) => change.status !== \"unchanged\") };\n}\n\n/**\n * Computes the complete idempotent application plan for a profile against the\n * supplied tracker snapshot. The returned files/settings are exactly what the\n * apply step persists; nothing here touches disk.\n */\nexport function planProfileApplication(\n  profile: ProjectProfileDefinition,\n  current: ProfileCurrentState,\n): ProfileApplicationPlan {\n  const types = planSchemaComponent(\n    parseItemTypesFile(current.typesRaw),\n    profile.types,\n    (input) => normalizeAddTypeInput(input).name,\n    serializeItemTypesFile,\n    (file, input) => upsertItemType(file, normalizeAddTypeInput(input)),\n  );\n  const statuses = planSchemaComponent(\n    parseStatusDefsFile(current.statusesRaw),\n    profile.statuses,\n    (input) => normalizeAddStatusInput(input).id,\n    serializeStatusDefsFile,\n    (file, input) => upsertStatusDef(file, normalizeAddStatusInput(input)),\n  );\n  const fields = planSchemaComponent(\n    parseFieldsFile(current.fieldsRaw),\n    profile.fields,\n    (input) => normalizeAddFieldInput(input).key,\n    serializeFieldsFile,\n    (file, input) => upsertField(file, normalizeAddFieldInput(input)),\n  );\n  const workflows = planWorkflows(current.workflows, profile.workflows);\n  const config = planConfig(profile, current.settings);\n  const templates = planTemplates(profile, current.templates);\n  const packages = profile.packages.map((recommendation) => ({\n    spec: recommendation.spec,\n    reason: recommendation.reason,\n    status: current.installedPackages.has(recommendation.spec) ? (\"installed\" as const) : (\"recommended\" as const),\n  }));\n  const changed = types.changed || statuses.changed || fields.changed || workflows.changed || config.changed || templates.changed;\n  return {\n    profile: { name: profile.name, title: profile.title, summary: profile.summary },\n    types,\n    statuses,\n    fields,\n    workflows,\n    config,\n    templates,\n    packages,\n    changed,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAmFM,SAAU,2BAA2B,SAAiC;AAC1E,SAAO;IACL,OAAO,QAAQ,MAAM;IACrB,UAAU,QAAQ,SAAS;IAC3B,QAAQ,QAAQ,OAAO;IACvB,WAAW,QAAQ,UAAU;IAC7B,QAAQ,QAAQ,OAAO;IACvB,WAAW,QAAQ,UAAU;IAC7B,UAAU,QAAQ,SAAS;;AAE/B;AAWM,SAAU,uBAAuB,SAAiC;AACtE,SAAO;IACL,MAAM,QAAQ;IACd,OAAO,QAAQ;IACf,SAAS,QAAQ;IACjB,aAAa,2BAA2B,OAAO;IAC/C,OAAO,QAAQ,MAAM,IAAI,CAAC,SACxB,kBAAkB,MAAM,sBAAsB,IAAI,EAAE,MAAM,MAAM,OAAO,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE1F,UAAU,QAAQ,SAAS,IAAI,CAAC,WAC9B,kBAAkB,MAAM,wBAAwB,MAAM,EAAE,IAAI,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC,CAAC;IAE5F,QAAQ,QAAQ,OAAO,IAAI,CAAC,UAC1B,kBAAkB,MAAM,uBAAuB,KAAK,EAAE,KAAK,MAAM,OAAO,MAAM,OAAO,EAAE,CAAC,CAAC;IAE3F,WAAW,QAAQ,UAAU,IAAI,CAAC,aAAa,SAAS,IAAI;IAC5D,QAAQ,QAAQ,OAAO,IAAI,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,MAAM,KAAK,EAAE;IACnE,WAAW,QAAQ,UAAU,IAAI,CAAC,aAAa,SAAS,IAAI;IAC5D,UAAU,QAAQ,SAAS,IAAI,CAAC,oBAAoB,EAAE,MAAM,eAAe,MAAM,QAAQ,eAAe,OAAM,EAAG;;AAErH;AASA,SAAS,kBAAkB,WAAyB,KAAiB;AACnE,MAAI;AACF,WAAO,UAAS;EAClB,QAAQ;AACN,WAAO,IAAG;EACZ;AACF;;;ACwCA,SAAS,oBACP,aACA,QACA,OACA,WACA,QAA0E;AAE1E,MAAI,OAAO;AACX,QAAM,UAAoC,CAAA;AAC1C,aAAW,SAAS,QAAQ;AAC1B,UAAM,SAAS,UAAU,IAAI;AAC7B,UAAM,SAAS,OAAO,MAAM,KAAK;AACjC,UAAM,QAAQ,UAAU,OAAO,IAAI;AACnC,WAAO,OAAO;AACd,UAAM,SAA8B,WAAW,QAAQ,cAAc,OAAO,WAAW,WAAW;AAClG,YAAQ,KAAK,EAAE,KAAK,MAAM,KAAK,GAAG,OAAM,CAAE;EAC5C;AACA,SAAO,EAAE,MAAM,SAAS,SAAS,QAAQ,KAAK,CAAC,WAAW,OAAO,WAAW,WAAW,EAAC;AAC1F;AAOA,SAAS,qBAAqB,aAAwC;AACpE,SAAO,KAAK,UAAU,YAAY,IAAI,CAAC,SAAS,KAAK,KAAK,IAAG,CAAC,EAAE,KAAI,CAAE;AACxE;AAQA,SAAS,cACP,SACA,SAA0C;AAE1C,QAAM,SAAS,QAAQ,IAAI,CAAC,WAAW,EAAE,GAAG,MAAK,EAAG;AACpD,QAAM,UAAmC,CAAA;AACzC,aAAW,YAAY,SAAS;AAC9B,UAAM,QAAQ,OAAO,UAAU,CAAC,UAAU,MAAM,SAAS,SAAS,IAAI;AACtE,UAAM,OAA+B,EAAE,MAAM,SAAS,MAAM,qBAAqB,SAAS,oBAAmB;AAC7G,QAAI,QAAQ,GAAG;AACb,aAAO,KAAK,IAAI;AAChB,cAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,QAAQ,MAAK,CAAE;IACrD,WAAW,qBAAqB,OAAO,KAAK,EAAE,mBAAmB,MAAM,qBAAqB,SAAS,mBAAmB,GAAG;AACzH,cAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,QAAQ,YAAW,CAAE;IAC3D,OAAO;AACL,aAAO,KAAK,IAAI;AAChB,cAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,QAAQ,SAAQ,CAAE;IACxD;EACF;AACA,SAAO,EAAE,SAAS,QAAQ,SAAS,QAAQ,KAAK,CAAC,WAAW,OAAO,WAAW,WAAW,EAAC;AAC5F;AAOA,SAAS,WAAW,SAAmC,UAAiB;AACtE,QAAM,UAAiC,CAAA;AACvC,aAAW,SAAS,QAAQ,QAAQ;AAClC,UAAM,aAAa,+BAA+B,MAAM,GAAG;AAC3D,QAAI,eAAe,QAAW;AAC5B,YAAM,IAAI,MAAM,YAAY,QAAQ,IAAI,oCAAoC,MAAM,GAAG,IAAI;IAC3F;AACA,UAAM,SAAS,wBAAwB,YAAY,MAAM,KAAK;AAC9D,QAAI,CAAC,OAAO,IAAI;AACd,YAAM,IAAI,MAAM,YAAY,QAAQ,IAAI,YAAY,MAAM,GAAG,KAAK,OAAO,MAAM,OAAO,EAAE;IAC1F;AAGA,UAAM,UAAU,uBAAuB,UAAU,UAAU;AAC3D,UAAM,SACJ,YAAY,OAAO,QAAQ,YAAY,OAAO,OAAO,QAAQ,cAAc;AAC7E,YAAQ,KAAK,EAAE,KAAK,WAAW,KAAK,MAAM,WAAW,MAAM,OAAO,OAAO,OAAO,OAAO,OAAM,CAAE;EACjG;AACA,SAAO,EAAE,SAAS,SAAS,QAAQ,KAAK,CAAC,WAAW,OAAO,WAAW,WAAW,EAAC;AACpF;AAOA,SAAS,yBAAyB,SAA+B;AAC/D,QAAM,SAAS,OAAO,QAAQ,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAAM,KAAK,cAAc,KAAK,CAAC;AAC1F,SAAO,KAAK,UAAU,MAAM;AAC9B;AAOA,SAAS,cACP,SACA,UAAqD;AAErD,QAAM,UAAmC,CAAA;AACzC,aAAW,YAAY,QAAQ,WAAW;AACxC,UAAM,UAAU,SAAS,IAAI,SAAS,IAAI;AAC1C,QAAI;AACJ,QAAI,YAAY,QAAW;AACzB,eAAS;IACX,WAAW,yBAAyB,OAAO,MAAM,yBAAyB,SAAS,OAAO,GAAG;AAC3F,eAAS;IACX,OAAO;AACL,eAAS;IACX;AACA,YAAQ,KAAK,EAAE,MAAM,SAAS,MAAM,SAAS,SAAS,SAAS,OAAM,CAAE;EACzE;AACA,SAAO,EAAE,SAAS,SAAS,QAAQ,KAAK,CAAC,WAAW,OAAO,WAAW,WAAW,EAAC;AACpF;AAOM,SAAU,uBACd,SACA,SAA4B;AAE5B,QAAM,QAAQ,oBACZ,mBAAmB,QAAQ,QAAQ,GACnC,QAAQ,OACR,CAAC,UAAU,sBAAsB,KAAK,EAAE,MACxC,wBACA,CAAC,MAAM,UAAU,eAAe,MAAM,sBAAsB,KAAK,CAAC,CAAC;AAErE,QAAM,WAAW,oBACf,oBAAoB,QAAQ,WAAW,GACvC,QAAQ,UACR,CAAC,UAAU,wBAAwB,KAAK,EAAE,IAC1C,yBACA,CAAC,MAAM,UAAU,gBAAgB,MAAM,wBAAwB,KAAK,CAAC,CAAC;AAExE,QAAM,SAAS,oBACb,gBAAgB,QAAQ,SAAS,GACjC,QAAQ,QACR,CAAC,UAAU,uBAAuB,KAAK,EAAE,KACzC,qBACA,CAAC,MAAM,UAAU,YAAY,MAAM,uBAAuB,KAAK,CAAC,CAAC;AAEnE,QAAM,YAAY,cAAc,QAAQ,WAAW,QAAQ,SAAS;AACpE,QAAM,SAAS,WAAW,SAAS,QAAQ,QAAQ;AACnD,QAAM,YAAY,cAAc,SAAS,QAAQ,SAAS;AAC1D,QAAM,WAAW,QAAQ,SAAS,IAAI,CAAC,oBAAoB;IACzD,MAAM,eAAe;IACrB,QAAQ,eAAe;IACvB,QAAQ,QAAQ,kBAAkB,IAAI,eAAe,IAAI,IAAK,cAAyB;IACvF;AACF,QAAM,UAAU,MAAM,WAAW,SAAS,WAAW,OAAO,WAAW,UAAU,WAAW,OAAO,WAAW,UAAU;AACxH,SAAO;IACL,SAAS,EAAE,MAAM,QAAQ,MAAM,OAAO,QAAQ,OAAO,SAAS,QAAQ,QAAO;IAC7E;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;AAEJ","debugId":"e578f2d0-df56-5377-b6dd-eb1c1c999ab6"}