@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -1,78 +1,78 @@
 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;
-    /** Last included source line. */
-    end: number;
+/** First included source line. */
+start: number;
+/** Last included source line. */
+end: number;
 }
 /** One evidence class supporting a source-to-item association. */
 export interface SourceTraceabilityEvidence {
-    /** Evidence producer. */
-    kind: "linked_file" | "git_commit";
-    /** Linked path or abbreviated commit identifier. */
-    reference: string;
-    /** Number of selected lines attributed to this evidence. */
-    contribution_lines?: number;
+/** Evidence producer. */
+kind: "linked_file" | "git_commit";
+/** Linked path or abbreviated commit identifier. */
+reference: string;
+/** Number of selected lines attributed to this evidence. */
+contribution_lines?: number;
 }
 /** Rationale fields projected without arbitrary body or comment content. */
 export interface SourceTraceabilityRationale {
-    /** User or project value statement. */
-    value: string | null;
-    /** Recorded timing rationale. */
-    why_now: string | null;
-    /** Recorded intended or achieved outcome. */
-    outcome: string | null;
-    /** Recorded implementation objective. */
-    objective: string | null;
+/** User or project value statement. */
+value: string | null;
+/** Recorded timing rationale. */
+why_now: string | null;
+/** Recorded intended or achieved outcome. */
+outcome: string | null;
+/** Recorded implementation objective. */
+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";
-    /** Ordered item identifiers, including source work and decision. */
-    nodes: string[];
-    /** Relationship kinds connecting consecutive nodes. */
-    kinds: string[];
-    /** Equally short governing decision candidates. */
-    alternative_decision_ids: string[];
+/** Whether a unique decision path was found under the bound. */
+status: "found" | "ambiguous" | "not_found";
+/** Ordered item identifiers, including source work and decision. */
+nodes: string[];
+/** Relationship kinds connecting consecutive nodes. */
+kinds: string[];
+/** Equally short governing decision candidates. */
+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;
-    /** Selected source lines attributable to commits naming this item. */
-    contribution_lines: number;
-    /** Structured evidence supporting the association. */
-    evidence: SourceTraceabilityEvidence[];
-    /** Project rationale carried by the item. */
-    rationale: SourceTraceabilityRationale;
-    /** Governing decision path under the declared graph bound. */
-    decision_path: SourceDecisionPath;
-    /** Honest ambiguity codes; an empty list means no ambiguity was observed. */
-    ambiguities: string[];
+/** Higher values sort first within the original scheduling priority. */
+score: number;
+/** Selected source lines attributable to commits naming this item. */
+contribution_lines: number;
+/** Structured evidence supporting the association. */
+evidence: SourceTraceabilityEvidence[];
+/** Project rationale carried by the item. */
+rationale: SourceTraceabilityRationale;
+/** Governing decision path under the declared graph bound. */
+decision_path: SourceDecisionPath;
+/** Honest ambiguity codes; an empty list means no ambiguity was observed. */
+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;
-    /** Number of distinct blamed commits. */
-    blamed_commit_count: number;
-    /** Number of blamed commits whose message named at least one pm item. */
-    mapped_commit_count: number;
-    /** Number of blamed commits without an item reference. */
-    unmapped_commit_count: number;
-    /** Maximum relationship depth searched for a governing decision. */
-    decision_depth: number;
+/** Inclusive selected range, or null for path-only explanation. */
+line_range: SourceLineRange | null;
+/** Number of distinct blamed commits. */
+blamed_commit_count: number;
+/** Number of blamed commits whose message named at least one pm item. */
+mapped_commit_count: number;
+/** Number of blamed commits without an item reference. */
+unmapped_commit_count: number;
+/** Maximum relationship depth searched for a governing decision. */
+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;
@@ -82,21 +82,21 @@ declare function shortestDecisionPath(itemId: string, corpus: readonly ItemMetad
 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;
+workspaceRoot: string;
+paths: readonly string[];
+candidates: readonly TraceabilityCandidate[];
+corpus: readonly ItemMetadata[];
+lineRange?: SourceLineRange;
+decisionDepth?: number;
 }): Promise<{
-    explanations: Map<string, SourceTraceabilityExplanation>;
-    receipt: SourceTraceabilityReceipt;
+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;
+mappedBlamedCommits: typeof mappedBlamedCommits;
+parseBlameCommits: typeof parseBlameCommits;
+parseCommitItemReferences: typeof parseCommitItemReferences;
+shortestDecisionPath: typeof shortestDecisionPath;
 };
 export {};

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

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

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

@@ -5,73 +5,73 @@ import { type CompletionTimestampSource } from "./lifecycle-completion.js";
 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;
-    /** Human-readable item title. */
-    title: string;
+/** Stable item identifier. */
+id: string;
+/** Human-readable item title. */
+title: string;
 }
 /** Deterministic historical summary for one calendar epoch or epic lineage. */
 export interface WorkspaceMemoryRollup {
-    /** Stable rollup kind. */
-    kind: "epoch" | "epic";
-    /** Stable kind-scoped rollup key. */
-    key: string;
-    /** Human-readable rollup label. */
-    label: string;
-    /** Number of completed items represented by this rollup. */
-    item_count: number;
-    /** Earliest completion timestamp represented by this rollup. */
-    first_closed_at: string;
-    /** Latest completion timestamp represented by this rollup. */
-    last_closed_at: string;
-    /** Bounded newest-first examples that let agents recover exact item context. */
-    representative_items: WorkspaceMemoryItemReference[];
-    /** Bounded distinct completion outcomes for semantic and keyword recall. */
-    outcomes: string[];
-    /** Number of durable notes and learnings represented by the rollup. */
-    knowledge_entries: number;
+/** Stable rollup kind. */
+kind: "epoch" | "epic";
+/** Stable kind-scoped rollup key. */
+key: string;
+/** Human-readable rollup label. */
+label: string;
+/** Number of completed items represented by this rollup. */
+item_count: number;
+/** Earliest completion timestamp represented by this rollup. */
+first_closed_at: string;
+/** Latest completion timestamp represented by this rollup. */
+last_closed_at: string;
+/** Bounded newest-first examples that let agents recover exact item context. */
+representative_items: WorkspaceMemoryItemReference[];
+/** Bounded distinct completion outcomes for semantic and keyword recall. */
+outcomes: string[];
+/** Number of durable notes and learnings represented by the rollup. */
+knowledge_entries: number;
 }
 /** Complete rebuildable workspace-memory projection tied to one source cursor. */
 export interface WorkspaceMemorySnapshot {
-    /** Serialized projection format version. */
-    format_version: number;
-    /** Authoritative metadata-index or scan cursor. */
-    source_cursor: string;
-    /** Number of authoritative items used to derive the projection. */
-    source_item_count: number;
-    /** Timestamp at which this projection was generated. */
-    generated_at: string;
-    /** Counts disclosing actual-completion use versus legacy fallback sources. */
-    completion_time_sources?: Record<CompletionTimestampSource, number>;
-    /** Deterministically ordered historical rollups. */
-    rollups: WorkspaceMemoryRollup[];
+/** Serialized projection format version. */
+format_version: number;
+/** Authoritative metadata-index or scan cursor. */
+source_cursor: string;
+/** Number of authoritative items used to derive the projection. */
+source_item_count: number;
+/** Timestamp at which this projection was generated. */
+generated_at: string;
+/** Counts disclosing actual-completion use versus legacy fallback sources. */
+completion_time_sources?: Record<CompletionTimestampSource, number>;
+/** Deterministically ordered historical rollups. */
+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;
-    /** Whether persistence was reused, rebuilt, or skipped for a small corpus. */
-    cache_status: "fresh" | "rebuilt" | "skipped";
-    /** Stable degradation warnings. */
-    warnings: string[];
+/** Projection when the corpus meets the configured tier threshold. */
+snapshot: WorkspaceMemorySnapshot | null;
+/** Whether persistence was reused, rebuilt, or skipped for a small corpus. */
+cache_status: "fresh" | "rebuilt" | "skipped";
+/** Stable degradation warnings. */
+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";
-    /** Authoritative cursor represented by the projection. */
-    source_cursor: string;
-    /** Counts disclosing actual-completion use versus legacy fallback sources. */
-    completion_time_sources?: Record<CompletionTimestampSource, number>;
-    /** Token-bounded historical rollups. */
-    rollups: WorkspaceMemoryRollup[];
+/** Whether the persisted projection was reused or rebuilt. */
+cache_status: "fresh" | "rebuilt";
+/** Authoritative cursor represented by the projection. */
+source_cursor: string;
+/** Counts disclosing actual-completion use versus legacy fallback sources. */
+completion_time_sources?: Record<CompletionTimestampSource, number>;
+/** Token-bounded historical rollups. */
+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";
-    /** Historical rollups matching the query. */
-    matches: WorkspaceMemoryRollup[];
+/** Whether the persisted projection was reused or rebuilt. */
+cache_status: "fresh" | "rebuilt";
+/** Historical rollups matching the query. */
+matches: WorkspaceMemoryRollup[];
 }
 /**
  * Fold completed history into deterministic calendar-epoch and epic-lineage
@@ -79,17 +79,17 @@ export interface WorkspaceMemorySearchResult {
  * references; authoritative item documents and history remain untouched.
  */
 export declare function buildWorkspaceMemorySnapshot(items: readonly ItemMetadata[], options: {
-    statusRegistry: RuntimeStatusRegistry;
-    sourceCursor: string;
-    now: string;
+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;
+pmRoot: string;
+statusRegistry: RuntimeStatusRegistry;
+now: string;
+minimumItems?: number;
+sourceCursor?: string;
 }): Promise<WorkspaceMemoryReadResult>;
 /**
  * Select recent rollups within an approximate agent-token budget. Epoch and

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

@@ -9,21 +9,21 @@ 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;
-    /** JSON-compatible action input forwarded without interpretation. */
-    input: Readonly<Record<string, WorkspaceRecipeJsonValue>>;
+/** Public action name understood by the caller-provided executor. */
+action: string;
+/** JSON-compatible action input forwarded without interpretation. */
+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;
-    /** Ordered operations executed inside the deterministic context. */
-    operations: readonly WorkspaceRecipeOperation[];
+/** Versioned recipe schema identifier. */
+schema: typeof PM_WORKSPACE_RECIPE_SCHEMA;
+/** Ordered operations executed inside the deterministic context. */
+operations: readonly WorkspaceRecipeOperation[];
 }
 type ExactWorkspaceRecipe<TRecipe extends WorkspaceRecipe> = TRecipe & Record<Exclude<keyof TRecipe, keyof WorkspaceRecipe>, never>;
 /** Validate and freeze a caller-authored reproducible workspace recipe. */