@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/agent/tracker-preflight-contracts.d.ts

@@ -9,53 +9,53 @@ export type PmTrackerPreflightFailureKind = "missing_root" | "settings_missing"
 export type PmTrackerPreflightRecoveryKind = "initialize" | "select_directory" | "repair_permissions";
 /** Static refusal and recovery obligation for one tracker filesystem state. */
 export interface PmTrackerPreflightRecoveryContract {
-    /** Stable probe identifier used by repository gates and evidence. */
-    probe_id: string;
-    /** Filesystem state created by the executable probe. */
-    failure_kind: PmTrackerPreflightFailureKind;
-    /** Stable structured error code required from CLI and SDK transports. */
-    expected_error_code: string;
-    /** Process exit code required from the CLI transport. */
-    expected_exit_code: 1 | 2 | 3;
-    /** Safe recovery behavior for this filesystem state. */
-    recovery_kind: PmTrackerPreflightRecoveryKind;
+/** Stable probe identifier used by repository gates and evidence. */
+probe_id: string;
+/** Filesystem state created by the executable probe. */
+failure_kind: PmTrackerPreflightFailureKind;
+/** Stable structured error code required from CLI and SDK transports. */
+expected_error_code: string;
+/** Process exit code required from the CLI transport. */
+expected_exit_code: 1 | 2 | 3;
+/** Safe recovery behavior for this filesystem state. */
+recovery_kind: PmTrackerPreflightRecoveryKind;
 }
 /** Runtime evidence captured from one executable tracker preflight probe. */
 export interface PmTrackerPreflightRecoveryObservation {
-    /** Stable probe identifier from the corresponding contract. */
-    probe_id: string;
-    /** Structured error code emitted by the refusal. */
-    error_code: string;
-    /** Process exit code emitted by the refusal. */
-    exit_code: number;
-    /** Recovery behavior exercised by the probe driver. */
-    recovery_kind: PmTrackerPreflightRecoveryKind;
-    /** Tokenized retry emitted by the refusal, or an empty list when no deterministic retry is safe. */
-    suggested_retry_args: string[];
-    /** Whether the emitted retry or safe alternate-root retry executed successfully. */
-    retry_succeeded: boolean;
-    /** Whether a file-path refusal incorrectly recommended tracker initialization. */
-    unsafe_init_recommended: boolean;
+/** Stable probe identifier from the corresponding contract. */
+probe_id: string;
+/** Structured error code emitted by the refusal. */
+error_code: string;
+/** Process exit code emitted by the refusal. */
+exit_code: number;
+/** Recovery behavior exercised by the probe driver. */
+recovery_kind: PmTrackerPreflightRecoveryKind;
+/** Tokenized retry emitted by the refusal, or an empty list when no deterministic retry is safe. */
+suggested_retry_args: string[];
+/** Whether the emitted retry or safe alternate-root retry executed successfully. */
+retry_succeeded: boolean;
+/** Whether a file-path refusal incorrectly recommended tracker initialization. */
+unsafe_init_recommended: boolean;
 }
 /** Actionable failure emitted by the tracker preflight closure scorer. */
 export interface PmTrackerPreflightRecoveryFinding {
-    /** Stable finding code for automation and ratchets. */
-    code: "missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
-    /** Probe that failed its recovery obligation. */
-    probe_id: string;
-    /** Human-readable explanation of the failed obligation. */
-    detail: string;
+/** Stable finding code for automation and ratchets. */
+code: "missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
+/** Probe that failed its recovery obligation. */
+probe_id: string;
+/** Human-readable explanation of the failed obligation. */
+detail: string;
 }
 /** Aggregate executable-closure report for the tracker preflight corpus. */
 export interface PmTrackerPreflightRecoveryReport {
-    /** Whether every declared probe met its refusal and recovery contract. */
-    ok: boolean;
-    /** Number of declared tracker preflight probes. */
-    probe_count: number;
-    /** Number of probes with no findings. */
-    closed_probe_count: number;
-    /** Deterministically ordered failed obligations. */
-    findings: PmTrackerPreflightRecoveryFinding[];
+/** Whether every declared probe met its refusal and recovery contract. */
+ok: boolean;
+/** Number of declared tracker preflight probes. */
+probe_count: number;
+/** Number of probes with no findings. */
+closed_probe_count: number;
+/** Deterministically ordered failed obligations. */
+findings: PmTrackerPreflightRecoveryFinding[];
 }
 /** Return defensive copies of every core tracker preflight recovery contract. */
 export declare function listTrackerPreflightRecoveryContracts(): PmTrackerPreflightRecoveryContract[];

package/dist/sdk/agent-capability-contracts.d.ts

@@ -5,22 +5,22 @@ export type PmCommandVisibilityTier = "core" | "standard" | "full" | "internal";
 export type PmCommandCapabilityFamily = ExtensionCommandCapabilityFamily;
 /** One command's canonical agent-surface visibility declaration. */
 export interface PmCommandVisibilityContract {
-    /** Canonical command path. */
-    command: string;
-    /** Minimum surface tier that advertises the command. */
-    tier: PmCommandVisibilityTier;
+/** Canonical command path. */
+command: string;
+/** Minimum surface tier that advertises the command. */
+tier: PmCommandVisibilityTier;
 }
 /** Complete command capability contract with visibility and family ownership. */
 export interface PmCommandCapabilityContract extends PmCommandVisibilityContract {
-    /** Exactly one stable capability family used to group the command. */
-    family: PmCommandCapabilityFamily;
+/** Exactly one stable capability family used to group the command. */
+family: PmCommandCapabilityFamily;
 }
 /** One generated family route shared by guides, skills, and documentation. */
 export interface PmCommandCapabilityGroup {
-    /** Stable capability family. */
-    family: PmCommandCapabilityFamily;
-    /** Non-internal commands owned by the family. */
-    commands: readonly string[];
+/** Stable capability family. */
+family: PmCommandCapabilityFamily;
+/** Non-internal commands owned by the family. */
+commands: readonly string[];
 }
 /** Resolve one command's stable capability family. */
 export declare function resolvePmCommandCapabilityFamily(command: string): PmCommandCapabilityFamily;
@@ -36,16 +36,16 @@ export declare const PM_COMMAND_CAPABILITY_CONTRACTS: readonly PmCommandCapabili
 export declare const PM_COMMAND_VISIBILITY_CONTRACTS: readonly PmCommandVisibilityContract[];
 /** Bounded compact-help contract: one conventional terminal screen. */
 export declare const PM_CORE_HELP_BUDGET: Readonly<{
-    max_lines: 50;
-    max_utf8_bytes: 6000;
+max_lines: 50;
+max_utf8_bytes: 6000;
 }>;
 /** Root options retained in the compact progressive-disclosure help screen. */
 export declare const PM_CORE_HELP_OPTION_FLAGS: readonly string[];
 /** Measure rendered core help against its line and byte ceilings. */
 export declare function measurePmCoreHelp(text: string): {
-    lines: number;
-    utf8_bytes: number;
-    within_budget: boolean;
+lines: number;
+utf8_bytes: number;
+within_budget: boolean;
 };
 /** Resolve one command's declared tier; extension commands default to standard. */
 export declare function resolvePmCommandVisibilityTier(command: string, extensionTier?: PmCommandVisibilityTier): PmCommandVisibilityTier;
@@ -69,36 +69,36 @@ export declare function listPmMcpToolsForProfile(availableTools: readonly string
 export declare function listPmMcpToolsForProfileFromContracts(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, "custom">, contracts: readonly PmCommandCapabilityContract[]): string[];
 /** Stable MCP resource contract generated from the same agent surface table. */
 export interface PmMcpResourceContract {
-    /** Stable resource URI. */
-    uri: string;
-    /** Human-readable resource name. */
-    name: string;
-    /** Agent-facing resource description. */
-    description: string;
-    /** Resource MIME type. */
-    mimeType: "application/json" | "text/markdown";
+/** Stable resource URI. */
+uri: string;
+/** Human-readable resource name. */
+name: string;
+/** Agent-facing resource description. */
+description: string;
+/** Resource MIME type. */
+mimeType: "application/json" | "text/markdown";
 }
 /** Addressable, bounded workspace context resources. */
 export declare const PM_MCP_RESOURCE_CONTRACTS: readonly PmMcpResourceContract[];
 /** One parameter accepted by a canonical MCP workflow prompt. */
 export interface PmMcpPromptArgumentContract {
-    /** Stable prompt argument name. */
-    name: string;
-    /** Argument description shown by the MCP host. */
-    description: string;
-    /** Whether the host must provide the argument. */
-    required: boolean;
+/** Stable prompt argument name. */
+name: string;
+/** Argument description shown by the MCP host. */
+description: string;
+/** Whether the host must provide the argument. */
+required: boolean;
 }
 /** Canonical MCP workflow prompt generated from the agent operating contract. */
 export interface PmMcpPromptContract {
-    /** Stable prompt name. */
-    name: string;
-    /** Agent-facing workflow description. */
-    description: string;
-    /** Parameters accepted by the workflow. */
-    arguments: readonly PmMcpPromptArgumentContract[];
-    /** Template rendered into a user message after argument substitution. */
-    template: string;
+/** Stable prompt name. */
+name: string;
+/** Agent-facing workflow description. */
+description: string;
+/** Parameters accepted by the workflow. */
+arguments: readonly PmMcpPromptArgumentContract[];
+/** Template rendered into a user message after argument substitution. */
+template: string;
 }
 /** Canonical orient, start, and evidence-close workflows. */
 export declare const PM_MCP_PROMPT_CONTRACTS: readonly PmMcpPromptContract[];

package/dist/sdk/annotations.d.ts

@@ -2,140 +2,140 @@ import type { GlobalOptions } from "../core/shared/command-types.js";
 import { mutateItem } from "../core/store/item-store.js";
 /** Common persisted shape shared by comments, notes, and learnings. */
 export interface AnnotationEntry {
-    /** Creation timestamp for the persisted entry. */
-    created_at: string;
-    /** Stable author attribution recorded with the entry. */
-    author: string;
-    /** Human-readable annotation body. */
-    text: string;
-    /** Last edit timestamp when the entry was changed in place. */
-    edited_at?: string;
+/** Creation timestamp for the persisted entry. */
+created_at: string;
+/** Stable author attribution recorded with the entry. */
+author: string;
+/** Human-readable annotation body. */
+text: string;
+/** Last edit timestamp when the entry was changed in place. */
+edited_at?: string;
 }
 /** Common options accepted by annotation primitive operations. */
 export interface AnnotationCommandOptions {
-    /** Maximum number of newest entries returned. */
-    limit?: string;
-    /** Author override for mutation attribution. */
-    author?: string;
-    /** Optional history message describing the mutation. */
-    message?: string;
-    /** Whether to override an active ownership conflict. */
-    force?: boolean;
-    /** Whether list results include paging metadata. */
-    includeMeta?: boolean;
-    /** Return the complete collection after a mutation instead of the bounded mutation receipt. */
-    fullHistory?: boolean;
-    /** Append only when no entry has the same resolved author and text. */
-    ifAbsent?: boolean;
+/** Maximum number of newest entries returned. */
+limit?: string;
+/** Author override for mutation attribution. */
+author?: string;
+/** Optional history message describing the mutation. */
+message?: string;
+/** Whether to override an active ownership conflict. */
+force?: boolean;
+/** Whether list results include paging metadata. */
+includeMeta?: boolean;
+/** Return the complete collection after a mutation instead of the bounded mutation receipt. */
+fullHistory?: boolean;
+/** Append only when no entry has the same resolved author and text. */
+ifAbsent?: boolean;
 }
 /** Identifies the single annotation mutation represented by a bounded response. */
 export interface AnnotationMutationReceipt {
-    /** Mutation applied to the annotation collection. */
-    action: "add" | "edit" | "delete";
-    /** Stable one-based collection position targeted by the mutation. */
-    entry_index: number;
-    /** Number of stored entries changed by the mutation attempt. */
-    changed_count: 0 | 1;
-    /** Whether the response includes the complete post-mutation collection. */
-    full_history_included: boolean;
+/** Mutation applied to the annotation collection. */
+action: "add" | "edit" | "delete";
+/** Stable one-based collection position targeted by the mutation. */
+entry_index: number;
+/** Number of stored entries changed by the mutation attempt. */
+changed_count: 0 | 1;
+/** Whether the response includes the complete post-mutation collection. */
+full_history_included: boolean;
 }
 /** Transport-neutral selectors that restore a complete annotation collection. */
 export interface AnnotationHistoryRestoration {
-    /** Stable semantic selector shared by every transport. */
-    selector: "full_history";
-    /** Equivalent CLI flag. */
-    cli_flag: "--full-history";
-    /** Equivalent direct SDK option. */
-    sdk_option: "fullHistory";
-    /** Equivalent MCP tool option. */
-    mcp_option: "full";
+/** Stable semantic selector shared by every transport. */
+selector: "full_history";
+/** Equivalent CLI flag. */
+cli_flag: "--full-history";
+/** Equivalent direct SDK option. */
+sdk_option: "fullHistory";
+/** Equivalent MCP tool option. */
+mcp_option: "full";
 }
 /** Describes annotation history withheld from a bounded mutation response. */
 export interface AnnotationOmissionReceipt {
-    /** Whether any historical collection entries were withheld. */
-    has_omissions: boolean;
-    /** Number of independently restorable field groups withheld. */
-    omitted_field_group_count: number;
-    /** Omitted groups and the transport-neutral selectors that restore them. */
-    omitted_field_groups: Array<{
-        name: string;
-        restore_with: AnnotationHistoryRestoration;
-    }>;
+/** Whether any historical collection entries were withheld. */
+has_omissions: boolean;
+/** Number of independently restorable field groups withheld. */
+omitted_field_group_count: number;
+/** Omitted groups and the transport-neutral selectors that restore them. */
+omitted_field_groups: Array<{
+name: string;
+restore_with: AnnotationHistoryRestoration;
+}>;
 }
 /** Map transport-level `full` onto the SDK annotation history option. */
 export declare function normalizeAnnotationTransportOptions(options: Record<string, unknown>): Record<string, unknown>;
 /** Presentation-layer inputs accepted by the shared annotation source resolver. */
 export interface AnnotationSourceOptions {
-    /** Inline annotation text or the stdin token (`-`). */
-    add?: string;
-    /** Read annotation text directly from stdin. */
-    stdin?: boolean;
-    /** Read annotation text from a UTF-8 file. */
-    file?: string;
-    /** One-based entry index to replace. */
-    edit?: number;
-    /** One-based entry index to delete. */
-    delete?: number;
+/** Inline annotation text or the stdin token (`-`). */
+add?: string;
+/** Read annotation text directly from stdin. */
+stdin?: boolean;
+/** Read annotation text from a UTF-8 file. */
+file?: string;
+/** One-based entry index to replace. */
+edit?: number;
+/** One-based entry index to delete. */
+delete?: number;
 }
 /** Normalized annotation operation supplied by a presentation layer. */
 export interface AnnotationInput {
-    /** Normalized operation selected by the presentation layer. */
-    mode: "list" | "add" | "stdin" | "file" | "edit" | "delete";
-    /** Resolved annotation text. */
-    value?: string;
-    /** Original input used for flag-like value validation. */
-    rawValue?: string;
-    /** Flag name used in validation messages. */
-    emptyFlag?: string;
-    /** One-based entry index for edit and delete operations. */
-    index?: number;
+/** Normalized operation selected by the presentation layer. */
+mode: "list" | "add" | "stdin" | "file" | "edit" | "delete";
+/** Resolved annotation text. */
+value?: string;
+/** Original input used for flag-like value validation. */
+rawValue?: string;
+/** Flag name used in validation messages. */
+emptyFlag?: string;
+/** One-based entry index for edit and delete operations. */
+index?: number;
 }
 /** Agent-facing recovery guidance for ownership conflicts. */
 export interface OwnershipConflictGuidance {
-    /** Actionable requirement shown to the caller. */
-    required: string;
-    /** Copyable retry examples. */
-    examples: string[];
-    /** Ordered recovery guidance. */
-    nextSteps: string[];
+/** Actionable requirement shown to the caller. */
+required: string;
+/** Copyable retry examples. */
+examples: string[];
+/** Ordered recovery guidance. */
+nextSteps: string[];
 }
 /** Domain configuration for one annotation collection primitive. */
 export interface AnnotationCommandConfig<TKey extends string, TEntry extends AnnotationEntry = AnnotationEntry> {
-    /** Normalized annotation operation. */
-    input: AnnotationInput;
-    /** Metadata collection that stores this annotation family. */
-    collectionKey: TKey;
-    /** History operation used for additions. */
-    op: Parameters<typeof mutateItem>[0]["op"];
-    /** History operation used for edits. */
-    editOp?: Parameters<typeof mutateItem>[0]["op"];
-    /** History operation used for deletions. */
-    deleteOp?: Parameters<typeof mutateItem>[0]["op"];
-    /** Domain parser that normalizes resolved text. */
-    parseText: (raw: string) => string;
-    /** Whether this operation may bypass ownership for a caller-authorized annotation workflow. */
-    bypassOwnershipConflict: boolean;
-    /** Recovery guidance for ownership conflicts. */
-    conflictGuidance: OwnershipConflictGuidance;
-    /** Entry factory that preserves or enriches the collection's typed annotation shape. */
-    createEntry: (input: {
-        created_at: string;
-        author: string;
-        text: string;
-    }) => TEntry;
+/** Normalized annotation operation. */
+input: AnnotationInput;
+/** Metadata collection that stores this annotation family. */
+collectionKey: TKey;
+/** History operation used for additions. */
+op: Parameters<typeof mutateItem>[0]["op"];
+/** History operation used for edits. */
+editOp?: Parameters<typeof mutateItem>[0]["op"];
+/** History operation used for deletions. */
+deleteOp?: Parameters<typeof mutateItem>[0]["op"];
+/** Domain parser that normalizes resolved text. */
+parseText: (raw: string) => string;
+/** Whether this operation may bypass ownership for a caller-authorized annotation workflow. */
+bypassOwnershipConflict: boolean;
+/** Recovery guidance for ownership conflicts. */
+conflictGuidance: OwnershipConflictGuidance;
+/** Entry factory that preserves or enriches the collection's typed annotation shape. */
+createEntry: (input: {
+created_at: string;
+author: string;
+text: string;
+}) => TEntry;
 }
 /** Structured result returned by an annotation primitive. */
 export type AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = {
-    id: string;
-    count: number;
+id: string;
+count: number;
 } & Record<TKey, TEntry[]> & {
-    total_count?: number;
-    returned_count?: number;
-    has_more?: boolean;
-    limit?: number;
-    mutation_receipt?: AnnotationMutationReceipt;
-    omission_receipt?: AnnotationOmissionReceipt;
-    changed?: boolean;
+total_count?: number;
+returned_count?: number;
+has_more?: boolean;
+limit?: number;
+mutation_receipt?: AnnotationMutationReceipt;
+omission_receipt?: AnnotationOmissionReceipt;
+changed?: boolean;
 };
 /** Implements limit annotation entries for the public runtime surface of this module. */
 export declare function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): TEntry[];
@@ -143,11 +143,11 @@ export declare function limitAnnotationEntries<TEntry>(values: TEntry[], limit:
 export declare function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[];
 /** Implements parse annotation text input for the public runtime surface of this module. */
 export declare function parseAnnotationTextInput(raw: string, options?: {
-    stripPlainTextPrefix?: boolean;
+stripPlainTextPrefix?: boolean;
 }): string;
 /** Returns whether an unknown file-system failure exposes an errno-like code. */
 export declare function isErrnoError(error: unknown): error is {
-    code?: unknown;
+code?: unknown;
 };
 /** Refuse presentation-level stdin directives when JSON-RPC owns the process stream. */
 export declare function assertAnnotationStdinTransportAvailable(options: AnnotationSourceOptions, optionName: string): void;