Skip to content

feat: add v1.0 reliability features — lockfile, backup, recovery, integrity#48

Merged
keeganthomp merged 2 commits intomainfrom
claude/review-roadmap-dO6CJ
Apr 8, 2026
Merged

feat: add v1.0 reliability features — lockfile, backup, recovery, integrity#48
keeganthomp merged 2 commits intomainfrom
claude/review-roadmap-dO6CJ

Conversation

@keeganthomp
Copy link
Copy Markdown
Owner

Implement all four reliability items from the v1.0 roadmap:

  • Lockfile mechanism (.kb/vault.lock) prevents concurrent vault writes
    with stale lock detection, re-entrant support, and PID-based ownership
  • Automatic backup creates manifest snapshots in .kb/backups/ before
    destructive operations (compile --force), with pruning to keep last 5
  • Crash recovery detects incomplete writes (.tmp files), stale locks,
    corrupt manifests, and repairs them (including restore from backup)
  • Manifest integrity validation checks source/article files exist on
    disk, cross-references are consistent, and stats match reality

Compile, ingest, and lint --fix are now wrapped with vault locks.
40 new tests, all 394 tests passing.

https://claude.ai/code/session_0127AhEBpSs1q8CgtNCRAwCW

claude added 2 commits April 8, 2026 02:35
…egrity

Implement all four reliability items from the v1.0 roadmap:

- Lockfile mechanism (.kb/vault.lock) prevents concurrent vault writes
  with stale lock detection, re-entrant support, and PID-based ownership
- Automatic backup creates manifest snapshots in .kb/backups/ before
  destructive operations (compile --force), with pruning to keep last 5
- Crash recovery detects incomplete writes (.tmp files), stale locks,
  corrupt manifests, and repairs them (including restore from backup)
- Manifest integrity validation checks source/article files exist on
  disk, cross-references are consistent, and stats match reality

Compile, ingest, and lint --fix are now wrapped with vault locks.
40 new tests, all 394 tests passing.

https://claude.ai/code/session_0127AhEBpSs1q8CgtNCRAwCW
Documentation suite:
- docs/getting-started.md — quick start tutorial with real examples
- docs/vault-format.md — complete vault structure and schema spec
- docs/skill-authoring.md — guide to creating custom skills
- docs/provider-config.md — LLM provider setup and model config
- docs/architecture.md — codebase architecture for contributors

Testing & quality:
- E2E test: full init → ingest → compile → search → query → lint lifecycle
- Performance benchmarks: vault init, manifest load, search build/query,
  ingest throughput, compile no-op latency
- Coverage reporting via `bun test:coverage`
- Fix integrity validator to correctly derive source file paths from
  metadata title (source IDs are hash-based, not file paths)

402 tests passing, all lint clean.

https://claude.ai/code/session_0127AhEBpSs1q8CgtNCRAwCW
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
kib Ready Ready Preview, Comment Apr 8, 2026 2:48am

Request Review

@keeganthomp keeganthomp merged commit 75a1269 into main Apr 8, 2026
3 checks passed
@keeganthomp keeganthomp deleted the claude/review-roadmap-dO6CJ branch April 8, 2026 02:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants