@vibe-validate/history 0.12.0

package/README.md

@@ -0,0 +1,239 @@
+# @vibe-validate/history
+
+Validation history tracking via git notes for vibe-validate.
+
+## Features
+
+- **Git Notes Storage**: Store validation results keyed by git tree hash
+- **Distributed Cache**: Remember validation for EVERY tree hash
+- **Worktree Stability Check**: Verify tree unchanged during validation
+- **Multi-Run Support**: Handle flaky tests, multiple branches at same tree
+- **Output Truncation**: Efficient storage (10KB max per step)
+- **Proactive Health**: Warn when pruning recommended
+- **Privacy-First**: Local by default, no auto-sharing
+
+## Installation
+
+```bash
+npm install @vibe-validate/history
+```
+
+## Usage
+
+### Record Validation History
+
+```typescript
+import { recordValidationHistory, checkWorktreeStability } from '@vibe-validate/history';
+import { getGitTreeHash } from '@vibe-validate/git';
+
+// Get tree hash before validation
+const treeHashBefore = await getGitTreeHash();
+
+// Run validation
+const result = await runValidation(config);
+
+// Check stability (did tree change during validation?)
+const stability = await checkWorktreeStability(treeHashBefore);
+
+if (!stability.stable) {
+  console.warn('⚠️  Worktree changed during validation - not caching');
+} else {
+  // Record to git notes
+  const recordResult = await recordValidationHistory(treeHashBefore, result);
+
+  if (recordResult.recorded) {
+    console.log('📝 History recorded');
+  }
+}
+```
+
+### Read Validation History
+
+```typescript
+import { readHistoryNote, listHistoryTreeHashes } from '@vibe-validate/history';
+
+// Read specific tree hash
+const note = await readHistoryNote('abc123def456...');
+
+if (note) {
+  console.log(`Found ${note.runs.length} validation runs for this tree`);
+
+  for (const run of note.runs) {
+    console.log(`- ${run.timestamp}: ${run.passed ? 'PASSED' : 'FAILED'}`);
+  }
+}
+
+// List all tree hashes with history
+const treeHashes = await listHistoryTreeHashes();
+console.log(`Total history: ${treeHashes.length} tree hashes`);
+```
+
+### Health Check
+
+```typescript
+import { checkHistoryHealth } from '@vibe-validate/history';
+
+const health = await checkHistoryHealth();
+
+if (health.shouldWarn) {
+  console.log(health.warningMessage);
+  // Example output:
+  // ℹ️  Validation history has grown large (127 tree hashes)
+  //    Found 15 notes older than 90 days
+  //    Consider pruning: vibe-validate history prune --older-than "90 days"
+}
+```
+
+### Prune Old History
+
+```typescript
+import { pruneHistoryByAge } from '@vibe-validate/history';
+
+// Prune notes older than 90 days (dry run)
+const dryRunResult = await pruneHistoryByAge(90, {}, true);
+console.log(`Would prune ${dryRunResult.notesPruned} notes`);
+
+// Actually prune
+const pruneResult = await pruneHistoryByAge(90);
+console.log(`Pruned ${pruneResult.notesPruned} notes`);
+console.log(`${pruneResult.notesRemaining} notes remaining`);
+```
+
+## Configuration
+
+```typescript
+import type { HistoryConfig } from '@vibe-validate/history';
+
+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
+  },
+
+  retention: {
+    warnAfterDays: 90,           // Warn about notes >90 days old
+    warnAfterCount: 100,         // Warn when >100 tree hashes
+  },
+};
+```
+
+## API Reference
+
+### Types
+
+- **ValidationRun**: Single validation run entry
+- **HistoryNote**: Git note structure (array of runs per tree)
+- **RecordResult**: Result of recording validation
+- **StabilityCheck**: Worktree stability check result
+- **HealthCheckResult**: History health check result
+- **PruneResult**: Result of pruning operation
+
+### Functions
+
+#### Recording
+- `recordValidationHistory(treeHash, result, config?)`: Record validation to git notes
+- `checkWorktreeStability(treeHashBefore)`: Check if tree changed during validation
+
+#### Reading
+- `readHistoryNote(treeHash, notesRef?)`: Read note for specific tree hash
+- `listHistoryTreeHashes(notesRef?)`: List all tree hashes with notes
+- `getAllHistoryNotes(notesRef?)`: Get all history notes
+- `hasHistoryForTree(treeHash, notesRef?)`: Check if history exists
+
+#### Pruning
+- `pruneHistoryByAge(olderThanDays, config?, dryRun?)`: Prune by age
+- `pruneAllHistory(config?, dryRun?)`: Prune all history
+
+#### Health
+- `checkHistoryHealth(config?)`: Check history health
+
+#### Utilities
+- `truncateValidationOutput(result, maxBytes?)`: Truncate validation output
+
+## Design
+
+### Git Tree Hash Caching
+
+Traditional validation caching (single state file):
+- Only remembers ONE tree hash
+- Switch branches → cache miss
+- Revert changes → cache miss
+
+Git notes caching (this package):
+- Remembers EVERY tree hash
+- Switch branches → cache hit (if tree unchanged)
+- Revert changes → cache hit
+- **Result**: Improved cache effectiveness
+
+### Note Structure
+
+```yaml
+# Git note: refs/notes/vibe-validate/runs → tree hash abc123
+treeHash: "abc123def456..."
+runs:
+  - id: "run-1729522215123"
+    timestamp: "2025-10-21T14:30:15.123Z"
+    duration: 2300
+    passed: true
+    branch: "feature/foo"
+    headCommit: "9abc3c4"
+    uncommittedChanges: false
+    result:
+      # Full validation result (output truncated to 10KB/step)
+```
+
+### Worktree Stability
+
+Critical safety feature: Verify tree unchanged during validation.
+
+```typescript
+// Before validation
+const treeHashBefore = await getGitTreeHash();
+
+// Run validation (potentially long-running)
+const result = await runValidation();
+
+// After validation - check stability
+const stability = await checkWorktreeStability(treeHashBefore);
+
+if (!stability.stable) {
+  // Tree changed during validation - don't cache
+  console.warn('⚠️  Worktree changed during validation');
+  return result; // Skip recording
+}
+
+// Safe to cache
+await recordValidationHistory(treeHashBefore, result);
+```
+
+## Privacy & Scope
+
+**Current Scope**: Local user validation caching only
+
+**What's recorded**:
+- ✅ Tree hash (content-based, no PII)
+- ✅ Timestamp
+- ✅ Branch name
+- ✅ HEAD commit
+- ✅ Validation results (truncated output)
+
+**What's NOT recorded** (privacy-first):
+- ❌ Author name/email (already in git history)
+- ❌ Machine hostname
+- ❌ Environment variables
+- ❌ File paths with usernames
+
+**Sharing**: Local by default (no auto-push to remote)
+
+## Future Extensions
+
+- Team sharing (opt-in)
+- Environment tracking (OS, Node version, CI matrix)
+- Analytics export (JSONL for SQLite/DuckDB analysis)
+
+## License
+
+MIT

package/dist/health-check.d.ts

@@ -0,0 +1,12 @@
+/**
+ * History health check utilities
+ */
+import type { HealthCheckResult, HistoryConfig } from './types.js';
+/**
+ * Check validation history health
+ *
+ * @param config - History configuration
+ * @returns Health check result
+ */
+export declare function checkHistoryHealth(config?: HistoryConfig): Promise<HealthCheckResult>;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../src/health-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAInE;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAkE5B"}

package/dist/health-check.js

@@ -0,0 +1,68 @@
+/**
+ * History health check utilities
+ */
+import { DEFAULT_HISTORY_CONFIG } from './types.js';
+import { getAllHistoryNotes } from './reader.js';
+/**
+ * Check validation history health
+ *
+ * @param config - History configuration
+ * @returns Health check result
+ */
+export async function checkHistoryHealth(config = {}) {
+    const mergedConfig = {
+        ...DEFAULT_HISTORY_CONFIG,
+        ...config,
+        retention: {
+            ...DEFAULT_HISTORY_CONFIG.retention,
+            ...config.retention,
+        },
+    };
+    // Type assertion safe: DEFAULT_HISTORY_CONFIG is Required<HistoryConfig>
+    const warnAfterDays = (mergedConfig.retention.warnAfterDays ?? DEFAULT_HISTORY_CONFIG.retention.warnAfterDays);
+    const warnAfterCount = (mergedConfig.retention.warnAfterCount ?? DEFAULT_HISTORY_CONFIG.retention.warnAfterCount);
+    const allNotes = await getAllHistoryNotes(mergedConfig.gitNotes?.ref || DEFAULT_HISTORY_CONFIG.gitNotes.ref);
+    const totalNotes = allNotes.length;
+    const cutoffTime = Date.now() - warnAfterDays * 24 * 60 * 60 * 1000;
+    let oldNotesCount = 0;
+    for (const note of allNotes) {
+        if (!note.runs || note.runs.length === 0) {
+            continue;
+        }
+        // Check oldest run
+        const oldestRun = note.runs[0];
+        const oldestTimestamp = new Date(oldestRun.timestamp).getTime();
+        if (oldestTimestamp < cutoffTime) {
+            oldNotesCount++;
+        }
+    }
+    // Determine if we should warn
+    const shouldWarnCount = totalNotes > warnAfterCount;
+    const shouldWarnAge = oldNotesCount > 0;
+    const shouldWarn = shouldWarnCount || shouldWarnAge;
+    let warningMessage;
+    if (shouldWarnCount && shouldWarnAge) {
+        warningMessage =
+            `ℹ️  Validation history has grown large (${totalNotes} tree hashes)\n` +
+                `   Found ${oldNotesCount} notes older than ${warnAfterDays} days\n` +
+                `   Consider pruning: vibe-validate history prune --older-than "${warnAfterDays} days"`;
+    }
+    else if (shouldWarnCount) {
+        warningMessage =
+            `ℹ️  Validation history has grown large (${totalNotes} tree hashes)\n` +
+                `   Consider pruning: vibe-validate history prune --older-than "${warnAfterDays} days"`;
+    }
+    else if (shouldWarnAge) {
+        warningMessage =
+            `ℹ️  Found validation history older than ${warnAfterDays} days\n` +
+                `   ${oldNotesCount} tree hashes can be pruned\n` +
+                `   Run: vibe-validate history prune --older-than "${warnAfterDays} days"`;
+    }
+    return {
+        totalNotes,
+        oldNotesCount,
+        shouldWarn,
+        warningMessage,
+    };
+}
+//# sourceMappingURL=health-check.js.map

package/dist/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../src/health-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAwB,EAAE;IAE1B,MAAM,YAAY,GAAG;QACnB,GAAG,sBAAsB;QACzB,GAAG,MAAM;QACT,SAAS,EAAE;YACT,GAAG,sBAAsB,CAAC,SAAS;YACnC,GAAG,MAAM,CAAC,SAAS;SACpB;KACF,CAAC;IAEF,yEAAyE;IACzE,MAAM,aAAa,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,aAAa,IAAI,sBAAsB,CAAC,SAAS,CAAC,aAAa,CAAW,CAAC;IACzH,MAAM,cAAc,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,cAAc,IAAI,sBAAsB,CAAC,SAAS,CAAC,cAAc,CAAW,CAAC;IAE5H,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,YAAY,CAAC,QAAQ,EAAE,GAAG,IAAI,sBAAsB,CAAC,QAAQ,CAAC,GAAG,CAClE,CAAC;IAEF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEpE,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,SAAS;QACX,CAAC;QAED,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAEhE,IAAI,eAAe,GAAG,UAAU,EAAE,CAAC;YACjC,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,eAAe,GAAG,UAAU,GAAG,cAAc,CAAC;IACpD,MAAM,aAAa,GAAG,aAAa,GAAG,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,eAAe,IAAI,aAAa,CAAC;IAEpD,IAAI,cAAkC,CAAC;IAEvC,IAAI,eAAe,IAAI,aAAa,EAAE,CAAC;QACrC,cAAc;YACZ,2CAA2C,UAAU,iBAAiB;gBACtE,YAAY,aAAa,qBAAqB,aAAa,SAAS;gBACpE,kEAAkE,aAAa,QAAQ,CAAC;IAC5F,CAAC;SAAM,IAAI,eAAe,EAAE,CAAC;QAC3B,cAAc;YACZ,2CAA2C,UAAU,iBAAiB;gBACtE,kEAAkE,aAAa,QAAQ,CAAC;IAC5F,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,cAAc;YACZ,2CAA2C,aAAa,SAAS;gBACjE,MAAM,aAAa,8BAA8B;gBACjD,qDAAqD,aAAa,QAAQ,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,UAAU;QACV,aAAa;QACb,UAAU;QACV,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation history tracking via git notes
+ *
+ * @packageDocumentation
+ */
+export type { ValidationRun, HistoryNote, RecordResult, StabilityCheck, HistoryConfig, HealthCheckResult, PruneResult, } 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 { checkHistoryHealth } from './health-check.js';
+export { truncateValidationOutput } from './truncate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * Validation history tracking via git notes
+ *
+ * @packageDocumentation
+ */
+export { DEFAULT_HISTORY_CONFIG } from './types.js';
+// Recorder
+export { recordValidationHistory, checkWorktreeStability, } from './recorder.js';
+// Reader
+export { readHistoryNote, listHistoryTreeHashes, getAllHistoryNotes, hasHistoryForTree, } from './reader.js';
+// Pruner
+export { pruneHistoryByAge, pruneAllHistory } from './pruner.js';
+// Health check
+export { checkHistoryHealth } from './health-check.js';
+// Truncate
+export { truncateValidationOutput } from './truncate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/pruner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * History pruning utilities
+ */
+import type { PruneResult, HistoryConfig } from './types.js';
+/**
+ * Prune validation history older than specified days
+ *
+ * @param olderThanDays - Remove notes older than this many days
+ * @param config - History configuration
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export declare function pruneHistoryByAge(olderThanDays: number, config?: HistoryConfig, dryRun?: boolean): Promise<PruneResult>;
+/**
+ * Prune all validation history
+ *
+ * @param config - History configuration
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export declare function pruneAllHistory(config?: HistoryConfig, dryRun?: boolean): Promise<PruneResult>;
+//# sourceMappingURL=pruner.d.ts.map

package/dist/pruner.d.ts.map

@@ -0,0 +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"}

package/dist/pruner.js

@@ -0,0 +1,107 @@
+/**
+ * History pruning utilities
+ */
+import { execSync } from 'child_process';
+import { DEFAULT_HISTORY_CONFIG } from './types.js';
+import { getAllHistoryNotes } from './reader.js';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Prune validation history older than specified days
+ *
+ * @param olderThanDays - Remove notes older than this many days
+ * @param config - History configuration
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export async function pruneHistoryByAge(olderThanDays, config = {}, dryRun = false) {
+    const mergedConfig = {
+        ...DEFAULT_HISTORY_CONFIG,
+        ...config,
+        gitNotes: {
+            ...DEFAULT_HISTORY_CONFIG.gitNotes,
+            ...config.gitNotes,
+        },
+    };
+    const notesRef = mergedConfig.gitNotes.ref;
+    const cutoffTime = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
+    let notesPruned = 0;
+    let runsPruned = 0;
+    const prunedTreeHashes = [];
+    const allNotes = await getAllHistoryNotes(notesRef);
+    const notesRemaining = allNotes.length;
+    for (const note of allNotes) {
+        if (!note.runs || note.runs.length === 0) {
+            continue;
+        }
+        // Get oldest run timestamp
+        const oldestRun = note.runs[0];
+        const oldestTimestamp = new Date(oldestRun.timestamp).getTime();
+        if (oldestTimestamp < cutoffTime) {
+            // All runs in this note are old - delete entire note
+            if (!dryRun) {
+                try {
+                    execSync(`git notes --ref=${notesRef} remove ${note.treeHash}`, { ...GIT_OPTIONS, stdio: 'ignore' });
+                }
+                catch {
+                    // Ignore errors (note might not exist)
+                }
+            }
+            notesPruned++;
+            runsPruned += note.runs.length;
+            prunedTreeHashes.push(note.treeHash);
+        }
+    }
+    return {
+        notesPruned,
+        runsPruned,
+        notesRemaining: notesRemaining - notesPruned,
+        prunedTreeHashes,
+    };
+}
+/**
+ * Prune all validation history
+ *
+ * @param config - History configuration
+ * @param dryRun - If true, don't actually delete (default: false)
+ * @returns Prune result
+ */
+export async function pruneAllHistory(config = {}, dryRun = false) {
+    const mergedConfig = {
+        ...DEFAULT_HISTORY_CONFIG,
+        ...config,
+        gitNotes: {
+            ...DEFAULT_HISTORY_CONFIG.gitNotes,
+            ...config.gitNotes,
+        },
+    };
+    const notesRef = mergedConfig.gitNotes.ref;
+    const allNotes = await getAllHistoryNotes(notesRef);
+    let notesPruned = 0;
+    let runsPruned = 0;
+    const prunedTreeHashes = [];
+    for (const note of allNotes) {
+        if (!dryRun) {
+            try {
+                execSync(`git notes --ref=${notesRef} remove ${note.treeHash}`, { ...GIT_OPTIONS, stdio: 'ignore' });
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        notesPruned++;
+        runsPruned += note.runs?.length || 0;
+        prunedTreeHashes.push(note.treeHash);
+    }
+    return {
+        notesPruned,
+        runsPruned,
+        notesRemaining: 0,
+        prunedTreeHashes,
+    };
+}
+//# sourceMappingURL=pruner.js.map

package/dist/pruner.js.map

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

package/dist/reader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Git notes reader
+ */
+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)
+ * @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)
+ * @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)
+ * @returns Array of all history notes
+ */
+export declare function getAllHistoryNotes(notesRef?: string): Promise<HistoryNote[]>;
+/**
+ * Check if validation history exists for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @returns True if history exists
+ */
+export declare function hasHistoryForTree(treeHash: string, notesRef?: string): Promise<boolean>;
+//# sourceMappingURL=reader.d.ts.map

package/dist/reader.d.ts.map

@@ -0,0 +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,CAa7B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB;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"}

package/dist/reader.js

@@ -0,0 +1,86 @@
+/**
+ * Git notes reader
+ */
+import { execSync } from 'child_process';
+import { parse as parseYaml } from 'yaml';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Read validation history note for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @returns History note or null if not found
+ */
+export async function readHistoryNote(treeHash, notesRef = 'vibe-validate/runs') {
+    try {
+        const yaml = execSync(`git notes --ref=${notesRef} show ${treeHash}`, GIT_OPTIONS);
+        const note = parseYaml(yaml);
+        return note;
+    }
+    catch (_error) {
+        // Note doesn't exist - this is fine
+        return null;
+    }
+}
+/**
+ * List all tree hashes with validation history
+ *
+ * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @returns Array of tree hashes with notes
+ */
+export async function listHistoryTreeHashes(notesRef = 'vibe-validate/runs') {
+    try {
+        const output = execSync(`git notes --ref=${notesRef} list`, GIT_OPTIONS);
+        if (!output.trim()) {
+            return [];
+        }
+        // Output format: "<note-sha> <tree-hash>"
+        const treeHashes = output
+            .trim()
+            .split('\n')
+            .map((line) => {
+            const parts = line.split(' ');
+            return parts[1]; // tree hash
+        })
+            .filter(Boolean);
+        return treeHashes;
+    }
+    catch (_error) {
+        // No notes exist yet
+        return [];
+    }
+}
+/**
+ * Get all validation history notes
+ *
+ * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @returns Array of all history notes
+ */
+export async function getAllHistoryNotes(notesRef = 'vibe-validate/runs') {
+    const treeHashes = await listHistoryTreeHashes(notesRef);
+    const notes = [];
+    for (const treeHash of treeHashes) {
+        const note = await readHistoryNote(treeHash, notesRef);
+        if (note) {
+            notes.push(note);
+        }
+    }
+    return notes;
+}
+/**
+ * Check if validation history exists for a tree hash
+ *
+ * @param treeHash - Git tree hash
+ * @param notesRef - Git notes ref (default: vibe-validate/runs)
+ * @returns True if history exists
+ */
+export async function hasHistoryForTree(treeHash, notesRef = 'vibe-validate/runs') {
+    const note = await readHistoryNote(treeHash, notesRef);
+    return note !== null;
+}
+//# sourceMappingURL=reader.js.map

package/dist/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,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,MAAM,EAAE,CAAC;QAChB,oCAAoC;QACpC,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,MAAM,EAAE,CAAC;QAChB,qBAAqB;QACrB,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"}

package/dist/recorder.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Git notes recorder
+ */
+import type { ValidationResult } from '@vibe-validate/core';
+import type { RecordResult, StabilityCheck, HistoryConfig } from './types.js';
+/**
+ * Record validation result to git notes
+ *
+ * @param treeHash - Git tree hash
+ * @param result - Validation result
+ * @param config - History configuration
+ * @returns Record result
+ */
+export declare function recordValidationHistory(treeHash: string, result: ValidationResult, config?: HistoryConfig): Promise<RecordResult>;
+/**
+ * Check worktree stability (compare tree hash before and after)
+ *
+ * @param treeHashBefore - Tree hash before validation
+ * @returns Stability check result
+ */
+export declare function checkWorktreeStability(treeHashBefore: string): Promise<StabilityCheck>;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAGV,YAAY,EACZ,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAuCpB;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,YAAY,CAAC,CA8FvB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,CAQzB"}

package/dist/recorder.js

@@ -0,0 +1,151 @@
+/**
+ * Git notes recorder
+ */
+import { execSync } from 'child_process';
+import { writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { stringify as stringifyYaml } from 'yaml';
+import { getGitTreeHash, hasWorkingTreeChanges } from '@vibe-validate/git';
+import { DEFAULT_HISTORY_CONFIG } from './types.js';
+import { truncateValidationOutput } from './truncate.js';
+import { readHistoryNote } from './reader.js';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Get current branch name
+ *
+ * @returns Branch name or 'detached' if in detached HEAD state
+ */
+async function getCurrentBranch() {
+    try {
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', GIT_OPTIONS).trim();
+        return branch === 'HEAD' ? 'detached' : branch;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Get HEAD commit SHA
+ *
+ * @returns Commit SHA or 'none' if no commits
+ */
+async function getHeadCommit() {
+    try {
+        return execSync('git rev-parse HEAD', GIT_OPTIONS).trim();
+    }
+    catch {
+        return 'none';
+    }
+}
+/**
+ * Record validation result to git notes
+ *
+ * @param treeHash - Git tree hash
+ * @param result - Validation result
+ * @param config - History configuration
+ * @returns Record result
+ */
+export async function recordValidationHistory(treeHash, result, config = {}) {
+    const mergedConfig = {
+        ...DEFAULT_HISTORY_CONFIG,
+        ...config,
+        gitNotes: {
+            ...DEFAULT_HISTORY_CONFIG.gitNotes,
+            ...config.gitNotes,
+        },
+        retention: {
+            ...DEFAULT_HISTORY_CONFIG.retention,
+            ...config.retention,
+        },
+    };
+    // Type assertions safe: DEFAULT_HISTORY_CONFIG is Required<HistoryConfig>
+    const notesRef = (mergedConfig.gitNotes.ref ?? DEFAULT_HISTORY_CONFIG.gitNotes.ref);
+    const maxRunsPerTree = (mergedConfig.gitNotes.maxRunsPerTree ?? DEFAULT_HISTORY_CONFIG.gitNotes.maxRunsPerTree);
+    const maxOutputBytes = (mergedConfig.gitNotes.maxOutputBytes ?? DEFAULT_HISTORY_CONFIG.gitNotes.maxOutputBytes);
+    try {
+        // 1. Read existing note (if any)
+        const existingNote = await readHistoryNote(treeHash, notesRef);
+        // 2. Create new run entry
+        const newRun = {
+            id: `run-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+            duration: result.passed ? 0 : 0, // Will be calculated from result if available
+            passed: result.passed,
+            branch: await getCurrentBranch(),
+            headCommit: await getHeadCommit(),
+            uncommittedChanges: await hasWorkingTreeChanges(),
+            result: truncateValidationOutput(result, maxOutputBytes),
+        };
+        // Calculate duration from result phases if available (convert to milliseconds)
+        if (result.phases && result.phases.length > 0) {
+            newRun.duration = result.phases.reduce((total, phase) => total + (phase.durationSecs || 0) * 1000, 0);
+        }
+        // 3. Append or create
+        let note;
+        if (existingNote) {
+            note = {
+                ...existingNote,
+                runs: [...existingNote.runs, newRun],
+            };
+            // Prune: keep last N runs
+            if (note.runs.length > maxRunsPerTree) {
+                note.runs = note.runs.slice(-maxRunsPerTree);
+            }
+        }
+        else {
+            note = {
+                treeHash,
+                runs: [newRun],
+            };
+        }
+        // 4. Write note to temp file (use cross-platform temp directory)
+        const tempFile = join(tmpdir(), `note.vibe-validate.${treeHash.slice(0, 12)}.${process.pid}.yaml`);
+        try {
+            writeFileSync(tempFile, stringifyYaml(note), 'utf8');
+            // 5. Add note to git (force overwrite)
+            execSync(`git notes --ref=${notesRef} add -f -F "${tempFile}" ${treeHash}`, { ...GIT_OPTIONS, stdio: 'ignore' });
+            return {
+                recorded: true,
+                treeHash,
+            };
+        }
+        finally {
+            // Cleanup temp file
+            try {
+                unlinkSync(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            recorded: false,
+            reason: errorMessage,
+            treeHash,
+        };
+    }
+}
+/**
+ * Check worktree stability (compare tree hash before and after)
+ *
+ * @param treeHashBefore - Tree hash before validation
+ * @returns Stability check result
+ */
+export async function checkWorktreeStability(treeHashBefore) {
+    const treeHashAfter = await getGitTreeHash();
+    return {
+        stable: treeHashBefore === treeHashAfter,
+        treeHashBefore,
+        treeHashAfter,
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

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

package/dist/truncate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Output truncation utilities
+ */
+import type { ValidationResult } from '@vibe-validate/core';
+/**
+ * Truncate validation result output to max bytes
+ *
+ * @param result - Validation result to truncate
+ * @param maxBytes - Maximum bytes per step output (default: 10000)
+ * @returns Truncated validation result
+ */
+export declare function truncateValidationOutput(result: ValidationResult, maxBytes?: number): ValidationResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,GAAE,MAAc,GACvB,gBAAgB,CAgClB"}

package/dist/truncate.js

@@ -0,0 +1,39 @@
+/**
+ * Output truncation utilities
+ */
+/**
+ * Truncate validation result output to max bytes
+ *
+ * @param result - Validation result to truncate
+ * @param maxBytes - Maximum bytes per step output (default: 10000)
+ * @returns Truncated validation result
+ */
+export function truncateValidationOutput(result, maxBytes = 10000) {
+    // Deep clone to avoid mutating original
+    const truncated = JSON.parse(JSON.stringify(result));
+    // Truncate phase outputs
+    if (truncated.phases) {
+        for (const phase of truncated.phases) {
+            if (phase.steps) {
+                for (const step of phase.steps) {
+                    if (step.output && step.output.length > maxBytes) {
+                        const originalLength = step.output.length;
+                        step.output =
+                            step.output.slice(0, maxBytes) +
+                                `\n\n[... truncated ${originalLength - maxBytes} bytes]`;
+                    }
+                }
+            }
+        }
+    }
+    // Truncate failed step output
+    if (truncated.failedStepOutput &&
+        truncated.failedStepOutput.length > maxBytes) {
+        const originalLength = truncated.failedStepOutput.length;
+        truncated.failedStepOutput =
+            truncated.failedStepOutput.slice(0, maxBytes) +
+                `\n\n[... truncated ${originalLength - maxBytes} bytes]`;
+    }
+    return truncated;
+}
+//# sourceMappingURL=truncate.js.map

package/dist/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAwB,EACxB,WAAmB,KAAK;IAExB,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAqB,CAAC;IAEzE,yBAAyB;IACzB,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;wBACjD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;wBAC1C,IAAI,CAAC,MAAM;4BACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;gCAC9B,sBAAsB,cAAc,GAAG,QAAQ,SAAS,CAAC;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IACE,SAAS,CAAC,gBAAgB;QAC1B,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,QAAQ,EAC5C,CAAC;QACD,MAAM,cAAc,GAAG,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC;QACzD,SAAS,CAAC,gBAAgB;YACxB,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;gBAC7C,sBAAsB,cAAc,GAAG,QAAQ,SAAS,CAAC;IAC7D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Validation history types
+ */
+import type { ValidationResult } from '@vibe-validate/core';
+/**
+ * Single validation run entry
+ */
+export interface ValidationRun {
+    /** Unique run ID (run-{timestamp}) */
+    id: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Did validation pass? */
+    passed: boolean;
+    /** Branch name at time of validation */
+    branch: string;
+    /** HEAD commit SHA at time of validation */
+    headCommit: string;
+    /** Were there uncommitted changes? */
+    uncommittedChanges: boolean;
+    /** Full validation result (with truncated output) */
+    result: ValidationResult;
+}
+/**
+ * Git note structure (stored as YAML)
+ */
+export interface HistoryNote {
+    /** Tree hash this note is attached to */
+    treeHash: string;
+    /** Array of validation runs for this tree */
+    runs: ValidationRun[];
+}
+/**
+ * Result of recording validation history
+ */
+export interface RecordResult {
+    /** Was history successfully recorded? */
+    recorded: boolean;
+    /** Reason if not recorded */
+    reason?: string;
+    /** Tree hash that was recorded (or attempted) */
+    treeHash: string;
+}
+/**
+ * Worktree stability check result
+ */
+export interface StabilityCheck {
+    /** Is worktree stable? */
+    stable: boolean;
+    /** Tree hash before validation */
+    treeHashBefore: string;
+    /** Tree hash after validation */
+    treeHashAfter: string;
+}
+/**
+ * History configuration
+ */
+export interface HistoryConfig {
+    /** Enable history recording */
+    enabled?: boolean;
+    /** Git notes configuration */
+    gitNotes?: {
+        /** Git ref namespace */
+        ref?: string;
+        /** Max runs to keep per tree */
+        maxRunsPerTree?: number;
+        /** Truncate output to max bytes */
+        maxOutputBytes?: number;
+    };
+    /** Retention policy */
+    retention?: {
+        /** Warn after this many days */
+        warnAfterDays?: number;
+        /** Warn after this many total notes */
+        warnAfterCount?: number;
+    };
+}
+/**
+ * Default history configuration
+ */
+export declare const DEFAULT_HISTORY_CONFIG: Required<HistoryConfig>;
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    /** Total number of tree hashes with notes */
+    totalNotes: number;
+    /** Number of notes older than retention policy */
+    oldNotesCount: number;
+    /** Should warn user about cleanup? */
+    shouldWarn: boolean;
+    /** Warning message (if any) */
+    warningMessage?: string;
+}
+/**
+ * Prune result
+ */
+export interface PruneResult {
+    /** Number of notes pruned */
+    notesPruned: number;
+    /** Number of runs pruned (across all notes) */
+    runsPruned: number;
+    /** Number of notes remaining */
+    notesRemaining: number;
+    /** Tree hashes that were pruned */
+    prunedTreeHashes: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAEhB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAE5B,qDAAqD;IACrD,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAElB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,OAAO,CAAC;IAEhB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IAEvB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE;QACT,wBAAwB;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb,gCAAgC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,mCAAmC;QACnC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,uBAAuB;IACvB,SAAS,CAAC,EAAE;QACV,gCAAgC;QAChC,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB,uCAAuC;QACvC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAW1D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAC;IAEpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IAEvB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,19 @@
+/**
+ * Validation history types
+ */
+/**
+ * Default history configuration
+ */
+export const DEFAULT_HISTORY_CONFIG = {
+    enabled: true,
+    gitNotes: {
+        ref: 'vibe-validate/runs',
+        maxRunsPerTree: 10,
+        maxOutputBytes: 10000,
+    },
+    retention: {
+        warnAfterDays: 90,
+        warnAfterCount: 100,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqGH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA4B;IAC7D,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACR,GAAG,EAAE,oBAAoB;QACzB,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,KAAK;KACtB;IACD,SAAS,EAAE;QACT,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,GAAG;KACpB;CACF,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@vibe-validate/history",
+  "version": "0.12.0",
+  "description": "Validation history tracking via git notes for vibe-validate",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "validation",
+    "history",
+    "git-notes",
+    "caching",
+    "sdlc"
+  ],
+  "author": "Jeff Dutton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jdutton/vibe-validate.git",
+    "directory": "packages/history"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vibe-validate/git": "workspace:*",
+    "@vibe-validate/core": "workspace:*",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}