@vibe-validate/history 0.14.3 → 0.15.0-rc.2

package/README.md

@@ -108,14 +108,14 @@ const config: HistoryConfig = {
   enabled: true,
 
   gitNotes: {
-    ref: 'vibe-validate/runs',  // Git notes ref namespace
-    maxRunsPerTree: 10,          // Keep last 10 runs per tree
-    maxOutputBytes: 10000,       // 10KB max per step output
+    ref: 'vibe-validate/validate',  // Git notes ref namespace (v0.15.0: changed from 'runs')
+    maxRunsPerTree: 10,             // Keep last 10 runs per tree
+    maxOutputBytes: 10000,          // 10KB max per step output
   },
 
   retention: {
-    warnAfterDays: 90,           // Warn about notes >90 days old
-    warnAfterCount: 100,         // Warn when >100 tree hashes
+    warnAfterDays: 30,              // Warn about notes >30 days old (v0.15.0: was 90)
+    warnAfterCount: 1000,           // Warn when >1000 tree hashes (v0.15.0: was 100, adjusted for run caching)
   },
 };
 ```

package/dist/index.d.ts

@@ -3,11 +3,12 @@
  *
  * @packageDocumentation
  */
-export type { ValidationRun, HistoryNote, RecordResult, StabilityCheck, HistoryConfig, HealthCheckResult, PruneResult, } from './types.js';
+export type { ValidationRun, HistoryNote, RecordResult, StabilityCheck, HistoryConfig, HealthCheckResult, PruneResult, RunCacheNote, } from './types.js';
 export { DEFAULT_HISTORY_CONFIG } from './types.js';
 export { recordValidationHistory, checkWorktreeStability, } from './recorder.js';
 export { readHistoryNote, listHistoryTreeHashes, getAllHistoryNotes, hasHistoryForTree, } from './reader.js';
-export { pruneHistoryByAge, pruneAllHistory } from './pruner.js';
+export { listRunCacheEntries, getRunCacheEntry, getAllRunCacheForTree, listRunCacheTreeHashes, getAllRunCacheEntries, type RunCacheEntryMeta, } from './run-cache-reader.js';
+export { pruneHistoryByAge, pruneAllHistory, pruneLegacyNotes, pruneAllRunCache } from './pruner.js';
 export { checkHistoryHealth } from './health-check.js';
 export { truncateValidationOutput } from './truncate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGrG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -8,8 +8,10 @@ export { DEFAULT_HISTORY_CONFIG } from './types.js';
 export { recordValidationHistory, checkWorktreeStability, } from './recorder.js';
 // Reader
 export { readHistoryNote, listHistoryTreeHashes, getAllHistoryNotes, hasHistoryForTree, } from './reader.js';
+// Run cache reader
+export { listRunCacheEntries, getRunCacheEntry, getAllRunCacheForTree, listRunCacheTreeHashes, getAllRunCacheEntries, } from './run-cache-reader.js';
 // Pruner
-export { pruneHistoryByAge, pruneAllHistory } from './pruner.js';
+export { pruneHistoryByAge, pruneAllHistory, pruneLegacyNotes, pruneAllRunCache } from './pruner.js';
 // Health check
 export { checkHistoryHealth } from './health-check.js';
 // Truncate

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,WAAW;AACX,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,WAAW;AACX,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,WAAW;AACX,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErG,eAAe;AACf,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,WAAW;AACX,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/pruner.d.ts

@@ -19,4 +19,21 @@ export declare function pruneHistoryByAge(olderThanDays: number, config?: Histor
  * @returns Prune result
  */
 export declare function pruneAllHistory(config?: HistoryConfig, dryRun?: boolean): Promise<PruneResult>;
+/**
+ * Clean up legacy git notes from pre-0.15.0 versions
+ *
+ * Removes notes from the old `refs/notes/vibe-validate/runs` namespace.
+ * Safe to call - only removes if legacy notes exist.
+ *
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export declare function pruneLegacyNotes(dryRun?: boolean): Promise<PruneResult>;
+/**
+ * Prune all run cache entries
+ *
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export declare function pruneAllRunCache(dryRun?: boolean): Promise<PruneResult>;
 //# sourceMappingURL=pruner.d.ts.map

package/dist/pruner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pruner.d.ts","sourceRoot":"","sources":["../src/pruner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW7D;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,aAAkB,EAC1B,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CAsDtB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,aAAkB,EAC1B,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CAwCtB"}
+{"version":3,"file":"pruner.d.ts","sourceRoot":"","sources":["../src/pruner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAY7D;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,aAAkB,EAC1B,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CAsDtB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,GAAE,aAAkB,EAC1B,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CAwCtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCpF;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAgCpF"}

package/dist/pruner.js

@@ -4,6 +4,7 @@
 import { execSync } from 'node:child_process';
 import { DEFAULT_HISTORY_CONFIG } from './types.js';
 import { getAllHistoryNotes } from './reader.js';
+import { listRunCacheTreeHashes, getAllRunCacheForTree } from './run-cache-reader.js';
 const GIT_TIMEOUT = 30000;
 const GIT_OPTIONS = {
     encoding: 'utf8',
@@ -104,4 +105,77 @@ export async function pruneAllHistory(config = {}, dryRun = false) {
         prunedTreeHashes,
     };
 }
+/**
+ * Clean up legacy git notes from pre-0.15.0 versions
+ *
+ * Removes notes from the old `refs/notes/vibe-validate/runs` namespace.
+ * Safe to call - only removes if legacy notes exist.
+ *
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export async function pruneLegacyNotes(dryRun = false) {
+    const legacyRef = 'vibe-validate/runs';
+    let notesPruned = 0;
+    let runsPruned = 0;
+    const prunedTreeHashes = [];
+    try {
+        const allNotes = await getAllHistoryNotes(legacyRef);
+        for (const note of allNotes) {
+            if (!dryRun) {
+                try {
+                    execSync(`git notes --ref=${legacyRef} remove ${note.treeHash}`, { ...GIT_OPTIONS, stdio: 'ignore' });
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+            notesPruned++;
+            runsPruned += note.runs?.length ?? 0;
+            prunedTreeHashes.push(note.treeHash);
+        }
+    }
+    catch {
+        // No legacy notes found - that's fine
+    }
+    return {
+        notesPruned,
+        runsPruned,
+        notesRemaining: 0,
+        prunedTreeHashes,
+    };
+}
+/**
+ * Prune all run cache entries
+ *
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export async function pruneAllRunCache(dryRun = false) {
+    const treeHashes = await listRunCacheTreeHashes();
+    let notesPruned = 0;
+    const prunedTreeHashes = [];
+    for (const treeHash of treeHashes) {
+        const entries = await getAllRunCacheForTree(treeHash);
+        if (entries.length > 0) {
+            if (!dryRun) {
+                try {
+                    // Delete all run cache notes under this tree hash
+                    execSync(`git for-each-ref --format="%(refname)" refs/notes/vibe-validate/run/${treeHash}/ | xargs -I {} git update-ref -d {}`, { ...GIT_OPTIONS, stdio: 'ignore' });
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+            notesPruned += entries.length;
+            prunedTreeHashes.push(treeHash);
+        }
+    }
+    return {
+        notesPruned,
+        runsPruned: notesPruned, // For run cache, each note is one cached command
+        notesRemaining: 0,
+        prunedTreeHashes,
+    };
+}
 //# sourceMappingURL=pruner.js.map

package/dist/pruner.js.map

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

package/dist/reader.d.ts

@@ -6,21 +6,21 @@ import type { HistoryNote } from './types.js';
  * Read validation history note for a tree hash
  *
  * @param treeHash - Git tree hash
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns History note or null if not found
  */
 export declare function readHistoryNote(treeHash: string, notesRef?: string): Promise<HistoryNote | null>;
 /**
  * List all tree hashes with validation history
  *
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns Array of tree hashes with notes
  */
 export declare function listHistoryTreeHashes(notesRef?: string): Promise<string[]>;
 /**
  * Get all validation history notes
  *
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns Array of all history notes
  */
 export declare function getAllHistoryNotes(notesRef?: string): Promise<HistoryNote[]>;
@@ -28,7 +28,7 @@ export declare function getAllHistoryNotes(notesRef?: string): Promise<HistoryNo
  * Check if validation history exists for a tree hash
  *
  * @param treeHash - Git tree hash
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns True if history exists
  */
 export declare function hasHistoryForTree(treeHash: string, notesRef?: string): Promise<boolean>;

package/dist/reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAc7B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,OAAO,CAAC,CAGlB"}
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAiC,GAC1C,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA4C7B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,GAAE,MAAiC,GAC1C,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,GAAE,MAAiC,GAC1C,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAiC,GAC1C,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/reader.js

@@ -3,6 +3,7 @@
  */
 import { execSync } from 'node:child_process';
 import { parse as parseYaml } from 'yaml';
+import { safeValidateResult } from '@vibe-validate/core';
 const GIT_TIMEOUT = 30000;
 const GIT_OPTIONS = {
     encoding: 'utf8',
@@ -13,28 +14,53 @@ const GIT_OPTIONS = {
  * Read validation history note for a tree hash
  *
  * @param treeHash - Git tree hash
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns History note or null if not found
  */
-export async function readHistoryNote(treeHash, notesRef = 'vibe-validate/runs') {
+export async function readHistoryNote(treeHash, notesRef = 'vibe-validate/validate') {
     try {
         const yaml = execSync(`git notes --ref=${notesRef} show ${treeHash}`, GIT_OPTIONS);
-        const note = parseYaml(yaml);
-        return note;
+        const parsed = parseYaml(yaml);
+        // Validate as HistoryNote structure
+        if (!parsed || typeof parsed !== 'object' || !('runs' in parsed) || !Array.isArray(parsed.runs)) {
+            console.warn(`Invalid history note structure for ${treeHash} - missing runs array`);
+            return null;
+        }
+        // Validate each ValidationResult in runs array using safe validation
+        const validatedRuns = [];
+        for (const run of parsed.runs) {
+            if (!run.result) {
+                console.warn(`Run ${run.id} missing result field - skipping`);
+                continue;
+            }
+            const validationResult = safeValidateResult(run.result);
+            if (!validationResult.success) {
+                console.warn(`Invalid ValidationResult in run ${run.id}:`, validationResult.errors);
+                console.warn('Skipping corrupted run entry');
+                continue;
+            }
+            validatedRuns.push({
+                ...run,
+                result: validationResult.data,
+            });
+        }
+        return {
+            treeHash: parsed.treeHash ?? treeHash,
+            runs: validatedRuns,
+        };
     }
-    catch (error) {
+    catch {
         // Note doesn't exist - this is expected for first-time validation
-        console.debug(`No history note for ${treeHash}: ${error instanceof Error ? error.message : String(error)}`);
         return null;
     }
 }
 /**
  * List all tree hashes with validation history
  *
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns Array of tree hashes with notes
  */
-export async function listHistoryTreeHashes(notesRef = 'vibe-validate/runs') {
+export async function listHistoryTreeHashes(notesRef = 'vibe-validate/validate') {
     try {
         const output = execSync(`git notes --ref=${notesRef} list`, GIT_OPTIONS);
         if (!output.trim()) {
@@ -51,19 +77,18 @@ export async function listHistoryTreeHashes(notesRef = 'vibe-validate/runs') {
             .filter(Boolean);
         return treeHashes;
     }
-    catch (error) {
+    catch {
         // No notes exist yet - expected for new repos
-        console.debug(`No history notes found: ${error instanceof Error ? error.message : String(error)}`);
         return [];
     }
 }
 /**
  * Get all validation history notes
  *
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns Array of all history notes
  */
-export async function getAllHistoryNotes(notesRef = 'vibe-validate/runs') {
+export async function getAllHistoryNotes(notesRef = 'vibe-validate/validate') {
     const treeHashes = await listHistoryTreeHashes(notesRef);
     const notes = [];
     for (const treeHash of treeHashes) {
@@ -78,10 +103,10 @@ export async function getAllHistoryNotes(notesRef = 'vibe-validate/runs') {
  * Check if validation history exists for a tree hash
  *
  * @param treeHash - Git tree hash
- * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @param notesRef - Git notes ref (default: vibe-validate/validate)
  * @returns True if history exists
  */
-export async function hasHistoryForTree(treeHash, notesRef = 'vibe-validate/runs') {
+export async function hasHistoryForTree(treeHash, notesRef = 'vibe-validate/validate') {
     const note = await readHistoryNote(treeHash, notesRef);
     return note !== null;
 }

package/dist/reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"reader.js","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAA+B;CAChE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,WAAmB,oBAAoB;IAEvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CACnB,mBAAmB,QAAQ,SAAS,QAAQ,EAAE,EAC9C,WAAW,CACZ,CAAC;QAEF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAgB,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kEAAkE;QAClE,OAAO,CAAC,KAAK,CAAC,uBAAuB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,oBAAoB;IAEvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,mBAAmB,QAAQ,OAAO,EAAE,WAAW,CAAC,CAAC;QAEzE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,0CAA0C;QAC1C,MAAM,UAAU,GAAG,MAAM;aACtB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY;QAC/B,CAAC,CAAC;aACD,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8CAA8C;QAC9C,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnG,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,oBAAoB;IAEvC,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,WAAmB,oBAAoB;IAEvC,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvD,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC"}
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"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"}

package/dist/run-cache-reader.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Run cache reader - Read run cache entries from git notes
+ *
+ * Run cache is stored at: refs/notes/vibe-validate/run/{treeHash}/{cacheKey}
+ * where cacheKey = encodeURIComponent(workdir ? `${workdir}:${command}` : command)
+ */
+import type { RunCacheNote } from './types.js';
+/**
+ * Entry metadata from git notes list
+ */
+export interface RunCacheEntryMeta {
+    treeHash: string;
+    cacheKey: string;
+    refPath: string;
+}
+/**
+ * List all run cache entries for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @returns Array of run cache entry metadata
+ */
+export declare function listRunCacheEntries(treeHash: string): Promise<RunCacheEntryMeta[]>;
+/**
+ * Get a specific run cache entry
+ *
+ * @param treeHash - Git tree hash
+ * @param cacheKey - URL-encoded cache key
+ * @returns Run cache note or null if not found
+ */
+export declare function getRunCacheEntry(treeHash: string, cacheKey: string): Promise<RunCacheNote | null>;
+/**
+ * Get all run cache entries for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @returns Array of all run cache notes for this tree hash
+ */
+export declare function getAllRunCacheForTree(treeHash: string): Promise<RunCacheNote[]>;
+/**
+ * List all tree hashes that have run cache entries
+ *
+ * @returns Array of tree hashes with run cache
+ */
+export declare function listRunCacheTreeHashes(): Promise<string[]>;
+/**
+ * Get all run cache entries across all tree hashes
+ *
+ * @returns Array of all run cache notes
+ */
+export declare function getAllRunCacheEntries(): Promise<RunCacheNote[]>;
+//# sourceMappingURL=run-cache-reader.d.ts.map

package/dist/run-cache-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cache-reader.d.ts","sourceRoot":"","sources":["../src/run-cache-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqCxF;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAYrF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BhE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAarE"}

package/dist/run-cache-reader.js

@@ -0,0 +1,136 @@
+/**
+ * Run cache reader - Read run cache entries from git notes
+ *
+ * Run cache is stored at: refs/notes/vibe-validate/run/{treeHash}/{cacheKey}
+ * where cacheKey = encodeURIComponent(workdir ? `${workdir}:${command}` : command)
+ */
+import { execSync } from 'node:child_process';
+import { parse as parseYaml } from 'yaml';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * List all run cache entries for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @returns Array of run cache entry metadata
+ */
+export async function listRunCacheEntries(treeHash) {
+    try {
+        // List all notes under refs/notes/vibe-validate/run/{treeHash}/*
+        const output = execSync(`git for-each-ref --format="%(refname) %(objectname)" refs/notes/vibe-validate/run/${treeHash}/`, GIT_OPTIONS);
+        if (!output.trim()) {
+            return [];
+        }
+        // Parse output: "refs/notes/vibe-validate/run/{treeHash}/{cacheKey} {noteObjectName}"
+        const entries = output
+            .trim()
+            .split('\n')
+            .map((line) => {
+            const [refPath] = line.split(' ');
+            // Extract cache key from ref path
+            const regex = /refs\/notes\/vibe-validate\/run\/([^/]+)\/(.+)$/;
+            const match = regex.exec(refPath);
+            if (!match)
+                return null;
+            const [, treeHashFromRef, cacheKey] = match;
+            return {
+                treeHash: treeHashFromRef,
+                cacheKey,
+                refPath,
+            };
+        })
+            .filter(Boolean);
+        return entries;
+    }
+    catch {
+        // No run cache exists - expected for tree hashes without run cache
+        return [];
+    }
+}
+/**
+ * Get a specific run cache entry
+ *
+ * @param treeHash - Git tree hash
+ * @param cacheKey - URL-encoded cache key
+ * @returns Run cache note or null if not found
+ */
+export async function getRunCacheEntry(treeHash, cacheKey) {
+    try {
+        const refPath = `vibe-validate/run/${treeHash}/${cacheKey}`;
+        const yaml = execSync(`git notes --ref=${refPath} show HEAD`, GIT_OPTIONS);
+        const note = parseYaml(yaml);
+        return note;
+    }
+    catch {
+        // Entry doesn't exist or parse failed
+        return null;
+    }
+}
+/**
+ * Get all run cache entries for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @returns Array of all run cache notes for this tree hash
+ */
+export async function getAllRunCacheForTree(treeHash) {
+    const entries = await listRunCacheEntries(treeHash);
+    const notes = [];
+    for (const entry of entries) {
+        const note = await getRunCacheEntry(entry.treeHash, entry.cacheKey);
+        if (note) {
+            notes.push(note);
+        }
+    }
+    return notes;
+}
+/**
+ * List all tree hashes that have run cache entries
+ *
+ * @returns Array of tree hashes with run cache
+ */
+export async function listRunCacheTreeHashes() {
+    try {
+        // List all notes under refs/notes/vibe-validate/run/
+        const output = execSync('git for-each-ref --format="%(refname)" refs/notes/vibe-validate/run/', GIT_OPTIONS);
+        if (!output.trim()) {
+            return [];
+        }
+        // Parse output and extract unique tree hashes
+        const treeHashes = new Set();
+        const lines = output.trim().split('\n');
+        for (const line of lines) {
+            // Extract tree hash from ref path: refs/notes/vibe-validate/run/{treeHash}/...
+            const regex = /refs\/notes\/vibe-validate\/run\/([^/]+)/;
+            const match = regex.exec(line);
+            if (match) {
+                treeHashes.add(match[1]);
+            }
+        }
+        return Array.from(treeHashes);
+    }
+    catch {
+        // No run cache exists - expected for repos without run cache
+        return [];
+    }
+}
+/**
+ * Get all run cache entries across all tree hashes
+ *
+ * @returns Array of all run cache notes
+ */
+export async function getAllRunCacheEntries() {
+    const treeHashes = await listRunCacheTreeHashes();
+    const allNotes = [];
+    for (const treeHash of treeHashes) {
+        const notes = await getAllRunCacheForTree(treeHash);
+        allNotes.push(...notes);
+    }
+    // Sort by timestamp (newest first)
+    allNotes.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    return allNotes;
+}
+//# sourceMappingURL=run-cache-reader.js.map

package/dist/run-cache-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cache-reader.js","sourceRoot":"","sources":["../src/run-cache-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAA+B;CAChE,CAAC;AAWF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,MAAM,GAAG,QAAQ,CACrB,qFAAqF,QAAQ,GAAG,EAChG,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,sFAAsF;QACtF,MAAM,OAAO,GAAG,MAAM;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,kCAAkC;YAClC,MAAM,KAAK,GAAG,iDAAiD,CAAC;YAChE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YAExB,MAAM,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;YAC5C,OAAO;gBACL,QAAQ,EAAE,eAAe;gBACzB,QAAQ;gBACR,OAAO;aACR,CAAC;QACJ,CAAC,CAAC;aACD,MAAM,CAAC,OAAO,CAAwB,CAAC;QAE1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,qBAAqB,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,mBAAmB,OAAO,YAAY,EAAE,WAAW,CAAC,CAAC;QAE3E,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAiB,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IAC1D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,IAAI,CAAC;QACH,qDAAqD;QACrD,MAAM,MAAM,GAAG,QAAQ,CACrB,sEAAsE,EACtE,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,+EAA+E;YAC/E,MAAM,KAAK,GAAG,0CAA0C,CAAC;YACzD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,EAAE,CAAC;gBACV,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,UAAU,GAAG,MAAM,sBAAsB,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3F,OAAO,QAAQ,CAAC;AAClB,CAAC"}