@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/init.d.ts

@@ -9,154 +9,154 @@ import { installMergeFence } from "./merge/install.js";
 export declare const INIT_INVOCATION_CWD: unique symbol;
 /** Documents the init installed packages summary payload exchanged by command, SDK, and package integrations. */
 export interface InitInstalledPackagesSummary {
-    /** Value that configures or reports installed all for this contract. */
-    installed_all: boolean;
-    /** Number of installed entries represented by this result. */
-    installed_count: number;
-    /** Value that configures or reports packages for this contract. */
-    packages: Array<{
-        alias: string;
-        ok: boolean;
-    }>;
+/** Value that configures or reports installed all for this contract. */
+installed_all: boolean;
+/** Number of installed entries represented by this result. */
+installed_count: number;
+/** Value that configures or reports packages for this contract. */
+packages: Array<{
+alias: string;
+ok: boolean;
+}>;
 }
 /** Restricts init type preset name values accepted by command, SDK, and storage contracts. */
 export type InitTypePresetName = TypePresetName;
 /** Documents the init registered type preset summary payload exchanged by command, SDK, and package integrations. */
 export interface InitRegisteredTypePresetSummary {
-    /** Value that configures or reports name for this contract. */
-    name: InitTypePresetName;
-    /** Value that configures or reports registered for this contract. */
-    registered: string[];
-    /** Value that configures or reports updated for this contract. */
-    updated: string[];
-    /** Value that configures or reports file for this contract. */
-    file: string;
+/** Value that configures or reports name for this contract. */
+name: InitTypePresetName;
+/** Value that configures or reports registered for this contract. */
+registered: string[];
+/** Value that configures or reports updated for this contract. */
+updated: string[];
+/** Value that configures or reports file for this contract. */
+file: string;
 }
 /** Documents the init agent-guidance summary plus generated next-step hints returned by init. */
 export type InitAgentGuidanceResult = InitAgentGuidanceSummary & {
-    next_steps: string[];
+next_steps: string[];
 };
 /** Describes how init resolved the tracker and optional workspace target. */
 export interface InitTargetResolution {
-    /** Value that configures or reports mode for this contract. */
-    mode: "workspace-discovery" | "tracker-path" | "workspace-path";
-    /** Value that configures or reports tracker root for this contract. */
-    tracker_root: string;
-    /** Value that configures or reports workspace root for this contract. */
-    workspace_root?: string;
-    /** How workspace discovery related the invocation directory to the selected tracker. */
-    discovery?: "current" | "ancestor";
-    /** Directory from which workspace discovery was requested. */
-    requested_cwd?: string;
-    /** Explicit tracker root that creates a new workspace in the invocation directory. */
-    suggested_current_tracker_root?: string;
+/** Value that configures or reports mode for this contract. */
+mode: "workspace-discovery" | "tracker-path" | "workspace-path";
+/** Value that configures or reports tracker root for this contract. */
+tracker_root: string;
+/** Value that configures or reports workspace root for this contract. */
+workspace_root?: string;
+/** How workspace discovery related the invocation directory to the selected tracker. */
+discovery?: "current" | "ancestor";
+/** Directory from which workspace discovery was requested. */
+requested_cwd?: string;
+/** Explicit tracker root that creates a new workspace in the invocation directory. */
+suggested_current_tracker_root?: string;
 }
 /** Documents the init result payload exchanged by command, SDK, and package integrations. */
 export interface InitResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports target for this contract. */
-    target: InitTargetResolution;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports created dirs for this contract. */
-    created_dirs: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports governance preset for this contract. */
-    governance_preset: GovernancePreset;
-    /** Value that configures or reports wizard used for this contract. */
-    wizard_used: boolean;
-    /** Value that configures or reports registered type preset for this contract. */
-    registered_type_preset?: InitRegisteredTypePresetSummary;
-    /** Value that configures or reports installed packages for this contract. */
-    installed_packages?: InitInstalledPackagesSummary;
-    /** Value that configures or reports next steps for this contract. */
-    next_steps: string[];
-    /** Value that configures or reports agent guidance for this contract. */
-    agent_guidance: InitAgentGuidanceResult;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports target for this contract. */
+target: InitTargetResolution;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports created dirs for this contract. */
+created_dirs: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports governance preset for this contract. */
+governance_preset: GovernancePreset;
+/** Value that configures or reports wizard used for this contract. */
+wizard_used: boolean;
+/** Value that configures or reports registered type preset for this contract. */
+registered_type_preset?: InitRegisteredTypePresetSummary;
+/** Value that configures or reports installed packages for this contract. */
+installed_packages?: InitInstalledPackagesSummary;
+/** Value that configures or reports next steps for this contract. */
+next_steps: string[];
+/** Value that configures or reports agent guidance for this contract. */
+agent_guidance: InitAgentGuidanceResult;
 }
 /** Documents the init command options payload exchanged by command, SDK, and package integrations. */
 export interface InitCommandOptions {
-    /** Item-id prefix supplied through the flag-oriented SDK/CLI input surface. */
-    idPrefix?: string;
-    /** Value that configures or reports preset for this contract. */
-    preset?: string;
-    /** Value that configures or reports defaults for this contract. */
-    defaults?: boolean;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports with packages for this contract. */
-    withPackages?: boolean;
-    /** Install the repository merge fence for a fresh Git-backed tracker. */
-    mergeFence?: boolean;
-    /** Value that configures or reports agent guidance for this contract. */
-    agentGuidance?: string;
-    /** Value that configures or reports type preset for this contract. */
-    typePreset?: string;
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
-    /** Value that configures or reports workspace for this contract. */
-    workspace?: string;
+/** Item-id prefix supplied through the flag-oriented SDK/CLI input surface. */
+idPrefix?: string;
+/** Value that configures or reports preset for this contract. */
+preset?: string;
+/** Value that configures or reports defaults for this contract. */
+defaults?: boolean;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports with packages for this contract. */
+withPackages?: boolean;
+/** Install the repository merge fence for a fresh Git-backed tracker. */
+mergeFence?: boolean;
+/** Value that configures or reports agent guidance for this contract. */
+agentGuidance?: string;
+/** Value that configures or reports type preset for this contract. */
+typePreset?: string;
+/** Value that configures or reports force for this contract. */
+force?: boolean;
+/** Value that configures or reports workspace for this contract. */
+workspace?: string;
 }
 /** Concise projection of an InitResult for the default (toon) renderer. It keeps every piece of information that only init can surface — the resolved path, id prefix, governance preset, telemetry capture level, created-directory count, the full warnings list (including `already_exists:` markers), agent-guidance summary, and next steps — but replaces the verbose full settings tree (~190 lines) with a compact `settings` summary. Use --verbose for the full tree. */
 export interface InitConciseResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports target for this contract. */
-    target: InitTargetResolution;
-    /** Value that configures or reports id prefix for this contract. */
-    id_prefix: string;
-    /** Value that configures or reports governance preset for this contract. */
-    governance_preset: GovernancePreset;
-    /** Value that configures or reports telemetry for this contract. */
-    telemetry: {
-        enabled: boolean;
-        capture_level: string;
-    };
-    /** Value that configures or reports output format for this contract. */
-    output_format: string;
-    /** Number of created dirs entries represented by this result. */
-    created_dirs_count: number;
-    /** Value that configures or reports created dirs for this contract. */
-    created_dirs: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports wizard used for this contract. */
-    wizard_used: boolean;
-    /** Value that configures or reports registered type preset for this contract. */
-    registered_type_preset?: InitRegisteredTypePresetSummary;
-    /** Value that configures or reports installed packages for this contract. */
-    installed_packages?: InitInstalledPackagesSummary;
-    /** Value that configures or reports next steps for this contract. */
-    next_steps: string[];
-    /** Value that configures or reports agent guidance for this contract. */
-    agent_guidance: InitAgentGuidanceResult;
-    /** Value that configures or reports hint for this contract. */
-    hint: string;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports target for this contract. */
+target: InitTargetResolution;
+/** Value that configures or reports id prefix for this contract. */
+id_prefix: string;
+/** Value that configures or reports governance preset for this contract. */
+governance_preset: GovernancePreset;
+/** Value that configures or reports telemetry for this contract. */
+telemetry: {
+enabled: boolean;
+capture_level: string;
+};
+/** Value that configures or reports output format for this contract. */
+output_format: string;
+/** Number of created dirs entries represented by this result. */
+created_dirs_count: number;
+/** Value that configures or reports created dirs for this contract. */
+created_dirs: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports wizard used for this contract. */
+wizard_used: boolean;
+/** Value that configures or reports registered type preset for this contract. */
+registered_type_preset?: InitRegisteredTypePresetSummary;
+/** Value that configures or reports installed packages for this contract. */
+installed_packages?: InitInstalledPackagesSummary;
+/** Value that configures or reports next steps for this contract. */
+next_steps: string[];
+/** Value that configures or reports agent guidance for this contract. */
+agent_guidance: InitAgentGuidanceResult;
+/** Value that configures or reports hint for this contract. */
+hint: string;
 }
 /** Minimal first-run display with actionable warnings and a full-result recovery hint. */
 export interface InitDisplayResult {
-    /** Whether initialization succeeded. */
-    ok: boolean;
-    /** Resolved tracker root, including explicitly selected or ancestor trackers. */
-    path: string;
-    /** Governance policy selected for this workspace. */
-    governance_preset: GovernancePreset;
-    /** Project telemetry consent and capture level. */
-    telemetry: string;
-    /** Number of created directories and schema files. */
-    created_count: number;
-    /** Concrete first commands, scoped to the selected tracker. */
-    next_steps: string[];
-    /** Non-routine warnings that require attention. */
-    warnings?: string;
-    /** How to retrieve the complete settings, setup details, and routine notices. */
-    details: string;
+/** Whether initialization succeeded. */
+ok: boolean;
+/** Resolved tracker root, including explicitly selected or ancestor trackers. */
+path: string;
+/** Governance policy selected for this workspace. */
+governance_preset: GovernancePreset;
+/** Project telemetry consent and capture level. */
+telemetry: string;
+/** Number of created directories and schema files. */
+created_count: number;
+/** Concrete first commands, scoped to the selected tracker. */
+next_steps: string[];
+/** Non-routine warnings that require attention. */
+warnings?: string;
+/** How to retrieve the complete settings, setup details, and routine notices. */
+details: string;
 }
 /** Select a compact display without changing the full initialization result. */
 export declare function summarizeInitResult(result: InitResult, display: true): InitDisplayResult;
@@ -164,23 +164,23 @@ export declare function summarizeInitResult(result: InitResult, display: true):
 export declare function summarizeInitResult(result: InitResult): InitConciseResult;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    normalizeInitGovernancePreset: typeof normalizeInitGovernancePreset;
-    normalizeInitTypePreset: typeof normalizeInitTypePreset;
-    normalizeOptionalInitAuthor: typeof normalizeOptionalInitAuthor;
-    normalizeInitAgentGuidanceMode: typeof normalizeInitAgentGuidanceMode;
-    isPathLikeInitTarget: typeof isPathLikeInitTarget;
-    resolveInitInvocation: typeof resolveInitInvocation;
-    resolveInitPrefixInput: typeof resolveInitPrefixInput;
-    parseYesNoChoice: typeof parseYesNoChoice;
-    applyGovernancePreset: typeof applyGovernancePreset;
-    runInitWizard: typeof runInitWizard;
-    setInitReadlineFactoryForTests: typeof setInitReadlineFactoryForTests;
-    summarizeInstalledPackages: typeof summarizeInstalledPackages;
-    buildInitNextSteps: typeof buildInitNextSteps;
-    registerInitTypePreset: typeof registerInitTypePreset;
-    assertExplicitTrackerPathIsNotWorkspaceRoot: typeof assertExplicitTrackerPathIsNotWorkspaceRoot;
-    isLikelyWorkspaceRoot: typeof isLikelyWorkspaceRoot;
-    installInitMergeFence: typeof installInitMergeFence;
+normalizeInitGovernancePreset: typeof normalizeInitGovernancePreset;
+normalizeInitTypePreset: typeof normalizeInitTypePreset;
+normalizeOptionalInitAuthor: typeof normalizeOptionalInitAuthor;
+normalizeInitAgentGuidanceMode: typeof normalizeInitAgentGuidanceMode;
+isPathLikeInitTarget: typeof isPathLikeInitTarget;
+resolveInitInvocation: typeof resolveInitInvocation;
+resolveInitPrefixInput: typeof resolveInitPrefixInput;
+parseYesNoChoice: typeof parseYesNoChoice;
+applyGovernancePreset: typeof applyGovernancePreset;
+runInitWizard: typeof runInitWizard;
+setInitReadlineFactoryForTests: typeof setInitReadlineFactoryForTests;
+summarizeInstalledPackages: typeof summarizeInstalledPackages;
+buildInitNextSteps: typeof buildInitNextSteps;
+registerInitTypePreset: typeof registerInitTypePreset;
+assertExplicitTrackerPathIsNotWorkspaceRoot: typeof assertExplicitTrackerPathIsNotWorkspaceRoot;
+isLikelyWorkspaceRoot: typeof isLikelyWorkspaceRoot;
+installInitMergeFence: typeof installInitMergeFence;
 };
 type InitReadlineInterface = ReturnType<typeof readline.createInterface>;
 declare function setInitReadlineFactoryForTests(factory: (() => InitReadlineInterface) | undefined): void;
@@ -190,9 +190,9 @@ declare function normalizeInitTypePreset(rawValue: string | undefined): InitType
 declare function normalizeOptionalInitAuthor(rawValue: string | undefined): string | undefined;
 declare function isPathLikeInitTarget(rawValue: string | undefined): boolean;
 declare function resolveInitInvocation(cwd: string, global: GlobalOptions, prefixArg: string | undefined, workspaceArg?: string): {
-    pmRoot: string;
-    prefixArg: string | undefined;
-    target: InitTargetResolution;
+pmRoot: string;
+prefixArg: string | undefined;
+target: InitTargetResolution;
 };
 /** Resolves the optional positional and flag-oriented id-prefix inputs, accepting equivalent normalized spellings and rejecting ambiguous conflicts. */
 declare function resolveInitPrefixInput(positionalPrefix: string | undefined, flaggedPrefix: string | undefined): string | undefined;
@@ -204,15 +204,15 @@ declare function registerInitTypePreset(pmRoot: string, settings: PmSettings, pr
 declare function isLikelyWorkspaceRoot(candidate: string): Promise<boolean>;
 declare function assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot: string, explicitTrackerTarget: boolean, force: boolean): Promise<void>;
 declare function runInitWizard(initialPrefix: string, telemetryDefault: boolean): Promise<{
-    prefix: string;
-    preset: BuiltinGovernancePreset;
-    telemetry_enabled: boolean;
+prefix: string;
+preset: BuiltinGovernancePreset;
+telemetry_enabled: boolean;
 }>;
 declare function buildInitNextSteps(params: {
-    installBundledPackages: boolean;
-    registeredTypePreset: InitRegisteredTypePresetSummary | undefined;
-    agentGuidanceNextSteps: string[];
-    target: InitTargetResolution;
+installBundledPackages: boolean;
+registeredTypePreset: InitRegisteredTypePresetSummary | undefined;
+agentGuidanceNextSteps: string[];
+target: InitTargetResolution;
 }): string[];
 /**
  * Install the fresh-trackers merge fence without making an otherwise

package/dist/sdk/item-children.d.ts

@@ -6,37 +6,37 @@ export declare const MAX_CHILD_PROJECTION_ITEMS = 1000000;
 export declare const DEFAULT_CHILD_SAMPLE_LIMIT = 20;
 /** Stable compact child row embedded in a parent read. */
 export interface ChildRollupSample {
-    /** Stable child identifier. */
-    id: string;
-    /** Human-readable child title. */
-    title: string;
-    /** Schema type of the child item. */
-    type: string;
-    /** Current lifecycle status of the child item. */
-    status: string;
-    /** Current priority of the child item. */
-    priority: number;
+/** Stable child identifier. */
+id: string;
+/** Human-readable child title. */
+title: string;
+/** Schema type of the child item. */
+type: string;
+/** Current lifecycle status of the child item. */
+status: string;
+/** Current priority of the child item. */
+priority: number;
 }
 /** Bounded direct-child summary shared across SDK and presentation surfaces. */
 export interface ChildRollupContext {
-    /** Total direct children discovered. */
-    count: number;
-    /** Direct children whose statuses are non-terminal. */
-    active: number;
-    /** Counts grouped by normalized lifecycle status. */
-    by_status: Record<string, number>;
-    /** Deterministic id-sorted inline sample. */
-    sample: ChildRollupSample[];
-    /** Configured maximum sample size. */
-    sample_limit: number;
-    /** Whether additional children exist beyond the inline sample. */
-    truncated: boolean;
-    /** Offset for the next page, or null when the sample is complete. */
-    next_offset: number | null;
-    /** Token-efficient CLI continuation command, or null when complete. */
-    continuation: string | null;
-    /** Number of corpus rows inspected to produce this projection. */
-    scanned: number;
+/** Total direct children discovered. */
+count: number;
+/** Direct children whose statuses are non-terminal. */
+active: number;
+/** Counts grouped by normalized lifecycle status. */
+by_status: Record<string, number>;
+/** Deterministic id-sorted inline sample. */
+sample: ChildRollupSample[];
+/** Configured maximum sample size. */
+sample_limit: number;
+/** Whether additional children exist beyond the inline sample. */
+truncated: boolean;
+/** Offset for the next page, or null when the sample is complete. */
+next_offset: number | null;
+/** Token-efficient CLI continuation command, or null when complete. */
+continuation: string | null;
+/** Number of corpus rows inspected to produce this projection. */
+scanned: number;
 }
 /**
  * Build a type-agnostic child rollup from indexed or source metadata. Input is

package/dist/sdk/item-schedule.d.ts

@@ -7,18 +7,18 @@
 import type { CalendarEvent, ItemMetadata, Reminder } from "../types/index.js";
 /** Schedule projection attached to standard and deep item reads. */
 export interface ItemScheduleContext {
-    /** Item deadline when present. */
-    deadline: string | null;
-    /** Earliest event start, convenient for single-event consumers. */
-    start_at: string | null;
-    /** End of the earliest event when present. */
-    end_at: string | null;
-    /** Location of the earliest event when present. */
-    location: string | null;
-    /** All configured reminders. */
-    reminders: Reminder[];
-    /** All configured events ordered by start timestamp. */
-    events: CalendarEvent[];
+/** Item deadline when present. */
+deadline: string | null;
+/** Earliest event start, convenient for single-event consumers. */
+start_at: string | null;
+/** End of the earliest event when present. */
+end_at: string | null;
+/** Location of the earliest event when present. */
+location: string | null;
+/** All configured reminders. */
+reminders: Reminder[];
+/** All configured events ordered by start timestamp. */
+events: CalendarEvent[];
 }
 /** Return whether an item carries or semantically represents schedule data. */
 export declare function itemHasSchedule(item: ItemMetadata): boolean;