@unbrained/pm-cli 2026.6.24 → 2026.6.30

package/dist/core/profile/profile-lint.js

@@ -0,0 +1,422 @@
+/**
+ * @module core/profile/profile-lint
+ *
+ * Author-time, tracker-independent consistency linting for a
+ * {@link ProjectProfileDefinition}. This is the project-profile analogue of the
+ * extension surface's `lintExtensionBlueprint`: where `defineProjectProfile`
+ * (and `api.registerProfile`) only assert structural shape, and
+ * {@link module:core/profile/profile-plan planProfileApplication} only validates
+ * config knobs fail-fast against a live tracker at apply time, this linter
+ * inspects a profile definition in isolation and reports *every* problem at once
+ * across all eight dimensions.
+ *
+ * Findings are graded:
+ * - `error` — a condition that makes `pm profile apply` throw or silently lose
+ *   data (an invalid type/status/field the upsert normalizer rejects, a
+ *   duplicate key whose later entry overwrites the earlier one, an unknown or
+ *   invalid config knob the planner rejects, an empty profile name resolution
+ *   requires, or a malformed workflow transition pair the workflow resolver
+ *   silently drops).
+ * - `warning` — authored content that is structurally valid but very likely a
+ *   bug (a workflow governing a type the profile never declares, a transition
+ *   referencing a status token no profile/built-in status defines — a dead,
+ *   unreachable rule — a template whose `type` references an undeclared type, a
+ *   profile name resolution would fold, or an empty title/summary/package spec).
+ *
+ * Cross-reference checks are warnings rather than errors because the referenced
+ * type or status MAY already exist in the target tracker independently of the
+ * profile (profiles layer onto whatever schema is present), so erroring would
+ * produce false positives against valid layered setups.
+ *
+ * Everything here is pure and side-effect-free so it is fully coverage-gated; the
+ * CLI `pm profile lint` command and the SDK `assertProjectProfile` helper are
+ * thin wrappers around {@link lintProjectProfile}.
+ */
+
+!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]="22ba01dc-013c-507c-b2f7-fbe6b71b3bc3")}catch(e){}}();
+import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
+import { parseNestedSettingValue, resolveNestedSettingDescriptor } from "../config/nested-settings.js";
+import { normalizeAddFieldInput } from "../schema/fields-file.js";
+import { normalizeAddStatusInput } from "../schema/status-defs-file.js";
+import { normalizeAddTypeInput } from "../schema/item-types-file.js";
+import { normalizeStatusToken } from "../schema/type-workflows.js";
+import { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from "../schema/runtime-schema.js";
+import { toErrorMessage } from "../shared/primitives.js";
+import { normalizeProfileLookupKey } from "./profile-presets.js";
+/** Profile dimension a lint finding is attributed to. */
+export const PROFILE_LINT_DIMENSIONS = [
+    "profile",
+    "types",
+    "statuses",
+    "fields",
+    "workflows",
+    "config",
+    "templates",
+    "packages",
+];
+/** Stable machine-readable codes every {@link ProjectProfileLintFinding} carries. */
+export const PROFILE_LINT_CODES = [
+    "profile_name_empty",
+    "profile_name_not_normalized",
+    "profile_title_empty",
+    "profile_summary_empty",
+    "type_invalid",
+    "type_duplicate",
+    "status_invalid",
+    "status_duplicate",
+    "field_invalid",
+    "field_duplicate",
+    "workflow_type_empty",
+    "workflow_type_unknown",
+    "workflow_duplicate_type",
+    "workflow_transition_malformed",
+    "workflow_status_unknown",
+    "config_key_unknown",
+    "config_value_invalid",
+    "config_duplicate",
+    "template_type_unknown",
+    "package_spec_empty",
+];
+/**
+ * Built-in status tokens (canonical ids and their aliases, normalized) every
+ * tracker recognizes regardless of profile. A workflow transition referencing one
+ * of these is always resolvable, so it never triggers a `workflow_status_unknown`
+ * warning. Computed once from the canonical defaults so it never drifts.
+ */
+const BUILTIN_STATUS_TOKENS = new Set(DEFAULT_RUNTIME_STATUS_DEFINITIONS.flatMap((definition) => [
+    normalizeStatusToken(definition.id),
+    ...(definition.aliases ?? []).map((alias) => normalizeStatusToken(alias)),
+]).filter((token) => token.length > 0));
+/** Built-in item type names, lower-cased for case-insensitive workflow/template matching. */
+const BUILTIN_TYPE_KEYS = new Set(BUILTIN_ITEM_TYPE_VALUES.map((name) => name.toLowerCase()));
+/** Lint the profile-level identity fields (name, title, summary). */
+function lintProfileIdentity(profile, findings) {
+    if (profile.name.trim().length === 0) {
+        findings.push({
+            severity: "error",
+            code: "profile_name_empty",
+            dimension: "profile",
+            message: "Profile name must not be empty; profile resolution requires a non-blank name.",
+        });
+    }
+    else if (profile.name !== normalizeProfileLookupKey(profile.name)) {
+        findings.push({
+            severity: "warning",
+            code: "profile_name_not_normalized",
+            dimension: "profile",
+            target: profile.name,
+            message: `Profile name "${profile.name}" is not in canonical form; resolution folds it to "${normalizeProfileLookupKey(profile.name)}" (lowercase, hyphens as underscores).`,
+        });
+    }
+    if (profile.title.trim().length === 0) {
+        findings.push({
+            severity: "warning",
+            code: "profile_title_empty",
+            dimension: "profile",
+            message: "Profile title is empty; list and show surfaces will render a blank title.",
+        });
+    }
+    if (profile.summary.trim().length === 0) {
+        findings.push({
+            severity: "warning",
+            code: "profile_summary_empty",
+            dimension: "profile",
+            message: "Profile summary is empty; list and show surfaces will render a blank archetype description.",
+        });
+    }
+}
+/**
+ * Lint the item types, returning the set of declared type keys (lower-cased)
+ * collected from entries that normalize cleanly so workflow and template checks
+ * can resolve cross-references against them.
+ */
+function lintTypes(profile, findings) {
+    const declared = new Set();
+    const seen = new Set();
+    for (const [index, type] of profile.types.entries()) {
+        let name;
+        try {
+            name = normalizeAddTypeInput(type).name;
+        }
+        catch (error) {
+            findings.push({
+                severity: "error",
+                code: "type_invalid",
+                dimension: "types",
+                target: typeof type.name === "string" ? type.name : `#${index}`,
+                message: toErrorMessage(error),
+            });
+            continue;
+        }
+        const key = name.toLowerCase();
+        if (seen.has(key)) {
+            findings.push({
+                severity: "error",
+                code: "type_duplicate",
+                dimension: "types",
+                target: name,
+                message: `Item type "${name}" is declared more than once; the later definition silently overwrites the earlier upsert.`,
+            });
+            continue;
+        }
+        seen.add(key);
+        declared.add(key);
+    }
+    return declared;
+}
+/**
+ * Lint the custom statuses, returning the set of declared status tokens (ids and
+ * aliases, normalized) collected from entries that normalize cleanly so workflow
+ * transition checks can resolve cross-references against them.
+ */
+function lintStatuses(profile, findings) {
+    const declared = new Set();
+    const seen = new Set();
+    for (const [index, status] of profile.statuses.entries()) {
+        let normalized;
+        try {
+            normalized = normalizeAddStatusInput(status);
+        }
+        catch (error) {
+            findings.push({
+                severity: "error",
+                code: "status_invalid",
+                dimension: "statuses",
+                target: typeof status.id === "string" ? status.id : `#${index}`,
+                message: toErrorMessage(error),
+            });
+            continue;
+        }
+        if (seen.has(normalized.id)) {
+            findings.push({
+                severity: "error",
+                code: "status_duplicate",
+                dimension: "statuses",
+                target: normalized.id,
+                message: `Status "${normalized.id}" is declared more than once; the later definition silently overwrites the earlier upsert.`,
+            });
+            continue;
+        }
+        seen.add(normalized.id);
+        declared.add(normalized.id);
+        for (const alias of normalized.aliases ?? []) {
+            declared.add(normalizeStatusToken(alias));
+        }
+    }
+    return declared;
+}
+/** Lint the custom fields for invalid and duplicate keys. */
+function lintFields(profile, findings) {
+    const seen = new Set();
+    for (const [index, field] of profile.fields.entries()) {
+        let key;
+        try {
+            key = normalizeAddFieldInput(field).key;
+        }
+        catch (error) {
+            findings.push({
+                severity: "error",
+                code: "field_invalid",
+                dimension: "fields",
+                target: typeof field.key === "string" ? field.key : `#${index}`,
+                message: toErrorMessage(error),
+            });
+            continue;
+        }
+        if (seen.has(key)) {
+            findings.push({
+                severity: "error",
+                code: "field_duplicate",
+                dimension: "fields",
+                target: key,
+                message: `Field "${key}" is declared more than once; the later definition silently overwrites the earlier upsert.`,
+            });
+            continue;
+        }
+        seen.add(key);
+    }
+}
+/**
+ * Lint the per-type workflows: flag workflows that govern an undeclared type,
+ * duplicate workflows for the same type, malformed transition pairs, and
+ * transitions referencing a status token no built-in or profile status defines.
+ */
+function lintWorkflows(profile, declaredTypes, declaredStatuses, findings) {
+    const seenTypes = new Set();
+    for (const [index, workflow] of profile.workflows.entries()) {
+        const typeKey = workflow.type.trim().toLowerCase();
+        if (typeKey.length === 0) {
+            findings.push({
+                severity: "error",
+                code: "workflow_type_empty",
+                dimension: "workflows",
+                target: `#${index}`,
+                message: "Workflow has an empty type; the workflow resolver drops entries without a type.",
+            });
+            continue;
+        }
+        const duplicate = seenTypes.has(typeKey);
+        seenTypes.add(typeKey);
+        if (duplicate) {
+            // The unknown-type check already fired for the first occurrence, so only
+            // report the duplication here to avoid a redundant second finding.
+            findings.push({
+                severity: "warning",
+                code: "workflow_duplicate_type",
+                dimension: "workflows",
+                target: workflow.type,
+                message: `Workflow type "${workflow.type}" is declared more than once; the later transition set wins.`,
+            });
+        }
+        else if (!BUILTIN_TYPE_KEYS.has(typeKey) && !declaredTypes.has(typeKey)) {
+            findings.push({
+                severity: "warning",
+                code: "workflow_type_unknown",
+                dimension: "workflows",
+                target: workflow.type,
+                message: `Workflow governs type "${workflow.type}" which is neither a built-in type nor declared by this profile; it has no effect unless that type already exists.`,
+            });
+        }
+        // Each unknown status is reported once per workflow (not globally) so a later
+        // workflow referencing the same unresolved token is still surfaced in its own
+        // context.
+        const reportedUnknownStatuses = new Set();
+        for (const pair of workflow.allowed_transitions) {
+            const from = normalizeStatusToken(pair[0]);
+            const to = normalizeStatusToken(pair[1]);
+            if (from.length === 0 || to.length === 0) {
+                findings.push({
+                    severity: "error",
+                    code: "workflow_transition_malformed",
+                    dimension: "workflows",
+                    target: workflow.type,
+                    message: `Workflow "${workflow.type}" has a transition with an empty status; the workflow resolver silently drops it.`,
+                });
+                continue;
+            }
+            for (const token of [from, to]) {
+                if (BUILTIN_STATUS_TOKENS.has(token) || declaredStatuses.has(token) || reportedUnknownStatuses.has(token)) {
+                    continue;
+                }
+                reportedUnknownStatuses.add(token);
+                findings.push({
+                    severity: "warning",
+                    code: "workflow_status_unknown",
+                    dimension: "workflows",
+                    target: token,
+                    message: `Workflow "${workflow.type}" references status "${token}" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`,
+                });
+            }
+        }
+    }
+}
+/**
+ * Lint the config knobs: resolve each descriptor, flag duplicates that would
+ * silently overwrite an earlier knob, and parse each value.
+ */
+function lintConfig(profile, findings) {
+    const seen = new Set();
+    for (const entry of profile.config) {
+        const descriptor = resolveNestedSettingDescriptor(entry.key);
+        if (descriptor === undefined) {
+            findings.push({
+                severity: "error",
+                code: "config_key_unknown",
+                dimension: "config",
+                target: entry.key,
+                message: `Config knob "${entry.key}" is not a recognized setting; apply rejects it with a usage error.`,
+            });
+            continue;
+        }
+        // Dedupe on the resolved descriptor key so two entries that differ only by
+        // alias/casing (e.g. `search-provider` and `search_provider`) are caught.
+        if (seen.has(descriptor.key)) {
+            findings.push({
+                severity: "error",
+                code: "config_duplicate",
+                dimension: "config",
+                target: descriptor.key,
+                message: `Config knob "${descriptor.key}" is set more than once; the later value silently overwrites the earlier one.`,
+            });
+        }
+        else {
+            seen.add(descriptor.key);
+        }
+        const parsed = parseNestedSettingValue(descriptor, entry.value);
+        if (!parsed.ok) {
+            findings.push({
+                severity: "error",
+                code: "config_value_invalid",
+                dimension: "config",
+                target: entry.key,
+                message: parsed.error.message,
+            });
+        }
+    }
+}
+/** Lint the create templates: flag a `type` option referencing an undeclared type. */
+function lintTemplates(profile, declaredTypes, findings) {
+    for (const template of profile.templates) {
+        const typeOption = template.options.type;
+        if (typeof typeOption !== "string" || typeOption.trim().length === 0) {
+            continue;
+        }
+        const typeKey = typeOption.trim().toLowerCase();
+        if (!BUILTIN_TYPE_KEYS.has(typeKey) && !declaredTypes.has(typeKey)) {
+            findings.push({
+                severity: "warning",
+                code: "template_type_unknown",
+                dimension: "templates",
+                target: template.name,
+                message: `Template "${template.name}" creates type "${typeOption}" which is neither a built-in type nor declared by this profile.`,
+            });
+        }
+    }
+}
+/** Lint the advisory package recommendations for an empty spec. */
+function lintPackages(profile, findings) {
+    for (const [index, recommendation] of profile.packages.entries()) {
+        if (recommendation.spec.trim().length === 0) {
+            findings.push({
+                severity: "warning",
+                code: "package_spec_empty",
+                dimension: "packages",
+                target: `#${index}`,
+                message: "Package recommendation has an empty spec; it cannot be surfaced as an install hint.",
+            });
+        }
+    }
+}
+/**
+ * Lints a project profile definition for internal consistency, returning every
+ * graded finding across all dimensions. Pure and tracker-independent: it never
+ * reads disk or settings, so authors can call it on a `defineProjectProfile`
+ * value, the CLI can call it on a resolved built-in or extension-contributed
+ * profile, and tests can gate against it.
+ *
+ * @param profile The profile definition to lint.
+ * @returns A report whose `ok` flag is true exactly when no `error` findings
+ *   were produced.
+ */
+export function lintProjectProfile(profile) {
+    const findings = [];
+    lintProfileIdentity(profile, findings);
+    const declaredTypes = lintTypes(profile, findings);
+    const declaredStatuses = lintStatuses(profile, findings);
+    lintFields(profile, findings);
+    lintWorkflows(profile, declaredTypes, declaredStatuses, findings);
+    lintConfig(profile, findings);
+    lintTemplates(profile, declaredTypes, findings);
+    lintPackages(profile, findings);
+    const errorCount = findings.filter((finding) => finding.severity === "error").length;
+    const warningCount = findings.length - errorCount;
+    return {
+        profile: profile.name,
+        ok: errorCount === 0,
+        findings,
+        errorCount,
+        warningCount,
+    };
+}
+//# sourceMappingURL=profile-lint.js.map
+//# debugId=22ba01dc-013c-507c-b2f7-fbe6b71b3bc3

package/dist/core/profile/profile-lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-lint.js","sources":["core/profile/profile-lint.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/profile/profile-lint\n *\n * Author-time, tracker-independent consistency linting for a\n * {@link ProjectProfileDefinition}. This is the project-profile analogue of the\n * extension surface's `lintExtensionBlueprint`: where `defineProjectProfile`\n * (and `api.registerProfile`) only assert structural shape, and\n * {@link module:core/profile/profile-plan planProfileApplication} only validates\n * config knobs fail-fast against a live tracker at apply time, this linter\n * inspects a profile definition in isolation and reports *every* problem at once\n * across all eight dimensions.\n *\n * Findings are graded:\n * - `error` — a condition that makes `pm profile apply` throw or silently lose\n *   data (an invalid type/status/field the upsert normalizer rejects, a\n *   duplicate key whose later entry overwrites the earlier one, an unknown or\n *   invalid config knob the planner rejects, an empty profile name resolution\n *   requires, or a malformed workflow transition pair the workflow resolver\n *   silently drops).\n * - `warning` — authored content that is structurally valid but very likely a\n *   bug (a workflow governing a type the profile never declares, a transition\n *   referencing a status token no profile/built-in status defines — a dead,\n *   unreachable rule — a template whose `type` references an undeclared type, a\n *   profile name resolution would fold, or an empty title/summary/package spec).\n *\n * Cross-reference checks are warnings rather than errors because the referenced\n * type or status MAY already exist in the target tracker independently of the\n * profile (profiles layer onto whatever schema is present), so erroring would\n * produce false positives against valid layered setups.\n *\n * Everything here is pure and side-effect-free so it is fully coverage-gated; the\n * CLI `pm profile lint` command and the SDK `assertProjectProfile` helper are\n * thin wrappers around {@link lintProjectProfile}.\n */\nimport { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport { parseNestedSettingValue, resolveNestedSettingDescriptor } from \"../config/nested-settings.js\";\nimport { normalizeAddFieldInput } from \"../schema/fields-file.js\";\nimport { normalizeAddStatusInput } from \"../schema/status-defs-file.js\";\nimport { normalizeAddTypeInput } from \"../schema/item-types-file.js\";\nimport { normalizeStatusToken } from \"../schema/type-workflows.js\";\nimport { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from \"../schema/runtime-schema.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { normalizeProfileLookupKey, type ProjectProfileDefinition } from \"./profile-presets.js\";\n\n/** Severity grade of a profile lint finding. */\nexport type ProfileLintSeverity = \"error\" | \"warning\";\n\n/** Profile dimension a lint finding is attributed to. */\nexport const PROFILE_LINT_DIMENSIONS = [\n  \"profile\",\n  \"types\",\n  \"statuses\",\n  \"fields\",\n  \"workflows\",\n  \"config\",\n  \"templates\",\n  \"packages\",\n] as const;\n/**\n * Restricts profile lint dimension values accepted by command, SDK, and storage contracts.\n */\nexport type ProfileLintDimension = (typeof PROFILE_LINT_DIMENSIONS)[number];\n\n/** Stable machine-readable codes every {@link ProjectProfileLintFinding} carries. */\nexport const PROFILE_LINT_CODES = [\n  \"profile_name_empty\",\n  \"profile_name_not_normalized\",\n  \"profile_title_empty\",\n  \"profile_summary_empty\",\n  \"type_invalid\",\n  \"type_duplicate\",\n  \"status_invalid\",\n  \"status_duplicate\",\n  \"field_invalid\",\n  \"field_duplicate\",\n  \"workflow_type_empty\",\n  \"workflow_type_unknown\",\n  \"workflow_duplicate_type\",\n  \"workflow_transition_malformed\",\n  \"workflow_status_unknown\",\n  \"config_key_unknown\",\n  \"config_value_invalid\",\n  \"config_duplicate\",\n  \"template_type_unknown\",\n  \"package_spec_empty\",\n] as const;\n/**\n * Restricts profile lint code values accepted by command, SDK, and storage contracts.\n */\nexport type ProfileLintCode = (typeof PROFILE_LINT_CODES)[number];\n\n/** A single graded consistency finding produced by {@link lintProjectProfile}. */\nexport interface ProjectProfileLintFinding {\n  /** Whether the finding blocks a clean apply (`error`) or merely flags risk (`warning`). */\n  severity: ProfileLintSeverity;\n  /** Stable machine-readable classification. */\n  code: ProfileLintCode;\n  /** Profile dimension the finding belongs to. */\n  dimension: ProfileLintDimension;\n  /** Identifier of the offending entry within the dimension, when applicable. */\n  target?: string;\n  /** Human-facing description of the problem. */\n  message: string;\n}\n\n/** Result of linting a single {@link ProjectProfileDefinition}. */\nexport interface ProjectProfileLintReport {\n  /** The profile name as authored (preserved verbatim, even when blank). */\n  profile: string;\n  /** True when no `error`-severity findings were produced. */\n  ok: boolean;\n  /** All findings in deterministic dimension order. */\n  findings: ProjectProfileLintFinding[];\n  /** Count of `error`-severity findings. */\n  errorCount: number;\n  /** Count of `warning`-severity findings. */\n  warningCount: number;\n}\n\n/**\n * Built-in status tokens (canonical ids and their aliases, normalized) every\n * tracker recognizes regardless of profile. A workflow transition referencing one\n * of these is always resolvable, so it never triggers a `workflow_status_unknown`\n * warning. Computed once from the canonical defaults so it never drifts.\n */\nconst BUILTIN_STATUS_TOKENS: ReadonlySet<string> = new Set(\n  DEFAULT_RUNTIME_STATUS_DEFINITIONS.flatMap((definition) => [\n    normalizeStatusToken(definition.id),\n    ...(definition.aliases ?? []).map((alias) => normalizeStatusToken(alias)),\n  ]).filter((token) => token.length > 0),\n);\n\n/** Built-in item type names, lower-cased for case-insensitive workflow/template matching. */\nconst BUILTIN_TYPE_KEYS: ReadonlySet<string> = new Set(BUILTIN_ITEM_TYPE_VALUES.map((name) => name.toLowerCase()));\n\n/** Lint the profile-level identity fields (name, title, summary). */\nfunction lintProfileIdentity(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): void {\n  if (profile.name.trim().length === 0) {\n    findings.push({\n      severity: \"error\",\n      code: \"profile_name_empty\",\n      dimension: \"profile\",\n      message: \"Profile name must not be empty; profile resolution requires a non-blank name.\",\n    });\n  } else if (profile.name !== normalizeProfileLookupKey(profile.name)) {\n    findings.push({\n      severity: \"warning\",\n      code: \"profile_name_not_normalized\",\n      dimension: \"profile\",\n      target: profile.name,\n      message: `Profile name \"${profile.name}\" is not in canonical form; resolution folds it to \"${normalizeProfileLookupKey(profile.name)}\" (lowercase, hyphens as underscores).`,\n    });\n  }\n  if (profile.title.trim().length === 0) {\n    findings.push({\n      severity: \"warning\",\n      code: \"profile_title_empty\",\n      dimension: \"profile\",\n      message: \"Profile title is empty; list and show surfaces will render a blank title.\",\n    });\n  }\n  if (profile.summary.trim().length === 0) {\n    findings.push({\n      severity: \"warning\",\n      code: \"profile_summary_empty\",\n      dimension: \"profile\",\n      message: \"Profile summary is empty; list and show surfaces will render a blank archetype description.\",\n    });\n  }\n}\n\n/**\n * Lint the item types, returning the set of declared type keys (lower-cased)\n * collected from entries that normalize cleanly so workflow and template checks\n * can resolve cross-references against them.\n */\nfunction lintTypes(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): Set<string> {\n  const declared = new Set<string>();\n  const seen = new Set<string>();\n  for (const [index, type] of profile.types.entries()) {\n    let name: string;\n    try {\n      name = normalizeAddTypeInput(type).name;\n    } catch (error) {\n      findings.push({\n        severity: \"error\",\n        code: \"type_invalid\",\n        dimension: \"types\",\n        target: typeof type.name === \"string\" ? type.name : `#${index}`,\n        message: toErrorMessage(error),\n      });\n      continue;\n    }\n    const key = name.toLowerCase();\n    if (seen.has(key)) {\n      findings.push({\n        severity: \"error\",\n        code: \"type_duplicate\",\n        dimension: \"types\",\n        target: name,\n        message: `Item type \"${name}\" is declared more than once; the later definition silently overwrites the earlier upsert.`,\n      });\n      continue;\n    }\n    seen.add(key);\n    declared.add(key);\n  }\n  return declared;\n}\n\n/**\n * Lint the custom statuses, returning the set of declared status tokens (ids and\n * aliases, normalized) collected from entries that normalize cleanly so workflow\n * transition checks can resolve cross-references against them.\n */\nfunction lintStatuses(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): Set<string> {\n  const declared = new Set<string>();\n  const seen = new Set<string>();\n  for (const [index, status] of profile.statuses.entries()) {\n    let normalized: ReturnType<typeof normalizeAddStatusInput>;\n    try {\n      normalized = normalizeAddStatusInput(status);\n    } catch (error) {\n      findings.push({\n        severity: \"error\",\n        code: \"status_invalid\",\n        dimension: \"statuses\",\n        target: typeof status.id === \"string\" ? status.id : `#${index}`,\n        message: toErrorMessage(error),\n      });\n      continue;\n    }\n    if (seen.has(normalized.id)) {\n      findings.push({\n        severity: \"error\",\n        code: \"status_duplicate\",\n        dimension: \"statuses\",\n        target: normalized.id,\n        message: `Status \"${normalized.id}\" is declared more than once; the later definition silently overwrites the earlier upsert.`,\n      });\n      continue;\n    }\n    seen.add(normalized.id);\n    declared.add(normalized.id);\n    for (const alias of normalized.aliases ?? []) {\n      declared.add(normalizeStatusToken(alias));\n    }\n  }\n  return declared;\n}\n\n/** Lint the custom fields for invalid and duplicate keys. */\nfunction lintFields(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): void {\n  const seen = new Set<string>();\n  for (const [index, field] of profile.fields.entries()) {\n    let key: string;\n    try {\n      key = normalizeAddFieldInput(field).key;\n    } catch (error) {\n      findings.push({\n        severity: \"error\",\n        code: \"field_invalid\",\n        dimension: \"fields\",\n        target: typeof field.key === \"string\" ? field.key : `#${index}`,\n        message: toErrorMessage(error),\n      });\n      continue;\n    }\n    if (seen.has(key)) {\n      findings.push({\n        severity: \"error\",\n        code: \"field_duplicate\",\n        dimension: \"fields\",\n        target: key,\n        message: `Field \"${key}\" is declared more than once; the later definition silently overwrites the earlier upsert.`,\n      });\n      continue;\n    }\n    seen.add(key);\n  }\n}\n\n/**\n * Lint the per-type workflows: flag workflows that govern an undeclared type,\n * duplicate workflows for the same type, malformed transition pairs, and\n * transitions referencing a status token no built-in or profile status defines.\n */\nfunction lintWorkflows(\n  profile: ProjectProfileDefinition,\n  declaredTypes: ReadonlySet<string>,\n  declaredStatuses: ReadonlySet<string>,\n  findings: ProjectProfileLintFinding[],\n): void {\n  const seenTypes = new Set<string>();\n  for (const [index, workflow] of profile.workflows.entries()) {\n    const typeKey = workflow.type.trim().toLowerCase();\n    if (typeKey.length === 0) {\n      findings.push({\n        severity: \"error\",\n        code: \"workflow_type_empty\",\n        dimension: \"workflows\",\n        target: `#${index}`,\n        message: \"Workflow has an empty type; the workflow resolver drops entries without a type.\",\n      });\n      continue;\n    }\n    const duplicate = seenTypes.has(typeKey);\n    seenTypes.add(typeKey);\n    if (duplicate) {\n      // The unknown-type check already fired for the first occurrence, so only\n      // report the duplication here to avoid a redundant second finding.\n      findings.push({\n        severity: \"warning\",\n        code: \"workflow_duplicate_type\",\n        dimension: \"workflows\",\n        target: workflow.type,\n        message: `Workflow type \"${workflow.type}\" is declared more than once; the later transition set wins.`,\n      });\n    } else if (!BUILTIN_TYPE_KEYS.has(typeKey) && !declaredTypes.has(typeKey)) {\n      findings.push({\n        severity: \"warning\",\n        code: \"workflow_type_unknown\",\n        dimension: \"workflows\",\n        target: workflow.type,\n        message: `Workflow governs type \"${workflow.type}\" which is neither a built-in type nor declared by this profile; it has no effect unless that type already exists.`,\n      });\n    }\n    // Each unknown status is reported once per workflow (not globally) so a later\n    // workflow referencing the same unresolved token is still surfaced in its own\n    // context.\n    const reportedUnknownStatuses = new Set<string>();\n    for (const pair of workflow.allowed_transitions) {\n      const from = normalizeStatusToken(pair[0]);\n      const to = normalizeStatusToken(pair[1]);\n      if (from.length === 0 || to.length === 0) {\n        findings.push({\n          severity: \"error\",\n          code: \"workflow_transition_malformed\",\n          dimension: \"workflows\",\n          target: workflow.type,\n          message: `Workflow \"${workflow.type}\" has a transition with an empty status; the workflow resolver silently drops it.`,\n        });\n        continue;\n      }\n      for (const token of [from, to]) {\n        if (BUILTIN_STATUS_TOKENS.has(token) || declaredStatuses.has(token) || reportedUnknownStatuses.has(token)) {\n          continue;\n        }\n        reportedUnknownStatuses.add(token);\n        findings.push({\n          severity: \"warning\",\n          code: \"workflow_status_unknown\",\n          dimension: \"workflows\",\n          target: token,\n          message: `Workflow \"${workflow.type}\" references status \"${token}\" which is neither a built-in status nor declared by this profile; transitions to or from it are unreachable.`,\n        });\n      }\n    }\n  }\n}\n\n/**\n * Lint the config knobs: resolve each descriptor, flag duplicates that would\n * silently overwrite an earlier knob, and parse each value.\n */\nfunction lintConfig(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): void {\n  const seen = new Set<string>();\n  for (const entry of profile.config) {\n    const descriptor = resolveNestedSettingDescriptor(entry.key);\n    if (descriptor === undefined) {\n      findings.push({\n        severity: \"error\",\n        code: \"config_key_unknown\",\n        dimension: \"config\",\n        target: entry.key,\n        message: `Config knob \"${entry.key}\" is not a recognized setting; apply rejects it with a usage error.`,\n      });\n      continue;\n    }\n    // Dedupe on the resolved descriptor key so two entries that differ only by\n    // alias/casing (e.g. `search-provider` and `search_provider`) are caught.\n    if (seen.has(descriptor.key)) {\n      findings.push({\n        severity: \"error\",\n        code: \"config_duplicate\",\n        dimension: \"config\",\n        target: descriptor.key,\n        message: `Config knob \"${descriptor.key}\" is set more than once; the later value silently overwrites the earlier one.`,\n      });\n    } else {\n      seen.add(descriptor.key);\n    }\n    const parsed = parseNestedSettingValue(descriptor, entry.value);\n    if (!parsed.ok) {\n      findings.push({\n        severity: \"error\",\n        code: \"config_value_invalid\",\n        dimension: \"config\",\n        target: entry.key,\n        message: parsed.error.message,\n      });\n    }\n  }\n}\n\n/** Lint the create templates: flag a `type` option referencing an undeclared type. */\nfunction lintTemplates(\n  profile: ProjectProfileDefinition,\n  declaredTypes: ReadonlySet<string>,\n  findings: ProjectProfileLintFinding[],\n): void {\n  for (const template of profile.templates) {\n    const typeOption = template.options.type;\n    if (typeof typeOption !== \"string\" || typeOption.trim().length === 0) {\n      continue;\n    }\n    const typeKey = typeOption.trim().toLowerCase();\n    if (!BUILTIN_TYPE_KEYS.has(typeKey) && !declaredTypes.has(typeKey)) {\n      findings.push({\n        severity: \"warning\",\n        code: \"template_type_unknown\",\n        dimension: \"templates\",\n        target: template.name,\n        message: `Template \"${template.name}\" creates type \"${typeOption}\" which is neither a built-in type nor declared by this profile.`,\n      });\n    }\n  }\n}\n\n/** Lint the advisory package recommendations for an empty spec. */\nfunction lintPackages(profile: ProjectProfileDefinition, findings: ProjectProfileLintFinding[]): void {\n  for (const [index, recommendation] of profile.packages.entries()) {\n    if (recommendation.spec.trim().length === 0) {\n      findings.push({\n        severity: \"warning\",\n        code: \"package_spec_empty\",\n        dimension: \"packages\",\n        target: `#${index}`,\n        message: \"Package recommendation has an empty spec; it cannot be surfaced as an install hint.\",\n      });\n    }\n  }\n}\n\n/**\n * Lints a project profile definition for internal consistency, returning every\n * graded finding across all dimensions. Pure and tracker-independent: it never\n * reads disk or settings, so authors can call it on a `defineProjectProfile`\n * value, the CLI can call it on a resolved built-in or extension-contributed\n * profile, and tests can gate against it.\n *\n * @param profile The profile definition to lint.\n * @returns A report whose `ok` flag is true exactly when no `error` findings\n *   were produced.\n */\nexport function lintProjectProfile(profile: ProjectProfileDefinition): ProjectProfileLintReport {\n  const findings: ProjectProfileLintFinding[] = [];\n  lintProfileIdentity(profile, findings);\n  const declaredTypes = lintTypes(profile, findings);\n  const declaredStatuses = lintStatuses(profile, findings);\n  lintFields(profile, findings);\n  lintWorkflows(profile, declaredTypes, declaredStatuses, findings);\n  lintConfig(profile, findings);\n  lintTemplates(profile, declaredTypes, findings);\n  lintPackages(profile, findings);\n  const errorCount = findings.filter((finding) => finding.severity === \"error\").length;\n  const warningCount = findings.length - errorCount;\n  return {\n    profile: profile.name,\n    ok: errorCount === 0,\n    findings,\n    errorCount,\n    warningCount,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"22ba01dc-013c-507c-b2f7-fbe6b71b3bc3"}

package/dist/core/profile/profile-plan.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @module core/profile/profile-plan
+ *
+ * Pure planning for `pm profile apply`. Given a {@link ProjectProfileDefinition}
+ * and a snapshot of the current tracker state, computes an idempotent diff across
+ * every profile dimension (item types, statuses, fields, per-type workflows,
+ * config knobs, templates, and package recommendations) without touching disk.
+ *
+ * Idempotency is structural: each schema component is upserted onto a clone and
+ * the canonical serialization is compared before/after, so re-running `apply`
+ * against an already-applied profile reports every entry as `unchanged` and the
+ * command performs zero writes. The resulting files/settings the planner returns
+ * are exactly what the apply step persists, guaranteeing the dry-run preview and
+ * the real mutation never diverge.
+ */
+import { type ItemTypesFile } from "../schema/item-types-file.js";
+import { type StatusDefsFile } from "../schema/status-defs-file.js";
+import { type FieldsFile } from "../schema/fields-file.js";
+import type { TypeWorkflowDefinition } from "../../types.js";
+import type { ProfileTemplateOptions, ProjectProfileDefinition } from "./profile-presets.js";
+/** Per-entry change classification used across every profile dimension. */
+export type ProfileChangeStatus = "add" | "update" | "unchanged";
+/** A single staged change keyed by its component identifier. */
+export interface ProfileComponentChange {
+    /** Component identity (type name, status id, field key, etc.). */
+    key: string;
+    /** Whether the entry is new, an overwrite, or already current. */
+    status: ProfileChangeStatus;
+}
+/** Plan for a file-backed schema component (types/statuses/fields). */
+export interface ProfileSchemaPlan<TFile> {
+    /** Serialized file content to persist when `changed`. */
+    file: TFile;
+    /** Per-entry classifications in profile order. */
+    changes: ProfileComponentChange[];
+    /** True when at least one entry is add/update. */
+    changed: boolean;
+}
+/** A staged per-type workflow change plus the merged result list. */
+export interface ProfileWorkflowChange {
+    /** Item type the workflow governs. */
+    type: string;
+    /** Whether the workflow is new, changed, or already current. */
+    status: ProfileChangeStatus;
+}
+/** Plan for the `schema.type_workflows` settings subtree. */
+export interface ProfileWorkflowPlan {
+    /** Per-workflow classifications in profile order. */
+    changes: ProfileWorkflowChange[];
+    /** Full merged workflow list to persist when `changed`. */
+    result: TypeWorkflowDefinition[];
+    /** True when at least one workflow is add/update. */
+    changed: boolean;
+}
+/** A staged config knob plus the resolved settings path and typed value. */
+export interface ProfileConfigChange {
+    /** Descriptor key (snake_case). */
+    key: string;
+    /** Dotted PmSettings path the value writes to. */
+    path: string;
+    /** Typed leaf value to persist. */
+    value: string | number | boolean;
+    /** Whether the leaf is new, changed, or already current. */
+    status: ProfileChangeStatus;
+}
+/** Plan for the nested-settings knobs a profile stages. */
+export interface ProfileConfigPlan {
+    /** Per-knob classifications in profile order. */
+    changes: ProfileConfigChange[];
+    /** True when at least one knob is add/update. */
+    changed: boolean;
+}
+/** A staged create-template change. */
+export interface ProfileTemplateChange {
+    /** Template name. */
+    name: string;
+    /** Option payload to persist for the template. */
+    options: ProfileTemplateOptions;
+    /** Whether the template is new, changed, or already current. */
+    status: ProfileChangeStatus;
+}
+/** Plan for the create templates a profile stages. */
+export interface ProfileTemplatePlan {
+    /** Per-template classifications in profile order. */
+    changes: ProfileTemplateChange[];
+    /** True when at least one template is add/update. */
+    changed: boolean;
+}
+/** Advisory package recommendation with install status. */
+export interface ProfilePackagePlan {
+    /** Catalog alias or install spec. */
+    spec: string;
+    /** Why the archetype benefits from the package. */
+    reason: string;
+    /** `installed` when already present, otherwise `recommended`. */
+    status: "installed" | "recommended";
+}
+/** Current tracker state the planner diffs the profile against. */
+export interface ProfileCurrentState {
+    /** Raw `schema/types.json` content (or null when absent). */
+    typesRaw: string | null;
+    /** Raw status-defs file content (or null when absent). */
+    statusesRaw: string | null;
+    /** Raw fields file content (or null when absent). */
+    fieldsRaw: string | null;
+    /** Current `schema.type_workflows` entries. */
+    workflows: readonly TypeWorkflowDefinition[];
+    /** Settings object used to read current config leaf values. */
+    settings: unknown;
+    /** Existing stored template options keyed by template name. */
+    templates: ReadonlyMap<string, ProfileTemplateOptions>;
+    /** Install specs/aliases already present in the project. */
+    installedPackages: ReadonlySet<string>;
+}
+/** Complete idempotent plan for applying a profile. */
+export interface ProfileApplicationPlan {
+    /** Identifying metadata for the planned profile. */
+    profile: {
+        name: string;
+        title: string;
+        summary: string;
+    };
+    /** Item-type plan. */
+    types: ProfileSchemaPlan<ItemTypesFile>;
+    /** Status plan. */
+    statuses: ProfileSchemaPlan<StatusDefsFile>;
+    /** Field plan. */
+    fields: ProfileSchemaPlan<FieldsFile>;
+    /** Per-type workflow plan. */
+    workflows: ProfileWorkflowPlan;
+    /** Config-knob plan. */
+    config: ProfileConfigPlan;
+    /** Template plan. */
+    templates: ProfileTemplatePlan;
+    /** Advisory package recommendations. */
+    packages: ProfilePackagePlan[];
+    /** True when any dimension stages an add/update. */
+    changed: boolean;
+}
+/**
+ * Computes the complete idempotent application plan for a profile against the
+ * supplied tracker snapshot. The returned files/settings are exactly what the
+ * apply step persists; nothing here touches disk.
+ */
+export declare function planProfileApplication(profile: ProjectProfileDefinition, current: ProfileCurrentState): ProfileApplicationPlan;