@unbrained/pm-cli 2026.8.5 → 2026.8.6

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.8.5"
+    "version": "2026.8.6"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.8.5",
+      "version": "2026.8.6",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2026.8.6 - 2026-08-06
+
+### Fixed
+
+- GH-909: executable extension migration application and remediation contract ([pm-ig5cfe](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ig5cfe.toon))
+- GH-908: explicit package-source identity and bare-name ambiguity diagnostics ([pm-495lkc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-495lkc.toon))
+- GH-907: preflight override ownership and statically disjoint command scopes ([pm-miy5k6](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-miy5k6.toon))
+- Release ratchet verdicts are a property of the working copy, not the commit: gitignored installs and clone-local git config decide three populations, so an identical commit passes locally and fails in CI ([pm-fr4dg8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-fr4dg8.toon))
+- Exact-tag Release recovery must bootstrap tracker gates and publish an unpublished immutable tag from its tagged source ([pm-lwnifd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-lwnifd.toon))
+
+### Other
+
+- Refresh compatible 2026-08-05 TypeScript-ESLint and Unicorn quality tooling ([pm-7gxbl8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-7gxbl8.toon))
+
 ## 2026.8.5 - 2026-08-05
 
 ### Fixed

package/dist/cli/main.js

@@ -3,7 +3,7 @@
  * @module cli/main
  */
 
-!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]="65cd2f79-5d55-542f-94ff-07cb4a913a44")}catch(e){}}();
+!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]="a16a4e5c-eaa5-59fd-a1ba-b5752e29ec47")}catch(e){}}();
 import { Command } from "commander";
 import { activateExtensions, clearActiveExtensionHooks, createCoreCommandHookContext, resetActiveExtensionRuntimeState, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, consumeAfterCommandAffectedItems, runActiveCommandHandler, runActiveParserOverride, runActivePreflightOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandResult, setActiveCommandContext, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, pathExists, resolvePmCliVersion, resolvePmPackageRootFromModule, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, EXIT_CODE, resolveTelemetryErrorCategory, PmCliError, asRecordOrNull, printError, printResult, maybeRunFirstUseTelemetryPrompt, emitTelemetryErrorEvent, startTelemetryCommand, deriveTelemetryCommandResolution, sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogCliUsageError, sentrySetCommandContext, sentryStartCommandSpan, ensureSentryInit, getSettingsPath, resolvePmRoot, readSettings, readSettingsWithMetadata, runWithWorkspaceHarnessSignalDescriptors, createLazyModule, } from "../sdk/runtime-primitives.js";
 import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
@@ -20,7 +20,8 @@ import { normalizeExtensionCommandPath, collectDynamicExtensionFlagHelpByCommand
 import { parseBootstrapGlobalOptions, applyBootstrapPagerPolicy, parseBootstrapHelpRequest, parseBootstrapCommandName, normalizeBootstrapInvocation, stripGlobalBootstrapTokens, } from "./bootstrap-args.js";
 import { applyInvocationAuthorOverride } from "../sdk/invocation-author.js";
 import { createPmCliProgram } from "../sdk/cli-program.js";
-import { collectMandatoryMigrationBlockers, enforceMandatoryMigrationWriteGate, enforceItemFormatWriteGateAndPreflightMigration, enforceMutationGuardPreflight, resolveMigrationId, resolveNormalizedMigrationStatus, } from "./migration-gates.js";
+import { collectMandatoryMigrationBlockers, enforceMandatoryMigrationWriteGate, enforceItemFormatWriteGateAndPreflightMigration, enforceMutationGuardPreflight, } from "./migration-gates.js";
+import { runExtensionMigrations } from "../sdk/extension/migrations.js";
 import { appendCommanderExtensionFailures, isKnownHelpCommandPath, formatCommanderUsageMessage, formatCommanderUsageJson, resolveCommanderUsageContext, resolveUnknownCommanderToken, } from "./commander-usage.js";
 import { loadExtensionRecoveryFailures, loadUnknownCommandRecoveryFailures } from "./extension-recovery.js";
 import { maybeRenderBootstrapJsonHelp, attachCreateUpdatePolicyHelpText } from "./help-json-payload.js";
@@ -1197,40 +1198,14 @@ async function loadRuntimeExtensionCommandDescriptorsForRecovery(pmRoot) {
     return snapshot ? new Map(snapshot.commandDescriptors) : activeRuntimeExtensionCommandDescriptors;
 }
 async function executeRegisteredRuntimeMigrations(migrations, pmRoot) {
-    const warnings = [];
-    for (let index = 0; index < migrations.length; index += 1) {
-        const migration = migrations[index];
-        const status = resolveNormalizedMigrationStatus(migration.definition);
-        if (status === "applied") {
-            continue;
-        }
-        const runtimeDefinition = migration.runtime_definition ?? migration.definition;
-        const run = runtimeDefinition.run;
-        if (typeof run !== "function") {
-            continue;
-        }
-        const migrationId = resolveMigrationId(migration.definition, index);
-        try {
-            await Promise.resolve(run({
-                id: migrationId,
-                command: "migration",
-                layer: migration.layer,
-                extension: migration.name,
-                pm_root: pmRoot,
-                status,
-            }));
-            migration.definition.status = "applied";
-            delete migration.definition.reason;
-            delete migration.definition.error;
-            delete migration.definition.message;
-        }
-        catch (error) {
-            migration.definition.status = "failed";
-            migration.definition.reason = describeUnknownError(error);
-            warnings.push(`extension_migration_failed:${migration.layer}:${migration.name}:${migrationId}`);
-        }
-    }
-    return warnings;
+    const result = await runExtensionMigrations({
+        pmRoot,
+        migrations,
+        author: "pm-extension-migration",
+    });
+    return result.migrations
+        .filter((migration) => migration.outcome === "failed")
+        .map((migration) => `extension_migration_failed:${migration.layer}:${migration.extension}:${migration.id}`);
 }
 /* c8 ignore start */
 /** Build one host-bound extension SDK using the command's resolved author. */
@@ -2476,4 +2451,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=65cd2f79-5d55-542f-94ff-07cb4a913a44
+//# debugId=a16a4e5c-eaa5-59fd-a1ba-b5752e29ec47

package/dist/cli/register-setup.d.ts

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Register Setup.
  */
 import type { Command } from "commander";
-type ExtensionSubcommandAction = "init" | "install" | "uninstall" | "explore" | "manage" | "describe" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate";
+type ExtensionSubcommandAction = "init" | "install" | "uninstall" | "explore" | "manage" | "describe" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate" | "migrate";
 type LifecycleCommandVocabulary = "extension" | "package";
 declare function normalizeExtensionOptions(options: Record<string, unknown>, forcedAction?: ExtensionSubcommandAction, vocabulary?: LifecycleCommandVocabulary): Record<string, unknown>;
 /** Internal setup helpers exposed only for deterministic unit coverage. */

package/dist/cli/register-setup.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a99184b6-e7cb-5d46-9737-87be7a1b1968")}catch(e){}}();
+!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]="d498a64c-9680-52a9-981d-4ce86949784d")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { EXIT_CODE, PmCliError, } from "../sdk/runtime-primitives.js";
@@ -10,6 +10,22 @@ import { renderExtensionDescribeMarkdown, } from "./commands/extension/describe.
 import { runConfig } from "./commands/config.js";
 import { runInit, summarizeInitResult } from "./commands/init.js";
 import { runUpgrade } from "./commands/upgrade.js";
+const EXTENSION_ACTION_OPTION_KEYS = {
+    init: "init",
+    install: "install",
+    uninstall: "uninstall",
+    explore: "explore",
+    manage: "manage",
+    describe: "describe",
+    reload: "reload",
+    doctor: "doctor",
+    catalog: "catalog",
+    adopt: "adopt",
+    "adopt-all": "adoptAll",
+    activate: "activate",
+    deactivate: "deactivate",
+    migrate: "migrate",
+};
 /** Normalize the repeatable scaffold capability selector without losing conflicting intent. */
 function resolveScaffoldCapability(options) {
     const rawCapability = options.capability;
@@ -29,33 +45,36 @@ function resolveScaffoldCapability(options) {
     return capabilities[0];
 }
 function normalizeExtensionOptions(options, forcedAction, vocabulary = "extension") {
-    const isForcedAction = (action) => forcedAction === action;
-    const readBoolean = (...keys) => keys.some((key) => options[key] === true);
+    const normalizedOptions = { ...options };
+    if (forcedAction !== undefined) {
+        normalizedOptions[EXTENSION_ACTION_OPTION_KEYS[forcedAction]] = true;
+    }
+    const readBoolean = (...keys) => keys.some((key) => normalizedOptions[key] === true);
     const readString = (...keys) => {
         for (const key of keys) {
-            if (typeof options[key] === "string") {
-                return options[key];
+            if (typeof normalizedOptions[key] === "string") {
+                return normalizedOptions[key];
             }
         }
         return undefined;
     };
     return {
-        init: isForcedAction("init") || readBoolean("init"),
+        init: readBoolean("init"),
         scaffold: readBoolean("scaffold"),
-        install: isForcedAction("install") || readBoolean("install"),
-        uninstall: isForcedAction("uninstall") || readBoolean("uninstall"),
-        explore: isForcedAction("explore") || readBoolean("explore", "list"),
-        manage: isForcedAction("manage") || readBoolean("manage"),
-        describe: isForcedAction("describe") || readBoolean("describe"),
+        install: readBoolean("install"),
+        uninstall: readBoolean("uninstall"),
+        explore: readBoolean("explore", "list"),
+        manage: readBoolean("manage"),
+        describe: readBoolean("describe"),
         markdown: readBoolean("markdown"),
-        reload: isForcedAction("reload") || readBoolean("reload"),
-        doctor: isForcedAction("doctor") || readBoolean("doctor"),
-        catalog: isForcedAction("catalog") || readBoolean("catalog"),
-        adopt: isForcedAction("adopt") || readBoolean("adopt"),
-        adoptAll: isForcedAction("adopt-all") ||
-            readBoolean("adoptAll", "adopt_all", "adopt-all"),
-        activate: isForcedAction("activate") || readBoolean("activate"),
-        deactivate: isForcedAction("deactivate") || readBoolean("deactivate"),
+        reload: readBoolean("reload"),
+        doctor: readBoolean("doctor"),
+        catalog: readBoolean("catalog"),
+        adopt: readBoolean("adopt"),
+        adoptAll: readBoolean("adoptAll", "adopt_all", "adopt-all"),
+        activate: readBoolean("activate"),
+        deactivate: readBoolean("deactivate"),
+        migrate: readBoolean("migrate"),
         project: readBoolean("project"),
         local: readBoolean("local"),
         global: readBoolean("global"),
@@ -75,6 +94,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
         ignoreGlobal: readBoolean("ignoreGlobal", "ignore_global", "ignore-global"),
         strictExit: readBoolean("strictExit", "strict_exit", "strict-exit"),
         failOnWarn: readBoolean("failOnWarn", "fail_on_warn", "fail-on-warn"),
+        dryRun: readBoolean("dryRun", "dry_run", "dry-run"),
         vocabulary,
     };
 }
@@ -461,6 +481,12 @@ function registerLifecycleCommand(program, vocabulary) {
         .description(`Adopt all unmanaged ${plural} into managed metadata.`), vocabulary).action(async (_options, command) => {
         await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "adopt-all", vocabulary);
     });
+    addLifecycleScopeOptions(lifecycleCommand
+        .command("migrate")
+        .option("--dry-run", "Plan active migrations without invoking extension code")
+        .description(`Plan or apply active ${noun} migrations with durable receipts.`), vocabulary).action(async (_options, command) => {
+        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "migrate", vocabulary);
+    });
     addLifecycleScopeOptions(lifecycleCommand
         .command("activate")
         .argument("<target>", `${noun[0].toUpperCase()}${noun.slice(1)} name`)
@@ -647,4 +673,4 @@ export function registerSetupCommands(program) {
     });
 }
 //# sourceMappingURL=register-setup.js.map
-//# debugId=a99184b6-e7cb-5d46-9737-87be7a1b1968
+//# debugId=d498a64c-9680-52a9-981d-4ce86949784d