learning-agent 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -7,6 +7,82 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-02-01
+
+### Added
+
+- **Age-based Temporal Validity** (LANDSCAPE.md: eik)
+  - `CompactionLevelSchema` for lesson lifecycle (0=active, 1=flagged, 2=archived)
+  - Age distribution display in `stats` command (<30d, 30-90d, >90d)
+  - Age warnings in `load-session` for lessons older than 90 days
+  - New schema fields: `compactionLevel`, `compactedAt`, `lastRetrieved`
+
+- **Manual Invalidation** (LANDSCAPE.md: mov)
+  - `learning-agent wrong <id>` - Mark a lesson as invalid/wrong
+  - `learning-agent validate <id>` - Re-enable a previously invalidated lesson
+  - `list --invalidated` flag to show only invalidated lessons
+  - New schema fields: `invalidatedAt`, `invalidationReason`
+
+- **Optional Citation Field** (LANDSCAPE.md: tn3)
+  - `CitationSchema` for lesson provenance tracking
+  - Store file path, line number, and git commit with lessons
+  - `learn --citation <file:line>` and `--citation-commit <hash>` flags
+
+- **Count Warning** (LANDSCAPE.md: qp9)
+  - Warning in `stats` when lesson count exceeds 20 (context pollution prevention)
+  - Note in `load-session` when total lessons may degrade retrieval quality
+
+### Changed
+
+- Lesson schema now includes optional fields for citation, age-tracking, and invalidation
+- `list` command shows `[INVALID]` marker for invalidated lessons
+- `load-session` JSON output includes `totalCount` field
+- CLI refactored into command modules (`src/commands/`) for maintainability
+- Age calculation logic centralized in `src/utils.ts`
+
+### Fixed
+
+- **SQLite schema now stores v0.2.2 fields** (x9y)
+  - Added columns: `invalidated_at`, `invalidation_reason`, `citation_*`, `compaction_level`, `compacted_at`
+  - `rebuildIndex` preserves all v0.2.2 fields during cache rebuild
+  - `rowToLesson` correctly maps all fields back to Lesson objects
+
+- **Retrieval paths filter out invalidated lessons** (z8k)
+  - `searchKeyword` excludes lessons with `invalidated_at` set
+  - `searchVector` skips invalidated lessons during scoring
+  - `loadSessionLessons` filters out invalidated high-severity lessons
+
+## [0.2.1] - 2026-02-01
+
+### Added
+
+- **CLI Commands**
+  - `lna` short alias for `learning-agent` CLI
+  - `show <id>` - Display lesson details
+  - `update <id>` - Modify lesson fields (insight, severity, tags, confirmed)
+  - `delete <id>` - Create tombstone for lesson removal
+  - `download-model` - Download embedding model (~278MB)
+  - `--severity` flag for `learn` command to set lesson severity
+
+- **Documentation**
+  - Complete lesson schema documentation in README
+  - Required vs optional fields explained
+  - Session-start loading requirements (type=full + severity=high + confirmed=true)
+  - "Never Edit JSONL Directly" warning in AGENTS.md template
+
+### Changed
+
+- `setup claude` now defaults to project-local (was global)
+- `setup claude --global` required for global installation
+- `init` now includes `setup claude` step by default
+- Auto-sync SQLite after every CLI mutation (learn, update, delete, import)
+
+### Fixed
+
+- Pre-commit hook now inserted before exit statements (not appended after)
+- JSONL edits properly sync to SQLite index
+- High-severity lessons load correctly at session start
+
 ## [0.2.0] - 2026-01-31
 
 ### Added
@@ -110,5 +186,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Vitest test suite
   - tsup build configuration
 
-[Unreleased]: https://github.com/nathanbraun/learning_agent/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/nathanbraun/learning_agent/releases/tag/v0.1.0
+[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v0.2.2...HEAD
+[0.2.2]: https://github.com/Nathandela/learning_agent/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/Nathandela/learning_agent/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/Nathandela/learning_agent/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Nathandela/learning_agent/releases/tag/v0.1.0

package/README.md

@@ -93,18 +93,30 @@ pnpm download-model
 # Capture a lesson manually
 pnpm learn "Use Polars for large files, not pandas"
 
+# Capture with citation (file:line provenance)
+learning-agent learn "API requires auth header" --citation src/api.ts:42
+
 # Search lessons
 learning-agent search "data processing"
 
-# Rebuild index from JSONL
-learning-agent rebuild
-
 # List all lessons
 learning-agent list
 
-# Show database stats
+# List only invalidated lessons
+learning-agent list --invalidated
+
+# Mark a lesson as wrong/invalid
+learning-agent wrong L12345678 --reason "This advice was incorrect"
+
+# Re-enable an invalidated lesson
+learning-agent validate L12345678
+
+# Show database stats (includes age distribution)
 learning-agent stats
 
+# Rebuild index from JSONL
+learning-agent rebuild
+
 # Compact and archive old lessons
 learning-agent compact
 ```
@@ -237,7 +249,7 @@ pnpm lint
 
 ## Project Status
 
-Version 0.2.0 - Claude Code hooks integration complete. See [doc/SPEC.md](doc/SPEC.md) for the full specification and [CHANGELOG.md](CHANGELOG.md) for recent changes.
+Version 0.2.2 - Hardening release with quality gates based on [LANDSCAPE.md](doc/LANDSCAPE.md) reviewer feedback. Adds age-based validity warnings, manual invalidation commands, optional citation tracking, and context pollution warnings. See [CHANGELOG.md](CHANGELOG.md) for details.
 
 ## Documentation