Add Note search

.github/PULL_REQUEST_TEMPLATE.md

@@ -11,9 +11,12 @@ Describe your changes.
 - [ ] test
 - [ ] chore
 
-## Testing
+### Required
 
-Describe testing performed.
+- [ ] cargo check passes
+- [ ] cargo fmt --check passes
+- [ ] cargo clippy --workspace --all-targets -- -D warnings passes
+- [ ] cargo test passes
 
 ## Checklist
 

README.md

@@ -1,12 +1,12 @@
 # FrilVault
 
-> Personal Knowledge Vault for Developers
+> Your Personal Knowledge Vault for Code
 
 🚧 Early development stage
 
-FrilVault is a developer-focused knowledge vault that allows you to attach private notes to source code without modifying the code itself.
+FrilVault is a developer-focused personal knowledge vault that allows you to attach private notes to source code without modifying the code itself.
 
-Instead of adding temporary comments, TODOs, research notes, or learning records directly into a repository, FrilVault stores them separately in a local `.vault` directory.
+Instead of adding temporary comments, TODOs, research notes, debugging records, or learning materials directly into source files, FrilVault stores them separately inside a local `.vault` directory.
 
 This keeps source code clean while preserving valuable knowledge.
 
@@ -22,6 +22,7 @@ When studying large codebases, contributing to open source projects, or maintain
 - TODO items
 - Learning notes
 - AI context
+- Reverse engineering notes
 
 Adding these notes directly into source files creates several problems:
 
@@ -34,32 +35,89 @@ FrilVault solves this by storing notes outside of the source code.
 
 ---
 
+## Quick Start
+
+Add a note:
+
+```bash
+flv add \
+  --file src/main.rs \
+  --line 10 \
+  --column 5 \
+  --content "parser 개선 필요"
+```
+
+List notes:
+
+```bash
+flv list \
+  --file src/main.rs
+```
+
+Search notes:
+
+```bash
+flv search parser
+```
+
+Update a note:
+
+```bash
+flv update \
+  --file src/main.rs \
+  --id <NOTE_ID> \
+  --content "parser 구조 재설계 필요"
+```
+
+Delete a note:
+
+```bash
+flv delete \
+  --file src/main.rs \
+  --id <NOTE_ID>
+```
+
+---
+
 ## Features
 
 ### Private Notes
 
-Store personal notes without modifying source files.
-
-### Symbol-Based Notes
+Store personal notes without modifying source code.
 
-Attach notes to functions, methods, structs, classes, or modules.
+### Line Anchors
 
-### Local First
+Attach notes to specific locations inside source files.
 
-All data is stored locally.
+```yaml
+anchor:
+  type: Line
+  line: 10
+  column: 5
+```
 
 ### Search
 
-Search notes by symbol, file, tag, or keyword.
+Search notes using keywords.
+
+```bash
+flv search parser
+```
 
-### AI Ready
+### Local First
 
-Use personal notes as context for AI-assisted development workflows.
+All data is stored locally.
+
+No external services are required.
 
 ### Clean Repository
 
 Keep repositories free from temporary comments and personal annotations.
 
+### Developer Knowledge Base
+
+Build a personal knowledge layer on top of any codebase.
+
 ---
 
 ## Example
@@ -72,61 +130,145 @@ pub fn calculate_damage() {
 }
 ```
 
+Personal note:
+
+```bash
+flv add \
+  --file src/combat.rs \
+  --line 1 \
+  --column 1 \
+  --content "Consider SIMD optimization in the future"
+```
+
 Stored note:
 
 ```yaml
 notes:
-  - symbol: calculate_damage
+  - id: '15b7c4b3-f4a6-4cc1-accb-428f344cc597'
+
+    source_file: src/combat.rs
 
-    tags:
-      - analysis
+    anchor:
+      type: Line
+      line: 1
+      column: 1
 
-    comment: |
-      Consider SIMD optimization in the future.
+    content: Consider SIMD optimization in the future
+
+    created_at: '2026-06-03T17:42:17.853037Z'
+    updated_at: '2026-06-03T17:42:17.853037Z'
 ```
 
 ---
 
-## Project Structure
+## Storage Structure
+
+Current storage layout:
 
 ```text
-frilvault/
-├── crates/
-│   └── frilvault-core/
-│
-├── apps/
-│   └── vscode-extension/
+project/
+├── src/
 │
 └── .vault/
-    ├── notes/
-    ├── cache/
-    └── index/
+    └── src/
+        ├── main.rs.yml
+        ├── lib.rs.yml
+        └── service.rs.yml
+```
+
+Example:
+
+```yaml
+notes:
+  - id: '15b7c4b3-f4a6-4cc1-accb-428f344cc597'
+
+    source_file: src/lib.rs
+
+    anchor:
+      type: Line
+      line: 3
+      column: 1
+
+    content: Parser trait 검토
+
+    created_at: '2026-06-03T17:42:17.853037Z'
+    updated_at: '2026-06-03T17:42:17.853037Z'
 ```
 
 ---
 
+## Current Status
+
+### Core
+
+- YAML note storage
+- Line anchors
+- CRUD operations
+- Keyword search
+
+### CLI
+
+- add
+- list
+- update
+- delete
+- search
+
+---
+
+## Use Cases
+
+### Open Source Analysis
+
+Study libraries and frameworks without modifying upstream code.
+
+### Reverse Engineering
+
+Document control flow and implementation details.
+
+### Personal Documentation
+
+Store architecture notes and design decisions.
+
+### Learning Notes
+
+Record discoveries while exploring unfamiliar codebases.
+
+### AI-Assisted Development
+
+Build project-specific context for future AI workflows.
+
+---
+
 ## Roadmap
 
-### Phase 1
+### Phase 1 (Current)
 
 - Rust core library
-- VSCode extension
-- YAML note storage
-- Symbol-based notes
+- YAML storage
+- CLI support
+- CRUD operations
+- Keyword search
 
 ### Phase 2
 
+- Symbol anchors
+- JSON output
+- VSCode extension
+
+### Phase 3
+
 - Project indexing
-- Search engine
 - Workspace explorer
+- Cached search
 
-### Phase 3
+### Phase 4
 
+- AI Context Engine
 - Semantic search
-- AI context integration
-- RAG support
+- RAG integration
 
-### Phase 4
+### Phase 5
 
 - JetBrains plugin
 - Desktop application

apps/frilvault-cli/Cargo.toml

@@ -3,6 +3,10 @@ name = "frilvault-cli"
 version = "0.1.0"
 edition = "2024"
 
+[[bin]]
+name = "flvt"
+path = "src/main.rs"
+
 [dependencies]
 clap = { version = "4", features = ["derive"] }
 anyhow = "1"

apps/frilvault-cli/src/cli/mod.rs

@@ -3,19 +3,17 @@ use clap::{Parser, Subcommand};
 pub mod add;
 pub mod delete;
 pub mod list;
+pub mod search;
 pub mod update;
 
 use add::AddCommand;
 use delete::DeleteCommand;
 use list::ListCommand;
+use search::SearchCommand;
 use update::UpdateCommand;
 
 #[derive(Parser)]
-#[command(
-    name = "frilvault",
-    version,
-    about = "Personal note vault for source code"
-)]
+#[command(name = "flvt", version, about = "Personal note vault for source code")]
 pub struct Cli {
     #[command(subcommand)]
     pub command: Commands,
@@ -27,4 +25,5 @@ pub enum Commands {
     List(ListCommand),
     Update(UpdateCommand),
     Delete(DeleteCommand),
+    Search(SearchCommand),
 }

apps/frilvault-cli/src/cli/search.rs

@@ -0,0 +1,6 @@
+use clap::Args;
+
+#[derive(Debug, Args)]
+pub struct SearchCommand {
+    pub keyword: String,
+}

apps/frilvault-cli/src/command/list.rs

@@ -1,22 +1,16 @@
 use anyhow::Result;
 
-use crate::{cli::list::ListCommand, command::create_note_service};
+use crate::{cli::list::ListCommand, command::create_note_service, output};
 
 pub fn execute(command: ListCommand) -> Result<()> {
     let service = create_note_service()?;
 
     let notes = service.list_notes(&command.file)?;
 
-    println!("Found {} notes", notes.len());
+    output::print_note_count(notes.len());
 
     for note in notes {
-        println!("\nID: {}", note.id);
-
-        println!("\nFilename: {:?}", note.source_file);
-
-        println!("Content: {}", note.content);
-
-        println!("Anchor: {:?}", note.anchor);
+        output::print_note(&note);
     }
 
     Ok(())

apps/frilvault-cli/src/command/mod.rs

@@ -5,6 +5,7 @@ use frilvault_core::{NoteService, PathResolver, YamlNoteRepository};
 pub mod add;
 pub mod delete;
 pub mod list;
+pub mod search;
 pub mod update;
 
 pub fn create_note_service() -> Result<NoteService> {