@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/core/shared/author.d.ts

@@ -9,16 +9,16 @@ export declare const AGENT_PROVENANCE_DIMENSIONS: readonly ["model", "effort", "
 export type AgentProvenanceResolver = "ai_agent_version" | "claude_session_file" | "codex_session_file";
 /** One bounded provenance value and the signal class that supplied it. */
 export interface AgentProvenanceObservation {
-    /** Bounded descriptive value retained in local history. */
-    value: string;
-    /** Signal class that supplied the value. */
-    source: AgentModelSource;
-    /** Confidence attached to a semantic inference. */
-    confidence?: "high" | "medium" | "low";
-    /** Versioned inference rule when the value was derived. */
-    rule_version?: "v2";
-    /** Bounded item and lineage references supporting an inference. */
-    evidence?: readonly string[];
+/** Bounded descriptive value retained in local history. */
+value: string;
+/** Signal class that supplied the value. */
+source: AgentModelSource;
+/** Confidence attached to a semantic inference. */
+confidence?: "high" | "medium" | "low";
+/** Versioned inference rule when the value was derived. */
+rule_version?: "v2";
+/** Bounded item and lineage references supporting an inference. */
+evidence?: readonly string[];
 }
 /**
  * Extensible provenance dimensions. A null value explicitly means that the
@@ -29,147 +29,147 @@ export type AgentProvenance = Readonly<Record<string, AgentProvenanceObservation
 export type AgentProvenanceAbsenceReason = "harness_unavailable" | "resolver_input_missing" | "resolver_failed" | "resolver_not_configured" | "probes_disabled" | "invalid_value";
 /** Machine-readable resolution outcome for one provenance dimension. */
 export interface AgentProvenanceOutcome {
-    /** Whether the dimension resolved without retaining private source material. */
-    status: "resolved" | "unavailable" | "not_configured" | "failed";
-    /** Stable bounded reason for absent or rejected values. */
-    reason?: AgentProvenanceAbsenceReason;
-    /** Resolver name when a bounded local resolver was attempted. */
-    resolver?: AgentProvenanceResolver;
-    /** Stable inference contract version used by downstream analytics. */
-    rule_version: "v1";
+/** Whether the dimension resolved without retaining private source material. */
+status: "resolved" | "unavailable" | "not_configured" | "failed";
+/** Stable bounded reason for absent or rejected values. */
+reason?: AgentProvenanceAbsenceReason;
+/** Resolver name when a bounded local resolver was attempted. */
+resolver?: AgentProvenanceResolver;
+/** Stable inference contract version used by downstream analytics. */
+rule_version: "v1";
 }
 /** Privacy-bounded MCP client metadata that can participate in agent detection. */
 export interface AgentClientInfo {
-    /** Client or harness name reported during protocol initialization. */
-    name: string;
-    /** Optional client version retained only as an input signal. */
-    version?: string;
-    /** Optional model identifier reported by a trusted embedding host. */
-    model?: string;
-    /** Optional invocation/session identifier reported by an embedding host. */
-    session?: string;
-    /** Optional descriptive provenance supplied by an embedding host. */
-    provenance?: Readonly<Record<string, string | undefined>>;
-    /** Optional episode declaration supplied by an embedding host. */
-    episode?: AgentEpisodeIdentity;
+/** Client or harness name reported during protocol initialization. */
+name: string;
+/** Optional client version retained only as an input signal. */
+version?: string;
+/** Optional model identifier reported by a trusted embedding host. */
+model?: string;
+/** Optional invocation/session identifier reported by an embedding host. */
+session?: string;
+/** Optional descriptive provenance supplied by an embedding host. */
+provenance?: Readonly<Record<string, string | undefined>>;
+/** Optional episode declaration supplied by an embedding host. */
+episode?: AgentEpisodeIdentity;
 }
 /** Declarative, side-effect-free signal definition for one agent harness. */
 export interface HarnessSignalDescriptor {
-    /** Stable lowercase namespace written to provenance fields. */
-    harness: string;
-    /** Environment keys whose non-blank presence identifies the harness. */
-    environment_keys?: readonly string[];
-    /** Environment keys checked in order for a model identifier. */
-    model_environment_keys?: readonly string[];
-    /** Environment keys checked in order for an invocation/session identifier. */
-    session_environment_keys?: readonly string[];
-    /** Extensible provenance dimension to ordered environment-key mappings. */
-    provenance_environment_keys?: Readonly<Record<string, readonly string[] | undefined>>;
-    /** Provenance dimensions mapped to audited built-in local resolvers. */
-    provenance_resolvers?: Readonly<Record<string, AgentProvenanceResolver | undefined>>;
-    /** Dimensions the harness is known not to expose through environment keys. */
-    provenance_unavailable_dimensions?: readonly string[];
-    /** Literal, case-insensitive executable or argument markers. */
-    argv_markers?: readonly string[];
-    /** Literal, case-insensitive MCP client-name markers. */
-    client_names?: readonly string[];
+/** Stable lowercase namespace written to provenance fields. */
+harness: string;
+/** Environment keys whose non-blank presence identifies the harness. */
+environment_keys?: readonly string[];
+/** Environment keys checked in order for a model identifier. */
+model_environment_keys?: readonly string[];
+/** Environment keys checked in order for an invocation/session identifier. */
+session_environment_keys?: readonly string[];
+/** Extensible provenance dimension to ordered environment-key mappings. */
+provenance_environment_keys?: Readonly<Record<string, readonly string[] | undefined>>;
+/** Provenance dimensions mapped to audited built-in local resolvers. */
+provenance_resolvers?: Readonly<Record<string, AgentProvenanceResolver | undefined>>;
+/** Dimensions the harness is known not to expose through environment keys. */
+provenance_unavailable_dimensions?: readonly string[];
+/** Literal, case-insensitive executable or argument markers. */
+argv_markers?: readonly string[];
+/** Literal, case-insensitive MCP client-name markers. */
+client_names?: readonly string[];
 }
 /** Versioned package-replaceable provenance contract for one agent harness. */
 export interface AgentProvenanceAdapter {
-    /** Public adapter contract revision. */
-    contract_version: 1;
-    /** Adapter implementation revision supplied by pm or a package. */
-    adapter_version: string;
-    /** Explicit replacement precedence; built-ins use zero. */
-    priority: number;
-    /** Stable lowercase harness namespace. */
-    harness: string;
-    /** Executable detection and provenance descriptor. */
-    descriptor: HarnessSignalDescriptor;
-    /** Provenance dimensions intentionally covered by the adapter. */
-    supported_dimensions: readonly string[];
-    /** Privacy classes the adapter may inspect. */
-    native_sources: readonly ("environment" | "argv" | "mcp_client" | "session_file")[];
-    /** Hard bounds shared by runtime probes and package review. */
-    probe_policy: {
-        max_bytes: number;
-        max_lines: number;
-        network_access: false;
-        subprocess_access: false;
-    };
-    /** Stable normalization vocabulary declarations. */
-    normalization: {
-        model_family: "v1";
-        effort: "v1";
-        preserve_raw: true;
-    };
-    /** Confidence of a value read directly from the declared sources. */
-    confidence: "high" | "medium" | "low";
-    /** Bounded reasons for intentionally uncovered dimensions. */
-    waivers?: Readonly<Record<string, string>>;
+/** Public adapter contract revision. */
+contract_version: 1;
+/** Adapter implementation revision supplied by pm or a package. */
+adapter_version: string;
+/** Explicit replacement precedence; built-ins use zero. */
+priority: number;
+/** Stable lowercase harness namespace. */
+harness: string;
+/** Executable detection and provenance descriptor. */
+descriptor: HarnessSignalDescriptor;
+/** Provenance dimensions intentionally covered by the adapter. */
+supported_dimensions: readonly string[];
+/** Privacy classes the adapter may inspect. */
+native_sources: readonly ("environment" | "argv" | "mcp_client" | "session_file")[];
+/** Hard bounds shared by runtime probes and package review. */
+probe_policy: {
+max_bytes: number;
+max_lines: number;
+network_access: false;
+subprocess_access: false;
+};
+/** Stable normalization vocabulary declarations. */
+normalization: {
+model_family: "v1";
+effort: "v1";
+preserve_raw: true;
+};
+/** Confidence of a value read directly from the declared sources. */
+confidence: "high" | "medium" | "low";
+/** Bounded reasons for intentionally uncovered dimensions. */
+waivers?: Readonly<Record<string, string>>;
 }
 /** One raw and normalized adapter value with its stable vocabulary revision. */
 export interface NormalizedAgentProvenanceAdapterValue {
-    /** Bounded value retained exactly as observed. */
-    raw: string;
-    /** Stable cross-harness family or vocabulary value. */
-    normalized: string;
-    /** Normalization vocabulary revision. */
-    vocabulary: "v1";
+/** Bounded value retained exactly as observed. */
+raw: string;
+/** Stable cross-harness family or vocabulary value. */
+normalized: string;
+/** Normalization vocabulary revision. */
+vocabulary: "v1";
 }
 /** Public, privacy-safe agent observation shared by CLI, SDK, and MCP hosts. */
 export interface DetectedAgentIdentity {
-    /** Normalized harness namespace when automatic detection succeeded. */
-    harness?: string;
-    /** Model identifier observed from a bounded runtime signal. */
-    model?: string;
-    /** Signal class that supplied `model`. */
-    model_source?: AgentModelSource;
-    /** Transient invocation/session identifier available only to the current host. */
-    session?: string;
-    /** Privacy-safe stable fingerprint for the current harness invocation. */
-    instance?: string;
-    /** Extensible local-only descriptive provenance observations. */
-    provenance?: AgentProvenance;
-    /** Stable declared episode identity when the session supplied one. */
-    episode?: AgentEpisodeIdentity;
+/** Normalized harness namespace when automatic detection succeeded. */
+harness?: string;
+/** Model identifier observed from a bounded runtime signal. */
+model?: string;
+/** Signal class that supplied `model`. */
+model_source?: AgentModelSource;
+/** Transient invocation/session identifier available only to the current host. */
+session?: string;
+/** Privacy-safe stable fingerprint for the current harness invocation. */
+instance?: string;
+/** Extensible local-only descriptive provenance observations. */
+provenance?: AgentProvenance;
+/** Stable declared episode identity when the session supplied one. */
+episode?: AgentEpisodeIdentity;
 }
 /** Agent identity plus explicit outcomes for every built-in provenance dimension. */
 export interface DiagnosedAgentIdentity extends DetectedAgentIdentity {
-    /** Resolution outcomes that distinguish absence from resolver failure. */
-    provenance_outcomes: Readonly<Record<string, AgentProvenanceOutcome>>;
+/** Resolution outcomes that distinguish absence from resolver failure. */
+provenance_outcomes: Readonly<Record<string, AgentProvenanceOutcome>>;
 }
 /** Public, privacy-safe identity resolution result shared by CLI and SDK hosts. */
 export interface ResolvedAuthorIdentity extends DetectedAgentIdentity {
-    /** Stable author value written to mutation history. */
-    author: string;
-    /** How the effective author was selected. */
-    source: AuthorSource;
+/** Stable author value written to mutation history. */
+author: string;
+/** How the effective author was selected. */
+source: AuthorSource;
 }
 /** Bounded runtime signals accepted by the pure harness detector. */
 export interface HarnessDetectionSignals {
-    /** Environment names and values supplied by the embedding runtime. */
-    env?: Readonly<Record<string, string | undefined>>;
-    /** Executable and argument tokens for the current process. */
-    argv?: readonly string[];
-    /** Optional parent-process labels supplied by a host that already knows them. */
-    process_labels?: readonly string[];
-    /** Optional protocol client metadata supplied by an MCP or SDK host. */
-    client_info?: AgentClientInfo;
-    /** Invocation metadata supplied directly by an embedding host. */
-    provenance?: Readonly<Record<string, string | undefined>>;
-    /** Session-wide semantic context supplied by an embedding host. */
-    session_context?: AgentSessionContext;
-    /** Invocation-local descriptors appended after built-in and package signals. */
-    descriptors?: readonly HarnessSignalDescriptor[];
-    /** Disable local provenance probes for this invocation. */
-    probes_enabled?: boolean;
-    /** Working directory used to derive harness-owned session paths. */
-    cwd?: string;
-    /** Home directory override used by embedders and isolated tests. */
-    home_dir?: string;
-    /** Explicit harness-owned session file supplied by an embedding host. */
-    session_file?: string;
+/** Environment names and values supplied by the embedding runtime. */
+env?: Readonly<Record<string, string | undefined>>;
+/** Executable and argument tokens for the current process. */
+argv?: readonly string[];
+/** Optional parent-process labels supplied by a host that already knows them. */
+process_labels?: readonly string[];
+/** Optional protocol client metadata supplied by an MCP or SDK host. */
+client_info?: AgentClientInfo;
+/** Invocation metadata supplied directly by an embedding host. */
+provenance?: Readonly<Record<string, string | undefined>>;
+/** Session-wide semantic context supplied by an embedding host. */
+session_context?: AgentSessionContext;
+/** Invocation-local descriptors appended after built-in and package signals. */
+descriptors?: readonly HarnessSignalDescriptor[];
+/** Disable local provenance probes for this invocation. */
+probes_enabled?: boolean;
+/** Working directory used to derive harness-owned session paths. */
+cwd?: string;
+/** Home directory override used by embedders and isolated tests. */
+home_dir?: string;
+/** Explicit harness-owned session file supplied by an embedding host. */
+session_file?: string;
 }
 /** Built-in agent descriptors evaluated before package and workspace additions. */
 export declare const BUILTIN_HARNESS_SIGNAL_DESCRIPTORS: readonly HarnessSignalDescriptor[];
@@ -196,7 +196,7 @@ export declare function normalizeAgentProvenanceAdapterValue(dimension: "model"
 export declare function runWithHarnessDetectionSignals<T>(signals: HarnessDetectionSignals, callback: () => T): T;
 /** Run one invocation with workspace-provided descriptors available downstream. */
 export declare function runWithWorkspaceHarnessSignalDescriptors<T>(descriptors: readonly HarnessSignalDescriptor[], callback: () => T, options?: {
-    probesEnabled?: boolean;
+probesEnabled?: boolean;
 }): T;
 /**
  * Detect structured agent provenance from bounded caller-supplied signals.

package/dist/core/shared/command-types.d.ts

@@ -5,44 +5,44 @@
  */
 /** Carries process-wide CLI options shared by command handlers and runtime adapters. */
 export interface GlobalOptions {
-    /** Value that configures or reports json for this contract. */
-    json?: boolean;
-    /** Value that configures or reports quiet for this contract. */
-    quiet?: boolean;
-    /** Value that configures or reports no changed fields for this contract. */
-    noChangedFields?: boolean;
-    /** Preserve the legacy full mutation envelope and changed-fields array. */
-    fullChangedFields?: boolean;
-    /** Value that configures or reports id only for this contract. */
-    idOnly?: boolean;
-    /** Omit null and empty containers from JSON output. */
-    lean?: boolean;
-    /** Attach a bounded receipt attributing the emitted output token cost. */
-    tokenAccounting?: boolean;
-    /** Canonical comma-separated fields or sections retained in read output. */
-    outputInclude?: string;
-    /** Canonical maximum row count retained in read output. */
-    outputLimit?: string;
-    /** Canonical estimated-token ceiling for read output. */
-    outputBudget?: string;
-    /** Canonical renderer encoding for read output. */
-    outputFormat?: "toon" | "json";
-    /** Caller-carried cross-call budget and served-item state. */
-    outputSession?: string;
-    /** Opaque budget-compaction continuation cursor. */
-    outputCursor?: string;
-    /** Include the machine-readable row selector and TOON encoding contract. */
-    outputRowContract?: boolean;
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
-    /** Value that configures or reports no pager for this contract. */
-    noPager?: boolean;
-    /** Value that configures or reports profile for this contract. */
-    profile?: boolean;
-    /** Invocation-wide mutation author override. */
-    author?: string;
-    /** Fallback output format used when callers do not provide an override. */
-    defaultOutputFormat?: "toon" | "json";
+/** Value that configures or reports json for this contract. */
+json?: boolean;
+/** Value that configures or reports quiet for this contract. */
+quiet?: boolean;
+/** Value that configures or reports no changed fields for this contract. */
+noChangedFields?: boolean;
+/** Preserve the legacy full mutation envelope and changed-fields array. */
+fullChangedFields?: boolean;
+/** Value that configures or reports id only for this contract. */
+idOnly?: boolean;
+/** Omit null and empty containers from JSON output. */
+lean?: boolean;
+/** Attach a bounded receipt attributing the emitted output token cost. */
+tokenAccounting?: boolean;
+/** Canonical comma-separated fields or sections retained in read output. */
+outputInclude?: string;
+/** Canonical maximum row count retained in read output. */
+outputLimit?: string;
+/** Canonical estimated-token ceiling for read output. */
+outputBudget?: string;
+/** Canonical renderer encoding for read output. */
+outputFormat?: "toon" | "json";
+/** Caller-carried cross-call budget and served-item state. */
+outputSession?: string;
+/** Opaque budget-compaction continuation cursor. */
+outputCursor?: string;
+/** Include the machine-readable row selector and TOON encoding contract. */
+outputRowContract?: boolean;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions?: boolean;
+/** Value that configures or reports no pager for this contract. */
+noPager?: boolean;
+/** Value that configures or reports profile for this contract. */
+profile?: boolean;
+/** Invocation-wide mutation author override. */
+author?: string;
+/** Fallback output format used when callers do not provide an override. */
+defaultOutputFormat?: "toon" | "json";
 }

package/dist/core/shared/conflict-markers.d.ts

@@ -5,12 +5,12 @@
  */
 /** Describes a detected unresolved merge-conflict marker and its source location. */
 export interface ConflictMarkerMatch {
-    /** Value that configures or reports line for this contract. */
-    line: number;
-    /** Value that configures or reports marker for this contract. */
-    marker: "<<<<<<<" | "=======" | ">>>>>>>";
-    /** Value that configures or reports text for this contract. */
-    text: string;
+/** Value that configures or reports line for this contract. */
+line: number;
+/** Value that configures or reports marker for this contract. */
+marker: "<<<<<<<" | "=======" | ">>>>>>>";
+/** Value that configures or reports text for this contract. */
+text: string;
 }
 /** Implements find merge conflict markers for the public runtime surface of this module. */
 export declare function findMergeConflictMarkers(content: string): ConflictMarkerMatch[];

package/dist/core/shared/constants.d.ts

@@ -36,27 +36,27 @@ export declare const GOVERNANCE_PRESET_DEFAULTS: Record<BuiltinGovernancePreset,
 export declare const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS: readonly ["no active blocker", "ready for planned execution sequencing", "work completed", "work is closed"];
 /** Fallback validate closure like metadata field patterns used when callers do not provide an override. */
 export declare const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS: {
-    readonly blocked_reason: readonly ["no active blocker because work is closed", "work is closed"];
-    readonly resolution: readonly ["closed with implementation evidence", "closed with verification evidence", "work completed and recorded", "work is closed"];
-    readonly actual_result: readonly ["closed and recorded", "work completed", "work completed and recorded"];
+readonly blocked_reason: readonly ["no active blocker because work is closed", "work is closed"];
+readonly resolution: readonly ["closed with implementation evidence", "closed with verification evidence", "work completed and recorded", "work is closed"];
+readonly actual_result: readonly ["closed and recorded", "work completed", "work completed and recorded"];
 };
 /** Public contract for settings defaults, shared by SDK and presentation-layer consumers. */
 export declare const SETTINGS_DEFAULTS: PmSettings;
 /** Public contract for empty canonical document, shared by SDK and presentation-layer consumers. */
 export declare const EMPTY_CANONICAL_DOCUMENT: {
-    metadata: {};
-    body: string;
+metadata: {};
+body: string;
 };
 /** Public contract for exit code, shared by SDK and presentation-layer consumers. */
 export declare const EXIT_CODE: {
-    readonly SUCCESS: 0;
-    readonly GENERIC_FAILURE: 1;
-    readonly USAGE: 2;
-    readonly NOT_FOUND: 3;
-    readonly CONFLICT: 4;
-    readonly DEPENDENCY_FAILED: 5;
-    readonly NO_EFFECT: 6;
-    readonly PARTIAL_EFFECT: 7;
+readonly SUCCESS: 0;
+readonly GENERIC_FAILURE: 1;
+readonly USAGE: 2;
+readonly NOT_FOUND: 3;
+readonly CONFLICT: 4;
+readonly DEPENDENCY_FAILED: 5;
+readonly NO_EFFECT: 6;
+readonly PARTIAL_EFFECT: 7;
 };
 /** Restricts telemetry error category values accepted by command, SDK, and storage contracts. */
 export type TelemetryErrorCategory = "usage" | "validation" | "conflict" | "runtime" | "unknown";