@unbrained/pm-cli 2026.10.13 → 2026.10.15

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

@@ -6,24 +6,24 @@ export type PmCommandCapabilityFamily = ExtensionCommandCapabilityFamily;
 /** One command's canonical agent-surface visibility declaration. */
 export interface PmCommandVisibilityContract {
 /** Canonical command path. */
-command: string;
+command:string;
 /** Minimum surface tier that advertises the command. */
-tier: PmCommandVisibilityTier;
+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;
+family:PmCommandCapabilityFamily;
 }
 /** One generated family route shared by guides, skills, and documentation. */
 export interface PmCommandCapabilityGroup {
 /** Stable capability family. */
-family: PmCommandCapabilityFamily;
+family:PmCommandCapabilityFamily;
 /** Non-internal commands owned by the family. */
-commands: readonly string[];
+commands:readonly string[];
 }
 /** Resolve one command's stable capability family. */
-export declare function resolvePmCommandCapabilityFamily(command: string): PmCommandCapabilityFamily;
+export declare function resolvePmCommandCapabilityFamily(command:string):PmCommandCapabilityFamily;
 /**
  * Canonical visibility contract for every built-in command.
  *
@@ -31,80 +31,80 @@ export declare function resolvePmCommandCapabilityFamily(command: string): PmCom
  * surface. Internal worker/helper paths are appended below and never advertised
  * by normal help or completion projections.
  */
-export declare const PM_COMMAND_CAPABILITY_CONTRACTS: readonly PmCommandCapabilityContract[];
+export declare const PM_COMMAND_CAPABILITY_CONTRACTS:readonly PmCommandCapabilityContract[];
 /** Backward-compatible tier-only projection of the capability contract. */
-export declare const PM_COMMAND_VISIBILITY_CONTRACTS: readonly PmCommandVisibilityContract[];
+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;
+export declare const PM_CORE_HELP_BUDGET:Readonly<{
+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[];
+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;
+export declare function measurePmCoreHelp(text:string):{
+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;
+export declare function resolvePmCommandVisibilityTier(command:string,extensionTier?:PmCommandVisibilityTier):PmCommandVisibilityTier;
 /** Return commands visible at a requested tier, preserving contract order. */
-export declare function listPmCommandsForTier(tier: Exclude<PmCommandVisibilityTier, "internal">): string[];
+export declare function listPmCommandsForTier(tier:Exclude<PmCommandVisibilityTier,"internal">):string[];
 /** Project an explicit command registry into one visibility tier. */
-export declare function listPmCommandsForTierFromContracts(tier: Exclude<PmCommandVisibilityTier, "internal">, contracts: readonly PmCommandCapabilityContract[]): string[];
+export declare function listPmCommandsForTierFromContracts(tier:Exclude<PmCommandVisibilityTier,"internal">,contracts:readonly PmCommandCapabilityContract[]):string[];
 /** Return commands in one capability family, preserving contract order. */
-export declare function listPmCommandsForFamily(family: PmCommandCapabilityFamily): string[];
+export declare function listPmCommandsForFamily(family:PmCommandCapabilityFamily):string[];
 /** Project an explicit command registry into one capability family. */
-export declare function listPmCommandsForFamilyFromContracts(family: PmCommandCapabilityFamily, contracts: readonly PmCommandCapabilityContract[]): string[];
+export declare function listPmCommandsForFamilyFromContracts(family:PmCommandCapabilityFamily,contracts:readonly PmCommandCapabilityContract[]):string[];
 /** Group the command registry for progressive-disclosure routing surfaces. */
-export declare function listPmCommandCapabilityGroups(contracts?: readonly PmCommandCapabilityContract[]): PmCommandCapabilityGroup[];
+export declare function listPmCommandCapabilityGroups(contracts?:readonly PmCommandCapabilityContract[]):PmCommandCapabilityGroup[];
 /** MCP profile names accepted by the server and embedding hosts. */
 export type PmMcpToolProfile = "core" | "standard" | "full" | "custom";
 /** Mapping from one narrow MCP tool to the command contract that tiers it. */
-export declare const PM_MCP_TOOL_COMMAND_CONTRACTS: Readonly<Record<string, string>>;
+export declare const PM_MCP_TOOL_COMMAND_CONTRACTS:Readonly<Record<string,string>>;
 /** Resolve the tools visible in a named MCP profile from command tiers. */
-export declare function listPmMcpToolsForProfile(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, "custom">): string[];
+export declare function listPmMcpToolsForProfile(availableTools:readonly string[],profile:Exclude<PmMcpToolProfile,"custom">):string[];
 /** Project an explicit command registry into one MCP tool profile. */
-export declare function listPmMcpToolsForProfileFromContracts(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, "custom">, contracts: readonly PmCommandCapabilityContract[]): 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;
+uri:string;
 /** Human-readable resource name. */
-name: string;
+name:string;
 /** Agent-facing resource description. */
-description: string;
+description:string;
 /** Resource MIME type. */
-mimeType: "application/json" | "text/markdown";
+mimeType:"application/json" | "text/markdown";
 }
 /** Addressable, bounded workspace context resources. */
-export declare const PM_MCP_RESOURCE_CONTRACTS: readonly PmMcpResourceContract[];
+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;
+name:string;
 /** Argument description shown by the MCP host. */
-description: string;
+description:string;
 /** Whether the host must provide the argument. */
-required: boolean;
+required:boolean;
 }
 /** Canonical MCP workflow prompt generated from the agent operating contract. */
 export interface PmMcpPromptContract {
 /** Stable prompt name. */
-name: string;
+name:string;
 /** Agent-facing workflow description. */
-description: string;
+description:string;
 /** Parameters accepted by the workflow. */
-arguments: readonly PmMcpPromptArgumentContract[];
+arguments:readonly PmMcpPromptArgumentContract[];
 /** Template rendered into a user message after argument substitution. */
-template: string;
+template:string;
 }
 /** Canonical orient, start, and evidence-close workflows. */
-export declare const PM_MCP_PROMPT_CONTRACTS: readonly PmMcpPromptContract[];
+export declare const PM_MCP_PROMPT_CONTRACTS:readonly PmMcpPromptContract[];
 /** Render the generated command visibility reference used by docs drift gates. */
-export declare function renderPmCommandVisibilityMarkdown(): string;
+export declare function renderPmCommandVisibilityMarkdown():string;
 /** Render an explicit registry for mutation-sensitivity and host tooling. */
-export declare function renderPmCommandVisibilityMarkdownFromContracts(contracts: readonly PmCommandCapabilityContract[]): string;
+export declare function renderPmCommandVisibilityMarkdownFromContracts(contracts:readonly PmCommandCapabilityContract[]):string;
 /** Render family routing for generated docs and skill progressive disclosure. */
-export declare function renderPmCapabilityRoutingMarkdown(contracts?: readonly PmCommandCapabilityContract[]): string;
+export declare function renderPmCapabilityRoutingMarkdown(contracts?:readonly PmCommandCapabilityContract[]):string;

package/dist/sdk/agent-session-context.d.ts

@@ -3,4 +3,4 @@
  *
  * Public SDK entrypoint for session-scoped provenance and episode identity.
  */
-export { agentSessionEnvironment, boundAgentEpisodeIdentity, runWithAgentSessionContext, resolveAgentSessionContextFromSignals, type AgentEpisodeIdentity, type AgentSessionContext, } from "../core/shared/agent-session-context.js";
+export { agentSessionEnvironment,boundAgentEpisodeIdentity,runWithAgentSessionContext,resolveAgentSessionContextFromSignals,type AgentEpisodeIdentity,type AgentSessionContext,} from "../core/shared/agent-session-context.js";

package/dist/sdk/annotations.d.ts

@@ -3,159 +3,159 @@ 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;
+created_at:string;
 /** Stable author attribution recorded with the entry. */
-author: string;
+author:string;
 /** Human-readable annotation body. */
-text: string;
+text:string;
 /** Last edit timestamp when the entry was changed in place. */
-edited_at?: string;
+edited_at?:string;
 }
 /** Common options accepted by annotation primitive operations. */
 export interface AnnotationCommandOptions {
 /** Maximum number of newest entries returned. */
-limit?: string;
+limit?:string;
 /** Author override for mutation attribution. */
-author?: string;
+author?:string;
 /** Optional history message describing the mutation. */
-message?: string;
+message?:string;
 /** Whether to override an active ownership conflict. */
-force?: boolean;
+force?:boolean;
 /** Whether list results include paging metadata. */
-includeMeta?: boolean;
+includeMeta?:boolean;
 /** Return the complete collection after a mutation instead of the bounded mutation receipt. */
-fullHistory?: boolean;
+fullHistory?:boolean;
 /** Append only when no entry has the same resolved author and text. */
-ifAbsent?: boolean;
+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";
+action:"add" | "edit" | "delete";
 /** Stable one-based collection position targeted by the mutation. */
-entry_index: number;
+entry_index:number;
 /** Number of stored entries changed by the mutation attempt. */
-changed_count: 0 | 1;
+changed_count:0 | 1;
 /** Whether the response includes the complete post-mutation collection. */
-full_history_included: boolean;
+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";
+selector:"full_history";
 /** Equivalent CLI flag. */
-cli_flag: "--full-history";
+cli_flag:"--full-history";
 /** Equivalent direct SDK option. */
-sdk_option: "fullHistory";
+sdk_option:"fullHistory";
 /** Equivalent MCP tool option. */
-mcp_option: "full";
+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;
+has_omissions:boolean;
 /** Number of independently restorable field groups withheld. */
-omitted_field_group_count: number;
+omitted_field_group_count:number;
 /** Omitted groups and the transport-neutral selectors that restore them. */
-omitted_field_groups: Array<{
-name: string;
-restore_with: AnnotationHistoryRestoration;
+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>;
+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;
+add?:string;
 /** Read annotation text directly from stdin. */
-stdin?: boolean;
+stdin?:boolean;
 /** Read annotation text from a UTF-8 file. */
-file?: string;
+file?:string;
 /** One-based entry index to replace. */
-edit?: number;
+edit?:number;
 /** One-based entry index to delete. */
-delete?: number;
+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";
+mode:"list" | "add" | "stdin" | "file" | "edit" | "delete";
 /** Resolved annotation text. */
-value?: string;
+value?:string;
 /** Original input used for flag-like value validation. */
-rawValue?: string;
+rawValue?:string;
 /** Flag name used in validation messages. */
-emptyFlag?: string;
+emptyFlag?:string;
 /** One-based entry index for edit and delete operations. */
-index?: number;
+index?:number;
 }
 /** Agent-facing recovery guidance for ownership conflicts. */
 export interface OwnershipConflictGuidance {
 /** Actionable requirement shown to the caller. */
-required: string;
+required:string;
 /** Copyable retry examples. */
-examples: string[];
+examples:string[];
 /** Ordered recovery guidance. */
-nextSteps: string[];
+nextSteps:string[];
 }
 /** Domain configuration for one annotation collection primitive. */
-export interface AnnotationCommandConfig<TKey extends string, TEntry extends AnnotationEntry = AnnotationEntry> {
+export interface AnnotationCommandConfig<TKey extends string,TEntry extends AnnotationEntry = AnnotationEntry> {
 /** Normalized annotation operation. */
-input: AnnotationInput;
+input:AnnotationInput;
 /** Metadata collection that stores this annotation family. */
-collectionKey: TKey;
+collectionKey:TKey;
 /** History operation used for additions. */
-op: Parameters<typeof mutateItem>[0]["op"];
+op:Parameters<typeof mutateItem>[0]["op"];
 /** History operation used for edits. */
-editOp?: Parameters<typeof mutateItem>[0]["op"];
+editOp?:Parameters<typeof mutateItem>[0]["op"];
 /** History operation used for deletions. */
-deleteOp?: Parameters<typeof mutateItem>[0]["op"];
+deleteOp?:Parameters<typeof mutateItem>[0]["op"];
 /** Domain parser that normalizes resolved text. */
-parseText: (raw: string) => string;
+parseText:(raw:string) => string;
 /** Whether this operation may bypass ownership for a caller-authorized annotation workflow. */
-bypassOwnershipConflict: boolean;
+bypassOwnershipConflict:boolean;
 /** Recovery guidance for ownership conflicts. */
-conflictGuidance: OwnershipConflictGuidance;
+conflictGuidance:OwnershipConflictGuidance;
 /** Entry factory that preserves or enriches the collection's typed annotation shape. */
-createEntry: (input: {
-created_at: string;
-author: string;
-text: string;
+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;
-} & Record<TKey, TEntry[]> & {
-total_count?: number;
-returned_count?: number;
-has_more?: boolean;
-limit?: number;
-mutation_receipt?: AnnotationMutationReceipt;
-omission_receipt?: AnnotationOmissionReceipt;
-changed?: boolean;
+export type AnnotationCommandResult<TKey extends string,TEntry extends AnnotationEntry> = {
+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;
 };
 /** Implements limit annotation entries for the public runtime surface of this module. */
-export declare function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): TEntry[];
+export declare function limitAnnotationEntries<TEntry>(values:TEntry[],limit:number | undefined):TEntry[];
 /** Implements read annotation entries for the public runtime surface of this module. */
-export declare function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[];
+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;
-}): string;
+export declare function parseAnnotationTextInput(raw:string,options?:{
+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;
+export declare function isErrnoError(error:unknown):error is {
+code?:unknown;
 };
 /** Refuse presentation-level stdin directives when JSON-RPC owns the process stream. */
-export declare function assertAnnotationStdinTransportAvailable(options: AnnotationSourceOptions, optionName: string): void;
+export declare function assertAnnotationStdinTransportAvailable(options:AnnotationSourceOptions,optionName:string):void;
 /** Resolves mutually exclusive annotation input flags into one normalized SDK operation. */
-export declare function resolveAnnotationInput(options: AnnotationSourceOptions, noun: string): Promise<AnnotationInput>;
+export declare function resolveAnnotationInput(options:AnnotationSourceOptions,noun:string):Promise<AnnotationInput>;
 /** Implements wrap ownership conflict for the public runtime surface of this module. */
-export declare function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): never;
+export declare function wrapOwnershipConflict(error:unknown,guidance:OwnershipConflictGuidance):never;
 /** Implements run annotation command for the public runtime surface of this module. */
-export declare function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(id: string, options: AnnotationCommandOptions, global: GlobalOptions, config: AnnotationCommandConfig<TKey, TEntry>): Promise<AnnotationCommandResult<TKey, TEntry>>;
+export declare function runAnnotationCommand<TKey extends string,TEntry extends AnnotationEntry>(id:string,options:AnnotationCommandOptions,global:GlobalOptions,config:AnnotationCommandConfig<TKey,TEntry>):Promise<AnnotationCommandResult<TKey,TEntry>>;
 /** Implements resolve annotation index for the public runtime surface of this module. */
-export declare function resolveAnnotationIndex(oneBasedIndex: number | undefined, count: number, collectionKey: string): number;
+export declare function resolveAnnotationIndex(oneBasedIndex:number | undefined,count:number,collectionKey:string):number;

package/dist/sdk/author-attribution.d.ts

@@ -3,117 +3,117 @@ export declare const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.
 /** Identifies one history event whose mutation author is absent or explicitly unknown. */
 export interface UnknownAuthorHistoryEvent {
 /** Item whose history stream contains the event. */
-item_id: string;
+item_id:string;
 /** One-based JSONL line number. */
-line: number;
+line:number;
 }
 /** Summarizes mutation-author provenance across all readable tracker history streams. */
 export interface HistoryAuthorAttributionScan {
 /** Number of readable history streams inspected. */
-checked_streams: number;
+checked_streams:number;
 /** Number of non-empty history events inspected. */
-checked_events: number;
+checked_events:number;
 /** Number of events without attributable authorship. */
-unknown_event_count: number;
+unknown_event_count:number;
 /** Immutable pre-baseline events retained as historical information. */
-legacy_unknown_event_count: number;
+legacy_unknown_event_count:number;
 /** Timestamped post-baseline events that require author-attribution fixes. */
-actionable_unknown_event_count: number;
+actionable_unknown_event_count:number;
 /** Post-baseline unknown events dispositioned by an append-only review event. */
-acknowledged_actionable_event_count: number;
+acknowledged_actionable_event_count:number;
 /** Stable, sorted item ids containing unknown-author events. */
-affected_item_ids: string[];
+affected_item_ids:string[];
 /** Bounded examples suitable for diagnostic output. */
-samples: UnknownAuthorHistoryEvent[];
+samples:UnknownAuthorHistoryEvent[];
 /** Whether additional undispositioned unknown-author examples were omitted. */
-samples_truncated: boolean;
+samples_truncated:boolean;
 /** Complete actionable coordinates when explicitly requested by a trusted caller. */
-actionable_events?: UnknownAuthorHistoryEvent[];
+actionable_events?:UnknownAuthorHistoryEvent[];
 }
 /** Classifies one parsed history event by author provenance and baseline age. */
-export declare const classifyHistoryAuthorEvent: (parsed: unknown) => "attributed" | "legacy_unknown" | "actionable_unknown";
+export declare const classifyHistoryAuthorEvent:(parsed:unknown) => "attributed" | "legacy_unknown" | "actionable_unknown";
 /** Inspect one readable JSONL stream without performing filesystem I/O. */
-export declare const inspectHistoryAuthorStream: (itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, "checked_events" | "unknown_event_count" | "legacy_unknown_event_count" | "actionable_unknown_event_count" | "acknowledged_actionable_event_count" | "samples" | "samples_truncated" | "actionable_events">;
+export declare const inspectHistoryAuthorStream:(itemId:string,raw:string,sampleLimit?:number,acknowledgedEvents?:ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan,"checked_events" | "unknown_event_count" | "legacy_unknown_event_count" | "actionable_unknown_event_count" | "acknowledged_actionable_event_count" | "samples" | "samples_truncated" | "actionable_events">;
 /**
  * Scan append-only tracker history for missing or `unknown` author values.
  * Malformed and unreadable streams are deliberately left to integrity diagnostics.
  */
-export declare const scanHistoryAuthorAttribution: (pmRoot: string, sampleLimit?: number, includeActionableEvents?: boolean) => Promise<HistoryAuthorAttributionScan>;
+export declare const scanHistoryAuthorAttribution:(pmRoot:string,sampleLimit?:number,includeActionableEvents?:boolean) => Promise<HistoryAuthorAttributionScan>;
 /** Parameters for append-only disposition of immutable unknown-author events. */
 export interface AcknowledgeUnknownAuthorEventsOptions {
 /** Events identified by item id and one-based history line. */
-events?: UnknownAuthorHistoryEvent[];
+events?:UnknownAuthorHistoryEvent[];
 /** Select every currently actionable, undispositioned event in the tracker. */
-all_actionable?: boolean;
+all_actionable?:boolean;
 /** Principal attributed by maintainer review. */
-attributed_author?: string;
+attributed_author?:string;
 /** Reviewer appending the disposition event. */
-reviewer?: string;
+reviewer?:string;
 /** Evidence-backed rationale for the attribution. */
-reason?: string;
+reason?:string;
 /** Resolve and return the selected plan without appending history. */
-dry_run?: boolean;
+dry_run?:boolean;
 /** Fingerprint from the exact preview plan being applied. */
-plan_fingerprint?: string;
+plan_fingerprint?:string;
 /** Maximum coordinate rows included in the returned plan. */
-coordinate_limit?: number;
+coordinate_limit?:number;
 }
 /** One source-bound coordinate in an author-acknowledgement plan. */
 export interface UnknownAuthorAcknowledgmentPlanCoordinate extends UnknownAuthorHistoryEvent {
 /** SHA-256 of the exact immutable JSONL source line. */
-source_event_hash: string;
+source_event_hash:string;
 /** Whether the row is undispositioned or an explicit apply would supersede it. */
-disposition: "actionable" | "already_acknowledged";
+disposition:"actionable" | "already_acknowledged";
 }
 /** Deterministic preview shared by CLI, SDK, and MCP apply paths. */
 export interface UnknownAuthorAcknowledgmentPlan {
 /** Selector family resolved by the plan. */
-selection: {
-kind: "events" | "all_actionable";
+selection:{
+kind:"events" | "all_actionable";
 };
 /** Complete number of unique selected coordinates. */
-selected_count: number;
+selected_count:number;
 /** Selected coordinates not covered by an earlier disposition. */
-actionable_count: number;
+actionable_count:number;
 /** Coordinates an explicit-events apply would supersede. */
-already_acknowledged_count: number;
+already_acknowledged_count:number;
 /** Coordinate rows omitted only from this bounded preview. */
-omitted_count: number;
+omitted_count:number;
 /** Stable ordered prefix of the complete selected set. */
-coordinates: UnknownAuthorAcknowledgmentPlanCoordinate[];
+coordinates:UnknownAuthorAcknowledgmentPlanCoordinate[];
 /** SHA-256 over selection kind and every complete source-bound coordinate. */
-plan_fingerprint: string;
+plan_fingerprint:string;
 }
 /** Structured preview or apply result for immutable author acknowledgement. */
 export interface UnknownAuthorAcknowledgmentResult {
 /** Whether this invocation was a read-only preview. */
-dry_run: boolean;
+dry_run:boolean;
 /** Whether an append-only workspace event was written. */
-mutated: boolean;
+mutated:boolean;
 /** Number of coordinates written to the appended disposition. */
-acknowledged: number;
+acknowledged:number;
 /** Effect-aware command outcome. */
-outcome: "preview" | "effect" | "no_effect" | "partial_effect";
+outcome:"preview" | "effect" | "no_effect" | "partial_effect";
 /** Stable shell and transport exit paired with the outcome. */
-exit_code: 0 | 6 | 7;
+exit_code:0 | 6 | 7;
 /** Exact plan used for preview or apply. */
-plan: UnknownAuthorAcknowledgmentPlan;
+plan:UnknownAuthorAcknowledgmentPlan;
 /** Appended workspace history path when mutation occurred. */
-history_path?: string;
+history_path?:string;
 }
 /** Resolve a deterministic, source-bound author-acknowledgement preview. */
-export declare function planUnknownAuthorHistoryAcknowledgment(pmRoot: string, selector: Pick<AcknowledgeUnknownAuthorEventsOptions, "events" | "all_actionable">, coordinateLimit?: number): Promise<UnknownAuthorAcknowledgmentPlan>;
+export declare function planUnknownAuthorHistoryAcknowledgment(pmRoot:string,selector:Pick<AcknowledgeUnknownAuthorEventsOptions,"events" | "all_actionable">,coordinateLimit?:number):Promise<UnknownAuthorAcknowledgmentPlan>;
 /** Resolve the mutually exclusive CLI and SDK acknowledgment selectors. */
-export declare function resolveUnknownAuthorAcknowledgmentSelector(rawEvents: readonly string[], allActionable: boolean): {
-events: UnknownAuthorHistoryEvent[];
-all_actionable: boolean;
+export declare function resolveUnknownAuthorAcknowledgmentSelector(rawEvents:readonly string[],allActionable:boolean):{
+events:UnknownAuthorHistoryEvent[];
+all_actionable:boolean;
 };
 /** Parse user-facing item or workspace history coordinates into SDK events. */
-export declare function parseUnknownAuthorHistoryEventCoordinates(values: readonly string[]): UnknownAuthorHistoryEvent[];
+export declare function parseUnknownAuthorHistoryEventCoordinates(values:readonly string[]):UnknownAuthorHistoryEvent[];
 /** Normalize an untyped transport payload and execute author acknowledgment. */
-export declare function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot: string, input: Record<string, unknown>): Promise<UnknownAuthorAcknowledgmentResult>;
+export declare function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot:string,input:Record<string,unknown>):Promise<UnknownAuthorAcknowledgmentResult>;
 /**
  * Append an audited disposition for immutable unknown-author events without
  * rewriting their original streams.
  */
-export declare function acknowledgeUnknownAuthorHistoryEvents(pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>;
+export declare function acknowledgeUnknownAuthorHistoryEvents(pmRoot:string,options:AcknowledgeUnknownAuthorEventsOptions):Promise<UnknownAuthorAcknowledgmentResult>;

package/dist/sdk/authoring.d.ts

@@ -7,12 +7,12 @@ export * from "./compose.js";
 export * from "./define.js";
 export * from "./extension-contracts.js";
 export { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
-export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, type PmPackageCatalogLinkMap, type PmPackageCatalogMediaMap, type PmPackageCatalogMetadata, type PmPackageManifest, type PmPackageResourceKind, type PmPackageResourceMap, } from "../core/packages/manifest.js";
-export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
-export { describeProfileComposition, describeProjectProfile, type ProjectProfileComposition, type ProjectProfileDescription, type ProjectProfilePackageSummary, } from "../core/profile/profile-describe.js";
-export { lintProjectProfile, PROFILE_LINT_CODES, PROFILE_LINT_DIMENSIONS, type ProfileLintCode, type ProfileLintDimension, type ProfileLintSeverity, type ProjectProfileLintFinding, type ProjectProfileLintReport, } from "../core/profile/profile-lint.js";
-export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";
-export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "../core/extensions/capability-usage.js";
-export { renderExtensionSurfaceMarkdown, type ExtensionSurfaceMarkdownOptions, } from "../core/extensions/activation-summary-markdown.js";
-export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandReadOutput, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, ServiceOverrideOwnership, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,collectPackageExtensionDirectories,readPmPackageManifest,type PmPackageCatalogLinkMap,type PmPackageCatalogMediaMap,type PmPackageCatalogMetadata,type PmPackageManifest,type PmPackageResourceKind,type PmPackageResourceMap,} from "../core/packages/manifest.js";
+export { BUILTIN_PROFILES,listProfiles,normalizeProfileName,PROFILE_NAMES,resolveProfile,type ProfileConfigEntry,type ProfileName,type ProfilePackageRecommendation,type ProfileTemplateEntry,type ProfileTemplateOptions,type ProjectProfileDefinition,type ProjectProfileRegistrationInput,} from "../core/profile/profile-presets.js";
+export { describeProfileComposition,describeProjectProfile,type ProjectProfileComposition,type ProjectProfileDescription,type ProjectProfilePackageSummary,} from "../core/profile/profile-describe.js";
+export { lintProjectProfile,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS,type ProfileLintCode,type ProfileLintDimension,type ProfileLintSeverity,type ProjectProfileLintFinding,type ProjectProfileLintReport,} from "../core/profile/profile-lint.js";
+export { planProfileApplication,type ProfileApplicationPlan,type ProfileChangeStatus,type ProfileComponentChange,type ProfileConfigChange,type ProfileConfigPlan,type ProfileCurrentState,type ProfilePackagePlan,type ProfileSchemaPlan,type ProfileTemplateChange,type ProfileTemplatePlan,type ProfileWorkflowChange,type ProfileWorkflowPlan,} from "../core/profile/profile-plan.js";
+export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,reconcileExtensionCapabilityUsage,type CollectUsedExtensionCapabilitiesOptions,type ExtensionCapabilityUsageReconciliation,} from "../core/extensions/capability-usage.js";
+export { renderExtensionSurfaceMarkdown,type ExtensionSurfaceMarkdownOptions,} from "../core/extensions/activation-summary-markdown.js";
+export { createExtensionContributionInventory,normalizeExtensionContributionInventory,} from "../core/extensions/contribution-inventory.js";
+export type { AfterCommandAffectedItem,AfterCommandHook,AfterCommandHookContext,BeforeCommandHook,BeforeCommandHookContext,BeforeMutationHook,BeforeMutationHookContext,BeforeMutationHookDecision,CommandDefinition,ExtensionCommandReadOutput,ExtensionCommandArgumentDefinition,CommandHandler,CommandHandlerContext,CommandHandlerResult,ExtensionCommandSdk,CommandOverride,CommandOverrideContext,ExtensionServiceName,Exporter,ExporterArtifactOutputContract,ExporterRegistrationOptions,ExtensionActivationResult,ExtensionApi,ExtensionCommandRegistry,ExtensionDeactivationFailure,ExtensionDeactivationOptions,ExtensionDeactivationResult,ExtensionDiagnostic,ExtensionContributionInventory,ExtensionDiscoveryResult,ExtensionHookRegistry,ExtensionSelfIdentity,ExtensionLoadResult,ExtensionManifest,ExtensionManifestEngines,ExtensionMutationGuardSdk,ExtensionGovernancePolicy,ExtensionPolicyOverride,ExtensionProvenanceMetadata,ExtensionRuntimePermissionDeclaration,ExtensionSearchMode,ExtensionParserRegistry,ExtensionPreflightRegistry,ExtensionRegistrationRegistry,ExtensionRendererRegistry,ExtensionServiceRegistry,FlagValueType,FlagDefinition,ImportExportContext,ImportExportRegistrationOptions,Importer,OnIndexHook,OnIndexHookContext,OnReadHook,OnReadHookContext,OnWriteHook,OnWriteHookContext,OutputRendererFormat,ParserOverride,ParserOverrideContext,ParserOverrideDelta,PreflightOverride,PreflightOverrideContext,PreflightOverrideDelta,PreflightRuntimeDecision,RegisteredExtensionExporter,RegisteredExporterArtifactOutputContract,RegisteredExtensionFlagDefinitions,RegisteredExtensionHook,RegisteredExtensionImporter,RegisteredExtensionProjectProfile,RegisteredExtensionSchemaMigrationDefinition,RegisteredExtensionSearchProvider,RegisteredExtensionServiceOverride,RegisteredExtensionVectorStoreAdapter,RendererOverride,RendererOverrideContext,SchemaFieldDefinition,SchemaItemTypeCommandOptionPolicyDefinition,SchemaItemTypeOptionDefinition,SchemaItemTypeDefinition,SchemaMigrationDefinition,SchemaMigrationRunContext,SchemaMigrationRunner,SearchProviderEmbedBatchContext,SearchProviderEmbedContext,SearchProviderDefinition,SearchProviderHit,SearchProviderQueryContext,SearchProviderQueryResult,ServiceOverride,ServiceOverrideContext,ServiceOverrideDecision,ServiceOverrideOwnership,VectorStoreAdapterDefinition,VectorStoreDeleteContext,VectorStoreQueryContext,VectorStoreQueryHit,VectorStoreUpsertContext,VectorStoreUpsertPoint,} from "../core/extensions/loader.js";