@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/extension/managed-state.js

@@ -1,253 +1,3 @@
-/**
- * @module sdk/extension/managed-state
- *
- * Implements extension package-management support for Managed State.
- */
-
-!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]="159d7bbd-1d2a-503d-b3ce-f32dcc6f6547")}catch(e){}}();
-import { isFileMissingError } from "../../core/fs/fs-utils.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { nowIso } from "../../core/shared/time.js";
-import { normalizeExtensionContributionInventory } from "../../core/extensions/contribution-inventory.js";
-import { normalizeExtensionNameForMatch, normalizeStringList, } from "./shared.js";
-const MANAGED_EXTENSION_STATE_FILENAME = ".managed-extensions.json";
-const MANAGED_EXTENSION_STATE_VERSION = 1;
-/** Implements resolve managed extension state path for the public runtime surface of this module. */
-export function resolveManagedExtensionStatePath(extensionsRoot) {
-    return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);
-}
-/** Implements create empty managed extension state for the public runtime surface of this module. */
-export function createEmptyManagedExtensionState() {
-    return {
-        version: MANAGED_EXTENSION_STATE_VERSION,
-        updated_at: nowIso(),
-        entries: [],
-    };
-}
-/** Implements sort managed entries for the public runtime surface of this module. */
-export function sortManagedEntries(entries) {
-    return [...entries].sort((left, right) => {
-        const byScope = left.scope.localeCompare(right.scope);
-        if (byScope !== 0) {
-            return byScope;
-        }
-        const byName = left.name.localeCompare(right.name);
-        if (byName !== 0) {
-            return byName;
-        }
-        return left.directory.localeCompare(right.directory);
-    });
-}
-/** Implements managed extension sources equivalent for the public runtime surface of this module. */
-export function managedExtensionSourcesEquivalent(left, right) {
-    if (left.kind !== right.kind ||
-        left.input !== right.input ||
-        left.location !== right.location) {
-        return false;
-    }
-    if (left.kind === "npm" && right.kind === "npm") {
-        return left.package === right.package && left.version === right.version;
-    }
-    if (left.kind === "github" && right.kind === "github") {
-        return (left.repository === right.repository &&
-            left.ref === right.ref &&
-            left.subpath === right.subpath &&
-            left.commit === right.commit);
-    }
-    if (left.kind === "builtin" && right.kind === "builtin") {
-        return left.name === right.name;
-    }
-    return true;
-}
-/** Narrow `value` to a string, or `undefined` for any other type — the normalization applied to every optional managed-state string field so an absent or malformed value is dropped rather than carried through as `unknown`. */
-function optionalString(value) {
-    return typeof value === "string" ? value : undefined;
-}
-/**
- * Type guard asserting `entry` carries every always-present managed-record field
- * with the right primitive type: a non-empty `name`/`directory`, a known
- * {@link ExtensionScope}, string manifest metadata, a `string[]` capability
- * list, and string `installed_at`/`updated_at` timestamps. The optional columns
- * (`source` plus the update-check fields) are validated separately by the
- * caller, so this guard narrows only the required columns.
- */
-function hasRequiredManagedRecordFields(entry) {
-    return (typeof entry.name === "string" &&
-        entry.name.trim().length > 0 &&
-        typeof entry.directory === "string" &&
-        entry.directory.trim().length > 0 &&
-        (entry.scope === "project" || entry.scope === "global") &&
-        typeof entry.manifest_version === "string" &&
-        typeof entry.manifest_entry === "string" &&
-        Array.isArray(entry.capabilities) &&
-        entry.capabilities.every((value) => typeof value === "string") &&
-        typeof entry.installed_at === "string" &&
-        typeof entry.updated_at === "string");
-}
-/** Normalize one persisted managed-extension source object, returning `null` when the discriminant (`kind`) or the required `input`/`location` strings are missing or malformed so the caller can skip the owning record. */
-function normalizeManagedSource(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        return null;
-    }
-    const source = raw;
-    if ((source.kind !== "local" &&
-        source.kind !== "github" &&
-        source.kind !== "npm" &&
-        source.kind !== "builtin") ||
-        typeof source.input !== "string" ||
-        typeof source.location !== "string") {
-        return null;
-    }
-    return {
-        kind: source.kind,
-        input: source.input,
-        location: source.location,
-        name: optionalString(source.name),
-        package: optionalString(source.package),
-        version: optionalString(source.version),
-        repository: optionalString(source.repository),
-        owner: optionalString(source.owner),
-        repo: optionalString(source.repo),
-        ref: optionalString(source.ref),
-        subpath: optionalString(source.subpath),
-        commit: optionalString(source.commit),
-    };
-}
-/**
- * Normalize one persisted managed-extension record, returning `null` when any
- * required field or its `source` is missing or malformed so {@link
- * normalizeManagedState} can drop the entry without discarding the rest of the
- * file.
- */
-function normalizeManagedRecord(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        return null;
-    }
-    const entry = raw;
-    if (!hasRequiredManagedRecordFields(entry)) {
-        return null;
-    }
-    const source = normalizeManagedSource(entry.source);
-    if (!source) {
-        return null;
-    }
-    const contributions = normalizeExtensionContributionInventory(entry.contributions);
-    if (contributions === null) {
-        return null;
-    }
-    return {
-        name: entry.name.trim(),
-        directory: entry.directory.trim(),
-        scope: entry.scope,
-        manifest_version: entry.manifest_version,
-        manifest_entry: entry.manifest_entry,
-        capabilities: normalizeStringList(entry.capabilities),
-        contributions,
-        installed_at: entry.installed_at,
-        updated_at: entry.updated_at,
-        source,
-        last_update_check_at: optionalString(entry.last_update_check_at),
-        last_update_remote_commit: optionalString(entry.last_update_remote_commit),
-        update_available: typeof entry.update_available === "boolean" ||
-            entry.update_available === null
-            ? entry.update_available
-            : undefined,
-        update_error: optionalString(entry.update_error),
-    };
-}
-/** Implements normalize managed state for the public runtime surface of this module. */
-export function normalizeManagedState(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        return null;
-    }
-    const candidate = raw;
-    if (candidate.version !== MANAGED_EXTENSION_STATE_VERSION ||
-        !Array.isArray(candidate.entries)) {
-        return null;
-    }
-    const entries = [];
-    for (const rawEntry of candidate.entries) {
-        const record = normalizeManagedRecord(rawEntry);
-        if (record) {
-            entries.push(record);
-        }
-    }
-    return {
-        version: MANAGED_EXTENSION_STATE_VERSION,
-        updated_at: optionalString(candidate.updated_at) ?? nowIso(),
-        entries: sortManagedEntries(entries),
-    };
-}
-/** Implements read managed extension state for the public runtime surface of this module. */
-export async function readManagedExtensionState(extensionsRoot) {
-    const statePath = resolveManagedExtensionStatePath(extensionsRoot);
-    const fallback = createEmptyManagedExtensionState();
-    try {
-        const raw = await fs.readFile(statePath, "utf8");
-        const parsed = JSON.parse(raw);
-        const normalized = normalizeManagedState(parsed);
-        if (!normalized) {
-            throw new PmCliError(`Managed extension state file "${statePath}" has an invalid schema. Repair or remove it before mutating extension state.`, EXIT_CODE.GENERIC_FAILURE);
-        }
-        return {
-            path: statePath,
-            state: normalized,
-            warnings: [],
-        };
-    }
-    catch (error) {
-        if (error instanceof PmCliError) {
-            throw error;
-        }
-        if (typeof error === "object" &&
-            error !== null &&
-            "code" in error &&
-            isFileMissingError(error)) {
-            return {
-                path: statePath,
-                state: fallback,
-                warnings: [],
-            };
-        }
-        throw new PmCliError(`Managed extension state file "${statePath}" could not be read. Repair or remove it before mutating extension state.`, EXIT_CODE.GENERIC_FAILURE);
-    }
-}
-/** Implements write managed extension state for the public runtime surface of this module. */
-export async function writeManagedExtensionState(extensionsRoot, state) {
-    const statePath = resolveManagedExtensionStatePath(extensionsRoot);
-    const normalized = {
-        version: MANAGED_EXTENSION_STATE_VERSION,
-        updated_at: nowIso(),
-        entries: sortManagedEntries(state.entries),
-    };
-    await fs.mkdir(extensionsRoot, { recursive: true });
-    await fs.writeFile(statePath, `${JSON.stringify(normalized, null, 2)}\n`, "utf8");
-}
-/** Implements upsert managed entry for the public runtime surface of this module. */
-export function upsertManagedEntry(state, entry) {
-    const updatedEntries = state.entries.filter((candidate) => normalizeExtensionNameForMatch(candidate.name) !==
-        normalizeExtensionNameForMatch(entry.name) &&
-        normalizeExtensionNameForMatch(candidate.directory) !==
-            normalizeExtensionNameForMatch(entry.directory));
-    updatedEntries.push(entry);
-    return {
-        ...state,
-        updated_at: nowIso(),
-        entries: sortManagedEntries(updatedEntries),
-    };
-}
-/** Persist a verified install-time contribution inventory on its managed record. */
-export async function persistManagedContributionInventory(extensionsRoot, state, extensionName, contributions) {
-    const entry = state.entries.find((candidate) => normalizeExtensionNameForMatch(candidate.name) ===
-        normalizeExtensionNameForMatch(extensionName));
-    if (!entry)
-        return state;
-    const updated = upsertManagedEntry(state, { ...entry, contributions });
-    await writeManagedExtensionState(extensionsRoot, updated);
-    return updated;
-}
+!(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]="33b7f318-cc64-55d6-8b57-19a618efe6c0")}catch(e2){}})();import{isFileMissingError}from"../../core/fs/fs-utils.js";import fs from"node:fs/promises";import path from"node:path";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{nowIso}from"../../core/shared/time.js";import{normalizeExtensionContributionInventory}from"../../core/extensions/contribution-inventory.js";import{normalizeExtensionNameForMatch,normalizeStringList}from"./shared.js";const MANAGED_EXTENSION_STATE_FILENAME=".managed-extensions.json";const MANAGED_EXTENSION_STATE_VERSION=1;function resolveManagedExtensionStatePath(extensionsRoot){return path.join(extensionsRoot,MANAGED_EXTENSION_STATE_FILENAME)}function createEmptyManagedExtensionState(){return{version:MANAGED_EXTENSION_STATE_VERSION,updated_at:nowIso(),entries:[]}}function sortManagedEntries(entries){return[...entries].sort((left,right)=>{const byScope=left.scope.localeCompare(right.scope);if(byScope!==0){return byScope}const byName=left.name.localeCompare(right.name);if(byName!==0){return byName}return left.directory.localeCompare(right.directory)})}function managedExtensionSourcesEquivalent(left,right){if(left.kind!==right.kind||left.input!==right.input||left.location!==right.location){return false}if(left.kind==="npm"&&right.kind==="npm"){return left.package===right.package&&left.version===right.version}if(left.kind==="github"&&right.kind==="github"){return left.repository===right.repository&&left.ref===right.ref&&left.subpath===right.subpath&&left.commit===right.commit}if(left.kind==="builtin"&&right.kind==="builtin"){return left.name===right.name}return true}function optionalString(value){return typeof value==="string"?value:void 0}function hasRequiredManagedRecordFields(entry){return typeof entry.name==="string"&&entry.name.trim().length>0&&typeof entry.directory==="string"&&entry.directory.trim().length>0&&(entry.scope==="project"||entry.scope==="global")&&typeof entry.manifest_version==="string"&&typeof entry.manifest_entry==="string"&&Array.isArray(entry.capabilities)&&entry.capabilities.every(value=>typeof value==="string")&&typeof entry.installed_at==="string"&&typeof entry.updated_at==="string"}function normalizeManagedSource(raw){if(typeof raw!=="object"||raw===null){return null}const source=raw;if(source.kind!=="local"&&source.kind!=="github"&&source.kind!=="npm"&&source.kind!=="builtin"||typeof source.input!=="string"||typeof source.location!=="string"){return null}return{kind:source.kind,input:source.input,location:source.location,name:optionalString(source.name),package:optionalString(source.package),version:optionalString(source.version),repository:optionalString(source.repository),owner:optionalString(source.owner),repo:optionalString(source.repo),ref:optionalString(source.ref),subpath:optionalString(source.subpath),commit:optionalString(source.commit)}}function normalizeManagedRecord(raw){if(typeof raw!=="object"||raw===null){return null}const entry=raw;if(!hasRequiredManagedRecordFields(entry)){return null}const source=normalizeManagedSource(entry.source);if(!source){return null}const contributions=normalizeExtensionContributionInventory(entry.contributions);if(contributions===null){return null}return{name:entry.name.trim(),directory:entry.directory.trim(),scope:entry.scope,manifest_version:entry.manifest_version,manifest_entry:entry.manifest_entry,capabilities:normalizeStringList(entry.capabilities),contributions,installed_at:entry.installed_at,updated_at:entry.updated_at,source,last_update_check_at:optionalString(entry.last_update_check_at),last_update_remote_commit:optionalString(entry.last_update_remote_commit),update_available:typeof entry.update_available==="boolean"||entry.update_available===null?entry.update_available:void 0,update_error:optionalString(entry.update_error)}}function normalizeManagedState(raw){if(typeof raw!=="object"||raw===null){return null}const candidate=raw;if(candidate.version!==MANAGED_EXTENSION_STATE_VERSION||!Array.isArray(candidate.entries)){return null}const entries=[];for(const rawEntry of candidate.entries){const record=normalizeManagedRecord(rawEntry);if(record){entries.push(record)}}return{version:MANAGED_EXTENSION_STATE_VERSION,updated_at:optionalString(candidate.updated_at)??nowIso(),entries:sortManagedEntries(entries)}}async function readManagedExtensionState(extensionsRoot){const statePath=resolveManagedExtensionStatePath(extensionsRoot);const fallback=createEmptyManagedExtensionState();try{const raw=await fs.readFile(statePath,"utf8");const parsed=JSON.parse(raw);const normalized=normalizeManagedState(parsed);if(!normalized){throw new PmCliError(`Managed extension state file "${statePath}" has an invalid schema. Repair or remove it before mutating extension state.`,EXIT_CODE.GENERIC_FAILURE)}return{path:statePath,state:normalized,warnings:[]}}catch(error){if(error instanceof PmCliError){throw error}if(typeof error==="object"&&error!==null&&"code"in error&&isFileMissingError(error)){return{path:statePath,state:fallback,warnings:[]}}throw new PmCliError(`Managed extension state file "${statePath}" could not be read. Repair or remove it before mutating extension state.`,EXIT_CODE.GENERIC_FAILURE)}}async function writeManagedExtensionState(extensionsRoot,state){const statePath=resolveManagedExtensionStatePath(extensionsRoot);const normalized={version:MANAGED_EXTENSION_STATE_VERSION,updated_at:nowIso(),entries:sortManagedEntries(state.entries)};await fs.mkdir(extensionsRoot,{recursive:true});await fs.writeFile(statePath,`${JSON.stringify(normalized,null,2)}
+`,"utf8")}function upsertManagedEntry(state,entry){const updatedEntries=state.entries.filter(candidate=>normalizeExtensionNameForMatch(candidate.name)!==normalizeExtensionNameForMatch(entry.name)&&normalizeExtensionNameForMatch(candidate.directory)!==normalizeExtensionNameForMatch(entry.directory));updatedEntries.push(entry);return{...state,updated_at:nowIso(),entries:sortManagedEntries(updatedEntries)}}async function persistManagedContributionInventory(extensionsRoot,state,extensionName,contributions){const entry=state.entries.find(candidate=>normalizeExtensionNameForMatch(candidate.name)===normalizeExtensionNameForMatch(extensionName));if(!entry)return state;const updated=upsertManagedEntry(state,{...entry,contributions});await writeManagedExtensionState(extensionsRoot,updated);return updated}export{createEmptyManagedExtensionState,managedExtensionSourcesEquivalent,normalizeManagedState,persistManagedContributionInventory,readManagedExtensionState,resolveManagedExtensionStatePath,sortManagedEntries,upsertManagedEntry,writeManagedExtensionState};
 //# sourceMappingURL=managed-state.js.map
-//# debugId=159d7bbd-1d2a-503d-b3ce-f32dcc6f6547

package/dist/sdk/extension/migrations.js

@@ -1,175 +1,3 @@
-/**
- * @module sdk/extension/migrations
- *
- * Provides durable planning and execution for extension-owned schema migrations.
- */
-
-!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]="56290db9-933c-590d-8b9f-df62ff45e515")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { pathExists } from "../../core/fs/fs-utils.js";
-import { activateExtensions, loadExtensions } from "../../core/extensions/index.js";
-import { writeWorkspaceJsonWithHistory } from "../../core/history/workspace-history.js";
-import { readSettings } from "../../core/store/settings.js";
-/** Return the durable workspace path for extension migration state. */
-export function resolveExtensionMigrationStatePath(pmRoot) {
-    return path.join(pmRoot, "extension-migrations.json");
-}
-function migrationId(migration, index) {
-    const id = migration.definition.id;
-    return typeof id === "string" && id.trim().length > 0
-        ? id.trim()
-        : `migration-${String(index + 1).padStart(3, "0")}`;
-}
-function migrationKey(migration, id) {
-    return `${migration.layer}:${migration.name}:${id}`;
-}
-/** Read durable extension migration outcomes, degrading absent state to empty. */
-export async function readExtensionMigrationState(pmRoot) {
-    const statePath = resolveExtensionMigrationStatePath(pmRoot);
-    if (!(await pathExists(statePath))) {
-        return { version: 1, updated_at: "", entries: [] };
-    }
-    const parsed = JSON.parse(await fs.readFile(statePath, "utf8"));
-    return {
-        version: 1,
-        updated_at: typeof parsed.updated_at === "string" ? parsed.updated_at : "",
-        entries: Array.isArray(parsed.entries)
-            ? parsed.entries.filter((entry) => typeof entry?.key === "string" &&
-                (entry.status === "applied" || entry.status === "failed"))
-            : [],
-    };
-}
-/** Overlay durable outcomes onto freshly activated migration definitions. */
-export async function applyStoredExtensionMigrationState(pmRoot, migrations) {
-    const state = await readExtensionMigrationState(pmRoot);
-    const byKey = new Map(state.entries.map((entry) => [entry.key, entry]));
-    migrations.forEach((migration, index) => {
-        const id = migrationId(migration, index);
-        const entry = byKey.get(migrationKey(migration, id));
-        if (!entry)
-            return;
-        migration.definition.status = entry.status;
-        if (entry.status === "failed") {
-            migration.definition.reason = entry.error;
-        }
-        else {
-            delete migration.definition.reason;
-            delete migration.definition.error;
-            delete migration.definition.message;
-        }
-    });
-    return state;
-}
-/** Plan or apply active extension migrations with durable idempotency receipts. */
-export async function runExtensionMigrations(options) {
-    const state = await applyStoredExtensionMigrationState(options.pmRoot, options.migrations);
-    const stateByKey = new Map(state.entries.map((entry) => [entry.key, entry]));
-    const receipts = [];
-    let changed = false;
-    const scopedMigrations = options.migrations
-        .map((migration, index) => ({ migration, index }))
-        .filter(({ migration }) => options.scope === undefined || migration.layer === options.scope);
-    for (const { migration, index } of scopedMigrations) {
-        const id = migrationId(migration, index);
-        const key = migrationKey(migration, id);
-        const stored = stateByKey.get(key);
-        const declaredStatus = String(migration.definition.status ?? "pending").toLowerCase();
-        const before = stored?.status ?? (declaredStatus === "applied" || declaredStatus === "failed" ? declaredStatus : "pending");
-        if (before === "applied") {
-            receipts.push({ key, layer: migration.layer, extension: migration.name, id, before, outcome: "skipped" });
-            continue;
-        }
-        if (options.dryRun === true) {
-            receipts.push({ key, layer: migration.layer, extension: migration.name, id, before, outcome: "pending" });
-            continue;
-        }
-        const run = migration.runtime_definition?.run ?? migration.definition.run;
-        if (typeof run !== "function") {
-            receipts.push({ key, layer: migration.layer, extension: migration.name, id, before, outcome: "pending" });
-            continue;
-        }
-        const attemptedAt = new Date().toISOString();
-        try {
-            await Promise.resolve(run({ id, command: "migration", layer: migration.layer, extension: migration.name, pm_root: options.pmRoot, status: before }));
-            const entry = { key, layer: migration.layer, extension: migration.name, id, status: "applied", attempted_at: attemptedAt };
-            stateByKey.set(key, entry);
-            migration.definition.status = "applied";
-            delete migration.definition.reason;
-            delete migration.definition.error;
-            delete migration.definition.message;
-            receipts.push({ key, layer: migration.layer, extension: migration.name, id, before, outcome: "applied" });
-            changed = true;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            const entry = { key, layer: migration.layer, extension: migration.name, id, status: "failed", attempted_at: attemptedAt, error: message };
-            stateByKey.set(key, entry);
-            migration.definition.status = "failed";
-            migration.definition.reason = message;
-            receipts.push({ key, layer: migration.layer, extension: migration.name, id, before, outcome: "failed", error: message });
-            changed = true;
-        }
-    }
-    if (changed) {
-        const settings = await readSettings(options.pmRoot);
-        const nextState = {
-            version: 1,
-            updated_at: new Date().toISOString(),
-            entries: [...stateByKey.values()].sort((left, right) => left.key.localeCompare(right.key)),
-        };
-        await writeWorkspaceJsonWithHistory({
-            pmRoot: options.pmRoot,
-            filePath: resolveExtensionMigrationStatePath(options.pmRoot),
-            raw: `${JSON.stringify(nextState, null, 2)}\n`,
-            op: "extension_migrations_apply",
-            author: options.author,
-            lockTtlSeconds: settings.locks.ttl_seconds,
-            lockWaitMs: settings.locks.wait_ms,
-        });
-    }
-    const pendingCount = receipts.filter((receipt) => receipt.outcome === "pending").length;
-    const appliedCount = receipts.filter((receipt) => receipt.outcome === "applied").length;
-    const skippedCount = receipts.filter((receipt) => receipt.outcome === "skipped").length;
-    const failedCount = receipts.filter((receipt) => receipt.outcome === "failed").length;
-    return {
-        ok: failedCount === 0,
-        dry_run: options.dryRun === true,
-        state_path: resolveExtensionMigrationStatePath(options.pmRoot),
-        total: receipts.length,
-        pending_count: pendingCount,
-        applied_count: appliedCount,
-        skipped_count: skippedCount,
-        failed_count: failedCount,
-        migrations: receipts,
-    };
-}
-/** Load active registrations and execute the extension lifecycle migrate action. */
-export async function runExtensionMigrateAction(context) {
-    const settings = await readSettings(context.resolvedRoots.settings_root);
-    const loaded = await loadExtensions({
-        pmRoot: context.resolvedRoots.pm_root,
-        settings,
-        cwd: process.cwd(),
-        noExtensions: context.global.noExtensions === true,
-    });
-    const activated = await activateExtensions(loaded);
-    context.warnings.push(...loaded.warnings, ...activated.warnings);
-    const migration = await runExtensionMigrations({
-        pmRoot: context.resolvedRoots.pm_root,
-        migrations: activated.registrations.migrations,
-        author: typeof context.global.author === "string" &&
-            context.global.author.trim().length > 0
-            ? context.global.author.trim()
-            : "pm-extension-migration",
-        dryRun: context.options.dryRun === true,
-        ...(context.scope === "global" ? { scope: "global" } : {}),
-    });
-    return context.withResult({
-        migration,
-        load_failure_count: loaded.failed.length,
-        activation_failure_count: activated.failed.length,
-    }, migration.ok);
-}
+!(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]="c4dc16d1-672a-5b1c-b681-97a7b3febd69")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{pathExists}from"../../core/fs/fs-utils.js";import{activateExtensions,loadExtensions}from"../../core/extensions/index.js";import{writeWorkspaceJsonWithHistory}from"../../core/history/workspace-history.js";import{readSettings}from"../../core/store/settings.js";function resolveExtensionMigrationStatePath(pmRoot){return path.join(pmRoot,"extension-migrations.json")}function migrationId(migration,index){const id=migration.definition.id;return typeof id==="string"&&id.trim().length>0?id.trim():`migration-${String(index+1).padStart(3,"0")}`}function migrationKey(migration,id){return`${migration.layer}:${migration.name}:${id}`}async function readExtensionMigrationState(pmRoot){const statePath=resolveExtensionMigrationStatePath(pmRoot);if(!await pathExists(statePath)){return{version:1,updated_at:"",entries:[]}}const parsed=JSON.parse(await fs.readFile(statePath,"utf8"));return{version:1,updated_at:typeof parsed.updated_at==="string"?parsed.updated_at:"",entries:Array.isArray(parsed.entries)?parsed.entries.filter(entry=>typeof entry?.key==="string"&&(entry.status==="applied"||entry.status==="failed")):[]}}async function applyStoredExtensionMigrationState(pmRoot,migrations){const state=await readExtensionMigrationState(pmRoot);const byKey=new Map(state.entries.map(entry=>[entry.key,entry]));migrations.forEach((migration,index)=>{const id=migrationId(migration,index);const entry=byKey.get(migrationKey(migration,id));if(!entry)return;migration.definition.status=entry.status;if(entry.status==="failed"){migration.definition.reason=entry.error}else{delete migration.definition.reason;delete migration.definition.error;delete migration.definition.message}});return state}async function runExtensionMigrations(options){const state=await applyStoredExtensionMigrationState(options.pmRoot,options.migrations);const stateByKey=new Map(state.entries.map(entry=>[entry.key,entry]));const receipts=[];let changed=false;const scopedMigrations=options.migrations.map((migration,index)=>({migration,index})).filter(({migration})=>options.scope===void 0||migration.layer===options.scope);for(const{migration,index}of scopedMigrations){const id=migrationId(migration,index);const key=migrationKey(migration,id);const stored=stateByKey.get(key);const declaredStatus=String(migration.definition.status??"pending").toLowerCase();const before=stored?.status??(declaredStatus==="applied"||declaredStatus==="failed"?declaredStatus:"pending");if(before==="applied"){receipts.push({key,layer:migration.layer,extension:migration.name,id,before,outcome:"skipped"});continue}if(options.dryRun===true){receipts.push({key,layer:migration.layer,extension:migration.name,id,before,outcome:"pending"});continue}const run=migration.runtime_definition?.run??migration.definition.run;if(typeof run!=="function"){receipts.push({key,layer:migration.layer,extension:migration.name,id,before,outcome:"pending"});continue}const attemptedAt=new Date().toISOString();try{await Promise.resolve(run({id,command:"migration",layer:migration.layer,extension:migration.name,pm_root:options.pmRoot,status:before}));const entry={key,layer:migration.layer,extension:migration.name,id,status:"applied",attempted_at:attemptedAt};stateByKey.set(key,entry);migration.definition.status="applied";delete migration.definition.reason;delete migration.definition.error;delete migration.definition.message;receipts.push({key,layer:migration.layer,extension:migration.name,id,before,outcome:"applied"});changed=true}catch(error){const message=error instanceof Error?error.message:String(error);const entry={key,layer:migration.layer,extension:migration.name,id,status:"failed",attempted_at:attemptedAt,error:message};stateByKey.set(key,entry);migration.definition.status="failed";migration.definition.reason=message;receipts.push({key,layer:migration.layer,extension:migration.name,id,before,outcome:"failed",error:message});changed=true}}if(changed){const settings=await readSettings(options.pmRoot);const nextState={version:1,updated_at:new Date().toISOString(),entries:[...stateByKey.values()].sort((left,right)=>left.key.localeCompare(right.key))};await writeWorkspaceJsonWithHistory({pmRoot:options.pmRoot,filePath:resolveExtensionMigrationStatePath(options.pmRoot),raw:`${JSON.stringify(nextState,null,2)}
+`,op:"extension_migrations_apply",author:options.author,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms})}const pendingCount=receipts.filter(receipt=>receipt.outcome==="pending").length;const appliedCount=receipts.filter(receipt=>receipt.outcome==="applied").length;const skippedCount=receipts.filter(receipt=>receipt.outcome==="skipped").length;const failedCount=receipts.filter(receipt=>receipt.outcome==="failed").length;return{ok:failedCount===0,dry_run:options.dryRun===true,state_path:resolveExtensionMigrationStatePath(options.pmRoot),total:receipts.length,pending_count:pendingCount,applied_count:appliedCount,skipped_count:skippedCount,failed_count:failedCount,migrations:receipts}}async function runExtensionMigrateAction(context){const settings=await readSettings(context.resolvedRoots.settings_root);const loaded=await loadExtensions({pmRoot:context.resolvedRoots.pm_root,settings,cwd:process.cwd(),noExtensions:context.global.noExtensions===true});const activated=await activateExtensions(loaded);context.warnings.push(...loaded.warnings,...activated.warnings);const migration=await runExtensionMigrations({pmRoot:context.resolvedRoots.pm_root,migrations:activated.registrations.migrations,author:typeof context.global.author==="string"&&context.global.author.trim().length>0?context.global.author.trim():"pm-extension-migration",dryRun:context.options.dryRun===true,...context.scope==="global"?{scope:"global"}:{}});return context.withResult({migration,load_failure_count:loaded.failed.length,activation_failure_count:activated.failed.length},migration.ok)}export{applyStoredExtensionMigrationState,readExtensionMigrationState,resolveExtensionMigrationStatePath,runExtensionMigrateAction,runExtensionMigrations};
 //# sourceMappingURL=migrations.js.map
-//# debugId=56290db9-933c-590d-8b9f-df62ff45e515

package/dist/sdk/extension/output-ownership.js

@@ -1,26 +1,2 @@
-/**
- * @module sdk/extension/output-ownership
- *
- * Classifies output overrides against manifest-declared command ownership.
- */
-
-!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]="e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998")}catch(e){}}();
-import { normalizeExtensionNameForMatch } from "./shared.js";
-/** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
-export function collectGlobalOutputOverrideDoctorWarnings(activationResult, loadResult) {
-    const commandScopedOwners = new Set((loadResult?.loaded ?? []).flatMap((entry) => (entry.activation?.commands?.length ?? 0) > 0
-        ? [`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`]
-        : []));
-    const serviceWarnings = activationResult.services.overrides
-        .filter((entry) => entry.service === "output_format")
-        .filter((entry) => entry.passThrough !== true)
-        .filter((entry) => !commandScopedOwners.has(`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`))
-        .map((entry) => `extension_output_service_override_global:${entry.service}:${entry.layer}:${entry.name}`);
-    const rendererWarnings = activationResult.renderers.overrides
-        .filter((entry) => (entry.commands?.length ?? 0) === 0 &&
-        entry.resultDiscriminator === undefined)
-        .map((entry) => `extension_output_renderer_override_global:${entry.format}:${entry.layer}:${entry.name}`);
-    return [...new Set([...serviceWarnings, ...rendererWarnings])].sort((left, right) => left.localeCompare(right));
-}
+!(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]="fcc97434-1ef5-5c47-b491-f00e9d19b2c6")}catch(e2){}})();import{normalizeExtensionNameForMatch}from"./shared.js";function collectGlobalOutputOverrideDoctorWarnings(activationResult,loadResult){const commandScopedOwners=new Set((loadResult?.loaded??[]).flatMap(entry=>(entry.activation?.commands?.length??0)>0?[`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`]:[]));const serviceWarnings=activationResult.services.overrides.filter(entry=>entry.service==="output_format").filter(entry=>entry.passThrough!==true).filter(entry=>!commandScopedOwners.has(`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`)).map(entry=>`extension_output_service_override_global:${entry.service}:${entry.layer}:${entry.name}`);const rendererWarnings=activationResult.renderers.overrides.filter(entry=>(entry.commands?.length??0)===0&&entry.resultDiscriminator===void 0).map(entry=>`extension_output_renderer_override_global:${entry.format}:${entry.layer}:${entry.name}`);return[...new Set([...serviceWarnings,...rendererWarnings])].sort((left,right)=>left.localeCompare(right))}export{collectGlobalOutputOverrideDoctorWarnings};
 //# sourceMappingURL=output-ownership.js.map
-//# debugId=e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998

package/dist/sdk/extension/runtime-summary.js

@@ -1,19 +1,2 @@
-/**
- * @module sdk/extension/runtime-summary
- *
- * Projects activated package command registrations into stable install output.
- */
-
-!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]="b17dfc10-9e07-5912-b294-c5663133f192")}catch(e){}}();
-import { normalizeExtensionNameForMatch } from "./shared.js";
-/** Return stable runtime command and action paths registered by one extension. */
-export function summarizeRuntimeCommandPathsForExtension(extensionName, installed) {
-    const normalizedName = normalizeExtensionNameForMatch(extensionName);
-    const entry = installed.find((candidate) => normalizeExtensionNameForMatch(candidate.name) === normalizedName);
-    return {
-        command_paths: [...(entry?.command_paths ?? [])].sort((left, right) => left.localeCompare(right)),
-        action_paths: [...(entry?.action_paths ?? [])].sort((left, right) => left.localeCompare(right)),
-    };
-}
+!(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]="37f2dced-3b93-5c64-85ae-56e62c95e8eb")}catch(e2){}})();import{normalizeExtensionNameForMatch}from"./shared.js";function summarizeRuntimeCommandPathsForExtension(extensionName,installed){const normalizedName=normalizeExtensionNameForMatch(extensionName);const entry=installed.find(candidate=>normalizeExtensionNameForMatch(candidate.name)===normalizedName);return{command_paths:[...entry?.command_paths??[]].sort((left,right)=>left.localeCompare(right)),action_paths:[...entry?.action_paths??[]].sort((left,right)=>left.localeCompare(right))}}export{summarizeRuntimeCommandPathsForExtension};
 //# sourceMappingURL=runtime-summary.js.map
-//# debugId=b17dfc10-9e07-5912-b294-c5663133f192