@unbrained/pm-cli 2026.10.8 → 2026.10.10

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

@@ -0,0 +1,74 @@
+/** One original attempt in a caller-defined recurrence family. */
+export interface ReliabilityAttempt {
+    /** Unique occurrence identity; retries retain the original occurrence separately. */
+    id: string;
+    /** Stable family identity independent of the occurrence's lifecycle. */
+    family: string;
+    /** Recorded start instant, used for half-open window membership. */
+    started_at: string;
+    /** Original outcome; a successful retry must not replace a failure. */
+    outcome: "success" | "failure" | "pending";
+    /** Observed repair instant, when supported by independent evidence. */
+    repaired_at?: string;
+    /** Failure-only cause; omit on success/pending and leave unknown without classification. */
+    cause?: "product" | "infrastructure" | "unknown";
+}
+/** Explicit population and thresholds for a reproducible reliability query. */
+export interface ReliabilityWindowPolicy {
+    /** Inclusive UTC window boundary. */
+    window_start: string;
+    /** Exclusive UTC window boundary and repair-observation cutoff. */
+    window_end: string;
+    /** Expected families, including families with no observed attempts. */
+    families: readonly string[];
+    /** Maximum permitted original-attempt failure fraction in [0, 1). */
+    max_failure_rate: number;
+    /** Minimum completed attempts required to establish coverage. */
+    min_completed_attempts: number;
+}
+/** Bounded aggregate evidence for one recurrence family. */
+export interface ReliabilityFamilyReport {
+    /** Stable identity from the declared population. */
+    family: string;
+    /** All original attempts in the selected window. */
+    attempts: number;
+    /** Attempts with a terminal original outcome. */
+    completed: number;
+    /** Originally failed attempts, including repaired occurrences. */
+    failed: number;
+    /** Attempts whose original outcome remains pending. */
+    pending: number;
+    /** Null denotes absent completed evidence, distinct from zero failures. */
+    failure_rate: number | null;
+    /** UTC dates carrying at least one original failure. */
+    affected_days: string[];
+    /** Sorted observed repair durations in minutes; missing repairs are excluded. */
+    repair_minutes: number[];
+    /** Failures without a repair observed before the query cutoff. */
+    unresolved: number;
+    /** Cause counts retain unclassified failures instead of guessing attribution. */
+    causes: Record<"product" | "infrastructure" | "unknown", number>;
+    /** Coverage or rate findings that enforce the declared policy. */
+    violations: Array<"insufficient_completed_attempts" | "failure_rate">;
+    /** True only when both coverage and the rate satisfy policy. */
+    ok: boolean;
+}
+/** Reproducible aggregate verdict suitable for a package, gate, or recorded measurement. */
+export interface ReliabilityWindowReport {
+    /** Versioned result schema for persisted evidence. */
+    schema: "pm-reliability-window/1";
+    /** Normalized inclusive query boundary. */
+    window_start: string;
+    /** Normalized exclusive query boundary. */
+    window_end: string;
+    /** True only when every expected family satisfies policy. */
+    ok: boolean;
+    /** Reports preserve the caller's declared family order. */
+    families: ReliabilityFamilyReport[];
+}
+/**
+ * Evaluate original attempts in [start, end), keeping repair and cause evidence separate.
+ * Reject duplicate identities, undeclared families, invalid outcomes and chronology.
+ * Empty families fail coverage; they never masquerade as healthy zero-rate evidence.
+ */
+export declare function evaluateReliabilityWindow(attempts: readonly ReliabilityAttempt[], policy: ReliabilityWindowPolicy): ReliabilityWindowReport;

package/dist/sdk/governance/reliability.js

@@ -0,0 +1,2 @@
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="604d7dcb-9fea-5631-8a72-b2a7ff3278f8")}catch{}})();import{isRfc3339DateTime}from"../../core/shared/time.js";function instant(value){if(typeof value!="string"||!isRfc3339DateTime(value))throw new TypeError("Invalid reliability timestamp.");return Date.parse(value)}function validatePolicy(policy){const start=instant(policy.window_start),end=instant(policy.window_end);if(start>=end||!Number.isFinite(policy.max_failure_rate)||policy.max_failure_rate<0||policy.max_failure_rate>=1||!Number.isSafeInteger(policy.min_completed_attempts)||policy.min_completed_attempts<1)throw new TypeError("Invalid reliability window policy.");if(policy.families.length===0||policy.families.some(family=>typeof family!="string"||family.trim().length===0)||new Set(policy.families).size!==policy.families.length)throw new TypeError("Expected unique, nonempty reliability families.");return{start,end}}function groupAttempts(attempts,families,start,end){const groups=new Map(families.map(family=>[family,[]])),ids=new Set;for(const attempt of attempts){if(typeof attempt.id!="string"||attempt.id.trim().length===0||ids.has(attempt.id))throw new TypeError("Invalid or duplicate reliability attempt identity.");ids.add(attempt.id);const group=groups.get(attempt.family);if(!group||!["success","failure","pending"].includes(attempt.outcome)||attempt.cause!==void 0&&(!["product","infrastructure","unknown"].includes(attempt.cause)||attempt.outcome!=="failure"))throw new TypeError("Invalid reliability attempt family, outcome or cause.");const created=instant(attempt.started_at);if(attempt.repaired_at!==void 0&&(instant(attempt.repaired_at)<created||attempt.outcome!=="failure"))throw new TypeError("Invalid reliability repair chronology.");created>=start&&created<end&&group.push(attempt)}return groups}function evaluateReliabilityWindow(attempts,policy){const{start,end}=validatePolicy(policy),families=[...groupAttempts(attempts,policy.families,start,end)].map(([family,rows])=>{const failed=rows.filter(row=>row.outcome==="failure"),completed=rows.filter(row=>row.outcome!=="pending").length,rate=completed===0?null:failed.length/completed,repairs=failed.filter(row=>row.repaired_at!==void 0&&instant(row.repaired_at)<end),causes={product:0,infrastructure:0,unknown:0};for(const row of failed)causes[row.cause??"unknown"]+=1;const violations=[];return completed<policy.min_completed_attempts&&violations.push("insufficient_completed_attempts"),rate!==null&&rate>policy.max_failure_rate&&violations.push("failure_rate"),{family,attempts:rows.length,completed,failed:failed.length,pending:rows.length-completed,failure_rate:rate,affected_days:[...new Set(failed.map(row=>new Date(instant(row.started_at)).toISOString().slice(0,10)))].sort(),repair_minutes:repairs.map(row=>(instant(row.repaired_at)-instant(row.started_at))/6e4).sort((a,b)=>a-b),unresolved:failed.length-repairs.length,causes,violations,ok:violations.length===0}});return{schema:"pm-reliability-window/1",window_start:new Date(start).toISOString(),window_end:new Date(end).toISOString(),ok:families.every(family=>family.ok),families}}export{evaluateReliabilityWindow};
+//# sourceMappingURL=reliability.js.map

package/dist/sdk/governance.d.ts

@@ -27,6 +27,7 @@ export * from "./governance/linked-file-report.js";
 export * from "./author-attribution.js";
 export * from "./mutation-guard.js";
 export * from "./governance/provenance-health.js";
+export * from "./governance/reliability.js";
 export * from "./similarity.js";
 export * from "./history/maintenance.js";
 export * from "./history/attestation.js";

package/dist/sdk/governance.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="47924d35-d6ce-5507-adbf-c4c3cb25c18e")}catch{}})();export*from"./governance/gc.js";export*from"./governance/health.js";export*from"./governance/extension-host-version.js";export*from"./governance/assurance.js";export*from"./governance/assurance-action.js";export*from"./governance/assurance-mutation-error.js";export*from"./governance/assurance-presets.js";export*from"./governance/assurance-runtime.js";export*from"./governance/boundary-fixtures.js";export*from"./governance/defect-recurrence.js";export*from"./governance/defect-recurrence-coverage.js";import{runReindex}from"./governance/reindex.js";export*from"./governance/stale-work.js";export*from"./governance/storage-integrity.js";export*from"./governance/status-role-diagnostics.js";export*from"./governance/workspace-position.js";export*from"./governance/workflow-policy.js";import{runUpgrade}from"./governance/upgrade.js";export*from"./governance/validate.js";export*from"./governance/closure-timestamps.js";export*from"./governance/linked-file-report.js";export*from"./author-attribution.js";export*from"./mutation-guard.js";export*from"./governance/provenance-health.js";export*from"./similarity.js";export*from"./history/maintenance.js";export*from"./history/attestation.js";export*from"./history/attestation-command.js";export*from"../core/history/digest.js";export{runReindex,runUpgrade};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c0218aaf-791c-57b1-8f9a-13816cb0c01f")}catch{}})();export*from"./governance/gc.js";export*from"./governance/health.js";export*from"./governance/extension-host-version.js";export*from"./governance/assurance.js";export*from"./governance/assurance-action.js";export*from"./governance/assurance-mutation-error.js";export*from"./governance/assurance-presets.js";export*from"./governance/assurance-runtime.js";export*from"./governance/boundary-fixtures.js";export*from"./governance/defect-recurrence.js";export*from"./governance/defect-recurrence-coverage.js";import{runReindex}from"./governance/reindex.js";export*from"./governance/stale-work.js";export*from"./governance/storage-integrity.js";export*from"./governance/status-role-diagnostics.js";export*from"./governance/workspace-position.js";export*from"./governance/workflow-policy.js";import{runUpgrade}from"./governance/upgrade.js";export*from"./governance/validate.js";export*from"./governance/closure-timestamps.js";export*from"./governance/linked-file-report.js";export*from"./author-attribution.js";export*from"./mutation-guard.js";export*from"./governance/provenance-health.js";export*from"./governance/reliability.js";export*from"./similarity.js";export*from"./history/maintenance.js";export*from"./history/attestation.js";export*from"./history/attestation-command.js";export*from"../core/history/digest.js";export{runReindex,runUpgrade};
 //# sourceMappingURL=governance.js.map

package/dist/sdk/output/table-rows.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module sdk/output/table-rows
+ *
+ * Lossless nested-cell projection for key-hoisted agent tables. Scalar columns
+ * retain their types; declared JSON columns and absent coordinates restore the
+ * original rows without confusing missing fields with explicit null values.
+ */
+import type { JsonValue } from "@toon-format/toon";
+/** Metadata required to restore nested cells and sparse object rows. */
+export interface PmTableCellEncoding {
+    /** Columns whose every present cell contains a JSON-serialized value. */
+    json_columns: string[];
+    /** Missing field coordinates, expressed as [zero-based row, column name]. */
+    absent: Array<[number, string]>;
+}
+/** Primitive rows accepted by the standard TOON tabular encoder. */
+export interface PmEncodedTableRows {
+    /** Key-hoisted rows with primitive cells and null padding for absent keys. */
+    rows: Record<string, string | number | boolean | null>[];
+    /** Explicit decoding metadata; never inferred from cell content. */
+    encoding: PmTableCellEncoding;
+}
+/**
+ * Project JSON object rows into a lossless table, preserving key order by first
+ * occurrence. A column containing any container serializes all present values
+ * as JSON so mixed strings, nulls, arrays, and objects remain unambiguous.
+ * Allocation is proportional to rows times distinct columns; callers budget
+ * that dense grid before encoding sparse inputs. The host formatter preflights
+ * automatic candidates and falls back to expanded TOON for sparse grids.
+ */
+export declare function encodePmTableRows(rows: readonly Record<string, JsonValue>[]): PmEncodedTableRows;
+/**
+ * Restore rows emitted by {@link encodePmTableRows}. Metadata is explicit, so
+ * strings resembling JSON stay strings unless their column declares JSON.
+ * Malformed JSON cells throw instead of silently changing their meaning.
+ */
+export declare function decodePmTableRows(table: PmEncodedTableRows): Record<string, JsonValue>[];

package/dist/sdk/output/table-rows.js

@@ -0,0 +1,2 @@
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8936e93f-25bf-58cc-ba91-37cc2677c5d2")}catch{}})();function encodePmTableRows(rows){const columns=[...new Set(rows.flatMap(row=>Object.keys(row)))],jsonColumns=columns.filter(column=>rows.some(row=>{const cell=row[column];return cell!==null&&typeof cell=="object"})),nested=new Set(jsonColumns),absent=[];return{rows:rows.map((row,index)=>Object.fromEntries(columns.map(column=>{if(!Object.hasOwn(row,column))return absent.push([index,column]),[column,null];const cell=row[column];return[column,nested.has(column)?JSON.stringify(cell):cell]}))),encoding:{json_columns:jsonColumns,absent}}}function decodePmTableRows(table){const nested=new Set(table.encoding.json_columns),absent=new Set(table.encoding.absent.map(([row,column])=>JSON.stringify([row,column])));return table.rows.map((row,index)=>Object.fromEntries(Object.entries(row).flatMap(([column,cell])=>absent.has(JSON.stringify([index,column]))?[]:[[column,nested.has(column)?JSON.parse(String(cell)):cell]])))}export{decodePmTableRows,encodePmTableRows};
+//# sourceMappingURL=table-rows.js.map

package/dist/sdk/output.d.ts

@@ -5,6 +5,7 @@
  * renderers, and custom SDK-built hosts.
  */
 export { SUPPRESS_HOST_OUTPUT_MARKER, isHostOutputSuppressed, suppressHostOutput, type SuppressedHostOutput, } from "../core/output/output-control.js";
+export { encodePmTableRows, decodePmTableRows, type PmTableCellEncoding, type PmEncodedTableRows, } from "./output/table-rows.js";
 /**
  * Serialize object rows as newline-delimited JSON without adding a trailing
  * newline. CLI hosts can append their final newline while SDK consumers can

package/dist/sdk/output.js

@@ -1,3 +1,3 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0b246b9c-4fb8-50ed-9fa9-c7d90f8ba87f")}catch{}})();import{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,suppressHostOutput}from"../core/output/output-control.js";function serializeNdjsonRows(rows){return rows.map((row,index)=>{if(typeof row!="object"||row===null||Array.isArray(row))throw new TypeError(`NDJSON row ${index} must be a non-null object.`);const serialized=JSON.stringify(row);if(serialized===void 0)throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);const projected=JSON.parse(serialized);if(typeof projected!="object"||projected===null||Array.isArray(projected))throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);return serialized}).join(`
-`)}function serializeNdjsonStream(rows,trailer){if(trailer.count!==rows.length)throw new TypeError(`NDJSON trailer count ${trailer.count} does not match ${rows.length} ${rows.length===1?"row":"rows"}.`);for(const[index,row]of rows.entries())if(typeof row=="object"&&row!==null&&!Array.isArray(row)&&Reflect.get(row,"record_type")==="pm.stream.trailer")throw new TypeError(`NDJSON row ${index} uses reserved record_type pm.stream.trailer`);return serializeNdjsonRows([...rows,{...trailer,record_type:"pm.stream.trailer"}])}export{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,serializeNdjsonRows,serializeNdjsonStream,suppressHostOutput};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1a6915d3-31fe-5269-b945-caef21172c86")}catch{}})();import{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,suppressHostOutput}from"../core/output/output-control.js";import{encodePmTableRows,decodePmTableRows}from"./output/table-rows.js";function serializeNdjsonRows(rows){return rows.map((row,index)=>{if(typeof row!="object"||row===null||Array.isArray(row))throw new TypeError(`NDJSON row ${index} must be a non-null object.`);const serialized=JSON.stringify(row);if(serialized===void 0)throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);const projected=JSON.parse(serialized);if(typeof projected!="object"||projected===null||Array.isArray(projected))throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);return serialized}).join(`
+`)}function serializeNdjsonStream(rows,trailer){if(trailer.count!==rows.length)throw new TypeError(`NDJSON trailer count ${trailer.count} does not match ${rows.length} ${rows.length===1?"row":"rows"}.`);for(const[index,row]of rows.entries())if(typeof row=="object"&&row!==null&&!Array.isArray(row)&&Reflect.get(row,"record_type")==="pm.stream.trailer")throw new TypeError(`NDJSON row ${index} uses reserved record_type pm.stream.trailer`);return serializeNdjsonRows([...rows,{...trailer,record_type:"pm.stream.trailer"}])}export{SUPPRESS_HOST_OUTPUT_MARKER,decodePmTableRows,encodePmTableRows,isHostOutputSuppressed,serializeNdjsonRows,serializeNdjsonStream,suppressHostOutput};
 //# sourceMappingURL=output.js.map