@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/cli-contracts/command-aliases.js

@@ -1,108 +1,2 @@
-/**
- * @module sdk/cli-contracts/command-aliases
- *
- * Declares command aliases once so CLI registration, bootstrap parsing,
- * contracts, completions, and package authors can share one compatibility
- * policy instead of maintaining parallel spelling lists.
- */
-/**
- * Public command-alias table. Deprecated aliases must remain executable but
- * are intentionally absent from default help and completion discovery.
- */
-
-!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]="a7934e70-b1ea-5eac-b500-e4b18a6385a6")}catch(e){}}();
-export const PM_COMMAND_ALIAS_CONTRACTS = [
-    {
-        alias: "tests",
-        canonical: "test",
-        canonical_argv: ["test"],
-        lifecycle: "permanent",
-        hidden: false,
-        registration: "bootstrap",
-        owner: "pm-u4t9gp",
-    },
-    ...[
-        ["fetch", "get"],
-        ["read", "get"],
-        ["show", "get"],
-        ["view", "get"],
-        ["comment", "comments"],
-        ["note", "notes"],
-        ["learning", "learnings"],
-    ].map(([alias, canonical]) => ({
-        alias,
-        canonical,
-        canonical_argv: [canonical],
-        lifecycle: "permanent",
-        hidden: false,
-        registration: "bootstrap",
-        owner: "pm-pbyu",
-    })),
-    ...[
-        ["extension list", "extension catalog"],
-        ["extension scaffold", "extension init"],
-        ["package list", "package catalog"],
-        ["package scaffold", "package init"],
-        ["packages list", "packages catalog"],
-        ["packages scaffold", "packages init"],
-    ].map(([alias, canonical]) => ({
-        alias,
-        canonical,
-        canonical_argv: canonical.split(" "),
-        lifecycle: "permanent",
-        hidden: false,
-        registration: "commander",
-        owner: "pm-ya7x55",
-    })),
-    {
-        alias: "list-all",
-        canonical: "list",
-        canonical_argv: ["list", "--all"],
-        lifecycle: "deprecated",
-        hidden: true,
-        registration: "commander",
-        owner: "pm-pfqi",
-    },
-    ...[
-        ["list-draft", "draft"],
-        ["list-open", "open"],
-        ["list-in-progress", "in_progress"],
-        ["list-blocked", "blocked"],
-        ["list-closed", "closed"],
-        ["list-canceled", "canceled"],
-    ].map(([alias, status]) => ({
-        alias,
-        canonical: "list",
-        canonical_argv: ["list", "--status", status],
-        lifecycle: "deprecated",
-        hidden: true,
-        registration: "commander",
-        owner: "pm-pfqi",
-    })),
-    ...[
-        ["extension", "package"],
-        ["install", "package install"],
-        ["upgrade", "package upgrade"],
-    ].map(([alias, canonical]) => ({
-        alias,
-        canonical,
-        canonical_argv: canonical.split(" "),
-        lifecycle: "deprecated",
-        hidden: true,
-        registration: "commander",
-        owner: "pm-tnud",
-    })),
-];
-/** High-frequency executable aliases whose targets accept identical arguments. */
-export const EXECUTABLE_COMMAND_ALIASES = Object.fromEntries(PM_COMMAND_ALIAS_CONTRACTS.filter((contract) => contract.registration === "bootstrap").map((contract) => [contract.alias, contract.canonical]));
-/** Resolve one declared command alias without inferring from its spelling. */
-export function resolvePmCommandAlias(alias) {
-    const normalized = alias.trim().toLowerCase();
-    return PM_COMMAND_ALIAS_CONTRACTS.find((contract) => contract.alias === normalized);
-}
-/** Render the stable one-line migration hint emitted for deprecated aliases. */
-export function renderPmCommandAliasMigrationHint(contract) {
-    return `Deprecated command \`${contract.alias}\`; use \`pm ${contract.canonical_argv.join(" ")}\`.`;
-}
+!(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]="4f5e4655-b263-5ad7-80c6-536ab242dd98")}catch(e2){}})();const PM_HISTORY_COMMAND_ALIASES=[["history-redact","history redact"],["history-repair","history repair"],["history-compact","history compact"],["activity","history activity"],["restore","history restore"]].map(([alias,canonical])=>({alias,canonical,canonical_argv:canonical.split(" "),lifecycle:"permanent",hidden:true,registration:"commander",owner:"pm-tqel"}));function resolvePmHistoryOperation(command){const normalized=command.trim().replace(/\s+/gu," ");return PM_HISTORY_COMMAND_ALIASES.find(alias=>alias.canonical===normalized)?.alias??normalized}const PM_COMMAND_ALIAS_CONTRACTS=[...PM_HISTORY_COMMAND_ALIASES,{alias:"tests",canonical:"test",canonical_argv:["test"],lifecycle:"permanent",hidden:false,registration:"bootstrap",owner:"pm-u4t9gp"},...[["fetch","get"],["read","get"],["show","get"],["view","get"],["comment","comments"],["note","notes"],["learning","learnings"]].map(([alias,canonical])=>({alias,canonical,canonical_argv:[canonical],lifecycle:"permanent",hidden:false,registration:"bootstrap",owner:"pm-pbyu"})),...[["extension list","extension catalog"],["extension scaffold","extension init"],["package list","package catalog"],["package scaffold","package init"],["packages list","packages catalog"],["packages scaffold","packages init"]].map(([alias,canonical])=>({alias,canonical,canonical_argv:canonical.split(" "),lifecycle:"permanent",hidden:false,registration:"commander",owner:"pm-ya7x55"})),{alias:"list-all",canonical:"list",canonical_argv:["list","--all"],lifecycle:"deprecated",hidden:true,registration:"commander",owner:"pm-pfqi"},...[["list-draft","draft"],["list-open","open"],["list-in-progress","in_progress"],["list-blocked","blocked"],["list-closed","closed"],["list-canceled","canceled"]].map(([alias,status])=>({alias,canonical:"list",canonical_argv:["list","--status",status],lifecycle:"deprecated",hidden:true,registration:"commander",owner:"pm-pfqi"})),...[["extension","package"],["install","package install"],["upgrade","package upgrade"]].map(([alias,canonical])=>({alias,canonical,canonical_argv:canonical.split(" "),lifecycle:"deprecated",hidden:true,registration:"commander",owner:"pm-tnud"}))];const EXECUTABLE_COMMAND_ALIASES=Object.fromEntries(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.registration==="bootstrap").map(contract=>[contract.alias,contract.canonical]));function resolvePmCommandAlias(alias){const normalized=alias.trim().toLowerCase();return PM_COMMAND_ALIAS_CONTRACTS.find(contract=>contract.alias===normalized)}function renderPmCommandAliasMigrationHint(contract){return`Deprecated command \`${contract.alias}\`; use \`pm ${contract.canonical_argv.join(" ")}\`.`}export{EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,PM_HISTORY_COMMAND_ALIASES,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,resolvePmHistoryOperation};
 //# sourceMappingURL=command-aliases.js.map
-//# debugId=a7934e70-b1ea-5eac-b500-e4b18a6385a6

package/dist/sdk/cli-contracts/command-exit-contracts.js

@@ -1,152 +1,2 @@
-/**
- * @module sdk/command-exit-contracts
- *
- * Declares shell-visible command outcomes and derives effect receipts shared by
- * CLI, SDK, MCP, packages, telemetry, and conformance gates.
- */
-
-!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]="5bbc21f0-f517-571a-8ecf-45f20f0e793d")}catch(e){}}();
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PM_CORE_COMMAND_NAMES } from "./enum-contracts.js";
-/** Canonical effect vocabulary for all stable CLI process exits. */
-export const PM_COMMAND_EXIT_OUTCOME_CONTRACTS = [
-    {
-        exit_code: EXIT_CODE.SUCCESS,
-        outcome: "effect",
-        success: true,
-        meaning: "The requested operation completed with its intended effect.",
-    },
-    {
-        exit_code: EXIT_CODE.GENERIC_FAILURE,
-        outcome: "internal_failure",
-        success: false,
-        meaning: "An unexpected runtime or internal failure prevented completion.",
-    },
-    {
-        exit_code: EXIT_CODE.USAGE,
-        outcome: "refused_input",
-        success: false,
-        meaning: "The invocation was refused because its input or composition was invalid.",
-    },
-    {
-        exit_code: EXIT_CODE.NOT_FOUND,
-        outcome: "refused_tracker_state",
-        success: false,
-        meaning: "The requested tracker, item, or resource was not present.",
-    },
-    {
-        exit_code: EXIT_CODE.CONFLICT,
-        outcome: "conflict",
-        success: false,
-        meaning: "Current state or concurrency prevented the requested effect.",
-    },
-    {
-        exit_code: EXIT_CODE.DEPENDENCY_FAILED,
-        outcome: "dependency_failed",
-        success: false,
-        meaning: "A required dependency operation failed.",
-    },
-    {
-        exit_code: EXIT_CODE.NO_EFFECT,
-        outcome: "no_effect",
-        success: true,
-        meaning: "The request was valid and completed, but matched nothing to change.",
-    },
-    {
-        exit_code: EXIT_CODE.PARTIAL_EFFECT,
-        outcome: "partial_effect",
-        success: true,
-        meaning: "The request completed and changed some, but not all, selected targets.",
-    },
-];
-const STANDARD_COMMAND_EXIT_CODES = [
-    EXIT_CODE.SUCCESS,
-    EXIT_CODE.GENERIC_FAILURE,
-    EXIT_CODE.USAGE,
-    EXIT_CODE.NOT_FOUND,
-    EXIT_CODE.CONFLICT,
-    EXIT_CODE.DEPENDENCY_FAILED,
-];
-const EFFECT_AWARE_BULK_COMMANDS = new Set(["close-many", "update-many"]);
-/** Exhaustive core command exit declarations generated from the command registry. */
-export const PM_COMMAND_EXIT_CONTRACTS = PM_CORE_COMMAND_NAMES.map((command) => ({
-    command,
-    exit_codes: EFFECT_AWARE_BULK_COMMANDS.has(command)
-        ? [
-            ...STANDARD_COMMAND_EXIT_CODES,
-            EXIT_CODE.NO_EFFECT,
-            EXIT_CODE.PARTIAL_EFFECT,
-        ]
-        : [...STANDARD_COMMAND_EXIT_CODES],
-}));
-const COMMAND_EXIT_CONTRACT_BY_PATH = new Map(PM_COMMAND_EXIT_CONTRACTS.map((contract) => [contract.command, contract]));
-/** Stable successful process exits, including machine-distinct effect states. */
-export const PM_SUCCESS_EXIT_CODES = [
-    EXIT_CODE.SUCCESS,
-    EXIT_CODE.NO_EFFECT,
-    EXIT_CODE.PARTIAL_EFFECT,
-];
-/** Return whether an exit represents a successful command outcome. */
-export function isPmSuccessfulExitCode(exitCode) {
-    return PM_SUCCESS_EXIT_CODES.includes(exitCode);
-}
-/** Return whether an exit belongs to the declared pm process vocabulary. */
-export function isPmKnownExitCode(exitCode) {
-    return PM_COMMAND_EXIT_OUTCOME_CONTRACTS.some((contract) => contract.exit_code === exitCode);
-}
-/** Resolve an exact command contract, falling back to its declared root path. */
-export function resolvePmCommandExitContract(commandPath) {
-    const normalized = commandPath
-        .trim()
-        .toLowerCase()
-        .split(/\s+/u)
-        .filter(Boolean)
-        .join(" ");
-    return (COMMAND_EXIT_CONTRACT_BY_PATH.get(normalized) ??
-        COMMAND_EXIT_CONTRACT_BY_PATH.get(normalized.split(" ")[0]));
-}
-/** Verify command coverage, observed exits, and vocabulary reachability for a replay corpus. */
-export function analyzePmCommandExitConformance(observations, expectedCommands = PM_CORE_COMMAND_NAMES, contracts = PM_COMMAND_EXIT_CONTRACTS) {
-    const contractsByCommand = new Map(contracts.map((contract) => [contract.command, contract]));
-    const missingCommands = expectedCommands.filter((command) => !contractsByCommand.has(command));
-    const undeclaredObservations = observations.filter((observation) => {
-        const contract = contractsByCommand.get(observation.command) ??
-            contractsByCommand.get(observation.command.split(" ")[0]);
-        return (contract === undefined ||
-            !contract.exit_codes.includes(observation.exit_code));
-    });
-    const observedExitCodes = new Set(observations.map((entry) => entry.exit_code));
-    const declaredExitCodes = new Set(contracts.flatMap((contract) => contract.exit_codes));
-    const unreachableExitCodes = [...declaredExitCodes]
-        .filter((exitCode) => !observedExitCodes.has(exitCode))
-        .sort((left, right) => left - right);
-    return {
-        ok: missingCommands.length === 0 &&
-            undeclaredObservations.length === 0 &&
-            unreachableExitCodes.length === 0,
-        missing_commands: missingCommands,
-        undeclared_observations: undeclaredObservations,
-        unreachable_exit_codes: unreachableExitCodes,
-    };
-}
-/** Derive deterministic full, empty, partial, or failed semantics for a bulk mutation. */
-export function derivePmBulkMutationEffect(counts) {
-    if (counts.applied === 0 && counts.failed > 0) {
-        return {
-            outcome: "dependency_failed",
-            exit_code: EXIT_CODE.DEPENDENCY_FAILED,
-        };
-    }
-    if (counts.applied === 0) {
-        return { outcome: "no_effect", exit_code: EXIT_CODE.NO_EFFECT };
-    }
-    if (counts.skipped > 0 || counts.failed > 0 || counts.unmatched > 0) {
-        return {
-            outcome: "partial_effect",
-            exit_code: EXIT_CODE.PARTIAL_EFFECT,
-        };
-    }
-    return { outcome: "effect", exit_code: EXIT_CODE.SUCCESS };
-}
+!(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]="86ee3f5f-ce07-59dc-a2ee-f4e0373a0345")}catch(e2){}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PM_CORE_COMMAND_NAMES}from"./enum-contracts.js";const PM_COMMAND_EXIT_OUTCOME_CONTRACTS=[{exit_code:EXIT_CODE.SUCCESS,outcome:"effect",success:true,meaning:"The requested operation completed with its intended effect."},{exit_code:EXIT_CODE.GENERIC_FAILURE,outcome:"internal_failure",success:false,meaning:"An unexpected runtime or internal failure prevented completion."},{exit_code:EXIT_CODE.USAGE,outcome:"refused_input",success:false,meaning:"The invocation was refused because its input or composition was invalid."},{exit_code:EXIT_CODE.NOT_FOUND,outcome:"refused_tracker_state",success:false,meaning:"The requested tracker, item, or resource was not present."},{exit_code:EXIT_CODE.CONFLICT,outcome:"conflict",success:false,meaning:"Current state or concurrency prevented the requested effect."},{exit_code:EXIT_CODE.DEPENDENCY_FAILED,outcome:"dependency_failed",success:false,meaning:"A required dependency operation failed."},{exit_code:EXIT_CODE.NO_EFFECT,outcome:"no_effect",success:true,meaning:"The request was valid and completed, but matched nothing to change."},{exit_code:EXIT_CODE.PARTIAL_EFFECT,outcome:"partial_effect",success:true,meaning:"The request completed and changed some, but not all, selected targets."}];const STANDARD_COMMAND_EXIT_CODES=[EXIT_CODE.SUCCESS,EXIT_CODE.GENERIC_FAILURE,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT,EXIT_CODE.DEPENDENCY_FAILED];const EFFECT_AWARE_BULK_COMMANDS=new Set(["close-many","update-many"]);const PM_COMMAND_EXIT_CONTRACTS=PM_CORE_COMMAND_NAMES.map(command=>({command,exit_codes:EFFECT_AWARE_BULK_COMMANDS.has(command)?[...STANDARD_COMMAND_EXIT_CODES,EXIT_CODE.NO_EFFECT,EXIT_CODE.PARTIAL_EFFECT]:[...STANDARD_COMMAND_EXIT_CODES]}));const COMMAND_EXIT_CONTRACT_BY_PATH=new Map(PM_COMMAND_EXIT_CONTRACTS.map(contract=>[contract.command,contract]));const PM_SUCCESS_EXIT_CODES=[EXIT_CODE.SUCCESS,EXIT_CODE.NO_EFFECT,EXIT_CODE.PARTIAL_EFFECT];function isPmSuccessfulExitCode(exitCode){return PM_SUCCESS_EXIT_CODES.includes(exitCode)}function isPmKnownExitCode(exitCode){return PM_COMMAND_EXIT_OUTCOME_CONTRACTS.some(contract=>contract.exit_code===exitCode)}function resolvePmCommandExitContract(commandPath){const normalized=commandPath.trim().toLowerCase().split(/\s+/u).filter(Boolean).join(" ");return COMMAND_EXIT_CONTRACT_BY_PATH.get(normalized)??COMMAND_EXIT_CONTRACT_BY_PATH.get(normalized.split(" ")[0])}function analyzePmCommandExitConformance(observations,expectedCommands=PM_CORE_COMMAND_NAMES,contracts=PM_COMMAND_EXIT_CONTRACTS){const contractsByCommand=new Map(contracts.map(contract=>[contract.command,contract]));const missingCommands=expectedCommands.filter(command=>!contractsByCommand.has(command));const undeclaredObservations=observations.filter(observation=>{const contract=contractsByCommand.get(observation.command)??contractsByCommand.get(observation.command.split(" ")[0]);return contract===void 0||!contract.exit_codes.includes(observation.exit_code)});const observedExitCodes=new Set(observations.map(entry=>entry.exit_code));const declaredExitCodes=new Set(contracts.flatMap(contract=>contract.exit_codes));const unreachableExitCodes=[...declaredExitCodes].filter(exitCode=>!observedExitCodes.has(exitCode)).sort((left,right)=>left-right);return{ok:missingCommands.length===0&&undeclaredObservations.length===0&&unreachableExitCodes.length===0,missing_commands:missingCommands,undeclared_observations:undeclaredObservations,unreachable_exit_codes:unreachableExitCodes}}function derivePmBulkMutationEffect(counts){if(counts.applied===0&&counts.failed>0){return{outcome:"dependency_failed",exit_code:EXIT_CODE.DEPENDENCY_FAILED}}if(counts.applied===0){return{outcome:"no_effect",exit_code:EXIT_CODE.NO_EFFECT}}if(counts.skipped>0||counts.failed>0||counts.unmatched>0){return{outcome:"partial_effect",exit_code:EXIT_CODE.PARTIAL_EFFECT}}return{outcome:"effect",exit_code:EXIT_CODE.SUCCESS}}export{PM_COMMAND_EXIT_CONTRACTS,PM_COMMAND_EXIT_OUTCOME_CONTRACTS,PM_SUCCESS_EXIT_CODES,analyzePmCommandExitConformance,derivePmBulkMutationEffect,isPmKnownExitCode,isPmSuccessfulExitCode,resolvePmCommandExitContract};
 //# sourceMappingURL=command-exit-contracts.js.map
-//# debugId=5bbc21f0-f517-571a-8ecf-45f20f0e793d