@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -20,58 +20,58 @@ export declare const NEXT_OUTPUT_VALUES: readonly ["markdown", "toon", "json"];
 export type NextOutputFormat = (typeof NEXT_OUTPUT_VALUES)[number];
 /** Documents the `pm next` options payload exchanged by command, SDK, and package integrations. */
 export interface NextOptions {
-    /** 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 | number;
-    /** 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 parent for this contract. */
-    parent?: string;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
-    /** Value that configures or reports blocked limit for this contract. */
-    blockedLimit?: string;
-    /** Value that configures or reports ready only for this contract. */
-    readyOnly?: boolean;
-    /** Value that configures or reports format for this contract. */
-    format?: string;
-    /** Value that configures or reports explain ranking for this contract. */
-    explainRanking?: boolean;
-    /** Maximum rendered tokens for the recommendation and ready alternatives; companion queues use outputBudget. */
-    tokenBudget?: string | number;
-    /** Include human-gated Decision items in the claimable ready queue. */
-    includeDecisions?: boolean;
-    /** Opt into gate-shaped leaf work; blockers and ownership restrictions still apply. */
-    includeGates?: boolean;
-    /** Opt into containers with unfinished descendants; blockers and ownership restrictions still apply. */
-    includeContainers?: boolean;
-    /** Internal caller override used to align claim-next ranking with --author. */
-    callerAuthor?: string;
-    [key: string]: unknown;
+/** 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 | number;
+/** 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 parent for this contract. */
+parent?: string;
+/** Value that configures or reports limit for this contract. */
+limit?: string;
+/** Value that configures or reports blocked limit for this contract. */
+blockedLimit?: string;
+/** Value that configures or reports ready only for this contract. */
+readyOnly?: boolean;
+/** Value that configures or reports format for this contract. */
+format?: string;
+/** Value that configures or reports explain ranking for this contract. */
+explainRanking?: boolean;
+/** Maximum rendered tokens for the recommendation and ready alternatives; companion queues use outputBudget. */
+tokenBudget?: string | number;
+/** Include human-gated Decision items in the claimable ready queue. */
+includeDecisions?: boolean;
+/** Opt into gate-shaped leaf work; blockers and ownership restrictions still apply. */
+includeGates?: boolean;
+/** Opt into containers with unfinished descendants; blockers and ownership restrictions still apply. */
+includeContainers?: boolean;
+/** Internal caller override used to align claim-next ranking with --author. */
+callerAuthor?: string;
+[key: string]: unknown;
 }
 /** A blocker reference projected onto the `pm next` output. */
 export interface NextBlockerRef {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string | null;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus | null;
-    /** Whether this reference must be checked outside the local tracker. */
-    external?: boolean;
-    /** Conservative timestamp from which the unresolved external block may be stale. */
-    blocked_since?: string;
-    /** External resolver identity, or null when no integration verified the reference. */
-    resolver?: 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 | null;
+/** Lifecycle state reported for status. */
+status: ItemStatus | null;
+/** Whether this reference must be checked outside the local tracker. */
+external?: boolean;
+/** Conservative timestamp from which the unresolved external block may be stale. */
+blocked_since?: string;
+/** External resolver identity, or null when no integration verified the reference. */
+resolver?: string | null;
 }
 /**
  * A classified actionable item on the `pm next` output: a {@link ContextFocusItem}
@@ -79,112 +79,112 @@ export interface NextBlockerRef {
  * would unblock.
  */
 export interface NextActionableItem extends ContextFocusItem {
-    /** One-based position in the complete ranked actionable queue. */
-    rank: number;
-    /** Number of open blocker entries represented by this result. */
-    open_blocker_count: number;
-    /** Value that configures or reports blockers for this contract. */
-    blockers: NextBlockerRef[];
-    /** Value that configures or reports unblocks for this contract. */
-    unblocks: string[];
+/** One-based position in the complete ranked actionable queue. */
+rank: number;
+/** Number of open blocker entries represented by this result. */
+open_blocker_count: number;
+/** Value that configures or reports blockers for this contract. */
+blockers: NextBlockerRef[];
+/** Value that configures or reports unblocks for this contract. */
+unblocks: string[];
 }
 /** The single recommended next item: an actionable row plus its rationale. */
 export interface NextRecommendation extends NextActionableItem {
-    /** Value that configures or reports reasons for this contract. */
-    reasons: string[];
+/** Value that configures or reports reasons for this contract. */
+reasons: string[];
 }
 interface NextSummary {
-    recommended: boolean;
-    ready: number;
-    blocked: number;
-    in_progress: number;
-    candidates: number;
-    containers: number;
-    decision_needed: number;
-    gate_needed?: number;
-    held_by_others: number;
+recommended: boolean;
+ready: number;
+blocked: number;
+in_progress: number;
+candidates: number;
+containers: number;
+decision_needed: number;
+gate_needed?: number;
+held_by_others: number;
 }
 /** Documents the `pm next` result payload exchanged by command, SDK, and package integrations. */
 export interface NextResult {
-    /** 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 recommended for this contract. */
-    recommended: NextRecommendation | null;
-    /** Value that configures or reports ready for this contract. */
-    ready: NextActionableItem[];
-    /** Human-gated decisions kept visible without dispatching them to agents. */
-    decision_needed: NextActionableItem[];
-    /** Outcome gates held out of autonomous dispatch. */
-    gate_needed?: NextActionableItem[];
-    /** Containers with unfinished descendants, retained as readable worklists. */
-    containers?: NextActionableItem[];
-    /** Value that configures or reports blocked for this contract. */
-    blocked: NextActionableItem[];
-    /** Value that configures or reports held by others for this contract. */
-    held_by_others: Array<{
-        id: string;
-        assignee: string;
-    }>;
-    /** Value that configures or reports summary for this contract. */
-    summary: NextSummary;
-    /** Value that configures or reports filters for this contract. */
-    filters: {
-        type: string | null;
-        tag: string | null;
-        priority: string | number | null;
-        assignee: string | null;
-        assignee_filter: string | null;
-        sprint: string | null;
-        release: string | null;
-        parent: string | null;
-        limit: number;
-        blocked_limit: number;
-        ready_only: boolean;
-        include_decisions: boolean;
-        include_gates?: boolean;
-        include_containers?: boolean;
-        token_budget: number;
-    };
-    /** Value that configures or reports suggestions for this contract. */
-    suggestions?: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings?: string[];
-    /** Value that configures or reports ranking for this contract. */
-    ranking?: ContextRankingSummary;
-    /** Advisory candidate-optimizer diagnostics; ready_budget accounts for emitted rows. */
-    packing?: ContextPackingSummary;
-    /** Explicit marker and complete counts for queues truncated by the shared section limit. */
-    truncation?: {
-        /** Complete actionable population before row and token limits. */
-        ready_total?: number;
-        /** Explicit selection-budget accounting, including infeasible empty selections. */
-        ready_budget?: NextReadyBudgetReceipt;
-        decision_needed_total?: number;
-        held_by_others_total?: number;
-        gate_needed_total?: number;
-        containers_total?: number;
-    };
+/** 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 recommended for this contract. */
+recommended: NextRecommendation | null;
+/** Value that configures or reports ready for this contract. */
+ready: NextActionableItem[];
+/** Human-gated decisions kept visible without dispatching them to agents. */
+decision_needed: NextActionableItem[];
+/** Outcome gates held out of autonomous dispatch. */
+gate_needed?: NextActionableItem[];
+/** Containers with unfinished descendants, retained as readable worklists. */
+containers?: NextActionableItem[];
+/** Value that configures or reports blocked for this contract. */
+blocked: NextActionableItem[];
+/** Value that configures or reports held by others for this contract. */
+held_by_others: Array<{
+id: string;
+assignee: string;
+}>;
+/** Value that configures or reports summary for this contract. */
+summary: NextSummary;
+/** Value that configures or reports filters for this contract. */
+filters: {
+type: string | null;
+tag: string | null;
+priority: string | number | null;
+assignee: string | null;
+assignee_filter: string | null;
+sprint: string | null;
+release: string | null;
+parent: string | null;
+limit: number;
+blocked_limit: number;
+ready_only: boolean;
+include_decisions: boolean;
+include_gates?: boolean;
+include_containers?: boolean;
+token_budget: number;
+};
+/** Value that configures or reports suggestions for this contract. */
+suggestions?: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings?: string[];
+/** Value that configures or reports ranking for this contract. */
+ranking?: ContextRankingSummary;
+/** Advisory candidate-optimizer diagnostics; ready_budget accounts for emitted rows. */
+packing?: ContextPackingSummary;
+/** Explicit marker and complete counts for queues truncated by the shared section limit. */
+truncation?: {
+/** Complete actionable population before row and token limits. */
+ready_total?: number;
+/** Explicit selection-budget accounting, including infeasible empty selections. */
+ready_budget?: NextReadyBudgetReceipt;
+decision_needed_total?: number;
+held_by_others_total?: number;
+gate_needed_total?: number;
+containers_total?: number;
+};
 }
 /** Resolves the effective `pm next` output format from the command `--format` flag and the global `--json` switch, rejecting the contradictory `--json --format markdown|toon` combination. Defaults to `toon`. */
 export declare function resolveNextOutputFormat(options: NextOptions, global: GlobalOptions): NextOutputFormat;
 declare function partitionCallerOwnedReady(ready: ActionableEntry[], fallbackAuthor: string, explicitAuthor?: string): {
-    available: ActionableEntry[];
-    held: Array<{
-        id: string;
-        assignee: string;
-    }>;
+available: ActionableEntry[];
+held: Array<{
+id: string;
+assignee: string;
+}>;
 };
 /** Test-only access to deterministic next-work partitioning edge cases. */
 export declare const _testOnlyNextCommand: {
-    partitionCallerOwnedReady: typeof partitionCallerOwnedReady;
-    resolveNextCallerAuthor: (options: NextOptions, settingsAuthor: string) => string;
+partitionCallerOwnedReady: typeof partitionCallerOwnedReady;
+resolveNextCallerAuthor: (options: NextOptions, settingsAuthor: string) => string;
 };
 /** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */
 export declare function partitionDecisionEntries(ready: ActionableEntry[], includeDecisions: boolean, typeRegistry?: ItemTypeRegistry): {
-    agent: ActionableEntry[];
-    decisions: ActionableEntry[];
+agent: ActionableEntry[];
+decisions: ActionableEntry[];
 };
 /** Implements `pm next`: computes the ranked ready/blocked actionable queues and a single recommended next item with rationale for the public runtime surface. */
 export declare function runNext(options: NextOptions, global: GlobalOptions): Promise<NextResult>;

package/dist/sdk/query/projection-contracts.d.ts

@@ -6,14 +6,14 @@ export declare const DEFAULT_COMPACT_LIST_FIELDS: readonly ["id", "title", "stat
 export declare const BRIEF_LIST_FIELDS: readonly ["id", "status", "type", "title"];
 /** Machine-readable default projection contract for every list command. */
 export declare const LIST_COMMAND_DEFAULT_PROJECTIONS: {
-    readonly list: "brief";
-    readonly "list-all": "full";
-    readonly "list-draft": "full";
-    readonly "list-open": "brief";
-    readonly "list-in-progress": "brief";
-    readonly "list-blocked": "brief";
-    readonly "list-closed": "brief";
-    readonly "list-canceled": "full";
+readonly list: "brief";
+readonly "list-all": "full";
+readonly "list-draft": "full";
+readonly "list-open": "brief";
+readonly "list-in-progress": "brief";
+readonly "list-blocked": "brief";
+readonly "list-closed": "brief";
+readonly "list-canceled": "full";
 };
 /** Command names whose output defaults are described by the list projection contract. */
 export type ListCommandName = keyof typeof LIST_COMMAND_DEFAULT_PROJECTIONS;

package/dist/sdk/query/search/corpus.d.ts

@@ -2,16 +2,16 @@ import type { ItemDocument, ItemFormat, ItemMetadata, PmSettings } from "../../.
 import { type SearchMode } from "../search-rendering.js";
 /** Collect linked file and document paths eligible for optional search corpus enrichment. */
 declare function collectLinkedPaths(item: ItemMetadata): Array<{
-    scope: "project" | "global";
-    path: string;
+scope: "project" | "global";
+path: string;
 }>;
 interface ContainmentRoot {
-    resolved: string;
-    realpath: string;
+resolved: string;
+realpath: string;
 }
 interface LinkedCorpusRoots {
-    projectContainmentRoot: ContainmentRoot | null;
-    globalContainmentRoot: ContainmentRoot | null;
+projectContainmentRoot: ContainmentRoot | null;
+globalContainmentRoot: ContainmentRoot | null;
 }
 /** Resolve the workspace and global roots used to contain linked-content reads. */
 declare function resolveLinkedCorpusRoots(projectRoot: string, globalRoot: string): Promise<LinkedCorpusRoots>;
@@ -19,8 +19,8 @@ declare function resolveLinkedCorpusRoots(projectRoot: string, globalRoot: strin
 declare function loadLinkedCorpus(document: ItemDocument, roots: LinkedCorpusRoots): Promise<string>;
 /** Load the searchable item corpus for the resolved tracker. */
 declare function loadDocuments(pmRoot: string, itemFormat: ItemFormat, typeToFolder: Record<string, string>, schema: PmSettings["schema"]): Promise<{
-    documents: ItemDocument[];
-    warnings: string[];
+documents: ItemDocument[];
+warnings: string[];
 }>;
 /** Build an item-ID lookup of linked content for provider execution and reranking. */
 declare function collectLinkedCorpusById(includeLinked: boolean, effectiveMode: SearchMode, filteredDocuments: ItemDocument[]): Promise<Map<string, string>>;

package/dist/sdk/query/search/filters.d.ts

@@ -6,12 +6,12 @@ import { type SearchOptions } from "../search-contracts.js";
 declare function stringArray(value: unknown): string[];
 /** Extract annotation text entries used by exact-phrase matching and lexical scoring. */
 declare function textEntries(value: unknown): Array<{
-    text: string;
+text: string;
 }>;
 /** Extract dependency metadata entries used by filtering and lexical scoring. */
 declare function dependencyEntries(value: unknown): Array<{
-    id: string;
-    kind: string;
+id: string;
+kind: string;
 }>;
 /** Collect searchable text fields used by exact-phrase filtering. */
 declare function collectExactPhraseFields(document: ItemDocument): string[];
@@ -19,8 +19,8 @@ declare function collectExactPhraseFields(document: ItemDocument): string[];
 declare function documentContainsExactPhrase(document: ItemDocument, normalizedQuery: string): boolean;
 /** Apply exact-title and exact-phrase restrictions before search ranking. */
 declare function applyExactQueryFilters(items: ItemDocument[], normalizedQuery: string, options: {
-    titleExact: boolean;
-    phraseExact: boolean;
+titleExact: boolean;
+phraseExact: boolean;
 }): ItemDocument[];
 /** Apply metadata and runtime field predicates to the loaded item corpus. */
 declare function applyFilters(items: ItemDocument[], options: SearchOptions, typeRegistry: ItemTypeRegistry, runtimeFieldFilters: Record<string, unknown>, statusFilter: ItemStatus[] | undefined, lifecycleClassifier: LifecycleClassifier): ItemDocument[];

package/dist/sdk/query/search/input.d.ts

@@ -4,10 +4,10 @@ declare const INLINE_QUERY_FILTER_FIELDS: readonly ["tag", "status", "type", "pr
 type InlineQueryFilterField = (typeof INLINE_QUERY_FILTER_FIELDS)[number];
 /** Result of extracting inline `field:value` tokens from a raw search query. */
 interface InlineQueryParse {
-    /** The query with all recognized inline filter tokens removed. */
-    residualQuery: string;
-    /** Recognized inline filters keyed by field name; first occurrence per field wins. */
-    inlineFilters: Partial<Record<InlineQueryFilterField, string>>;
+/** The query with all recognized inline filter tokens removed. */
+residualQuery: string;
+/** Recognized inline filters keyed by field name; first occurrence per field wins. */
+inlineFilters: Partial<Record<InlineQueryFilterField, string>>;
 }
 /**
  * Split a raw search query into its residual keyword text and any inline

package/dist/sdk/query/search/response.d.ts

@@ -16,19 +16,19 @@ declare function buildEmptySearchResultFromContext(response: SearchResponseConte
 declare function buildCountOnlySearchResult(response: SearchResponseContext, total: number): SearchResult;
 /** Attach bounded historical workspace rollups when the query and workspace qualify. */
 declare function withSearchWorkspaceMemory(result: SearchResult, memory: {
-    cache_status: "fresh" | "rebuilt";
-    matches: WorkspaceMemoryRollup[];
+cache_status: "fresh" | "rebuilt";
+matches: WorkspaceMemoryRollup[];
 } | undefined): SearchResult;
 /** Add matched-field snippets only when highlighting was requested. */
 declare function attachSearchHighlights(prepared: PreparedSearchInput, filteredDocuments: ItemDocument[], limited: SearchHit[]): {
-    hits: SearchHit[];
-    projection: SearchProjectionConfig;
+hits: SearchHit[];
+projection: SearchProjectionConfig;
 };
 /** Apply search pagination and projection to the final ranked hit set. */
 declare function buildSearchResultForHits(response: SearchResponseContext, projectedItems: SearchResultItem[], total: number, limitedCount: number, effectiveProjection: SearchProjectionConfig, pageExtras: {
-    has_more?: boolean;
-    next_cursor?: string;
-    applied_limit: number;
-    truncated?: true;
+has_more?: boolean;
+next_cursor?: string;
+applied_limit: number;
+truncated?: true;
 }): SearchResult;
 export { attachSearchHighlights, buildCountOnlySearchResult, buildEmptySearchResultFromContext, buildSearchResultForHits, emptySearchResult, projectSearchHits, readSearchFieldValue, withSearchWorkspaceMemory };