@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/pagination.js

@@ -1,163 +1,2 @@
-/**
- * @module sdk/pagination
- *
- * Provides versioned opaque cursor primitives shared by CLI, SDK, MCP, and
- * package-authored query surfaces.
- */
-
-!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]="d3329fac-693d-566c-a30a-43f8fb37938f")}catch(e){}}();
-import { createHash } from "node:crypto";
-import { PmCliError } from "../core/shared/errors.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { stableStringify } from "../core/shared/serialization.js";
-const QUERY_CURSOR_VERSION = 1;
-const MAX_CURSOR_LENGTH = 4096;
-const BASE64URL_PATTERN = /^[A-Za-z0-9_-]+$/;
-function optionKeyForFlag(flag) {
-    return flag
-        .replace(/^--/u, "")
-        .replace(/[-_]([a-z0-9])/gu, (_, character) => character.toUpperCase());
-}
-/**
- * Select the query-semantic portion of an options object from published flag
- * contracts. Query semantics are the compact fail-safe default; contracts
- * explicitly mark only presentation-only exceptions.
- */
-export function selectCursorSemanticOptions(options, contracts) {
-    const presentationKeys = new Set();
-    for (const contract of contracts) {
-        if (contract.cursor_semantics === "presentation") {
-            presentationKeys.add(optionKeyForFlag(contract.flag));
-            for (const alias of contract.aliases ?? []) {
-                presentationKeys.add(optionKeyForFlag(alias));
-            }
-        }
-    }
-    return Object.fromEntries(Object.entries(options).filter(([key]) => !presentationKeys.has(key)));
-}
-/** Build a compact deterministic fingerprint for a normalized query contract. */
-export function createQueryFingerprint(command, contract) {
-    return createHash("sha256")
-        .update(command)
-        .update("\0")
-        .update(stableStringify(contract))
-        .digest("hex")
-        .slice(0, 24);
-}
-/** Encode the last emitted item id into a versioned opaque base64url cursor. */
-export function encodeQueryCursor(fingerprint, afterId, afterIndex, snapshot) {
-    return Buffer.from(JSON.stringify({
-        version: QUERY_CURSOR_VERSION,
-        fingerprint,
-        after_id: afterId,
-        ...(afterIndex === undefined ? {} : { after_index: afterIndex }),
-        ...(snapshot === undefined ? {} : { snapshot }),
-    })).toString("base64url");
-}
-function invalidCursor(message) {
-    return new PmCliError(message, EXIT_CODE.USAGE, {
-        code: "invalid_query_cursor",
-        nextSteps: [
-            "Repeat the original query without --after to obtain a fresh cursor.",
-        ],
-    });
-}
-/** Return whether an unknown payload is a supported cursor envelope. */
-function isQueryCursorEnvelope(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return false;
-    }
-    const envelope = value;
-    return (envelope.version === QUERY_CURSOR_VERSION &&
-        typeof envelope.fingerprint === "string" &&
-        typeof envelope.after_id === "string" &&
-        envelope.after_id.length > 0 &&
-        (envelope.after_index === undefined ||
-            (Number.isSafeInteger(envelope.after_index) &&
-                envelope.after_index >= 0)) &&
-        (envelope.snapshot === undefined ||
-            (typeof envelope.snapshot === "string" && envelope.snapshot.length > 0)));
-}
-/** Decode and validate an opaque cursor without imposing caller query identity. */
-export function decodeQueryCursorEnvelope(cursor) {
-    if (typeof cursor !== "string") {
-        throw invalidCursor("Query cursor is malformed.");
-    }
-    const normalized = cursor.trim();
-    if (normalized.length === 0 ||
-        normalized.length > MAX_CURSOR_LENGTH ||
-        !BASE64URL_PATTERN.test(normalized)) {
-        throw invalidCursor("Query cursor is malformed.");
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(Buffer.from(normalized, "base64url").toString("utf8"));
-    }
-    catch {
-        throw invalidCursor("Query cursor is malformed.");
-    }
-    if (!isQueryCursorEnvelope(parsed)) {
-        throw invalidCursor("Query cursor version or payload is unsupported.");
-    }
-    return parsed;
-}
-/** Decode and validate complete cursor state against a query fingerprint. */
-export function decodeQueryCursorState(cursor, expectedFingerprint) {
-    const envelope = decodeQueryCursorEnvelope(cursor);
-    if (envelope.fingerprint !== expectedFingerprint) {
-        throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`);
-    }
-    return {
-        after_id: envelope.after_id,
-        ...(envelope.after_index === undefined
-            ? {}
-            : { after_index: envelope.after_index }),
-        ...(envelope.snapshot === undefined ? {} : { snapshot: envelope.snapshot }),
-    };
-}
-/** Decode and validate a cursor against the normalized query fingerprint. */
-export function decodeQueryCursor(cursor, expectedFingerprint) {
-    return decodeQueryCursorState(cursor, expectedFingerprint).after_id;
-}
-/** Resolve the first row after a validated cursor's stable id tiebreaker. */
-export function resolveQueryCursorStart(rows, cursor, fingerprint, readId) {
-    if (cursor === undefined) {
-        return 0;
-    }
-    const state = decodeQueryCursorState(cursor, fingerprint);
-    const index = rows.findIndex((row) => readId(row) === state.after_id);
-    if (index < 0) {
-        if (state.after_index !== undefined) {
-            return Math.min(state.after_index, rows.length);
-        }
-        throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`);
-    }
-    return index + 1;
-}
-/** Page an ordered result through the shared stable cursor contract. */
-export function paginateQueryRows(rows, options) {
-    if (options.cursor !== undefined &&
-        decodeQueryCursorState(options.cursor, options.fingerprint).snapshot !==
-            options.snapshot)
-        throw invalidCursor("Query cursor does not match the requested snapshot.");
-    const pageStart = resolveQueryCursorStart(rows, options.cursor, options.fingerprint, options.readId);
-    const pageRows = rows.slice(pageStart, pageStart + options.limit);
-    const hasMore = pageRows.length > 0 && pageStart + pageRows.length < rows.length;
-    const lastRow = pageRows.at(-1);
-    return {
-        rows: pageRows,
-        has_more: hasMore,
-        ...(hasMore && lastRow !== undefined
-            ? {
-                next_cursor: encodeQueryCursor(options.fingerprint, options.readId(lastRow), pageStart + pageRows.length - 1, options.snapshot),
-            }
-            : {}),
-    };
-}
-/** Public pagination constants exposed for package authors and contract tests. */
-export const QUERY_CURSOR_CONTRACT = Object.freeze({
-    version: QUERY_CURSOR_VERSION,
-    max_length: MAX_CURSOR_LENGTH,
-});
+!(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]="15037266-75b7-5f8d-9565-e7848e720a49")}catch(e2){}})();import{createHash}from"node:crypto";import{PmCliError}from"../core/shared/errors.js";import{EXIT_CODE}from"../core/shared/constants.js";import{stableStringify}from"../core/shared/serialization.js";const QUERY_CURSOR_VERSION=1;const MAX_CURSOR_LENGTH=4096;const BASE64URL_PATTERN=/^[A-Za-z0-9_-]+$/;function optionKeyForFlag(flag){return flag.replace(/^--/u,"").replace(/[-_]([a-z0-9])/gu,(_,character)=>character.toUpperCase())}function selectCursorSemanticOptions(options,contracts){const presentationKeys=new Set;for(const contract of contracts){if(contract.cursor_semantics==="presentation"){presentationKeys.add(optionKeyForFlag(contract.flag));for(const alias of contract.aliases??[]){presentationKeys.add(optionKeyForFlag(alias))}}}return Object.fromEntries(Object.entries(options).filter(([key])=>!presentationKeys.has(key)))}function createQueryFingerprint(command,contract){return createHash("sha256").update(command).update("\0").update(stableStringify(contract)).digest("hex").slice(0,24)}function encodeQueryCursor(fingerprint,afterId,afterIndex,snapshot){return Buffer.from(JSON.stringify({version:QUERY_CURSOR_VERSION,fingerprint,after_id:afterId,...afterIndex===void 0?{}:{after_index:afterIndex},...snapshot===void 0?{}:{snapshot}})).toString("base64url")}function invalidCursor(message){return new PmCliError(message,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:["Repeat the original query without --after to obtain a fresh cursor."]})}function isQueryCursorEnvelope(value){if(typeof value!=="object"||value===null||Array.isArray(value)){return false}const envelope=value;return envelope.version===QUERY_CURSOR_VERSION&&typeof envelope.fingerprint==="string"&&typeof envelope.after_id==="string"&&envelope.after_id.length>0&&(envelope.after_index===void 0||Number.isSafeInteger(envelope.after_index)&&envelope.after_index>=0)&&(envelope.snapshot===void 0||typeof envelope.snapshot==="string"&&envelope.snapshot.length>0)}function decodeQueryCursorEnvelope(cursor){if(typeof cursor!=="string"){throw invalidCursor("Query cursor is malformed.")}const normalized=cursor.trim();if(normalized.length===0||normalized.length>MAX_CURSOR_LENGTH||!BASE64URL_PATTERN.test(normalized)){throw invalidCursor("Query cursor is malformed.")}let parsed;try{parsed=JSON.parse(Buffer.from(normalized,"base64url").toString("utf8"))}catch{throw invalidCursor("Query cursor is malformed.")}if(!isQueryCursorEnvelope(parsed)){throw invalidCursor("Query cursor version or payload is unsupported.")}return parsed}function decodeQueryCursorState(cursor,expectedFingerprint){const envelope=decodeQueryCursorEnvelope(cursor);if(envelope.fingerprint!==expectedFingerprint){throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`)}return{after_id:envelope.after_id,...envelope.after_index===void 0?{}:{after_index:envelope.after_index},...envelope.snapshot===void 0?{}:{snapshot:envelope.snapshot}}}function decodeQueryCursor(cursor,expectedFingerprint){return decodeQueryCursorState(cursor,expectedFingerprint).after_id}function resolveQueryCursorStart(rows,cursor,fingerprint,readId){if(cursor===void 0){return 0}const state=decodeQueryCursorState(cursor,fingerprint);const index=rows.findIndex(row=>readId(row)===state.after_id);if(index<0){if(state.after_index!==void 0){return Math.min(state.after_index,rows.length)}throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`)}return index+1}function paginateQueryRows(rows,options){if(options.cursor!==void 0&&decodeQueryCursorState(options.cursor,options.fingerprint).snapshot!==options.snapshot)throw invalidCursor("Query cursor does not match the requested snapshot.");const pageStart=resolveQueryCursorStart(rows,options.cursor,options.fingerprint,options.readId);const pageRows=rows.slice(pageStart,pageStart+options.limit);const hasMore=pageRows.length>0&&pageStart+pageRows.length<rows.length;const lastRow=pageRows.at(-1);return{rows:pageRows,has_more:hasMore,...hasMore&&lastRow!==void 0?{next_cursor:encodeQueryCursor(options.fingerprint,options.readId(lastRow),pageStart+pageRows.length-1,options.snapshot)}:{}}}const QUERY_CURSOR_CONTRACT=Object.freeze({version:QUERY_CURSOR_VERSION,max_length:MAX_CURSOR_LENGTH});export{QUERY_CURSOR_CONTRACT,createQueryFingerprint,decodeQueryCursor,decodeQueryCursorEnvelope,decodeQueryCursorState,encodeQueryCursor,paginateQueryRows,resolveQueryCursorStart,selectCursorSemanticOptions};
 //# sourceMappingURL=pagination.js.map
-//# debugId=d3329fac-693d-566c-a30a-43f8fb37938f

package/dist/sdk/profile.js

@@ -1,455 +1,2 @@
-/**
- * @module sdk/profile
- *
- * Implements the `pm profile` command surface: listing the built-in project
- * archetypes, showing a profile's full composition, and applying a profile to an
- * initialized tracker. Apply stages item types, custom statuses, custom fields,
- * per-type workflows, config knobs, and create templates idempotently, and
- * surfaces advisory package recommendations. The pure diff lives in
- * {@link module:core/profile/profile-plan}; this module is the I/O orchestration
- * and human formatting around it.
- */
-
-!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]="f65b4f1f-5501-5829-a04b-d4fbcfb59f5c")}catch(e){}}();
-import { assertInitializedTracker } from "./environment/tracker-preflight.js";
-import path from "node:path";
-import { readFileIfExists, } from "../core/fs/fs-utils.js";
-import { writeWorkspaceJsonWithHistory } from "../core/history/workspace-history.js";
-import { acquireLock } from "../core/lock/lock.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { resolveAuthor } from "../core/shared/author.js";
-import { nowIso } from "../core/shared/time.js";
-import { resolvePmRoot } from "../core/store/paths.js";
-import { readSettings, resolveGovernanceKnobs, writeSettings, } from "../core/store/settings.js";
-import { DEFAULT_RUNTIME_SCHEMA_FILE_PATHS, filePathForSchemaSection, normalizeRuntimeSchemaSettings, } from "../core/schema/runtime-schema.js";
-import { normalizeAddTypeInput, serializeItemTypesFile, } from "../core/schema/item-types-file.js";
-import { serializeStatusDefsFile } from "../core/schema/status-defs-file.js";
-import { serializeFieldsFile } from "../core/schema/fields-file.js";
-import { resolveNestedSettingDescriptor, writeNestedSettingValue, } from "../core/config/nested-settings.js";
-import { getActiveExtensionRegistrations, runActiveOnWriteHooks, } from "../core/extensions/index.js";
-import { resolveProfileCatalog, resolveProfileEntry, } from "../core/profile/profile-presets.js";
-import { describeProfileComposition, describeProjectProfile, } from "../core/profile/profile-describe.js";
-import { lintProjectProfile, } from "../core/profile/profile-lint.js";
-import { planProfileApplication, } from "../core/profile/profile-plan.js";
-import { ensureTypeFolderScaffold } from "./schema.js";
-import { runTemplatesSave } from "./templates.js";
-/** Ordered `pm profile` subcommands. */
-export const PROFILE_SUBCOMMANDS = ["list", "show", "apply", "lint"];
-const PROFILE_TYPES_LOCK_ID = "schema-types";
-const PROFILE_STATUSES_LOCK_ID = "schema-statuses";
-const PROFILE_FIELDS_LOCK_ID = "schema-fields";
-/* c8 ignore start -- profile command I/O orchestration and formatting is covered by profile integration workflows; the idempotent diff is unit-tested in core/profile/profile-plan. */
-/** Collects the profiles contributed by active extensions, mapping the live registration registry onto the resolver's contribution shape. Returns an empty list when extensions are disabled or none registered a profile. */
-function collectExtensionProfileContributions() {
-    const registrations = getActiveExtensionRegistrations();
-    if (registrations === null) {
-        return [];
-    }
-    return registrations.profiles.map((entry) => ({
-        name: entry.name,
-        profile: entry.profile,
-    }));
-}
-/** Lists every available profile — the built-in archetypes followed by profiles contributed by active extensions — with per-dimension composition counts and the source each came from. Surfaces any non-fatal merge collisions as warnings. */
-export function runProfileList() {
-    const { profiles, warnings } = resolveProfileCatalog(collectExtensionProfileContributions());
-    return {
-        action: "list",
-        profiles: profiles.map((resolved) => ({
-            name: resolved.definition.name,
-            title: resolved.definition.title,
-            summary: resolved.definition.summary,
-            source: resolved.source,
-            ...(resolved.package !== undefined ? { package: resolved.package } : {}),
-            composition: describeProfileComposition(resolved.definition),
-        })),
-        warnings,
-        generated_at: nowIso(),
-    };
-}
-/** Shows the full composition of a single profile, resolved across built-in and extension-contributed archetypes. Throws a USAGE error for a missing or unknown profile name. */
-export function runProfileShow(name) {
-    let entry;
-    try {
-        entry = resolveProfileEntry(name, collectExtensionProfileContributions());
-    }
-    catch (error) {
-        throw new PmCliError(error instanceof Error ? error.message : String(error), EXIT_CODE.USAGE);
-    }
-    const { resolved } = entry;
-    return {
-        action: "show",
-        ...describeProjectProfile(resolved.definition),
-        source: resolved.source,
-        ...(resolved.package !== undefined ? { package: resolved.package } : {}),
-        warnings: entry.warnings,
-        generated_at: nowIso(),
-    };
-}
-/** Lints a single profile, resolved across built-in and extension-contributed archetypes, returning every graded consistency finding plus any catalog merge warnings. Throws a USAGE error for a missing or unknown profile name. This is the read-only author-time validation surface; it never writes to the tracker. */
-export function runProfileLint(name) {
-    let entry;
-    try {
-        entry = resolveProfileEntry(name, collectExtensionProfileContributions());
-    }
-    catch (error) {
-        throw new PmCliError(error instanceof Error ? error.message : String(error), EXIT_CODE.USAGE);
-    }
-    const { resolved } = entry;
-    const report = lintProjectProfile(resolved.definition);
-    return {
-        action: "lint",
-        name: resolved.definition.name,
-        title: resolved.definition.title,
-        source: resolved.source,
-        ...(resolved.package !== undefined ? { package: resolved.package } : {}),
-        ok: report.ok,
-        error_count: report.errorCount,
-        warning_count: report.warningCount,
-        findings: report.findings,
-        warnings: entry.warnings,
-        generated_at: nowIso(),
-    };
-}
-function templateFilePath(pmRoot, name) {
-    return path.join(pmRoot, "templates", `${name}.json`);
-}
-async function readStoredTemplateOptions(pmRoot, name) {
-    const raw = await readFileIfExists(templateFilePath(pmRoot, name));
-    if (raw === null) {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse(raw);
-        if (parsed !== null &&
-            typeof parsed === "object" &&
-            !Array.isArray(parsed)) {
-            const options = parsed.options;
-            if (options !== null &&
-                typeof options === "object" &&
-                !Array.isArray(options)) {
-                return options;
-            }
-        }
-    }
-    catch {
-        // A malformed template file is treated as absent so apply re-stages it.
-    }
-    return undefined;
-}
-async function loadProfileCurrentState(pmRoot, schema, settings, profile) {
-    const templates = new Map();
-    for (const template of profile.templates) {
-        const stored = await readStoredTemplateOptions(pmRoot, template.name);
-        if (stored !== undefined) {
-            templates.set(template.name, stored);
-        }
-    }
-    return {
-        typesRaw: await readFileIfExists(filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types)),
-        statusesRaw: await readFileIfExists(filePathForSchemaSection(pmRoot, schema.files.statuses, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses)),
-        fieldsRaw: await readFileIfExists(filePathForSchemaSection(pmRoot, schema.files.fields, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields)),
-        workflows: settings.schema.type_workflows ?? [],
-        settings,
-        templates,
-        // Package recommendations are advisory: apply never installs and never
-        // inspects install state, so every recommendation surfaces as "recommended".
-        // The planner still supports an install-state set for SDK consumers that want
-        // richer reporting.
-        installedPackages: new Set(),
-    };
-}
-function dimensionFrom(changes) {
-    const added = [];
-    const updated = [];
-    const unchanged = [];
-    for (const change of changes) {
-        (change.status === "add"
-            ? added
-            : change.status === "update"
-                ? updated
-                : unchanged).push(change.key);
-    }
-    return { added, updated, unchanged };
-}
-function buildApplyResult(profile, plan, applied, dryRun, warnings) {
-    return {
-        action: "apply",
-        name: profile.name,
-        title: profile.title,
-        applied,
-        dry_run: dryRun,
-        changed: plan.changed,
-        types: dimensionFrom(plan.types.changes),
-        statuses: dimensionFrom(plan.statuses.changes),
-        fields: dimensionFrom(plan.fields.changes),
-        workflows: dimensionFrom(plan.workflows.changes.map((change) => ({
-            key: change.type,
-            status: change.status,
-        }))),
-        config: dimensionFrom(plan.config.changes),
-        templates: dimensionFrom(plan.templates.changes.map((change) => ({
-            key: change.name,
-            status: change.status,
-        }))),
-        packages: plan.packages,
-        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
-        generated_at: nowIso(),
-    };
-}
-async function assertProfileTrackerInitialized(pmRoot) {
-    await assertInitializedTracker(pmRoot);
-}
-function resolveProfileForCommand(name) {
-    try {
-        const entry = resolveProfileEntry(name, collectExtensionProfileContributions());
-        return {
-            profile: entry.resolved.definition,
-            warnings: entry.warnings,
-        };
-    }
-    catch (error) {
-        throw new PmCliError(error instanceof Error ? error.message : String(error), EXIT_CODE.USAGE);
-    }
-}
-/** Applies a profile to the initialized tracker, or previews the idempotent diff when `dryRun` is set. Schema files are written under their respective locks; config and workflows are persisted to settings; templates are staged via the shared template writer. Re-applying an already-applied profile performs zero writes. Throws a USAGE error for an unknown profile or an invalid config knob, and a NOT_FOUND error when the tracker is not initialized. */
-export async function runProfileApply(name, options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertProfileTrackerInitialized(pmRoot);
-    // Catalog-level merge warnings (e.g. an extension profile shadowed by a
-    // built-in) seed the result so `apply` surfaces them the same way `list`
-    // does, rather than silently swallowing them.
-    const resolvedProfile = resolveProfileForCommand(name);
-    const profile = resolvedProfile.profile;
-    const mergeWarnings = resolvedProfile.warnings;
-    const dryRun = options.dryRun === true;
-    const settings = await readSettings(pmRoot);
-    const schema = normalizeRuntimeSchemaSettings(settings.schema);
-    if (dryRun) {
-        const state = await loadProfileCurrentState(pmRoot, schema, settings, profile);
-        const plan = planProfile(profile, state);
-        return buildApplyResult(profile, plan, false, true, [...mergeWarnings]);
-    }
-    const author = resolveAuthor(options.author, settings.author_default);
-    const governance = resolveGovernanceKnobs(settings);
-    const force = Boolean(options.force);
-    const warnings = [...mergeWarnings];
-    // Acquire all three schema locks inside the try so a later acquisition that
-    // throws (held/stale lock without --force) still releases the earlier ones in
-    // finally rather than stranding them until TTL expiry.
-    const releasers = [];
-    const acquire = async (lockId) => {
-        releasers.push(await acquireLock(pmRoot, lockId, settings.locks.ttl_seconds, author, force, governance.force_required_for_stale_lock, settings.locks.wait_ms));
-    };
-    let plan;
-    try {
-        await acquire(PROFILE_TYPES_LOCK_ID);
-        await acquire(PROFILE_STATUSES_LOCK_ID);
-        await acquire(PROFILE_FIELDS_LOCK_ID);
-        const state = await loadProfileCurrentState(pmRoot, schema, settings, profile);
-        plan = planProfile(profile, state);
-        if (plan.types.changed) {
-            const typesPath = filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);
-            await writeWorkspaceJsonWithHistory({
-                pmRoot,
-                filePath: typesPath,
-                raw: serializeItemTypesFile(plan.types.file),
-                op: "profile:apply-types",
-                author,
-                lockTtlSeconds: settings.locks.ttl_seconds,
-                lockWaitMs: settings.locks.wait_ms,
-            });
-            const stagedNames = new Set(profile.types.map((type) => normalizeAddTypeInput(type).name));
-            const stagedDefinitions = plan.types.file.definitions.filter((definition) => stagedNames.has(definition.name));
-            await ensureTypeFolderScaffold(pmRoot, stagedDefinitions, warnings, "profile:apply-type-folder");
-            warnings.push(...(await runActiveOnWriteHooks({
-                path: typesPath,
-                scope: "project",
-                op: "profile:apply-types",
-            })));
-        }
-        if (plan.statuses.changed) {
-            const statusesPath = filePathForSchemaSection(pmRoot, schema.files.statuses, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses);
-            await writeWorkspaceJsonWithHistory({
-                pmRoot,
-                filePath: statusesPath,
-                raw: serializeStatusDefsFile(plan.statuses.file),
-                op: "profile:apply-statuses",
-                author,
-                lockTtlSeconds: settings.locks.ttl_seconds,
-                lockWaitMs: settings.locks.wait_ms,
-            });
-            warnings.push(...(await runActiveOnWriteHooks({
-                path: statusesPath,
-                scope: "project",
-                op: "profile:apply-statuses",
-            })));
-        }
-        if (plan.fields.changed) {
-            const fieldsPath = filePathForSchemaSection(pmRoot, schema.files.fields, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields);
-            await writeWorkspaceJsonWithHistory({
-                pmRoot,
-                filePath: fieldsPath,
-                raw: serializeFieldsFile(plan.fields.file),
-                op: "profile:apply-fields",
-                author,
-                lockTtlSeconds: settings.locks.ttl_seconds,
-                lockWaitMs: settings.locks.wait_ms,
-            });
-            warnings.push(...(await runActiveOnWriteHooks({
-                path: fieldsPath,
-                scope: "project",
-                op: "profile:apply-fields",
-            })));
-        }
-        if (plan.config.changed || plan.workflows.changed) {
-            for (const change of plan.config.changes) {
-                if (change.status === "unchanged") {
-                    continue;
-                }
-                const descriptor = resolveNestedSettingDescriptor(change.key);
-                if (descriptor !== undefined) {
-                    writeNestedSettingValue(settings, descriptor, change.value);
-                }
-            }
-            settings.schema.type_workflows = plan.workflows.result;
-            await writeSettings(pmRoot, settings, "profile:apply-config");
-        }
-        for (const change of plan.templates.changes) {
-            if (change.status === "unchanged") {
-                continue;
-            }
-            await runTemplatesSave(change.name, { ...change.options }, global);
-        }
-    }
-    finally {
-        // Release in reverse acquisition order; only locks actually acquired are
-        // present. Each release is best-effort so one rejecting release never strands
-        // the remaining locks (a failed release falls back to TTL expiry).
-        for (const release of releasers.reverse()) {
-            try {
-                await release();
-            }
-            catch {
-                // Ignore: a failed lock release is non-fatal and self-heals at TTL.
-            }
-        }
-    }
-    return buildApplyResult(profile, plan, plan.changed, false, warnings);
-}
-// planProfileApplication can throw a plain Error for an invalid config knob; map
-// it to a USAGE exit code consistently across the dry-run and apply paths.
-function planProfile(profile, state) {
-    try {
-        return planProfileApplication(profile, state);
-    }
-    catch (error) {
-        throw new PmCliError(error instanceof Error ? error.message : String(error), EXIT_CODE.USAGE);
-    }
-}
-function formatDimensionLine(label, dimension) {
-    const segments = [];
-    if (dimension.added.length > 0) {
-        segments.push(`+${dimension.added.join(", ")}`);
-    }
-    if (dimension.updated.length > 0) {
-        segments.push(`~${dimension.updated.join(", ")}`);
-    }
-    if (segments.length === 0) {
-        return undefined;
-    }
-    return `  ${label}: ${segments.join("  ")}`;
-}
-/** Renders the `pm profile list` result as human-readable text. */
-export function formatProfileListHuman(result) {
-    const lines = ["Project profiles:"];
-    for (const profile of result.profiles) {
-        const origin = profile.source === "extension"
-            ? ` [${profile.package ?? "extension"}]`
-            : "";
-        lines.push(`  ${profile.name} — ${profile.title}: ${profile.summary}${origin}`);
-    }
-    for (const warning of result.warnings) {
-        lines.push(`  warning: ${warning}`);
-    }
-    return lines.join("\n");
-}
-/** Renders the `pm profile show` result as human-readable text. */
-export function formatProfileShowHuman(result) {
-    const origin = result.source === "extension" ? ` [${result.package ?? "extension"}]` : "";
-    const lines = [
-        `${result.name} — ${result.title}${origin}`,
-        result.summary,
-        "",
-    ];
-    lines.push(`types: ${result.types.join(", ") || "(none)"}`);
-    lines.push(`statuses: ${result.statuses.join(", ") || "(none)"}`);
-    lines.push(`fields: ${result.fields.join(", ") || "(none)"}`);
-    lines.push(`workflows: ${result.workflows.join(", ") || "(none)"}`);
-    lines.push(`config: ${result.config.join(", ") || "(none)"}`);
-    lines.push(`templates: ${result.templates.join(", ") || "(none)"}`);
-    lines.push(`packages: ${result.packages.map((pkg) => pkg.spec).join(", ") || "(none)"}`);
-    for (const warning of result.warnings) {
-        lines.push(`warning: ${warning}`);
-    }
-    return lines.join("\n");
-}
-/** Renders the `pm profile lint` result as human-readable text: a one-line verdict followed by each finding prefixed with its severity, code, and dimension. */
-export function formatProfileLintHuman(result) {
-    const origin = result.source === "extension" ? ` [${result.package ?? "extension"}]` : "";
-    // Catalog merge warnings are rendered below alongside lint-finding warnings, so
-    // fold them into the headline count to avoid an "ok (0 warnings)" verdict that
-    // is immediately followed by `warning:` lines.
-    const totalWarningCount = result.warning_count + result.warnings.length;
-    const verdict = result.ok
-        ? `Profile ${result.name}${origin}: ok (${totalWarningCount} warning${totalWarningCount === 1 ? "" : "s"})`
-        : `Profile ${result.name}${origin}: ${result.error_count} error${result.error_count === 1 ? "" : "s"}, ${totalWarningCount} warning${totalWarningCount === 1 ? "" : "s"}`;
-    const lines = [verdict];
-    for (const finding of result.findings) {
-        const target = finding.target !== undefined ? ` (${finding.target})` : "";
-        lines.push(`  ${finding.severity} [${finding.code}] ${finding.dimension}${target}: ${finding.message}`);
-    }
-    for (const warning of result.warnings) {
-        lines.push(`  warning: ${warning}`);
-    }
-    return lines.join("\n");
-}
-/** Renders the `pm profile apply` result as human-readable text, including the staged diff and any package recommendations. */
-export function formatProfileApplyHuman(result) {
-    const mode = result.dry_run
-        ? "dry-run"
-        : result.applied
-            ? "applied"
-            : "no changes";
-    const lines = [`Profile ${result.name} (${mode})`];
-    if (!result.changed) {
-        lines.push("  already up to date");
-    }
-    else {
-        for (const [label, dimension] of [
-            ["types", result.types],
-            ["statuses", result.statuses],
-            ["fields", result.fields],
-            ["workflows", result.workflows],
-            ["config", result.config],
-            ["templates", result.templates],
-        ]) {
-            const line = formatDimensionLine(label, dimension);
-            if (line !== undefined) {
-                lines.push(line);
-            }
-        }
-    }
-    const recommended = result.packages.filter((pkg) => pkg.status === "recommended");
-    if (recommended.length > 0) {
-        lines.push(`  recommended packages: ${recommended.map((pkg) => pkg.spec).join(", ")}`);
-    }
-    for (const warning of result.warnings) {
-        lines.push(`  warning: ${warning}`);
-    }
-    return lines.join("\n");
-}
-/* c8 ignore stop */
+!(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]="5529deea-21db-509b-9562-d5e08dfc004a")}catch(e2){}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import path from"node:path";import{readFileIfExists}from"../core/fs/fs-utils.js";import{writeWorkspaceJsonWithHistory}from"../core/history/workspace-history.js";import{acquireLock}from"../core/lock/lock.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveAuthor}from"../core/shared/author.js";import{nowIso}from"../core/shared/time.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings,resolveGovernanceKnobs,writeSettings}from"../core/store/settings.js";import{DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,filePathForSchemaSection,normalizeRuntimeSchemaSettings}from"../core/schema/runtime-schema.js";import{normalizeAddTypeInput,serializeItemTypesFile}from"../core/schema/item-types-file.js";import{serializeStatusDefsFile}from"../core/schema/status-defs-file.js";import{serializeFieldsFile}from"../core/schema/fields-file.js";import{resolveNestedSettingDescriptor,writeNestedSettingValue}from"../core/config/nested-settings.js";import{getActiveExtensionRegistrations,runActiveOnWriteHooks}from"../core/extensions/index.js";import{resolveProfileCatalog,resolveProfileEntry}from"../core/profile/profile-presets.js";import{describeProfileComposition,describeProjectProfile}from"../core/profile/profile-describe.js";import{lintProjectProfile}from"../core/profile/profile-lint.js";import{planProfileApplication}from"../core/profile/profile-plan.js";import{ensureTypeFolderScaffold}from"./schema.js";import{runTemplatesSave}from"./templates.js";const PROFILE_SUBCOMMANDS=["list","show","apply","lint"];const PROFILE_TYPES_LOCK_ID="schema-types";const PROFILE_STATUSES_LOCK_ID="schema-statuses";const PROFILE_FIELDS_LOCK_ID="schema-fields";function collectExtensionProfileContributions(){const registrations=getActiveExtensionRegistrations();if(registrations===null){return[]}return registrations.profiles.map(entry=>({name:entry.name,profile:entry.profile}))}function runProfileList(){const{profiles,warnings}=resolveProfileCatalog(collectExtensionProfileContributions());return{action:"list",profiles:profiles.map(resolved=>({name:resolved.definition.name,title:resolved.definition.title,summary:resolved.definition.summary,source:resolved.source,...resolved.package!==void 0?{package:resolved.package}:{},composition:describeProfileComposition(resolved.definition)})),warnings,generated_at:nowIso()}}function runProfileShow(name){let entry;try{entry=resolveProfileEntry(name,collectExtensionProfileContributions())}catch(error){throw new PmCliError(error instanceof Error?error.message:String(error),EXIT_CODE.USAGE)}const{resolved}=entry;return{action:"show",...describeProjectProfile(resolved.definition),source:resolved.source,...resolved.package!==void 0?{package:resolved.package}:{},warnings:entry.warnings,generated_at:nowIso()}}function runProfileLint(name){let entry;try{entry=resolveProfileEntry(name,collectExtensionProfileContributions())}catch(error){throw new PmCliError(error instanceof Error?error.message:String(error),EXIT_CODE.USAGE)}const{resolved}=entry;const report=lintProjectProfile(resolved.definition);return{action:"lint",name:resolved.definition.name,title:resolved.definition.title,source:resolved.source,...resolved.package!==void 0?{package:resolved.package}:{},ok:report.ok,error_count:report.errorCount,warning_count:report.warningCount,findings:report.findings,warnings:entry.warnings,generated_at:nowIso()}}function templateFilePath(pmRoot,name){return path.join(pmRoot,"templates",`${name}.json`)}async function readStoredTemplateOptions(pmRoot,name){const raw=await readFileIfExists(templateFilePath(pmRoot,name));if(raw===null){return void 0}try{const parsed=JSON.parse(raw);if(parsed!==null&&typeof parsed==="object"&&!Array.isArray(parsed)){const options=parsed.options;if(options!==null&&typeof options==="object"&&!Array.isArray(options)){return options}}}catch{}return void 0}async function loadProfileCurrentState(pmRoot,schema,settings,profile){const templates=new Map;for(const template of profile.templates){const stored=await readStoredTemplateOptions(pmRoot,template.name);if(stored!==void 0){templates.set(template.name,stored)}}return{typesRaw:await readFileIfExists(filePathForSchemaSection(pmRoot,schema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types)),statusesRaw:await readFileIfExists(filePathForSchemaSection(pmRoot,schema.files.statuses,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses)),fieldsRaw:await readFileIfExists(filePathForSchemaSection(pmRoot,schema.files.fields,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields)),workflows:settings.schema.type_workflows??[],settings,templates,installedPackages:new Set}}function dimensionFrom(changes){const added=[];const updated=[];const unchanged=[];for(const change of changes){(change.status==="add"?added:change.status==="update"?updated:unchanged).push(change.key)}return{added,updated,unchanged}}function buildApplyResult(profile,plan,applied,dryRun,warnings){return{action:"apply",name:profile.name,title:profile.title,applied,dry_run:dryRun,changed:plan.changed,types:dimensionFrom(plan.types.changes),statuses:dimensionFrom(plan.statuses.changes),fields:dimensionFrom(plan.fields.changes),workflows:dimensionFrom(plan.workflows.changes.map(change=>({key:change.type,status:change.status}))),config:dimensionFrom(plan.config.changes),templates:dimensionFrom(plan.templates.changes.map(change=>({key:change.name,status:change.status}))),packages:plan.packages,warnings:[...new Set(warnings)].sort((left,right)=>left.localeCompare(right)),generated_at:nowIso()}}async function assertProfileTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function resolveProfileForCommand(name){try{const entry=resolveProfileEntry(name,collectExtensionProfileContributions());return{profile:entry.resolved.definition,warnings:entry.warnings}}catch(error){throw new PmCliError(error instanceof Error?error.message:String(error),EXIT_CODE.USAGE)}}async function runProfileApply(name,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertProfileTrackerInitialized(pmRoot);const resolvedProfile=resolveProfileForCommand(name);const profile=resolvedProfile.profile;const mergeWarnings=resolvedProfile.warnings;const dryRun=options.dryRun===true;const settings=await readSettings(pmRoot);const schema=normalizeRuntimeSchemaSettings(settings.schema);if(dryRun){const state=await loadProfileCurrentState(pmRoot,schema,settings,profile);const plan2=planProfile(profile,state);return buildApplyResult(profile,plan2,false,true,[...mergeWarnings])}const author=resolveAuthor(options.author,settings.author_default);const governance=resolveGovernanceKnobs(settings);const force=Boolean(options.force);const warnings=[...mergeWarnings];const releasers=[];const acquire=async lockId=>{releasers.push(await acquireLock(pmRoot,lockId,settings.locks.ttl_seconds,author,force,governance.force_required_for_stale_lock,settings.locks.wait_ms))};let plan;try{await acquire(PROFILE_TYPES_LOCK_ID);await acquire(PROFILE_STATUSES_LOCK_ID);await acquire(PROFILE_FIELDS_LOCK_ID);const state=await loadProfileCurrentState(pmRoot,schema,settings,profile);plan=planProfile(profile,state);if(plan.types.changed){const typesPath=filePathForSchemaSection(pmRoot,schema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);await writeWorkspaceJsonWithHistory({pmRoot,filePath:typesPath,raw:serializeItemTypesFile(plan.types.file),op:"profile:apply-types",author,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});const stagedNames=new Set(profile.types.map(type=>normalizeAddTypeInput(type).name));const stagedDefinitions=plan.types.file.definitions.filter(definition=>stagedNames.has(definition.name));await ensureTypeFolderScaffold(pmRoot,stagedDefinitions,warnings,"profile:apply-type-folder");warnings.push(...await runActiveOnWriteHooks({path:typesPath,scope:"project",op:"profile:apply-types"}))}if(plan.statuses.changed){const statusesPath=filePathForSchemaSection(pmRoot,schema.files.statuses,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses);await writeWorkspaceJsonWithHistory({pmRoot,filePath:statusesPath,raw:serializeStatusDefsFile(plan.statuses.file),op:"profile:apply-statuses",author,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});warnings.push(...await runActiveOnWriteHooks({path:statusesPath,scope:"project",op:"profile:apply-statuses"}))}if(plan.fields.changed){const fieldsPath=filePathForSchemaSection(pmRoot,schema.files.fields,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields);await writeWorkspaceJsonWithHistory({pmRoot,filePath:fieldsPath,raw:serializeFieldsFile(plan.fields.file),op:"profile:apply-fields",author,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});warnings.push(...await runActiveOnWriteHooks({path:fieldsPath,scope:"project",op:"profile:apply-fields"}))}if(plan.config.changed||plan.workflows.changed){for(const change of plan.config.changes){if(change.status==="unchanged"){continue}const descriptor=resolveNestedSettingDescriptor(change.key);if(descriptor!==void 0){writeNestedSettingValue(settings,descriptor,change.value)}}settings.schema.type_workflows=plan.workflows.result;await writeSettings(pmRoot,settings,"profile:apply-config")}for(const change of plan.templates.changes){if(change.status==="unchanged"){continue}await runTemplatesSave(change.name,{...change.options},global2)}}finally{for(const release of releasers.reverse()){try{await release()}catch{}}}return buildApplyResult(profile,plan,plan.changed,false,warnings)}function planProfile(profile,state){try{return planProfileApplication(profile,state)}catch(error){throw new PmCliError(error instanceof Error?error.message:String(error),EXIT_CODE.USAGE)}}function formatDimensionLine(label,dimension){const segments=[];if(dimension.added.length>0){segments.push(`+${dimension.added.join(", ")}`)}if(dimension.updated.length>0){segments.push(`~${dimension.updated.join(", ")}`)}if(segments.length===0){return void 0}return`  ${label}: ${segments.join("  ")}`}function formatProfileListHuman(result){const lines=["Project profiles:"];for(const profile of result.profiles){const origin=profile.source==="extension"?` [${profile.package??"extension"}]`:"";lines.push(`  ${profile.name} \u2014 ${profile.title}: ${profile.summary}${origin}`)}for(const warning of result.warnings){lines.push(`  warning: ${warning}`)}return lines.join("\n")}function formatProfileShowHuman(result){const origin=result.source==="extension"?` [${result.package??"extension"}]`:"";const lines=[`${result.name} \u2014 ${result.title}${origin}`,result.summary,""];lines.push(`types: ${result.types.join(", ")||"(none)"}`);lines.push(`statuses: ${result.statuses.join(", ")||"(none)"}`);lines.push(`fields: ${result.fields.join(", ")||"(none)"}`);lines.push(`workflows: ${result.workflows.join(", ")||"(none)"}`);lines.push(`config: ${result.config.join(", ")||"(none)"}`);lines.push(`templates: ${result.templates.join(", ")||"(none)"}`);lines.push(`packages: ${result.packages.map(pkg=>pkg.spec).join(", ")||"(none)"}`);for(const warning of result.warnings){lines.push(`warning: ${warning}`)}return lines.join("\n")}function formatProfileLintHuman(result){const origin=result.source==="extension"?` [${result.package??"extension"}]`:"";const totalWarningCount=result.warning_count+result.warnings.length;const verdict=result.ok?`Profile ${result.name}${origin}: ok (${totalWarningCount} warning${totalWarningCount===1?"":"s"})`:`Profile ${result.name}${origin}: ${result.error_count} error${result.error_count===1?"":"s"}, ${totalWarningCount} warning${totalWarningCount===1?"":"s"}`;const lines=[verdict];for(const finding of result.findings){const target=finding.target!==void 0?` (${finding.target})`:"";lines.push(`  ${finding.severity} [${finding.code}] ${finding.dimension}${target}: ${finding.message}`)}for(const warning of result.warnings){lines.push(`  warning: ${warning}`)}return lines.join("\n")}function formatProfileApplyHuman(result){const mode=result.dry_run?"dry-run":result.applied?"applied":"no changes";const lines=[`Profile ${result.name} (${mode})`];if(!result.changed){lines.push("  already up to date")}else{for(const[label,dimension]of[["types",result.types],["statuses",result.statuses],["fields",result.fields],["workflows",result.workflows],["config",result.config],["templates",result.templates]]){const line=formatDimensionLine(label,dimension);if(line!==void 0){lines.push(line)}}}const recommended=result.packages.filter(pkg=>pkg.status==="recommended");if(recommended.length>0){lines.push(`  recommended packages: ${recommended.map(pkg=>pkg.spec).join(", ")}`)}for(const warning of result.warnings){lines.push(`  warning: ${warning}`)}return lines.join("\n")}export{PROFILE_SUBCOMMANDS,formatProfileApplyHuman,formatProfileLintHuman,formatProfileListHuman,formatProfileShowHuman,runProfileApply,runProfileLint,runProfileList,runProfileShow};
 //# sourceMappingURL=profile.js.map
-//# debugId=f65b4f1f-5501-5829-a04b-d4fbcfb59f5c