@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/traceability/runtime-files-lookup.d.ts

@@ -5,4 +5,4 @@
  */
 import type { FilesLookupOptions } from "../files.js";
 /** Convert bounded MCP/action values into the public files lookup contract. */
-export declare function runtimeFilesLookupOptions(options: Readonly<Record<string, unknown>>, paths: string[], parseInteger: (value: unknown, label: string) => number | undefined): FilesLookupOptions;
+export declare function runtimeFilesLookupOptions(options:Readonly<Record<string,unknown>>,paths:string[],parseInteger:(value:unknown,label:string) => number | undefined):FilesLookupOptions;

package/dist/sdk/traceability/source-traceability.d.ts

@@ -1,102 +1,102 @@
-import type { ItemMetadata, LinkedFile } from "../../types/index.js";
+import type { ItemMetadata,LinkedFile } from "../../types/index.js";
 /** Inclusive one-based source range accepted by traceability lookup. */
 export interface SourceLineRange {
 /** First included source line. */
-start: number;
+start:number;
 /** Last included source line. */
-end: number;
+end:number;
 }
 /** One evidence class supporting a source-to-item association. */
 export interface SourceTraceabilityEvidence {
 /** Evidence producer. */
-kind: "linked_file" | "git_commit";
+kind:"linked_file" | "git_commit";
 /** Linked path or abbreviated commit identifier. */
-reference: string;
+reference:string;
 /** Number of selected lines attributed to this evidence. */
-contribution_lines?: number;
+contribution_lines?:number;
 }
 /** Rationale fields projected without arbitrary body or comment content. */
 export interface SourceTraceabilityRationale {
 /** User or project value statement. */
-value: string | null;
+value:string | null;
 /** Recorded timing rationale. */
-why_now: string | null;
+why_now:string | null;
 /** Recorded intended or achieved outcome. */
-outcome: string | null;
+outcome:string | null;
 /** Recorded implementation objective. */
-objective: string | null;
+objective:string | null;
 }
 /** Shortest typed path from source-owning work to a governing decision. */
 export interface SourceDecisionPath {
 /** Whether a unique decision path was found under the bound. */
-status: "found" | "ambiguous" | "not_found";
+status:"found" | "ambiguous" | "not_found";
 /** Ordered item identifiers, including source work and decision. */
-nodes: string[];
+nodes:string[];
 /** Relationship kinds connecting consecutive nodes. */
-kinds: string[];
+kinds:string[];
 /** Equally short governing decision candidates. */
-alternative_decision_ids: string[];
+alternative_decision_ids:string[];
 }
 /** Explainable fields added to one reverse linked-file match. */
 export interface SourceTraceabilityExplanation {
 /** Higher values sort first within the original scheduling priority. */
-score: number;
+score:number;
 /** Selected source lines attributable to commits naming this item. */
-contribution_lines: number;
+contribution_lines:number;
 /** Structured evidence supporting the association. */
-evidence: SourceTraceabilityEvidence[];
+evidence:SourceTraceabilityEvidence[];
 /** Project rationale carried by the item. */
-rationale: SourceTraceabilityRationale;
+rationale:SourceTraceabilityRationale;
 /** Governing decision path under the declared graph bound. */
-decision_path: SourceDecisionPath;
+decision_path:SourceDecisionPath;
 /** Honest ambiguity codes; an empty list means no ambiguity was observed. */
-ambiguities: string[];
+ambiguities:string[];
 }
 /** Aggregate line-attribution receipt returned beside explained matches. */
 export interface SourceTraceabilityReceipt {
 /** Inclusive selected range, or null for path-only explanation. */
-line_range: SourceLineRange | null;
+line_range:SourceLineRange | null;
 /** Number of distinct blamed commits. */
-blamed_commit_count: number;
+blamed_commit_count:number;
 /** Number of blamed commits whose message named at least one pm item. */
-mapped_commit_count: number;
+mapped_commit_count:number;
 /** Number of blamed commits without an item reference. */
-unmapped_commit_count: number;
+unmapped_commit_count:number;
 /** Maximum relationship depth searched for a governing decision. */
-decision_depth: number;
+decision_depth:number;
 }
 interface TraceabilityCandidate {
-item: ItemMetadata;
-files: LinkedFile[];
+item:ItemMetadata;
+files:LinkedFile[];
 }
 interface GitAttribution {
-commitLines: Map<string, number>;
-commitItems: Map<string, string[]>;
-available: boolean;
+commitLines:Map<string,number>;
+commitItems:Map<string,string[]>;
+available:boolean;
 }
 /** Parse an inclusive `start:end` source-line selector. */
-export declare function parseSourceLineRange(value: string): SourceLineRange;
-declare function parseBlameCommits(output: string): Map<string, number>;
-declare function parseCommitItemReferences(output: string): Map<string, string[]>;
-declare function shortestDecisionPath(itemId: string, corpus: readonly ItemMetadata[], maxDepth: number): SourceDecisionPath;
-declare function mappedBlamedCommits(attribution: GitAttribution): string[];
+export declare function parseSourceLineRange(value:string):SourceLineRange;
+declare function parseBlameCommits(output:string):Map<string,number>;
+declare function parseCommitItemReferences(output:string):Map<string,string[]>;
+declare function shortestDecisionPath(itemId:string,corpus:readonly ItemMetadata[],maxDepth:number):SourceDecisionPath;
+declare function mappedBlamedCommits(attribution:GitAttribution):string[];
 /** Enrich reverse linked-file candidates with bounded source rationale. */
-export declare function explainSourceTraceability(params: {
-workspaceRoot: string;
-paths: readonly string[];
-candidates: readonly TraceabilityCandidate[];
-corpus: readonly ItemMetadata[];
-lineRange?: SourceLineRange;
-decisionDepth?: number;
-}): Promise<{
-explanations: Map<string, SourceTraceabilityExplanation>;
-receipt: SourceTraceabilityReceipt;
+export declare function explainSourceTraceability(params:{
+workspaceRoot:string;
+paths:readonly string[];
+candidates:readonly TraceabilityCandidate[];
+corpus:readonly ItemMetadata[];
+lineRange?:SourceLineRange;
+decisionDepth?:number;
+}):Promise<{
+explanations:Map<string,SourceTraceabilityExplanation>;
+receipt:SourceTraceabilityReceipt;
 }>;
 /** Internal parser and traversal seams for deterministic boundary tests. */
-export declare const _testOnlySourceTraceability: {
-mappedBlamedCommits: typeof mappedBlamedCommits;
-parseBlameCommits: typeof parseBlameCommits;
-parseCommitItemReferences: typeof parseCommitItemReferences;
-shortestDecisionPath: typeof shortestDecisionPath;
+export declare const _testOnlySourceTraceability:{
+mappedBlamedCommits:typeof mappedBlamedCommits;
+parseBlameCommits:typeof parseBlameCommits;
+parseCommitItemReferences:typeof parseCommitItemReferences;
+shortestDecisionPath:typeof shortestDecisionPath;
 };
 export {};

package/dist/sdk/workspace-contracts-cache.d.ts

@@ -5,6 +5,6 @@
  */
 import type { ExtensionRegistrationRegistry } from "../core/extensions/index.js";
 /** Drop all memoized workspace extension registrations so the next `getWorkspaceContracts` call re-loads and re-activates extensions from disk. Long-lived hosts should call this after any extension or settings mutation. */
-export declare function clearWorkspaceContractsCache(): void;
+export declare function clearWorkspaceContractsCache():void;
 /** Memoize one workspace extension-registration load and evict rejected entries so transient activation failures do not poison long-lived embedding hosts. */
-export declare function memoizeWorkspaceExtensionRegistrations(cacheKey: string, loadRegistrations: () => Promise<ExtensionRegistrationRegistry | null>): Promise<ExtensionRegistrationRegistry | null>;
+export declare function memoizeWorkspaceExtensionRegistrations(cacheKey:string,loadRegistrations:() => Promise<ExtensionRegistrationRegistry | null>):Promise<ExtensionRegistrationRegistry | null>;

package/dist/sdk/workspace-contracts.d.ts

@@ -10,47 +10,47 @@ import type { RuntimeFieldType } from "../types/index.js";
 /** Runtime custom-field metadata exposed to SDK and MCP consumers. */
 export interface WorkspaceFieldContract {
 /** Stable schema key persisted in item metadata. */
-key: string;
+key:string;
 /** Camel-case action option accepted by SDK and MCP calls. */
-optionName: string;
+optionName:string;
 /** Persisted metadata key. */
-metadataKey: string;
+metadataKey:string;
 /** JSON-compatible field value type. */
-type: RuntimeFieldType;
+type:RuntimeFieldType;
 /** Actions on which the field is accepted. */
-commands: string[];
+commands:string[];
 /** Whether the action accepts more than one value. */
-repeatable: boolean;
+repeatable:boolean;
 /** Whether create requires the field for every item. */
-requiredOnCreate: boolean;
+requiredOnCreate:boolean;
 /** Optional agent-facing explanation. */
-description?: string;
+description?:string;
 }
 /** Activated extension command metadata exposed to SDK and MCP consumers. */
 export interface WorkspaceExtensionCommandContract {
 /** Canonical command path. */
-command: string;
+command:string;
 /** Action name accepted by generic SDK dispatch. */
-action: string;
+action:string;
 /** Positional argument definitions. */
-arguments: Array<{
+arguments:Array<{
 /** Stable positional argument name. */
-name: string;
+name:string;
 /** Whether callers must provide the argument. */
-required: boolean;
+required:boolean;
 /** Whether the argument accepts multiple values. */
-variadic: boolean;
+variadic:boolean;
 /** Optional agent-facing explanation. */
-description?: string;
+description?:string;
 }>;
 /** Optional agent-facing explanation. */
-description?: string;
+description?:string;
 /** Minimum agent surface tier requested by the extension. */
-tier: "core" | "standard" | "full" | "internal";
+tier:"core" | "standard" | "full" | "internal";
 /** Capability family declared by the extension. */
-family: PmCommandCapabilityFamily;
+family:PmCommandCapabilityFamily;
 }
 /** Project resolved custom-field definitions into the public workspace shape. */
-export declare function buildWorkspaceFieldContracts(definitions: RuntimeFieldDefinitionResolved[]): WorkspaceFieldContract[];
+export declare function buildWorkspaceFieldContracts(definitions:RuntimeFieldDefinitionResolved[]):WorkspaceFieldContract[];
 /** Project activated extension registrations into the public workspace shape. */
-export declare function buildWorkspaceExtensionCommandContracts(definitions: RegisteredExtensionCommandDefinition[]): WorkspaceExtensionCommandContract[];
+export declare function buildWorkspaceExtensionCommandContracts(definitions:RegisteredExtensionCommandDefinition[]):WorkspaceExtensionCommandContract[];

package/dist/sdk/workspace-memory.d.ts

@@ -6,105 +6,105 @@ export declare const DEFAULT_WORKSPACE_MEMORY_MINIMUM_ITEMS = 10000;
 /** A bounded item reference retained inside one historical rollup. */
 export interface WorkspaceMemoryItemReference {
 /** Stable item identifier. */
-id: string;
+id:string;
 /** Human-readable item title. */
-title: string;
+title:string;
 }
 /** Deterministic historical summary for one calendar epoch or epic lineage. */
 export interface WorkspaceMemoryRollup {
 /** Stable rollup kind. */
-kind: "epoch" | "epic";
+kind:"epoch" | "epic";
 /** Stable kind-scoped rollup key. */
-key: string;
+key:string;
 /** Human-readable rollup label. */
-label: string;
+label:string;
 /** Number of completed items represented by this rollup. */
-item_count: number;
+item_count:number;
 /** Earliest completion timestamp represented by this rollup. */
-first_closed_at: string;
+first_closed_at:string;
 /** Latest completion timestamp represented by this rollup. */
-last_closed_at: string;
+last_closed_at:string;
 /** Bounded newest-first examples that let agents recover exact item context. */
-representative_items: WorkspaceMemoryItemReference[];
+representative_items:WorkspaceMemoryItemReference[];
 /** Bounded distinct completion outcomes for semantic and keyword recall. */
-outcomes: string[];
+outcomes:string[];
 /** Number of durable notes and learnings represented by the rollup. */
-knowledge_entries: number;
+knowledge_entries:number;
 }
 /** Complete rebuildable workspace-memory projection tied to one source cursor. */
 export interface WorkspaceMemorySnapshot {
 /** Serialized projection format version. */
-format_version: number;
+format_version:number;
 /** Authoritative metadata-index or scan cursor. */
-source_cursor: string;
+source_cursor:string;
 /** Number of authoritative items used to derive the projection. */
-source_item_count: number;
+source_item_count:number;
 /** Timestamp at which this projection was generated. */
-generated_at: string;
+generated_at:string;
 /** Counts disclosing actual-completion use versus legacy fallback sources. */
-completion_time_sources?: Record<CompletionTimestampSource, number>;
+completion_time_sources?:Record<CompletionTimestampSource,number>;
 /** Deterministically ordered historical rollups. */
-rollups: WorkspaceMemoryRollup[];
+rollups:WorkspaceMemoryRollup[];
 }
 /** Result of reading, rebuilding, or intentionally skipping workspace memory. */
 export interface WorkspaceMemoryReadResult {
 /** Projection when the corpus meets the configured tier threshold. */
-snapshot: WorkspaceMemorySnapshot | null;
+snapshot:WorkspaceMemorySnapshot | null;
 /** Whether persistence was reused, rebuilt, or skipped for a small corpus. */
-cache_status: "fresh" | "rebuilt" | "skipped";
+cache_status:"fresh" | "rebuilt" | "skipped";
 /** Stable degradation warnings. */
-warnings: string[];
+warnings:string[];
 }
 /** Agent-facing bounded context projection derived from a workspace-memory read. */
 export interface WorkspaceMemorySelection {
 /** Whether the persisted projection was reused or rebuilt. */
-cache_status: "fresh" | "rebuilt";
+cache_status:"fresh" | "rebuilt";
 /** Authoritative cursor represented by the projection. */
-source_cursor: string;
+source_cursor:string;
 /** Counts disclosing actual-completion use versus legacy fallback sources. */
-completion_time_sources?: Record<CompletionTimestampSource, number>;
+completion_time_sources?:Record<CompletionTimestampSource,number>;
 /** Token-bounded historical rollups. */
-rollups: WorkspaceMemoryRollup[];
+rollups:WorkspaceMemoryRollup[];
 }
 /** Agent-facing search matches derived from a workspace-memory read. */
 export interface WorkspaceMemorySearchResult {
 /** Whether the persisted projection was reused or rebuilt. */
-cache_status: "fresh" | "rebuilt";
+cache_status:"fresh" | "rebuilt";
 /** Historical rollups matching the query. */
-matches: WorkspaceMemoryRollup[];
+matches:WorkspaceMemoryRollup[];
 }
 /**
  * Fold completed history into deterministic calendar-epoch and epic-lineage
  * rollups. The projection contains only rebuildable summaries and bounded item
  * references; authoritative item documents and history remain untouched.
  */
-export declare function buildWorkspaceMemorySnapshot(items: readonly ItemMetadata[], options: {
-statusRegistry: RuntimeStatusRegistry;
-sourceCursor: string;
-now: string;
-}): WorkspaceMemorySnapshot;
+export declare function buildWorkspaceMemorySnapshot(items:readonly ItemMetadata[],options:{
+statusRegistry:RuntimeStatusRegistry;
+sourceCursor:string;
+now:string;
+}):WorkspaceMemorySnapshot;
 /** Read a fresh cursor-bound projection or rebuild it from authoritative items. */
-export declare function readWorkspaceMemory(items: readonly ItemMetadata[], options: {
-pmRoot: string;
-statusRegistry: RuntimeStatusRegistry;
-now: string;
-minimumItems?: number;
-sourceCursor?: string;
-}): Promise<WorkspaceMemoryReadResult>;
+export declare function readWorkspaceMemory(items:readonly ItemMetadata[],options:{
+pmRoot:string;
+statusRegistry:RuntimeStatusRegistry;
+now:string;
+minimumItems?:number;
+sourceCursor?:string;
+}):Promise<WorkspaceMemoryReadResult>;
 /**
  * Select recent rollups within an approximate agent-token budget. Epoch and
  * epic rows are interleaved by recency because snapshot order is deterministic.
  */
-export declare function selectWorkspaceMemoryRollups(snapshot: WorkspaceMemorySnapshot, tokenBudget: number, limit?: number): WorkspaceMemoryRollup[];
+export declare function selectWorkspaceMemoryRollups(snapshot:WorkspaceMemorySnapshot,tokenBudget:number,limit?:number):WorkspaceMemoryRollup[];
 /**
  * Convert a persisted read into a token-bounded context section. Small
  * workspaces and empty token windows intentionally return no section.
  */
-export declare function selectWorkspaceMemory(memory: WorkspaceMemoryReadResult, tokenBudget: number, limit?: number): WorkspaceMemorySelection | undefined;
+export declare function selectWorkspaceMemory(memory:WorkspaceMemoryReadResult,tokenBudget:number,limit?:number):WorkspaceMemorySelection | undefined;
 /** Search derived rollups without expanding the authoritative closed corpus. */
-export declare function searchWorkspaceMemory(snapshot: WorkspaceMemorySnapshot | null, query: string, limit?: number): WorkspaceMemoryRollup[];
+export declare function searchWorkspaceMemory(snapshot:WorkspaceMemorySnapshot | null,query:string,limit?:number):WorkspaceMemoryRollup[];
 /**
  * Convert a persisted read into bounded query matches. Small workspaces and
  * unmatched queries intentionally return no section.
  */
-export declare function searchWorkspaceMemoryReadResult(memory: WorkspaceMemoryReadResult, query: string, limit?: number): WorkspaceMemorySearchResult | undefined;
+export declare function searchWorkspaceMemoryReadResult(memory:WorkspaceMemoryReadResult,query:string,limit?:number):WorkspaceMemorySearchResult | undefined;

package/dist/sdk/workspace-recipe.d.ts

@@ -9,27 +9,27 @@ import { type ReproducibleExecutionSettings } from "../core/reproducibility/cont
 export declare const PM_WORKSPACE_RECIPE_SCHEMA = "https://schema.unbrained.dev/pm/workspace-recipe/v1";
 /** Recursive JSON value accepted by portable workspace recipe inputs. */
 export type WorkspaceRecipeJsonValue = null | boolean | number | string | readonly WorkspaceRecipeJsonValue[] | {
-readonly [key: string]: WorkspaceRecipeJsonValue;
+readonly [key:string]:WorkspaceRecipeJsonValue;
 };
 /** One declared SDK or CLI operation in a reproducible workspace recipe. */
 export interface WorkspaceRecipeOperation {
 /** Public action name understood by the caller-provided executor. */
-action: string;
+action:string;
 /** JSON-compatible action input forwarded without interpretation. */
-input: Readonly<Record<string, WorkspaceRecipeJsonValue>>;
+input:Readonly<Record<string,WorkspaceRecipeJsonValue>>;
 }
 /** Portable inputs required to replay a deterministic workspace execution. */
 export interface WorkspaceRecipe extends ReproducibleExecutionSettings {
 /** Versioned recipe schema identifier. */
-schema: typeof PM_WORKSPACE_RECIPE_SCHEMA;
+schema:typeof PM_WORKSPACE_RECIPE_SCHEMA;
 /** Ordered operations executed inside the deterministic context. */
-operations: readonly WorkspaceRecipeOperation[];
+operations:readonly WorkspaceRecipeOperation[];
 }
-type ExactWorkspaceRecipe<TRecipe extends WorkspaceRecipe> = TRecipe & Record<Exclude<keyof TRecipe, keyof WorkspaceRecipe>, never>;
+type ExactWorkspaceRecipe<TRecipe extends WorkspaceRecipe> = TRecipe & Record<Exclude<keyof TRecipe,keyof WorkspaceRecipe>,never>;
 /** Validate and freeze a caller-authored reproducible workspace recipe. */
-export declare function defineWorkspaceRecipe<const TRecipe extends WorkspaceRecipe>(recipe: ExactWorkspaceRecipe<TRecipe>): Readonly<TRecipe>;
+export declare function defineWorkspaceRecipe<const TRecipe extends WorkspaceRecipe>(recipe:ExactWorkspaceRecipe<TRecipe>):Readonly<TRecipe>;
 /** Run arbitrary SDK work under the recipe's deterministic clock and entropy. */
-export declare function runWithWorkspaceRecipe<T>(recipe: WorkspaceRecipe, operation: () => Promise<T>): Promise<T>;
+export declare function runWithWorkspaceRecipe<T>(recipe:WorkspaceRecipe,operation:() => Promise<T>):Promise<T>;
 /** Replay every declared recipe operation with a caller-provided dispatcher. */
-export declare function executeWorkspaceRecipe<T>(recipe: WorkspaceRecipe, execute: (operation: WorkspaceRecipeOperation, index: number) => Promise<T>): Promise<T[]>;
+export declare function executeWorkspaceRecipe<T>(recipe:WorkspaceRecipe,execute:(operation:WorkspaceRecipeOperation,index:number) => Promise<T>):Promise<T[]>;
 export {};