@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/types.d.ts

@@ -31,10 +31,10 @@ export type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];
 export declare const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES: readonly ["allow", "warn", "reject"];
 /** Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts. */
 export type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];
-/** Supported values accepted by the dependency kind contract. */
+/** Built-in dependency spellings; active extensions may register additional kinds and aliases. */
 export declare const DEPENDENCY_KIND_VALUES: readonly ["blocks", "parent", "child", "parent_child", "child_of", "related", "related_to", "discovered_from", "blocked_by", "incident_from", "epic", "implements", "recurs_from", "supersedes", "task", "verifies"];
-/** Restricts dependency kind values accepted by command, SDK, and storage contracts. */
-export type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];
+/** Relationship identifier admitted by the active built-in and extension registry. */
+export type DependencyKind = string;
 /** Supported values accepted by the scope contract. */
 export declare const SCOPE_VALUES: readonly ["project", "global"];
 /** Restricts link scope values accepted by command, SDK, and storage contracts. */
@@ -109,166 +109,170 @@ export type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];
 export declare function weekdayOrderIndex(value: RecurrenceWeekday): number;
 /** Documents the dependency payload exchanged by command, SDK, and package integrations. */
 export interface Dependency {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports kind for this contract. */
-    kind: DependencyKind;
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports source kind for this contract. */
-    source_kind?: string;
-    /** Whether the recorded edge author was explicitly asserted or automatically detected. */
-    author_source?: "asserted" | "detected" | "legacy";
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports kind for this contract. */
+kind: DependencyKind;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports source kind for this contract. */
+source_kind?: string;
+/** Whether the recorded edge author was explicitly asserted or automatically detected. */
+author_source?: "asserted" | "detected" | "legacy";
 }
 /** Documents the comment payload exchanged by command, SDK, and package integrations. */
 export interface Comment {
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports text for this contract. */
+text: string;
 }
 /** Documents the log note payload exchanged by command, SDK, and package integrations. */
 export interface LogNote {
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
-    /** Structured payload format marker; absent entries remain ordinary text notes. */
-    format?: "json";
-    /** Validated JSON payload for merge-safe machine-authored context events. */
-    data?: StructuredJsonValue;
-    /** Optional event discriminator projected from a top-level `type` property. */
-    event_type?: string;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports text for this contract. */
+text: string;
+/** Structured payload format marker; absent entries remain ordinary text notes. */
+format?: "json";
+/** Validated JSON payload for merge-safe machine-authored context events. */
+data?: StructuredJsonValue;
+/** Optional event discriminator projected from a top-level `type` property. */
+event_type?: string;
 }
 /** JSON value accepted by structured context-event annotations. */
 export type StructuredJsonValue = null | boolean | number | string | StructuredJsonValue[] | {
-    [key: string]: StructuredJsonValue;
+[key: string]: StructuredJsonValue;
 };
 /** Machine-readable, append-only context event stored in the union-merged notes collection. */
 export interface StructuredLogEvent extends LogNote {
-    /** Discriminates structured events from free-text notes. */
-    format: "json";
-    /** Validated JSON payload. */
-    data: StructuredJsonValue;
+/** Discriminates structured events from free-text notes. */
+format: "json";
+/** Validated JSON payload. */
+data: StructuredJsonValue;
 }
 /** Documents the linked file payload exchanged by command, SDK, and package integrations. */
 export interface LinkedFile {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: LinkScope;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope: LinkScope;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Valid immutable provenance captured when a linked command enters tracker data. */
 export interface LinkedTestProvenance {
-    /** Author identity recorded by the originating mutation. */
-    author: string;
-    /** ISO 8601 time at which the command entered tracker data. */
-    created_at: string;
-    /** Mutation path that introduced the command. */
-    source_kind: "local_mutation" | "merge_union";
-    /** Best-effort Git branch or hosted head ref of the originating mutation. */
-    source_ref?: string;
+/** Author identity recorded by the originating mutation. */
+author: string;
+/** ISO 8601 time at which the command entered tracker data. */
+created_at: string;
+/** Mutation path that introduced the command. */
+source_kind: "local_mutation" | "merge_union";
+/** Best-effort Git branch or hosted head ref of the originating mutation. */
+source_ref?: string;
 }
 /** Documents the linked test payload exchanged by command, SDK, and package integrations. */
 export interface LinkedTest {
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: LinkScope;
-    /** Value that configures or reports timeout seconds for this contract. */
-    timeout_seconds?: number;
-    /** Strategy used to control pm context behavior. */
-    pm_context_mode?: "schema" | "tracker" | "auto" | "none";
-    /** Strategy used for source-workspace visibility and command working directory. */
-    workspace_context_mode?: "source" | "isolated" | "snapshot";
-    /** Immutable provenance captured when the linked command enters tracker data. */
-    provenance?: LinkedTestProvenance;
-    /** Explicit fail-closed marker retained when stored provenance is malformed. */
-    provenance_invalid?: true;
-    /** Value that configures or reports env set for this contract. */
-    env_set?: Record<string, string>;
-    /** Value that configures or reports env clear for this contract. */
-    env_clear?: string[];
-    /** Value that configures or reports shared host safe for this contract. */
-    shared_host_safe?: boolean;
-    /** Value that configures or reports assert stdout contains for this contract. */
-    assert_stdout_contains?: string[];
-    /** Value that configures or reports assert stdout regex for this contract. */
-    assert_stdout_regex?: string[];
-    /** Value that configures or reports assert stderr contains for this contract. */
-    assert_stderr_contains?: string[];
-    /** Value that configures or reports assert stderr regex for this contract. */
-    assert_stderr_regex?: string[];
-    /** Value that configures or reports assert stdout min lines for this contract. */
-    assert_stdout_min_lines?: number;
-    /** Value that configures or reports assert json field equals for this contract. */
-    assert_json_field_equals?: Record<string, string>;
-    /** Value that configures or reports assert json field gte for this contract. */
-    assert_json_field_gte?: Record<string, number>;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Value that configures or reports scope for this contract. */
+scope: LinkScope;
+/** Value that configures or reports timeout seconds for this contract. */
+timeout_seconds?: number;
+/** Strategy used to control pm context behavior. */
+pm_context_mode?: "schema" | "tracker" | "auto" | "none";
+/** Strategy used for source-workspace visibility and command working directory. */
+workspace_context_mode?: "source" | "isolated" | "snapshot";
+/** Immutable provenance captured when the linked command enters tracker data. */
+provenance?: LinkedTestProvenance;
+/** Explicit fail-closed marker retained when stored provenance is malformed. */
+provenance_invalid?: true;
+/** Author of the most recent explicit metadata edit; creation provenance is retained. */
+updated_by?: string;
+/** ISO timestamp of the most recent explicit metadata edit. */
+updated_at?: string;
+/** Value that configures or reports env set for this contract. */
+env_set?: Record<string, string>;
+/** Value that configures or reports env clear for this contract. */
+env_clear?: string[];
+/** Value that configures or reports shared host safe for this contract. */
+shared_host_safe?: boolean;
+/** Value that configures or reports assert stdout contains for this contract. */
+assert_stdout_contains?: string[];
+/** Value that configures or reports assert stdout regex for this contract. */
+assert_stdout_regex?: string[];
+/** Value that configures or reports assert stderr contains for this contract. */
+assert_stderr_contains?: string[];
+/** Value that configures or reports assert stderr regex for this contract. */
+assert_stderr_regex?: string[];
+/** Value that configures or reports assert stdout min lines for this contract. */
+assert_stdout_min_lines?: number;
+/** Value that configures or reports assert json field equals for this contract. */
+assert_json_field_equals?: Record<string, string>;
+/** Value that configures or reports assert json field gte for this contract. */
+assert_json_field_gte?: Record<string, number>;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Documents the linked doc payload exchanged by command, SDK, and package integrations. */
 export interface LinkedDoc {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: LinkScope;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope: LinkScope;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Documents the reminder payload exchanged by command, SDK, and package integrations. */
 export interface Reminder {
-    /** Value that configures or reports at for this contract. */
-    at: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
+/** Value that configures or reports at for this contract. */
+at: string;
+/** Value that configures or reports text for this contract. */
+text: string;
 }
 /** Documents the recurrence rule payload exchanged by command, SDK, and package integrations. */
 export interface RecurrenceRule {
-    /** Value that configures or reports freq for this contract. */
-    freq: RecurrenceFrequency;
-    /** Value that configures or reports interval for this contract. */
-    interval?: number;
-    /** Value that configures or reports count for this contract. */
-    count?: number;
-    /** Value that configures or reports until for this contract. */
-    until?: string;
-    /** Value that configures or reports by weekday for this contract. */
-    by_weekday?: RecurrenceWeekday[];
-    /** Value that configures or reports by month day for this contract. */
-    by_month_day?: number[];
-    /** Value that configures or reports exdates for this contract. */
-    exdates?: string[];
+/** Value that configures or reports freq for this contract. */
+freq: RecurrenceFrequency;
+/** Value that configures or reports interval for this contract. */
+interval?: number;
+/** Value that configures or reports count for this contract. */
+count?: number;
+/** Value that configures or reports until for this contract. */
+until?: string;
+/** Value that configures or reports by weekday for this contract. */
+by_weekday?: RecurrenceWeekday[];
+/** Value that configures or reports by month day for this contract. */
+by_month_day?: number[];
+/** Value that configures or reports exdates for this contract. */
+exdates?: string[];
 }
 /** Documents the calendar event payload exchanged by command, SDK, and package integrations. */
 export interface CalendarEvent {
-    /** ISO 8601 timestamp recording when start occurred. */
-    start_at: string;
-    /** ISO 8601 timestamp recording when end occurred. */
-    end_at?: string;
-    /** Value that configures or reports title for this contract. */
-    title?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports location for this contract. */
-    location?: string;
-    /** Value that configures or reports all day for this contract. */
-    all_day?: boolean;
-    /** Value that configures or reports timezone for this contract. */
-    timezone?: string;
-    /** Value that configures or reports recurrence for this contract. */
-    recurrence?: RecurrenceRule;
+/** ISO 8601 timestamp recording when start occurred. */
+start_at: string;
+/** ISO 8601 timestamp recording when end occurred. */
+end_at?: string;
+/** Value that configures or reports title for this contract. */
+title?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports location for this contract. */
+location?: string;
+/** Value that configures or reports all day for this contract. */
+all_day?: boolean;
+/** Value that configures or reports timezone for this contract. */
+timezone?: string;
+/** Value that configures or reports recurrence for this contract. */
+recurrence?: RecurrenceRule;
 }
 /** Supported values accepted by the plan mode contract. */
 export declare const PLAN_MODE_VALUES: readonly ["draft", "research", "review", "approved", "executing", "paused", "completed", "superseded"];
@@ -288,592 +292,592 @@ export declare const PLAN_STEP_LINK_KIND_VALUES: readonly ["related", "blocks",
 export type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];
 /** Documents the plan step link payload exchanged by command, SDK, and package integrations. */
 export interface PlanStepLink {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports kind for this contract. */
-    kind: PlanStepLinkKind;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
-    /** Value that configures or reports required before step for this contract. */
-    required_before_step?: boolean;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports kind for this contract. */
+kind: PlanStepLinkKind;
+/** Value that configures or reports note for this contract. */
+note?: string;
+/** Value that configures or reports required before step for this contract. */
+required_before_step?: boolean;
 }
 /** Documents the plan step file payload exchanged by command, SDK, and package integrations. */
 export interface PlanStepFile {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope?: LinkScope;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope?: LinkScope;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Documents the plan step test payload exchanged by command, SDK, and package integrations. */
 export interface PlanStepTest {
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Documents the plan step doc payload exchanged by command, SDK, and package integrations. */
 export interface PlanStepDoc {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope?: LinkScope;
-    /** Value that configures or reports note for this contract. */
-    note?: string;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope?: LinkScope;
+/** Value that configures or reports note for this contract. */
+note?: string;
 }
 /** Documents the plan step payload exchanged by command, SDK, and package integrations. */
 export interface PlanStep {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports order for this contract. */
-    order: number;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Value that configures or reports body for this contract. */
-    body?: string;
-    /** Lifecycle state reported for status. */
-    status: PlanStepStatus;
-    /** Value that configures or reports owner for this contract. */
-    owner?: string;
-    /** Value that configures or reports evidence for this contract. */
-    evidence?: string;
-    /** Value that configures or reports blocked reason for this contract. */
-    blocked_reason?: string;
-    /** Value that configures or reports superseded by for this contract. */
-    superseded_by?: string;
-    /** Value that configures or reports linked items for this contract. */
-    linked_items?: PlanStepLink[];
-    /** Value that configures or reports files for this contract. */
-    files?: PlanStepFile[];
-    /** Value that configures or reports tests for this contract. */
-    tests?: PlanStepTest[];
-    /** Value that configures or reports docs for this contract. */
-    docs?: PlanStepDoc[];
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** ISO 8601 timestamp recording when completed occurred. */
-    completed_at?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports order for this contract. */
+order: number;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Value that configures or reports body for this contract. */
+body?: string;
+/** Lifecycle state reported for status. */
+status: PlanStepStatus;
+/** Value that configures or reports owner for this contract. */
+owner?: string;
+/** Value that configures or reports evidence for this contract. */
+evidence?: string;
+/** Value that configures or reports blocked reason for this contract. */
+blocked_reason?: string;
+/** Value that configures or reports superseded by for this contract. */
+superseded_by?: string;
+/** Value that configures or reports linked items for this contract. */
+linked_items?: PlanStepLink[];
+/** Value that configures or reports files for this contract. */
+files?: PlanStepFile[];
+/** Value that configures or reports tests for this contract. */
+tests?: PlanStepTest[];
+/** Value that configures or reports docs for this contract. */
+docs?: PlanStepDoc[];
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** ISO 8601 timestamp recording when completed occurred. */
+completed_at?: string;
 }
 /** Documents the plan decision payload exchanged by command, SDK, and package integrations. */
 export interface PlanDecision {
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports decision for this contract. */
-    decision: string;
-    /** Value that configures or reports rationale for this contract. */
-    rationale?: string;
-    /** Value that configures or reports evidence for this contract. */
-    evidence?: string;
-    /** Value that configures or reports step id for this contract. */
-    step_id?: string;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports decision for this contract. */
+decision: string;
+/** Value that configures or reports rationale for this contract. */
+rationale?: string;
+/** Value that configures or reports evidence for this contract. */
+evidence?: string;
+/** Value that configures or reports step id for this contract. */
+step_id?: string;
 }
 /** Documents the plan discovery payload exchanged by command, SDK, and package integrations. */
 export interface PlanDiscovery {
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
-    /** Value that configures or reports step id for this contract. */
-    step_id?: string;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports text for this contract. */
+text: string;
+/** Value that configures or reports step id for this contract. */
+step_id?: string;
 }
 /** Documents the plan validation check payload exchanged by command, SDK, and package integrations. */
 export interface PlanValidationCheck {
-    /** Value that configures or reports text for this contract. */
-    text: string;
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Value that configures or reports expected for this contract. */
-    expected?: string;
+/** Value that configures or reports text for this contract. */
+text: string;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Value that configures or reports expected for this contract. */
+expected?: string;
 }
 /** Documents the item type option definition payload exchanged by command, SDK, and package integrations. */
 export interface ItemTypeOptionDefinition {
-    /** Value that configures or reports key for this contract. */
-    key: string;
-    /** Value that configures or reports values for this contract. */
-    values: string[];
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
+/** Value that configures or reports key for this contract. */
+key: string;
+/** Value that configures or reports values for this contract. */
+values: string[];
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Value that configures or reports description for this contract. */
+description?: string;
 }
 /** Documents the item type command option policy payload exchanged by command, SDK, and package integrations. */
 export interface ItemTypeCommandOptionPolicy {
-    /** Value that configures or reports command for this contract. */
-    command: "create" | "update";
-    /** Value that configures or reports option for this contract. */
-    option: string;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports visible for this contract. */
-    visible?: boolean;
-    /** Whether enabled applies to this operation. */
-    enabled?: boolean;
+/** Value that configures or reports command for this contract. */
+command: "create" | "update";
+/** Value that configures or reports option for this contract. */
+option: string;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports visible for this contract. */
+visible?: boolean;
+/** Whether enabled applies to this operation. */
+enabled?: boolean;
 }
 /** Documents the item type definition payload exchanged by command, SDK, and package integrations. */
 export interface ItemTypeDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Status assigned to newly created items of this type when `--status` is not provided. Falls back to the workflow's open status when unset or invalid. */
-    default_status?: string;
-    /** Agent work can be dispatched automatically; human work needs a decision, and gates track outcomes. Omission inherits the built-in role or defaults custom types to agent work. */
-    execution_role?: "agent" | "human" | "gate";
-    /** Value that configures or reports folder for this contract. */
-    folder?: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Value that configures or reports required create fields for this contract. */
-    required_create_fields?: string[];
-    /** Value that configures or reports required create repeatables for this contract. */
-    required_create_repeatables?: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: ItemTypeOptionDefinition[];
-    /** Value that configures or reports command option policies for this contract. */
-    command_option_policies?: ItemTypeCommandOptionPolicy[];
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Status assigned to newly created items of this type when `--status` is not provided. Falls back to the workflow's open status when unset or invalid. */
+default_status?: string;
+/** Agent work can be dispatched automatically; human work needs a decision, and gates track outcomes. Omission inherits the built-in role or defaults custom types to agent work. */
+execution_role?: "agent" | "human" | "gate";
+/** Value that configures or reports folder for this contract. */
+folder?: string;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Value that configures or reports required create fields for this contract. */
+required_create_fields?: string[];
+/** Value that configures or reports required create repeatables for this contract. */
+required_create_repeatables?: string[];
+/** Value that configures or reports options for this contract. */
+options?: ItemTypeOptionDefinition[];
+/** Value that configures or reports command option policies for this contract. */
+command_option_policies?: ItemTypeCommandOptionPolicy[];
 }
 /** Documents the runtime status definition payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeStatusDefinition {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Value that configures or reports roles for this contract. */
-    roles?: RuntimeStatusRole[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports order for this contract. */
-    order?: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Value that configures or reports roles for this contract. */
+roles?: RuntimeStatusRole[];
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports order for this contract. */
+order?: number;
 }
 /** Declarative JSON-value constraints enforced before custom-field persistence. */
 export interface RuntimeFieldValueSchema {
-    /** Optional JSON value type constraint. */
-    type?: "string" | "number" | "boolean" | "array" | "object";
-    /** Exact JSON value required by this schema branch. */
-    const?: StructuredJsonValue;
-    /** Complete allowed JSON value set. */
-    enum?: StructuredJsonValue[];
-    /** Minimum accepted string length. */
-    min_length?: number;
-    /** Minimum accepted array length. */
-    min_items?: number;
-    /** Optional semantic string format. */
-    format?: "date-time";
-    /** Object-property schemas keyed by the persisted property name. */
-    properties?: Record<string, RuntimeFieldValueSchema>;
-    /** Object properties that must be present. */
-    required?: string[];
-    /** Whether properties absent from `properties` are accepted. */
-    additional_properties?: boolean;
-    /** Schema applied to every array element. */
-    items?: RuntimeFieldValueSchema;
-    /** Alternative schemas of which exactly one must match. */
-    one_of?: RuntimeFieldValueSchema[];
+/** Optional JSON value type constraint. */
+type?: "string" | "number" | "boolean" | "array" | "object";
+/** Exact JSON value required by this schema branch. */
+const?: StructuredJsonValue;
+/** Complete allowed JSON value set. */
+enum?: StructuredJsonValue[];
+/** Minimum accepted string length. */
+min_length?: number;
+/** Minimum accepted array length. */
+min_items?: number;
+/** Optional semantic string format. */
+format?: "date-time";
+/** Object-property schemas keyed by the persisted property name. */
+properties?: Record<string, RuntimeFieldValueSchema>;
+/** Object properties that must be present. */
+required?: string[];
+/** Whether properties absent from `properties` are accepted. */
+additional_properties?: boolean;
+/** Schema applied to every array element. */
+items?: RuntimeFieldValueSchema;
+/** Alternative schemas of which exactly one must match. */
+one_of?: RuntimeFieldValueSchema[];
 }
 /** Documents the runtime field definition payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeFieldDefinition {
-    /** Value that configures or reports key for this contract. */
-    key: string;
-    /** Value that configures or reports metadata key for this contract. */
-    metadata_key?: string;
-    /**
+/** Value that configures or reports key for this contract. */
+key: string;
+/** Value that configures or reports metadata key for this contract. */
+metadata_key?: string;
+/**
      * @deprecated Use metadata_key.
      */
-    front_matter_key?: string;
-    /** Value that configures or reports cli flag for this contract. */
-    cli_flag?: string;
-    /** Value that configures or reports cli aliases for this contract. */
-    cli_aliases?: string[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: RuntimeFieldType;
-    /** Value that configures or reports commands for this contract. */
-    commands?: RuntimeFieldCommand[];
-    /** Value that configures or reports repeatable for this contract. */
-    repeatable?: boolean;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports required on create for this contract. */
-    required_on_create?: boolean;
-    /** Value that configures or reports required types for this contract. */
-    required_types?: string[];
-    /** Value that configures or reports allow unset for this contract. */
-    allow_unset?: boolean;
-    /** Optional semantic JSON-value constraints enforced on create and update. */
-    value_schema?: RuntimeFieldValueSchema;
+front_matter_key?: string;
+/** Value that configures or reports cli flag for this contract. */
+cli_flag?: string;
+/** Value that configures or reports cli aliases for this contract. */
+cli_aliases?: string[];
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: RuntimeFieldType;
+/** Value that configures or reports commands for this contract. */
+commands?: RuntimeFieldCommand[];
+/** Value that configures or reports repeatable for this contract. */
+repeatable?: boolean;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports required on create for this contract. */
+required_on_create?: boolean;
+/** Value that configures or reports required types for this contract. */
+required_types?: string[];
+/** Value that configures or reports allow unset for this contract. */
+allow_unset?: boolean;
+/** Optional semantic JSON-value constraints enforced on create and update. */
+value_schema?: RuntimeFieldValueSchema;
 }
 /** Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeWorkflowDefinition {
-    /** Configured status id representing the draft lifecycle state. */
-    draft_status?: string;
-    /** Configured status id representing the open lifecycle state. */
-    open_status?: string;
-    /** Configured status id representing the in-progress lifecycle state. */
-    in_progress_status?: string;
-    /** Configured status id representing the blocked lifecycle state. */
-    blocked_status?: string;
-    /** Configured status id representing the closed lifecycle state. */
-    close_status?: string;
-    /** Configured status id representing the canceled lifecycle state. */
-    canceled_status?: string;
+/** Configured status id representing the draft lifecycle state. */
+draft_status?: string;
+/** Configured status id representing the open lifecycle state. */
+open_status?: string;
+/** Configured status id representing the in-progress lifecycle state. */
+in_progress_status?: string;
+/** Configured status id representing the blocked lifecycle state. */
+blocked_status?: string;
+/** Configured status id representing the closed lifecycle state. */
+close_status?: string;
+/** Configured status id representing the canceled lifecycle state. */
+canceled_status?: string;
 }
 /** Documents the runtime schema file config payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeSchemaFileConfig {
-    /** Value that configures or reports types for this contract. */
-    types?: string;
-    /** Value that configures or reports statuses for this contract. */
-    statuses?: string;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports workflows for this contract. */
-    workflows?: string;
+/** Value that configures or reports types for this contract. */
+types?: string;
+/** Value that configures or reports statuses for this contract. */
+statuses?: string;
+/** Value that configures or reports fields for this contract. */
+fields?: string;
+/** Value that configures or reports workflows for this contract. */
+workflows?: string;
 }
 /** Per-type allowed-transition rule. A type with no matching entry is unrestricted; a type with an entry allows only the listed [from, to] status pairs (status tokens are resolved case-insensitively through the status registry alias map; a same-status no-op is always allowed). */
 export interface TypeWorkflowDefinition {
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: string;
-    /** Value that configures or reports allowed transitions for this contract. */
-    allowed_transitions: [string, string][];
+/** Schema type that determines the shape and validation rules for this value. */
+type: string;
+/** Value that configures or reports allowed transitions for this contract. */
+allowed_transitions: [string, string][];
 }
 /** Documents the runtime schema settings payload exchanged by command, SDK, and package integrations. */
 export interface RuntimeSchemaSettings {
-    /** Value that configures or reports version for this contract. */
-    version: number;
-    /** Value that configures or reports files for this contract. */
-    files: RuntimeSchemaFileConfig;
-    /** Value that configures or reports statuses for this contract. */
-    statuses: RuntimeStatusDefinition[];
-    /** Value that configures or reports fields for this contract. */
-    fields: RuntimeFieldDefinition[];
-    /** Value that configures or reports workflow for this contract. */
-    workflow: RuntimeWorkflowDefinition;
-    /** Value that configures or reports type workflows for this contract. */
-    type_workflows?: TypeWorkflowDefinition[];
-    /** Value that configures or reports unknown field policy for this contract. */
-    unknown_field_policy: RuntimeUnknownFieldPolicy;
+/** Value that configures or reports version for this contract. */
+version: number;
+/** Value that configures or reports files for this contract. */
+files: RuntimeSchemaFileConfig;
+/** Value that configures or reports statuses for this contract. */
+statuses: RuntimeStatusDefinition[];
+/** Value that configures or reports fields for this contract. */
+fields: RuntimeFieldDefinition[];
+/** Value that configures or reports workflow for this contract. */
+workflow: RuntimeWorkflowDefinition;
+/** Value that configures or reports type workflows for this contract. */
+type_workflows?: TypeWorkflowDefinition[];
+/** Value that configures or reports unknown field policy for this contract. */
+unknown_field_policy: RuntimeUnknownFieldPolicy;
 }
 /** Documents the item test run summary payload exchanged by command, SDK, and package integrations. */
 export interface TestRunMeasurement {
-    /** Stable metric name, such as coverage or p95_latency. */
-    name: string;
-    /** Numeric value recorded by the producing verification run. */
-    value: number;
-    /** Optional domain-specific unit, such as percent, ms, bytes, or count. */
-    unit?: string;
-    /** Optional pass/fail or budget threshold associated with the measurement. */
-    threshold?: number;
-    /** ISO 8601 timestamp binding the measurement to its producing run. */
-    recorded_at: string;
+/** Stable metric name, such as coverage or p95_latency. */
+name: string;
+/** Numeric value recorded by the producing verification run. */
+value: number;
+/** Optional domain-specific unit, such as percent, ms, bytes, or count. */
+unit?: string;
+/** Optional pass/fail or budget threshold associated with the measurement. */
+threshold?: number;
+/** ISO 8601 timestamp binding the measurement to its producing run. */
+recorded_at: string;
 }
 /** Bounded command and tracker-context provenance for one linked-test execution. */
 export interface ItemTestRunExecution {
-    /** Exact linked command selected for execution. */
-    command: string;
-    /** Context mode requested before linked-test overrides or auto-remediation. */
-    requested_pm_context_mode?: "schema" | "tracker" | "auto" | "none";
-    /** Effective context mode used by the linked command. */
-    pm_context_mode?: "schema" | "tracker" | "auto" | "none";
-    /** Effective source-workspace mode used by the linked command. */
-    workspace_context_mode?: "source" | "isolated" | "snapshot";
-    /** Trust classification applied before execution. */
-    trust_reason?: "legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
+/** Exact linked command selected for execution. */
+command: string;
+/** Context mode requested before linked-test overrides or auto-remediation. */
+requested_pm_context_mode?: "schema" | "tracker" | "auto" | "none";
+/** Effective context mode used by the linked command. */
+pm_context_mode?: "schema" | "tracker" | "auto" | "none";
+/** Effective source-workspace mode used by the linked command. */
+workspace_context_mode?: "source" | "isolated" | "snapshot";
+/** Trust classification applied before execution. */
+trust_reason?: "legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
 }
 /** Documents the item test run summary payload exchanged by command, SDK, and package integrations. */
 export interface ItemTestRunSummary {
-    /** Executes the id operation through the package runtime. */
-    run_id: string;
-    /** Value that configures or reports kind for this contract. */
-    kind: "test" | "test-all";
-    /** Lifecycle state reported for status. */
-    status: "passed" | "failed" | "stopped" | "canceled";
-    /** ISO 8601 timestamp recording when started occurred. */
-    started_at: string;
-    /** ISO 8601 timestamp recording when finished occurred. */
-    finished_at: string;
-    /** ISO 8601 timestamp recording when recorded occurred. */
-    recorded_at: string;
-    /** Value that configures or reports attempt for this contract. */
-    attempt?: number;
-    /** Value that configures or reports resumed from for this contract. */
-    resumed_from?: string;
-    /** Value that configures or reports passed for this contract. */
-    passed: number;
-    /** Value that configures or reports failed for this contract. */
-    failed: number;
-    /** Value that configures or reports skipped for this contract. */
-    skipped: number;
-    /** Value that configures or reports items for this contract. */
-    items?: number;
-    /** Value that configures or reports linked tests for this contract. */
-    linked_tests?: number;
-    /** Value that configures or reports fail on skipped triggered for this contract. */
-    fail_on_skipped_triggered?: boolean;
-    /** Bounded, deterministic quantitative evidence produced by this run. */
-    measurements?: TestRunMeasurement[];
-    /** Commands and effective tracker contexts bound to this recorded run. */
-    executions?: ItemTestRunExecution[];
+/** Executes the id operation through the package runtime. */
+run_id: string;
+/** Value that configures or reports kind for this contract. */
+kind: "test" | "test-all";
+/** Lifecycle state reported for status. */
+status: "passed" | "failed" | "stopped" | "canceled";
+/** ISO 8601 timestamp recording when started occurred. */
+started_at: string;
+/** ISO 8601 timestamp recording when finished occurred. */
+finished_at: string;
+/** ISO 8601 timestamp recording when recorded occurred. */
+recorded_at: string;
+/** Value that configures or reports attempt for this contract. */
+attempt?: number;
+/** Value that configures or reports resumed from for this contract. */
+resumed_from?: string;
+/** Value that configures or reports passed for this contract. */
+passed: number;
+/** Value that configures or reports failed for this contract. */
+failed: number;
+/** Value that configures or reports skipped for this contract. */
+skipped: number;
+/** Value that configures or reports items for this contract. */
+items?: number;
+/** Value that configures or reports linked tests for this contract. */
+linked_tests?: number;
+/** Value that configures or reports fail on skipped triggered for this contract. */
+fail_on_skipped_triggered?: boolean;
+/** Bounded, deterministic quantitative evidence produced by this run. */
+measurements?: TestRunMeasurement[];
+/** Commands and effective tracker contexts bound to this recorded run. */
+executions?: ItemTestRunExecution[];
 }
 /** Documents the item metadata payload exchanged by command, SDK, and package integrations. */
 export interface ItemMetadata {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Value that configures or reports description for this contract. */
-    description: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: ItemType;
-    /** On-disk item-metadata format version. Absent means the implicit baseline (version 1) and is never serialized; populated only once an item advances past the baseline via a future storage migration. See core/item/item-format-version. */
-    pm_format_version?: number;
-    /** Schema type that determines the shape and validation rules for this value. */
-    source_type?: string;
-    /** Inputs that customize the type operation. */
-    type_options?: Record<string, string>;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus;
-    /** Value that configures or reports priority for this contract. */
-    priority: 0 | 1 | 2 | 3 | 4;
-    /** Value that configures or reports tags for this contract. */
-    tags: string[];
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports deadline for this contract. */
-    deadline?: string;
-    /** Value that configures or reports reminders for this contract. */
-    reminders?: Reminder[];
-    /** Value that configures or reports events for this contract. */
-    events?: CalendarEvent[];
-    /** ISO 8601 timestamp recording when closed occurred. */
-    closed_at?: string;
-    /** ISO 8601 timestamp recording when the work actually completed. */
-    completed_at?: string;
-    /** Value that configures or reports assignee for this contract. */
-    assignee?: string;
-    /** Internal privacy-safe ownership principal for concurrent agent sessions. */
-    claim_principal?: string;
-    /** Value that configures or reports source owner for this contract. */
-    source_owner?: string;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports estimated minutes for this contract. */
-    estimated_minutes?: number;
-    /** Value that configures or reports acceptance criteria for this contract. */
-    acceptance_criteria?: string;
-    /** Value that configures or reports design for this contract. */
-    design?: string;
-    /** Value that configures or reports external ref for this contract. */
-    external_ref?: string;
-    /** Value that configures or reports definition of ready for this contract. */
-    definition_of_ready?: string;
-    /** Value that configures or reports order for this contract. */
-    order?: number;
-    /** Value that configures or reports goal for this contract. */
-    goal?: string;
-    /** Value that configures or reports objective for this contract. */
-    objective?: string;
-    /** Value that configures or reports value for this contract. */
-    value?: string;
-    /** Value that configures or reports impact for this contract. */
-    impact?: string;
-    /** Value that configures or reports outcome for this contract. */
-    outcome?: string;
-    /** Value that configures or reports why now for this contract. */
-    why_now?: string;
-    /** Value that configures or reports parent for this contract. */
-    parent?: string;
-    /** Value that configures or reports reviewer for this contract. */
-    reviewer?: string;
-    /** Value that configures or reports risk for this contract. */
-    risk?: RiskLevel;
-    /** Value that configures or reports confidence for this contract. */
-    confidence?: ConfidenceValue;
-    /** Value that configures or reports sprint for this contract. */
-    sprint?: string;
-    /** Value that configures or reports release for this contract. */
-    release?: string;
-    /** Value that configures or reports blocked by for this contract. */
-    blocked_by?: string;
-    /** Value that configures or reports blocked reason for this contract. */
-    blocked_reason?: string;
-    /** Value that configures or reports unblock note for this contract. */
-    unblock_note?: string;
-    /** Value that configures or reports reporter for this contract. */
-    reporter?: string;
-    /** Value that configures or reports severity for this contract. */
-    severity?: IssueSeverity;
-    /** Value that configures or reports environment for this contract. */
-    environment?: string;
-    /** Value that configures or reports repro steps for this contract. */
-    repro_steps?: string;
-    /** Value that configures or reports resolution for this contract. */
-    resolution?: string;
-    /** Structured result returned by the expected operation. */
-    expected_result?: string;
-    /** Structured result returned by the actual operation. */
-    actual_result?: string;
-    /** Value that configures or reports affected version for this contract. */
-    affected_version?: string;
-    /** Value that configures or reports fixed version for this contract. */
-    fixed_version?: string;
-    /** Value that configures or reports component for this contract. */
-    component?: string;
-    /** Value that configures or reports regression for this contract. */
-    regression?: boolean;
-    /** Value that configures or reports customer impact for this contract. */
-    customer_impact?: string;
-    /** Value that configures or reports dependencies for this contract. */
-    dependencies?: Dependency[];
-    /** Value that configures or reports comments for this contract. */
-    comments?: Comment[];
-    /** Value that configures or reports notes for this contract. */
-    notes?: LogNote[];
-    /** Value that configures or reports learnings for this contract. */
-    learnings?: LogNote[];
-    /** Value that configures or reports files for this contract. */
-    files?: LinkedFile[];
-    /** Value that configures or reports tests for this contract. */
-    tests?: LinkedTest[];
-    /** Value that configures or reports test runs for this contract. */
-    test_runs?: ItemTestRunSummary[];
-    /** Value that configures or reports docs for this contract. */
-    docs?: LinkedDoc[];
-    /** Value that configures or reports close reason for this contract. */
-    close_reason?: string;
-    /** Value that configures or reports duplicate of for this contract. */
-    duplicate_of?: string;
-    /** Strategy used to control plan behavior. */
-    plan_mode?: PlanMode;
-    /** Value that configures or reports plan scope for this contract. */
-    plan_scope?: string;
-    /** Value that configures or reports plan harness for this contract. */
-    plan_harness?: PlanHarness;
-    /** Value that configures or reports plan steps for this contract. */
-    plan_steps?: PlanStep[];
-    /** Value that configures or reports plan decisions for this contract. */
-    plan_decisions?: PlanDecision[];
-    /** Value that configures or reports plan discoveries for this contract. */
-    plan_discoveries?: PlanDiscovery[];
-    /** Value that configures or reports plan validation for this contract. */
-    plan_validation?: PlanValidationCheck[];
-    /** Value that configures or reports plan resume context for this contract. */
-    plan_resume_context?: string;
-    [key: string]: unknown;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Value that configures or reports description for this contract. */
+description: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: ItemType;
+/** On-disk item-metadata format version. Absent means the implicit baseline (version 1) and is never serialized; populated only once an item advances past the baseline via a future storage migration. See core/item/item-format-version. */
+pm_format_version?: number;
+/** Schema type that determines the shape and validation rules for this value. */
+source_type?: string;
+/** Inputs that customize the type operation. */
+type_options?: Record<string, string>;
+/** Lifecycle state reported for status. */
+status: ItemStatus;
+/** Value that configures or reports priority for this contract. */
+priority: 0 | 1 | 2 | 3 | 4;
+/** Value that configures or reports tags for this contract. */
+tags: string[];
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports deadline for this contract. */
+deadline?: string;
+/** Value that configures or reports reminders for this contract. */
+reminders?: Reminder[];
+/** Value that configures or reports events for this contract. */
+events?: CalendarEvent[];
+/** ISO 8601 timestamp recording when closed occurred. */
+closed_at?: string;
+/** ISO 8601 timestamp recording when the work actually completed. */
+completed_at?: string;
+/** Value that configures or reports assignee for this contract. */
+assignee?: string;
+/** Internal privacy-safe ownership principal for concurrent agent sessions. */
+claim_principal?: string;
+/** Value that configures or reports source owner for this contract. */
+source_owner?: string;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports estimated minutes for this contract. */
+estimated_minutes?: number;
+/** Value that configures or reports acceptance criteria for this contract. */
+acceptance_criteria?: string;
+/** Value that configures or reports design for this contract. */
+design?: string;
+/** Value that configures or reports external ref for this contract. */
+external_ref?: string;
+/** Value that configures or reports definition of ready for this contract. */
+definition_of_ready?: string;
+/** Value that configures or reports order for this contract. */
+order?: number;
+/** Value that configures or reports goal for this contract. */
+goal?: string;
+/** Value that configures or reports objective for this contract. */
+objective?: string;
+/** Value that configures or reports value for this contract. */
+value?: string;
+/** Value that configures or reports impact for this contract. */
+impact?: string;
+/** Value that configures or reports outcome for this contract. */
+outcome?: string;
+/** Value that configures or reports why now for this contract. */
+why_now?: string;
+/** Value that configures or reports parent for this contract. */
+parent?: string;
+/** Value that configures or reports reviewer for this contract. */
+reviewer?: string;
+/** Value that configures or reports risk for this contract. */
+risk?: RiskLevel;
+/** Value that configures or reports confidence for this contract. */
+confidence?: ConfidenceValue;
+/** Value that configures or reports sprint for this contract. */
+sprint?: string;
+/** Value that configures or reports release for this contract. */
+release?: string;
+/** Value that configures or reports blocked by for this contract. */
+blocked_by?: string;
+/** Value that configures or reports blocked reason for this contract. */
+blocked_reason?: string;
+/** Value that configures or reports unblock note for this contract. */
+unblock_note?: string;
+/** Value that configures or reports reporter for this contract. */
+reporter?: string;
+/** Value that configures or reports severity for this contract. */
+severity?: IssueSeverity;
+/** Value that configures or reports environment for this contract. */
+environment?: string;
+/** Value that configures or reports repro steps for this contract. */
+repro_steps?: string;
+/** Value that configures or reports resolution for this contract. */
+resolution?: string;
+/** Structured result returned by the expected operation. */
+expected_result?: string;
+/** Structured result returned by the actual operation. */
+actual_result?: string;
+/** Value that configures or reports affected version for this contract. */
+affected_version?: string;
+/** Value that configures or reports fixed version for this contract. */
+fixed_version?: string;
+/** Value that configures or reports component for this contract. */
+component?: string;
+/** Value that configures or reports regression for this contract. */
+regression?: boolean;
+/** Value that configures or reports customer impact for this contract. */
+customer_impact?: string;
+/** Value that configures or reports dependencies for this contract. */
+dependencies?: Dependency[];
+/** Value that configures or reports comments for this contract. */
+comments?: Comment[];
+/** Value that configures or reports notes for this contract. */
+notes?: LogNote[];
+/** Value that configures or reports learnings for this contract. */
+learnings?: LogNote[];
+/** Value that configures or reports files for this contract. */
+files?: LinkedFile[];
+/** Value that configures or reports tests for this contract. */
+tests?: LinkedTest[];
+/** Value that configures or reports test runs for this contract. */
+test_runs?: ItemTestRunSummary[];
+/** Value that configures or reports docs for this contract. */
+docs?: LinkedDoc[];
+/** Value that configures or reports close reason for this contract. */
+close_reason?: string;
+/** Value that configures or reports duplicate of for this contract. */
+duplicate_of?: string;
+/** Strategy used to control plan behavior. */
+plan_mode?: PlanMode;
+/** Value that configures or reports plan scope for this contract. */
+plan_scope?: string;
+/** Value that configures or reports plan harness for this contract. */
+plan_harness?: PlanHarness;
+/** Value that configures or reports plan steps for this contract. */
+plan_steps?: PlanStep[];
+/** Value that configures or reports plan decisions for this contract. */
+plan_decisions?: PlanDecision[];
+/** Value that configures or reports plan discoveries for this contract. */
+plan_discoveries?: PlanDiscovery[];
+/** Value that configures or reports plan validation for this contract. */
+plan_validation?: PlanValidationCheck[];
+/** Value that configures or reports plan resume context for this contract. */
+plan_resume_context?: string;
+[key: string]: unknown;
 }
 /** Documents the item document payload exchanged by command, SDK, and package integrations. */
 export interface ItemDocument {
-    /** Value that configures or reports metadata for this contract. */
-    metadata: ItemMetadata;
-    /** Value that configures or reports body for this contract. */
-    body: string;
+/** Value that configures or reports metadata for this contract. */
+metadata: ItemMetadata;
+/** Value that configures or reports body for this contract. */
+body: string;
 }
 /** Documents the history patch op payload exchanged by command, SDK, and package integrations. */
 export interface HistoryPatchOp {
-    /** Value that configures or reports op for this contract. */
-    op: "add" | "remove" | "replace" | "move" | "copy" | "test";
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports from for this contract. */
-    from?: string;
-    /** Value that configures or reports value for this contract. */
-    value?: unknown;
+/** Value that configures or reports op for this contract. */
+op: "add" | "remove" | "replace" | "move" | "copy" | "test";
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports from for this contract. */
+from?: string;
+/** Value that configures or reports value for this contract. */
+value?: unknown;
 }
 /** Immutable evidence retained whenever history maintenance replaces anchors or patch operations. */
 export interface HistoryReanchorEvidence {
-    /** Algorithm of the retained item and record anchors; absent means SHA-256. */
-    hash_algorithm?: string;
-    /** Before-state anchor present on the record before re-anchoring. */
-    before_hash: string;
-    /** After-state anchor present on the record before re-anchoring. */
-    after_hash: string;
-    /** Item hash epoch present before re-anchoring. */
-    item_hash_version?: number;
-    /** Hash of the original patch, retained even when redaction forbids retaining its values. */
-    patch_hash: string;
-    /** Original patch operations when repair replaced or skipped recorded intent. */
-    patch?: HistoryPatchOp[];
-    /** Record-integrity epoch protecting the pre-re-anchor record. */
-    record_hash_version?: number;
-    /** Record hash protecting the pre-re-anchor attribution and operation metadata. */
-    record_hash?: string;
-    /** Exact prior sealed record when maintenance can retain its non-sensitive payload. */
-    record?: HistoryEntry;
+/** Algorithm of the retained item and record anchors; absent means SHA-256. */
+hash_algorithm?: string;
+/** Before-state anchor present on the record before re-anchoring. */
+before_hash: string;
+/** After-state anchor present on the record before re-anchoring. */
+after_hash: string;
+/** Item hash epoch present before re-anchoring. */
+item_hash_version?: number;
+/** Hash of the original patch, retained even when redaction forbids retaining its values. */
+patch_hash: string;
+/** Original patch operations when repair replaced or skipped recorded intent. */
+patch?: HistoryPatchOp[];
+/** Record-integrity epoch protecting the pre-re-anchor record. */
+record_hash_version?: number;
+/** Record hash protecting the pre-re-anchor attribution and operation metadata. */
+record_hash?: string;
+/** Exact prior sealed record when maintenance can retain its non-sensitive payload. */
+record?: HistoryEntry;
 }
 /** Documents the history entry payload exchanged by command, SDK, and package integrations. */
 export interface HistoryEntry {
-    /** Algorithm for before_hash, after_hash and record_hash; absent means legacy SHA-256. */
-    hash_algorithm?: string;
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Provenance of the author selected for this event. Absent only on legacy entries. */
-    author_source?: "asserted" | "configured" | "detected" | "unknown";
-    /** Observed agent harness, independent from the effective author precedence. */
-    agent_harness?: string;
-    /** Observed agent model identifier, retained in local history. */
-    agent_model?: string;
-    /** Bounded signal class that supplied `agent_model`. */
-    agent_model_source?: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
-    /** Privacy-safe fingerprint distinguishing concurrent harness invocations. */
-    agent_instance?: string;
-    /** Extensible local-only descriptive agent provenance; null means declared but unavailable. */
-    agent_provenance?: Readonly<Record<string, {
-        /** Bounded descriptive value observed for this dimension. */
-        value: string;
-        /** Bounded signal class that supplied the value. */
-        source: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
-        /** Confidence attached to a semantic inference. */
-        confidence?: "high" | "medium" | "low";
-        /** Versioned semantic inference rule. */
-        rule_version?: "v2";
-        /** Bounded item and lineage references supporting the inference. */
-        evidence?: readonly string[];
-    } | null>>;
-    /** Stable declared episode identity; absent on legacy or undeclared events. */
-    agent_episode?: {
-        /** Stable caller-declared episode join key. */
-        id: string;
-        /** Human-readable episode purpose retained in local history. */
-        label?: string;
-        /** Parent episode key for delegated or nested work. */
-        parent_id?: string;
-    };
-    /** Value that configures or reports op for this contract. */
-    op: string;
-    /** Declared semantic effect used by recency consumers. Absent on legacy entries. */
-    event_class?: "substantive" | "maintenance";
-    /** Value that configures or reports patch for this contract. */
-    patch: HistoryPatchOp[];
-    /** Value that configures or reports before hash for this contract. */
-    before_hash: string;
-    /** Value that configures or reports after hash for this contract. */
-    after_hash: string;
-    /** Version of the item canonicalization used by before_hash and after_hash. Absent on legacy streams. */
-    item_hash_version?: number;
-    /** Version of the canonical immutable-record envelope. Absent on legacy entries whose coverage is item-state-only. */
-    record_hash_version?: number;
-    /** Digest covering immutable metadata, patch and anchors under hash_algorithm. */
-    record_hash?: string;
-    /** Append-only evidence for every prior anchor or patch representation replaced by maintenance. */
-    reanchor_evidence?: HistoryReanchorEvidence[];
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message?: string;
-    /** Structured audit metadata that does not alter replayed item state. */
-    context?: Record<string, unknown>;
+/** Algorithm for before_hash, after_hash and record_hash; absent means legacy SHA-256. */
+hash_algorithm?: string;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Provenance of the author selected for this event. Absent only on legacy entries. */
+author_source?: "asserted" | "configured" | "detected" | "unknown";
+/** Observed agent harness, independent from the effective author precedence. */
+agent_harness?: string;
+/** Observed agent model identifier, retained in local history. */
+agent_model?: string;
+/** Bounded signal class that supplied `agent_model`. */
+agent_model_source?: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
+/** Privacy-safe fingerprint distinguishing concurrent harness invocations. */
+agent_instance?: string;
+/** Extensible local-only descriptive agent provenance; null means declared but unavailable. */
+agent_provenance?: Readonly<Record<string, {
+/** Bounded descriptive value observed for this dimension. */
+value: string;
+/** Bounded signal class that supplied the value. */
+source: "override" | "environment" | "mcp_client" | "argv" | "host" | "session" | "probe" | "inferred";
+/** Confidence attached to a semantic inference. */
+confidence?: "high" | "medium" | "low";
+/** Versioned semantic inference rule. */
+rule_version?: "v2";
+/** Bounded item and lineage references supporting the inference. */
+evidence?: readonly string[];
+} | null>>;
+/** Stable declared episode identity; absent on legacy or undeclared events. */
+agent_episode?: {
+/** Stable caller-declared episode join key. */
+id: string;
+/** Human-readable episode purpose retained in local history. */
+label?: string;
+/** Parent episode key for delegated or nested work. */
+parent_id?: string;
+};
+/** Value that configures or reports op for this contract. */
+op: string;
+/** Declared semantic effect used by recency consumers. Absent on legacy entries. */
+event_class?: "substantive" | "maintenance";
+/** Value that configures or reports patch for this contract. */
+patch: HistoryPatchOp[];
+/** Value that configures or reports before hash for this contract. */
+before_hash: string;
+/** Value that configures or reports after hash for this contract. */
+after_hash: string;
+/** Version of the item canonicalization used by before_hash and after_hash. Absent on legacy streams. */
+item_hash_version?: number;
+/** Version of the canonical immutable-record envelope. Absent on legacy entries whose coverage is item-state-only. */
+record_hash_version?: number;
+/** Digest covering immutable metadata, patch and anchors under hash_algorithm. */
+record_hash?: string;
+/** Append-only evidence for every prior anchor or patch representation replaced by maintenance. */
+reanchor_evidence?: HistoryReanchorEvidence[];
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message?: string;
+/** Structured audit metadata that does not alter replayed item state. */
+context?: Record<string, unknown>;
 }
 /** Supported values accepted by the context depth contract. */
 export declare const CONTEXT_DEPTH_VALUES: readonly ["brief", "standard", "deep", "full"];
@@ -885,66 +889,66 @@ export declare const CONTEXT_SECTION_VALUES: readonly ["hierarchy", "activity",
 export type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];
 /** Documents the context section settings payload exchanged by command, SDK, and package integrations. */
 export interface ContextSectionSettings {
-    /** Value that configures or reports hierarchy for this contract. */
-    hierarchy: boolean;
-    /** Value that configures or reports activity for this contract. */
-    activity: boolean;
-    /** Value that configures or reports progress for this contract. */
-    progress: boolean;
-    /** Value that configures or reports recently created for this contract. */
-    recently_created: boolean;
-    /** Value that configures or reports unparented for this contract. */
-    unparented: boolean;
-    /** Value that configures or reports blockers for this contract. */
-    blockers: boolean;
-    /** Value that configures or reports files for this contract. */
-    files: boolean;
-    /** Value that configures or reports workload for this contract. */
-    workload: boolean;
-    /** Value that configures or reports staleness for this contract. */
-    staleness: boolean;
-    /** Value that configures or reports tests for this contract. */
-    tests: boolean;
+/** Value that configures or reports hierarchy for this contract. */
+hierarchy: boolean;
+/** Value that configures or reports activity for this contract. */
+activity: boolean;
+/** Value that configures or reports progress for this contract. */
+progress: boolean;
+/** Value that configures or reports recently created for this contract. */
+recently_created: boolean;
+/** Value that configures or reports unparented for this contract. */
+unparented: boolean;
+/** Value that configures or reports blockers for this contract. */
+blockers: boolean;
+/** Value that configures or reports files for this contract. */
+files: boolean;
+/** Value that configures or reports workload for this contract. */
+workload: boolean;
+/** Value that configures or reports staleness for this contract. */
+staleness: boolean;
+/** Value that configures or reports tests for this contract. */
+tests: boolean;
 }
 /** Documents the context settings payload exchanged by command, SDK, and package integrations. */
 export interface ContextSettings {
-    /** Fallback depth used when callers do not provide an override. */
-    default_depth: ContextDepth;
-    /** Value that configures or reports activity limit for this contract. */
-    activity_limit: number;
-    /** Value that configures or reports stale threshold days for this contract. */
-    stale_threshold_days: number;
-    /** Value that configures or reports sections for this contract. */
-    sections: ContextSectionSettings;
+/** Fallback depth used when callers do not provide an override. */
+default_depth: ContextDepth;
+/** Value that configures or reports activity limit for this contract. */
+activity_limit: number;
+/** Value that configures or reports stale threshold days for this contract. */
+stale_threshold_days: number;
+/** Value that configures or reports sections for this contract. */
+sections: ContextSectionSettings;
 }
 /** Documents the governance settings payload exchanged by command, SDK, and package integrations. */
 export interface GovernanceSettings {
-    /** Value that configures or reports preset for this contract. */
-    preset: GovernancePreset;
-    /** Value that configures or reports ownership enforcement for this contract. */
-    ownership_enforcement: GovernanceOwnershipEnforcement;
-    /** Creates mode default using the validated operation inputs. */
-    create_mode_default: GovernanceCreateModeDefault;
-    /** Value that configures or reports close validation default for this contract. */
-    close_validation_default: GovernanceCloseValidationDefault;
-    /** Value that configures or reports require close reason for this contract. */
-    require_close_reason: boolean;
-    /** Value that configures or reports parent reference for this contract. */
-    parent_reference: ParentReferencePolicy;
-    /** Value that configures or reports metadata profile for this contract. */
-    metadata_profile: ValidateMetadataProfile;
-    /** Value that configures or reports force required for stale lock for this contract. */
-    force_required_for_stale_lock: boolean;
-    /** Schema type that determines the shape and validation rules for this value. */
-    create_default_type?: string;
-    /** Per-type allowed-transition enforcement mode for `pm update --status`. Read raw from settings (not preset-derived) so existing projects are unaffected when unset; defaults to "off". */
-    workflow_enforcement?: GovernanceWorkflowEnforcement;
-    /** Create/copy near-duplicate enforcement mode. */
-    duplicate_detection_mode: GovernanceDuplicateDetectionMode;
-    /** Inclusive similarity floor on the zero-to-one scale. */
-    duplicate_detection_threshold: number;
-    /** Maximum advisory candidates attached to a mutation result. */
-    duplicate_detection_limit: number;
+/** Value that configures or reports preset for this contract. */
+preset: GovernancePreset;
+/** Value that configures or reports ownership enforcement for this contract. */
+ownership_enforcement: GovernanceOwnershipEnforcement;
+/** Creates mode default using the validated operation inputs. */
+create_mode_default: GovernanceCreateModeDefault;
+/** Value that configures or reports close validation default for this contract. */
+close_validation_default: GovernanceCloseValidationDefault;
+/** Value that configures or reports require close reason for this contract. */
+require_close_reason: boolean;
+/** Value that configures or reports parent reference for this contract. */
+parent_reference: ParentReferencePolicy;
+/** Value that configures or reports metadata profile for this contract. */
+metadata_profile: ValidateMetadataProfile;
+/** Value that configures or reports force required for stale lock for this contract. */
+force_required_for_stale_lock: boolean;
+/** Schema type that determines the shape and validation rules for this value. */
+create_default_type?: string;
+/** Per-type allowed-transition enforcement mode for `pm update --status`. Read raw from settings (not preset-derived) so existing projects are unaffected when unset; defaults to "off". */
+workflow_enforcement?: GovernanceWorkflowEnforcement;
+/** Create/copy near-duplicate enforcement mode. */
+duplicate_detection_mode: GovernanceDuplicateDetectionMode;
+/** Inclusive similarity floor on the zero-to-one scale. */
+duplicate_detection_threshold: number;
+/** Maximum advisory candidates attached to a mutation result. */
+duplicate_detection_limit: number;
 }
 /** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */
 export type ExtensionPolicyMode = "off" | "warn" | "enforce";
@@ -954,88 +958,88 @@ export type ExtensionTrustMode = "off" | "warn" | "enforce";
 export type ExtensionSandboxProfile = "none" | "restricted" | "strict";
 /** Documents the extension policy override settings payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionPolicyOverrideSettings {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Whether disabled applies to this operation. */
-    disabled?: boolean;
-    /** Value that configures or reports require trusted for this contract. */
-    require_trusted?: boolean;
-    /** Value that configures or reports require provenance for this contract. */
-    require_provenance?: boolean;
-    /** Value that configures or reports sandbox profile for this contract. */
-    sandbox_profile?: ExtensionSandboxProfile;
-    /** Value that configures or reports allowed capabilities for this contract. */
-    allowed_capabilities?: string[];
-    /** Value that configures or reports blocked capabilities for this contract. */
-    blocked_capabilities?: string[];
-    /** Value that configures or reports allowed surfaces for this contract. */
-    allowed_surfaces?: string[];
-    /** Value that configures or reports blocked surfaces for this contract. */
-    blocked_surfaces?: string[];
-    /** Value that configures or reports allowed commands for this contract. */
-    allowed_commands?: string[];
-    /** Value that configures or reports blocked commands for this contract. */
-    blocked_commands?: string[];
-    /** Value that configures or reports allowed actions for this contract. */
-    allowed_actions?: string[];
-    /** Value that configures or reports blocked actions for this contract. */
-    blocked_actions?: string[];
-    /** Value that configures or reports allowed services for this contract. */
-    allowed_services?: string[];
-    /** Value that configures or reports blocked services for this contract. */
-    blocked_services?: string[];
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Whether disabled applies to this operation. */
+disabled?: boolean;
+/** Value that configures or reports require trusted for this contract. */
+require_trusted?: boolean;
+/** Value that configures or reports require provenance for this contract. */
+require_provenance?: boolean;
+/** Value that configures or reports sandbox profile for this contract. */
+sandbox_profile?: ExtensionSandboxProfile;
+/** Value that configures or reports allowed capabilities for this contract. */
+allowed_capabilities?: string[];
+/** Value that configures or reports blocked capabilities for this contract. */
+blocked_capabilities?: string[];
+/** Value that configures or reports allowed surfaces for this contract. */
+allowed_surfaces?: string[];
+/** Value that configures or reports blocked surfaces for this contract. */
+blocked_surfaces?: string[];
+/** Value that configures or reports allowed commands for this contract. */
+allowed_commands?: string[];
+/** Value that configures or reports blocked commands for this contract. */
+blocked_commands?: string[];
+/** Value that configures or reports allowed actions for this contract. */
+allowed_actions?: string[];
+/** Value that configures or reports blocked actions for this contract. */
+blocked_actions?: string[];
+/** Value that configures or reports allowed services for this contract. */
+allowed_services?: string[];
+/** Value that configures or reports blocked services for this contract. */
+blocked_services?: string[];
 }
 /** Documents the extension policy settings payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionPolicySettings {
-    /** Value that configures or reports mode for this contract. */
-    mode: ExtensionPolicyMode;
-    /** Strategy used to control trust behavior. */
-    trust_mode: ExtensionTrustMode;
-    /** Value that configures or reports require provenance for this contract. */
-    require_provenance: boolean;
-    /** Value that configures or reports trusted extensions for this contract. */
-    trusted_extensions: string[];
-    /** Fallback sandbox profile used when callers do not provide an override. */
-    default_sandbox_profile: ExtensionSandboxProfile;
-    /** Value that configures or reports allowed extensions for this contract. */
-    allowed_extensions: string[];
-    /** Value that configures or reports blocked extensions for this contract. */
-    blocked_extensions: string[];
-    /** Value that configures or reports allowed capabilities for this contract. */
-    allowed_capabilities: string[];
-    /** Value that configures or reports blocked capabilities for this contract. */
-    blocked_capabilities: string[];
-    /** Value that configures or reports allowed surfaces for this contract. */
-    allowed_surfaces: string[];
-    /** Value that configures or reports blocked surfaces for this contract. */
-    blocked_surfaces: string[];
-    /** Value that configures or reports allowed commands for this contract. */
-    allowed_commands: string[];
-    /** Value that configures or reports blocked commands for this contract. */
-    blocked_commands: string[];
-    /** Value that configures or reports allowed actions for this contract. */
-    allowed_actions: string[];
-    /** Value that configures or reports blocked actions for this contract. */
-    blocked_actions: string[];
-    /** Value that configures or reports allowed services for this contract. */
-    allowed_services: string[];
-    /** Value that configures or reports blocked services for this contract. */
-    blocked_services: string[];
-    /** Value that configures or reports extension overrides for this contract. */
-    extension_overrides: ExtensionPolicyOverrideSettings[];
+/** Value that configures or reports mode for this contract. */
+mode: ExtensionPolicyMode;
+/** Strategy used to control trust behavior. */
+trust_mode: ExtensionTrustMode;
+/** Value that configures or reports require provenance for this contract. */
+require_provenance: boolean;
+/** Value that configures or reports trusted extensions for this contract. */
+trusted_extensions: string[];
+/** Fallback sandbox profile used when callers do not provide an override. */
+default_sandbox_profile: ExtensionSandboxProfile;
+/** Value that configures or reports allowed extensions for this contract. */
+allowed_extensions: string[];
+/** Value that configures or reports blocked extensions for this contract. */
+blocked_extensions: string[];
+/** Value that configures or reports allowed capabilities for this contract. */
+allowed_capabilities: string[];
+/** Value that configures or reports blocked capabilities for this contract. */
+blocked_capabilities: string[];
+/** Value that configures or reports allowed surfaces for this contract. */
+allowed_surfaces: string[];
+/** Value that configures or reports blocked surfaces for this contract. */
+blocked_surfaces: string[];
+/** Value that configures or reports allowed commands for this contract. */
+allowed_commands: string[];
+/** Value that configures or reports blocked commands for this contract. */
+blocked_commands: string[];
+/** Value that configures or reports allowed actions for this contract. */
+allowed_actions: string[];
+/** Value that configures or reports blocked actions for this contract. */
+blocked_actions: string[];
+/** Value that configures or reports allowed services for this contract. */
+allowed_services: string[];
+/** Value that configures or reports blocked services for this contract. */
+blocked_services: string[];
+/** Value that configures or reports extension overrides for this contract. */
+extension_overrides: ExtensionPolicyOverrideSettings[];
 }
 /** Documents the agent guidance settings payload exchanged by command, SDK, and package integrations. */
 export interface AgentGuidanceSettings {
-    /** Value that configures or reports prompt completed for this contract. */
-    prompt_completed: boolean;
-    /** Value that configures or reports declined for this contract. */
-    declined: boolean;
-    /** ISO 8601 timestamp recording when declined occurred. */
-    declined_at: string;
-    /** Value that configures or reports template version for this contract. */
-    template_version: number;
-    /** Value that configures or reports last checked files for this contract. */
-    last_checked_files: string[];
+/** Value that configures or reports prompt completed for this contract. */
+prompt_completed: boolean;
+/** Value that configures or reports declined for this contract. */
+declined: boolean;
+/** ISO 8601 timestamp recording when declined occurred. */
+declined_at: string;
+/** Value that configures or reports template version for this contract. */
+template_version: number;
+/** Value that configures or reports last checked files for this contract. */
+last_checked_files: string[];
 }
 /** Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts. */
 export type SearchMutationRefreshPolicy = "cache_only" | "semantic_configured" | "semantic_auto";
@@ -1043,19 +1047,19 @@ export type SearchMutationRefreshPolicy = "cache_only" | "semantic_configured" |
 export type SearchDefaultMode = "auto" | "keyword" | "semantic" | "hybrid";
 /** Documents the search query expansion settings payload exchanged by command, SDK, and package integrations. */
 export interface SearchQueryExpansionSettings {
-    /** Whether enabled applies to this operation. */
-    enabled: boolean;
-    /** Value that configures or reports provider for this contract. */
-    provider: string;
+/** Whether enabled applies to this operation. */
+enabled: boolean;
+/** Value that configures or reports provider for this contract. */
+provider: string;
 }
 /** Documents the search rerank settings payload exchanged by command, SDK, and package integrations. */
 export interface SearchRerankSettings {
-    /** Whether enabled applies to this operation. */
-    enabled: boolean;
-    /** Value that configures or reports model for this contract. */
-    model: string;
-    /** Value that configures or reports top k for this contract. */
-    top_k: number;
+/** Whether enabled applies to this operation. */
+enabled: boolean;
+/** Value that configures or reports model for this contract. */
+model: string;
+/** Value that configures or reports top k for this contract. */
+top_k: number;
 }
 /**
  * Config-driven policy for automatic history-stream compaction triage.
@@ -1068,202 +1072,202 @@ export interface SearchRerankSettings {
  * additionally signals that scheduled/automatic sweeps are expected.
  */
 export interface HistoryCompactPolicy {
-    /** Whether enabled applies to this operation. */
-    enabled: boolean;
-    /** Value that configures or reports max entries for this contract. */
-    max_entries: number;
-    /** Value that configures or reports trigger for this contract. */
-    trigger: "health_warn" | "auto";
+/** Whether enabled applies to this operation. */
+enabled: boolean;
+/** Value that configures or reports max entries for this contract. */
+max_entries: number;
+/** Value that configures or reports trigger for this contract. */
+trigger: "health_warn" | "auto";
 }
 /** Documents the pm settings payload exchanged by command, SDK, and package integrations. */
 export interface PmSettings {
-    /** Value that configures or reports version for this contract. */
-    version: number;
-    /** Value that configures or reports id prefix for this contract. */
-    id_prefix: string;
-    /** Item id allocation policy: `token_length` is the number of random base36 characters appended to `id_prefix` when minting ids (4–12). Longer tokens shrink cross-branch collision odds for concurrent multi-agent workflows: 4 chars ≈ 1.68M ids (~1% birthday-collision at ~184 items), 6 chars ≈ 2.18B (~1% at ~6.6k items), 8 chars ≈ 2.8T (~1% at ~238k items). */
-    ids: {
-        token_length: number;
-    };
-    /** Value that configures or reports author default for this contract. */
-    author_default: string;
-    /** Declarative workspace additions to the built-in agent identity registry. */
-    agent_identity?: {
-        /** Whether bounded local harness-owned provenance probes may run. */
-        probes_enabled?: boolean;
-        /** Versioned read-time interpretation for legacy free-text authors. */
-        identity_vocabulary?: {
-            /** Reproducible vocabulary revision recorded in read projections. */
-            version: number;
-            /** Exact literal author spellings mapped to canonical harness namespaces. */
-            aliases: Record<string, string>;
-        };
-        /** Pure, bounded harness signal descriptors evaluated after built-ins. */
-        harness_signals: Array<{
-            /** Stable lowercase harness namespace. */
-            harness: string;
-            /** Environment keys whose non-blank presence identifies the harness. */
-            environment_keys?: string[];
-            /** Environment keys checked in order for a model identifier. */
-            model_environment_keys?: string[];
-            /** Environment keys checked in order for a session identifier. */
-            session_environment_keys?: string[];
-            /** Extensible provenance dimensions mapped to ordered environment keys. */
-            provenance_environment_keys?: Record<string, string[]>;
-            /** Provenance dimensions mapped to audited built-in local resolvers. */
-            provenance_resolvers?: Record<string, "ai_agent_version" | "claude_session_file">;
-            /** Dimensions intentionally unavailable from this harness environment. */
-            provenance_unavailable_dimensions?: string[];
-            /** Literal executable or argument markers. */
-            argv_markers?: string[];
-            /** Literal MCP client-name markers. */
-            client_names?: string[];
-        }>;
-    };
-    /** Shared pre-write provenance, secret, and stale-work policy. */
-    mutation_guard: {
-        /** Reject mutations whose resolved author is `unknown`. */
-        require_attributed_author: boolean;
-        /** Credential-shaped content policy applied before CLI/MCP mutation dispatch. */
-        secret_guard: "off" | "advise" | "block";
-        /** Age threshold for unclaimed in-progress work surfaced by health. */
-        stale_in_progress_hours: number;
-    };
-    /** Value that configures or reports item format for this contract. */
-    item_format: ItemFormat;
-    /** Value that configures or reports locks for this contract. */
-    locks: {
-        ttl_seconds: number;
-        /** Bounded wait budget (milliseconds) for acquiring a contended item lock before surfacing lock_conflict. 0 disables waiting (fail-fast). Overridable per invocation via PM_LOCK_WAIT_MS. */
-        wait_ms: number;
-    };
-    /** Retention policy for local crash-recovery receipts: bulk-mutation rollback checkpoints written by `update-many`/`close-many` AND terminal SDK workspace-transaction journals under `transactions/sdk/`. `pm gc --scope checkpoints` prunes checkpoint files older than `retention_days`; `pm gc --scope transactions` prunes committed/compensated journals older than the same window. Unparseable receipts and in-flight journals are always retained (safety-first, mirroring the stale-lock sweep). */
-    checkpoints: {
-        retention_days: number;
-    };
-    /** Value that configures or reports output for this contract. */
-    output: {
-        default_format: "toon" | "json";
-    };
-    /** Agent and human interaction preferences that do not change command semantics. */
-    ux?: {
-        /** Emit one stderr migration hint when a deprecated command alias is invoked. */
-        deprecation_hints?: boolean;
-    };
-    /** Value that configures or reports history for this contract. */
-    history: {
-        missing_stream: "auto_create" | "strict_error";
-        compact_policy: HistoryCompactPolicy;
-    };
-    /** Value that configures or reports validation for this contract. */
-    validation: {
-        sprint_release_format: SprintReleaseFormatPolicy;
-        parent_reference: ParentReferencePolicy;
-        metadata_profile: ValidateMetadataProfile;
-        metadata_required_fields: ValidateMetadataRequiredField[];
-        lifecycle_stale_blocker_reason_patterns: string[];
-        lifecycle_closure_like_blocked_reason_patterns: string[];
-        lifecycle_closure_like_resolution_patterns: string[];
-        lifecycle_closure_like_actual_result_patterns: string[];
-        /** Per-type default estimates (minutes) used by `pm validate --auto-fix --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212). Keys are item type names (case-insensitive); values are positive minutes that override the built-in defaults. Empty by default. */
-        estimate_defaults_by_type: Record<string, number>;
-    };
-    /** Value that configures or reports governance for this contract. */
-    governance: GovernanceSettings;
-    /** Value that configures or reports workflow for this contract. */
-    workflow: {
-        definition_of_done: string[];
-    };
-    /** Value that configures or reports testing for this contract. */
-    testing: {
-        record_results_to_items: boolean;
-        /** Permit explicit one-shot execution of commands not yet trusted by this clone. */
-        allow_untrusted_linked_tests: boolean;
-    };
-    /** Value that configures or reports telemetry for this contract. */
-    telemetry: {
-        enabled: boolean;
-        first_run_prompt_completed: boolean;
-        capture_level: "minimal" | "redacted" | "max";
-        endpoint: string;
-        installation_id: string;
-        retention_days: number;
-    };
-    /** Value that configures or reports agent guidance for this contract. */
-    agent_guidance: AgentGuidanceSettings;
-    /** Value that configures or reports item types for this contract. */
-    item_types: {
-        definitions: ItemTypeDefinition[];
-    };
-    /** Value that configures or reports schema for this contract. */
-    schema: RuntimeSchemaSettings;
-    /** Value that configures or reports extensions for this contract. */
-    extensions: {
-        enabled: string[];
-        disabled: string[];
-        policy: ExtensionPolicySettings;
-    };
-    /** Value that configures or reports search for this contract. */
-    search: {
-        score_threshold: number;
-        hybrid_semantic_weight: number;
-        max_results: number;
-        embedding_model: string;
-        embedding_corpus_max_characters?: number;
-        embedding_batch_size: number;
-        embedding_timeout_ms: number;
-        scanner_max_batch_retries: number;
-        provider?: string;
-        /** Mode a search runs in when the caller passes none: `auto` (default) resolves to hybrid when semantic search is explicitly configured and runnable, keyword otherwise; a concrete mode pins it. Optional on the type so existing settings literals stay valid; readers always normalize it. */
-        default_mode?: SearchDefaultMode;
-        /** Optional allow-list of corpus field names embedded for semantic search (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or empty, the full default field set is used (backward compatible). When set, only the named fields are embedded — letting teams opt structured signals (priority, assignee, risk, acceptance_criteria, etc.) in/out for token efficiency. Changing this re-flags items stale on the next refresh. */
-        corpus_fields?: string[];
-        mutation_refresh_policy: SearchMutationRefreshPolicy;
-        query_expansion: SearchQueryExpansionSettings;
-        rerank: SearchRerankSettings;
-        /** Offline BM25 lexical-ranking parameters (pm-75k9), applied when `search.provider` is `bm25` (or auto-selected as the offline fallback) for semantic/hybrid queries. `k1` controls term-frequency saturation, `b` controls document-length normalization. Unset → Lucene defaults (1.2/0.75). */
-        bm25?: {
-            k1?: number;
-            b?: number;
-        };
-        tuning?: {
-            title_exact_bonus?: number;
-            title_weight?: number;
-            description_weight?: number;
-            tags_weight?: number;
-            status_weight?: number;
-            body_weight?: number;
-            comments_weight?: number;
-            notes_weight?: number;
-            learnings_weight?: number;
-            dependencies_weight?: number;
-            linked_content_weight?: number;
-        };
-    };
-    /** Value that configures or reports providers for this contract. */
-    providers: {
-        openai: {
-            base_url: string;
-            api_key: string;
-            model: string;
-        };
-        ollama: {
-            base_url: string;
-            model: string;
-        };
-    };
-    /** Value that configures or reports context for this contract. */
-    context: ContextSettings;
-    /** Value that configures or reports vector store for this contract. */
-    vector_store: {
-        adapter?: string;
-        collection_name: string;
-        qdrant: {
-            url: string;
-            api_key: string;
-        };
-        lancedb: {
-            path: string;
-        };
-    };
+/** Value that configures or reports version for this contract. */
+version: number;
+/** Value that configures or reports id prefix for this contract. */
+id_prefix: string;
+/** Item id allocation policy: `token_length` is the number of random base36 characters appended to `id_prefix` when minting ids (4–12). Longer tokens shrink cross-branch collision odds for concurrent multi-agent workflows: 4 chars ≈ 1.68M ids (~1% birthday-collision at ~184 items), 6 chars ≈ 2.18B (~1% at ~6.6k items), 8 chars ≈ 2.8T (~1% at ~238k items). */
+ids: {
+token_length: number;
+};
+/** Value that configures or reports author default for this contract. */
+author_default: string;
+/** Declarative workspace additions to the built-in agent identity registry. */
+agent_identity?: {
+/** Whether bounded local harness-owned provenance probes may run. */
+probes_enabled?: boolean;
+/** Versioned read-time interpretation for legacy free-text authors. */
+identity_vocabulary?: {
+/** Reproducible vocabulary revision recorded in read projections. */
+version: number;
+/** Exact literal author spellings mapped to canonical harness namespaces. */
+aliases: Record<string, string>;
+};
+/** Pure, bounded harness signal descriptors evaluated after built-ins. */
+harness_signals: Array<{
+/** Stable lowercase harness namespace. */
+harness: string;
+/** Environment keys whose non-blank presence identifies the harness. */
+environment_keys?: string[];
+/** Environment keys checked in order for a model identifier. */
+model_environment_keys?: string[];
+/** Environment keys checked in order for a session identifier. */
+session_environment_keys?: string[];
+/** Extensible provenance dimensions mapped to ordered environment keys. */
+provenance_environment_keys?: Record<string, string[]>;
+/** Provenance dimensions mapped to audited built-in local resolvers. */
+provenance_resolvers?: Record<string, "ai_agent_version" | "claude_session_file">;
+/** Dimensions intentionally unavailable from this harness environment. */
+provenance_unavailable_dimensions?: string[];
+/** Literal executable or argument markers. */
+argv_markers?: string[];
+/** Literal MCP client-name markers. */
+client_names?: string[];
+}>;
+};
+/** Shared pre-write provenance, secret, and stale-work policy. */
+mutation_guard: {
+/** Reject mutations whose resolved author is `unknown`. */
+require_attributed_author: boolean;
+/** Credential-shaped content policy applied before CLI/MCP mutation dispatch. */
+secret_guard: "off" | "advise" | "block";
+/** Age threshold for unclaimed in-progress work surfaced by health. */
+stale_in_progress_hours: number;
+};
+/** Value that configures or reports item format for this contract. */
+item_format: ItemFormat;
+/** Value that configures or reports locks for this contract. */
+locks: {
+ttl_seconds: number;
+/** Bounded wait budget (milliseconds) for acquiring a contended item lock before surfacing lock_conflict. 0 disables waiting (fail-fast). Overridable per invocation via PM_LOCK_WAIT_MS. */
+wait_ms: number;
+};
+/** Retention policy for local crash-recovery receipts: bulk-mutation rollback checkpoints written by `update-many`/`close-many` AND terminal SDK workspace-transaction journals under `transactions/sdk/`. `pm gc --scope checkpoints` prunes checkpoint files older than `retention_days`; `pm gc --scope transactions` prunes committed/compensated journals older than the same window. Unparseable receipts and in-flight journals are always retained (safety-first, mirroring the stale-lock sweep). */
+checkpoints: {
+retention_days: number;
+};
+/** Value that configures or reports output for this contract. */
+output: {
+default_format: "toon" | "json";
+};
+/** Agent and human interaction preferences that do not change command semantics. */
+ux?: {
+/** Emit one stderr migration hint when a deprecated command alias is invoked. */
+deprecation_hints?: boolean;
+};
+/** Value that configures or reports history for this contract. */
+history: {
+missing_stream: "auto_create" | "strict_error";
+compact_policy: HistoryCompactPolicy;
+};
+/** Value that configures or reports validation for this contract. */
+validation: {
+sprint_release_format: SprintReleaseFormatPolicy;
+parent_reference: ParentReferencePolicy;
+metadata_profile: ValidateMetadataProfile;
+metadata_required_fields: ValidateMetadataRequiredField[];
+lifecycle_stale_blocker_reason_patterns: string[];
+lifecycle_closure_like_blocked_reason_patterns: string[];
+lifecycle_closure_like_resolution_patterns: string[];
+lifecycle_closure_like_actual_result_patterns: string[];
+/** Per-type default estimates (minutes) used by `pm validate --auto-fix --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212). Keys are item type names (case-insensitive); values are positive minutes that override the built-in defaults. Empty by default. */
+estimate_defaults_by_type: Record<string, number>;
+};
+/** Value that configures or reports governance for this contract. */
+governance: GovernanceSettings;
+/** Value that configures or reports workflow for this contract. */
+workflow: {
+definition_of_done: string[];
+};
+/** Value that configures or reports testing for this contract. */
+testing: {
+record_results_to_items: boolean;
+/** Permit explicit one-shot execution of commands not yet trusted by this clone. */
+allow_untrusted_linked_tests: boolean;
+};
+/** Value that configures or reports telemetry for this contract. */
+telemetry: {
+enabled: boolean;
+first_run_prompt_completed: boolean;
+capture_level: "minimal" | "redacted" | "max";
+endpoint: string;
+installation_id: string;
+retention_days: number;
+};
+/** Value that configures or reports agent guidance for this contract. */
+agent_guidance: AgentGuidanceSettings;
+/** Value that configures or reports item types for this contract. */
+item_types: {
+definitions: ItemTypeDefinition[];
+};
+/** Value that configures or reports schema for this contract. */
+schema: RuntimeSchemaSettings;
+/** Value that configures or reports extensions for this contract. */
+extensions: {
+enabled: string[];
+disabled: string[];
+policy: ExtensionPolicySettings;
+};
+/** Value that configures or reports search for this contract. */
+search: {
+score_threshold: number;
+hybrid_semantic_weight: number;
+max_results: number;
+embedding_model: string;
+embedding_corpus_max_characters?: number;
+embedding_batch_size: number;
+embedding_timeout_ms: number;
+scanner_max_batch_retries: number;
+provider?: string;
+/** Mode a search runs in when the caller passes none: `auto` (default) resolves to hybrid when semantic search is explicitly configured and runnable, keyword otherwise; a concrete mode pins it. Optional on the type so existing settings literals stay valid; readers always normalize it. */
+default_mode?: SearchDefaultMode;
+/** Optional allow-list of corpus field names embedded for semantic search (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or empty, the full default field set is used (backward compatible). When set, only the named fields are embedded — letting teams opt structured signals (priority, assignee, risk, acceptance_criteria, etc.) in/out for token efficiency. Changing this re-flags items stale on the next refresh. */
+corpus_fields?: string[];
+mutation_refresh_policy: SearchMutationRefreshPolicy;
+query_expansion: SearchQueryExpansionSettings;
+rerank: SearchRerankSettings;
+/** Offline BM25 lexical-ranking parameters (pm-75k9), applied when `search.provider` is `bm25` (or auto-selected as the offline fallback) for semantic/hybrid queries. `k1` controls term-frequency saturation, `b` controls document-length normalization. Unset → Lucene defaults (1.2/0.75). */
+bm25?: {
+k1?: number;
+b?: number;
+};
+tuning?: {
+title_exact_bonus?: number;
+title_weight?: number;
+description_weight?: number;
+tags_weight?: number;
+status_weight?: number;
+body_weight?: number;
+comments_weight?: number;
+notes_weight?: number;
+learnings_weight?: number;
+dependencies_weight?: number;
+linked_content_weight?: number;
+};
+};
+/** Value that configures or reports providers for this contract. */
+providers: {
+openai: {
+base_url: string;
+api_key: string;
+model: string;
+};
+ollama: {
+base_url: string;
+model: string;
+};
+};
+/** Value that configures or reports context for this contract. */
+context: ContextSettings;
+/** Value that configures or reports vector store for this contract. */
+vector_store: {
+adapter?: string;
+collection_name: string;
+qdrant: {
+url: string;
+api_key: string;
+};
+lancedb: {
+path: string;
+};
+};
 }