@unbrained/pm-cli 2026.10.10 → 2026.10.11

package/dist/sdk/governance/artifact-ledgers.d.ts

@@ -0,0 +1,59 @@
+/** @module sdk/governance/artifact-ledgers
+ * Reconciles complete artifact identity inventories without concealing historical discrepancies.
+ */
+/** One authoritative inventory; callers must establish completeness before evaluation. */
+export interface ArtifactLedgerSnapshot {
+    /** Unique ledger name, such as declared, tagged or delivered. */
+    name: string;
+    /** Exact artifact identities; duplicates indicate an invalid inventory. */
+    identities: readonly string[];
+    /** Explicit completeness acknowledgement; partial evidence is refused. */
+    complete: boolean;
+}
+/** A reviewed historical exception scoped to one exact missing-ledger signature. */
+export interface ArtifactLedgerException {
+    /** Exact artifact identity whose discrepancy is retained. */
+    identity: string;
+    /** Exact ledgers lacking this identity; a new omission invalidates settlement. */
+    missing_from: readonly string[];
+    /** Recorded rationale for retaining this historical discrepancy. */
+    reason: string;
+    /** Caller-owned decision, item or immutable evidence reference. */
+    evidence: string;
+}
+/** One discrepancy, including its observed membership and explicit disposition. */
+export interface ArtifactLedgerFinding {
+    /** Artifact identity missing from at least one complete ledger. */
+    identity: string;
+    /** Sorted ledgers containing the artifact. */
+    present_in: string[];
+    /** Sorted ledgers missing the artifact. */
+    missing_from: string[];
+    /** Exact historical disposition; null denotes unsettled drift. */
+    disposition: {
+        reason: string;
+        evidence: string;
+    } | null;
+}
+/** Deterministic full-history result suitable for any project's artifact governance. */
+export interface ArtifactLedgerReport {
+    /** Versioned receipt schema. */
+    schema: "pm-artifact-ledgers/1";
+    /** True only when every finding is settled and no exception has become stale. */
+    ok: boolean;
+    /** Complete per-ledger population counts, including empty individual ledgers. */
+    counts: Record<string, number>;
+    /** Every discrepancy remains visible, including accepted historical exceptions. */
+    findings: ArtifactLedgerFinding[];
+    /** Exceptions whose artifact or exact missing signature no longer matches. */
+    stale_exceptions: string[];
+}
+/**
+ * Compare caller-defined complete inventories by exact artifact identity.
+ * Preserve all discrepancies and apply a historical exception only when its
+ * missing-ledger signature still matches. Reject incomplete/vacuous populations;
+ * input order, a recovery or a stale exception cannot hide newly introduced drift.
+ * Validate JavaScript collection and record shapes before property access, so
+ * malformed inventories and exceptions retain field-specific TypeError diagnostics.
+ */
+export declare function reconcileArtifactLedgers(snapshots: readonly ArtifactLedgerSnapshot[], exceptions?: readonly ArtifactLedgerException[]): ArtifactLedgerReport;

package/dist/sdk/governance/artifact-ledgers.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]="415e07d5-008a-5a96-ad7d-eb630aa08f57")}catch{}})();function validIdentity(value){return typeof value=="string"&&value.length>0&&value.trim()===value}function inventory(snapshots){if(!Array.isArray(snapshots)||snapshots.length<2)throw new TypeError("Expected at least two artifact ledgers.");const ledgers=new Map;for(const snapshot of snapshots){if(snapshot===null||typeof snapshot!="object"||!validIdentity(snapshot.name)||ledgers.has(snapshot.name)||snapshot.complete!==!0)throw new TypeError("Expected unique complete artifact ledgers.");if(!Array.isArray(snapshot.identities))throw new TypeError("Invalid or duplicate artifact identity.");const identities=new Set(snapshot.identities);if(identities.size!==snapshot.identities.length||snapshot.identities.some(id=>!validIdentity(id)))throw new TypeError("Invalid or duplicate artifact identity.");ledgers.set(snapshot.name,identities)}if([...ledgers.values()].every(identities=>identities.size===0))throw new TypeError("Empty inventories cannot establish artifact reconciliation.");return ledgers}function settlements(exceptions,names){if(!Array.isArray(exceptions))throw new TypeError("Expected unique evidence-backed artifact exceptions.");const accepted=new Map;for(const exception of exceptions){if(exception===null||typeof exception!="object"||!validIdentity(exception.identity)||accepted.has(exception.identity)||!validIdentity(exception.reason)||!validIdentity(exception.evidence))throw new TypeError("Expected unique evidence-backed artifact exceptions.");const missing=exception.missing_from;if(!Array.isArray(missing)||missing.length===0||missing.length>=names.length||new Set(missing).size!==missing.length||missing.some(name=>!names.includes(name)))throw new TypeError("Invalid artifact exception ledger signature.");accepted.set(exception.identity,exception)}return accepted}function reconcileArtifactLedgers(snapshots,exceptions=[]){const ledgers=inventory(snapshots),names=[...ledgers.keys()].sort(),accepted=settlements(exceptions,names),identities=[...new Set([...ledgers.values()].flatMap(set=>[...set]))].sort(),findings=[],matched=new Set;for(const identity of identities){const missing=names.filter(name=>!ledgers.get(name).has(identity));if(missing.length===0)continue;const exception=accepted.get(identity),settled=exception!==void 0&&JSON.stringify([...exception.missing_from].sort())===JSON.stringify(missing);settled&&matched.add(identity),findings.push({identity,present_in:names.filter(name=>ledgers.get(name).has(identity)),missing_from:missing,disposition:settled?{reason:exception.reason,evidence:exception.evidence}:null})}const stale=[...accepted.keys()].filter(identity=>!matched.has(identity)).sort();return{schema:"pm-artifact-ledgers/1",ok:findings.every(finding=>finding.disposition!==null)&&stale.length===0,counts:Object.fromEntries(names.map(name=>[name,ledgers.get(name).size])),findings,stale_exceptions:stale}}export{reconcileArtifactLedgers};
+//# sourceMappingURL=artifact-ledgers.js.map

package/dist/sdk/governance.d.ts

@@ -28,6 +28,7 @@ export * from "./author-attribution.js";
 export * from "./mutation-guard.js";
 export * from "./governance/provenance-health.js";
 export * from "./governance/reliability.js";
+export * from "./governance/artifact-ledgers.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]="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};
+(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]="fca4e9bb-3a30-512e-9929-565ab6c11c54")}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"./governance/artifact-ledgers.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