@unbrained/pm-cli 2026.10.14 → 2026.10.15

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

@@ -2,9 +2,9 @@ import type { AssuranceItemRecord } from "./assurance.js";
 import { type DefectRecurrenceRecord } from "./defect-recurrence-graph.js";
 export type { DefectRecurrenceRecord } from "./defect-recurrence-graph.js";
 /** Stable defect escape taxonomy used by project policy and PM metadata. */
-export declare const DEFECT_ESCAPE_CLASSES: readonly ["production_defect", "nightly_regression", "scanner_finding", "review_caught_late"];
+export declare const DEFECT_ESCAPE_CLASSES:readonly ["production_defect","nightly_regression","scanner_finding","review_caught_late"];
 /** Evidence dispositions accepted by the fail-closed defect gate. */
-export declare const DEFECT_GATE_EVIDENCE_DISPOSITIONS: readonly ["gate_added", "gate_strengthened", "explicit_waiver"];
+export declare const DEFECT_GATE_EVIDENCE_DISPOSITIONS:readonly ["gate_added","gate_strengthened","explicit_waiver"];
 /** Defect escape classification. */
 export type DefectEscapeClass = (typeof DEFECT_ESCAPE_CLASSES)[number];
 /** Distinguishes a concrete assurance improvement from a reviewed exception. */
@@ -12,244 +12,244 @@ export type DefectGateEvidenceDisposition = (typeof DEFECT_GATE_EVIDENCE_DISPOSI
 /** Structured proof attached to a terminal defect item. */
 export interface DefectGateEvidence {
 /** Whether a gate was added, strengthened, or explicitly waived. */
-disposition: DefectGateEvidenceDisposition;
+disposition:DefectGateEvidenceDisposition;
 /** Stable gate identifier, except for an explicit waiver. */
-gate_id?: string;
+gate_id?:string;
 /** Runnable negative-control command that proves the gate can fail. */
-negative_control?: string;
+negative_control?:string;
 /** Local checks selected by the same recurrence policy as hosted checks. */
-local_checks?: string[];
+local_checks?:string[];
 /** Hosted checks selected by the same recurrence policy as local checks. */
-hosted_checks?: string[];
+hosted_checks?:string[];
 /** Accountable owner of the gate or waiver. */
-owner: string;
+owner:string;
 /** Concrete reason for an explicit waiver. */
-waiver_reason?: string;
+waiver_reason?:string;
 /** ISO timestamp after which an explicit waiver is invalid. */
-waiver_expires_at?: string;
+waiver_expires_at?:string;
 }
 /** Signals that associate a family with source changes or PM context. */
 export interface DefectRecurrenceTriggers {
 /** Repository-relative glob patterns. */
-file_patterns?: string[];
+file_patterns?:string[];
 /** Package names or workspace package paths. */
-package_names?: string[];
+package_names?:string[];
 /** Canonical PM item ids. */
-item_ids?: string[];
+item_ids?:string[];
 /** PM tags. */
-tags?: string[];
+tags?:string[];
 /** Stable error-code contracts. */
-error_codes?: string[];
+error_codes?:string[];
 }
 /** Local and hosted checks selected together for one recurrence family. */
 export interface DefectRecurrenceChecks {
 /** Fast checks suitable for local development. */
-local: string[];
+local:string[];
 /** Hosted checks that add independent or environment-specific evidence. */
-hosted: string[];
+hosted:string[];
 }
 /** Budget that makes an assurance family measurable over time. */
 export interface DefectRecurrenceBudget {
 /** Maximum accepted escaped-defect rate. */
-max_escape_rate: number;
+max_escape_rate:number;
 /** Maximum accepted false-positive rate. */
-max_false_positive_rate: number;
+max_false_positive_rate:number;
 }
 /** Versioned recurrence policy for one historically observed defect family. */
 export interface DefectRecurrenceFamily {
 /** Stable family identifier. */
-id: string;
+id:string;
 /** Monotonic family contract version. */
-version: number;
+version:number;
 /** Concise human-readable title. */
-title: string;
+title:string;
 /** PM item accountable for maintaining this family. */
-owner_item_id: string;
+owner_item_id:string;
 /** Escape class represented by the historical examples. */
-escape_class: DefectEscapeClass;
+escape_class:DefectEscapeClass;
 /** Signals that select this family. */
-triggers: DefectRecurrenceTriggers;
+triggers:DefectRecurrenceTriggers;
 /** Shared local and hosted assurance policy. */
-checks: DefectRecurrenceChecks;
+checks:DefectRecurrenceChecks;
 /** Input that must select this family during policy validation. */
-negative_control: DefectChangeRiskInput;
+negative_control:DefectChangeRiskInput;
 /** Historical items that justify the family. */
-historical_item_ids: string[];
+historical_item_ids:string[];
 /** Quantitative escape and false-positive budgets. */
-budget: DefectRecurrenceBudget;
+budget:DefectRecurrenceBudget;
 }
 /** Repository recurrence policy serialized by a project or extension. */
 export interface DefectRecurrencePolicy {
 /** Serialized policy format version. */
-version: 1;
+version:1;
 /** ISO instant after which terminal defects require structured evidence. */
-evidence_epoch: string;
+evidence_epoch:string;
 /** Versioned recurrence families. */
-families: DefectRecurrenceFamily[];
+families:DefectRecurrenceFamily[];
 }
 /** Input used to explain assurance requirements for a proposed change. */
 export interface DefectChangeRiskInput {
 /** Changed repository-relative files. */
-files?: string[];
+files?:string[];
 /** Changed package names or workspace package paths. */
-package_names?: string[];
+package_names?:string[];
 /** PM items in the change lineage. */
-item_ids?: string[];
+item_ids?:string[];
 /** PM tags in the change lineage. */
-tags?: string[];
+tags?:string[];
 /** Error-code contracts touched by the change. */
-error_codes?: string[];
+error_codes?:string[];
 }
 /** Options for a full or incremental recurrence-index build. */
 export interface BuildDefectRecurrenceIndexOptions {
 /** Previous index whose unaffected item mappings can be reused. */
-previous_index?: DefectRecurrenceIndex;
+previous_index?:DefectRecurrenceIndex;
 /** Item ids replaced by the supplied item projection. */
-changed_item_ids?: string[];
+changed_item_ids?:string[];
 }
 /** Deterministic recurrence index shared by CLI, SDK, MCP, and CI. */
 export interface DefectRecurrenceIndex {
 /** Index format version. */
-version: 1;
+version:1;
 /** Hash of the policy used to build the index. */
-policy_fingerprint: string;
+policy_fingerprint:string;
 /** Hash of policy plus deterministic item-to-family contributions. */
-index_fingerprint: string;
+index_fingerprint:string;
 /** Stable family definitions. */
-families: DefectRecurrenceFamily[];
+families:DefectRecurrenceFamily[];
 /** Sparse PM item-to-family index. */
-item_families: Record<string, string[]>;
+item_families:Record<string,string[]>;
 /** Direct signal matches retained separately so removing an edge removes inherited matches. */
-direct_item_families?: Record<string, string[]>;
+direct_item_families?:Record<string,string[]>;
 /** Sparse recurrence and linked-file evidence retained for incremental graph updates. */
-recurrence_records?: Record<string, DefectRecurrenceRecord>;
+recurrence_records?:Record<string,DefectRecurrenceRecord>;
 /** Exact project file matches inherited from explicitly registered recurrence lineages. */
-file_families?: Record<string, string[]>;
+file_families?:Record<string,string[]>;
 /** Build-cost receipt. */
-build: {
+build:{
 /** Items inspected during this build. */
-items_scanned: number;
+items_scanned:number;
 /** Unchanged item mappings reused from a previous index. */
-items_reused: number;
+items_reused:number;
 /** Items with at least one recurrence family. */
-items_indexed: number;
+items_indexed:number;
 };
 }
 /** One explainable reason that selected an assurance family. */
 export interface DefectChangeRiskReason {
 /** Signal category that matched. */
-signal: "file" | "package" | "item" | "tag" | "error_code";
+signal:"file" | "package" | "item" | "tag" | "error_code";
 /** Submitted signal value. */
-value: string;
+value:string;
 /** Policy trigger or indexed item that matched. */
-matched: string;
+matched:string;
 }
 /** One selected recurrence family and its evidence requirements. */
 export interface DefectChangeRiskMatch {
 /** Stable family identifier. */
-family_id: string;
+family_id:string;
 /** Family contract version. */
-family_version: number;
+family_version:number;
 /** Accountable PM item. */
-owner_item_id: string;
+owner_item_id:string;
 /** Historical escape class. */
-escape_class: DefectEscapeClass;
+escape_class:DefectEscapeClass;
 /** Exact selection reasons. */
-reasons: DefectChangeRiskReason[];
+reasons:DefectChangeRiskReason[];
 /** Required local checks. */
-local_checks: string[];
+local_checks:string[];
 /** Required hosted checks. */
-hosted_checks: string[];
+hosted_checks:string[];
 /** Quantitative policy budget. */
-budget: DefectRecurrenceBudget;
+budget:DefectRecurrenceBudget;
 }
 /** Pagination controls for bounded change-risk output. */
 export interface AnalyzeDefectChangeRiskOptions {
 /** Opaque cursor returned by a previous report. */
-cursor?: string;
+cursor?:string;
 /** Maximum family rows returned, from 1 through 100. */
-limit?: number;
+limit?:number;
 }
 /** Serialized assurance-risk request shared by CLI, SDK, and MCP transports. */
 export interface DefectChangeRiskRequest {
 /** Project- or package-owned recurrence policy. */
-policy: DefectRecurrencePolicy;
+policy:DefectRecurrencePolicy;
 /** Proposed source and PM-context changes. */
-change: DefectChangeRiskInput;
+change:DefectChangeRiskInput;
 /** Opaque cursor returned by a previous report. */
-cursor?: string;
+cursor?:string;
 /** Maximum family rows returned, from 1 through 100. */
-limit?: number;
+limit?:number;
 }
 /** Bounded and explainable change-risk report. */
 export interface DefectChangeRiskReport {
 /** Whether at least one historical family was selected. */
-risk_detected: boolean;
+risk_detected:boolean;
 /** Stable recurrence-index identity. */
-index_fingerprint: string;
+index_fingerprint:string;
 /** Current page of selected families. */
-items: DefectChangeRiskMatch[];
+items:DefectChangeRiskMatch[];
 /** Total selected families before pagination. */
-total: number;
+total:number;
 /** Opaque continuation cursor when rows remain. */
-next_cursor?: string;
+next_cursor?:string;
 /** Deduplicated local checks across every selected family. */
-required_local_checks: string[];
+required_local_checks:string[];
 /** Deduplicated hosted checks across every selected family. */
-required_hosted_checks: string[];
+required_hosted_checks:string[];
 /** Deterministic analysis-cost receipt. */
-cost: {
+cost:{
 /** Families evaluated. */
-families_evaluated: number;
+families_evaluated:number;
 /** Submitted signals evaluated against the policy. */
-signals_evaluated: number;
+signals_evaluated:number;
 /** Selected families before pagination. */
-families_selected: number;
+families_selected:number;
 /** Approximate JSON-token cost of the bounded response. */
-estimated_output_tokens: number;
+estimated_output_tokens:number;
 };
 /** Stable collection selector for agent consumers. */
-row_contract: {
-row_keys: ["items"];
-jq_selector: ".items[]";
+row_contract:{
+row_keys:["items"];
+jq_selector:".items[]";
 };
 }
 /** One fail-closed defect-evidence finding. */
 export interface DefectGateEvidenceFinding {
 /** PM item missing or carrying invalid evidence. */
-item_id: string;
+item_id:string;
 /** Stable machine-readable finding kind. */
-kind: "missing_escape_class" | "invalid_escape_class" | "invalid_completion_timestamp" | "missing_gate_evidence" | "invalid_gate_evidence" | "expired_waiver";
+kind:"missing_escape_class" | "invalid_escape_class" | "invalid_completion_timestamp" | "missing_gate_evidence" | "invalid_gate_evidence" | "expired_waiver";
 /** Actionable explanation. */
-detail: string;
+detail:string;
 }
 /** Fail-closed governance report for terminal defects after the policy epoch. */
 export interface DefectGateEvidenceReport {
 /** Whether every governed defect carried valid evidence. */
-ok: boolean;
+ok:boolean;
 /** Terminal defect items governed by the epoch. */
-governed_item_count: number;
+governed_item_count:number;
 /** Terminal defects carrying a recognized historical escape classification. */
-classified_item_count: number;
+classified_item_count:number;
 /** Historical and epoch-governed counts by required escape class. */
-class_counts: Record<DefectEscapeClass, number>;
+class_counts:Record<DefectEscapeClass,number>;
 /** Historical and epoch-governed counts by evidence disposition. */
-evidence_disposition_counts: Record<DefectGateEvidenceDisposition, number>;
+evidence_disposition_counts:Record<DefectGateEvidenceDisposition,number>;
 /** Stable sorted findings. */
-findings: DefectGateEvidenceFinding[];
+findings:DefectGateEvidenceFinding[];
 }
 /** Compile deterministic policy and PM metadata into a sparse incremental index. */
-export declare function buildDefectRecurrenceIndex(policy: DefectRecurrencePolicy, items: readonly AssuranceItemRecord[], options?: BuildDefectRecurrenceIndexOptions): DefectRecurrenceIndex;
+export declare function buildDefectRecurrenceIndex(policy:DefectRecurrencePolicy,items:readonly AssuranceItemRecord[],options?:BuildDefectRecurrenceIndexOptions):DefectRecurrenceIndex;
 /** Explain recurrence families and shared local/hosted checks for one change. */
-export declare function analyzeDefectChangeRisk(index: DefectRecurrenceIndex, input: DefectChangeRiskInput, options?: AnalyzeDefectChangeRiskOptions): DefectChangeRiskReport;
+export declare function analyzeDefectChangeRisk(index:DefectRecurrenceIndex,input:DefectChangeRiskInput,options?:AnalyzeDefectChangeRiskOptions):DefectChangeRiskReport;
 /** Enforce structured escape classification and gate evidence on new terminal defects. */
-export declare function evaluateDefectGateEvidence(items: readonly AssuranceItemRecord[], policy: DefectRecurrencePolicy, terminalStatuses: readonly string[], now?: Date): DefectGateEvidenceReport;
+export declare function evaluateDefectGateEvidence(items:readonly AssuranceItemRecord[],policy:DefectRecurrencePolicy,terminalStatuses:readonly string[],now?:Date):DefectGateEvidenceReport;
 /** A policy-stage validation failure, distinguishable from other request TypeErrors. */
 export declare class DefectRecurrencePolicyParseError extends TypeError {
 /** Stable stage identity for consumers combining different SDK entrypoints. */
 readonly code = "defect_recurrence_policy_invalid";
 }
 /** Parse an untrusted serialized policy without weakening runtime validation. */
-export declare function parseDefectRecurrencePolicy(value: unknown): DefectRecurrencePolicy;
+export declare function parseDefectRecurrencePolicy(value:unknown):DefectRecurrencePolicy;
 /** Parse an untrusted cross-transport change-risk request. */
-export declare function parseDefectChangeRiskRequest(value: unknown): DefectChangeRiskRequest;
+export declare function parseDefectChangeRiskRequest(value:unknown):DefectChangeRiskRequest;

package/dist/sdk/governance/extension-host-version.d.ts

@@ -2,24 +2,24 @@ import type { LoadedExtension } from "../../core/extensions/loader.js";
 /** One distinct resolvable pm-cli installation and its extension consumers. */
 export interface ExtensionHostVersionCopy {
 /** Installed pm-cli version. */
-version: string;
+version:string;
 /** Privacy-safe workspace-relative package manifest location. */
-path: string;
+path:string;
 /** Dependency layout that exposed this copy. */
-layout: "host" | "npm" | "pnpm" | "other";
+layout:"host" | "npm" | "pnpm" | "other";
 /** Loaded extensions resolving this copy. */
-consumers: string[];
+consumers:string[];
 }
 /** Extension/host version census returned by the health SDK. */
 export interface ExtensionHostVersionCensus {
 /** Version of the process-hosting pm-cli package. */
-host_version: string | null;
+host_version:string | null;
 /** Every distinct relevant copy resolved by the host or an extension. */
-copies: ExtensionHostVersionCopy[];
+copies:ExtensionHostVersionCopy[];
 /** Copies whose version differs from the process host. */
-mismatches: ExtensionHostVersionCopy[];
+mismatches:ExtensionHostVersionCopy[];
 /** Stable health warning tokens for mismatched copies. */
-warnings: string[];
+warnings:string[];
 }
 /** Scan the host plus the nearest pm-cli package resolvable by every loaded extension. */
-export declare function scanExtensionHostVersions(loadedExtensions: readonly LoadedExtension[], workspaceRoot: string, hostPackageRoot?: string): Promise<ExtensionHostVersionCensus>;
+export declare function scanExtensionHostVersions(loadedExtensions:readonly LoadedExtension[],workspaceRoot:string,hostPackageRoot?:string):Promise<ExtensionHostVersionCensus>;

package/dist/sdk/governance/gc.d.ts

@@ -1,69 +1,69 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-declare const GC_SCOPE_VALUES: readonly ["index", "embeddings", "runtime", "locks", "checkpoints", "transactions"];
+declare const GC_SCOPE_VALUES:readonly ["index","embeddings","runtime","locks","checkpoints","transactions"];
 type GcScope = (typeof GC_SCOPE_VALUES)[number];
 /** Documents the gc command options payload exchanged by command, SDK, and package integrations. */
 export interface GcCommandOptions {
 /** Value that configures or reports dry run for this contract. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Value that configures or reports scope for this contract. */
-scope?: string[];
+scope?:string[];
 }
 /** Documents the gc locks summary payload exchanged by command, SDK, and package integrations. */
 export interface GcLocksSummary {
 /** Value that configures or reports scanned for this contract. */
-scanned: number;
+scanned:number;
 /** Value that configures or reports removed for this contract. */
-removed: number;
+removed:number;
 /** Value that configures or reports retained for this contract. */
-retained: number;
+retained:number;
 }
 /** Documents the gc checkpoints summary payload exchanged by command, SDK, and package integrations. */
 export interface GcCheckpointsSummary {
 /** Value that configures or reports scanned for this contract. */
-scanned: number;
+scanned:number;
 /** Value that configures or reports removed for this contract. */
-removed: number;
+removed:number;
 /** Value that configures or reports retained for this contract. */
-retained: number;
+retained:number;
 /** Value that configures or reports retention days for this contract. */
-retention_days: number;
+retention_days:number;
 }
 /** Documents the gc transactions summary payload exchanged by command, SDK, and package integrations. */
 export interface GcTransactionsSummary {
 /** Value that configures or reports scanned for this contract. */
-scanned: number;
+scanned:number;
 /** Value that configures or reports removed for this contract. */
-removed: number;
+removed:number;
 /** Value that configures or reports retained for this contract. */
-retained: number;
+retained:number;
 /** Value that configures or reports retention days for this contract. */
-retention_days: number;
+retention_days:number;
 }
 /** Documents the gc result payload exchanged by command, SDK, and package integrations. */
 export interface GcResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Value that configures or reports dry run for this contract. */
-dry_run: boolean;
+dry_run:boolean;
 /** Value that configures or reports scope for this contract. */
-scope: GcScope[];
+scope:GcScope[];
 /** Value that configures or reports removed for this contract. */
-removed: string[];
+removed:string[];
 /** Value that configures or reports retained for this contract. */
-retained: string[];
+retained:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports guidance for this contract. */
-guidance: string[];
+guidance:string[];
 /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */
-locks?: GcLocksSummary;
+locks?:GcLocksSummary;
 /** Present only when the checkpoints scope was selected. Summarizes the rollback-checkpoint sweep. */
-checkpoints?: GcCheckpointsSummary;
+checkpoints?:GcCheckpointsSummary;
 /** Present only when the transactions scope was selected. Summarizes the workspace-transaction journal sweep. */
-transactions?: GcTransactionsSummary;
+transactions?:GcTransactionsSummary;
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+generated_at:string;
 }
 /** Implements run gc for the public runtime surface of this module. */
-export declare function runGc(global: GlobalOptions, options?: GcCommandOptions): Promise<GcResult>;
+export declare function runGc(global:GlobalOptions,options?:GcCommandOptions):Promise<GcResult>;
 export {};

package/dist/sdk/governance/health-merge-evidence.d.ts

@@ -6,13 +6,13 @@
 import type { PmSettings } from "../../types/index.js";
 import { auditMergeAttributeFence } from "../merge/install.js";
 /** Audit the active tracker's shared attribute fence and report strict merge protection findings. */
-export declare function resolveMergeFenceHealthEvidence(pmRoot: string, gitWorkspaceRoot: string | null, settings: PmSettings, required: boolean): Promise<{
-audit: Awaited<ReturnType<typeof auditMergeAttributeFence>> | null;
-count: number;
-warnings: string[];
+export declare function resolveMergeFenceHealthEvidence(pmRoot:string,gitWorkspaceRoot:string | null,settings:PmSettings,required:boolean):Promise<{
+audit:Awaited<ReturnType<typeof auditMergeAttributeFence>> | null;
+count:number;
+warnings:string[];
 }>;
 /** Report unresolved durable merge receipt evidence in compact warning form. */
-export declare function buildMergeReceiptEvidenceWarnings(params: {
-invalidEvidenceCount: number;
-missingHistoryReferenceCount: number;
-}): string[];
+export declare function buildMergeReceiptEvidenceWarnings(params:{
+invalidEvidenceCount:number;
+missingHistoryReferenceCount:number;
+}):string[];