@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/core/search/vectorization-metadata.d.ts

@@ -1,14 +1,14 @@
 /** Documents the vectorization embedding identity payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationEmbeddingIdentity {
-    /** Value that configures or reports provider for this contract. */
-    provider: string;
-    /** Value that configures or reports model for this contract. */
-    model: string;
+/** Value that configures or reports provider for this contract. */
+provider: string;
+/** Value that configures or reports model for this contract. */
+model: string;
 }
 /** Documents the vectorization embedding metadata payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationEmbeddingMetadata extends VectorizationEmbeddingIdentity {
-    /** Value that configures or reports vector dimension for this contract. */
-    vector_dimension: number;
+/** Value that configures or reports vector dimension for this contract. */
+vector_dimension: number;
 }
 /** Implements build vectorization embedding identity for the public runtime surface of this module. */
 export declare function buildVectorizationEmbeddingIdentity(provider: unknown, model: unknown): VectorizationEmbeddingIdentity | null;

package/dist/core/sentry/helpers.d.ts

@@ -2,18 +2,18 @@ import { type TelemetryErrorCategory } from "../shared/constants.js";
 import { type TelemetryCommandResolution, type TelemetryResolutionStage } from "../telemetry/observability.js";
 /** Implements sentry set command context for the public runtime surface of this module. */
 export declare function sentrySetCommandContext(command: string, args: string[], options: Record<string, unknown>, metadata?: {
-    source_context?: string;
-    source_context_source?: string;
+source_context?: string;
+source_context_source?: string;
 }): void;
 /** Implements sentry start command span for the public runtime surface of this module. */
 export declare function sentryStartCommandSpan(command: string): void;
 /** Implements sentry finish command span for the public runtime surface of this module. */
 export declare function sentryFinishCommandSpan(ok: boolean, error?: string, metadata?: {
-    error_code?: string;
-    error_category?: TelemetryErrorCategory;
-    exit_code?: number;
-    command_resolution?: TelemetryCommandResolution;
-    resolution_stage?: TelemetryResolutionStage;
+error_code?: string;
+error_category?: TelemetryErrorCategory;
+exit_code?: number;
+command_resolution?: TelemetryCommandResolution;
+resolution_stage?: TelemetryResolutionStage;
 }): void;
 /**
  * Tag value recorded when a captured error declares no canonical pm error code.
@@ -29,14 +29,14 @@ export declare const UNCLASSIFIED_CAPTURED_ERROR_CODE = "unclassified_runtime_er
 export declare function sentryCaptureCliError(error: unknown): void;
 /** Implements sentry log cli usage error for the public runtime surface of this module. */
 export declare function sentryLogCliUsageError(params: {
-    command: string;
-    error_code: string;
-    error_category: TelemetryErrorCategory;
-    exit_code: number;
-    error_message: string;
-    command_resolution?: TelemetryCommandResolution;
-    resolution_stage?: TelemetryResolutionStage;
-    source_context?: string;
+command: string;
+error_code: string;
+error_category: TelemetryErrorCategory;
+exit_code: number;
+error_message: string;
+command_resolution?: TelemetryCommandResolution;
+resolution_stage?: TelemetryResolutionStage;
+source_context?: string;
 }): void;
 /** Implements should capture cli error for the public runtime surface of this module. */
 export declare function shouldCaptureCliError(error: unknown): boolean;

package/dist/core/sentry/instrument.d.ts

@@ -3,42 +3,42 @@ declare function scrubString(value: string, keyHint?: string): string;
 declare function scrubEventData(obj: Record<string, unknown>): Record<string, unknown>;
 type SentryLike = typeof SentryModuleTypes;
 declare function isKnownNoisyConsoleEvent(event: {
-    logger?: string;
-    message?: string;
-    exception?: {
-        values?: Array<{
-            value?: string;
-        }>;
-    };
+logger?: string;
+message?: string;
+exception?: {
+values?: Array<{
+value?: string;
+}>;
+};
 }): boolean;
 /** Detect handled Node listener-pressure warnings captured through console stderr. */
 declare function isNodeRuntimeWarningEvent(event: {
-    logger?: string;
-    message?: string;
-    exception?: {
-        values?: Array<{
-            value?: string;
-        }>;
-    };
+logger?: string;
+message?: string;
+exception?: {
+values?: Array<{
+value?: string;
+}>;
+};
 }): boolean;
 declare function isExpectedCliErrorEvent(event: {
-    exception?: {
-        values?: Array<{
-            type?: string;
-            value?: string;
-        }>;
-    };
-    message?: string;
-    extra?: Record<string, unknown>;
-    logger?: string;
+exception?: {
+values?: Array<{
+type?: string;
+value?: string;
+}>;
+};
+message?: string;
+extra?: Record<string, unknown>;
+logger?: string;
 }): boolean;
 declare function isPmCliErrorBreadcrumb(breadcrumb: {
-    category?: string;
-    message?: string;
+category?: string;
+message?: string;
 }): boolean;
 declare function isKnownNoisyConsoleBreadcrumb(breadcrumb: {
-    category?: string;
-    message?: string;
+category?: string;
+message?: string;
 }): boolean;
 /**
  * Resolves the Sentry performance-tracing sample rate, honouring the standard
@@ -57,18 +57,18 @@ export declare function ensureSentryInit(): Promise<SentryLike | undefined>;
 export declare function getSentry(): SentryLike | undefined;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    isExpectedCliErrorEvent: typeof isExpectedCliErrorEvent;
-    isKnownNoisyConsoleEvent: typeof isKnownNoisyConsoleEvent;
-    isNodeRuntimeWarningEvent: typeof isNodeRuntimeWarningEvent;
-    isPmCliErrorBreadcrumb: typeof isPmCliErrorBreadcrumb;
-    isKnownNoisyConsoleBreadcrumb: typeof isKnownNoisyConsoleBreadcrumb;
-    scrubString: typeof scrubString;
-    scrubEventData: typeof scrubEventData;
-    resolveTracesSampleRate: typeof resolveTracesSampleRate;
-    KNOWN_NOISY_CONSOLE_MESSAGE_PATTERNS: readonly ["[starter-extension] activating", "[starter-extension] all 8 capabilities registered.", "[starter-extension] commands:", "[starter] preflight check for workspace", "[starter] output_format service override active", "[pm-ext-ts-starter] activating", "[pm-ext-ts-starter] all capabilities registered.", "run `pm init` first to initialise a pm workspace"];
-    MAX_KNOWN_NOISY_CONSOLE_MESSAGE_PATTERNS: number;
-    defaultSentryLoader: () => SentryLike;
-    setSentryLoaderForTests(loader?: () => SentryLike): void;
-    resetSentryStateForTests(): void;
+isExpectedCliErrorEvent: typeof isExpectedCliErrorEvent;
+isKnownNoisyConsoleEvent: typeof isKnownNoisyConsoleEvent;
+isNodeRuntimeWarningEvent: typeof isNodeRuntimeWarningEvent;
+isPmCliErrorBreadcrumb: typeof isPmCliErrorBreadcrumb;
+isKnownNoisyConsoleBreadcrumb: typeof isKnownNoisyConsoleBreadcrumb;
+scrubString: typeof scrubString;
+scrubEventData: typeof scrubEventData;
+resolveTracesSampleRate: typeof resolveTracesSampleRate;
+KNOWN_NOISY_CONSOLE_MESSAGE_PATTERNS: readonly ["[starter-extension] activating", "[starter-extension] all 8 capabilities registered.", "[starter-extension] commands:", "[starter] preflight check for workspace", "[starter] output_format service override active", "[pm-ext-ts-starter] activating", "[pm-ext-ts-starter] all capabilities registered.", "run `pm init` first to initialise a pm workspace"];
+MAX_KNOWN_NOISY_CONSOLE_MESSAGE_PATTERNS: number;
+defaultSentryLoader: () => SentryLike;
+setSentryLoaderForTests(loader?: () => SentryLike): void;
+resetSentryStateForTests(): void;
 };
 export {};

package/dist/core/session/session-state.d.ts

@@ -7,27 +7,27 @@
  * stale or hand-edited file never blocks a command.
  */
 export interface SessionState {
-    /** Value that configures or reports focused item for this contract. */
-    focused_item?: string;
-    /** Privacy-safe semantic work context partitioned by agent invocation. */
-    semantic_attribution?: Record<string, AgentSemanticAttribution>;
+/** Value that configures or reports focused item for this contract. */
+focused_item?: string;
+/** Privacy-safe semantic work context partitioned by agent invocation. */
+semantic_attribution?: Record<string, AgentSemanticAttribution>;
 }
 /** Bounded inferred work context consumed by mutation provenance. */
 export interface AgentSemanticAttribution {
-    /** Controlled role inferred from the current work lifecycle. */
-    role: "implementer" | "planner" | "release-operator";
-    /** Stable item or workset identity, never prompt text. */
-    topic: string;
-    /** Confidence attached to the inferred observation. */
-    confidence: "high" | "medium";
-    /** Versioned inference rule understood by history consumers. */
-    rule_version: "v2";
-    /** Bounded item and lineage references supporting the inference. */
-    evidence: string[];
-    /** Claimed items currently contributing to the workset. */
-    active_item_ids: string[];
-    /** Explicitly focused item when focus takes precedence over claims. */
-    focused_item_id?: string;
+/** Controlled role inferred from the current work lifecycle. */
+role: "implementer" | "planner" | "release-operator";
+/** Stable item or workset identity, never prompt text. */
+topic: string;
+/** Confidence attached to the inferred observation. */
+confidence: "high" | "medium";
+/** Versioned inference rule understood by history consumers. */
+rule_version: "v2";
+/** Bounded item and lineage references supporting the inference. */
+evidence: string[];
+/** Claimed items currently contributing to the workset. */
+active_item_ids: string[];
+/** Explicitly focused item when focus takes precedence over claims. */
+focused_item_id?: string;
 }
 /** Implements get session state path for the public runtime surface of this module. */
 export declare function getSessionStatePath(pmRoot: string): string;
@@ -37,29 +37,29 @@ export declare function readSessionState(pmRoot: string): Promise<SessionState>;
 export declare function semanticAttributionKey(principal: string): string;
 /** Record a successful claim as incremental semantic session evidence. */
 export declare function recordClaimedWorkAttribution(params: {
-    pmRoot: string;
-    principal: string;
-    itemId: string;
-    lineageIds?: readonly string[];
+pmRoot: string;
+principal: string;
+itemId: string;
+lineageIds?: readonly string[];
 }): Promise<void>;
 /** Remove a released item from incremental semantic session evidence. */
 export declare function releaseClaimedWorkAttribution(params: {
-    pmRoot: string;
-    principal: string;
-    itemId: string;
+pmRoot: string;
+principal: string;
+itemId: string;
 }): Promise<void>;
 /** Set or clear focus as the highest-confidence semantic topic. */
 export declare function recordFocusedWorkAttribution(params: {
-    pmRoot: string;
-    principal: string;
-    itemId?: string;
-    lineageIds?: readonly string[];
+pmRoot: string;
+principal: string;
+itemId?: string;
+lineageIds?: readonly string[];
 }): Promise<void>;
 /** Read one privacy-bounded inferred attribution without making mutations fail. */
 export declare function readAgentSemanticAttributionSync(params: {
-    cwd: string;
-    env: Readonly<Record<string, string | undefined>>;
-    key: string | undefined;
+cwd: string;
+env: Readonly<Record<string, string | undefined>>;
+key: string | undefined;
 }): AgentSemanticAttribution | undefined;
 /** Implements get focused item for the public runtime surface of this module. */
 export declare function getFocusedItem(pmRoot: string): Promise<string | undefined>;

package/dist/core/shared/agent-session-context.d.ts

@@ -1,18 +1,18 @@
 /** Stable identity for one declared agent episode and its optional parent. */
 export interface AgentEpisodeIdentity {
-    /** Stable caller-declared join key. */
-    id: string;
-    /** Human-readable purpose retained in local history. */
-    label?: string;
-    /** Stable parent episode key for delegated or nested work. */
-    parent_id?: string;
+/** Stable caller-declared join key. */
+id: string;
+/** Human-readable purpose retained in local history. */
+label?: string;
+/** Stable parent episode key for delegated or nested work. */
+parent_id?: string;
 }
 /** Session-wide descriptive context inherited by subsequent mutations. */
 export interface AgentSessionContext {
-    /** Session-scoped role and topic declarations. */
-    provenance?: Readonly<Record<string, string | undefined>>;
-    /** Optional declared episode identity. */
-    episode?: AgentEpisodeIdentity;
+/** Session-scoped role and topic declarations. */
+provenance?: Readonly<Record<string, string | undefined>>;
+/** Optional declared episode identity. */
+episode?: AgentEpisodeIdentity;
 }
 /** Bound and validate an episode declaration without exposing raw input. */
 export declare function boundAgentEpisodeIdentity(value: unknown, strict: boolean): AgentEpisodeIdentity | undefined;
@@ -20,10 +20,10 @@ export declare function boundAgentEpisodeIdentity(value: unknown, strict: boolea
 export declare function resolveAgentSessionContext(explicit: AgentSessionContext | undefined, env: Readonly<Record<string, string | undefined>>, fallbackEpisode?: AgentEpisodeIdentity): AgentSessionContext | undefined;
 /** Resolve session context from a complete embedded-host signal envelope. */
 export declare function resolveAgentSessionContextFromSignals(signals: {
-    session_context?: AgentSessionContext;
-    client_info?: {
-        episode?: AgentEpisodeIdentity;
-    };
+session_context?: AgentSessionContext;
+client_info?: {
+episode?: AgentEpisodeIdentity;
+};
 }, env: Readonly<Record<string, string | undefined>>): AgentSessionContext;
 /** Run work with one inherited session declaration and automatic episode nesting. */
 export declare function runWithAgentSessionContext<T>(context: AgentSessionContext, callback: () => T): T;

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.