@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -3,449 +3,449 @@
  *
  * Implements the pm context command surface and its agent-facing runtime behavior.
  */
-import { type GlobalOptions, type RuntimeStatusRegistry } from "../runtime-primitives.js";
-import type { ContextDepth, ContextSectionName, ContextSettings, ItemMetadata, ItemStatus, PmSettings } from "../../types/index.js";
+import { type GlobalOptions,type RuntimeStatusRegistry } from "../runtime-primitives.js";
+import type { ContextDepth,ContextSectionName,ContextSettings,ItemMetadata,ItemStatus,PmSettings } from "../../types/index.js";
 import { type CalendarRow } from "./calendar.js";
 import { type CompactActivityEntry } from "./activity.js";
-import { type ContextRelevanceContributions, type ContextRecencyEvidence, type ContextRelevanceReport, type ContextRelevanceSignalName } from "../context-relevance.js";
+import { type ContextRelevanceContributions,type ContextRecencyEvidence,type ContextRelevanceReport,type ContextRelevanceSignalName } from "../context-relevance.js";
 export { buildItemContextRelevanceCandidates } from "../context-relevance.js";
 import { type ContextPackingReport } from "../context-packing.js";
 import { type ContextSignalStoreReadResult } from "../context-signal-store.js";
 import { type WorkspaceMemoryRollup } from "../workspace-memory.js";
 /** Supported values accepted by the context output contract. */
-export declare const CONTEXT_OUTPUT_VALUES: readonly ["markdown", "toon", "json", "ndjson"];
+export declare const CONTEXT_OUTPUT_VALUES:readonly ["markdown","toon","json","ndjson"];
 /** Restricts context output format values accepted by command, SDK, and storage contracts. */
 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;
+date?:string;
 /** Value that configures or reports from for this contract. */
-from?: string;
+from?:string;
 /** Value that configures or reports to for this contract. */
-to?: string;
+to?:string;
 /** Value that configures or reports past for this contract. */
-past?: boolean;
+past?:boolean;
 /** Schema type that determines the shape and validation rules for this value. */
-type?: string;
+type?:string;
 /** Value that configures or reports tag for this contract. */
-tag?: string;
+tag?:string;
 /** Value that configures or reports priority for this contract. */
-priority?: string;
+priority?:string;
 /** Value that configures or reports assignee for this contract. */
-assignee?: string;
+assignee?:string;
 /** Value that configures or reports assignee filter for this contract. */
-assigneeFilter?: string;
+assigneeFilter?:string;
 /** Value that configures or reports sprint for this contract. */
-sprint?: string;
+sprint?:string;
 /** Value that configures or reports release for this contract. */
-release?: string;
+release?:string;
 /** Value that configures or reports limit for this contract. */
-limit?: string;
+limit?:string;
 /** Value that configures or reports max items for this contract. */
-maxItems?: string;
+maxItems?:string;
 /** Opaque cursor returned by a previous context focus page. */
-after?: string;
+after?:string;
 /** Value that configures or reports format for this contract. */
-format?: string;
+format?:string;
 /** Value that configures or reports depth for this contract. */
-depth?: string;
+depth?:string;
 /** Value that configures or reports fields for this contract. */
-fields?: string;
+fields?:string;
 /** Value that configures or reports section for this contract. */
-section?: string[];
+section?:string[];
 /** Value that configures or reports activity limit for this contract. */
-activityLimit?: string;
+activityLimit?:string;
 /** Value that configures or reports stale threshold for this contract. */
-staleThreshold?: string;
+staleThreshold?:string;
 /** Value that configures or reports parent for this contract. */
-parent?: string;
+parent?:string;
 /** Value that configures or reports explain ranking for this contract. */
-explainRanking?: boolean;
+explainRanking?:boolean;
 /** Maximum estimated tokens spent on ranked focus rows. */
-tokenBudget?: string | number;
+tokenBudget?:string | number;
 /** Omit tag arrays from every context focus-row collection. */
-noTags?: boolean;
+noTags?:boolean;
 /** Omit the static installed extension health summary. */
-noExtensionHealth?: boolean;
-[key: string]: unknown;
+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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Lifecycle state reported for status. */
-status: ItemStatus;
+status:ItemStatus;
 /** Value that configures or reports priority for this contract. */
-priority: number;
+priority:number;
 /** Value that configures or reports order for this contract. */
-order: number | null;
+order:number | null;
 /** Value that configures or reports deadline for this contract. */
-deadline: string | null;
+deadline:string | null;
 /** Value that configures or reports assignee for this contract. */
-assignee: string | null;
+assignee:string | null;
 /** Value that configures or reports tags for this contract. */
-tags?: string[];
+tags?:string[];
 /** Parent item whose identical tag set was folded out of this row. */
-tags_inherited?: string;
+tags_inherited?:string;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 /** Value that configures or reports parent for this contract. */
-parent: string | null;
+parent:string | null;
 /** Value that configures or reports children total for this contract. */
-children_total?: number;
+children_total?:number;
 /** Value that configures or reports children closed for this contract. */
-children_closed?: number;
+children_closed?:number;
 /** Value that configures or reports completion pct for this contract. */
-completion_pct?: number;
+completion_pct?:number;
 /** True when lifecycle state or an unresolved dependency prevents action. */
-blocked?: true;
+blocked?:true;
 /** Canonical unresolved blocker IDs; an empty array denotes lifecycle-only blocking. */
-blocker_ids?: string[];
+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;
+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;
 });
 /** 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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Lifecycle state reported for status. */
-status: ItemStatus;
+status:ItemStatus;
 /** Value that configures or reports children total for this contract. */
-children_total: number;
+children_total:number;
 /** Value that configures or reports children closed for this contract. */
-children_closed: number;
+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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Lifecycle state reported for status. */
-status: ItemStatus;
+status:ItemStatus;
 /** Value that configures or reports children total for this contract. */
-children_total: number;
+children_total:number;
 /** Value that configures or reports children closed for this contract. */
-children_closed: number;
+children_closed:number;
 /** Value that configures or reports children open for this contract. */
-children_open: number;
+children_open:number;
 /** Value that configures or reports children in progress for this contract. */
-children_in_progress: number;
+children_in_progress:number;
 /** Value that configures or reports children blocked for this contract. */
-children_blocked: number;
+children_blocked:number;
 /** Value that configures or reports children for this contract. */
-children: HierarchyChild[];
+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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Value that configures or reports total for this contract. */
-total: number;
+total:number;
 /** Value that configures or reports closed for this contract. */
-closed: number;
+closed:number;
 /** Value that configures or reports open for this contract. */
-open: number;
+open:number;
 /** Value that configures or reports in progress for this contract. */
-in_progress: number;
+in_progress:number;
 /** Value that configures or reports blocked for this contract. */
-blocked: number;
+blocked:number;
 /** Value that configures or reports completion pct for this contract. */
-completion_pct: number;
+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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Value that configures or reports blocked by for this contract. */
-blocked_by: string | null;
+blocked_by:string | null;
 /** Value that configures or reports blocked by title for this contract. */
-blocked_by_title: string | null;
+blocked_by_title:string | null;
 /** Lifecycle status of the blocking item, or null when unresolved. */
-blocked_by_status: ItemStatus | null;
+blocked_by_status:ItemStatus | null;
 /** Value that configures or reports blocked reason for this contract. */
-blocked_reason: string | null;
+blocked_reason:string | null;
 /** Value that configures or reports unblock note for this contract. */
-unblock_note: string | null;
+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;
+path:string;
 /** Value that configures or reports references for this contract. */
-references: number;
+references:number;
 /** Value that configures or reports items for this contract. */
-items: string[];
+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;
+assignee:string | null;
 /** Value that configures or reports active for this contract. */
-active: number;
+active:number;
 /** Value that configures or reports in progress for this contract. */
-in_progress: number;
+in_progress:number;
 /** Value that configures or reports items for this contract. */
-items: string[];
+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;
+id:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Lifecycle state reported for status. */
-status: ItemStatus;
+status:ItemStatus;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 /** Value that configures or reports stale days for this contract. */
-stale_days: number;
+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;
+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;
+items_with_tests:number;
 /** Value that configures or reports items with recent runs for this contract. */
-items_with_recent_runs: number;
+items_with_recent_runs:number;
 /** Value that configures or reports recent runs for this contract. */
-recent_runs: {
-passed: number;
-failed: number;
-skipped: number;
+recent_runs:{
+passed:number;
+failed:number;
+skipped:number;
 };
 /** Value that configures or reports items failing for this contract. */
-items_failing: string[];
+items_failing:string[];
 }
 /** Token-bounded static health of installed extension packages. */
 export interface ContextExtensionHealth {
 /** Number of installed extension directories inspected. */
-total: number;
+total:number;
 /** Number of healthy installed extensions. */
-ok: number;
+ok:number;
 /** Number of degraded installed extensions. */
-degraded: number;
+degraded:number;
 /** Per-package static discovery health. */
-packages: Array<{
-name: string;
-status: "ok" | "degraded";
+packages:Array<{
+name:string;
+status:"ok" | "degraded";
 }>;
 /** Whether package rows were capped. */
-truncated?: true;
+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";
+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;
+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;
+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";
+output_default:"toon";
 /** Value that configures or reports now for this contract. */
-now: string;
+now:string;
 /** Value that configures or reports depth for this contract. */
-depth: ContextDepth;
+depth:ContextDepth;
 /** Value that configures or reports sections included for this contract. */
-sections_included: ContextSectionName[];
+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;
+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>;
+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;
+summary:ContextSummary;
 /** Value that configures or reports high level for this contract. */
-high_level: ContextFocusItem[];
+high_level:ContextFocusItem[];
 /** Value that configures or reports low level for this contract. */
-low_level: ContextFocusItem[];
+low_level:ContextFocusItem[];
 /** Value that configures or reports blocked fallback for this contract. */
-blocked_fallback: ContextFocusItem[];
+blocked_fallback:ContextFocusItem[];
 /** Value that configures or reports agenda for this contract. */
-agenda: {
-summary: ContextAgendaSummary;
-events: ContextAgendaEvent[];
+agenda:{
+summary:ContextAgendaSummary;
+events:ContextAgendaEvent[];
 };
 /** Value that configures or reports hierarchy for this contract. */
-hierarchy?: HierarchyNode[];
+hierarchy?:HierarchyNode[];
 /** Value that configures or reports activity for this contract. */
-activity?: CompactActivityEntry[];
+activity?:CompactActivityEntry[];
 /** Value that configures or reports progress for this contract. */
-progress?: ProgressEntry[];
+progress?:ProgressEntry[];
 /** Value that configures or reports blockers for this contract. */
-blockers?: BlockerEntry[];
+blockers?:BlockerEntry[];
 /** Value that configures or reports recently created for this contract. */
-recently_created?: RecentContextItem[];
+recently_created?:RecentContextItem[];
 /** Value that configures or reports unparented for this contract. */
-unparented?: ContextFocusItem[];
+unparented?:ContextFocusItem[];
 /** Value that configures or reports files for this contract. */
-files?: HotFile[];
+files?:HotFile[];
 /** Value that configures or reports workload for this contract. */
-workload?: WorkloadEntry[];
+workload?:WorkloadEntry[];
 /** Value that configures or reports staleness for this contract. */
-staleness?: StaleEntry[];
+staleness?:StaleEntry[];
 /** Value that configures or reports tests for this contract. */
-tests?: TestHealthSummary;
+tests?:TestHealthSummary;
 /** Token-bounded installed extension health derived without module imports. */
-extension_health?: ContextExtensionHealth;
+extension_health?:ContextExtensionHealth;
 /** Cursor-bound historical rollups automatically attached for large workspaces. */
-workspace_memory?: {
+workspace_memory?:{
 /** Persistence freshness for the derived projection. */
-cache_status: "fresh" | "rebuilt";
+cache_status:"fresh" | "rebuilt";
 /** Source cursor shared with the authoritative metadata projection. */
-source_cursor: string;
+source_cursor:string;
 /** Recent epoch and epic summaries selected within the context token budget. */
-rollups: WorkspaceMemoryRollup[];
+rollups:WorkspaceMemoryRollup[];
 };
 /** Value that configures or reports suggestions for this contract. */
-suggestions?: string[];
+suggestions?:string[];
 /** Focus-row field subset requested via --fields; null/omitted means full rows. */
-focus_fields?: string[];
+focus_fields?:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings?: string[];
+warnings?:string[];
 /** Actionable recovery contracts for context signal-store warnings. */
-warning_details?: ContextSignalStoreReadResult["warning_details"];
+warning_details?:ContextSignalStoreReadResult["warning_details"];
 /** Value that configures or reports ranking for this contract. */
-ranking?: ContextRankingSummary;
+ranking?:ContextRankingSummary;
 /** Token-budget selection and projection accounting for ranked focus rows. */
-packing?: ContextPackingSummary;
+packing?:ContextPackingSummary;
 /** Whether additional ranked focus rows remain after this page. */
-has_more?: boolean;
+has_more?:boolean;
 /** Opaque continuation cursor for the next ranked focus page. */
-next_cursor?: string;
+next_cursor?:string;
 /** Effective ranked-focus page size. */
-applied_limit?: number;
+applied_limit?:number;
 /** Explicit marker that focus rows were bounded. */
-truncated?: true;
+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;
+export type ContextPackingSummary = Omit<ContextPackingReport<unknown>,"included"> & {
+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;
+model:string;
 /** Value that configures or reports available signals for this contract. */
-available_signals: ContextRelevanceSignalName[];
+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;
+items:Array<{
+id:string;
+rank:number;
+baseline_rank:number;
+score:number;
+contributions:ContextRelevanceContributions;
 /** Authoritative temporal source used for the recency contribution. */
-recency?: ContextRecencyEvidence;
+recency?:ContextRecencyEvidence;
 }>;
 /** Number of candidates considered before answer-sized projection. */
-candidate_count: number;
+candidate_count:number;
 /** Number of candidate explanations omitted because their rows were not served. */
-omitted_count: number;
+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;
+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;
+export declare function parseContextFocusFields(raw:string | undefined):string[] | undefined;
 /** Projects focus rows onto the requested field subset, preserving field order so the rendered/serialized output mirrors the `--fields` argument. */
-export declare function projectContextFocusRows<T extends ContextFocusItem>(rows: T[], fields: string[]): ContextFocusItem[];
+export declare function projectContextFocusRows<T extends ContextFocusItem>(rows:T[],fields:string[]):ContextFocusItem[];
 /** Implements resolve context output format for the public runtime surface of this module. */
-export declare function resolveContextOutputFormat(options: ContextOptions, global: GlobalOptions): ContextOutputFormat;
-declare function parseContextLimit(raw: string | undefined, depth: ContextDepth): number;
+export declare function resolveContextOutputFormat(options:ContextOptions,global:GlobalOptions):ContextOutputFormat;
+declare function parseContextLimit(raw:string | undefined,depth:ContextDepth):number;
 /** Resolve a positive context-packing budget from CLI or SDK input. */
-export declare function resolveContextTokenBudget(raw: string | number | undefined, fallback: number): number;
-declare function resolveContextLimitAtScale(limit: number, itemCount: number): number;
+export declare function resolveContextTokenBudget(raw:string | number | undefined,fallback:number):number;
+declare function resolveContextLimitAtScale(limit:number,itemCount:number):number;
 /** Implements parse context depth for the public runtime surface of this module. */
-export declare function parseContextDepth(raw: string | undefined, settings: ContextSettings): ContextDepth;
+export declare function parseContextDepth(raw:string | undefined,settings:ContextSettings):ContextDepth;
 /** Implements parse context sections for the public runtime surface of this module. */
-export declare function parseContextSections(raw: string[] | undefined, depth: ContextDepth, settings: ContextSettings): ContextSectionName[];
-declare function parseActivityLimit(raw: string | undefined, settings: ContextSettings): number;
-declare function parseStaleThresholdDays(raw: string | undefined, settings: ContextSettings): number;
-declare function statusRank(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): number;
-declare function isClosedStatus(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean;
-declare function isInProgressStatus(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean;
-declare function isOpenStatus(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean;
-declare function isBlockedStatus(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean;
-declare function stripListProjectionFlags(options: ContextOptions): Record<string, unknown>;
+export declare function parseContextSections(raw:string[] | undefined,depth:ContextDepth,settings:ContextSettings):ContextSectionName[];
+declare function parseActivityLimit(raw:string | undefined,settings:ContextSettings):number;
+declare function parseStaleThresholdDays(raw:string | undefined,settings:ContextSettings):number;
+declare function statusRank(status:ItemStatus,statusRegistry:RuntimeStatusRegistry):number;
+declare function isClosedStatus(status:ItemStatus,statusRegistry:RuntimeStatusRegistry):boolean;
+declare function isInProgressStatus(status:ItemStatus,statusRegistry:RuntimeStatusRegistry):boolean;
+declare function isOpenStatus(status:ItemStatus,statusRegistry:RuntimeStatusRegistry):boolean;
+declare function isBlockedStatus(status:ItemStatus,statusRegistry:RuntimeStatusRegistry):boolean;
+declare function stripListProjectionFlags(options:ContextOptions):Record<string,unknown>;
 /**
  * Resolves the transitive subtree (the anchor item plus every descendant via
  * parent links) so `--parent` can scope a snapshot to one epic/milestone. Reuses
@@ -455,17 +455,17 @@ declare function stripListProjectionFlags(options: ContextOptions): Record<strin
  * `found` flag is false when the anchor id is absent from the corpus. Exported so
  * 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;
+export declare function collectSubtreeIds(corpus:ItemMetadata[],parentId:string):{
+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;
-declare function compareOptionalDeadline(left: string | null | undefined, right: string | null | undefined): number;
-declare function parseContextTimestampMs(value: unknown): number;
-declare function sortableTimestamp(value: unknown): string;
-declare function dateTokenForTimestamp(value: unknown): string;
-declare function normalizedParentId(value: unknown): string | null;
+declare function parseContextParent(raw:string | undefined):string | undefined;
+declare function compareOptionalOrder(left:number | null | undefined,right:number | null | undefined):number;
+declare function compareOptionalDeadline(left:string | null | undefined,right:string | null | undefined):number;
+declare function parseContextTimestampMs(value:unknown):number;
+declare function sortableTimestamp(value:unknown):string;
+declare function dateTokenForTimestamp(value:unknown):string;
+declare function normalizedParentId(value:unknown):string | null;
 /**
  * Ranks two items by work criticality: in-progress before open before blocked
  * before draft (via {@link statusRank}), then ascending priority, explicit order,
@@ -473,89 +473,89 @@ declare function normalizedParentId(value: unknown): string | null;
  * Exported as the canonical focus ordering so sibling read commands (e.g.
  * `pm next`) recommend work in the exact same sequence as `pm context`.
  */
-export declare function compareCriticalItems(left: ItemMetadata, right: ItemMetadata, statusRegistry: RuntimeStatusRegistry): number;
+export declare function compareCriticalItems(left:ItemMetadata,right:ItemMetadata,statusRegistry:RuntimeStatusRegistry):number;
 /** Packs a relevance report with monotone identity, summary, and full item projections. */
-export declare function packRankedContextItems(report: ContextRelevanceReport<ItemMetadata>, tokenBudget: number, requiredIds?: ReadonlySet<string>, profile?: "context" | "next"): ContextPackingReport<ItemMetadata>;
+export declare function packRankedContextItems(report:ContextRelevanceReport<ItemMetadata>,tokenBudget:number,requiredIds?:ReadonlySet<string>,profile?:"context" | "next"):ContextPackingReport<ItemMetadata>;
 /** Projects the SDK packer report onto the stable low-token command envelope. */
-export declare function toContextPackingSummary(report: ContextPackingReport<ItemMetadata>): ContextPackingSummary;
+export declare function toContextPackingSummary(report:ContextPackingReport<ItemMetadata>):ContextPackingSummary;
 /** Project a full scorer report onto the low-token command explanation shape. */
-export declare function toContextRankingSummary<TItem>(report: ContextRelevanceReport<TItem>, featureStore?: ContextSignalStoreReadResult, servedItemIds?: ReadonlySet<string>): ContextRankingSummary;
-declare function completionPct(closed: number, total: number): number;
+export declare function toContextRankingSummary<TItem>(report:ContextRelevanceReport<TItem>,featureStore?:ContextSignalStoreReadResult,servedItemIds?:ReadonlySet<string>):ContextRankingSummary;
+declare function completionPct(closed:number,total:number):number;
 /** Indexes items by their parent id, yielding a parent→direct-children map used by the hierarchy/progress rollups and by focus-row child completion. Items without a parent are skipped. Exported so sibling read commands reuse the same index. */
-export declare function buildChildrenByParent(allItems: ItemMetadata[]): Map<string, ItemMetadata[]>;
+export declare function buildChildrenByParent(allItems:ItemMetadata[]):Map<string,ItemMetadata[]>;
 /**
  * Projects an item onto the compact {@link ContextFocusItem} focus row. When both
  * a status registry and a parent→children index are supplied, it also folds in the
  * descendant rollup (`children_total`/`children_closed`/`completion_pct`). Exported
  * so sibling read commands (e.g. `pm next`) emit identically-shaped focus rows.
  */
-export declare function toContextFocusItem(item: ItemMetadata, statusRegistry?: RuntimeStatusRegistry, childrenByParent?: Map<string, ItemMetadata[]>): ContextFocusItem;
-declare function summarizeAgenda(events: CalendarRow[]): ContextAgendaSummary;
+export declare function toContextFocusItem(item:ItemMetadata,statusRegistry?:RuntimeStatusRegistry,childrenByParent?:Map<string,ItemMetadata[]>):ContextFocusItem;
+declare function summarizeAgenda(events:CalendarRow[]):ContextAgendaSummary;
 /** Combines warning groups into a stable, duplicate-free lexical ordering. */
-export declare function mergeSortedWarnings(...warningGroups: Array<string[] | undefined>): string[];
-declare function filterTerminalCalendarEvents(events: CalendarRow[], statusRegistry: RuntimeStatusRegistry): CalendarRow[];
-declare function buildHierarchy(allItems: ItemMetadata[], activeItems: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, limit: number): HierarchyNode[];
-declare function collectDescendants(parentId: string, childrenByParent: Map<string, ItemMetadata[]>): ItemMetadata[];
+export declare function mergeSortedWarnings(...warningGroups:Array<string[] | undefined>):string[];
+declare function filterTerminalCalendarEvents(events:CalendarRow[],statusRegistry:RuntimeStatusRegistry):CalendarRow[];
+declare function buildHierarchy(allItems:ItemMetadata[],activeItems:ItemMetadata[],statusRegistry:RuntimeStatusRegistry,limit:number):HierarchyNode[];
+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;
+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;
 };
-declare function buildActivity(activityLimit: number, global: GlobalOptions): Promise<CompactActivityEntry[]>;
-declare function buildProgress(allItems: ItemMetadata[], activeItems: ItemMetadata[], blockedIds: ReadonlySet<string>, statusRegistry: RuntimeStatusRegistry, limit: number): ProgressEntry[];
-declare function buildBlockers(blockedItems: ItemMetadata[], fullCorpus: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, limit: number): BlockerEntry[];
-declare function buildHotFiles(activeItems: ItemMetadata[], limit: number): HotFile[];
-declare function buildWorkload(activeItems: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, limit: number): WorkloadEntry[];
-declare function buildStaleness(allNonTerminal: ItemMetadata[], staleThresholdDays: number, now: string, limit: number): StaleEntry[];
-declare function buildRecentlyCreated(allNonTerminal: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, childrenByParent: Map<string, ItemMetadata[]>, limit: number): RecentContextItem[];
-declare function buildUnparented(allNonTerminal: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, childrenByParent: Map<string, ItemMetadata[]>, limit: number): ContextFocusItem[];
-declare function buildTestHealth(activeItems: ItemMetadata[]): TestHealthSummary;
-declare function formatAgendaLine(event: ContextAgendaEvent): string;
+declare function buildActivity(activityLimit:number,global:GlobalOptions):Promise<CompactActivityEntry[]>;
+declare function buildProgress(allItems:ItemMetadata[],activeItems:ItemMetadata[],blockedIds:ReadonlySet<string>,statusRegistry:RuntimeStatusRegistry,limit:number):ProgressEntry[];
+declare function buildBlockers(blockedItems:ItemMetadata[],fullCorpus:ItemMetadata[],statusRegistry:RuntimeStatusRegistry,limit:number):BlockerEntry[];
+declare function buildHotFiles(activeItems:ItemMetadata[],limit:number):HotFile[];
+declare function buildWorkload(activeItems:ItemMetadata[],statusRegistry:RuntimeStatusRegistry,limit:number):WorkloadEntry[];
+declare function buildStaleness(allNonTerminal:ItemMetadata[],staleThresholdDays:number,now:string,limit:number):StaleEntry[];
+declare function buildRecentlyCreated(allNonTerminal:ItemMetadata[],statusRegistry:RuntimeStatusRegistry,childrenByParent:Map<string,ItemMetadata[]>,limit:number):RecentContextItem[];
+declare function buildUnparented(allNonTerminal:ItemMetadata[],statusRegistry:RuntimeStatusRegistry,childrenByParent:Map<string,ItemMetadata[]>,limit:number):ContextFocusItem[];
+declare function buildTestHealth(activeItems:ItemMetadata[]):TestHealthSummary;
+declare function formatAgendaLine(event:ContextAgendaEvent):string;
 /** Implements render context markdown for the public runtime surface of this module. */
-export declare function renderContextMarkdown(result: ContextResult): string;
+export declare function renderContextMarkdown(result:ContextResult):string;
 /**
  * Remove redundant context tags while preserving their provenance. Identical
  * child tag sets are folded only when the parent row is present in the same
  * bounded result, so consumers never need an unavailable follow-up read.
  * `--no-tags` removes both tag values and inheritance markers.
  */
-export declare function applyContextTagProjection(result: ContextResult, noTags: boolean): void;
+export declare function applyContextTagProjection(result:ContextResult,noTags:boolean):void;
 /** Resolve the optional static extension-health projection without module imports. */
-export declare function resolveContextExtensionHealthProjection(omitted: boolean, pmRoot: string, settings: PmSettings): Promise<Pick<ContextResult, "extension_health">>;
+export declare function resolveContextExtensionHealthProjection(omitted:boolean,pmRoot:string,settings:PmSettings):Promise<Pick<ContextResult,"extension_health">>;
 /** Implements run context for the public runtime surface of this module. */
-export declare function runContext(options: ContextOptions, global: GlobalOptions): Promise<ContextResult>;
+export declare function runContext(options:ContextOptions,global:GlobalOptions):Promise<ContextResult>;