@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/governance/boundary-fixtures.d.ts

@@ -4,83 +4,83 @@ export declare const BOUNDARY_FIXTURE_CAPTURE_SOURCES: readonly ["captured_redac
 export type BoundaryFixtureCaptureSource = (typeof BOUNDARY_FIXTURE_CAPTURE_SOURCES)[number];
 /** Inventory record backed by a committed captured sample. */
 export interface CapturedBoundaryRecord {
-    /** Stable external-boundary identifier. */
-    id: string;
-    /** Production component that emits or obtains the value. */
-    producer: string;
-    /** Production component that parses or consumes the value. */
-    consumer: string;
-    /** Concise serialized-format description. */
-    format: string;
-    /** Relative path to a committed JSON fixture. */
-    fixture_path: string;
+/** Stable external-boundary identifier. */
+id: string;
+/** Production component that emits or obtains the value. */
+producer: string;
+/** Production component that parses or consumes the value. */
+consumer: string;
+/** Concise serialized-format description. */
+format: string;
+/** Relative path to a committed JSON fixture. */
+fixture_path: string;
 }
 /** Inventory record explicitly waived until a bounded expiry. */
 export interface WaivedBoundaryRecord {
-    /** Stable external-boundary identifier. */
-    id: string;
-    /** Production component that emits or obtains the value. */
-    producer: string;
-    /** Production component that parses or consumes the value. */
-    consumer: string;
-    /** Concise serialized-format description. */
-    format: string;
-    /** Concrete reason a safe captured fixture is not available. */
-    waiver_reason: string;
-    /** Accountable PM item or team. */
-    waiver_owner: string;
-    /** ISO timestamp after which the waiver fails closed. */
-    waiver_expires_at: string;
+/** Stable external-boundary identifier. */
+id: string;
+/** Production component that emits or obtains the value. */
+producer: string;
+/** Production component that parses or consumes the value. */
+consumer: string;
+/** Concise serialized-format description. */
+format: string;
+/** Concrete reason a safe captured fixture is not available. */
+waiver_reason: string;
+/** Accountable PM item or team. */
+waiver_owner: string;
+/** ISO timestamp after which the waiver fails closed. */
+waiver_expires_at: string;
 }
 /** One externally generated or consumed boundary inventory entry. */
 export type BoundaryInventoryRecord = CapturedBoundaryRecord | WaivedBoundaryRecord;
 /** Versioned project boundary inventory. */
 export interface BoundaryFixtureRegistry {
-    /** Serialized registry format. */
-    version: 1;
-    /** Human-readable statement of what source surfaces were inventoried. */
-    inventory_scope: string;
-    /** Captured or explicitly waived boundary records. */
-    boundaries: BoundaryInventoryRecord[];
+/** Serialized registry format. */
+version: 1;
+/** Human-readable statement of what source surfaces were inventoried. */
+inventory_scope: string;
+/** Captured or explicitly waived boundary records. */
+boundaries: BoundaryInventoryRecord[];
 }
 /** Required shape of a committed captured boundary sample. */
 export interface BoundaryFixtureSample {
-    /** Serialized fixture format. */
-    version: 1;
-    /** Inventory boundary id proved by this sample. */
-    boundary_id: string;
-    /** Captured evidence classification; self-generated is intentionally absent. */
-    capture_source: BoundaryFixtureCaptureSource;
-    /** Where and how the original value was observed. */
-    capture_provenance: string;
-    /** Redactions applied before committing the sample. */
-    redactions: string[];
-    /** Redacted external input. */
-    input: unknown;
-    /** Redacted observed boundary value. */
-    observed: unknown;
+/** Serialized fixture format. */
+version: 1;
+/** Inventory boundary id proved by this sample. */
+boundary_id: string;
+/** Captured evidence classification; self-generated is intentionally absent. */
+capture_source: BoundaryFixtureCaptureSource;
+/** Where and how the original value was observed. */
+capture_provenance: string;
+/** Redactions applied before committing the sample. */
+redactions: string[];
+/** Redacted external input. */
+input: unknown;
+/** Redacted observed boundary value. */
+observed: unknown;
 }
 /** Stable boundary-fixture governance finding. */
 export interface BoundaryFixtureFinding {
-    /** Boundary id, or registry for registry-wide defects. */
-    boundary_id: string;
-    /** Machine-readable failure kind. */
-    kind: "invalid_registry" | "duplicate_boundary" | "invalid_boundary" | "missing_fixture" | "invalid_fixture" | "fixture_boundary_mismatch" | "unsafe_fixture" | "invalid_waiver" | "expired_waiver";
-    /** Actionable explanation. */
-    detail: string;
+/** Boundary id, or registry for registry-wide defects. */
+boundary_id: string;
+/** Machine-readable failure kind. */
+kind: "invalid_registry" | "duplicate_boundary" | "invalid_boundary" | "missing_fixture" | "invalid_fixture" | "fixture_boundary_mismatch" | "unsafe_fixture" | "invalid_waiver" | "expired_waiver";
+/** Actionable explanation. */
+detail: string;
 }
 /** Complete captured-boundary governance report. */
 export interface BoundaryFixtureReport {
-    /** Whether every inventoried boundary has safe current evidence. */
-    ok: boolean;
-    /** Total inventoried boundaries. */
-    boundary_count: number;
-    /** Boundaries backed by committed captured samples. */
-    captured_count: number;
-    /** Boundaries carrying live explicit waivers. */
-    waived_count: number;
-    /** Stable sorted failures. */
-    findings: BoundaryFixtureFinding[];
+/** Whether every inventoried boundary has safe current evidence. */
+ok: boolean;
+/** Total inventoried boundaries. */
+boundary_count: number;
+/** Boundaries backed by committed captured samples. */
+captured_count: number;
+/** Boundaries carrying live explicit waivers. */
+waived_count: number;
+/** Stable sorted failures. */
+findings: BoundaryFixtureFinding[];
 }
 /** Validate an untrusted boundary registry and its already-loaded JSON samples. */
 export declare function evaluateBoundaryFixtures(registry: BoundaryFixtureRegistry, fixtures: Readonly<Record<string, unknown>>, now?: Date): BoundaryFixtureReport;

package/dist/sdk/governance/closure-timestamps.d.ts

@@ -5,10 +5,10 @@ import type { HistoryEntry, ItemDocument } from "../../types/index.js";
 import type { ValidateItem } from "./validate-item-reader.js";
 /** A replay-proven transition or an explicit reason no safe date can be assigned. */
 export type ClosureTimestampEvidence = {
-    timestamp: string;
-    source_index: number;
+timestamp: string;
+source_index: number;
 } | {
-    reason: "missing_history" | "unverified_history" | "not_terminal" | "no_proven_transition";
+reason: "missing_history" | "unverified_history" | "not_terminal" | "no_proven_transition";
 };
 /**
  * Find the beginning of the final uninterrupted terminal interval in stream order.
@@ -19,12 +19,12 @@ export type ClosureTimestampEvidence = {
 export declare function deriveClosureTimestamp(history: HistoryEntry[], document: ItemDocument, terminalStatuses: ReadonlySet<string>): ClosureTimestampEvidence;
 /** Missing closure dates, bounded diagnostics, and the complete opt-in repair plan. */
 export interface ClosureTimestampScan {
-    /** Scalar counts and explicitly bounded residual/evidence rows for validate output. */
-    details: Record<string, unknown>;
-    /** Audited fixes; no entry exists for unproven history. */
-    fixes: ValidateFixRecord[];
-    /** Advisory warnings for the missing population. */
-    warnings: string[];
+/** Scalar counts and explicitly bounded residual/evidence rows for validate output. */
+details: Record<string, unknown>;
+/** Audited fixes; no entry exists for unproven history. */
+fixes: ValidateFixRecord[];
+/** Advisory warnings for the missing population. */
+warnings: string[];
 }
 /** Inspect only terminal items missing a date; replay is requested explicitly by remediation callers. */
 export declare function scanClosureTimestamps(pmRoot: string, items: readonly ValidateItem[], registry: RuntimeStatusRegistry, inspectHistory: boolean, limit: number): Promise<ClosureTimestampScan>;

package/dist/sdk/governance/coverage-assurance.d.ts

@@ -9,16 +9,16 @@ export declare const PM_EXACT_COVERAGE_METRICS: readonly ["lines", "branches", "
 export type PmExactCoverageMetric = (typeof PM_EXACT_COVERAGE_METRICS)[number];
 /** One exact uncovered-count finding. */
 export interface PmCoverageDeficit {
-    /** Coverage summary entry or source filename. */
-    file: string;
-    /** Deficient required metric. */
-    metric: PmExactCoverageMetric;
-    /** Integer statements or paths not covered. */
-    uncovered: number;
-    /** Exact covered count. */
-    covered: number;
-    /** Exact total count. */
-    total: number;
+/** Coverage summary entry or source filename. */
+file: string;
+/** Deficient required metric. */
+metric: PmExactCoverageMetric;
+/** Integer statements or paths not covered. */
+uncovered: number;
+/** Exact covered count. */
+covered: number;
+/** Exact total count. */
+total: number;
 }
 /** Return exact uncovered counts for every summary entry and required metric. */
 export declare function findCoverageDeficits(summary: unknown): PmCoverageDeficit[];

package/dist/sdk/governance/defect-recurrence-coverage.d.ts

@@ -2,92 +2,92 @@ import type { AssuranceItemRecord } from "./assurance.js";
 import { type DefectEscapeClass, type DefectRecurrencePolicy } from "./defect-recurrence.js";
 /** Bounded recurrence-evidence selection shared by SDK and transport hosts. */
 export interface DefectRecurrenceCoverageOptions {
-    /** Maximum item rows returned, from 1 through 100; defaults to 25. */
-    limit?: number;
-    /** Continuation tied to the policy, complete recurrence evidence, and filter. */
-    cursor?: string;
-    /** Return only unregistered or missing items; totals always describe the full graph. */
-    uncoveredOnly?: boolean;
+/** Maximum item rows returned, from 1 through 100; defaults to 25. */
+limit?: number;
+/** Continuation tied to the policy, complete recurrence evidence, and filter. */
+cursor?: string;
+/** Return only unregistered or missing items; totals always describe the full graph. */
+uncoveredOnly?: boolean;
 }
 /** Serialized request for the shared assurance lineages action. */
 export interface DefectRecurrenceCoverageRequest extends DefectRecurrenceCoverageOptions {
-    /** Project- or package-owned versioned family policy. */
-    policy: DefectRecurrencePolicy;
+/** Project- or package-owned versioned family policy. */
+policy: DefectRecurrencePolicy;
 }
 /** Validate lineage-policy and paging input at the untrusted transport boundary. */
 export declare function parseDefectRecurrenceCoverageRequest(value: unknown): DefectRecurrenceCoverageRequest;
 /** One registered, unregistered, or missing member of a recorded recurrence lineage. */
 export interface DefectRecurrenceCoverageRow {
-    /** Recorded item id or missing local reference. */
-    item_id: string;
-    /** Current component identity, derived from its lexically first item id. */
-    lineage_id: string;
-    /** Full component size, independent of the returned page. */
-    lineage_item_count: number;
-    /** Explicitly registered families covering this component. */
-    family_ids: string[];
-    /** Whether the local item exists in the supplied authoritative corpus. */
-    present: boolean;
-    /** Stable named finding when registration or the target record is absent. */
-    finding?: "unregistered_recurrence_item" | "missing_recurrence_item";
+/** Recorded item id or missing local reference. */
+item_id: string;
+/** Current component identity, derived from its lexically first item id. */
+lineage_id: string;
+/** Full component size, independent of the returned page. */
+lineage_item_count: number;
+/** Explicitly registered families covering this component. */
+family_ids: string[];
+/** Whether the local item exists in the supplied authoritative corpus. */
+present: boolean;
+/** Stable named finding when registration or the target record is absent. */
+finding?: "unregistered_recurrence_item" | "missing_recurrence_item";
 }
 /** Complete population counts and bounded recurrence-policy evidence. */
 export interface DefectRecurrenceCoverageReport {
-    /** False if any recorded recurrence member is unregistered or missing. */
-    ok: boolean;
-    /** Identity of policy, recurrence evidence, and selected filter. */
-    fingerprint: string;
-    /** Current page; every row remains connected to its complete lineage. */
-    items: DefectRecurrenceCoverageRow[];
-    /** Selected row count before pagination. */
-    total: number;
-    /** Whether another page remains. */
-    has_more: boolean;
-    /** Cursor for the next page when has_more is true. */
-    next_cursor?: string;
-    /** Independent denominator including covered, uncovered, and absent local references. */
-    population: {
-        /** Explicit statement that the denominator is not the family registry. */
-        scope: "all_recorded_recurrence_items";
-        /** Unique participating local ids, including missing references. */
-        item_count: number;
-        /** Connected recurrence components. */
-        lineage_count: number;
-        /** Unique directed local recurrence edges. */
-        edge_count: number;
-        /** Existing members with an explicitly seeded registered family. */
-        covered_item_count: number;
-        /** Existing or missing members without a seeded registered family. */
-        uncovered_item_count: number;
-        /** Referenced ids missing from the authoritative item corpus. */
-        missing_item_count: number;
-        /** Members with an explicit recognized escape classification. */
-        classified_item_count: number;
-        /** Members without a recognized classification; never counted as non-escapes. */
-        unclassified_item_count: number;
-        /** Recorded classification counts over the entire population. */
-        class_counts: Record<DefectEscapeClass, number>;
-        /** Production-defect fraction only when every participant is classified; null otherwise. */
-        escape_rate: number | null;
-        /** Known production defects divided by the entire population, explicitly a lower bound. */
-        escape_rate_lower_bound: number | null;
-    };
-    /** Budgets on the policy's families cannot certify uncovered or unclassified members. */
-    budget_scope: "registered_families_only";
-    /** Declared performance accounting; connectivity never uses a depth cutoff. */
-    cost: {
-        /** Input item records inspected. */
-        items_scanned: number;
-        /** Recurrence edges traversed. */
-        edges_scanned: number;
-        /** Maximum emitted item rows. */
-        row_limit: number;
-    };
-    /** Stable machine selector. */
-    row_contract: {
-        row_keys: ["items"];
-        jq_selector: ".items[]";
-    };
+/** False if any recorded recurrence member is unregistered or missing. */
+ok: boolean;
+/** Identity of policy, recurrence evidence, and selected filter. */
+fingerprint: string;
+/** Current page; every row remains connected to its complete lineage. */
+items: DefectRecurrenceCoverageRow[];
+/** Selected row count before pagination. */
+total: number;
+/** Whether another page remains. */
+has_more: boolean;
+/** Cursor for the next page when has_more is true. */
+next_cursor?: string;
+/** Independent denominator including covered, uncovered, and absent local references. */
+population: {
+/** Explicit statement that the denominator is not the family registry. */
+scope: "all_recorded_recurrence_items";
+/** Unique participating local ids, including missing references. */
+item_count: number;
+/** Connected recurrence components. */
+lineage_count: number;
+/** Unique directed local recurrence edges. */
+edge_count: number;
+/** Existing members with an explicitly seeded registered family. */
+covered_item_count: number;
+/** Existing or missing members without a seeded registered family. */
+uncovered_item_count: number;
+/** Referenced ids missing from the authoritative item corpus. */
+missing_item_count: number;
+/** Members with an explicit recognized escape classification. */
+classified_item_count: number;
+/** Members without a recognized classification; never counted as non-escapes. */
+unclassified_item_count: number;
+/** Recorded classification counts over the entire population. */
+class_counts: Record<DefectEscapeClass, number>;
+/** Production-defect fraction only when every participant is classified; null otherwise. */
+escape_rate: number | null;
+/** Known production defects divided by the entire population, explicitly a lower bound. */
+escape_rate_lower_bound: number | null;
+};
+/** Budgets on the policy's families cannot certify uncovered or unclassified members. */
+budget_scope: "registered_families_only";
+/** Declared performance accounting; connectivity never uses a depth cutoff. */
+cost: {
+/** Input item records inspected. */
+items_scanned: number;
+/** Recurrence edges traversed. */
+edges_scanned: number;
+/** Maximum emitted item rows. */
+row_limit: number;
+};
+/** Stable machine selector. */
+row_contract: {
+row_keys: ["items"];
+jq_selector: ".items[]";
+};
 }
 /** Evaluate all local recurs_from lineages before applying any result-row limit. */
 export declare function analyzeDefectRecurrenceCoverage(policy: DefectRecurrencePolicy, items: readonly AssuranceItemRecord[], options?: DefectRecurrenceCoverageOptions): DefectRecurrenceCoverageReport;

package/dist/sdk/governance/defect-recurrence-graph.d.ts

@@ -2,30 +2,30 @@ import type { AssuranceItemRecord } from "./assurance.js";
 import type { DefectRecurrenceFamily } from "./defect-recurrence.js";
 /** Sparse item evidence retained so incremental graph edits can be reversed. */
 export interface DefectRecurrenceRecord {
-    /** Unique local predecessors named by recurs_from edges. */
-    targets: string[];
-    /** Project file paths used as exact change-risk triggers after lineage registration. */
-    files: string[];
-    /** Recorded classification, never inferred from a registered family's label. */
-    escape_class?: string;
+/** Unique local predecessors named by recurs_from edges. */
+targets: string[];
+/** Project file paths used as exact change-risk triggers after lineage registration. */
+files: string[];
+/** Recorded classification, never inferred from a registered family's label. */
+escape_class?: string;
 }
 /** One weakly connected recurrence component, traversed without a depth ceiling. */
 export interface DefectRecurrenceLineage {
-    /** Lexically first member, used as a stable identifier for the current component. */
-    id: string;
-    /** Every member, in deterministic code-point order. */
-    item_ids: string[];
-    /** Families explicitly seeded anywhere in this component. */
-    family_ids: string[];
+/** Lexically first member, used as a stable identifier for the current component. */
+id: string;
+/** Every member, in deterministic code-point order. */
+item_ids: string[];
+/** Families explicitly seeded anywhere in this component. */
+family_ids: string[];
 }
 /** Complete sparse graph used internally by the bounded public coverage report. */
 export interface DefectRecurrenceGraph {
-    /** Components sorted by their current stable id. */
-    lineages: DefectRecurrenceLineage[];
-    /** Sparse lookup from every recurrence member to its component. */
-    membership: Map<string, DefectRecurrenceLineage>;
-    /** Number of distinct directed local recurrence edges. */
-    edge_count: number;
+/** Components sorted by their current stable id. */
+lineages: DefectRecurrenceLineage[];
+/** Sparse lookup from every recurrence member to its component. */
+membership: Map<string, DefectRecurrenceLineage>;
+/** Number of distinct directed local recurrence edges. */
+edge_count: number;
 }
 /** Read a sparse projection without retaining full item bodies or history. */
 export declare function readDefectRecurrenceRecord(item: AssuranceItemRecord): DefectRecurrenceRecord | undefined;