@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/cli-contracts/commander-types.js

@@ -1,160 +1,2 @@
-/** Public contract for list commander string option contracts, shared by SDK and presentation-layer consumers. */
-
-!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]="5f56c4ef-58e1-5cf6-a10e-dfa29b9ad3e8")}catch(e){}}();
-export const LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "status", keys: ["status"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag", "tags"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "deadlineBefore", keys: ["deadlineBefore"] },
-    { target: "deadlineAfter", keys: ["deadlineAfter"] },
-    { target: "updatedAfter", keys: ["updatedAfter"] },
-    { target: "updatedBefore", keys: ["updatedBefore"] },
-    { target: "createdAfter", keys: ["createdAfter"] },
-    { target: "createdBefore", keys: ["createdBefore"] },
-    { target: "ids", keys: ["ids"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "offset", keys: ["offset"] },
-    { target: "after", keys: ["after"] },
-    { target: "fields", keys: ["fields"] },
-    { target: "sort", keys: ["sort"] },
-    { target: "order", keys: ["order"] },
-    { target: "treeDepth", keys: ["treeDepth", "tree_depth"] },
-];
-/** Public contract for search commander string option contracts, shared by SDK and presentation-layer consumers. */
-export const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "mode", keys: ["mode"] },
-    { target: "matchMode", keys: ["matchMode", "match_mode"] },
-    { target: "minScore", keys: ["minScore", "min_score"] },
-    { target: "semanticWeight", keys: ["semanticWeight", "semantic_weight"] },
-    { target: "status", keys: ["status"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag", "tags"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "deadlineBefore", keys: ["deadlineBefore"] },
-    { target: "deadlineAfter", keys: ["deadlineAfter"] },
-    { target: "updatedAfter", keys: ["updatedAfter"] },
-    { target: "updatedBefore", keys: ["updatedBefore"] },
-    { target: "createdAfter", keys: ["createdAfter"] },
-    { target: "createdBefore", keys: ["createdBefore"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "fields", keys: ["fields"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "after", keys: ["after"] },
-];
-/** Public contract for calendar commander string option contracts, shared by SDK and presentation-layer consumers. */
-export const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "view", keys: ["view"] },
-    { target: "date", keys: ["date"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "status", keys: ["status"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "include", keys: ["include"] },
-    {
-        target: "recurrenceLookaheadDays",
-        keys: ["recurrenceLookaheadDays", "recurrence_lookahead_days"],
-    },
-    {
-        target: "recurrenceLookbackDays",
-        keys: ["recurrenceLookbackDays", "recurrence_lookback_days"],
-    },
-    {
-        target: "occurrenceLimit",
-        keys: ["occurrenceLimit", "occurrence_limit"],
-    },
-    { target: "format", keys: ["format"] },
-];
-/** Public contract for context commander string option contracts, shared by SDK and presentation-layer consumers. */
-export const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "date", keys: ["date"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "limit", keys: ["limit", "maxItems", "max_items"] },
-    { target: "after", keys: ["after"] },
-    { target: "format", keys: ["format"] },
-    { target: "depth", keys: ["depth"] },
-    { target: "fields", keys: ["fields"] },
-    { target: "activityLimit", keys: ["activityLimit", "activity_limit"] },
-    { target: "staleThreshold", keys: ["staleThreshold", "stale_threshold"] },
-    { target: "tokenBudget", keys: ["tokenBudget", "token_budget"] },
-];
-/** Public contract for next commander string option contracts, shared by SDK and presentation-layer consumers. */
-export const NEXT_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "blockedLimit", keys: ["blockedLimit", "blocked_limit"] },
-    { target: "format", keys: ["format"] },
-    { target: "tokenBudget", keys: ["tokenBudget", "token_budget"] },
-];
-/** Public contract for activity commander string option contracts, shared by SDK and presentation-layer consumers. */
-export const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "id", keys: ["id"] },
-    { target: "op", keys: ["op"] },
-    { target: "author", keys: ["author"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "limit", keys: ["limit"] },
-];
-/** Implements read first string from commander options for the public runtime surface of this module. */
-export function readFirstStringFromCommanderOptions(options, contract) {
-    for (const key of contract.keys) {
-        const candidate = options[key];
-        if (typeof candidate === "string") {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-/** Implements read first value from commander options for the public runtime surface of this module. */
-export function readFirstValueFromCommanderOptions(options, contract) {
-    for (const key of contract.keys) {
-        if (Object.hasOwn(options, key)) {
-            return options[key];
-        }
-    }
-    return undefined;
-}
-/** Implements read string array from commander options for the public runtime surface of this module. */
-export function readStringArrayFromCommanderOptions(options, contract) {
-    const values = [];
-    for (const key of contract.keys) {
-        const candidate = options[key];
-        if (Array.isArray(candidate)) {
-            values.push(...candidate.filter((value) => typeof value === "string"));
-        }
-    }
-    return values.length > 0 ? values : undefined;
-}
+!(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]="4426de97-62fc-594c-8ebf-39975ed5ed50")}catch(e2){}})();const LIST_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"status",keys:["status"]},{target:"type",keys:["type"]},{target:"tag",keys:["tag","tags"]},{target:"priority",keys:["priority"]},{target:"deadlineBefore",keys:["deadlineBefore"]},{target:"deadlineAfter",keys:["deadlineAfter"]},{target:"updatedAfter",keys:["updatedAfter"]},{target:"updatedBefore",keys:["updatedBefore"]},{target:"createdAfter",keys:["createdAfter"]},{target:"createdBefore",keys:["createdBefore"]},{target:"ids",keys:["ids"]},{target:"assignee",keys:["assignee"]},{target:"assigneeFilter",keys:["assigneeFilter","assignee_filter"]},{target:"parent",keys:["parent"]},{target:"sprint",keys:["sprint"]},{target:"release",keys:["release"]},{target:"limit",keys:["limit"]},{target:"offset",keys:["offset"]},{target:"after",keys:["after"]},{target:"fields",keys:["fields"]},{target:"sort",keys:["sort"]},{target:"order",keys:["order"]},{target:"treeDepth",keys:["treeDepth","tree_depth"]}];const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"mode",keys:["mode"]},{target:"matchMode",keys:["matchMode","match_mode"]},{target:"minScore",keys:["minScore","min_score"]},{target:"semanticWeight",keys:["semanticWeight","semantic_weight"]},{target:"status",keys:["status"]},{target:"type",keys:["type"]},{target:"tag",keys:["tag","tags"]},{target:"priority",keys:["priority"]},{target:"deadlineBefore",keys:["deadlineBefore"]},{target:"deadlineAfter",keys:["deadlineAfter"]},{target:"updatedAfter",keys:["updatedAfter"]},{target:"updatedBefore",keys:["updatedBefore"]},{target:"createdAfter",keys:["createdAfter"]},{target:"createdBefore",keys:["createdBefore"]},{target:"assignee",keys:["assignee"]},{target:"sprint",keys:["sprint"]},{target:"release",keys:["release"]},{target:"parent",keys:["parent"]},{target:"fields",keys:["fields"]},{target:"limit",keys:["limit"]},{target:"after",keys:["after"]}];const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"view",keys:["view"]},{target:"date",keys:["date"]},{target:"from",keys:["from"]},{target:"to",keys:["to"]},{target:"limit",keys:["limit"]},{target:"type",keys:["type"]},{target:"tag",keys:["tag"]},{target:"priority",keys:["priority"]},{target:"status",keys:["status"]},{target:"assignee",keys:["assignee"]},{target:"assigneeFilter",keys:["assigneeFilter","assignee_filter"]},{target:"sprint",keys:["sprint"]},{target:"release",keys:["release"]},{target:"include",keys:["include"]},{target:"recurrenceLookaheadDays",keys:["recurrenceLookaheadDays","recurrence_lookahead_days"]},{target:"recurrenceLookbackDays",keys:["recurrenceLookbackDays","recurrence_lookback_days"]},{target:"occurrenceLimit",keys:["occurrenceLimit","occurrence_limit"]},{target:"format",keys:["format"]}];const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"date",keys:["date"]},{target:"from",keys:["from"]},{target:"to",keys:["to"]},{target:"type",keys:["type"]},{target:"tag",keys:["tag"]},{target:"priority",keys:["priority"]},{target:"assignee",keys:["assignee"]},{target:"assigneeFilter",keys:["assigneeFilter","assignee_filter"]},{target:"sprint",keys:["sprint"]},{target:"release",keys:["release"]},{target:"parent",keys:["parent"]},{target:"limit",keys:["limit","maxItems","max_items"]},{target:"after",keys:["after"]},{target:"format",keys:["format"]},{target:"depth",keys:["depth"]},{target:"fields",keys:["fields"]},{target:"activityLimit",keys:["activityLimit","activity_limit"]},{target:"staleThreshold",keys:["staleThreshold","stale_threshold"]},{target:"tokenBudget",keys:["tokenBudget","token_budget"]}];const NEXT_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"type",keys:["type"]},{target:"tag",keys:["tag"]},{target:"priority",keys:["priority"]},{target:"assignee",keys:["assignee"]},{target:"assigneeFilter",keys:["assigneeFilter","assignee_filter"]},{target:"sprint",keys:["sprint"]},{target:"release",keys:["release"]},{target:"parent",keys:["parent"]},{target:"limit",keys:["limit"]},{target:"blockedLimit",keys:["blockedLimit","blocked_limit"]},{target:"format",keys:["format"]},{target:"tokenBudget",keys:["tokenBudget","token_budget"]}];const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS=[{target:"id",keys:["id"]},{target:"op",keys:["op"]},{target:"author",keys:["author"]},{target:"from",keys:["from"]},{target:"to",keys:["to"]},{target:"limit",keys:["limit"]}];function readFirstStringFromCommanderOptions(options,contract){for(const key of contract.keys){const candidate=options[key];if(typeof candidate==="string"){return candidate}}return void 0}function readFirstValueFromCommanderOptions(options,contract){for(const key of contract.keys){if(Object.hasOwn(options,key)){return options[key]}}return void 0}function readStringArrayFromCommanderOptions(options,contract){const values=[];for(const key of contract.keys){const candidate=options[key];if(Array.isArray(candidate)){values.push(...candidate.filter(value=>typeof value==="string"))}}return values.length>0?values:void 0}export{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,readFirstStringFromCommanderOptions,readFirstValueFromCommanderOptions,readStringArrayFromCommanderOptions};
 //# sourceMappingURL=commander-types.js.map
-//# debugId=5f56c4ef-58e1-5cf6-a10e-dfa29b9ad3e8

package/dist/sdk/cli-contracts/completeness.js

@@ -1,394 +1,2 @@
-/**
- * @module sdk/cli-contracts/completeness
- *
- * Derives a bidirectional parameter-coverage matrix between the public CLI
- * flag contracts and strict SDK action schemas. Every non-shared input carries
- * a bounded, machine-readable disposition so compatibility gaps cannot hide in
- * a hand-picked test list.
- */
-
-!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]="199e3ef5-93a0-5d93-8f77-d9d12bbc69d4")}catch(e){}}();
-import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
-import { resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
-import { pmToolActionParameterKeys } from "./tool-schema.js";
-import { PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_OPTION_FLAGS, resolveReadOutputSurface, } from "../read-output-contracts.js";
-const CLI_TRANSPORT_FLAGS = new Set([
-    "--author",
-    "--follow",
-    "--help",
-    "--lean",
-    "--token-accounting",
-    "--output-include",
-    "--output-limit",
-    "--output-budget",
-    "--output-format",
-    "--output-session",
-    "--output-cursor",
-    "--output-row-contract",
-    "--no-changed-fields",
-    "--no-extensions",
-    "--no-pager",
-    "--pm-path",
-    "--profile",
-    "--quiet",
-    "--interval-ms",
-]);
-const READ_OUTPUT_OPTION_FLAGS = new Set([
-    ...PM_READ_OUTPUT_OPTION_FLAGS,
-    ...PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,
-]);
-const CLI_PRESENTATION_FLAGS = new Set([
-    "--brief",
-    "--format",
-    "--full",
-    "--full-changed-fields",
-    "--id-only",
-    "--no-truncate",
-    "--stream",
-]);
-const CLI_ADAPTER_FLAGS = new Set(["--body-file", "--file", "--stdin-json"]);
-const CLI_SCOPE_SELECTOR_FLAGS = new Set(["--global", "--local", "--project"]);
-const CLI_CONFIG_SHORTHAND_FLAGS = new Set([
-    "--activity-limit",
-    "--default-depth",
-    "--section-activity",
-    "--section-blockers",
-    "--section-files",
-    "--section-hierarchy",
-    "--section-progress",
-    "--section-staleness",
-    "--section-tests",
-    "--section-workload",
-    "--stale-threshold-days",
-]);
-const SDK_TRANSPORT_PARAMETERS = new Set([
-    "action",
-    "fullChangedFields",
-    "idOnly",
-    "path",
-    "pmExecutable",
-    "timeoutMs",
-]);
-const CLI_POSITIONAL_PARAMETERS = new Set([
-    "configAction",
-    "id",
-    "name",
-    "query",
-    "reason",
-    "subcommand",
-    "target",
-    "text",
-]);
-const ACTION_POSITIONAL_PARAMETERS = {
-    assurance: {
-        id: "<id>",
-        kind: "<kind>",
-        preset: "[kind]|[id]",
-        subcommand: "<action>",
-    },
-    event: { title: "<title>" },
-    files: { lookupPath: "lookup <path...>" },
-    meet: { title: "<title>" },
-    "item-reopen": { id: "<id>", reason: "<reason>" },
-    merge: { subcommand: "<subcommand>" },
-    remind: { title: "<title>" },
-    workspace: {
-        name: "<name>",
-        subcommand: "snapshot",
-        snapshotAction: "<snapshot-action>",
-        target: "<target>",
-    },
-};
-const ACTION_FLAG_PARAMETER_OVERRIDES = {
-    append: { "--text": "body" },
-    assurance: {
-        "--tree": "treeId",
-        "--owner": "owner",
-        "--apply": "apply",
-        "--enforcement": "enforcement",
-    },
-    init: {
-        "--id-prefix": "idPrefix",
-        "--no-merge-fence": "mergeFence",
-        "--workspace": "workspace",
-    },
-    create: {
-        "--ac": "acceptanceCriteria",
-        "--estimated-minutes": "estimate",
-        "--file": "linkedFile",
-        "--test": "linkedTest",
-        "--expected": "expectedResult",
-        "--actual": "actualResult",
-    },
-    update: {
-        "--ac": "acceptanceCriteria",
-        "--estimated-minutes": "estimate",
-        "--file": "linkedFile",
-        "--test": "linkedTest",
-        "--expected": "expectedResult",
-        "--actual": "actualResult",
-    },
-    "update-many": {
-        "--ac": "acceptanceCriteria",
-        "--estimated-minutes": "estimate",
-        "--file": "linkedFile",
-        "--test": "linkedTest",
-        "--expected": "expectedResult",
-        "--actual": "actualResult",
-    },
-    files: { "--note": "addNote" },
-    docs: { "--note": "addNote" },
-    comments: { "--full-history": "full" },
-    notes: { "--file": "text", "--full-history": "full" },
-    learnings: { "--file": "text", "--full-history": "full" },
-    gc: { "--scope": "gcScope" },
-    contracts: { "--action": "contractAction" },
-    schema: {
-        "--no-allow-unset": "allowUnset",
-        "--type": "fieldTypeScope",
-    },
-    "history-author-acknowledge": {
-        "--event": "historyEvent",
-        "--all-actionable": "allActionable",
-    },
-    "extension-init": { "--capability": "capability" },
-    "package-init": { "--capability": "capability" },
-    "extension-install": { "--gh": "github" },
-    "package-install": { "--gh": "github" },
-    "extension-adopt": { "--gh": "github" },
-    "package-adopt": { "--gh": "github" },
-    extension: { "--gh": "github", "--scaffold": "init" },
-    package: { "--gh": "github", "--scaffold": "init" },
-    install: { "--gh": "github" },
-};
-const GLOBAL_FLAG_PARAMETER_OVERRIDES = {
-    "--pm-path": "path",
-};
-const ACTION_STRUCTURED_FLAG_PARAMETERS = {
-    stats: {
-        "--analytics": [
-            "measurements",
-            "metric",
-            "measurementLimit",
-            "observe",
-            "improvementDirection",
-            "measurementSource",
-            "measurementItem",
-            "measurementRevision",
-            "author",
-            "message",
-            "provenanceCoverage",
-            "fleetAttribution",
-            "since",
-            "eventLimit",
-            "minimumSample",
-        ],
-    },
-};
-function actionCommand(action) {
-    if (action.startsWith("extension-")) {
-        return `extension ${action.slice("extension-".length)}`;
-    }
-    if (action.startsWith("package-")) {
-        return `package ${action.slice("package-".length)}`;
-    }
-    if (action.startsWith("item-")) {
-        return `item ${action.slice("item-".length)}`;
-    }
-    return action;
-}
-function parameterForFlag(action, flag) {
-    const override = ACTION_FLAG_PARAMETER_OVERRIDES[action]?.[flag] ??
-        GLOBAL_FLAG_PARAMETER_OVERRIDES[flag];
-    if (override !== undefined)
-        return override;
-    return flag
-        .replace(/^--/, "")
-        .replaceAll("_", "-")
-        .replace(/-([a-z])/g, (_match, value) => value.toUpperCase());
-}
-function canonicalLongFlags(contracts) {
-    const seen = new Set();
-    return contracts.filter(({ flag }) => {
-        if (!flag.startsWith("--") || seen.has(flag))
-            return false;
-        seen.add(flag);
-        return true;
-    });
-}
-function aliasTarget(flag, contracts) {
-    return contracts.find(({ aliases }) => aliases?.includes(flag))?.flag;
-}
-function classifyCliInput(action, contract, contracts, sdkParameters) {
-    const structuredParameters = ACTION_STRUCTURED_FLAG_PARAMETERS[action]?.[contract.flag];
-    if (structuredParameters !== undefined &&
-        structuredParameters.every((parameter) => sdkParameters.has(parameter))) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            counterpart: structuredParameters[0],
-            disposition: "shared",
-            reason: "The validated CLI JSON object fans out across strict SDK parameters.",
-        };
-    }
-    const parameter = parameterForFlag(action, contract.flag);
-    if (sdkParameters.has(parameter)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            counterpart: parameter,
-            disposition: "shared",
-            reason: "The CLI flag maps directly to a strict SDK action parameter.",
-        };
-    }
-    const canonicalAlias = aliasTarget(contract.flag, contracts);
-    if (canonicalAlias !== undefined) {
-        const aliasParameter = parameterForFlag(action, canonicalAlias);
-        if (sdkParameters.has(aliasParameter)) {
-            return {
-                surface: "cli",
-                input: contract.flag,
-                counterpart: aliasParameter,
-                disposition: "compatibility_alias",
-                reason: `Compatibility spelling for ${canonicalAlias}.`,
-            };
-        }
-    }
-    if (CLI_TRANSPORT_FLAGS.has(contract.flag)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            disposition: "cli_transport",
-            reason: "CLI process transport is supplied by the in-process SDK host.",
-        };
-    }
-    if (CLI_PRESENTATION_FLAGS.has(contract.flag)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            disposition: "cli_presentation",
-            reason: "CLI rendering or mutation projection does not alter the SDK result envelope.",
-        };
-    }
-    if (CLI_ADAPTER_FLAGS.has(contract.flag)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            disposition: "cli_adapter",
-            reason: "Local file or stdin adaptation is a CLI boundary concern.",
-        };
-    }
-    if (CLI_CONFIG_SHORTHAND_FLAGS.has(contract.flag)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            counterpart: "key",
-            disposition: "compatibility_alias",
-            reason: "CLI config shorthand normalizes to the SDK configAction/key/value contract.",
-        };
-    }
-    if (CLI_SCOPE_SELECTOR_FLAGS.has(contract.flag)) {
-        return {
-            surface: "cli",
-            input: contract.flag,
-            counterpart: "scope",
-            disposition: "cli_scope_selector",
-            reason: "Mutually exclusive CLI scope switches normalize to the SDK scope parameter.",
-        };
-    }
-    return {
-        surface: "cli",
-        input: contract.flag,
-        counterpart: parameter,
-        disposition: "unclassified",
-        reason: "The CLI flag has no strict SDK parameter or approved boundary classification.",
-    };
-}
-function classifySdkInput(action, parameter, cliEntries) {
-    const structuredCounterpart = Object.entries(ACTION_STRUCTURED_FLAG_PARAMETERS[action] ?? {}).find(([flag, parameters]) => parameters.includes(parameter) &&
-        cliEntries.some(({ input, disposition }) => input === flag && disposition === "shared"));
-    if (structuredCounterpart !== undefined) {
-        return {
-            surface: "sdk",
-            input: parameter,
-            counterpart: structuredCounterpart[0],
-            disposition: "shared",
-            reason: "The strict SDK parameter is reachable through the validated CLI JSON object.",
-        };
-    }
-    const cliCounterpart = cliEntries.find(({ counterpart, disposition }) => counterpart === parameter &&
-        (disposition === "shared" ||
-            disposition === "compatibility_alias" ||
-            disposition === "cli_scope_selector"));
-    if (cliCounterpart !== undefined) {
-        return {
-            surface: "sdk",
-            input: parameter,
-            counterpart: cliCounterpart.input,
-            disposition: "shared",
-            reason: "The strict SDK parameter is reachable from the CLI contract.",
-        };
-    }
-    const positionalCounterpart = ACTION_POSITIONAL_PARAMETERS[action]?.[parameter];
-    if (positionalCounterpart !== undefined) {
-        return {
-            surface: "sdk",
-            input: parameter,
-            counterpart: positionalCounterpart,
-            disposition: "shared",
-            reason: "The strict SDK parameter maps to a canonical CLI positional argument.",
-        };
-    }
-    if (SDK_TRANSPORT_PARAMETERS.has(parameter)) {
-        return {
-            surface: "sdk",
-            input: parameter,
-            disposition: "sdk_transport",
-            reason: "The SDK host supplies in-process transport and workspace selection.",
-        };
-    }
-    if (CLI_POSITIONAL_PARAMETERS.has(parameter)) {
-        return {
-            surface: "sdk",
-            input: parameter,
-            disposition: "cli_positional",
-            reason: "The CLI accepts this SDK parameter as a positional command argument.",
-        };
-    }
-    return {
-        surface: "sdk",
-        input: parameter,
-        disposition: "sdk_native",
-        reason: "The typed SDK exposes this structured input without a canonical CLI long flag.",
-    };
-}
-/**
- * Analyze every public action from live CLI and strict schema contracts.
- *
- * Unknown CLI flags fail closed as `unclassified`; SDK-only inputs remain
- * visible as per-parameter `sdk_native` dispositions for shrinking baselines.
- */
-export function analyzeSdkCliParameterCompleteness(source = {}) {
-    const actions = source.actions ?? PM_TOOL_ACTIONS;
-    const resolveFlags = source.resolveFlags ?? resolveSubcommandFlagContractsForCommand;
-    const resolveParameters = source.resolveParameters ?? pmToolActionParameterKeys;
-    return actions.map((action) => {
-        const command = actionCommand(action);
-        const flagContracts = canonicalLongFlags(resolveFlags(command)).filter(({ flag }) => resolveReadOutputSurface(action) !== undefined ||
-            !READ_OUTPUT_OPTION_FLAGS.has(flag));
-        const sdkParameters = new Set(resolveParameters(action) ?? []);
-        const cli = flagContracts.map((contract) => classifyCliInput(action, contract, flagContracts, sdkParameters));
-        const sdk = [...sdkParameters]
-            .sort((left, right) => left.localeCompare(right))
-            .map((parameter) => classifySdkInput(action, parameter, cli));
-        return {
-            action,
-            command,
-            cli,
-            sdk,
-            unclassified: [...cli, ...sdk].filter(({ disposition }) => disposition === "unclassified"),
-        };
-    });
-}
+!(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]="48efaa37-f28e-5f2a-a033-456bee15e294")}catch(e2){}})();import{PM_TOOL_ACTIONS}from"./enum-contracts.js";import{resolveSubcommandFlagContractsForCommand}from"./flag-contracts.js";import{pmToolActionParameterKeys}from"./tool-schema.js";import{PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_OPTION_FLAGS,resolveReadOutputSurface}from"../read-output-contracts.js";const CLI_TRANSPORT_FLAGS=new Set(["--author","--follow","--help","--lean","--token-accounting","--output-include","--output-limit","--output-budget","--output-format","--output-session","--output-cursor","--output-row-contract","--no-changed-fields","--no-extensions","--no-pager","--pm-path","--profile","--quiet","--interval-ms"]);const READ_OUTPUT_OPTION_FLAGS=new Set([...PM_READ_OUTPUT_OPTION_FLAGS,...PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS]);const CLI_PRESENTATION_FLAGS=new Set(["--brief","--format","--full","--full-changed-fields","--id-only","--no-truncate","--stream"]);const CLI_ADAPTER_FLAGS=new Set(["--body-file","--file","--stdin-json"]);const CLI_SCOPE_SELECTOR_FLAGS=new Set(["--global","--local","--project"]);const CLI_CONFIG_SHORTHAND_FLAGS=new Set(["--activity-limit","--default-depth","--section-activity","--section-blockers","--section-files","--section-hierarchy","--section-progress","--section-staleness","--section-tests","--section-workload","--stale-threshold-days"]);const SDK_TRANSPORT_PARAMETERS=new Set(["action","fullChangedFields","idOnly","path","pmExecutable","timeoutMs"]);const CLI_POSITIONAL_PARAMETERS=new Set(["configAction","id","name","query","reason","subcommand","target","text"]);const ACTION_POSITIONAL_PARAMETERS={assurance:{id:"<id>",kind:"<kind>",preset:"[kind]|[id]",subcommand:"<action>"},event:{title:"<title>"},files:{lookupPath:"lookup <path...>"},meet:{title:"<title>"},"item-reopen":{id:"<id>",reason:"<reason>"},merge:{subcommand:"<subcommand>"},remind:{title:"<title>"},workspace:{name:"<name>",subcommand:"snapshot",snapshotAction:"<snapshot-action>",target:"<target>"}};const ACTION_FLAG_PARAMETER_OVERRIDES={append:{"--text":"body"},assurance:{"--tree":"treeId","--owner":"owner","--apply":"apply","--enforcement":"enforcement"},init:{"--id-prefix":"idPrefix","--no-merge-fence":"mergeFence","--workspace":"workspace"},create:{"--ac":"acceptanceCriteria","--estimated-minutes":"estimate","--file":"linkedFile","--test":"linkedTest","--expected":"expectedResult","--actual":"actualResult"},update:{"--ac":"acceptanceCriteria","--estimated-minutes":"estimate","--file":"linkedFile","--test":"linkedTest","--expected":"expectedResult","--actual":"actualResult"},"update-many":{"--ac":"acceptanceCriteria","--estimated-minutes":"estimate","--file":"linkedFile","--test":"linkedTest","--expected":"expectedResult","--actual":"actualResult"},files:{"--note":"addNote"},docs:{"--note":"addNote"},comments:{"--full-history":"full"},notes:{"--file":"text","--full-history":"full"},learnings:{"--file":"text","--full-history":"full"},gc:{"--scope":"gcScope"},contracts:{"--action":"contractAction"},schema:{"--no-allow-unset":"allowUnset","--type":"fieldTypeScope"},"history-author-acknowledge":{"--event":"historyEvent","--all-actionable":"allActionable"},"extension-init":{"--capability":"capability"},"package-init":{"--capability":"capability"},"extension-install":{"--gh":"github"},"package-install":{"--gh":"github"},"extension-adopt":{"--gh":"github"},"package-adopt":{"--gh":"github"},extension:{"--gh":"github","--scaffold":"init"},package:{"--gh":"github","--scaffold":"init"},install:{"--gh":"github"}};const GLOBAL_FLAG_PARAMETER_OVERRIDES={"--pm-path":"path"};const ACTION_STRUCTURED_FLAG_PARAMETERS={stats:{"--analytics":["measurements","metric","measurementLimit","observe","improvementDirection","measurementSource","measurementItem","measurementRevision","author","message","provenanceCoverage","fleetAttribution","since","eventLimit","minimumSample"]}};function actionCommand(action){if(action.startsWith("extension-")){return`extension ${action.slice("extension-".length)}`}if(action.startsWith("package-")){return`package ${action.slice("package-".length)}`}if(action.startsWith("item-")){return`item ${action.slice("item-".length)}`}return action}function parameterForFlag(action,flag){const override=ACTION_FLAG_PARAMETER_OVERRIDES[action]?.[flag]??GLOBAL_FLAG_PARAMETER_OVERRIDES[flag];if(override!==void 0)return override;return flag.replace(/^--/,"").replaceAll("_","-").replace(/-([a-z])/g,(_match,value)=>value.toUpperCase())}function canonicalLongFlags(contracts){const seen=new Set;return contracts.filter(({flag})=>{if(!flag.startsWith("--")||seen.has(flag))return false;seen.add(flag);return true})}function aliasTarget(flag,contracts){return contracts.find(({aliases})=>aliases?.includes(flag))?.flag}function classifyCliInput(action,contract,contracts,sdkParameters){const structuredParameters=ACTION_STRUCTURED_FLAG_PARAMETERS[action]?.[contract.flag];if(structuredParameters!==void 0&&structuredParameters.every(parameter2=>sdkParameters.has(parameter2))){return{surface:"cli",input:contract.flag,counterpart:structuredParameters[0],disposition:"shared",reason:"The validated CLI JSON object fans out across strict SDK parameters."}}const parameter=parameterForFlag(action,contract.flag);if(sdkParameters.has(parameter)){return{surface:"cli",input:contract.flag,counterpart:parameter,disposition:"shared",reason:"The CLI flag maps directly to a strict SDK action parameter."}}const canonicalAlias=aliasTarget(contract.flag,contracts);if(canonicalAlias!==void 0){const aliasParameter=parameterForFlag(action,canonicalAlias);if(sdkParameters.has(aliasParameter)){return{surface:"cli",input:contract.flag,counterpart:aliasParameter,disposition:"compatibility_alias",reason:`Compatibility spelling for ${canonicalAlias}.`}}}if(CLI_TRANSPORT_FLAGS.has(contract.flag)){return{surface:"cli",input:contract.flag,disposition:"cli_transport",reason:"CLI process transport is supplied by the in-process SDK host."}}if(CLI_PRESENTATION_FLAGS.has(contract.flag)){return{surface:"cli",input:contract.flag,disposition:"cli_presentation",reason:"CLI rendering or mutation projection does not alter the SDK result envelope."}}if(CLI_ADAPTER_FLAGS.has(contract.flag)){return{surface:"cli",input:contract.flag,disposition:"cli_adapter",reason:"Local file or stdin adaptation is a CLI boundary concern."}}if(CLI_CONFIG_SHORTHAND_FLAGS.has(contract.flag)){return{surface:"cli",input:contract.flag,counterpart:"key",disposition:"compatibility_alias",reason:"CLI config shorthand normalizes to the SDK configAction/key/value contract."}}if(CLI_SCOPE_SELECTOR_FLAGS.has(contract.flag)){return{surface:"cli",input:contract.flag,counterpart:"scope",disposition:"cli_scope_selector",reason:"Mutually exclusive CLI scope switches normalize to the SDK scope parameter."}}return{surface:"cli",input:contract.flag,counterpart:parameter,disposition:"unclassified",reason:"The CLI flag has no strict SDK parameter or approved boundary classification."}}function classifySdkInput(action,parameter,cliEntries){const structuredCounterpart=Object.entries(ACTION_STRUCTURED_FLAG_PARAMETERS[action]??{}).find(([flag,parameters])=>parameters.includes(parameter)&&cliEntries.some(({input,disposition})=>input===flag&&disposition==="shared"));if(structuredCounterpart!==void 0){return{surface:"sdk",input:parameter,counterpart:structuredCounterpart[0],disposition:"shared",reason:"The strict SDK parameter is reachable through the validated CLI JSON object."}}const cliCounterpart=cliEntries.find(({counterpart,disposition})=>counterpart===parameter&&(disposition==="shared"||disposition==="compatibility_alias"||disposition==="cli_scope_selector"));if(cliCounterpart!==void 0){return{surface:"sdk",input:parameter,counterpart:cliCounterpart.input,disposition:"shared",reason:"The strict SDK parameter is reachable from the CLI contract."}}const positionalCounterpart=ACTION_POSITIONAL_PARAMETERS[action]?.[parameter];if(positionalCounterpart!==void 0){return{surface:"sdk",input:parameter,counterpart:positionalCounterpart,disposition:"shared",reason:"The strict SDK parameter maps to a canonical CLI positional argument."}}if(SDK_TRANSPORT_PARAMETERS.has(parameter)){return{surface:"sdk",input:parameter,disposition:"sdk_transport",reason:"The SDK host supplies in-process transport and workspace selection."}}if(CLI_POSITIONAL_PARAMETERS.has(parameter)){return{surface:"sdk",input:parameter,disposition:"cli_positional",reason:"The CLI accepts this SDK parameter as a positional command argument."}}return{surface:"sdk",input:parameter,disposition:"sdk_native",reason:"The typed SDK exposes this structured input without a canonical CLI long flag."}}function analyzeSdkCliParameterCompleteness(source={}){const actions=source.actions??PM_TOOL_ACTIONS;const resolveFlags=source.resolveFlags??resolveSubcommandFlagContractsForCommand;const resolveParameters=source.resolveParameters??pmToolActionParameterKeys;return actions.map(action=>{const command=actionCommand(action);const flagContracts=canonicalLongFlags(resolveFlags(command)).filter(({flag})=>resolveReadOutputSurface(action)!==void 0||!READ_OUTPUT_OPTION_FLAGS.has(flag));const sdkParameters=new Set(resolveParameters(action)??[]);const cli=flagContracts.map(contract=>classifyCliInput(action,contract,flagContracts,sdkParameters));const sdk=[...sdkParameters].sort((left,right)=>left.localeCompare(right)).map(parameter=>classifySdkInput(action,parameter,cli));return{action,command,cli,sdk,unclassified:[...cli,...sdk].filter(({disposition})=>disposition==="unclassified")}})}export{analyzeSdkCliParameterCompleteness};
 //# sourceMappingURL=completeness.js.map
-//# debugId=199e3ef5-93a0-5d93-8f77-d9d12bbc69d4