@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/files.d.ts

@@ -1,211 +1,211 @@
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import type { ItemDocument, LinkedFile, LinkScope } from "../types/index.js";
+import type { ItemDocument,LinkedFile,LinkScope } from "../types/index.js";
 import { type LinkedPathValidation } from "./linked-artifacts.js";
-import { type SourceLineRange, type SourceTraceabilityExplanation, type SourceTraceabilityReceipt } from "./traceability/source-traceability.js";
+import { type SourceLineRange,type SourceTraceabilityExplanation,type SourceTraceabilityReceipt } from "./traceability/source-traceability.js";
 /** Documents the files command options payload exchanged by command, SDK, and package integrations. */
 export interface FilesCommandOptions {
 /** Value that configures or reports add for this contract. */
-add?: string[];
+add?:string[];
 /** Value that configures or reports add glob for this contract. */
-addGlob?: string[];
+addGlob?:string[];
 /** Value that configures or reports remove for this contract. */
-remove?: string[];
+remove?:string[];
 /** Value that configures or reports migrate for this contract. */
-migrate?: string[];
+migrate?:string[];
 /** GH-170 (pm-pfnx): standalone note applied to every --add/--add-glob link in this invocation. */
-note?: string;
+note?:string;
 /** Value that configures or reports list for this contract. */
-list?: boolean;
+list?:boolean;
 /** Value that configures or reports append stable for this contract. */
-appendStable?: boolean;
+appendStable?:boolean;
 /** Value that configures or reports validate paths for this contract. */
-validatePaths?: boolean;
+validatePaths?:boolean;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 }
 /** Documents the files discover options payload exchanged by command, SDK, and package integrations. */
 export interface FilesDiscoverOptions {
 /** Value that configures or reports apply for this contract. */
-apply?: boolean;
+apply?:boolean;
 /** Value that configures or reports append stable for this contract. */
-appendStable?: boolean;
+appendStable?:boolean;
 /** Value that configures or reports note for this contract. */
-note?: string;
+note?:string;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 }
 /** Documents the files discovery candidate payload exchanged by command, SDK, and package integrations. */
 export interface FilesDiscoveryCandidate {
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports scope for this contract. */
-scope: LinkScope;
+scope:LinkScope;
 /** Lifecycle state reported for status. */
-status: "addable" | "already_linked";
+status:"addable" | "already_linked";
 /** Number of source entries represented by this result. */
-source_count: number;
+source_count:number;
 /** Value that configures or reports source fields for this contract. */
-source_fields: string[];
+source_fields:string[];
 /** Value that configures or reports original paths for this contract. */
-original_paths: string[];
+original_paths:string[];
 }
 /** Documents the files result payload exchanged by command, SDK, and package integrations. */
 export interface FilesResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports files for this contract. */
-files: LinkedFile[];
+files:LinkedFile[];
 /** Value that configures or reports changed for this contract. */
-changed: boolean;
+changed:boolean;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Value that configures or reports migrations applied for this contract. */
-migrations_applied?: number;
+migrations_applied?:number;
 /** Value that configures or reports validation for this contract. */
-validation?: LinkedPathValidation;
+validation?:LinkedPathValidation;
 }
 /** Documents the files discover result payload exchanged by command, SDK, and package integrations. */
 export interface FilesDiscoverResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports files for this contract. */
-files: LinkedFile[];
+files:LinkedFile[];
 /** Value that configures or reports changed for this contract. */
-changed: boolean;
+changed:boolean;
 /** Value that configures or reports apply for this contract. */
-apply: boolean;
+apply:boolean;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Number of candidate entries represented by this result. */
-candidate_count: number;
+candidate_count:number;
 /** Number of addable entries represented by this result. */
-addable_count: number;
+addable_count:number;
 /** Number of added entries represented by this result. */
-added_count: number;
+added_count:number;
 /** Number of skipped existing entries represented by this result. */
-skipped_existing_count: number;
+skipped_existing_count:number;
 /** Value that configures or reports candidates for this contract. */
-candidates: FilesDiscoveryCandidate[];
+candidates:FilesDiscoveryCandidate[];
 /** Value that configures or reports added for this contract. */
-added: LinkedFile[];
+added:LinkedFile[];
 /** Value that configures or reports skipped existing for this contract. */
-skipped_existing: FilesDiscoveryCandidate[];
+skipped_existing:FilesDiscoveryCandidate[];
 }
 /** Documents reverse linked-file lookup options shared by CLI, SDK, and MCP. */
 export interface FilesLookupOptions {
 /** Project-relative or absolute source paths to resolve. */
-paths: string[];
+paths:string[];
 /** Restrict matches to one linked-file scope. */
-scope?: LinkScope;
+scope?:LinkScope;
 /** Maximum referencing items returned. */
-limit?: number;
+limit?:number;
 /** Number of ordered referencing items skipped. */
-offset?: number;
+offset?:number;
 /** Return every match instead of applying the default output bound. */
-noTruncate?: boolean;
+noTruncate?:boolean;
 /** Fail when any authoritative item cannot be read. */
-strictRead?: boolean;
+strictRead?:boolean;
 /** Include rationale, governing-decision paths, and ambiguity receipts. */
-explain?: boolean;
+explain?:boolean;
 /** Optional inclusive line range; implies explain and requires one path. */
-lineRange?: SourceLineRange;
+lineRange?:SourceLineRange;
 /** Maximum relationship depth searched for a governing decision. */
-decisionDepth?: number;
+decisionDepth?:number;
 }
 /** Token-efficient item identity returned by reverse linked-file lookup. */
 export interface FilesLookupItem {
 /** Stable item identifier. */
-id: string;
+id:string;
 /** Human-readable item title. */
-title: string;
+title:string;
 /** Item kind. */
-type: string;
+type:string;
 /** Lifecycle status. */
-status: string;
+status:string;
 /** Numeric scheduling priority. */
-priority: number;
+priority:number;
 /** Last authoritative update timestamp. */
-updated_at: string;
+updated_at:string;
 }
 /** One item and its exact file links that matched a reverse lookup. */
 export interface FilesLookupMatch {
 /** Referencing item identity. */
-item: FilesLookupItem;
+item:FilesLookupItem;
 /** Matching linked-file evidence. */
-files: LinkedFile[];
+files:LinkedFile[];
 /** Optional bounded rationale and line-attribution explanation. */
-traceability?: SourceTraceabilityExplanation;
+traceability?:SourceTraceabilityExplanation;
 }
 /** Reverse linked-file lookup result with bounded output and read provenance. */
 export interface FilesLookupResult {
 /** Normalized paths used for matching. */
-paths: string[];
+paths:string[];
 /** Total referencing items before pagination. */
-total: number;
+total:number;
 /** Number of matches in this page. */
-count: number;
+count:number;
 /** Zero-based page offset. */
-offset: number;
+offset:number;
 /** Effective result limit, or null when unbounded. */
-limit: number | null;
+limit:number | null;
 /** Whether more matches remain after this page. */
-has_more: boolean;
+has_more:boolean;
 /** Whether the current page is bounded below the total match count. */
-truncated: boolean;
+truncated:boolean;
 /** Read source and completeness receipt. */
-completeness: {
-status: "complete" | "partial" | "unchecked";
-source: "index" | "source_scan";
+completeness:{
+status:"complete" | "partial" | "unchecked";
+source:"index" | "source_scan";
 };
 /** Non-fatal authoritative read warnings. */
-warnings: string[];
+warnings:string[];
 /** Ordered reverse-traceability matches. */
-matches: FilesLookupMatch[];
+matches:FilesLookupMatch[];
 /** Aggregate receipt for an explained source query. */
-traceability_receipt?: SourceTraceabilityReceipt;
+traceability_receipt?:SourceTraceabilityReceipt;
 }
 interface TextReference {
-field: string;
-value: string;
+field:string;
+value:string;
 }
 interface RawPathReference {
-field: string;
-value: string;
+field:string;
+value:string;
 }
-declare function normalizeCandidatePathForOutput(value: string): string;
-declare function realpathForContainment(inputPath: string): Promise<string>;
-declare function linkedFileResolvedKey(linkedFile: Pick<LinkedFile, "path" | "scope">, projectRoot: string): string;
-declare function collectTextReferences(value: unknown, fieldPath: string, references: TextReference[]): void;
-declare function collectItemTextReferences(document: ItemDocument): TextReference[];
-declare function cleanupPathToken(value: string): string;
-declare function extractRawPathReferences(references: TextReference[]): RawPathReference[];
-declare function resolveDiscoveredFile(rawPath: string, workspaceRoot: string, invocationRoot?: string): Promise<Pick<LinkedFile, "path" | "scope"> | undefined>;
-declare function discoverReferencedFiles(document: ItemDocument, workspaceRoot: string, invocationRoot?: string): Promise<FilesDiscoveryCandidate[]>;
+declare function normalizeCandidatePathForOutput(value:string):string;
+declare function realpathForContainment(inputPath:string):Promise<string>;
+declare function linkedFileResolvedKey(linkedFile:Pick<LinkedFile,"path" | "scope">,projectRoot:string):string;
+declare function collectTextReferences(value:unknown,fieldPath:string,references:TextReference[]):void;
+declare function collectItemTextReferences(document:ItemDocument):TextReference[];
+declare function cleanupPathToken(value:string):string;
+declare function extractRawPathReferences(references:TextReference[]):RawPathReference[];
+declare function resolveDiscoveredFile(rawPath:string,workspaceRoot:string,invocationRoot?:string):Promise<Pick<LinkedFile,"path" | "scope"> | undefined>;
+declare function discoverReferencedFiles(document:ItemDocument,workspaceRoot:string,invocationRoot?:string):Promise<FilesDiscoveryCandidate[]>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-relativeReferenceScanMaxChars: number;
-normalizeCandidatePathForOutput: typeof normalizeCandidatePathForOutput;
-realpathForContainment: typeof realpathForContainment;
-linkedFileResolvedKey: typeof linkedFileResolvedKey;
-collectTextReferences: typeof collectTextReferences;
-collectItemTextReferences: typeof collectItemTextReferences;
-cleanupPathToken: typeof cleanupPathToken;
-extractRawPathReferences: typeof extractRawPathReferences;
-resolveDiscoveredFile: typeof resolveDiscoveredFile;
-discoverReferencedFiles: typeof discoverReferencedFiles;
+export declare const _testOnly:{
+relativeReferenceScanMaxChars:number;
+normalizeCandidatePathForOutput:typeof normalizeCandidatePathForOutput;
+realpathForContainment:typeof realpathForContainment;
+linkedFileResolvedKey:typeof linkedFileResolvedKey;
+collectTextReferences:typeof collectTextReferences;
+collectItemTextReferences:typeof collectItemTextReferences;
+cleanupPathToken:typeof cleanupPathToken;
+extractRawPathReferences:typeof extractRawPathReferences;
+resolveDiscoveredFile:typeof resolveDiscoveredFile;
+discoverReferencedFiles:typeof discoverReferencedFiles;
 };
 /** Implements run files for the public runtime surface of this module. */
-export declare function runFiles(id: string, options: FilesCommandOptions, global: GlobalOptions): Promise<FilesResult>;
+export declare function runFiles(id:string,options:FilesCommandOptions,global:GlobalOptions):Promise<FilesResult>;
 /** Resolve the pm items that reference one or more source paths. */
-export declare function runFilesLookup(options: FilesLookupOptions, global: GlobalOptions): Promise<FilesLookupResult>;
+export declare function runFilesLookup(options:FilesLookupOptions,global:GlobalOptions):Promise<FilesLookupResult>;
 /** Implements run files discover for the public runtime surface of this module. */
-export declare function runFilesDiscover(id: string, options: FilesDiscoverOptions, global: GlobalOptions): Promise<FilesDiscoverResult>;
+export declare function runFilesDiscover(id:string,options:FilesDiscoverOptions,global:GlobalOptions):Promise<FilesDiscoverResult>;
 export {};

package/dist/sdk/flag-invocation-contracts.d.ts

@@ -4,62 +4,62 @@ export type CliFlagInputSource = "argv" | "file" | "stdin";
 /** Complete invocation semantics for one accepted CLI flag. */
 export interface CliFlagInvocationContract extends CliFlagContract {
 /** Human-readable behavior, always present for generated surfaces. */
-description: string;
+description:string;
 /** Whether the option consumes a value token. */
-takes_value: boolean;
+takes_value:boolean;
 /** Whether omission of the consumed value is invalid. */
-value_required: boolean;
+value_required:boolean;
 /** Machine value type after CLI parsing. */
-value_type: "string" | "number" | "boolean";
+value_type:"string" | "number" | "boolean";
 /** Whether the option itself is required. */
-required: boolean;
+required:boolean;
 /** Whether repeated occurrences accumulate. */
-repeatable: boolean;
+repeatable:boolean;
 /** Accepted value channels. */
-input_sources: CliFlagInputSource[];
+input_sources:CliFlagInputSource[];
 /** Sentinel that redirects the argv value to stdin. */
-stdin_token?: "-";
+stdin_token?:"-";
 /** Prefix that redirects the argv value to a file path. */
-file_token_prefix?: "@";
+file_token_prefix?:"@";
 }
 /** Executable option arity observed from the registered Commander program. */
 export interface CliFlagArityObservation {
 /** Canonical command path owning the option. */
-command: string;
+command:string;
 /** Long option spelling. */
-flag: string;
+flag:string;
 /** Whether the option consumes a value token. */
-takes_value: boolean;
+takes_value:boolean;
 /** Whether the consumed value is mandatory. */
-value_required: boolean;
+value_required:boolean;
 /** Whether repeated values accumulate. */
-repeatable: boolean;
+repeatable:boolean;
 }
 /** One machine-readable mismatch between declared and executable flag arity. */
 export interface CliFlagInvocationParityFinding {
 /** Stable finding code. */
-code: "duplicate_observation" | "missing_observation" | "takes_value_mismatch" | "value_required_mismatch" | "repeatable_mismatch" | "undeclared_observation";
+code:"duplicate_observation" | "missing_observation" | "takes_value_mismatch" | "value_required_mismatch" | "repeatable_mismatch" | "undeclared_observation";
 /** Canonical command path. */
-command: string;
+command:string;
 /** Long option spelling. */
-flag: string;
+flag:string;
 /** Human-readable mismatch detail. */
-detail: string;
+detail:string;
 }
 /** Complete parity receipt for one command's declared and executable flags. */
 export interface CliFlagInvocationParityReport {
 /** Whether the two surfaces agree exactly. */
-ok: boolean;
+ok:boolean;
 /** Number of declared invocation rows. */
-declared_count: number;
+declared_count:number;
 /** Number of executable observations. */
-observed_count: number;
+observed_count:number;
 /** Stable mismatch list. */
-findings: CliFlagInvocationParityFinding[];
+findings:CliFlagInvocationParityFinding[];
 }
 /** Enrich one vocabulary row with deterministic invocation and input-channel metadata. */
-export declare function enrichCliFlagInvocationContract(command: string, contract: CliFlagContract): CliFlagInvocationContract;
+export declare function enrichCliFlagInvocationContract(command:string,contract:CliFlagContract):CliFlagInvocationContract;
 /** Enrich a complete command flag table without mutating package-owned rows. */
-export declare function enrichCliFlagInvocationContracts(command: string, contracts: readonly CliFlagContract[]): CliFlagInvocationContract[];
+export declare function enrichCliFlagInvocationContracts(command:string,contracts:readonly CliFlagContract[]):CliFlagInvocationContract[];
 /** Compare generated invocation rows with independently observed executable arity. */
-export declare function verifyCliFlagInvocationParity(command: string, declarations: readonly CliFlagInvocationContract[], observations: readonly CliFlagArityObservation[]): CliFlagInvocationParityReport;
+export declare function verifyCliFlagInvocationParity(command:string,declarations:readonly CliFlagInvocationContract[],observations:readonly CliFlagArityObservation[]):CliFlagInvocationParityReport;

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

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="95513ca1-1eca-5bff-9f29-7055ba879f1b")}catch{}})();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."}),STDIN_TOKEN_FLAGS=new Set(["--add","--body","--comment","--dep","--dep-remove","--description","--doc","--event","--field","--file","--learning","--note","--remove","--reminder","--test","--type-option"]),STDIN_VALUE_COMMANDS=new Set(["append","comments","create","docs","files","learnings","notes","test","update","update-many"]),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"]),AT_PATH_FILE_COMMAND_FLAGS=new Set(["close-many:--ids","history-compact:--ids","update-many:--ids"]),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"],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"]),VALUE_FLAG_NAMES=new Set(["--only-index"]),VALUE_COMMAND_FLAGS=new Set(["activity:--stream","eval:--fail-under","validate:--fix-scope"]),OPTIONAL_VALUE_COMMAND_FLAGS=new Set(["activity:--stream","close:--validate-close","close-many:--validate-close","comments:--author","learnings:--author","notes:--author"]),OPTIONAL_VALUE_FLAGS=new Set(["--regression"]);function resolveFlagInputSources(command,flag){return flag==="--stdin"||flag==="--stdin-json"?["stdin"]:FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)?["argv","file","stdin"]:flag.endsWith("-file")?["argv","file"]:STDIN_TOKEN_FLAGS.has(flag)&&STDIN_VALUE_COMMANDS.has(command)?["argv","stdin"]:["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===!0||contract.repeatable===!0,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),takesValue=flagTakesValue(operation,contract),inputSources=resolveFlagInputSources(operation,contract.flag),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===!0,repeatable:contract.repeatable===!0||contract.list===!0,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(),findings=[],observedByFlag=new Map;let matchingObservationCount=0;for(const observation of observations)if(observation.command.trim().toLowerCase()===normalizedCommand){if(matchingObservationCount+=1,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"]])declaration[field]!==observation[field]&&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())declaredFlags.has(observation.flag)||findings.push({code:"undeclared_observation",command:normalizedCommand,flag:observation.flag,detail:`${normalizedCommand} ${observation.flag} is executable but absent from invocation contracts.`});return findings.sort((left,right)=>left.flag.localeCompare(right.flag)||left.code.localeCompare(right.code)),{ok:findings.length===0,declared_count:declarations.length,observed_count:matchingObservationCount,findings}}export{enrichCliFlagInvocationContract,enrichCliFlagInvocationContracts,verifyCliFlagInvocationParity};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c2e89d3c-9abc-5ca7-a290-69a54dd694ab")}catch{}})();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."}),STDIN_TOKEN_FLAGS=new Set(["--add","--body","--comment","--dep","--dep-remove","--description","--doc","--event","--field","--file","--learning","--note","--remove","--reminder","--test","--type-option"]),STDIN_VALUE_COMMANDS=new Set(["append","comments","create","docs","files","learnings","notes","test","update","update-many"]),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"]),AT_PATH_FILE_COMMAND_FLAGS=new Set(["close-many:--ids","history-compact:--ids","update-many:--ids"]),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"],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"]),VALUE_FLAG_NAMES=new Set(["--only-index"]),VALUE_COMMAND_FLAGS=new Set(["activity:--stream","eval:--fail-under","validate:--fix-scope"]),OPTIONAL_VALUE_COMMAND_FLAGS=new Set(["activity:--stream","close:--validate-close","close-many:--validate-close","comments:--author","learnings:--author","notes:--author"]),OPTIONAL_VALUE_FLAGS=new Set(["--regression"]);function resolveFlagInputSources(command,flag){return flag==="--stdin"||flag==="--stdin-json"?["stdin"]:FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)?["argv","file","stdin"]:flag.endsWith("-file")?["argv","file"]:STDIN_TOKEN_FLAGS.has(flag)&&STDIN_VALUE_COMMANDS.has(command)?["argv","stdin"]:["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===!0||contract.repeatable===!0,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 resolveFlagValueArity(command,contract){return contract.value_arity!==void 0?contract.value_arity:flagTakesValue(command,contract)?OPTIONAL_VALUE_FLAGS.has(contract.flag)||OPTIONAL_VALUE_COMMAND_FLAGS.has(`${command}:${contract.flag}`)?"optional":"required":"none"}function enrichCliFlagInvocationContract(command,contract){const operation=resolvePmHistoryOperation(command),arity=resolveFlagValueArity(operation,contract),takesValue=arity!=="none",inputSources=resolveFlagInputSources(operation,contract.flag),description=contract.description??FLAG_DESCRIPTIONS[contract.flag]??`${takesValue?"Set":"Enable"} ${contract.flag.slice(2).replaceAll("-"," ")}.`;return{...contract,description,takes_value:takesValue,value_required:arity==="required",...takesValue?{value_name:contract.value_name??"value"}:{},value_type:takesValue?contract.value_type??"string":"boolean",required:contract.required===!0,repeatable:contract.repeatable===!0||contract.list===!0,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(),findings=[],observedByFlag=new Map;let matchingObservationCount=0;for(const observation of observations)if(observation.command.trim().toLowerCase()===normalizedCommand){if(matchingObservationCount+=1,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"]])declaration[field]!==observation[field]&&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())declaredFlags.has(observation.flag)||findings.push({code:"undeclared_observation",command:normalizedCommand,flag:observation.flag,detail:`${normalizedCommand} ${observation.flag} is executable but absent from invocation contracts.`});return findings.sort((left,right)=>left.flag.localeCompare(right.flag)||left.code.localeCompare(right.code)),{ok:findings.length===0,declared_count:declarations.length,observed_count:matchingObservationCount,findings}}export{enrichCliFlagInvocationContract,enrichCliFlagInvocationContracts,verifyCliFlagInvocationParity};
 //# sourceMappingURL=flag-invocation-contracts.js.map

package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts

@@ -5,4 +5,4 @@
  */
 import type { PmErrorCodeContract } from "../error-code-catalog.js";
 /** Generated partition 1 of the exhaustive error-code catalog. */
-export declare const PM_ERROR_CODE_CATALOG_PART_1: PmErrorCodeContract[];
+export declare const PM_ERROR_CODE_CATALOG_PART_1:PmErrorCodeContract[];

package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts

@@ -5,4 +5,4 @@
  */
 import type { PmErrorCodeContract } from "../error-code-catalog.js";
 /** Generated partition 2 of the exhaustive error-code catalog. */
-export declare const PM_ERROR_CODE_CATALOG_PART_2: PmErrorCodeContract[];
+export declare const PM_ERROR_CODE_CATALOG_PART_2:PmErrorCodeContract[];