@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/pagination.d.ts

@@ -1,34 +1,34 @@
 import type { CliFlagContract } from "./cli-contracts/flag-contracts.js";
 /** Validated transport envelope carried by an opaque query cursor. */
 export interface QueryCursorEnvelope {
-    /** Serialized cursor contract version. */
-    version: number;
-    /** Stable fingerprint of the query semantics that produced the cursor. */
-    fingerprint: string;
-    /** Stable id of the last row emitted by the producer. */
-    after_id: string;
-    /** Zero-based position of the last emitted row when available. */
-    after_index?: number;
-    /** Opaque producer-defined snapshot token for stable continuation. */
-    snapshot?: string;
+/** Serialized cursor contract version. */
+version: number;
+/** Stable fingerprint of the query semantics that produced the cursor. */
+fingerprint: string;
+/** Stable id of the last row emitted by the producer. */
+after_id: string;
+/** Zero-based position of the last emitted row when available. */
+after_index?: number;
+/** Opaque producer-defined snapshot token for stable continuation. */
+snapshot?: string;
 }
 /** Decoded cursor state for advanced package and retrieval-window integrations. */
 export interface QueryCursorState {
-    /** Stable id of the last row emitted by the previous page. */
-    after_id: string;
-    /** Zero-based position of that row when the producer supplied one. */
-    after_index?: number;
-    /** Opaque producer-defined snapshot token for stable continuation. */
-    snapshot?: string;
+/** Stable id of the last row emitted by the previous page. */
+after_id: string;
+/** Zero-based position of that row when the producer supplied one. */
+after_index?: number;
+/** Opaque producer-defined snapshot token for stable continuation. */
+snapshot?: string;
 }
 /** Describes one stable cursor page over an already ordered query result. */
 export interface QueryCursorPage<T> {
-    /** Rows contained in the requested page. */
-    rows: T[];
-    /** Whether another page exists after these rows. */
-    has_more: boolean;
-    /** Opaque cursor for the next page when one exists. */
-    next_cursor?: string;
+/** Rows contained in the requested page. */
+rows: T[];
+/** Whether another page exists after these rows. */
+has_more: boolean;
+/** Opaque cursor for the next page when one exists. */
+next_cursor?: string;
 }
 /**
  * Select the query-semantic portion of an options object from published flag
@@ -50,14 +50,14 @@ export declare function decodeQueryCursor(cursor: unknown, expectedFingerprint:
 export declare function resolveQueryCursorStart<T>(rows: readonly T[], cursor: string | undefined, fingerprint: string, readId: (row: T) => string): number;
 /** Page an ordered result through the shared stable cursor contract. */
 export declare function paginateQueryRows<T>(rows: readonly T[], options: {
-    cursor?: string;
-    fingerprint: string;
-    limit: number;
-    readId: (row: T) => string;
-    snapshot?: string;
+cursor?: string;
+fingerprint: string;
+limit: number;
+readId: (row: T) => string;
+snapshot?: string;
 }): QueryCursorPage<T>;
 /** Public pagination constants exposed for package authors and contract tests. */
 export declare const QUERY_CURSOR_CONTRACT: Readonly<{
-    version: 1;
-    max_length: 4096;
+version: 1;
+max_length: 4096;
 }>;

package/dist/sdk/profile.d.ts

@@ -14,138 +14,138 @@ export type ProfileSubcommand = (typeof PROFILE_SUBCOMMANDS)[number];
 export type ProfileComposition = ProjectProfileComposition;
 /** A single profile entry in the `pm profile list` payload. */
 export interface ProfileListEntry {
-    /** Profile name. */
-    name: string;
-    /** Display title. */
-    title: string;
-    /** One-line archetype summary. */
-    summary: string;
-    /** Whether the profile is core-baked or contributed by an active extension. */
-    source: ProfileSourceKind;
-    /** Owning package/extension name for an extension profile; omitted for builtins. */
-    package?: string;
-    /** Per-dimension counts. */
-    composition: ProfileComposition;
+/** Profile name. */
+name: string;
+/** Display title. */
+title: string;
+/** One-line archetype summary. */
+summary: string;
+/** Whether the profile is core-baked or contributed by an active extension. */
+source: ProfileSourceKind;
+/** Owning package/extension name for an extension profile; omitted for builtins. */
+package?: string;
+/** Per-dimension counts. */
+composition: ProfileComposition;
 }
 /** Result of `pm profile list`. */
 export interface ProfileListResult {
-    /** Discriminant for the profile result union. */
-    action: "list";
-    /** Built-in profiles in canonical order followed by active extension profiles. */
-    profiles: ProfileListEntry[];
-    /** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
-    warnings: string[];
-    /** ISO timestamp the result was produced. */
-    generated_at: string;
+/** Discriminant for the profile result union. */
+action: "list";
+/** Built-in profiles in canonical order followed by active extension profiles. */
+profiles: ProfileListEntry[];
+/** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
+warnings: string[];
+/** ISO timestamp the result was produced. */
+generated_at: string;
 }
 /** Result of `pm profile show <name>`. */
 export interface ProfileShowResult {
-    /** Discriminant for the profile result union. */
-    action: "show";
-    /** Profile name. */
-    name: string;
-    /** Display title. */
-    title: string;
-    /** One-line archetype summary. */
-    summary: string;
-    /** Whether the profile is core-baked or contributed by an active extension. */
-    source: ProfileSourceKind;
-    /** Owning package/extension name for an extension profile; omitted for builtins. */
-    package?: string;
-    /** Per-dimension counts. */
-    composition: ProfileComposition;
-    /** Item type names the profile registers. */
-    types: string[];
-    /** Custom status ids. */
-    statuses: string[];
-    /** Custom field keys. */
-    fields: string[];
-    /** Item types governed by a staged workflow. */
-    workflows: string[];
-    /** Config knobs as `key=value` pairs. */
-    config: string[];
-    /** Template names the profile stages. */
-    templates: string[];
-    /** Recommended package specs with rationale. */
-    packages: Array<{
-        spec: string;
-        reason: string;
-    }>;
-    /** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
-    warnings: string[];
-    /** ISO timestamp the result was produced. */
-    generated_at: string;
+/** Discriminant for the profile result union. */
+action: "show";
+/** Profile name. */
+name: string;
+/** Display title. */
+title: string;
+/** One-line archetype summary. */
+summary: string;
+/** Whether the profile is core-baked or contributed by an active extension. */
+source: ProfileSourceKind;
+/** Owning package/extension name for an extension profile; omitted for builtins. */
+package?: string;
+/** Per-dimension counts. */
+composition: ProfileComposition;
+/** Item type names the profile registers. */
+types: string[];
+/** Custom status ids. */
+statuses: string[];
+/** Custom field keys. */
+fields: string[];
+/** Item types governed by a staged workflow. */
+workflows: string[];
+/** Config knobs as `key=value` pairs. */
+config: string[];
+/** Template names the profile stages. */
+templates: string[];
+/** Recommended package specs with rationale. */
+packages: Array<{
+spec: string;
+reason: string;
+}>;
+/** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
+warnings: string[];
+/** ISO timestamp the result was produced. */
+generated_at: string;
 }
 /** Per-dimension change summary in an apply result. */
 export interface ProfileApplyDimension {
-    /** Entry keys that were newly created. */
-    added: string[];
-    /** Entry keys whose stored value was overwritten. */
-    updated: string[];
-    /** Entry keys already current (no write). */
-    unchanged: string[];
+/** Entry keys that were newly created. */
+added: string[];
+/** Entry keys whose stored value was overwritten. */
+updated: string[];
+/** Entry keys already current (no write). */
+unchanged: string[];
 }
 /** Result of `pm profile apply <name>`. */
 export interface ProfileApplyResult {
-    /** Discriminant for the profile result union. */
-    action: "apply";
-    /** Applied profile name. */
-    name: string;
-    /** Display title. */
-    title: string;
-    /** True when changes were persisted; false for `--dry-run` or a no-op. */
-    applied: boolean;
-    /** True when `--dry-run` previewed without writing. */
-    dry_run: boolean;
-    /** True when at least one dimension stages an add/update. */
-    changed: boolean;
-    /** Item-type change summary. */
-    types: ProfileApplyDimension;
-    /** Status change summary. */
-    statuses: ProfileApplyDimension;
-    /** Field change summary. */
-    fields: ProfileApplyDimension;
-    /** Workflow change summary. */
-    workflows: ProfileApplyDimension;
-    /** Config-knob change summary. */
-    config: ProfileApplyDimension;
-    /** Template change summary. */
-    templates: ProfileApplyDimension;
-    /** Advisory package recommendations with install status. */
-    packages: Array<{
-        spec: string;
-        reason: string;
-        status: "installed" | "recommended";
-    }>;
-    /** Deduped on-write hook + advisory warnings. */
-    warnings: string[];
-    /** ISO timestamp the result was produced. */
-    generated_at: string;
+/** Discriminant for the profile result union. */
+action: "apply";
+/** Applied profile name. */
+name: string;
+/** Display title. */
+title: string;
+/** True when changes were persisted; false for `--dry-run` or a no-op. */
+applied: boolean;
+/** True when `--dry-run` previewed without writing. */
+dry_run: boolean;
+/** True when at least one dimension stages an add/update. */
+changed: boolean;
+/** Item-type change summary. */
+types: ProfileApplyDimension;
+/** Status change summary. */
+statuses: ProfileApplyDimension;
+/** Field change summary. */
+fields: ProfileApplyDimension;
+/** Workflow change summary. */
+workflows: ProfileApplyDimension;
+/** Config-knob change summary. */
+config: ProfileApplyDimension;
+/** Template change summary. */
+templates: ProfileApplyDimension;
+/** Advisory package recommendations with install status. */
+packages: Array<{
+spec: string;
+reason: string;
+status: "installed" | "recommended";
+}>;
+/** Deduped on-write hook + advisory warnings. */
+warnings: string[];
+/** ISO timestamp the result was produced. */
+generated_at: string;
 }
 /** Result of `pm profile lint [name]`. */
 export interface ProfileLintResult {
-    /** Discriminant for the profile result union. */
-    action: "lint";
-    /** Linted profile name. */
-    name: string;
-    /** Display title. */
-    title: string;
-    /** Whether the profile is core-baked or contributed by an active extension. */
-    source: ProfileSourceKind;
-    /** Owning package/extension name for an extension profile; omitted for builtins. */
-    package?: string;
-    /** True when the profile produced no error-severity findings. */
-    ok: boolean;
-    /** Count of error-severity findings. */
-    error_count: number;
-    /** Count of warning-severity findings. */
-    warning_count: number;
-    /** Every graded consistency finding in dimension order. */
-    findings: ProjectProfileLintFinding[];
-    /** Non-fatal catalog merge warnings (built-in shadowing attempts, duplicate names). */
-    warnings: string[];
-    /** ISO timestamp the result was produced. */
-    generated_at: string;
+/** Discriminant for the profile result union. */
+action: "lint";
+/** Linted profile name. */
+name: string;
+/** Display title. */
+title: string;
+/** Whether the profile is core-baked or contributed by an active extension. */
+source: ProfileSourceKind;
+/** Owning package/extension name for an extension profile; omitted for builtins. */
+package?: string;
+/** True when the profile produced no error-severity findings. */
+ok: boolean;
+/** Count of error-severity findings. */
+error_count: number;
+/** Count of warning-severity findings. */
+warning_count: number;
+/** Every graded consistency finding in dimension order. */
+findings: ProjectProfileLintFinding[];
+/** Non-fatal catalog merge warnings (built-in shadowing attempts, duplicate names). */
+warnings: string[];
+/** ISO timestamp the result was produced. */
+generated_at: string;
 }
 /** Discriminated union of every `pm profile` result shape. */
 export type ProfileResult = ProfileListResult | ProfileShowResult | ProfileApplyResult | ProfileLintResult;
@@ -157,12 +157,12 @@ export declare function runProfileShow(name: string | undefined): ProfileShowRes
 export declare function runProfileLint(name: string | undefined): ProfileLintResult;
 /** Options accepted by {@link runProfileApply}. */
 export interface ProfileApplyCommandOptions {
-    /** Preview the diff without writing any files. */
-    dryRun?: boolean;
-    /** Mutation author override. */
-    author?: string;
-    /** Force ownership/lock override. */
-    force?: boolean;
+/** Preview the diff without writing any files. */
+dryRun?: boolean;
+/** Mutation author override. */
+author?: string;
+/** Force ownership/lock override. */
+force?: boolean;
 }
 /** Applies a profile to the initialized tracker, or previews the idempotent diff when `dryRun` is set. Schema files are written under their respective locks; config and workflows are persisted to settings; templates are staged via the shared template writer. Re-applying an already-applied profile performs zero writes. Throws a USAGE error for an unknown profile or an invalid config knob, and a NOT_FOUND error when the tracker is not initialized. */
 export declare function runProfileApply(name: string | undefined, options: ProfileApplyCommandOptions, global: GlobalOptions): Promise<ProfileApplyResult>;

package/dist/sdk/provenance.d.ts

@@ -8,77 +8,77 @@ import { type HarnessSignalDescriptor } from "../core/shared/author.js";
 import type { AgentModelSource } from "../core/shared/author.js";
 /** One declared provenance dimension and the built-in harnesses that can supply it. */
 export interface AgentProvenanceDescriptorCoverage {
-    /** Stable provenance dimension name. */
-    dimension: string;
-    /** Built-in harnesses declaring at least one source for the dimension. */
-    harnesses: string[];
-    /** Whether at least one built-in harness can populate the dimension. */
-    covered: boolean;
+/** Stable provenance dimension name. */
+dimension: string;
+/** Built-in harnesses declaring at least one source for the dimension. */
+harnesses: string[];
+/** Whether at least one built-in harness can populate the dimension. */
+covered: boolean;
 }
 /** Model-provenance coverage for one harness over a bounded history window. */
 export interface AgentModelProvenanceCoverage {
-    /** Stable detected harness namespace. */
-    harness: string;
-    /** History events attributed to the harness. */
-    entries: number;
-    /** Events carrying an observed model. */
-    observed: number;
-    /** Events explicitly recording that the model was unavailable. */
-    unavailable: number;
-    /** Legacy events written before explicit availability existed. */
-    legacy_missing: number;
-    /** Observed fraction among events with explicit availability. */
-    coverage: number | null;
-    /** True when a sampled declared signal produced only unavailable values. */
-    inert: boolean;
+/** Stable detected harness namespace. */
+harness: string;
+/** History events attributed to the harness. */
+entries: number;
+/** Events carrying an observed model. */
+observed: number;
+/** Events explicitly recording that the model was unavailable. */
+unavailable: number;
+/** Legacy events written before explicit availability existed. */
+legacy_missing: number;
+/** Observed fraction among events with explicit availability. */
+coverage: number | null;
+/** True when a sampled declared signal produced only unavailable values. */
+inert: boolean;
 }
 /** Availability coverage for one provenance dimension on one harness. */
 export interface AgentProvenanceDimensionCoverage extends AgentModelProvenanceCoverage {
-    /** Stable provenance dimension being summarized. */
-    dimension: string;
+/** Stable provenance dimension being summarized. */
+dimension: string;
 }
 /** Semantic attribution coverage for one harness and role/topic dimension. */
 export interface AgentSemanticAttributionCoverage {
-    /** Stable detected harness namespace. */
-    harness: string;
-    /** Semantic dimension being measured. */
-    dimension: "role" | "topic";
-    /** History events attributed to the harness. */
-    entries: number;
-    /** Events carrying a non-empty semantic observation. */
-    observed: number;
-    /** Observed events grouped by precedence source. */
-    by_source: Partial<Record<AgentModelSource, number>>;
-    /** Observed fraction across all harness events. */
-    coverage: number;
+/** Stable detected harness namespace. */
+harness: string;
+/** Semantic dimension being measured. */
+dimension: "role" | "topic";
+/** History events attributed to the harness. */
+entries: number;
+/** Events carrying a non-empty semantic observation. */
+observed: number;
+/** Observed events grouped by precedence source. */
+by_source: Partial<Record<AgentModelSource, number>>;
+/** Observed fraction across all harness events. */
+coverage: number;
 }
 /** Result of applying a corpus-facing semantic coverage threshold. */
 export interface AgentSemanticAttributionCoverageGate {
-    /** Whether every sampled harness/dimension row met the threshold. */
-    passed: boolean;
-    /** Required observed fraction. */
-    minimum_coverage: number;
-    /** Required event count before a row participates. */
-    minimum_entries: number;
-    /** Deterministically ordered coverage rows. */
-    rows: AgentSemanticAttributionCoverage[];
-    /** Harness/dimension keys that failed the threshold. */
-    failures: string[];
+/** Whether every sampled harness/dimension row met the threshold. */
+passed: boolean;
+/** Required observed fraction. */
+minimum_coverage: number;
+/** Required event count before a row participates. */
+minimum_entries: number;
+/** Deterministically ordered coverage rows. */
+rows: AgentSemanticAttributionCoverage[];
+/** Harness/dimension keys that failed the threshold. */
+failures: string[];
 }
 /** One declared or inferred episode group with deterministically nested children. */
 export interface AgentEpisodeGroup {
-    /** Stable declared or inferred group key. */
-    id: string;
-    /** Optional declared human-readable purpose. */
-    label?: string;
-    /** Optional declared parent episode key. */
-    parent_id?: string;
-    /** Whether the grouping key was recorded or reconstructed. */
-    source: "declared" | "inferred";
-    /** Chronologically ordered immutable history entries in this episode. */
-    entries: [HistoryEntry, ...HistoryEntry[]];
-    /** Deterministically ordered nested episodes. */
-    children: AgentEpisodeGroup[];
+/** Stable declared or inferred group key. */
+id: string;
+/** Optional declared human-readable purpose. */
+label?: string;
+/** Optional declared parent episode key. */
+parent_id?: string;
+/** Whether the grouping key was recorded or reconstructed. */
+source: "declared" | "inferred";
+/** Chronologically ordered immutable history entries in this episode. */
+entries: [HistoryEntry, ...HistoryEntry[]];
+/** Deterministically ordered nested episodes. */
+children: AgentEpisodeGroup[];
 }
 /** Resolve the declared or deterministic legacy identity for one history event. */
 export declare function resolveHistoryEpisodeGroupIdentity(entry: HistoryEntry): Pick<AgentEpisodeGroup, "id" | "source">;
@@ -103,8 +103,8 @@ export declare function summarizeAgentProvenance(entries: readonly Pick<HistoryE
  * negative controls instead of silently passing a production coverage gate.
  */
 export declare function evaluateSemanticAttributionCoverage(entries: readonly Pick<HistoryEntry, "agent_harness" | "agent_provenance">[], options?: {
-    minimumCoverage?: number;
-    minimumEntries?: number;
+minimumCoverage?: number;
+minimumEntries?: number;
 }): AgentSemanticAttributionCoverageGate;
 /**
  * Group immutable history by declared episode keys. Legacy entries fall back