@principles/core 1.73.0

package/dist/runtime-v2/pruning-read-model.d.ts

@@ -0,0 +1,76 @@
+export type PrincipleStatus = 'candidate' | 'active' | 'archived' | 'deprecated' | 'probation';
+export type PruningRiskLevel = 'none' | 'watch' | 'review';
+export interface PrinciplePruningSignal {
+    principleId: string;
+    status: PrincipleStatus;
+    createdAt: string;
+    updatedAt: string;
+    derivedCandidateIds: string[];
+    derivedPainCount: number;
+    matchedCandidateCount: number;
+    recentCandidateCount: number;
+    orphanCandidateCount: number;
+    ageDays: number;
+    riskLevel: PruningRiskLevel;
+    reasons: string[];
+}
+export interface PruningHealthSummary {
+    totalPrinciples: number;
+    byStatus: Record<string, number>;
+    watchCount: number;
+    reviewCount: number;
+    orphanDerivedCandidateCount: number;
+    averageAgeDays: number;
+    activeL1Count: number;
+    l1Cap: number;
+    generatedAt: string;
+}
+export interface OrphanDerivedCandidate {
+    candidateId: string;
+    principleId: string;
+    reason: string;
+    sourceRef?: string;
+    status?: string;
+}
+export interface OrphanDetectionResult {
+    candidates: OrphanDerivedCandidate[];
+    dbReadable: boolean;
+}
+export interface PruningReadModelOptions {
+    workspaceDir: string;
+    /** Override days threshold for 'watch' risk level (default: 30) */
+    watchThresholdDays?: number;
+    /** Override days threshold for 'review' risk level (default: 90) */
+    reviewThresholdDays?: number;
+    /** Override L1 hard cap for health summary (default: 12) */
+    l1Cap?: number;
+}
+export declare class PruningReadModel {
+    private readonly workspaceDir;
+    private readonly watchThresholdDays;
+    private readonly reviewThresholdDays;
+    private readonly l1Cap;
+    constructor(opts: PruningReadModelOptions);
+    /**
+     * Build per-principle signals for the current workspace ledger.
+     *
+     * Reads:
+     *   - .state/principle_training_state.json (ledger)
+     *   - .pd/state.db principle_candidates (candidate table)
+     *
+     * Returns one signal per ledger principle entry.
+     */
+    getPrincipleSignals(): PrinciplePruningSignal[];
+    /**
+     * Build aggregate pruning health summary.
+     * Reuses getPrincipleSignals() to avoid duplicate DB queries.
+     */
+    getHealthSummary(): PruningHealthSummary;
+    getOrphanDerivedCandidates(): OrphanDetectionResult;
+}
+export interface RemovedOrphanReference {
+    principleId: string;
+    removedIds: string[];
+}
+export declare function removeOrphanReferencesFromLedger(stateDir: string, orphanIdsByPrinciple: Map<string, Set<string>>): RemovedOrphanReference[];
+//# sourceMappingURL=pruning-read-model.d.ts.map

package/dist/runtime-v2/pruning-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruning-read-model.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/pruning-read-model.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAC/F,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B,EAAE,MAAM,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,EAAE,uBAAuB;IAQzC;;;;;;;;OAQG;IACH,mBAAmB,IAAI,sBAAsB,EAAE;IA0F/C;;;OAGG;IACH,gBAAgB,IAAI,oBAAoB;IA6BxC,0BAA0B,IAAI,qBAAqB;CAoDpD;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAC7C,sBAAsB,EAAE,CA0B1B"}

package/dist/runtime-v2/pruning-read-model.js

@@ -0,0 +1,266 @@
+/**
+ * PruningReadModel — non-destructive read model for principle lifecycle signals.
+ *
+ * PRI-15: Dynamic pruning metrics and read model.
+ *
+ * This model reads from the ledger and candidates table to produce
+ * actionable signals for principle health, without writing anything.
+ * All rules are deterministic and based on available metadata only.
+ *
+ * Non-goals:
+ * - No automatic pruning or demotion
+ * - No ledger writes
+ * - No state changes
+ * - No background workers
+ */
+import * as path from 'path';
+import * as fs from 'fs';
+import Database from 'better-sqlite3';
+import { loadLedger, saveLedger } from '../principle-tree-ledger.js';
+import { DEFAULT_L1_HARD_CAP, validateL1CapConfig } from './l1-hard-cap.js';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function daysBetween(dateA, dateB) {
+    const a = typeof dateA === 'string' ? new Date(dateA).getTime() : dateA;
+    const b = typeof dateB === 'number' ? dateB : dateB.getTime();
+    if (isNaN(a))
+        return 9999;
+    return Math.max(0, Math.round((b - a) / (1000 * 60 * 60 * 24)));
+}
+function computeRiskLevel(ageDays, derivedPainCount, opts) {
+    if (ageDays >= opts.reviewThresholdDays && derivedPainCount === 0) {
+        return 'review';
+    }
+    if (ageDays >= opts.watchThresholdDays && derivedPainCount === 0) {
+        return 'watch';
+    }
+    return 'none';
+}
+function buildReasons(ageDays, derivedPainCount, params) {
+    const reasons = [];
+    const { matchedCandidateCount, recentCandCount, orphanCandCount, status } = params;
+    const opts = { watchThresholdDays: params.watchThresholdDays, reviewThresholdDays: params.reviewThresholdDays };
+    if (ageDays >= opts.reviewThresholdDays && derivedPainCount === 0) {
+        reasons.push(`review: principle older than ${opts.reviewThresholdDays} days with no derived pain signals [source: createdAt + derivedFromPainIds]`);
+    }
+    else if (ageDays >= opts.watchThresholdDays && derivedPainCount === 0) {
+        reasons.push(`watch: principle older than ${opts.watchThresholdDays} days with no recent derived pain signals [source: createdAt + derivedFromPainIds]`);
+    }
+    if (status === 'probation') {
+        reasons.push('status: principle is in probation status [source: ledger.status]');
+    }
+    if (orphanCandCount > 0) {
+        reasons.push(`orphan: ${orphanCandCount} derived candidate(s) not found in candidates table [source: derivedFromPainIds + state.db]`);
+    }
+    if (derivedPainCount > 0 && matchedCandidateCount === 0) {
+        reasons.push('gap: derived pain signals exist but no matched candidates in DB [source: derivedFromPainIds + state.db]');
+    }
+    if (recentCandCount > 0 && derivedPainCount === 0) {
+        reasons.push('stale: recent candidates exist but none derived from pain signals [source: candidates.createdAt]');
+    }
+    if (status === 'deprecated' || status === 'archived') {
+        reasons.push(`status: principle is ${status} [source: ledger.status]`);
+    }
+    return reasons;
+}
+// ── Main Class ────────────────────────────────────────────────────────────────
+export class PruningReadModel {
+    workspaceDir;
+    watchThresholdDays;
+    reviewThresholdDays;
+    l1Cap;
+    constructor(opts) {
+        this.workspaceDir = opts.workspaceDir;
+        this.watchThresholdDays = opts.watchThresholdDays ?? 30;
+        this.reviewThresholdDays = opts.reviewThresholdDays ?? 90;
+        this.l1Cap = opts.l1Cap ?? DEFAULT_L1_HARD_CAP;
+        validateL1CapConfig({ hardCap: this.l1Cap });
+    }
+    /**
+     * Build per-principle signals for the current workspace ledger.
+     *
+     * Reads:
+     *   - .state/principle_training_state.json (ledger)
+     *   - .pd/state.db principle_candidates (candidate table)
+     *
+     * Returns one signal per ledger principle entry.
+     */
+    getPrincipleSignals() {
+        const now = new Date();
+        const stateDir = path.join(this.workspaceDir, '.state');
+        const ledger = loadLedger(stateDir);
+        const principleEntries = Object.values(ledger.tree.principles);
+        if (principleEntries.length === 0) {
+            return [];
+        }
+        const candidateCreatedAtMap = new Map();
+        const allCandidateIdSet = new Set();
+        const pdDbPath = path.join(this.workspaceDir, '.pd', 'state.db');
+        try {
+            if (fs.existsSync(pdDbPath)) {
+                const db = new Database(pdDbPath, { readonly: true });
+                try {
+                    const allRows = db.prepare('SELECT candidate_id, status, created_at FROM principle_candidates').all();
+                    for (const r of allRows) {
+                        allCandidateIdSet.add(r.candidate_id);
+                        if (r.status === 'consumed') {
+                            candidateCreatedAtMap.set(r.candidate_id, r.created_at);
+                        }
+                    }
+                }
+                finally {
+                    db.close();
+                }
+            }
+        }
+        catch {
+            // Graceful degradation — candidate map stays empty
+        }
+        const thirtyDaysMs = 30 * 24 * 60 * 60 * 1000;
+        const recentCutoff = new Date(now.getTime() - thirtyDaysMs).toISOString();
+        return principleEntries.map((p) => {
+            const derivedPainCount = p.derivedFromPainIds?.length ?? 0;
+            let matchedCandidateCount = 0;
+            let recentCandidateCount = 0;
+            let orphanCandidateCount = 0;
+            for (const cid of p.derivedFromPainIds ?? []) {
+                if (allCandidateIdSet.has(cid)) {
+                    matchedCandidateCount++;
+                    const cAt = candidateCreatedAtMap.get(cid);
+                    if (cAt && cAt >= recentCutoff)
+                        recentCandidateCount++;
+                }
+                else {
+                    orphanCandidateCount++;
+                }
+            }
+            const ageDays = daysBetween(p.createdAt, now);
+            const riskLevel = computeRiskLevel(ageDays, derivedPainCount, {
+                watchThresholdDays: this.watchThresholdDays,
+                reviewThresholdDays: this.reviewThresholdDays,
+            });
+            const reasons = buildReasons(ageDays, derivedPainCount, {
+                matchedCandidateCount,
+                recentCandCount: recentCandidateCount,
+                orphanCandCount: orphanCandidateCount,
+                status: p.status,
+                watchThresholdDays: this.watchThresholdDays,
+                reviewThresholdDays: this.reviewThresholdDays,
+            });
+            return {
+                principleId: p.id,
+                status: p.status,
+                createdAt: p.createdAt,
+                updatedAt: p.updatedAt ?? p.createdAt,
+                derivedCandidateIds: [...(p.derivedFromPainIds ?? [])],
+                derivedPainCount,
+                matchedCandidateCount,
+                recentCandidateCount,
+                orphanCandidateCount,
+                ageDays,
+                riskLevel,
+                reasons,
+            };
+        });
+    }
+    /**
+     * Build aggregate pruning health summary.
+     * Reuses getPrincipleSignals() to avoid duplicate DB queries.
+     */
+    getHealthSummary() {
+        const now = new Date();
+        const signals = this.getPrincipleSignals();
+        const byStatus = {};
+        let totalAgeDays = 0;
+        let orphanDerivedCandidateCount = 0;
+        for (const s of signals) {
+            byStatus[s.status] = (byStatus[s.status] ?? 0) + 1;
+            totalAgeDays += s.ageDays;
+            orphanDerivedCandidateCount += s.orphanCandidateCount;
+        }
+        return {
+            totalPrinciples: signals.length,
+            byStatus,
+            watchCount: signals.filter((s) => s.riskLevel === 'watch').length,
+            reviewCount: signals.filter((s) => s.riskLevel === 'review').length,
+            orphanDerivedCandidateCount,
+            averageAgeDays: signals.length > 0
+                ? Math.round(totalAgeDays / signals.length)
+                : 0,
+            activeL1Count: byStatus.active ?? 0,
+            l1Cap: this.l1Cap,
+            generatedAt: now.toISOString(),
+        };
+    }
+    getOrphanDerivedCandidates() {
+        const stateDir = path.join(this.workspaceDir, '.state');
+        const ledger = loadLedger(stateDir);
+        const principleEntries = Object.values(ledger.tree.principles);
+        if (principleEntries.length === 0) {
+            return { candidates: [], dbReadable: true };
+        }
+        const allCandidateIds = new Set();
+        let dbReadable = true;
+        const pdDbPath = path.join(this.workspaceDir, '.pd', 'state.db');
+        try {
+            if (fs.existsSync(pdDbPath)) {
+                const db = new Database(pdDbPath, { readonly: true });
+                try {
+                    const rows = db.prepare('SELECT candidate_id FROM principle_candidates').all();
+                    for (const r of rows) {
+                        allCandidateIds.add(r.candidate_id);
+                    }
+                }
+                finally {
+                    db.close();
+                }
+            }
+            else {
+                dbReadable = false;
+            }
+        }
+        catch {
+            dbReadable = false;
+        }
+        const orphans = [];
+        for (const p of principleEntries) {
+            for (const cid of p.derivedFromPainIds ?? []) {
+                if (!allCandidateIds.has(cid)) {
+                    orphans.push({
+                        candidateId: cid,
+                        principleId: p.id,
+                        reason: dbReadable
+                            ? 'candidate not found in state.db'
+                            : 'candidate not verifiable: state.db unreadable',
+                        sourceRef: 'derivedFromPainIds',
+                        status: p.status,
+                    });
+                }
+            }
+        }
+        return { candidates: orphans, dbReadable };
+    }
+}
+export function removeOrphanReferencesFromLedger(stateDir, orphanIdsByPrinciple) {
+    const ledger = loadLedger(stateDir);
+    const nextLedger = JSON.parse(JSON.stringify(ledger));
+    const removedFromPrinciples = [];
+    for (const [principleId, orphanIds] of orphanIdsByPrinciple) {
+        const entry = nextLedger.tree.principles[principleId];
+        if (!entry)
+            continue;
+        const originalIds = entry.derivedFromPainIds ?? [];
+        const filteredIds = originalIds.filter((id) => !orphanIds.has(id));
+        if (filteredIds.length !== originalIds.length) {
+            entry.derivedFromPainIds = filteredIds;
+            removedFromPrinciples.push({
+                principleId,
+                removedIds: originalIds.filter((id) => orphanIds.has(id)),
+            });
+        }
+    }
+    if (removedFromPrinciples.length > 0) {
+        saveLedger(stateDir, nextLedger);
+    }
+    return removedFromPrinciples;
+}
+//# sourceMappingURL=pruning-read-model.js.map

package/dist/runtime-v2/pruning-read-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruning-read-model.js","sourceRoot":"","sources":["../../src/runtime-v2/pruning-read-model.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/pruning-review-log.d.ts

@@ -0,0 +1,41 @@
+import type { PrinciplePruningSignal } from './pruning-read-model.js';
+export type PruningReviewDecision = 'keep' | 'defer' | 'archive-candidate';
+export interface PruningReviewRecord {
+    reviewId: string;
+    principleId: string;
+    decision: PruningReviewDecision;
+    note: string;
+    reviewer: string;
+    reviewedAt: string;
+    signalSnapshot: PrinciplePruningSignal;
+}
+export interface AppendPruningReviewInput {
+    principleId: string;
+    decision: PruningReviewDecision;
+    note?: string;
+    reviewer?: string;
+    /**
+     * Snapshot of the principle's pruning signal at the time of review.
+     * Optional — rollback operations may not have a live signal available.
+     */
+    signalSnapshot?: PruningReviewRecord['signalSnapshot'];
+}
+/**
+ * Append a pruning review record to the audit log.
+ *
+ * @param workspaceDir - The workspace root directory
+ * @param input - Review decision input
+ * @returns The full record that was written
+ */
+export declare function appendPruningReview(workspaceDir: string, input: AppendPruningReviewInput): PruningReviewRecord;
+/**
+ * List pruning review records from the audit log.
+ *
+ * @param workspaceDir - The workspace root directory
+ * @param filter - Optional filter by principleId
+ * @returns Array of review records (oldest first)
+ */
+export declare function listPruningReviews(workspaceDir: string, filter?: {
+    principleId?: string;
+}): PruningReviewRecord[];
+//# sourceMappingURL=pruning-review-log.d.ts.map

package/dist/runtime-v2/pruning-review-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruning-review-log.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/pruning-review-log.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAItE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;CACxD;AAyBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CAqCrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,mBAAmB,EAAE,CA0BvB"}

package/dist/runtime-v2/pruning-review-log.js

@@ -0,0 +1,106 @@
+/**
+ * PruningReviewLog — append-only JSONL audit log for human pruning review decisions.
+ *
+ * PRI-24: Add pruning review audit log.
+ *
+ * Storage: <workspace>/.state/pruning_reviews.jsonl
+ * Each line is one complete JSON record.
+ *
+ * Non-goals:
+ * - Does not modify ledger or state.db
+ * - Does not implement automatic pruning
+ * - Does not provide CLI (that's PRI-25)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+// ── Validation ─────────────────────────────────────────────────────────────────
+const VALID_DECISIONS = new Set(['keep', 'defer', 'archive-candidate']);
+function validateDecision(decision) {
+    if (!VALID_DECISIONS.has(decision)) {
+        throw new Error(`Invalid decision: '${decision}'. Must be one of: keep, defer, archive-candidate`);
+    }
+}
+// ── Core Functions ─────────────────────────────────────────────────────────────
+function getLogPath(workspaceDir) {
+    return path.join(workspaceDir, '.state', 'pruning_reviews.jsonl');
+}
+function ensureStateDir(workspaceDir) {
+    const stateDir = path.join(workspaceDir, '.state');
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+}
+/**
+ * Append a pruning review record to the audit log.
+ *
+ * @param workspaceDir - The workspace root directory
+ * @param input - Review decision input
+ * @returns The full record that was written
+ */
+export function appendPruningReview(workspaceDir, input) {
+    validateDecision(input.decision);
+    ensureStateDir(workspaceDir);
+    const reviewId = crypto.randomUUID();
+    const reviewedAt = new Date().toISOString();
+    const reviewer = input.reviewer ?? 'operator';
+    const record = {
+        reviewId,
+        principleId: input.principleId,
+        decision: input.decision,
+        note: input.note ?? '',
+        reviewer,
+        reviewedAt,
+        signalSnapshot: input.signalSnapshot ?? {
+            principleId: input.principleId,
+            status: 'active',
+            createdAt: reviewedAt,
+            updatedAt: reviewedAt,
+            derivedCandidateIds: [],
+            derivedPainCount: 0,
+            matchedCandidateCount: 0,
+            recentCandidateCount: 0,
+            orphanCandidateCount: 0,
+            ageDays: 0,
+            riskLevel: 'watch',
+            reasons: ['rollback: no signal snapshot available'],
+        },
+    };
+    const logPath = getLogPath(workspaceDir);
+    const line = JSON.stringify(record) + '\n';
+    fs.appendFileSync(logPath, line, 'utf-8');
+    return record;
+}
+/**
+ * List pruning review records from the audit log.
+ *
+ * @param workspaceDir - The workspace root directory
+ * @param filter - Optional filter by principleId
+ * @returns Array of review records (oldest first)
+ */
+export function listPruningReviews(workspaceDir, filter) {
+    const logPath = getLogPath(workspaceDir);
+    if (!fs.existsSync(logPath)) {
+        return [];
+    }
+    const content = fs.readFileSync(logPath, 'utf-8');
+    const lines = content.split('\n');
+    const records = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const record = JSON.parse(trimmed);
+            if (filter?.principleId && record.principleId !== filter.principleId) {
+                continue;
+            }
+            records.push(record);
+        }
+        catch {
+            // Skip corrupt lines — continue processing
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=pruning-review-log.js.map

package/dist/runtime-v2/pruning-review-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruning-review-log.js","sourceRoot":"","sources":["../../src/runtime-v2/pruning-review-log.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/recovery-sweep-service.d.ts

@@ -0,0 +1,14 @@
+import type { RecoveryResult } from './store/lifecycle/recovery-sweep.js';
+export interface RecoverySweepService {
+    detectExpiredLeases(): Promise<string[]>;
+    recoverTask(taskId: string): Promise<RecoveryResult | null>;
+    close(): Promise<void>;
+}
+export interface RecoverySweepServiceHandle {
+    service: RecoverySweepService;
+    close: () => Promise<void>;
+}
+export declare function createRecoverySweepService(opts: {
+    workspaceDir: string;
+}): Promise<RecoverySweepServiceHandle>;
+//# sourceMappingURL=recovery-sweep-service.d.ts.map

package/dist/runtime-v2/recovery-sweep-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-sweep-service.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/recovery-sweep-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAmBD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAOrC"}

package/dist/runtime-v2/recovery-sweep-service.js

@@ -0,0 +1,26 @@
+import { createRuntimeStateHandle } from './runtime-state-handle.js';
+class RecoverySweepServiceImpl {
+    stateManager;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    async detectExpiredLeases() {
+        return this.stateManager.detectExpiredLeases();
+    }
+    async recoverTask(taskId) {
+        return this.stateManager.recoverTask(taskId);
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    async close() {
+        // No-op: RuntimeStateManager lifecycle managed by handle
+    }
+}
+export async function createRecoverySweepService(opts) {
+    const handle = await createRuntimeStateHandle({ workspaceDir: opts.workspaceDir });
+    const service = new RecoverySweepServiceImpl(handle.stateManager);
+    return {
+        service,
+        close: handle.close,
+    };
+}
+//# sourceMappingURL=recovery-sweep-service.js.map

package/dist/runtime-v2/recovery-sweep-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-sweep-service.js","sourceRoot":"","sources":["../../src/runtime-v2/recovery-sweep-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAerE,MAAM,wBAAwB;IACC;IAA7B,YAA6B,YAAgD;QAAhD,iBAAY,GAAZ,YAAY,CAAoC;IAAG,CAAC;IAEjF,KAAK,CAAC,mBAAmB;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,KAAK;QACT,yDAAyD;IAC3D,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClE,OAAO;QACL,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/runtime-v2/remediation-contract.d.ts

@@ -0,0 +1,46 @@
+export type RemediationMode = 'dry_run' | 'confirm';
+export type RemediationStatus = 'would_change' | 'changed' | 'no_op' | 'refused' | 'error';
+export interface RemediationAction {
+    action: string;
+    targetId: string;
+    previousState?: string;
+    nextState?: string;
+    reason: string;
+    /**
+     * Legacy command-specific fields are retained during PRI-105 migration so
+     * existing operator consumers do not lose detail while the shared contract
+     * becomes the canonical top-level shape.
+     */
+    taskId?: string;
+    type?: string;
+    severity?: 'error' | 'warning';
+    previousStatus?: string;
+    newStatus?: string;
+    recommendedAction?: string;
+    successorTaskId?: string;
+}
+export interface RemediationResult {
+    mode: RemediationMode;
+    status: RemediationStatus;
+    safeToConfirm: boolean;
+    repairedCount: number;
+    skippedCount: number;
+    actions: RemediationAction[];
+    warnings: string[];
+    generatedAt?: string;
+    dryRun?: boolean;
+}
+export interface CreateRemediationResultInput {
+    mode: RemediationMode;
+    repairedCount?: number;
+    skippedCount?: number;
+    actions?: RemediationAction[];
+    warnings?: string[];
+    status?: RemediationStatus;
+    safeToConfirm?: boolean;
+    generatedAt?: string;
+    includeLegacyDryRun?: boolean;
+}
+export declare function createRemediationResult(input: CreateRemediationResultInput): RemediationResult;
+export declare function remediationAction(input: RemediationAction): RemediationAction;
+//# sourceMappingURL=remediation-contract.d.ts.map

package/dist/runtime-v2/remediation-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remediation-contract.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/remediation-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAaD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,iBAAiB,CAqB9F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAE7E"}

package/dist/runtime-v2/remediation-contract.js

@@ -0,0 +1,29 @@
+function deriveRemediationStatus(mode, repairedCount, actions) {
+    if (mode === 'dry_run') {
+        return actions.length > 0 ? 'would_change' : 'no_op';
+    }
+    return repairedCount > 0 ? 'changed' : 'no_op';
+}
+export function createRemediationResult(input) {
+    const actions = input.actions ?? [];
+    const warnings = input.warnings ?? [];
+    const repairedCount = input.repairedCount ?? 0;
+    const skippedCount = input.skippedCount ?? 0;
+    const status = input.status ?? deriveRemediationStatus(input.mode, repairedCount, actions);
+    const safeToConfirm = input.safeToConfirm ?? (input.mode === 'dry_run' && status === 'would_change' && warnings.length === 0);
+    return {
+        mode: input.mode,
+        status,
+        safeToConfirm,
+        repairedCount,
+        skippedCount,
+        actions,
+        warnings,
+        ...(input.generatedAt ? { generatedAt: input.generatedAt } : {}),
+        ...(input.includeLegacyDryRun ? { dryRun: input.mode === 'dry_run' } : {}),
+    };
+}
+export function remediationAction(input) {
+    return input;
+}
+//# sourceMappingURL=remediation-contract.js.map