@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/improvement-ledger.d.ts

@@ -3,120 +3,120 @@ import { parseImprovementLedgerDocument as parseLedger } from "./improvement-led
 export type ImprovementDirection = "higher" | "lower" | "target";
 /** One immutable quantitative observation retained by the workspace ledger. */
 export interface ImprovementObservation {
-    /** Content-derived observation identity. */
-    id: string;
-    /** Stable, agent-readable metric name. */
-    metric: string;
-    /** Finite observed numeric value. */
-    value: number;
-    /** Direction in which later values improve. */
-    direction: ImprovementDirection;
-    /** Optional domain unit such as count, ms, bytes, or percent. */
-    unit?: string;
-    /** Required target when direction is target; optional gate threshold otherwise. */
-    threshold?: number;
-    /** ISO timestamp at which the value was observed. */
-    observed_at: string;
-    /** Git commit, caller revision, or explicit unversioned marker. */
-    revision: string;
-    /** How the revision value was obtained. */
-    revision_source: "caller" | "git" | "unversioned";
-    /** Attributed actor that recorded the observation. */
-    author: string;
-    /** Optional tracked item owning the measurement. */
-    item_id?: string;
-    /** Optional producing instrument or gate name. */
-    source?: string;
-    /** Stable retry key when supplied or derivable from a revision. */
-    idempotency_key?: string;
+/** Content-derived observation identity. */
+id: string;
+/** Stable, agent-readable metric name. */
+metric: string;
+/** Finite observed numeric value. */
+value: number;
+/** Direction in which later values improve. */
+direction: ImprovementDirection;
+/** Optional domain unit such as count, ms, bytes, or percent. */
+unit?: string;
+/** Required target when direction is target; optional gate threshold otherwise. */
+threshold?: number;
+/** ISO timestamp at which the value was observed. */
+observed_at: string;
+/** Git commit, caller revision, or explicit unversioned marker. */
+revision: string;
+/** How the revision value was obtained. */
+revision_source: "caller" | "git" | "unversioned";
+/** Attributed actor that recorded the observation. */
+author: string;
+/** Optional tracked item owning the measurement. */
+item_id?: string;
+/** Optional producing instrument or gate name. */
+source?: string;
+/** Stable retry key when supplied or derivable from a revision. */
+idempotency_key?: string;
 }
 /** Versioned workspace singleton containing every retained observation. */
 export interface ImprovementLedgerDocument {
-    /** Storage contract revision. */
-    format_version: 1;
-    /** Append-only observations in deterministic chronological order. */
-    observations: ImprovementObservation[];
+/** Storage contract revision. */
+format_version: 1;
+/** Append-only observations in deterministic chronological order. */
+observations: ImprovementObservation[];
 }
 /** Mutation controls accepted by {@link recordImprovementObservation}. */
 export interface RecordImprovementObservationOptions {
-    /** Stable metric name. */
-    metric: string;
-    /** Finite observed numeric value. */
-    value: number;
-    /** Direction in which later values improve. */
-    direction?: ImprovementDirection;
-    /** Optional domain unit. */
-    unit?: string;
-    /** Target or gate threshold associated with this observation. */
-    threshold?: number;
-    /** Optional producing instrument or gate name. */
-    source?: string;
-    /** Optional tracked item owning the observation. */
-    itemId?: string;
-    /** Explicit source revision; otherwise git HEAD is resolved when available. */
-    revision?: string;
-    /** Explicit observation time, primarily for reproducible importers. */
-    observedAt?: string;
-    /** Explicit retry identity. */
-    idempotencyKey?: string;
-    /** Intentional author override. */
-    author?: string;
-    /** Human-readable audit rationale. */
-    message?: string;
+/** Stable metric name. */
+metric: string;
+/** Finite observed numeric value. */
+value: number;
+/** Direction in which later values improve. */
+direction?: ImprovementDirection;
+/** Optional domain unit. */
+unit?: string;
+/** Target or gate threshold associated with this observation. */
+threshold?: number;
+/** Optional producing instrument or gate name. */
+source?: string;
+/** Optional tracked item owning the observation. */
+itemId?: string;
+/** Explicit source revision; otherwise git HEAD is resolved when available. */
+revision?: string;
+/** Explicit observation time, primarily for reproducible importers. */
+observedAt?: string;
+/** Explicit retry identity. */
+idempotencyKey?: string;
+/** Intentional author override. */
+author?: string;
+/** Human-readable audit rationale. */
+message?: string;
 }
 /** Receipt returned after recording or replaying one observation. */
 export interface RecordImprovementObservationResult {
-    /** Whether a new observation was appended. */
-    changed: boolean;
-    /** Recorded or idempotently replayed observation. */
-    observation: ImprovementObservation;
-    /** Workspace-relative singleton path. */
-    ledger_path: "improvement-ledger.json";
+/** Whether a new observation was appended. */
+changed: boolean;
+/** Recorded or idempotently replayed observation. */
+observation: ImprovementObservation;
+/** Workspace-relative singleton path. */
+ledger_path: "improvement-ledger.json";
 }
 /** Bounded read controls for {@link readImprovementLedger}. */
 export interface ReadImprovementLedgerOptions {
-    /** Explicit tracker root, equivalent to global --pm-path. */
-    pmRoot?: string;
-    /** Working directory used for implicit tracker discovery. */
-    cwd?: string;
-    /** Optional exact metric filter. */
-    metric?: string;
-    /** Optional tracked owner filter. */
-    itemId?: string;
-    /** Inclusive ISO timestamp lower bound. */
-    since?: string;
-    /** Maximum newest observations returned. */
-    limit?: number;
+/** Explicit tracker root, equivalent to global --pm-path. */
+pmRoot?: string;
+/** Working directory used for implicit tracker discovery. */
+cwd?: string;
+/** Optional exact metric filter. */
+metric?: string;
+/** Optional tracked owner filter. */
+itemId?: string;
+/** Inclusive ISO timestamp lower bound. */
+since?: string;
+/** Maximum newest observations returned. */
+limit?: number;
 }
 /** One baseline-to-latest trend computed without rewriting observations. */
 export interface ImprovementTrend {
-    /** Stable metric name. */
-    metric: string;
-    /** Direction used to interpret the delta. */
-    direction: ImprovementDirection;
-    /** Oldest matching observation. */
-    baseline: ImprovementObservation;
-    /** Newest matching observation. */
-    latest: ImprovementObservation;
-    /** Latest value minus baseline value. */
-    delta: number;
-    /** Whether the latest value improved over the baseline. */
-    improved: boolean;
-    /** Number of observations contributing to the trend. */
-    sample_count: number;
+/** Stable metric name. */
+metric: string;
+/** Direction used to interpret the delta. */
+direction: ImprovementDirection;
+/** Oldest matching observation. */
+baseline: ImprovementObservation;
+/** Newest matching observation. */
+latest: ImprovementObservation;
+/** Latest value minus baseline value. */
+delta: number;
+/** Whether the latest value improved over the baseline. */
+improved: boolean;
+/** Number of observations contributing to the trend. */
+sample_count: number;
 }
 /** Bounded ledger page plus complete aggregate trend metadata. */
 export interface ImprovementLedgerResult {
-    /** Newest-first observation page. */
-    observations: ImprovementObservation[];
-    /** Matching observation count before the page limit. */
-    total: number;
-    /** Whether older matching rows were omitted. */
-    truncated: boolean;
-    /** Trends for every matching metric, sorted by metric name. */
-    trends: ImprovementTrend[];
-    /** Read provenance for deterministic consumers. */
-    source: "audited_workspace_singleton";
+/** Newest-first observation page. */
+observations: ImprovementObservation[];
+/** Matching observation count before the page limit. */
+total: number;
+/** Whether older matching rows were omitted. */
+truncated: boolean;
+/** Trends for every matching metric, sorted by metric name. */
+trends: ImprovementTrend[];
+/** Read provenance for deterministic consumers. */
+source: "audited_workspace_singleton";
 }
 declare function normalizeMetricName(value: string): string;
 declare function normalizeDirection(value: ImprovementDirection | undefined): ImprovementDirection;
@@ -124,16 +124,16 @@ declare function parseObservationLimit(value: number | undefined): number;
 declare function trendForMetric(observations: ImprovementObservation[]): ImprovementTrend;
 /** Record one audited observation, returning an idempotent receipt on retry. */
 export declare function recordImprovementObservation(options: RecordImprovementObservationOptions, global?: {
-    path?: string;
+path?: string;
 }): Promise<RecordImprovementObservationResult>;
 /** Read a bounded newest-first observation page and derive complete trends. */
 export declare function readImprovementLedger(options?: ReadImprovementLedgerOptions): Promise<ImprovementLedgerResult>;
 /** Pure helpers exposed for storage and trend contract tests. */
 export declare const _testOnlyImprovementLedger: {
-    normalizeMetricName: typeof normalizeMetricName;
-    normalizeDirection: typeof normalizeDirection;
-    parseLedger: typeof parseLedger;
-    parseObservationLimit: typeof parseObservationLimit;
-    trendForMetric: typeof trendForMetric;
+normalizeMetricName: typeof normalizeMetricName;
+normalizeDirection: typeof normalizeDirection;
+parseLedger: typeof parseLedger;
+parseObservationLimit: typeof parseObservationLimit;
+trendForMetric: typeof trendForMetric;
 };
 export {};

package/dist/sdk/init-agent-guidance.d.ts

@@ -6,85 +6,85 @@ export type InitAgentGuidanceMode = "ask" | "add" | "skip" | "status";
 export declare const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[];
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    toPortableRelativePath: typeof toPortableRelativePath;
-    ensureTrailingNewline: typeof ensureTrailingNewline;
-    detectLineEnding: typeof detectLineEnding;
-    findGuidanceBlockRange: typeof findGuidanceBlockRange;
-    buildAgentGuidanceBlock: typeof buildAgentGuidanceBlock;
-    upsertAgentGuidanceBlock: typeof upsertAgentGuidanceBlock;
-    resolveProjectRoot: typeof resolveProjectRoot;
-    resolveTargetGuidancePath: typeof resolveTargetGuidancePath;
-    parsePromptChoice: typeof parsePromptChoice;
-    pushUnique: typeof pushUnique;
-    promptForGuidanceWrite: typeof promptForGuidanceWrite;
-    normalizeAgentGuidanceState: typeof normalizeAgentGuidanceState;
-    applyAgentGuidanceState: typeof applyAgentGuidanceState;
-    writeGuidanceFile: typeof writeGuidanceFile;
-    setAgentGuidanceReadlineFactoryForTests: typeof setAgentGuidanceReadlineFactoryForTests;
+toPortableRelativePath: typeof toPortableRelativePath;
+ensureTrailingNewline: typeof ensureTrailingNewline;
+detectLineEnding: typeof detectLineEnding;
+findGuidanceBlockRange: typeof findGuidanceBlockRange;
+buildAgentGuidanceBlock: typeof buildAgentGuidanceBlock;
+upsertAgentGuidanceBlock: typeof upsertAgentGuidanceBlock;
+resolveProjectRoot: typeof resolveProjectRoot;
+resolveTargetGuidancePath: typeof resolveTargetGuidancePath;
+parsePromptChoice: typeof parsePromptChoice;
+pushUnique: typeof pushUnique;
+promptForGuidanceWrite: typeof promptForGuidanceWrite;
+normalizeAgentGuidanceState: typeof normalizeAgentGuidanceState;
+applyAgentGuidanceState: typeof applyAgentGuidanceState;
+writeGuidanceFile: typeof writeGuidanceFile;
+setAgentGuidanceReadlineFactoryForTests: typeof setAgentGuidanceReadlineFactoryForTests;
 };
 type AgentGuidanceReadlineInterface = ReturnType<typeof readline.createInterface>;
 declare function setAgentGuidanceReadlineFactoryForTests(factory: (() => AgentGuidanceReadlineInterface) | undefined): void;
 interface AgentGuidanceFileScan {
-    file_path: string;
-    exists: boolean;
-    has_guidance: boolean;
-    has_marker: boolean;
-    outdated?: boolean;
+file_path: string;
+exists: boolean;
+has_guidance: boolean;
+has_marker: boolean;
+outdated?: boolean;
 }
 interface AgentGuidanceBlockRange {
-    start_index: number;
-    end_index: number;
+start_index: number;
+end_index: number;
 }
 /** Documents the init agent guidance summary payload exchanged by command, SDK, and package integrations. */
 export interface InitAgentGuidanceSummary {
-    /** Value that configures or reports mode for this contract. */
-    mode: InitAgentGuidanceMode;
-    /** Value that configures or reports present for this contract. */
-    present: boolean;
-    /** Value that configures or reports prompted for this contract. */
-    prompted: boolean;
-    /** Value that configures or reports applied for this contract. */
-    applied: boolean;
-    /** Value that configures or reports skipped for this contract. */
-    skipped: boolean;
-    /** Value that configures or reports declined for this contract. */
-    declined: boolean;
-    /** Value that configures or reports prompt completed for this contract. */
-    prompt_completed: boolean;
-    /** Value that configures or reports template version for this contract. */
-    template_version: number;
-    /** Value that configures or reports target file for this contract. */
-    target_file: string;
-    /** Value that configures or reports checked files for this contract. */
-    checked_files: string[];
-    /** Value that configures or reports files with guidance for this contract. */
-    files_with_guidance: string[];
-    /** Value that configures or reports missing files for this contract. */
-    missing_files: string[];
+/** Value that configures or reports mode for this contract. */
+mode: InitAgentGuidanceMode;
+/** Value that configures or reports present for this contract. */
+present: boolean;
+/** Value that configures or reports prompted for this contract. */
+prompted: boolean;
+/** Value that configures or reports applied for this contract. */
+applied: boolean;
+/** Value that configures or reports skipped for this contract. */
+skipped: boolean;
+/** Value that configures or reports declined for this contract. */
+declined: boolean;
+/** Value that configures or reports prompt completed for this contract. */
+prompt_completed: boolean;
+/** Value that configures or reports template version for this contract. */
+template_version: number;
+/** Value that configures or reports target file for this contract. */
+target_file: string;
+/** Value that configures or reports checked files for this contract. */
+checked_files: string[];
+/** Value that configures or reports files with guidance for this contract. */
+files_with_guidance: string[];
+/** Value that configures or reports missing files for this contract. */
+missing_files: string[];
 }
 /** Documents the run init agent guidance options payload exchanged by command, SDK, and package integrations. */
 export interface RunInitAgentGuidanceOptions {
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Value that configures or reports cwd for this contract. */
-    cwd: string;
-    /** Value that configures or reports mode for this contract. */
-    mode: InitAgentGuidanceMode;
-    /** Value that configures or reports interactive for this contract. */
-    interactive: boolean;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Value that configures or reports cwd for this contract. */
+cwd: string;
+/** Value that configures or reports mode for this contract. */
+mode: InitAgentGuidanceMode;
+/** Value that configures or reports interactive for this contract. */
+interactive: boolean;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
 }
 /** Documents the run init agent guidance result payload exchanged by command, SDK, and package integrations. */
 export interface RunInitAgentGuidanceResult {
-    /** Value that configures or reports summary for this contract. */
-    summary: InitAgentGuidanceSummary;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports next steps for this contract. */
-    next_steps: string[];
-    /** Value that configures or reports settings changed for this contract. */
-    settings_changed: boolean;
+/** Value that configures or reports summary for this contract. */
+summary: InitAgentGuidanceSummary;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports next steps for this contract. */
+next_steps: string[];
+/** Value that configures or reports settings changed for this contract. */
+settings_changed: boolean;
 }
 declare function toPortableRelativePath(projectRoot: string, targetPath: string): string;
 declare function ensureTrailingNewline(value: string): string;
@@ -92,8 +92,8 @@ declare function detectLineEnding(value: string): "\n" | "\r\n";
 declare function findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null;
 declare function buildAgentGuidanceBlock(lineEnding: "\n" | "\r\n", projectTestCommand?: string): string;
 declare function upsertAgentGuidanceBlock(existingContent: string, projectTestCommand?: string): {
-    next_content: string;
-    changed: boolean;
+next_content: string;
+changed: boolean;
 };
 /** Resolve an executable linked-test command from a target repository's own files. */
 export declare function resolveProjectTestCommand(projectRoot: string): Promise<string>;
@@ -104,12 +104,12 @@ declare function promptForGuidanceWrite(targetRelativePath: string): Promise<boo
 declare function normalizeAgentGuidanceState(settings: PmSettings): PmSettings["agent_guidance"];
 declare function pushUnique(target: string[], value: string): void;
 declare function applyAgentGuidanceState(settings: PmSettings, currentState: PmSettings["agent_guidance"]): {
-    changed: boolean;
-    state: PmSettings["agent_guidance"];
+changed: boolean;
+state: PmSettings["agent_guidance"];
 };
 declare function writeGuidanceFile(filePath: string, projectRoot?: string): Promise<{
-    changed: boolean;
-    warnings: string[];
+changed: boolean;
+warnings: string[];
 }>;
 /** Inspect, offer or refresh managed guidance; preserve surrounding prose and return state for the caller's settings transaction. */
 export declare function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult>;