@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/agent/closed-domain-contracts.d.ts

@@ -1,25 +1,25 @@
 /** A closed-domain refusal that can be executed and recovered automatically. */
 export interface PmClosedDomainContract {
 /** Stable assurance identity. */
-probe_id: string;
+probe_id:string;
 /** Public command accepting the constrained flag. */
-command: string;
+command:string;
 /** Constrained option spelling. */
-flag: string;
+flag:string;
 /** Invalid token used to prove the refusal path. */
-rejected_value: string;
+rejected_value:string;
 /** Exact argv that must refuse the invalid token. */
-refusal_args: readonly string[];
+refusal_args:readonly string[];
 /** Complete stable core domain accepted by the command. */
-allowed_values: readonly string[];
+allowed_values:readonly string[];
 /** Exact argv expected in the refusal's executable recovery. */
-suggested_retry_args: readonly string[];
+suggested_retry_args:readonly string[];
 /** Stable machine-readable error code that owns the refusal. */
-error_code: "package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
+error_code:"package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
 /** Whether a complete accepted-value domain is required in the refusal. */
-allowed_values_required?: boolean;
+allowed_values_required?:boolean;
 }
 /** Return the complete stable core refusal corpus shared by every public surface. */
-export declare function listCoreClosedDomainContracts(): PmClosedDomainContract[];
+export declare function listCoreClosedDomainContracts():PmClosedDomainContract[];
 /** Render a compact but complete core-domain description for command help. */
-export declare function renderPmClosedDomainHelp(command: string, flag: "--fields" | "--for"): string;
+export declare function renderPmClosedDomainHelp(command:string,flag:"--fields" | "--for"):string;

package/dist/sdk/agent/command-recovery.d.ts

@@ -1,10 +1,10 @@
 /** Identify presentation intent that must not be silently dropped from an unknown-option retry. */
-export declare function isReadProjectionRecoveryFlag(flag: string): boolean;
+export declare function isReadProjectionRecoveryFlag(flag:string):boolean;
 /** Keep lexical corrections within read projection or mutation receipt semantics. */
-export declare function isCompatibleRecoveryFlag(requested: string, candidate: string): boolean;
+export declare function isCompatibleRecoveryFlag(requested:string,candidate:string):boolean;
 /** Resolve a recovery command without interpreting global option values as command tokens. */
-export declare function resolveRecoveryCommandName(invocationArgv: string[] | undefined): string | undefined;
+export declare function resolveRecoveryCommandName(invocationArgv:string[] | undefined):string | undefined;
 /** Resolve the truthful placeholder for a missing flag from its contract. */
-export declare function resolveMissingOptionPlaceholder(commandName: string, missingLabel: string): string | null | undefined;
+export declare function resolveMissingOptionPlaceholder(commandName:string,missingLabel:string):string | null | undefined;
 /** Preserve an attempted argv vector and insert each missing option before `--`. */
-export declare function renderMissingOptionRetry(invocationArgv: string[], commandName: string, missingLabels: string[]): string | undefined;
+export declare function renderMissingOptionRetry(invocationArgv:string[],commandName:string,missingLabels:string[]):string | undefined;

package/dist/sdk/agent/command-suggestions.d.ts

@@ -1,12 +1,12 @@
 /** Resolve the longest exact misplaced suffix under registered namespaces only when one canonical command owns it. */
-export declare function resolveMisnestedCommandPath(unknownPath: string, availablePaths: readonly string[]): string | undefined;
+export declare function resolveMisnestedCommandPath(unknownPath:string,availablePaths:readonly string[]):string | undefined;
 /** Score one command path for a guessed command token; lower is better. */
-export declare function scoreCommandPathMatch(commandPath: string, queryToken: string): number;
+export declare function scoreCommandPathMatch(commandPath:string,queryToken:string):number;
 /** Rank available command paths for one guessed token. */
-export declare function rankCommandPaths(commandPaths: string[], queryToken: string): string[];
+export declare function rankCommandPaths(commandPaths:string[],queryToken:string):string[];
 /**
  * Replace migration-only prefixes with installed canonical paths and required flags.
  * A query token prefers known semantic matches over weaker spelling guesses after
  * unavailable replacements have been removed.
  */
-export declare function canonicalizeCommandSuggestions(candidates: readonly string[], availablePaths: readonly string[], queryToken?: string): string[];
+export declare function canonicalizeCommandSuggestions(candidates:readonly string[],availablePaths:readonly string[],queryToken?:string):string[];

package/dist/sdk/agent/create-option-policy.d.ts

@@ -7,6 +7,6 @@
  * truthful answer that the collection is intentionally empty.
  */
 /** Return the explicit-empty flag for a repeatable create option. */
-export declare function resolveCreateExplicitEmptyFlag(optionKey: string): string | undefined;
+export declare function resolveCreateExplicitEmptyFlag(optionKey:string):string | undefined;
 /** Return whether a create option can be satisfied by an explicit empty set. */
-export declare function supportsCreateExplicitEmpty(optionKey: string): boolean;
+export declare function supportsCreateExplicitEmpty(optionKey:string):boolean;

package/dist/sdk/agent/identity-config.d.ts

@@ -8,56 +8,56 @@
 /** Persisted legacy-author interpretation vocabulary. */
 export interface AgentIdentityVocabulary {
 /** Monotonic interpretation revision. */
-version: number;
+version:number;
 /** Exact legacy author spelling to canonical harness namespace. */
-aliases: Record<string, string>;
+aliases:Record<string,string>;
 }
 /** Privacy-safe vocabulary projection used by config get/list/export. */
 export interface AgentIdentityVocabularySummary {
 /** Current interpretation revision. */
-version: number;
+version:number;
 /** Number of exact legacy spellings configured. */
-alias_count: number;
+alias_count:number;
 }
 /** Supported vocabulary mutations. */
 export type AgentIdentityVocabularyOperation = "add" | "remove" | "clear";
 /** One typed vocabulary mutation and optional residual-coverage census. */
 export interface AgentIdentityVocabularyMutationInput {
 /** Exact operation applied to the vocabulary. */
-operation: AgentIdentityVocabularyOperation;
+operation:AgentIdentityVocabularyOperation;
 /** Exact legacy spelling required by add/remove. */
-legacy_author?: string;
+legacy_author?:string;
 /** Canonical lowercase harness namespace required by add. */
-canonical_harness?: string;
+canonical_harness?:string;
 /** Optional bounded author census used only to count still-unmapped values. */
-observed_authors?: readonly string[];
+observed_authors?:readonly string[];
 }
 /** Privacy-safe dry-run or committed mutation preview. */
 export interface AgentIdentityVocabularyMutationPreview {
 /** Operation that was evaluated. */
-operation: AgentIdentityVocabularyOperation;
+operation:AgentIdentityVocabularyOperation;
 /** Whether persistence would change. */
-changed: boolean;
+changed:boolean;
 /** Revision before the operation. */
-version_before: number;
+version_before:number;
 /** Revision after the operation, equal when idempotent. */
-version_after: number;
+version_after:number;
 /** Alias count after the operation. */
-alias_count: number;
+alias_count:number;
 /** Unique non-canonical authors not covered after the operation. */
-residual_author_count: number;
+residual_author_count:number;
 }
 /** Planned vocabulary plus a privacy-safe result preview. */
 export interface AgentIdentityVocabularyMutationPlan {
 /** Complete value suitable for settings persistence. */
-vocabulary: AgentIdentityVocabulary;
+vocabulary:AgentIdentityVocabulary;
 /** Public mutation result with no alias spellings. */
-preview: AgentIdentityVocabularyMutationPreview;
+preview:AgentIdentityVocabularyMutationPreview;
 }
 /** Return only the revision and count suitable for config discovery surfaces. */
-export declare function summarizeAgentIdentityVocabulary(vocabulary: AgentIdentityVocabulary | undefined): AgentIdentityVocabularySummary;
+export declare function summarizeAgentIdentityVocabulary(vocabulary:AgentIdentityVocabulary | undefined):AgentIdentityVocabularySummary;
 /**
  * Validate and plan one exact mutation. A real change increments the revision
  * exactly once; identical adds and absent removes are idempotent.
  */
-export declare function planAgentIdentityVocabularyMutation(current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput): AgentIdentityVocabularyMutationPlan;
+export declare function planAgentIdentityVocabularyMutation(current:AgentIdentityVocabulary | undefined,input:AgentIdentityVocabularyMutationInput):AgentIdentityVocabularyMutationPlan;

package/dist/sdk/agent/item-addressing.d.ts

@@ -1,19 +1,19 @@
 /** Result of normalizing one item-addressed invocation. */
 export interface ItemAddressInvocationResult {
 /** Canonical argv with an `--id` value moved into positional-id location. */
-argv: string[];
+argv:string[];
 /** Whether argv changed. */
-changed: boolean;
+changed:boolean;
 /** Whether both positional and named item ids were supplied. */
-conflict: boolean;
+conflict:boolean;
 /** Resolved named item id when one was present. */
-itemId?: string;
+itemId?:string;
 }
 /** Return whether a command participates in the shared item-id alias contract. */
-export declare function supportsItemIdAlias(commandName: string | undefined): boolean;
+export declare function supportsItemIdAlias(commandName:string | undefined):boolean;
 /**
  * Normalize `pm <command> --id <value>` to the command's positional id form.
  * The transformation is lossless for every other argument and reports a
  * conflict instead of guessing when both forms are present.
  */
-export declare function normalizeItemAddressInvocation(argv: string[]): ItemAddressInvocationResult;
+export declare function normalizeItemAddressInvocation(argv:string[]):ItemAddressInvocationResult;

package/dist/sdk/agent/refusal-closure-census.d.ts

@@ -13,58 +13,58 @@ export type PmRefusalEvidenceKind = "owned_state" | "closed_domain" | "grammar";
 /** One complete-catalog closure row. */
 export interface PmRefusalClosureCensusRow {
 /** Declared machine-readable error code. */
-code: string;
+code:string;
 /** Canonical compatibility-group code. */
-canonical_code: string;
+canonical_code:string;
 /** Whether at least one executable probe reaches the compatibility group. */
-disposition: "executable" | "uncovered";
+disposition:"executable" | "uncovered";
 /** Evidence families contributing executable probes. */
-evidence_kinds: PmRefusalEvidenceKind[];
+evidence_kinds:PmRefusalEvidenceKind[];
 /** Stable executable probe identities. */
-probe_ids: string[];
+probe_ids:string[];
 }
 /** Full emitted-vocabulary refusal closure receipt. */
 export interface PmRefusalClosureCensusReport {
 /** True only when every catalog code belongs to a probed compatibility group. */
-ok: boolean;
+ok:boolean;
 /** Number of emitted codes in the catalog. */
-catalog_error_code_count: number;
+catalog_error_code_count:number;
 /** Number of codes backed by executable evidence. */
-executable_error_code_count: number;
+executable_error_code_count:number;
 /** Number of codes still lacking executable evidence. */
-uncovered_error_code_count: number;
+uncovered_error_code_count:number;
 /** Executable codes divided by all catalog codes. */
-coverage_fraction: number;
+coverage_fraction:number;
 /** Number of closed-domain probes joined into the census. */
-closed_domain_probe_count: number;
+closed_domain_probe_count:number;
 /** Number of grammar-derived probes joined into the census. */
-grammar_probe_count: number;
+grammar_probe_count:number;
 /** Stable complete list of codes without executable evidence. */
-uncovered_error_codes: string[];
+uncovered_error_codes:string[];
 /** Exactly one row for every catalog code. */
-rows: PmRefusalClosureCensusRow[];
+rows:PmRefusalClosureCensusRow[];
 }
 /** @deprecated Historical v1 floor retained for SDK compatibility. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
 /** @deprecated Historical v1 identities retained for SDK compatibility. */
-export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE: readonly ["bulk_ids_input_empty", "bulk_ids_input_missing_path", "bulk_ids_input_unreadable", "invalid_argument_value", "missing_lifecycle_target", "missing_required_argument", "projection_options_mutually_exclusive", "tracker_not_initialized", "tracker_root_missing", "tracker_root_not_directory", "tracker_root_unreadable", "unknown_context_intent", "unknown_field_projection", "unknown_option", "unknown_subcommand"];
+export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE:readonly ["bulk_ids_input_empty","bulk_ids_input_missing_path","bulk_ids_input_unreadable","invalid_argument_value","missing_lifecycle_target","missing_required_argument","projection_options_mutually_exclusive","tracker_not_initialized","tracker_root_missing","tracker_root_not_directory","tracker_root_unreadable","unknown_context_intent","unknown_field_projection","unknown_option","unknown_subcommand"];
 /** Reviewed v2 floor of 18 catalog rows across 17 canonical groups. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
 /** V2 canonical identities that must retain executable evidence. */
-export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2: readonly string[];
+export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2:readonly string[];
 /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
-export declare function verifyPmRefusalClosureRatchet(report: PmRefusalClosureCensusReport, baseline?: number): {
-ok: boolean;
-baseline: number;
-actual: number;
+export declare function verifyPmRefusalClosureRatchet(report:PmRefusalClosureCensusReport,baseline?:number):{
+ok:boolean;
+baseline:number;
+actual:number;
 };
 /** Ratchet canonical compatibility-group identities independently from counts. */
-export declare function verifyPmRefusalClosureIdentityRatchet(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]): {
-ok: boolean;
-required_canonical_codes: string[];
-missing_required_canonical_codes: string[];
+export declare function verifyPmRefusalClosureIdentityRatchet(report:PmRefusalClosureCensusReport,requiredCanonicalCodes?:readonly string[]):{
+ok:boolean;
+required_canonical_codes:string[];
+missing_required_canonical_codes:string[];
 };
 /** Build the complete closure join without silently omitting uncovered codes. */
-export declare function buildPmRefusalClosureCensus(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]): PmRefusalClosureCensusReport;
+export declare function buildPmRefusalClosureCensus(catalog:readonly PmErrorCodeContract[],closedDomains:readonly PmClosedDomainContract[],grammar:readonly PmGrammarRefusalContract[]):PmRefusalClosureCensusReport;
 /** Render the complete census for generated documentation and review evidence. */
-export declare function renderPmRefusalClosureCensusMarkdown(report: PmRefusalClosureCensusReport): string;
+export declare function renderPmRefusalClosureCensusMarkdown(report:PmRefusalClosureCensusReport):string;

package/dist/sdk/agent/refusal-closure.d.ts

@@ -1,53 +1,53 @@
 /** One real refusal and the outcome of executing its advertised retry. */
 export interface PmRefusalClosureObservation {
 /** Stable corpus identifier. */
-probe_id: string;
+probe_id:string;
 /** Public entrypoint that refused the invocation. */
-entrypoint: string;
+entrypoint:string;
 /** Process exit code returned by the refusal. */
-exit_code: number;
+exit_code:number;
 /** Rejected closed-domain token. */
-rejected_value: string;
+rejected_value:string;
 /** Complete accepted domain emitted by the refusal. */
-allowed_values: readonly string[];
+allowed_values:readonly string[];
 /** Stable error code emitted by the refusal. */
-error_code?: string;
+error_code?:string;
 /** Contract-owned error code required for this refusal. */
-expected_error_code?: string;
+expected_error_code?:string;
 /** Contract-owned complete accepted domain. */
-expected_allowed_values?: readonly string[];
+expected_allowed_values?:readonly string[];
 /** Whether an accepted-value domain is required for this refusal class. */
-allowed_values_required?: boolean;
+allowed_values_required?:boolean;
 /** Exact command emitted for recovery. */
-suggested_retry: string;
+suggested_retry:string;
 /** Shell-free argv emitted for safe programmatic recovery. */
-suggested_retry_args?: readonly string[];
+suggested_retry_args?:readonly string[];
 /** Contract-owned argv required for deterministic recovery. */
-expected_suggested_retry_args?: readonly string[];
+expected_suggested_retry_args?:readonly string[];
 /** Whether executing the advertised retry succeeded. */
-retry_succeeded: boolean;
+retry_succeeded:boolean;
 }
 /** One missing or contradictory recovery primitive. */
 export interface PmRefusalClosureFinding {
 /** Stable finding code. */
-code: "accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
+code:"accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
 /** Stable corpus identifier. */
-probe_id: string;
+probe_id:string;
 /** Actionable mismatch detail. */
-detail: string;
+detail:string;
 }
 /** Complete recovery-closure score and its fail-closed findings. */
 export interface PmRefusalClosureReport {
 /** Whether every refusal was self-contained and executable. */
-ok: boolean;
+ok:boolean;
 /** Number of unique probes scored. */
-probe_count: number;
+probe_count:number;
 /** Number of probes with complete successful closure. */
-closed_probe_count: number;
+closed_probe_count:number;
 /** Closed probes divided by unique probes. */
-closure_fraction: number;
+closure_fraction:number;
 /** Stable ordered findings. */
-findings: readonly PmRefusalClosureFinding[];
+findings:readonly PmRefusalClosureFinding[];
 }
 /** Score structured closed-domain refusals and executable retries. */
-export declare function scorePmRefusalClosure(observations: readonly PmRefusalClosureObservation[]): PmRefusalClosureReport;
+export declare function scorePmRefusalClosure(observations:readonly PmRefusalClosureObservation[]):PmRefusalClosureReport;

package/dist/sdk/agent/refusal-corpus-contracts.d.ts

@@ -2,75 +2,75 @@ import { type PmCommandPositionalContract } from "../cli-contracts/grammar-contr
 /** Shared executable shape for a refusal that must not mutate tracker state. */
 export interface PmGrammarRefusalContract {
 /** Stable probe identity used by ratchets and evidence. */
-probe_id: string;
+probe_id:string;
 /** Canonical command path under test. */
-command: string;
+command:string;
 /** Exact argv expected to refuse. */
-refusal_args: readonly string[];
+refusal_args:readonly string[];
 /** Exact help argv that must execute successfully after the refusal. */
-recovery_args: readonly string[];
+recovery_args:readonly string[];
 /** Stable problem-envelope code expected from the refusal. */
-error_code: "invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
+error_code:"invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
 }
 /** One required positional omission derived from the grammar declaration. */
 export interface PmRequiredArgumentRefusalContract extends PmGrammarRefusalContract {
 /** Stable positional name deliberately omitted by the probe. */
-missing_argument: string;
+missing_argument:string;
 /** Zero-based slot index in the command's declared positional signature. */
-missing_argument_index: number;
+missing_argument_index:number;
 }
 /** One invalid action probe for a closed positional subcommand family. */
 export interface PmSubcommandRefusalContract extends PmGrammarRefusalContract {
 /** Invalid action token used to reach the refusal. */
-rejected_value: string;
+rejected_value:string;
 /** Complete authoritative action domain expected in recovery. */
-allowed_values: readonly string[];
+allowed_values:readonly string[];
 }
 /** Runtime evidence for one grammar-derived refusal probe. */
 export interface PmGrammarRefusalObservation {
 /** Probe identity matching a declared contract. */
-probe_id: string;
+probe_id:string;
 /** Machine-readable code emitted by the refusal. */
-error_code: string;
+error_code:string;
 /** Process exit code emitted by the refusal. */
-exit_code: number;
+exit_code:number;
 /** Allowed values emitted for a closed action family. */
-allowed_values: readonly string[];
+allowed_values:readonly string[];
 /** Whether the advertised help recovery exited successfully. */
-recovery_succeeded: boolean;
+recovery_succeeded:boolean;
 /** Whether any tracker state changed while executing the refusal. */
-refusal_mutated_state: boolean;
+refusal_mutated_state:boolean;
 /** Repository-relative tracker paths changed by the refusal, when measured. */
-mutated_paths?: readonly string[];
+mutated_paths?:readonly string[];
 }
 /** Stable reason a grammar-derived refusal failed closure. */
 export type PmGrammarRefusalFindingCode = "refusal_allowed_values_mismatch" | "refusal_error_code_mismatch" | "refusal_exit_code_mismatch" | "refusal_mutated_state" | "refusal_probe_missing" | "refusal_recovery_failed" | "unexpected_refusal_probe";
 /** One actionable grammar-derived refusal closure failure. */
 export interface PmGrammarRefusalFinding {
 /** Stable machine-readable failure category. */
-code: PmGrammarRefusalFindingCode;
+code:PmGrammarRefusalFindingCode;
 /** Probe associated with the finding. */
-probe_id: string;
+probe_id:string;
 /** Human-readable failure detail. */
-detail: string;
+detail:string;
 }
 /** Aggregate closure receipt for the grammar-derived refusal corpus. */
 export interface PmGrammarRefusalClosureReport {
 /** Whether every declared probe refused safely and recovered. */
-ok: boolean;
+ok:boolean;
 /** Number of declared probes. */
-probe_count: number;
+probe_count:number;
 /** Number of probes without findings. */
-closed_probe_count: number;
+closed_probe_count:number;
 /** Stable actionable failures. */
-findings: PmGrammarRefusalFinding[];
+findings:PmGrammarRefusalFinding[];
 }
 /**
  * Return one omission probe for every required slot in the declared grammar.
  * Earlier positionals receive deterministic, non-mutating placeholder values.
  */
-export declare function listPmRequiredArgumentRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmRequiredArgumentRefusalContract[];
+export declare function listPmRequiredArgumentRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmRequiredArgumentRefusalContract[];
 /** Return one invalid-action probe for every required positional action family. */
-export declare function listPmSubcommandRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmSubcommandRefusalContract[];
+export declare function listPmSubcommandRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmSubcommandRefusalContract[];
 /** Score exact code, exit, domain, state-safety, and recovery closure. */
-export declare function scorePmGrammarRefusalClosure(contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]): PmGrammarRefusalClosureReport;
+export declare function scorePmGrammarRefusalClosure(contracts:readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[],observations:readonly PmGrammarRefusalObservation[]):PmGrammarRefusalClosureReport;