@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/core/store/item-metadata-query-index.d.ts

@@ -4,80 +4,80 @@ import { loadDatabaseSync, loadStableDatabaseSync } from "./sqlite-runtime.js";
 type DatabaseSyncConstructor = typeof DatabaseSync;
 /** One light-metadata row projected into the persistent query index. */
 export interface ItemMetadataQueryIndexRow {
-    /** Tracker-relative authoritative item path. */
-    relativePath: string;
-    /** Light item metadata serialized into the row store. */
-    metadata: ItemMetadata;
-    /** Heavy linked-file records projected separately for reverse traceability. */
-    linkedFiles?: readonly LinkedFile[];
+/** Tracker-relative authoritative item path. */
+relativePath: string;
+/** Light item metadata serialized into the row store. */
+metadata: ItemMetadata;
+/** Heavy linked-file records projected separately for reverse traceability. */
+linkedFiles?: readonly LinkedFile[];
 }
 /** Selection supported directly by the persistent metadata query index. */
 export interface ItemMetadataIndexQuery {
-    /** Include only these lifecycle statuses. */
-    statuses?: readonly string[];
-    /** Exclude these lifecycle statuses. */
-    excludeStatuses?: readonly string[];
-    /** Statuses sorted after active rows by the default list ordering contract. */
-    terminalStatuses?: readonly string[];
-    /** Include only these item types. */
-    types?: readonly string[];
-    /** Include only these exact item identifiers. */
-    ids?: readonly string[];
-    /** Include only rows that define every requested metadata key. */
-    metadataKeys?: readonly string[];
-    /** Include only direct children of this item. */
-    parent?: string;
-    /** Include only this assignee value. */
-    assignee?: string;
-    /** Include only this sprint value. */
-    sprint?: string;
-    /** Include only this release value. */
-    release?: string;
-    /** Include only this numeric priority. */
-    priority?: number;
-    /** Maximum rows returned after deterministic default ordering. */
-    limit?: number;
-    /** Number of ordered rows skipped before returning results. */
-    offset?: number;
+/** Include only these lifecycle statuses. */
+statuses?: readonly string[];
+/** Exclude these lifecycle statuses. */
+excludeStatuses?: readonly string[];
+/** Statuses sorted after active rows by the default list ordering contract. */
+terminalStatuses?: readonly string[];
+/** Include only these item types. */
+types?: readonly string[];
+/** Include only these exact item identifiers. */
+ids?: readonly string[];
+/** Include only rows that define every requested metadata key. */
+metadataKeys?: readonly string[];
+/** Include only direct children of this item. */
+parent?: string;
+/** Include only this assignee value. */
+assignee?: string;
+/** Include only this sprint value. */
+sprint?: string;
+/** Include only this release value. */
+release?: string;
+/** Include only this numeric priority. */
+priority?: number;
+/** Maximum rows returned after deterministic default ordering. */
+limit?: number;
+/** Number of ordered rows skipped before returning results. */
+offset?: number;
 }
 /** Bounded query result carrying total match count and index provenance. */
 export interface ItemMetadataIndexQueryResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** Total matching rows before offset and limit. */
-    total: number;
-    /** Ordered light metadata rows in the requested window. */
-    items: ItemMetadata[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** Total matching rows before offset and limit. */
+total: number;
+/** Ordered light metadata rows in the requested window. */
+items: ItemMetadata[];
 }
 /** Bounded lexical candidate result from the persistent metadata projection. */
 export interface SimilarItemMetadataIndexResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** FTS-ranked light metadata candidates. */
-    items: ItemMetadata[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** FTS-ranked light metadata candidates. */
+items: ItemMetadata[];
 }
 /** One indexed item and the requested linked-file records that reference it. */
 export interface IndexedLinkedFileMatch {
-    /** Light metadata for the referencing item. */
-    item: ItemMetadata;
-    /** Exact linked-file records matching the requested paths and optional scope. */
-    files: LinkedFile[];
+/** Light metadata for the referencing item. */
+item: ItemMetadata;
+/** Exact linked-file records matching the requested paths and optional scope. */
+files: LinkedFile[];
 }
 /** Bounded reverse linked-file query result from the persistent projection. */
 export interface LinkedFileMetadataIndexResult {
-    /** Effective index source cursor. */
-    source_cursor: string;
-    /** Total matching items before offset and limit. */
-    total: number;
-    /** Deterministically ordered referencing items in the requested window. */
-    matches: IndexedLinkedFileMatch[];
+/** Effective index source cursor. */
+source_cursor: string;
+/** Total matching items before offset and limit. */
+total: number;
+/** Deterministically ordered referencing items in the requested window. */
+matches: IndexedLinkedFileMatch[];
 }
 /** Atomically rebuild the complete query projection from authoritative cache rows. */
 export declare function rebuildItemMetadataQueryIndex(options: {
-    pmRoot: string;
-    contextFingerprint: string;
-    sourceCursor: string;
-    rows: readonly ItemMetadataQueryIndexRow[];
+pmRoot: string;
+contextFingerprint: string;
+sourceCursor: string;
+rows: readonly ItemMetadataQueryIndexRow[];
 }): Promise<void>;
 /**
  * Apply one authoritative metadata mutation in the same writer critical
@@ -85,12 +85,12 @@ export declare function rebuildItemMetadataQueryIndex(options: {
  * callers can remove and lazily rebuild this optional projection.
  */
 export declare function updateItemMetadataQueryIndex(options: {
-    pmRoot: string;
-    contextFingerprint: string;
-    expectedSourceCursor: string;
-    sourceCursor: string;
-    row: ItemMetadataQueryIndexRow | null;
-    deletedRelativePaths?: readonly string[];
+pmRoot: string;
+contextFingerprint: string;
+expectedSourceCursor: string;
+sourceCursor: string;
+row: ItemMetadataQueryIndexRow | null;
+deletedRelativePaths?: readonly string[];
 }): Promise<boolean>;
 /**
  * Query the persistent projection without materializing the full metadata
@@ -98,9 +98,9 @@ export declare function updateItemMetadataQueryIndex(options: {
  * extension read hooks require canonical per-document dispatch.
  */
 export declare function queryItemMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    query?: ItemMetadataIndexQuery;
+pmRoot: string;
+expectedSourceCursor: string;
+query?: ItemMetadataIndexQuery;
 }): Promise<ItemMetadataIndexQueryResult | null>;
 /**
  * Resolve items that link any requested project-relative path without loading
@@ -108,30 +108,30 @@ export declare function queryItemMetadataIndex(options: {
  * stale, or corrupt so callers can fall back to authoritative item reads.
  */
 export declare function queryLinkedFileMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    paths: readonly string[];
-    scope?: LinkScope;
-    limit?: number;
-    offset?: number;
+pmRoot: string;
+expectedSourceCursor: string;
+paths: readonly string[];
+scope?: LinkScope;
+limit?: number;
+offset?: number;
 }): Promise<LinkedFileMetadataIndexResult | null>;
 /**
  * Query FTS-ranked item candidates without materializing the workspace. The
  * caller owns final similarity scoring and threshold semantics.
  */
 export declare function querySimilarItemMetadataIndex(options: {
-    pmRoot: string;
-    expectedSourceCursor: string;
-    query: string;
-    limit: number;
+pmRoot: string;
+expectedSourceCursor: string;
+query: string;
+limit: number;
 }): Promise<SimilarItemMetadataIndexResult | null>;
 /** Remove only the optional SQLite query projection. */
 export declare function removeItemMetadataQueryIndex(pmRoot: string): Promise<void>;
 /** Test-only dependency seam for runtimes that do not implement node:sqlite. */
 export declare const _testOnly: {
-    loadDatabaseSync: typeof loadDatabaseSync;
-    loadStableDatabaseSync: typeof loadStableDatabaseSync;
-    /** Replace the optional constructor and return a restoration callback. */
-    setDatabaseSync(databaseSync: DatabaseSyncConstructor | null): () => void;
+loadDatabaseSync: typeof loadDatabaseSync;
+loadStableDatabaseSync: typeof loadStableDatabaseSync;
+/** Replace the optional constructor and return a restoration callback. */
+setDatabaseSync(databaseSync: DatabaseSyncConstructor | null): () => void;
 };
 export {};

package/dist/core/store/item-metadata-read-work.d.ts

@@ -1,9 +1,9 @@
 /** Logical metadata work, independent of output projection and cache hit rate. */
 export interface ItemMetadataReadWork {
-    /** Completed full, light, or body-bearing item-store enumeration calls. */
-    enumeration_calls: number;
-    /** Metadata rows returned by those calls, counting repeated enumeration. */
-    metadata_rows: number;
+/** Completed full, light, or body-bearing item-store enumeration calls. */
+enumeration_calls: number;
+/** Metadata rows returned by those calls, counting repeated enumeration. */
+metadata_rows: number;
 }
 /** Record completed enumeration in each enclosing measurement, without retaining item data. */
 export declare function recordItemMetadataEnumeration(rowCount: number): void;
@@ -14,6 +14,6 @@ export declare function recordItemMetadataEnumeration(rowCount: number): void;
  * Counters cover filesystem item-store enumeration APIs, not arbitrary host I/O.
  */
 export declare function measureItemMetadataReadWork<T>(operation: () => T | Promise<T>): Promise<{
-    result: T;
-    work: Readonly<ItemMetadataReadWork>;
+result: T;
+work: Readonly<ItemMetadataReadWork>;
 }>;

package/dist/core/store/item-store.d.ts

@@ -3,14 +3,14 @@ import { PmCliError } from "../shared/errors.js";
 import type { ItemDocument, ItemFormat, ItemMetadata, ItemType, PmSettings, RuntimeSchemaSettings } from "../../types/index.js";
 /** Documents the located item payload exchanged by command, SDK, and package integrations. */
 export interface LocatedItem {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type: ItemType;
-    /** Filesystem path used for item resolution. */
-    itemPath: string;
-    /** Value that configures or reports item format for this contract. */
-    item_format: ItemFormat;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type: ItemType;
+/** Filesystem path used for item resolution. */
+itemPath: string;
+/** Value that configures or reports item format for this contract. */
+item_format: ItemFormat;
 }
 declare function isErrno(error: unknown, code: string): boolean;
 declare function appendWarning(warnings: string[] | undefined, warning: string): void;
@@ -22,12 +22,12 @@ declare function appendWarning(warnings: string[] | undefined, warning: string):
 export declare function locateItem(pmRoot: string, rawId: string, idPrefix?: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>): Promise<LocatedItem | null>;
 /** Implements read located item for the public runtime surface of this module. */
 export declare function readLocatedItem(item: LocatedItem, options?: {
-    schema?: RuntimeSchemaSettings;
-    extensionFieldNames?: readonly string[];
-    warnings?: string[];
+schema?: RuntimeSchemaSettings;
+extensionFieldNames?: readonly string[];
+warnings?: string[];
 }): Promise<{
-    raw: string;
-    document: ItemDocument;
+raw: string;
+document: ItemDocument;
 }>;
 /**
  * Read once and retain a recoverable parse failure beside its exact text snapshot.
@@ -35,13 +35,13 @@ export declare function readLocatedItem(item: LocatedItem, options?: {
  * reconstruct an invalid document before performing any mutation.
  */
 export declare function readLocatedItemSnapshot(item: LocatedItem, options?: Parameters<typeof readLocatedItem>[1]): Promise<{
-    raw: string;
-    document: ItemDocument;
-    error: null;
+raw: string;
+document: ItemDocument;
+error: null;
 } | {
-    raw: string;
-    document: null;
-    error: PmCliError;
+raw: string;
+document: null;
+error: PmCliError;
 }>;
 /** Implements list all item metadata for the public runtime surface of this module. */
 export declare function listAllItemMetadata(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings): Promise<ItemMetadata[]>;
@@ -54,126 +54,126 @@ export declare function listAllItemMetadata(pmRoot: string, preferredFormat?: It
 export declare function listAllItemMetadataLight(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings): Promise<ItemMetadata[]>;
 /** List item metadata with bodies, optionally bypassing the derived-index fast path when an integrity workflow must re-read authoritative files. */
 export declare function listAllItemMetadataWithBody(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings, options?: {
-    forceSourceScan?: boolean;
+forceSourceScan?: boolean;
 }): Promise<Array<ItemMetadata & {
-    body: string;
+body: string;
 }>>;
 /** Build the minimal host-bound read-only SDK exposed to transactional extension guards. */
 export declare function createMutationGuardSdk(params: {
-    pmRoot: string;
-    settings: PmSettings;
-    typeToFolder: Record<string, string>;
+pmRoot: string;
+settings: PmSettings;
+typeToFolder: Record<string, string>;
 }): ExtensionMutationGuardSdk;
 declare function buildDidYouMeanSuggestions(pmRoot: string, badId: string, idPrefix: string, typeToFolder: Record<string, string>): Promise<string[]>;
 /** Implements build item not found error for the public runtime surface of this module. */
 export declare function buildItemNotFoundError(pmRoot: string, badId: string, idPrefix: string, typeToFolder: Record<string, string>): Promise<PmCliError>;
 declare function bypassesAssigneeConflict(op: string, bypassAssigneeConflict?: boolean): boolean;
 interface ItemMutationResult {
-    item: ItemMetadata;
-    body: string;
-    changedFields: string[];
-    warnings: string[];
+item: ItemMetadata;
+body: string;
+changedFields: string[];
+warnings: string[];
 }
 interface ItemMutationParams {
-    pmRoot: string;
-    settings: PmSettings;
-    id: string;
-    op: string;
-    author: string;
-    message?: string;
-    /** Structured immutable context attached to the appended history entry. */
-    historyContext?: Record<string, unknown>;
-    force?: boolean;
-    bypassAssigneeConflict?: boolean;
-    skipNoop?: boolean;
-    extensionFieldNames?: readonly string[];
-    typeToFolder?: Record<string, string>;
-    mutate: (document: ItemDocument) => {
-        changedFields: string[];
-        warnings?: string[];
-    } | Promise<{
-        changedFields: string[];
-        warnings?: string[];
-    }>;
+pmRoot: string;
+settings: PmSettings;
+id: string;
+op: string;
+author: string;
+message?: string;
+/** Structured immutable context attached to the appended history entry. */
+historyContext?: Record<string, unknown>;
+force?: boolean;
+bypassAssigneeConflict?: boolean;
+skipNoop?: boolean;
+extensionFieldNames?: readonly string[];
+typeToFolder?: Record<string, string>;
+mutate: (document: ItemDocument) => {
+changedFields: string[];
+warnings?: string[];
+} | Promise<{
+changedFields: string[];
+warnings?: string[];
+}>;
 }
 /** Mutate one item while attaching structured context to its immutable history event. */
 export declare function mutateItemWithHistoryContext(params: {
-    pmRoot: string;
-    settings: PmSettings;
-    id: string;
-    op: string;
-    author: string;
-    message?: string;
-    /** Structured immutable context attached to the appended history entry. */
-    historyContext?: Record<string, unknown>;
-    force?: boolean;
-    bypassAssigneeConflict?: boolean;
-    skipNoop?: boolean;
-    extensionFieldNames?: readonly string[];
-    typeToFolder?: Record<string, string>;
-    mutate: (document: ItemDocument) => {
-        changedFields: string[];
-        warnings?: string[];
-    } | Promise<{
-        changedFields: string[];
-        warnings?: string[];
-    }>;
+pmRoot: string;
+settings: PmSettings;
+id: string;
+op: string;
+author: string;
+message?: string;
+/** Structured immutable context attached to the appended history entry. */
+historyContext?: Record<string, unknown>;
+force?: boolean;
+bypassAssigneeConflict?: boolean;
+skipNoop?: boolean;
+extensionFieldNames?: readonly string[];
+typeToFolder?: Record<string, string>;
+mutate: (document: ItemDocument) => {
+changedFields: string[];
+warnings?: string[];
+} | Promise<{
+changedFields: string[];
+warnings?: string[];
+}>;
 }): Promise<{
-    item: ItemMetadata;
-    body: string;
-    changedFields: string[];
-    warnings: string[];
+item: ItemMetadata;
+body: string;
+changedFields: string[];
+warnings: string[];
 }>;
 /** Mutate one item while resolving structured history context after its locked mutation. */
 export declare function mutateItemWithHistoryContextResolver(params: Omit<ItemMutationParams, "historyContext"> & {
-    resolveHistoryContext: () => Record<string, unknown> | undefined;
+resolveHistoryContext: () => Record<string, unknown> | undefined;
 }): Promise<ItemMutationResult>;
 /** Implements mutate item for the public runtime surface of this module. */
 export declare function mutateItem(params: {
-    pmRoot: string;
-    settings: PmSettings;
-    id: string;
-    op: string;
-    author: string;
-    message?: string;
-    force?: boolean;
-    bypassAssigneeConflict?: boolean;
-    skipNoop?: boolean;
-    extensionFieldNames?: readonly string[];
-    typeToFolder?: Record<string, string>;
-    mutate: (document: ItemDocument) => {
-        changedFields: string[];
-        warnings?: string[];
-    } | Promise<{
-        changedFields: string[];
-        warnings?: string[];
-    }>;
+pmRoot: string;
+settings: PmSettings;
+id: string;
+op: string;
+author: string;
+message?: string;
+force?: boolean;
+bypassAssigneeConflict?: boolean;
+skipNoop?: boolean;
+extensionFieldNames?: readonly string[];
+typeToFolder?: Record<string, string>;
+mutate: (document: ItemDocument) => {
+changedFields: string[];
+warnings?: string[];
+} | Promise<{
+changedFields: string[];
+warnings?: string[];
+}>;
 }): Promise<{
-    item: ItemMetadata;
-    body: string;
-    changedFields: string[];
-    warnings: string[];
+item: ItemMetadata;
+body: string;
+changedFields: string[];
+warnings: string[];
 }>;
 /** Public contract for item store test only, shared by SDK and presentation-layer consumers. */
 export declare const itemStoreTestOnly: {
-    appendWarning: typeof appendWarning;
-    bypassesAssigneeConflict: typeof bypassesAssigneeConflict;
-    buildDidYouMeanSuggestions: typeof buildDidYouMeanSuggestions;
-    isErrno: typeof isErrno;
+appendWarning: typeof appendWarning;
+bypassesAssigneeConflict: typeof bypassesAssigneeConflict;
+buildDidYouMeanSuggestions: typeof buildDidYouMeanSuggestions;
+isErrno: typeof isErrno;
 };
 /** Implements delete item for the public runtime surface of this module. */
 export declare function deleteItem(params: {
-    pmRoot: string;
-    settings: PmSettings;
-    id: string;
-    author: string;
-    message?: string;
-    force?: boolean;
-    dryRun?: boolean;
+pmRoot: string;
+settings: PmSettings;
+id: string;
+author: string;
+message?: string;
+force?: boolean;
+dryRun?: boolean;
 }): Promise<{
-    item: ItemMetadata;
-    changedFields: string[];
-    warnings: string[];
-    targetPath?: string;
+item: ItemMetadata;
+changedFields: string[];
+warnings: string[];
+targetPath?: string;
 }>;
 export {};

package/dist/core/store/paths.d.ts

@@ -2,8 +2,8 @@ import type { ItemFormat, ItemType } from "../../types/index.js";
 /** Public contract for item file extension by format, shared by SDK and presentation-layer consumers. */
 export declare const ITEM_FILE_EXTENSION_BY_FORMAT: Record<ItemFormat, ".md" | ".toon">;
 declare const ITEM_FORMAT_BY_EXTENSION: {
-    readonly ".md": "json_markdown";
-    readonly ".toon": "toon";
+readonly ".md": "json_markdown";
+readonly ".toon": "toon";
 };
 /** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */
 export declare const ITEM_FILE_EXTENSIONS: Array<keyof typeof ITEM_FORMAT_BY_EXTENSION>;

package/dist/core/store/settings-read-cache.d.ts

@@ -1,20 +1,20 @@
 /** Documents the settings read cache path signature payload exchanged by command, SDK, and package integrations. */
 export interface SettingsReadCachePathSignature {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Elapsed time in milliseconds for mtime. */
-    mtime_ms: number | null;
-    /** Value that configures or reports size for this contract. */
-    size: number | null;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Elapsed time in milliseconds for mtime. */
+mtime_ms: number | null;
+/** Value that configures or reports size for this contract. */
+size: number | null;
 }
 /** Documents the settings read cache entry payload exchanged by command, SDK, and package integrations. */
 export interface SettingsReadCacheEntry<T> {
-    /** Value that configures or reports tracked paths for this contract. */
-    tracked_paths: string[];
-    /** Value that configures or reports signatures for this contract. */
-    signatures: SettingsReadCachePathSignature[];
-    /** Value that configures or reports value for this contract. */
-    value: T;
+/** Value that configures or reports tracked paths for this contract. */
+tracked_paths: string[];
+/** Value that configures or reports signatures for this contract. */
+signatures: SettingsReadCachePathSignature[];
+/** Value that configures or reports value for this contract. */
+value: T;
 }
 /** Implements collect settings read cache signatures for the public runtime surface of this module. */
 export declare function collectSettingsReadCacheSignatures(paths: string[]): Promise<SettingsReadCachePathSignature[]>;