@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -7,52 +7,52 @@
  */
 /** Persisted legacy-author interpretation vocabulary. */
 export interface AgentIdentityVocabulary {
-    /** Monotonic interpretation revision. */
-    version: number;
-    /** Exact legacy author spelling to canonical harness namespace. */
-    aliases: Record<string, string>;
+/** Monotonic interpretation revision. */
+version: number;
+/** Exact legacy author spelling to canonical harness namespace. */
+aliases: Record<string, string>;
 }
 /** Privacy-safe vocabulary projection used by config get/list/export. */
 export interface AgentIdentityVocabularySummary {
-    /** Current interpretation revision. */
-    version: number;
-    /** Number of exact legacy spellings configured. */
-    alias_count: number;
+/** Current interpretation revision. */
+version: number;
+/** Number of exact legacy spellings configured. */
+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;
-    /** Exact legacy spelling required by add/remove. */
-    legacy_author?: string;
-    /** Canonical lowercase harness namespace required by add. */
-    canonical_harness?: string;
-    /** Optional bounded author census used only to count still-unmapped values. */
-    observed_authors?: readonly string[];
+/** Exact operation applied to the vocabulary. */
+operation: AgentIdentityVocabularyOperation;
+/** Exact legacy spelling required by add/remove. */
+legacy_author?: string;
+/** Canonical lowercase harness namespace required by add. */
+canonical_harness?: string;
+/** Optional bounded author census used only to count still-unmapped values. */
+observed_authors?: readonly string[];
 }
 /** Privacy-safe dry-run or committed mutation preview. */
 export interface AgentIdentityVocabularyMutationPreview {
-    /** Operation that was evaluated. */
-    operation: AgentIdentityVocabularyOperation;
-    /** Whether persistence would change. */
-    changed: boolean;
-    /** Revision before the operation. */
-    version_before: number;
-    /** Revision after the operation, equal when idempotent. */
-    version_after: number;
-    /** Alias count after the operation. */
-    alias_count: number;
-    /** Unique non-canonical authors not covered after the operation. */
-    residual_author_count: number;
+/** Operation that was evaluated. */
+operation: AgentIdentityVocabularyOperation;
+/** Whether persistence would change. */
+changed: boolean;
+/** Revision before the operation. */
+version_before: number;
+/** Revision after the operation, equal when idempotent. */
+version_after: number;
+/** Alias count after the operation. */
+alias_count: number;
+/** Unique non-canonical authors not covered after the operation. */
+residual_author_count: number;
 }
 /** Planned vocabulary plus a privacy-safe result preview. */
 export interface AgentIdentityVocabularyMutationPlan {
-    /** Complete value suitable for settings persistence. */
-    vocabulary: AgentIdentityVocabulary;
-    /** Public mutation result with no alias spellings. */
-    preview: AgentIdentityVocabularyMutationPreview;
+/** Complete value suitable for settings persistence. */
+vocabulary: AgentIdentityVocabulary;
+/** Public mutation result with no alias spellings. */
+preview: AgentIdentityVocabularyMutationPreview;
 }
 /** Return only the revision and count suitable for config discovery surfaces. */
 export declare function summarizeAgentIdentityVocabulary(vocabulary: AgentIdentityVocabulary | undefined): AgentIdentityVocabularySummary;

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

@@ -1,13 +1,13 @@
 /** Result of normalizing one item-addressed invocation. */
 export interface ItemAddressInvocationResult {
-    /** Canonical argv with an `--id` value moved into positional-id location. */
-    argv: string[];
-    /** Whether argv changed. */
-    changed: boolean;
-    /** Whether both positional and named item ids were supplied. */
-    conflict: boolean;
-    /** Resolved named item id when one was present. */
-    itemId?: string;
+/** Canonical argv with an `--id` value moved into positional-id location. */
+argv: string[];
+/** Whether argv changed. */
+changed: boolean;
+/** Whether both positional and named item ids were supplied. */
+conflict: boolean;
+/** Resolved named item id when one was present. */
+itemId?: string;
 }
 /** Return whether a command participates in the shared item-id alias contract. */
 export declare function supportsItemIdAlias(commandName: string | undefined): boolean;

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

@@ -12,37 +12,37 @@ import type { PmGrammarRefusalContract } from "./refusal-corpus-contracts.js";
 export type PmRefusalEvidenceKind = "owned_state" | "closed_domain" | "grammar";
 /** One complete-catalog closure row. */
 export interface PmRefusalClosureCensusRow {
-    /** Declared machine-readable error code. */
-    code: string;
-    /** Canonical compatibility-group code. */
-    canonical_code: string;
-    /** Whether at least one executable probe reaches the compatibility group. */
-    disposition: "executable" | "uncovered";
-    /** Evidence families contributing executable probes. */
-    evidence_kinds: PmRefusalEvidenceKind[];
-    /** Stable executable probe identities. */
-    probe_ids: string[];
+/** Declared machine-readable error code. */
+code: string;
+/** Canonical compatibility-group code. */
+canonical_code: string;
+/** Whether at least one executable probe reaches the compatibility group. */
+disposition: "executable" | "uncovered";
+/** Evidence families contributing executable probes. */
+evidence_kinds: PmRefusalEvidenceKind[];
+/** Stable executable probe identities. */
+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;
-    /** Number of emitted codes in the catalog. */
-    catalog_error_code_count: number;
-    /** Number of codes backed by executable evidence. */
-    executable_error_code_count: number;
-    /** Number of codes still lacking executable evidence. */
-    uncovered_error_code_count: number;
-    /** Executable codes divided by all catalog codes. */
-    coverage_fraction: number;
-    /** Number of closed-domain probes joined into the census. */
-    closed_domain_probe_count: number;
-    /** Number of grammar-derived probes joined into the census. */
-    grammar_probe_count: number;
-    /** Stable complete list of codes without executable evidence. */
-    uncovered_error_codes: string[];
-    /** Exactly one row for every catalog code. */
-    rows: PmRefusalClosureCensusRow[];
+/** True only when every catalog code belongs to a probed compatibility group. */
+ok: boolean;
+/** Number of emitted codes in the catalog. */
+catalog_error_code_count: number;
+/** Number of codes backed by executable evidence. */
+executable_error_code_count: number;
+/** Number of codes still lacking executable evidence. */
+uncovered_error_code_count: number;
+/** Executable codes divided by all catalog codes. */
+coverage_fraction: number;
+/** Number of closed-domain probes joined into the census. */
+closed_domain_probe_count: number;
+/** Number of grammar-derived probes joined into the census. */
+grammar_probe_count: number;
+/** Stable complete list of codes without executable evidence. */
+uncovered_error_codes: string[];
+/** Exactly one row for every catalog code. */
+rows: PmRefusalClosureCensusRow[];
 }
 /** @deprecated Historical v1 floor retained for SDK compatibility. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
@@ -54,15 +54,15 @@ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
 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;
+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[];
+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;

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

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

@@ -1,69 +1,69 @@
 import { type PmCommandPositionalContract } from "../cli-contracts/grammar-contracts.js";
 /** 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;
-    /** Canonical command path under test. */
-    command: string;
-    /** Exact argv expected to refuse. */
-    refusal_args: readonly string[];
-    /** Exact help argv that must execute successfully after the refusal. */
-    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";
+/** Stable probe identity used by ratchets and evidence. */
+probe_id: string;
+/** Canonical command path under test. */
+command: string;
+/** Exact argv expected to refuse. */
+refusal_args: readonly string[];
+/** Exact help argv that must execute successfully after the refusal. */
+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";
 }
 /** 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;
-    /** Zero-based slot index in the command's declared positional signature. */
-    missing_argument_index: number;
+/** Stable positional name deliberately omitted by the probe. */
+missing_argument: string;
+/** Zero-based slot index in the command's declared positional signature. */
+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;
-    /** Complete authoritative action domain expected in recovery. */
-    allowed_values: readonly string[];
+/** Invalid action token used to reach the refusal. */
+rejected_value: string;
+/** Complete authoritative action domain expected in recovery. */
+allowed_values: readonly string[];
 }
 /** Runtime evidence for one grammar-derived refusal probe. */
 export interface PmGrammarRefusalObservation {
-    /** Probe identity matching a declared contract. */
-    probe_id: string;
-    /** Machine-readable code emitted by the refusal. */
-    error_code: string;
-    /** Process exit code emitted by the refusal. */
-    exit_code: number;
-    /** Allowed values emitted for a closed action family. */
-    allowed_values: readonly string[];
-    /** Whether the advertised help recovery exited successfully. */
-    recovery_succeeded: boolean;
-    /** Whether any tracker state changed while executing the refusal. */
-    refusal_mutated_state: boolean;
-    /** Repository-relative tracker paths changed by the refusal, when measured. */
-    mutated_paths?: readonly string[];
+/** Probe identity matching a declared contract. */
+probe_id: string;
+/** Machine-readable code emitted by the refusal. */
+error_code: string;
+/** Process exit code emitted by the refusal. */
+exit_code: number;
+/** Allowed values emitted for a closed action family. */
+allowed_values: readonly string[];
+/** Whether the advertised help recovery exited successfully. */
+recovery_succeeded: boolean;
+/** Whether any tracker state changed while executing the refusal. */
+refusal_mutated_state: boolean;
+/** Repository-relative tracker paths changed by the refusal, when measured. */
+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;
-    /** Probe associated with the finding. */
-    probe_id: string;
-    /** Human-readable failure detail. */
-    detail: string;
+/** Stable machine-readable failure category. */
+code: PmGrammarRefusalFindingCode;
+/** Probe associated with the finding. */
+probe_id: string;
+/** Human-readable failure detail. */
+detail: string;
 }
 /** Aggregate closure receipt for the grammar-derived refusal corpus. */
 export interface PmGrammarRefusalClosureReport {
-    /** Whether every declared probe refused safely and recovered. */
-    ok: boolean;
-    /** Number of declared probes. */
-    probe_count: number;
-    /** Number of probes without findings. */
-    closed_probe_count: number;
-    /** Stable actionable failures. */
-    findings: PmGrammarRefusalFinding[];
+/** Whether every declared probe refused safely and recovered. */
+ok: boolean;
+/** Number of declared probes. */
+probe_count: number;
+/** Number of probes without findings. */
+closed_probe_count: number;
+/** Stable actionable failures. */
+findings: PmGrammarRefusalFinding[];
 }
 /**
  * Return one omission probe for every required slot in the declared grammar.