@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/query/context.d.ts

@@ -18,411 +18,411 @@ export declare const CONTEXT_OUTPUT_VALUES: readonly ["markdown", "toon", "json"
 export type ContextOutputFormat = (typeof CONTEXT_OUTPUT_VALUES)[number];
 /** Documents the context options payload exchanged by command, SDK, and package integrations. */
 export interface ContextOptions {
-    /** Value that configures or reports date for this contract. */
-    date?: string;
-    /** Value that configures or reports from for this contract. */
-    from?: string;
-    /** Value that configures or reports to for this contract. */
-    to?: string;
-    /** Value that configures or reports past for this contract. */
-    past?: boolean;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports tag for this contract. */
-    tag?: string;
-    /** Value that configures or reports priority for this contract. */
-    priority?: string;
-    /** Value that configures or reports assignee for this contract. */
-    assignee?: string;
-    /** Value that configures or reports assignee filter for this contract. */
-    assigneeFilter?: string;
-    /** 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 limit for this contract. */
-    limit?: string;
-    /** Value that configures or reports max items for this contract. */
-    maxItems?: string;
-    /** Opaque cursor returned by a previous context focus page. */
-    after?: string;
-    /** Value that configures or reports format for this contract. */
-    format?: string;
-    /** Value that configures or reports depth for this contract. */
-    depth?: string;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports section for this contract. */
-    section?: string[];
-    /** Value that configures or reports activity limit for this contract. */
-    activityLimit?: string;
-    /** Value that configures or reports stale threshold for this contract. */
-    staleThreshold?: string;
-    /** Value that configures or reports parent for this contract. */
-    parent?: string;
-    /** Value that configures or reports explain ranking for this contract. */
-    explainRanking?: boolean;
-    /** Maximum estimated tokens spent on ranked focus rows. */
-    tokenBudget?: string | number;
-    /** Omit tag arrays from every context focus-row collection. */
-    noTags?: boolean;
-    /** Omit the static installed extension health summary. */
-    noExtensionHealth?: boolean;
-    [key: string]: unknown;
+/** Value that configures or reports date for this contract. */
+date?: string;
+/** Value that configures or reports from for this contract. */
+from?: string;
+/** Value that configures or reports to for this contract. */
+to?: string;
+/** Value that configures or reports past for this contract. */
+past?: boolean;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports tag for this contract. */
+tag?: string;
+/** Value that configures or reports priority for this contract. */
+priority?: string;
+/** Value that configures or reports assignee for this contract. */
+assignee?: string;
+/** Value that configures or reports assignee filter for this contract. */
+assigneeFilter?: string;
+/** 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 limit for this contract. */
+limit?: string;
+/** Value that configures or reports max items for this contract. */
+maxItems?: string;
+/** Opaque cursor returned by a previous context focus page. */
+after?: string;
+/** Value that configures or reports format for this contract. */
+format?: string;
+/** Value that configures or reports depth for this contract. */
+depth?: string;
+/** Value that configures or reports fields for this contract. */
+fields?: string;
+/** Value that configures or reports section for this contract. */
+section?: string[];
+/** Value that configures or reports activity limit for this contract. */
+activityLimit?: string;
+/** Value that configures or reports stale threshold for this contract. */
+staleThreshold?: string;
+/** Value that configures or reports parent for this contract. */
+parent?: string;
+/** Value that configures or reports explain ranking for this contract. */
+explainRanking?: boolean;
+/** Maximum estimated tokens spent on ranked focus rows. */
+tokenBudget?: string | number;
+/** Omit tag arrays from every context focus-row collection. */
+noTags?: boolean;
+/** Omit the static installed extension health summary. */
+noExtensionHealth?: boolean;
+[key: string]: unknown;
 }
 /** Documents the context focus item payload exchanged by command, SDK, and package integrations. */
 export interface ContextFocusItem {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: string;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus;
-    /** Value that configures or reports priority for this contract. */
-    priority: number;
-    /** Value that configures or reports order for this contract. */
-    order: number | null;
-    /** Value that configures or reports deadline for this contract. */
-    deadline: string | null;
-    /** Value that configures or reports assignee for this contract. */
-    assignee: string | null;
-    /** Value that configures or reports tags for this contract. */
-    tags?: string[];
-    /** Parent item whose identical tag set was folded out of this row. */
-    tags_inherited?: string;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports parent for this contract. */
-    parent: string | null;
-    /** Value that configures or reports children total for this contract. */
-    children_total?: number;
-    /** Value that configures or reports children closed for this contract. */
-    children_closed?: number;
-    /** Value that configures or reports completion pct for this contract. */
-    completion_pct?: number;
-    /** True when lifecycle state or an unresolved dependency prevents action. */
-    blocked?: true;
-    /** Canonical unresolved blocker IDs; an empty array denotes lifecycle-only blocking. */
-    blocker_ids?: string[];
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: string;
+/** Lifecycle state reported for status. */
+status: ItemStatus;
+/** Value that configures or reports priority for this contract. */
+priority: number;
+/** Value that configures or reports order for this contract. */
+order: number | null;
+/** Value that configures or reports deadline for this contract. */
+deadline: string | null;
+/** Value that configures or reports assignee for this contract. */
+assignee: string | null;
+/** Value that configures or reports tags for this contract. */
+tags?: string[];
+/** Parent item whose identical tag set was folded out of this row. */
+tags_inherited?: string;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports parent for this contract. */
+parent: string | null;
+/** Value that configures or reports children total for this contract. */
+children_total?: number;
+/** Value that configures or reports children closed for this contract. */
+children_closed?: number;
+/** Value that configures or reports completion pct for this contract. */
+completion_pct?: number;
+/** True when lifecycle state or an unresolved dependency prevents action. */
+blocked?: true;
+/** Canonical unresolved blocker IDs; an empty array denotes lifecycle-only blocking. */
+blocker_ids?: string[];
 }
 /** Compact agenda reference used when the corresponding item is already present in a focus section. */
 export type ContextAgendaEvent = CalendarRow | (Pick<CalendarRow, "at" | "date" | "kind" | "item_id"> & {
-    reference_only: true;
-    reminder_text?: string | null;
-    event_title?: string | null;
-    event_recurring?: boolean | null;
+reference_only: true;
+reminder_text?: string | null;
+event_title?: string | null;
+event_recurring?: boolean | null;
 });
 /** Documents the hierarchy child payload exchanged by command, SDK, and package integrations. */
 export interface HierarchyChild {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: string;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus;
-    /** Value that configures or reports children total for this contract. */
-    children_total: number;
-    /** Value that configures or reports children closed for this contract. */
-    children_closed: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: string;
+/** Lifecycle state reported for status. */
+status: ItemStatus;
+/** Value that configures or reports children total for this contract. */
+children_total: number;
+/** Value that configures or reports children closed for this contract. */
+children_closed: number;
 }
 /** Documents the hierarchy node payload exchanged by command, SDK, and package integrations. */
 export interface HierarchyNode {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: string;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus;
-    /** Value that configures or reports children total for this contract. */
-    children_total: number;
-    /** Value that configures or reports children closed for this contract. */
-    children_closed: number;
-    /** Value that configures or reports children open for this contract. */
-    children_open: number;
-    /** Value that configures or reports children in progress for this contract. */
-    children_in_progress: number;
-    /** Value that configures or reports children blocked for this contract. */
-    children_blocked: number;
-    /** Value that configures or reports children for this contract. */
-    children: HierarchyChild[];
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: string;
+/** Lifecycle state reported for status. */
+status: ItemStatus;
+/** Value that configures or reports children total for this contract. */
+children_total: number;
+/** Value that configures or reports children closed for this contract. */
+children_closed: number;
+/** Value that configures or reports children open for this contract. */
+children_open: number;
+/** Value that configures or reports children in progress for this contract. */
+children_in_progress: number;
+/** Value that configures or reports children blocked for this contract. */
+children_blocked: number;
+/** Value that configures or reports children for this contract. */
+children: HierarchyChild[];
 }
 /** Documents the progress entry payload exchanged by command, SDK, and package integrations. */
 export interface ProgressEntry {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: string;
-    /** Value that configures or reports total for this contract. */
-    total: number;
-    /** Value that configures or reports closed for this contract. */
-    closed: number;
-    /** Value that configures or reports open for this contract. */
-    open: number;
-    /** Value that configures or reports in progress for this contract. */
-    in_progress: number;
-    /** Value that configures or reports blocked for this contract. */
-    blocked: number;
-    /** Value that configures or reports completion pct for this contract. */
-    completion_pct: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: string;
+/** Value that configures or reports total for this contract. */
+total: number;
+/** Value that configures or reports closed for this contract. */
+closed: number;
+/** Value that configures or reports open for this contract. */
+open: number;
+/** Value that configures or reports in progress for this contract. */
+in_progress: number;
+/** Value that configures or reports blocked for this contract. */
+blocked: number;
+/** Value that configures or reports completion pct for this contract. */
+completion_pct: number;
 }
 /** Documents the blocker entry payload exchanged by command, SDK, and package integrations. */
 export interface BlockerEntry {
-    /** 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 blocked by for this contract. */
-    blocked_by: string | null;
-    /** Value that configures or reports blocked by title for this contract. */
-    blocked_by_title: string | null;
-    /** Lifecycle status of the blocking item, or null when unresolved. */
-    blocked_by_status: ItemStatus | null;
-    /** Value that configures or reports blocked reason for this contract. */
-    blocked_reason: string | null;
-    /** Value that configures or reports unblock note for this contract. */
-    unblock_note: string | null;
+/** 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 blocked by for this contract. */
+blocked_by: string | null;
+/** Value that configures or reports blocked by title for this contract. */
+blocked_by_title: string | null;
+/** Lifecycle status of the blocking item, or null when unresolved. */
+blocked_by_status: ItemStatus | null;
+/** Value that configures or reports blocked reason for this contract. */
+blocked_reason: string | null;
+/** Value that configures or reports unblock note for this contract. */
+unblock_note: string | null;
 }
 /** Documents the hot file payload exchanged by command, SDK, and package integrations. */
 export interface HotFile {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports references for this contract. */
-    references: number;
-    /** Value that configures or reports items for this contract. */
-    items: string[];
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports references for this contract. */
+references: number;
+/** Value that configures or reports items for this contract. */
+items: string[];
 }
 /** Documents the workload entry payload exchanged by command, SDK, and package integrations. */
 export interface WorkloadEntry {
-    /** Value that configures or reports assignee for this contract. */
-    assignee: string | null;
-    /** Value that configures or reports active for this contract. */
-    active: number;
-    /** Value that configures or reports in progress for this contract. */
-    in_progress: number;
-    /** Value that configures or reports items for this contract. */
-    items: string[];
+/** Value that configures or reports assignee for this contract. */
+assignee: string | null;
+/** Value that configures or reports active for this contract. */
+active: number;
+/** Value that configures or reports in progress for this contract. */
+in_progress: number;
+/** Value that configures or reports items for this contract. */
+items: string[];
 }
 /** Documents the stale entry payload exchanged by command, SDK, and package integrations. */
 export interface StaleEntry {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports stale days for this contract. */
-    stale_days: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string;
+/** Lifecycle state reported for status. */
+status: ItemStatus;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports stale days for this contract. */
+stale_days: number;
 }
 /** Documents the recent context item payload exchanged by command, SDK, and package integrations. */
 export interface RecentContextItem extends ContextFocusItem {
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at?: string;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at?: string;
 }
 /** Documents the test health summary payload exchanged by command, SDK, and package integrations. */
 export interface TestHealthSummary {
-    /** Value that configures or reports items with tests for this contract. */
-    items_with_tests: number;
-    /** Value that configures or reports items with recent runs for this contract. */
-    items_with_recent_runs: number;
-    /** Value that configures or reports recent runs for this contract. */
-    recent_runs: {
-        passed: number;
-        failed: number;
-        skipped: number;
-    };
-    /** Value that configures or reports items failing for this contract. */
-    items_failing: string[];
+/** Value that configures or reports items with tests for this contract. */
+items_with_tests: number;
+/** Value that configures or reports items with recent runs for this contract. */
+items_with_recent_runs: number;
+/** Value that configures or reports recent runs for this contract. */
+recent_runs: {
+passed: number;
+failed: number;
+skipped: number;
+};
+/** Value that configures or reports items failing for this contract. */
+items_failing: string[];
 }
 /** Token-bounded static health of installed extension packages. */
 export interface ContextExtensionHealth {
-    /** Number of installed extension directories inspected. */
-    total: number;
-    /** Number of healthy installed extensions. */
-    ok: number;
-    /** Number of degraded installed extensions. */
-    degraded: number;
-    /** Per-package static discovery health. */
-    packages: Array<{
-        name: string;
-        status: "ok" | "degraded";
-    }>;
-    /** Whether package rows were capped. */
-    truncated?: true;
+/** Number of installed extension directories inspected. */
+total: number;
+/** Number of healthy installed extensions. */
+ok: number;
+/** Number of degraded installed extensions. */
+degraded: number;
+/** Per-package static discovery health. */
+packages: Array<{
+name: string;
+status: "ok" | "degraded";
+}>;
+/** Whether package rows were capped. */
+truncated?: true;
 }
 interface ContextAgendaSummary {
-    events: number;
-    items: number;
-    deadlines: number;
-    reminders: number;
-    scheduled: number;
+events: number;
+items: number;
+deadlines: number;
+reminders: number;
+scheduled: number;
 }
 interface ContextSummary {
-    /** Population counters honor item filters and parent scope, never output limits. */
-    scope?: "matching_items";
-    /** Counts for the bounded focus selection, separate from the matching population. */
-    returned_focus?: {
-        active_items: number;
-        in_progress: number;
-        open: number;
-        blocked: number;
-    };
-    /** Optional per-section role/blocker codes for projected rows: i/I in progress, o/O open; uppercase is blocked. */
-    focus_row_states?: Record<string, string>;
-    active_items: number;
-    in_progress: number;
-    open: number;
-    blocked: number;
-    blocked_fallback_used: boolean;
-    high_level: number;
-    low_level: number;
-    agenda_events: number;
-    total_items?: number;
-    closed?: number;
-    canceled?: number;
+/** Population counters honor item filters and parent scope, never output limits. */
+scope?: "matching_items";
+/** Counts for the bounded focus selection, separate from the matching population. */
+returned_focus?: {
+active_items: number;
+in_progress: number;
+open: number;
+blocked: number;
+};
+/** Optional per-section role/blocker codes for projected rows: i/I in progress, o/O open; uppercase is blocked. */
+focus_row_states?: Record<string, string>;
+active_items: number;
+in_progress: number;
+open: number;
+blocked: number;
+blocked_fallback_used: boolean;
+high_level: number;
+low_level: number;
+agenda_events: number;
+total_items?: number;
+closed?: number;
+canceled?: number;
 }
 /** Documents the context result payload exchanged by command, SDK, and package integrations. */
 export interface ContextResult {
-    /** Value that configures or reports output default for this contract. */
-    output_default: "toon";
-    /** Value that configures or reports now for this contract. */
-    now: string;
-    /** Value that configures or reports depth for this contract. */
-    depth: ContextDepth;
-    /** Value that configures or reports sections included for this contract. */
-    sections_included: ContextSectionName[];
-    /** Value that configures or reports window for this contract. */
-    window: {
-        anchor: string;
-        start: string | null;
-        end: string | null;
-        past: boolean;
-        from: string | null;
-        to: string | null;
-    };
-    /** Value that configures or reports filters for this contract. */
-    filters: {
-        type: string | null;
-        tag: string | null;
-        priority: string | null;
-        assignee: string | null;
-        assignee_filter: string | null;
-        sprint: string | null;
-        release: string | null;
-        limit: string | null;
-        parent: string | null;
-        token_budget: number;
-        runtime_filters?: Record<string, unknown>;
-    };
-    /** Value that configures or reports summary for this contract. */
-    summary: ContextSummary;
-    /** Value that configures or reports high level for this contract. */
-    high_level: ContextFocusItem[];
-    /** Value that configures or reports low level for this contract. */
-    low_level: ContextFocusItem[];
-    /** Value that configures or reports blocked fallback for this contract. */
-    blocked_fallback: ContextFocusItem[];
-    /** Value that configures or reports agenda for this contract. */
-    agenda: {
-        summary: ContextAgendaSummary;
-        events: ContextAgendaEvent[];
-    };
-    /** Value that configures or reports hierarchy for this contract. */
-    hierarchy?: HierarchyNode[];
-    /** Value that configures or reports activity for this contract. */
-    activity?: CompactActivityEntry[];
-    /** Value that configures or reports progress for this contract. */
-    progress?: ProgressEntry[];
-    /** Value that configures or reports blockers for this contract. */
-    blockers?: BlockerEntry[];
-    /** Value that configures or reports recently created for this contract. */
-    recently_created?: RecentContextItem[];
-    /** Value that configures or reports unparented for this contract. */
-    unparented?: ContextFocusItem[];
-    /** Value that configures or reports files for this contract. */
-    files?: HotFile[];
-    /** Value that configures or reports workload for this contract. */
-    workload?: WorkloadEntry[];
-    /** Value that configures or reports staleness for this contract. */
-    staleness?: StaleEntry[];
-    /** Value that configures or reports tests for this contract. */
-    tests?: TestHealthSummary;
-    /** Token-bounded installed extension health derived without module imports. */
-    extension_health?: ContextExtensionHealth;
-    /** Cursor-bound historical rollups automatically attached for large workspaces. */
-    workspace_memory?: {
-        /** Persistence freshness for the derived projection. */
-        cache_status: "fresh" | "rebuilt";
-        /** Source cursor shared with the authoritative metadata projection. */
-        source_cursor: string;
-        /** Recent epoch and epic summaries selected within the context token budget. */
-        rollups: WorkspaceMemoryRollup[];
-    };
-    /** Value that configures or reports suggestions for this contract. */
-    suggestions?: string[];
-    /** Focus-row field subset requested via --fields; null/omitted means full rows. */
-    focus_fields?: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings?: string[];
-    /** Actionable recovery contracts for context signal-store warnings. */
-    warning_details?: ContextSignalStoreReadResult["warning_details"];
-    /** Value that configures or reports ranking for this contract. */
-    ranking?: ContextRankingSummary;
-    /** Token-budget selection and projection accounting for ranked focus rows. */
-    packing?: ContextPackingSummary;
-    /** Whether additional ranked focus rows remain after this page. */
-    has_more?: boolean;
-    /** Opaque continuation cursor for the next ranked focus page. */
-    next_cursor?: string;
-    /** Effective ranked-focus page size. */
-    applied_limit?: number;
-    /** Explicit marker that focus rows were bounded. */
-    truncated?: true;
+/** Value that configures or reports output default for this contract. */
+output_default: "toon";
+/** Value that configures or reports now for this contract. */
+now: string;
+/** Value that configures or reports depth for this contract. */
+depth: ContextDepth;
+/** Value that configures or reports sections included for this contract. */
+sections_included: ContextSectionName[];
+/** Value that configures or reports window for this contract. */
+window: {
+anchor: string;
+start: string | null;
+end: string | null;
+past: boolean;
+from: string | null;
+to: string | null;
+};
+/** Value that configures or reports filters for this contract. */
+filters: {
+type: string | null;
+tag: string | null;
+priority: string | null;
+assignee: string | null;
+assignee_filter: string | null;
+sprint: string | null;
+release: string | null;
+limit: string | null;
+parent: string | null;
+token_budget: number;
+runtime_filters?: Record<string, unknown>;
+};
+/** Value that configures or reports summary for this contract. */
+summary: ContextSummary;
+/** Value that configures or reports high level for this contract. */
+high_level: ContextFocusItem[];
+/** Value that configures or reports low level for this contract. */
+low_level: ContextFocusItem[];
+/** Value that configures or reports blocked fallback for this contract. */
+blocked_fallback: ContextFocusItem[];
+/** Value that configures or reports agenda for this contract. */
+agenda: {
+summary: ContextAgendaSummary;
+events: ContextAgendaEvent[];
+};
+/** Value that configures or reports hierarchy for this contract. */
+hierarchy?: HierarchyNode[];
+/** Value that configures or reports activity for this contract. */
+activity?: CompactActivityEntry[];
+/** Value that configures or reports progress for this contract. */
+progress?: ProgressEntry[];
+/** Value that configures or reports blockers for this contract. */
+blockers?: BlockerEntry[];
+/** Value that configures or reports recently created for this contract. */
+recently_created?: RecentContextItem[];
+/** Value that configures or reports unparented for this contract. */
+unparented?: ContextFocusItem[];
+/** Value that configures or reports files for this contract. */
+files?: HotFile[];
+/** Value that configures or reports workload for this contract. */
+workload?: WorkloadEntry[];
+/** Value that configures or reports staleness for this contract. */
+staleness?: StaleEntry[];
+/** Value that configures or reports tests for this contract. */
+tests?: TestHealthSummary;
+/** Token-bounded installed extension health derived without module imports. */
+extension_health?: ContextExtensionHealth;
+/** Cursor-bound historical rollups automatically attached for large workspaces. */
+workspace_memory?: {
+/** Persistence freshness for the derived projection. */
+cache_status: "fresh" | "rebuilt";
+/** Source cursor shared with the authoritative metadata projection. */
+source_cursor: string;
+/** Recent epoch and epic summaries selected within the context token budget. */
+rollups: WorkspaceMemoryRollup[];
+};
+/** Value that configures or reports suggestions for this contract. */
+suggestions?: string[];
+/** Focus-row field subset requested via --fields; null/omitted means full rows. */
+focus_fields?: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings?: string[];
+/** Actionable recovery contracts for context signal-store warnings. */
+warning_details?: ContextSignalStoreReadResult["warning_details"];
+/** Value that configures or reports ranking for this contract. */
+ranking?: ContextRankingSummary;
+/** Token-budget selection and projection accounting for ranked focus rows. */
+packing?: ContextPackingSummary;
+/** Whether additional ranked focus rows remain after this page. */
+has_more?: boolean;
+/** Opaque continuation cursor for the next ranked focus page. */
+next_cursor?: string;
+/** Effective ranked-focus page size. */
+applied_limit?: number;
+/** Explicit marker that focus rows were bounded. */
+truncated?: true;
 }
 /** Compact token-budget accounting shared by context and next results. */
 export type ContextPackingSummary = Omit<ContextPackingReport<unknown>, "included"> & {
-    included: Array<{
-        id: string;
-        projection: string;
-        tokens: number;
-    }>;
+included: Array<{
+id: string;
+projection: string;
+tokens: number;
+}>;
 };
 /** Compact explainability envelope shared by context and next JSON results. */
 export interface ContextRankingSummary {
-    /** Value that configures or reports model for this contract. */
-    model: string;
-    /** Value that configures or reports available signals for this contract. */
-    available_signals: ContextRelevanceSignalName[];
-    /** Value that configures or reports items for this contract. */
-    items: Array<{
-        id: string;
-        rank: number;
-        baseline_rank: number;
-        score: number;
-        contributions: ContextRelevanceContributions;
-        /** Authoritative temporal source used for the recency contribution. */
-        recency?: ContextRecencyEvidence;
-    }>;
-    /** Number of candidates considered before answer-sized projection. */
-    candidate_count: number;
-    /** Number of candidate explanations omitted because their rows were not served. */
-    omitted_count: number;
-    /** Rebuildable feature-store freshness and provenance. */
-    feature_store?: {
-        source: "derived_index" | "scan_fallback";
-        cache_status: "fresh" | "rebuilt";
-        source_cursor: string;
-        generated_at: string;
-    };
+/** Value that configures or reports model for this contract. */
+model: string;
+/** Value that configures or reports available signals for this contract. */
+available_signals: ContextRelevanceSignalName[];
+/** Value that configures or reports items for this contract. */
+items: Array<{
+id: string;
+rank: number;
+baseline_rank: number;
+score: number;
+contributions: ContextRelevanceContributions;
+/** Authoritative temporal source used for the recency contribution. */
+recency?: ContextRecencyEvidence;
+}>;
+/** Number of candidates considered before answer-sized projection. */
+candidate_count: number;
+/** Number of candidate explanations omitted because their rows were not served. */
+omitted_count: number;
+/** Rebuildable feature-store freshness and provenance. */
+feature_store?: {
+source: "derived_index" | "scan_fallback";
+cache_status: "fresh" | "rebuilt";
+source_cursor: string;
+generated_at: string;
+};
 }
 /** Parses the comma-separated `--fields` value into a validated, de-duplicated focus-row projection list. Returns undefined when no projection was requested. */
 export declare function parseContextFocusFields(raw: string | undefined): string[] | undefined;
@@ -456,8 +456,8 @@ declare function stripListProjectionFlags(options: ContextOptions): Record<strin
  * sibling read commands (e.g. `pm next`) can apply the same subtree scoping.
  */
 export declare function collectSubtreeIds(corpus: ItemMetadata[], parentId: string): {
-    ids: Set<string>;
-    found: boolean;
+ids: Set<string>;
+found: boolean;
 };
 declare function parseContextParent(raw: string | undefined): string | undefined;
 declare function compareOptionalOrder(left: number | null | undefined, right: number | null | undefined): number;
@@ -498,43 +498,43 @@ declare function buildHierarchy(allItems: ItemMetadata[], activeItems: ItemMetad
 declare function collectDescendants(parentId: string, childrenByParent: Map<string, ItemMetadata[]>): ItemMetadata[];
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    buildActivity: typeof buildActivity;
-    buildBlockers: typeof buildBlockers;
-    buildChildrenByParent: typeof buildChildrenByParent;
-    buildHierarchy: typeof buildHierarchy;
-    buildHotFiles: typeof buildHotFiles;
-    buildProgress: typeof buildProgress;
-    buildRecentlyCreated: typeof buildRecentlyCreated;
-    buildStaleness: typeof buildStaleness;
-    buildTestHealth: typeof buildTestHealth;
-    buildUnparented: typeof buildUnparented;
-    buildWorkload: typeof buildWorkload;
-    collectDescendants: typeof collectDescendants;
-    collectSubtreeIds: typeof collectSubtreeIds;
-    compareCriticalItems: typeof compareCriticalItems;
-    compareOptionalDeadline: typeof compareOptionalDeadline;
-    compareOptionalOrder: typeof compareOptionalOrder;
-    completionPct: typeof completionPct;
-    dateTokenForTimestamp: typeof dateTokenForTimestamp;
-    filterTerminalCalendarEvents: typeof filterTerminalCalendarEvents;
-    formatAgendaLine: typeof formatAgendaLine;
-    isBlockedStatus: typeof isBlockedStatus;
-    isClosedStatus: typeof isClosedStatus;
-    isInProgressStatus: typeof isInProgressStatus;
-    isOpenStatus: typeof isOpenStatus;
-    mergeSortedWarnings: typeof mergeSortedWarnings;
-    normalizedParentId: typeof normalizedParentId;
-    parseActivityLimit: typeof parseActivityLimit;
-    parseContextLimit: typeof parseContextLimit;
-    resolveContextLimitAtScale: typeof resolveContextLimitAtScale;
-    parseContextParent: typeof parseContextParent;
-    parseContextTimestampMs: typeof parseContextTimestampMs;
-    parseStaleThresholdDays: typeof parseStaleThresholdDays;
-    sortableTimestamp: typeof sortableTimestamp;
-    statusRank: typeof statusRank;
-    stripListProjectionFlags: typeof stripListProjectionFlags;
-    summarizeAgenda: typeof summarizeAgenda;
-    toContextFocusItem: typeof toContextFocusItem;
+buildActivity: typeof buildActivity;
+buildBlockers: typeof buildBlockers;
+buildChildrenByParent: typeof buildChildrenByParent;
+buildHierarchy: typeof buildHierarchy;
+buildHotFiles: typeof buildHotFiles;
+buildProgress: typeof buildProgress;
+buildRecentlyCreated: typeof buildRecentlyCreated;
+buildStaleness: typeof buildStaleness;
+buildTestHealth: typeof buildTestHealth;
+buildUnparented: typeof buildUnparented;
+buildWorkload: typeof buildWorkload;
+collectDescendants: typeof collectDescendants;
+collectSubtreeIds: typeof collectSubtreeIds;
+compareCriticalItems: typeof compareCriticalItems;
+compareOptionalDeadline: typeof compareOptionalDeadline;
+compareOptionalOrder: typeof compareOptionalOrder;
+completionPct: typeof completionPct;
+dateTokenForTimestamp: typeof dateTokenForTimestamp;
+filterTerminalCalendarEvents: typeof filterTerminalCalendarEvents;
+formatAgendaLine: typeof formatAgendaLine;
+isBlockedStatus: typeof isBlockedStatus;
+isClosedStatus: typeof isClosedStatus;
+isInProgressStatus: typeof isInProgressStatus;
+isOpenStatus: typeof isOpenStatus;
+mergeSortedWarnings: typeof mergeSortedWarnings;
+normalizedParentId: typeof normalizedParentId;
+parseActivityLimit: typeof parseActivityLimit;
+parseContextLimit: typeof parseContextLimit;
+resolveContextLimitAtScale: typeof resolveContextLimitAtScale;
+parseContextParent: typeof parseContextParent;
+parseContextTimestampMs: typeof parseContextTimestampMs;
+parseStaleThresholdDays: typeof parseStaleThresholdDays;
+sortableTimestamp: typeof sortableTimestamp;
+statusRank: typeof statusRank;
+stripListProjectionFlags: typeof stripListProjectionFlags;
+summarizeAgenda: typeof summarizeAgenda;
+toContextFocusItem: typeof toContextFocusItem;
 };
 declare function buildActivity(activityLimit: number, global: GlobalOptions): Promise<CompactActivityEntry[]>;
 declare function buildProgress(allItems: ItemMetadata[], activeItems: ItemMetadata[], blockedIds: ReadonlySet<string>, statusRegistry: RuntimeStatusRegistry, limit: number): ProgressEntry[];