@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/cli/register-setup.js

@@ -1,717 +1,2 @@
-
-!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]="feb682f9-344c-569e-bbab-861fe20f08f1")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { EXIT_CODE, PmCliError, readSettings, resolvePmRoot, } from "../sdk/runtime-primitives.js";
-import { renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "../sdk/cli-contracts.js";
-import { collect, getGlobalOptions, printError, printResult, writeStdout, } from "./registration-helpers.js";
-import { runExtension, } from "./commands/extension.js";
-import { SCAFFOLD_CAPABILITIES } from "./commands/extension/scaffold.js";
-import { renderExtensionDescribeMarkdown, } from "./commands/extension/describe.js";
-import { runConfig } from "./commands/config.js";
-import { runInit, summarizeInitResult } from "./commands/init.js";
-import { runUpgrade } from "./commands/upgrade.js";
-const LIFECYCLE_DEPRECATION_ALIASES = {
-    extension: "extension",
-    package: undefined,
-};
-async function emitDeprecatedAliasHint(alias, command) {
-    if (!alias)
-        return;
-    const aliasContract = resolvePmCommandAlias(alias);
-    const globalOptions = getGlobalOptions(command);
-    const deprecationHints = await readSettings(resolvePmRoot(process.cwd(), globalOptions.path)).then((settings) => settings.ux.deprecation_hints);
-    if (deprecationHints) {
-        printError(renderPmCommandAliasMigrationHint(aliasContract));
-    }
-}
-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;
-    const values = typeof rawCapability === "string"
-        ? [rawCapability]
-        : Array.isArray(rawCapability)
-            ? rawCapability.filter((entry) => typeof entry === "string")
-            : [];
-    const capabilities = [
-        ...new Set(values
-            .map((capability) => capability.trim().toLowerCase())
-            .filter((capability) => capability.length > 0)),
-    ];
-    if (capabilities.length > 1) {
-        throw new PmCliError(`Multiple scaffold capabilities cannot be combined yet: ${capabilities.join(", ")}. Choose one capability per scaffold.`, EXIT_CODE.USAGE);
-    }
-    return capabilities[0];
-}
-function normalizeExtensionOptions(options, forcedAction, vocabulary = "extension") {
-    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 normalizedOptions[key] === "string") {
-                return normalizedOptions[key];
-            }
-        }
-        return undefined;
-    };
-    return {
-        init: readBoolean("init"),
-        scaffold: readBoolean("scaffold"),
-        install: readBoolean("install"),
-        uninstall: readBoolean("uninstall"),
-        explore: readBoolean("explore", "list"),
-        manage: readBoolean("manage"),
-        describe: readBoolean("describe"),
-        markdown: readBoolean("markdown"),
-        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"),
-        gh: readString("gh"),
-        github: readString("github"),
-        ref: readString("ref"),
-        capability: resolveScaffoldCapability(options),
-        declarative: readBoolean("declarative"),
-        fields: readString("fields"),
-        detail: readString("detail"),
-        output: readString("output"),
-        trace: readBoolean("trace"),
-        watch: readBoolean("watch"),
-        runtimeProbe: readBoolean("runtimeProbe", "runtime_probe", "runtime-probe"),
-        fixManagedState: readBoolean("fixManagedState", "fix_managed_state", "fix-managed-state"),
-        isolated: readBoolean("isolated"),
-        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,
-    };
-}
-async function looksLikeShellExpandedWildcard(targets) {
-    // Only ever called by normalizeInstallTargets after it has already returned
-    // early for length <= 1, so targets always has more than one entry here.
-    const visibleEntries = (await fs.readdir(process.cwd()))
-        .filter((entry) => !entry.startsWith("."))
-        .sort((left, right) => left.localeCompare(right));
-    const normalizedTargets = [...targets].sort((left, right) => left.localeCompare(right));
-    return (visibleEntries.length === normalizedTargets.length &&
-        visibleEntries.every((entry, index) => entry === normalizedTargets[index]));
-}
-async function normalizeInstallTargets(targets) {
-    // Commander variadic `[targets...]` always yields an array (empty when no
-    // targets are given), so a single nullish coalesce covers every input.
-    /* c8 ignore start -- commander variadic `[targets...]` always passes an array; the `?? []` arm is an unreachable nullish guard */
-    const normalizedTargets = (targets ?? [])
-        .map((target) => target.trim())
-        .filter((target) => target.length > 0);
-    /* c8 ignore stop */
-    if (normalizedTargets.length <= 1) {
-        return normalizedTargets.length === 0 ? undefined : normalizedTargets;
-    }
-    if (await looksLikeShellExpandedWildcard(normalizedTargets)) {
-        return ["*"];
-    }
-    return normalizedTargets;
-}
-function validateExtensionMarkdownOptions(normalizedOptions, globalOptions, outputPath) {
-    const wantsMarkdown = normalizedOptions.markdown === true;
-    if (outputPath !== undefined && outputPath === "") {
-        throw new PmCliError("--output requires a non-empty file path.", EXIT_CODE.USAGE);
-    }
-    if (outputPath !== undefined && !wantsMarkdown) {
-        throw new PmCliError("--output is only supported with --markdown describe output.", EXIT_CODE.USAGE);
-    }
-    if (!wantsMarkdown) {
-        return;
-    }
-    if (globalOptions.json) {
-        throw new PmCliError("Cannot combine --json with --markdown.", EXIT_CODE.USAGE);
-    }
-    if (normalizedOptions.describe !== true) {
-        throw new PmCliError("--markdown is only supported by the describe action.", EXIT_CODE.USAGE);
-    }
-}
-async function emitExtensionMarkdownResult(params) {
-    const markdown = renderExtensionDescribeMarkdown(params.result.details, params.vocabulary);
-    if (params.outputPath !== undefined) {
-        const resolvedOutputPath = path.resolve(params.outputPath);
-        await fs.mkdir(path.dirname(resolvedOutputPath), { recursive: true });
-        await fs.writeFile(resolvedOutputPath, markdown, "utf8");
-    }
-    if (params.globalOptions.quiet) {
-        return;
-    }
-    for (const warning of params.result.warnings) {
-        printError(`warning: ${warning}`);
-    }
-    if (params.outputPath === undefined) {
-        writeStdout(markdown);
-    }
-}
-function applyExtensionDoctorStrictExit(result, normalizedOptions) {
-    const strictExit = Boolean(normalizedOptions.strictExit) ||
-        Boolean(normalizedOptions.failOnWarn);
-    if (result.action !== "doctor" || !strictExit) {
-        return;
-    }
-    const detailsRecord = result.details !== null && typeof result.details === "object"
-        ? result.details
-        : {};
-    const summary = detailsRecord.summary !== null && typeof detailsRecord.summary === "object"
-        ? detailsRecord.summary
-        : null;
-    const summaryStatus = summary && typeof summary.status === "string" ? summary.status : undefined;
-    const shouldFail = result.warnings.length > 0 ||
-        (summaryStatus !== undefined && summaryStatus !== "ok");
-    if (shouldFail) {
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-    }
-}
-async function executeExtensionCommand(target, options, command, forcedAction, vocabulary = "extension") {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const effectiveVocabulary = vocabulary === "extension" ? "package" : vocabulary;
-    await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary], command);
-    const normalizedOptions = normalizeExtensionOptions(options, forcedAction, effectiveVocabulary);
-    const outputOption = typeof normalizedOptions.output === "string"
-        ? normalizedOptions.output
-        : undefined;
-    const outputPath = outputOption?.trim();
-    validateExtensionMarkdownOptions(normalizedOptions, globalOptions, outputPath);
-    const result = await runExtension(target, normalizedOptions, globalOptions);
-    if (normalizedOptions.markdown === true) {
-        await emitExtensionMarkdownResult({
-            result,
-            vocabulary: effectiveVocabulary,
-            outputPath,
-            globalOptions,
-        });
-    }
-    else {
-        printResult(result, globalOptions);
-    }
-    applyExtensionDoctorStrictExit(result, normalizedOptions);
-    if (result.ok === false) {
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=extension took_ms=${Date.now() - startedAt}`);
-    }
-}
-function extractExtensionInstallDetails(result) {
-    return result.details !== null && typeof result.details === "object"
-        ? result.details
-        : {};
-}
-function serializeExtensionInstallError(error) {
-    if (error instanceof PmCliError) {
-        return {
-            message: error.message,
-            exit_code: error.exitCode,
-            ...error.context,
-        };
-    }
-    return {
-        message: error instanceof Error ? error.message : String(error),
-        exit_code: EXIT_CODE.GENERIC_FAILURE,
-    };
-}
-async function runMultiTargetExtensionInstalls(targets, options, globalOptions) {
-    const rows = [];
-    const warnings = [];
-    let failureExitCode = EXIT_CODE.GENERIC_FAILURE;
-    for (const target of targets) {
-        try {
-            const result = await runExtension(target, options, globalOptions);
-            const details = extractExtensionInstallDetails(result);
-            const targetWarnings = Array.isArray(result.warnings)
-                ? result.warnings
-                : [];
-            warnings.push(...targetWarnings);
-            const targetOk = result.ok === true;
-            rows.push({
-                target,
-                ok: targetOk,
-                extension: details.extension,
-                source: details.source,
-                destination_path: details.destination_path,
-                activated: details.activated,
-                settings_changed: details.settings_changed,
-                command_paths: details.command_paths,
-                action_paths: details.action_paths,
-                runtime_activation_status: details.runtime_activation_status,
-                activation_diagnostics: details.activation_diagnostics,
-                command_discovery: details.command_discovery,
-                verification: details.verification,
-                warnings: targetWarnings,
-                ...(targetOk
-                    ? {}
-                    : {
-                        error: {
-                            message: "Extension install returned ok=false without throwing an error.",
-                            exit_code: EXIT_CODE.GENERIC_FAILURE,
-                            code: "extension_install_soft_failed",
-                        },
-                    }),
-            });
-        }
-        catch (error) {
-            const serializedError = serializeExtensionInstallError(error);
-            const exitCode = serializedError.exit_code;
-            if (typeof exitCode === "number" &&
-                failureExitCode === EXIT_CODE.GENERIC_FAILURE &&
-                exitCode !== EXIT_CODE.GENERIC_FAILURE) {
-                failureExitCode = exitCode;
-            }
-            rows.push({
-                target,
-                ok: false,
-                error: serializedError,
-            });
-        }
-    }
-    return { rows, warnings, failureExitCode };
-}
-async function executeExtensionInstallCommand(targets, options, command, vocabulary) {
-    const effectiveVocabulary = vocabulary === "extension" ? "package" : vocabulary;
-    await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary], command);
-    const normalizedTargets = await normalizeInstallTargets(targets);
-    if (normalizedTargets === undefined || normalizedTargets.length <= 1) {
-        await executeExtensionCommand(normalizedTargets?.[0], options, command, "install", effectiveVocabulary);
-        return;
-    }
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const normalizedOptions = normalizeExtensionOptions(options, "install", effectiveVocabulary);
-    validateExtensionMarkdownOptions(normalizedOptions, globalOptions, undefined);
-    const hasForcedGithubSource = [
-        normalizedOptions.gh,
-        normalizedOptions.github,
-    ].some((value) => typeof value === "string" && value.trim().length > 0);
-    if (hasForcedGithubSource) {
-        throw new PmCliError("Multiple install targets cannot be combined with --gh/--github. Install one GitHub source per command, or pass multiple explicit local, bundled, or npm: targets.", EXIT_CODE.USAGE, {
-            code: "multi_target_github_install_ambiguous",
-            required: "Use exactly one positional target with --gh/--github, or omit --gh/--github when installing multiple targets.",
-            examples: [
-                "pm install --gh owner/repo",
-                "pm install npm:pm-guide-shell pm-todos",
-            ],
-        });
-    }
-    const { rows, warnings, failureExitCode } = await runMultiTargetExtensionInstalls(normalizedTargets, normalizedOptions, globalOptions);
-    const failedCount = rows.filter((row) => row.ok !== true).length;
-    const result = {
-        ok: failedCount === 0,
-        action: "install",
-        scope: normalizedOptions.global === true ? "global" : "project",
-        installed_count: rows.length - failedCount,
-        failed_count: failedCount,
-        targets: rows,
-        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
-    };
-    printResult(result, globalOptions);
-    if (failedCount > 0) {
-        process.exitCode = failureExitCode;
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=extension took_ms=${Date.now() - startedAt}`);
-    }
-}
-function addExtensionScopeOptions(command) {
-    return command
-        .option("--project", "Use project extension scope (default)")
-        .option("--local", "Alias for --project")
-        .option("--global", "Use global extension scope");
-}
-function addPackageScopeOptions(command) {
-    return command
-        .option("--project", "Use project package scope (default)")
-        .option("--local", "Alias for --project")
-        .option("--global", "Use global package scope");
-}
-function addLifecycleScopeOptions(command, vocabulary) {
-    return vocabulary === "package"
-        ? addPackageScopeOptions(command)
-        : addExtensionScopeOptions(command);
-}
-function addUpgradeOptions(command) {
-    return command
-        .option("--dry-run", "Plan CLI/package upgrades without running npm or reinstalling packages")
-        .option("--cli-only", "Upgrade only the pm CLI/SDK npm package")
-        .option("--packages-only", "Upgrade only managed pm packages")
-        .option("--repair", "Force npm global reinstall when upgrading the pm CLI/SDK")
-        .option("--tag <value>", "npm dist-tag/version for CLI and registry package upgrades")
-        .option("--package-name <value>", "Override the CLI package name for self-upgrade testing");
-}
-async function executeUpgradeCommand(target, command, legacyAlias) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    if (legacyAlias) {
-        await emitDeprecatedAliasHint("upgrade", command);
-    }
-    const result = await runUpgrade(target, command.opts(), globalOptions);
-    printResult(result, globalOptions);
-    if (!result.ok) {
-        process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-    }
-    if (globalOptions.profile) {
-        printError(`profile:command=package-upgrade took_ms=${Date.now() - startedAt}`);
-    }
-}
-function registerLifecycleCommand(program, vocabulary) {
-    const noun = vocabulary === "package" ? "package" : "extension";
-    const plural = vocabulary === "package" ? "packages" : "extensions";
-    const commandName = vocabulary;
-    const lifecycleCommand = program
-        .command(commandName, { hidden: vocabulary === "extension" })
-        .argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} source, name, or scaffold path`)
-        .option("--init", `Generate a starter ${noun} scaffold at target path`)
-        .option("--scaffold", "Alias for --init")
-        .option("--capability <kind>", "Starter capability for --init (default: commands)", collect)
-        .option("--install", `Install a ${noun} source`)
-        .option("--uninstall", `Uninstall an installed ${noun}`)
-        .option("--explore", `List discovered ${plural} in selected scope`)
-        .option("--list", "Alias for --explore")
-        .option("--manage", `List managed ${plural} with update-check metadata`)
-        .option("--describe", `Map every surface a loaded ${noun} registers (optionally one by name)`)
-        .option("--markdown", "Render describe output as a Markdown reference document (describe only)")
-        .option("--output <path>", "Write describe Markdown to a file (requires --markdown)")
-        .option("--reload", `Reload ${plural} with cache-busted module imports`)
-        .option("--watch", "Use watch mode with --reload")
-        .option("--doctor", `Run consolidated ${noun} diagnostics (summary/deep modes)`)
-        .option("--catalog", `List bundled first-party ${noun} catalog metadata`)
-        .option("--adopt", `Adopt an existing unmanaged ${noun} into managed metadata`)
-        .option("--adopt-all", `Adopt all unmanaged ${plural} into managed metadata`)
-        .option("--activate", `Activate a ${noun} in selected scope settings`)
-        .option("--deactivate", `Deactivate a ${noun} in selected scope settings`)
-        .option("--project", `Use project ${noun} scope (default)`)
-        .option("--local", "Alias for --project")
-        .option("--global", `Use global ${noun} scope`)
-        .option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])")
-        .option("--github <github-source>", "Alias for --gh")
-        .option("--ref <ref>", "Git ref/branch/tag for GitHub install sources")
-        .option("--detail <mode>", `${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`)
-        .option("--trace", "Include actionable registration traces in doctor deep diagnostics")
-        .option("--runtime-probe", "Opt-in runtime activation probe for manage output parity")
-        .option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`)
-        .option("--isolated", `Run doctor against project-scope ${plural} only, ignoring global registrations`)
-        .option("--ignore-global", "Alias for --isolated")
-        .option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)")
-        .option("--fail-on-warn", "Alias for --strict-exit (doctor)")
-        .description(vocabulary === "package"
-        ? "Manage package lifecycle in project or global scope."
-        : "Manage extension lifecycle in project or global scope.")
-        .action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, undefined, vocabulary);
-    });
-    if (vocabulary === "package") {
-        lifecycleCommand.alias("packages");
-        // `--declarative` scaffolds a `composeExtension` blueprint starter, which is a
-        // runtime SDK *value* import — only package-mode authoring links the SDK, so the
-        // flag is package-only. It is advertised solely on `pm package` (the top-level
-        // lifecycle command and its `init` subcommand below); `scaffoldExtensionProject`
-        // still rejects extension-mode + declarative as defense-in-depth for the
-        // programmatic/MCP path.
-        lifecycleCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
-    }
-    const initCommand = lifecycleCommand
-        .command("init")
-        .alias("scaffold")
-        .argument("<target>", `Scaffold target directory path`)
-        .option("--capability <kind>", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`, collect)
-        .description(vocabulary === "package"
-        ? "Generate a starter package scaffold with package metadata, manifest, and entrypoint."
-        : "Generate a starter extension scaffold with manifest and entrypoint.");
-    if (vocabulary === "package") {
-        initCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
-    }
-    addLifecycleScopeOptions(initCommand, vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "init", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("install")
-        .argument("[targets...]", `${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`)
-        .option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])")
-        .option("--github <github-source>", "Alias for --gh")
-        .option("--ref <ref>", "Git ref/branch/tag for GitHub install sources")
-        .description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`), vocabulary).action(async (targets, _options, command) => {
-        await executeExtensionInstallCommand(targets, command.optsWithGlobals(), command, vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("uninstall")
-        .argument("<target>", `${noun[0].toUpperCase()}${noun.slice(1)} name`)
-        .description(`Uninstall an installed ${noun}.`), vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "uninstall", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("explore")
-        .description(`List discovered ${plural} in selected scope.`), vocabulary).action(async (_options, command) => {
-        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "explore", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("manage")
-        .option("--runtime-probe", "Opt-in runtime activation probe for manage output parity")
-        .option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`)
-        .description(`List managed ${plural} with update-check metadata.`), vocabulary).action(async (_options, command) => {
-        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "manage", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("describe")
-        .argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`)
-        .option("--markdown", "Render the surface map as a Markdown reference document instead of toon/json")
-        .option("--output <path>", "Write Markdown output to a file (requires --markdown)")
-        .description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`), vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "describe", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("reload")
-        .option("--watch", "Use watch mode for repeated reload checks")
-        .description(`Reload ${plural} with cache-busted module imports.`), vocabulary).action(async (_options, command) => {
-        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "reload", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("doctor")
-        .option("--detail <mode>", `Detail mode for ${noun} diagnostics (summary|deep)`)
-        .option("--trace", "Include actionable registration traces in doctor deep diagnostics")
-        .option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`)
-        .option("--isolated", `Run doctor against project-scope ${plural} only, ignoring global registrations`)
-        .option("--ignore-global", "Alias for --isolated")
-        .option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)")
-        .option("--fail-on-warn", "Alias for --strict-exit (doctor)")
-        .description(`Run consolidated ${noun} diagnostics (summary/deep modes).`), vocabulary).action(async (_options, command) => {
-        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "doctor", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("catalog")
-        .alias("list")
-        .option("--fields <value>", "Render compact comma-separated catalog fields, for example: alias,installed,install_command")
-        .description(`List bundled first-party ${noun} catalog metadata.`), vocabulary).action(async (_options, command) => {
-        await executeExtensionCommand(undefined, command.optsWithGlobals(), command, "catalog", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("adopt")
-        .argument("<target>", `${noun[0].toUpperCase()}${noun.slice(1)} name`)
-        .option("--gh <owner/repo[/path]>", `GitHub provenance shorthand for adopted ${noun}`)
-        .option("--github <owner/repo[/path]>", "Alias for --gh")
-        .option("--ref <ref>", "Git ref/branch/tag for GitHub shorthand source")
-        .description(`Adopt an existing unmanaged ${noun} into managed metadata.`), vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "adopt", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("adopt-all")
-        .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`)
-        .description(`Activate a ${noun} in selected scope settings.`), vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "activate", vocabulary);
-    });
-    addLifecycleScopeOptions(lifecycleCommand
-        .command("deactivate")
-        .argument("<target>", `${noun[0].toUpperCase()}${noun.slice(1)} name`)
-        .description(`Deactivate a ${noun} in selected scope settings.`), vocabulary).action(async (target, _options, command) => {
-        await executeExtensionCommand(target, command.optsWithGlobals(), command, "deactivate", vocabulary);
-    });
-    if (vocabulary === "package") {
-        addUpgradeOptions(addPackageScopeOptions(lifecycleCommand
-            .command("upgrade")
-            .argument("[target]", "Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages")
-            .description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async (target, _options, command) => {
-            await executeUpgradeCommand(target, command, false);
-        });
-    }
-}
-async function runInitCommandAction(prefix, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const result = await runInit(prefix, globalOptions, {
-        idPrefix: typeof options.idPrefix === "string" ? options.idPrefix : undefined,
-        preset: typeof options.preset === "string" ? options.preset : undefined,
-        defaults: options.defaults === true || options.yes === true,
-        author: typeof options.author === "string" ? options.author : undefined,
-        agentGuidance: typeof options.agentGuidance === "string"
-            ? options.agentGuidance
-            : undefined,
-        typePreset: typeof options.typePreset === "string" ? options.typePreset : undefined,
-        withPackages: options.withPackages === true,
-        mergeFence: options.mergeFence !== false,
-        force: options.force === true,
-        workspace: typeof options.workspace === "string" ? options.workspace : undefined,
-    });
-    const verbose = options.verbose === true;
-    const emitFullTree = verbose || globalOptions.json === true;
-    printResult(emitFullTree ? result : summarizeInitResult(result), globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=init took_ms=${Date.now() - startedAt}`);
-    }
-}
-function resolveConfigPositionals(scope, action, key, value) {
-    const actionShorthands = new Set(["get", "set", "list", "export"]);
-    const scopeShorthand = scope !== undefined && actionShorthands.has(scope);
-    return {
-        resolvedScope: scopeShorthand ? "project" : (scope ?? "project"),
-        resolvedAction: scopeShorthand ? scope : (action ?? "list"),
-        resolvedKey: scopeShorthand ? action : key,
-        resolvedValue: scopeShorthand ? key : value,
-    };
-}
-function buildConfigOptions(options) {
-    return {
-        criterion: Array.isArray(options.criterion)
-            ? options.criterion
-            : [],
-        format: typeof options.format === "string" ? options.format : undefined,
-        policy: typeof options.policy === "string" ? options.policy : undefined,
-        value: typeof options.value === "string" ? options.value : undefined,
-        clearCriteria: options.clearCriteria === true,
-        defaultDepth: typeof options.defaultDepth === "string"
-            ? options.defaultDepth
-            : undefined,
-        activityLimit: typeof options.activityLimit === "string"
-            ? options.activityLimit
-            : undefined,
-        staleThresholdDays: typeof options.staleThresholdDays === "string"
-            ? options.staleThresholdDays
-            : undefined,
-        sectionHierarchy: typeof options.sectionHierarchy === "string"
-            ? options.sectionHierarchy
-            : undefined,
-        sectionActivity: typeof options.sectionActivity === "string"
-            ? options.sectionActivity
-            : undefined,
-        sectionProgress: typeof options.sectionProgress === "string"
-            ? options.sectionProgress
-            : undefined,
-        sectionBlockers: typeof options.sectionBlockers === "string"
-            ? options.sectionBlockers
-            : undefined,
-        sectionFiles: typeof options.sectionFiles === "string"
-            ? options.sectionFiles
-            : undefined,
-        sectionWorkload: typeof options.sectionWorkload === "string"
-            ? options.sectionWorkload
-            : undefined,
-        sectionStaleness: typeof options.sectionStaleness === "string"
-            ? options.sectionStaleness
-            : undefined,
-        sectionTests: typeof options.sectionTests === "string"
-            ? options.sectionTests
-            : undefined,
-    };
-}
-async function runConfigCommandAction(scope, action, key, value, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { resolvedScope, resolvedAction, resolvedKey, resolvedValue } = resolveConfigPositionals(scope, action, key, value);
-    const result = await runConfig(resolvedScope, resolvedAction, resolvedKey, buildConfigOptions(options), globalOptions, typeof resolvedValue === "string" ? resolvedValue : undefined);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=config took_ms=${Date.now() - startedAt}`);
-    }
-}
-/** Internal setup helpers exposed only for deterministic unit coverage. */
-export const _testOnlyRegisterSetup = {
-    normalizeExtensionOptions,
-};
-/** Register initialization, configuration, package, and extension setup commands. */
-export function registerSetupCommands(program) {
-    program
-        .command("init")
-        .argument("[prefix-or-path]", "Optional id prefix, or path-like tracker target such as ./pm-sandbox")
-        .option("--prefix, --id-prefix <value>", "Set the item ID prefix (alias for the positional prefix)")
-        .option("--preset <value>", "Governance preset for new setups: minimal|default|strict")
-        .option("--defaults", "Use non-interactive setup defaults without opening the wizard")
-        .option("-y, --yes", "Alias for --defaults (non-interactive setup)")
-        .option("--author <value>", "Set the default mutation author for this project")
-        .option("--agent-guidance <mode>", "Agent guidance mode: ask|add|skip|status")
-        .option("--type-preset <name>", "Register domain item types during init: agile|ops|research")
-        .option("--with-packages", "Install all bundled first-party packages during initialization")
-        .option("--no-merge-fence", "Skip automatic merge-driver installation for a fresh Git-backed tracker")
-        .option("--workspace <dir>", "Initialize repository-local tracker storage at <dir>/.agents/pm")
-        .option("--force", "Allow initializing tracker files directly in a directory that looks like a workspace root")
-        .option("--verbose", "Include the full resolved settings tree in the output (default output is a concise summary)")
-        .description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.")
-        .action(async (prefix, options, command) => {
-        await runInitCommandAction(prefix, options, command);
-    });
-    program
-        .command("config")
-        .argument("[scope]", "Config scope: project|global, or action shorthand list|export|get|set for project scope")
-        .argument("[action]", "Config action: get|set|list|export")
-        .argument("[key]", "Config key for get|set; use `pm config project list` for the complete typed inventory, including mutation-guard-* policies")
-        .argument("[value]", 'Optional value for set: routed to the right typed flag by key (e.g. config set telemetry-tracking off, config set item-format toon, config set definition-of-done "Tests pass"). Equivalent to --policy/--format/--criterion. context keys still require --default-depth/--section-* flags.')
-        .option("--criterion <text>", "Criteria value for definition-of-done, metadata-required-fields, or lifecycle pattern keys (repeatable for set)", collect)
-        .option("--clear-criteria", "Clear criteria-list keys for config set operations")
-        .option("--format <value>", "Item format for item-format key: toon")
-        .option("--policy <value>", "Policy key values: history-missing-stream-policy=auto_create|strict_error; sprint-release-format-policy=warn|strict_error; parent-reference-policy=warn|strict_error; governance-preset=minimal|default|strict|custom; governance-ownership-enforcement=none|warn|strict; governance-create-mode-default=progressive|strict; governance-close-validation-default=off|warn|strict; governance-require-close-reason=enabled|disabled; governance-parent-reference-policy=warn|strict_error; governance-metadata-validation-profile=core|strict|custom; governance-force-required-for-stale-lock=enabled|disabled; governance-duplicate-detection-mode=off|advisory|strict; test-result-tracking=enabled|disabled; untrusted-linked-test-execution=enabled|disabled; telemetry-tracking=enabled|disabled")
-        .option("--value <value>", "Typed nested setting value. Mutation guards: require-attributed-author=true|false, secret-guard=off|advise|block, stale-in-progress-hours=integer>=1. Kebab-case is preferred; underscore aliases remain accepted.")
-        .option("--default-depth <value>", "Context default depth: brief|standard|deep")
-        .option("--activity-limit <n>", "Context default activity limit")
-        .option("--stale-threshold-days <n>", "Context staleness cutoff in days")
-        .option("--section-hierarchy <value>", "Enable/disable context hierarchy section (true|false)")
-        .option("--section-activity <value>", "Enable/disable context activity section (true|false)")
-        .option("--section-progress <value>", "Enable/disable context progress section (true|false)")
-        .option("--section-blockers <value>", "Enable/disable context blockers section (true|false)")
-        .option("--section-files <value>", "Enable/disable context files section (true|false)")
-        .option("--section-workload <value>", "Enable/disable context workload section (true|false)")
-        .option("--section-staleness <value>", "Enable/disable context staleness section (true|false)")
-        .option("--section-tests <value>", "Enable/disable context tests section (true|false)")
-        .description("Read or update pm settings for the current workspace or global profile.")
-        .action(async (scope, action, key, value, options, command) => {
-        await runConfigCommandAction(scope, action, key, value, options, command);
-    });
-    registerLifecycleCommand(program, "extension");
-    registerLifecycleCommand(program, "package");
-    addPackageScopeOptions(program
-        .command("install", { hidden: true })
-        .argument("[targets...]", "Package source (local path, bundled alias, npm: source, wildcard, or GitHub source)")
-        .option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])")
-        .option("--github <github-source>", "Alias for --gh")
-        .option("--ref <ref>", "Git ref/branch/tag for GitHub install sources")
-        .description("Install a pm package into the project package scope by default.")).action(async (targets, _options, command) => {
-        await emitDeprecatedAliasHint("install", command);
-        await executeExtensionInstallCommand(targets, command.optsWithGlobals(), command, "package");
-    });
-    addUpgradeOptions(addPackageScopeOptions(program
-        .command("upgrade", { hidden: true })
-        .argument("[target]", "Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages")
-        .description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async (target, _options, command) => {
-        await executeUpgradeCommand(target, command, true);
-    });
-}
+!(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]="4720a00c-4389-5dd4-a9f9-63aeff8c8762")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{EXIT_CODE,PmCliError,readSettings,resolvePmRoot}from"../sdk/runtime-primitives.js";import{renderPmCommandAliasMigrationHint,resolvePmCommandAlias}from"../sdk/cli-contracts.js";import{collect,getGlobalOptions,printError,printResult,writeStdout}from"./registration-helpers.js";import{runExtension}from"./commands/extension.js";import{SCAFFOLD_CAPABILITIES}from"./commands/extension/scaffold.js";import{renderExtensionDescribeMarkdown}from"./commands/extension/describe.js";import{runConfig}from"./commands/config.js";import{runInit,summarizeInitResult}from"./commands/init.js";import{runUpgrade}from"./commands/upgrade.js";const LIFECYCLE_DEPRECATION_ALIASES={extension:"extension",package:void 0};async function emitDeprecatedAliasHint(alias,command){if(!alias)return;const aliasContract=resolvePmCommandAlias(alias);const globalOptions=getGlobalOptions(command);const deprecationHints=await readSettings(resolvePmRoot(process.cwd(),globalOptions.path)).then(settings=>settings.ux.deprecation_hints);if(deprecationHints){printError(renderPmCommandAliasMigrationHint(aliasContract))}}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"};function resolveScaffoldCapability(options){const rawCapability=options.capability;const values=typeof rawCapability==="string"?[rawCapability]:Array.isArray(rawCapability)?rawCapability.filter(entry=>typeof entry==="string"):[];const capabilities=[...new Set(values.map(capability=>capability.trim().toLowerCase()).filter(capability=>capability.length>0))];if(capabilities.length>1){throw new PmCliError(`Multiple scaffold capabilities cannot be combined yet: ${capabilities.join(", ")}. Choose one capability per scaffold.`,EXIT_CODE.USAGE)}return capabilities[0]}function normalizeExtensionOptions(options,forcedAction,vocabulary="extension"){const normalizedOptions={...options};if(forcedAction!==void 0){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 normalizedOptions[key]==="string"){return normalizedOptions[key]}}return void 0};return{init:readBoolean("init"),scaffold:readBoolean("scaffold"),install:readBoolean("install"),uninstall:readBoolean("uninstall"),explore:readBoolean("explore","list"),manage:readBoolean("manage"),describe:readBoolean("describe"),markdown:readBoolean("markdown"),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"),gh:readString("gh"),github:readString("github"),ref:readString("ref"),capability:resolveScaffoldCapability(options),declarative:readBoolean("declarative"),fields:readString("fields"),detail:readString("detail"),output:readString("output"),trace:readBoolean("trace"),watch:readBoolean("watch"),runtimeProbe:readBoolean("runtimeProbe","runtime_probe","runtime-probe"),fixManagedState:readBoolean("fixManagedState","fix_managed_state","fix-managed-state"),isolated:readBoolean("isolated"),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}}async function looksLikeShellExpandedWildcard(targets){const visibleEntries=(await fs.readdir(process.cwd())).filter(entry=>!entry.startsWith(".")).sort((left,right)=>left.localeCompare(right));const normalizedTargets=[...targets].sort((left,right)=>left.localeCompare(right));return visibleEntries.length===normalizedTargets.length&&visibleEntries.every((entry,index)=>entry===normalizedTargets[index])}async function normalizeInstallTargets(targets){const normalizedTargets=(targets??[]).map(target=>target.trim()).filter(target=>target.length>0);if(normalizedTargets.length<=1){return normalizedTargets.length===0?void 0:normalizedTargets}if(await looksLikeShellExpandedWildcard(normalizedTargets)){return["*"]}return normalizedTargets}function validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath){const wantsMarkdown=normalizedOptions.markdown===true;if(outputPath!==void 0&&outputPath===""){throw new PmCliError("--output requires a non-empty file path.",EXIT_CODE.USAGE)}if(outputPath!==void 0&&!wantsMarkdown){throw new PmCliError("--output is only supported with --markdown describe output.",EXIT_CODE.USAGE)}if(!wantsMarkdown){return}if(globalOptions.json){throw new PmCliError("Cannot combine --json with --markdown.",EXIT_CODE.USAGE)}if(normalizedOptions.describe!==true){throw new PmCliError("--markdown is only supported by the describe action.",EXIT_CODE.USAGE)}}async function emitExtensionMarkdownResult(params){const markdown=renderExtensionDescribeMarkdown(params.result.details,params.vocabulary);if(params.outputPath!==void 0){const resolvedOutputPath=path.resolve(params.outputPath);await fs.mkdir(path.dirname(resolvedOutputPath),{recursive:true});await fs.writeFile(resolvedOutputPath,markdown,"utf8")}if(params.globalOptions.quiet){return}for(const warning of params.result.warnings){printError(`warning: ${warning}`)}if(params.outputPath===void 0){writeStdout(markdown)}}function applyExtensionDoctorStrictExit(result,normalizedOptions){const strictExit=Boolean(normalizedOptions.strictExit)||Boolean(normalizedOptions.failOnWarn);if(result.action!=="doctor"||!strictExit){return}const detailsRecord=result.details!==null&&typeof result.details==="object"?result.details:{};const summary=detailsRecord.summary!==null&&typeof detailsRecord.summary==="object"?detailsRecord.summary:null;const summaryStatus=summary&&typeof summary.status==="string"?summary.status:void 0;const shouldFail=result.warnings.length>0||summaryStatus!==void 0&&summaryStatus!=="ok";if(shouldFail){process.exitCode=EXIT_CODE.GENERIC_FAILURE}}async function executeExtensionCommand(target,options,command,forcedAction,vocabulary="extension"){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedOptions=normalizeExtensionOptions(options,forcedAction,effectiveVocabulary);const outputOption=typeof normalizedOptions.output==="string"?normalizedOptions.output:void 0;const outputPath=outputOption?.trim();validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath);const result=await runExtension(target,normalizedOptions,globalOptions);if(normalizedOptions.markdown===true){await emitExtensionMarkdownResult({result,vocabulary:effectiveVocabulary,outputPath,globalOptions})}else{printResult(result,globalOptions)}applyExtensionDoctorStrictExit(result,normalizedOptions);if(result.ok===false){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}}function extractExtensionInstallDetails(result){return result.details!==null&&typeof result.details==="object"?result.details:{}}function serializeExtensionInstallError(error){if(error instanceof PmCliError){return{message:error.message,exit_code:error.exitCode,...error.context}}return{message:error instanceof Error?error.message:String(error),exit_code:EXIT_CODE.GENERIC_FAILURE}}async function runMultiTargetExtensionInstalls(targets,options,globalOptions){const rows=[];const warnings=[];let failureExitCode=EXIT_CODE.GENERIC_FAILURE;for(const target of targets){try{const result=await runExtension(target,options,globalOptions);const details=extractExtensionInstallDetails(result);const targetWarnings=Array.isArray(result.warnings)?result.warnings:[];warnings.push(...targetWarnings);const targetOk=result.ok===true;rows.push({target,ok:targetOk,extension:details.extension,source:details.source,install_plan:details.install_plan,dry_run:details.dry_run,destination_path:details.destination_path,activated:details.activated,settings_changed:details.settings_changed,command_paths:details.command_paths,action_paths:details.action_paths,runtime_activation_status:details.runtime_activation_status,activation_diagnostics:details.activation_diagnostics,command_discovery:details.command_discovery,verification:details.verification,warnings:targetWarnings,...targetOk?{}:{error:{message:"Extension install returned ok=false without throwing an error.",exit_code:EXIT_CODE.GENERIC_FAILURE,code:"extension_install_soft_failed"}}})}catch(error){const serializedError=serializeExtensionInstallError(error);const exitCode=serializedError.exit_code;if(typeof exitCode==="number"&&failureExitCode===EXIT_CODE.GENERIC_FAILURE&&exitCode!==EXIT_CODE.GENERIC_FAILURE){failureExitCode=exitCode}rows.push({target,ok:false,error:serializedError})}}return{rows,warnings,failureExitCode}}async function executeExtensionInstallCommand(targets,options,command,vocabulary){const effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedTargets=await normalizeInstallTargets(targets);if(normalizedTargets===void 0||normalizedTargets.length<=1){await executeExtensionCommand(normalizedTargets?.[0],options,command,"install",effectiveVocabulary);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const normalizedOptions=normalizeExtensionOptions(options,"install",effectiveVocabulary);validateExtensionMarkdownOptions(normalizedOptions,globalOptions,void 0);const hasForcedGithubSource=[normalizedOptions.gh,normalizedOptions.github].some(value=>typeof value==="string"&&value.trim().length>0);if(hasForcedGithubSource){throw new PmCliError("Multiple install targets cannot be combined with --gh/--github. Install one GitHub source per command, or pass multiple explicit local, bundled, or npm: targets.",EXIT_CODE.USAGE,{code:"multi_target_github_install_ambiguous",required:"Use exactly one positional target with --gh/--github, or omit --gh/--github when installing multiple targets.",examples:["pm install --gh owner/repo","pm install npm:pm-guide-shell pm-todos"]})}const{rows,warnings,failureExitCode}=await runMultiTargetExtensionInstalls(normalizedTargets,normalizedOptions,globalOptions);const failedCount=rows.filter(row=>row.ok!==true).length;const result={ok:failedCount===0,action:"install",scope:normalizedOptions.global===true?"global":"project",installed_count:normalizedOptions.dryRun===true?0:rows.length-failedCount,...normalizedOptions.dryRun===true?{dry_run:true,planned_count:rows.length-failedCount}:{},failed_count:failedCount,targets:rows,warnings:[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))};printResult(result,globalOptions);if(failedCount>0){process.exitCode=failureExitCode}if(globalOptions.profile){printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}}function addExtensionScopeOptions(command){return command.option("--project","Use project extension scope (default)").option("--local","Alias for --project").option("--global","Use global extension scope")}function addPackageScopeOptions(command){return command.option("--project","Use project package scope (default)").option("--local","Alias for --project").option("--global","Use global package scope")}function addLifecycleScopeOptions(command,vocabulary){return vocabulary==="package"?addPackageScopeOptions(command):addExtensionScopeOptions(command)}function addUpgradeOptions(command){return command.option("--dry-run","Plan CLI/package upgrades without running npm or reinstalling packages").option("--cli-only","Upgrade only the pm CLI/SDK npm package").option("--packages-only","Upgrade only managed pm packages").option("--repair","Force npm global reinstall when upgrading the pm CLI/SDK").option("--tag <value>","npm dist-tag/version for CLI and registry package upgrades").option("--package-name <value>","Override the CLI package name for self-upgrade testing")}async function executeUpgradeCommand(target,command,legacyAlias){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();if(legacyAlias){await emitDeprecatedAliasHint("upgrade",command)}const result=await runUpgrade(target,command.optsWithGlobals(),globalOptions);printResult(result,globalOptions);if(!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=package-upgrade took_ms=${Date.now()-startedAt}`)}}function registerLifecycleCommand(program,vocabulary){const noun=vocabulary==="package"?"package":"extension";const plural=vocabulary==="package"?"packages":"extensions";const commandName=vocabulary;const lifecycleCommand=program.command(commandName,{hidden:vocabulary==="extension"}).argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} source, name, or scaffold path`).option("--init",`Generate a starter ${noun} scaffold at target path`).option("--scaffold","Alias for --init").option("--capability <kind>","Starter capability for --init (default: commands)",collect).option("--install",`Install a ${noun} source`).option("--dry-run","Resolve install sources and estimate copying without destination writes or activation").option("--uninstall",`Uninstall an installed ${noun}`).option("--explore",`List discovered ${plural} in selected scope`).option("--list","Alias for --explore").option("--manage",`List managed ${plural} with update-check metadata`).option("--describe",`Map every surface a loaded ${noun} registers (optionally one by name)`).option("--markdown","Render describe output as a Markdown reference document (describe only)").option("--output <path>","Write describe Markdown to a file (requires --markdown)").option("--reload",`Reload ${plural} with cache-busted module imports`).option("--watch","Use watch mode with --reload").option("--doctor",`Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog",`List bundled first-party ${noun} catalog metadata`).option("--adopt",`Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all",`Adopt all unmanaged ${plural} into managed metadata`).option("--activate",`Activate a ${noun} in selected scope settings`).option("--deactivate",`Deactivate a ${noun} in selected scope settings`).option("--project",`Use project ${noun} scope (default)`).option("--local","Alias for --project").option("--global",`Use global ${noun} scope`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").option("--detail <mode>",`${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(vocabulary==="package"?"Manage package lifecycle in project or global scope.":"Manage extension lifecycle in project or global scope.").action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,void 0,vocabulary)});if(vocabulary==="package"){lifecycleCommand.alias("packages");lifecycleCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)")}const initCommand=lifecycleCommand.command("init").alias("scaffold").argument("<target>",`Scaffold target directory path`).option("--capability <kind>",`Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`,collect).description(vocabulary==="package"?"Generate a starter package scaffold with package metadata, manifest, and entrypoint.":"Generate a starter extension scaffold with manifest and entrypoint.");if(vocabulary==="package"){initCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)")}addLifecycleScopeOptions(initCommand,vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"init",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("install").option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]",`${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`),vocabulary).action(async(targets,_options,command)=>{await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("uninstall").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Uninstall an installed ${noun}.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"uninstall",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("explore").description(`List discovered ${plural} in selected scope.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"explore",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("manage").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).description(`List managed ${plural} with update-check metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"manage",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).option("--markdown","Render the surface map as a Markdown reference document instead of toon/json").option("--output <path>","Write Markdown output to a file (requires --markdown)").description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"describe",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("reload").option("--watch","Use watch mode for repeated reload checks").description(`Reload ${plural} with cache-busted module imports.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"reload",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("doctor").option("--detail <mode>",`Detail mode for ${noun} diagnostics (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(`Run consolidated ${noun} diagnostics (summary/deep modes).`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"doctor",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("catalog").alias("list").option("--fields <value>","Render compact comma-separated catalog fields, for example: alias,installed,install_command").description(`List bundled first-party ${noun} catalog metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"catalog",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("adopt").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).option("--gh <owner/repo[/path]>",`GitHub provenance shorthand for adopted ${noun}`).option("--github <owner/repo[/path]>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub shorthand source").description(`Adopt an existing unmanaged ${noun} into managed metadata.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"adopt",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("adopt-all").description(`Adopt all unmanaged ${plural} into managed metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,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(void 0,command.optsWithGlobals(),command,"migrate",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("activate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Activate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"activate",vocabulary)});addLifecycleScopeOptions(lifecycleCommand.command("deactivate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Deactivate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"deactivate",vocabulary)});if(vocabulary==="package"){addUpgradeOptions(addPackageScopeOptions(lifecycleCommand.command("upgrade").argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,false)})}}async function runInitCommandAction(prefix,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runInit(prefix,globalOptions,{idPrefix:typeof options.idPrefix==="string"?options.idPrefix:void 0,preset:typeof options.preset==="string"?options.preset:void 0,defaults:options.defaults===true||options.yes===true,author:typeof options.author==="string"?options.author:void 0,agentGuidance:typeof options.agentGuidance==="string"?options.agentGuidance:void 0,typePreset:typeof options.typePreset==="string"?options.typePreset:void 0,withPackages:options.withPackages===true,mergeFence:options.mergeFence!==false,force:options.force===true,workspace:typeof options.workspace==="string"?options.workspace:void 0});const verbose=options.verbose===true;const emitFullTree=verbose||globalOptions.json===true;printResult(emitFullTree?result:summarizeInitResult(result),globalOptions);if(globalOptions.profile){printError(`profile:command=init took_ms=${Date.now()-startedAt}`)}}function resolveConfigPositionals(scope,action,key,value){const actionShorthands=new Set(["get","set","list","export"]);const scopeShorthand=scope!==void 0&&actionShorthands.has(scope);return{resolvedScope:scopeShorthand?"project":scope??"project",resolvedAction:scopeShorthand?scope:action??"list",resolvedKey:scopeShorthand?action:key,resolvedValue:scopeShorthand?key:value}}function buildConfigOptions(options){return{criterion:Array.isArray(options.criterion)?options.criterion:[],format:typeof options.format==="string"?options.format:void 0,policy:typeof options.policy==="string"?options.policy:void 0,value:typeof options.value==="string"?options.value:void 0,clearCriteria:options.clearCriteria===true,defaultDepth:typeof options.defaultDepth==="string"?options.defaultDepth:void 0,activityLimit:typeof options.activityLimit==="string"?options.activityLimit:void 0,staleThresholdDays:typeof options.staleThresholdDays==="string"?options.staleThresholdDays:void 0,sectionHierarchy:typeof options.sectionHierarchy==="string"?options.sectionHierarchy:void 0,sectionActivity:typeof options.sectionActivity==="string"?options.sectionActivity:void 0,sectionProgress:typeof options.sectionProgress==="string"?options.sectionProgress:void 0,sectionBlockers:typeof options.sectionBlockers==="string"?options.sectionBlockers:void 0,sectionFiles:typeof options.sectionFiles==="string"?options.sectionFiles:void 0,sectionWorkload:typeof options.sectionWorkload==="string"?options.sectionWorkload:void 0,sectionStaleness:typeof options.sectionStaleness==="string"?options.sectionStaleness:void 0,sectionTests:typeof options.sectionTests==="string"?options.sectionTests:void 0}}async function runConfigCommandAction(scope,action,key,value,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const{resolvedScope,resolvedAction,resolvedKey,resolvedValue}=resolveConfigPositionals(scope,action,key,value);const result=await runConfig(resolvedScope,resolvedAction,resolvedKey,buildConfigOptions(options),globalOptions,typeof resolvedValue==="string"?resolvedValue:void 0);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=config took_ms=${Date.now()-startedAt}`)}}const _testOnlyRegisterSetup={normalizeExtensionOptions};function registerSetupCommands(program){program.command("init").argument("[prefix-or-path]","Optional id prefix, or path-like tracker target such as ./pm-sandbox").option("--prefix, --id-prefix <value>","Set the item ID prefix (alias for the positional prefix)").option("--preset <value>","Governance preset for new setups: minimal|default|strict").option("--defaults","Use non-interactive setup defaults without opening the wizard").option("-y, --yes","Alias for --defaults (non-interactive setup)").option("--author <value>","Set the default mutation author for this project").option("--agent-guidance <mode>","Agent guidance mode: ask|add|skip|status").option("--type-preset <name>","Register domain item types during init: agile|ops|research").option("--with-packages","Install all bundled first-party packages during initialization").option("--no-merge-fence","Skip automatic merge-driver installation for a fresh Git-backed tracker").option("--workspace <dir>","Initialize repository-local tracker storage at <dir>/.agents/pm").option("--force","Allow initializing tracker files directly in a directory that looks like a workspace root").option("--verbose","Include the full resolved settings tree in the output (default output is a concise summary)").description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.").action(async(prefix,options,command)=>{await runInitCommandAction(prefix,options,command)});program.command("config").argument("[scope]","Config scope: project|global, or action shorthand list|export|get|set for project scope").argument("[action]","Config action: get|set|list|export").argument("[key]","Config key for get|set; use `pm config project list` for the complete typed inventory, including mutation-guard-* policies").argument("[value]",'Optional value for set: routed to the right typed flag by key (e.g. config set telemetry-tracking off, config set item-format toon, config set definition-of-done "Tests pass"). Equivalent to --policy/--format/--criterion. context keys still require --default-depth/--section-* flags.').option("--criterion <text>","Criteria value for definition-of-done, metadata-required-fields, or lifecycle pattern keys (repeatable for set)",collect).option("--clear-criteria","Clear criteria-list keys for config set operations").option("--format <value>","Item format for item-format key: toon").option("--policy <value>","Policy key values: history-missing-stream-policy=auto_create|strict_error; sprint-release-format-policy=warn|strict_error; parent-reference-policy=warn|strict_error; governance-preset=minimal|default|strict|custom; governance-ownership-enforcement=none|warn|strict; governance-create-mode-default=progressive|strict; governance-close-validation-default=off|warn|strict; governance-require-close-reason=enabled|disabled; governance-parent-reference-policy=warn|strict_error; governance-metadata-validation-profile=core|strict|custom; governance-force-required-for-stale-lock=enabled|disabled; governance-duplicate-detection-mode=off|advisory|strict; test-result-tracking=enabled|disabled; untrusted-linked-test-execution=enabled|disabled; telemetry-tracking=enabled|disabled").option("--value <value>","Typed nested setting value. Mutation guards: require-attributed-author=true|false, secret-guard=off|advise|block, stale-in-progress-hours=integer>=1. Kebab-case is preferred; underscore aliases remain accepted.").option("--default-depth <value>","Context default depth: brief|standard|deep").option("--activity-limit <n>","Context default activity limit").option("--stale-threshold-days <n>","Context staleness cutoff in days").option("--section-hierarchy <value>","Enable/disable context hierarchy section (true|false)").option("--section-activity <value>","Enable/disable context activity section (true|false)").option("--section-progress <value>","Enable/disable context progress section (true|false)").option("--section-blockers <value>","Enable/disable context blockers section (true|false)").option("--section-files <value>","Enable/disable context files section (true|false)").option("--section-workload <value>","Enable/disable context workload section (true|false)").option("--section-staleness <value>","Enable/disable context staleness section (true|false)").option("--section-tests <value>","Enable/disable context tests section (true|false)").description("Read or update pm settings for the current workspace or global profile.").action(async(scope,action,key,value,options,command)=>{await runConfigCommandAction(scope,action,key,value,options,command)});registerLifecycleCommand(program,"extension");registerLifecycleCommand(program,"package");addPackageScopeOptions(program.command("install",{hidden:true}).option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]","Package source (local path, bundled alias, npm: source, wildcard, or GitHub source)").option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description("Install a pm package into the project package scope by default.")).action(async(targets,_options,command)=>{await emitDeprecatedAliasHint("install",command);await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,"package")});addUpgradeOptions(addPackageScopeOptions(program.command("upgrade",{hidden:true}).argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,true)})}export{_testOnlyRegisterSetup,registerSetupCommands};
 //# sourceMappingURL=register-setup.js.map
-//# debugId=feb682f9-344c-569e-bbab-861fe20f08f1