@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/flag-invocation-contracts.js

@@ -1,345 +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]="7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2")}catch(e){}}();
-const FLAG_DESCRIPTIONS = Object.freeze({
-    "--body": "Set the item body.",
-    "--body-file": "Read the item body from a file, or from stdin when set to -.",
-    "--description": "Set the item description.",
-    "--stdin": "Read the value from stdin.",
-    "--stdin-json": "Read a complete JSON document from stdin.",
-});
-const STDIN_TOKEN_FLAGS = new Set([
-    "--add",
-    "--body",
-    "--comment",
-    "--dep",
-    "--dep-remove",
-    "--description",
-    "--doc",
-    "--event",
-    "--field",
-    "--file",
-    "--learning",
-    "--note",
-    "--remove",
-    "--reminder",
-    "--test",
-    "--type-option",
-]);
-const STDIN_VALUE_COMMANDS = new Set([
-    "append",
-    "comments",
-    "create",
-    "docs",
-    "files",
-    "learnings",
-    "notes",
-    "test",
-    "update",
-    "update-many",
-]);
-const FILE_OR_STDIN_COMMAND_FLAGS = new Set([
-    "close-many:--ids",
-    "comments:--file",
-    "create:--body-file",
-    "history-compact:--ids",
-    "learnings:--file",
-    "notes:--file",
-    "update:--body-file",
-    "update-many:--ids",
-]);
-const AT_PATH_FILE_COMMAND_FLAGS = new Set([
-    "close-many:--ids",
-    "history-compact:--ids",
-    "update-many:--ids",
-]);
-const BOOLEAN_FLAG_PREFIXES = [
-    "--allow-",
-    "--check-",
-    "--dry-run",
-    "--explain",
-    "--fail-",
-    "--fix-",
-    "--full",
-    "--has-",
-    "--include-",
-    "--json",
-    "--no-",
-    "--prune-",
-    "--quiet",
-    "--refresh-",
-    "--require-",
-    "--runtime-only",
-    "--schema-only",
-    "--skip-",
-    "--stream",
-    "--strict-",
-    "--summary",
-    "--today",
-    "--verbose",
-];
-const BOOLEAN_FLAG_NAMES = new Set([
-    "--activate",
-    "--active-only",
-    "--adopt",
-    "--adopt-all",
-    "--all",
-    "--all-actionable",
-    "--all-affected-ids",
-    "--all-day",
-    "--all-streams",
-    "--acknowledge-linked-tests",
-    "--append-stable",
-    "--auto-fix",
-    "--auto-pm-context",
-    "--availability-only",
-    "--background",
-    "--brief",
-    "--by-assignee",
-    "--by-priority",
-    "--by-tag",
-    "--catalog",
-    "--claim",
-    "--clear",
-    "--clear-comments",
-    "--clear-criteria",
-    "--clear-deps",
-    "--clear-docs",
-    "--clear-events",
-    "--clear-files",
-    "--clear-learnings",
-    "--clear-notes",
-    "--clear-reminders",
-    "--clear-tests",
-    "--clear-type-options",
-    "--cli-only",
-    "--closed",
-    "--compact",
-    "--completion",
-    "--count",
-    "--counts",
-    "--deactivate",
-    "--declarative",
-    "--defaults",
-    "--describe",
-    "--diff",
-    "--doctor",
-    "--empty-body",
-    "--explore",
-    "--field-utilization",
-    "--filter-empty-body",
-    "--flags-only",
-    "--follow",
-    "--force",
-    "--global",
-    "--highlight",
-    "--hybrid",
-    "--id-only",
-    "--if-available",
-    "--ignore-global",
-    "--include_unparented",
-    "--infer",
-    "--init",
-    "--install",
-    "--isolated",
-    "--lean",
-    "--list",
-    "--local",
-    "--manage",
-    "--markdown",
-    "--metadata-coverage",
-    "--next",
-    "--normalize-provenance",
-    "--only",
-    "--only-last",
-    "--output-row-contract",
-    "--override-linked-pm-context",
-    "--override-linked-workspace-context",
-    "--packages-only",
-    "--past",
-    "--phrase-exact",
-    "--profile",
-    "--progress",
-    "--project",
-    "--promote-to-item-dep",
-    "--provenance",
-    "--provenance-summary",
-    "--raw",
-    "--ready-only",
-    "--ready_only",
-    "--rebuild",
-    "--recent",
-    "--reload",
-    "--repair",
-    "--replace-deps",
-    "--replace-docs",
-    "--replace-files",
-    "--replace-tests",
-    "--required",
-    "--required-on-create",
-    "--run",
-    "--runtime-probe",
-    "--save-baseline",
-    "--scaffold",
-    "--semantic",
-    "--shared-host-safe",
-    "--storage",
-    "--title-exact",
-    "--token-accounting",
-    "--trace",
-    "--tree",
-    "--unbounded",
-    "--uninstall",
-    "--validate-paths",
-    "--verify",
-    "--watch",
-    "--with-packages",
-]);
-const VALUE_FLAG_NAMES = new Set(["--only-index"]);
-const VALUE_COMMAND_FLAGS = new Set([
-    "activity:--stream",
-    "eval:--fail-under",
-    "validate:--fix-scope",
-]);
-const OPTIONAL_VALUE_COMMAND_FLAGS = new Set([
-    "activity:--stream",
-    "close:--validate-close",
-    "close-many:--validate-close",
-    "comments:--author",
-    "learnings:--author",
-    "notes:--author",
-]);
-const OPTIONAL_VALUE_FLAGS = new Set(["--regression"]);
-function resolveFlagInputSources(command, flag) {
-    if (flag === "--stdin" || flag === "--stdin-json")
-        return ["stdin"];
-    if (FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)) {
-        return ["argv", "file", "stdin"];
-    }
-    if (flag.endsWith("-file"))
-        return ["argv", "file"];
-    if (STDIN_TOKEN_FLAGS.has(flag) && STDIN_VALUE_COMMANDS.has(command)) {
-        return ["argv", "stdin"];
-    }
-    return ["argv"];
-}
-function flagTakesValue(command, contract) {
-    const explicitlyValued = VALUE_COMMAND_FLAGS.has(`${command}:${contract.flag}`) ||
-        contract.value_name !== undefined ||
-        contract.value_type === "string" ||
-        contract.value_type === "number" ||
-        contract.list === true ||
-        contract.repeatable === true;
-    const inferredBoolean = contract.value_type === "boolean" ||
-        contract.flag === "--stdin" ||
-        contract.flag === "--stdin-json" ||
-        (contract.flag.startsWith("--filter-") &&
-            (contract.flag.endsWith("-missing") ||
-                contract.flag.startsWith("--filter-has-") ||
-                contract.flag.startsWith("--filter-no-"))) ||
-        BOOLEAN_FLAG_PREFIXES.some((prefix) => contract.flag.startsWith(prefix));
-    return (explicitlyValued ||
-        VALUE_FLAG_NAMES.has(contract.flag) ||
-        (!BOOLEAN_FLAG_NAMES.has(contract.flag) && !inferredBoolean));
-}
-/** Enrich one vocabulary row with deterministic invocation and input-channel metadata. */
-export function enrichCliFlagInvocationContract(command, contract) {
-    const takesValue = flagTakesValue(command, contract);
-    const inputSources = resolveFlagInputSources(command, contract.flag);
-    const description = contract.description ??
-        FLAG_DESCRIPTIONS[contract.flag] ??
-        `${takesValue ? "Set" : "Enable"} ${contract.flag.slice(2).replaceAll("-", " ")}.`;
-    return {
-        ...contract,
-        description,
-        takes_value: takesValue,
-        value_required: takesValue &&
-            !OPTIONAL_VALUE_FLAGS.has(contract.flag) &&
-            !OPTIONAL_VALUE_COMMAND_FLAGS.has(`${command}:${contract.flag}`),
-        ...(takesValue ? { value_name: contract.value_name ?? "value" } : {}),
-        value_type: takesValue ? (contract.value_type ?? "string") : "boolean",
-        required: contract.required === true,
-        repeatable: contract.repeatable === true || contract.list === true,
-        input_sources: inputSources,
-        ...(inputSources.includes("stdin") &&
-            contract.flag !== "--stdin" &&
-            contract.flag !== "--stdin-json"
-            ? { stdin_token: "-" }
-            : {}),
-        ...(AT_PATH_FILE_COMMAND_FLAGS.has(`${command}:${contract.flag}`)
-            ? { file_token_prefix: "@" }
-            : {}),
-    };
-}
-/** Enrich a complete command flag table without mutating package-owned rows. */
-export function enrichCliFlagInvocationContracts(command, contracts) {
-    return contracts.map((contract) => enrichCliFlagInvocationContract(command, contract));
-}
-/** Compare generated invocation rows with independently observed executable arity. */
-export function verifyCliFlagInvocationParity(command, declarations, observations) {
-    const normalizedCommand = command.trim().toLowerCase();
-    const findings = [];
-    const observedByFlag = new Map();
-    let matchingObservationCount = 0;
-    for (const observation of observations) {
-        if (observation.command.trim().toLowerCase() !== normalizedCommand)
-            continue;
-        matchingObservationCount += 1;
-        if (observedByFlag.has(observation.flag)) {
-            findings.push({
-                code: "duplicate_observation",
-                command: normalizedCommand,
-                flag: observation.flag,
-                detail: `${normalizedCommand} ${observation.flag} was observed more than once.`,
-            });
-            continue;
-        }
-        observedByFlag.set(observation.flag, observation);
-    }
-    const declaredFlags = new Set(declarations.map(({ flag }) => flag));
-    for (const declaration of declarations) {
-        const observation = observedByFlag.get(declaration.flag);
-        if (!observation) {
-            findings.push({
-                code: "missing_observation",
-                command: normalizedCommand,
-                flag: declaration.flag,
-                detail: `${normalizedCommand} ${declaration.flag} has no executable option observation.`,
-            });
-            continue;
-        }
-        for (const [field, code] of [
-            ["takes_value", "takes_value_mismatch"],
-            ["value_required", "value_required_mismatch"],
-            ["repeatable", "repeatable_mismatch"],
-        ]) {
-            if (declaration[field] === observation[field])
-                continue;
-            findings.push({
-                code,
-                command: normalizedCommand,
-                flag: declaration.flag,
-                detail: `${normalizedCommand} ${declaration.flag} declares ${field}=${String(declaration[field])} but the executable option reports ${String(observation[field])}.`,
-            });
-        }
-    }
-    for (const observation of observedByFlag.values()) {
-        if (declaredFlags.has(observation.flag))
-            continue;
-        findings.push({
-            code: "undeclared_observation",
-            command: normalizedCommand,
-            flag: observation.flag,
-            detail: `${normalizedCommand} ${observation.flag} is executable but absent from invocation contracts.`,
-        });
-    }
-    findings.sort((left, right) => left.flag.localeCompare(right.flag) ||
-        left.code.localeCompare(right.code));
-    return {
-        ok: findings.length === 0,
-        declared_count: declarations.length,
-        observed_count: matchingObservationCount,
-        findings,
-    };
-}
+!(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]="c6f4f9d1-e167-5a06-a1a1-a32d3b3f4d9f")}catch(e2){}})();import{resolvePmHistoryOperation}from"./cli-contracts/command-aliases.js";const FLAG_DESCRIPTIONS=Object.freeze({"--body":"Set the item body.","--body-file":"Read the item body from a file, or from stdin when set to -.","--description":"Set the item description.","--stdin":"Read the value from stdin.","--stdin-json":"Read a complete JSON document from stdin."});const STDIN_TOKEN_FLAGS=new Set(["--add","--body","--comment","--dep","--dep-remove","--description","--doc","--event","--field","--file","--learning","--note","--remove","--reminder","--test","--type-option"]);const STDIN_VALUE_COMMANDS=new Set(["append","comments","create","docs","files","learnings","notes","test","update","update-many"]);const FILE_OR_STDIN_COMMAND_FLAGS=new Set(["close-many:--ids","comments:--file","create:--body-file","history-compact:--ids","learnings:--file","notes:--file","update:--body-file","update-many:--ids"]);const AT_PATH_FILE_COMMAND_FLAGS=new Set(["close-many:--ids","history-compact:--ids","update-many:--ids"]);const BOOLEAN_FLAG_PREFIXES=["--allow-","--check-","--dry-run","--explain","--fail-","--fix-","--full","--has-","--include-","--json","--no-","--prune-","--quiet","--refresh-","--require-","--runtime-only","--schema-only","--skip-","--stream","--strict-","--summary","--today","--verbose"];const BOOLEAN_FLAG_NAMES=new Set(["--activate","--active-only","--adopt","--adopt-all","--all","--all-actionable","--all-affected-ids","--all-day","--all-streams","--acknowledge-linked-tests","--append-stable","--auto-fix","--auto-pm-context","--availability-only","--background","--brief","--by-assignee","--by-priority","--by-tag","--catalog","--claim","--clear","--clear-comments","--clear-criteria","--clear-deps","--clear-docs","--clear-events","--clear-files","--clear-learnings","--clear-notes","--clear-reminders","--clear-tests","--clear-type-options","--cli-only","--closed","--compact","--completion","--count","--counts","--deactivate","--declarative","--defaults","--describe","--diff","--doctor","--empty-body","--explore","--field-utilization","--filter-empty-body","--flags-only","--follow","--force","--global","--highlight","--hybrid","--id-only","--if-available","--ignore-global","--include_unparented","--infer","--init","--install","--isolated","--lean","--list","--local","--manage","--markdown","--metadata-coverage","--next","--normalize-provenance","--only","--only-last","--output-row-contract","--override-linked-pm-context","--override-linked-workspace-context","--packages-only","--past","--phrase-exact","--profile","--progress","--project","--promote-to-item-dep","--provenance","--provenance-summary","--raw","--ready-only","--ready_only","--rebuild","--recent","--reload","--repair","--replace-deps","--replace-docs","--replace-files","--replace-tests","--required","--required-on-create","--run","--runtime-probe","--save-baseline","--scaffold","--semantic","--shared-host-safe","--storage","--title-exact","--token-accounting","--trace","--tree","--unbounded","--uninstall","--validate-paths","--verify","--watch","--with-packages"]);const VALUE_FLAG_NAMES=new Set(["--only-index"]);const VALUE_COMMAND_FLAGS=new Set(["activity:--stream","eval:--fail-under","validate:--fix-scope"]);const OPTIONAL_VALUE_COMMAND_FLAGS=new Set(["activity:--stream","close:--validate-close","close-many:--validate-close","comments:--author","learnings:--author","notes:--author"]);const OPTIONAL_VALUE_FLAGS=new Set(["--regression"]);function resolveFlagInputSources(command,flag){if(flag==="--stdin"||flag==="--stdin-json")return["stdin"];if(FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)){return["argv","file","stdin"]}if(flag.endsWith("-file"))return["argv","file"];if(STDIN_TOKEN_FLAGS.has(flag)&&STDIN_VALUE_COMMANDS.has(command)){return["argv","stdin"]}return["argv"]}function flagTakesValue(command,contract){const explicitlyValued=VALUE_COMMAND_FLAGS.has(`${command}:${contract.flag}`)||contract.value_name!==void 0||contract.value_type==="string"||contract.value_type==="number"||contract.list===true||contract.repeatable===true;const inferredBoolean=contract.value_type==="boolean"||contract.flag==="--stdin"||contract.flag==="--stdin-json"||contract.flag.startsWith("--filter-")&&(contract.flag.endsWith("-missing")||contract.flag.startsWith("--filter-has-")||contract.flag.startsWith("--filter-no-"))||BOOLEAN_FLAG_PREFIXES.some(prefix=>contract.flag.startsWith(prefix));return explicitlyValued||VALUE_FLAG_NAMES.has(contract.flag)||!BOOLEAN_FLAG_NAMES.has(contract.flag)&&!inferredBoolean}function enrichCliFlagInvocationContract(command,contract){const operation=resolvePmHistoryOperation(command);const takesValue=flagTakesValue(operation,contract);const inputSources=resolveFlagInputSources(operation,contract.flag);const description=contract.description??FLAG_DESCRIPTIONS[contract.flag]??`${takesValue?"Set":"Enable"} ${contract.flag.slice(2).replaceAll("-"," ")}.`;return{...contract,description,takes_value:takesValue,value_required:takesValue&&!OPTIONAL_VALUE_FLAGS.has(contract.flag)&&!OPTIONAL_VALUE_COMMAND_FLAGS.has(`${operation}:${contract.flag}`),...takesValue?{value_name:contract.value_name??"value"}:{},value_type:takesValue?contract.value_type??"string":"boolean",required:contract.required===true,repeatable:contract.repeatable===true||contract.list===true,input_sources:inputSources,...inputSources.includes("stdin")&&contract.flag!=="--stdin"&&contract.flag!=="--stdin-json"?{stdin_token:"-"}:{},...AT_PATH_FILE_COMMAND_FLAGS.has(`${operation}:${contract.flag}`)?{file_token_prefix:"@"}:{}}}function enrichCliFlagInvocationContracts(command,contracts){return contracts.map(contract=>enrichCliFlagInvocationContract(command,contract))}function verifyCliFlagInvocationParity(command,declarations,observations){const normalizedCommand=command.trim().toLowerCase();const findings=[];const observedByFlag=new Map;let matchingObservationCount=0;for(const observation of observations){if(observation.command.trim().toLowerCase()!==normalizedCommand)continue;matchingObservationCount+=1;if(observedByFlag.has(observation.flag)){findings.push({code:"duplicate_observation",command:normalizedCommand,flag:observation.flag,detail:`${normalizedCommand} ${observation.flag} was observed more than once.`});continue}observedByFlag.set(observation.flag,observation)}const declaredFlags=new Set(declarations.map(({flag})=>flag));for(const declaration of declarations){const observation=observedByFlag.get(declaration.flag);if(!observation){findings.push({code:"missing_observation",command:normalizedCommand,flag:declaration.flag,detail:`${normalizedCommand} ${declaration.flag} has no executable option observation.`});continue}for(const[field,code]of[["takes_value","takes_value_mismatch"],["value_required","value_required_mismatch"],["repeatable","repeatable_mismatch"]]){if(declaration[field]===observation[field])continue;findings.push({code,command:normalizedCommand,flag:declaration.flag,detail:`${normalizedCommand} ${declaration.flag} declares ${field}=${String(declaration[field])} but the executable option reports ${String(observation[field])}.`})}}for(const observation of observedByFlag.values()){if(declaredFlags.has(observation.flag))continue;findings.push({code:"undeclared_observation",command:normalizedCommand,flag:observation.flag,detail:`${normalizedCommand} ${observation.flag} is executable but absent from invocation contracts.`})}findings.sort((left,right)=>left.flag.localeCompare(right.flag)||left.code.localeCompare(right.code));return{ok:findings.length===0,declared_count:declarations.length,observed_count:matchingObservationCount,findings}}export{enrichCliFlagInvocationContract,enrichCliFlagInvocationContracts,verifyCliFlagInvocationParity};
 //# sourceMappingURL=flag-invocation-contracts.js.map
-//# debugId=7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2