update version to v0.3.0

Author: Roberto Amarante

CHANGELOG.md

@@ -6,7 +6,63 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 
 ## [Unreleased]
 
-## [v0.2.0] - 2025-08-10
+## [v0.3.0] - 2026-05-01
+
+### AI Features
+
+- AI Chat Participant (`@codenotes`) with `/annotate`, `/summarize`, `/relate`, `/diff`, `/suggest-note` commands
+- Suggest Note for Selection (AI) — recommends which note fits selected code
+- Inline completions — annotation suggestions as you type in `.md` notes
+- Auto-Tag Note (AI) — suggest tags based on references
+- Ask Notes (AI) — natural language Q&A over your notes
+- Refresh Stale Annotations (AI) — detect code drift and regenerate
+- Semantic Search (AI) — natural language search across all annotations
+- Auto Annotate (AI) — AI generates annotation from code + note context (`Cmd+Shift+;`)
+- Smart Linking (AI) — auto-detect related references and add cross-link comments
+- Annotation Quality Scoring (AI) — rate staleness/vagueness, suggest rewrites
+- Code Review Assistant (AI) — surface relevant annotations for git changes
+
+### AI Provider
+
+- External AI API support (OpenAI, Anthropic, Ollama, any OpenAI-compatible endpoint)
+- Auto-detect provider (VS Code LM API or external)
+- Secure API key storage via SecretStorage
+- Configurable model selection
+
+### Notes & Organization
+
+- Note templates (Bug Investigation, Code Review, Feature Exploration, Architecture Decision, Learning Notes)
+- Tags/labels with filtering
+- Archive/unarchive notes
+- Comments/threads on references
+- Export to Markdown
+- Git-friendly `.codenotes/` workspace storage option
+
+### Code References
+
+- Pin/favorite references
+- Bulk add references
+- Drag-and-drop reorder
+- Auto-update line numbers on file changes
+- Quick Add annotation (`Cmd+Shift+L`) — minimal dialogs
+- Delete annotation command
+- Annotation history/versioning — track changes over time
+- Broken reference detection — auto-scan on startup
+
+### Navigation & Visualization
+
+- Reference graph (interactive webview)
+- References to this file command
+- Annotation timeline (chronological webview)
+- Status bar badge for stale/broken annotations
+
+### Infrastructure
+
+- Open VSX marketplace publishing
+- Engine version lowered to `^1.85.0` (Cursor compatibility)
+- JSON-based storage with schema migration
+
+## [v0.2.0] - 2026-01-02
 
 - Add search notes
 - Add change notes directory
@@ -18,5 +74,6 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 - Initial Release
 - Add note taking
 
-[v0.2.0]: https://github.com/Kyonru/feather/compare/v0.1.0...v0.2.0
-[v0.1.0]: https://github.com/Kyonru/feather/releases/tag/v0.1.0
+[v0.3.0]: https://github.com/Kyonru/code-notes/compare/v0.2.0...v0.3.0
+[v0.2.0]: https://github.com/Kyonru/code-notes/compare/v0.1.0...v0.2.0
+[v0.1.0]: https://github.com/Kyonru/code-notes/releases/tag/v0.1.0

README.md

@@ -30,6 +30,15 @@ Codebase Notebook is a VS Code extension that lets you take structured notes acr
 - Auto-update line numbers when code shifts (file change watcher)
 - Hover preview — see annotation when hovering over referenced lines
 - **Quick Add** — Single-keystroke annotation without leaving the editor (`Cmd+Shift+L`)
+- **Auto Annotate (AI)** — AI generates an annotation based on selected code and note context (`Cmd+Shift+;`)
+- **Annotation History** — Track changes to annotations over time, view full revision history per reference
+- **Broken Reference Detection** — Auto-scan for references to deleted/moved files on startup, with manual command
+
+### 📊 Monitoring & Quality
+
+- **Status Bar Badge** — Shows count of stale/broken annotations with warning indicator
+- **Annotation Timeline** — Chronological webview showing when annotations were added across all notes
+- **Annotation Quality Scoring (AI)** — Rate annotations for staleness/vagueness and suggest rewrites
 
 ### 🔌 AI Provider Flexibility
 
@@ -55,8 +64,13 @@ Additional AI commands (Command Palette):
 | Command                                             | Description                                                |
 | --------------------------------------------------- | ---------------------------------------------------------- |
 | `Codebase Notebook: Suggest Note`                   | AI suggests which note fits the current code (Cmd+Shift+K) |
+| `Codebase Notebook: Auto Annotate (AI)`             | AI generates annotation from code context (Cmd+Shift+;)    |
 | `Codebase Notebook: Auto-Tag Note (AI)`             | Suggest tags for a note based on its references            |
 | `Codebase Notebook: Ask Notes (AI)`                 | Ask questions about your notes ("Which note covers auth?") |
+| `Codebase Notebook: Semantic Search (AI)`           | Natural language search across all annotations             |
+| `Codebase Notebook: Smart Linking (AI)`             | Auto-detect related references and suggest cross-links     |
+| `Codebase Notebook: Annotation Quality Score (AI)`  | Rate staleness/vagueness and suggest rewrites              |
+| `Codebase Notebook: Code Review Assistant (AI)`     | Surface relevant annotations during code review (git diff) |
 | `Codebase Notebook: Refresh Stale Annotations (AI)` | Detect changed code and regenerate annotations             |
 
 ### 🏷️ Organization
@@ -76,6 +90,9 @@ Additional AI commands (Command Palette):
 
 - **Reference graph** — Interactive webview showing how notes connect to files (click to open)
 - **References to this file** — See all notes referencing the current file
+- **Semantic Search (AI)** — Natural language queries across all annotations (sparkle button in tree view)
+- **Smart Linking (AI)** — Auto-detect related references and add cross-link comments
+- **Code Review Assistant (AI)** — Surface relevant annotations for your git changes
 - **CodeLens** — "View Note" lens on referenced lines
 - **Inline completions** — Annotation suggestions as you type
 
@@ -120,6 +137,9 @@ Additional AI commands (Command Palette):
 | `Codebase Notebook: Add Comment`               | Add a comment to a reference                    |
 | `Codebase Notebook: View Comments`             | View/delete comments on a reference             |
 | `Codebase Notebook: Delete Annotation`         | Delete a reference and its section from the note|
+| `Codebase Notebook: Show Annotation Timeline`  | Chronological view of all annotations           |
+| `Codebase Notebook: Detect Broken References`  | Scan for references to deleted/moved files      |
+| `Codebase Notebook: View Annotation History`   | View revision history of a reference            |
 | `Codebase Notebook: Set AI API Key`            | Store API key securely for external AI provider |
 | `Codebase Notebook: Clear AI API Key`          | Remove stored AI API key                        |
 | `Codebase Notebook: Change Notes Directory`    | Select / change the directory used for notes    |
@@ -141,6 +161,7 @@ You'll find most actions in:
 | Add Reference to Notebook | `Ctrl + Shift + J` | `Cmd + Shift + J` |
 | Quick Add Annotation      | `Ctrl + Shift + L` | `Cmd + Shift + L` |
 | Suggest Note (AI)         | `Ctrl + Shift + K` | `Cmd + Shift + K` |
+| Auto Annotate (AI)        | `Ctrl + Shift + ;` | `Cmd + Shift + ;` |
 
 ### Quick Add vs Add Reference
 

TODO.md

@@ -6,11 +6,6 @@
 
 ## AI-Enhanced Features
 
-- [ ] Code change impact analysis (identify affected annotations from git diffs)
-- [ ] Auto-annotation from PR (suggest annotations for notable PR changes)
-- [ ] Knowledge gaps detection (find heavily-modified files with no annotations)
-- [ ] Annotation quality scoring (rate staleness/vagueness, suggest rewrites)
-- [ ] Generate onboarding guide (compile annotations into a structured walkthrough)
 - [ ] Code review assistant (surface relevant annotations during code review)
 - [ ] Dependency chain narrator (trace call chains from an annotated reference)
 - [ ] Note summarization on hover (AI one-liner in tree view tooltip)

package.json

@@ -5,7 +5,7 @@
     "url": "https://github.com/sponsors/kyonru"
   },
   "description": "An extension to help taking note across the codebase",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "icon": "icon.png",
   "publisher": "SolenodonteLabs",
   "engines": {