diff --git a/.gitignore b/.gitignore
index a898024..8aab79f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -48,3 +48,7 @@ saved_config.yaml
 /target/
 /cobertura.xml
 /tarpaulin-report.html
+target/.rustc_info.json
+target/release/marlin
+target/release/marlin.d
+tarpaulin-report.html
diff --git a/bench/dirty-vs-full.md b/bench/dirty-vs-full.md
index 891aa61..40bae79 100644
--- a/bench/dirty-vs-full.md
+++ b/bench/dirty-vs-full.md
@@ -1,4 +1,4 @@
 | Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
 |:---|---:|---:|---:|---:|
-| `full-scan` | 504.7 ± 38.5 | 462.3 | 562.2 | 6.75 ± 0.67 |
-| `dirty-scan` | 74.8 ± 4.8 | 66.9 | 81.3 | 1.00 |
+| `full-scan` | 631.7 ± 78.1 | 541.8 | 711.3 | 8.72 ± 1.39 |
+| `dirty-scan` | 72.5 ± 7.3 | 63.2 | 85.7 | 1.00 |
diff --git a/cli-bin/docs/cli_cheatsheet.md b/cli-bin/docs/cli_cheatsheet.md
new file mode 100644
index 0000000..f9297c7
--- /dev/null
+++ b/cli-bin/docs/cli_cheatsheet.md
@@ -0,0 +1,23 @@
+| Command | Flags |
+| ------- | ----- |
+| `link add` | --type |
+| `link rm` | --type |
+| `link list` | --direction, --type |
+| `link backlinks` | — |
+| `coll create` | — |
+| `coll add` | — |
+| `coll list` | — |
+| `view save` | — |
+| `view list` | — |
+| `view exec` | — |
+| `state set` | — |
+| `state transitions-add` | — |
+| `state log` | — |
+| `task scan` | — |
+| `task list` | --due-today |
+| `remind set` | — |
+| `annotate add` | --range, --highlight |
+| `annotate list` | — |
+| `version diff` | — |
+| `event add` | — |
+| `event timeline` | — |
diff --git a/run_all_tests.sh b/run_all_tests.sh
old mode 100644
new mode 100755
diff --git a/target/.rustc_info.json b/target/.rustc_info.json
index db53717..32ad72f 100644
--- a/target/.rustc_info.json
+++ b/target/.rustc_info.json
@@ -1 +1 @@
-{"rustc_fingerprint":490527502257410439,"outputs":{"17747080675513052775":{"success":true,"status":"","code":0,"stdout":"rustc 1.87.0 (17067e9ac 2025-05-09)\nbinary: rustc\ncommit-hash: 17067e9ac6d7ecb70e50f92c1944e545188d2359\ncommit-date: 2025-05-09\nhost: x86_64-unknown-linux-gnu\nrelease: 1.87.0\nLLVM version: 20.1.1\n","stderr":""}},"successes":{}}
\ No newline at end of file
+{"rustc_fingerprint":490527502257410439,"outputs":{"17747080675513052775":{"success":true,"status":"","code":0,"stdout":"rustc 1.87.0 (17067e9ac 2025-05-09)\nbinary: rustc\ncommit-hash: 17067e9ac6d7ecb70e50f92c1944e545188d2359\ncommit-date: 2025-05-09\nhost: x86_64-unknown-linux-gnu\nrelease: 1.87.0\nLLVM version: 20.1.1\n","stderr":""},"7971740275564407648":{"success":true,"status":"","code":0,"stdout":"___\nlib___.rlib\nlib___.so\nlib___.so\nlib___.a\nlib___.so\n/home/user/.rustup/toolchains/stable-x86_64-unknown-linux-gnu\noff\npacked\nunpacked\n___\ndebug_assertions\npanic=\"unwind\"\nproc_macro\ntarget_abi=\"\"\ntarget_arch=\"x86_64\"\ntarget_endian=\"little\"\ntarget_env=\"gnu\"\ntarget_family=\"unix\"\ntarget_feature=\"fxsr\"\ntarget_feature=\"sse\"\ntarget_feature=\"sse2\"\ntarget_has_atomic=\"16\"\ntarget_has_atomic=\"32\"\ntarget_has_atomic=\"64\"\ntarget_has_atomic=\"8\"\ntarget_has_atomic=\"ptr\"\ntarget_os=\"linux\"\ntarget_pointer_width=\"64\"\ntarget_vendor=\"unknown\"\nunix\n","stderr":""},"10431901537437931773":{"success":true,"status":"","code":0,"stdout":"___\nlib___.rlib\nlib___.so\nlib___.so\nlib___.a\nlib___.so\n/home/user/.rustup/toolchains/stable-x86_64-unknown-linux-gnu\noff\npacked\nunpacked\n___\ndebug_assertions\npanic=\"unwind\"\nproc_macro\ntarget_abi=\"\"\ntarget_arch=\"x86_64\"\ntarget_endian=\"little\"\ntarget_env=\"gnu\"\ntarget_family=\"unix\"\ntarget_feature=\"fxsr\"\ntarget_feature=\"sse\"\ntarget_feature=\"sse2\"\ntarget_has_atomic=\"16\"\ntarget_has_atomic=\"32\"\ntarget_has_atomic=\"64\"\ntarget_has_atomic=\"8\"\ntarget_has_atomic=\"ptr\"\ntarget_os=\"linux\"\ntarget_pointer_width=\"64\"\ntarget_vendor=\"unknown\"\ntarpaulin\nunix\n","stderr":""}},"successes":{}}
\ No newline at end of file
diff --git a/target/release/marlin b/target/release/marlin
old mode 100644
new mode 100755
index e69de29..f91dd5c
Binary files a/target/release/marlin and b/target/release/marlin differ
diff --git a/target/release/marlin.d b/target/release/marlin.d
index 5e14229..9ceab2b 100644
--- a/target/release/marlin.d
+++ b/target/release/marlin.d
@@ -1 +1 @@
-/workspace/Marlin/target/release/marlin: /workspace/Marlin/cli-bin/build.rs /workspace/Marlin/cli-bin/src/cli/annotate.rs /workspace/Marlin/cli-bin/src/cli/coll.rs /workspace/Marlin/cli-bin/src/cli/event.rs /workspace/Marlin/cli-bin/src/cli/link.rs /workspace/Marlin/cli-bin/src/cli/remind.rs /workspace/Marlin/cli-bin/src/cli/state.rs /workspace/Marlin/cli-bin/src/cli/task.rs /workspace/Marlin/cli-bin/src/cli/version.rs /workspace/Marlin/cli-bin/src/cli/view.rs /workspace/Marlin/cli-bin/src/cli/watch.rs /workspace/Marlin/cli-bin/src/cli.rs /workspace/Marlin/cli-bin/src/main.rs /workspace/Marlin/libmarlin/src/backup.rs /workspace/Marlin/libmarlin/src/config.rs /workspace/Marlin/libmarlin/src/db/database.rs /workspace/Marlin/libmarlin/src/db/migrations/0001_initial_schema.sql /workspace/Marlin/libmarlin/src/db/migrations/0002_update_fts_and_triggers.sql /workspace/Marlin/libmarlin/src/db/migrations/0003_create_links_collections_views.sql /workspace/Marlin/libmarlin/src/db/migrations/0004_fix_hierarchical_tags_fts.sql /workspace/Marlin/libmarlin/src/db/migrations/0005_add_dirty_table.sql /workspace/Marlin/libmarlin/src/db/mod.rs /workspace/Marlin/libmarlin/src/error.rs /workspace/Marlin/libmarlin/src/lib.rs /workspace/Marlin/libmarlin/src/logging.rs /workspace/Marlin/libmarlin/src/scan.rs /workspace/Marlin/libmarlin/src/utils.rs /workspace/Marlin/libmarlin/src/watcher.rs
+/home/user/Documents/GitHub/Marlin/target/release/marlin: /home/user/Documents/GitHub/Marlin/cli-bin/build.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/annotate.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/coll.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/commands.yaml /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/event.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/link.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/remind.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/state.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/task.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/version.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/view.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli/watch.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/cli.rs /home/user/Documents/GitHub/Marlin/cli-bin/src/main.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/backup.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/config.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/db/database.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/db/migrations/0001_initial_schema.sql /home/user/Documents/GitHub/Marlin/libmarlin/src/db/migrations/0002_update_fts_and_triggers.sql /home/user/Documents/GitHub/Marlin/libmarlin/src/db/migrations/0003_create_links_collections_views.sql /home/user/Documents/GitHub/Marlin/libmarlin/src/db/migrations/0004_fix_hierarchical_tags_fts.sql /home/user/Documents/GitHub/Marlin/libmarlin/src/db/migrations/0005_add_dirty_table.sql /home/user/Documents/GitHub/Marlin/libmarlin/src/db/mod.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/error.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/lib.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/logging.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/scan.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/utils.rs /home/user/Documents/GitHub/Marlin/libmarlin/src/watcher.rs
diff --git a/tarpaulin-report.html b/tarpaulin-report.html
index 7f7aaf5..d65a084 100644
--- a/tarpaulin-report.html
+++ b/tarpaulin-report.html
@@ -118,8 +118,8 @@
 <body>
     <div id="root"></div>
     <script>
-        var data = {"files":[{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","build.rs"],"content":"// cli-bin/build.rs\n//\n// The CLI currently needs no build-time code-generation, but Cargo\n// insists on rerunning any build-script each compile.  Tell it to\n// rebuild only if this file itself changes.\n\nfn main() {\n    // If you later add code-gen (e.g. embed completions or YAML), add\n    // further `cargo:rerun-if-changed=\u003cpath\u003e` lines here.\n    println!(\"cargo:rerun-if-changed=build.rs\");\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","annotate.rs"],"content":"// src/cli/annotate.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum AnnotateCmd {\n    Add (ArgsAdd),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub note: String,\n    #[arg(long)] pub range: Option\u003cString\u003e,\n    #[arg(long)] pub highlight: bool,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsList { pub file_pattern: String }\n\npub fn run(cmd: \u0026AnnotateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        AnnotateCmd::Add(a)  =\u003e todo!(\"annotate add {:?}\", a),\n        AnnotateCmd::List(a) =\u003e todo!(\"annotate list {:?}\", a),\n    }\n}\n","traces":[{"line":23,"address":[2450848],"length":1,"stats":{"Line":0}},{"line":24,"address":[2450887],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","coll.rs"],"content":"//! `marlin coll …` – named collections of files (simple “playlists”).\n\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // local enum for text / json output\nuse libmarlin::db;        // core DB helpers from the library crate\n\n#[derive(Subcommand, Debug)]\npub enum CollCmd {\n    /// Create an empty collection\n    Create(CreateArgs),\n    /// Add files (glob) to a collection\n    Add(AddArgs),\n    /// List files inside a collection\n    List(ListArgs),\n}\n\n#[derive(Args, Debug)]\npub struct CreateArgs {\n    pub name: String,\n}\n\n#[derive(Args, Debug)]\npub struct AddArgs {\n    pub name: String,\n    pub file_pattern: String,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub name: String,\n}\n\n/// Look-up an existing collection **without** implicitly creating it.\n///\n/// Returns the collection ID or an error if it doesn’t exist.\nfn lookup_collection_id(conn: \u0026Connection, name: \u0026str) -\u003e anyhow::Result\u003ci64\u003e {\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        [name],\n        |r| r.get(0),\n    )\n    .map_err(|_| anyhow::anyhow!(\"collection not found: {}\", name))\n}\n\npub fn run(cmd: \u0026CollCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── coll create ──────────────────────────────────────────── */\n        CollCmd::Create(a) =\u003e {\n            db::ensure_collection(conn, \u0026a.name)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Created collection '{}'\", a.name);\n            }\n        }\n\n        /* ── coll add ─────────────────────────────────────────────── */\n        CollCmd::Add(a) =\u003e {\n            // Fail if the target collection does not yet exist\n            let coll_id = lookup_collection_id(conn, \u0026a.name)?;\n\n            let like = a.file_pattern.replace('*', \"%\");\n            let mut stmt = conn.prepare(\"SELECT id FROM files WHERE path LIKE ?1\")?;\n            let ids: Vec\u003ci64\u003e = stmt\n                .query_map([\u0026like], |r| r.get::\u003c_, i64\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            for fid in \u0026ids {\n                db::add_file_to_collection(conn, coll_id, *fid)?;\n            }\n\n            match fmt {\n                Format::Text =\u003e println!(\"Added {} file(s) → '{}'\", ids.len(), a.name),\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\n                            \"{{\\\"collection\\\":\\\"{}\\\",\\\"added\\\":{}}}\",\n                            a.name,\n                            ids.len()\n                        );\n                    }\n                }\n            }\n        }\n\n        /* ── coll list ────────────────────────────────────────────── */\n        CollCmd::List(a) =\u003e {\n            let files = db::list_collection(conn, \u0026a.name)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for f in files {\n                        println!(\"{f}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026files)?);\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":38,"address":[2169520],"length":1,"stats":{"Line":0}},{"line":39,"address":[2169565],"length":1,"stats":{"Line":0}},{"line":41,"address":[2169545],"length":1,"stats":{"Line":0}},{"line":42,"address":[2296672,2296656],"length":1,"stats":{"Line":0}},{"line":44,"address":[2296704,2296721],"length":1,"stats":{"Line":0}},{"line":47,"address":[2169632,2171921,2171991],"length":1,"stats":{"Line":0}},{"line":48,"address":[2169683],"length":1,"stats":{"Line":0}},{"line":50,"address":[2169766],"length":1,"stats":{"Line":0}},{"line":51,"address":[2169783,2170057],"length":1,"stats":{"Line":0}},{"line":52,"address":[2170122],"length":1,"stats":{"Line":0}},{"line":53,"address":[2170138],"length":1,"stats":{"Line":0}},{"line":58,"address":[2169858],"length":1,"stats":{"Line":0}},{"line":60,"address":[2170255,2169866],"length":1,"stats":{"Line":0}},{"line":62,"address":[2170320],"length":1,"stats":{"Line":0}},{"line":63,"address":[2170443,2170372,2171981],"length":1,"stats":{"Line":0}},{"line":64,"address":[2170775,2171932,2170882,2170990,2171195],"length":1,"stats":{"Line":0}},{"line":65,"address":[2170767,2170926],"length":1,"stats":{"Line":0}},{"line":68,"address":[2171293,2171376],"length":1,"stats":{"Line":0}},{"line":69,"address":[2171486,2171767],"length":1,"stats":{"Line":0}},{"line":72,"address":[2171515],"length":1,"stats":{"Line":0}},{"line":73,"address":[2171558],"length":1,"stats":{"Line":0}},{"line":88,"address":[2169940],"length":1,"stats":{"Line":0}},{"line":89,"address":[2169952,2172004,2172061],"length":1,"stats":{"Line":0}},{"line":90,"address":[2172165],"length":1,"stats":{"Line":0}},{"line":92,"address":[2172197,2172440,2172305],"length":1,"stats":{"Line":0}},{"line":93,"address":[2172509,2172602],"length":1,"stats":{"Line":0}},{"line":105,"address":[2170227],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":27},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","event.rs"],"content":"// src/cli/event.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum EventCmd {\n    Add     (ArgsAdd),\n    Timeline,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub date: String,\n    pub description: String,\n}\n\npub fn run(cmd: \u0026EventCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        EventCmd::Add(a)      =\u003e todo!(\"event add {:?}\", a),\n        EventCmd::Timeline    =\u003e todo!(\"event timeline\"),\n    }\n}\n","traces":[{"line":19,"address":[2433520],"length":1,"stats":{"Line":0}},{"line":20,"address":[2433559],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","link.rs"],"content":"//! src/cli/link.rs – manage typed relationships between files\n\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector\nuse libmarlin::db;        // ← switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum LinkCmd {\n    Add(LinkArgs),\n    Rm (LinkArgs),\n    List(ListArgs),\n    Backlinks(BacklinksArgs),\n}\n\n#[derive(Args, Debug)]\npub struct LinkArgs {\n    pub from: String,\n    pub to:   String,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub pattern: String,\n    #[arg(long)]\n    pub direction: Option\u003cString\u003e,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct BacklinksArgs {\n    pub pattern: String,\n}\n\npub fn run(cmd: \u0026LinkCmd, conn: \u0026mut Connection, format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        LinkCmd::Add(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::add_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Linked '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Linked '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::Rm(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::remove_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Removed link '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Removed link '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::List(args) =\u003e {\n            let results = db::list_links(\n                conn,\n                \u0026args.pattern,\n                args.direction.as_deref(),\n                args.r#type.as_deref(),\n            )?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, dst, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\n                                \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                                src, dst, typ\n                            )\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, dst, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} → {} [type='{}']\", src, dst, t);\n                        } else {\n                            println!(\"{} → {}\", src, dst);\n                        }\n                    }\n                }\n            }\n        }\n        LinkCmd::Backlinks(args) =\u003e {\n            let results = db::find_backlinks(conn, \u0026args.pattern)?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\"{{\\\"from\\\":\\\"{}\\\",\\\"type\\\":{}}}\", src, typ)\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} [type='{}']\", src, t);\n                        } else {\n                            println!(\"{}\", src);\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":39,"address":[2065785,2063952,2065779],"length":1,"stats":{"Line":0}},{"line":40,"address":[2064009],"length":1,"stats":{"Line":0}},{"line":41,"address":[2064086],"length":1,"stats":{"Line":0}},{"line":42,"address":[2064644,2064106],"length":1,"stats":{"Line":0}},{"line":43,"address":[2064715],"length":1,"stats":{"Line":0}},{"line":44,"address":[2064854],"length":1,"stats":{"Line":0}},{"line":45,"address":[2064991],"length":1,"stats":{"Line":0}},{"line":47,"address":[2065109],"length":1,"stats":{"Line":0}},{"line":48,"address":[2065179],"length":1,"stats":{"Line":0}},{"line":50,"address":[2065393],"length":1,"stats":{"Line":0}},{"line":54,"address":[2065012],"length":1,"stats":{"Line":0}},{"line":57,"address":[2422784,2422805],"length":1,"stats":{"Line":0}},{"line":58,"address":[2422924,2422912],"length":1,"stats":{"Line":0}},{"line":59,"address":[2065079,2065609],"length":1,"stats":{"Line":0}},{"line":66,"address":[2064187],"length":1,"stats":{"Line":0}},{"line":67,"address":[2064207,2065814],"length":1,"stats":{"Line":0}},{"line":68,"address":[2065882],"length":1,"stats":{"Line":0}},{"line":69,"address":[2066021],"length":1,"stats":{"Line":0}},{"line":70,"address":[2066158],"length":1,"stats":{"Line":0}},{"line":72,"address":[2066276],"length":1,"stats":{"Line":0}},{"line":73,"address":[2066346],"length":1,"stats":{"Line":0}},{"line":75,"address":[2066560],"length":1,"stats":{"Line":0}},{"line":79,"address":[2066179],"length":1,"stats":{"Line":0}},{"line":82,"address":[2422981,2422960],"length":1,"stats":{"Line":0}},{"line":83,"address":[2423100,2423088],"length":1,"stats":{"Line":0}},{"line":84,"address":[2066764,2066246],"length":1,"stats":{"Line":0}},{"line":91,"address":[2064288],"length":1,"stats":{"Line":0}},{"line":94,"address":[2064308],"length":1,"stats":{"Line":0}},{"line":95,"address":[2064337],"length":1,"stats":{"Line":0}},{"line":96,"address":[2064371],"length":1,"stats":{"Line":0}},{"line":98,"address":[2067095],"length":1,"stats":{"Line":0}},{"line":100,"address":[2068413,2067108],"length":1,"stats":{"Line":0}},{"line":102,"address":[2423161,2423710,2423136],"length":1,"stats":{"Line":0}},{"line":103,"address":[2423214,2423289],"length":1,"stats":{"Line":0}},{"line":105,"address":[2423765,2423744],"length":1,"stats":{"Line":0}},{"line":106,"address":[2423884,2423872],"length":1,"stats":{"Line":0}},{"line":107,"address":[2423323,2423385],"length":1,"stats":{"Line":0}},{"line":113,"address":[2068526,2068443],"length":1,"stats":{"Line":0}},{"line":116,"address":[2067174,2067278,2067405],"length":1,"stats":{"Line":0}},{"line":117,"address":[2067665,2067598],"length":1,"stats":{"Line":0}},{"line":118,"address":[2067806,2067705],"length":1,"stats":{"Line":0}},{"line":120,"address":[2068085,2067732],"length":1,"stats":{"Line":0}},{"line":126,"address":[2064525],"length":1,"stats":{"Line":0}},{"line":127,"address":[2068818,2064537,2068761],"length":1,"stats":{"Line":0}},{"line":128,"address":[2068922],"length":1,"stats":{"Line":0}},{"line":130,"address":[2068935,2070060],"length":1,"stats":{"Line":0}},{"line":132,"address":[2423920,2423945,2424376],"length":1,"stats":{"Line":0}},{"line":133,"address":[2424052,2423980],"length":1,"stats":{"Line":0}},{"line":135,"address":[2424400,2424421],"length":1,"stats":{"Line":0}},{"line":136,"address":[2424540,2424528],"length":1,"stats":{"Line":0}},{"line":137,"address":[2424083,2424145],"length":1,"stats":{"Line":0}},{"line":140,"address":[2070090,2070173],"length":1,"stats":{"Line":0}},{"line":143,"address":[2069248,2069113,2069005],"length":1,"stats":{"Line":0}},{"line":144,"address":[2069464,2069393],"length":1,"stats":{"Line":0}},{"line":145,"address":[2069504,2069605],"length":1,"stats":{"Line":0}},{"line":147,"address":[2069531,2069841],"length":1,"stats":{"Line":0}},{"line":155,"address":[2065540],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":57},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","remind.rs"],"content":"// src/cli/remind.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum RemindCmd {\n    Set(ArgsSet),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet {\n    pub file_pattern: String,\n    pub timestamp:    String,\n    pub message:      String,\n}\n\npub fn run(cmd: \u0026RemindCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        RemindCmd::Set(a) =\u003e todo!(\"remind set {:?}\", a),\n    }\n}\n","traces":[{"line":18,"address":[2142944],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","state.rs"],"content":"// src/cli/state.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum StateCmd {\n    Set(ArgsSet),\n    TransitionsAdd(ArgsTrans),\n    Log(ArgsLog),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet   { pub file_pattern: String, pub new_state: String }\n#[derive(Args, Debug)]\npub struct ArgsTrans { pub from_state: String,   pub to_state: String }\n#[derive(Args, Debug)]\npub struct ArgsLog   { pub file_pattern: String }\n\npub fn run(cmd: \u0026StateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        StateCmd::Set(a)           =\u003e todo!(\"state set {:?}\", a),\n        StateCmd::TransitionsAdd(a)=\u003e todo!(\"state transitions-add {:?}\", a),\n        StateCmd::Log(a)           =\u003e todo!(\"state log {:?}\", a),\n    }\n}\n","traces":[{"line":20,"address":[2474816],"length":1,"stats":{"Line":0}},{"line":21,"address":[2474855],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","task.rs"],"content":"// src/cli/task.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum TaskCmd {\n    Scan(ArgsScan),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsScan { pub directory: String }\n#[derive(Args, Debug)]\npub struct ArgsList { #[arg(long)] pub due_today: bool }\n\npub fn run(cmd: \u0026TaskCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        TaskCmd::Scan(a) =\u003e todo!(\"task scan {:?}\", a),\n        TaskCmd::List(a) =\u003e todo!(\"task list {:?}\", a),\n    }\n}\n","traces":[{"line":17,"address":[2403248],"length":1,"stats":{"Line":0}},{"line":18,"address":[2403287],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","version.rs"],"content":"// src/cli/version.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum VersionCmd {\n    Diff(ArgsDiff),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsDiff { pub file: String }\n\npub fn run(cmd: \u0026VersionCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        VersionCmd::Diff(a) =\u003e todo!(\"version diff {:?}\", a),\n    }\n}\n","traces":[{"line":14,"address":[2314960],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","view.rs"],"content":"//! `marlin view …` – save \u0026 use “smart folders” (named queries).\n\nuse std::fs;\n\nuse anyhow::Result;\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector stays local\nuse libmarlin::db;        // ← path switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum ViewCmd {\n    /// Save (or update) a view\n    Save(ArgsSave),\n    /// List all saved views\n    List,\n    /// Execute a view (print matching paths)\n    Exec(ArgsExec),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSave {\n    pub view_name: String,\n    pub query: String,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsExec {\n    pub view_name: String,\n}\n\npub fn run(cmd: \u0026ViewCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── view save ───────────────────────────────────────────── */\n        ViewCmd::Save(a) =\u003e {\n            db::save_view(conn, \u0026a.view_name, \u0026a.query)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Saved view '{}' = {}\", a.view_name, a.query);\n            }\n        }\n\n        /* ── view list ───────────────────────────────────────────── */\n        ViewCmd::List =\u003e {\n            let views = db::list_views(conn)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for (name, q) in views {\n                        println!(\"{name}: {q}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026views)?);\n                    }\n                }\n            }\n        }\n\n        /* ── view exec ───────────────────────────────────────────── */\n        ViewCmd::Exec(a) =\u003e {\n            let raw = db::view_query(conn, \u0026a.view_name)?;\n\n            // Re-use the tiny parser from marlin search\n            let fts_expr = build_fts_match(\u0026raw);\n\n            let mut stmt = conn.prepare(\n                r#\"\n                SELECT f.path\n                  FROM files_fts\n                  JOIN files f ON f.rowid = files_fts.rowid\n                 WHERE files_fts MATCH ?1\n                 ORDER BY rank\n                \"#,\n            )?;\n            let mut paths: Vec\u003cString\u003e = stmt\n                .query_map([fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            /* ── NEW: graceful fallback when FTS finds nothing ───── */\n            if paths.is_empty() \u0026\u0026 !raw.contains(':') {\n                paths = naive_search(conn, \u0026raw)?;\n            }\n\n            if paths.is_empty() \u0026\u0026 matches!(fmt, Format::Text) {\n                eprintln!(\"(view '{}' has no matches)\", a.view_name);\n            } else {\n                for p in paths {\n                    println!(\"{p}\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\n/* ─── naive substring path/content search (≤ 64 kB files) ───────── */\n\nfn naive_search(conn: \u0026Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let term_lc = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut hits = Vec::new();\n    for p in rows {\n        let p = p?;\n        /* path match */\n        if p.to_lowercase().contains(\u0026term_lc) {\n            hits.push(p);\n            continue;\n        }\n        /* small-file content match */\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 64_000 {\n                continue;\n            }\n        }\n        if let Ok(content) = fs::read_to_string(\u0026p) {\n            if content.to_lowercase().contains(\u0026term_lc) {\n                hits.push(p);\n            }\n        }\n    }\n    Ok(hits)\n}\n\n/* ─── minimal copy of search-string → FTS5 translator ───────────── */\n\nfn build_fts_match(raw_query: \u0026str) -\u003e String {\n    use shlex;\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 {\n                    parts.push(\"AND\".into());\n                }\n                parts.push(format!(\"tags_text:{}\", escape(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n            }\n        } else {\n            parts.push(escape(\u0026tok));\n        }\n    }\n    parts.join(\" \")\n}\n\nfn escape(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n","traces":[{"line":33,"address":[2363246,2361648,2363240],"length":1,"stats":{"Line":0}},{"line":34,"address":[2361705],"length":1,"stats":{"Line":0}},{"line":36,"address":[2361821],"length":1,"stats":{"Line":0}},{"line":37,"address":[2362169,2361829],"length":1,"stats":{"Line":0}},{"line":38,"address":[2362218],"length":1,"stats":{"Line":0}},{"line":39,"address":[2362241],"length":1,"stats":{"Line":0}},{"line":45,"address":[2361956,2362416,2362470],"length":1,"stats":{"Line":0}},{"line":46,"address":[2362574],"length":1,"stats":{"Line":0}},{"line":48,"address":[2362849,2362714,2362606],"length":1,"stats":{"Line":0}},{"line":49,"address":[2363043,2362950],"length":1,"stats":{"Line":0}},{"line":62,"address":[2362045],"length":1,"stats":{"Line":0}},{"line":63,"address":[2362062,2363307],"length":1,"stats":{"Line":0}},{"line":66,"address":[2363500,2363421],"length":1,"stats":{"Line":0}},{"line":68,"address":[2363523,2363588,2365825,2363710],"length":1,"stats":{"Line":0}},{"line":77,"address":[2364175,2364067,2365777,2364384,2364000],"length":1,"stats":{"Line":0}},{"line":78,"address":[2096051,2096016],"length":1,"stats":{"Line":0}},{"line":82,"address":[2364598,2364490,2364558,2365008],"length":1,"stats":{"Line":0}},{"line":83,"address":[2364869,2364663,2365017],"length":1,"stats":{"Line":0}},{"line":86,"address":[2365078,2365161,2364564],"length":1,"stats":{"Line":0}},{"line":87,"address":[2365177],"length":1,"stats":{"Line":0}},{"line":89,"address":[2365084,2365421,2365286],"length":1,"stats":{"Line":0}},{"line":90,"address":[2365490,2365659],"length":1,"stats":{"Line":0}},{"line":95,"address":[2362388],"length":1,"stats":{"Line":0}},{"line":100,"address":[2367885,2365904,2368916],"length":1,"stats":{"Line":0}},{"line":101,"address":[2365985],"length":1,"stats":{"Line":0}},{"line":102,"address":[2368914,2366105,2366034],"length":1,"stats":{"Line":0}},{"line":103,"address":[2096115,2096080],"length":1,"stats":{"Line":0}},{"line":105,"address":[2366708],"length":1,"stats":{"Line":0}},{"line":106,"address":[2366768,2366936,2366860,2368590],"length":1,"stats":{"Line":0}},{"line":107,"address":[2367037,2367202],"length":1,"stats":{"Line":0}},{"line":109,"address":[2367488,2367420],"length":1,"stats":{"Line":0}},{"line":110,"address":[2368673],"length":1,"stats":{"Line":0}},{"line":114,"address":[2367657,2367767],"length":1,"stats":{"Line":0}},{"line":115,"address":[2367774,2367835],"length":1,"stats":{"Line":0}},{"line":119,"address":[2367982,2367891],"length":1,"stats":{"Line":0}},{"line":120,"address":[2368030,2368101],"length":1,"stats":{"Line":0}},{"line":121,"address":[2368289],"length":1,"stats":{"Line":0}},{"line":125,"address":[2367090],"length":1,"stats":{"Line":0}},{"line":130,"address":[2368944,2370638,2372260],"length":1,"stats":{"Line":0}},{"line":132,"address":[2368999],"length":1,"stats":{"Line":0}},{"line":133,"address":[2096144,2096178],"length":1,"stats":{"Line":0}},{"line":134,"address":[2369311,2369149,2372214],"length":1,"stats":{"Line":0}},{"line":135,"address":[2369396,2369611],"length":1,"stats":{"Line":0}},{"line":136,"address":[2372201,2369709],"length":1,"stats":{"Line":0}},{"line":137,"address":[2369802,2369686],"length":1,"stats":{"Line":0}},{"line":138,"address":[2096416,2096430],"length":1,"stats":{"Line":0}},{"line":139,"address":[2370204],"length":1,"stats":{"Line":0}},{"line":140,"address":[2370259],"length":1,"stats":{"Line":0}},{"line":142,"address":[2370252,2370333],"length":1,"stats":{"Line":0}},{"line":144,"address":[2370660,2369968],"length":1,"stats":{"Line":0}},{"line":145,"address":[2370782],"length":1,"stats":{"Line":0}},{"line":146,"address":[2370840],"length":1,"stats":{"Line":0}},{"line":147,"address":[2370949],"length":1,"stats":{"Line":0}},{"line":148,"address":[2371130,2371095],"length":1,"stats":{"Line":0}},{"line":149,"address":[2371430],"length":1,"stats":{"Line":0}},{"line":150,"address":[2371520],"length":1,"stats":{"Line":0}},{"line":152,"address":[2371832,2371120],"length":1,"stats":{"Line":0}},{"line":155,"address":[2370820,2372155],"length":1,"stats":{"Line":0}},{"line":158,"address":[2369441],"length":1,"stats":{"Line":0}},{"line":161,"address":[2372288,2372656,2372650],"length":1,"stats":{"Line":0}},{"line":162,"address":[2096492,2096464],"length":1,"stats":{"Line":0}},{"line":163,"address":[2372621,2372484,2372366],"length":1,"stats":{"Line":0}},{"line":165,"address":[2372417,2372669],"length":1,"stats":{"Line":0}},{"line":167,"address":[2372613],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":64},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","watch.rs"],"content":"// src/cli/watch.rs\n\nuse anyhow::Result;\nuse clap::Subcommand;\nuse libmarlin::watcher::{WatcherConfig, WatcherState};\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse std::sync::Arc;\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tracing::info;\n\n/// Commands related to file watching functionality\n#[derive(Subcommand, Debug)]\npub enum WatchCmd {\n    /// Start watching a directory for changes\n    Start {\n        /// Directory to watch (defaults to current directory)\n        #[arg(default_value = \".\")]\n        path: PathBuf,\n        \n        /// Debounce window in milliseconds (default: 100ms)\n        #[arg(long, default_value = \"100\")]\n        debounce_ms: u64,\n    },\n    \n    /// Show status of currently active watcher\n    Status,\n    \n    /// Stop the currently running watcher\n    Stop,\n}\n\n/// Run a watch command\npub fn run(cmd: \u0026WatchCmd, _conn: \u0026mut Connection, _format: super::Format) -\u003e Result\u003c()\u003e {\n    match cmd {\n        WatchCmd::Start { path, debounce_ms } =\u003e {\n            let mut marlin = libmarlin::Marlin::open_default()?;\n            let config = WatcherConfig {\n                debounce_ms: *debounce_ms,\n                ..Default::default()\n            };\n            let canon_path = path.canonicalize().unwrap_or_else(|_| path.clone());\n            info!(\"Starting watcher for directory: {}\", canon_path.display());\n\n            let mut watcher = marlin.watch(\u0026canon_path, Some(config))?;\n            \n            let status = watcher.status();\n            info!(\"Watcher started. Press Ctrl+C to stop watching.\");\n            info!(\"Watching {} paths\", status.watched_paths.len());\n            \n            let start_time = Instant::now();\n            let mut last_status_time = Instant::now();\n            let running = Arc::new(AtomicBool::new(true));\n            let r_clone = running.clone();\n\n            ctrlc::set_handler(move || {\n                info!(\"Ctrl+C received. Signaling watcher to stop...\");\n                r_clone.store(false, Ordering::SeqCst);\n            })?;\n\n            info!(\"Watcher run loop started. Waiting for Ctrl+C or stop signal...\");\n            while running.load(Ordering::SeqCst) {\n                let current_status = watcher.status();\n                if current_status.state == WatcherState::Stopped {\n                    info!(\"Watcher has stopped (detected by state). Exiting loop.\");\n                    break;\n                }\n\n                // Corrected line: removed the extra closing parenthesis\n                if last_status_time.elapsed() \u003e Duration::from_secs(10) { \n                    let uptime = start_time.elapsed();\n                    info!(\n                        \"Watcher running for {}s, processed {} events, queue: {}, state: {:?}\",\n                        uptime.as_secs(),\n                        current_status.events_processed,\n                        current_status.queue_size,\n                        current_status.state\n                    );\n                    last_status_time = Instant::now();\n                }\n                thread::sleep(Duration::from_millis(200));\n            }\n\n            info!(\"Watcher run loop ended. Explicitly stopping watcher instance...\");\n            watcher.stop()?; \n            info!(\"Watcher instance fully stopped.\");\n            Ok(())\n        }\n        WatchCmd::Status =\u003e {\n            info!(\"Status command: No active watcher process to query in this CLI invocation model.\");\n            info!(\"To see live status, run 'marlin watch start' which prints periodic updates.\");\n            Ok(())\n        }\n        WatchCmd::Stop =\u003e {\n            info!(\"Stop command: No active watcher process to stop in this CLI invocation model.\");\n            info!(\"Please use Ctrl+C in the terminal where 'marlin watch start' is running.\");\n            Ok(())\n        }\n    }\n}","traces":[{"line":36,"address":[2338224,2347011,2346893],"length":1,"stats":{"Line":0}},{"line":37,"address":[2338281],"length":1,"stats":{"Line":0}},{"line":38,"address":[2338369],"length":1,"stats":{"Line":0}},{"line":39,"address":[2338397,2338535],"length":1,"stats":{"Line":0}},{"line":41,"address":[2338841],"length":1,"stats":{"Line":0}},{"line":44,"address":[2056512,2056533],"length":1,"stats":{"Line":0}},{"line":45,"address":[2339509,2339079,2339158],"length":1,"stats":{"Line":0}},{"line":47,"address":[2339423,2346982,2340089],"length":1,"stats":{"Line":0}},{"line":49,"address":[2340273],"length":1,"stats":{"Line":0}},{"line":50,"address":[2340412,2340336,2340708],"length":1,"stats":{"Line":0}},{"line":51,"address":[2341420,2340677,2341126],"length":1,"stats":{"Line":0}},{"line":53,"address":[2341936,2341391],"length":1,"stats":{"Line":0}},{"line":54,"address":[2341951],"length":1,"stats":{"Line":0}},{"line":55,"address":[2342012],"length":1,"stats":{"Line":0}},{"line":56,"address":[2342111,2342190],"length":1,"stats":{"Line":0}},{"line":58,"address":[2056624],"length":1,"stats":{"Line":0}},{"line":59,"address":[2056644,2056834],"length":1,"stats":{"Line":0}},{"line":60,"address":[2056794],"length":1,"stats":{"Line":0}},{"line":63,"address":[2342642,2342312],"length":1,"stats":{"Line":0}},{"line":64,"address":[2342612,2343061],"length":1,"stats":{"Line":0}},{"line":65,"address":[2343135],"length":1,"stats":{"Line":0}},{"line":66,"address":[2343162,2343242],"length":1,"stats":{"Line":0}},{"line":67,"address":[2343282,2344873,2344586],"length":1,"stats":{"Line":0}},{"line":72,"address":[2343248,2343328,2344526],"length":1,"stats":{"Line":0}},{"line":73,"address":[2343473],"length":1,"stats":{"Line":0}},{"line":74,"address":[2344056],"length":1,"stats":{"Line":0}},{"line":81,"address":[2344511,2343837],"length":1,"stats":{"Line":0}},{"line":83,"address":[2343448,2344546],"length":1,"stats":{"Line":0}},{"line":86,"address":[2343104,2345586,2345291],"length":1,"stats":{"Line":0}},{"line":87,"address":[2345556,2345999,2346866],"length":1,"stats":{"Line":0}},{"line":88,"address":[2346101,2346387],"length":1,"stats":{"Line":0}},{"line":89,"address":[2346353],"length":1,"stats":{"Line":0}},{"line":92,"address":[2347205,2338471,2347024],"length":1,"stats":{"Line":0}},{"line":93,"address":[2347740,2347574,2347173],"length":1,"stats":{"Line":0}},{"line":94,"address":[2347723],"length":1,"stats":{"Line":0}},{"line":97,"address":[2348109,2338503,2348290],"length":1,"stats":{"Line":0}},{"line":98,"address":[2348258,2348659,2348825],"length":1,"stats":{"Line":0}},{"line":99,"address":[2348808],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":38},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli.rs"],"content":"// src/cli.rs\n\npub mod link;\npub mod coll;\npub mod view;\npub mod state;\npub mod task;\npub mod remind;\npub mod annotate;\npub mod version;\npub mod event;\npub mod watch;\n\nuse clap::{Parser, Subcommand, ValueEnum};\nuse clap_complete::Shell;\n\n/// Output format for commands.\n#[derive(ValueEnum, Clone, Copy, Debug)]\npub enum Format {\n    Text,\n    Json,\n}\n\n/// Marlin – metadata-driven file explorer (CLI utilities)\n#[derive(Parser, Debug)]\n#[command(author, version, about, propagate_version = true)]\npub struct Cli {\n    /// Enable debug logging and extra output\n    #[arg(long)]\n    pub verbose: bool,\n\n    /// Output format (text or JSON)\n    #[arg(long, default_value = \"text\", value_enum, global = true)]\n    pub format: Format,\n\n    #[command(subcommand)]\n    pub command: Commands,\n}\n\n#[derive(Subcommand, Debug)]\npub enum Commands {\n    /// Initialise the database (idempotent)\n    Init,\n\n    /// Scan one or more directories and populate the file index\n    Scan {\n        /// Only re-index files marked dirty by `marlin watch`\n        #[arg(long)]\n        dirty: bool,\n\n        /// Directories to scan (defaults to cwd)\n        paths: Vec\u003cstd::path::PathBuf\u003e,\n    },\n\n    /// Tag files matching a glob pattern (hierarchical tags use `/`)\n    Tag {\n        /// Glob or path pattern\n        pattern: String,\n        /// Hierarchical tag name (`foo/bar`)\n        tag_path: String,\n    },\n\n    /// Manage custom attributes\n    Attr {\n        #[command(subcommand)]\n        action: AttrCmd,\n    },\n\n    /// Full-text search; `--exec CMD` runs CMD on each hit (`{}` placeholder)\n    Search {\n        query: String,\n        #[arg(long)]\n        exec: Option\u003cString\u003e,\n    },\n\n    /// Create a timestamped backup of the database\n    Backup,\n\n    /// Restore from a backup file (overwrites current DB)\n    Restore {\n        backup_path: std::path::PathBuf,\n    },\n\n    /// Generate shell completions (hidden)\n    #[command(hide = true)]\n    Completions {\n        /// Which shell to generate for\n        #[arg(value_enum)]\n        shell: Shell,\n    },\n\n    /// File-to-file links\n    #[command(subcommand)]\n    Link(link::LinkCmd),\n\n    /// Collections (groups) of files\n    #[command(subcommand)]\n    Coll(coll::CollCmd),\n\n    /// Smart views (saved queries)\n    #[command(subcommand)]\n    View(view::ViewCmd),\n\n    /// Workflow states on files\n    #[command(subcommand)]\n    State(state::StateCmd),\n\n    /// TODO/tasks management\n    #[command(subcommand)]\n    Task(task::TaskCmd),\n\n    /// Reminders on files\n    #[command(subcommand)]\n    Remind(remind::RemindCmd),\n\n    /// File annotations and highlights\n    #[command(subcommand)]\n    Annotate(annotate::AnnotateCmd),\n\n    /// Version diffs\n    #[command(subcommand)]\n    Version(version::VersionCmd),\n\n    /// Calendar events \u0026 timelines\n    #[command(subcommand)]\n    Event(event::EventCmd),\n\n    /// Watch directories for changes\n    #[command(subcommand)]\n    Watch(watch::WatchCmd),\n}\n\n#[derive(Subcommand, Debug)]\npub enum AttrCmd {\n    Set { pattern: String, key: String, value: String },\n    Ls  { path: std::path::PathBuf },\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","main.rs"],"content":"//! Marlin CLI entry-point (post crate-split)\n//!\n//! All heavy lifting now lives in the `libmarlin` crate; this file\n//! handles argument parsing, logging, orchestration and the few\n//! helpers that remain CLI-specific.\n\n#![deny(warnings)]\n\nmod cli; // sub-command definitions and argument structs\n\n/* ── shared modules re-exported from libmarlin ─────────────────── */\nuse libmarlin::{\n    config,\n    db,\n    logging,\n    scan,\n    utils::determine_scan_root,\n};\nuse libmarlin::db::take_dirty;\n\nuse anyhow::{Context, Result};\nuse clap::{CommandFactory, Parser};\nuse clap_complete::generate;\nuse glob::Pattern;\nuse shellexpand;\nuse shlex;\nuse std::{\n    env,\n    fs,\n    io,\n    path::Path,\n    process::Command,\n};\nuse tracing::{debug, error, info};\nuse walkdir::WalkDir;\n\nuse cli::{Cli, Commands};\n\nfn main() -\u003e Result\u003c()\u003e {\n    /* ── CLI parsing \u0026 logging ────────────────────────────────── */\n    let args = Cli::parse();\n    if args.verbose {\n        env::set_var(\"RUST_LOG\", \"debug\");\n    }\n    logging::init();\n\n    /* ── shell-completion shortcut ────────────────────────────── */\n    if let Commands::Completions { shell } = \u0026args.command {\n        let mut cmd = Cli::command();\n        generate(*shell, \u0026mut cmd, \"marlin\", \u0026mut io::stdout());\n        return Ok(());\n    }\n\n    /* ── config \u0026 automatic backup ───────────────────────────── */\n    let cfg = config::Config::load()?; // resolves DB path\n\n    match \u0026args.command {\n        Commands::Init | Commands::Backup | Commands::Restore { .. } =\u003e {}\n        _ =\u003e match db::backup(\u0026cfg.db_path) {\n            Ok(p)  =\u003e info!(\"Pre-command auto-backup created at {}\", p.display()),\n            Err(e) =\u003e error!(\"Failed to create pre-command auto-backup: {e}\"),\n        },\n    }\n\n    /* ── open DB (runs migrations) ───────────────────────────── */\n    let mut conn = db::open(\u0026cfg.db_path)?;\n\n    /* ── command dispatch ────────────────────────────────────── */\n    match args.command {\n        Commands::Completions { .. } =\u003e {} // handled above\n\n        /* ---- init ------------------------------------------------ */\n        Commands::Init =\u003e {\n            info!(\"Database initialised at {}\", cfg.db_path.display());\n            let cwd   = env::current_dir().context(\"getting current directory\")?;\n            let count = scan::scan_directory(\u0026mut conn, \u0026cwd)\n                .context(\"initial scan failed\")?;\n            info!(\"Initial scan complete – indexed/updated {count} files\");\n        }\n\n        /* ---- scan ------------------------------------------------ */\n        Commands::Scan { dirty, paths } =\u003e {\n            let scan_paths: Vec\u003cstd::path::PathBuf\u003e = if paths.is_empty() {\n                vec![env::current_dir()?]\n            } else {\n                paths.into_iter().collect()\n            };\n\n            if dirty {\n                let dirty_ids = take_dirty(\u0026conn)?;\n                for id in dirty_ids {\n                    let path: String = conn.query_row(\n                        \"SELECT path FROM files WHERE id = ?1\",\n                        [id],\n                        |r| r.get(0),\n                    )?;\n                    scan::scan_directory(\u0026mut conn, Path::new(\u0026path))?;\n                }\n            } else {\n                for p in scan_paths {\n                    scan::scan_directory(\u0026mut conn, \u0026p)?;\n                }\n            }\n        }\n\n        /* ---- tag / attribute / search --------------------------- */\n        Commands::Tag { pattern, tag_path } =\u003e\n            apply_tag(\u0026conn, \u0026pattern, \u0026tag_path)?,\n\n        Commands::Attr { action } =\u003e match action {\n            cli::AttrCmd::Set { pattern, key, value } =\u003e\n                attr_set(\u0026conn, \u0026pattern, \u0026key, \u0026value)?,\n            cli::AttrCmd::Ls { path } =\u003e\n                attr_ls(\u0026conn, \u0026path)?,\n        },\n\n        Commands::Search { query, exec } =\u003e\n            run_search(\u0026conn, \u0026query, exec)?,\n\n        /* ---- maintenance ---------------------------------------- */\n        Commands::Backup =\u003e {\n            let p = db::backup(\u0026cfg.db_path)?;\n            println!(\"Backup created: {}\", p.display());\n        }\n\n        Commands::Restore { backup_path } =\u003e {\n            drop(conn);\n            db::restore(\u0026backup_path, \u0026cfg.db_path).with_context(|| {\n                format!(\"Failed to restore DB from {}\", backup_path.display())\n            })?;\n            println!(\"Restored DB from {}\", backup_path.display());\n            db::open(\u0026cfg.db_path).with_context(|| {\n                format!(\"Could not open restored DB at {}\", cfg.db_path.display())\n            })?;\n            info!(\"Successfully opened restored database.\");\n        }\n\n        /* ---- passthrough sub-modules (some still stubs) ---------- */\n        Commands::Link(link_cmd)   =\u003e cli::link::run(\u0026link_cmd,   \u0026mut conn, args.format)?,\n        Commands::Coll(coll_cmd)   =\u003e cli::coll::run(\u0026coll_cmd,   \u0026mut conn, args.format)?,\n        Commands::View(view_cmd)   =\u003e cli::view::run(\u0026view_cmd,   \u0026mut conn, args.format)?,\n        Commands::State(state_cmd) =\u003e cli::state::run(\u0026state_cmd, \u0026mut conn, args.format)?,\n        Commands::Task(task_cmd)   =\u003e cli::task::run(\u0026task_cmd,   \u0026mut conn, args.format)?,\n        Commands::Remind(rm_cmd)   =\u003e cli::remind::run(\u0026rm_cmd,   \u0026mut conn, args.format)?,\n        Commands::Annotate(a_cmd)  =\u003e cli::annotate::run(\u0026a_cmd,  \u0026mut conn, args.format)?,\n        Commands::Version(v_cmd)   =\u003e cli::version::run(\u0026v_cmd,   \u0026mut conn, args.format)?,\n        Commands::Event(e_cmd)     =\u003e cli::event::run(\u0026e_cmd,     \u0026mut conn, args.format)?,\n        Commands::Watch(watch_cmd) =\u003e cli::watch::run(\u0026watch_cmd, \u0026mut conn, args.format)?,\n    }\n\n    Ok(())\n}\n\n/* ─────────────────── helpers \u0026 sub-routines ─────────────────── */\n\n/* ---------- TAGS ---------- */\nfn apply_tag(conn: \u0026rusqlite::Connection, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003c()\u003e {\n    let leaf_tag_id = db::ensure_tag_path(conn, tag_path)?;\n    let mut tag_ids = Vec::new();\n    let mut current = Some(leaf_tag_id);\n    while let Some(id) = current {\n        tag_ids.push(id);\n        current = conn.query_row(\n            \"SELECT parent_id FROM tags WHERE id=?1\",\n            [id],\n            |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n        )?;\n    }\n\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file   = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut stmt_insert = conn.prepare(\n        \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n    )?;\n\n    let mut count = 0usize;\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                let mut newly = false;\n                for \u0026tid in \u0026tag_ids {\n                    if stmt_insert.execute([fid, tid])? \u003e 0 {\n                        newly = true;\n                    }\n                }\n                if newly {\n                    info!(file=%p, tag=tag_path, \"tagged\");\n                    count += 1;\n                }\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Applied tag '{}' to {} file(s).\", tag_path, count);\n    Ok(())\n}\n\n/* ---------- ATTRIBUTES ---------- */\nfn attr_set(conn: \u0026rusqlite::Connection, pattern: \u0026str, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut count = 0usize;\n\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                db::upsert_attr(conn, fid, key, value)?;\n                info!(file=%p, key, value, \"attr set\");\n                count += 1;\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Attribute '{}={}' set on {} file(s).\", key, value, count);\n    Ok(())\n}\n\nfn attr_ls(conn: \u0026rusqlite::Connection, path: \u0026Path) -\u003e Result\u003c()\u003e {\n    let fid = db::file_id(conn, \u0026path.to_string_lossy())?;\n    let mut stmt = conn.prepare(\n        \"SELECT key, value FROM attributes WHERE file_id=?1 ORDER BY key\"\n    )?;\n    for row in stmt\n        .query_map([fid], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?\n    {\n        let (k, v) = row?;\n        println!(\"{k} = {v}\");\n    }\n    Ok(())\n}\n\n/* ---------- SEARCH ---------- */\nfn run_search(conn: \u0026rusqlite::Connection, raw_query: \u0026str, exec: Option\u003cString\u003e) -\u003e Result\u003c()\u003e {\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 { parts.push(\"AND\".into()); }\n                parts.push(format!(\"tags_text:{}\", escape_fts(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape_fts(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n            }\n        } else {\n            parts.push(escape_fts(\u0026tok));\n        }\n    }\n    let fts_expr = parts.join(\" \");\n    debug!(\"FTS MATCH expression: {fts_expr}\");\n\n    let mut stmt = conn.prepare(\n        r#\"\n        SELECT f.path\n          FROM files_fts\n          JOIN files f ON f.rowid = files_fts.rowid\n         WHERE files_fts MATCH ?1\n         ORDER BY rank\n        \"#,\n    )?;\n    let mut hits: Vec\u003cString\u003e = stmt\n        .query_map([\u0026fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n        .filter_map(Result::ok)\n        .collect();\n\n    if hits.is_empty() \u0026\u0026 !raw_query.contains(':') {\n        hits = naive_substring_search(conn, raw_query)?;\n    }\n\n    if let Some(cmd_tpl) = exec {\n        run_exec(\u0026hits, \u0026cmd_tpl)?;\n    } else {\n        if hits.is_empty() {\n            eprintln!(\n                \"No matches for query: `{raw_query}` (FTS expr: `{fts_expr}`)\"\n            );\n        } else {\n            for p in hits { println!(\"{p}\"); }\n        }\n    }\n    Ok(())\n}\n\nfn naive_substring_search(conn: \u0026rusqlite::Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let needle = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut out = Vec::new();\n    for p in rows {\n        let p = p?;\n        if p.to_lowercase().contains(\u0026needle) {\n            out.push(p.clone());\n            continue;\n        }\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 65_536 { continue; }\n        }\n        if let Ok(body) = fs::read_to_string(\u0026p) {\n            if body.to_lowercase().contains(\u0026needle) {\n                out.push(p);\n            }\n        }\n    }\n    Ok(out)\n}\n\nfn run_exec(paths: \u0026[String], cmd_tpl: \u0026str) -\u003e Result\u003c()\u003e {\n    let mut ran_without_placeholder = false;\n\n    if paths.is_empty() \u0026\u0026 !cmd_tpl.contains(\"{}\") {\n        if let Some(mut parts) = shlex::split(cmd_tpl) {\n            if !parts.is_empty() {\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(command=%cmd_tpl, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n        ran_without_placeholder = true;\n    }\n\n    if !ran_without_placeholder {\n        for p in paths {\n            let quoted = shlex::try_quote(p).unwrap_or_else(|_| p.into());\n            let final_cmd = if cmd_tpl.contains(\"{}\") {\n                cmd_tpl.replace(\"{}\", \u0026quoted)\n            } else {\n                format!(\"{cmd_tpl} {quoted}\")\n            };\n            if let Some(mut parts) = shlex::split(\u0026final_cmd) {\n                if parts.is_empty() { continue; }\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(file=%p, command=%final_cmd, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\nfn escape_fts(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use assert_cmd::Command;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_help_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--help\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"Usage: marlin\"));\n    }\n\n    #[test]\n    fn test_version_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--version\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"marlin-cli 0.1.0\"));\n    }\n\n    #[test]\n    fn test_verbose_logging() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"--verbose\").arg(\"init\");\n        let output = cmd.output().unwrap();\n        assert!(output.status.success());\n        let stderr = String::from_utf8_lossy(\u0026output.stderr);\n        assert!(\n            stderr.contains(\"DEBUG\"),\n            \"Expected debug logs in stderr, got: {}\",\n            stderr\n        );\n    }\n\n    #[test]\n    fn test_shell_completions() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"completions\").arg(\"bash\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"_marlin()\"))\n            .stdout(predicates::str::contains(\"init\"))\n            .stdout(predicates::str::contains(\"scan\"));\n    }\n\n    #[test]\n    fn test_invalid_subcommand() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"invalid_cmd\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"error: unrecognized subcommand\"));\n    }\n\n    #[test]\n    fn test_init_command() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd.arg(\"init\");\n        cmd.assert().success();\n        assert!(db_path.exists(), \"Database file should exist after init\");\n    }\n\n    #[test]\n    fn test_automatic_backup() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let backups_dir = tmp.path().join(\"backups\");\n\n        // Init: no backup\n        let mut cmd_init = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_init.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_init.arg(\"init\");\n        cmd_init.assert().success();\n        assert!(\n            !backups_dir.exists() || backups_dir.read_dir().unwrap().next().is_none(),\n            \"No backup should be created for init\"\n        );\n\n        // Scan: backup created\n        let mut cmd_scan = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_scan.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_scan.arg(\"scan\");\n        cmd_scan.assert().success();\n        assert!(backups_dir.exists(), \"Backups directory should exist after scan\");\n        let backups: Vec\u003c_\u003e = backups_dir.read_dir().unwrap().collect();\n        assert_eq!(backups.len(), 1, \"One backup should be created for scan\");\n    }\n\n    #[test]\n    fn test_annotate_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"annotate\").arg(\"add\").arg(\"file.txt\").arg(\"note\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n\n    #[test]\n    fn test_event_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"event\").arg(\"add\").arg(\"file.txt\").arg(\"2025-05-20\").arg(\"desc\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n}\n","traces":[{"line":39,"address":[2202655,2218682,2201872],"length":1,"stats":{"Line":0}},{"line":41,"address":[2201894],"length":1,"stats":{"Line":0}},{"line":42,"address":[2202219],"length":1,"stats":{"Line":0}},{"line":43,"address":[2202240,2202346],"length":1,"stats":{"Line":0}},{"line":45,"address":[2202229],"length":1,"stats":{"Line":0}},{"line":48,"address":[2202348],"length":1,"stats":{"Line":0}},{"line":49,"address":[2202394],"length":1,"stats":{"Line":0}},{"line":50,"address":[2202431,2202518],"length":1,"stats":{"Line":0}},{"line":51,"address":[2202571],"length":1,"stats":{"Line":0}},{"line":55,"address":[2218129,2202661,2202401],"length":1,"stats":{"Line":0}},{"line":57,"address":[2202834],"length":1,"stats":{"Line":0}},{"line":59,"address":[2202893,2202974],"length":1,"stats":{"Line":0}},{"line":60,"address":[2203058],"length":1,"stats":{"Line":0}},{"line":61,"address":[2203011,2204020],"length":1,"stats":{"Line":0}},{"line":66,"address":[2218111,2202900,2204816],"length":1,"stats":{"Line":0}},{"line":69,"address":[2205102],"length":1,"stats":{"Line":0}},{"line":74,"address":[2206936,2205144,2207223],"length":1,"stats":{"Line":0}},{"line":75,"address":[2207201,2207787,2209168],"length":1,"stats":{"Line":0}},{"line":76,"address":[2207999,2208269,2208082,2209114],"length":1,"stats":{"Line":0}},{"line":78,"address":[2208644,2208322],"length":1,"stats":{"Line":0}},{"line":82,"address":[2205175],"length":1,"stats":{"Line":0}},{"line":83,"address":[2209226,2209760,2205244],"length":1,"stats":{"Line":0}},{"line":84,"address":[2211871,2209309,2209383,2211968],"length":1,"stats":{"Line":0}},{"line":86,"address":[2209232,2209340],"length":1,"stats":{"Line":0}},{"line":89,"address":[2209362,2211077],"length":1,"stats":{"Line":0}},{"line":90,"address":[2210525,2209832,2211788],"length":1,"stats":{"Line":0}},{"line":91,"address":[2210790,2210686,2210941],"length":1,"stats":{"Line":0}},{"line":92,"address":[2211153,2211735,2210995,2211281],"length":1,"stats":{"Line":0}},{"line":94,"address":[2210987],"length":1,"stats":{"Line":0}},{"line":95,"address":[2298240,2298256],"length":1,"stats":{"Line":0}},{"line":97,"address":[2211685,2211382,2211477],"length":1,"stats":{"Line":0}},{"line":100,"address":[2209903,2209765,2210038],"length":1,"stats":{"Line":0}},{"line":101,"address":[2210115,2210236,2210444],"length":1,"stats":{"Line":0}},{"line":107,"address":[2205273],"length":1,"stats":{"Line":0}},{"line":108,"address":[2212000,2205361],"length":1,"stats":{"Line":0}},{"line":110,"address":[2205387],"length":1,"stats":{"Line":0}},{"line":111,"address":[2212486],"length":1,"stats":{"Line":0}},{"line":112,"address":[2212590],"length":1,"stats":{"Line":0}},{"line":113,"address":[2212420],"length":1,"stats":{"Line":0}},{"line":114,"address":[2212460,2213200],"length":1,"stats":{"Line":0}},{"line":117,"address":[2205471],"length":1,"stats":{"Line":0}},{"line":118,"address":[2205567,2213459],"length":1,"stats":{"Line":0}},{"line":122,"address":[2213836,2205609,2214261],"length":1,"stats":{"Line":0}},{"line":123,"address":[2214080,2213997],"length":1,"stats":{"Line":0}},{"line":126,"address":[2205619],"length":1,"stats":{"Line":0}},{"line":127,"address":[2205659],"length":1,"stats":{"Line":0}},{"line":128,"address":[2214470,2214334,2215831],"length":1,"stats":{"Line":0}},{"line":129,"address":[2298310],"length":1,"stats":{"Line":0}},{"line":131,"address":[2214507],"length":1,"stats":{"Line":0}},{"line":132,"address":[2214812,2214697,2215793],"length":1,"stats":{"Line":0}},{"line":133,"address":[2298486],"length":1,"stats":{"Line":0}},{"line":135,"address":[2215052,2215374],"length":1,"stats":{"Line":0}},{"line":139,"address":[2215849,2205812],"length":1,"stats":{"Line":0}},{"line":140,"address":[2216057,2205942],"length":1,"stats":{"Line":0}},{"line":141,"address":[2206040,2216265],"length":1,"stats":{"Line":0}},{"line":142,"address":[2216467,2206138],"length":1,"stats":{"Line":0}},{"line":143,"address":[2206252,2216663],"length":1,"stats":{"Line":0}},{"line":144,"address":[2206334,2216859],"length":1,"stats":{"Line":0}},{"line":145,"address":[2206464,2217055],"length":1,"stats":{"Line":0}},{"line":146,"address":[2206594,2217251],"length":1,"stats":{"Line":0}},{"line":147,"address":[2206676,2217447],"length":1,"stats":{"Line":0}},{"line":148,"address":[2217643,2218006,2206806],"length":1,"stats":{"Line":0}},{"line":151,"address":[2205781],"length":1,"stats":{"Line":0}},{"line":157,"address":[2219744,2227697,2227856],"length":1,"stats":{"Line":0}},{"line":158,"address":[2219830],"length":1,"stats":{"Line":0}},{"line":159,"address":[2219968],"length":1,"stats":{"Line":0}},{"line":160,"address":[2219990],"length":1,"stats":{"Line":0}},{"line":161,"address":[2220010,2220441],"length":1,"stats":{"Line":0}},{"line":162,"address":[2220048],"length":1,"stats":{"Line":0}},{"line":163,"address":[2220454,2220180,2220359],"length":1,"stats":{"Line":0}},{"line":165,"address":[2220172],"length":1,"stats":{"Line":0}},{"line":166,"address":[2298656,2298640],"length":1,"stats":{"Line":0}},{"line":170,"address":[2220090,2220481],"length":1,"stats":{"Line":0}},{"line":171,"address":[2220729,2220599,2227846,2220516],"length":1,"stats":{"Line":0}},{"line":172,"address":[2220713],"length":1,"stats":{"Line":0}},{"line":173,"address":[2220977,2220894],"length":1,"stats":{"Line":0}},{"line":175,"address":[2227787,2221004,2221075],"length":1,"stats":{"Line":0}},{"line":176,"address":[2227747,2221402,2221595,2221473],"length":1,"stats":{"Line":0}},{"line":180,"address":[2221792],"length":1,"stats":{"Line":0}},{"line":181,"address":[2221871,2221820,2222060],"length":1,"stats":{"Line":0}},{"line":184,"address":[2298843,2298816],"length":1,"stats":{"Line":0}},{"line":186,"address":[2222145,2223211],"length":1,"stats":{"Line":0}},{"line":187,"address":[2223218,2223313],"length":1,"stats":{"Line":0}},{"line":189,"address":[2223444,2223371],"length":1,"stats":{"Line":0}},{"line":190,"address":[2223585],"length":1,"stats":{"Line":0}},{"line":191,"address":[2223609],"length":1,"stats":{"Line":0}},{"line":192,"address":[2223617,2223712],"length":1,"stats":{"Line":0}},{"line":193,"address":[2223829,2225104,2225300],"length":1,"stats":{"Line":0}},{"line":194,"address":[2225292],"length":1,"stats":{"Line":0}},{"line":197,"address":[2225079,2223883],"length":1,"stats":{"Line":0}},{"line":198,"address":[2223915,2224249],"length":1,"stats":{"Line":0}},{"line":199,"address":[2224215,2225084,2225071],"length":1,"stats":{"Line":0}},{"line":203,"address":[2225489,2225627],"length":1,"stats":{"Line":0}},{"line":204,"address":[2225517],"length":1,"stats":{"Line":0}},{"line":205,"address":[2225589,2226490],"length":1,"stats":{"Line":0}},{"line":209,"address":[2222198,2222532],"length":1,"stats":{"Line":0}},{"line":210,"address":[2222498],"length":1,"stats":{"Line":0}},{"line":214,"address":[2234849,2227872,2234730],"length":1,"stats":{"Line":0}},{"line":215,"address":[2227966],"length":1,"stats":{"Line":0}},{"line":216,"address":[2228040,2234839,2228253,2228123],"length":1,"stats":{"Line":0}},{"line":217,"address":[2228237],"length":1,"stats":{"Line":0}},{"line":218,"address":[2228418,2228501],"length":1,"stats":{"Line":0}},{"line":220,"address":[2228528,2228599,2234780],"length":1,"stats":{"Line":0}},{"line":221,"address":[2228918],"length":1,"stats":{"Line":0}},{"line":223,"address":[2229186,2228997,2228946],"length":1,"stats":{"Line":0}},{"line":226,"address":[2299056,2299083],"length":1,"stats":{"Line":0}},{"line":228,"address":[2230342,2229271],"length":1,"stats":{"Line":0}},{"line":229,"address":[2230349,2230444],"length":1,"stats":{"Line":0}},{"line":231,"address":[2230575,2230502],"length":1,"stats":{"Line":0}},{"line":232,"address":[2230724],"length":1,"stats":{"Line":0}},{"line":233,"address":[2230740,2230843,2232346],"length":1,"stats":{"Line":0}},{"line":234,"address":[2230954,2231288],"length":1,"stats":{"Line":0}},{"line":235,"address":[2232296,2231254,2232286],"length":1,"stats":{"Line":0}},{"line":238,"address":[2232660,2232522],"length":1,"stats":{"Line":0}},{"line":239,"address":[2232550],"length":1,"stats":{"Line":0}},{"line":240,"address":[2232622,2233523],"length":1,"stats":{"Line":0}},{"line":244,"address":[2229658,2229324],"length":1,"stats":{"Line":0}},{"line":245,"address":[2229624],"length":1,"stats":{"Line":0}},{"line":248,"address":[2236563,2234864,2236624],"length":1,"stats":{"Line":0}},{"line":249,"address":[2236642,2234913],"length":1,"stats":{"Line":0}},{"line":250,"address":[2235279,2235171],"length":1,"stats":{"Line":0}},{"line":253,"address":[2235483,2235590,2235698,2235870,2236617],"length":1,"stats":{"Line":0}},{"line":254,"address":[2235475,2235634],"length":1,"stats":{"Line":0}},{"line":256,"address":[2236573,2235971,2236049],"length":1,"stats":{"Line":0}},{"line":257,"address":[2236295,2236366],"length":1,"stats":{"Line":0}},{"line":259,"address":[2236013],"length":1,"stats":{"Line":0}},{"line":263,"address":[2236672,2243587,2239914],"length":1,"stats":{"Line":0}},{"line":264,"address":[2236719],"length":1,"stats":{"Line":0}},{"line":265,"address":[2236915,2236839],"length":1,"stats":{"Line":0}},{"line":266,"address":[2236961,2237123,2243531],"length":1,"stats":{"Line":0}},{"line":267,"address":[2240934,2237208],"length":1,"stats":{"Line":0}},{"line":268,"address":[2241032,2243518],"length":1,"stats":{"Line":0}},{"line":269,"address":[2241009,2241125],"length":1,"stats":{"Line":0}},{"line":270,"address":[2241259,2241333],"length":1,"stats":{"Line":0}},{"line":271,"address":[2241582,2241527],"length":1,"stats":{"Line":0}},{"line":272,"address":[2241575,2241656],"length":1,"stats":{"Line":0}},{"line":274,"address":[2241977,2241291],"length":1,"stats":{"Line":0}},{"line":275,"address":[2242099],"length":1,"stats":{"Line":0}},{"line":276,"address":[2242157],"length":1,"stats":{"Line":0}},{"line":277,"address":[2242266],"length":1,"stats":{"Line":0}},{"line":278,"address":[2242447,2242412],"length":1,"stats":{"Line":0}},{"line":279,"address":[2242747],"length":1,"stats":{"Line":0}},{"line":280,"address":[2242837],"length":1,"stats":{"Line":0}},{"line":282,"address":[2242437,2243149],"length":1,"stats":{"Line":0}},{"line":285,"address":[2243472,2242137],"length":1,"stats":{"Line":0}},{"line":288,"address":[2237253],"length":1,"stats":{"Line":0}},{"line":289,"address":[2237718,2237415,2237336],"length":1,"stats":{"Line":0}},{"line":291,"address":[2240771,2237688,2238180,2238302],"length":1,"stats":{"Line":0}},{"line":300,"address":[2238622,2238515,2238730,2240731],"length":1,"stats":{"Line":0}},{"line":301,"address":[2238666,2238507],"length":1,"stats":{"Line":0}},{"line":305,"address":[2238861,2238990,2238935,2239380],"length":1,"stats":{"Line":0}},{"line":306,"address":[2239393,2239050],"length":1,"stats":{"Line":0}},{"line":309,"address":[2239431,2238949],"length":1,"stats":{"Line":0}},{"line":310,"address":[2239854,2239610,2239462],"length":1,"stats":{"Line":0}},{"line":312,"address":[2239497,2239927],"length":1,"stats":{"Line":0}},{"line":313,"address":[2240418,2240000],"length":1,"stats":{"Line":0}},{"line":317,"address":[2239933,2240030],"length":1,"stats":{"Line":0}},{"line":320,"address":[2239815],"length":1,"stats":{"Line":0}},{"line":323,"address":[2245619,2243632,2246596],"length":1,"stats":{"Line":0}},{"line":324,"address":[2243713],"length":1,"stats":{"Line":0}},{"line":325,"address":[2246594,2243833,2243762],"length":1,"stats":{"Line":0}},{"line":326,"address":[2244168,2244235,2246573],"length":1,"stats":{"Line":0}},{"line":328,"address":[2244436],"length":1,"stats":{"Line":0}},{"line":329,"address":[2244496,2244588,2246324,2244664],"length":1,"stats":{"Line":0}},{"line":330,"address":[2244930,2244765],"length":1,"stats":{"Line":0}},{"line":331,"address":[2245219,2245148],"length":1,"stats":{"Line":0}},{"line":332,"address":[2246407],"length":1,"stats":{"Line":0}},{"line":335,"address":[2245388,2245498],"length":1,"stats":{"Line":0}},{"line":336,"address":[2245505,2245566],"length":1,"stats":{"Line":0}},{"line":338,"address":[2245625,2245716],"length":1,"stats":{"Line":0}},{"line":339,"address":[2245835,2245764],"length":1,"stats":{"Line":0}},{"line":340,"address":[2246023],"length":1,"stats":{"Line":0}},{"line":344,"address":[2244818],"length":1,"stats":{"Line":0}},{"line":347,"address":[2246624,2248773,2248808],"length":1,"stats":{"Line":0}},{"line":348,"address":[2246679],"length":1,"stats":{"Line":0}},{"line":350,"address":[2246719,2246748,2248866],"length":1,"stats":{"Line":0}},{"line":351,"address":[2248787,2246786],"length":1,"stats":{"Line":0}},{"line":352,"address":[2247029,2246909],"length":1,"stats":{"Line":0}},{"line":353,"address":[2247035],"length":1,"stats":{"Line":0}},{"line":354,"address":[2247104,2247155,2248695],"length":1,"stats":{"Line":0}},{"line":355,"address":[2247428],"length":1,"stats":{"Line":0}},{"line":356,"address":[2247512,2247455],"length":1,"stats":{"Line":0}},{"line":360,"address":[2248858],"length":1,"stats":{"Line":0}},{"line":363,"address":[2246729],"length":1,"stats":{"Line":0}},{"line":364,"address":[2248903,2251960,2248944],"length":1,"stats":{"Line":0}},{"line":365,"address":[2249013],"length":1,"stats":{"Line":0}},{"line":366,"address":[2249090,2249187],"length":1,"stats":{"Line":0}},{"line":367,"address":[2249450,2249220],"length":1,"stats":{"Line":0}},{"line":369,"address":[2249193,2249258],"length":1,"stats":{"Line":0}},{"line":371,"address":[2249566,2251542,2249411],"length":1,"stats":{"Line":0}},{"line":372,"address":[2249774,2249678],"length":1,"stats":{"Line":0}},{"line":373,"address":[2249780],"length":1,"stats":{"Line":0}},{"line":374,"address":[2251552,2249852,2249903],"length":1,"stats":{"Line":0}},{"line":375,"address":[2250173],"length":1,"stats":{"Line":0}},{"line":376,"address":[2250245,2250194],"length":1,"stats":{"Line":0}},{"line":381,"address":[2248927],"length":1,"stats":{"Line":0}},{"line":384,"address":[2252400,2252394,2252032],"length":1,"stats":{"Line":0}},{"line":385,"address":[2252091],"length":1,"stats":{"Line":0}},{"line":386,"address":[2252365,2252110,2252228],"length":1,"stats":{"Line":0}},{"line":388,"address":[2252413,2252161],"length":1,"stats":{"Line":0}},{"line":390,"address":[2252357],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":201},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","e2e.rs"],"content":"//! tests e2e.rs\n//! End-to-end “happy path” smoke-tests for the `marlin` binary.\n//!\n//! Run with `cargo test --test e2e` (CI does) or `cargo test`.\n\nuse assert_cmd::prelude::*;\nuse predicates::prelude::*;\nuse std::{fs, path::PathBuf, process::Command};\nuse tempfile::tempdir;\n\n/// Absolute path to the freshly-built `marlin` binary.\nfn marlin_bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Create the demo directory structure and seed files.\nfn spawn_demo_tree(root: \u0026PathBuf) {\n    fs::create_dir_all(root.join(\"Projects/Alpha\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Beta\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Gamma\")).unwrap();\n    fs::create_dir_all(root.join(\"Logs\")).unwrap();\n    fs::create_dir_all(root.join(\"Reports\")).unwrap();\n\n    fs::write(root.join(\"Projects/Alpha/draft1.md\"), \"- [ ] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Alpha/draft2.md\"), \"- [x] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Beta/final.md\"), \"done\\n\").unwrap();\n    fs::write(root.join(\"Projects/Gamma/TODO.txt\"), \"TODO bar\\n\").unwrap();\n    fs::write(root.join(\"Logs/app.log\"),           \"ERROR omg\\n\").unwrap();\n    fs::write(root.join(\"Reports/Q1.pdf\"),         \"PDF\\n\").unwrap();\n}\n\n/// Shorthand for “run and must succeed”.\nfn ok(cmd: \u0026mut Command) -\u003e assert_cmd::assert::Assert {\n    cmd.assert().success()\n}\n\n#[test]\nfn full_cli_flow() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    /* ── 1 ░ sandbox ───────────────────────────────────────────── */\n\n    let tmp      = tempdir()?;                 // wiped on drop\n    let demo_dir = tmp.path().join(\"marlin_demo\");\n    spawn_demo_tree(\u0026demo_dir);\n\n    let db_path = demo_dir.join(\"index.db\");\n\n    // Helper to spawn a fresh `marlin` Command with the DB env-var set\n    let marlin = || {\n        let mut c = Command::new(marlin_bin());\n        c.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        c\n    };\n\n    /* ── 2 ░ init ( auto-scan cwd ) ───────────────────────────── */\n\n    ok(marlin()\n        .current_dir(\u0026demo_dir)\n        .arg(\"init\"));\n\n    /* ── 3 ░ tag \u0026 attr demos ─────────────────────────────────── */\n\n    ok(marlin()\n        .arg(\"tag\")\n        .arg(format!(\"{}/Projects/**/*.md\", demo_dir.display()))\n        .arg(\"project/md\"));\n\n    ok(marlin()\n        .arg(\"attr\")\n        .arg(\"set\")\n        .arg(format!(\"{}/Reports/*.pdf\", demo_dir.display()))\n        .arg(\"reviewed\")\n        .arg(\"yes\"));\n\n    /* ── 4 ░ quick search sanity checks ───────────────────────── */\n\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    marlin()\n        .arg(\"search\").arg(\"attr:reviewed=yes\")\n        .assert()\n        .stdout(predicate::str::contains(\"Q1.pdf\"));\n\n    /* ── 5 ░ link flow \u0026 backlinks ────────────────────────────── */\n\n    let foo = demo_dir.join(\"foo.txt\");\n    let bar = demo_dir.join(\"bar.txt\");\n    fs::write(\u0026foo, \"\")?;\n    fs::write(\u0026bar, \"\")?;\n\n    ok(marlin().arg(\"scan\").arg(\u0026demo_dir));\n\n    ok(marlin()\n        .arg(\"link\").arg(\"add\")\n        .arg(\u0026foo).arg(\u0026bar));\n\n    marlin()\n        .arg(\"link\").arg(\"backlinks\").arg(\u0026bar)\n        .assert()\n        .stdout(predicate::str::contains(\"foo.txt\"));\n\n    /* ── 6 ░ backup → delete DB → restore ────────────────────── */\n\n    let backup_path = String::from_utf8(\n        marlin().arg(\"backup\").output()?.stdout\n    )?;\n    let backup_file = backup_path.split_whitespace().last().unwrap();\n\n    fs::remove_file(\u0026db_path)?;                        // simulate corruption\n    ok(marlin().arg(\"restore\").arg(backup_file));      // restore\n\n    // Search must still work afterwards\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    Ok(())\n}\n\n","traces":[{"line":12,"address":[789200],"length":1,"stats":{"Line":1}},{"line":13,"address":[789208],"length":1,"stats":{"Line":1}},{"line":17,"address":[789232],"length":1,"stats":{"Line":1}},{"line":18,"address":[789251],"length":1,"stats":{"Line":1}},{"line":19,"address":[789312],"length":1,"stats":{"Line":1}},{"line":20,"address":[789373],"length":1,"stats":{"Line":1}},{"line":21,"address":[789434],"length":1,"stats":{"Line":1}},{"line":22,"address":[789495],"length":1,"stats":{"Line":1}},{"line":24,"address":[789556],"length":1,"stats":{"Line":1}},{"line":25,"address":[789635],"length":1,"stats":{"Line":1}},{"line":26,"address":[789714],"length":1,"stats":{"Line":1}},{"line":27,"address":[789793],"length":1,"stats":{"Line":1}},{"line":28,"address":[789872],"length":1,"stats":{"Line":1}},{"line":29,"address":[789951],"length":1,"stats":{"Line":1}},{"line":33,"address":[790048],"length":1,"stats":{"Line":1}},{"line":34,"address":[790066],"length":1,"stats":{"Line":1}}],"covered":16,"coverable":16},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","integration","watcher","watcher_test.rs"],"content":"//! Integration test for the file watcher functionality\n//! \n//! Tests various aspects of the file system watcher including:\n//! - Basic event handling (create, modify, delete files)\n//! - Debouncing of events\n//! - Hierarchical event coalescing\n//! - Graceful shutdown and event draining\n\nuse marlin::watcher::{FileWatcher, WatcherConfig, WatcherState};\nuse std::path::{Path, PathBuf};\nuse std::fs::{self, File};\nuse std::io::Write;\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tempfile::tempdir;\n\n// Mock filesystem event simulator inspired by inotify-sim\nstruct MockEventSimulator {\n    temp_dir: PathBuf,\n    files_created: Vec\u003cPathBuf\u003e,\n}\n\nimpl MockEventSimulator {\n    fn new(temp_dir: PathBuf) -\u003e Self {\n        Self {\n            temp_dir,\n            files_created: Vec::new(),\n        }\n    }\n\n    fn create_file(\u0026mut self, relative_path: \u0026str, content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        if let Some(parent) = path.parent() {\n            fs::create_dir_all(parent).expect(\"Failed to create parent directory\");\n        }\n        \n        let mut file = File::create(\u0026path).expect(\"Failed to create file\");\n        file.write_all(content.as_bytes()).expect(\"Failed to write content\");\n        \n        self.files_created.push(path.clone());\n        path\n    }\n    \n    fn modify_file(\u0026self, relative_path: \u0026str, new_content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        let mut file = File::create(\u0026path).expect(\"Failed to update file\");\n        file.write_all(new_content.as_bytes()).expect(\"Failed to write content\");\n        path\n    }\n    \n    fn delete_file(\u0026mut self, relative_path: \u0026str) {\n        let path = self.temp_dir.join(relative_path);\n        fs::remove_file(\u0026path).expect(\"Failed to delete file\");\n        \n        self.files_created.retain(|p| p != \u0026path);\n    }\n    \n    fn create_burst(\u0026mut self, count: usize, prefix: \u0026str) -\u003e Vec\u003cPathBuf\u003e {\n        let mut paths = Vec::with_capacity(count);\n        \n        for i in 0..count {\n            let file_path = format!(\"{}/burst_file_{}.txt\", prefix, i);\n            let path = self.create_file(\u0026file_path, \u0026format!(\"Content {}\", i));\n            paths.push(path);\n            \n            // Small delay to simulate rapid but not instantaneous file creation\n            thread::sleep(Duration::from_micros(10));\n        }\n        \n        paths\n    }\n    \n    fn cleanup(\u0026self) {\n        // No need to do anything as tempdir will clean itself\n    }\n}\n\n#[test]\nfn test_basic_watch_functionality() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Create a test file before starting the watcher\n    let initial_file = simulator.create_file(\"initial.txt\", \"Initial content\");\n    \n    // Configure and start the watcher\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for a short time\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Generate events\n    let file1 = simulator.create_file(\"test1.txt\", \"Hello, world!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    let file2 = simulator.create_file(\"dir1/test2.txt\", \"Hello from subdirectory!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.modify_file(\"test1.txt\", \"Updated content\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.delete_file(\"test1.txt\");\n    \n    // Wait for watcher thread to complete\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Check status after processing events\n    let status = finished_watcher.status();\n    \n    // Assertions\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with larger debounce window for this test\n    let config = WatcherConfig {\n        debounce_ms: 200,  // 200ms debounce window\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to observe debouncing\n        thread::sleep(Duration::from_secs(3));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Rapidly update the same file multiple times within the debounce window\n    let test_file = \"test_debounce.txt\";\n    simulator.create_file(test_file, \"Initial content\");\n    \n    // Update the same file multiple times within debounce window\n    for i in 1..10 {\n        simulator.modify_file(test_file, \u0026format!(\"Update {}\", i));\n        thread::sleep(Duration::from_millis(10)); // Short delay between updates\n    }\n    \n    // Wait for debounce window and processing\n    thread::sleep(Duration::from_millis(500));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // We should have processed fewer events than modifications made\n    // due to debouncing (exact count depends on implementation details)\n    assert!(status.events_processed \u003c 10, \n            \"Expected fewer events processed than modifications due to debouncing\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_event_flood() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure with settings tuned for burst handling\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 500,  // Handle larger batches\n        max_queue_size: 10000,  // Large queue for burst\n        drain_timeout_ms: 5000, // Longer drain time for cleanup\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to process a large burst\n        thread::sleep(Duration::from_secs(10));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create 1000 files in rapid succession (smaller scale for test)\n    let start_time = Instant::now();\n    let created_files = simulator.create_burst(1000, \"flood\");\n    let creation_time = start_time.elapsed();\n    \n    println!(\"Created 1000 files in {:?}\", creation_time);\n    \n    // Wait for processing to complete\n    thread::sleep(Duration::from_secs(5));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // Verify processing occurred\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_hierarchical_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher\n    let config = WatcherConfig {\n        debounce_ms: 200,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create directory structure\n    let nested_dir = \"parent/child/grandchild\";\n    fs::create_dir_all(temp_path.join(nested_dir)).expect(\"Failed to create nested directories\");\n    \n    // Create files in the hierarchy\n    simulator.create_file(\"parent/file1.txt\", \"Content 1\");\n    simulator.create_file(\"parent/child/file2.txt\", \"Content 2\");\n    simulator.create_file(\"parent/child/grandchild/file3.txt\", \"Content 3\");\n    \n    // Wait a bit\n    thread::sleep(Duration::from_millis(300));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_graceful_shutdown() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with specific drain timeout\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 2000, // 2 second drain timeout\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    watcher.start().expect(\"Failed to start watcher\");\n    \n    // Wait for initialization\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create files\n    for i in 0..10 {\n        simulator.create_file(\u0026format!(\"shutdown_test_{}.txt\", i), \"Shutdown test\");\n        thread::sleep(Duration::from_millis(10));\n    }\n    \n    // Immediately request shutdown while events are being processed\n    let shutdown_start = Instant::now();\n    watcher.stop().expect(\"Failed to stop watcher\");\n    let shutdown_duration = shutdown_start.elapsed();\n    \n    // Shutdown should take close to the drain timeout but not excessively longer\n    println!(\"Shutdown took {:?}\", shutdown_duration);\n    assert!(shutdown_duration \u003e= Duration::from_millis(100), \n            \"Shutdown was too quick, may not have drained properly\");\n    assert!(shutdown_duration \u003c= Duration::from_millis(3000), \n            \"Shutdown took too long\");\n    \n    // Verify final state\n    let status = watcher.status();\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert_eq!(status.queue_size, 0, \"Queue should be empty after shutdown\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","neg.rs"],"content":"//! tests neg.rs\n//! Negative-path integration tests (“should fail / warn”).\n\nuse predicates::str;\nuse tempfile::tempdir;\n\nmod util;\nuse util::marlin;\n\n/* ───────────────────────── LINKS ─────────────────────────────── */\n\n#[test]\nfn link_non_indexed_should_fail() {\n    let tmp = tempdir().unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    std::fs::write(tmp.path().join(\"foo.txt\"), \"\").unwrap();\n    std::fs::write(tmp.path().join(\"bar.txt\"), \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .current_dir(tmp.path())\n        .args([\n            \"link\", \"add\",\n            \u0026tmp.path().join(\"foo.txt\").to_string_lossy(),\n            \u0026tmp.path().join(\"bar.txt\").to_string_lossy()\n        ])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"file not indexed\"));\n}\n\n/* ───────────────────────── ATTR ─────────────────────────────── */\n\n#[test]\nfn attr_set_on_non_indexed_file_should_warn() {\n    let tmp = tempdir().unwrap();\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    let ghost = tmp.path().join(\"ghost.txt\");\n    std::fs::write(\u0026ghost, \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .args([\"attr\",\"set\",\n               \u0026ghost.to_string_lossy(),\"foo\",\"bar\"])\n        .assert()\n        .success()                       // exits 0\n        .stderr(str::contains(\"not indexed\"));\n}\n\n/* ───────────────────── COLLECTIONS ───────────────────────────── */\n\n#[test]\nfn coll_add_unknown_collection_should_fail() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"doc.txt\");\n    std::fs::write(\u0026file, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"coll\",\"add\",\"nope\",\u0026file.to_string_lossy()])\n        .assert()\n        .failure();\n}\n\n/* ───────────────────── RESTORE (bad file) ───────────────────── */\n\n#[test]\nfn restore_with_nonexistent_backup_should_fail() {\n    let tmp   = tempdir().unwrap();\n\n    // create an empty DB first\n    marlin(\u0026tmp).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"restore\", \"/definitely/not/here.db\"])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"Failed to restore\"));\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","pos.rs"],"content":"//! tests pos.rs\n//! Positive-path integration checks for every sub-command\n//! that already has real logic behind it.\n\nmod util;\nuse util::marlin;\n\nuse predicates::{prelude::*, str};          // brings `PredicateBooleanExt::and`\nuse std::fs;\nuse tempfile::tempdir;\n\n/* ─────────────────────────── TAG ─────────────────────────────── */\n\n#[test]\nfn tag_should_add_hierarchical_tag_and_search_finds_it() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"foo.md\");\n    fs::write(\u0026file, \"# test\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"tag\", file.to_str().unwrap(), \"project/md\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"search\", \"tag:project/md\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"foo.md\"));\n}\n\n/* ─────────────────────────── ATTR ────────────────────────────── */\n\n#[test]\nfn attr_set_then_ls_roundtrip() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"report.pdf\");\n    fs::write(\u0026file, \"%PDF-1.4\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"set\", file.to_str().unwrap(), \"reviewed\", \"yes\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"ls\", file.to_str().unwrap()])\n        .assert()\n        .success()\n        .stdout(str::contains(\"reviewed = yes\"));\n}\n\n/* ─────────────────────── COLLECTIONS ────────────────────────── */\n\n#[test]\nfn coll_create_add_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let a = tmp.path().join(\"a.txt\");\n    let b = tmp.path().join(\"b.txt\");\n    fs::write(\u0026a, \"\").unwrap();\n    fs::write(\u0026b, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp).args([\"coll\", \"create\", \"Set\"]).assert().success();\n    for f in [\u0026a, \u0026b] {\n        marlin(\u0026tmp).args([\"coll\", \"add\", \"Set\", f.to_str().unwrap()]).assert().success();\n    }\n\n    marlin(\u0026tmp)\n        .args([\"coll\", \"list\", \"Set\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"a.txt\").and(str::contains(\"b.txt\")));\n}\n\n/* ─────────────────────────── VIEWS ───────────────────────────── */\n\n#[test]\nfn view_save_list_and_exec() {\n    let tmp  = tempdir().unwrap();\n\n    let todo = tmp.path().join(\"TODO.txt\");\n    fs::write(\u0026todo, \"remember the milk\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // save \u0026 list\n    marlin(\u0026tmp).args([\"view\", \"save\", \"tasks\", \"milk\"]).assert().success();\n    marlin(\u0026tmp)\n        .args([\"view\", \"list\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"tasks: milk\"));\n\n    // exec\n    marlin(\u0026tmp)\n        .args([\"view\", \"exec\", \"tasks\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"TODO.txt\"));\n}\n\n/* ─────────────────────────── LINKS ───────────────────────────── */\n\n#[test]\nfn link_add_rm_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let foo = tmp.path().join(\"foo.txt\");\n    let bar = tmp.path().join(\"bar.txt\");\n    fs::write(\u0026foo, \"\").unwrap();\n    fs::write(\u0026bar, \"\").unwrap();\n\n    // handy closure\n    let mc = || marlin(\u0026tmp);\n\n    mc().current_dir(tmp.path()).arg(\"init\").assert().success();\n    mc().args([\"scan\", tmp.path().to_str().unwrap()]).assert().success();\n\n    // add\n    mc().args([\"link\", \"add\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list (outgoing default)\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::contains(\"foo.txt\").and(str::contains(\"bar.txt\")));\n\n    // remove\n    mc().args([\"link\", \"rm\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list now empty\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::is_empty());\n}\n\n/* ─────────────────────── SCAN (multi-path) ───────────────────── */\n\n#[test]\nfn scan_with_multiple_paths_indexes_all() {\n    let tmp = tempdir().unwrap();\n\n    let dir_a = tmp.path().join(\"A\");\n    let dir_b = tmp.path().join(\"B\");\n    std::fs::create_dir_all(\u0026dir_a).unwrap();\n    std::fs::create_dir_all(\u0026dir_b).unwrap();\n    let f1 = dir_a.join(\"one.txt\");\n    let f2 = dir_b.join(\"two.txt\");\n    fs::write(\u0026f1, \"\").unwrap();\n    fs::write(\u0026f2, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // multi-path scan\n    marlin(\u0026tmp)\n        .args([\"scan\", dir_a.to_str().unwrap(), dir_b.to_str().unwrap()])\n        .assert().success();\n\n    // both files findable\n    for term in [\"one.txt\", \"two.txt\"] {\n        marlin(\u0026tmp).args([\"search\", term])\n            .assert()\n            .success()\n            .stdout(str::contains(term));\n    }\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","util.rs"],"content":"//! tests/util.rs\n//! Small helpers shared across integration tests.\n\nuse std::path::{Path, PathBuf};\nuse tempfile::TempDir;\nuse assert_cmd::Command; \n/// Absolute path to the freshly-built `marlin` binary.\npub fn bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Build a `Command` for `marlin` whose `MARLIN_DB_PATH` is\n/// `\u003ctmp\u003e/index.db`.\n///\n/// Each call yields a brand-new `Command`, so callers can freely add\n/// arguments, change the working directory, etc., without affecting\n/// other invocations.\npub fn marlin(tmp: \u0026TempDir) -\u003e Command {\n    let db_path: \u0026Path = \u0026tmp.path().join(\"index.db\");\n    let mut cmd = Command::new(bin());\n    cmd.env(\"MARLIN_DB_PATH\", db_path);\n    cmd\n}\n","traces":[{"line":8,"address":[776352],"length":1,"stats":{"Line":10}},{"line":9,"address":[776360],"length":1,"stats":{"Line":10}},{"line":18,"address":[776384,776727,776721],"length":1,"stats":{"Line":10}},{"line":19,"address":[776535,776422],"length":1,"stats":{"Line":20}},{"line":20,"address":[776575],"length":1,"stats":{"Line":10}},{"line":21,"address":[776612],"length":1,"stats":{"Line":10}},{"line":22,"address":[776682],"length":1,"stats":{"Line":10}}],"covered":7,"coverable":7},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","backup.rs"],"content":"// libmarlin/src/backup.rs\n\nuse anyhow::{anyhow, Context, Result};\nuse chrono::{DateTime, Local, NaiveDateTime, Utc, TimeZone};\nuse rusqlite;\nuse std::fs;\nuse std::path::{Path, PathBuf};\nuse std::time::Duration;\n\nuse crate::error as marlin_error;\n\n#[derive(Debug, Clone)]\npub struct BackupInfo {\n    pub id: String,\n    pub timestamp: DateTime\u003cUtc\u003e,\n    pub size_bytes: u64,\n    pub hash: Option\u003cString\u003e,\n}\n\n#[derive(Debug)]\npub struct PruneResult {\n    pub kept: Vec\u003cBackupInfo\u003e,\n    pub removed: Vec\u003cBackupInfo\u003e,\n}\n\n// FIX 2: Add derive(Debug) here\n#[derive(Debug)]\npub struct BackupManager {\n    live_db_path: PathBuf,\n    backups_dir: PathBuf,\n}\n\nimpl BackupManager {\n    pub fn new\u003cP1: AsRef\u003cPath\u003e, P2: AsRef\u003cPath\u003e\u003e(live_db_path: P1, backups_dir: P2) -\u003e Result\u003cSelf\u003e {\n        let backups_dir_path = backups_dir.as_ref().to_path_buf();\n        if !backups_dir_path.exists() {\n            fs::create_dir_all(\u0026backups_dir_path).with_context(|| {\n                format!(\n                    \"Failed to create backup directory at {}\",\n                    backups_dir_path.display()\n                )\n            })?;\n        } else if !backups_dir_path.is_dir() {\n            return Err(anyhow!(\"Backups path exists but is not a directory: {}\", backups_dir_path.display()));\n        }\n        Ok(Self {\n            live_db_path: live_db_path.as_ref().to_path_buf(),\n            backups_dir: backups_dir_path,\n        })\n    }\n\n    pub fn create_backup(\u0026self) -\u003e Result\u003cBackupInfo\u003e {\n        let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S_%f\");\n        let backup_file_name = format!(\"backup_{stamp}.db\");\n        let backup_file_path = self.backups_dir.join(\u0026backup_file_name);\n\n        if !self.live_db_path.exists() {\n             return Err(anyhow::Error::new(std::io::Error::new(\n                std::io::ErrorKind::NotFound,\n                format!(\"Live DB path does not exist: {}\", self.live_db_path.display()),\n            )).context(\"Cannot create backup from non-existent live DB\"));\n        }\n\n        let src_conn = rusqlite::Connection::open_with_flags(\n            \u0026self.live_db_path,\n            rusqlite::OpenFlags::SQLITE_OPEN_READ_ONLY,\n        )\n        .with_context(|| {\n            format!(\n                \"Failed to open source DB ('{}') for backup\",\n                self.live_db_path.display()\n            )\n        })?;\n\n        let mut dst_conn = rusqlite::Connection::open(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to open destination backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        let backup_op =\n            rusqlite::backup::Backup::new(\u0026src_conn, \u0026mut dst_conn).with_context(|| {\n                format!(\n                    \"Failed to initialize backup from {} to {}\",\n                    self.live_db_path.display(),\n                    backup_file_path.display()\n                )\n            })?;\n\n        backup_op\n            .run_to_completion(100, Duration::from_millis(250), None)\n            .map_err(|e| anyhow::Error::new(e).context(\"SQLite backup operation failed\"))?;\n\n        let metadata = fs::metadata(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to get metadata for backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        Ok(BackupInfo {\n            id: backup_file_name,\n            timestamp: DateTime::from(metadata.modified()?),\n            size_bytes: metadata.len(),\n            hash: None,\n        })\n    }\n\n    pub fn list_backups(\u0026self) -\u003e Result\u003cVec\u003cBackupInfo\u003e\u003e {\n        let mut backup_infos = Vec::new();\n        \n        if !self.backups_dir.exists() { \n            return Ok(backup_infos);\n        }\n\n        for entry_result in fs::read_dir(\u0026self.backups_dir).with_context(|| {\n            format!(\n                \"Failed to read backup directory: {}\",\n                self.backups_dir.display()\n            )\n        })? {\n            let entry = entry_result?;\n            let path = entry.path();\n\n            if path.is_file() {\n                if let Some(filename_osstr) = path.file_name() {\n                    if let Some(filename) = filename_osstr.to_str() {\n                        if filename.starts_with(\"backup_\") \u0026\u0026 filename.ends_with(\".db\") {\n                            let ts_str = filename\n                                .trim_start_matches(\"backup_\")\n                                .trim_end_matches(\".db\");\n                            \n                            let naive_dt = match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S_%f\") {\n                                Ok(dt) =\u003e dt,\n                                Err(_) =\u003e match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S\") {\n                                    Ok(dt) =\u003e dt,\n                                    Err(_) =\u003e { \n                                        let metadata = fs::metadata(\u0026path).with_context(|| format!(\"Failed to get metadata for {}\", path.display()))?;\n                                        DateTime::\u003cUtc\u003e::from(metadata.modified()?).naive_utc()\n                                    }\n                                }\n                            };\n                            \n                            let local_dt_result = Local.from_local_datetime(\u0026naive_dt);\n                            let local_dt = match local_dt_result {\n                                chrono::LocalResult::Single(dt) =\u003e dt,\n                                chrono::LocalResult::Ambiguous(dt1, _dt2) =\u003e {\n                                    eprintln!(\"Warning: Ambiguous local time for backup {}, taking first interpretation.\", filename);\n                                    dt1\n                                },\n                                chrono::LocalResult::None =\u003e {\n                                    eprintln!(\"Warning: Invalid local time for backup {}, skipping.\", filename);\n                                    continue; \n                                }\n                            };\n                            let timestamp_utc = DateTime::\u003cUtc\u003e::from(local_dt);\n\n                            let metadata = fs::metadata(\u0026path)?;\n                            backup_infos.push(BackupInfo {\n                                id: filename.to_string(),\n                                timestamp: timestamp_utc,\n                                size_bytes: metadata.len(),\n                                hash: None,\n                            });\n                        }\n                    }\n                }\n            }\n        }\n        backup_infos.sort_by_key(|b| std::cmp::Reverse(b.timestamp));\n        Ok(backup_infos)\n    }\n\n    pub fn prune(\u0026self, keep_count: usize) -\u003e Result\u003cPruneResult\u003e {\n        let all_backups = self.list_backups()?; \n\n        let mut kept = Vec::new();\n        let mut removed = Vec::new();\n\n        if keep_count \u003e= all_backups.len() { \n            kept = all_backups;\n        } else {\n            for (index, backup_info) in all_backups.into_iter().enumerate() {\n                if index \u003c keep_count {\n                    kept.push(backup_info);\n                } else {\n                    let backup_file_path = self.backups_dir.join(\u0026backup_info.id);\n                    if backup_file_path.exists() { \n                        fs::remove_file(\u0026backup_file_path).with_context(|| {\n                            format!(\n                                \"Failed to remove old backup file: {}\",\n                                backup_file_path.display()\n                            )\n                        })?;\n                    }\n                    removed.push(backup_info);\n                }\n            }\n        }\n        Ok(PruneResult { kept, removed })\n    }\n\n    pub fn restore_from_backup(\u0026self, backup_id: \u0026str) -\u003e Result\u003c()\u003e {\n        let backup_file_path = self.backups_dir.join(backup_id);\n        if !backup_file_path.exists() || !backup_file_path.is_file() {\n            return Err(anyhow::Error::new(marlin_error::Error::NotFound(format!(\n                \"Backup file not found or is not a file: {}\",\n                backup_file_path.display()\n            ))));\n        }\n\n        fs::copy(\u0026backup_file_path, \u0026self.live_db_path).with_context(|| {\n            format!(\n                \"Failed to copy backup {} to live DB {}\",\n                backup_file_path.display(),\n                self.live_db_path.display()\n            )\n        })?;\n        Ok(())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use tempfile::tempdir;\n    use crate::db::open as open_marlin_db;\n    // FIX 1: Remove unused import std::io::ErrorKind\n    // use std::io::ErrorKind; \n\n    fn create_valid_live_db(path: \u0026Path) -\u003e rusqlite::Connection {\n        let conn = open_marlin_db(path)\n            .unwrap_or_else(|e| panic!(\"Failed to open/create test DB at {}: {:?}\", path.display(), e));\n        conn.execute_batch(\n            \"CREATE TABLE IF NOT EXISTS test_table (id INTEGER PRIMARY KEY, data TEXT);\n             INSERT INTO test_table (data) VALUES ('initial_data');\"\n        ).expect(\"Failed to initialize test table\");\n        conn\n    }\n\n    #[test]\n    fn test_backup_manager_new_creates_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_new_creates.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_new_creates_test\");\n\n        assert!(!backups_dir.exists());\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        assert!(manager.backups_dir.exists()); \n        assert!(backups_dir.exists());\n    }\n\n    #[test]\n    fn test_backup_manager_new_with_existing_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_existing_dir.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_existing_test\");\n        std::fs::create_dir_all(\u0026backups_dir).unwrap(); \n\n        assert!(backups_dir.exists());\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026backups_dir);\n        assert!(manager_res.is_ok());\n        let manager = manager_res.unwrap();\n        assert_eq!(manager.backups_dir, backups_dir);\n    }\n    \n    #[test]\n    fn test_backup_manager_new_fails_if_backup_path_is_file() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_backup_path_is_file.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n        let file_as_backups_dir = base_tmp.path().join(\"file_as_backups_dir\");\n        std::fs::write(\u0026file_as_backups_dir, \"i am a file\").unwrap();\n\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026file_as_backups_dir);\n        assert!(manager_res.is_err());\n        assert!(manager_res.unwrap_err().to_string().contains(\"Backups path exists but is not a directory\"));\n    }\n\n    #[test]\n    fn test_create_backup_failure_non_existent_live_db() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"non_existent_live.db\"); \n        let backups_dir = base_tmp.path().join(\"backups_fail_test\");\n\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        let backup_result = manager.create_backup();\n        assert!(backup_result.is_err());\n        let err_str = backup_result.unwrap_err().to_string();\n        assert!(err_str.contains(\"Cannot create backup from non-existent live DB\") || err_str.contains(\"Failed to open source DB\"));\n    }\n\n    #[test]\n    fn test_create_list_prune_backups() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_clp_test.db\");\n        let _conn_live = create_valid_live_db(\u0026live_db_file);\n\n        let backups_storage_dir = tmp.path().join(\"backups_clp_storage_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_storage_dir).unwrap();\n\n        let initial_list = manager.list_backups().unwrap();\n        assert!(initial_list.is_empty(), \"Backup list should be empty initially\");\n\n        let prune_empty_result = manager.prune(2).unwrap();\n        assert!(prune_empty_result.kept.is_empty());\n        assert!(prune_empty_result.removed.is_empty());\n\n        let mut created_backup_ids = Vec::new();\n        for i in 0..5 {\n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone()); \n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(listed_backups.len(), 5);\n        for id in \u0026created_backup_ids {\n            assert!(\n                listed_backups.iter().any(|b| \u0026b.id == id),\n                \"Backup ID {} not found in list\", id\n            );\n        }\n        if listed_backups.len() \u003e= 2 {\n            assert!(listed_backups[0].timestamp \u003e= listed_backups[1].timestamp);\n        }\n\n        let prune_to_zero_result = manager.prune(0).unwrap();\n        assert_eq!(prune_to_zero_result.kept.len(), 0);\n        assert_eq!(prune_to_zero_result.removed.len(), 5);\n        let listed_after_prune_zero = manager.list_backups().unwrap();\n        assert!(listed_after_prune_zero.is_empty());\n\n        created_backup_ids.clear();\n        for i in 0..5 { \n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone());\n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let prune_keep_more_result = manager.prune(10).unwrap();\n        assert_eq!(prune_keep_more_result.kept.len(), 5);\n        assert_eq!(prune_keep_more_result.removed.len(), 0);\n        let listed_after_prune_more = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune_more.len(), 5);\n\n        let prune_result = manager.prune(2).unwrap();\n        assert_eq!(prune_result.kept.len(), 2);\n        assert_eq!(prune_result.removed.len(), 3);\n\n        let listed_after_prune = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune.len(), 2);\n\n        assert_eq!(listed_after_prune[0].id, created_backup_ids[4]);\n        assert_eq!(listed_after_prune[1].id, created_backup_ids[3]);\n        \n        for removed_info in prune_result.removed {\n            assert!(\n                !backups_storage_dir.join(\u0026removed_info.id).exists(),\n                \"Removed backup file {} should not exist\", removed_info.id\n            );\n        }\n        for kept_info in prune_result.kept {\n            assert!(\n                backups_storage_dir.join(\u0026kept_info.id).exists(),\n                \"Kept backup file {} should exist\", kept_info.id\n            );\n        }\n    }\n\n     #[test]\n    fn test_restore_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_test.db\");\n        \n        let initial_value = \"initial_data_for_restore\";\n        {\n            // FIX 3: Remove `mut` from conn here\n            let conn = create_valid_live_db(\u0026live_db_path);\n            conn.execute(\"DELETE FROM test_table\", []).unwrap(); \n            conn.execute(\"INSERT INTO test_table (data) VALUES (?1)\", [initial_value]).unwrap();\n        }\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_test_dir\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let backup_info = manager.create_backup().unwrap();\n\n        let modified_value = \"modified_data_for_restore\";\n        {\n            // FIX 3: Remove `mut` from conn here\n            let conn = rusqlite::Connection::open(\u0026live_db_path) \n                .expect(\"Failed to open live DB for modification\");\n            conn.execute(\"UPDATE test_table SET data = ?1\", [modified_value])\n                .expect(\"Failed to update data\");\n            let modified_check: String = conn\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(modified_check, modified_value);\n        }\n        \n        manager.restore_from_backup(\u0026backup_info.id).unwrap();\n\n        {\n            let conn_after_restore = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB after restore\");\n            let restored_data: String = conn_after_restore\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(restored_data, initial_value);\n        }\n    }\n\n    #[test]\n    fn test_restore_non_existent_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_fail_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_fail_test\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let result = manager.restore_from_backup(\"non_existent_backup.db\");\n        assert!(result.is_err());\n        let err_string = result.unwrap_err().to_string();\n        assert!(err_string.contains(\"Backup file not found\"), \"Error string was: {}\", err_string);\n    }\n\n    #[test]\n    fn list_backups_with_non_backup_files() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        let backups_dir = tmp.path().join(\"backups_list_mixed_files_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_dir).unwrap();\n\n        manager.create_backup().unwrap(); \n        \n        std::fs::write(backups_dir.join(\"not_a_backup.txt\"), \"hello\").unwrap();\n        std::fs::write(\n            backups_dir.join(\"backup_malformed.db.tmp\"),\n            \"temp data\",\n        )\n        .unwrap();\n        std::fs::create_dir(backups_dir.join(\"a_subdir\")).unwrap();\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(\n            listed_backups.len(),\n            1,\n            \"Should only list the valid backup file\"\n        );\n        assert!(listed_backups[0].id.starts_with(\"backup_\"));\n        assert!(listed_backups[0].id.ends_with(\".db\"));\n    }\n\n     #[test]\n    fn list_backups_handles_io_error_on_read_dir() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_io_error.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        \n        let backups_dir_for_deletion = tmp.path().join(\"backups_dir_to_delete_test\");\n        let manager_for_deletion = BackupManager::new(\u0026live_db_file, \u0026backups_dir_for_deletion).unwrap();\n        std::fs::remove_dir_all(\u0026backups_dir_for_deletion).unwrap(); \n\n        let list_res = manager_for_deletion.list_backups().unwrap();\n        assert!(list_res.is_empty());\n    }\n}","traces":[{"line":34,"address":[1940524,1940518,1939536],"length":1,"stats":{"Line":1}},{"line":35,"address":[],"length":0,"stats":{"Line":2}},{"line":36,"address":[],"length":0,"stats":{"Line":2}},{"line":37,"address":[1939830,1939973,1940544,1939777,1939927],"length":1,"stats":{"Line":2}},{"line":38,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":43,"address":[],"length":0,"stats":{"Line":4}},{"line":44,"address":[],"length":0,"stats":{"Line":1}},{"line":46,"address":[1940399],"length":1,"stats":{"Line":1}},{"line":47,"address":[1940324,1939941],"length":1,"stats":{"Line":2}},{"line":48,"address":[],"length":0,"stats":{"Line":1}},{"line":52,"address":[1715154,1711872,1715148],"length":1,"stats":{"Line":1}},{"line":53,"address":[1711911],"length":1,"stats":{"Line":1}},{"line":54,"address":[1712001,1712048],"length":1,"stats":{"Line":2}},{"line":55,"address":[1712164,1712248],"length":1,"stats":{"Line":2}},{"line":57,"address":[5530103,5530186],"length":1,"stats":{"Line":2}},{"line":58,"address":[5530494],"length":1,"stats":{"Line":1}},{"line":59,"address":[1712401],"length":1,"stats":{"Line":1}},{"line":60,"address":[1712500,1712409],"length":1,"stats":{"Line":2}},{"line":68,"address":[1940720],"length":1,"stats":{"Line":0}},{"line":69,"address":[1940779],"length":1,"stats":{"Line":0}},{"line":71,"address":[5443926],"length":1,"stats":{"Line":0}},{"line":75,"address":[5530945,5531116,5531016,5533143],"length":1,"stats":{"Line":2}},{"line":76,"address":[1940955],"length":1,"stats":{"Line":0}},{"line":78,"address":[1940918],"length":1,"stats":{"Line":0}},{"line":82,"address":[5444256],"length":1,"stats":{"Line":3}},{"line":84,"address":[1941194,1941135],"length":1,"stats":{"Line":0}},{"line":86,"address":[1941098],"length":1,"stats":{"Line":0}},{"line":87,"address":[5444341],"length":1,"stats":{"Line":0}},{"line":91,"address":[5531685,5531838,5533098],"length":1,"stats":{"Line":1}},{"line":92,"address":[5531673,5531603],"length":1,"stats":{"Line":2}},{"line":93,"address":[1713942],"length":1,"stats":{"Line":0}},{"line":95,"address":[1713975,1715167,1714108],"length":1,"stats":{"Line":1}},{"line":96,"address":[5444619],"length":1,"stats":{"Line":0}},{"line":98,"address":[5444582],"length":1,"stats":{"Line":0}},{"line":102,"address":[1714546],"length":1,"stats":{"Line":2}},{"line":103,"address":[1714205],"length":1,"stats":{"Line":1}},{"line":104,"address":[1714245,1714324],"length":1,"stats":{"Line":3}},{"line":105,"address":[5532407],"length":1,"stats":{"Line":1}},{"line":106,"address":[1714538],"length":1,"stats":{"Line":1}},{"line":110,"address":[1718643,1715312,1718888],"length":1,"stats":{"Line":1}},{"line":111,"address":[1715351],"length":1,"stats":{"Line":2}},{"line":113,"address":[1715388,1715471],"length":1,"stats":{"Line":4}},{"line":114,"address":[1715506],"length":1,"stats":{"Line":1}},{"line":117,"address":[5444736],"length":1,"stats":{"Line":3}},{"line":118,"address":[1941615],"length":1,"stats":{"Line":0}},{"line":120,"address":[1941574],"length":1,"stats":{"Line":0}},{"line":123,"address":[1718853,1716004,1716210],"length":1,"stats":{"Line":2}},{"line":124,"address":[1716378],"length":1,"stats":{"Line":1}},{"line":126,"address":[1716537,1716457],"length":1,"stats":{"Line":2}},{"line":127,"address":[1716598],"length":1,"stats":{"Line":1}},{"line":128,"address":[1716763],"length":1,"stats":{"Line":1}},{"line":129,"address":[1716885],"length":1,"stats":{"Line":1}},{"line":130,"address":[1717009],"length":1,"stats":{"Line":1}},{"line":134,"address":[5535107],"length":1,"stats":{"Line":1}},{"line":135,"address":[5535208],"length":1,"stats":{"Line":1}},{"line":136,"address":[1717208,1717335],"length":1,"stats":{"Line":0}},{"line":137,"address":[1717389],"length":1,"stats":{"Line":0}},{"line":139,"address":[5444912,5444934],"length":1,"stats":{"Line":0}},{"line":140,"address":[1717657,1718780],"length":1,"stats":{"Line":0}},{"line":145,"address":[5535268],"length":1,"stats":{"Line":1}},{"line":146,"address":[5535839],"length":1,"stats":{"Line":1}},{"line":147,"address":[1717887],"length":1,"stats":{"Line":1}},{"line":148,"address":[1717953],"length":1,"stats":{"Line":0}},{"line":149,"address":[5536073,5535973],"length":1,"stats":{"Line":0}},{"line":150,"address":[1718154],"length":1,"stats":{"Line":0}},{"line":153,"address":[1718670,1718012],"length":1,"stats":{"Line":0}},{"line":157,"address":[5536030],"length":1,"stats":{"Line":1}},{"line":159,"address":[1718649,1718191],"length":1,"stats":{"Line":1}},{"line":160,"address":[1718506],"length":1,"stats":{"Line":1}},{"line":161,"address":[1718384],"length":1,"stats":{"Line":1}},{"line":163,"address":[1718427],"length":1,"stats":{"Line":1}},{"line":164,"address":[1718498],"length":1,"stats":{"Line":1}},{"line":171,"address":[1716041],"length":1,"stats":{"Line":3}},{"line":172,"address":[1716095],"length":1,"stats":{"Line":1}},{"line":175,"address":[1720660,1720827,1718912],"length":1,"stats":{"Line":1}},{"line":176,"address":[1718955],"length":1,"stats":{"Line":1}},{"line":178,"address":[1719157],"length":1,"stats":{"Line":1}},{"line":179,"address":[5537212],"length":1,"stats":{"Line":1}},{"line":181,"address":[5537344,5537272,5538907],"length":1,"stats":{"Line":3}},{"line":182,"address":[1719386,1720686],"length":1,"stats":{"Line":1}},{"line":184,"address":[1720555,1719326,1719457,1719576],"length":1,"stats":{"Line":4}},{"line":185,"address":[1719682],"length":1,"stats":{"Line":1}},{"line":186,"address":[1719968,1720666],"length":1,"stats":{"Line":2}},{"line":188,"address":[1720140,1719944],"length":1,"stats":{"Line":2}},{"line":189,"address":[1720175,1720243],"length":1,"stats":{"Line":2}},{"line":190,"address":[1941952],"length":1,"stats":{"Line":1}},{"line":191,"address":[1942011],"length":1,"stats":{"Line":0}},{"line":193,"address":[1941974],"length":1,"stats":{"Line":0}},{"line":197,"address":[5538319],"length":1,"stats":{"Line":1}},{"line":201,"address":[1719716],"length":1,"stats":{"Line":1}},{"line":204,"address":[1721712,1720864,1721706],"length":1,"stats":{"Line":1}},{"line":205,"address":[1720919],"length":1,"stats":{"Line":1}},{"line":206,"address":[1720980,1721117,1721063],"length":1,"stats":{"Line":3}},{"line":207,"address":[1721258],"length":1,"stats":{"Line":1}},{"line":209,"address":[5539315,5539188],"length":1,"stats":{"Line":2}},{"line":213,"address":[1721513,1721613,1721693,1721185],"length":1,"stats":{"Line":2}},{"line":214,"address":[1942250,1942191],"length":1,"stats":{"Line":0}},{"line":216,"address":[1942154],"length":1,"stats":{"Line":0}},{"line":217,"address":[1942213],"length":1,"stats":{"Line":0}},{"line":220,"address":[1721647],"length":1,"stats":{"Line":1}}],"covered":73,"coverable":102},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config.rs"],"content":"use anyhow::Result;\nuse directories::ProjectDirs;\nuse std::{\n    collections::hash_map::DefaultHasher,\n    hash::{Hash, Hasher},\n    path::{Path, PathBuf},\n};\n\n/// Runtime configuration (currently just the DB path).\n#[derive(Debug, Clone)]\npub struct Config {\n    pub db_path: PathBuf,\n}\n\nimpl Config {\n    /// Resolve configuration from environment or derive one per-workspace.\n    ///\n    /// Priority:\n    /// 1. `MARLIN_DB_PATH` env-var (explicit override)\n    /// 2. *Workspace-local* file under XDG data dir\n    ///    (`~/.local/share/marlin/index_\u003chash\u003e.db`)\n    /// 3. Fallback to   `./index.db`  when we cannot locate an XDG dir\n    pub fn load() -\u003e Result\u003cSelf\u003e {\n        // 1) explicit override\n        if let Some(val) = std::env::var_os(\"MARLIN_DB_PATH\") {\n            let p = PathBuf::from(val);\n            std::fs::create_dir_all(p.parent().expect(\"has parent\"))?;\n            return Ok(Self { db_path: p });\n        }\n\n        // 2) derive per-workspace DB name from CWD hash\n        let cwd = std::env::current_dir()?;\n        let mut h = DefaultHasher::new();\n        cwd.hash(\u0026mut h);\n        let digest = h.finish(); // 64-bit\n        let file_name = format!(\"index_{digest:016x}.db\");\n\n        if let Some(dirs) = ProjectDirs::from(\"io\", \"Marlin\", \"marlin\") {\n            let dir = dirs.data_dir();\n            std::fs::create_dir_all(dir)?;\n            return Ok(Self {\n                db_path: dir.join(file_name),\n            });\n        }\n\n        // 3) very last resort – workspace-relative DB\n        Ok(Self {\n            db_path: Path::new(\u0026file_name).to_path_buf(),\n        })\n    }\n}\n","traces":[{"line":23,"address":[5516629,5516623,5515840],"length":1,"stats":{"Line":1}},{"line":25,"address":[2078215],"length":1,"stats":{"Line":1}},{"line":26,"address":[2078350],"length":1,"stats":{"Line":1}},{"line":27,"address":[2078919,2078371,2078553],"length":1,"stats":{"Line":3}},{"line":28,"address":[2078768],"length":1,"stats":{"Line":2}},{"line":32,"address":[2078411,2078990],"length":1,"stats":{"Line":1}},{"line":33,"address":[2079092],"length":1,"stats":{"Line":1}},{"line":34,"address":[2079143],"length":1,"stats":{"Line":1}},{"line":35,"address":[2079178],"length":1,"stats":{"Line":1}},{"line":36,"address":[2079203],"length":1,"stats":{"Line":1}},{"line":38,"address":[2079590,2079488],"length":1,"stats":{"Line":2}},{"line":39,"address":[2079667,2079760],"length":1,"stats":{"Line":2}},{"line":40,"address":[2079792,2080093],"length":1,"stats":{"Line":1}},{"line":41,"address":[2079991],"length":1,"stats":{"Line":1}},{"line":42,"address":[2079920],"length":1,"stats":{"Line":1}},{"line":47,"address":[2080213],"length":1,"stats":{"Line":0}},{"line":48,"address":[2080159],"length":1,"stats":{"Line":0}}],"covered":15,"coverable":17},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config_tests.rs"],"content":"// libmarlin/src/config_tests.rs\n\nuse super::config::Config;\nuse std::env;\nuse tempfile::tempdir;\n\n#[test]\nfn load_env_override() {\n    let tmp = tempdir().unwrap();\n    let db = tmp.path().join(\"custom.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db);\n    let cfg = Config::load().unwrap();\n    assert_eq!(cfg.db_path, db);\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn load_xdg_or_fallback() {\n    // since XDG_DATA_HOME will normally be present, just test it doesn't error\n    let cfg = Config::load().unwrap();\n    assert!(cfg.db_path.to_string_lossy().ends_with(\".db\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","database.rs"],"content":"//! Database abstraction for Marlin\n//! \n//! This module provides a database abstraction layer that wraps the SQLite connection\n//! and provides methods for common database operations.\n\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse anyhow::Result;\n\n/// Options for indexing files\n#[derive(Debug, Clone)]\npub struct IndexOptions {\n    /// Only update files marked as dirty\n    pub dirty_only: bool,\n    \n    /// Index file contents (not just metadata)\n    pub index_contents: bool,\n    \n    /// Maximum file size to index (in bytes)\n    pub max_size: Option\u003cu64\u003e,\n}\n\nimpl Default for IndexOptions {\n    fn default() -\u003e Self {\n        Self {\n            dirty_only: false,\n            index_contents: true,\n            max_size: Some(1_000_000), // 1MB default limit\n        }\n    }\n}\n\n/// Database wrapper for Marlin\npub struct Database {\n    /// The SQLite connection\n    conn: Connection,\n}\n\nimpl Database {\n    /// Create a new database wrapper around an existing connection\n    pub fn new(conn: Connection) -\u003e Self {\n        Self { conn }\n    }\n    \n    /// Get a reference to the underlying connection\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n    \n    /// Get a mutable reference to the underlying connection\n    pub fn conn_mut(\u0026mut self) -\u003e \u0026mut Connection {\n        \u0026mut self.conn\n    }\n    \n    /// Index one or more files\n    pub fn index_files(\u0026mut self, paths: \u0026[PathBuf], _options: \u0026IndexOptions) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would index the files\n        // For now, we just return the number of files \"indexed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n    \n    /// Remove files from the index\n    pub fn remove_files(\u0026mut self, paths: \u0026[PathBuf]) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would remove the files\n        // For now, we just return the number of files \"removed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n    use tempfile::tempdir;\n    use std::fs::File;\n\n    fn setup_db() -\u003e Database {\n        let conn = open_marlin_db(\":memory:\").expect(\"Failed to open in-memory DB\");\n        Database::new(conn)\n    }\n\n    #[test]\n    fn test_database_new_conn_conn_mut() {\n        let mut db = setup_db();\n        let _conn_ref = db.conn();\n        let _conn_mut_ref = db.conn_mut();\n        // Just checking they don't panic and can be called.\n    }\n\n    #[test]\n    fn test_index_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap();\n\n        let paths = vec![file1.to_path_buf()];\n        let options = IndexOptions::default();\n        \n        assert_eq!(db.index_files(\u0026paths, \u0026options).unwrap(), 1);\n        assert_eq!(db.index_files(\u0026[], \u0026options).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_remove_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap(); // File doesn't need to be in DB for this stub\n\n        let paths = vec![file1.to_path_buf()];\n        \n        assert_eq!(db.remove_files(\u0026paths).unwrap(), 1);\n        assert_eq!(db.remove_files(\u0026[]).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_index_options_default() {\n        let options = IndexOptions::default();\n        assert!(!options.dirty_only);\n        assert!(options.index_contents);\n        assert_eq!(options.max_size, Some(1_000_000));\n    }\n}\n","traces":[{"line":24,"address":[5509984],"length":1,"stats":{"Line":1}},{"line":28,"address":[2083427],"length":1,"stats":{"Line":1}},{"line":41,"address":[2083472],"length":1,"stats":{"Line":3}},{"line":46,"address":[2083504],"length":1,"stats":{"Line":1}},{"line":51,"address":[2083520],"length":1,"stats":{"Line":1}},{"line":56,"address":[2083536],"length":1,"stats":{"Line":1}},{"line":59,"address":[2083589],"length":1,"stats":{"Line":1}},{"line":60,"address":[2083619],"length":1,"stats":{"Line":1}},{"line":62,"address":[2083603],"length":1,"stats":{"Line":1}},{"line":66,"address":[2083664],"length":1,"stats":{"Line":1}},{"line":69,"address":[2083714],"length":1,"stats":{"Line":1}},{"line":70,"address":[2083744],"length":1,"stats":{"Line":1}},{"line":72,"address":[2083728],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":13},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","mod.rs"],"content":"//! Central DB helper – connection bootstrap, migrations **and** most\n//! data-access helpers (tags, links, collections, saved views, …).\n\nmod database;\npub use database::{Database, IndexOptions};\n\nuse std::{\n    fs,\n    path::{Path, PathBuf},\n};\n\nuse std::result::Result as StdResult;\nuse anyhow::{Context, Result};\nuse chrono::Local;\nuse rusqlite::{\n    backup::{Backup, StepResult},\n    params,\n    Connection,\n    OpenFlags,\n    OptionalExtension,\n    TransactionBehavior,\n};\nuse tracing::{debug, info, warn};\n\n/* ─── embedded migrations ─────────────────────────────────────────── */\n\nconst MIGRATIONS: \u0026[(\u0026str, \u0026str)] = \u0026[\n    (\"0001_initial_schema.sql\", include_str!(\"migrations/0001_initial_schema.sql\")),\n    (\"0002_update_fts_and_triggers.sql\", include_str!(\"migrations/0002_update_fts_and_triggers.sql\")),\n    (\"0003_create_links_collections_views.sql\", include_str!(\"migrations/0003_create_links_collections_views.sql\")),\n    (\"0004_fix_hierarchical_tags_fts.sql\", include_str!(\"migrations/0004_fix_hierarchical_tags_fts.sql\")),\n    (\"0005_add_dirty_table.sql\", include_str!(\"migrations/0005_add_dirty_table.sql\")),\n];\n\n/* ─── connection bootstrap ────────────────────────────────────────── */\n\npub fn open\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cConnection\u003e {\n    let db_path_ref = db_path.as_ref();\n    let mut conn = Connection::open(db_path_ref)\n        .with_context(|| format!(\"failed to open DB at {}\", db_path_ref.display()))?;\n\n    conn.pragma_update(None, \"journal_mode\", \"WAL\")?;\n    conn.pragma_update(None, \"foreign_keys\", \"ON\")?;\n\n    // Wait up to 30 s for a competing writer before giving up\n    conn.busy_timeout(std::time::Duration::from_secs(30))?;\n\n    apply_migrations(\u0026mut conn)?;\n    Ok(conn)\n}\n\n/* ─── migration runner ────────────────────────────────────────────── */\n\npub(crate) fn apply_migrations(conn: \u0026mut Connection) -\u003e Result\u003c()\u003e {\n    // Ensure schema_version bookkeeping table exists\n    conn.execute_batch(\n        \"CREATE TABLE IF NOT EXISTS schema_version (\n             version     INTEGER PRIMARY KEY,\n             applied_on  TEXT NOT NULL\n         );\",\n    )?;\n\n    // Legacy patch – ignore errors if column already exists\n    let _ = conn.execute(\"ALTER TABLE schema_version ADD COLUMN applied_on TEXT\", []);\n\n    // Grab the write-lock up-front so migrations can run uninterrupted\n    let tx = conn.transaction_with_behavior(TransactionBehavior::Immediate)?;\n\n    for (fname, sql) in MIGRATIONS {\n        let version: i64 = fname\n            .split('_')\n            .next()\n            .and_then(|s| s.parse().ok())\n            .expect(\"migration filenames start with number\");\n\n        let already: Option\u003ci64\u003e = tx\n            .query_row(\n                \"SELECT version FROM schema_version WHERE version = ?1\",\n                [version],\n                |r| r.get(0),\n            )\n            .optional()?;\n\n        if already.is_some() {\n            debug!(\"migration {} already applied\", fname);\n            continue;\n        }\n\n        info!(\"applying migration {}\", fname);\n        tx.execute_batch(sql)\n            .with_context(|| format!(\"could not apply migration {}\", fname))?;\n\n        tx.execute(\n            \"INSERT INTO schema_version (version, applied_on) VALUES (?1, ?2)\",\n            params![version, Local::now().to_rfc3339()],\n        )?;\n    }\n\n    tx.commit()?;\n\n    // sanity – warn if any embedded migration got skipped\n    let mut missing = Vec::new();\n    for (fname, _) in MIGRATIONS {\n        let v: i64 = fname.split('_').next().unwrap().parse().unwrap();\n        let ok: bool = conn\n            .query_row(\n                \"SELECT 1 FROM schema_version WHERE version = ?1\",\n                [v],\n                |_| Ok(true),\n            )\n            .optional()?\n            .unwrap_or(false);\n        if !ok {\n            missing.push(v);\n        }\n    }\n    if !missing.is_empty() {\n        warn!(\"migrations not applied: {:?}\", missing);\n    }\n\n    Ok(())\n}\n\n/* ─── tag helpers ─────────────────────────────────────────────────── */\n\npub fn ensure_tag_path(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    let mut parent: Option\u003ci64\u003e = None;\n    for segment in path.split('/').filter(|s| !s.is_empty()) {\n        conn.execute(\n            \"INSERT OR IGNORE INTO tags(name, parent_id) VALUES (?1, ?2)\",\n            params![segment, parent],\n        )?;\n        let id: i64 = conn.query_row(\n            \"SELECT id FROM tags WHERE name = ?1 AND (parent_id IS ?2 OR parent_id = ?2)\",\n            params![segment, parent],\n            |r| r.get(0),\n        )?;\n        parent = Some(id);\n    }\n    parent.ok_or_else(|| anyhow::anyhow!(\"empty tag path\"))\n}\n\npub fn file_id(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.query_row(\"SELECT id FROM files WHERE path = ?1\", [path], |r| r.get(0))\n        .map_err(|_| anyhow::anyhow!(\"file not indexed: {}\", path))\n}\n\n/* ─── attributes ──────────────────────────────────────────────────── */\n\npub fn upsert_attr(conn: \u0026Connection, file_id: i64, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        r#\"\n        INSERT INTO attributes(file_id, key, value)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(file_id, key) DO UPDATE SET value = excluded.value\n        \"#,\n        params![file_id, key, value],\n    )?;\n    Ok(())\n}\n\n/* ─── links ───────────────────────────────────────────────────────── */\n\npub fn add_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO links(src_file_id, dst_file_id, type)\n         VALUES (?1, ?2, ?3)\n         ON CONFLICT(src_file_id, dst_file_id, type) DO NOTHING\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn remove_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"DELETE FROM links\n         WHERE src_file_id = ?1\n           AND dst_file_id = ?2\n           AND (type IS ?3 OR type = ?3)\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn list_links(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n    direction: Option\u003c\u0026str\u003e,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003cVec\u003c(String, String, Option\u003cString\u003e)\u003e\u003e {\n    let like_pattern = pattern.replace('*', \"%\");\n\n    // Files matching pattern\n    let mut stmt = conn.prepare(\"SELECT id, path FROM files WHERE path LIKE ?1\")?;\n    let rows = stmt\n        .query_map(params![like_pattern], |r| {\n            Ok((r.get::\u003c_, i64\u003e(0)?, r.get::\u003c_, String\u003e(1)?))\n        })?\n        .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n    let mut out = Vec::new();\n    for (fid, fpath) in rows {\n        let (src_col, dst_col) = match direction {\n            Some(\"in\") =\u003e (\"dst_file_id\", \"src_file_id\"),\n            _ =\u003e (\"src_file_id\", \"dst_file_id\"),\n        };\n\n        let sql = format!(\n            \"SELECT f2.path, l.type\n               FROM links l\n               JOIN files f2 ON f2.id = l.{dst_col}\n              WHERE l.{src_col} = ?1\n                AND (?2 IS NULL OR l.type = ?2)\",\n        );\n\n        let mut stmt2 = conn.prepare(\u0026sql)?;\n        let links = stmt2\n            .query_map(params![fid, link_type], |r| {\n                Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n            })?\n            .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n        for (other, typ) in links {\n            out.push((fpath.clone(), other, typ));\n        }\n    }\n    Ok(out)\n}\n\npub fn find_backlinks(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n) -\u003e Result\u003cVec\u003c(String, Option\u003cString\u003e)\u003e\u003e {\n    let like = pattern.replace('*', \"%\");\n\n    let mut stmt = conn.prepare(\n        \"SELECT f1.path, l.type\n           FROM links l\n           JOIN files f1 ON f1.id = l.src_file_id\n           JOIN files f2 ON f2.id = l.dst_file_id\n          WHERE f2.path LIKE ?1\",\n    )?;\n\n    let rows = stmt.query_map([like], |r| {\n        Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n    })?;\n\n    let out = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(out)\n}\n\n/* ─── collections helpers ────────────────────────────────────────── */\n\npub fn ensure_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collections(name) VALUES (?1)\",\n        params![name],\n    )?;\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        params![name],\n        |r| r.get(0),\n    )\n    .context(\"collection lookup failed\")\n}\n\npub fn add_file_to_collection(conn: \u0026Connection, coll_id: i64, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collection_files(collection_id, file_id)\n         VALUES (?1, ?2)\",\n        params![coll_id, file_id],\n    )?;\n    Ok(())\n}\n\npub fn list_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let mut stmt = conn.prepare(\n        r#\"SELECT f.path\n            FROM collections        c\n            JOIN collection_files cf ON cf.collection_id = c.id\n            JOIN files            f  ON f.id            = cf.file_id\n           WHERE c.name = ?1\n           ORDER BY f.path\"#,\n    )?;\n\n    let rows = stmt.query_map([name], |r| r.get::\u003c_, String\u003e(0))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\n/* ─── saved views (smart folders) ───────────────────────────────── */\n\npub fn save_view(conn: \u0026Connection, name: \u0026str, query: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO views(name, query)\n         VALUES (?1, ?2)\n         ON CONFLICT(name) DO UPDATE SET query = excluded.query\",\n        params![name, query],\n    )?;\n    Ok(())\n}\n\npub fn list_views(conn: \u0026Connection) -\u003e Result\u003cVec\u003c(String, String)\u003e\u003e {\n    let mut stmt = conn.prepare(\"SELECT name, query FROM views ORDER BY name\")?;\n    let rows = stmt.query_map([], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\npub fn view_query(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cString\u003e {\n    conn.query_row(\n        \"SELECT query FROM views WHERE name = ?1\",\n        [name],\n        |r| r.get::\u003c_, String\u003e(0),\n    )\n    .context(format!(\"no view called '{}'\", name))\n}\n\n/* ─── dirty‐scan helpers ─────────────────────────────────────────── */\n\n/// Mark a file as “dirty” so it’ll be picked up by `scan_dirty`.\npub fn mark_dirty(conn: \u0026Connection, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO file_changes(file_id, marked_at)\n         VALUES (?1, strftime('%s','now'))\",\n        params![file_id],\n    )?;\n    Ok(())\n}\n\n/// Take and clear all dirty file IDs for incremental re-scan.\npub fn take_dirty(conn: \u0026Connection) -\u003e Result\u003cVec\u003ci64\u003e\u003e {\n    let mut ids = Vec::new();\n    {\n        let mut stmt = conn.prepare(\"SELECT file_id FROM file_changes\")?;\n        for row in stmt.query_map([], |r| r.get(0))? {\n            ids.push(row?);\n        }\n    }\n    conn.execute(\"DELETE FROM file_changes\", [])?;\n    Ok(ids)\n}\n\n/* ─── backup / restore helpers ────────────────────────────────────── */\n\npub fn backup\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cPathBuf\u003e {\n    let src = db_path.as_ref();\n    let dir = src\n        .parent()\n        .ok_or_else(|| anyhow::anyhow!(\"invalid DB path: {}\", src.display()))?\n        .join(\"backups\");\n    fs::create_dir_all(\u0026dir)?;\n\n    let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S\");\n    let dst = dir.join(format!(\"backup_{stamp}.db\"));\n\n    let src_conn = Connection::open_with_flags(src, OpenFlags::SQLITE_OPEN_READ_ONLY)?;\n    let mut dst_conn = Connection::open(\u0026dst)?;\n\n    let bk = Backup::new(\u0026src_conn, \u0026mut dst_conn)?;\n    while let StepResult::More = bk.step(100)? {}\n    Ok(dst)\n}\n\npub fn restore\u003cP: AsRef\u003cPath\u003e\u003e(backup_path: P, live_db_path: P) -\u003e Result\u003c()\u003e {\n    fs::copy(\u0026backup_path, \u0026live_db_path)?;\n    Ok(())\n}\n\n/* ─── tests ───────────────────────────────────────────────────────── */\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn migrations_apply_in_memory() {\n        open(\":memory:\").expect(\"all migrations apply\");\n    }\n}\n","traces":[{"line":37,"address":[5479632,5480989,5479584],"length":1,"stats":{"Line":10}},{"line":38,"address":[],"length":0,"stats":{"Line":20}},{"line":39,"address":[5479827,5480995,5479709],"length":1,"stats":{"Line":10}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":42,"address":[1760529,1762721,1761802,1761913,1761337,1759969,1760418,1759050,1759161],"length":1,"stats":{"Line":16}},{"line":43,"address":[1760687,1761335,1759319,1762071,1762719,1759967],"length":1,"stats":{"Line":4}},{"line":46,"address":[1762304,1759965,1762717,1759552,1761333,1760920],"length":1,"stats":{"Line":7}},{"line":48,"address":[],"length":0,"stats":{"Line":7}},{"line":49,"address":[5480888],"length":1,"stats":{"Line":3}},{"line":54,"address":[5373047,5375769,5370432],"length":1,"stats":{"Line":1}},{"line":56,"address":[5370577,5370458],"length":1,"stats":{"Line":1}},{"line":64,"address":[5370619],"length":1,"stats":{"Line":1}},{"line":67,"address":[2110984],"length":1,"stats":{"Line":1}},{"line":69,"address":[2111275,2111183],"length":1,"stats":{"Line":2}},{"line":70,"address":[2111405,2113314],"length":1,"stats":{"Line":2}},{"line":73,"address":[5481184,5481204],"length":1,"stats":{"Line":2}},{"line":76,"address":[5375727,5373476,5373266,5373227],"length":1,"stats":{"Line":2}},{"line":79,"address":[5373250],"length":1,"stats":{"Line":1}},{"line":80,"address":[5481248,5481264],"length":1,"stats":{"Line":2}},{"line":84,"address":[5373561],"length":1,"stats":{"Line":6}},{"line":85,"address":[5373628,5375061],"length":1,"stats":{"Line":2}},{"line":89,"address":[5373600,5373666,5373957],"length":1,"stats":{"Line":5}},{"line":90,"address":[2114759,2114628,2115228,2114154],"length":1,"stats":{"Line":6}},{"line":91,"address":[2114743],"length":1,"stats":{"Line":0}},{"line":93,"address":[2114789,2114995,2115123,2115193,2114910],"length":1,"stats":{"Line":5}},{"line":95,"address":[2114801],"length":1,"stats":{"Line":3}},{"line":99,"address":[5371140,5373061],"length":1,"stats":{"Line":7}},{"line":102,"address":[5371343],"length":1,"stats":{"Line":6}},{"line":103,"address":[2111661,2111752],"length":1,"stats":{"Line":7}},{"line":104,"address":[2112731,2111854],"length":1,"stats":{"Line":7}},{"line":105,"address":[2112913,2113111,2113248],"length":1,"stats":{"Line":1}},{"line":108,"address":[2112905],"length":1,"stats":{"Line":6}},{"line":109,"address":[1763504,1763512],"length":1,"stats":{"Line":7}},{"line":113,"address":[2113197],"length":1,"stats":{"Line":6}},{"line":114,"address":[5372962],"length":1,"stats":{"Line":0}},{"line":117,"address":[5371601],"length":1,"stats":{"Line":2}},{"line":118,"address":[2111923,2111988],"length":1,"stats":{"Line":0}},{"line":121,"address":[2111951],"length":1,"stats":{"Line":6}},{"line":126,"address":[5375808],"length":1,"stats":{"Line":1}},{"line":127,"address":[5375844],"length":1,"stats":{"Line":1}},{"line":128,"address":[2116766,2116029],"length":1,"stats":{"Line":4}},{"line":129,"address":[2116264,2116433],"length":1,"stats":{"Line":1}},{"line":131,"address":[5376032],"length":1,"stats":{"Line":1}},{"line":133,"address":[2116545,2116669],"length":1,"stats":{"Line":1}},{"line":135,"address":[5376316],"length":1,"stats":{"Line":1}},{"line":136,"address":[1763600,1763584],"length":1,"stats":{"Line":2}},{"line":138,"address":[2116720],"length":1,"stats":{"Line":1}},{"line":140,"address":[2116364],"length":1,"stats":{"Line":1}},{"line":143,"address":[2116784],"length":1,"stats":{"Line":0}},{"line":144,"address":[2116809],"length":1,"stats":{"Line":0}},{"line":145,"address":[1763744,1763761],"length":1,"stats":{"Line":0}},{"line":150,"address":[2116896],"length":1,"stats":{"Line":1}},{"line":151,"address":[2117135,2117026],"length":1,"stats":{"Line":1}},{"line":157,"address":[2116942],"length":1,"stats":{"Line":1}},{"line":159,"address":[2117175],"length":1,"stats":{"Line":1}},{"line":164,"address":[5377024],"length":1,"stats":{"Line":1}},{"line":170,"address":[2117431,2117322],"length":1,"stats":{"Line":1}},{"line":174,"address":[5377064],"length":1,"stats":{"Line":1}},{"line":176,"address":[2117471],"length":1,"stats":{"Line":1}},{"line":179,"address":[2117504],"length":1,"stats":{"Line":1}},{"line":185,"address":[2117626,2117735],"length":1,"stats":{"Line":1}},{"line":190,"address":[2117544],"length":1,"stats":{"Line":1}},{"line":192,"address":[2117775],"length":1,"stats":{"Line":1}},{"line":195,"address":[2121829,2117808,2121615],"length":1,"stats":{"Line":1}},{"line":201,"address":[2117916],"length":1,"stats":{"Line":1}},{"line":204,"address":[2117985,2118053,2121827],"length":1,"stats":{"Line":2}},{"line":205,"address":[2118422,2121807,2118803,2118602,2118489],"length":1,"stats":{"Line":2}},{"line":206,"address":[2118370],"length":1,"stats":{"Line":2}},{"line":207,"address":[1764030],"length":1,"stats":{"Line":1}},{"line":211,"address":[2118908],"length":1,"stats":{"Line":1}},{"line":212,"address":[2118956,2119056,2119183],"length":1,"stats":{"Line":3}},{"line":213,"address":[2119644,2119284],"length":1,"stats":{"Line":2}},{"line":214,"address":[5379460,5379323],"length":1,"stats":{"Line":0}},{"line":215,"address":[2119480],"length":1,"stats":{"Line":1}},{"line":218,"address":[5379584],"length":1,"stats":{"Line":1}},{"line":226,"address":[2119970,2121711,2119886],"length":1,"stats":{"Line":2}},{"line":227,"address":[2120377,2120758,2120557,2121661,2120444,2121690],"length":1,"stats":{"Line":2}},{"line":228,"address":[2120297],"length":1,"stats":{"Line":2}},{"line":229,"address":[5482462,5483060],"length":1,"stats":{"Line":1}},{"line":233,"address":[2121576,2120855,2120959,2121086],"length":1,"stats":{"Line":4}},{"line":234,"address":[5381277,5381119],"length":1,"stats":{"Line":2}},{"line":237,"address":[5379217],"length":1,"stats":{"Line":1}},{"line":240,"address":[2123125,2123080,2121856],"length":1,"stats":{"Line":1}},{"line":244,"address":[2121926],"length":1,"stats":{"Line":1}},{"line":246,"address":[5382118,5383068,5381923,5381991],"length":1,"stats":{"Line":2}},{"line":254,"address":[5383054,5382295,5382434,5382567],"length":1,"stats":{"Line":3}},{"line":255,"address":[1765246,1765829],"length":1,"stats":{"Line":1}},{"line":258,"address":[2122700,2123036,2122796],"length":1,"stats":{"Line":2}},{"line":259,"address":[5382932],"length":1,"stats":{"Line":1}},{"line":264,"address":[2123168],"length":1,"stats":{"Line":1}},{"line":265,"address":[5383309,5383199],"length":1,"stats":{"Line":1}},{"line":267,"address":[2123203],"length":1,"stats":{"Line":1}},{"line":269,"address":[5383387],"length":1,"stats":{"Line":1}},{"line":271,"address":[5383359],"length":1,"stats":{"Line":1}},{"line":272,"address":[1765920,1765904],"length":1,"stats":{"Line":2}},{"line":277,"address":[2123520],"length":1,"stats":{"Line":1}},{"line":278,"address":[2123604,2123713],"length":1,"stats":{"Line":1}},{"line":281,"address":[5383518],"length":1,"stats":{"Line":1}},{"line":283,"address":[2123753],"length":1,"stats":{"Line":1}},{"line":286,"address":[2123776,2124801,2124809],"length":1,"stats":{"Line":1}},{"line":287,"address":[2123938,2123826],"length":1,"stats":{"Line":1}},{"line":296,"address":[1765952,1765987],"length":1,"stats":{"Line":4}},{"line":297,"address":[2124409,2124760,2124505],"length":1,"stats":{"Line":2}},{"line":298,"address":[5384702],"length":1,"stats":{"Line":1}},{"line":303,"address":[2124832],"length":1,"stats":{"Line":1}},{"line":304,"address":[2125035,2124926],"length":1,"stats":{"Line":1}},{"line":308,"address":[2124872],"length":1,"stats":{"Line":1}},{"line":310,"address":[2125075],"length":1,"stats":{"Line":1}},{"line":313,"address":[2126071,2125104,2126063],"length":1,"stats":{"Line":1}},{"line":314,"address":[2125128],"length":1,"stats":{"Line":1}},{"line":315,"address":[5483968,5484014],"length":1,"stats":{"Line":4}},{"line":316,"address":[2126022,2125769,2125673],"length":1,"stats":{"Line":2}},{"line":317,"address":[2125955],"length":1,"stats":{"Line":1}},{"line":320,"address":[2126096,2126405,2126430],"length":1,"stats":{"Line":1}},{"line":321,"address":[2126130,2126359,2126158],"length":1,"stats":{"Line":3}},{"line":323,"address":[2126138],"length":1,"stats":{"Line":1}},{"line":324,"address":[1766720,1766736],"length":1,"stats":{"Line":2}},{"line":326,"address":[2126193,2126389,2126423,2126217],"length":1,"stats":{"Line":2}},{"line":332,"address":[2126448],"length":1,"stats":{"Line":0}},{"line":333,"address":[2126502,2126611],"length":1,"stats":{"Line":0}},{"line":336,"address":[2126474],"length":1,"stats":{"Line":0}},{"line":338,"address":[2126651],"length":1,"stats":{"Line":0}},{"line":342,"address":[2128121,2128134,2126688],"length":1,"stats":{"Line":0}},{"line":343,"address":[2126723],"length":1,"stats":{"Line":0}},{"line":345,"address":[2126797,2128129,2126733],"length":1,"stats":{"Line":0}},{"line":346,"address":[2127110,2127174,2127448,2128127],"length":1,"stats":{"Line":0}},{"line":347,"address":[2127549,2127919],"length":1,"stats":{"Line":0}},{"line":350,"address":[2127905,2127615],"length":1,"stats":{"Line":0}},{"line":351,"address":[2127818],"length":1,"stats":{"Line":0}},{"line":356,"address":[],"length":0,"stats":{"Line":1}},{"line":357,"address":[],"length":0,"stats":{"Line":2}},{"line":358,"address":[1767096,1766965,1769333],"length":1,"stats":{"Line":1}},{"line":360,"address":[],"length":0,"stats":{"Line":0}},{"line":362,"address":[],"length":0,"stats":{"Line":2}},{"line":364,"address":[],"length":0,"stats":{"Line":1}},{"line":365,"address":[],"length":0,"stats":{"Line":2}},{"line":367,"address":[2498760,2497145,2497253],"length":1,"stats":{"Line":2}},{"line":368,"address":[1768151,1768084,1769239],"length":1,"stats":{"Line":2}},{"line":370,"address":[1768549,1769218,1768482],"length":1,"stats":{"Line":2}},{"line":371,"address":[1768807,1768756],"length":1,"stats":{"Line":2}},{"line":372,"address":[],"length":0,"stats":{"Line":1}},{"line":375,"address":[],"length":0,"stats":{"Line":1}},{"line":376,"address":[],"length":0,"stats":{"Line":2}},{"line":377,"address":[],"length":0,"stats":{"Line":1}}],"covered":124,"coverable":144},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db_tests.rs"],"content":"// libmarlin/src/db_tests.rs\n\nuse super::db;\nuse rusqlite::Connection;\nuse tempfile::tempdir;\n\nfn open_mem() -\u003e Connection {\n    // helper to open an in-memory DB with migrations applied\n    db::open(\":memory:\").expect(\"open in-memory DB\")\n}\n\n#[test]\nfn ensure_tag_path_creates_hierarchy() {\n    let conn = open_mem();\n    // create foo/bar/baz\n    let leaf = db::ensure_tag_path(\u0026conn, \"foo/bar/baz\").unwrap();\n    // foo should exist as a root tag\n    let foo: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='foo' AND parent_id IS NULL\",\n            [],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // bar should be child of foo\n    let bar: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='bar' AND parent_id = ?1\",\n            [foo],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // baz should be child of bar, and its ID is what we got back\n    let baz: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='baz' AND parent_id = ?1\",\n            [bar],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(leaf, baz);\n}\n\n#[test]\nfn upsert_attr_inserts_and_updates() {\n    let conn = open_mem();\n    // insert a dummy file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"a.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='a.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // insert\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v\").unwrap();\n    let v1: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v1, \"v\");\n\n    // update\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v2\").unwrap();\n    let v2: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v2, \"v2\");\n}\n\n#[test]\nfn add_and_remove_links_and_backlinks() {\n    let conn = open_mem();\n    // create two files\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"one.txt\"],\n    )\n    .unwrap();\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"two.txt\"],\n    )\n    .unwrap();\n    let src: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='one.txt'\", [], |r| r.get(0))\n        .unwrap();\n    let dst: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='two.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // add a link of type \"ref\"\n    db::add_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let out = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert_eq!(out.len(), 1);\n    assert_eq!(out[0].2.as_deref(), Some(\"ref\"));\n\n    // backlinks should mirror\n    let back = db::find_backlinks(\u0026conn, \"two%\").unwrap();\n    assert_eq!(back.len(), 1);\n    assert_eq!(back[0].1.as_deref(), Some(\"ref\"));\n\n    // remove it\n    db::remove_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let empty = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert!(empty.is_empty());\n}\n\n#[test]\nfn collections_roundtrip() {\n    let conn = open_mem();\n    // create collection \"C\"\n    let cid = db::ensure_collection(\u0026conn, \"C\").unwrap();\n\n    // add a file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"f.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='f.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    db::add_file_to_collection(\u0026conn, cid, fid).unwrap();\n    let files = db::list_collection(\u0026conn, \"C\").unwrap();\n    assert_eq!(files, vec![\"f.txt\".to_string()]);\n}\n\n#[test]\nfn views_save_and_query() {\n    let conn = open_mem();\n    db::save_view(\u0026conn, \"v1\", \"some_query\").unwrap();\n    let all = db::list_views(\u0026conn).unwrap();\n    assert_eq!(all, vec![(\"v1\".to_string(), \"some_query\".to_string())]);\n\n    let q = db::view_query(\u0026conn, \"v1\").unwrap();\n    assert_eq!(q, \"some_query\");\n}\n\n#[test]\nfn backup_and_restore_cycle() {\n    let tmp = tempdir().unwrap();\n    let db_path = tmp.path().join(\"data.db\");\n    let live = db::open(\u0026db_path).unwrap();\n\n    // insert a file\n    live.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"x.bin\"],\n    )\n    .unwrap();\n\n    // backup\n    let backup = db::backup(\u0026db_path).unwrap();\n    // remove original\n    std::fs::remove_file(\u0026db_path).unwrap();\n    // restore\n    db::restore(\u0026backup, \u0026db_path).unwrap();\n\n    // reopen and check that x.bin survived\n    let conn2 = db::open(\u0026db_path).unwrap();\n    let cnt: i64 =\n        conn2.query_row(\"SELECT COUNT(*) FROM files WHERE path='x.bin'\", [], |r| r.get(0)).unwrap();\n    assert_eq!(cnt, 1);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","error.rs"],"content":"// libmarlin/src/error.rs\n\nuse std::io;\nuse std::fmt;\n// Ensure these are present if Error enum variants use them directly\n// use rusqlite;\n// use notify;\n\npub type Result\u003cT\u003e = std::result::Result\u003cT, Error\u003e;\n\n#[derive(Debug)]\npub enum Error {\n    Io(io::Error),\n    Database(rusqlite::Error), \n    Watch(notify::Error),    \n    InvalidState(String),\n    NotFound(String),\n    Config(String),\n    Other(String),\n}\n\nimpl fmt::Display for Error {\n    fn fmt(\u0026self, f: \u0026mut fmt::Formatter\u003c'_\u003e) -\u003e fmt::Result {\n        match self {\n            Self::Io(err) =\u003e write!(f, \"IO error: {}\", err),\n            Self::Database(err) =\u003e write!(f, \"Database error: {}\", err),\n            Self::Watch(err) =\u003e write!(f, \"Watch error: {}\", err),\n            Self::InvalidState(msg) =\u003e write!(f, \"Invalid state: {}\", msg),\n            Self::NotFound(path) =\u003e write!(f, \"Not found: {}\", path),\n            Self::Config(msg) =\u003e write!(f, \"Configuration error: {}\", msg),\n            Self::Other(msg) =\u003e write!(f, \"Error: {}\", msg),\n        }\n    }\n}\n\nimpl std::error::Error for Error {\n    fn source(\u0026self) -\u003e Option\u003c\u0026(dyn std::error::Error + 'static)\u003e {\n        match self {\n            Self::Io(err) =\u003e Some(err),\n            Self::Database(err) =\u003e Some(err),\n            Self::Watch(err) =\u003e Some(err),\n            Self::InvalidState(_) | Self::NotFound(_) | Self::Config(_) | Self::Other(_) =\u003e None,\n        }\n    }\n}\n\nimpl From\u003cio::Error\u003e for Error {\n    fn from(err: io::Error) -\u003e Self {\n        Self::Io(err)\n    }\n}\n\nimpl From\u003crusqlite::Error\u003e for Error {\n    fn from(err: rusqlite::Error) -\u003e Self {\n        Self::Database(err)\n    }\n}\n\nimpl From\u003cnotify::Error\u003e for Error {\n    fn from(err: notify::Error) -\u003e Self {\n        Self::Watch(err)\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use std::error::Error as StdError; \n\n    #[test]\n    fn test_error_display_and_from() {\n        // Test Io variant\n        let io_err_inner_for_source_check = io::Error::new(io::ErrorKind::NotFound, \"test io error\");\n        let io_err_marlin = Error::from(io::Error::new(io::ErrorKind::NotFound, \"test io error\"));\n        assert_eq!(io_err_marlin.to_string(), \"IO error: test io error\");\n        let source = io_err_marlin.source();\n        assert!(source.is_some(), \"Io error should have a source\");\n        if let Some(s) = source {\n            // Compare details of the source if necessary, or just its string representation\n            assert_eq!(s.to_string(), io_err_inner_for_source_check.to_string());\n        }\n\n        // Test Database variant\n        let rusqlite_err_inner_for_source_check = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        );\n        // We need to create the error again for the From conversion if we want to compare the source\n        let db_err_marlin = Error::from(rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        ));\n        assert!(db_err_marlin.to_string().contains(\"Database error: test db error\"));\n        let source = db_err_marlin.source();\n        assert!(source.is_some(), \"Database error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), rusqlite_err_inner_for_source_check.to_string());\n        }\n\n\n        // Test Watch variant\n        let notify_raw_err_inner_for_source_check = notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string()));\n        let watch_err_marlin = Error::from(notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string())));\n        assert!(watch_err_marlin.to_string().contains(\"Watch error: test watch error\"));\n        let source = watch_err_marlin.source();\n        assert!(source.is_some(), \"Watch error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), notify_raw_err_inner_for_source_check.to_string());\n        }\n\n\n        let invalid_state_err = Error::InvalidState(\"bad state\".to_string());\n        assert_eq!(invalid_state_err.to_string(), \"Invalid state: bad state\");\n        assert!(invalid_state_err.source().is_none());\n\n        let not_found_err = Error::NotFound(\"missing_file.txt\".to_string());\n        assert_eq!(not_found_err.to_string(), \"Not found: missing_file.txt\");\n        assert!(not_found_err.source().is_none());\n\n        let config_err = Error::Config(\"bad config\".to_string());\n        assert_eq!(config_err.to_string(), \"Configuration error: bad config\");\n        assert!(config_err.source().is_none());\n\n        let other_err = Error::Other(\"some other issue\".to_string());\n        assert_eq!(other_err.to_string(), \"Error: some other issue\");\n        assert!(other_err.source().is_none());\n    }\n\n    #[test]\n    fn test_rusqlite_error_without_message() {\n        let sqlite_busy_error = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        );\n        let db_err_no_msg = Error::from(sqlite_busy_error);\n        \n        let expected_rusqlite_msg = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        ).to_string(); \n        \n        let expected_marlin_msg = format!(\"Database error: {}\", expected_rusqlite_msg);\n        \n        // Verify the string matches the expected format\n        assert_eq!(db_err_no_msg.to_string(), expected_marlin_msg);\n        \n        // Check the error code directly instead of the string\n        if let Error::Database(rusqlite::Error::SqliteFailure(err, _)) = \u0026db_err_no_msg {\n            assert_eq!(err.code, rusqlite::ffi::ErrorCode::DatabaseBusy);\n        } else {\n            panic!(\"Expected Error::Database variant\");\n        }\n        \n        // Verify the source exists\n        assert!(db_err_no_msg.source().is_some());\n    }\n}","traces":[{"line":23,"address":[5592736],"length":1,"stats":{"Line":1}},{"line":24,"address":[2070560],"length":1,"stats":{"Line":1}},{"line":25,"address":[2070624],"length":1,"stats":{"Line":1}},{"line":26,"address":[2070722],"length":1,"stats":{"Line":1}},{"line":27,"address":[2070839],"length":1,"stats":{"Line":1}},{"line":28,"address":[2070966],"length":1,"stats":{"Line":1}},{"line":29,"address":[2071094],"length":1,"stats":{"Line":1}},{"line":30,"address":[2071222],"length":1,"stats":{"Line":1}},{"line":31,"address":[2071347],"length":1,"stats":{"Line":1}},{"line":37,"address":[2071488],"length":1,"stats":{"Line":1}},{"line":38,"address":[2071498],"length":1,"stats":{"Line":1}},{"line":39,"address":[2071563],"length":1,"stats":{"Line":1}},{"line":40,"address":[5593804],"length":1,"stats":{"Line":2}},{"line":41,"address":[2071625],"length":1,"stats":{"Line":1}},{"line":42,"address":[2071653],"length":1,"stats":{"Line":1}},{"line":48,"address":[2071680],"length":1,"stats":{"Line":1}},{"line":49,"address":[2071688],"length":1,"stats":{"Line":1}},{"line":54,"address":[2071712],"length":1,"stats":{"Line":1}},{"line":55,"address":[2071720],"length":1,"stats":{"Line":1}},{"line":60,"address":[2071744],"length":1,"stats":{"Line":1}},{"line":61,"address":[2071761],"length":1,"stats":{"Line":1}}],"covered":21,"coverable":21},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","facade_tests.rs"],"content":"// libmarlin/src/facade_tests.rs\n\nuse super::*;             // brings Marlin, config, etc.\nuse std::{env, fs};\nuse tempfile::tempdir;\n\n#[test]\nfn open_at_and_scan_and_search() {\n    // 1) Prepare a temp workspace with one file\n    let tmp = tempdir().unwrap();\n    let file = tmp.path().join(\"hello.txt\");\n    fs::write(\u0026file, \"hello FAÇT\").unwrap();\n\n    // 2) Use open_at to create a fresh DB\n    let db_path = tmp.path().join(\"explicit.db\");\n    let mut m = Marlin::open_at(\u0026db_path).expect(\"open_at should succeed\");\n    assert!(db_path.exists(), \"DB file should be created\");\n\n    // 3) Scan the directory\n    let count = m.scan(\u0026[tmp.path()]).expect(\"scan should succeed\");\n    assert_eq!(count, 1, \"we created exactly one file\");\n\n    // 4) Search using an FTS hit\n    let hits = m.search(\"hello\").expect(\"search must not error\");\n    assert_eq!(hits.len(), 1);\n    assert!(hits[0].ends_with(\"hello.txt\"));\n\n    // 5) Search a substring that isn't a valid token (fires fallback)\n    let fallback_hits = m.search(\"FAÇT\").expect(\"fallback search works\");\n    assert_eq!(fallback_hits.len(), 1);\n    assert!(fallback_hits[0].ends_with(\"hello.txt\"));\n}\n\n#[test]\nfn tag_and_search_by_tag() {\n    let tmp = tempdir().unwrap();\n    let a = tmp.path().join(\"a.md\");\n    let b = tmp.path().join(\"b.md\");\n    fs::write(\u0026a, \"# a\").unwrap();\n    fs::write(\u0026b, \"# b\").unwrap();\n\n    let db_path = tmp.path().join(\"my.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db_path);\n\n    let mut m = Marlin::open_default().unwrap();\n    m.scan(\u0026[tmp.path()]).unwrap();\n\n    let changed = m.tag(\"*.md\", \"foo/bar\").unwrap();\n    assert_eq!(changed, 2);\n\n    let tagged = m.search(\"tags_text:\\\"foo/bar\\\"\").unwrap();\n    assert_eq!(tagged.len(), 2);\n\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn open_default_fallback_config() {\n    // Unset all overrides\n    env::remove_var(\"MARLIN_DB_PATH\");\n    env::remove_var(\"XDG_DATA_HOME\");\n\n    // Simulate no XDG: temporarily point HOME to a read-only dir\n    let fake_home = tempdir().unwrap();\n    env::set_var(\"HOME\", fake_home.path());\n    // This should fall back to \"./index_\u003chash\u003e.db\"\n    let cfg = config::Config::load().unwrap();\n    let fname = cfg.db_path.file_name().unwrap().to_string_lossy();\n    assert!(fname.starts_with(\"index_\") \u0026\u0026 fname.ends_with(\".db\"));\n\n    // Clean up\n    env::remove_var(\"HOME\");\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","lib.rs"],"content":"//! libmarlin – public API surface for the Marlin core.\n//!\n//! Down-stream crates (`cli-bin`, `tui-bin`, tests, plugins) should depend\n//! *only* on the helpers re-exported here, never on internal modules\n//! directly.  That gives us room to refactor internals without breaking\n//! callers.\n\n#![deny(warnings)]\n\npub mod backup;\npub mod config;\npub mod db;\npub mod error;\npub mod logging;\npub mod scan;\npub mod utils;\npub mod watcher;\n\n#[cfg(test)]\nmod utils_tests;\n#[cfg(test)]\nmod config_tests;\n#[cfg(test)]\nmod scan_tests;\n#[cfg(test)]\nmod logging_tests;\n#[cfg(test)]\nmod db_tests;\n#[cfg(test)]\nmod facade_tests;\n#[cfg(test)]\nmod watcher_tests;\n\nuse anyhow::{Context, Result};\nuse rusqlite::Connection;\nuse std::{fs, path::Path, sync::{Arc, Mutex}};\n\n/// Main handle for interacting with a Marlin database.\npub struct Marlin {\n    #[allow(dead_code)]\n    cfg: config::Config,\n    conn: Connection,\n}\n\nimpl Marlin {\n    /// Open using the default config (env override or XDG/CWD fallback),\n    /// ensuring parent directories exist and applying migrations.\n    pub fn open_default() -\u003e Result\u003cSelf\u003e {\n        // 1) Load configuration\n        let cfg = config::Config::load()?;\n        // 2) Ensure the DB's parent directory exists\n        if let Some(parent) = cfg.db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // 3) Open the database and run migrations\n        let conn = db::open(\u0026cfg.db_path)\n            .context(format!(\"opening database at {}\", cfg.db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Open a Marlin instance at the specified database path,\n    /// creating parent directories and applying migrations.\n    pub fn open_at\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cSelf\u003e {\n        let db_path = db_path.as_ref();\n        // Ensure the specified DB directory exists\n        if let Some(parent) = db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // Build a minimal Config so callers can still inspect cfg.db_path\n        let cfg = config::Config { db_path: db_path.to_path_buf() };\n        // Open the database and run migrations\n        let conn = db::open(db_path)\n            .context(format!(\"opening database at {}\", db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Recursively index one or more directories.\n    pub fn scan\u003cP: AsRef\u003cPath\u003e\u003e(\u0026mut self, paths: \u0026[P]) -\u003e Result\u003cusize\u003e {\n        let mut total = 0;\n        for p in paths {\n            total += scan::scan_directory(\u0026mut self.conn, p.as_ref())?;\n        }\n        Ok(total)\n    }\n\n    /// Attach a hierarchical tag (`foo/bar`) to every _indexed_ file\n    /// matching the glob.  Returns the number of files actually updated.\n    pub fn tag(\u0026mut self, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003cusize\u003e {\n        use glob::Pattern;\n\n        // 1) ensure tag hierarchy\n        let leaf = db::ensure_tag_path(\u0026self.conn, tag_path)?;\n\n        // 2) collect leaf + ancestors\n        let mut tag_ids = Vec::new();\n        let mut cur = Some(leaf);\n        while let Some(id) = cur {\n            tag_ids.push(id);\n            cur = self.conn.query_row(\n                \"SELECT parent_id FROM tags WHERE id = ?1\",\n                [id],\n                |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n            )?;\n        }\n\n        // 3) match files by glob against stored paths\n        let expanded = shellexpand::tilde(pattern).into_owned();\n        let pat = Pattern::new(\u0026expanded)\n            .with_context(|| format!(\"Invalid glob pattern `{}`\", expanded))?;\n\n        let mut stmt_all = self.conn.prepare(\"SELECT id, path FROM files\")?;\n        let rows = stmt_all.query_map([], |r| Ok((r.get(0)?, r.get(1)?)))?;\n\n        let mut stmt_ins = self.conn.prepare(\n            \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n        )?;\n\n        let mut changed = 0;\n        for row in rows {\n            let (fid, path_str): (i64, String) = row?;\n            let is_match = if expanded.contains(std::path::MAIN_SEPARATOR) {\n                pat.matches(\u0026path_str)\n            } else {\n                Path::new(\u0026path_str)\n                    .file_name()\n                    .and_then(|n| n.to_str())\n                    .map(|n| pat.matches(n))\n                    .unwrap_or(false)\n            };\n            if !is_match {\n                continue;\n            }\n\n            let mut newly = false;\n            for \u0026tid in \u0026tag_ids {\n                if stmt_ins.execute([fid, tid])? \u003e 0 {\n                    newly = true;\n                }\n            }\n            if newly {\n                changed += 1;\n            }\n        }\n        Ok(changed)\n    }\n\n    /// Full-text search over path, tags, and attrs, with substring fallback.\n    pub fn search(\u0026self, query: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let mut stmt = self.conn.prepare(\n            \"SELECT f.path FROM files_fts JOIN files f ON f.rowid = files_fts.rowid WHERE files_fts MATCH ?1 ORDER BY rank\",\n        )?;\n        let mut hits = stmt.query_map([query], |r| r.get(0))?\n            .collect::\u003cstd::result::Result\u003cVec\u003c_\u003e, rusqlite::Error\u003e\u003e()?;\n\n        if hits.is_empty() \u0026\u0026 !query.contains(':') {\n            hits = self.fallback_search(query)?;\n        }\n        Ok(hits)\n    }\n\n    fn fallback_search(\u0026self, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let needle = term.to_lowercase();\n        let mut stmt = self.conn.prepare(\"SELECT path FROM files\")?;\n        let rows = stmt.query_map([], |r| r.get(0))?;\n        let mut out = Vec::new();\n        for res in rows {\n            let p: String = res?;\n            if p.to_lowercase().contains(\u0026needle) {\n                out.push(p.clone());\n                continue;\n            }\n            if let Ok(meta) = fs::metadata(\u0026p) {\n                if meta.len() \u003c= 65_536 { \n                    if let Ok(body) = fs::read_to_string(\u0026p) {\n                        if body.to_lowercase().contains(\u0026needle) {\n                            out.push(p.clone());\n                        }\n                    }\n                }\n            }\n        }\n        Ok(out)\n    }\n\n    /// Borrow the raw SQLite connection.\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n\n    /// Spawn a file-watcher that indexes changes in real time.\n    pub fn watch\u003cP: AsRef\u003cPath\u003e\u003e(\n        \u0026mut self,\n        path: P,\n        config: Option\u003cwatcher::WatcherConfig\u003e,\n    ) -\u003e Result\u003cwatcher::FileWatcher\u003e {\n        let cfg = config.unwrap_or_default();\n        let p = path.as_ref().to_path_buf();\n        let new_conn = db::open(\u0026self.cfg.db_path)\n            .context(\"opening database for watcher\")?;\n        let watcher_db = Arc::new(Mutex::new(db::Database::new(new_conn)));\n        \n        let mut owned_w = watcher::FileWatcher::new(vec![p], cfg)?;\n        owned_w.with_database(watcher_db); // Modifies owned_w in place\n        owned_w.start()?; // Start the watcher after it has been fully configured\n        \n        Ok(owned_w) // Return the owned FileWatcher\n    }\n}","traces":[{"line":48,"address":[5390771,5390765,5389632],"length":1,"stats":{"Line":1}},{"line":50,"address":[2099265],"length":1,"stats":{"Line":1}},{"line":52,"address":[2099445,2099509],"length":1,"stats":{"Line":2}},{"line":53,"address":[2099656,2099619],"length":1,"stats":{"Line":2}},{"line":56,"address":[2099768,2100017,2100122,2100080,2099644,2100322],"length":1,"stats":{"Line":4}},{"line":57,"address":[2099798,2099781,2100106,2100335,2100056],"length":1,"stats":{"Line":2}},{"line":58,"address":[2100169],"length":1,"stats":{"Line":1}},{"line":63,"address":[],"length":0,"stats":{"Line":1}},{"line":64,"address":[1683494,1683573],"length":1,"stats":{"Line":2}},{"line":66,"address":[],"length":0,"stats":{"Line":1}},{"line":67,"address":[],"length":0,"stats":{"Line":2}},{"line":70,"address":[1683849,1683722],"length":1,"stats":{"Line":2}},{"line":72,"address":[],"length":0,"stats":{"Line":4}},{"line":73,"address":[1683970,1684249,1683954,1684500,1684199],"length":1,"stats":{"Line":2}},{"line":74,"address":[],"length":0,"stats":{"Line":1}},{"line":78,"address":[],"length":0,"stats":{"Line":1}},{"line":79,"address":[],"length":0,"stats":{"Line":1}},{"line":80,"address":[],"length":0,"stats":{"Line":2}},{"line":81,"address":[1684765,1684843,1684666],"length":1,"stats":{"Line":1}},{"line":83,"address":[],"length":0,"stats":{"Line":1}},{"line":88,"address":[5395118,5390784,5394802],"length":1,"stats":{"Line":1}},{"line":92,"address":[2100477],"length":1,"stats":{"Line":1}},{"line":95,"address":[5391027],"length":1,"stats":{"Line":1}},{"line":96,"address":[2100629],"length":1,"stats":{"Line":1}},{"line":97,"address":[5391516,5391069],"length":1,"stats":{"Line":2}},{"line":98,"address":[5391107],"length":1,"stats":{"Line":1}},{"line":99,"address":[2100799,2100811,2100986,2101093],"length":1,"stats":{"Line":2}},{"line":101,"address":[2100803],"length":1,"stats":{"Line":1}},{"line":102,"address":[1684864,1684880],"length":1,"stats":{"Line":2}},{"line":107,"address":[5391572,5391149],"length":1,"stats":{"Line":2}},{"line":108,"address":[5391690,5391607,5391824,5395100],"length":1,"stats":{"Line":2}},{"line":109,"address":[5391808],"length":1,"stats":{"Line":0}},{"line":111,"address":[2104506,2101615,2101540],"length":1,"stats":{"Line":2}},{"line":112,"address":[5600174,5600128],"length":1,"stats":{"Line":4}},{"line":114,"address":[5392707,5392901,5392779,5394889],"length":1,"stats":{"Line":2}},{"line":118,"address":[5393106],"length":1,"stats":{"Line":1}},{"line":119,"address":[2102748,2102641,2102824],"length":1,"stats":{"Line":3}},{"line":120,"address":[2102941,2104294,2103115],"length":1,"stats":{"Line":2}},{"line":121,"address":[2103353,2103436],"length":1,"stats":{"Line":2}},{"line":122,"address":[5394005,5394179],"length":1,"stats":{"Line":0}},{"line":124,"address":[2103474,2103529],"length":1,"stats":{"Line":2}},{"line":126,"address":[5600654,5600640],"length":1,"stats":{"Line":2}},{"line":127,"address":[5600672,5600690],"length":1,"stats":{"Line":2}},{"line":130,"address":[2103643],"length":1,"stats":{"Line":1}},{"line":134,"address":[5394239],"length":1,"stats":{"Line":1}},{"line":135,"address":[2103741],"length":1,"stats":{"Line":1}},{"line":136,"address":[2103879,2104015,2104208],"length":1,"stats":{"Line":3}},{"line":137,"address":[5394726],"length":1,"stats":{"Line":1}},{"line":140,"address":[5394448,5394515],"length":1,"stats":{"Line":2}},{"line":141,"address":[2103995,2103958],"length":1,"stats":{"Line":1}},{"line":144,"address":[2102966],"length":1,"stats":{"Line":1}},{"line":148,"address":[5396601,5396611,5395136],"length":1,"stats":{"Line":1}},{"line":149,"address":[2104781,2104664],"length":1,"stats":{"Line":1}},{"line":152,"address":[1685632,1685667],"length":1,"stats":{"Line":4}},{"line":155,"address":[2105992,2105465,2105656,2105536],"length":1,"stats":{"Line":4}},{"line":156,"address":[5396430,5396266],"length":1,"stats":{"Line":1}},{"line":158,"address":[2105547],"length":1,"stats":{"Line":1}},{"line":161,"address":[5396624,5399133,5399481],"length":1,"stats":{"Line":1}},{"line":162,"address":[2106145],"length":1,"stats":{"Line":1}},{"line":163,"address":[2106261,2106186,2108847],"length":1,"stats":{"Line":2}},{"line":164,"address":[5397211,5397140,5399458],"length":1,"stats":{"Line":4}},{"line":165,"address":[2106856],"length":1,"stats":{"Line":1}},{"line":166,"address":[2107084,2107008,2106916],"length":1,"stats":{"Line":3}},{"line":167,"address":[2107346,2107201],"length":1,"stats":{"Line":2}},{"line":168,"address":[2107623,2107552],"length":1,"stats":{"Line":2}},{"line":169,"address":[2108664],"length":1,"stats":{"Line":0}},{"line":172,"address":[2107804,2107894],"length":1,"stats":{"Line":2}},{"line":173,"address":[2107962,2107901,2108574],"length":1,"stats":{"Line":3}},{"line":174,"address":[2108088,2107990],"length":1,"stats":{"Line":2}},{"line":175,"address":[2108136,2108207],"length":1,"stats":{"Line":2}},{"line":176,"address":[2108391],"length":1,"stats":{"Line":1}},{"line":182,"address":[2107234],"length":1,"stats":{"Line":1}},{"line":186,"address":[2108864],"length":1,"stats":{"Line":0}},{"line":187,"address":[2108872],"length":1,"stats":{"Line":0}},{"line":191,"address":[2308112,2308196,2309672],"length":1,"stats":{"Line":0}},{"line":196,"address":[],"length":0,"stats":{"Line":0}},{"line":197,"address":[],"length":0,"stats":{"Line":0}},{"line":198,"address":[],"length":0,"stats":{"Line":0}},{"line":200,"address":[],"length":0,"stats":{"Line":0}},{"line":202,"address":[],"length":0,"stats":{"Line":0}},{"line":203,"address":[2309358],"length":1,"stats":{"Line":0}},{"line":204,"address":[2309429],"length":1,"stats":{"Line":0}},{"line":206,"address":[2309555],"length":1,"stats":{"Line":0}}],"covered":69,"coverable":83},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging.rs"],"content":"use tracing_subscriber::{fmt, EnvFilter};\n\n/// Initialise global tracing subscriber.\n///\n/// Reads `RUST_LOG` for filtering, falls back to `info`.\npub fn init() {\n    let filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new(\"info\"));\n\n    // All tracing output (INFO, WARN, ERROR …) now goes to *stderr* so the\n    // integration tests can assert on warnings / errors reliably.\n    fmt()\n        .with_target(false)        // hide module targets\n        .with_level(true)          // include log level\n        .with_env_filter(filter)   // respect RUST_LOG\n        .with_writer(std::io::stderr) // \u003c-- NEW: send to stderr\n        .init();\n}\n","traces":[{"line":6,"address":[2108944,2109307,2109278],"length":1,"stats":{"Line":1}},{"line":7,"address":[2108981],"length":1,"stats":{"Line":1}},{"line":11,"address":[2109041,2109119,2109197],"length":1,"stats":{"Line":3}},{"line":14,"address":[2109154],"length":1,"stats":{"Line":1}}],"covered":4,"coverable":4},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging_tests.rs"],"content":"// libmarlin/src/logging_tests.rs\n\nuse super::logging;\nuse tracing::Level;\n\n#[test]\nfn init_sets_up_subscriber() {\n    // set RUST_LOG to something to test the EnvFilter path\n    std::env::set_var(\"RUST_LOG\", \"debug\");\n    logging::init();\n    tracing::event!(Level::INFO, \"this is a test log\");\n    // if we made it here without panic, we’re good\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan.rs"],"content":"// src/scan.rs\n\nuse std::fs;\nuse std::path::Path;\n\nuse anyhow::Result;\nuse rusqlite::{params, Connection};\nuse tracing::{debug, info};\nuse walkdir::WalkDir;\n\n/// Recursively walk `root` and upsert file metadata.\n/// Triggers keep the FTS table in sync.\npub fn scan_directory(conn: \u0026mut Connection, root: \u0026Path) -\u003e Result\u003cusize\u003e {\n    // Begin a transaction so we batch many inserts/updates together\n    let tx = conn.transaction()?;\n\n    // Prepare the upsert statement once\n    let mut stmt = tx.prepare(\n        r#\"\n        INSERT INTO files(path, size, mtime)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(path) DO UPDATE\n            SET size  = excluded.size,\n                mtime = excluded.mtime\n        \"#,\n    )?;\n\n    let mut count = 0usize;\n\n    // Walk the directory recursively\n    for entry in WalkDir::new(root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let path = entry.path();\n\n        // Skip the database file and its WAL/SHM siblings\n        if let Some(name) = path.file_name().and_then(|n| n.to_str()) {\n            if name.ends_with(\".db\") || name.ends_with(\"-wal\") || name.ends_with(\"-shm\") {\n                continue;\n            }\n        }\n\n        // Gather file metadata\n        let meta = fs::metadata(path)?;\n        let size = meta.len() as i64;\n        let mtime = meta\n            .modified()?\n            .duration_since(std::time::UNIX_EPOCH)?\n            .as_secs() as i64;\n\n        // Execute the upsert\n        let path_str = path.to_string_lossy();\n        stmt.execute(params![path_str, size, mtime])?;\n        count += 1;\n\n        debug!(file = %path_str, \"indexed\");\n    }\n\n    // Finalize and commit\n    drop(stmt);\n    tx.commit()?;\n\n    info!(indexed = count, \"scan complete\");\n    Ok(count)\n}\n","traces":[{"line":13,"address":[5442107,5436832,5441856],"length":1,"stats":{"Line":1}},{"line":15,"address":[1954756],"length":1,"stats":{"Line":1}},{"line":18,"address":[1954971,1955035,1955184,1959810],"length":1,"stats":{"Line":2}},{"line":28,"address":[1955409],"length":1,"stats":{"Line":1}},{"line":31,"address":[1955662,1955429,1955477],"length":1,"stats":{"Line":3}},{"line":34,"address":[2057008,2057035],"length":1,"stats":{"Line":2}},{"line":36,"address":[1957173,1955747],"length":1,"stats":{"Line":2}},{"line":39,"address":[1957211],"length":1,"stats":{"Line":3}},{"line":40,"address":[1957544,1957463,1957388],"length":1,"stats":{"Line":3}},{"line":46,"address":[1957434,1959697,1957612],"length":1,"stats":{"Line":2}},{"line":47,"address":[5440026],"length":1,"stats":{"Line":1}},{"line":48,"address":[1957947,1957851,1959629,1958123],"length":1,"stats":{"Line":1}},{"line":49,"address":[5440141],"length":1,"stats":{"Line":0}},{"line":50,"address":[5440311],"length":1,"stats":{"Line":0}},{"line":54,"address":[1958255],"length":1,"stats":{"Line":1}},{"line":55,"address":[5440492,5440654,5441802],"length":1,"stats":{"Line":2}},{"line":56,"address":[1958667,1958607],"length":1,"stats":{"Line":1}},{"line":58,"address":[1958642,1958936,1958691],"length":1,"stats":{"Line":3}},{"line":62,"address":[1955800],"length":1,"stats":{"Line":1}},{"line":63,"address":[1955903,1957078],"length":1,"stats":{"Line":1}},{"line":65,"address":[1956459,1956110],"length":1,"stats":{"Line":2}},{"line":66,"address":[1956410],"length":1,"stats":{"Line":1}}],"covered":20,"coverable":22},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan_tests.rs"],"content":"// libmarlin/src/scan_tests.rs\n\nuse super::scan::scan_directory;\nuse super::db;\nuse tempfile::tempdir;\nuse std::fs::File;\n\n#[test]\nfn scan_directory_counts_files() {\n    let tmp = tempdir().unwrap();\n\n    // create a couple of files\n    File::create(tmp.path().join(\"a.txt\")).unwrap();\n    File::create(tmp.path().join(\"b.log\")).unwrap();\n\n    // open an in-memory DB (runs migrations)\n    let mut conn = db::open(\":memory:\").unwrap();\n\n    let count = scan_directory(\u0026mut conn, tmp.path()).unwrap();\n    assert_eq!(count, 2);\n\n    // ensure the paths were inserted\n    let mut stmt = conn.prepare(\"SELECT COUNT(*) FROM files\").unwrap();\n    let total: i64 = stmt.query_row([], |r| r.get(0)).unwrap();\n    assert_eq!(total, 2);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils.rs"],"content":"//! Misc shared helpers.\n\nuse std::path::PathBuf;\n\n/// Determine a filesystem root to limit recursive walking on glob scans.\n///\n/// If the pattern contains any of `*?[`, we take everything up to the\n/// first such character, and then (if that still contains metacharacters)\n/// walk up until there aren’t any left.  If there are *no* metachars at\n/// all, we treat the entire string as a path and return its parent\n/// directory (or `.` if it has no parent).\npub fn determine_scan_root(pattern: \u0026str) -\u003e PathBuf {\n    // find first wildcard char\n    let first_wild = pattern\n        .find(|c| matches!(c, '*' | '?' | '['))\n        .unwrap_or(pattern.len());\n\n    // everything up to the wildcard (or the whole string if none)\n    let prefix = \u0026pattern[..first_wild];\n    let mut root = PathBuf::from(prefix);\n\n    // If there were NO wildcards at all, just return the parent directory\n    if first_wild == pattern.len() {\n        return root.parent().map(|p| p.to_path_buf()).unwrap_or_else(|| PathBuf::from(\".\"));\n    }\n\n    // Otherwise, if the prefix still has any wildcards (e.g. \"foo*/bar\"),\n    // walk back up until it doesn’t\n    while root\n        .as_os_str()\n        .to_string_lossy()\n        .chars()\n        .any(|c| matches!(c, '*' | '?' | '['))\n    {\n        root = root.parent().map(|p| p.to_path_buf()).unwrap_or_default();\n    }\n\n    if root.as_os_str().is_empty() {\n        PathBuf::from(\".\")\n    } else {\n        root\n    }\n}\n","traces":[{"line":12,"address":[5518304,5519490,5519621],"length":1,"stats":{"Line":1}},{"line":14,"address":[1785170,1785101],"length":1,"stats":{"Line":2}},{"line":15,"address":[2163328,2163341],"length":1,"stats":{"Line":2}},{"line":16,"address":[1785146],"length":1,"stats":{"Line":1}},{"line":19,"address":[1785217],"length":1,"stats":{"Line":1}},{"line":20,"address":[1785252],"length":1,"stats":{"Line":1}},{"line":23,"address":[1785368,1785293],"length":1,"stats":{"Line":2}},{"line":24,"address":[5629772,5629734,5629760,5629712],"length":1,"stats":{"Line":4}},{"line":29,"address":[1785381,1785454,1786189,1785591],"length":1,"stats":{"Line":3}},{"line":33,"address":[1785663,1785537],"length":1,"stats":{"Line":4}},{"line":35,"address":[1786050,1785935],"length":1,"stats":{"Line":0}},{"line":38,"address":[1785838,1785712],"length":1,"stats":{"Line":3}},{"line":39,"address":[1785883,1785848],"length":1,"stats":{"Line":2}},{"line":41,"address":[1785795],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":14},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils_tests.rs"],"content":"// libmarlin/src/utils_tests.rs\n\nuse super::utils::determine_scan_root;\nuse std::path::PathBuf;\n\n#[test]\nfn determine_scan_root_plain_path() {\n    let root = determine_scan_root(\"foo/bar/baz.txt\");\n    assert_eq!(root, PathBuf::from(\"foo/bar\"));\n}\n\n#[test]\nfn determine_scan_root_glob() {\n    let root = determine_scan_root(\"foo/*/baz.rs\");\n    assert_eq!(root, PathBuf::from(\"foo\"));\n}\n\n#[test]\nfn determine_scan_root_only_wildcards() {\n    let root = determine_scan_root(\"**/*.txt\");\n    assert_eq!(root, PathBuf::from(\".\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher.rs"],"content":"// libmarlin/src/watcher.rs\n\n//! File system watcher implementation for Marlin\n//!\n//! This module provides real-time index updates by monitoring file system events\n//! (create, modify, delete) using the `notify` crate. It implements event debouncing,\n//! batch processing, and a state machine for robust lifecycle management.\n\nuse anyhow::{Result, Context};\nuse crate::db::Database;\nuse crossbeam_channel::{bounded, Receiver};\nuse notify::{Event, EventKind, RecommendedWatcher, RecursiveMode, Watcher as NotifyWatcherTrait};\nuse std::collections::HashMap;\nuse std::path::PathBuf;\nuse std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};\nuse std::sync::{Arc, Mutex};\nuse std::thread::{self, JoinHandle};\nuse std::time::{Duration, Instant};\n// REMOVED: use std::fs; // \u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c THIS LINE WAS REMOVED\n\n/// Configuration for the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherConfig {\n    /// Time in milliseconds to debounce file events\n    pub debounce_ms: u64,\n\n    /// Maximum number of events to process in a single batch\n    pub batch_size: usize,\n\n    /// Maximum size of the event queue before applying backpressure\n    pub max_queue_size: usize,\n\n    /// Time in milliseconds to wait for events to drain during shutdown\n    pub drain_timeout_ms: u64,\n}\n\nimpl Default for WatcherConfig {\n    fn default() -\u003e Self {\n        Self {\n            debounce_ms: 100,\n            batch_size: 1000,\n            max_queue_size: 100_000,\n            drain_timeout_ms: 5000,\n        }\n    }\n}\n\n/// State of the file watcher\n#[derive(Debug, Clone, PartialEq, Eq)]\npub enum WatcherState {\n    Initializing,\n    Watching,\n    Paused,\n    ShuttingDown,\n    Stopped,\n}\n\n/// Status information about the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherStatus {\n    pub state: WatcherState,\n    pub events_processed: usize,\n    pub queue_size: usize,\n    pub start_time: Option\u003cInstant\u003e,\n    pub watched_paths: Vec\u003cPathBuf\u003e,\n}\n\n#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]\nenum EventPriority {\n    Create = 0,\n    Delete = 1,\n    Modify = 2,\n    Access = 3,\n}\n\n#[derive(Debug, Clone)]\nstruct ProcessedEvent {\n    path: PathBuf,\n    kind: EventKind,\n    priority: EventPriority,\n    timestamp: Instant,\n}\n\nstruct EventDebouncer {\n    events: HashMap\u003cPathBuf, ProcessedEvent\u003e,\n    debounce_window_ms: u64,\n    last_flush: Instant,\n}\n\nimpl EventDebouncer {\n    fn new(debounce_window_ms: u64) -\u003e Self {\n        Self {\n            events: HashMap::new(),\n            debounce_window_ms,\n            last_flush: Instant::now(),\n        }\n    }\n\n    fn add_event(\u0026mut self, event: ProcessedEvent) {\n        let path = event.path.clone();\n        if path.is_dir() { // This relies on the PathBuf itself knowing if it's a directory\n                           // or on the underlying FS. For unit tests, ensure paths are created.\n            self.events.retain(|file_path, _| !file_path.starts_with(\u0026path) || file_path == \u0026path );\n        }\n        match self.events.get_mut(\u0026path) {\n            Some(existing) =\u003e {\n                if event.priority \u003c existing.priority {\n                    existing.priority = event.priority;\n                }\n                existing.timestamp = event.timestamp;\n                existing.kind = event.kind;\n            }\n            None =\u003e {\n                self.events.insert(path, event);\n            }\n        }\n    }\n\n    fn is_ready_to_flush(\u0026self) -\u003e bool {\n        self.last_flush.elapsed() \u003e= Duration::from_millis(self.debounce_window_ms)\n    }\n\n    fn flush(\u0026mut self) -\u003e Vec\u003cProcessedEvent\u003e {\n        let mut events: Vec\u003cProcessedEvent\u003e = self.events.drain().map(|(_, e)| e).collect();\n        events.sort_by_key(|e| e.priority);\n        self.last_flush = Instant::now();\n        events\n    }\n\n    #[allow(dead_code)]\n    fn len(\u0026self) -\u003e usize {\n        self.events.len()\n    }\n}\n\n#[cfg(test)]\nmod event_debouncer_tests {\n    use super::*;\n    use notify::event::{CreateKind, DataChange, ModifyKind, RemoveKind, RenameMode};\n    use std::fs; // fs is needed for these tests to create dirs/files\n    use tempfile; \n\n    #[test]\n    fn debouncer_add_and_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110)); \n        assert!(debouncer.is_ready_to_flush());\n        assert_eq!(debouncer.len(), 0);\n\n        let path1 = PathBuf::from(\"file1.txt\");\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 1);\n        \n        debouncer.last_flush = Instant::now(); \n        assert!(!debouncer.is_ready_to_flush());\n\n        std::thread::sleep(Duration::from_millis(110));\n        assert!(debouncer.is_ready_to_flush());\n\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(debouncer.len(), 0);\n        assert!(!debouncer.is_ready_to_flush()); \n    }\n\n    #[test]\n    fn debouncer_coalesce_events() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n\n        let t1 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: t1,\n        });\n        std::thread::sleep(Duration::from_millis(10));\n        let t2 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Modify(ModifyKind::Data(DataChange::Any)),\n            priority: EventPriority::Modify,\n            timestamp: t2,\n        });\n        \n        assert_eq!(debouncer.len(), 1);\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!( \n            flushed[0].kind,\n            EventKind::Modify(ModifyKind::Data(DataChange::Any))\n        );\n        assert_eq!(flushed[0].timestamp, t2);\n    }\n\n    #[test]\n    fn debouncer_hierarchical() {\n        let mut debouncer_h = EventDebouncer::new(100);\n        let temp_dir_obj = tempfile::tempdir().expect(\"Failed to create temp dir\");\n        let p_dir = temp_dir_obj.path().to_path_buf(); \n        let p_file = p_dir.join(\"file.txt\");\n        \n        fs::File::create(\u0026p_file).expect(\"Failed to create test file for hierarchical debounce\");\n\n        debouncer_h.add_event(ProcessedEvent {\n            path: p_file.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1);\n        \n        debouncer_h.add_event(ProcessedEvent {\n            path: p_dir.clone(), \n            kind: EventKind::Remove(RemoveKind::Folder), \n            priority: EventPriority::Delete,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1, \"Hierarchical debounce should remove child event, leaving only parent dir event\");\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer_h.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, p_dir);\n    }\n\n    #[test]\n    fn debouncer_different_files() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n        let path2 = PathBuf::from(\"file2.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: path2.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n    }\n\n    #[test]\n    fn debouncer_priority_sorting_on_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\"); \n        let path2 = PathBuf::from(\"file2.txt\"); \n        let path3 = PathBuf::from(\"file3.txt\"); \n\n        debouncer.add_event(ProcessedEvent { path: path1, kind: EventKind::Modify(ModifyKind::Name(RenameMode::To)), priority: EventPriority::Modify, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path2, kind: EventKind::Create(CreateKind::File), priority: EventPriority::Create, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path3, kind: EventKind::Remove(RemoveKind::File), priority: EventPriority::Delete, timestamp: Instant::now() });\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 3);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!(flushed[1].priority, EventPriority::Delete); \n        assert_eq!(flushed[2].priority, EventPriority::Modify); \n    }\n\n    #[test]\n    fn debouncer_no_events_flush_empty() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert!(flushed.is_empty());\n        assert_eq!(debouncer.len(), 0);\n    }\n}\n\n\npub struct FileWatcher {\n    state: Arc\u003cMutex\u003cWatcherState\u003e\u003e,\n    #[allow(dead_code)]\n    config: WatcherConfig,\n    watched_paths: Vec\u003cPathBuf\u003e,\n    #[allow(dead_code)]\n    event_receiver: Receiver\u003cstd::result::Result\u003cEvent, notify::Error\u003e\u003e,\n    #[allow(dead_code)] \n    watcher: RecommendedWatcher,\n    processor_thread: Option\u003cJoinHandle\u003c()\u003e\u003e,\n    stop_flag: Arc\u003cAtomicBool\u003e,\n    events_processed: Arc\u003cAtomicUsize\u003e,\n    queue_size: Arc\u003cAtomicUsize\u003e,\n    start_time: Instant,\n    db_shared: Arc\u003cMutex\u003cOption\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e\u003e\u003e,\n}\n\nimpl FileWatcher {\n    pub fn new(paths: Vec\u003cPathBuf\u003e, config: WatcherConfig) -\u003e Result\u003cSelf\u003e {\n        let stop_flag = Arc::new(AtomicBool::new(false));\n        let events_processed = Arc::new(AtomicUsize::new(0));\n        let queue_size = Arc::new(AtomicUsize::new(0));\n        let state = Arc::new(Mutex::new(WatcherState::Initializing));\n\n        let (tx, rx) = bounded(config.max_queue_size);\n\n        let event_tx = tx.clone();\n        let mut actual_watcher = RecommendedWatcher::new(\n            move |event_res: std::result::Result\u003cEvent, notify::Error\u003e| {\n                if event_tx.send(event_res).is_err() {\n                    // Receiver dropped\n                }\n            },\n            notify::Config::default(),\n        )?;\n\n        for path_to_watch in \u0026paths {\n            actual_watcher\n                .watch(path_to_watch, RecursiveMode::Recursive)\n                .with_context(|| format!(\"Failed to watch path: {}\", path_to_watch.display()))?;\n        }\n\n        let config_clone = config.clone();\n        let stop_flag_clone = stop_flag.clone();\n        let events_processed_clone = events_processed.clone();\n        let queue_size_clone = queue_size.clone();\n        let state_clone = state.clone();\n        let receiver_clone = rx.clone(); \n\n        let db_shared_for_thread = Arc::new(Mutex::new(None::\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e));\n        let db_captured_for_thread = db_shared_for_thread.clone();\n\n        let processor_thread = thread::spawn(move || {\n            let mut debouncer = EventDebouncer::new(config_clone.debounce_ms);\n\n            while !stop_flag_clone.load(Ordering::Relaxed) { \n                let current_state = { state_clone.lock().unwrap().clone() };\n\n                if current_state == WatcherState::Paused {\n                    thread::sleep(Duration::from_millis(100));\n                    continue;\n                }\n                if current_state == WatcherState::ShuttingDown || current_state == WatcherState::Stopped {\n                    break;\n                }\n\n                let mut received_in_batch = 0;\n                while let Ok(evt_res) = receiver_clone.try_recv() {\n                    received_in_batch +=1;\n                    match evt_res {\n                        Ok(event) =\u003e {\n                            for path in event.paths {\n                                let prio = match event.kind {\n                                    EventKind::Create(_) =\u003e EventPriority::Create,\n                                    EventKind::Remove(_) =\u003e EventPriority::Delete,\n                                    EventKind::Modify(_) =\u003e EventPriority::Modify,\n                                    EventKind::Access(_) =\u003e EventPriority::Access,\n                                    _ =\u003e EventPriority::Modify,\n                                };\n                                debouncer.add_event(ProcessedEvent {\n                                    path,\n                                    kind: event.kind.clone(),\n                                    priority: prio,\n                                    timestamp: Instant::now(),\n                                });\n                            }\n                        }\n                        Err(e) =\u003e {\n                            eprintln!(\"Watcher channel error: {:?}\", e);\n                        }\n                    }\n                    if received_in_batch \u003e= config_clone.batch_size {\n                        break;\n                    }\n                }\n\n                queue_size_clone.store(debouncer.len(), Ordering::SeqCst);\n\n                if debouncer.is_ready_to_flush() \u0026\u0026 debouncer.len() \u003e 0 {\n                    let evts_to_process = debouncer.flush();\n                    let num_evts = evts_to_process.len();\n                    events_processed_clone.fetch_add(num_evts, Ordering::SeqCst);\n\n                    let db_guard_option = db_captured_for_thread.lock().unwrap();\n                    if let Some(db_mutex) = \u0026*db_guard_option {\n                        let mut _db_instance_guard = db_mutex.lock().unwrap();\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (DB available): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    } else {\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (no DB): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    }\n                }\n                thread::sleep(Duration::from_millis(50));\n            }\n\n            if debouncer.len() \u003e 0 {\n                let final_evts = debouncer.flush();\n                events_processed_clone.fetch_add(final_evts.len(), Ordering::SeqCst);\n                for processed_event in final_evts {\n                    println!(\n                        \"Processing final event: {:?} for path {:?}\",\n                        processed_event.kind, processed_event.path\n                    );\n                }\n            }\n            let mut final_state_guard = state_clone.lock().unwrap();\n            *final_state_guard = WatcherState::Stopped;\n        });\n\n        Ok(Self {\n            state,\n            config,\n            watched_paths: paths,\n            event_receiver: rx,\n            watcher: actual_watcher,\n            processor_thread: Some(processor_thread),\n            stop_flag,\n            events_processed,\n            queue_size,\n            start_time: Instant::now(),\n            db_shared: db_shared_for_thread,\n        })\n    }\n\n    pub fn with_database(\u0026mut self, db_arc: Arc\u003cMutex\u003cDatabase\u003e\u003e) -\u003e \u0026mut Self {\n        { \n            let mut shared_db_guard = self.db_shared.lock().unwrap();\n            *shared_db_guard = Some(db_arc);\n        } \n        self\n    }\n\n    pub fn start(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        if *state_guard == WatcherState::Watching || self.processor_thread.is_none() {\n            if self.processor_thread.is_none() {\n                return Err(anyhow::anyhow!(\"Watcher thread not available to start.\"));\n            }\n            if *state_guard == WatcherState::Initializing {\n                 *state_guard = WatcherState::Watching;\n            }\n            return Ok(());\n        }\n        if *state_guard != WatcherState::Initializing \u0026\u0026 *state_guard != WatcherState::Stopped \u0026\u0026 *state_guard != WatcherState::Paused {\n            return Err(anyhow::anyhow!(format!(\"Cannot start watcher from state {:?}\", *state_guard)));\n        }\n\n        *state_guard = WatcherState::Watching;\n        Ok(())\n    }\n\n    pub fn pause(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Watching =\u003e {\n                *state_guard = WatcherState::Paused;\n                Ok(())\n            }\n            WatcherState::Paused =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in watching state to pause (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn resume(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Paused =\u003e {\n                *state_guard = WatcherState::Watching;\n                Ok(())\n            }\n            WatcherState::Watching =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in paused state to resume (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn stop(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut current_state_guard = self.state.lock().unwrap();\n        if *current_state_guard == WatcherState::Stopped || *current_state_guard == WatcherState::ShuttingDown {\n            return Ok(());\n        }\n        *current_state_guard = WatcherState::ShuttingDown;\n        drop(current_state_guard);\n\n        self.stop_flag.store(true, Ordering::SeqCst);\n\n        if let Some(handle) = self.processor_thread.take() {\n            match handle.join() {\n                Ok(_) =\u003e { /* Thread joined cleanly */ }\n                Err(join_err) =\u003e {\n                    eprintln!(\"Watcher processor thread panicked: {:?}\", join_err);\n                }\n            }\n        }\n        \n        let mut final_state_guard = self.state.lock().unwrap();\n        *final_state_guard = WatcherState::Stopped;\n        Ok(())\n    }\n\n    pub fn status(\u0026self) -\u003e WatcherStatus {\n        let state_guard = self.state.lock().unwrap().clone();\n        WatcherStatus {\n            state: state_guard,\n            events_processed: self.events_processed.load(Ordering::SeqCst),\n            queue_size: self.queue_size.load(Ordering::SeqCst),\n            start_time: Some(self.start_time),\n            watched_paths: self.watched_paths.clone(),\n        }\n    }\n}\n\nimpl Drop for FileWatcher {\n    fn drop(\u0026mut self) {\n        if let Err(e) = self.stop() {\n            eprintln!(\"Error stopping watcher in Drop: {:?}\", e);\n        }\n    }\n}\n\n\n#[cfg(test)]\nmod file_watcher_state_tests { \n    use super::*;\n    use tempfile::tempdir;\n    use std::fs as FsMod; // Alias to avoid conflict with local `fs` module name if any\n\n    #[test]\n    fn test_watcher_pause_resume_stop() {\n        let tmp_dir = tempdir().unwrap();\n        let watch_path = tmp_dir.path().to_path_buf();\n        FsMod::create_dir_all(\u0026watch_path).expect(\"Failed to create temp dir for watching\");\n\n        let config = WatcherConfig::default();\n\n        let mut watcher = FileWatcher::new(vec![watch_path], config).expect(\"Failed to create watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Initializing);\n\n        watcher.start().expect(\"Start failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.pause().expect(\"Pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.pause().expect(\"Second pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.resume().expect(\"Resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        watcher.resume().expect(\"Second resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.stop().expect(\"Stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n\n        watcher.stop().expect(\"Second stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n    }\n\n    #[test]\n    fn test_watcher_start_errors() {\n        let tmp_dir = tempdir().unwrap();\n        FsMod::create_dir_all(tmp_dir.path()).expect(\"Failed to create temp dir for watching\");\n        let mut watcher = FileWatcher::new(vec![tmp_dir.path().to_path_buf()], WatcherConfig::default()).unwrap();\n        \n        {\n            let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::Watching; \n        }\n        assert!(watcher.start().is_ok(), \"Should be able to call start when already Watching (idempotent state change)\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        {\n             let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::ShuttingDown;\n        }\n        assert!(watcher.start().is_err(), \"Should not be able to start from ShuttingDown\");\n    }\n\n     #[test]\n    fn test_new_watcher_with_nonexistent_path() {\n        let non_existent_path = PathBuf::from(\"/path/that/REALLY/does/not/exist/for/sure/and/cannot/be/created\");\n        let config = WatcherConfig::default();\n        let watcher_result = FileWatcher::new(vec![non_existent_path], config);\n        assert!(watcher_result.is_err());\n        if let Err(e) = watcher_result {\n            let err_string = e.to_string();\n            assert!(err_string.contains(\"Failed to watch path\") || err_string.contains(\"os error 2\"), \"Error was: {}\", err_string);\n        }\n    }\n\n    #[test]\n    fn test_watcher_default_config() {\n        let config = WatcherConfig::default(); \n        assert_eq!(config.debounce_ms, 100);\n        assert_eq!(config.batch_size, 1000);\n        assert_eq!(config.max_queue_size, 100_000);\n        assert_eq!(config.drain_timeout_ms, 5000);\n    }\n}","traces":[{"line":38,"address":[5542400],"length":1,"stats":{"Line":1}},{"line":91,"address":[2059006,2058864,2059012],"length":1,"stats":{"Line":1}},{"line":93,"address":[2058893],"length":1,"stats":{"Line":1}},{"line":95,"address":[2058898],"length":1,"stats":{"Line":1}},{"line":99,"address":[2059653,2059024],"length":1,"stats":{"Line":1}},{"line":100,"address":[2059049,2059126],"length":1,"stats":{"Line":2}},{"line":101,"address":[2059139,2059204],"length":1,"stats":{"Line":2}},{"line":103,"address":[2059261],"length":1,"stats":{"Line":3}},{"line":105,"address":[2059275,2059239],"length":1,"stats":{"Line":2}},{"line":106,"address":[2059313],"length":1,"stats":{"Line":1}},{"line":107,"address":[2059576,2059496,2059331],"length":1,"stats":{"Line":2}},{"line":108,"address":[2059570],"length":1,"stats":{"Line":0}},{"line":110,"address":[2059512],"length":1,"stats":{"Line":1}},{"line":111,"address":[5543146],"length":1,"stats":{"Line":1}},{"line":114,"address":[2059363],"length":1,"stats":{"Line":1}},{"line":119,"address":[2059696],"length":1,"stats":{"Line":1}},{"line":120,"address":[2059710],"length":1,"stats":{"Line":1}},{"line":123,"address":[2060025,2059776,2060031],"length":1,"stats":{"Line":1}},{"line":124,"address":[2059819],"length":1,"stats":{"Line":5}},{"line":125,"address":[2004170,2004160],"length":1,"stats":{"Line":5}},{"line":126,"address":[2059940],"length":1,"stats":{"Line":1}},{"line":127,"address":[2059991],"length":1,"stats":{"Line":1}},{"line":131,"address":[2060048],"length":1,"stats":{"Line":1}},{"line":132,"address":[5543701],"length":1,"stats":{"Line":2}},{"line":310,"address":[2060064,2063925,2063163],"length":1,"stats":{"Line":1}},{"line":311,"address":[5543751,5543927],"length":1,"stats":{"Line":2}},{"line":312,"address":[2060369,2060433],"length":1,"stats":{"Line":2}},{"line":313,"address":[2060524,2060588],"length":1,"stats":{"Line":2}},{"line":314,"address":[2060675,2060755],"length":1,"stats":{"Line":2}},{"line":316,"address":[2060850,2060910],"length":1,"stats":{"Line":2}},{"line":318,"address":[2060990,2061070],"length":1,"stats":{"Line":2}},{"line":320,"address":[2004176,2004268,2004274],"length":1,"stats":{"Line":2}},{"line":321,"address":[2004191],"length":1,"stats":{"Line":1}},{"line":325,"address":[2061110],"length":1,"stats":{"Line":1}},{"line":328,"address":[5545137,5545221],"length":1,"stats":{"Line":2}},{"line":329,"address":[2063405,2063555],"length":1,"stats":{"Line":2}},{"line":330,"address":[2061644,2063397],"length":1,"stats":{"Line":2}},{"line":331,"address":[2004288,2004310],"length":1,"stats":{"Line":3}},{"line":334,"address":[2061680],"length":1,"stats":{"Line":1}},{"line":335,"address":[2061687],"length":1,"stats":{"Line":1}},{"line":336,"address":[2061740,2061798],"length":1,"stats":{"Line":2}},{"line":337,"address":[5545573,5545506],"length":1,"stats":{"Line":2}},{"line":338,"address":[2061956,2061901],"length":1,"stats":{"Line":2}},{"line":339,"address":[2062045,2061980],"length":1,"stats":{"Line":2}},{"line":341,"address":[2062069,2062150],"length":1,"stats":{"Line":2}},{"line":342,"address":[2062183,2062237],"length":1,"stats":{"Line":2}},{"line":344,"address":[2062245],"length":1,"stats":{"Line":2}},{"line":345,"address":[2004570,2004479],"length":1,"stats":{"Line":2}},{"line":347,"address":[2004648,2004580],"length":1,"stats":{"Line":2}},{"line":348,"address":[2004760,2004699],"length":1,"stats":{"Line":2}},{"line":350,"address":[2004950],"length":1,"stats":{"Line":1}},{"line":351,"address":[2008058,2005026],"length":1,"stats":{"Line":0}},{"line":354,"address":[2005058,2004992],"length":1,"stats":{"Line":2}},{"line":358,"address":[2005114],"length":1,"stats":{"Line":1}},{"line":359,"address":[2005142,2006547,2005222],"length":1,"stats":{"Line":3}},{"line":360,"address":[2005272,2005346],"length":1,"stats":{"Line":1}},{"line":361,"address":[2005313],"length":1,"stats":{"Line":1}},{"line":362,"address":[2005521],"length":1,"stats":{"Line":1}},{"line":363,"address":[2005577,2005815,2005680],"length":1,"stats":{"Line":3}},{"line":364,"address":[2005884],"length":1,"stats":{"Line":1}},{"line":365,"address":[2006022],"length":1,"stats":{"Line":1}},{"line":366,"address":[2006042],"length":1,"stats":{"Line":1}},{"line":367,"address":[2006032],"length":1,"stats":{"Line":1}},{"line":368,"address":[2006012],"length":1,"stats":{"Line":1}},{"line":369,"address":[2006002],"length":1,"stats":{"Line":0}},{"line":371,"address":[2006268],"length":1,"stats":{"Line":1}},{"line":372,"address":[5524074],"length":1,"stats":{"Line":1}},{"line":373,"address":[2006155,2006082],"length":1,"stats":{"Line":2}},{"line":374,"address":[2006206],"length":1,"stats":{"Line":1}},{"line":375,"address":[2006220],"length":1,"stats":{"Line":1}},{"line":379,"address":[2005423],"length":1,"stats":{"Line":0}},{"line":380,"address":[2005511,2006432],"length":1,"stats":{"Line":0}},{"line":383,"address":[2005979],"length":1,"stats":{"Line":1}},{"line":388,"address":[2006663,2006719],"length":1,"stats":{"Line":2}},{"line":390,"address":[2006846,2006781],"length":1,"stats":{"Line":2}},{"line":391,"address":[2006891],"length":1,"stats":{"Line":1}},{"line":392,"address":[2006977,2006906],"length":1,"stats":{"Line":2}},{"line":393,"address":[2006985],"length":1,"stats":{"Line":1}},{"line":395,"address":[5525091],"length":1,"stats":{"Line":1}},{"line":396,"address":[5525214,5525293],"length":1,"stats":{"Line":2}},{"line":397,"address":[5525335,5525397],"length":1,"stats":{"Line":0}},{"line":398,"address":[2007476,2007409],"length":1,"stats":{"Line":0}},{"line":399,"address":[5525734,5525665],"length":1,"stats":{"Line":0}},{"line":405,"address":[5525354,5525856],"length":1,"stats":{"Line":2}},{"line":406,"address":[5526046,5525965],"length":1,"stats":{"Line":2}},{"line":413,"address":[5526025,5524841],"length":1,"stats":{"Line":2}},{"line":416,"address":[2008588,2008082,2004726],"length":1,"stats":{"Line":2}},{"line":417,"address":[5526247],"length":1,"stats":{"Line":0}},{"line":418,"address":[5526331,5526270],"length":1,"stats":{"Line":0}},{"line":419,"address":[5526388,5526590],"length":1,"stats":{"Line":0}},{"line":420,"address":[2008843,2008539],"length":1,"stats":{"Line":0}},{"line":426,"address":[5526208,5526742],"length":1,"stats":{"Line":2}},{"line":427,"address":[2008743,2008670],"length":1,"stats":{"Line":2}},{"line":430,"address":[5546512],"length":1,"stats":{"Line":1}},{"line":431,"address":[5546176],"length":1,"stats":{"Line":1}},{"line":433,"address":[2062476],"length":1,"stats":{"Line":1}},{"line":434,"address":[2062507],"length":1,"stats":{"Line":1}},{"line":435,"address":[5546271],"length":1,"stats":{"Line":1}},{"line":436,"address":[5546311],"length":1,"stats":{"Line":1}},{"line":437,"address":[5546343],"length":1,"stats":{"Line":1}},{"line":438,"address":[2062643],"length":1,"stats":{"Line":1}},{"line":439,"address":[2062667],"length":1,"stats":{"Line":1}},{"line":440,"address":[5546415],"length":1,"stats":{"Line":1}},{"line":441,"address":[2062776],"length":1,"stats":{"Line":1}},{"line":445,"address":[2064322,2063968,2064316],"length":1,"stats":{"Line":0}},{"line":447,"address":[2064005,2064066],"length":1,"stats":{"Line":0}},{"line":448,"address":[5548035,5547941,5548140,5547982],"length":1,"stats":{"Line":0}},{"line":450,"address":[5547798],"length":1,"stats":{"Line":0}},{"line":453,"address":[5549403,5548192,5549178],"length":1,"stats":{"Line":1}},{"line":454,"address":[5548215],"length":1,"stats":{"Line":1}},{"line":455,"address":[5548306,5548385,5548480],"length":1,"stats":{"Line":3}},{"line":456,"address":[2065274,2064587],"length":1,"stats":{"Line":2}},{"line":457,"address":[5549218,5549350],"length":1,"stats":{"Line":0}},{"line":459,"address":[5549249,5549340,5549194],"length":1,"stats":{"Line":2}},{"line":460,"address":[2065376],"length":1,"stats":{"Line":0}},{"line":462,"address":[5549277],"length":1,"stats":{"Line":1}},{"line":464,"address":[5548486,5548582],"length":1,"stats":{"Line":2}},{"line":465,"address":[5548792,5548707,5549156,5548986],"length":1,"stats":{"Line":2}},{"line":468,"address":[5548547,5548736],"length":1,"stats":{"Line":2}},{"line":469,"address":[5548745],"length":1,"stats":{"Line":1}},{"line":472,"address":[5549424,5550079,5550085],"length":1,"stats":{"Line":1}},{"line":473,"address":[2065519],"length":1,"stats":{"Line":1}},{"line":474,"address":[2065642,2065588],"length":1,"stats":{"Line":2}},{"line":476,"address":[5549674,5549632],"length":1,"stats":{"Line":2}},{"line":477,"address":[2065732],"length":1,"stats":{"Line":1}},{"line":479,"address":[2065710],"length":1,"stats":{"Line":1}},{"line":480,"address":[2065949,2065676,2065777],"length":1,"stats":{"Line":0}},{"line":484,"address":[5550769,5550112,5550775],"length":1,"stats":{"Line":1}},{"line":485,"address":[2066159],"length":1,"stats":{"Line":1}},{"line":486,"address":[5550203,5550270],"length":1,"stats":{"Line":2}},{"line":488,"address":[2066339,2066389],"length":1,"stats":{"Line":2}},{"line":489,"address":[2066395],"length":1,"stats":{"Line":1}},{"line":491,"address":[5550320],"length":1,"stats":{"Line":1}},{"line":492,"address":[2066316,2066419,2066591],"length":1,"stats":{"Line":0}},{"line":496,"address":[2067872,2067606,2066784],"length":1,"stats":{"Line":1}},{"line":497,"address":[2066804],"length":1,"stats":{"Line":1}},{"line":498,"address":[5551072,5550918,5550985],"length":1,"stats":{"Line":3}},{"line":499,"address":[2066998],"length":1,"stats":{"Line":1}},{"line":501,"address":[5551100],"length":1,"stats":{"Line":1}},{"line":502,"address":[2067102],"length":1,"stats":{"Line":1}},{"line":504,"address":[2067135],"length":1,"stats":{"Line":1}},{"line":506,"address":[2067193],"length":1,"stats":{"Line":1}},{"line":507,"address":[5551343,5551422],"length":1,"stats":{"Line":2}},{"line":509,"address":[2067416],"length":1,"stats":{"Line":0}},{"line":510,"address":[2067464,2067515],"length":1,"stats":{"Line":0}},{"line":515,"address":[2067683,2067635],"length":1,"stats":{"Line":2}},{"line":516,"address":[2067747,2067818],"length":1,"stats":{"Line":2}},{"line":517,"address":[2067827],"length":1,"stats":{"Line":1}},{"line":520,"address":[5552406,5552412,5551984],"length":1,"stats":{"Line":1}},{"line":521,"address":[2067942],"length":1,"stats":{"Line":1}},{"line":524,"address":[5552195],"length":1,"stats":{"Line":1}},{"line":525,"address":[2068130],"length":1,"stats":{"Line":1}},{"line":526,"address":[2068167],"length":1,"stats":{"Line":1}},{"line":527,"address":[2068183],"length":1,"stats":{"Line":1}},{"line":533,"address":[2001554,2001560,2001328],"length":1,"stats":{"Line":1}},{"line":534,"address":[2001340],"length":1,"stats":{"Line":1}},{"line":535,"address":[2001410,2001484],"length":1,"stats":{"Line":0}}],"covered":134,"coverable":157},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher_tests.rs"],"content":"//! Tests for the file system watcher functionality\n\n#[cfg(test)]\nmod tests {\n    // Updated import for BackupManager from the new backup module\n    use crate::backup::BackupManager;\n    // These are still from the watcher module\n    use crate::watcher::{FileWatcher, WatcherConfig, WatcherState};\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n\n\n    use std::fs::{self, File};\n    use std::io::Write;\n    // No longer need: use std::path::PathBuf;\n    use std::thread;\n    use std::time::Duration;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_watcher_lifecycle() {\n        // Create a temp directory for testing\n        let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n        let temp_path = temp_dir.path();\n\n        // Create a test file\n        let test_file_path = temp_path.join(\"test.txt\");\n        let mut file = File::create(\u0026test_file_path).expect(\"Failed to create test file\");\n        writeln!(file, \"Test content\").expect(\"Failed to write to test file\");\n        drop(file);\n\n        // Configure and start the watcher\n        let config = WatcherConfig {\n            debounce_ms: 100,\n            batch_size: 10,\n            max_queue_size: 100,\n            drain_timeout_ms: 1000,\n        };\n\n        let mut watcher = FileWatcher::new(vec![temp_path.to_path_buf()], config)\n            .expect(\"Failed to create watcher\");\n\n        watcher.start().expect(\"Failed to start watcher\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        thread::sleep(Duration::from_millis(200));\n        let new_file_path = temp_path.join(\"new_file.txt\");\n        let mut new_file_handle = File::create(\u0026new_file_path).expect(\"Failed to create new file\");\n        writeln!(new_file_handle, \"New file content\").expect(\"Failed to write to new file\");\n        drop(new_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        let mut existing_file_handle = fs::OpenOptions::new()\n            .write(true)\n            .append(true)\n            .open(\u0026test_file_path)\n            .expect(\"Failed to open test file for modification\");\n        writeln!(existing_file_handle, \"Additional content\").expect(\"Failed to append to test file\");\n        drop(existing_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        fs::remove_file(\u0026new_file_path).expect(\"Failed to remove file\");\n\n        thread::sleep(Duration::from_millis(500));\n        watcher.stop().expect(\"Failed to stop watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n        assert!(watcher.status().events_processed \u003e 0, \"Expected some file events to be processed\");\n    }\n\n    #[test]\n    fn test_backup_manager_related_functionality() {\n        let live_db_tmp_dir = tempdir().expect(\"Failed to create temp directory for live DB\");\n        let backups_storage_tmp_dir = tempdir().expect(\"Failed to create temp directory for backups storage\");\n        \n        let live_db_path = live_db_tmp_dir.path().join(\"test_live_watcher.db\"); // Unique name\n        let backups_actual_dir = backups_storage_tmp_dir.path().join(\"my_backups_watcher\"); // Unique name\n\n        // Initialize a proper SQLite DB for the \"live\" database\n        let _conn = open_marlin_db(\u0026live_db_path).expect(\"Failed to open test_live_watcher.db for backup test\");\n        \n        let backup_manager = BackupManager::new(\u0026live_db_path, \u0026backups_actual_dir)\n            .expect(\"Failed to create BackupManager instance\");\n        \n        let backup_info = backup_manager.create_backup().expect(\"Failed to create first backup\");\n        \n        assert!(backups_actual_dir.join(\u0026backup_info.id).exists(), \"Backup file should exist\");\n        assert!(backup_info.size_bytes \u003e 0, \"Backup size should be greater than 0\");\n        \n        for i in 0..3 {\n            std::thread::sleep(std::time::Duration::from_millis(30)); // Ensure timestamp difference\n            backup_manager.create_backup().unwrap_or_else(|e| panic!(\"Failed to create additional backup {}: {:?}\", i, e));\n        }\n        \n        let backups = backup_manager.list_backups().expect(\"Failed to list backups\");\n        assert_eq!(backups.len(), 4, \"Should have 4 backups listed\");\n        \n        let prune_result = backup_manager.prune(2).expect(\"Failed to prune backups\");\n        \n        assert_eq!(prune_result.kept.len(), 2, \"Should have kept 2 backups\");\n        assert_eq!(prune_result.removed.len(), 2, \"Should have removed 2 backups (4 initial - 2 kept)\");\n        \n        let remaining_backups = backup_manager.list_backups().expect(\"Failed to list backups after prune\");\n        assert_eq!(remaining_backups.len(), 2, \"Should have 2 backups remaining after prune\");\n\n        for removed_info in prune_result.removed {\n            assert!(!backups_actual_dir.join(\u0026removed_info.id).exists(), \"Removed backup file {} should not exist\", removed_info.id);\n        }\n        for kept_info in prune_result.kept {\n            assert!(backups_actual_dir.join(\u0026kept_info.id).exists(), \"Kept backup file {} should exist\", kept_info.id);\n        }\n    }\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","tui-bin","src","main.rs"],"content":"// tui-bin/src/main.rs\n\nfn main() {\n    eprintln!(\"marlin-tui is not yet implemented. Stay tuned!\");\n}\n","traces":[{"line":3,"address":[127488],"length":1,"stats":{"Line":0}},{"line":4,"address":[127492],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2}]};
-        var previousData = {"files":[{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","build.rs"],"content":"// cli-bin/build.rs\n//\n// The CLI currently needs no build-time code-generation, but Cargo\n// insists on rerunning any build-script each compile.  Tell it to\n// rebuild only if this file itself changes.\n\nfn main() {\n    // If you later add code-gen (e.g. embed completions or YAML), add\n    // further `cargo:rerun-if-changed=\u003cpath\u003e` lines here.\n    println!(\"cargo:rerun-if-changed=build.rs\");\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","annotate.rs"],"content":"// src/cli/annotate.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum AnnotateCmd {\n    Add (ArgsAdd),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub note: String,\n    #[arg(long)] pub range: Option\u003cString\u003e,\n    #[arg(long)] pub highlight: bool,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsList { pub file_pattern: String }\n\npub fn run(cmd: \u0026AnnotateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        AnnotateCmd::Add(a)  =\u003e todo!(\"annotate add {:?}\", a),\n        AnnotateCmd::List(a) =\u003e todo!(\"annotate list {:?}\", a),\n    }\n}\n","traces":[{"line":23,"address":[2450848],"length":1,"stats":{"Line":0}},{"line":24,"address":[2450887],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","coll.rs"],"content":"//! `marlin coll …` – named collections of files (simple “playlists”).\n\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // local enum for text / json output\nuse libmarlin::db;        // core DB helpers from the library crate\n\n#[derive(Subcommand, Debug)]\npub enum CollCmd {\n    /// Create an empty collection\n    Create(CreateArgs),\n    /// Add files (glob) to a collection\n    Add(AddArgs),\n    /// List files inside a collection\n    List(ListArgs),\n}\n\n#[derive(Args, Debug)]\npub struct CreateArgs {\n    pub name: String,\n}\n\n#[derive(Args, Debug)]\npub struct AddArgs {\n    pub name: String,\n    pub file_pattern: String,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub name: String,\n}\n\n/// Look-up an existing collection **without** implicitly creating it.\n///\n/// Returns the collection ID or an error if it doesn’t exist.\nfn lookup_collection_id(conn: \u0026Connection, name: \u0026str) -\u003e anyhow::Result\u003ci64\u003e {\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        [name],\n        |r| r.get(0),\n    )\n    .map_err(|_| anyhow::anyhow!(\"collection not found: {}\", name))\n}\n\npub fn run(cmd: \u0026CollCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── coll create ──────────────────────────────────────────── */\n        CollCmd::Create(a) =\u003e {\n            db::ensure_collection(conn, \u0026a.name)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Created collection '{}'\", a.name);\n            }\n        }\n\n        /* ── coll add ─────────────────────────────────────────────── */\n        CollCmd::Add(a) =\u003e {\n            // Fail if the target collection does not yet exist\n            let coll_id = lookup_collection_id(conn, \u0026a.name)?;\n\n            let like = a.file_pattern.replace('*', \"%\");\n            let mut stmt = conn.prepare(\"SELECT id FROM files WHERE path LIKE ?1\")?;\n            let ids: Vec\u003ci64\u003e = stmt\n                .query_map([\u0026like], |r| r.get::\u003c_, i64\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            for fid in \u0026ids {\n                db::add_file_to_collection(conn, coll_id, *fid)?;\n            }\n\n            match fmt {\n                Format::Text =\u003e println!(\"Added {} file(s) → '{}'\", ids.len(), a.name),\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\n                            \"{{\\\"collection\\\":\\\"{}\\\",\\\"added\\\":{}}}\",\n                            a.name,\n                            ids.len()\n                        );\n                    }\n                }\n            }\n        }\n\n        /* ── coll list ────────────────────────────────────────────── */\n        CollCmd::List(a) =\u003e {\n            let files = db::list_collection(conn, \u0026a.name)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for f in files {\n                        println!(\"{f}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026files)?);\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":38,"address":[2169520],"length":1,"stats":{"Line":0}},{"line":39,"address":[2169565],"length":1,"stats":{"Line":0}},{"line":41,"address":[2169545],"length":1,"stats":{"Line":0}},{"line":42,"address":[2296656,2296672],"length":1,"stats":{"Line":0}},{"line":44,"address":[2296721,2296704],"length":1,"stats":{"Line":0}},{"line":47,"address":[2169632,2171921,2171991],"length":1,"stats":{"Line":0}},{"line":48,"address":[2169683],"length":1,"stats":{"Line":0}},{"line":50,"address":[2169766],"length":1,"stats":{"Line":0}},{"line":51,"address":[2170057,2169783],"length":1,"stats":{"Line":0}},{"line":52,"address":[2170122],"length":1,"stats":{"Line":0}},{"line":53,"address":[2170138],"length":1,"stats":{"Line":0}},{"line":58,"address":[2169858],"length":1,"stats":{"Line":0}},{"line":60,"address":[2170255,2169866],"length":1,"stats":{"Line":0}},{"line":62,"address":[2170320],"length":1,"stats":{"Line":0}},{"line":63,"address":[2171981,2170443,2170372],"length":1,"stats":{"Line":0}},{"line":64,"address":[2171932,2171195,2170775,2170990,2170882],"length":1,"stats":{"Line":0}},{"line":65,"address":[2170767,2170926],"length":1,"stats":{"Line":0}},{"line":68,"address":[2171376,2171293],"length":1,"stats":{"Line":0}},{"line":69,"address":[2171767,2171486],"length":1,"stats":{"Line":0}},{"line":72,"address":[2171515],"length":1,"stats":{"Line":0}},{"line":73,"address":[2171558],"length":1,"stats":{"Line":0}},{"line":88,"address":[2169940],"length":1,"stats":{"Line":0}},{"line":89,"address":[2169952,2172004,2172061],"length":1,"stats":{"Line":0}},{"line":90,"address":[2172165],"length":1,"stats":{"Line":0}},{"line":92,"address":[2172197,2172305,2172440],"length":1,"stats":{"Line":0}},{"line":93,"address":[2172509,2172602],"length":1,"stats":{"Line":0}},{"line":105,"address":[2170227],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":27},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","event.rs"],"content":"// src/cli/event.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum EventCmd {\n    Add     (ArgsAdd),\n    Timeline,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub date: String,\n    pub description: String,\n}\n\npub fn run(cmd: \u0026EventCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        EventCmd::Add(a)      =\u003e todo!(\"event add {:?}\", a),\n        EventCmd::Timeline    =\u003e todo!(\"event timeline\"),\n    }\n}\n","traces":[{"line":19,"address":[2433520],"length":1,"stats":{"Line":0}},{"line":20,"address":[2433559],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","link.rs"],"content":"//! src/cli/link.rs – manage typed relationships between files\n\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector\nuse libmarlin::db;        // ← switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum LinkCmd {\n    Add(LinkArgs),\n    Rm (LinkArgs),\n    List(ListArgs),\n    Backlinks(BacklinksArgs),\n}\n\n#[derive(Args, Debug)]\npub struct LinkArgs {\n    pub from: String,\n    pub to:   String,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub pattern: String,\n    #[arg(long)]\n    pub direction: Option\u003cString\u003e,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct BacklinksArgs {\n    pub pattern: String,\n}\n\npub fn run(cmd: \u0026LinkCmd, conn: \u0026mut Connection, format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        LinkCmd::Add(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::add_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Linked '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Linked '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::Rm(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::remove_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Removed link '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Removed link '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::List(args) =\u003e {\n            let results = db::list_links(\n                conn,\n                \u0026args.pattern,\n                args.direction.as_deref(),\n                args.r#type.as_deref(),\n            )?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, dst, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\n                                \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                                src, dst, typ\n                            )\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, dst, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} → {} [type='{}']\", src, dst, t);\n                        } else {\n                            println!(\"{} → {}\", src, dst);\n                        }\n                    }\n                }\n            }\n        }\n        LinkCmd::Backlinks(args) =\u003e {\n            let results = db::find_backlinks(conn, \u0026args.pattern)?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\"{{\\\"from\\\":\\\"{}\\\",\\\"type\\\":{}}}\", src, typ)\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} [type='{}']\", src, t);\n                        } else {\n                            println!(\"{}\", src);\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":39,"address":[2065779,2063952,2065785],"length":1,"stats":{"Line":0}},{"line":40,"address":[2064009],"length":1,"stats":{"Line":0}},{"line":41,"address":[2064086],"length":1,"stats":{"Line":0}},{"line":42,"address":[2064106,2064644],"length":1,"stats":{"Line":0}},{"line":43,"address":[2064715],"length":1,"stats":{"Line":0}},{"line":44,"address":[2064854],"length":1,"stats":{"Line":0}},{"line":45,"address":[2064991],"length":1,"stats":{"Line":0}},{"line":47,"address":[2065109],"length":1,"stats":{"Line":0}},{"line":48,"address":[2065179],"length":1,"stats":{"Line":0}},{"line":50,"address":[2065393],"length":1,"stats":{"Line":0}},{"line":54,"address":[2065012],"length":1,"stats":{"Line":0}},{"line":57,"address":[2422805,2422784],"length":1,"stats":{"Line":0}},{"line":58,"address":[2422924,2422912],"length":1,"stats":{"Line":0}},{"line":59,"address":[2065079,2065609],"length":1,"stats":{"Line":0}},{"line":66,"address":[2064187],"length":1,"stats":{"Line":0}},{"line":67,"address":[2065814,2064207],"length":1,"stats":{"Line":0}},{"line":68,"address":[2065882],"length":1,"stats":{"Line":0}},{"line":69,"address":[2066021],"length":1,"stats":{"Line":0}},{"line":70,"address":[2066158],"length":1,"stats":{"Line":0}},{"line":72,"address":[2066276],"length":1,"stats":{"Line":0}},{"line":73,"address":[2066346],"length":1,"stats":{"Line":0}},{"line":75,"address":[2066560],"length":1,"stats":{"Line":0}},{"line":79,"address":[2066179],"length":1,"stats":{"Line":0}},{"line":82,"address":[2422960,2422981],"length":1,"stats":{"Line":0}},{"line":83,"address":[2423100,2423088],"length":1,"stats":{"Line":0}},{"line":84,"address":[2066246,2066764],"length":1,"stats":{"Line":0}},{"line":91,"address":[2064288],"length":1,"stats":{"Line":0}},{"line":94,"address":[2064308],"length":1,"stats":{"Line":0}},{"line":95,"address":[2064337],"length":1,"stats":{"Line":0}},{"line":96,"address":[2064371],"length":1,"stats":{"Line":0}},{"line":98,"address":[2067095],"length":1,"stats":{"Line":0}},{"line":100,"address":[2067108,2068413],"length":1,"stats":{"Line":0}},{"line":102,"address":[2423710,2423136,2423161],"length":1,"stats":{"Line":0}},{"line":103,"address":[2423289,2423214],"length":1,"stats":{"Line":0}},{"line":105,"address":[2423744,2423765],"length":1,"stats":{"Line":0}},{"line":106,"address":[2423884,2423872],"length":1,"stats":{"Line":0}},{"line":107,"address":[2423385,2423323],"length":1,"stats":{"Line":0}},{"line":113,"address":[2068443,2068526],"length":1,"stats":{"Line":0}},{"line":116,"address":[2067174,2067278,2067405],"length":1,"stats":{"Line":0}},{"line":117,"address":[2067665,2067598],"length":1,"stats":{"Line":0}},{"line":118,"address":[2067705,2067806],"length":1,"stats":{"Line":0}},{"line":120,"address":[2068085,2067732],"length":1,"stats":{"Line":0}},{"line":126,"address":[2064525],"length":1,"stats":{"Line":0}},{"line":127,"address":[2068761,2064537,2068818],"length":1,"stats":{"Line":0}},{"line":128,"address":[2068922],"length":1,"stats":{"Line":0}},{"line":130,"address":[2068935,2070060],"length":1,"stats":{"Line":0}},{"line":132,"address":[2424376,2423945,2423920],"length":1,"stats":{"Line":0}},{"line":133,"address":[2423980,2424052],"length":1,"stats":{"Line":0}},{"line":135,"address":[2424400,2424421],"length":1,"stats":{"Line":0}},{"line":136,"address":[2424528,2424540],"length":1,"stats":{"Line":0}},{"line":137,"address":[2424083,2424145],"length":1,"stats":{"Line":0}},{"line":140,"address":[2070090,2070173],"length":1,"stats":{"Line":0}},{"line":143,"address":[2069113,2069248,2069005],"length":1,"stats":{"Line":0}},{"line":144,"address":[2069464,2069393],"length":1,"stats":{"Line":0}},{"line":145,"address":[2069504,2069605],"length":1,"stats":{"Line":0}},{"line":147,"address":[2069531,2069841],"length":1,"stats":{"Line":0}},{"line":155,"address":[2065540],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":57},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","remind.rs"],"content":"// src/cli/remind.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum RemindCmd {\n    Set(ArgsSet),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet {\n    pub file_pattern: String,\n    pub timestamp:    String,\n    pub message:      String,\n}\n\npub fn run(cmd: \u0026RemindCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        RemindCmd::Set(a) =\u003e todo!(\"remind set {:?}\", a),\n    }\n}\n","traces":[{"line":18,"address":[2142944],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","state.rs"],"content":"// src/cli/state.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum StateCmd {\n    Set(ArgsSet),\n    TransitionsAdd(ArgsTrans),\n    Log(ArgsLog),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet   { pub file_pattern: String, pub new_state: String }\n#[derive(Args, Debug)]\npub struct ArgsTrans { pub from_state: String,   pub to_state: String }\n#[derive(Args, Debug)]\npub struct ArgsLog   { pub file_pattern: String }\n\npub fn run(cmd: \u0026StateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        StateCmd::Set(a)           =\u003e todo!(\"state set {:?}\", a),\n        StateCmd::TransitionsAdd(a)=\u003e todo!(\"state transitions-add {:?}\", a),\n        StateCmd::Log(a)           =\u003e todo!(\"state log {:?}\", a),\n    }\n}\n","traces":[{"line":20,"address":[2474816],"length":1,"stats":{"Line":0}},{"line":21,"address":[2474855],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","task.rs"],"content":"// src/cli/task.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum TaskCmd {\n    Scan(ArgsScan),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsScan { pub directory: String }\n#[derive(Args, Debug)]\npub struct ArgsList { #[arg(long)] pub due_today: bool }\n\npub fn run(cmd: \u0026TaskCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        TaskCmd::Scan(a) =\u003e todo!(\"task scan {:?}\", a),\n        TaskCmd::List(a) =\u003e todo!(\"task list {:?}\", a),\n    }\n}\n","traces":[{"line":17,"address":[2403248],"length":1,"stats":{"Line":0}},{"line":18,"address":[2403287],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","version.rs"],"content":"// src/cli/version.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum VersionCmd {\n    Diff(ArgsDiff),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsDiff { pub file: String }\n\npub fn run(cmd: \u0026VersionCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        VersionCmd::Diff(a) =\u003e todo!(\"version diff {:?}\", a),\n    }\n}\n","traces":[{"line":14,"address":[2314960],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","view.rs"],"content":"//! `marlin view …` – save \u0026 use “smart folders” (named queries).\n\nuse std::fs;\n\nuse anyhow::Result;\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector stays local\nuse libmarlin::db;        // ← path switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum ViewCmd {\n    /// Save (or update) a view\n    Save(ArgsSave),\n    /// List all saved views\n    List,\n    /// Execute a view (print matching paths)\n    Exec(ArgsExec),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSave {\n    pub view_name: String,\n    pub query: String,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsExec {\n    pub view_name: String,\n}\n\npub fn run(cmd: \u0026ViewCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── view save ───────────────────────────────────────────── */\n        ViewCmd::Save(a) =\u003e {\n            db::save_view(conn, \u0026a.view_name, \u0026a.query)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Saved view '{}' = {}\", a.view_name, a.query);\n            }\n        }\n\n        /* ── view list ───────────────────────────────────────────── */\n        ViewCmd::List =\u003e {\n            let views = db::list_views(conn)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for (name, q) in views {\n                        println!(\"{name}: {q}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026views)?);\n                    }\n                }\n            }\n        }\n\n        /* ── view exec ───────────────────────────────────────────── */\n        ViewCmd::Exec(a) =\u003e {\n            let raw = db::view_query(conn, \u0026a.view_name)?;\n\n            // Re-use the tiny parser from marlin search\n            let fts_expr = build_fts_match(\u0026raw);\n\n            let mut stmt = conn.prepare(\n                r#\"\n                SELECT f.path\n                  FROM files_fts\n                  JOIN files f ON f.rowid = files_fts.rowid\n                 WHERE files_fts MATCH ?1\n                 ORDER BY rank\n                \"#,\n            )?;\n            let mut paths: Vec\u003cString\u003e = stmt\n                .query_map([fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            /* ── NEW: graceful fallback when FTS finds nothing ───── */\n            if paths.is_empty() \u0026\u0026 !raw.contains(':') {\n                paths = naive_search(conn, \u0026raw)?;\n            }\n\n            if paths.is_empty() \u0026\u0026 matches!(fmt, Format::Text) {\n                eprintln!(\"(view '{}' has no matches)\", a.view_name);\n            } else {\n                for p in paths {\n                    println!(\"{p}\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\n/* ─── naive substring path/content search (≤ 64 kB files) ───────── */\n\nfn naive_search(conn: \u0026Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let term_lc = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut hits = Vec::new();\n    for p in rows {\n        let p = p?;\n        /* path match */\n        if p.to_lowercase().contains(\u0026term_lc) {\n            hits.push(p);\n            continue;\n        }\n        /* small-file content match */\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 64_000 {\n                continue;\n            }\n        }\n        if let Ok(content) = fs::read_to_string(\u0026p) {\n            if content.to_lowercase().contains(\u0026term_lc) {\n                hits.push(p);\n            }\n        }\n    }\n    Ok(hits)\n}\n\n/* ─── minimal copy of search-string → FTS5 translator ───────────── */\n\nfn build_fts_match(raw_query: \u0026str) -\u003e String {\n    use shlex;\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 {\n                    parts.push(\"AND\".into());\n                }\n                parts.push(format!(\"tags_text:{}\", escape(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n            }\n        } else {\n            parts.push(escape(\u0026tok));\n        }\n    }\n    parts.join(\" \")\n}\n\nfn escape(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n","traces":[{"line":33,"address":[2361648,2363246,2363240],"length":1,"stats":{"Line":0}},{"line":34,"address":[2361705],"length":1,"stats":{"Line":0}},{"line":36,"address":[2361821],"length":1,"stats":{"Line":0}},{"line":37,"address":[2362169,2361829],"length":1,"stats":{"Line":0}},{"line":38,"address":[2362218],"length":1,"stats":{"Line":0}},{"line":39,"address":[2362241],"length":1,"stats":{"Line":0}},{"line":45,"address":[2362416,2362470,2361956],"length":1,"stats":{"Line":0}},{"line":46,"address":[2362574],"length":1,"stats":{"Line":0}},{"line":48,"address":[2362849,2362714,2362606],"length":1,"stats":{"Line":0}},{"line":49,"address":[2363043,2362950],"length":1,"stats":{"Line":0}},{"line":62,"address":[2362045],"length":1,"stats":{"Line":0}},{"line":63,"address":[2362062,2363307],"length":1,"stats":{"Line":0}},{"line":66,"address":[2363421,2363500],"length":1,"stats":{"Line":0}},{"line":68,"address":[2365825,2363588,2363710,2363523],"length":1,"stats":{"Line":0}},{"line":77,"address":[2364067,2364000,2364175,2364384,2365777],"length":1,"stats":{"Line":0}},{"line":78,"address":[2096051,2096016],"length":1,"stats":{"Line":0}},{"line":82,"address":[2364490,2365008,2364598,2364558],"length":1,"stats":{"Line":0}},{"line":83,"address":[2364869,2364663,2365017],"length":1,"stats":{"Line":0}},{"line":86,"address":[2365078,2365161,2364564],"length":1,"stats":{"Line":0}},{"line":87,"address":[2365177],"length":1,"stats":{"Line":0}},{"line":89,"address":[2365286,2365084,2365421],"length":1,"stats":{"Line":0}},{"line":90,"address":[2365659,2365490],"length":1,"stats":{"Line":0}},{"line":95,"address":[2362388],"length":1,"stats":{"Line":0}},{"line":100,"address":[2367885,2365904,2368916],"length":1,"stats":{"Line":0}},{"line":101,"address":[2365985],"length":1,"stats":{"Line":0}},{"line":102,"address":[2366105,2368914,2366034],"length":1,"stats":{"Line":0}},{"line":103,"address":[2096115,2096080],"length":1,"stats":{"Line":0}},{"line":105,"address":[2366708],"length":1,"stats":{"Line":0}},{"line":106,"address":[2368590,2366768,2366860,2366936],"length":1,"stats":{"Line":0}},{"line":107,"address":[2367037,2367202],"length":1,"stats":{"Line":0}},{"line":109,"address":[2367420,2367488],"length":1,"stats":{"Line":0}},{"line":110,"address":[2368673],"length":1,"stats":{"Line":0}},{"line":114,"address":[2367657,2367767],"length":1,"stats":{"Line":0}},{"line":115,"address":[2367774,2367835],"length":1,"stats":{"Line":0}},{"line":119,"address":[2367982,2367891],"length":1,"stats":{"Line":0}},{"line":120,"address":[2368030,2368101],"length":1,"stats":{"Line":0}},{"line":121,"address":[2368289],"length":1,"stats":{"Line":0}},{"line":125,"address":[2367090],"length":1,"stats":{"Line":0}},{"line":130,"address":[2372260,2370638,2368944],"length":1,"stats":{"Line":0}},{"line":132,"address":[2368999],"length":1,"stats":{"Line":0}},{"line":133,"address":[2096178,2096144],"length":1,"stats":{"Line":0}},{"line":134,"address":[2369149,2372214,2369311],"length":1,"stats":{"Line":0}},{"line":135,"address":[2369611,2369396],"length":1,"stats":{"Line":0}},{"line":136,"address":[2369709,2372201],"length":1,"stats":{"Line":0}},{"line":137,"address":[2369802,2369686],"length":1,"stats":{"Line":0}},{"line":138,"address":[2096416,2096430],"length":1,"stats":{"Line":0}},{"line":139,"address":[2370204],"length":1,"stats":{"Line":0}},{"line":140,"address":[2370259],"length":1,"stats":{"Line":0}},{"line":142,"address":[2370333,2370252],"length":1,"stats":{"Line":0}},{"line":144,"address":[2369968,2370660],"length":1,"stats":{"Line":0}},{"line":145,"address":[2370782],"length":1,"stats":{"Line":0}},{"line":146,"address":[2370840],"length":1,"stats":{"Line":0}},{"line":147,"address":[2370949],"length":1,"stats":{"Line":0}},{"line":148,"address":[2371095,2371130],"length":1,"stats":{"Line":0}},{"line":149,"address":[2371430],"length":1,"stats":{"Line":0}},{"line":150,"address":[2371520],"length":1,"stats":{"Line":0}},{"line":152,"address":[2371832,2371120],"length":1,"stats":{"Line":0}},{"line":155,"address":[2372155,2370820],"length":1,"stats":{"Line":0}},{"line":158,"address":[2369441],"length":1,"stats":{"Line":0}},{"line":161,"address":[2372650,2372656,2372288],"length":1,"stats":{"Line":0}},{"line":162,"address":[2096492,2096464],"length":1,"stats":{"Line":0}},{"line":163,"address":[2372484,2372366,2372621],"length":1,"stats":{"Line":0}},{"line":165,"address":[2372417,2372669],"length":1,"stats":{"Line":0}},{"line":167,"address":[2372613],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":64},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","watch.rs"],"content":"// src/cli/watch.rs\n\nuse anyhow::Result;\nuse clap::Subcommand;\nuse libmarlin::watcher::{WatcherConfig, WatcherState};\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse std::sync::Arc;\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tracing::info;\n\n/// Commands related to file watching functionality\n#[derive(Subcommand, Debug)]\npub enum WatchCmd {\n    /// Start watching a directory for changes\n    Start {\n        /// Directory to watch (defaults to current directory)\n        #[arg(default_value = \".\")]\n        path: PathBuf,\n        \n        /// Debounce window in milliseconds (default: 100ms)\n        #[arg(long, default_value = \"100\")]\n        debounce_ms: u64,\n    },\n    \n    /// Show status of currently active watcher\n    Status,\n    \n    /// Stop the currently running watcher\n    Stop,\n}\n\n/// Run a watch command\npub fn run(cmd: \u0026WatchCmd, _conn: \u0026mut Connection, _format: super::Format) -\u003e Result\u003c()\u003e {\n    match cmd {\n        WatchCmd::Start { path, debounce_ms } =\u003e {\n            let mut marlin = libmarlin::Marlin::open_default()?;\n            let config = WatcherConfig {\n                debounce_ms: *debounce_ms,\n                ..Default::default()\n            };\n            let canon_path = path.canonicalize().unwrap_or_else(|_| path.clone());\n            info!(\"Starting watcher for directory: {}\", canon_path.display());\n\n            let mut watcher = marlin.watch(\u0026canon_path, Some(config))?;\n            \n            let status = watcher.status();\n            info!(\"Watcher started. Press Ctrl+C to stop watching.\");\n            info!(\"Watching {} paths\", status.watched_paths.len());\n            \n            let start_time = Instant::now();\n            let mut last_status_time = Instant::now();\n            let running = Arc::new(AtomicBool::new(true));\n            let r_clone = running.clone();\n\n            ctrlc::set_handler(move || {\n                info!(\"Ctrl+C received. Signaling watcher to stop...\");\n                r_clone.store(false, Ordering::SeqCst);\n            })?;\n\n            info!(\"Watcher run loop started. Waiting for Ctrl+C or stop signal...\");\n            while running.load(Ordering::SeqCst) {\n                let current_status = watcher.status();\n                if current_status.state == WatcherState::Stopped {\n                    info!(\"Watcher has stopped (detected by state). Exiting loop.\");\n                    break;\n                }\n\n                // Corrected line: removed the extra closing parenthesis\n                if last_status_time.elapsed() \u003e Duration::from_secs(10) { \n                    let uptime = start_time.elapsed();\n                    info!(\n                        \"Watcher running for {}s, processed {} events, queue: {}, state: {:?}\",\n                        uptime.as_secs(),\n                        current_status.events_processed,\n                        current_status.queue_size,\n                        current_status.state\n                    );\n                    last_status_time = Instant::now();\n                }\n                thread::sleep(Duration::from_millis(200));\n            }\n\n            info!(\"Watcher run loop ended. Explicitly stopping watcher instance...\");\n            watcher.stop()?; \n            info!(\"Watcher instance fully stopped.\");\n            Ok(())\n        }\n        WatchCmd::Status =\u003e {\n            info!(\"Status command: No active watcher process to query in this CLI invocation model.\");\n            info!(\"To see live status, run 'marlin watch start' which prints periodic updates.\");\n            Ok(())\n        }\n        WatchCmd::Stop =\u003e {\n            info!(\"Stop command: No active watcher process to stop in this CLI invocation model.\");\n            info!(\"Please use Ctrl+C in the terminal where 'marlin watch start' is running.\");\n            Ok(())\n        }\n    }\n}","traces":[{"line":36,"address":[2347011,2346893,2338224],"length":1,"stats":{"Line":0}},{"line":37,"address":[2338281],"length":1,"stats":{"Line":0}},{"line":38,"address":[2338369],"length":1,"stats":{"Line":0}},{"line":39,"address":[2338397,2338535],"length":1,"stats":{"Line":0}},{"line":41,"address":[2338841],"length":1,"stats":{"Line":0}},{"line":44,"address":[2056512,2056533],"length":1,"stats":{"Line":0}},{"line":45,"address":[2339509,2339158,2339079],"length":1,"stats":{"Line":0}},{"line":47,"address":[2346982,2340089,2339423],"length":1,"stats":{"Line":0}},{"line":49,"address":[2340273],"length":1,"stats":{"Line":0}},{"line":50,"address":[2340336,2340708,2340412],"length":1,"stats":{"Line":0}},{"line":51,"address":[2340677,2341126,2341420],"length":1,"stats":{"Line":0}},{"line":53,"address":[2341391,2341936],"length":1,"stats":{"Line":0}},{"line":54,"address":[2341951],"length":1,"stats":{"Line":0}},{"line":55,"address":[2342012],"length":1,"stats":{"Line":0}},{"line":56,"address":[2342111,2342190],"length":1,"stats":{"Line":0}},{"line":58,"address":[2056624],"length":1,"stats":{"Line":0}},{"line":59,"address":[2056834,2056644],"length":1,"stats":{"Line":0}},{"line":60,"address":[2056794],"length":1,"stats":{"Line":0}},{"line":63,"address":[2342312,2342642],"length":1,"stats":{"Line":0}},{"line":64,"address":[2343061,2342612],"length":1,"stats":{"Line":0}},{"line":65,"address":[2343135],"length":1,"stats":{"Line":0}},{"line":66,"address":[2343162,2343242],"length":1,"stats":{"Line":0}},{"line":67,"address":[2344586,2343282,2344873],"length":1,"stats":{"Line":0}},{"line":72,"address":[2344526,2343328,2343248],"length":1,"stats":{"Line":0}},{"line":73,"address":[2343473],"length":1,"stats":{"Line":0}},{"line":74,"address":[2343537,2344087,2343866],"length":1,"stats":{"Line":0}},{"line":81,"address":[2343837,2344511],"length":1,"stats":{"Line":0}},{"line":83,"address":[2344546,2343448],"length":1,"stats":{"Line":0}},{"line":86,"address":[2343104,2345291,2345586],"length":1,"stats":{"Line":0}},{"line":87,"address":[2345999,2345556,2346866],"length":1,"stats":{"Line":0}},{"line":88,"address":[2346387,2346101],"length":1,"stats":{"Line":0}},{"line":89,"address":[2346353],"length":1,"stats":{"Line":0}},{"line":92,"address":[2347205,2338471,2347024],"length":1,"stats":{"Line":0}},{"line":93,"address":[2347173,2347740,2347574],"length":1,"stats":{"Line":0}},{"line":94,"address":[2347723],"length":1,"stats":{"Line":0}},{"line":97,"address":[2338503,2348109,2348290],"length":1,"stats":{"Line":0}},{"line":98,"address":[2348659,2348825,2348258],"length":1,"stats":{"Line":0}},{"line":99,"address":[2348808],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":38},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli.rs"],"content":"// src/cli.rs\n\npub mod link;\npub mod coll;\npub mod view;\npub mod state;\npub mod task;\npub mod remind;\npub mod annotate;\npub mod version;\npub mod event;\npub mod watch;\n\nuse clap::{Parser, Subcommand, ValueEnum};\nuse clap_complete::Shell;\n\n/// Output format for commands.\n#[derive(ValueEnum, Clone, Copy, Debug)]\npub enum Format {\n    Text,\n    Json,\n}\n\n/// Marlin – metadata-driven file explorer (CLI utilities)\n#[derive(Parser, Debug)]\n#[command(author, version, about, propagate_version = true)]\npub struct Cli {\n    /// Enable debug logging and extra output\n    #[arg(long)]\n    pub verbose: bool,\n\n    /// Output format (text or JSON)\n    #[arg(long, default_value = \"text\", value_enum, global = true)]\n    pub format: Format,\n\n    #[command(subcommand)]\n    pub command: Commands,\n}\n\n#[derive(Subcommand, Debug)]\npub enum Commands {\n    /// Initialise the database (idempotent)\n    Init,\n\n    /// Scan one or more directories and populate the file index\n    Scan {\n        /// Only re-index files marked dirty by `marlin watch`\n        #[arg(long)]\n        dirty: bool,\n\n        /// Directories to scan (defaults to cwd)\n        paths: Vec\u003cstd::path::PathBuf\u003e,\n    },\n\n    /// Tag files matching a glob pattern (hierarchical tags use `/`)\n    Tag {\n        /// Glob or path pattern\n        pattern: String,\n        /// Hierarchical tag name (`foo/bar`)\n        tag_path: String,\n    },\n\n    /// Manage custom attributes\n    Attr {\n        #[command(subcommand)]\n        action: AttrCmd,\n    },\n\n    /// Full-text search; `--exec CMD` runs CMD on each hit (`{}` placeholder)\n    Search {\n        query: String,\n        #[arg(long)]\n        exec: Option\u003cString\u003e,\n    },\n\n    /// Create a timestamped backup of the database\n    Backup,\n\n    /// Restore from a backup file (overwrites current DB)\n    Restore {\n        backup_path: std::path::PathBuf,\n    },\n\n    /// Generate shell completions (hidden)\n    #[command(hide = true)]\n    Completions {\n        /// Which shell to generate for\n        #[arg(value_enum)]\n        shell: Shell,\n    },\n\n    /// File-to-file links\n    #[command(subcommand)]\n    Link(link::LinkCmd),\n\n    /// Collections (groups) of files\n    #[command(subcommand)]\n    Coll(coll::CollCmd),\n\n    /// Smart views (saved queries)\n    #[command(subcommand)]\n    View(view::ViewCmd),\n\n    /// Workflow states on files\n    #[command(subcommand)]\n    State(state::StateCmd),\n\n    /// TODO/tasks management\n    #[command(subcommand)]\n    Task(task::TaskCmd),\n\n    /// Reminders on files\n    #[command(subcommand)]\n    Remind(remind::RemindCmd),\n\n    /// File annotations and highlights\n    #[command(subcommand)]\n    Annotate(annotate::AnnotateCmd),\n\n    /// Version diffs\n    #[command(subcommand)]\n    Version(version::VersionCmd),\n\n    /// Calendar events \u0026 timelines\n    #[command(subcommand)]\n    Event(event::EventCmd),\n\n    /// Watch directories for changes\n    #[command(subcommand)]\n    Watch(watch::WatchCmd),\n}\n\n#[derive(Subcommand, Debug)]\npub enum AttrCmd {\n    Set { pattern: String, key: String, value: String },\n    Ls  { path: std::path::PathBuf },\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","main.rs"],"content":"//! Marlin CLI entry-point (post crate-split)\n//!\n//! All heavy lifting now lives in the `libmarlin` crate; this file\n//! handles argument parsing, logging, orchestration and the few\n//! helpers that remain CLI-specific.\n\n#![deny(warnings)]\n\nmod cli; // sub-command definitions and argument structs\n\n/* ── shared modules re-exported from libmarlin ─────────────────── */\nuse libmarlin::{\n    config,\n    db,\n    logging,\n    scan,\n    utils::determine_scan_root,\n};\nuse libmarlin::db::take_dirty;\n\nuse anyhow::{Context, Result};\nuse clap::{CommandFactory, Parser};\nuse clap_complete::generate;\nuse glob::Pattern;\nuse shellexpand;\nuse shlex;\nuse std::{\n    env,\n    fs,\n    io,\n    path::Path,\n    process::Command,\n};\nuse tracing::{debug, error, info};\nuse walkdir::WalkDir;\n\nuse cli::{Cli, Commands};\n\nfn main() -\u003e Result\u003c()\u003e {\n    /* ── CLI parsing \u0026 logging ────────────────────────────────── */\n    let args = Cli::parse();\n    if args.verbose {\n        env::set_var(\"RUST_LOG\", \"debug\");\n    }\n    logging::init();\n\n    /* ── shell-completion shortcut ────────────────────────────── */\n    if let Commands::Completions { shell } = \u0026args.command {\n        let mut cmd = Cli::command();\n        generate(*shell, \u0026mut cmd, \"marlin\", \u0026mut io::stdout());\n        return Ok(());\n    }\n\n    /* ── config \u0026 automatic backup ───────────────────────────── */\n    let cfg = config::Config::load()?; // resolves DB path\n\n    match \u0026args.command {\n        Commands::Init | Commands::Backup | Commands::Restore { .. } =\u003e {}\n        _ =\u003e match db::backup(\u0026cfg.db_path) {\n            Ok(p)  =\u003e info!(\"Pre-command auto-backup created at {}\", p.display()),\n            Err(e) =\u003e error!(\"Failed to create pre-command auto-backup: {e}\"),\n        },\n    }\n\n    /* ── open DB (runs migrations) ───────────────────────────── */\n    let mut conn = db::open(\u0026cfg.db_path)?;\n\n    /* ── command dispatch ────────────────────────────────────── */\n    match args.command {\n        Commands::Completions { .. } =\u003e {} // handled above\n\n        /* ---- init ------------------------------------------------ */\n        Commands::Init =\u003e {\n            info!(\"Database initialised at {}\", cfg.db_path.display());\n            let cwd   = env::current_dir().context(\"getting current directory\")?;\n            let count = scan::scan_directory(\u0026mut conn, \u0026cwd)\n                .context(\"initial scan failed\")?;\n            info!(\"Initial scan complete – indexed/updated {count} files\");\n        }\n\n        /* ---- scan ------------------------------------------------ */\n        Commands::Scan { dirty, paths } =\u003e {\n            let scan_paths: Vec\u003cstd::path::PathBuf\u003e = if paths.is_empty() {\n                vec![env::current_dir()?]\n            } else {\n                paths.into_iter().collect()\n            };\n\n            if dirty {\n                let dirty_ids = take_dirty(\u0026conn)?;\n                for id in dirty_ids {\n                    let path: String = conn.query_row(\n                        \"SELECT path FROM files WHERE id = ?1\",\n                        [id],\n                        |r| r.get(0),\n                    )?;\n                    scan::scan_directory(\u0026mut conn, Path::new(\u0026path))?;\n                }\n            } else {\n                for p in scan_paths {\n                    scan::scan_directory(\u0026mut conn, \u0026p)?;\n                }\n            }\n        }\n\n        /* ---- tag / attribute / search --------------------------- */\n        Commands::Tag { pattern, tag_path } =\u003e\n            apply_tag(\u0026conn, \u0026pattern, \u0026tag_path)?,\n\n        Commands::Attr { action } =\u003e match action {\n            cli::AttrCmd::Set { pattern, key, value } =\u003e\n                attr_set(\u0026conn, \u0026pattern, \u0026key, \u0026value)?,\n            cli::AttrCmd::Ls { path } =\u003e\n                attr_ls(\u0026conn, \u0026path)?,\n        },\n\n        Commands::Search { query, exec } =\u003e\n            run_search(\u0026conn, \u0026query, exec)?,\n\n        /* ---- maintenance ---------------------------------------- */\n        Commands::Backup =\u003e {\n            let p = db::backup(\u0026cfg.db_path)?;\n            println!(\"Backup created: {}\", p.display());\n        }\n\n        Commands::Restore { backup_path } =\u003e {\n            drop(conn);\n            db::restore(\u0026backup_path, \u0026cfg.db_path).with_context(|| {\n                format!(\"Failed to restore DB from {}\", backup_path.display())\n            })?;\n            println!(\"Restored DB from {}\", backup_path.display());\n            db::open(\u0026cfg.db_path).with_context(|| {\n                format!(\"Could not open restored DB at {}\", cfg.db_path.display())\n            })?;\n            info!(\"Successfully opened restored database.\");\n        }\n\n        /* ---- passthrough sub-modules (some still stubs) ---------- */\n        Commands::Link(link_cmd)   =\u003e cli::link::run(\u0026link_cmd,   \u0026mut conn, args.format)?,\n        Commands::Coll(coll_cmd)   =\u003e cli::coll::run(\u0026coll_cmd,   \u0026mut conn, args.format)?,\n        Commands::View(view_cmd)   =\u003e cli::view::run(\u0026view_cmd,   \u0026mut conn, args.format)?,\n        Commands::State(state_cmd) =\u003e cli::state::run(\u0026state_cmd, \u0026mut conn, args.format)?,\n        Commands::Task(task_cmd)   =\u003e cli::task::run(\u0026task_cmd,   \u0026mut conn, args.format)?,\n        Commands::Remind(rm_cmd)   =\u003e cli::remind::run(\u0026rm_cmd,   \u0026mut conn, args.format)?,\n        Commands::Annotate(a_cmd)  =\u003e cli::annotate::run(\u0026a_cmd,  \u0026mut conn, args.format)?,\n        Commands::Version(v_cmd)   =\u003e cli::version::run(\u0026v_cmd,   \u0026mut conn, args.format)?,\n        Commands::Event(e_cmd)     =\u003e cli::event::run(\u0026e_cmd,     \u0026mut conn, args.format)?,\n        Commands::Watch(watch_cmd) =\u003e cli::watch::run(\u0026watch_cmd, \u0026mut conn, args.format)?,\n    }\n\n    Ok(())\n}\n\n/* ─────────────────── helpers \u0026 sub-routines ─────────────────── */\n\n/* ---------- TAGS ---------- */\nfn apply_tag(conn: \u0026rusqlite::Connection, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003c()\u003e {\n    let leaf_tag_id = db::ensure_tag_path(conn, tag_path)?;\n    let mut tag_ids = Vec::new();\n    let mut current = Some(leaf_tag_id);\n    while let Some(id) = current {\n        tag_ids.push(id);\n        current = conn.query_row(\n            \"SELECT parent_id FROM tags WHERE id=?1\",\n            [id],\n            |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n        )?;\n    }\n\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file   = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut stmt_insert = conn.prepare(\n        \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n    )?;\n\n    let mut count = 0usize;\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                let mut newly = false;\n                for \u0026tid in \u0026tag_ids {\n                    if stmt_insert.execute([fid, tid])? \u003e 0 {\n                        newly = true;\n                    }\n                }\n                if newly {\n                    info!(file=%p, tag=tag_path, \"tagged\");\n                    count += 1;\n                }\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Applied tag '{}' to {} file(s).\", tag_path, count);\n    Ok(())\n}\n\n/* ---------- ATTRIBUTES ---------- */\nfn attr_set(conn: \u0026rusqlite::Connection, pattern: \u0026str, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut count = 0usize;\n\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                db::upsert_attr(conn, fid, key, value)?;\n                info!(file=%p, key, value, \"attr set\");\n                count += 1;\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Attribute '{}={}' set on {} file(s).\", key, value, count);\n    Ok(())\n}\n\nfn attr_ls(conn: \u0026rusqlite::Connection, path: \u0026Path) -\u003e Result\u003c()\u003e {\n    let fid = db::file_id(conn, \u0026path.to_string_lossy())?;\n    let mut stmt = conn.prepare(\n        \"SELECT key, value FROM attributes WHERE file_id=?1 ORDER BY key\"\n    )?;\n    for row in stmt\n        .query_map([fid], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?\n    {\n        let (k, v) = row?;\n        println!(\"{k} = {v}\");\n    }\n    Ok(())\n}\n\n/* ---------- SEARCH ---------- */\nfn run_search(conn: \u0026rusqlite::Connection, raw_query: \u0026str, exec: Option\u003cString\u003e) -\u003e Result\u003c()\u003e {\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 { parts.push(\"AND\".into()); }\n                parts.push(format!(\"tags_text:{}\", escape_fts(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape_fts(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n            }\n        } else {\n            parts.push(escape_fts(\u0026tok));\n        }\n    }\n    let fts_expr = parts.join(\" \");\n    debug!(\"FTS MATCH expression: {fts_expr}\");\n\n    let mut stmt = conn.prepare(\n        r#\"\n        SELECT f.path\n          FROM files_fts\n          JOIN files f ON f.rowid = files_fts.rowid\n         WHERE files_fts MATCH ?1\n         ORDER BY rank\n        \"#,\n    )?;\n    let mut hits: Vec\u003cString\u003e = stmt\n        .query_map([\u0026fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n        .filter_map(Result::ok)\n        .collect();\n\n    if hits.is_empty() \u0026\u0026 !raw_query.contains(':') {\n        hits = naive_substring_search(conn, raw_query)?;\n    }\n\n    if let Some(cmd_tpl) = exec {\n        run_exec(\u0026hits, \u0026cmd_tpl)?;\n    } else {\n        if hits.is_empty() {\n            eprintln!(\n                \"No matches for query: `{raw_query}` (FTS expr: `{fts_expr}`)\"\n            );\n        } else {\n            for p in hits { println!(\"{p}\"); }\n        }\n    }\n    Ok(())\n}\n\nfn naive_substring_search(conn: \u0026rusqlite::Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let needle = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut out = Vec::new();\n    for p in rows {\n        let p = p?;\n        if p.to_lowercase().contains(\u0026needle) {\n            out.push(p.clone());\n            continue;\n        }\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 65_536 { continue; }\n        }\n        if let Ok(body) = fs::read_to_string(\u0026p) {\n            if body.to_lowercase().contains(\u0026needle) {\n                out.push(p);\n            }\n        }\n    }\n    Ok(out)\n}\n\nfn run_exec(paths: \u0026[String], cmd_tpl: \u0026str) -\u003e Result\u003c()\u003e {\n    let mut ran_without_placeholder = false;\n\n    if paths.is_empty() \u0026\u0026 !cmd_tpl.contains(\"{}\") {\n        if let Some(mut parts) = shlex::split(cmd_tpl) {\n            if !parts.is_empty() {\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(command=%cmd_tpl, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n        ran_without_placeholder = true;\n    }\n\n    if !ran_without_placeholder {\n        for p in paths {\n            let quoted = shlex::try_quote(p).unwrap_or_else(|_| p.into());\n            let final_cmd = if cmd_tpl.contains(\"{}\") {\n                cmd_tpl.replace(\"{}\", \u0026quoted)\n            } else {\n                format!(\"{cmd_tpl} {quoted}\")\n            };\n            if let Some(mut parts) = shlex::split(\u0026final_cmd) {\n                if parts.is_empty() { continue; }\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(file=%p, command=%final_cmd, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\nfn escape_fts(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use assert_cmd::Command;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_help_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--help\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"Usage: marlin\"));\n    }\n\n    #[test]\n    fn test_version_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--version\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"marlin-cli 0.1.0\"));\n    }\n\n    #[test]\n    fn test_verbose_logging() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"--verbose\").arg(\"init\");\n        let output = cmd.output().unwrap();\n        assert!(output.status.success());\n        let stderr = String::from_utf8_lossy(\u0026output.stderr);\n        assert!(\n            stderr.contains(\"DEBUG\"),\n            \"Expected debug logs in stderr, got: {}\",\n            stderr\n        );\n    }\n\n    #[test]\n    fn test_shell_completions() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"completions\").arg(\"bash\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"_marlin()\"))\n            .stdout(predicates::str::contains(\"init\"))\n            .stdout(predicates::str::contains(\"scan\"));\n    }\n\n    #[test]\n    fn test_invalid_subcommand() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"invalid_cmd\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"error: unrecognized subcommand\"));\n    }\n\n    #[test]\n    fn test_init_command() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd.arg(\"init\");\n        cmd.assert().success();\n        assert!(db_path.exists(), \"Database file should exist after init\");\n    }\n\n    #[test]\n    fn test_automatic_backup() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let backups_dir = tmp.path().join(\"backups\");\n\n        // Init: no backup\n        let mut cmd_init = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_init.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_init.arg(\"init\");\n        cmd_init.assert().success();\n        assert!(\n            !backups_dir.exists() || backups_dir.read_dir().unwrap().next().is_none(),\n            \"No backup should be created for init\"\n        );\n\n        // Scan: backup created\n        let mut cmd_scan = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_scan.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_scan.arg(\"scan\");\n        cmd_scan.assert().success();\n        assert!(backups_dir.exists(), \"Backups directory should exist after scan\");\n        let backups: Vec\u003c_\u003e = backups_dir.read_dir().unwrap().collect();\n        assert_eq!(backups.len(), 1, \"One backup should be created for scan\");\n    }\n\n    #[test]\n    fn test_annotate_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"annotate\").arg(\"add\").arg(\"file.txt\").arg(\"note\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n\n    #[test]\n    fn test_event_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"event\").arg(\"add\").arg(\"file.txt\").arg(\"2025-05-20\").arg(\"desc\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n}\n","traces":[{"line":39,"address":[2202655,2218682,2201872],"length":1,"stats":{"Line":0}},{"line":41,"address":[2201894],"length":1,"stats":{"Line":0}},{"line":42,"address":[2202219],"length":1,"stats":{"Line":0}},{"line":43,"address":[2202240,2202346],"length":1,"stats":{"Line":0}},{"line":45,"address":[2202229],"length":1,"stats":{"Line":0}},{"line":48,"address":[2202348],"length":1,"stats":{"Line":0}},{"line":49,"address":[2202394],"length":1,"stats":{"Line":0}},{"line":50,"address":[2202518,2202431],"length":1,"stats":{"Line":0}},{"line":51,"address":[2202571],"length":1,"stats":{"Line":0}},{"line":55,"address":[2202661,2218129,2202401],"length":1,"stats":{"Line":0}},{"line":57,"address":[2202834],"length":1,"stats":{"Line":0}},{"line":59,"address":[2202974,2202893],"length":1,"stats":{"Line":0}},{"line":60,"address":[2203058],"length":1,"stats":{"Line":0}},{"line":61,"address":[2203011,2204020],"length":1,"stats":{"Line":0}},{"line":66,"address":[2218111,2204816,2202900],"length":1,"stats":{"Line":0}},{"line":69,"address":[2205102],"length":1,"stats":{"Line":0}},{"line":74,"address":[2206936,2207223,2205144],"length":1,"stats":{"Line":0}},{"line":75,"address":[2209168,2207787,2207201],"length":1,"stats":{"Line":0}},{"line":76,"address":[2209114,2208269,2207999,2208082],"length":1,"stats":{"Line":0}},{"line":78,"address":[2208644,2208322],"length":1,"stats":{"Line":0}},{"line":82,"address":[2205175],"length":1,"stats":{"Line":0}},{"line":83,"address":[2209760,2209226,2205244],"length":1,"stats":{"Line":0}},{"line":84,"address":[2209309,2209383,2211968,2211871],"length":1,"stats":{"Line":0}},{"line":86,"address":[2209232,2209340],"length":1,"stats":{"Line":0}},{"line":89,"address":[2209362,2211077],"length":1,"stats":{"Line":0}},{"line":90,"address":[2210525,2209832,2211788],"length":1,"stats":{"Line":0}},{"line":91,"address":[2210686,2210941,2210790],"length":1,"stats":{"Line":0}},{"line":92,"address":[2210995,2211153,2211735,2211281],"length":1,"stats":{"Line":0}},{"line":94,"address":[2210987],"length":1,"stats":{"Line":0}},{"line":95,"address":[2298240,2298256],"length":1,"stats":{"Line":0}},{"line":97,"address":[2211382,2211685,2211477],"length":1,"stats":{"Line":0}},{"line":100,"address":[2209765,2209903,2210038],"length":1,"stats":{"Line":0}},{"line":101,"address":[2210444,2210115,2210236],"length":1,"stats":{"Line":0}},{"line":107,"address":[2205273],"length":1,"stats":{"Line":0}},{"line":108,"address":[2212000,2205361],"length":1,"stats":{"Line":0}},{"line":110,"address":[2205387],"length":1,"stats":{"Line":0}},{"line":111,"address":[2212486],"length":1,"stats":{"Line":0}},{"line":112,"address":[2212590],"length":1,"stats":{"Line":0}},{"line":113,"address":[2212420],"length":1,"stats":{"Line":0}},{"line":114,"address":[2212460,2213200],"length":1,"stats":{"Line":0}},{"line":117,"address":[2205471],"length":1,"stats":{"Line":0}},{"line":118,"address":[2213459,2205567],"length":1,"stats":{"Line":0}},{"line":122,"address":[2205609,2213836,2214261],"length":1,"stats":{"Line":0}},{"line":123,"address":[2214080,2213997],"length":1,"stats":{"Line":0}},{"line":126,"address":[2205619],"length":1,"stats":{"Line":0}},{"line":127,"address":[2205659],"length":1,"stats":{"Line":0}},{"line":128,"address":[2214334,2215831,2214470],"length":1,"stats":{"Line":0}},{"line":129,"address":[2298310],"length":1,"stats":{"Line":0}},{"line":131,"address":[2214507],"length":1,"stats":{"Line":0}},{"line":132,"address":[2215793,2214697,2214812],"length":1,"stats":{"Line":0}},{"line":133,"address":[2298486],"length":1,"stats":{"Line":0}},{"line":135,"address":[2215374,2215052],"length":1,"stats":{"Line":0}},{"line":139,"address":[2205812,2215849],"length":1,"stats":{"Line":0}},{"line":140,"address":[2205942,2216057],"length":1,"stats":{"Line":0}},{"line":141,"address":[2216265,2206040],"length":1,"stats":{"Line":0}},{"line":142,"address":[2216467,2206138],"length":1,"stats":{"Line":0}},{"line":143,"address":[2206252,2216663],"length":1,"stats":{"Line":0}},{"line":144,"address":[2206334,2216859],"length":1,"stats":{"Line":0}},{"line":145,"address":[2217055,2206464],"length":1,"stats":{"Line":0}},{"line":146,"address":[2217251,2206594],"length":1,"stats":{"Line":0}},{"line":147,"address":[2206676,2217447],"length":1,"stats":{"Line":0}},{"line":148,"address":[2218006,2206806,2217643],"length":1,"stats":{"Line":0}},{"line":151,"address":[2205781],"length":1,"stats":{"Line":0}},{"line":157,"address":[2227697,2219744,2227856],"length":1,"stats":{"Line":0}},{"line":158,"address":[2219830],"length":1,"stats":{"Line":0}},{"line":159,"address":[2219968],"length":1,"stats":{"Line":0}},{"line":160,"address":[2219990],"length":1,"stats":{"Line":0}},{"line":161,"address":[2220441,2220010],"length":1,"stats":{"Line":0}},{"line":162,"address":[2220048],"length":1,"stats":{"Line":0}},{"line":163,"address":[2220359,2220454,2220180],"length":1,"stats":{"Line":0}},{"line":165,"address":[2220172],"length":1,"stats":{"Line":0}},{"line":166,"address":[2298640,2298656],"length":1,"stats":{"Line":0}},{"line":170,"address":[2220481,2220090],"length":1,"stats":{"Line":0}},{"line":171,"address":[2220729,2220516,2227846,2220599],"length":1,"stats":{"Line":0}},{"line":172,"address":[2220713],"length":1,"stats":{"Line":0}},{"line":173,"address":[2220894,2220977],"length":1,"stats":{"Line":0}},{"line":175,"address":[2221075,2221004,2227787],"length":1,"stats":{"Line":0}},{"line":176,"address":[2221595,2221473,2227747,2221402],"length":1,"stats":{"Line":0}},{"line":180,"address":[2221792],"length":1,"stats":{"Line":0}},{"line":181,"address":[2221871,2221820,2222060],"length":1,"stats":{"Line":0}},{"line":184,"address":[2298816,2298843],"length":1,"stats":{"Line":0}},{"line":186,"address":[2222145,2223211],"length":1,"stats":{"Line":0}},{"line":187,"address":[2223218,2223313],"length":1,"stats":{"Line":0}},{"line":189,"address":[2223444,2223371],"length":1,"stats":{"Line":0}},{"line":190,"address":[2223585],"length":1,"stats":{"Line":0}},{"line":191,"address":[2223609],"length":1,"stats":{"Line":0}},{"line":192,"address":[2223712,2223617],"length":1,"stats":{"Line":0}},{"line":193,"address":[2223829,2225300,2225104],"length":1,"stats":{"Line":0}},{"line":194,"address":[2225292],"length":1,"stats":{"Line":0}},{"line":197,"address":[2223883,2225079],"length":1,"stats":{"Line":0}},{"line":198,"address":[2223915,2224249],"length":1,"stats":{"Line":0}},{"line":199,"address":[2224215,2225084,2225071],"length":1,"stats":{"Line":0}},{"line":203,"address":[2225489,2225627],"length":1,"stats":{"Line":0}},{"line":204,"address":[2225517],"length":1,"stats":{"Line":0}},{"line":205,"address":[2225589,2226490],"length":1,"stats":{"Line":0}},{"line":209,"address":[2222198,2222532],"length":1,"stats":{"Line":0}},{"line":210,"address":[2222498],"length":1,"stats":{"Line":0}},{"line":214,"address":[2227872,2234849,2234730],"length":1,"stats":{"Line":0}},{"line":215,"address":[2227966],"length":1,"stats":{"Line":0}},{"line":216,"address":[2228253,2234839,2228123,2228040],"length":1,"stats":{"Line":0}},{"line":217,"address":[2228237],"length":1,"stats":{"Line":0}},{"line":218,"address":[2228418,2228501],"length":1,"stats":{"Line":0}},{"line":220,"address":[2234780,2228599,2228528],"length":1,"stats":{"Line":0}},{"line":221,"address":[2228918],"length":1,"stats":{"Line":0}},{"line":223,"address":[2228997,2228946,2229186],"length":1,"stats":{"Line":0}},{"line":226,"address":[2299056,2299083],"length":1,"stats":{"Line":0}},{"line":228,"address":[2230342,2229271],"length":1,"stats":{"Line":0}},{"line":229,"address":[2230444,2230349],"length":1,"stats":{"Line":0}},{"line":231,"address":[2230502,2230575],"length":1,"stats":{"Line":0}},{"line":232,"address":[2230724],"length":1,"stats":{"Line":0}},{"line":233,"address":[2232346,2230843,2230740],"length":1,"stats":{"Line":0}},{"line":234,"address":[2231288,2230954],"length":1,"stats":{"Line":0}},{"line":235,"address":[2232286,2232296,2231254],"length":1,"stats":{"Line":0}},{"line":238,"address":[2232660,2232522],"length":1,"stats":{"Line":0}},{"line":239,"address":[2232550],"length":1,"stats":{"Line":0}},{"line":240,"address":[2233523,2232622],"length":1,"stats":{"Line":0}},{"line":244,"address":[2229658,2229324],"length":1,"stats":{"Line":0}},{"line":245,"address":[2229624],"length":1,"stats":{"Line":0}},{"line":248,"address":[2236624,2236563,2234864],"length":1,"stats":{"Line":0}},{"line":249,"address":[2236642,2234913],"length":1,"stats":{"Line":0}},{"line":250,"address":[2235279,2235171],"length":1,"stats":{"Line":0}},{"line":253,"address":[2235698,2236617,2235870,2235483,2235590],"length":1,"stats":{"Line":0}},{"line":254,"address":[2235634,2235475],"length":1,"stats":{"Line":0}},{"line":256,"address":[2236049,2235971,2236573],"length":1,"stats":{"Line":0}},{"line":257,"address":[2236366,2236295],"length":1,"stats":{"Line":0}},{"line":259,"address":[2236013],"length":1,"stats":{"Line":0}},{"line":263,"address":[2243587,2236672,2239914],"length":1,"stats":{"Line":0}},{"line":264,"address":[2236719],"length":1,"stats":{"Line":0}},{"line":265,"address":[2236839,2236915],"length":1,"stats":{"Line":0}},{"line":266,"address":[2236961,2243531,2237123],"length":1,"stats":{"Line":0}},{"line":267,"address":[2237208,2240934],"length":1,"stats":{"Line":0}},{"line":268,"address":[2241032,2243518],"length":1,"stats":{"Line":0}},{"line":269,"address":[2241009,2241125],"length":1,"stats":{"Line":0}},{"line":270,"address":[2241259,2241333],"length":1,"stats":{"Line":0}},{"line":271,"address":[2241527,2241582],"length":1,"stats":{"Line":0}},{"line":272,"address":[2241656,2241575],"length":1,"stats":{"Line":0}},{"line":274,"address":[2241291,2241977],"length":1,"stats":{"Line":0}},{"line":275,"address":[2242099],"length":1,"stats":{"Line":0}},{"line":276,"address":[2242157],"length":1,"stats":{"Line":0}},{"line":277,"address":[2242266],"length":1,"stats":{"Line":0}},{"line":278,"address":[2242447,2242412],"length":1,"stats":{"Line":0}},{"line":279,"address":[2242747],"length":1,"stats":{"Line":0}},{"line":280,"address":[2242837],"length":1,"stats":{"Line":0}},{"line":282,"address":[2243149,2242437],"length":1,"stats":{"Line":0}},{"line":285,"address":[2243472,2242137],"length":1,"stats":{"Line":0}},{"line":288,"address":[2237253],"length":1,"stats":{"Line":0}},{"line":289,"address":[2237718,2237415,2237336],"length":1,"stats":{"Line":0}},{"line":291,"address":[2238180,2237688,2240771,2238302],"length":1,"stats":{"Line":0}},{"line":300,"address":[2238622,2240731,2238730,2238515],"length":1,"stats":{"Line":0}},{"line":301,"address":[2238666,2238507],"length":1,"stats":{"Line":0}},{"line":305,"address":[2238990,2239380,2238861,2238935],"length":1,"stats":{"Line":0}},{"line":306,"address":[2239393,2239050],"length":1,"stats":{"Line":0}},{"line":309,"address":[2238949,2239431],"length":1,"stats":{"Line":0}},{"line":310,"address":[2239610,2239854,2239462],"length":1,"stats":{"Line":0}},{"line":312,"address":[2239497,2239927],"length":1,"stats":{"Line":0}},{"line":313,"address":[2240418,2240000],"length":1,"stats":{"Line":0}},{"line":317,"address":[2240030,2239933],"length":1,"stats":{"Line":0}},{"line":320,"address":[2239815],"length":1,"stats":{"Line":0}},{"line":323,"address":[2243632,2246596,2245619],"length":1,"stats":{"Line":0}},{"line":324,"address":[2243713],"length":1,"stats":{"Line":0}},{"line":325,"address":[2243762,2246594,2243833],"length":1,"stats":{"Line":0}},{"line":326,"address":[2244168,2244235,2246573],"length":1,"stats":{"Line":0}},{"line":328,"address":[2244436],"length":1,"stats":{"Line":0}},{"line":329,"address":[2244496,2244588,2244664,2246324],"length":1,"stats":{"Line":0}},{"line":330,"address":[2244930,2244765],"length":1,"stats":{"Line":0}},{"line":331,"address":[2245148,2245219],"length":1,"stats":{"Line":0}},{"line":332,"address":[2246407],"length":1,"stats":{"Line":0}},{"line":335,"address":[2245498,2245388],"length":1,"stats":{"Line":0}},{"line":336,"address":[2245505,2245566],"length":1,"stats":{"Line":0}},{"line":338,"address":[2245625,2245716],"length":1,"stats":{"Line":0}},{"line":339,"address":[2245764,2245835],"length":1,"stats":{"Line":0}},{"line":340,"address":[2246023],"length":1,"stats":{"Line":0}},{"line":344,"address":[2244818],"length":1,"stats":{"Line":0}},{"line":347,"address":[2246624,2248773,2248808],"length":1,"stats":{"Line":0}},{"line":348,"address":[2246679],"length":1,"stats":{"Line":0}},{"line":350,"address":[2246748,2248866,2246719],"length":1,"stats":{"Line":0}},{"line":351,"address":[2246786,2248787],"length":1,"stats":{"Line":0}},{"line":352,"address":[2247029,2246909],"length":1,"stats":{"Line":0}},{"line":353,"address":[2247035],"length":1,"stats":{"Line":0}},{"line":354,"address":[2247155,2247104,2248695],"length":1,"stats":{"Line":0}},{"line":355,"address":[2247428],"length":1,"stats":{"Line":0}},{"line":356,"address":[2247455,2247512],"length":1,"stats":{"Line":0}},{"line":360,"address":[2248858],"length":1,"stats":{"Line":0}},{"line":363,"address":[2246729],"length":1,"stats":{"Line":0}},{"line":364,"address":[2248944,2251960,2248903],"length":1,"stats":{"Line":0}},{"line":365,"address":[2249013],"length":1,"stats":{"Line":0}},{"line":366,"address":[2249187,2249090],"length":1,"stats":{"Line":0}},{"line":367,"address":[2249220,2249450],"length":1,"stats":{"Line":0}},{"line":369,"address":[2249193,2249258],"length":1,"stats":{"Line":0}},{"line":371,"address":[2249411,2249566,2251542],"length":1,"stats":{"Line":0}},{"line":372,"address":[2249774,2249678],"length":1,"stats":{"Line":0}},{"line":373,"address":[2249780],"length":1,"stats":{"Line":0}},{"line":374,"address":[2249903,2249852,2251552],"length":1,"stats":{"Line":0}},{"line":375,"address":[2250173],"length":1,"stats":{"Line":0}},{"line":376,"address":[2250194,2250245],"length":1,"stats":{"Line":0}},{"line":381,"address":[2248927],"length":1,"stats":{"Line":0}},{"line":384,"address":[2252032,2252400,2252394],"length":1,"stats":{"Line":0}},{"line":385,"address":[2252091],"length":1,"stats":{"Line":0}},{"line":386,"address":[2252110,2252228,2252365],"length":1,"stats":{"Line":0}},{"line":388,"address":[2252413,2252161],"length":1,"stats":{"Line":0}},{"line":390,"address":[2252357],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":201},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","e2e.rs"],"content":"//! tests e2e.rs\n//! End-to-end “happy path” smoke-tests for the `marlin` binary.\n//!\n//! Run with `cargo test --test e2e` (CI does) or `cargo test`.\n\nuse assert_cmd::prelude::*;\nuse predicates::prelude::*;\nuse std::{fs, path::PathBuf, process::Command};\nuse tempfile::tempdir;\n\n/// Absolute path to the freshly-built `marlin` binary.\nfn marlin_bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Create the demo directory structure and seed files.\nfn spawn_demo_tree(root: \u0026PathBuf) {\n    fs::create_dir_all(root.join(\"Projects/Alpha\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Beta\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Gamma\")).unwrap();\n    fs::create_dir_all(root.join(\"Logs\")).unwrap();\n    fs::create_dir_all(root.join(\"Reports\")).unwrap();\n\n    fs::write(root.join(\"Projects/Alpha/draft1.md\"), \"- [ ] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Alpha/draft2.md\"), \"- [x] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Beta/final.md\"), \"done\\n\").unwrap();\n    fs::write(root.join(\"Projects/Gamma/TODO.txt\"), \"TODO bar\\n\").unwrap();\n    fs::write(root.join(\"Logs/app.log\"),           \"ERROR omg\\n\").unwrap();\n    fs::write(root.join(\"Reports/Q1.pdf\"),         \"PDF\\n\").unwrap();\n}\n\n/// Shorthand for “run and must succeed”.\nfn ok(cmd: \u0026mut Command) -\u003e assert_cmd::assert::Assert {\n    cmd.assert().success()\n}\n\n#[test]\nfn full_cli_flow() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    /* ── 1 ░ sandbox ───────────────────────────────────────────── */\n\n    let tmp      = tempdir()?;                 // wiped on drop\n    let demo_dir = tmp.path().join(\"marlin_demo\");\n    spawn_demo_tree(\u0026demo_dir);\n\n    let db_path = demo_dir.join(\"index.db\");\n\n    // Helper to spawn a fresh `marlin` Command with the DB env-var set\n    let marlin = || {\n        let mut c = Command::new(marlin_bin());\n        c.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        c\n    };\n\n    /* ── 2 ░ init ( auto-scan cwd ) ───────────────────────────── */\n\n    ok(marlin()\n        .current_dir(\u0026demo_dir)\n        .arg(\"init\"));\n\n    /* ── 3 ░ tag \u0026 attr demos ─────────────────────────────────── */\n\n    ok(marlin()\n        .arg(\"tag\")\n        .arg(format!(\"{}/Projects/**/*.md\", demo_dir.display()))\n        .arg(\"project/md\"));\n\n    ok(marlin()\n        .arg(\"attr\")\n        .arg(\"set\")\n        .arg(format!(\"{}/Reports/*.pdf\", demo_dir.display()))\n        .arg(\"reviewed\")\n        .arg(\"yes\"));\n\n    /* ── 4 ░ quick search sanity checks ───────────────────────── */\n\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    marlin()\n        .arg(\"search\").arg(\"attr:reviewed=yes\")\n        .assert()\n        .stdout(predicate::str::contains(\"Q1.pdf\"));\n\n    /* ── 5 ░ link flow \u0026 backlinks ────────────────────────────── */\n\n    let foo = demo_dir.join(\"foo.txt\");\n    let bar = demo_dir.join(\"bar.txt\");\n    fs::write(\u0026foo, \"\")?;\n    fs::write(\u0026bar, \"\")?;\n\n    ok(marlin().arg(\"scan\").arg(\u0026demo_dir));\n\n    ok(marlin()\n        .arg(\"link\").arg(\"add\")\n        .arg(\u0026foo).arg(\u0026bar));\n\n    marlin()\n        .arg(\"link\").arg(\"backlinks\").arg(\u0026bar)\n        .assert()\n        .stdout(predicate::str::contains(\"foo.txt\"));\n\n    /* ── 6 ░ backup → delete DB → restore ────────────────────── */\n\n    let backup_path = String::from_utf8(\n        marlin().arg(\"backup\").output()?.stdout\n    )?;\n    let backup_file = backup_path.split_whitespace().last().unwrap();\n\n    fs::remove_file(\u0026db_path)?;                        // simulate corruption\n    ok(marlin().arg(\"restore\").arg(backup_file));      // restore\n\n    // Search must still work afterwards\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    Ok(())\n}\n\n","traces":[{"line":12,"address":[789200],"length":1,"stats":{"Line":1}},{"line":13,"address":[789208],"length":1,"stats":{"Line":1}},{"line":17,"address":[789232],"length":1,"stats":{"Line":1}},{"line":18,"address":[789251],"length":1,"stats":{"Line":1}},{"line":19,"address":[789312],"length":1,"stats":{"Line":1}},{"line":20,"address":[789373],"length":1,"stats":{"Line":1}},{"line":21,"address":[789434],"length":1,"stats":{"Line":1}},{"line":22,"address":[789495],"length":1,"stats":{"Line":1}},{"line":24,"address":[789556],"length":1,"stats":{"Line":1}},{"line":25,"address":[789635],"length":1,"stats":{"Line":1}},{"line":26,"address":[789714],"length":1,"stats":{"Line":1}},{"line":27,"address":[789793],"length":1,"stats":{"Line":1}},{"line":28,"address":[789872],"length":1,"stats":{"Line":1}},{"line":29,"address":[789951],"length":1,"stats":{"Line":1}},{"line":33,"address":[790048],"length":1,"stats":{"Line":1}},{"line":34,"address":[790066],"length":1,"stats":{"Line":1}}],"covered":16,"coverable":16},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","integration","watcher","watcher_test.rs"],"content":"//! Integration test for the file watcher functionality\n//! \n//! Tests various aspects of the file system watcher including:\n//! - Basic event handling (create, modify, delete files)\n//! - Debouncing of events\n//! - Hierarchical event coalescing\n//! - Graceful shutdown and event draining\n\nuse marlin::watcher::{FileWatcher, WatcherConfig, WatcherState};\nuse std::path::{Path, PathBuf};\nuse std::fs::{self, File};\nuse std::io::Write;\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tempfile::tempdir;\n\n// Mock filesystem event simulator inspired by inotify-sim\nstruct MockEventSimulator {\n    temp_dir: PathBuf,\n    files_created: Vec\u003cPathBuf\u003e,\n}\n\nimpl MockEventSimulator {\n    fn new(temp_dir: PathBuf) -\u003e Self {\n        Self {\n            temp_dir,\n            files_created: Vec::new(),\n        }\n    }\n\n    fn create_file(\u0026mut self, relative_path: \u0026str, content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        if let Some(parent) = path.parent() {\n            fs::create_dir_all(parent).expect(\"Failed to create parent directory\");\n        }\n        \n        let mut file = File::create(\u0026path).expect(\"Failed to create file\");\n        file.write_all(content.as_bytes()).expect(\"Failed to write content\");\n        \n        self.files_created.push(path.clone());\n        path\n    }\n    \n    fn modify_file(\u0026self, relative_path: \u0026str, new_content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        let mut file = File::create(\u0026path).expect(\"Failed to update file\");\n        file.write_all(new_content.as_bytes()).expect(\"Failed to write content\");\n        path\n    }\n    \n    fn delete_file(\u0026mut self, relative_path: \u0026str) {\n        let path = self.temp_dir.join(relative_path);\n        fs::remove_file(\u0026path).expect(\"Failed to delete file\");\n        \n        self.files_created.retain(|p| p != \u0026path);\n    }\n    \n    fn create_burst(\u0026mut self, count: usize, prefix: \u0026str) -\u003e Vec\u003cPathBuf\u003e {\n        let mut paths = Vec::with_capacity(count);\n        \n        for i in 0..count {\n            let file_path = format!(\"{}/burst_file_{}.txt\", prefix, i);\n            let path = self.create_file(\u0026file_path, \u0026format!(\"Content {}\", i));\n            paths.push(path);\n            \n            // Small delay to simulate rapid but not instantaneous file creation\n            thread::sleep(Duration::from_micros(10));\n        }\n        \n        paths\n    }\n    \n    fn cleanup(\u0026self) {\n        // No need to do anything as tempdir will clean itself\n    }\n}\n\n#[test]\nfn test_basic_watch_functionality() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Create a test file before starting the watcher\n    let initial_file = simulator.create_file(\"initial.txt\", \"Initial content\");\n    \n    // Configure and start the watcher\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for a short time\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Generate events\n    let file1 = simulator.create_file(\"test1.txt\", \"Hello, world!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    let file2 = simulator.create_file(\"dir1/test2.txt\", \"Hello from subdirectory!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.modify_file(\"test1.txt\", \"Updated content\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.delete_file(\"test1.txt\");\n    \n    // Wait for watcher thread to complete\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Check status after processing events\n    let status = finished_watcher.status();\n    \n    // Assertions\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with larger debounce window for this test\n    let config = WatcherConfig {\n        debounce_ms: 200,  // 200ms debounce window\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to observe debouncing\n        thread::sleep(Duration::from_secs(3));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Rapidly update the same file multiple times within the debounce window\n    let test_file = \"test_debounce.txt\";\n    simulator.create_file(test_file, \"Initial content\");\n    \n    // Update the same file multiple times within debounce window\n    for i in 1..10 {\n        simulator.modify_file(test_file, \u0026format!(\"Update {}\", i));\n        thread::sleep(Duration::from_millis(10)); // Short delay between updates\n    }\n    \n    // Wait for debounce window and processing\n    thread::sleep(Duration::from_millis(500));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // We should have processed fewer events than modifications made\n    // due to debouncing (exact count depends on implementation details)\n    assert!(status.events_processed \u003c 10, \n            \"Expected fewer events processed than modifications due to debouncing\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_event_flood() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure with settings tuned for burst handling\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 500,  // Handle larger batches\n        max_queue_size: 10000,  // Large queue for burst\n        drain_timeout_ms: 5000, // Longer drain time for cleanup\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to process a large burst\n        thread::sleep(Duration::from_secs(10));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create 1000 files in rapid succession (smaller scale for test)\n    let start_time = Instant::now();\n    let created_files = simulator.create_burst(1000, \"flood\");\n    let creation_time = start_time.elapsed();\n    \n    println!(\"Created 1000 files in {:?}\", creation_time);\n    \n    // Wait for processing to complete\n    thread::sleep(Duration::from_secs(5));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // Verify processing occurred\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_hierarchical_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher\n    let config = WatcherConfig {\n        debounce_ms: 200,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create directory structure\n    let nested_dir = \"parent/child/grandchild\";\n    fs::create_dir_all(temp_path.join(nested_dir)).expect(\"Failed to create nested directories\");\n    \n    // Create files in the hierarchy\n    simulator.create_file(\"parent/file1.txt\", \"Content 1\");\n    simulator.create_file(\"parent/child/file2.txt\", \"Content 2\");\n    simulator.create_file(\"parent/child/grandchild/file3.txt\", \"Content 3\");\n    \n    // Wait a bit\n    thread::sleep(Duration::from_millis(300));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_graceful_shutdown() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with specific drain timeout\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 2000, // 2 second drain timeout\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    watcher.start().expect(\"Failed to start watcher\");\n    \n    // Wait for initialization\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create files\n    for i in 0..10 {\n        simulator.create_file(\u0026format!(\"shutdown_test_{}.txt\", i), \"Shutdown test\");\n        thread::sleep(Duration::from_millis(10));\n    }\n    \n    // Immediately request shutdown while events are being processed\n    let shutdown_start = Instant::now();\n    watcher.stop().expect(\"Failed to stop watcher\");\n    let shutdown_duration = shutdown_start.elapsed();\n    \n    // Shutdown should take close to the drain timeout but not excessively longer\n    println!(\"Shutdown took {:?}\", shutdown_duration);\n    assert!(shutdown_duration \u003e= Duration::from_millis(100), \n            \"Shutdown was too quick, may not have drained properly\");\n    assert!(shutdown_duration \u003c= Duration::from_millis(3000), \n            \"Shutdown took too long\");\n    \n    // Verify final state\n    let status = watcher.status();\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert_eq!(status.queue_size, 0, \"Queue should be empty after shutdown\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","neg.rs"],"content":"//! tests neg.rs\n//! Negative-path integration tests (“should fail / warn”).\n\nuse predicates::str;\nuse tempfile::tempdir;\n\nmod util;\nuse util::marlin;\n\n/* ───────────────────────── LINKS ─────────────────────────────── */\n\n#[test]\nfn link_non_indexed_should_fail() {\n    let tmp = tempdir().unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    std::fs::write(tmp.path().join(\"foo.txt\"), \"\").unwrap();\n    std::fs::write(tmp.path().join(\"bar.txt\"), \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .current_dir(tmp.path())\n        .args([\n            \"link\", \"add\",\n            \u0026tmp.path().join(\"foo.txt\").to_string_lossy(),\n            \u0026tmp.path().join(\"bar.txt\").to_string_lossy()\n        ])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"file not indexed\"));\n}\n\n/* ───────────────────────── ATTR ─────────────────────────────── */\n\n#[test]\nfn attr_set_on_non_indexed_file_should_warn() {\n    let tmp = tempdir().unwrap();\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    let ghost = tmp.path().join(\"ghost.txt\");\n    std::fs::write(\u0026ghost, \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .args([\"attr\",\"set\",\n               \u0026ghost.to_string_lossy(),\"foo\",\"bar\"])\n        .assert()\n        .success()                       // exits 0\n        .stderr(str::contains(\"not indexed\"));\n}\n\n/* ───────────────────── COLLECTIONS ───────────────────────────── */\n\n#[test]\nfn coll_add_unknown_collection_should_fail() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"doc.txt\");\n    std::fs::write(\u0026file, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"coll\",\"add\",\"nope\",\u0026file.to_string_lossy()])\n        .assert()\n        .failure();\n}\n\n/* ───────────────────── RESTORE (bad file) ───────────────────── */\n\n#[test]\nfn restore_with_nonexistent_backup_should_fail() {\n    let tmp   = tempdir().unwrap();\n\n    // create an empty DB first\n    marlin(\u0026tmp).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"restore\", \"/definitely/not/here.db\"])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"Failed to restore\"));\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","pos.rs"],"content":"//! tests pos.rs\n//! Positive-path integration checks for every sub-command\n//! that already has real logic behind it.\n\nmod util;\nuse util::marlin;\n\nuse predicates::{prelude::*, str};          // brings `PredicateBooleanExt::and`\nuse std::fs;\nuse tempfile::tempdir;\n\n/* ─────────────────────────── TAG ─────────────────────────────── */\n\n#[test]\nfn tag_should_add_hierarchical_tag_and_search_finds_it() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"foo.md\");\n    fs::write(\u0026file, \"# test\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"tag\", file.to_str().unwrap(), \"project/md\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"search\", \"tag:project/md\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"foo.md\"));\n}\n\n/* ─────────────────────────── ATTR ────────────────────────────── */\n\n#[test]\nfn attr_set_then_ls_roundtrip() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"report.pdf\");\n    fs::write(\u0026file, \"%PDF-1.4\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"set\", file.to_str().unwrap(), \"reviewed\", \"yes\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"ls\", file.to_str().unwrap()])\n        .assert()\n        .success()\n        .stdout(str::contains(\"reviewed = yes\"));\n}\n\n/* ─────────────────────── COLLECTIONS ────────────────────────── */\n\n#[test]\nfn coll_create_add_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let a = tmp.path().join(\"a.txt\");\n    let b = tmp.path().join(\"b.txt\");\n    fs::write(\u0026a, \"\").unwrap();\n    fs::write(\u0026b, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp).args([\"coll\", \"create\", \"Set\"]).assert().success();\n    for f in [\u0026a, \u0026b] {\n        marlin(\u0026tmp).args([\"coll\", \"add\", \"Set\", f.to_str().unwrap()]).assert().success();\n    }\n\n    marlin(\u0026tmp)\n        .args([\"coll\", \"list\", \"Set\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"a.txt\").and(str::contains(\"b.txt\")));\n}\n\n/* ─────────────────────────── VIEWS ───────────────────────────── */\n\n#[test]\nfn view_save_list_and_exec() {\n    let tmp  = tempdir().unwrap();\n\n    let todo = tmp.path().join(\"TODO.txt\");\n    fs::write(\u0026todo, \"remember the milk\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // save \u0026 list\n    marlin(\u0026tmp).args([\"view\", \"save\", \"tasks\", \"milk\"]).assert().success();\n    marlin(\u0026tmp)\n        .args([\"view\", \"list\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"tasks: milk\"));\n\n    // exec\n    marlin(\u0026tmp)\n        .args([\"view\", \"exec\", \"tasks\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"TODO.txt\"));\n}\n\n/* ─────────────────────────── LINKS ───────────────────────────── */\n\n#[test]\nfn link_add_rm_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let foo = tmp.path().join(\"foo.txt\");\n    let bar = tmp.path().join(\"bar.txt\");\n    fs::write(\u0026foo, \"\").unwrap();\n    fs::write(\u0026bar, \"\").unwrap();\n\n    // handy closure\n    let mc = || marlin(\u0026tmp);\n\n    mc().current_dir(tmp.path()).arg(\"init\").assert().success();\n    mc().args([\"scan\", tmp.path().to_str().unwrap()]).assert().success();\n\n    // add\n    mc().args([\"link\", \"add\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list (outgoing default)\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::contains(\"foo.txt\").and(str::contains(\"bar.txt\")));\n\n    // remove\n    mc().args([\"link\", \"rm\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list now empty\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::is_empty());\n}\n\n/* ─────────────────────── SCAN (multi-path) ───────────────────── */\n\n#[test]\nfn scan_with_multiple_paths_indexes_all() {\n    let tmp = tempdir().unwrap();\n\n    let dir_a = tmp.path().join(\"A\");\n    let dir_b = tmp.path().join(\"B\");\n    std::fs::create_dir_all(\u0026dir_a).unwrap();\n    std::fs::create_dir_all(\u0026dir_b).unwrap();\n    let f1 = dir_a.join(\"one.txt\");\n    let f2 = dir_b.join(\"two.txt\");\n    fs::write(\u0026f1, \"\").unwrap();\n    fs::write(\u0026f2, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // multi-path scan\n    marlin(\u0026tmp)\n        .args([\"scan\", dir_a.to_str().unwrap(), dir_b.to_str().unwrap()])\n        .assert().success();\n\n    // both files findable\n    for term in [\"one.txt\", \"two.txt\"] {\n        marlin(\u0026tmp).args([\"search\", term])\n            .assert()\n            .success()\n            .stdout(str::contains(term));\n    }\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","util.rs"],"content":"//! tests/util.rs\n//! Small helpers shared across integration tests.\n\nuse std::path::{Path, PathBuf};\nuse tempfile::TempDir;\nuse assert_cmd::Command; \n/// Absolute path to the freshly-built `marlin` binary.\npub fn bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Build a `Command` for `marlin` whose `MARLIN_DB_PATH` is\n/// `\u003ctmp\u003e/index.db`.\n///\n/// Each call yields a brand-new `Command`, so callers can freely add\n/// arguments, change the working directory, etc., without affecting\n/// other invocations.\npub fn marlin(tmp: \u0026TempDir) -\u003e Command {\n    let db_path: \u0026Path = \u0026tmp.path().join(\"index.db\");\n    let mut cmd = Command::new(bin());\n    cmd.env(\"MARLIN_DB_PATH\", db_path);\n    cmd\n}\n","traces":[{"line":8,"address":[776352],"length":1,"stats":{"Line":10}},{"line":9,"address":[776360],"length":1,"stats":{"Line":10}},{"line":18,"address":[776727,776384,776721],"length":1,"stats":{"Line":10}},{"line":19,"address":[776422,776535],"length":1,"stats":{"Line":20}},{"line":20,"address":[776575],"length":1,"stats":{"Line":10}},{"line":21,"address":[776612],"length":1,"stats":{"Line":10}},{"line":22,"address":[776682],"length":1,"stats":{"Line":10}}],"covered":7,"coverable":7},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","backup.rs"],"content":"// libmarlin/src/backup.rs\n\nuse anyhow::{anyhow, Context, Result};\nuse chrono::{DateTime, Local, NaiveDateTime, Utc, TimeZone};\nuse rusqlite;\nuse std::fs;\nuse std::path::{Path, PathBuf};\nuse std::time::Duration;\n\nuse crate::error as marlin_error;\n\n#[derive(Debug, Clone)]\npub struct BackupInfo {\n    pub id: String,\n    pub timestamp: DateTime\u003cUtc\u003e,\n    pub size_bytes: u64,\n    pub hash: Option\u003cString\u003e,\n}\n\n#[derive(Debug)]\npub struct PruneResult {\n    pub kept: Vec\u003cBackupInfo\u003e,\n    pub removed: Vec\u003cBackupInfo\u003e,\n}\n\n// FIX 2: Add derive(Debug) here\n#[derive(Debug)]\npub struct BackupManager {\n    live_db_path: PathBuf,\n    backups_dir: PathBuf,\n}\n\nimpl BackupManager {\n    pub fn new\u003cP1: AsRef\u003cPath\u003e, P2: AsRef\u003cPath\u003e\u003e(live_db_path: P1, backups_dir: P2) -\u003e Result\u003cSelf\u003e {\n        let backups_dir_path = backups_dir.as_ref().to_path_buf();\n        if !backups_dir_path.exists() {\n            fs::create_dir_all(\u0026backups_dir_path).with_context(|| {\n                format!(\n                    \"Failed to create backup directory at {}\",\n                    backups_dir_path.display()\n                )\n            })?;\n        } else if !backups_dir_path.is_dir() {\n            return Err(anyhow!(\"Backups path exists but is not a directory: {}\", backups_dir_path.display()));\n        }\n        Ok(Self {\n            live_db_path: live_db_path.as_ref().to_path_buf(),\n            backups_dir: backups_dir_path,\n        })\n    }\n\n    pub fn create_backup(\u0026self) -\u003e Result\u003cBackupInfo\u003e {\n        let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S_%f\");\n        let backup_file_name = format!(\"backup_{stamp}.db\");\n        let backup_file_path = self.backups_dir.join(\u0026backup_file_name);\n\n        if !self.live_db_path.exists() {\n             return Err(anyhow::Error::new(std::io::Error::new(\n                std::io::ErrorKind::NotFound,\n                format!(\"Live DB path does not exist: {}\", self.live_db_path.display()),\n            )).context(\"Cannot create backup from non-existent live DB\"));\n        }\n\n        let src_conn = rusqlite::Connection::open_with_flags(\n            \u0026self.live_db_path,\n            rusqlite::OpenFlags::SQLITE_OPEN_READ_ONLY,\n        )\n        .with_context(|| {\n            format!(\n                \"Failed to open source DB ('{}') for backup\",\n                self.live_db_path.display()\n            )\n        })?;\n\n        let mut dst_conn = rusqlite::Connection::open(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to open destination backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        let backup_op =\n            rusqlite::backup::Backup::new(\u0026src_conn, \u0026mut dst_conn).with_context(|| {\n                format!(\n                    \"Failed to initialize backup from {} to {}\",\n                    self.live_db_path.display(),\n                    backup_file_path.display()\n                )\n            })?;\n\n        backup_op\n            .run_to_completion(100, Duration::from_millis(250), None)\n            .map_err(|e| anyhow::Error::new(e).context(\"SQLite backup operation failed\"))?;\n\n        let metadata = fs::metadata(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to get metadata for backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        Ok(BackupInfo {\n            id: backup_file_name,\n            timestamp: DateTime::from(metadata.modified()?),\n            size_bytes: metadata.len(),\n            hash: None,\n        })\n    }\n\n    pub fn list_backups(\u0026self) -\u003e Result\u003cVec\u003cBackupInfo\u003e\u003e {\n        let mut backup_infos = Vec::new();\n        \n        if !self.backups_dir.exists() { \n            return Ok(backup_infos);\n        }\n\n        for entry_result in fs::read_dir(\u0026self.backups_dir).with_context(|| {\n            format!(\n                \"Failed to read backup directory: {}\",\n                self.backups_dir.display()\n            )\n        })? {\n            let entry = entry_result?;\n            let path = entry.path();\n\n            if path.is_file() {\n                if let Some(filename_osstr) = path.file_name() {\n                    if let Some(filename) = filename_osstr.to_str() {\n                        if filename.starts_with(\"backup_\") \u0026\u0026 filename.ends_with(\".db\") {\n                            let ts_str = filename\n                                .trim_start_matches(\"backup_\")\n                                .trim_end_matches(\".db\");\n                            \n                            let naive_dt = match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S_%f\") {\n                                Ok(dt) =\u003e dt,\n                                Err(_) =\u003e match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S\") {\n                                    Ok(dt) =\u003e dt,\n                                    Err(_) =\u003e { \n                                        let metadata = fs::metadata(\u0026path).with_context(|| format!(\"Failed to get metadata for {}\", path.display()))?;\n                                        DateTime::\u003cUtc\u003e::from(metadata.modified()?).naive_utc()\n                                    }\n                                }\n                            };\n                            \n                            let local_dt_result = Local.from_local_datetime(\u0026naive_dt);\n                            let local_dt = match local_dt_result {\n                                chrono::LocalResult::Single(dt) =\u003e dt,\n                                chrono::LocalResult::Ambiguous(dt1, _dt2) =\u003e {\n                                    eprintln!(\"Warning: Ambiguous local time for backup {}, taking first interpretation.\", filename);\n                                    dt1\n                                },\n                                chrono::LocalResult::None =\u003e {\n                                    eprintln!(\"Warning: Invalid local time for backup {}, skipping.\", filename);\n                                    continue; \n                                }\n                            };\n                            let timestamp_utc = DateTime::\u003cUtc\u003e::from(local_dt);\n\n                            let metadata = fs::metadata(\u0026path)?;\n                            backup_infos.push(BackupInfo {\n                                id: filename.to_string(),\n                                timestamp: timestamp_utc,\n                                size_bytes: metadata.len(),\n                                hash: None,\n                            });\n                        }\n                    }\n                }\n            }\n        }\n        backup_infos.sort_by_key(|b| std::cmp::Reverse(b.timestamp));\n        Ok(backup_infos)\n    }\n\n    pub fn prune(\u0026self, keep_count: usize) -\u003e Result\u003cPruneResult\u003e {\n        let all_backups = self.list_backups()?; \n\n        let mut kept = Vec::new();\n        let mut removed = Vec::new();\n\n        if keep_count \u003e= all_backups.len() { \n            kept = all_backups;\n        } else {\n            for (index, backup_info) in all_backups.into_iter().enumerate() {\n                if index \u003c keep_count {\n                    kept.push(backup_info);\n                } else {\n                    let backup_file_path = self.backups_dir.join(\u0026backup_info.id);\n                    if backup_file_path.exists() { \n                        fs::remove_file(\u0026backup_file_path).with_context(|| {\n                            format!(\n                                \"Failed to remove old backup file: {}\",\n                                backup_file_path.display()\n                            )\n                        })?;\n                    }\n                    removed.push(backup_info);\n                }\n            }\n        }\n        Ok(PruneResult { kept, removed })\n    }\n\n    pub fn restore_from_backup(\u0026self, backup_id: \u0026str) -\u003e Result\u003c()\u003e {\n        let backup_file_path = self.backups_dir.join(backup_id);\n        if !backup_file_path.exists() || !backup_file_path.is_file() {\n            return Err(anyhow::Error::new(marlin_error::Error::NotFound(format!(\n                \"Backup file not found or is not a file: {}\",\n                backup_file_path.display()\n            ))));\n        }\n\n        fs::copy(\u0026backup_file_path, \u0026self.live_db_path).with_context(|| {\n            format!(\n                \"Failed to copy backup {} to live DB {}\",\n                backup_file_path.display(),\n                self.live_db_path.display()\n            )\n        })?;\n        Ok(())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use tempfile::tempdir;\n    use crate::db::open as open_marlin_db;\n    // FIX 1: Remove unused import std::io::ErrorKind\n    // use std::io::ErrorKind; \n\n    fn create_valid_live_db(path: \u0026Path) -\u003e rusqlite::Connection {\n        let conn = open_marlin_db(path)\n            .unwrap_or_else(|e| panic!(\"Failed to open/create test DB at {}: {:?}\", path.display(), e));\n        conn.execute_batch(\n            \"CREATE TABLE IF NOT EXISTS test_table (id INTEGER PRIMARY KEY, data TEXT);\n             INSERT INTO test_table (data) VALUES ('initial_data');\"\n        ).expect(\"Failed to initialize test table\");\n        conn\n    }\n\n    #[test]\n    fn test_backup_manager_new_creates_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_new_creates.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_new_creates_test\");\n\n        assert!(!backups_dir.exists());\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        assert!(manager.backups_dir.exists()); \n        assert!(backups_dir.exists());\n    }\n\n    #[test]\n    fn test_backup_manager_new_with_existing_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_existing_dir.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_existing_test\");\n        std::fs::create_dir_all(\u0026backups_dir).unwrap(); \n\n        assert!(backups_dir.exists());\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026backups_dir);\n        assert!(manager_res.is_ok());\n        let manager = manager_res.unwrap();\n        assert_eq!(manager.backups_dir, backups_dir);\n    }\n    \n    #[test]\n    fn test_backup_manager_new_fails_if_backup_path_is_file() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_backup_path_is_file.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n        let file_as_backups_dir = base_tmp.path().join(\"file_as_backups_dir\");\n        std::fs::write(\u0026file_as_backups_dir, \"i am a file\").unwrap();\n\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026file_as_backups_dir);\n        assert!(manager_res.is_err());\n        assert!(manager_res.unwrap_err().to_string().contains(\"Backups path exists but is not a directory\"));\n    }\n\n    #[test]\n    fn test_create_backup_failure_non_existent_live_db() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"non_existent_live.db\"); \n        let backups_dir = base_tmp.path().join(\"backups_fail_test\");\n\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        let backup_result = manager.create_backup();\n        assert!(backup_result.is_err());\n        let err_str = backup_result.unwrap_err().to_string();\n        assert!(err_str.contains(\"Cannot create backup from non-existent live DB\") || err_str.contains(\"Failed to open source DB\"));\n    }\n\n    #[test]\n    fn test_create_list_prune_backups() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_clp_test.db\");\n        let _conn_live = create_valid_live_db(\u0026live_db_file);\n\n        let backups_storage_dir = tmp.path().join(\"backups_clp_storage_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_storage_dir).unwrap();\n\n        let initial_list = manager.list_backups().unwrap();\n        assert!(initial_list.is_empty(), \"Backup list should be empty initially\");\n\n        let prune_empty_result = manager.prune(2).unwrap();\n        assert!(prune_empty_result.kept.is_empty());\n        assert!(prune_empty_result.removed.is_empty());\n\n        let mut created_backup_ids = Vec::new();\n        for i in 0..5 {\n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone()); \n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(listed_backups.len(), 5);\n        for id in \u0026created_backup_ids {\n            assert!(\n                listed_backups.iter().any(|b| \u0026b.id == id),\n                \"Backup ID {} not found in list\", id\n            );\n        }\n        if listed_backups.len() \u003e= 2 {\n            assert!(listed_backups[0].timestamp \u003e= listed_backups[1].timestamp);\n        }\n\n        let prune_to_zero_result = manager.prune(0).unwrap();\n        assert_eq!(prune_to_zero_result.kept.len(), 0);\n        assert_eq!(prune_to_zero_result.removed.len(), 5);\n        let listed_after_prune_zero = manager.list_backups().unwrap();\n        assert!(listed_after_prune_zero.is_empty());\n\n        created_backup_ids.clear();\n        for i in 0..5 { \n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone());\n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let prune_keep_more_result = manager.prune(10).unwrap();\n        assert_eq!(prune_keep_more_result.kept.len(), 5);\n        assert_eq!(prune_keep_more_result.removed.len(), 0);\n        let listed_after_prune_more = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune_more.len(), 5);\n\n        let prune_result = manager.prune(2).unwrap();\n        assert_eq!(prune_result.kept.len(), 2);\n        assert_eq!(prune_result.removed.len(), 3);\n\n        let listed_after_prune = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune.len(), 2);\n\n        assert_eq!(listed_after_prune[0].id, created_backup_ids[4]);\n        assert_eq!(listed_after_prune[1].id, created_backup_ids[3]);\n        \n        for removed_info in prune_result.removed {\n            assert!(\n                !backups_storage_dir.join(\u0026removed_info.id).exists(),\n                \"Removed backup file {} should not exist\", removed_info.id\n            );\n        }\n        for kept_info in prune_result.kept {\n            assert!(\n                backups_storage_dir.join(\u0026kept_info.id).exists(),\n                \"Kept backup file {} should exist\", kept_info.id\n            );\n        }\n    }\n\n     #[test]\n    fn test_restore_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_test.db\");\n        \n        let initial_value = \"initial_data_for_restore\";\n        {\n            // FIX 3: Remove `mut` from conn here\n            let conn = create_valid_live_db(\u0026live_db_path);\n            conn.execute(\"DELETE FROM test_table\", []).unwrap(); \n            conn.execute(\"INSERT INTO test_table (data) VALUES (?1)\", [initial_value]).unwrap();\n        }\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_test_dir\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let backup_info = manager.create_backup().unwrap();\n\n        let modified_value = \"modified_data_for_restore\";\n        {\n            // FIX 3: Remove `mut` from conn here\n            let conn = rusqlite::Connection::open(\u0026live_db_path) \n                .expect(\"Failed to open live DB for modification\");\n            conn.execute(\"UPDATE test_table SET data = ?1\", [modified_value])\n                .expect(\"Failed to update data\");\n            let modified_check: String = conn\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(modified_check, modified_value);\n        }\n        \n        manager.restore_from_backup(\u0026backup_info.id).unwrap();\n\n        {\n            let conn_after_restore = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB after restore\");\n            let restored_data: String = conn_after_restore\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(restored_data, initial_value);\n        }\n    }\n\n    #[test]\n    fn test_restore_non_existent_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_fail_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_fail_test\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let result = manager.restore_from_backup(\"non_existent_backup.db\");\n        assert!(result.is_err());\n        let err_string = result.unwrap_err().to_string();\n        assert!(err_string.contains(\"Backup file not found\"), \"Error string was: {}\", err_string);\n    }\n\n    #[test]\n    fn list_backups_with_non_backup_files() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        let backups_dir = tmp.path().join(\"backups_list_mixed_files_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_dir).unwrap();\n\n        manager.create_backup().unwrap(); \n        \n        std::fs::write(backups_dir.join(\"not_a_backup.txt\"), \"hello\").unwrap();\n        std::fs::write(\n            backups_dir.join(\"backup_malformed.db.tmp\"),\n            \"temp data\",\n        )\n        .unwrap();\n        std::fs::create_dir(backups_dir.join(\"a_subdir\")).unwrap();\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(\n            listed_backups.len(),\n            1,\n            \"Should only list the valid backup file\"\n        );\n        assert!(listed_backups[0].id.starts_with(\"backup_\"));\n        assert!(listed_backups[0].id.ends_with(\".db\"));\n    }\n\n     #[test]\n    fn list_backups_handles_io_error_on_read_dir() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_io_error.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        \n        let backups_dir_for_deletion = tmp.path().join(\"backups_dir_to_delete_test\");\n        let manager_for_deletion = BackupManager::new(\u0026live_db_file, \u0026backups_dir_for_deletion).unwrap();\n        std::fs::remove_dir_all(\u0026backups_dir_for_deletion).unwrap(); \n\n        let list_res = manager_for_deletion.list_backups().unwrap();\n        assert!(list_res.is_empty());\n    }\n}","traces":[{"line":34,"address":[1939536,1940524,1940518],"length":1,"stats":{"Line":1}},{"line":35,"address":[],"length":0,"stats":{"Line":2}},{"line":36,"address":[],"length":0,"stats":{"Line":2}},{"line":37,"address":[1939830,1940544,1939927,1939777,1939973],"length":1,"stats":{"Line":2}},{"line":38,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":43,"address":[],"length":0,"stats":{"Line":4}},{"line":44,"address":[],"length":0,"stats":{"Line":1}},{"line":46,"address":[1940399],"length":1,"stats":{"Line":1}},{"line":47,"address":[1940324,1939941],"length":1,"stats":{"Line":2}},{"line":48,"address":[],"length":0,"stats":{"Line":1}},{"line":52,"address":[1715148,1715154,1711872],"length":1,"stats":{"Line":1}},{"line":53,"address":[1711911],"length":1,"stats":{"Line":1}},{"line":54,"address":[1712001,1712048],"length":1,"stats":{"Line":2}},{"line":55,"address":[1712248,1712164],"length":1,"stats":{"Line":2}},{"line":57,"address":[5530186,5530103],"length":1,"stats":{"Line":2}},{"line":58,"address":[5530494],"length":1,"stats":{"Line":1}},{"line":59,"address":[1712401],"length":1,"stats":{"Line":1}},{"line":60,"address":[1712409,1712500],"length":1,"stats":{"Line":2}},{"line":68,"address":[1940720],"length":1,"stats":{"Line":0}},{"line":69,"address":[1940779],"length":1,"stats":{"Line":0}},{"line":71,"address":[5443926],"length":1,"stats":{"Line":0}},{"line":75,"address":[5531016,5531116,5530945,5533143],"length":1,"stats":{"Line":2}},{"line":76,"address":[1940955],"length":1,"stats":{"Line":0}},{"line":78,"address":[1940918],"length":1,"stats":{"Line":0}},{"line":82,"address":[5444256],"length":1,"stats":{"Line":2}},{"line":84,"address":[1941194,1941135],"length":1,"stats":{"Line":0}},{"line":86,"address":[1941098],"length":1,"stats":{"Line":0}},{"line":87,"address":[5444341],"length":1,"stats":{"Line":0}},{"line":91,"address":[5531685,5531838,5533098],"length":1,"stats":{"Line":2}},{"line":92,"address":[5531673,5531603],"length":1,"stats":{"Line":4}},{"line":93,"address":[1713942],"length":1,"stats":{"Line":0}},{"line":95,"address":[1713975,1715167,1714108],"length":1,"stats":{"Line":1}},{"line":96,"address":[5444619],"length":1,"stats":{"Line":0}},{"line":98,"address":[5444582],"length":1,"stats":{"Line":0}},{"line":102,"address":[1714546],"length":1,"stats":{"Line":1}},{"line":103,"address":[1714205],"length":1,"stats":{"Line":1}},{"line":104,"address":[1714324,1714245],"length":1,"stats":{"Line":2}},{"line":105,"address":[5532407],"length":1,"stats":{"Line":1}},{"line":106,"address":[1714538],"length":1,"stats":{"Line":1}},{"line":110,"address":[1718888,1715312,1718643],"length":1,"stats":{"Line":2}},{"line":111,"address":[1715351],"length":1,"stats":{"Line":2}},{"line":113,"address":[1715471,1715388],"length":1,"stats":{"Line":3}},{"line":114,"address":[1715506],"length":1,"stats":{"Line":1}},{"line":117,"address":[5444736],"length":1,"stats":{"Line":3}},{"line":118,"address":[1941615],"length":1,"stats":{"Line":0}},{"line":120,"address":[1941574],"length":1,"stats":{"Line":0}},{"line":123,"address":[1718853,1716004,1716210],"length":1,"stats":{"Line":2}},{"line":124,"address":[1716378],"length":1,"stats":{"Line":1}},{"line":126,"address":[1716457,1716537],"length":1,"stats":{"Line":2}},{"line":127,"address":[1716598],"length":1,"stats":{"Line":1}},{"line":128,"address":[1716763],"length":1,"stats":{"Line":1}},{"line":129,"address":[1716885],"length":1,"stats":{"Line":1}},{"line":130,"address":[1717009],"length":1,"stats":{"Line":1}},{"line":134,"address":[5535107],"length":1,"stats":{"Line":1}},{"line":135,"address":[5535208],"length":1,"stats":{"Line":1}},{"line":136,"address":[1717208,1717335],"length":1,"stats":{"Line":0}},{"line":137,"address":[1717389],"length":1,"stats":{"Line":0}},{"line":139,"address":[5444934,5444912],"length":1,"stats":{"Line":0}},{"line":140,"address":[1717657,1718780],"length":1,"stats":{"Line":0}},{"line":145,"address":[5535268],"length":1,"stats":{"Line":1}},{"line":146,"address":[5535839],"length":1,"stats":{"Line":1}},{"line":147,"address":[1717887],"length":1,"stats":{"Line":1}},{"line":148,"address":[1717953],"length":1,"stats":{"Line":0}},{"line":149,"address":[5536073,5535973],"length":1,"stats":{"Line":0}},{"line":150,"address":[1718154],"length":1,"stats":{"Line":0}},{"line":153,"address":[1718670,1718012],"length":1,"stats":{"Line":0}},{"line":157,"address":[5536030],"length":1,"stats":{"Line":1}},{"line":159,"address":[1718191,1718649],"length":1,"stats":{"Line":1}},{"line":160,"address":[1718506],"length":1,"stats":{"Line":1}},{"line":161,"address":[1718384],"length":1,"stats":{"Line":1}},{"line":163,"address":[1718427],"length":1,"stats":{"Line":1}},{"line":164,"address":[1718498],"length":1,"stats":{"Line":1}},{"line":171,"address":[1716041],"length":1,"stats":{"Line":3}},{"line":172,"address":[1716095],"length":1,"stats":{"Line":1}},{"line":175,"address":[1718912,1720660,1720827],"length":1,"stats":{"Line":1}},{"line":176,"address":[1718955],"length":1,"stats":{"Line":1}},{"line":178,"address":[1719157],"length":1,"stats":{"Line":1}},{"line":179,"address":[5537212],"length":1,"stats":{"Line":1}},{"line":181,"address":[5537272,5538907,5537344],"length":1,"stats":{"Line":3}},{"line":182,"address":[1720686,1719386],"length":1,"stats":{"Line":1}},{"line":184,"address":[1720555,1719326,1719576,1719457],"length":1,"stats":{"Line":4}},{"line":185,"address":[1719682],"length":1,"stats":{"Line":1}},{"line":186,"address":[1720666,1719968],"length":1,"stats":{"Line":2}},{"line":188,"address":[1720140,1719944],"length":1,"stats":{"Line":2}},{"line":189,"address":[1720243,1720175],"length":1,"stats":{"Line":2}},{"line":190,"address":[1941952],"length":1,"stats":{"Line":1}},{"line":191,"address":[1942011],"length":1,"stats":{"Line":0}},{"line":193,"address":[1941974],"length":1,"stats":{"Line":0}},{"line":197,"address":[5538319],"length":1,"stats":{"Line":1}},{"line":201,"address":[1719716],"length":1,"stats":{"Line":1}},{"line":204,"address":[1720864,1721712,1721706],"length":1,"stats":{"Line":1}},{"line":205,"address":[1720919],"length":1,"stats":{"Line":1}},{"line":206,"address":[1721063,1721117,1720980],"length":1,"stats":{"Line":3}},{"line":207,"address":[1721258],"length":1,"stats":{"Line":1}},{"line":209,"address":[5539188,5539315],"length":1,"stats":{"Line":2}},{"line":213,"address":[1721185,1721613,1721693,1721513],"length":1,"stats":{"Line":2}},{"line":214,"address":[1942191,1942250],"length":1,"stats":{"Line":0}},{"line":216,"address":[1942154],"length":1,"stats":{"Line":0}},{"line":217,"address":[1942213],"length":1,"stats":{"Line":0}},{"line":220,"address":[1721647],"length":1,"stats":{"Line":1}}],"covered":73,"coverable":102},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config.rs"],"content":"use anyhow::Result;\nuse directories::ProjectDirs;\nuse std::{\n    collections::hash_map::DefaultHasher,\n    hash::{Hash, Hasher},\n    path::{Path, PathBuf},\n};\n\n/// Runtime configuration (currently just the DB path).\n#[derive(Debug, Clone)]\npub struct Config {\n    pub db_path: PathBuf,\n}\n\nimpl Config {\n    /// Resolve configuration from environment or derive one per-workspace.\n    ///\n    /// Priority:\n    /// 1. `MARLIN_DB_PATH` env-var (explicit override)\n    /// 2. *Workspace-local* file under XDG data dir\n    ///    (`~/.local/share/marlin/index_\u003chash\u003e.db`)\n    /// 3. Fallback to   `./index.db`  when we cannot locate an XDG dir\n    pub fn load() -\u003e Result\u003cSelf\u003e {\n        // 1) explicit override\n        if let Some(val) = std::env::var_os(\"MARLIN_DB_PATH\") {\n            let p = PathBuf::from(val);\n            std::fs::create_dir_all(p.parent().expect(\"has parent\"))?;\n            return Ok(Self { db_path: p });\n        }\n\n        // 2) derive per-workspace DB name from CWD hash\n        let cwd = std::env::current_dir()?;\n        let mut h = DefaultHasher::new();\n        cwd.hash(\u0026mut h);\n        let digest = h.finish(); // 64-bit\n        let file_name = format!(\"index_{digest:016x}.db\");\n\n        if let Some(dirs) = ProjectDirs::from(\"io\", \"Marlin\", \"marlin\") {\n            let dir = dirs.data_dir();\n            std::fs::create_dir_all(dir)?;\n            return Ok(Self {\n                db_path: dir.join(file_name),\n            });\n        }\n\n        // 3) very last resort – workspace-relative DB\n        Ok(Self {\n            db_path: Path::new(\u0026file_name).to_path_buf(),\n        })\n    }\n}\n","traces":[{"line":23,"address":[5516623,5515840,5516629],"length":1,"stats":{"Line":1}},{"line":25,"address":[2078215],"length":1,"stats":{"Line":1}},{"line":26,"address":[2078350],"length":1,"stats":{"Line":2}},{"line":27,"address":[2078919,2078553,2078371],"length":1,"stats":{"Line":4}},{"line":28,"address":[2078768],"length":1,"stats":{"Line":2}},{"line":32,"address":[2078411,2078990],"length":1,"stats":{"Line":1}},{"line":33,"address":[2079092],"length":1,"stats":{"Line":1}},{"line":34,"address":[2079143],"length":1,"stats":{"Line":1}},{"line":35,"address":[2079178],"length":1,"stats":{"Line":1}},{"line":36,"address":[2079203],"length":1,"stats":{"Line":1}},{"line":38,"address":[2079590,2079488],"length":1,"stats":{"Line":2}},{"line":39,"address":[2079667,2079760],"length":1,"stats":{"Line":2}},{"line":40,"address":[2080093,2079792],"length":1,"stats":{"Line":1}},{"line":41,"address":[2079991],"length":1,"stats":{"Line":1}},{"line":42,"address":[2079920],"length":1,"stats":{"Line":1}},{"line":47,"address":[2080213],"length":1,"stats":{"Line":0}},{"line":48,"address":[2080159],"length":1,"stats":{"Line":0}}],"covered":15,"coverable":17},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config_tests.rs"],"content":"// libmarlin/src/config_tests.rs\n\nuse super::config::Config;\nuse std::env;\nuse tempfile::tempdir;\n\n#[test]\nfn load_env_override() {\n    let tmp = tempdir().unwrap();\n    let db = tmp.path().join(\"custom.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db);\n    let cfg = Config::load().unwrap();\n    assert_eq!(cfg.db_path, db);\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn load_xdg_or_fallback() {\n    // since XDG_DATA_HOME will normally be present, just test it doesn't error\n    let cfg = Config::load().unwrap();\n    assert!(cfg.db_path.to_string_lossy().ends_with(\".db\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","database.rs"],"content":"//! Database abstraction for Marlin\n//! \n//! This module provides a database abstraction layer that wraps the SQLite connection\n//! and provides methods for common database operations.\n\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse anyhow::Result;\n\n/// Options for indexing files\n#[derive(Debug, Clone)]\npub struct IndexOptions {\n    /// Only update files marked as dirty\n    pub dirty_only: bool,\n    \n    /// Index file contents (not just metadata)\n    pub index_contents: bool,\n    \n    /// Maximum file size to index (in bytes)\n    pub max_size: Option\u003cu64\u003e,\n}\n\nimpl Default for IndexOptions {\n    fn default() -\u003e Self {\n        Self {\n            dirty_only: false,\n            index_contents: true,\n            max_size: Some(1_000_000), // 1MB default limit\n        }\n    }\n}\n\n/// Database wrapper for Marlin\npub struct Database {\n    /// The SQLite connection\n    conn: Connection,\n}\n\nimpl Database {\n    /// Create a new database wrapper around an existing connection\n    pub fn new(conn: Connection) -\u003e Self {\n        Self { conn }\n    }\n    \n    /// Get a reference to the underlying connection\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n    \n    /// Get a mutable reference to the underlying connection\n    pub fn conn_mut(\u0026mut self) -\u003e \u0026mut Connection {\n        \u0026mut self.conn\n    }\n    \n    /// Index one or more files\n    pub fn index_files(\u0026mut self, paths: \u0026[PathBuf], _options: \u0026IndexOptions) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would index the files\n        // For now, we just return the number of files \"indexed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n    \n    /// Remove files from the index\n    pub fn remove_files(\u0026mut self, paths: \u0026[PathBuf]) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would remove the files\n        // For now, we just return the number of files \"removed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n    use tempfile::tempdir;\n    use std::fs::File;\n\n    fn setup_db() -\u003e Database {\n        let conn = open_marlin_db(\":memory:\").expect(\"Failed to open in-memory DB\");\n        Database::new(conn)\n    }\n\n    #[test]\n    fn test_database_new_conn_conn_mut() {\n        let mut db = setup_db();\n        let _conn_ref = db.conn();\n        let _conn_mut_ref = db.conn_mut();\n        // Just checking they don't panic and can be called.\n    }\n\n    #[test]\n    fn test_index_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap();\n\n        let paths = vec![file1.to_path_buf()];\n        let options = IndexOptions::default();\n        \n        assert_eq!(db.index_files(\u0026paths, \u0026options).unwrap(), 1);\n        assert_eq!(db.index_files(\u0026[], \u0026options).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_remove_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap(); // File doesn't need to be in DB for this stub\n\n        let paths = vec![file1.to_path_buf()];\n        \n        assert_eq!(db.remove_files(\u0026paths).unwrap(), 1);\n        assert_eq!(db.remove_files(\u0026[]).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_index_options_default() {\n        let options = IndexOptions::default();\n        assert!(!options.dirty_only);\n        assert!(options.index_contents);\n        assert_eq!(options.max_size, Some(1_000_000));\n    }\n}\n","traces":[{"line":24,"address":[5509984],"length":1,"stats":{"Line":1}},{"line":28,"address":[2083427],"length":1,"stats":{"Line":1}},{"line":41,"address":[2083472],"length":1,"stats":{"Line":3}},{"line":46,"address":[2083504],"length":1,"stats":{"Line":1}},{"line":51,"address":[2083520],"length":1,"stats":{"Line":1}},{"line":56,"address":[2083536],"length":1,"stats":{"Line":1}},{"line":59,"address":[2083589],"length":1,"stats":{"Line":1}},{"line":60,"address":[2083619],"length":1,"stats":{"Line":1}},{"line":62,"address":[2083603],"length":1,"stats":{"Line":1}},{"line":66,"address":[2083664],"length":1,"stats":{"Line":1}},{"line":69,"address":[2083714],"length":1,"stats":{"Line":1}},{"line":70,"address":[2083744],"length":1,"stats":{"Line":1}},{"line":72,"address":[2083728],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":13},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","mod.rs"],"content":"//! Central DB helper – connection bootstrap, migrations **and** most\n//! data-access helpers (tags, links, collections, saved views, …).\n\nmod database;\npub use database::{Database, IndexOptions};\n\nuse std::{\n    fs,\n    path::{Path, PathBuf},\n};\n\nuse std::result::Result as StdResult;\nuse anyhow::{Context, Result};\nuse chrono::Local;\nuse rusqlite::{\n    backup::{Backup, StepResult},\n    params,\n    Connection,\n    OpenFlags,\n    OptionalExtension,\n    TransactionBehavior,\n};\nuse tracing::{debug, info, warn};\n\n/* ─── embedded migrations ─────────────────────────────────────────── */\n\nconst MIGRATIONS: \u0026[(\u0026str, \u0026str)] = \u0026[\n    (\"0001_initial_schema.sql\", include_str!(\"migrations/0001_initial_schema.sql\")),\n    (\"0002_update_fts_and_triggers.sql\", include_str!(\"migrations/0002_update_fts_and_triggers.sql\")),\n    (\"0003_create_links_collections_views.sql\", include_str!(\"migrations/0003_create_links_collections_views.sql\")),\n    (\"0004_fix_hierarchical_tags_fts.sql\", include_str!(\"migrations/0004_fix_hierarchical_tags_fts.sql\")),\n    (\"0005_add_dirty_table.sql\", include_str!(\"migrations/0005_add_dirty_table.sql\")),\n];\n\n/* ─── connection bootstrap ────────────────────────────────────────── */\n\npub fn open\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cConnection\u003e {\n    let db_path_ref = db_path.as_ref();\n    let mut conn = Connection::open(db_path_ref)\n        .with_context(|| format!(\"failed to open DB at {}\", db_path_ref.display()))?;\n\n    conn.pragma_update(None, \"journal_mode\", \"WAL\")?;\n    conn.pragma_update(None, \"foreign_keys\", \"ON\")?;\n\n    // Wait up to 30 s for a competing writer before giving up\n    conn.busy_timeout(std::time::Duration::from_secs(30))?;\n\n    apply_migrations(\u0026mut conn)?;\n    Ok(conn)\n}\n\n/* ─── migration runner ────────────────────────────────────────────── */\n\npub(crate) fn apply_migrations(conn: \u0026mut Connection) -\u003e Result\u003c()\u003e {\n    // Ensure schema_version bookkeeping table exists\n    conn.execute_batch(\n        \"CREATE TABLE IF NOT EXISTS schema_version (\n             version     INTEGER PRIMARY KEY,\n             applied_on  TEXT NOT NULL\n         );\",\n    )?;\n\n    // Legacy patch – ignore errors if column already exists\n    let _ = conn.execute(\"ALTER TABLE schema_version ADD COLUMN applied_on TEXT\", []);\n\n    // Grab the write-lock up-front so migrations can run uninterrupted\n    let tx = conn.transaction_with_behavior(TransactionBehavior::Immediate)?;\n\n    for (fname, sql) in MIGRATIONS {\n        let version: i64 = fname\n            .split('_')\n            .next()\n            .and_then(|s| s.parse().ok())\n            .expect(\"migration filenames start with number\");\n\n        let already: Option\u003ci64\u003e = tx\n            .query_row(\n                \"SELECT version FROM schema_version WHERE version = ?1\",\n                [version],\n                |r| r.get(0),\n            )\n            .optional()?;\n\n        if already.is_some() {\n            debug!(\"migration {} already applied\", fname);\n            continue;\n        }\n\n        info!(\"applying migration {}\", fname);\n        tx.execute_batch(sql)\n            .with_context(|| format!(\"could not apply migration {}\", fname))?;\n\n        tx.execute(\n            \"INSERT INTO schema_version (version, applied_on) VALUES (?1, ?2)\",\n            params![version, Local::now().to_rfc3339()],\n        )?;\n    }\n\n    tx.commit()?;\n\n    // sanity – warn if any embedded migration got skipped\n    let mut missing = Vec::new();\n    for (fname, _) in MIGRATIONS {\n        let v: i64 = fname.split('_').next().unwrap().parse().unwrap();\n        let ok: bool = conn\n            .query_row(\n                \"SELECT 1 FROM schema_version WHERE version = ?1\",\n                [v],\n                |_| Ok(true),\n            )\n            .optional()?\n            .unwrap_or(false);\n        if !ok {\n            missing.push(v);\n        }\n    }\n    if !missing.is_empty() {\n        warn!(\"migrations not applied: {:?}\", missing);\n    }\n\n    Ok(())\n}\n\n/* ─── tag helpers ─────────────────────────────────────────────────── */\n\npub fn ensure_tag_path(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    let mut parent: Option\u003ci64\u003e = None;\n    for segment in path.split('/').filter(|s| !s.is_empty()) {\n        conn.execute(\n            \"INSERT OR IGNORE INTO tags(name, parent_id) VALUES (?1, ?2)\",\n            params![segment, parent],\n        )?;\n        let id: i64 = conn.query_row(\n            \"SELECT id FROM tags WHERE name = ?1 AND (parent_id IS ?2 OR parent_id = ?2)\",\n            params![segment, parent],\n            |r| r.get(0),\n        )?;\n        parent = Some(id);\n    }\n    parent.ok_or_else(|| anyhow::anyhow!(\"empty tag path\"))\n}\n\npub fn file_id(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.query_row(\"SELECT id FROM files WHERE path = ?1\", [path], |r| r.get(0))\n        .map_err(|_| anyhow::anyhow!(\"file not indexed: {}\", path))\n}\n\n/* ─── attributes ──────────────────────────────────────────────────── */\n\npub fn upsert_attr(conn: \u0026Connection, file_id: i64, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        r#\"\n        INSERT INTO attributes(file_id, key, value)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(file_id, key) DO UPDATE SET value = excluded.value\n        \"#,\n        params![file_id, key, value],\n    )?;\n    Ok(())\n}\n\n/* ─── links ───────────────────────────────────────────────────────── */\n\npub fn add_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO links(src_file_id, dst_file_id, type)\n         VALUES (?1, ?2, ?3)\n         ON CONFLICT(src_file_id, dst_file_id, type) DO NOTHING\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn remove_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"DELETE FROM links\n         WHERE src_file_id = ?1\n           AND dst_file_id = ?2\n           AND (type IS ?3 OR type = ?3)\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn list_links(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n    direction: Option\u003c\u0026str\u003e,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003cVec\u003c(String, String, Option\u003cString\u003e)\u003e\u003e {\n    let like_pattern = pattern.replace('*', \"%\");\n\n    // Files matching pattern\n    let mut stmt = conn.prepare(\"SELECT id, path FROM files WHERE path LIKE ?1\")?;\n    let rows = stmt\n        .query_map(params![like_pattern], |r| {\n            Ok((r.get::\u003c_, i64\u003e(0)?, r.get::\u003c_, String\u003e(1)?))\n        })?\n        .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n    let mut out = Vec::new();\n    for (fid, fpath) in rows {\n        let (src_col, dst_col) = match direction {\n            Some(\"in\") =\u003e (\"dst_file_id\", \"src_file_id\"),\n            _ =\u003e (\"src_file_id\", \"dst_file_id\"),\n        };\n\n        let sql = format!(\n            \"SELECT f2.path, l.type\n               FROM links l\n               JOIN files f2 ON f2.id = l.{dst_col}\n              WHERE l.{src_col} = ?1\n                AND (?2 IS NULL OR l.type = ?2)\",\n        );\n\n        let mut stmt2 = conn.prepare(\u0026sql)?;\n        let links = stmt2\n            .query_map(params![fid, link_type], |r| {\n                Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n            })?\n            .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n        for (other, typ) in links {\n            out.push((fpath.clone(), other, typ));\n        }\n    }\n    Ok(out)\n}\n\npub fn find_backlinks(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n) -\u003e Result\u003cVec\u003c(String, Option\u003cString\u003e)\u003e\u003e {\n    let like = pattern.replace('*', \"%\");\n\n    let mut stmt = conn.prepare(\n        \"SELECT f1.path, l.type\n           FROM links l\n           JOIN files f1 ON f1.id = l.src_file_id\n           JOIN files f2 ON f2.id = l.dst_file_id\n          WHERE f2.path LIKE ?1\",\n    )?;\n\n    let rows = stmt.query_map([like], |r| {\n        Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n    })?;\n\n    let out = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(out)\n}\n\n/* ─── collections helpers ────────────────────────────────────────── */\n\npub fn ensure_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collections(name) VALUES (?1)\",\n        params![name],\n    )?;\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        params![name],\n        |r| r.get(0),\n    )\n    .context(\"collection lookup failed\")\n}\n\npub fn add_file_to_collection(conn: \u0026Connection, coll_id: i64, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collection_files(collection_id, file_id)\n         VALUES (?1, ?2)\",\n        params![coll_id, file_id],\n    )?;\n    Ok(())\n}\n\npub fn list_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let mut stmt = conn.prepare(\n        r#\"SELECT f.path\n            FROM collections        c\n            JOIN collection_files cf ON cf.collection_id = c.id\n            JOIN files            f  ON f.id            = cf.file_id\n           WHERE c.name = ?1\n           ORDER BY f.path\"#,\n    )?;\n\n    let rows = stmt.query_map([name], |r| r.get::\u003c_, String\u003e(0))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\n/* ─── saved views (smart folders) ───────────────────────────────── */\n\npub fn save_view(conn: \u0026Connection, name: \u0026str, query: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO views(name, query)\n         VALUES (?1, ?2)\n         ON CONFLICT(name) DO UPDATE SET query = excluded.query\",\n        params![name, query],\n    )?;\n    Ok(())\n}\n\npub fn list_views(conn: \u0026Connection) -\u003e Result\u003cVec\u003c(String, String)\u003e\u003e {\n    let mut stmt = conn.prepare(\"SELECT name, query FROM views ORDER BY name\")?;\n    let rows = stmt.query_map([], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\npub fn view_query(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cString\u003e {\n    conn.query_row(\n        \"SELECT query FROM views WHERE name = ?1\",\n        [name],\n        |r| r.get::\u003c_, String\u003e(0),\n    )\n    .context(format!(\"no view called '{}'\", name))\n}\n\n/* ─── dirty‐scan helpers ─────────────────────────────────────────── */\n\n/// Mark a file as “dirty” so it’ll be picked up by `scan_dirty`.\npub fn mark_dirty(conn: \u0026Connection, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO file_changes(file_id, marked_at)\n         VALUES (?1, strftime('%s','now'))\",\n        params![file_id],\n    )?;\n    Ok(())\n}\n\n/// Take and clear all dirty file IDs for incremental re-scan.\npub fn take_dirty(conn: \u0026Connection) -\u003e Result\u003cVec\u003ci64\u003e\u003e {\n    let mut ids = Vec::new();\n    {\n        let mut stmt = conn.prepare(\"SELECT file_id FROM file_changes\")?;\n        for row in stmt.query_map([], |r| r.get(0))? {\n            ids.push(row?);\n        }\n    }\n    conn.execute(\"DELETE FROM file_changes\", [])?;\n    Ok(ids)\n}\n\n/* ─── backup / restore helpers ────────────────────────────────────── */\n\npub fn backup\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cPathBuf\u003e {\n    let src = db_path.as_ref();\n    let dir = src\n        .parent()\n        .ok_or_else(|| anyhow::anyhow!(\"invalid DB path: {}\", src.display()))?\n        .join(\"backups\");\n    fs::create_dir_all(\u0026dir)?;\n\n    let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S\");\n    let dst = dir.join(format!(\"backup_{stamp}.db\"));\n\n    let src_conn = Connection::open_with_flags(src, OpenFlags::SQLITE_OPEN_READ_ONLY)?;\n    let mut dst_conn = Connection::open(\u0026dst)?;\n\n    let bk = Backup::new(\u0026src_conn, \u0026mut dst_conn)?;\n    while let StepResult::More = bk.step(100)? {}\n    Ok(dst)\n}\n\npub fn restore\u003cP: AsRef\u003cPath\u003e\u003e(backup_path: P, live_db_path: P) -\u003e Result\u003c()\u003e {\n    fs::copy(\u0026backup_path, \u0026live_db_path)?;\n    Ok(())\n}\n\n/* ─── tests ───────────────────────────────────────────────────────── */\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn migrations_apply_in_memory() {\n        open(\":memory:\").expect(\"all migrations apply\");\n    }\n}\n","traces":[{"line":37,"address":[5479584,5479632,5480989],"length":1,"stats":{"Line":9}},{"line":38,"address":[],"length":0,"stats":{"Line":20}},{"line":39,"address":[5479709,5479827,5480995],"length":1,"stats":{"Line":10}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":42,"address":[1761913,1760418,1759050,1760529,1761802,1759161,1761337,1762721,1759969],"length":1,"stats":{"Line":14}},{"line":43,"address":[1762719,1760687,1759967,1762071,1759319,1761335],"length":1,"stats":{"Line":5}},{"line":46,"address":[1762304,1762717,1759965,1760920,1761333,1759552],"length":1,"stats":{"Line":6}},{"line":48,"address":[],"length":0,"stats":{"Line":5}},{"line":49,"address":[5480888],"length":1,"stats":{"Line":4}},{"line":54,"address":[5373047,5370432,5375769],"length":1,"stats":{"Line":1}},{"line":56,"address":[5370458,5370577],"length":1,"stats":{"Line":1}},{"line":64,"address":[5370619],"length":1,"stats":{"Line":1}},{"line":67,"address":[2110984],"length":1,"stats":{"Line":1}},{"line":69,"address":[2111183,2111275],"length":1,"stats":{"Line":2}},{"line":70,"address":[2111405,2113314],"length":1,"stats":{"Line":2}},{"line":73,"address":[5481184,5481204],"length":1,"stats":{"Line":2}},{"line":76,"address":[5375727,5373266,5373476,5373227],"length":1,"stats":{"Line":4}},{"line":79,"address":[5373250],"length":1,"stats":{"Line":1}},{"line":80,"address":[5481248,5481264],"length":1,"stats":{"Line":2}},{"line":84,"address":[5373561],"length":1,"stats":{"Line":1}},{"line":85,"address":[5373628,5375061],"length":1,"stats":{"Line":2}},{"line":89,"address":[5373666,5373600,5373957],"length":1,"stats":{"Line":4}},{"line":90,"address":[2114628,2114759,2114154,2115228],"length":1,"stats":{"Line":3}},{"line":91,"address":[2114743],"length":1,"stats":{"Line":0}},{"line":93,"address":[2114995,2115123,2114910,2114789,2115193],"length":1,"stats":{"Line":15}},{"line":95,"address":[2114801],"length":1,"stats":{"Line":1}},{"line":99,"address":[5371140,5373061],"length":1,"stats":{"Line":2}},{"line":102,"address":[5371343],"length":1,"stats":{"Line":6}},{"line":103,"address":[2111661,2111752],"length":1,"stats":{"Line":8}},{"line":104,"address":[2112731,2111854],"length":1,"stats":{"Line":8}},{"line":105,"address":[2112913,2113111,2113248],"length":1,"stats":{"Line":2}},{"line":108,"address":[2112905],"length":1,"stats":{"Line":6}},{"line":109,"address":[1763504,1763512],"length":1,"stats":{"Line":8}},{"line":113,"address":[2113197],"length":1,"stats":{"Line":6}},{"line":114,"address":[5372962],"length":1,"stats":{"Line":0}},{"line":117,"address":[5371601],"length":1,"stats":{"Line":2}},{"line":118,"address":[2111988,2111923],"length":1,"stats":{"Line":0}},{"line":121,"address":[2111951],"length":1,"stats":{"Line":6}},{"line":126,"address":[5375808],"length":1,"stats":{"Line":1}},{"line":127,"address":[5375844],"length":1,"stats":{"Line":1}},{"line":128,"address":[2116766,2116029],"length":1,"stats":{"Line":4}},{"line":129,"address":[2116433,2116264],"length":1,"stats":{"Line":1}},{"line":131,"address":[5376032],"length":1,"stats":{"Line":1}},{"line":133,"address":[2116545,2116669],"length":1,"stats":{"Line":1}},{"line":135,"address":[5376316],"length":1,"stats":{"Line":1}},{"line":136,"address":[1763600,1763584],"length":1,"stats":{"Line":2}},{"line":138,"address":[2116720],"length":1,"stats":{"Line":1}},{"line":140,"address":[2116364],"length":1,"stats":{"Line":1}},{"line":143,"address":[2116784],"length":1,"stats":{"Line":0}},{"line":144,"address":[2116809],"length":1,"stats":{"Line":0}},{"line":145,"address":[1763761,1763744],"length":1,"stats":{"Line":0}},{"line":150,"address":[2116896],"length":1,"stats":{"Line":1}},{"line":151,"address":[2117135,2117026],"length":1,"stats":{"Line":1}},{"line":157,"address":[2116942],"length":1,"stats":{"Line":1}},{"line":159,"address":[2117175],"length":1,"stats":{"Line":1}},{"line":164,"address":[5377024],"length":1,"stats":{"Line":1}},{"line":170,"address":[2117431,2117322],"length":1,"stats":{"Line":1}},{"line":174,"address":[5377064],"length":1,"stats":{"Line":1}},{"line":176,"address":[2117471],"length":1,"stats":{"Line":1}},{"line":179,"address":[2117504],"length":1,"stats":{"Line":1}},{"line":185,"address":[2117735,2117626],"length":1,"stats":{"Line":1}},{"line":190,"address":[2117544],"length":1,"stats":{"Line":1}},{"line":192,"address":[2117775],"length":1,"stats":{"Line":1}},{"line":195,"address":[2121829,2117808,2121615],"length":1,"stats":{"Line":1}},{"line":201,"address":[2117916],"length":1,"stats":{"Line":1}},{"line":204,"address":[2117985,2121827,2118053],"length":1,"stats":{"Line":2}},{"line":205,"address":[2118803,2118489,2118422,2118602,2121807],"length":1,"stats":{"Line":2}},{"line":206,"address":[2118370],"length":1,"stats":{"Line":2}},{"line":207,"address":[1764030],"length":1,"stats":{"Line":1}},{"line":211,"address":[2118908],"length":1,"stats":{"Line":1}},{"line":212,"address":[2119056,2118956,2119183],"length":1,"stats":{"Line":3}},{"line":213,"address":[2119644,2119284],"length":1,"stats":{"Line":2}},{"line":214,"address":[5379460,5379323],"length":1,"stats":{"Line":0}},{"line":215,"address":[2119480],"length":1,"stats":{"Line":1}},{"line":218,"address":[5379584],"length":1,"stats":{"Line":1}},{"line":226,"address":[2121711,2119886,2119970],"length":1,"stats":{"Line":2}},{"line":227,"address":[2120758,2121661,2120377,2120557,2120444,2121690],"length":1,"stats":{"Line":2}},{"line":228,"address":[2120297],"length":1,"stats":{"Line":2}},{"line":229,"address":[5483060,5482462],"length":1,"stats":{"Line":1}},{"line":233,"address":[2120855,2120959,2121576,2121086],"length":1,"stats":{"Line":4}},{"line":234,"address":[5381119,5381277],"length":1,"stats":{"Line":2}},{"line":237,"address":[5379217],"length":1,"stats":{"Line":1}},{"line":240,"address":[2123080,2121856,2123125],"length":1,"stats":{"Line":1}},{"line":244,"address":[2121926],"length":1,"stats":{"Line":1}},{"line":246,"address":[5382118,5381991,5381923,5383068],"length":1,"stats":{"Line":2}},{"line":254,"address":[5382434,5382567,5383054,5382295],"length":1,"stats":{"Line":3}},{"line":255,"address":[1765246,1765829],"length":1,"stats":{"Line":1}},{"line":258,"address":[2123036,2122796,2122700],"length":1,"stats":{"Line":2}},{"line":259,"address":[5382932],"length":1,"stats":{"Line":1}},{"line":264,"address":[2123168],"length":1,"stats":{"Line":1}},{"line":265,"address":[5383309,5383199],"length":1,"stats":{"Line":1}},{"line":267,"address":[2123203],"length":1,"stats":{"Line":1}},{"line":269,"address":[5383387],"length":1,"stats":{"Line":1}},{"line":271,"address":[5383359],"length":1,"stats":{"Line":1}},{"line":272,"address":[1765904,1765920],"length":1,"stats":{"Line":2}},{"line":277,"address":[2123520],"length":1,"stats":{"Line":1}},{"line":278,"address":[2123713,2123604],"length":1,"stats":{"Line":1}},{"line":281,"address":[5383518],"length":1,"stats":{"Line":1}},{"line":283,"address":[2123753],"length":1,"stats":{"Line":1}},{"line":286,"address":[2124809,2124801,2123776],"length":1,"stats":{"Line":1}},{"line":287,"address":[2123826,2123938],"length":1,"stats":{"Line":1}},{"line":296,"address":[1765987,1765952],"length":1,"stats":{"Line":4}},{"line":297,"address":[2124409,2124505,2124760],"length":1,"stats":{"Line":2}},{"line":298,"address":[5384702],"length":1,"stats":{"Line":1}},{"line":303,"address":[2124832],"length":1,"stats":{"Line":1}},{"line":304,"address":[2125035,2124926],"length":1,"stats":{"Line":1}},{"line":308,"address":[2124872],"length":1,"stats":{"Line":1}},{"line":310,"address":[2125075],"length":1,"stats":{"Line":1}},{"line":313,"address":[2126071,2125104,2126063],"length":1,"stats":{"Line":1}},{"line":314,"address":[2125128],"length":1,"stats":{"Line":1}},{"line":315,"address":[5484014,5483968],"length":1,"stats":{"Line":4}},{"line":316,"address":[2126022,2125673,2125769],"length":1,"stats":{"Line":2}},{"line":317,"address":[2125955],"length":1,"stats":{"Line":1}},{"line":320,"address":[2126430,2126405,2126096],"length":1,"stats":{"Line":1}},{"line":321,"address":[2126158,2126359,2126130],"length":1,"stats":{"Line":3}},{"line":323,"address":[2126138],"length":1,"stats":{"Line":1}},{"line":324,"address":[1766736,1766720],"length":1,"stats":{"Line":2}},{"line":326,"address":[2126423,2126217,2126389,2126193],"length":1,"stats":{"Line":2}},{"line":332,"address":[2126448],"length":1,"stats":{"Line":0}},{"line":333,"address":[2126611,2126502],"length":1,"stats":{"Line":0}},{"line":336,"address":[2126474],"length":1,"stats":{"Line":0}},{"line":338,"address":[2126651],"length":1,"stats":{"Line":0}},{"line":342,"address":[2128134,2128121,2126688],"length":1,"stats":{"Line":0}},{"line":343,"address":[2126723],"length":1,"stats":{"Line":0}},{"line":345,"address":[2126733,2126797,2128129],"length":1,"stats":{"Line":0}},{"line":346,"address":[2127448,2127174,2127110,2128127],"length":1,"stats":{"Line":0}},{"line":347,"address":[2127549,2127919],"length":1,"stats":{"Line":0}},{"line":350,"address":[2127905,2127615],"length":1,"stats":{"Line":0}},{"line":351,"address":[2127818],"length":1,"stats":{"Line":0}},{"line":356,"address":[],"length":0,"stats":{"Line":1}},{"line":357,"address":[],"length":0,"stats":{"Line":2}},{"line":358,"address":[1766965,1767096,1769333],"length":1,"stats":{"Line":1}},{"line":360,"address":[],"length":0,"stats":{"Line":0}},{"line":362,"address":[],"length":0,"stats":{"Line":2}},{"line":364,"address":[],"length":0,"stats":{"Line":1}},{"line":365,"address":[],"length":0,"stats":{"Line":2}},{"line":367,"address":[2497145,2498760,2497253],"length":1,"stats":{"Line":2}},{"line":368,"address":[1768084,1769239,1768151],"length":1,"stats":{"Line":2}},{"line":370,"address":[1769218,1768549,1768482],"length":1,"stats":{"Line":2}},{"line":371,"address":[1768756,1768807],"length":1,"stats":{"Line":2}},{"line":372,"address":[],"length":0,"stats":{"Line":1}},{"line":375,"address":[],"length":0,"stats":{"Line":1}},{"line":376,"address":[],"length":0,"stats":{"Line":2}},{"line":377,"address":[],"length":0,"stats":{"Line":1}}],"covered":124,"coverable":144},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db_tests.rs"],"content":"// libmarlin/src/db_tests.rs\n\nuse super::db;\nuse rusqlite::Connection;\nuse tempfile::tempdir;\n\nfn open_mem() -\u003e Connection {\n    // helper to open an in-memory DB with migrations applied\n    db::open(\":memory:\").expect(\"open in-memory DB\")\n}\n\n#[test]\nfn ensure_tag_path_creates_hierarchy() {\n    let conn = open_mem();\n    // create foo/bar/baz\n    let leaf = db::ensure_tag_path(\u0026conn, \"foo/bar/baz\").unwrap();\n    // foo should exist as a root tag\n    let foo: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='foo' AND parent_id IS NULL\",\n            [],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // bar should be child of foo\n    let bar: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='bar' AND parent_id = ?1\",\n            [foo],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // baz should be child of bar, and its ID is what we got back\n    let baz: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='baz' AND parent_id = ?1\",\n            [bar],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(leaf, baz);\n}\n\n#[test]\nfn upsert_attr_inserts_and_updates() {\n    let conn = open_mem();\n    // insert a dummy file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"a.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='a.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // insert\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v\").unwrap();\n    let v1: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v1, \"v\");\n\n    // update\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v2\").unwrap();\n    let v2: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v2, \"v2\");\n}\n\n#[test]\nfn add_and_remove_links_and_backlinks() {\n    let conn = open_mem();\n    // create two files\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"one.txt\"],\n    )\n    .unwrap();\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"two.txt\"],\n    )\n    .unwrap();\n    let src: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='one.txt'\", [], |r| r.get(0))\n        .unwrap();\n    let dst: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='two.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // add a link of type \"ref\"\n    db::add_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let out = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert_eq!(out.len(), 1);\n    assert_eq!(out[0].2.as_deref(), Some(\"ref\"));\n\n    // backlinks should mirror\n    let back = db::find_backlinks(\u0026conn, \"two%\").unwrap();\n    assert_eq!(back.len(), 1);\n    assert_eq!(back[0].1.as_deref(), Some(\"ref\"));\n\n    // remove it\n    db::remove_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let empty = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert!(empty.is_empty());\n}\n\n#[test]\nfn collections_roundtrip() {\n    let conn = open_mem();\n    // create collection \"C\"\n    let cid = db::ensure_collection(\u0026conn, \"C\").unwrap();\n\n    // add a file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"f.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='f.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    db::add_file_to_collection(\u0026conn, cid, fid).unwrap();\n    let files = db::list_collection(\u0026conn, \"C\").unwrap();\n    assert_eq!(files, vec![\"f.txt\".to_string()]);\n}\n\n#[test]\nfn views_save_and_query() {\n    let conn = open_mem();\n    db::save_view(\u0026conn, \"v1\", \"some_query\").unwrap();\n    let all = db::list_views(\u0026conn).unwrap();\n    assert_eq!(all, vec![(\"v1\".to_string(), \"some_query\".to_string())]);\n\n    let q = db::view_query(\u0026conn, \"v1\").unwrap();\n    assert_eq!(q, \"some_query\");\n}\n\n#[test]\nfn backup_and_restore_cycle() {\n    let tmp = tempdir().unwrap();\n    let db_path = tmp.path().join(\"data.db\");\n    let live = db::open(\u0026db_path).unwrap();\n\n    // insert a file\n    live.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"x.bin\"],\n    )\n    .unwrap();\n\n    // backup\n    let backup = db::backup(\u0026db_path).unwrap();\n    // remove original\n    std::fs::remove_file(\u0026db_path).unwrap();\n    // restore\n    db::restore(\u0026backup, \u0026db_path).unwrap();\n\n    // reopen and check that x.bin survived\n    let conn2 = db::open(\u0026db_path).unwrap();\n    let cnt: i64 =\n        conn2.query_row(\"SELECT COUNT(*) FROM files WHERE path='x.bin'\", [], |r| r.get(0)).unwrap();\n    assert_eq!(cnt, 1);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","error.rs"],"content":"// libmarlin/src/error.rs\n\nuse std::io;\nuse std::fmt;\n// Ensure these are present if Error enum variants use them directly\n// use rusqlite;\n// use notify;\n\npub type Result\u003cT\u003e = std::result::Result\u003cT, Error\u003e;\n\n#[derive(Debug)]\npub enum Error {\n    Io(io::Error),\n    Database(rusqlite::Error), \n    Watch(notify::Error),    \n    InvalidState(String),\n    NotFound(String),\n    Config(String),\n    Other(String),\n}\n\nimpl fmt::Display for Error {\n    fn fmt(\u0026self, f: \u0026mut fmt::Formatter\u003c'_\u003e) -\u003e fmt::Result {\n        match self {\n            Self::Io(err) =\u003e write!(f, \"IO error: {}\", err),\n            Self::Database(err) =\u003e write!(f, \"Database error: {}\", err),\n            Self::Watch(err) =\u003e write!(f, \"Watch error: {}\", err),\n            Self::InvalidState(msg) =\u003e write!(f, \"Invalid state: {}\", msg),\n            Self::NotFound(path) =\u003e write!(f, \"Not found: {}\", path),\n            Self::Config(msg) =\u003e write!(f, \"Configuration error: {}\", msg),\n            Self::Other(msg) =\u003e write!(f, \"Error: {}\", msg),\n        }\n    }\n}\n\nimpl std::error::Error for Error {\n    fn source(\u0026self) -\u003e Option\u003c\u0026(dyn std::error::Error + 'static)\u003e {\n        match self {\n            Self::Io(err) =\u003e Some(err),\n            Self::Database(err) =\u003e Some(err),\n            Self::Watch(err) =\u003e Some(err),\n            Self::InvalidState(_) | Self::NotFound(_) | Self::Config(_) | Self::Other(_) =\u003e None,\n        }\n    }\n}\n\nimpl From\u003cio::Error\u003e for Error {\n    fn from(err: io::Error) -\u003e Self {\n        Self::Io(err)\n    }\n}\n\nimpl From\u003crusqlite::Error\u003e for Error {\n    fn from(err: rusqlite::Error) -\u003e Self {\n        Self::Database(err)\n    }\n}\n\nimpl From\u003cnotify::Error\u003e for Error {\n    fn from(err: notify::Error) -\u003e Self {\n        Self::Watch(err)\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use std::error::Error as StdError; \n\n    #[test]\n    fn test_error_display_and_from() {\n        // Test Io variant\n        let io_err_inner_for_source_check = io::Error::new(io::ErrorKind::NotFound, \"test io error\");\n        let io_err_marlin = Error::from(io::Error::new(io::ErrorKind::NotFound, \"test io error\"));\n        assert_eq!(io_err_marlin.to_string(), \"IO error: test io error\");\n        let source = io_err_marlin.source();\n        assert!(source.is_some(), \"Io error should have a source\");\n        if let Some(s) = source {\n            // Compare details of the source if necessary, or just its string representation\n            assert_eq!(s.to_string(), io_err_inner_for_source_check.to_string());\n        }\n\n        // Test Database variant\n        let rusqlite_err_inner_for_source_check = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        );\n        // We need to create the error again for the From conversion if we want to compare the source\n        let db_err_marlin = Error::from(rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        ));\n        assert!(db_err_marlin.to_string().contains(\"Database error: test db error\"));\n        let source = db_err_marlin.source();\n        assert!(source.is_some(), \"Database error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), rusqlite_err_inner_for_source_check.to_string());\n        }\n\n\n        // Test Watch variant\n        let notify_raw_err_inner_for_source_check = notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string()));\n        let watch_err_marlin = Error::from(notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string())));\n        assert!(watch_err_marlin.to_string().contains(\"Watch error: test watch error\"));\n        let source = watch_err_marlin.source();\n        assert!(source.is_some(), \"Watch error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), notify_raw_err_inner_for_source_check.to_string());\n        }\n\n\n        let invalid_state_err = Error::InvalidState(\"bad state\".to_string());\n        assert_eq!(invalid_state_err.to_string(), \"Invalid state: bad state\");\n        assert!(invalid_state_err.source().is_none());\n\n        let not_found_err = Error::NotFound(\"missing_file.txt\".to_string());\n        assert_eq!(not_found_err.to_string(), \"Not found: missing_file.txt\");\n        assert!(not_found_err.source().is_none());\n\n        let config_err = Error::Config(\"bad config\".to_string());\n        assert_eq!(config_err.to_string(), \"Configuration error: bad config\");\n        assert!(config_err.source().is_none());\n\n        let other_err = Error::Other(\"some other issue\".to_string());\n        assert_eq!(other_err.to_string(), \"Error: some other issue\");\n        assert!(other_err.source().is_none());\n    }\n\n    #[test]\n    fn test_rusqlite_error_without_message() {\n        let sqlite_busy_error = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        );\n        let db_err_no_msg = Error::from(sqlite_busy_error);\n        \n        let expected_rusqlite_msg = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        ).to_string(); \n        \n        let expected_marlin_msg = format!(\"Database error: {}\", expected_rusqlite_msg);\n        \n        // Verify the string matches the expected format\n        assert_eq!(db_err_no_msg.to_string(), expected_marlin_msg);\n        \n        // Check the error code directly instead of the string\n        if let Error::Database(rusqlite::Error::SqliteFailure(err, _)) = \u0026db_err_no_msg {\n            assert_eq!(err.code, rusqlite::ffi::ErrorCode::DatabaseBusy);\n        } else {\n            panic!(\"Expected Error::Database variant\");\n        }\n        \n        // Verify the source exists\n        assert!(db_err_no_msg.source().is_some());\n    }\n}","traces":[{"line":23,"address":[5592736],"length":1,"stats":{"Line":1}},{"line":24,"address":[2070560],"length":1,"stats":{"Line":1}},{"line":25,"address":[2070624],"length":1,"stats":{"Line":1}},{"line":26,"address":[2070722],"length":1,"stats":{"Line":1}},{"line":27,"address":[2070839],"length":1,"stats":{"Line":1}},{"line":28,"address":[2070966],"length":1,"stats":{"Line":1}},{"line":29,"address":[2071094],"length":1,"stats":{"Line":1}},{"line":30,"address":[2071222],"length":1,"stats":{"Line":1}},{"line":31,"address":[2071347],"length":1,"stats":{"Line":1}},{"line":37,"address":[2071488],"length":1,"stats":{"Line":1}},{"line":38,"address":[2071498],"length":1,"stats":{"Line":1}},{"line":39,"address":[2071563],"length":1,"stats":{"Line":1}},{"line":40,"address":[5593804],"length":1,"stats":{"Line":1}},{"line":41,"address":[2071625],"length":1,"stats":{"Line":1}},{"line":42,"address":[2071653],"length":1,"stats":{"Line":1}},{"line":48,"address":[2071680],"length":1,"stats":{"Line":1}},{"line":49,"address":[2071688],"length":1,"stats":{"Line":1}},{"line":54,"address":[2071712],"length":1,"stats":{"Line":1}},{"line":55,"address":[2071720],"length":1,"stats":{"Line":1}},{"line":60,"address":[2071744],"length":1,"stats":{"Line":1}},{"line":61,"address":[2071761],"length":1,"stats":{"Line":1}}],"covered":21,"coverable":21},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","facade_tests.rs"],"content":"// libmarlin/src/facade_tests.rs\n\nuse super::*;             // brings Marlin, config, etc.\nuse std::{env, fs};\nuse tempfile::tempdir;\n\n#[test]\nfn open_at_and_scan_and_search() {\n    // 1) Prepare a temp workspace with one file\n    let tmp = tempdir().unwrap();\n    let file = tmp.path().join(\"hello.txt\");\n    fs::write(\u0026file, \"hello FAÇT\").unwrap();\n\n    // 2) Use open_at to create a fresh DB\n    let db_path = tmp.path().join(\"explicit.db\");\n    let mut m = Marlin::open_at(\u0026db_path).expect(\"open_at should succeed\");\n    assert!(db_path.exists(), \"DB file should be created\");\n\n    // 3) Scan the directory\n    let count = m.scan(\u0026[tmp.path()]).expect(\"scan should succeed\");\n    assert_eq!(count, 1, \"we created exactly one file\");\n\n    // 4) Search using an FTS hit\n    let hits = m.search(\"hello\").expect(\"search must not error\");\n    assert_eq!(hits.len(), 1);\n    assert!(hits[0].ends_with(\"hello.txt\"));\n\n    // 5) Search a substring that isn't a valid token (fires fallback)\n    let fallback_hits = m.search(\"FAÇT\").expect(\"fallback search works\");\n    assert_eq!(fallback_hits.len(), 1);\n    assert!(fallback_hits[0].ends_with(\"hello.txt\"));\n}\n\n#[test]\nfn tag_and_search_by_tag() {\n    let tmp = tempdir().unwrap();\n    let a = tmp.path().join(\"a.md\");\n    let b = tmp.path().join(\"b.md\");\n    fs::write(\u0026a, \"# a\").unwrap();\n    fs::write(\u0026b, \"# b\").unwrap();\n\n    let db_path = tmp.path().join(\"my.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db_path);\n\n    let mut m = Marlin::open_default().unwrap();\n    m.scan(\u0026[tmp.path()]).unwrap();\n\n    let changed = m.tag(\"*.md\", \"foo/bar\").unwrap();\n    assert_eq!(changed, 2);\n\n    let tagged = m.search(\"tags_text:\\\"foo/bar\\\"\").unwrap();\n    assert_eq!(tagged.len(), 2);\n\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn open_default_fallback_config() {\n    // Unset all overrides\n    env::remove_var(\"MARLIN_DB_PATH\");\n    env::remove_var(\"XDG_DATA_HOME\");\n\n    // Simulate no XDG: temporarily point HOME to a read-only dir\n    let fake_home = tempdir().unwrap();\n    env::set_var(\"HOME\", fake_home.path());\n    // This should fall back to \"./index_\u003chash\u003e.db\"\n    let cfg = config::Config::load().unwrap();\n    let fname = cfg.db_path.file_name().unwrap().to_string_lossy();\n    assert!(fname.starts_with(\"index_\") \u0026\u0026 fname.ends_with(\".db\"));\n\n    // Clean up\n    env::remove_var(\"HOME\");\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","lib.rs"],"content":"//! libmarlin – public API surface for the Marlin core.\n//!\n//! Down-stream crates (`cli-bin`, `tui-bin`, tests, plugins) should depend\n//! *only* on the helpers re-exported here, never on internal modules\n//! directly.  That gives us room to refactor internals without breaking\n//! callers.\n\n#![deny(warnings)]\n\npub mod backup;\npub mod config;\npub mod db;\npub mod error;\npub mod logging;\npub mod scan;\npub mod utils;\npub mod watcher;\n\n#[cfg(test)]\nmod utils_tests;\n#[cfg(test)]\nmod config_tests;\n#[cfg(test)]\nmod scan_tests;\n#[cfg(test)]\nmod logging_tests;\n#[cfg(test)]\nmod db_tests;\n#[cfg(test)]\nmod facade_tests;\n#[cfg(test)]\nmod watcher_tests;\n\nuse anyhow::{Context, Result};\nuse rusqlite::Connection;\nuse std::{fs, path::Path, sync::{Arc, Mutex}};\n\n/// Main handle for interacting with a Marlin database.\npub struct Marlin {\n    #[allow(dead_code)]\n    cfg: config::Config,\n    conn: Connection,\n}\n\nimpl Marlin {\n    /// Open using the default config (env override or XDG/CWD fallback),\n    /// ensuring parent directories exist and applying migrations.\n    pub fn open_default() -\u003e Result\u003cSelf\u003e {\n        // 1) Load configuration\n        let cfg = config::Config::load()?;\n        // 2) Ensure the DB's parent directory exists\n        if let Some(parent) = cfg.db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // 3) Open the database and run migrations\n        let conn = db::open(\u0026cfg.db_path)\n            .context(format!(\"opening database at {}\", cfg.db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Open a Marlin instance at the specified database path,\n    /// creating parent directories and applying migrations.\n    pub fn open_at\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cSelf\u003e {\n        let db_path = db_path.as_ref();\n        // Ensure the specified DB directory exists\n        if let Some(parent) = db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // Build a minimal Config so callers can still inspect cfg.db_path\n        let cfg = config::Config { db_path: db_path.to_path_buf() };\n        // Open the database and run migrations\n        let conn = db::open(db_path)\n            .context(format!(\"opening database at {}\", db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Recursively index one or more directories.\n    pub fn scan\u003cP: AsRef\u003cPath\u003e\u003e(\u0026mut self, paths: \u0026[P]) -\u003e Result\u003cusize\u003e {\n        let mut total = 0;\n        for p in paths {\n            total += scan::scan_directory(\u0026mut self.conn, p.as_ref())?;\n        }\n        Ok(total)\n    }\n\n    /// Attach a hierarchical tag (`foo/bar`) to every _indexed_ file\n    /// matching the glob.  Returns the number of files actually updated.\n    pub fn tag(\u0026mut self, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003cusize\u003e {\n        use glob::Pattern;\n\n        // 1) ensure tag hierarchy\n        let leaf = db::ensure_tag_path(\u0026self.conn, tag_path)?;\n\n        // 2) collect leaf + ancestors\n        let mut tag_ids = Vec::new();\n        let mut cur = Some(leaf);\n        while let Some(id) = cur {\n            tag_ids.push(id);\n            cur = self.conn.query_row(\n                \"SELECT parent_id FROM tags WHERE id = ?1\",\n                [id],\n                |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n            )?;\n        }\n\n        // 3) match files by glob against stored paths\n        let expanded = shellexpand::tilde(pattern).into_owned();\n        let pat = Pattern::new(\u0026expanded)\n            .with_context(|| format!(\"Invalid glob pattern `{}`\", expanded))?;\n\n        let mut stmt_all = self.conn.prepare(\"SELECT id, path FROM files\")?;\n        let rows = stmt_all.query_map([], |r| Ok((r.get(0)?, r.get(1)?)))?;\n\n        let mut stmt_ins = self.conn.prepare(\n            \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n        )?;\n\n        let mut changed = 0;\n        for row in rows {\n            let (fid, path_str): (i64, String) = row?;\n            let is_match = if expanded.contains(std::path::MAIN_SEPARATOR) {\n                pat.matches(\u0026path_str)\n            } else {\n                Path::new(\u0026path_str)\n                    .file_name()\n                    .and_then(|n| n.to_str())\n                    .map(|n| pat.matches(n))\n                    .unwrap_or(false)\n            };\n            if !is_match {\n                continue;\n            }\n\n            let mut newly = false;\n            for \u0026tid in \u0026tag_ids {\n                if stmt_ins.execute([fid, tid])? \u003e 0 {\n                    newly = true;\n                }\n            }\n            if newly {\n                changed += 1;\n            }\n        }\n        Ok(changed)\n    }\n\n    /// Full-text search over path, tags, and attrs, with substring fallback.\n    pub fn search(\u0026self, query: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let mut stmt = self.conn.prepare(\n            \"SELECT f.path FROM files_fts JOIN files f ON f.rowid = files_fts.rowid WHERE files_fts MATCH ?1 ORDER BY rank\",\n        )?;\n        let mut hits = stmt.query_map([query], |r| r.get(0))?\n            .collect::\u003cstd::result::Result\u003cVec\u003c_\u003e, rusqlite::Error\u003e\u003e()?;\n\n        if hits.is_empty() \u0026\u0026 !query.contains(':') {\n            hits = self.fallback_search(query)?;\n        }\n        Ok(hits)\n    }\n\n    fn fallback_search(\u0026self, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let needle = term.to_lowercase();\n        let mut stmt = self.conn.prepare(\"SELECT path FROM files\")?;\n        let rows = stmt.query_map([], |r| r.get(0))?;\n        let mut out = Vec::new();\n        for res in rows {\n            let p: String = res?;\n            if p.to_lowercase().contains(\u0026needle) {\n                out.push(p.clone());\n                continue;\n            }\n            if let Ok(meta) = fs::metadata(\u0026p) {\n                if meta.len() \u003c= 65_536 { \n                    if let Ok(body) = fs::read_to_string(\u0026p) {\n                        if body.to_lowercase().contains(\u0026needle) {\n                            out.push(p.clone());\n                        }\n                    }\n                }\n            }\n        }\n        Ok(out)\n    }\n\n    /// Borrow the raw SQLite connection.\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n\n    /// Spawn a file-watcher that indexes changes in real time.\n    pub fn watch\u003cP: AsRef\u003cPath\u003e\u003e(\n        \u0026mut self,\n        path: P,\n        config: Option\u003cwatcher::WatcherConfig\u003e,\n    ) -\u003e Result\u003cwatcher::FileWatcher\u003e {\n        let cfg = config.unwrap_or_default();\n        let p = path.as_ref().to_path_buf();\n        let new_conn = db::open(\u0026self.cfg.db_path)\n            .context(\"opening database for watcher\")?;\n        let watcher_db = Arc::new(Mutex::new(db::Database::new(new_conn)));\n        \n        let mut owned_w = watcher::FileWatcher::new(vec![p], cfg)?;\n        owned_w.with_database(watcher_db); // Modifies owned_w in place\n        owned_w.start()?; // Start the watcher after it has been fully configured\n        \n        Ok(owned_w) // Return the owned FileWatcher\n    }\n}","traces":[{"line":48,"address":[5390765,5390771,5389632],"length":1,"stats":{"Line":1}},{"line":50,"address":[2099265],"length":1,"stats":{"Line":1}},{"line":52,"address":[2099509,2099445],"length":1,"stats":{"Line":2}},{"line":53,"address":[2099619,2099656],"length":1,"stats":{"Line":2}},{"line":56,"address":[2100322,2099768,2100017,2100080,2100122,2099644],"length":1,"stats":{"Line":4}},{"line":57,"address":[2099798,2099781,2100335,2100056,2100106],"length":1,"stats":{"Line":2}},{"line":58,"address":[2100169],"length":1,"stats":{"Line":1}},{"line":63,"address":[],"length":0,"stats":{"Line":1}},{"line":64,"address":[1683494,1683573],"length":1,"stats":{"Line":2}},{"line":66,"address":[],"length":0,"stats":{"Line":1}},{"line":67,"address":[],"length":0,"stats":{"Line":2}},{"line":70,"address":[1683849,1683722],"length":1,"stats":{"Line":2}},{"line":72,"address":[],"length":0,"stats":{"Line":4}},{"line":73,"address":[1683954,1684199,1684249,1684500,1683970],"length":1,"stats":{"Line":2}},{"line":74,"address":[],"length":0,"stats":{"Line":1}},{"line":78,"address":[],"length":0,"stats":{"Line":1}},{"line":79,"address":[],"length":0,"stats":{"Line":1}},{"line":80,"address":[],"length":0,"stats":{"Line":2}},{"line":81,"address":[1684843,1684666,1684765],"length":1,"stats":{"Line":1}},{"line":83,"address":[],"length":0,"stats":{"Line":1}},{"line":88,"address":[5390784,5395118,5394802],"length":1,"stats":{"Line":1}},{"line":92,"address":[2100477],"length":1,"stats":{"Line":1}},{"line":95,"address":[5391027],"length":1,"stats":{"Line":1}},{"line":96,"address":[2100629],"length":1,"stats":{"Line":1}},{"line":97,"address":[5391516,5391069],"length":1,"stats":{"Line":2}},{"line":98,"address":[5391107],"length":1,"stats":{"Line":1}},{"line":99,"address":[2101093,2100799,2100811,2100986],"length":1,"stats":{"Line":2}},{"line":101,"address":[2100803],"length":1,"stats":{"Line":1}},{"line":102,"address":[1684864,1684880],"length":1,"stats":{"Line":2}},{"line":107,"address":[5391149,5391572],"length":1,"stats":{"Line":2}},{"line":108,"address":[5395100,5391824,5391690,5391607],"length":1,"stats":{"Line":2}},{"line":109,"address":[5391808],"length":1,"stats":{"Line":0}},{"line":111,"address":[2101540,2104506,2101615],"length":1,"stats":{"Line":2}},{"line":112,"address":[5600174,5600128],"length":1,"stats":{"Line":4}},{"line":114,"address":[5392779,5392707,5392901,5394889],"length":1,"stats":{"Line":2}},{"line":118,"address":[5393106],"length":1,"stats":{"Line":1}},{"line":119,"address":[2102748,2102641,2102824],"length":1,"stats":{"Line":3}},{"line":120,"address":[2102941,2104294,2103115],"length":1,"stats":{"Line":2}},{"line":121,"address":[2103436,2103353],"length":1,"stats":{"Line":2}},{"line":122,"address":[5394005,5394179],"length":1,"stats":{"Line":0}},{"line":124,"address":[2103529,2103474],"length":1,"stats":{"Line":2}},{"line":126,"address":[5600654,5600640],"length":1,"stats":{"Line":2}},{"line":127,"address":[5600672,5600690],"length":1,"stats":{"Line":2}},{"line":130,"address":[2103643],"length":1,"stats":{"Line":1}},{"line":134,"address":[5394239],"length":1,"stats":{"Line":1}},{"line":135,"address":[2103741],"length":1,"stats":{"Line":1}},{"line":136,"address":[2104015,2104208,2103879],"length":1,"stats":{"Line":3}},{"line":137,"address":[5394726],"length":1,"stats":{"Line":1}},{"line":140,"address":[5394448,5394515],"length":1,"stats":{"Line":2}},{"line":141,"address":[2103995,2103958],"length":1,"stats":{"Line":1}},{"line":144,"address":[2102966],"length":1,"stats":{"Line":1}},{"line":148,"address":[5396601,5396611,5395136],"length":1,"stats":{"Line":1}},{"line":149,"address":[2104781,2104664],"length":1,"stats":{"Line":1}},{"line":152,"address":[1685667,1685632],"length":1,"stats":{"Line":4}},{"line":155,"address":[2105536,2105992,2105465,2105656],"length":1,"stats":{"Line":4}},{"line":156,"address":[5396430,5396266],"length":1,"stats":{"Line":1}},{"line":158,"address":[2105547],"length":1,"stats":{"Line":1}},{"line":161,"address":[5399481,5396624,5399133],"length":1,"stats":{"Line":1}},{"line":162,"address":[2106145],"length":1,"stats":{"Line":1}},{"line":163,"address":[2108847,2106261,2106186],"length":1,"stats":{"Line":2}},{"line":164,"address":[5397140,5399458,5397211],"length":1,"stats":{"Line":4}},{"line":165,"address":[2106856],"length":1,"stats":{"Line":1}},{"line":166,"address":[2107084,2107008,2106916],"length":1,"stats":{"Line":3}},{"line":167,"address":[2107201,2107346],"length":1,"stats":{"Line":2}},{"line":168,"address":[2107623,2107552],"length":1,"stats":{"Line":2}},{"line":169,"address":[2108664],"length":1,"stats":{"Line":0}},{"line":172,"address":[2107804,2107894],"length":1,"stats":{"Line":2}},{"line":173,"address":[2108574,2107962,2107901],"length":1,"stats":{"Line":3}},{"line":174,"address":[2108088,2107990],"length":1,"stats":{"Line":2}},{"line":175,"address":[2108136,2108207],"length":1,"stats":{"Line":2}},{"line":176,"address":[2108391],"length":1,"stats":{"Line":1}},{"line":182,"address":[2107234],"length":1,"stats":{"Line":1}},{"line":186,"address":[2108864],"length":1,"stats":{"Line":0}},{"line":187,"address":[2108872],"length":1,"stats":{"Line":0}},{"line":191,"address":[2308196,2308112,2309672],"length":1,"stats":{"Line":0}},{"line":196,"address":[],"length":0,"stats":{"Line":0}},{"line":197,"address":[],"length":0,"stats":{"Line":0}},{"line":198,"address":[],"length":0,"stats":{"Line":0}},{"line":200,"address":[],"length":0,"stats":{"Line":0}},{"line":202,"address":[],"length":0,"stats":{"Line":0}},{"line":203,"address":[2309358],"length":1,"stats":{"Line":0}},{"line":204,"address":[2309429],"length":1,"stats":{"Line":0}},{"line":206,"address":[2309555],"length":1,"stats":{"Line":0}}],"covered":69,"coverable":83},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging.rs"],"content":"use tracing_subscriber::{fmt, EnvFilter};\n\n/// Initialise global tracing subscriber.\n///\n/// Reads `RUST_LOG` for filtering, falls back to `info`.\npub fn init() {\n    let filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new(\"info\"));\n\n    // All tracing output (INFO, WARN, ERROR …) now goes to *stderr* so the\n    // integration tests can assert on warnings / errors reliably.\n    fmt()\n        .with_target(false)        // hide module targets\n        .with_level(true)          // include log level\n        .with_env_filter(filter)   // respect RUST_LOG\n        .with_writer(std::io::stderr) // \u003c-- NEW: send to stderr\n        .init();\n}\n","traces":[{"line":6,"address":[2109278,2108944,2109307],"length":1,"stats":{"Line":1}},{"line":7,"address":[2108981],"length":1,"stats":{"Line":1}},{"line":11,"address":[2109119,2109197,2109041],"length":1,"stats":{"Line":3}},{"line":14,"address":[2109154],"length":1,"stats":{"Line":1}}],"covered":4,"coverable":4},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging_tests.rs"],"content":"// libmarlin/src/logging_tests.rs\n\nuse super::logging;\nuse tracing::Level;\n\n#[test]\nfn init_sets_up_subscriber() {\n    // set RUST_LOG to something to test the EnvFilter path\n    std::env::set_var(\"RUST_LOG\", \"debug\");\n    logging::init();\n    tracing::event!(Level::INFO, \"this is a test log\");\n    // if we made it here without panic, we’re good\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan.rs"],"content":"// src/scan.rs\n\nuse std::fs;\nuse std::path::Path;\n\nuse anyhow::Result;\nuse rusqlite::{params, Connection};\nuse tracing::{debug, info};\nuse walkdir::WalkDir;\n\n/// Recursively walk `root` and upsert file metadata.\n/// Triggers keep the FTS table in sync.\npub fn scan_directory(conn: \u0026mut Connection, root: \u0026Path) -\u003e Result\u003cusize\u003e {\n    // Begin a transaction so we batch many inserts/updates together\n    let tx = conn.transaction()?;\n\n    // Prepare the upsert statement once\n    let mut stmt = tx.prepare(\n        r#\"\n        INSERT INTO files(path, size, mtime)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(path) DO UPDATE\n            SET size  = excluded.size,\n                mtime = excluded.mtime\n        \"#,\n    )?;\n\n    let mut count = 0usize;\n\n    // Walk the directory recursively\n    for entry in WalkDir::new(root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let path = entry.path();\n\n        // Skip the database file and its WAL/SHM siblings\n        if let Some(name) = path.file_name().and_then(|n| n.to_str()) {\n            if name.ends_with(\".db\") || name.ends_with(\"-wal\") || name.ends_with(\"-shm\") {\n                continue;\n            }\n        }\n\n        // Gather file metadata\n        let meta = fs::metadata(path)?;\n        let size = meta.len() as i64;\n        let mtime = meta\n            .modified()?\n            .duration_since(std::time::UNIX_EPOCH)?\n            .as_secs() as i64;\n\n        // Execute the upsert\n        let path_str = path.to_string_lossy();\n        stmt.execute(params![path_str, size, mtime])?;\n        count += 1;\n\n        debug!(file = %path_str, \"indexed\");\n    }\n\n    // Finalize and commit\n    drop(stmt);\n    tx.commit()?;\n\n    info!(indexed = count, \"scan complete\");\n    Ok(count)\n}\n","traces":[{"line":13,"address":[5442107,5436832,5441856],"length":1,"stats":{"Line":1}},{"line":15,"address":[1954756],"length":1,"stats":{"Line":1}},{"line":18,"address":[1955184,1955035,1954971,1959810],"length":1,"stats":{"Line":2}},{"line":28,"address":[1955409],"length":1,"stats":{"Line":1}},{"line":31,"address":[1955429,1955662,1955477],"length":1,"stats":{"Line":5}},{"line":34,"address":[2057035,2057008],"length":1,"stats":{"Line":4}},{"line":36,"address":[1957173,1955747],"length":1,"stats":{"Line":4}},{"line":39,"address":[1957211],"length":1,"stats":{"Line":5}},{"line":40,"address":[1957388,1957544,1957463],"length":1,"stats":{"Line":3}},{"line":46,"address":[1957434,1959697,1957612],"length":1,"stats":{"Line":2}},{"line":47,"address":[5440026],"length":1,"stats":{"Line":1}},{"line":48,"address":[1957947,1958123,1957851,1959629],"length":1,"stats":{"Line":1}},{"line":49,"address":[5440141],"length":1,"stats":{"Line":0}},{"line":50,"address":[5440311],"length":1,"stats":{"Line":0}},{"line":54,"address":[1958255],"length":1,"stats":{"Line":1}},{"line":55,"address":[5440654,5441802,5440492],"length":1,"stats":{"Line":3}},{"line":56,"address":[1958667,1958607],"length":1,"stats":{"Line":1}},{"line":58,"address":[1958936,1958691,1958642],"length":1,"stats":{"Line":3}},{"line":62,"address":[1955800],"length":1,"stats":{"Line":1}},{"line":63,"address":[1957078,1955903],"length":1,"stats":{"Line":2}},{"line":65,"address":[1956110,1956459],"length":1,"stats":{"Line":2}},{"line":66,"address":[1956410],"length":1,"stats":{"Line":1}}],"covered":20,"coverable":22},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan_tests.rs"],"content":"// libmarlin/src/scan_tests.rs\n\nuse super::scan::scan_directory;\nuse super::db;\nuse tempfile::tempdir;\nuse std::fs::File;\n\n#[test]\nfn scan_directory_counts_files() {\n    let tmp = tempdir().unwrap();\n\n    // create a couple of files\n    File::create(tmp.path().join(\"a.txt\")).unwrap();\n    File::create(tmp.path().join(\"b.log\")).unwrap();\n\n    // open an in-memory DB (runs migrations)\n    let mut conn = db::open(\":memory:\").unwrap();\n\n    let count = scan_directory(\u0026mut conn, tmp.path()).unwrap();\n    assert_eq!(count, 2);\n\n    // ensure the paths were inserted\n    let mut stmt = conn.prepare(\"SELECT COUNT(*) FROM files\").unwrap();\n    let total: i64 = stmt.query_row([], |r| r.get(0)).unwrap();\n    assert_eq!(total, 2);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils.rs"],"content":"//! Misc shared helpers.\n\nuse std::path::PathBuf;\n\n/// Determine a filesystem root to limit recursive walking on glob scans.\n///\n/// If the pattern contains any of `*?[`, we take everything up to the\n/// first such character, and then (if that still contains metacharacters)\n/// walk up until there aren’t any left.  If there are *no* metachars at\n/// all, we treat the entire string as a path and return its parent\n/// directory (or `.` if it has no parent).\npub fn determine_scan_root(pattern: \u0026str) -\u003e PathBuf {\n    // find first wildcard char\n    let first_wild = pattern\n        .find(|c| matches!(c, '*' | '?' | '['))\n        .unwrap_or(pattern.len());\n\n    // everything up to the wildcard (or the whole string if none)\n    let prefix = \u0026pattern[..first_wild];\n    let mut root = PathBuf::from(prefix);\n\n    // If there were NO wildcards at all, just return the parent directory\n    if first_wild == pattern.len() {\n        return root.parent().map(|p| p.to_path_buf()).unwrap_or_else(|| PathBuf::from(\".\"));\n    }\n\n    // Otherwise, if the prefix still has any wildcards (e.g. \"foo*/bar\"),\n    // walk back up until it doesn’t\n    while root\n        .as_os_str()\n        .to_string_lossy()\n        .chars()\n        .any(|c| matches!(c, '*' | '?' | '['))\n    {\n        root = root.parent().map(|p| p.to_path_buf()).unwrap_or_default();\n    }\n\n    if root.as_os_str().is_empty() {\n        PathBuf::from(\".\")\n    } else {\n        root\n    }\n}\n","traces":[{"line":12,"address":[5518304,5519621,5519490],"length":1,"stats":{"Line":1}},{"line":14,"address":[1785101,1785170],"length":1,"stats":{"Line":4}},{"line":15,"address":[2163341,2163328],"length":1,"stats":{"Line":2}},{"line":16,"address":[1785146],"length":1,"stats":{"Line":2}},{"line":19,"address":[1785217],"length":1,"stats":{"Line":2}},{"line":20,"address":[1785252],"length":1,"stats":{"Line":2}},{"line":23,"address":[1785293,1785368],"length":1,"stats":{"Line":4}},{"line":24,"address":[5629712,5629760,5629734,5629772],"length":1,"stats":{"Line":4}},{"line":29,"address":[1786189,1785454,1785381,1785591],"length":1,"stats":{"Line":6}},{"line":33,"address":[1785663,1785537],"length":1,"stats":{"Line":3}},{"line":35,"address":[1786050,1785935],"length":1,"stats":{"Line":0}},{"line":38,"address":[1785712,1785838],"length":1,"stats":{"Line":2}},{"line":39,"address":[1785883,1785848],"length":1,"stats":{"Line":2}},{"line":41,"address":[1785795],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":14},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils_tests.rs"],"content":"// libmarlin/src/utils_tests.rs\n\nuse super::utils::determine_scan_root;\nuse std::path::PathBuf;\n\n#[test]\nfn determine_scan_root_plain_path() {\n    let root = determine_scan_root(\"foo/bar/baz.txt\");\n    assert_eq!(root, PathBuf::from(\"foo/bar\"));\n}\n\n#[test]\nfn determine_scan_root_glob() {\n    let root = determine_scan_root(\"foo/*/baz.rs\");\n    assert_eq!(root, PathBuf::from(\"foo\"));\n}\n\n#[test]\nfn determine_scan_root_only_wildcards() {\n    let root = determine_scan_root(\"**/*.txt\");\n    assert_eq!(root, PathBuf::from(\".\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher.rs"],"content":"// libmarlin/src/watcher.rs\n\n//! File system watcher implementation for Marlin\n//!\n//! This module provides real-time index updates by monitoring file system events\n//! (create, modify, delete) using the `notify` crate. It implements event debouncing,\n//! batch processing, and a state machine for robust lifecycle management.\n\nuse anyhow::{Result, Context};\nuse crate::db::Database;\nuse crossbeam_channel::{bounded, Receiver};\nuse notify::{Event, EventKind, RecommendedWatcher, RecursiveMode, Watcher as NotifyWatcherTrait};\nuse std::collections::HashMap;\nuse std::path::PathBuf;\nuse std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};\nuse std::sync::{Arc, Mutex};\nuse std::thread::{self, JoinHandle};\nuse std::time::{Duration, Instant};\n// REMOVED: use std::fs; // \u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c THIS LINE WAS REMOVED\n\n/// Configuration for the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherConfig {\n    /// Time in milliseconds to debounce file events\n    pub debounce_ms: u64,\n\n    /// Maximum number of events to process in a single batch\n    pub batch_size: usize,\n\n    /// Maximum size of the event queue before applying backpressure\n    pub max_queue_size: usize,\n\n    /// Time in milliseconds to wait for events to drain during shutdown\n    pub drain_timeout_ms: u64,\n}\n\nimpl Default for WatcherConfig {\n    fn default() -\u003e Self {\n        Self {\n            debounce_ms: 100,\n            batch_size: 1000,\n            max_queue_size: 100_000,\n            drain_timeout_ms: 5000,\n        }\n    }\n}\n\n/// State of the file watcher\n#[derive(Debug, Clone, PartialEq, Eq)]\npub enum WatcherState {\n    Initializing,\n    Watching,\n    Paused,\n    ShuttingDown,\n    Stopped,\n}\n\n/// Status information about the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherStatus {\n    pub state: WatcherState,\n    pub events_processed: usize,\n    pub queue_size: usize,\n    pub start_time: Option\u003cInstant\u003e,\n    pub watched_paths: Vec\u003cPathBuf\u003e,\n}\n\n#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]\nenum EventPriority {\n    Create = 0,\n    Delete = 1,\n    Modify = 2,\n    Access = 3,\n}\n\n#[derive(Debug, Clone)]\nstruct ProcessedEvent {\n    path: PathBuf,\n    kind: EventKind,\n    priority: EventPriority,\n    timestamp: Instant,\n}\n\nstruct EventDebouncer {\n    events: HashMap\u003cPathBuf, ProcessedEvent\u003e,\n    debounce_window_ms: u64,\n    last_flush: Instant,\n}\n\nimpl EventDebouncer {\n    fn new(debounce_window_ms: u64) -\u003e Self {\n        Self {\n            events: HashMap::new(),\n            debounce_window_ms,\n            last_flush: Instant::now(),\n        }\n    }\n\n    fn add_event(\u0026mut self, event: ProcessedEvent) {\n        let path = event.path.clone();\n        if path.is_dir() { // This relies on the PathBuf itself knowing if it's a directory\n                           // or on the underlying FS. For unit tests, ensure paths are created.\n            self.events.retain(|file_path, _| !file_path.starts_with(\u0026path) || file_path == \u0026path );\n        }\n        match self.events.get_mut(\u0026path) {\n            Some(existing) =\u003e {\n                if event.priority \u003c existing.priority {\n                    existing.priority = event.priority;\n                }\n                existing.timestamp = event.timestamp;\n                existing.kind = event.kind;\n            }\n            None =\u003e {\n                self.events.insert(path, event);\n            }\n        }\n    }\n\n    fn is_ready_to_flush(\u0026self) -\u003e bool {\n        self.last_flush.elapsed() \u003e= Duration::from_millis(self.debounce_window_ms)\n    }\n\n    fn flush(\u0026mut self) -\u003e Vec\u003cProcessedEvent\u003e {\n        let mut events: Vec\u003cProcessedEvent\u003e = self.events.drain().map(|(_, e)| e).collect();\n        events.sort_by_key(|e| e.priority);\n        self.last_flush = Instant::now();\n        events\n    }\n\n    #[allow(dead_code)]\n    fn len(\u0026self) -\u003e usize {\n        self.events.len()\n    }\n}\n\n#[cfg(test)]\nmod event_debouncer_tests {\n    use super::*;\n    use notify::event::{CreateKind, DataChange, ModifyKind, RemoveKind, RenameMode};\n    use std::fs; // fs is needed for these tests to create dirs/files\n    use tempfile; \n\n    #[test]\n    fn debouncer_add_and_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110)); \n        assert!(debouncer.is_ready_to_flush());\n        assert_eq!(debouncer.len(), 0);\n\n        let path1 = PathBuf::from(\"file1.txt\");\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 1);\n        \n        debouncer.last_flush = Instant::now(); \n        assert!(!debouncer.is_ready_to_flush());\n\n        std::thread::sleep(Duration::from_millis(110));\n        assert!(debouncer.is_ready_to_flush());\n\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(debouncer.len(), 0);\n        assert!(!debouncer.is_ready_to_flush()); \n    }\n\n    #[test]\n    fn debouncer_coalesce_events() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n\n        let t1 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: t1,\n        });\n        std::thread::sleep(Duration::from_millis(10));\n        let t2 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Modify(ModifyKind::Data(DataChange::Any)),\n            priority: EventPriority::Modify,\n            timestamp: t2,\n        });\n        \n        assert_eq!(debouncer.len(), 1);\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!( \n            flushed[0].kind,\n            EventKind::Modify(ModifyKind::Data(DataChange::Any))\n        );\n        assert_eq!(flushed[0].timestamp, t2);\n    }\n\n    #[test]\n    fn debouncer_hierarchical() {\n        let mut debouncer_h = EventDebouncer::new(100);\n        let temp_dir_obj = tempfile::tempdir().expect(\"Failed to create temp dir\");\n        let p_dir = temp_dir_obj.path().to_path_buf(); \n        let p_file = p_dir.join(\"file.txt\");\n        \n        fs::File::create(\u0026p_file).expect(\"Failed to create test file for hierarchical debounce\");\n\n        debouncer_h.add_event(ProcessedEvent {\n            path: p_file.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1);\n        \n        debouncer_h.add_event(ProcessedEvent {\n            path: p_dir.clone(), \n            kind: EventKind::Remove(RemoveKind::Folder), \n            priority: EventPriority::Delete,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1, \"Hierarchical debounce should remove child event, leaving only parent dir event\");\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer_h.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, p_dir);\n    }\n\n    #[test]\n    fn debouncer_different_files() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n        let path2 = PathBuf::from(\"file2.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: path2.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n    }\n\n    #[test]\n    fn debouncer_priority_sorting_on_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\"); \n        let path2 = PathBuf::from(\"file2.txt\"); \n        let path3 = PathBuf::from(\"file3.txt\"); \n\n        debouncer.add_event(ProcessedEvent { path: path1, kind: EventKind::Modify(ModifyKind::Name(RenameMode::To)), priority: EventPriority::Modify, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path2, kind: EventKind::Create(CreateKind::File), priority: EventPriority::Create, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path3, kind: EventKind::Remove(RemoveKind::File), priority: EventPriority::Delete, timestamp: Instant::now() });\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 3);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!(flushed[1].priority, EventPriority::Delete); \n        assert_eq!(flushed[2].priority, EventPriority::Modify); \n    }\n\n    #[test]\n    fn debouncer_no_events_flush_empty() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert!(flushed.is_empty());\n        assert_eq!(debouncer.len(), 0);\n    }\n}\n\n\npub struct FileWatcher {\n    state: Arc\u003cMutex\u003cWatcherState\u003e\u003e,\n    #[allow(dead_code)]\n    config: WatcherConfig,\n    watched_paths: Vec\u003cPathBuf\u003e,\n    #[allow(dead_code)]\n    event_receiver: Receiver\u003cstd::result::Result\u003cEvent, notify::Error\u003e\u003e,\n    #[allow(dead_code)] \n    watcher: RecommendedWatcher,\n    processor_thread: Option\u003cJoinHandle\u003c()\u003e\u003e,\n    stop_flag: Arc\u003cAtomicBool\u003e,\n    events_processed: Arc\u003cAtomicUsize\u003e,\n    queue_size: Arc\u003cAtomicUsize\u003e,\n    start_time: Instant,\n    db_shared: Arc\u003cMutex\u003cOption\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e\u003e\u003e,\n}\n\nimpl FileWatcher {\n    pub fn new(paths: Vec\u003cPathBuf\u003e, config: WatcherConfig) -\u003e Result\u003cSelf\u003e {\n        let stop_flag = Arc::new(AtomicBool::new(false));\n        let events_processed = Arc::new(AtomicUsize::new(0));\n        let queue_size = Arc::new(AtomicUsize::new(0));\n        let state = Arc::new(Mutex::new(WatcherState::Initializing));\n\n        let (tx, rx) = bounded(config.max_queue_size);\n\n        let event_tx = tx.clone();\n        let mut actual_watcher = RecommendedWatcher::new(\n            move |event_res: std::result::Result\u003cEvent, notify::Error\u003e| {\n                if event_tx.send(event_res).is_err() {\n                    // Receiver dropped\n                }\n            },\n            notify::Config::default(),\n        )?;\n\n        for path_to_watch in \u0026paths {\n            actual_watcher\n                .watch(path_to_watch, RecursiveMode::Recursive)\n                .with_context(|| format!(\"Failed to watch path: {}\", path_to_watch.display()))?;\n        }\n\n        let config_clone = config.clone();\n        let stop_flag_clone = stop_flag.clone();\n        let events_processed_clone = events_processed.clone();\n        let queue_size_clone = queue_size.clone();\n        let state_clone = state.clone();\n        let receiver_clone = rx.clone(); \n\n        let db_shared_for_thread = Arc::new(Mutex::new(None::\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e));\n        let db_captured_for_thread = db_shared_for_thread.clone();\n\n        let processor_thread = thread::spawn(move || {\n            let mut debouncer = EventDebouncer::new(config_clone.debounce_ms);\n\n            while !stop_flag_clone.load(Ordering::Relaxed) { \n                let current_state = { state_clone.lock().unwrap().clone() };\n\n                if current_state == WatcherState::Paused {\n                    thread::sleep(Duration::from_millis(100));\n                    continue;\n                }\n                if current_state == WatcherState::ShuttingDown || current_state == WatcherState::Stopped {\n                    break;\n                }\n\n                let mut received_in_batch = 0;\n                while let Ok(evt_res) = receiver_clone.try_recv() {\n                    received_in_batch +=1;\n                    match evt_res {\n                        Ok(event) =\u003e {\n                            for path in event.paths {\n                                let prio = match event.kind {\n                                    EventKind::Create(_) =\u003e EventPriority::Create,\n                                    EventKind::Remove(_) =\u003e EventPriority::Delete,\n                                    EventKind::Modify(_) =\u003e EventPriority::Modify,\n                                    EventKind::Access(_) =\u003e EventPriority::Access,\n                                    _ =\u003e EventPriority::Modify,\n                                };\n                                debouncer.add_event(ProcessedEvent {\n                                    path,\n                                    kind: event.kind.clone(),\n                                    priority: prio,\n                                    timestamp: Instant::now(),\n                                });\n                            }\n                        }\n                        Err(e) =\u003e {\n                            eprintln!(\"Watcher channel error: {:?}\", e);\n                        }\n                    }\n                    if received_in_batch \u003e= config_clone.batch_size {\n                        break;\n                    }\n                }\n\n                queue_size_clone.store(debouncer.len(), Ordering::SeqCst);\n\n                if debouncer.is_ready_to_flush() \u0026\u0026 debouncer.len() \u003e 0 {\n                    let evts_to_process = debouncer.flush();\n                    let num_evts = evts_to_process.len();\n                    events_processed_clone.fetch_add(num_evts, Ordering::SeqCst);\n\n                    let db_guard_option = db_captured_for_thread.lock().unwrap();\n                    if let Some(db_mutex) = \u0026*db_guard_option {\n                        let mut _db_instance_guard = db_mutex.lock().unwrap();\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (DB available): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    } else {\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (no DB): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    }\n                }\n                thread::sleep(Duration::from_millis(50));\n            }\n\n            if debouncer.len() \u003e 0 {\n                let final_evts = debouncer.flush();\n                events_processed_clone.fetch_add(final_evts.len(), Ordering::SeqCst);\n                for processed_event in final_evts {\n                    println!(\n                        \"Processing final event: {:?} for path {:?}\",\n                        processed_event.kind, processed_event.path\n                    );\n                }\n            }\n            let mut final_state_guard = state_clone.lock().unwrap();\n            *final_state_guard = WatcherState::Stopped;\n        });\n\n        Ok(Self {\n            state,\n            config,\n            watched_paths: paths,\n            event_receiver: rx,\n            watcher: actual_watcher,\n            processor_thread: Some(processor_thread),\n            stop_flag,\n            events_processed,\n            queue_size,\n            start_time: Instant::now(),\n            db_shared: db_shared_for_thread,\n        })\n    }\n\n    pub fn with_database(\u0026mut self, db_arc: Arc\u003cMutex\u003cDatabase\u003e\u003e) -\u003e \u0026mut Self {\n        { \n            let mut shared_db_guard = self.db_shared.lock().unwrap();\n            *shared_db_guard = Some(db_arc);\n        } \n        self\n    }\n\n    pub fn start(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        if *state_guard == WatcherState::Watching || self.processor_thread.is_none() {\n            if self.processor_thread.is_none() {\n                return Err(anyhow::anyhow!(\"Watcher thread not available to start.\"));\n            }\n            if *state_guard == WatcherState::Initializing {\n                 *state_guard = WatcherState::Watching;\n            }\n            return Ok(());\n        }\n        if *state_guard != WatcherState::Initializing \u0026\u0026 *state_guard != WatcherState::Stopped \u0026\u0026 *state_guard != WatcherState::Paused {\n            return Err(anyhow::anyhow!(format!(\"Cannot start watcher from state {:?}\", *state_guard)));\n        }\n\n        *state_guard = WatcherState::Watching;\n        Ok(())\n    }\n\n    pub fn pause(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Watching =\u003e {\n                *state_guard = WatcherState::Paused;\n                Ok(())\n            }\n            WatcherState::Paused =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in watching state to pause (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn resume(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Paused =\u003e {\n                *state_guard = WatcherState::Watching;\n                Ok(())\n            }\n            WatcherState::Watching =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in paused state to resume (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn stop(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut current_state_guard = self.state.lock().unwrap();\n        if *current_state_guard == WatcherState::Stopped || *current_state_guard == WatcherState::ShuttingDown {\n            return Ok(());\n        }\n        *current_state_guard = WatcherState::ShuttingDown;\n        drop(current_state_guard);\n\n        self.stop_flag.store(true, Ordering::SeqCst);\n\n        if let Some(handle) = self.processor_thread.take() {\n            match handle.join() {\n                Ok(_) =\u003e { /* Thread joined cleanly */ }\n                Err(join_err) =\u003e {\n                    eprintln!(\"Watcher processor thread panicked: {:?}\", join_err);\n                }\n            }\n        }\n        \n        let mut final_state_guard = self.state.lock().unwrap();\n        *final_state_guard = WatcherState::Stopped;\n        Ok(())\n    }\n\n    pub fn status(\u0026self) -\u003e WatcherStatus {\n        let state_guard = self.state.lock().unwrap().clone();\n        WatcherStatus {\n            state: state_guard,\n            events_processed: self.events_processed.load(Ordering::SeqCst),\n            queue_size: self.queue_size.load(Ordering::SeqCst),\n            start_time: Some(self.start_time),\n            watched_paths: self.watched_paths.clone(),\n        }\n    }\n}\n\nimpl Drop for FileWatcher {\n    fn drop(\u0026mut self) {\n        if let Err(e) = self.stop() {\n            eprintln!(\"Error stopping watcher in Drop: {:?}\", e);\n        }\n    }\n}\n\n\n#[cfg(test)]\nmod file_watcher_state_tests { \n    use super::*;\n    use tempfile::tempdir;\n    use std::fs as FsMod; // Alias to avoid conflict with local `fs` module name if any\n\n    #[test]\n    fn test_watcher_pause_resume_stop() {\n        let tmp_dir = tempdir().unwrap();\n        let watch_path = tmp_dir.path().to_path_buf();\n        FsMod::create_dir_all(\u0026watch_path).expect(\"Failed to create temp dir for watching\");\n\n        let config = WatcherConfig::default();\n\n        let mut watcher = FileWatcher::new(vec![watch_path], config).expect(\"Failed to create watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Initializing);\n\n        watcher.start().expect(\"Start failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.pause().expect(\"Pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.pause().expect(\"Second pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.resume().expect(\"Resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        watcher.resume().expect(\"Second resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.stop().expect(\"Stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n\n        watcher.stop().expect(\"Second stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n    }\n\n    #[test]\n    fn test_watcher_start_errors() {\n        let tmp_dir = tempdir().unwrap();\n        FsMod::create_dir_all(tmp_dir.path()).expect(\"Failed to create temp dir for watching\");\n        let mut watcher = FileWatcher::new(vec![tmp_dir.path().to_path_buf()], WatcherConfig::default()).unwrap();\n        \n        {\n            let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::Watching; \n        }\n        assert!(watcher.start().is_ok(), \"Should be able to call start when already Watching (idempotent state change)\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        {\n             let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::ShuttingDown;\n        }\n        assert!(watcher.start().is_err(), \"Should not be able to start from ShuttingDown\");\n    }\n\n     #[test]\n    fn test_new_watcher_with_nonexistent_path() {\n        let non_existent_path = PathBuf::from(\"/path/that/REALLY/does/not/exist/for/sure/and/cannot/be/created\");\n        let config = WatcherConfig::default();\n        let watcher_result = FileWatcher::new(vec![non_existent_path], config);\n        assert!(watcher_result.is_err());\n        if let Err(e) = watcher_result {\n            let err_string = e.to_string();\n            assert!(err_string.contains(\"Failed to watch path\") || err_string.contains(\"os error 2\"), \"Error was: {}\", err_string);\n        }\n    }\n\n    #[test]\n    fn test_watcher_default_config() {\n        let config = WatcherConfig::default(); \n        assert_eq!(config.debounce_ms, 100);\n        assert_eq!(config.batch_size, 1000);\n        assert_eq!(config.max_queue_size, 100_000);\n        assert_eq!(config.drain_timeout_ms, 5000);\n    }\n}","traces":[{"line":38,"address":[5542400],"length":1,"stats":{"Line":1}},{"line":91,"address":[2059012,2059006,2058864],"length":1,"stats":{"Line":1}},{"line":93,"address":[2058893],"length":1,"stats":{"Line":1}},{"line":95,"address":[2058898],"length":1,"stats":{"Line":1}},{"line":99,"address":[2059024,2059653],"length":1,"stats":{"Line":1}},{"line":100,"address":[2059049,2059126],"length":1,"stats":{"Line":2}},{"line":101,"address":[2059204,2059139],"length":1,"stats":{"Line":4}},{"line":103,"address":[2059261],"length":1,"stats":{"Line":3}},{"line":105,"address":[2059239,2059275],"length":1,"stats":{"Line":4}},{"line":106,"address":[2059313],"length":1,"stats":{"Line":1}},{"line":107,"address":[2059576,2059331,2059496],"length":1,"stats":{"Line":2}},{"line":108,"address":[2059570],"length":1,"stats":{"Line":0}},{"line":110,"address":[2059512],"length":1,"stats":{"Line":1}},{"line":111,"address":[5543146],"length":1,"stats":{"Line":1}},{"line":114,"address":[2059363],"length":1,"stats":{"Line":2}},{"line":119,"address":[2059696],"length":1,"stats":{"Line":1}},{"line":120,"address":[2059710],"length":1,"stats":{"Line":1}},{"line":123,"address":[2060031,2060025,2059776],"length":1,"stats":{"Line":2}},{"line":124,"address":[2059819],"length":1,"stats":{"Line":5}},{"line":125,"address":[2004170,2004160],"length":1,"stats":{"Line":5}},{"line":126,"address":[2059940],"length":1,"stats":{"Line":1}},{"line":127,"address":[2059991],"length":1,"stats":{"Line":1}},{"line":131,"address":[2060048],"length":1,"stats":{"Line":2}},{"line":132,"address":[5543701],"length":1,"stats":{"Line":2}},{"line":310,"address":[2060064,2063925,2063163],"length":1,"stats":{"Line":1}},{"line":311,"address":[5543751,5543927],"length":1,"stats":{"Line":2}},{"line":312,"address":[2060433,2060369],"length":1,"stats":{"Line":2}},{"line":313,"address":[2060524,2060588],"length":1,"stats":{"Line":2}},{"line":314,"address":[2060675,2060755],"length":1,"stats":{"Line":2}},{"line":316,"address":[2060910,2060850],"length":1,"stats":{"Line":2}},{"line":318,"address":[2060990,2061070],"length":1,"stats":{"Line":2}},{"line":320,"address":[2004268,2004176,2004274],"length":1,"stats":{"Line":2}},{"line":321,"address":[2004191],"length":1,"stats":{"Line":1}},{"line":325,"address":[2061110],"length":1,"stats":{"Line":1}},{"line":328,"address":[5545137,5545221],"length":1,"stats":{"Line":2}},{"line":329,"address":[2063555,2063405],"length":1,"stats":{"Line":2}},{"line":330,"address":[2061644,2063397],"length":1,"stats":{"Line":2}},{"line":331,"address":[2004288,2004310],"length":1,"stats":{"Line":3}},{"line":334,"address":[2061680],"length":1,"stats":{"Line":1}},{"line":335,"address":[2061687],"length":1,"stats":{"Line":1}},{"line":336,"address":[2061740,2061798],"length":1,"stats":{"Line":2}},{"line":337,"address":[5545506,5545573],"length":1,"stats":{"Line":2}},{"line":338,"address":[2061901,2061956],"length":1,"stats":{"Line":2}},{"line":339,"address":[2062045,2061980],"length":1,"stats":{"Line":2}},{"line":341,"address":[2062069,2062150],"length":1,"stats":{"Line":2}},{"line":342,"address":[2062237,2062183],"length":1,"stats":{"Line":2}},{"line":344,"address":[2062245],"length":1,"stats":{"Line":2}},{"line":345,"address":[2004479,2004570],"length":1,"stats":{"Line":2}},{"line":347,"address":[2004580,2004648],"length":1,"stats":{"Line":2}},{"line":348,"address":[2004760,2004699],"length":1,"stats":{"Line":2}},{"line":350,"address":[2004950],"length":1,"stats":{"Line":1}},{"line":351,"address":[2005026,2008058],"length":1,"stats":{"Line":0}},{"line":354,"address":[2005058,2004992],"length":1,"stats":{"Line":2}},{"line":358,"address":[2005114],"length":1,"stats":{"Line":1}},{"line":359,"address":[2006547,2005222,2005142],"length":1,"stats":{"Line":3}},{"line":360,"address":[2005272,2005346],"length":1,"stats":{"Line":1}},{"line":361,"address":[2005313],"length":1,"stats":{"Line":1}},{"line":362,"address":[2005521],"length":1,"stats":{"Line":1}},{"line":363,"address":[2005577,2005815,2005680],"length":1,"stats":{"Line":3}},{"line":364,"address":[2005884],"length":1,"stats":{"Line":1}},{"line":365,"address":[2006022],"length":1,"stats":{"Line":1}},{"line":366,"address":[2006042],"length":1,"stats":{"Line":1}},{"line":367,"address":[2006032],"length":1,"stats":{"Line":1}},{"line":368,"address":[2006012],"length":1,"stats":{"Line":1}},{"line":369,"address":[2006002],"length":1,"stats":{"Line":0}},{"line":371,"address":[2006268],"length":1,"stats":{"Line":1}},{"line":372,"address":[5524074],"length":1,"stats":{"Line":1}},{"line":373,"address":[2006082,2006155],"length":1,"stats":{"Line":2}},{"line":374,"address":[2006206],"length":1,"stats":{"Line":1}},{"line":375,"address":[2006220],"length":1,"stats":{"Line":1}},{"line":379,"address":[2005423],"length":1,"stats":{"Line":0}},{"line":380,"address":[2005511,2006432],"length":1,"stats":{"Line":0}},{"line":383,"address":[2005979],"length":1,"stats":{"Line":1}},{"line":388,"address":[2006663,2006719],"length":1,"stats":{"Line":2}},{"line":390,"address":[2006781,2006846],"length":1,"stats":{"Line":2}},{"line":391,"address":[2006891],"length":1,"stats":{"Line":1}},{"line":392,"address":[2006906,2006977],"length":1,"stats":{"Line":2}},{"line":393,"address":[2006985],"length":1,"stats":{"Line":1}},{"line":395,"address":[5525091],"length":1,"stats":{"Line":1}},{"line":396,"address":[5525293,5525214],"length":1,"stats":{"Line":2}},{"line":397,"address":[5525335,5525397],"length":1,"stats":{"Line":0}},{"line":398,"address":[2007409,2007476],"length":1,"stats":{"Line":0}},{"line":399,"address":[5525665,5525734],"length":1,"stats":{"Line":0}},{"line":405,"address":[5525856,5525354],"length":1,"stats":{"Line":2}},{"line":406,"address":[5526046,5525965],"length":1,"stats":{"Line":2}},{"line":413,"address":[5526025,5524841],"length":1,"stats":{"Line":2}},{"line":416,"address":[2008588,2004726,2008082],"length":1,"stats":{"Line":2}},{"line":417,"address":[5526247],"length":1,"stats":{"Line":0}},{"line":418,"address":[5526331,5526270],"length":1,"stats":{"Line":0}},{"line":419,"address":[5526388,5526590],"length":1,"stats":{"Line":0}},{"line":420,"address":[2008539,2008843],"length":1,"stats":{"Line":0}},{"line":426,"address":[5526742,5526208],"length":1,"stats":{"Line":2}},{"line":427,"address":[2008743,2008670],"length":1,"stats":{"Line":2}},{"line":430,"address":[5546512],"length":1,"stats":{"Line":1}},{"line":431,"address":[5546176],"length":1,"stats":{"Line":1}},{"line":433,"address":[2062476],"length":1,"stats":{"Line":1}},{"line":434,"address":[2062507],"length":1,"stats":{"Line":1}},{"line":435,"address":[5546271],"length":1,"stats":{"Line":1}},{"line":436,"address":[5546311],"length":1,"stats":{"Line":1}},{"line":437,"address":[5546343],"length":1,"stats":{"Line":1}},{"line":438,"address":[2062643],"length":1,"stats":{"Line":1}},{"line":439,"address":[2062667],"length":1,"stats":{"Line":1}},{"line":440,"address":[5546415],"length":1,"stats":{"Line":1}},{"line":441,"address":[2062776],"length":1,"stats":{"Line":1}},{"line":445,"address":[2064322,2064316,2063968],"length":1,"stats":{"Line":0}},{"line":447,"address":[2064066,2064005],"length":1,"stats":{"Line":0}},{"line":448,"address":[5548035,5547941,5547982,5548140],"length":1,"stats":{"Line":0}},{"line":450,"address":[5547798],"length":1,"stats":{"Line":0}},{"line":453,"address":[5549403,5549178,5548192],"length":1,"stats":{"Line":1}},{"line":454,"address":[5548215],"length":1,"stats":{"Line":1}},{"line":455,"address":[5548480,5548306,5548385],"length":1,"stats":{"Line":3}},{"line":456,"address":[2064587,2065274],"length":1,"stats":{"Line":2}},{"line":457,"address":[5549218,5549350],"length":1,"stats":{"Line":0}},{"line":459,"address":[5549249,5549194,5549340],"length":1,"stats":{"Line":2}},{"line":460,"address":[2065376],"length":1,"stats":{"Line":0}},{"line":462,"address":[5549277],"length":1,"stats":{"Line":1}},{"line":464,"address":[5548582,5548486],"length":1,"stats":{"Line":2}},{"line":465,"address":[5548986,5549156,5548707,5548792],"length":1,"stats":{"Line":2}},{"line":468,"address":[5548547,5548736],"length":1,"stats":{"Line":2}},{"line":469,"address":[5548745],"length":1,"stats":{"Line":1}},{"line":472,"address":[5549424,5550085,5550079],"length":1,"stats":{"Line":1}},{"line":473,"address":[2065519],"length":1,"stats":{"Line":1}},{"line":474,"address":[2065588,2065642],"length":1,"stats":{"Line":2}},{"line":476,"address":[5549674,5549632],"length":1,"stats":{"Line":2}},{"line":477,"address":[2065732],"length":1,"stats":{"Line":1}},{"line":479,"address":[2065710],"length":1,"stats":{"Line":1}},{"line":480,"address":[2065676,2065777,2065949],"length":1,"stats":{"Line":0}},{"line":484,"address":[5550769,5550775,5550112],"length":1,"stats":{"Line":1}},{"line":485,"address":[2066159],"length":1,"stats":{"Line":1}},{"line":486,"address":[5550203,5550270],"length":1,"stats":{"Line":2}},{"line":488,"address":[2066389,2066339],"length":1,"stats":{"Line":2}},{"line":489,"address":[2066395],"length":1,"stats":{"Line":1}},{"line":491,"address":[5550320],"length":1,"stats":{"Line":1}},{"line":492,"address":[2066591,2066316,2066419],"length":1,"stats":{"Line":0}},{"line":496,"address":[2067872,2067606,2066784],"length":1,"stats":{"Line":1}},{"line":497,"address":[2066804],"length":1,"stats":{"Line":1}},{"line":498,"address":[5550918,5550985,5551072],"length":1,"stats":{"Line":3}},{"line":499,"address":[2066998],"length":1,"stats":{"Line":1}},{"line":501,"address":[5551100],"length":1,"stats":{"Line":1}},{"line":502,"address":[2067102],"length":1,"stats":{"Line":1}},{"line":504,"address":[2067135],"length":1,"stats":{"Line":1}},{"line":506,"address":[2067193],"length":1,"stats":{"Line":1}},{"line":507,"address":[5551422,5551343],"length":1,"stats":{"Line":2}},{"line":509,"address":[2067416],"length":1,"stats":{"Line":0}},{"line":510,"address":[2067464,2067515],"length":1,"stats":{"Line":0}},{"line":515,"address":[2067683,2067635],"length":1,"stats":{"Line":2}},{"line":516,"address":[2067747,2067818],"length":1,"stats":{"Line":2}},{"line":517,"address":[2067827],"length":1,"stats":{"Line":1}},{"line":520,"address":[5551984,5552406,5552412],"length":1,"stats":{"Line":1}},{"line":521,"address":[2067942],"length":1,"stats":{"Line":1}},{"line":524,"address":[5552195],"length":1,"stats":{"Line":1}},{"line":525,"address":[2068130],"length":1,"stats":{"Line":1}},{"line":526,"address":[2068167],"length":1,"stats":{"Line":1}},{"line":527,"address":[2068183],"length":1,"stats":{"Line":1}},{"line":533,"address":[2001554,2001560,2001328],"length":1,"stats":{"Line":1}},{"line":534,"address":[2001340],"length":1,"stats":{"Line":1}},{"line":535,"address":[2001410,2001484],"length":1,"stats":{"Line":0}}],"covered":134,"coverable":157},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher_tests.rs"],"content":"//! Tests for the file system watcher functionality\n\n#[cfg(test)]\nmod tests {\n    // Updated import for BackupManager from the new backup module\n    use crate::backup::BackupManager;\n    // These are still from the watcher module\n    use crate::watcher::{FileWatcher, WatcherConfig, WatcherState};\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n\n\n    use std::fs::{self, File};\n    use std::io::Write;\n    // No longer need: use std::path::PathBuf;\n    use std::thread;\n    use std::time::Duration;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_watcher_lifecycle() {\n        // Create a temp directory for testing\n        let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n        let temp_path = temp_dir.path();\n\n        // Create a test file\n        let test_file_path = temp_path.join(\"test.txt\");\n        let mut file = File::create(\u0026test_file_path).expect(\"Failed to create test file\");\n        writeln!(file, \"Test content\").expect(\"Failed to write to test file\");\n        drop(file);\n\n        // Configure and start the watcher\n        let config = WatcherConfig {\n            debounce_ms: 100,\n            batch_size: 10,\n            max_queue_size: 100,\n            drain_timeout_ms: 1000,\n        };\n\n        let mut watcher = FileWatcher::new(vec![temp_path.to_path_buf()], config)\n            .expect(\"Failed to create watcher\");\n\n        watcher.start().expect(\"Failed to start watcher\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        thread::sleep(Duration::from_millis(200));\n        let new_file_path = temp_path.join(\"new_file.txt\");\n        let mut new_file_handle = File::create(\u0026new_file_path).expect(\"Failed to create new file\");\n        writeln!(new_file_handle, \"New file content\").expect(\"Failed to write to new file\");\n        drop(new_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        let mut existing_file_handle = fs::OpenOptions::new()\n            .write(true)\n            .append(true)\n            .open(\u0026test_file_path)\n            .expect(\"Failed to open test file for modification\");\n        writeln!(existing_file_handle, \"Additional content\").expect(\"Failed to append to test file\");\n        drop(existing_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        fs::remove_file(\u0026new_file_path).expect(\"Failed to remove file\");\n\n        thread::sleep(Duration::from_millis(500));\n        watcher.stop().expect(\"Failed to stop watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n        assert!(watcher.status().events_processed \u003e 0, \"Expected some file events to be processed\");\n    }\n\n    #[test]\n    fn test_backup_manager_related_functionality() {\n        let live_db_tmp_dir = tempdir().expect(\"Failed to create temp directory for live DB\");\n        let backups_storage_tmp_dir = tempdir().expect(\"Failed to create temp directory for backups storage\");\n        \n        let live_db_path = live_db_tmp_dir.path().join(\"test_live_watcher.db\"); // Unique name\n        let backups_actual_dir = backups_storage_tmp_dir.path().join(\"my_backups_watcher\"); // Unique name\n\n        // Initialize a proper SQLite DB for the \"live\" database\n        let _conn = open_marlin_db(\u0026live_db_path).expect(\"Failed to open test_live_watcher.db for backup test\");\n        \n        let backup_manager = BackupManager::new(\u0026live_db_path, \u0026backups_actual_dir)\n            .expect(\"Failed to create BackupManager instance\");\n        \n        let backup_info = backup_manager.create_backup().expect(\"Failed to create first backup\");\n        \n        assert!(backups_actual_dir.join(\u0026backup_info.id).exists(), \"Backup file should exist\");\n        assert!(backup_info.size_bytes \u003e 0, \"Backup size should be greater than 0\");\n        \n        for i in 0..3 {\n            std::thread::sleep(std::time::Duration::from_millis(30)); // Ensure timestamp difference\n            backup_manager.create_backup().unwrap_or_else(|e| panic!(\"Failed to create additional backup {}: {:?}\", i, e));\n        }\n        \n        let backups = backup_manager.list_backups().expect(\"Failed to list backups\");\n        assert_eq!(backups.len(), 4, \"Should have 4 backups listed\");\n        \n        let prune_result = backup_manager.prune(2).expect(\"Failed to prune backups\");\n        \n        assert_eq!(prune_result.kept.len(), 2, \"Should have kept 2 backups\");\n        assert_eq!(prune_result.removed.len(), 2, \"Should have removed 2 backups (4 initial - 2 kept)\");\n        \n        let remaining_backups = backup_manager.list_backups().expect(\"Failed to list backups after prune\");\n        assert_eq!(remaining_backups.len(), 2, \"Should have 2 backups remaining after prune\");\n\n        for removed_info in prune_result.removed {\n            assert!(!backups_actual_dir.join(\u0026removed_info.id).exists(), \"Removed backup file {} should not exist\", removed_info.id);\n        }\n        for kept_info in prune_result.kept {\n            assert!(backups_actual_dir.join(\u0026kept_info.id).exists(), \"Kept backup file {} should exist\", kept_info.id);\n        }\n    }\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","tui-bin","src","main.rs"],"content":"// tui-bin/src/main.rs\n\nfn main() {\n    eprintln!(\"marlin-tui is not yet implemented. Stay tuned!\");\n}\n","traces":[{"line":3,"address":[127488],"length":1,"stats":{"Line":0}},{"line":4,"address":[127492],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2}]};
+        var data = {"files":[{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","build.rs"],"content":"// cli-bin/build.rs\n//\n// Build script to generate the CLI cheatsheet at compile time.  It\n// parses `src/cli/commands.yaml` and emits a simple Markdown table of\n// commands and flags to `docs/cli_cheatsheet.md`.\n\nuse std::{fs, path::Path};\n\nuse serde_yaml::Value;\n\nfn main() {\n    println!(\"cargo:rerun-if-changed=build.rs\");\n    println!(\"cargo:rerun-if-changed=src/cli/commands.yaml\");\n\n    if let Err(e) = generate_cheatsheet() {\n        eprintln!(\"Failed to generate CLI cheatsheet: {e}\");\n        std::process::exit(1);\n    }\n}\n\nfn generate_cheatsheet() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    let yaml_str = fs::read_to_string(\"src/cli/commands.yaml\")?;\n    let parsed: Value = serde_yaml::from_str(\u0026yaml_str)?;\n\n    let mut table = String::from(\"| Command | Flags |\\n| ------- | ----- |\\n\");\n\n    if let Value::Mapping(cmds) = parsed {\n        for (cmd_name_val, cmd_details_val) in cmds {\n            let cmd_name = cmd_name_val.as_str().unwrap_or(\"\");\n            if let Value::Mapping(cmd_details) = cmd_details_val {\n                if let Some(Value::Mapping(actions)) = cmd_details.get(\u0026Value::String(\"actions\".into())) {\n                    for (action_name_val, action_body_val) in actions {\n                        let action_name = action_name_val.as_str().unwrap_or(\"\");\n                        let flags = if let Value::Mapping(action_map) = action_body_val {\n                            match action_map.get(\u0026Value::String(\"flags\".into())) {\n                                Some(Value::Sequence(seq)) =\u003e seq\n                                    .iter()\n                                    .filter_map(|v| v.as_str())\n                                    .collect::\u003cVec\u003c_\u003e\u003e()\n                                    .join(\", \"),\n                                _ =\u003e String::new(),\n                            }\n                        } else {\n                            String::new()\n                        };\n\n                        let flags_disp = if flags.is_empty() { \"—\" } else { \u0026flags };\n                        table.push_str(\u0026format!(\"| `{}` | {} |\\n\", format!(\"{} {}\", cmd_name, action_name), flags_disp));\n                    }\n                }\n            }\n        }\n    }\n\n    fs::create_dir_all(Path::new(\"docs\"))?;\n    fs::write(\"docs/cli_cheatsheet.md\", table)?;\n\n    Ok(())\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","annotate.rs"],"content":"// src/cli/annotate.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum AnnotateCmd {\n    Add (ArgsAdd),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub note: String,\n    #[arg(long)] pub range: Option\u003cString\u003e,\n    #[arg(long)] pub highlight: bool,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsList { pub file_pattern: String }\n\npub fn run(cmd: \u0026AnnotateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        AnnotateCmd::Add(a)  =\u003e todo!(\"annotate add {:?}\", a),\n        AnnotateCmd::List(a) =\u003e todo!(\"annotate list {:?}\", a),\n    }\n}\n","traces":[{"line":23,"address":[2405584],"length":1,"stats":{"Line":0}},{"line":24,"address":[2405623],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","coll.rs"],"content":"//! `marlin coll …` – named collections of files (simple “playlists”).\n\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // local enum for text / json output\nuse libmarlin::db;        // core DB helpers from the library crate\n\n#[derive(Subcommand, Debug)]\npub enum CollCmd {\n    /// Create an empty collection\n    Create(CreateArgs),\n    /// Add files (glob) to a collection\n    Add(AddArgs),\n    /// List files inside a collection\n    List(ListArgs),\n}\n\n#[derive(Args, Debug)]\npub struct CreateArgs {\n    pub name: String,\n}\n\n#[derive(Args, Debug)]\npub struct AddArgs {\n    pub name: String,\n    pub file_pattern: String,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub name: String,\n}\n\n/// Look-up an existing collection **without** implicitly creating it.\n///\n/// Returns the collection ID or an error if it doesn’t exist.\nfn lookup_collection_id(conn: \u0026Connection, name: \u0026str) -\u003e anyhow::Result\u003ci64\u003e {\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        [name],\n        |r| r.get(0),\n    )\n    .map_err(|_| anyhow::anyhow!(\"collection not found: {}\", name))\n}\n\npub fn run(cmd: \u0026CollCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── coll create ──────────────────────────────────────────── */\n        CollCmd::Create(a) =\u003e {\n            db::ensure_collection(conn, \u0026a.name)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Created collection '{}'\", a.name);\n            }\n        }\n\n        /* ── coll add ─────────────────────────────────────────────── */\n        CollCmd::Add(a) =\u003e {\n            // Fail if the target collection does not yet exist\n            let coll_id = lookup_collection_id(conn, \u0026a.name)?;\n\n            let like = a.file_pattern.replace('*', \"%\");\n            let mut stmt = conn.prepare(\"SELECT id FROM files WHERE path LIKE ?1\")?;\n            let ids: Vec\u003ci64\u003e = stmt\n                .query_map([\u0026like], |r| r.get::\u003c_, i64\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            for fid in \u0026ids {\n                db::add_file_to_collection(conn, coll_id, *fid)?;\n            }\n\n            match fmt {\n                Format::Text =\u003e println!(\"Added {} file(s) → '{}'\", ids.len(), a.name),\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\n                            \"{{\\\"collection\\\":\\\"{}\\\",\\\"added\\\":{}}}\",\n                            a.name,\n                            ids.len()\n                        );\n                    }\n                }\n            }\n        }\n\n        /* ── coll list ────────────────────────────────────────────── */\n        CollCmd::List(a) =\u003e {\n            let files = db::list_collection(conn, \u0026a.name)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for f in files {\n                        println!(\"{f}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026files)?);\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":38,"address":[2196208],"length":1,"stats":{"Line":0}},{"line":39,"address":[2196253],"length":1,"stats":{"Line":0}},{"line":41,"address":[2196233],"length":1,"stats":{"Line":0}},{"line":42,"address":[2489344,2489328],"length":1,"stats":{"Line":0}},{"line":44,"address":[2489376,2489393],"length":1,"stats":{"Line":0}},{"line":47,"address":[2198679,2196320,2198609],"length":1,"stats":{"Line":0}},{"line":48,"address":[2196371],"length":1,"stats":{"Line":0}},{"line":50,"address":[2196454],"length":1,"stats":{"Line":0}},{"line":51,"address":[2196745,2196471],"length":1,"stats":{"Line":0}},{"line":52,"address":[2196810],"length":1,"stats":{"Line":0}},{"line":53,"address":[2196826],"length":1,"stats":{"Line":0}},{"line":58,"address":[2196546],"length":1,"stats":{"Line":0}},{"line":60,"address":[2196943,2196554],"length":1,"stats":{"Line":0}},{"line":62,"address":[2197008],"length":1,"stats":{"Line":0}},{"line":63,"address":[2197060,2198669,2197131],"length":1,"stats":{"Line":0}},{"line":64,"address":[2197570,2197678,2197463,2197883,2198620],"length":1,"stats":{"Line":0}},{"line":65,"address":[2197455,2197614],"length":1,"stats":{"Line":0}},{"line":68,"address":[2197981,2198064],"length":1,"stats":{"Line":0}},{"line":69,"address":[2198455,2198174],"length":1,"stats":{"Line":0}},{"line":72,"address":[2198203],"length":1,"stats":{"Line":0}},{"line":73,"address":[2198246],"length":1,"stats":{"Line":0}},{"line":88,"address":[2196628],"length":1,"stats":{"Line":0}},{"line":89,"address":[2196640,2198692,2198749],"length":1,"stats":{"Line":0}},{"line":90,"address":[2198853],"length":1,"stats":{"Line":0}},{"line":92,"address":[2198885,2198993,2199128],"length":1,"stats":{"Line":0}},{"line":93,"address":[2199197,2199290],"length":1,"stats":{"Line":0}},{"line":105,"address":[2196915],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":27},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","event.rs"],"content":"// src/cli/event.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum EventCmd {\n    Add     (ArgsAdd),\n    Timeline,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub date: String,\n    pub description: String,\n}\n\npub fn run(cmd: \u0026EventCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        EventCmd::Add(a)      =\u003e todo!(\"event add {:?}\", a),\n        EventCmd::Timeline    =\u003e todo!(\"event timeline\"),\n    }\n}\n","traces":[{"line":19,"address":[2067392],"length":1,"stats":{"Line":0}},{"line":20,"address":[2067431],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","link.rs"],"content":"//! src/cli/link.rs – manage typed relationships between files\n\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector\nuse libmarlin::db;        // ← switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum LinkCmd {\n    Add(LinkArgs),\n    Rm (LinkArgs),\n    List(ListArgs),\n    Backlinks(BacklinksArgs),\n}\n\n#[derive(Args, Debug)]\npub struct LinkArgs {\n    pub from: String,\n    pub to:   String,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub pattern: String,\n    #[arg(long)]\n    pub direction: Option\u003cString\u003e,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct BacklinksArgs {\n    pub pattern: String,\n}\n\npub fn run(cmd: \u0026LinkCmd, conn: \u0026mut Connection, format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        LinkCmd::Add(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::add_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Linked '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Linked '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::Rm(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::remove_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Removed link '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Removed link '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::List(args) =\u003e {\n            let results = db::list_links(\n                conn,\n                \u0026args.pattern,\n                args.direction.as_deref(),\n                args.r#type.as_deref(),\n            )?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, dst, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\n                                \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                                src, dst, typ\n                            )\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, dst, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} → {} [type='{}']\", src, dst, t);\n                        } else {\n                            println!(\"{} → {}\", src, dst);\n                        }\n                    }\n                }\n            }\n        }\n        LinkCmd::Backlinks(args) =\u003e {\n            let results = db::find_backlinks(conn, \u0026args.pattern)?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\"{{\\\"from\\\":\\\"{}\\\",\\\"type\\\":{}}}\", src, typ)\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} [type='{}']\", src, t);\n                        } else {\n                            println!(\"{}\", src);\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":39,"address":[2455936,2457769,2457763],"length":1,"stats":{"Line":0}},{"line":40,"address":[2455993],"length":1,"stats":{"Line":0}},{"line":41,"address":[2456070],"length":1,"stats":{"Line":0}},{"line":42,"address":[2456090,2456628],"length":1,"stats":{"Line":0}},{"line":43,"address":[2456699],"length":1,"stats":{"Line":0}},{"line":44,"address":[2456838],"length":1,"stats":{"Line":0}},{"line":45,"address":[2456975],"length":1,"stats":{"Line":0}},{"line":47,"address":[2457093],"length":1,"stats":{"Line":0}},{"line":48,"address":[2457163],"length":1,"stats":{"Line":0}},{"line":50,"address":[2457377],"length":1,"stats":{"Line":0}},{"line":54,"address":[2456996],"length":1,"stats":{"Line":0}},{"line":57,"address":[2499408,2499429],"length":1,"stats":{"Line":0}},{"line":58,"address":[2499536,2499548],"length":1,"stats":{"Line":0}},{"line":59,"address":[2457063,2457593],"length":1,"stats":{"Line":0}},{"line":66,"address":[2456171],"length":1,"stats":{"Line":0}},{"line":67,"address":[2456191,2457798],"length":1,"stats":{"Line":0}},{"line":68,"address":[2457866],"length":1,"stats":{"Line":0}},{"line":69,"address":[2458005],"length":1,"stats":{"Line":0}},{"line":70,"address":[2458142],"length":1,"stats":{"Line":0}},{"line":72,"address":[2458260],"length":1,"stats":{"Line":0}},{"line":73,"address":[2458330],"length":1,"stats":{"Line":0}},{"line":75,"address":[2458544],"length":1,"stats":{"Line":0}},{"line":79,"address":[2458163],"length":1,"stats":{"Line":0}},{"line":82,"address":[2499605,2499584],"length":1,"stats":{"Line":0}},{"line":83,"address":[2499712,2499724],"length":1,"stats":{"Line":0}},{"line":84,"address":[2458748,2458230],"length":1,"stats":{"Line":0}},{"line":91,"address":[2456272],"length":1,"stats":{"Line":0}},{"line":94,"address":[2456292],"length":1,"stats":{"Line":0}},{"line":95,"address":[2456321],"length":1,"stats":{"Line":0}},{"line":96,"address":[2456355],"length":1,"stats":{"Line":0}},{"line":98,"address":[2459079],"length":1,"stats":{"Line":0}},{"line":100,"address":[2459092,2460397],"length":1,"stats":{"Line":0}},{"line":102,"address":[2500334,2499785,2499760],"length":1,"stats":{"Line":0}},{"line":103,"address":[2499838,2499913],"length":1,"stats":{"Line":0}},{"line":105,"address":[2500389,2500368],"length":1,"stats":{"Line":0}},{"line":106,"address":[2500508,2500496],"length":1,"stats":{"Line":0}},{"line":107,"address":[2499947,2500009],"length":1,"stats":{"Line":0}},{"line":113,"address":[2460427,2460510],"length":1,"stats":{"Line":0}},{"line":116,"address":[2459389,2459158,2459262],"length":1,"stats":{"Line":0}},{"line":117,"address":[2459582,2459649],"length":1,"stats":{"Line":0}},{"line":118,"address":[2459790,2459689],"length":1,"stats":{"Line":0}},{"line":120,"address":[2459716,2460069],"length":1,"stats":{"Line":0}},{"line":126,"address":[2456509],"length":1,"stats":{"Line":0}},{"line":127,"address":[2460745,2456521,2460802],"length":1,"stats":{"Line":0}},{"line":128,"address":[2460906],"length":1,"stats":{"Line":0}},{"line":130,"address":[2460919,2462044],"length":1,"stats":{"Line":0}},{"line":132,"address":[2500569,2501000,2500544],"length":1,"stats":{"Line":0}},{"line":133,"address":[2500676,2500604],"length":1,"stats":{"Line":0}},{"line":135,"address":[2501024,2501045],"length":1,"stats":{"Line":0}},{"line":136,"address":[2501164,2501152],"length":1,"stats":{"Line":0}},{"line":137,"address":[2500769,2500707],"length":1,"stats":{"Line":0}},{"line":140,"address":[2462074,2462157],"length":1,"stats":{"Line":0}},{"line":143,"address":[2461097,2460989,2461232],"length":1,"stats":{"Line":0}},{"line":144,"address":[2461448,2461377],"length":1,"stats":{"Line":0}},{"line":145,"address":[2461488,2461589],"length":1,"stats":{"Line":0}},{"line":147,"address":[2461515,2461825],"length":1,"stats":{"Line":0}},{"line":155,"address":[2457524],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":57},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","remind.rs"],"content":"// src/cli/remind.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum RemindCmd {\n    Set(ArgsSet),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet {\n    pub file_pattern: String,\n    pub timestamp:    String,\n    pub message:      String,\n}\n\npub fn run(cmd: \u0026RemindCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        RemindCmd::Set(a) =\u003e todo!(\"remind set {:?}\", a),\n    }\n}\n","traces":[{"line":18,"address":[2133952],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","state.rs"],"content":"// src/cli/state.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum StateCmd {\n    Set(ArgsSet),\n    TransitionsAdd(ArgsTrans),\n    Log(ArgsLog),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet   { pub file_pattern: String, pub new_state: String }\n#[derive(Args, Debug)]\npub struct ArgsTrans { pub from_state: String,   pub to_state: String }\n#[derive(Args, Debug)]\npub struct ArgsLog   { pub file_pattern: String }\n\npub fn run(cmd: \u0026StateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        StateCmd::Set(a)           =\u003e todo!(\"state set {:?}\", a),\n        StateCmd::TransitionsAdd(a)=\u003e todo!(\"state transitions-add {:?}\", a),\n        StateCmd::Log(a)           =\u003e todo!(\"state log {:?}\", a),\n    }\n}\n","traces":[{"line":20,"address":[2011360],"length":1,"stats":{"Line":0}},{"line":21,"address":[2011399],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","task.rs"],"content":"// src/cli/task.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum TaskCmd {\n    Scan(ArgsScan),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsScan { pub directory: String }\n#[derive(Args, Debug)]\npub struct ArgsList { #[arg(long)] pub due_today: bool }\n\npub fn run(cmd: \u0026TaskCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        TaskCmd::Scan(a) =\u003e todo!(\"task scan {:?}\", a),\n        TaskCmd::List(a) =\u003e todo!(\"task list {:?}\", a),\n    }\n}\n","traces":[{"line":17,"address":[2250768],"length":1,"stats":{"Line":0}},{"line":18,"address":[2250807],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","version.rs"],"content":"// src/cli/version.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum VersionCmd {\n    Diff(ArgsDiff),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsDiff { pub file: String }\n\npub fn run(cmd: \u0026VersionCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        VersionCmd::Diff(a) =\u003e todo!(\"version diff {:?}\", a),\n    }\n}\n","traces":[{"line":14,"address":[1999168],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","view.rs"],"content":"//! `marlin view …` – save \u0026 use “smart folders” (named queries).\n\nuse std::fs;\n\nuse anyhow::Result;\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector stays local\nuse libmarlin::db;        // ← path switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum ViewCmd {\n    /// Save (or update) a view\n    Save(ArgsSave),\n    /// List all saved views\n    List,\n    /// Execute a view (print matching paths)\n    Exec(ArgsExec),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSave {\n    pub view_name: String,\n    pub query: String,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsExec {\n    pub view_name: String,\n}\n\npub fn run(cmd: \u0026ViewCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── view save ───────────────────────────────────────────── */\n        ViewCmd::Save(a) =\u003e {\n            db::save_view(conn, \u0026a.view_name, \u0026a.query)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Saved view '{}' = {}\", a.view_name, a.query);\n            }\n        }\n\n        /* ── view list ───────────────────────────────────────────── */\n        ViewCmd::List =\u003e {\n            let views = db::list_views(conn)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for (name, q) in views {\n                        println!(\"{name}: {q}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026views)?);\n                    }\n                }\n            }\n        }\n\n        /* ── view exec ───────────────────────────────────────────── */\n        ViewCmd::Exec(a) =\u003e {\n            let raw = db::view_query(conn, \u0026a.view_name)?;\n\n            // Re-use the tiny parser from marlin search\n            let fts_expr = build_fts_match(\u0026raw);\n\n            let mut stmt = conn.prepare(\n                r#\"\n                SELECT f.path\n                  FROM files_fts\n                  JOIN files f ON f.rowid = files_fts.rowid\n                 WHERE files_fts MATCH ?1\n                 ORDER BY rank\n                \"#,\n            )?;\n            let mut paths: Vec\u003cString\u003e = stmt\n                .query_map([fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            /* ── NEW: graceful fallback when FTS finds nothing ───── */\n            if paths.is_empty() \u0026\u0026 !raw.contains(':') {\n                paths = naive_search(conn, \u0026raw)?;\n            }\n\n            if paths.is_empty() \u0026\u0026 matches!(fmt, Format::Text) {\n                eprintln!(\"(view '{}' has no matches)\", a.view_name);\n            } else {\n                for p in paths {\n                    println!(\"{p}\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\n/* ─── naive substring path/content search (≤ 64 kB files) ───────── */\n\nfn naive_search(conn: \u0026Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let term_lc = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut hits = Vec::new();\n    for p in rows {\n        let p = p?;\n        /* path match */\n        if p.to_lowercase().contains(\u0026term_lc) {\n            hits.push(p);\n            continue;\n        }\n        /* small-file content match */\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 64_000 {\n                continue;\n            }\n        }\n        if let Ok(content) = fs::read_to_string(\u0026p) {\n            if content.to_lowercase().contains(\u0026term_lc) {\n                hits.push(p);\n            }\n        }\n    }\n    Ok(hits)\n}\n\n/* ─── minimal copy of search-string → FTS5 translator ───────────── */\n\nfn build_fts_match(raw_query: \u0026str) -\u003e String {\n    use shlex;\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 {\n                    parts.push(\"AND\".into());\n                }\n                parts.push(format!(\"tags_text:{}\", escape(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n            }\n        } else {\n            parts.push(escape(\u0026tok));\n        }\n    }\n    parts.join(\" \")\n}\n\nfn escape(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n","traces":[{"line":33,"address":[2091696,2093294,2093288],"length":1,"stats":{"Line":0}},{"line":34,"address":[2091753],"length":1,"stats":{"Line":0}},{"line":36,"address":[2091869],"length":1,"stats":{"Line":0}},{"line":37,"address":[2092217,2091877],"length":1,"stats":{"Line":0}},{"line":38,"address":[2092266],"length":1,"stats":{"Line":0}},{"line":39,"address":[2092289],"length":1,"stats":{"Line":0}},{"line":45,"address":[2092464,2092518,2092004],"length":1,"stats":{"Line":0}},{"line":46,"address":[2092622],"length":1,"stats":{"Line":0}},{"line":48,"address":[2092897,2092762,2092654],"length":1,"stats":{"Line":0}},{"line":49,"address":[2092998,2093091],"length":1,"stats":{"Line":0}},{"line":62,"address":[2092093],"length":1,"stats":{"Line":0}},{"line":63,"address":[2092110,2093355],"length":1,"stats":{"Line":0}},{"line":66,"address":[2093469,2093548],"length":1,"stats":{"Line":0}},{"line":68,"address":[2095873,2093571,2093636,2093758],"length":1,"stats":{"Line":0}},{"line":77,"address":[2094048,2094115,2094223,2095825,2094432],"length":1,"stats":{"Line":0}},{"line":78,"address":[2080432,2080467],"length":1,"stats":{"Line":0}},{"line":82,"address":[2094538,2094646,2095056,2094606],"length":1,"stats":{"Line":0}},{"line":83,"address":[2094917,2095065,2094711],"length":1,"stats":{"Line":0}},{"line":86,"address":[2095209,2094612,2095126],"length":1,"stats":{"Line":0}},{"line":87,"address":[2095225],"length":1,"stats":{"Line":0}},{"line":89,"address":[2095469,2095132,2095334],"length":1,"stats":{"Line":0}},{"line":90,"address":[2095707,2095538],"length":1,"stats":{"Line":0}},{"line":95,"address":[2092436],"length":1,"stats":{"Line":0}},{"line":100,"address":[2098964,2097933,2095952],"length":1,"stats":{"Line":0}},{"line":101,"address":[2096033],"length":1,"stats":{"Line":0}},{"line":102,"address":[2098962,2096082,2096153],"length":1,"stats":{"Line":0}},{"line":103,"address":[2080496,2080531],"length":1,"stats":{"Line":0}},{"line":105,"address":[2096756],"length":1,"stats":{"Line":0}},{"line":106,"address":[2096908,2096816,2096984,2098638],"length":1,"stats":{"Line":0}},{"line":107,"address":[2097085,2097250],"length":1,"stats":{"Line":0}},{"line":109,"address":[2097536,2097468],"length":1,"stats":{"Line":0}},{"line":110,"address":[2098721],"length":1,"stats":{"Line":0}},{"line":114,"address":[2097705,2097815],"length":1,"stats":{"Line":0}},{"line":115,"address":[2097822,2097883],"length":1,"stats":{"Line":0}},{"line":119,"address":[2097939,2098030],"length":1,"stats":{"Line":0}},{"line":120,"address":[2098078,2098149],"length":1,"stats":{"Line":0}},{"line":121,"address":[2098337],"length":1,"stats":{"Line":0}},{"line":125,"address":[2097138],"length":1,"stats":{"Line":0}},{"line":130,"address":[2098992,2100686,2102308],"length":1,"stats":{"Line":0}},{"line":132,"address":[2099047],"length":1,"stats":{"Line":0}},{"line":133,"address":[2080560,2080594],"length":1,"stats":{"Line":0}},{"line":134,"address":[2102262,2099197,2099359],"length":1,"stats":{"Line":0}},{"line":135,"address":[2099444,2099659],"length":1,"stats":{"Line":0}},{"line":136,"address":[2102249,2099757],"length":1,"stats":{"Line":0}},{"line":137,"address":[2099734,2099850],"length":1,"stats":{"Line":0}},{"line":138,"address":[2080846,2080832],"length":1,"stats":{"Line":0}},{"line":139,"address":[2100252],"length":1,"stats":{"Line":0}},{"line":140,"address":[2100307],"length":1,"stats":{"Line":0}},{"line":142,"address":[2100300,2100381],"length":1,"stats":{"Line":0}},{"line":144,"address":[2100016,2100708],"length":1,"stats":{"Line":0}},{"line":145,"address":[2100830],"length":1,"stats":{"Line":0}},{"line":146,"address":[2100888],"length":1,"stats":{"Line":0}},{"line":147,"address":[2100997],"length":1,"stats":{"Line":0}},{"line":148,"address":[2101143,2101178],"length":1,"stats":{"Line":0}},{"line":149,"address":[2101478],"length":1,"stats":{"Line":0}},{"line":150,"address":[2101568],"length":1,"stats":{"Line":0}},{"line":152,"address":[2101168,2101880],"length":1,"stats":{"Line":0}},{"line":155,"address":[2102203,2100868],"length":1,"stats":{"Line":0}},{"line":158,"address":[2099489],"length":1,"stats":{"Line":0}},{"line":161,"address":[2102336,2102704,2102698],"length":1,"stats":{"Line":0}},{"line":162,"address":[2080908,2080880],"length":1,"stats":{"Line":0}},{"line":163,"address":[2102414,2102532,2102669],"length":1,"stats":{"Line":0}},{"line":165,"address":[2102465,2102717],"length":1,"stats":{"Line":0}},{"line":167,"address":[2102661],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":64},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","watch.rs"],"content":"// src/cli/watch.rs\n\nuse anyhow::Result;\nuse clap::Subcommand;\nuse libmarlin::watcher::{WatcherConfig, WatcherState};\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse std::sync::Arc;\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tracing::info;\n\n/// Commands related to file watching functionality\n#[derive(Subcommand, Debug)]\npub enum WatchCmd {\n    /// Start watching a directory for changes\n    Start {\n        /// Directory to watch (defaults to current directory)\n        #[arg(default_value = \".\")]\n        path: PathBuf,\n        \n        /// Debounce window in milliseconds (default: 100ms)\n        #[arg(long, default_value = \"100\")]\n        debounce_ms: u64,\n    },\n    \n    /// Show status of currently active watcher\n    Status,\n    \n    /// Stop the currently running watcher\n    Stop,\n}\n\n/// Run a watch command\npub fn run(cmd: \u0026WatchCmd, _conn: \u0026mut Connection, _format: super::Format) -\u003e Result\u003c()\u003e {\n    match cmd {\n        WatchCmd::Start { path, debounce_ms } =\u003e {\n            let mut marlin = libmarlin::Marlin::open_default()?;\n            let config = WatcherConfig {\n                debounce_ms: *debounce_ms,\n                ..Default::default()\n            };\n            let canon_path = path.canonicalize().unwrap_or_else(|_| path.clone());\n            info!(\"Starting watcher for directory: {}\", canon_path.display());\n\n            let mut watcher = marlin.watch(\u0026canon_path, Some(config))?;\n            \n            let status = watcher.status();\n            info!(\"Watcher started. Press Ctrl+C to stop watching.\");\n            info!(\"Watching {} paths\", status.watched_paths.len());\n            \n            let start_time = Instant::now();\n            let mut last_status_time = Instant::now();\n            let running = Arc::new(AtomicBool::new(true));\n            let r_clone = running.clone();\n\n            ctrlc::set_handler(move || {\n                info!(\"Ctrl+C received. Signaling watcher to stop...\");\n                r_clone.store(false, Ordering::SeqCst);\n            })?;\n\n            info!(\"Watcher run loop started. Waiting for Ctrl+C or stop signal...\");\n            while running.load(Ordering::SeqCst) {\n                let current_status = watcher.status();\n                if current_status.state == WatcherState::Stopped {\n                    info!(\"Watcher has stopped (detected by state). Exiting loop.\");\n                    break;\n                }\n\n                // Corrected line: removed the extra closing parenthesis\n                if last_status_time.elapsed() \u003e Duration::from_secs(10) { \n                    let uptime = start_time.elapsed();\n                    info!(\n                        \"Watcher running for {}s, processed {} events, queue: {}, state: {:?}\",\n                        uptime.as_secs(),\n                        current_status.events_processed,\n                        current_status.queue_size,\n                        current_status.state\n                    );\n                    last_status_time = Instant::now();\n                }\n                thread::sleep(Duration::from_millis(200));\n            }\n\n            info!(\"Watcher run loop ended. Explicitly stopping watcher instance...\");\n            watcher.stop()?; \n            info!(\"Watcher instance fully stopped.\");\n            Ok(())\n        }\n        WatchCmd::Status =\u003e {\n            info!(\"Status command: No active watcher process to query in this CLI invocation model.\");\n            info!(\"To see live status, run 'marlin watch start' which prints periodic updates.\");\n            Ok(())\n        }\n        WatchCmd::Stop =\u003e {\n            info!(\"Stop command: No active watcher process to stop in this CLI invocation model.\");\n            info!(\"Please use Ctrl+C in the terminal where 'marlin watch start' is running.\");\n            Ok(())\n        }\n    }\n}","traces":[{"line":36,"address":[2236707,2227920,2236589],"length":1,"stats":{"Line":0}},{"line":37,"address":[2227977],"length":1,"stats":{"Line":0}},{"line":38,"address":[2228065],"length":1,"stats":{"Line":0}},{"line":39,"address":[2228093,2228231],"length":1,"stats":{"Line":0}},{"line":41,"address":[2228537],"length":1,"stats":{"Line":0}},{"line":44,"address":[2219056,2219077],"length":1,"stats":{"Line":0}},{"line":45,"address":[2228854,2228775,2229205],"length":1,"stats":{"Line":0}},{"line":47,"address":[2236678,2229119,2229785],"length":1,"stats":{"Line":0}},{"line":49,"address":[2229969],"length":1,"stats":{"Line":0}},{"line":50,"address":[2230108,2230404,2230032],"length":1,"stats":{"Line":0}},{"line":51,"address":[2230822,2230373,2231116],"length":1,"stats":{"Line":0}},{"line":53,"address":[2231087,2231632],"length":1,"stats":{"Line":0}},{"line":54,"address":[2231647],"length":1,"stats":{"Line":0}},{"line":55,"address":[2231708],"length":1,"stats":{"Line":0}},{"line":56,"address":[2231886,2231807],"length":1,"stats":{"Line":0}},{"line":58,"address":[2219168],"length":1,"stats":{"Line":0}},{"line":59,"address":[2219378,2219188],"length":1,"stats":{"Line":0}},{"line":60,"address":[2219338],"length":1,"stats":{"Line":0}},{"line":63,"address":[2232008,2232338],"length":1,"stats":{"Line":0}},{"line":64,"address":[2232308,2232757],"length":1,"stats":{"Line":0}},{"line":65,"address":[2232831],"length":1,"stats":{"Line":0}},{"line":66,"address":[2232858,2232938],"length":1,"stats":{"Line":0}},{"line":67,"address":[2234282,2232978,2234569],"length":1,"stats":{"Line":0}},{"line":72,"address":[2234222,2232944,2233024],"length":1,"stats":{"Line":0}},{"line":73,"address":[2233169],"length":1,"stats":{"Line":0}},{"line":74,"address":[2233752],"length":1,"stats":{"Line":0}},{"line":81,"address":[2234207,2233533],"length":1,"stats":{"Line":0}},{"line":83,"address":[2233144,2234242],"length":1,"stats":{"Line":0}},{"line":86,"address":[2235282,2232800,2234987],"length":1,"stats":{"Line":0}},{"line":87,"address":[2236562,2235252,2235695],"length":1,"stats":{"Line":0}},{"line":88,"address":[2236083,2235797],"length":1,"stats":{"Line":0}},{"line":89,"address":[2236049],"length":1,"stats":{"Line":0}},{"line":92,"address":[2236720,2236901,2228167],"length":1,"stats":{"Line":0}},{"line":93,"address":[2237436,2237270,2236869],"length":1,"stats":{"Line":0}},{"line":94,"address":[2237419],"length":1,"stats":{"Line":0}},{"line":97,"address":[2237805,2237986,2228199],"length":1,"stats":{"Line":0}},{"line":98,"address":[2237954,2238355,2238521],"length":1,"stats":{"Line":0}},{"line":99,"address":[2238504],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":38},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli.rs"],"content":"// src/cli.rs\n\npub mod link;\npub mod coll;\npub mod view;\npub mod state;\npub mod task;\npub mod remind;\npub mod annotate;\npub mod version;\npub mod event;\npub mod watch;\n\nuse clap::{Parser, Subcommand, ValueEnum};\nuse clap_complete::Shell;\n\n/// Output format for commands.\n#[derive(ValueEnum, Clone, Copy, Debug)]\npub enum Format {\n    Text,\n    Json,\n}\n\n/// Marlin – metadata-driven file explorer (CLI utilities)\n#[derive(Parser, Debug)]\n#[command(author, version, about, propagate_version = true)]\npub struct Cli {\n    /// Enable debug logging and extra output\n    #[arg(long)]\n    pub verbose: bool,\n\n    /// Output format (text or JSON)\n    #[arg(long, default_value = \"text\", value_enum, global = true)]\n    pub format: Format,\n\n    #[command(subcommand)]\n    pub command: Commands,\n}\n\n#[derive(Subcommand, Debug)]\npub enum Commands {\n    /// Initialise the database (idempotent)\n    Init,\n\n    /// Scan one or more directories and populate the file index\n    Scan {\n        /// Only re-index files marked dirty by `marlin watch`\n        #[arg(long)]\n        dirty: bool,\n\n        /// Directories to scan (defaults to cwd)\n        paths: Vec\u003cstd::path::PathBuf\u003e,\n    },\n\n    /// Tag files matching a glob pattern (hierarchical tags use `/`)\n    Tag {\n        /// Glob or path pattern\n        pattern: String,\n        /// Hierarchical tag name (`foo/bar`)\n        tag_path: String,\n    },\n\n    /// Manage custom attributes\n    Attr {\n        #[command(subcommand)]\n        action: AttrCmd,\n    },\n\n    /// Full-text search; `--exec CMD` runs CMD on each hit (`{}` placeholder)\n    Search {\n        query: String,\n        #[arg(long)]\n        exec: Option\u003cString\u003e,\n    },\n\n    /// Create a timestamped backup of the database\n    Backup,\n\n    /// Restore from a backup file (overwrites current DB)\n    Restore {\n        backup_path: std::path::PathBuf,\n    },\n\n    /// Generate shell completions (hidden)\n    #[command(hide = true)]\n    Completions {\n        /// Which shell to generate for\n        #[arg(value_enum)]\n        shell: Shell,\n    },\n\n    /// File-to-file links\n    #[command(subcommand)]\n    Link(link::LinkCmd),\n\n    /// Collections (groups) of files\n    #[command(subcommand)]\n    Coll(coll::CollCmd),\n\n    /// Smart views (saved queries)\n    #[command(subcommand)]\n    View(view::ViewCmd),\n\n    /// Workflow states on files\n    #[command(subcommand)]\n    State(state::StateCmd),\n\n    /// TODO/tasks management\n    #[command(subcommand)]\n    Task(task::TaskCmd),\n\n    /// Reminders on files\n    #[command(subcommand)]\n    Remind(remind::RemindCmd),\n\n    /// File annotations and highlights\n    #[command(subcommand)]\n    Annotate(annotate::AnnotateCmd),\n\n    /// Version diffs\n    #[command(subcommand)]\n    Version(version::VersionCmd),\n\n    /// Calendar events \u0026 timelines\n    #[command(subcommand)]\n    Event(event::EventCmd),\n\n    /// Watch directories for changes\n    #[command(subcommand)]\n    Watch(watch::WatchCmd),\n}\n\n#[derive(Subcommand, Debug)]\npub enum AttrCmd {\n    Set { pattern: String, key: String, value: String },\n    Ls  { path: std::path::PathBuf },\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","main.rs"],"content":"//! Marlin CLI entry-point (post crate-split)\n//!\n//! All heavy lifting now lives in the `libmarlin` crate; this file\n//! handles argument parsing, logging, orchestration and the few\n//! helpers that remain CLI-specific.\n\n#![deny(warnings)]\n\nmod cli; // sub-command definitions and argument structs\n\n/* ── shared modules re-exported from libmarlin ─────────────────── */\nuse libmarlin::{\n    config,\n    db,\n    logging,\n    scan,\n    utils::determine_scan_root,\n};\nuse libmarlin::db::take_dirty;\n\nuse anyhow::{Context, Result};\nuse clap::{CommandFactory, Parser};\nuse clap_complete::generate;\nuse glob::Pattern;\nuse shellexpand;\nuse shlex;\nuse std::{\n    env,\n    fs,\n    io,\n    path::Path,\n    process::Command,\n};\nuse tracing::{debug, error, info};\nuse walkdir::WalkDir;\n\nuse cli::{Cli, Commands};\n\nfn main() -\u003e Result\u003c()\u003e {\n    /* ── CLI parsing \u0026 logging ────────────────────────────────── */\n    let args = Cli::parse();\n    if args.verbose {\n        env::set_var(\"RUST_LOG\", \"debug\");\n    }\n    logging::init();\n\n    /* ── shell-completion shortcut ────────────────────────────── */\n    if let Commands::Completions { shell } = \u0026args.command {\n        let mut cmd = Cli::command();\n        generate(*shell, \u0026mut cmd, \"marlin\", \u0026mut io::stdout());\n        return Ok(());\n    }\n\n    /* ── config \u0026 automatic backup ───────────────────────────── */\n    let cfg = config::Config::load()?; // resolves DB path\n\n    match \u0026args.command {\n        Commands::Init | Commands::Backup | Commands::Restore { .. } =\u003e {}\n        _ =\u003e match db::backup(\u0026cfg.db_path) {\n            Ok(p)  =\u003e info!(\"Pre-command auto-backup created at {}\", p.display()),\n            Err(e) =\u003e error!(\"Failed to create pre-command auto-backup: {e}\"),\n        },\n    }\n\n    /* ── open DB (runs migrations) ───────────────────────────── */\n    let mut conn = db::open(\u0026cfg.db_path)?;\n\n    /* ── command dispatch ────────────────────────────────────── */\n    match args.command {\n        Commands::Completions { .. } =\u003e {} // handled above\n\n        /* ---- init ------------------------------------------------ */\n        Commands::Init =\u003e {\n            info!(\"Database initialised at {}\", cfg.db_path.display());\n            let cwd   = env::current_dir().context(\"getting current directory\")?;\n            let count = scan::scan_directory(\u0026mut conn, \u0026cwd)\n                .context(\"initial scan failed\")?;\n            info!(\"Initial scan complete – indexed/updated {count} files\");\n        }\n\n        /* ---- scan ------------------------------------------------ */\n        Commands::Scan { dirty, paths } =\u003e {\n            let scan_paths: Vec\u003cstd::path::PathBuf\u003e = if paths.is_empty() {\n                vec![env::current_dir()?]\n            } else {\n                paths.into_iter().collect()\n            };\n\n            if dirty {\n                let dirty_ids = take_dirty(\u0026conn)?;\n                for id in dirty_ids {\n                    let path: String = conn.query_row(\n                        \"SELECT path FROM files WHERE id = ?1\",\n                        [id],\n                        |r| r.get(0),\n                    )?;\n                    scan::scan_directory(\u0026mut conn, Path::new(\u0026path))?;\n                }\n            } else {\n                for p in scan_paths {\n                    scan::scan_directory(\u0026mut conn, \u0026p)?;\n                }\n            }\n        }\n\n        /* ---- tag / attribute / search --------------------------- */\n        Commands::Tag { pattern, tag_path } =\u003e\n            apply_tag(\u0026conn, \u0026pattern, \u0026tag_path)?,\n\n        Commands::Attr { action } =\u003e match action {\n            cli::AttrCmd::Set { pattern, key, value } =\u003e\n                attr_set(\u0026conn, \u0026pattern, \u0026key, \u0026value)?,\n            cli::AttrCmd::Ls { path } =\u003e\n                attr_ls(\u0026conn, \u0026path)?,\n        },\n\n        Commands::Search { query, exec } =\u003e\n            run_search(\u0026conn, \u0026query, exec)?,\n\n        /* ---- maintenance ---------------------------------------- */\n        Commands::Backup =\u003e {\n            let p = db::backup(\u0026cfg.db_path)?;\n            println!(\"Backup created: {}\", p.display());\n        }\n\n        Commands::Restore { backup_path } =\u003e {\n            drop(conn);\n            db::restore(\u0026backup_path, \u0026cfg.db_path).with_context(|| {\n                format!(\"Failed to restore DB from {}\", backup_path.display())\n            })?;\n            println!(\"Restored DB from {}\", backup_path.display());\n            db::open(\u0026cfg.db_path).with_context(|| {\n                format!(\"Could not open restored DB at {}\", cfg.db_path.display())\n            })?;\n            info!(\"Successfully opened restored database.\");\n        }\n\n        /* ---- passthrough sub-modules (some still stubs) ---------- */\n        Commands::Link(link_cmd)   =\u003e cli::link::run(\u0026link_cmd,   \u0026mut conn, args.format)?,\n        Commands::Coll(coll_cmd)   =\u003e cli::coll::run(\u0026coll_cmd,   \u0026mut conn, args.format)?,\n        Commands::View(view_cmd)   =\u003e cli::view::run(\u0026view_cmd,   \u0026mut conn, args.format)?,\n        Commands::State(state_cmd) =\u003e cli::state::run(\u0026state_cmd, \u0026mut conn, args.format)?,\n        Commands::Task(task_cmd)   =\u003e cli::task::run(\u0026task_cmd,   \u0026mut conn, args.format)?,\n        Commands::Remind(rm_cmd)   =\u003e cli::remind::run(\u0026rm_cmd,   \u0026mut conn, args.format)?,\n        Commands::Annotate(a_cmd)  =\u003e cli::annotate::run(\u0026a_cmd,  \u0026mut conn, args.format)?,\n        Commands::Version(v_cmd)   =\u003e cli::version::run(\u0026v_cmd,   \u0026mut conn, args.format)?,\n        Commands::Event(e_cmd)     =\u003e cli::event::run(\u0026e_cmd,     \u0026mut conn, args.format)?,\n        Commands::Watch(watch_cmd) =\u003e cli::watch::run(\u0026watch_cmd, \u0026mut conn, args.format)?,\n    }\n\n    Ok(())\n}\n\n/* ─────────────────── helpers \u0026 sub-routines ─────────────────── */\n\n/* ---------- TAGS ---------- */\nfn apply_tag(conn: \u0026rusqlite::Connection, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003c()\u003e {\n    let leaf_tag_id = db::ensure_tag_path(conn, tag_path)?;\n    let mut tag_ids = Vec::new();\n    let mut current = Some(leaf_tag_id);\n    while let Some(id) = current {\n        tag_ids.push(id);\n        current = conn.query_row(\n            \"SELECT parent_id FROM tags WHERE id=?1\",\n            [id],\n            |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n        )?;\n    }\n\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file   = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut stmt_insert = conn.prepare(\n        \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n    )?;\n\n    let mut count = 0usize;\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                let mut newly = false;\n                for \u0026tid in \u0026tag_ids {\n                    if stmt_insert.execute([fid, tid])? \u003e 0 {\n                        newly = true;\n                    }\n                }\n                if newly {\n                    info!(file=%p, tag=tag_path, \"tagged\");\n                    count += 1;\n                }\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Applied tag '{}' to {} file(s).\", tag_path, count);\n    Ok(())\n}\n\n/* ---------- ATTRIBUTES ---------- */\nfn attr_set(conn: \u0026rusqlite::Connection, pattern: \u0026str, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut count = 0usize;\n\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                db::upsert_attr(conn, fid, key, value)?;\n                info!(file=%p, key, value, \"attr set\");\n                count += 1;\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Attribute '{}={}' set on {} file(s).\", key, value, count);\n    Ok(())\n}\n\nfn attr_ls(conn: \u0026rusqlite::Connection, path: \u0026Path) -\u003e Result\u003c()\u003e {\n    let fid = db::file_id(conn, \u0026path.to_string_lossy())?;\n    let mut stmt = conn.prepare(\n        \"SELECT key, value FROM attributes WHERE file_id=?1 ORDER BY key\"\n    )?;\n    for row in stmt\n        .query_map([fid], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?\n    {\n        let (k, v) = row?;\n        println!(\"{k} = {v}\");\n    }\n    Ok(())\n}\n\n/* ---------- SEARCH ---------- */\nfn run_search(conn: \u0026rusqlite::Connection, raw_query: \u0026str, exec: Option\u003cString\u003e) -\u003e Result\u003c()\u003e {\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 { parts.push(\"AND\".into()); }\n                parts.push(format!(\"tags_text:{}\", escape_fts(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape_fts(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n            }\n        } else {\n            parts.push(escape_fts(\u0026tok));\n        }\n    }\n    let fts_expr = parts.join(\" \");\n    debug!(\"FTS MATCH expression: {fts_expr}\");\n\n    let mut stmt = conn.prepare(\n        r#\"\n        SELECT f.path\n          FROM files_fts\n          JOIN files f ON f.rowid = files_fts.rowid\n         WHERE files_fts MATCH ?1\n         ORDER BY rank\n        \"#,\n    )?;\n    let mut hits: Vec\u003cString\u003e = stmt\n        .query_map([\u0026fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n        .filter_map(Result::ok)\n        .collect();\n\n    if hits.is_empty() \u0026\u0026 !raw_query.contains(':') {\n        hits = naive_substring_search(conn, raw_query)?;\n    }\n\n    if let Some(cmd_tpl) = exec {\n        run_exec(\u0026hits, \u0026cmd_tpl)?;\n    } else {\n        if hits.is_empty() {\n            eprintln!(\n                \"No matches for query: `{raw_query}` (FTS expr: `{fts_expr}`)\"\n            );\n        } else {\n            for p in hits { println!(\"{p}\"); }\n        }\n    }\n    Ok(())\n}\n\nfn naive_substring_search(conn: \u0026rusqlite::Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let needle = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut out = Vec::new();\n    for p in rows {\n        let p = p?;\n        if p.to_lowercase().contains(\u0026needle) {\n            out.push(p.clone());\n            continue;\n        }\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 65_536 { continue; }\n        }\n        if let Ok(body) = fs::read_to_string(\u0026p) {\n            if body.to_lowercase().contains(\u0026needle) {\n                out.push(p);\n            }\n        }\n    }\n    Ok(out)\n}\n\nfn run_exec(paths: \u0026[String], cmd_tpl: \u0026str) -\u003e Result\u003c()\u003e {\n    let mut ran_without_placeholder = false;\n\n    if paths.is_empty() \u0026\u0026 !cmd_tpl.contains(\"{}\") {\n        if let Some(mut parts) = shlex::split(cmd_tpl) {\n            if !parts.is_empty() {\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(command=%cmd_tpl, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n        ran_without_placeholder = true;\n    }\n\n    if !ran_without_placeholder {\n        for p in paths {\n            let quoted = shlex::try_quote(p).unwrap_or_else(|_| p.into());\n            let final_cmd = if cmd_tpl.contains(\"{}\") {\n                cmd_tpl.replace(\"{}\", \u0026quoted)\n            } else {\n                format!(\"{cmd_tpl} {quoted}\")\n            };\n            if let Some(mut parts) = shlex::split(\u0026final_cmd) {\n                if parts.is_empty() { continue; }\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(file=%p, command=%final_cmd, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\nfn escape_fts(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use assert_cmd::Command;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_help_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--help\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"Usage: marlin\"));\n    }\n\n    #[test]\n    fn test_version_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--version\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"marlin-cli 0.1.0\"));\n    }\n\n    #[test]\n    fn test_verbose_logging() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"--verbose\").arg(\"init\");\n        let output = cmd.output().unwrap();\n        assert!(output.status.success());\n        let stderr = String::from_utf8_lossy(\u0026output.stderr);\n        assert!(\n            stderr.contains(\"DEBUG\"),\n            \"Expected debug logs in stderr, got: {}\",\n            stderr\n        );\n    }\n\n    #[test]\n    fn test_shell_completions() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"completions\").arg(\"bash\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"_marlin()\"))\n            .stdout(predicates::str::contains(\"init\"))\n            .stdout(predicates::str::contains(\"scan\"));\n    }\n\n    #[test]\n    fn test_invalid_subcommand() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"invalid_cmd\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"error: unrecognized subcommand\"));\n    }\n\n    #[test]\n    fn test_init_command() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd.arg(\"init\");\n        cmd.assert().success();\n        assert!(db_path.exists(), \"Database file should exist after init\");\n    }\n\n    #[test]\n    fn test_automatic_backup() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let backups_dir = tmp.path().join(\"backups\");\n\n        // Init: no backup\n        let mut cmd_init = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_init.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_init.arg(\"init\");\n        cmd_init.assert().success();\n        assert!(\n            !backups_dir.exists() || backups_dir.read_dir().unwrap().next().is_none(),\n            \"No backup should be created for init\"\n        );\n\n        // Scan: backup created\n        let mut cmd_scan = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_scan.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_scan.arg(\"scan\");\n        cmd_scan.assert().success();\n        assert!(backups_dir.exists(), \"Backups directory should exist after scan\");\n        let backups: Vec\u003c_\u003e = backups_dir.read_dir().unwrap().collect();\n        assert_eq!(backups.len(), 1, \"One backup should be created for scan\");\n    }\n\n    #[test]\n    fn test_annotate_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"annotate\").arg(\"add\").arg(\"file.txt\").arg(\"note\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n\n    #[test]\n    fn test_event_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"event\").arg(\"add\").arg(\"file.txt\").arg(\"2025-05-20\").arg(\"desc\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n}\n","traces":[{"line":39,"address":[2145360,2162170,2146143],"length":1,"stats":{"Line":0}},{"line":41,"address":[2145382],"length":1,"stats":{"Line":0}},{"line":42,"address":[2145707],"length":1,"stats":{"Line":0}},{"line":43,"address":[2145834,2145728],"length":1,"stats":{"Line":0}},{"line":45,"address":[2145717],"length":1,"stats":{"Line":0}},{"line":48,"address":[2145836],"length":1,"stats":{"Line":0}},{"line":49,"address":[2145882],"length":1,"stats":{"Line":0}},{"line":50,"address":[2146006,2145919],"length":1,"stats":{"Line":0}},{"line":51,"address":[2146059],"length":1,"stats":{"Line":0}},{"line":55,"address":[2146149,2161617,2145889],"length":1,"stats":{"Line":0}},{"line":57,"address":[2146322],"length":1,"stats":{"Line":0}},{"line":59,"address":[2146381,2146462],"length":1,"stats":{"Line":0}},{"line":60,"address":[2146546],"length":1,"stats":{"Line":0}},{"line":61,"address":[2146499,2147508],"length":1,"stats":{"Line":0}},{"line":66,"address":[2148304,2161599,2146388],"length":1,"stats":{"Line":0}},{"line":69,"address":[2148590],"length":1,"stats":{"Line":0}},{"line":74,"address":[2150711,2150424,2148632],"length":1,"stats":{"Line":0}},{"line":75,"address":[2151275,2152656,2150689],"length":1,"stats":{"Line":0}},{"line":76,"address":[2152602,2151570,2151757,2151487],"length":1,"stats":{"Line":0}},{"line":78,"address":[2151810,2152132],"length":1,"stats":{"Line":0}},{"line":82,"address":[2148663],"length":1,"stats":{"Line":0}},{"line":83,"address":[2153248,2152714,2148732],"length":1,"stats":{"Line":0}},{"line":84,"address":[2155359,2152797,2152871,2155456],"length":1,"stats":{"Line":0}},{"line":86,"address":[2152720,2152828],"length":1,"stats":{"Line":0}},{"line":89,"address":[2152850,2154565],"length":1,"stats":{"Line":0}},{"line":90,"address":[2153320,2154013,2155276],"length":1,"stats":{"Line":0}},{"line":91,"address":[2154174,2154278,2154429],"length":1,"stats":{"Line":0}},{"line":92,"address":[2154483,2154769,2154641,2155223],"length":1,"stats":{"Line":0}},{"line":94,"address":[2154475],"length":1,"stats":{"Line":0}},{"line":95,"address":[2449168,2449184],"length":1,"stats":{"Line":0}},{"line":97,"address":[2154870,2154965,2155173],"length":1,"stats":{"Line":0}},{"line":100,"address":[2153391,2153526,2153253],"length":1,"stats":{"Line":0}},{"line":101,"address":[2153603,2153932,2153724],"length":1,"stats":{"Line":0}},{"line":107,"address":[2148761],"length":1,"stats":{"Line":0}},{"line":108,"address":[2155488,2148849],"length":1,"stats":{"Line":0}},{"line":110,"address":[2148875],"length":1,"stats":{"Line":0}},{"line":111,"address":[2155974],"length":1,"stats":{"Line":0}},{"line":112,"address":[2156078],"length":1,"stats":{"Line":0}},{"line":113,"address":[2155908],"length":1,"stats":{"Line":0}},{"line":114,"address":[2156688,2155948],"length":1,"stats":{"Line":0}},{"line":117,"address":[2148959],"length":1,"stats":{"Line":0}},{"line":118,"address":[2156947,2149055],"length":1,"stats":{"Line":0}},{"line":122,"address":[2157324,2157749,2149097],"length":1,"stats":{"Line":0}},{"line":123,"address":[2157485,2157568],"length":1,"stats":{"Line":0}},{"line":126,"address":[2149107],"length":1,"stats":{"Line":0}},{"line":127,"address":[2149147],"length":1,"stats":{"Line":0}},{"line":128,"address":[2159319,2157958,2157822],"length":1,"stats":{"Line":0}},{"line":129,"address":[2449238],"length":1,"stats":{"Line":0}},{"line":131,"address":[2157995],"length":1,"stats":{"Line":0}},{"line":132,"address":[2158185,2159281,2158300],"length":1,"stats":{"Line":0}},{"line":133,"address":[2449414],"length":1,"stats":{"Line":0}},{"line":135,"address":[2158862,2158540],"length":1,"stats":{"Line":0}},{"line":139,"address":[2149300,2159337],"length":1,"stats":{"Line":0}},{"line":140,"address":[2149430,2159545],"length":1,"stats":{"Line":0}},{"line":141,"address":[2159753,2149528],"length":1,"stats":{"Line":0}},{"line":142,"address":[2149626,2159955],"length":1,"stats":{"Line":0}},{"line":143,"address":[2149740,2160151],"length":1,"stats":{"Line":0}},{"line":144,"address":[2160347,2149822],"length":1,"stats":{"Line":0}},{"line":145,"address":[2160543,2149952],"length":1,"stats":{"Line":0}},{"line":146,"address":[2160739,2150082],"length":1,"stats":{"Line":0}},{"line":147,"address":[2160935,2150164],"length":1,"stats":{"Line":0}},{"line":148,"address":[2161494,2150294,2161131],"length":1,"stats":{"Line":0}},{"line":151,"address":[2149269],"length":1,"stats":{"Line":0}},{"line":157,"address":[2163232,2171185,2171344],"length":1,"stats":{"Line":0}},{"line":158,"address":[2163318],"length":1,"stats":{"Line":0}},{"line":159,"address":[2163456],"length":1,"stats":{"Line":0}},{"line":160,"address":[2163478],"length":1,"stats":{"Line":0}},{"line":161,"address":[2163929,2163498],"length":1,"stats":{"Line":0}},{"line":162,"address":[2163536],"length":1,"stats":{"Line":0}},{"line":163,"address":[2163942,2163847,2163668],"length":1,"stats":{"Line":0}},{"line":165,"address":[2163660],"length":1,"stats":{"Line":0}},{"line":166,"address":[2449584,2449568],"length":1,"stats":{"Line":0}},{"line":170,"address":[2163578,2163969],"length":1,"stats":{"Line":0}},{"line":171,"address":[2164087,2164217,2164004,2171334],"length":1,"stats":{"Line":0}},{"line":172,"address":[2164201],"length":1,"stats":{"Line":0}},{"line":173,"address":[2164465,2164382],"length":1,"stats":{"Line":0}},{"line":175,"address":[2171275,2164563,2164492],"length":1,"stats":{"Line":0}},{"line":176,"address":[2165083,2171235,2164890,2164961],"length":1,"stats":{"Line":0}},{"line":180,"address":[2165280],"length":1,"stats":{"Line":0}},{"line":181,"address":[2165359,2165548,2165308],"length":1,"stats":{"Line":0}},{"line":184,"address":[2449744,2449771],"length":1,"stats":{"Line":0}},{"line":186,"address":[2166699,2165633],"length":1,"stats":{"Line":0}},{"line":187,"address":[2166801,2166706],"length":1,"stats":{"Line":0}},{"line":189,"address":[2166932,2166859],"length":1,"stats":{"Line":0}},{"line":190,"address":[2167073],"length":1,"stats":{"Line":0}},{"line":191,"address":[2167097],"length":1,"stats":{"Line":0}},{"line":192,"address":[2167105,2167200],"length":1,"stats":{"Line":0}},{"line":193,"address":[2167317,2168788,2168592],"length":1,"stats":{"Line":0}},{"line":194,"address":[2168780],"length":1,"stats":{"Line":0}},{"line":197,"address":[2167371,2168567],"length":1,"stats":{"Line":0}},{"line":198,"address":[2167403,2167737],"length":1,"stats":{"Line":0}},{"line":199,"address":[2168559,2167703,2168572],"length":1,"stats":{"Line":0}},{"line":203,"address":[2169115,2168977],"length":1,"stats":{"Line":0}},{"line":204,"address":[2169005],"length":1,"stats":{"Line":0}},{"line":205,"address":[2169077,2169978],"length":1,"stats":{"Line":0}},{"line":209,"address":[2165686,2166020],"length":1,"stats":{"Line":0}},{"line":210,"address":[2165986],"length":1,"stats":{"Line":0}},{"line":214,"address":[2178337,2178218,2171360],"length":1,"stats":{"Line":0}},{"line":215,"address":[2171454],"length":1,"stats":{"Line":0}},{"line":216,"address":[2171528,2178327,2171611,2171741],"length":1,"stats":{"Line":0}},{"line":217,"address":[2171725],"length":1,"stats":{"Line":0}},{"line":218,"address":[2171906,2171989],"length":1,"stats":{"Line":0}},{"line":220,"address":[2172016,2172087,2178268],"length":1,"stats":{"Line":0}},{"line":221,"address":[2172406],"length":1,"stats":{"Line":0}},{"line":223,"address":[2172434,2172485,2172674],"length":1,"stats":{"Line":0}},{"line":226,"address":[2450011,2449984],"length":1,"stats":{"Line":0}},{"line":228,"address":[2173830,2172759],"length":1,"stats":{"Line":0}},{"line":229,"address":[2173932,2173837],"length":1,"stats":{"Line":0}},{"line":231,"address":[2173990,2174063],"length":1,"stats":{"Line":0}},{"line":232,"address":[2174212],"length":1,"stats":{"Line":0}},{"line":233,"address":[2174331,2175834,2174228],"length":1,"stats":{"Line":0}},{"line":234,"address":[2174442,2174776],"length":1,"stats":{"Line":0}},{"line":235,"address":[2174742,2175774,2175784],"length":1,"stats":{"Line":0}},{"line":238,"address":[2176148,2176010],"length":1,"stats":{"Line":0}},{"line":239,"address":[2176038],"length":1,"stats":{"Line":0}},{"line":240,"address":[2176110,2177011],"length":1,"stats":{"Line":0}},{"line":244,"address":[2173146,2172812],"length":1,"stats":{"Line":0}},{"line":245,"address":[2173112],"length":1,"stats":{"Line":0}},{"line":248,"address":[2180051,2178352,2180112],"length":1,"stats":{"Line":0}},{"line":249,"address":[2178401,2180130],"length":1,"stats":{"Line":0}},{"line":250,"address":[2178767,2178659],"length":1,"stats":{"Line":0}},{"line":253,"address":[2179186,2180105,2178971,2179078,2179358],"length":1,"stats":{"Line":0}},{"line":254,"address":[2178963,2179122],"length":1,"stats":{"Line":0}},{"line":256,"address":[2179459,2179537,2180061],"length":1,"stats":{"Line":0}},{"line":257,"address":[2179854,2179783],"length":1,"stats":{"Line":0}},{"line":259,"address":[2179501],"length":1,"stats":{"Line":0}},{"line":263,"address":[2187075,2183402,2180160],"length":1,"stats":{"Line":0}},{"line":264,"address":[2180207],"length":1,"stats":{"Line":0}},{"line":265,"address":[2180327,2180403],"length":1,"stats":{"Line":0}},{"line":266,"address":[2187019,2180449,2180611],"length":1,"stats":{"Line":0}},{"line":267,"address":[2184422,2180696],"length":1,"stats":{"Line":0}},{"line":268,"address":[2184520,2187006],"length":1,"stats":{"Line":0}},{"line":269,"address":[2184497,2184613],"length":1,"stats":{"Line":0}},{"line":270,"address":[2184821,2184747],"length":1,"stats":{"Line":0}},{"line":271,"address":[2185015,2185070],"length":1,"stats":{"Line":0}},{"line":272,"address":[2185063,2185144],"length":1,"stats":{"Line":0}},{"line":274,"address":[2185465,2184779],"length":1,"stats":{"Line":0}},{"line":275,"address":[2185587],"length":1,"stats":{"Line":0}},{"line":276,"address":[2185645],"length":1,"stats":{"Line":0}},{"line":277,"address":[2185754],"length":1,"stats":{"Line":0}},{"line":278,"address":[2185935,2185900],"length":1,"stats":{"Line":0}},{"line":279,"address":[2186235],"length":1,"stats":{"Line":0}},{"line":280,"address":[2186325],"length":1,"stats":{"Line":0}},{"line":282,"address":[2185925,2186637],"length":1,"stats":{"Line":0}},{"line":285,"address":[2185625,2186960],"length":1,"stats":{"Line":0}},{"line":288,"address":[2180741],"length":1,"stats":{"Line":0}},{"line":289,"address":[2180824,2181206,2180903],"length":1,"stats":{"Line":0}},{"line":291,"address":[2181790,2181176,2184259,2181668],"length":1,"stats":{"Line":0}},{"line":300,"address":[2184219,2182110,2182218,2182003],"length":1,"stats":{"Line":0}},{"line":301,"address":[2182154,2181995],"length":1,"stats":{"Line":0}},{"line":305,"address":[2182423,2182868,2182478,2182349],"length":1,"stats":{"Line":0}},{"line":306,"address":[2182881,2182538],"length":1,"stats":{"Line":0}},{"line":309,"address":[2182437,2182919],"length":1,"stats":{"Line":0}},{"line":310,"address":[2183342,2182950,2183098],"length":1,"stats":{"Line":0}},{"line":312,"address":[2182985,2183415],"length":1,"stats":{"Line":0}},{"line":313,"address":[2183906,2183488],"length":1,"stats":{"Line":0}},{"line":317,"address":[2183518,2183421],"length":1,"stats":{"Line":0}},{"line":320,"address":[2183303],"length":1,"stats":{"Line":0}},{"line":323,"address":[2187120,2189107,2190084],"length":1,"stats":{"Line":0}},{"line":324,"address":[2187201],"length":1,"stats":{"Line":0}},{"line":325,"address":[2187321,2187250,2190082],"length":1,"stats":{"Line":0}},{"line":326,"address":[2187723,2190061,2187656],"length":1,"stats":{"Line":0}},{"line":328,"address":[2187924],"length":1,"stats":{"Line":0}},{"line":329,"address":[2187984,2188076,2188152,2189812],"length":1,"stats":{"Line":0}},{"line":330,"address":[2188253,2188418],"length":1,"stats":{"Line":0}},{"line":331,"address":[2188707,2188636],"length":1,"stats":{"Line":0}},{"line":332,"address":[2189895],"length":1,"stats":{"Line":0}},{"line":335,"address":[2188986,2188876],"length":1,"stats":{"Line":0}},{"line":336,"address":[2188993,2189054],"length":1,"stats":{"Line":0}},{"line":338,"address":[2189113,2189204],"length":1,"stats":{"Line":0}},{"line":339,"address":[2189252,2189323],"length":1,"stats":{"Line":0}},{"line":340,"address":[2189511],"length":1,"stats":{"Line":0}},{"line":344,"address":[2188306],"length":1,"stats":{"Line":0}},{"line":347,"address":[2192261,2190112,2192296],"length":1,"stats":{"Line":0}},{"line":348,"address":[2190167],"length":1,"stats":{"Line":0}},{"line":350,"address":[2190207,2190236,2192354],"length":1,"stats":{"Line":0}},{"line":351,"address":[2192275,2190274],"length":1,"stats":{"Line":0}},{"line":352,"address":[2190397,2190517],"length":1,"stats":{"Line":0}},{"line":353,"address":[2190523],"length":1,"stats":{"Line":0}},{"line":354,"address":[2192183,2190592,2190643],"length":1,"stats":{"Line":0}},{"line":355,"address":[2190916],"length":1,"stats":{"Line":0}},{"line":356,"address":[2190943,2191000],"length":1,"stats":{"Line":0}},{"line":360,"address":[2192346],"length":1,"stats":{"Line":0}},{"line":363,"address":[2190217],"length":1,"stats":{"Line":0}},{"line":364,"address":[2195448,2192391,2192432],"length":1,"stats":{"Line":0}},{"line":365,"address":[2192501],"length":1,"stats":{"Line":0}},{"line":366,"address":[2192578,2192675],"length":1,"stats":{"Line":0}},{"line":367,"address":[2192708,2192938],"length":1,"stats":{"Line":0}},{"line":369,"address":[2192681,2192746],"length":1,"stats":{"Line":0}},{"line":371,"address":[2192899,2193054,2195030],"length":1,"stats":{"Line":0}},{"line":372,"address":[2193262,2193166],"length":1,"stats":{"Line":0}},{"line":373,"address":[2193268],"length":1,"stats":{"Line":0}},{"line":374,"address":[2193340,2193391,2195040],"length":1,"stats":{"Line":0}},{"line":375,"address":[2193661],"length":1,"stats":{"Line":0}},{"line":376,"address":[2193682,2193733],"length":1,"stats":{"Line":0}},{"line":381,"address":[2192415],"length":1,"stats":{"Line":0}},{"line":384,"address":[2195520,2195888,2195882],"length":1,"stats":{"Line":0}},{"line":385,"address":[2195579],"length":1,"stats":{"Line":0}},{"line":386,"address":[2195853,2195598,2195716],"length":1,"stats":{"Line":0}},{"line":388,"address":[2195901,2195649],"length":1,"stats":{"Line":0}},{"line":390,"address":[2195845],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":201},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","e2e.rs"],"content":"//! tests e2e.rs\n//! End-to-end “happy path” smoke-tests for the `marlin` binary.\n//!\n//! Run with `cargo test --test e2e` (CI does) or `cargo test`.\n\nuse assert_cmd::prelude::*;\nuse predicates::prelude::*;\nuse std::{fs, path::PathBuf, process::Command};\nuse tempfile::tempdir;\n\n/// Absolute path to the freshly-built `marlin` binary.\nfn marlin_bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Create the demo directory structure and seed files.\nfn spawn_demo_tree(root: \u0026PathBuf) {\n    fs::create_dir_all(root.join(\"Projects/Alpha\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Beta\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Gamma\")).unwrap();\n    fs::create_dir_all(root.join(\"Logs\")).unwrap();\n    fs::create_dir_all(root.join(\"Reports\")).unwrap();\n\n    fs::write(root.join(\"Projects/Alpha/draft1.md\"), \"- [ ] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Alpha/draft2.md\"), \"- [x] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Beta/final.md\"), \"done\\n\").unwrap();\n    fs::write(root.join(\"Projects/Gamma/TODO.txt\"), \"TODO bar\\n\").unwrap();\n    fs::write(root.join(\"Logs/app.log\"),           \"ERROR omg\\n\").unwrap();\n    fs::write(root.join(\"Reports/Q1.pdf\"),         \"PDF\\n\").unwrap();\n}\n\n/// Shorthand for “run and must succeed”.\nfn ok(cmd: \u0026mut Command) -\u003e assert_cmd::assert::Assert {\n    cmd.assert().success()\n}\n\n#[test]\nfn full_cli_flow() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    /* ── 1 ░ sandbox ───────────────────────────────────────────── */\n\n    let tmp      = tempdir()?;                 // wiped on drop\n    let demo_dir = tmp.path().join(\"marlin_demo\");\n    spawn_demo_tree(\u0026demo_dir);\n\n    let db_path = demo_dir.join(\"index.db\");\n\n    // Helper to spawn a fresh `marlin` Command with the DB env-var set\n    let marlin = || {\n        let mut c = Command::new(marlin_bin());\n        c.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        c\n    };\n\n    /* ── 2 ░ init ( auto-scan cwd ) ───────────────────────────── */\n\n    ok(marlin()\n        .current_dir(\u0026demo_dir)\n        .arg(\"init\"));\n\n    /* ── 3 ░ tag \u0026 attr demos ─────────────────────────────────── */\n\n    ok(marlin()\n        .arg(\"tag\")\n        .arg(format!(\"{}/Projects/**/*.md\", demo_dir.display()))\n        .arg(\"project/md\"));\n\n    ok(marlin()\n        .arg(\"attr\")\n        .arg(\"set\")\n        .arg(format!(\"{}/Reports/*.pdf\", demo_dir.display()))\n        .arg(\"reviewed\")\n        .arg(\"yes\"));\n\n    /* ── 4 ░ quick search sanity checks ───────────────────────── */\n\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    marlin()\n        .arg(\"search\").arg(\"attr:reviewed=yes\")\n        .assert()\n        .stdout(predicate::str::contains(\"Q1.pdf\"));\n\n    /* ── 5 ░ link flow \u0026 backlinks ────────────────────────────── */\n\n    let foo = demo_dir.join(\"foo.txt\");\n    let bar = demo_dir.join(\"bar.txt\");\n    fs::write(\u0026foo, \"\")?;\n    fs::write(\u0026bar, \"\")?;\n\n    ok(marlin().arg(\"scan\").arg(\u0026demo_dir));\n\n    ok(marlin()\n        .arg(\"link\").arg(\"add\")\n        .arg(\u0026foo).arg(\u0026bar));\n\n    marlin()\n        .arg(\"link\").arg(\"backlinks\").arg(\u0026bar)\n        .assert()\n        .stdout(predicate::str::contains(\"foo.txt\"));\n\n    /* ── 6 ░ backup → delete DB → restore ────────────────────── */\n\n    let backup_path = String::from_utf8(\n        marlin().arg(\"backup\").output()?.stdout\n    )?;\n    let backup_file = backup_path.split_whitespace().last().unwrap();\n\n    fs::remove_file(\u0026db_path)?;                        // simulate corruption\n    ok(marlin().arg(\"restore\").arg(backup_file));      // restore\n\n    // Search must still work afterwards\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    Ok(())\n}\n\n","traces":[{"line":12,"address":[785104],"length":1,"stats":{"Line":1}},{"line":13,"address":[785112],"length":1,"stats":{"Line":1}},{"line":17,"address":[785136],"length":1,"stats":{"Line":1}},{"line":18,"address":[785155],"length":1,"stats":{"Line":1}},{"line":19,"address":[785216],"length":1,"stats":{"Line":1}},{"line":20,"address":[785277],"length":1,"stats":{"Line":1}},{"line":21,"address":[785338],"length":1,"stats":{"Line":1}},{"line":22,"address":[785399],"length":1,"stats":{"Line":1}},{"line":24,"address":[785460],"length":1,"stats":{"Line":1}},{"line":25,"address":[785539],"length":1,"stats":{"Line":1}},{"line":26,"address":[785618],"length":1,"stats":{"Line":1}},{"line":27,"address":[785697],"length":1,"stats":{"Line":1}},{"line":28,"address":[785776],"length":1,"stats":{"Line":1}},{"line":29,"address":[785855],"length":1,"stats":{"Line":1}},{"line":33,"address":[785952],"length":1,"stats":{"Line":1}},{"line":34,"address":[785970],"length":1,"stats":{"Line":1}}],"covered":16,"coverable":16},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","integration","watcher","watcher_test.rs"],"content":"//! Integration test for the file watcher functionality\n//! \n//! Tests various aspects of the file system watcher including:\n//! - Basic event handling (create, modify, delete files)\n//! - Debouncing of events\n//! - Hierarchical event coalescing\n//! - Graceful shutdown and event draining\n\nuse marlin::watcher::{FileWatcher, WatcherConfig, WatcherState};\nuse std::path::{Path, PathBuf};\nuse std::fs::{self, File};\nuse std::io::Write;\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tempfile::tempdir;\n\n// Mock filesystem event simulator inspired by inotify-sim\nstruct MockEventSimulator {\n    temp_dir: PathBuf,\n    files_created: Vec\u003cPathBuf\u003e,\n}\n\nimpl MockEventSimulator {\n    fn new(temp_dir: PathBuf) -\u003e Self {\n        Self {\n            temp_dir,\n            files_created: Vec::new(),\n        }\n    }\n\n    fn create_file(\u0026mut self, relative_path: \u0026str, content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        if let Some(parent) = path.parent() {\n            fs::create_dir_all(parent).expect(\"Failed to create parent directory\");\n        }\n        \n        let mut file = File::create(\u0026path).expect(\"Failed to create file\");\n        file.write_all(content.as_bytes()).expect(\"Failed to write content\");\n        \n        self.files_created.push(path.clone());\n        path\n    }\n    \n    fn modify_file(\u0026self, relative_path: \u0026str, new_content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        let mut file = File::create(\u0026path).expect(\"Failed to update file\");\n        file.write_all(new_content.as_bytes()).expect(\"Failed to write content\");\n        path\n    }\n    \n    fn delete_file(\u0026mut self, relative_path: \u0026str) {\n        let path = self.temp_dir.join(relative_path);\n        fs::remove_file(\u0026path).expect(\"Failed to delete file\");\n        \n        self.files_created.retain(|p| p != \u0026path);\n    }\n    \n    fn create_burst(\u0026mut self, count: usize, prefix: \u0026str) -\u003e Vec\u003cPathBuf\u003e {\n        let mut paths = Vec::with_capacity(count);\n        \n        for i in 0..count {\n            let file_path = format!(\"{}/burst_file_{}.txt\", prefix, i);\n            let path = self.create_file(\u0026file_path, \u0026format!(\"Content {}\", i));\n            paths.push(path);\n            \n            // Small delay to simulate rapid but not instantaneous file creation\n            thread::sleep(Duration::from_micros(10));\n        }\n        \n        paths\n    }\n    \n    fn cleanup(\u0026self) {\n        // No need to do anything as tempdir will clean itself\n    }\n}\n\n#[test]\nfn test_basic_watch_functionality() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Create a test file before starting the watcher\n    let initial_file = simulator.create_file(\"initial.txt\", \"Initial content\");\n    \n    // Configure and start the watcher\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for a short time\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Generate events\n    let file1 = simulator.create_file(\"test1.txt\", \"Hello, world!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    let file2 = simulator.create_file(\"dir1/test2.txt\", \"Hello from subdirectory!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.modify_file(\"test1.txt\", \"Updated content\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.delete_file(\"test1.txt\");\n    \n    // Wait for watcher thread to complete\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Check status after processing events\n    let status = finished_watcher.status();\n    \n    // Assertions\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with larger debounce window for this test\n    let config = WatcherConfig {\n        debounce_ms: 200,  // 200ms debounce window\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to observe debouncing\n        thread::sleep(Duration::from_secs(3));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Rapidly update the same file multiple times within the debounce window\n    let test_file = \"test_debounce.txt\";\n    simulator.create_file(test_file, \"Initial content\");\n    \n    // Update the same file multiple times within debounce window\n    for i in 1..10 {\n        simulator.modify_file(test_file, \u0026format!(\"Update {}\", i));\n        thread::sleep(Duration::from_millis(10)); // Short delay between updates\n    }\n    \n    // Wait for debounce window and processing\n    thread::sleep(Duration::from_millis(500));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // We should have processed fewer events than modifications made\n    // due to debouncing (exact count depends on implementation details)\n    assert!(status.events_processed \u003c 10, \n            \"Expected fewer events processed than modifications due to debouncing\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_event_flood() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure with settings tuned for burst handling\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 500,  // Handle larger batches\n        max_queue_size: 10000,  // Large queue for burst\n        drain_timeout_ms: 5000, // Longer drain time for cleanup\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to process a large burst\n        thread::sleep(Duration::from_secs(10));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create 1000 files in rapid succession (smaller scale for test)\n    let start_time = Instant::now();\n    let created_files = simulator.create_burst(1000, \"flood\");\n    let creation_time = start_time.elapsed();\n    \n    println!(\"Created 1000 files in {:?}\", creation_time);\n    \n    // Wait for processing to complete\n    thread::sleep(Duration::from_secs(5));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // Verify processing occurred\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_hierarchical_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher\n    let config = WatcherConfig {\n        debounce_ms: 200,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create directory structure\n    let nested_dir = \"parent/child/grandchild\";\n    fs::create_dir_all(temp_path.join(nested_dir)).expect(\"Failed to create nested directories\");\n    \n    // Create files in the hierarchy\n    simulator.create_file(\"parent/file1.txt\", \"Content 1\");\n    simulator.create_file(\"parent/child/file2.txt\", \"Content 2\");\n    simulator.create_file(\"parent/child/grandchild/file3.txt\", \"Content 3\");\n    \n    // Wait a bit\n    thread::sleep(Duration::from_millis(300));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_graceful_shutdown() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with specific drain timeout\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 2000, // 2 second drain timeout\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    watcher.start().expect(\"Failed to start watcher\");\n    \n    // Wait for initialization\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create files\n    for i in 0..10 {\n        simulator.create_file(\u0026format!(\"shutdown_test_{}.txt\", i), \"Shutdown test\");\n        thread::sleep(Duration::from_millis(10));\n    }\n    \n    // Immediately request shutdown while events are being processed\n    let shutdown_start = Instant::now();\n    watcher.stop().expect(\"Failed to stop watcher\");\n    let shutdown_duration = shutdown_start.elapsed();\n    \n    // Shutdown should take close to the drain timeout but not excessively longer\n    println!(\"Shutdown took {:?}\", shutdown_duration);\n    assert!(shutdown_duration \u003e= Duration::from_millis(100), \n            \"Shutdown was too quick, may not have drained properly\");\n    assert!(shutdown_duration \u003c= Duration::from_millis(3000), \n            \"Shutdown took too long\");\n    \n    // Verify final state\n    let status = watcher.status();\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert_eq!(status.queue_size, 0, \"Queue should be empty after shutdown\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","neg.rs"],"content":"//! tests neg.rs\n//! Negative-path integration tests (“should fail / warn”).\n\nuse predicates::str;\nuse tempfile::tempdir;\n\nmod util;\nuse util::marlin;\n\n/* ───────────────────────── LINKS ─────────────────────────────── */\n\n#[test]\nfn link_non_indexed_should_fail() {\n    let tmp = tempdir().unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    std::fs::write(tmp.path().join(\"foo.txt\"), \"\").unwrap();\n    std::fs::write(tmp.path().join(\"bar.txt\"), \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .current_dir(tmp.path())\n        .args([\n            \"link\", \"add\",\n            \u0026tmp.path().join(\"foo.txt\").to_string_lossy(),\n            \u0026tmp.path().join(\"bar.txt\").to_string_lossy()\n        ])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"file not indexed\"));\n}\n\n/* ───────────────────────── ATTR ─────────────────────────────── */\n\n#[test]\nfn attr_set_on_non_indexed_file_should_warn() {\n    let tmp = tempdir().unwrap();\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    let ghost = tmp.path().join(\"ghost.txt\");\n    std::fs::write(\u0026ghost, \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .args([\"attr\",\"set\",\n               \u0026ghost.to_string_lossy(),\"foo\",\"bar\"])\n        .assert()\n        .success()                       // exits 0\n        .stderr(str::contains(\"not indexed\"));\n}\n\n/* ───────────────────── COLLECTIONS ───────────────────────────── */\n\n#[test]\nfn coll_add_unknown_collection_should_fail() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"doc.txt\");\n    std::fs::write(\u0026file, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"coll\",\"add\",\"nope\",\u0026file.to_string_lossy()])\n        .assert()\n        .failure();\n}\n\n/* ───────────────────── RESTORE (bad file) ───────────────────── */\n\n#[test]\nfn restore_with_nonexistent_backup_should_fail() {\n    let tmp   = tempdir().unwrap();\n\n    // create an empty DB first\n    marlin(\u0026tmp).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"restore\", \"/definitely/not/here.db\"])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"Failed to restore\"));\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","pos.rs"],"content":"//! tests pos.rs\n//! Positive-path integration checks for every sub-command\n//! that already has real logic behind it.\n\nmod util;\nuse util::marlin;\n\nuse predicates::{prelude::*, str};          // brings `PredicateBooleanExt::and`\nuse std::fs;\nuse tempfile::tempdir;\n\n/* ─────────────────────────── TAG ─────────────────────────────── */\n\n#[test]\nfn tag_should_add_hierarchical_tag_and_search_finds_it() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"foo.md\");\n    fs::write(\u0026file, \"# test\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"tag\", file.to_str().unwrap(), \"project/md\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"search\", \"tag:project/md\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"foo.md\"));\n}\n\n/* ─────────────────────────── ATTR ────────────────────────────── */\n\n#[test]\nfn attr_set_then_ls_roundtrip() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"report.pdf\");\n    fs::write(\u0026file, \"%PDF-1.4\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"set\", file.to_str().unwrap(), \"reviewed\", \"yes\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"ls\", file.to_str().unwrap()])\n        .assert()\n        .success()\n        .stdout(str::contains(\"reviewed = yes\"));\n}\n\n/* ─────────────────────── COLLECTIONS ────────────────────────── */\n\n#[test]\nfn coll_create_add_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let a = tmp.path().join(\"a.txt\");\n    let b = tmp.path().join(\"b.txt\");\n    fs::write(\u0026a, \"\").unwrap();\n    fs::write(\u0026b, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp).args([\"coll\", \"create\", \"Set\"]).assert().success();\n    for f in [\u0026a, \u0026b] {\n        marlin(\u0026tmp).args([\"coll\", \"add\", \"Set\", f.to_str().unwrap()]).assert().success();\n    }\n\n    marlin(\u0026tmp)\n        .args([\"coll\", \"list\", \"Set\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"a.txt\").and(str::contains(\"b.txt\")));\n}\n\n/* ─────────────────────────── VIEWS ───────────────────────────── */\n\n#[test]\nfn view_save_list_and_exec() {\n    let tmp  = tempdir().unwrap();\n\n    let todo = tmp.path().join(\"TODO.txt\");\n    fs::write(\u0026todo, \"remember the milk\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // save \u0026 list\n    marlin(\u0026tmp).args([\"view\", \"save\", \"tasks\", \"milk\"]).assert().success();\n    marlin(\u0026tmp)\n        .args([\"view\", \"list\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"tasks: milk\"));\n\n    // exec\n    marlin(\u0026tmp)\n        .args([\"view\", \"exec\", \"tasks\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"TODO.txt\"));\n}\n\n/* ─────────────────────────── LINKS ───────────────────────────── */\n\n#[test]\nfn link_add_rm_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let foo = tmp.path().join(\"foo.txt\");\n    let bar = tmp.path().join(\"bar.txt\");\n    fs::write(\u0026foo, \"\").unwrap();\n    fs::write(\u0026bar, \"\").unwrap();\n\n    // handy closure\n    let mc = || marlin(\u0026tmp);\n\n    mc().current_dir(tmp.path()).arg(\"init\").assert().success();\n    mc().args([\"scan\", tmp.path().to_str().unwrap()]).assert().success();\n\n    // add\n    mc().args([\"link\", \"add\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list (outgoing default)\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::contains(\"foo.txt\").and(str::contains(\"bar.txt\")));\n\n    // remove\n    mc().args([\"link\", \"rm\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list now empty\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::is_empty());\n}\n\n/* ─────────────────────── SCAN (multi-path) ───────────────────── */\n\n#[test]\nfn scan_with_multiple_paths_indexes_all() {\n    let tmp = tempdir().unwrap();\n\n    let dir_a = tmp.path().join(\"A\");\n    let dir_b = tmp.path().join(\"B\");\n    std::fs::create_dir_all(\u0026dir_a).unwrap();\n    std::fs::create_dir_all(\u0026dir_b).unwrap();\n    let f1 = dir_a.join(\"one.txt\");\n    let f2 = dir_b.join(\"two.txt\");\n    fs::write(\u0026f1, \"\").unwrap();\n    fs::write(\u0026f2, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // multi-path scan\n    marlin(\u0026tmp)\n        .args([\"scan\", dir_a.to_str().unwrap(), dir_b.to_str().unwrap()])\n        .assert().success();\n\n    // both files findable\n    for term in [\"one.txt\", \"two.txt\"] {\n        marlin(\u0026tmp).args([\"search\", term])\n            .assert()\n            .success()\n            .stdout(str::contains(term));\n    }\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","util.rs"],"content":"//! tests/util.rs\n//! Small helpers shared across integration tests.\n\nuse std::path::{Path, PathBuf};\nuse tempfile::TempDir;\nuse assert_cmd::Command; \n/// Absolute path to the freshly-built `marlin` binary.\npub fn bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Build a `Command` for `marlin` whose `MARLIN_DB_PATH` is\n/// `\u003ctmp\u003e/index.db`.\n///\n/// Each call yields a brand-new `Command`, so callers can freely add\n/// arguments, change the working directory, etc., without affecting\n/// other invocations.\npub fn marlin(tmp: \u0026TempDir) -\u003e Command {\n    let db_path: \u0026Path = \u0026tmp.path().join(\"index.db\");\n    let mut cmd = Command::new(bin());\n    cmd.env(\"MARLIN_DB_PATH\", db_path);\n    cmd\n}\n","traces":[{"line":8,"address":[777600],"length":1,"stats":{"Line":7}},{"line":9,"address":[777608],"length":1,"stats":{"Line":6}},{"line":18,"address":[777632,777969,777975],"length":1,"stats":{"Line":10}},{"line":19,"address":[777783,777670],"length":1,"stats":{"Line":11}},{"line":20,"address":[777823],"length":1,"stats":{"Line":5}},{"line":21,"address":[777860],"length":1,"stats":{"Line":8}},{"line":22,"address":[777930],"length":1,"stats":{"Line":6}}],"covered":7,"coverable":7},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","backup.rs"],"content":"// libmarlin/src/backup.rs\n\nuse anyhow::{anyhow, Context, Result};\nuse chrono::{DateTime, Local, NaiveDateTime, Utc, TimeZone};\nuse rusqlite;\nuse std::fs;\nuse std::path::{Path, PathBuf};\nuse std::time::Duration;\n\nuse crate::error as marlin_error;\n\n#[derive(Debug, Clone)]\npub struct BackupInfo {\n    pub id: String,\n    pub timestamp: DateTime\u003cUtc\u003e,\n    pub size_bytes: u64,\n    pub hash: Option\u003cString\u003e,\n}\n\n#[derive(Debug)]\npub struct PruneResult {\n    pub kept: Vec\u003cBackupInfo\u003e,\n    pub removed: Vec\u003cBackupInfo\u003e,\n}\n\n#[derive(Debug)]\npub struct BackupManager {\n    live_db_path: PathBuf,\n    backups_dir: PathBuf,\n}\n\nimpl BackupManager {\n    pub fn new\u003cP1: AsRef\u003cPath\u003e, P2: AsRef\u003cPath\u003e\u003e(live_db_path: P1, backups_dir: P2) -\u003e Result\u003cSelf\u003e {\n        let backups_dir_path = backups_dir.as_ref().to_path_buf();\n        if !backups_dir_path.exists() {\n            fs::create_dir_all(\u0026backups_dir_path).with_context(|| {\n                format!(\n                    \"Failed to create backup directory at {}\",\n                    backups_dir_path.display()\n                )\n            })?;\n        } else if !backups_dir_path.is_dir() {\n            return Err(anyhow!(\"Backups path exists but is not a directory: {}\", backups_dir_path.display()));\n        }\n        Ok(Self {\n            live_db_path: live_db_path.as_ref().to_path_buf(),\n            backups_dir: backups_dir_path,\n        })\n    }\n\n    pub fn create_backup(\u0026self) -\u003e Result\u003cBackupInfo\u003e {\n        let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S_%f\");\n        let backup_file_name = format!(\"backup_{stamp}.db\");\n        let backup_file_path = self.backups_dir.join(\u0026backup_file_name);\n\n        if !self.live_db_path.exists() {\n             return Err(anyhow::Error::new(std::io::Error::new(\n                std::io::ErrorKind::NotFound,\n                format!(\"Live DB path does not exist: {}\", self.live_db_path.display()),\n            )).context(\"Cannot create backup from non-existent live DB\"));\n        }\n\n        let src_conn = rusqlite::Connection::open_with_flags(\n            \u0026self.live_db_path,\n            rusqlite::OpenFlags::SQLITE_OPEN_READ_ONLY,\n        )\n        .with_context(|| {\n            format!(\n                \"Failed to open source DB ('{}') for backup\",\n                self.live_db_path.display()\n            )\n        })?;\n\n        let mut dst_conn = rusqlite::Connection::open(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to open destination backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        let backup_op =\n            rusqlite::backup::Backup::new(\u0026src_conn, \u0026mut dst_conn).with_context(|| {\n                format!(\n                    \"Failed to initialize backup from {} to {}\",\n                    self.live_db_path.display(),\n                    backup_file_path.display()\n                )\n            })?;\n\n        backup_op\n            .run_to_completion(100, Duration::from_millis(250), None)\n            .map_err(|e| anyhow::Error::new(e).context(\"SQLite backup operation failed\"))?;\n\n        let metadata = fs::metadata(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to get metadata for backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        Ok(BackupInfo {\n            id: backup_file_name,\n            timestamp: DateTime::from(metadata.modified()?),\n            size_bytes: metadata.len(),\n            hash: None,\n        })\n    }\n\n    pub fn list_backups(\u0026self) -\u003e Result\u003cVec\u003cBackupInfo\u003e\u003e {\n        let mut backup_infos = Vec::new();\n        \n        if !self.backups_dir.exists() { \n            return Ok(backup_infos);\n        }\n\n        for entry_result in fs::read_dir(\u0026self.backups_dir).with_context(|| {\n            format!(\n                \"Failed to read backup directory: {}\",\n                self.backups_dir.display()\n            )\n        })? {\n            let entry = entry_result?;\n            let path = entry.path();\n\n            if path.is_file() {\n                if let Some(filename_osstr) = path.file_name() {\n                    if let Some(filename) = filename_osstr.to_str() {\n                        if filename.starts_with(\"backup_\") \u0026\u0026 filename.ends_with(\".db\") {\n                            let ts_str = filename\n                                .trim_start_matches(\"backup_\")\n                                .trim_end_matches(\".db\");\n                            \n                            let naive_dt = match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S_%f\") {\n                                Ok(dt) =\u003e dt,\n                                Err(_) =\u003e match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S\") {\n                                    Ok(dt) =\u003e dt,\n                                    Err(_) =\u003e { \n                                        let metadata = fs::metadata(\u0026path).with_context(|| format!(\"Failed to get metadata for {}\", path.display()))?;\n                                        DateTime::\u003cUtc\u003e::from(metadata.modified()?).naive_utc()\n                                    }\n                                }\n                            };\n                            \n                            let local_dt_result = Local.from_local_datetime(\u0026naive_dt);\n                            let local_dt = match local_dt_result {\n                                chrono::LocalResult::Single(dt) =\u003e dt,\n                                chrono::LocalResult::Ambiguous(dt1, _dt2) =\u003e {\n                                    eprintln!(\"Warning: Ambiguous local time for backup {}, taking first interpretation.\", filename);\n                                    dt1\n                                },\n                                chrono::LocalResult::None =\u003e {\n                                    eprintln!(\"Warning: Invalid local time for backup {}, skipping.\", filename);\n                                    continue; \n                                }\n                            };\n                            let timestamp_utc = DateTime::\u003cUtc\u003e::from(local_dt);\n\n                            let metadata = fs::metadata(\u0026path)?;\n                            backup_infos.push(BackupInfo {\n                                id: filename.to_string(),\n                                timestamp: timestamp_utc,\n                                size_bytes: metadata.len(),\n                                hash: None,\n                            });\n                        }\n                    }\n                }\n            }\n        }\n        backup_infos.sort_by_key(|b| std::cmp::Reverse(b.timestamp));\n        Ok(backup_infos)\n    }\n\n    pub fn prune(\u0026self, keep_count: usize) -\u003e Result\u003cPruneResult\u003e {\n        let all_backups = self.list_backups()?; \n\n        let mut kept = Vec::new();\n        let mut removed = Vec::new();\n\n        if keep_count \u003e= all_backups.len() { \n            kept = all_backups;\n        } else {\n            for (index, backup_info) in all_backups.into_iter().enumerate() {\n                if index \u003c keep_count {\n                    kept.push(backup_info);\n                } else {\n                    let backup_file_path = self.backups_dir.join(\u0026backup_info.id);\n                    if backup_file_path.exists() { \n                        fs::remove_file(\u0026backup_file_path).with_context(|| {\n                            format!(\n                                \"Failed to remove old backup file: {}\",\n                                backup_file_path.display()\n                            )\n                        })?;\n                    }\n                    removed.push(backup_info);\n                }\n            }\n        }\n        Ok(PruneResult { kept, removed })\n    }\n\n    pub fn restore_from_backup(\u0026self, backup_id: \u0026str) -\u003e Result\u003c()\u003e {\n        let backup_file_path = self.backups_dir.join(backup_id);\n        if !backup_file_path.exists() || !backup_file_path.is_file() {\n            return Err(anyhow::Error::new(marlin_error::Error::NotFound(format!(\n                \"Backup file not found or is not a file: {}\",\n                backup_file_path.display()\n            ))));\n        }\n\n        fs::copy(\u0026backup_file_path, \u0026self.live_db_path).with_context(|| {\n            format!(\n                \"Failed to copy backup {} to live DB {}\",\n                backup_file_path.display(),\n                self.live_db_path.display()\n            )\n        })?;\n        Ok(())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use tempfile::tempdir;\n    use crate::db::open as open_marlin_db;\n\n    fn create_valid_live_db(path: \u0026Path) -\u003e rusqlite::Connection {\n        let conn = open_marlin_db(path)\n            .unwrap_or_else(|e| panic!(\"Failed to open/create test DB at {}: {:?}\", path.display(), e));\n        conn.execute_batch(\n            \"CREATE TABLE IF NOT EXISTS test_table (id INTEGER PRIMARY KEY, data TEXT);\n             INSERT INTO test_table (data) VALUES ('initial_data');\"\n        ).expect(\"Failed to initialize test table\");\n        conn\n    }\n\n    #[test]\n    fn test_backup_manager_new_creates_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_new_creates.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_new_creates_test\");\n\n        assert!(!backups_dir.exists());\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        assert!(manager.backups_dir.exists()); \n        assert!(backups_dir.exists());\n    }\n\n    #[test]\n    fn test_backup_manager_new_with_existing_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_existing_dir.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_existing_test\");\n        std::fs::create_dir_all(\u0026backups_dir).unwrap(); \n\n        assert!(backups_dir.exists());\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026backups_dir);\n        assert!(manager_res.is_ok());\n        let manager = manager_res.unwrap();\n        assert_eq!(manager.backups_dir, backups_dir);\n    }\n    \n    #[test]\n    fn test_backup_manager_new_fails_if_backup_path_is_file() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_backup_path_is_file.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n        let file_as_backups_dir = base_tmp.path().join(\"file_as_backups_dir\");\n        std::fs::write(\u0026file_as_backups_dir, \"i am a file\").unwrap();\n\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026file_as_backups_dir);\n        assert!(manager_res.is_err());\n        assert!(manager_res.unwrap_err().to_string().contains(\"Backups path exists but is not a directory\"));\n    }\n\n    #[test]\n    fn test_create_backup_failure_non_existent_live_db() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"non_existent_live.db\"); \n        let backups_dir = base_tmp.path().join(\"backups_fail_test\");\n\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        let backup_result = manager.create_backup();\n        assert!(backup_result.is_err());\n        let err_str = backup_result.unwrap_err().to_string();\n        assert!(err_str.contains(\"Cannot create backup from non-existent live DB\") || err_str.contains(\"Failed to open source DB\"));\n    }\n\n    #[test]\n    fn test_create_list_prune_backups() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_clp_test.db\");\n        let _conn_live = create_valid_live_db(\u0026live_db_file);\n\n        let backups_storage_dir = tmp.path().join(\"backups_clp_storage_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_storage_dir).unwrap();\n\n        let initial_list = manager.list_backups().unwrap();\n        assert!(initial_list.is_empty(), \"Backup list should be empty initially\");\n\n        let prune_empty_result = manager.prune(2).unwrap();\n        assert!(prune_empty_result.kept.is_empty());\n        assert!(prune_empty_result.removed.is_empty());\n\n        let mut created_backup_ids = Vec::new();\n        for i in 0..5 {\n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone()); \n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(listed_backups.len(), 5);\n        for id in \u0026created_backup_ids {\n            assert!(\n                listed_backups.iter().any(|b| \u0026b.id == id),\n                \"Backup ID {} not found in list\", id\n            );\n        }\n        if listed_backups.len() \u003e= 2 {\n            assert!(listed_backups[0].timestamp \u003e= listed_backups[1].timestamp);\n        }\n\n        let prune_to_zero_result = manager.prune(0).unwrap();\n        assert_eq!(prune_to_zero_result.kept.len(), 0);\n        assert_eq!(prune_to_zero_result.removed.len(), 5);\n        let listed_after_prune_zero = manager.list_backups().unwrap();\n        assert!(listed_after_prune_zero.is_empty());\n\n        created_backup_ids.clear();\n        for i in 0..5 { \n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone());\n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let prune_keep_more_result = manager.prune(10).unwrap();\n        assert_eq!(prune_keep_more_result.kept.len(), 5);\n        assert_eq!(prune_keep_more_result.removed.len(), 0);\n        let listed_after_prune_more = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune_more.len(), 5);\n\n        let prune_result = manager.prune(2).unwrap();\n        assert_eq!(prune_result.kept.len(), 2);\n        assert_eq!(prune_result.removed.len(), 3);\n\n        let listed_after_prune = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune.len(), 2);\n\n        assert_eq!(listed_after_prune[0].id, created_backup_ids[4]);\n        assert_eq!(listed_after_prune[1].id, created_backup_ids[3]);\n        \n        for removed_info in prune_result.removed {\n            assert!(\n                !backups_storage_dir.join(\u0026removed_info.id).exists(),\n                \"Removed backup file {} should not exist\", removed_info.id\n            );\n        }\n        for kept_info in prune_result.kept {\n            assert!(\n                backups_storage_dir.join(\u0026kept_info.id).exists(),\n                \"Kept backup file {} should exist\", kept_info.id\n            );\n        }\n    }\n\n     #[test]\n    fn test_restore_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_test.db\");\n        \n        let initial_value = \"initial_data_for_restore\";\n        {\n            let conn = create_valid_live_db(\u0026live_db_path);\n            conn.execute(\"DELETE FROM test_table\", []).unwrap(); \n            conn.execute(\"INSERT INTO test_table (data) VALUES (?1)\", [initial_value]).unwrap();\n        }\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_test_dir\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let backup_info = manager.create_backup().unwrap();\n\n        let modified_value = \"modified_data_for_restore\";\n        {\n            let conn = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB for modification\");\n            conn.execute(\"UPDATE test_table SET data = ?1\", [modified_value])\n                .expect(\"Failed to update data\");\n            let modified_check: String = conn\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(modified_check, modified_value);\n        }\n        \n        manager.restore_from_backup(\u0026backup_info.id).unwrap();\n\n        {\n            let conn_after_restore = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB after restore\");\n            let restored_data: String = conn_after_restore\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(restored_data, initial_value);\n        }\n    }\n\n    #[test]\n    fn test_restore_non_existent_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_fail_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_fail_test\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let result = manager.restore_from_backup(\"non_existent_backup.db\");\n        assert!(result.is_err());\n        let err_string = result.unwrap_err().to_string();\n        assert!(err_string.contains(\"Backup file not found\"), \"Error string was: {}\", err_string);\n    }\n\n    #[test]\n    fn list_backups_with_non_backup_files() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        let backups_dir = tmp.path().join(\"backups_list_mixed_files_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_dir).unwrap();\n\n        manager.create_backup().unwrap(); \n        \n        std::fs::write(backups_dir.join(\"not_a_backup.txt\"), \"hello\").unwrap();\n        std::fs::write(\n            backups_dir.join(\"backup_malformed.db.tmp\"),\n            \"temp data\",\n        )\n        .unwrap();\n        std::fs::create_dir(backups_dir.join(\"a_subdir\")).unwrap();\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(\n            listed_backups.len(),\n            1,\n            \"Should only list the valid backup file\"\n        );\n        assert!(listed_backups[0].id.starts_with(\"backup_\"));\n        assert!(listed_backups[0].id.ends_with(\".db\"));\n    }\n\n     #[test]\n    fn list_backups_handles_io_error_on_read_dir() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_io_error.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        \n        let backups_dir_for_deletion = tmp.path().join(\"backups_dir_to_delete_test\");\n        let manager_for_deletion = BackupManager::new(\u0026live_db_file, \u0026backups_dir_for_deletion).unwrap();\n        std::fs::remove_dir_all(\u0026backups_dir_for_deletion).unwrap(); \n\n        let list_res = manager_for_deletion.list_backups().unwrap();\n        assert!(list_res.is_empty());\n    }\n}","traces":[{"line":33,"address":[1776028,1776022,1775040],"length":1,"stats":{"Line":1}},{"line":34,"address":[],"length":0,"stats":{"Line":2}},{"line":35,"address":[],"length":0,"stats":{"Line":2}},{"line":36,"address":[1775334,1775431,1775477,1776048,1775281],"length":1,"stats":{"Line":2}},{"line":37,"address":[],"length":0,"stats":{"Line":0}},{"line":38,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":42,"address":[],"length":0,"stats":{"Line":3}},{"line":43,"address":[],"length":0,"stats":{"Line":1}},{"line":45,"address":[1775903],"length":1,"stats":{"Line":1}},{"line":46,"address":[1775445,1775828],"length":1,"stats":{"Line":2}},{"line":47,"address":[],"length":0,"stats":{"Line":1}},{"line":51,"address":[1934892,1934898,1931616],"length":1,"stats":{"Line":1}},{"line":52,"address":[1931655],"length":1,"stats":{"Line":1}},{"line":53,"address":[1931792,1931745],"length":1,"stats":{"Line":2}},{"line":54,"address":[1931992,1931908],"length":1,"stats":{"Line":2}},{"line":56,"address":[5474474,5474391],"length":1,"stats":{"Line":2}},{"line":57,"address":[5474782],"length":1,"stats":{"Line":1}},{"line":58,"address":[1932145],"length":1,"stats":{"Line":1}},{"line":59,"address":[1932244,1932153],"length":1,"stats":{"Line":2}},{"line":67,"address":[1776224],"length":1,"stats":{"Line":0}},{"line":68,"address":[1776283],"length":1,"stats":{"Line":0}},{"line":70,"address":[5455670],"length":1,"stats":{"Line":0}},{"line":74,"address":[5475404,5475233,5475304,5477431],"length":1,"stats":{"Line":2}},{"line":75,"address":[1776459],"length":1,"stats":{"Line":0}},{"line":77,"address":[1776422],"length":1,"stats":{"Line":0}},{"line":81,"address":[5456000],"length":1,"stats":{"Line":2}},{"line":83,"address":[1776639,1776698],"length":1,"stats":{"Line":0}},{"line":85,"address":[1776602],"length":1,"stats":{"Line":0}},{"line":86,"address":[5456085],"length":1,"stats":{"Line":0}},{"line":90,"address":[5477386,5476126,5475973],"length":1,"stats":{"Line":1}},{"line":91,"address":[5475891,5475961],"length":1,"stats":{"Line":2}},{"line":92,"address":[1776848,1776849],"length":1,"stats":{"Line":0}},{"line":94,"address":[1776880],"length":1,"stats":{"Line":1}},{"line":95,"address":[5456363],"length":1,"stats":{"Line":0}},{"line":97,"address":[5456326],"length":1,"stats":{"Line":0}},{"line":101,"address":[1934290],"length":1,"stats":{"Line":2}},{"line":102,"address":[1933949],"length":1,"stats":{"Line":1}},{"line":103,"address":[1933989,1934068],"length":1,"stats":{"Line":4}},{"line":104,"address":[5476695],"length":1,"stats":{"Line":2}},{"line":105,"address":[1934282],"length":1,"stats":{"Line":2}},{"line":109,"address":[1935056,1938632,1938387],"length":1,"stats":{"Line":2}},{"line":110,"address":[1935095],"length":1,"stats":{"Line":2}},{"line":112,"address":[1935132,1935215],"length":1,"stats":{"Line":3}},{"line":113,"address":[1935250],"length":1,"stats":{"Line":1}},{"line":116,"address":[5456480],"length":1,"stats":{"Line":3}},{"line":117,"address":[1777119],"length":1,"stats":{"Line":0}},{"line":119,"address":[1777078],"length":1,"stats":{"Line":0}},{"line":122,"address":[1938597,1935748,1935954],"length":1,"stats":{"Line":2}},{"line":123,"address":[1936122],"length":1,"stats":{"Line":1}},{"line":125,"address":[1936201,1936281],"length":1,"stats":{"Line":2}},{"line":126,"address":[1936342],"length":1,"stats":{"Line":1}},{"line":127,"address":[1936507],"length":1,"stats":{"Line":1}},{"line":128,"address":[1936629],"length":1,"stats":{"Line":1}},{"line":129,"address":[1936753],"length":1,"stats":{"Line":1}},{"line":133,"address":[5479395],"length":1,"stats":{"Line":1}},{"line":134,"address":[5479496],"length":1,"stats":{"Line":1}},{"line":135,"address":[1936952,1937079],"length":1,"stats":{"Line":0}},{"line":136,"address":[1937133],"length":1,"stats":{"Line":0}},{"line":138,"address":[5456656,5456678],"length":1,"stats":{"Line":0}},{"line":139,"address":[1938524,1937401],"length":1,"stats":{"Line":0}},{"line":144,"address":[5479556],"length":1,"stats":{"Line":1}},{"line":145,"address":[5480127],"length":1,"stats":{"Line":1}},{"line":146,"address":[1937631],"length":1,"stats":{"Line":1}},{"line":147,"address":[1937697],"length":1,"stats":{"Line":0}},{"line":148,"address":[5480361,5480261],"length":1,"stats":{"Line":0}},{"line":149,"address":[1937898],"length":1,"stats":{"Line":0}},{"line":152,"address":[1938414,1937756],"length":1,"stats":{"Line":0}},{"line":156,"address":[5480318],"length":1,"stats":{"Line":1}},{"line":158,"address":[1938393,1937935],"length":1,"stats":{"Line":1}},{"line":159,"address":[1938250],"length":1,"stats":{"Line":1}},{"line":160,"address":[1938128],"length":1,"stats":{"Line":1}},{"line":162,"address":[1938171],"length":1,"stats":{"Line":1}},{"line":163,"address":[1938242],"length":1,"stats":{"Line":1}},{"line":170,"address":[1777421,1777408],"length":1,"stats":{"Line":3}},{"line":171,"address":[1935839],"length":1,"stats":{"Line":1}},{"line":174,"address":[1938656,1940571,1940404],"length":1,"stats":{"Line":1}},{"line":175,"address":[1938699],"length":1,"stats":{"Line":1}},{"line":177,"address":[1938901],"length":1,"stats":{"Line":1}},{"line":178,"address":[5481500],"length":1,"stats":{"Line":1}},{"line":180,"address":[5481560,5481632,5483195],"length":1,"stats":{"Line":3}},{"line":181,"address":[1939130,1940430],"length":1,"stats":{"Line":1}},{"line":183,"address":[1939070,1939201,1940299,1939320],"length":1,"stats":{"Line":4}},{"line":184,"address":[1939426],"length":1,"stats":{"Line":1}},{"line":185,"address":[1939712,1940410],"length":1,"stats":{"Line":2}},{"line":187,"address":[1939688,1939884],"length":1,"stats":{"Line":2}},{"line":188,"address":[1939919,1939987],"length":1,"stats":{"Line":2}},{"line":189,"address":[1777456],"length":1,"stats":{"Line":1}},{"line":190,"address":[1777515],"length":1,"stats":{"Line":0}},{"line":192,"address":[1777478],"length":1,"stats":{"Line":0}},{"line":196,"address":[5482607],"length":1,"stats":{"Line":1}},{"line":200,"address":[1939460],"length":1,"stats":{"Line":1}},{"line":203,"address":[1941450,1941456,1940608],"length":1,"stats":{"Line":1}},{"line":204,"address":[1940663],"length":1,"stats":{"Line":1}},{"line":205,"address":[1940861,1940807,1940724],"length":1,"stats":{"Line":3}},{"line":206,"address":[1941002],"length":1,"stats":{"Line":1}},{"line":208,"address":[5483476,5483603],"length":1,"stats":{"Line":2}},{"line":212,"address":[1777632],"length":1,"stats":{"Line":2}},{"line":213,"address":[1777695,1777754],"length":1,"stats":{"Line":0}},{"line":215,"address":[1777658],"length":1,"stats":{"Line":0}},{"line":216,"address":[1777717],"length":1,"stats":{"Line":0}},{"line":219,"address":[1941391],"length":1,"stats":{"Line":1}}],"covered":73,"coverable":102},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config.rs"],"content":"use anyhow::Result;\nuse directories::ProjectDirs;\nuse std::{\n    collections::hash_map::DefaultHasher,\n    hash::{Hash, Hasher},\n    path::{Path, PathBuf},\n};\n\n/// Runtime configuration (currently just the DB path).\n#[derive(Debug, Clone)]\npub struct Config {\n    pub db_path: PathBuf,\n}\n\nimpl Config {\n    /// Resolve configuration from environment or derive one per-workspace.\n    ///\n    /// Priority:\n    /// 1. `MARLIN_DB_PATH` env-var (explicit override)\n    /// 2. *Workspace-local* file under XDG data dir\n    ///    (`~/.local/share/marlin/index_\u003chash\u003e.db`)\n    /// 3. Fallback to   `./index.db`  when we cannot locate an XDG dir\n    pub fn load() -\u003e Result\u003cSelf\u003e {\n        // 1) explicit override\n        if let Some(val) = std::env::var_os(\"MARLIN_DB_PATH\") {\n            let p = PathBuf::from(val);\n            std::fs::create_dir_all(p.parent().expect(\"has parent\"))?;\n            return Ok(Self { db_path: p });\n        }\n\n        // 2) derive per-workspace DB name from CWD hash\n        let cwd = std::env::current_dir()?;\n        let mut h = DefaultHasher::new();\n        cwd.hash(\u0026mut h);\n        let digest = h.finish(); // 64-bit\n        let file_name = format!(\"index_{digest:016x}.db\");\n\n        if let Some(dirs) = ProjectDirs::from(\"io\", \"Marlin\", \"marlin\") {\n            let dir = dirs.data_dir();\n            std::fs::create_dir_all(dir)?;\n            return Ok(Self {\n                db_path: dir.join(file_name),\n            });\n        }\n\n        // 3) very last resort – workspace-relative DB\n        Ok(Self {\n            db_path: Path::new(\u0026file_name).to_path_buf(),\n        })\n    }\n}\n","traces":[{"line":23,"address":[5467872,5468661,5468655],"length":1,"stats":{"Line":2}},{"line":25,"address":[1805767],"length":1,"stats":{"Line":2}},{"line":26,"address":[1805902],"length":1,"stats":{"Line":2}},{"line":27,"address":[1805923,1806105,1806471],"length":1,"stats":{"Line":4}},{"line":28,"address":[1806320],"length":1,"stats":{"Line":2}},{"line":32,"address":[1805963,1806542],"length":1,"stats":{"Line":1}},{"line":33,"address":[1806644],"length":1,"stats":{"Line":1}},{"line":34,"address":[1806695],"length":1,"stats":{"Line":1}},{"line":35,"address":[1806730],"length":1,"stats":{"Line":1}},{"line":36,"address":[1806755],"length":1,"stats":{"Line":1}},{"line":38,"address":[1807040,1807142],"length":1,"stats":{"Line":2}},{"line":39,"address":[1807312,1807219],"length":1,"stats":{"Line":2}},{"line":40,"address":[1807344,1807645],"length":1,"stats":{"Line":1}},{"line":41,"address":[1807543],"length":1,"stats":{"Line":1}},{"line":42,"address":[1807472],"length":1,"stats":{"Line":1}},{"line":47,"address":[1807765],"length":1,"stats":{"Line":0}},{"line":48,"address":[1807711],"length":1,"stats":{"Line":0}}],"covered":15,"coverable":17},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config_tests.rs"],"content":"// libmarlin/src/config_tests.rs\n\nuse super::config::Config;\nuse std::env;\nuse tempfile::tempdir;\n\n#[test]\nfn load_env_override() {\n    let tmp = tempdir().unwrap();\n    let db = tmp.path().join(\"custom.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db);\n    let cfg = Config::load().unwrap();\n    assert_eq!(cfg.db_path, db);\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn load_xdg_or_fallback() {\n    // since XDG_DATA_HOME will normally be present, just test it doesn't error\n    let cfg = Config::load().unwrap();\n    assert!(cfg.db_path.to_string_lossy().ends_with(\".db\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","database.rs"],"content":"//! Database abstraction for Marlin\n//! \n//! This module provides a database abstraction layer that wraps the SQLite connection\n//! and provides methods for common database operations.\n\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse anyhow::Result;\n\n/// Options for indexing files\n#[derive(Debug, Clone)]\npub struct IndexOptions {\n    /// Only update files marked as dirty\n    pub dirty_only: bool,\n    \n    /// Index file contents (not just metadata)\n    pub index_contents: bool,\n    \n    /// Maximum file size to index (in bytes)\n    pub max_size: Option\u003cu64\u003e,\n}\n\nimpl Default for IndexOptions {\n    fn default() -\u003e Self {\n        Self {\n            dirty_only: false,\n            index_contents: true,\n            max_size: Some(1_000_000), // 1MB default limit\n        }\n    }\n}\n\n/// Database wrapper for Marlin\npub struct Database {\n    /// The SQLite connection\n    conn: Connection,\n}\n\nimpl Database {\n    /// Create a new database wrapper around an existing connection\n    pub fn new(conn: Connection) -\u003e Self {\n        Self { conn }\n    }\n    \n    /// Get a reference to the underlying connection\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n    \n    /// Get a mutable reference to the underlying connection\n    pub fn conn_mut(\u0026mut self) -\u003e \u0026mut Connection {\n        \u0026mut self.conn\n    }\n    \n    /// Index one or more files\n    pub fn index_files(\u0026mut self, paths: \u0026[PathBuf], _options: \u0026IndexOptions) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would index the files\n        // For now, we just return the number of files \"indexed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n    \n    /// Remove files from the index\n    pub fn remove_files(\u0026mut self, paths: \u0026[PathBuf]) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would remove the files\n        // For now, we just return the number of files \"removed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n    use tempfile::tempdir;\n    use std::fs::File;\n\n    fn setup_db() -\u003e Database {\n        let conn = open_marlin_db(\":memory:\").expect(\"Failed to open in-memory DB\");\n        Database::new(conn)\n    }\n\n    #[test]\n    fn test_database_new_conn_conn_mut() {\n        let mut db = setup_db();\n        let _conn_ref = db.conn();\n        let _conn_mut_ref = db.conn_mut();\n        // Just checking they don't panic and can be called.\n    }\n\n    #[test]\n    fn test_index_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap();\n\n        let paths = vec![file1.to_path_buf()];\n        let options = IndexOptions::default();\n        \n        assert_eq!(db.index_files(\u0026paths, \u0026options).unwrap(), 1);\n        assert_eq!(db.index_files(\u0026[], \u0026options).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_remove_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap(); // File doesn't need to be in DB for this stub\n\n        let paths = vec![file1.to_path_buf()];\n        \n        assert_eq!(db.remove_files(\u0026paths).unwrap(), 1);\n        assert_eq!(db.remove_files(\u0026[]).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_index_options_default() {\n        let options = IndexOptions::default();\n        assert!(!options.dirty_only);\n        assert!(options.index_contents);\n        assert_eq!(options.max_size, Some(1_000_000));\n    }\n}\n","traces":[{"line":24,"address":[5444320],"length":1,"stats":{"Line":1}},{"line":28,"address":[1972867],"length":1,"stats":{"Line":1}},{"line":41,"address":[1972912],"length":1,"stats":{"Line":3}},{"line":46,"address":[1972944],"length":1,"stats":{"Line":1}},{"line":51,"address":[1972960],"length":1,"stats":{"Line":1}},{"line":56,"address":[1972976],"length":1,"stats":{"Line":1}},{"line":59,"address":[1973029],"length":1,"stats":{"Line":1}},{"line":60,"address":[1973059],"length":1,"stats":{"Line":1}},{"line":62,"address":[1973043],"length":1,"stats":{"Line":1}},{"line":66,"address":[1973104],"length":1,"stats":{"Line":1}},{"line":69,"address":[1973154],"length":1,"stats":{"Line":1}},{"line":70,"address":[1973184],"length":1,"stats":{"Line":1}},{"line":72,"address":[1973168],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":13},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","mod.rs"],"content":"//! Central DB helper – connection bootstrap, migrations **and** most\n//! data-access helpers (tags, links, collections, saved views, …).\n\nmod database;\npub use database::{Database, IndexOptions};\n\nuse std::{\n    fs,\n    path::{Path, PathBuf},\n};\n\nuse std::result::Result as StdResult;\nuse anyhow::{Context, Result};\nuse chrono::Local;\nuse rusqlite::{\n    backup::{Backup, StepResult},\n    params,\n    Connection,\n    OpenFlags,\n    OptionalExtension,\n    TransactionBehavior,\n};\nuse tracing::{debug, info, warn};\n\n/* ─── embedded migrations ─────────────────────────────────────────── */\n\nconst MIGRATIONS: \u0026[(\u0026str, \u0026str)] = \u0026[\n    (\"0001_initial_schema.sql\", include_str!(\"migrations/0001_initial_schema.sql\")),\n    (\"0002_update_fts_and_triggers.sql\", include_str!(\"migrations/0002_update_fts_and_triggers.sql\")),\n    (\"0003_create_links_collections_views.sql\", include_str!(\"migrations/0003_create_links_collections_views.sql\")),\n    (\"0004_fix_hierarchical_tags_fts.sql\", include_str!(\"migrations/0004_fix_hierarchical_tags_fts.sql\")),\n    (\"0005_add_dirty_table.sql\", include_str!(\"migrations/0005_add_dirty_table.sql\")),\n];\n\n/* ─── connection bootstrap ────────────────────────────────────────── */\n\npub fn open\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cConnection\u003e {\n    let db_path_ref = db_path.as_ref();\n    let mut conn = Connection::open(db_path_ref)\n        .with_context(|| format!(\"failed to open DB at {}\", db_path_ref.display()))?;\n\n    conn.pragma_update(None, \"journal_mode\", \"WAL\")?;\n    conn.pragma_update(None, \"foreign_keys\", \"ON\")?;\n\n    // Wait up to 30 s for a competing writer before giving up\n    conn.busy_timeout(std::time::Duration::from_secs(30))?;\n\n    apply_migrations(\u0026mut conn)?;\n    Ok(conn)\n}\n\n/* ─── migration runner ────────────────────────────────────────────── */\n\npub(crate) fn apply_migrations(conn: \u0026mut Connection) -\u003e Result\u003c()\u003e {\n    // Ensure schema_version bookkeeping table exists\n    conn.execute_batch(\n        \"CREATE TABLE IF NOT EXISTS schema_version (\n             version     INTEGER PRIMARY KEY,\n             applied_on  TEXT NOT NULL\n         );\",\n    )?;\n\n    // Legacy patch – ignore errors if column already exists\n    let _ = conn.execute(\"ALTER TABLE schema_version ADD COLUMN applied_on TEXT\", []);\n\n    // Grab the write-lock up-front so migrations can run uninterrupted\n    let tx = conn.transaction_with_behavior(TransactionBehavior::Immediate)?;\n\n    for (fname, sql) in MIGRATIONS {\n        let version: i64 = fname\n            .split('_')\n            .next()\n            .and_then(|s| s.parse().ok())\n            .expect(\"migration filenames start with number\");\n\n        let already: Option\u003ci64\u003e = tx\n            .query_row(\n                \"SELECT version FROM schema_version WHERE version = ?1\",\n                [version],\n                |r| r.get(0),\n            )\n            .optional()?;\n\n        if already.is_some() {\n            debug!(\"migration {} already applied\", fname);\n            continue;\n        }\n\n        info!(\"applying migration {}\", fname);\n        tx.execute_batch(sql)\n            .with_context(|| format!(\"could not apply migration {}\", fname))?;\n\n        tx.execute(\n            \"INSERT INTO schema_version (version, applied_on) VALUES (?1, ?2)\",\n            params![version, Local::now().to_rfc3339()],\n        )?;\n    }\n\n    tx.commit()?;\n\n    // sanity – warn if any embedded migration got skipped\n    let mut missing = Vec::new();\n    for (fname, _) in MIGRATIONS {\n        let v: i64 = fname.split('_').next().unwrap().parse().unwrap();\n        let ok: bool = conn\n            .query_row(\n                \"SELECT 1 FROM schema_version WHERE version = ?1\",\n                [v],\n                |_| Ok(true),\n            )\n            .optional()?\n            .unwrap_or(false);\n        if !ok {\n            missing.push(v);\n        }\n    }\n    if !missing.is_empty() {\n        warn!(\"migrations not applied: {:?}\", missing);\n    }\n\n    Ok(())\n}\n\n/* ─── tag helpers ─────────────────────────────────────────────────── */\n\npub fn ensure_tag_path(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    let mut parent: Option\u003ci64\u003e = None;\n    for segment in path.split('/').filter(|s| !s.is_empty()) {\n        conn.execute(\n            \"INSERT OR IGNORE INTO tags(name, parent_id) VALUES (?1, ?2)\",\n            params![segment, parent],\n        )?;\n        let id: i64 = conn.query_row(\n            \"SELECT id FROM tags WHERE name = ?1 AND (parent_id IS ?2 OR parent_id = ?2)\",\n            params![segment, parent],\n            |r| r.get(0),\n        )?;\n        parent = Some(id);\n    }\n    parent.ok_or_else(|| anyhow::anyhow!(\"empty tag path\"))\n}\n\npub fn file_id(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.query_row(\"SELECT id FROM files WHERE path = ?1\", [path], |r| r.get(0))\n        .map_err(|_| anyhow::anyhow!(\"file not indexed: {}\", path))\n}\n\n/* ─── attributes ──────────────────────────────────────────────────── */\n\npub fn upsert_attr(conn: \u0026Connection, file_id: i64, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        r#\"\n        INSERT INTO attributes(file_id, key, value)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(file_id, key) DO UPDATE SET value = excluded.value\n        \"#,\n        params![file_id, key, value],\n    )?;\n    Ok(())\n}\n\n/* ─── links ───────────────────────────────────────────────────────── */\n\npub fn add_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO links(src_file_id, dst_file_id, type)\n         VALUES (?1, ?2, ?3)\n         ON CONFLICT(src_file_id, dst_file_id, type) DO NOTHING\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn remove_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"DELETE FROM links\n         WHERE src_file_id = ?1\n           AND dst_file_id = ?2\n           AND (type IS ?3 OR type = ?3)\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn list_links(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n    direction: Option\u003c\u0026str\u003e,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003cVec\u003c(String, String, Option\u003cString\u003e)\u003e\u003e {\n    let like_pattern = pattern.replace('*', \"%\");\n\n    // Files matching pattern\n    let mut stmt = conn.prepare(\"SELECT id, path FROM files WHERE path LIKE ?1\")?;\n    let rows = stmt\n        .query_map(params![like_pattern], |r| {\n            Ok((r.get::\u003c_, i64\u003e(0)?, r.get::\u003c_, String\u003e(1)?))\n        })?\n        .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n    let mut out = Vec::new();\n    for (fid, fpath) in rows {\n        let (src_col, dst_col) = match direction {\n            Some(\"in\") =\u003e (\"dst_file_id\", \"src_file_id\"),\n            _ =\u003e (\"src_file_id\", \"dst_file_id\"),\n        };\n\n        let sql = format!(\n            \"SELECT f2.path, l.type\n               FROM links l\n               JOIN files f2 ON f2.id = l.{dst_col}\n              WHERE l.{src_col} = ?1\n                AND (?2 IS NULL OR l.type = ?2)\",\n        );\n\n        let mut stmt2 = conn.prepare(\u0026sql)?;\n        let links = stmt2\n            .query_map(params![fid, link_type], |r| {\n                Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n            })?\n            .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n        for (other, typ) in links {\n            out.push((fpath.clone(), other, typ));\n        }\n    }\n    Ok(out)\n}\n\npub fn find_backlinks(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n) -\u003e Result\u003cVec\u003c(String, Option\u003cString\u003e)\u003e\u003e {\n    let like = pattern.replace('*', \"%\");\n\n    let mut stmt = conn.prepare(\n        \"SELECT f1.path, l.type\n           FROM links l\n           JOIN files f1 ON f1.id = l.src_file_id\n           JOIN files f2 ON f2.id = l.dst_file_id\n          WHERE f2.path LIKE ?1\",\n    )?;\n\n    let rows = stmt.query_map([like], |r| {\n        Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n    })?;\n\n    let out = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(out)\n}\n\n/* ─── collections helpers ────────────────────────────────────────── */\n\npub fn ensure_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collections(name) VALUES (?1)\",\n        params![name],\n    )?;\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        params![name],\n        |r| r.get(0),\n    )\n    .context(\"collection lookup failed\")\n}\n\npub fn add_file_to_collection(conn: \u0026Connection, coll_id: i64, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collection_files(collection_id, file_id)\n         VALUES (?1, ?2)\",\n        params![coll_id, file_id],\n    )?;\n    Ok(())\n}\n\npub fn list_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let mut stmt = conn.prepare(\n        r#\"SELECT f.path\n            FROM collections        c\n            JOIN collection_files cf ON cf.collection_id = c.id\n            JOIN files            f  ON f.id            = cf.file_id\n           WHERE c.name = ?1\n           ORDER BY f.path\"#,\n    )?;\n\n    let rows = stmt.query_map([name], |r| r.get::\u003c_, String\u003e(0))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\n/* ─── saved views (smart folders) ───────────────────────────────── */\n\npub fn save_view(conn: \u0026Connection, name: \u0026str, query: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO views(name, query)\n         VALUES (?1, ?2)\n         ON CONFLICT(name) DO UPDATE SET query = excluded.query\",\n        params![name, query],\n    )?;\n    Ok(())\n}\n\npub fn list_views(conn: \u0026Connection) -\u003e Result\u003cVec\u003c(String, String)\u003e\u003e {\n    let mut stmt = conn.prepare(\"SELECT name, query FROM views ORDER BY name\")?;\n    let rows = stmt.query_map([], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\npub fn view_query(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cString\u003e {\n    conn.query_row(\n        \"SELECT query FROM views WHERE name = ?1\",\n        [name],\n        |r| r.get::\u003c_, String\u003e(0),\n    )\n    .context(format!(\"no view called '{}'\", name))\n}\n\n/* ─── dirty‐scan helpers ─────────────────────────────────────────── */\n\n/// Mark a file as “dirty” so it’ll be picked up by `scan_dirty`.\npub fn mark_dirty(conn: \u0026Connection, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO file_changes(file_id, marked_at)\n         VALUES (?1, strftime('%s','now'))\",\n        params![file_id],\n    )?;\n    Ok(())\n}\n\n/// Take and clear all dirty file IDs for incremental re-scan.\npub fn take_dirty(conn: \u0026Connection) -\u003e Result\u003cVec\u003ci64\u003e\u003e {\n    let mut ids = Vec::new();\n    {\n        let mut stmt = conn.prepare(\"SELECT file_id FROM file_changes\")?;\n        for row in stmt.query_map([], |r| r.get(0))? {\n            ids.push(row?);\n        }\n    }\n    conn.execute(\"DELETE FROM file_changes\", [])?;\n    Ok(ids)\n}\n\n/* ─── backup / restore helpers ────────────────────────────────────── */\n\npub fn backup\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cPathBuf\u003e {\n    let src = db_path.as_ref();\n    let dir = src\n        .parent()\n        .ok_or_else(|| anyhow::anyhow!(\"invalid DB path: {}\", src.display()))?\n        .join(\"backups\");\n    fs::create_dir_all(\u0026dir)?;\n\n    let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S\");\n    let dst = dir.join(format!(\"backup_{stamp}.db\"));\n\n    let src_conn = Connection::open_with_flags(src, OpenFlags::SQLITE_OPEN_READ_ONLY)?;\n    let mut dst_conn = Connection::open(\u0026dst)?;\n\n    let bk = Backup::new(\u0026src_conn, \u0026mut dst_conn)?;\n    while let StepResult::More = bk.step(100)? {}\n    Ok(dst)\n}\n\npub fn restore\u003cP: AsRef\u003cPath\u003e\u003e(backup_path: P, live_db_path: P) -\u003e Result\u003c()\u003e {\n    fs::copy(\u0026backup_path, \u0026live_db_path)?;\n    Ok(())\n}\n\n/* ─── tests ───────────────────────────────────────────────────────── */\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn migrations_apply_in_memory() {\n        open(\":memory:\").expect(\"all migrations apply\");\n    }\n}\n","traces":[{"line":37,"address":[5333152,5333200,5334557],"length":1,"stats":{"Line":10}},{"line":38,"address":[],"length":0,"stats":{"Line":21}},{"line":39,"address":[5334563,5333395,5333277],"length":1,"stats":{"Line":11}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":42,"address":[2025001,2025809,2024890,2022249,2024425,2023057,2023506,2022138,2023617],"length":1,"stats":{"Line":17}},{"line":43,"address":[2024423,2023055,2025807,2022407,2023775,2025159],"length":1,"stats":{"Line":5}},{"line":46,"address":[2024421,2025805,2022640,2025392,2023053,2024008],"length":1,"stats":{"Line":7}},{"line":48,"address":[],"length":0,"stats":{"Line":9}},{"line":49,"address":[5334456],"length":1,"stats":{"Line":9}},{"line":54,"address":[5284208,5286823,5289545],"length":1,"stats":{"Line":2}},{"line":56,"address":[5284234,5284353],"length":1,"stats":{"Line":5}},{"line":64,"address":[5284395],"length":1,"stats":{"Line":3}},{"line":67,"address":[1905016],"length":1,"stats":{"Line":3}},{"line":69,"address":[1905215,1905307],"length":1,"stats":{"Line":6}},{"line":70,"address":[1907346,1905437],"length":1,"stats":{"Line":6}},{"line":73,"address":[5334772,5334752],"length":1,"stats":{"Line":6}},{"line":76,"address":[5287252,5289503,5287042,5287003],"length":1,"stats":{"Line":6}},{"line":79,"address":[5287026],"length":1,"stats":{"Line":1}},{"line":80,"address":[5334816,5334832],"length":1,"stats":{"Line":2}},{"line":84,"address":[5287337],"length":1,"stats":{"Line":1}},{"line":85,"address":[5287404,5288837],"length":1,"stats":{"Line":2}},{"line":89,"address":[5287376,5287733,5287442],"length":1,"stats":{"Line":5}},{"line":90,"address":[1909260,1908791,1908186,1908660],"length":1,"stats":{"Line":7}},{"line":91,"address":[2026464,2026486],"length":1,"stats":{"Line":0}},{"line":93,"address":[1908942,1909027,1909225,1909155,1908821],"length":1,"stats":{"Line":8}},{"line":95,"address":[1908833],"length":1,"stats":{"Line":1}},{"line":99,"address":[5286837,5284916],"length":1,"stats":{"Line":4}},{"line":102,"address":[5285119],"length":1,"stats":{"Line":1}},{"line":103,"address":[1905693,1905784],"length":1,"stats":{"Line":4}},{"line":104,"address":[1905886,1906763],"length":1,"stats":{"Line":5}},{"line":105,"address":[1906945,1907143,1907280],"length":1,"stats":{"Line":2}},{"line":108,"address":[1906937],"length":1,"stats":{"Line":3}},{"line":109,"address":[2026600,2026592],"length":1,"stats":{"Line":6}},{"line":113,"address":[1907229],"length":1,"stats":{"Line":4}},{"line":114,"address":[5286738],"length":1,"stats":{"Line":0}},{"line":117,"address":[5285377],"length":1,"stats":{"Line":4}},{"line":118,"address":[1906020,1905955],"length":1,"stats":{"Line":0}},{"line":121,"address":[1905983],"length":1,"stats":{"Line":4}},{"line":126,"address":[5289584],"length":1,"stats":{"Line":1}},{"line":127,"address":[5289620],"length":1,"stats":{"Line":1}},{"line":128,"address":[2026624,2026638],"length":1,"stats":{"Line":4}},{"line":129,"address":[1910465,1910296],"length":1,"stats":{"Line":1}},{"line":131,"address":[5289808],"length":1,"stats":{"Line":1}},{"line":133,"address":[1910577,1910701],"length":1,"stats":{"Line":1}},{"line":135,"address":[5290092],"length":1,"stats":{"Line":1}},{"line":136,"address":[2026672,2026688],"length":1,"stats":{"Line":2}},{"line":138,"address":[1910752],"length":1,"stats":{"Line":1}},{"line":140,"address":[2026720,2026724],"length":1,"stats":{"Line":1}},{"line":143,"address":[1910816],"length":1,"stats":{"Line":0}},{"line":144,"address":[2026784,2026800],"length":1,"stats":{"Line":0}},{"line":145,"address":[2026832,2026849],"length":1,"stats":{"Line":0}},{"line":150,"address":[1910928],"length":1,"stats":{"Line":1}},{"line":151,"address":[1911058,1911167],"length":1,"stats":{"Line":1}},{"line":157,"address":[1910974],"length":1,"stats":{"Line":1}},{"line":159,"address":[1911207],"length":1,"stats":{"Line":1}},{"line":164,"address":[5290800],"length":1,"stats":{"Line":1}},{"line":170,"address":[1911463,1911354],"length":1,"stats":{"Line":1}},{"line":174,"address":[5290840],"length":1,"stats":{"Line":1}},{"line":176,"address":[1911503],"length":1,"stats":{"Line":1}},{"line":179,"address":[1911536],"length":1,"stats":{"Line":1}},{"line":185,"address":[1911658,1911767],"length":1,"stats":{"Line":1}},{"line":190,"address":[1911576],"length":1,"stats":{"Line":1}},{"line":192,"address":[1911807],"length":1,"stats":{"Line":1}},{"line":195,"address":[1911840,1915861,1915647],"length":1,"stats":{"Line":1}},{"line":201,"address":[1911948],"length":1,"stats":{"Line":1}},{"line":204,"address":[1915859,1912085,1912017],"length":1,"stats":{"Line":2}},{"line":205,"address":[1912454,1912521,1912634,1915839,1912835],"length":1,"stats":{"Line":2}},{"line":206,"address":[1912402],"length":1,"stats":{"Line":2}},{"line":207,"address":[2027118],"length":1,"stats":{"Line":1}},{"line":211,"address":[1912940],"length":1,"stats":{"Line":1}},{"line":212,"address":[1912988,1913088,1913215],"length":1,"stats":{"Line":3}},{"line":213,"address":[1913676,1913316],"length":1,"stats":{"Line":2}},{"line":214,"address":[5293099,5293236],"length":1,"stats":{"Line":0}},{"line":215,"address":[1913512],"length":1,"stats":{"Line":1}},{"line":218,"address":[5293360],"length":1,"stats":{"Line":1}},{"line":226,"address":[1915743,1914002,1913918],"length":1,"stats":{"Line":2}},{"line":227,"address":[1914790,1915722,1914589,1914476,1914409,1915693],"length":1,"stats":{"Line":2}},{"line":228,"address":[2028264,2028270,2027584],"length":1,"stats":{"Line":2}},{"line":229,"address":[5336030,5336628],"length":1,"stats":{"Line":1}},{"line":233,"address":[1914887,1914991,1915608,1915118],"length":1,"stats":{"Line":4}},{"line":234,"address":[5294895,5295053],"length":1,"stats":{"Line":2}},{"line":237,"address":[5292993],"length":1,"stats":{"Line":1}},{"line":240,"address":[1917112,1915888,1917157],"length":1,"stats":{"Line":1}},{"line":244,"address":[1915958],"length":1,"stats":{"Line":1}},{"line":246,"address":[5295767,5296844,5295699,5295894],"length":1,"stats":{"Line":2}},{"line":254,"address":[5296071,5296830,5296210,5296343],"length":1,"stats":{"Line":3}},{"line":255,"address":[2028334,2028917],"length":1,"stats":{"Line":1}},{"line":258,"address":[1917068,1916828,1916732],"length":1,"stats":{"Line":2}},{"line":259,"address":[5296708],"length":1,"stats":{"Line":1}},{"line":264,"address":[1917200],"length":1,"stats":{"Line":1}},{"line":265,"address":[5296975,5297085],"length":1,"stats":{"Line":1}},{"line":267,"address":[1917235],"length":1,"stats":{"Line":1}},{"line":269,"address":[5297163],"length":1,"stats":{"Line":1}},{"line":271,"address":[5297135],"length":1,"stats":{"Line":1}},{"line":272,"address":[2028992,2029008],"length":1,"stats":{"Line":2}},{"line":277,"address":[1917552],"length":1,"stats":{"Line":1}},{"line":278,"address":[1917636,1917745],"length":1,"stats":{"Line":1}},{"line":281,"address":[5297294],"length":1,"stats":{"Line":1}},{"line":283,"address":[1917785],"length":1,"stats":{"Line":1}},{"line":286,"address":[1918833,1918841,1917808],"length":1,"stats":{"Line":1}},{"line":287,"address":[1917858,1917970],"length":1,"stats":{"Line":1}},{"line":296,"address":[2029075,2029040],"length":1,"stats":{"Line":4}},{"line":297,"address":[1918537,1918792,1918441],"length":1,"stats":{"Line":2}},{"line":298,"address":[5298478],"length":1,"stats":{"Line":1}},{"line":303,"address":[1918864],"length":1,"stats":{"Line":1}},{"line":304,"address":[1919067,1918958],"length":1,"stats":{"Line":1}},{"line":308,"address":[1918904],"length":1,"stats":{"Line":1}},{"line":310,"address":[1919107],"length":1,"stats":{"Line":1}},{"line":313,"address":[1919136,1920103,1920095],"length":1,"stats":{"Line":1}},{"line":314,"address":[1919160],"length":1,"stats":{"Line":1}},{"line":315,"address":[5337536,5337582],"length":1,"stats":{"Line":4}},{"line":316,"address":[1919801,1920054,1919705],"length":1,"stats":{"Line":2}},{"line":317,"address":[1919987],"length":1,"stats":{"Line":1}},{"line":320,"address":[1920462,1920128,1920437],"length":1,"stats":{"Line":1}},{"line":321,"address":[1920162,1920391,1920190],"length":1,"stats":{"Line":3}},{"line":323,"address":[1920170],"length":1,"stats":{"Line":1}},{"line":324,"address":[2029808,2029824],"length":1,"stats":{"Line":2}},{"line":326,"address":[1920455,1920225,1920421,1920249],"length":1,"stats":{"Line":2}},{"line":332,"address":[1920480],"length":1,"stats":{"Line":0}},{"line":333,"address":[1920534,1920643],"length":1,"stats":{"Line":0}},{"line":336,"address":[1920506],"length":1,"stats":{"Line":0}},{"line":338,"address":[1920683],"length":1,"stats":{"Line":0}},{"line":342,"address":[1922153,1920720,1922166],"length":1,"stats":{"Line":0}},{"line":343,"address":[1920755],"length":1,"stats":{"Line":0}},{"line":345,"address":[1920829,1922161,1920765],"length":1,"stats":{"Line":0}},{"line":346,"address":[2029856,2029891],"length":1,"stats":{"Line":0}},{"line":347,"address":[1921951,1921581],"length":1,"stats":{"Line":0}},{"line":350,"address":[1921937,1921647],"length":1,"stats":{"Line":0}},{"line":351,"address":[1921850],"length":1,"stats":{"Line":0}},{"line":356,"address":[],"length":0,"stats":{"Line":1}},{"line":357,"address":[],"length":0,"stats":{"Line":2}},{"line":358,"address":[2030184,2032421,2030053],"length":1,"stats":{"Line":1}},{"line":360,"address":[],"length":0,"stats":{"Line":0}},{"line":362,"address":[],"length":0,"stats":{"Line":2}},{"line":364,"address":[],"length":0,"stats":{"Line":1}},{"line":365,"address":[],"length":0,"stats":{"Line":2}},{"line":367,"address":[1956825,1956933,1958440],"length":1,"stats":{"Line":2}},{"line":368,"address":[2032327,2031239,2031172],"length":1,"stats":{"Line":2}},{"line":370,"address":[2031637,2031570,2032306],"length":1,"stats":{"Line":2}},{"line":371,"address":[2031844,2031895],"length":1,"stats":{"Line":2}},{"line":372,"address":[],"length":0,"stats":{"Line":1}},{"line":375,"address":[],"length":0,"stats":{"Line":1}},{"line":376,"address":[],"length":0,"stats":{"Line":2}},{"line":377,"address":[],"length":0,"stats":{"Line":1}}],"covered":124,"coverable":144},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db_tests.rs"],"content":"// libmarlin/src/db_tests.rs\n\nuse super::db;\nuse rusqlite::Connection;\nuse tempfile::tempdir;\n\nfn open_mem() -\u003e Connection {\n    // helper to open an in-memory DB with migrations applied\n    db::open(\":memory:\").expect(\"open in-memory DB\")\n}\n\n#[test]\nfn ensure_tag_path_creates_hierarchy() {\n    let conn = open_mem();\n    // create foo/bar/baz\n    let leaf = db::ensure_tag_path(\u0026conn, \"foo/bar/baz\").unwrap();\n    // foo should exist as a root tag\n    let foo: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='foo' AND parent_id IS NULL\",\n            [],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // bar should be child of foo\n    let bar: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='bar' AND parent_id = ?1\",\n            [foo],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // baz should be child of bar, and its ID is what we got back\n    let baz: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='baz' AND parent_id = ?1\",\n            [bar],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(leaf, baz);\n}\n\n#[test]\nfn upsert_attr_inserts_and_updates() {\n    let conn = open_mem();\n    // insert a dummy file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"a.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='a.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // insert\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v\").unwrap();\n    let v1: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v1, \"v\");\n\n    // update\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v2\").unwrap();\n    let v2: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v2, \"v2\");\n}\n\n#[test]\nfn add_and_remove_links_and_backlinks() {\n    let conn = open_mem();\n    // create two files\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"one.txt\"],\n    )\n    .unwrap();\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"two.txt\"],\n    )\n    .unwrap();\n    let src: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='one.txt'\", [], |r| r.get(0))\n        .unwrap();\n    let dst: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='two.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // add a link of type \"ref\"\n    db::add_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let out = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert_eq!(out.len(), 1);\n    assert_eq!(out[0].2.as_deref(), Some(\"ref\"));\n\n    // backlinks should mirror\n    let back = db::find_backlinks(\u0026conn, \"two%\").unwrap();\n    assert_eq!(back.len(), 1);\n    assert_eq!(back[0].1.as_deref(), Some(\"ref\"));\n\n    // remove it\n    db::remove_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let empty = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert!(empty.is_empty());\n}\n\n#[test]\nfn collections_roundtrip() {\n    let conn = open_mem();\n    // create collection \"C\"\n    let cid = db::ensure_collection(\u0026conn, \"C\").unwrap();\n\n    // add a file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"f.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='f.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    db::add_file_to_collection(\u0026conn, cid, fid).unwrap();\n    let files = db::list_collection(\u0026conn, \"C\").unwrap();\n    assert_eq!(files, vec![\"f.txt\".to_string()]);\n}\n\n#[test]\nfn views_save_and_query() {\n    let conn = open_mem();\n    db::save_view(\u0026conn, \"v1\", \"some_query\").unwrap();\n    let all = db::list_views(\u0026conn).unwrap();\n    assert_eq!(all, vec![(\"v1\".to_string(), \"some_query\".to_string())]);\n\n    let q = db::view_query(\u0026conn, \"v1\").unwrap();\n    assert_eq!(q, \"some_query\");\n}\n\n#[test]\nfn backup_and_restore_cycle() {\n    let tmp = tempdir().unwrap();\n    let db_path = tmp.path().join(\"data.db\");\n    let live = db::open(\u0026db_path).unwrap();\n\n    // insert a file\n    live.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"x.bin\"],\n    )\n    .unwrap();\n\n    // backup\n    let backup = db::backup(\u0026db_path).unwrap();\n    // remove original\n    std::fs::remove_file(\u0026db_path).unwrap();\n    // restore\n    db::restore(\u0026backup, \u0026db_path).unwrap();\n\n    // reopen and check that x.bin survived\n    let conn2 = db::open(\u0026db_path).unwrap();\n    let cnt: i64 =\n        conn2.query_row(\"SELECT COUNT(*) FROM files WHERE path='x.bin'\", [], |r| r.get(0)).unwrap();\n    assert_eq!(cnt, 1);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","error.rs"],"content":"// libmarlin/src/error.rs\n\nuse std::io;\nuse std::fmt;\n// Ensure these are present if Error enum variants use them directly\n// use rusqlite;\n// use notify;\n\npub type Result\u003cT\u003e = std::result::Result\u003cT, Error\u003e;\n\n#[derive(Debug)]\npub enum Error {\n    Io(io::Error),\n    Database(rusqlite::Error), \n    Watch(notify::Error),    \n    InvalidState(String),\n    NotFound(String),\n    Config(String),\n    Other(String),\n}\n\nimpl fmt::Display for Error {\n    fn fmt(\u0026self, f: \u0026mut fmt::Formatter\u003c'_\u003e) -\u003e fmt::Result {\n        match self {\n            Self::Io(err) =\u003e write!(f, \"IO error: {}\", err),\n            Self::Database(err) =\u003e write!(f, \"Database error: {}\", err),\n            Self::Watch(err) =\u003e write!(f, \"Watch error: {}\", err),\n            Self::InvalidState(msg) =\u003e write!(f, \"Invalid state: {}\", msg),\n            Self::NotFound(path) =\u003e write!(f, \"Not found: {}\", path),\n            Self::Config(msg) =\u003e write!(f, \"Configuration error: {}\", msg),\n            Self::Other(msg) =\u003e write!(f, \"Error: {}\", msg),\n        }\n    }\n}\n\nimpl std::error::Error for Error {\n    fn source(\u0026self) -\u003e Option\u003c\u0026(dyn std::error::Error + 'static)\u003e {\n        match self {\n            Self::Io(err) =\u003e Some(err),\n            Self::Database(err) =\u003e Some(err),\n            Self::Watch(err) =\u003e Some(err),\n            Self::InvalidState(_) | Self::NotFound(_) | Self::Config(_) | Self::Other(_) =\u003e None,\n        }\n    }\n}\n\nimpl From\u003cio::Error\u003e for Error {\n    fn from(err: io::Error) -\u003e Self {\n        Self::Io(err)\n    }\n}\n\nimpl From\u003crusqlite::Error\u003e for Error {\n    fn from(err: rusqlite::Error) -\u003e Self {\n        Self::Database(err)\n    }\n}\n\nimpl From\u003cnotify::Error\u003e for Error {\n    fn from(err: notify::Error) -\u003e Self {\n        Self::Watch(err)\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use std::error::Error as StdError; \n\n    #[test]\n    fn test_error_display_and_from() {\n        // Test Io variant\n        let io_err_inner_for_source_check = io::Error::new(io::ErrorKind::NotFound, \"test io error\");\n        let io_err_marlin = Error::from(io::Error::new(io::ErrorKind::NotFound, \"test io error\"));\n        assert_eq!(io_err_marlin.to_string(), \"IO error: test io error\");\n        let source = io_err_marlin.source();\n        assert!(source.is_some(), \"Io error should have a source\");\n        if let Some(s) = source {\n            // Compare details of the source if necessary, or just its string representation\n            assert_eq!(s.to_string(), io_err_inner_for_source_check.to_string());\n        }\n\n        // Test Database variant\n        let rusqlite_err_inner_for_source_check = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        );\n        // We need to create the error again for the From conversion if we want to compare the source\n        let db_err_marlin = Error::from(rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        ));\n        assert!(db_err_marlin.to_string().contains(\"Database error: test db error\"));\n        let source = db_err_marlin.source();\n        assert!(source.is_some(), \"Database error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), rusqlite_err_inner_for_source_check.to_string());\n        }\n\n\n        // Test Watch variant\n        let notify_raw_err_inner_for_source_check = notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string()));\n        let watch_err_marlin = Error::from(notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string())));\n        assert!(watch_err_marlin.to_string().contains(\"Watch error: test watch error\"));\n        let source = watch_err_marlin.source();\n        assert!(source.is_some(), \"Watch error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), notify_raw_err_inner_for_source_check.to_string());\n        }\n\n\n        let invalid_state_err = Error::InvalidState(\"bad state\".to_string());\n        assert_eq!(invalid_state_err.to_string(), \"Invalid state: bad state\");\n        assert!(invalid_state_err.source().is_none());\n\n        let not_found_err = Error::NotFound(\"missing_file.txt\".to_string());\n        assert_eq!(not_found_err.to_string(), \"Not found: missing_file.txt\");\n        assert!(not_found_err.source().is_none());\n\n        let config_err = Error::Config(\"bad config\".to_string());\n        assert_eq!(config_err.to_string(), \"Configuration error: bad config\");\n        assert!(config_err.source().is_none());\n\n        let other_err = Error::Other(\"some other issue\".to_string());\n        assert_eq!(other_err.to_string(), \"Error: some other issue\");\n        assert!(other_err.source().is_none());\n    }\n\n    #[test]\n    fn test_rusqlite_error_without_message() {\n        let sqlite_busy_error = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        );\n        let db_err_no_msg = Error::from(sqlite_busy_error);\n        \n        let expected_rusqlite_msg = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        ).to_string(); \n        \n        let expected_marlin_msg = format!(\"Database error: {}\", expected_rusqlite_msg);\n        \n        // Verify the string matches the expected format\n        assert_eq!(db_err_no_msg.to_string(), expected_marlin_msg);\n        \n        // Check the error code directly instead of the string\n        if let Error::Database(rusqlite::Error::SqliteFailure(err, _)) = \u0026db_err_no_msg {\n            assert_eq!(err.code, rusqlite::ffi::ErrorCode::DatabaseBusy);\n        } else {\n            panic!(\"Expected Error::Database variant\");\n        }\n        \n        // Verify the source exists\n        assert!(db_err_no_msg.source().is_some());\n    }\n}","traces":[{"line":23,"address":[5692560],"length":1,"stats":{"Line":1}},{"line":24,"address":[1800064],"length":1,"stats":{"Line":1}},{"line":25,"address":[1800128],"length":1,"stats":{"Line":1}},{"line":26,"address":[1800226],"length":1,"stats":{"Line":1}},{"line":27,"address":[1800343],"length":1,"stats":{"Line":1}},{"line":28,"address":[1800470],"length":1,"stats":{"Line":1}},{"line":29,"address":[1800598],"length":1,"stats":{"Line":1}},{"line":30,"address":[1800726],"length":1,"stats":{"Line":1}},{"line":31,"address":[1800851],"length":1,"stats":{"Line":1}},{"line":37,"address":[1800992],"length":1,"stats":{"Line":1}},{"line":38,"address":[1801002],"length":1,"stats":{"Line":1}},{"line":39,"address":[1801067],"length":1,"stats":{"Line":1}},{"line":40,"address":[5693628],"length":1,"stats":{"Line":1}},{"line":41,"address":[1801129],"length":1,"stats":{"Line":1}},{"line":42,"address":[1801157],"length":1,"stats":{"Line":1}},{"line":48,"address":[1801184],"length":1,"stats":{"Line":1}},{"line":49,"address":[1801192],"length":1,"stats":{"Line":1}},{"line":54,"address":[1801216],"length":1,"stats":{"Line":1}},{"line":55,"address":[1801224],"length":1,"stats":{"Line":1}},{"line":60,"address":[1801248],"length":1,"stats":{"Line":1}},{"line":61,"address":[1801265],"length":1,"stats":{"Line":1}}],"covered":21,"coverable":21},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","facade_tests.rs"],"content":"// libmarlin/src/facade_tests.rs\n\nuse super::*;             // brings Marlin, config, etc.\nuse std::{env, fs};\nuse tempfile::tempdir;\n\n#[test]\nfn open_at_and_scan_and_search() {\n    // 1) Prepare a temp workspace with one file\n    let tmp = tempdir().unwrap();\n    let file = tmp.path().join(\"hello.txt\");\n    fs::write(\u0026file, \"hello FAÇT\").unwrap();\n\n    // 2) Use open_at to create a fresh DB\n    let db_path = tmp.path().join(\"explicit.db\");\n    let mut m = Marlin::open_at(\u0026db_path).expect(\"open_at should succeed\");\n    assert!(db_path.exists(), \"DB file should be created\");\n\n    // 3) Scan the directory\n    let count = m.scan(\u0026[tmp.path()]).expect(\"scan should succeed\");\n    assert_eq!(count, 1, \"we created exactly one file\");\n\n    // 4) Search using an FTS hit\n    let hits = m.search(\"hello\").expect(\"search must not error\");\n    assert_eq!(hits.len(), 1);\n    assert!(hits[0].ends_with(\"hello.txt\"));\n\n    // 5) Search a substring that isn't a valid token (fires fallback)\n    let fallback_hits = m.search(\"FAÇT\").expect(\"fallback search works\");\n    assert_eq!(fallback_hits.len(), 1);\n    assert!(fallback_hits[0].ends_with(\"hello.txt\"));\n}\n\n#[test]\nfn tag_and_search_by_tag() {\n    let tmp = tempdir().unwrap();\n    let a = tmp.path().join(\"a.md\");\n    let b = tmp.path().join(\"b.md\");\n    fs::write(\u0026a, \"# a\").unwrap();\n    fs::write(\u0026b, \"# b\").unwrap();\n\n    let db_path = tmp.path().join(\"my.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db_path);\n\n    let mut m = Marlin::open_default().unwrap();\n    m.scan(\u0026[tmp.path()]).unwrap();\n\n    let changed = m.tag(\"*.md\", \"foo/bar\").unwrap();\n    assert_eq!(changed, 2);\n\n    let tagged = m.search(\"tags_text:\\\"foo/bar\\\"\").unwrap();\n    assert_eq!(tagged.len(), 2);\n\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn open_default_fallback_config() {\n    // Unset all overrides\n    env::remove_var(\"MARLIN_DB_PATH\");\n    env::remove_var(\"XDG_DATA_HOME\");\n\n    // Simulate no XDG: temporarily point HOME to a read-only dir\n    let fake_home = tempdir().unwrap();\n    env::set_var(\"HOME\", fake_home.path());\n    // This should fall back to \"./index_\u003chash\u003e.db\"\n    let cfg = config::Config::load().unwrap();\n    let fname = cfg.db_path.file_name().unwrap().to_string_lossy();\n    assert!(fname.starts_with(\"index_\") \u0026\u0026 fname.ends_with(\".db\"));\n\n    // Clean up\n    env::remove_var(\"HOME\");\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","lib.rs"],"content":"//! libmarlin – public API surface for the Marlin core.\n//!\n//! Down-stream crates (`cli-bin`, `tui-bin`, tests, plugins) should depend\n//! *only* on the helpers re-exported here, never on internal modules\n//! directly.  That gives us room to refactor internals without breaking\n//! callers.\n\n#![deny(warnings)]\n\npub mod backup;\npub mod config;\npub mod db;\npub mod error;\npub mod logging;\npub mod scan;\npub mod utils;\npub mod watcher;\n\n#[cfg(test)]\nmod utils_tests;\n#[cfg(test)]\nmod config_tests;\n#[cfg(test)]\nmod scan_tests;\n#[cfg(test)]\nmod logging_tests;\n#[cfg(test)]\nmod db_tests;\n#[cfg(test)]\nmod facade_tests;\n#[cfg(test)]\nmod watcher_tests;\n\nuse anyhow::{Context, Result};\nuse rusqlite::Connection;\nuse std::{fs, path::Path, sync::{Arc, Mutex}};\n\n/// Main handle for interacting with a Marlin database.\npub struct Marlin {\n    #[allow(dead_code)]\n    cfg: config::Config,\n    conn: Connection,\n}\n\nimpl Marlin {\n    /// Open using the default config (env override or XDG/CWD fallback),\n    /// ensuring parent directories exist and applying migrations.\n    pub fn open_default() -\u003e Result\u003cSelf\u003e {\n        // 1) Load configuration\n        let cfg = config::Config::load()?;\n        // 2) Ensure the DB's parent directory exists\n        if let Some(parent) = cfg.db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // 3) Open the database and run migrations\n        let conn = db::open(\u0026cfg.db_path)\n            .context(format!(\"opening database at {}\", cfg.db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Open a Marlin instance at the specified database path,\n    /// creating parent directories and applying migrations.\n    pub fn open_at\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cSelf\u003e {\n        let db_path = db_path.as_ref();\n        // Ensure the specified DB directory exists\n        if let Some(parent) = db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // Build a minimal Config so callers can still inspect cfg.db_path\n        let cfg = config::Config { db_path: db_path.to_path_buf() };\n        // Open the database and run migrations\n        let conn = db::open(db_path)\n            .context(format!(\"opening database at {}\", db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Recursively index one or more directories.\n    pub fn scan\u003cP: AsRef\u003cPath\u003e\u003e(\u0026mut self, paths: \u0026[P]) -\u003e Result\u003cusize\u003e {\n        let mut total = 0;\n        for p in paths {\n            total += scan::scan_directory(\u0026mut self.conn, p.as_ref())?;\n        }\n        Ok(total)\n    }\n\n    /// Attach a hierarchical tag (`foo/bar`) to every _indexed_ file\n    /// matching the glob.  Returns the number of files actually updated.\n    pub fn tag(\u0026mut self, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003cusize\u003e {\n        use glob::Pattern;\n\n        // 1) ensure tag hierarchy\n        let leaf = db::ensure_tag_path(\u0026self.conn, tag_path)?;\n\n        // 2) collect leaf + ancestors\n        let mut tag_ids = Vec::new();\n        let mut cur = Some(leaf);\n        while let Some(id) = cur {\n            tag_ids.push(id);\n            cur = self.conn.query_row(\n                \"SELECT parent_id FROM tags WHERE id = ?1\",\n                [id],\n                |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n            )?;\n        }\n\n        // 3) match files by glob against stored paths\n        let expanded = shellexpand::tilde(pattern).into_owned();\n        let pat = Pattern::new(\u0026expanded)\n            .with_context(|| format!(\"Invalid glob pattern `{}`\", expanded))?;\n\n        let mut stmt_all = self.conn.prepare(\"SELECT id, path FROM files\")?;\n        let rows = stmt_all.query_map([], |r| Ok((r.get(0)?, r.get(1)?)))?;\n\n        let mut stmt_ins = self.conn.prepare(\n            \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n        )?;\n\n        let mut changed = 0;\n        for row in rows {\n            let (fid, path_str): (i64, String) = row?;\n            let is_match = if expanded.contains(std::path::MAIN_SEPARATOR) {\n                pat.matches(\u0026path_str)\n            } else {\n                Path::new(\u0026path_str)\n                    .file_name()\n                    .and_then(|n| n.to_str())\n                    .map(|n| pat.matches(n))\n                    .unwrap_or(false)\n            };\n            if !is_match {\n                continue;\n            }\n\n            let mut newly = false;\n            for \u0026tid in \u0026tag_ids {\n                if stmt_ins.execute([fid, tid])? \u003e 0 {\n                    newly = true;\n                }\n            }\n            if newly {\n                changed += 1;\n            }\n        }\n        Ok(changed)\n    }\n\n    /// Full-text search over path, tags, and attrs, with substring fallback.\n    pub fn search(\u0026self, query: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let mut stmt = self.conn.prepare(\n            \"SELECT f.path FROM files_fts JOIN files f ON f.rowid = files_fts.rowid WHERE files_fts MATCH ?1 ORDER BY rank\",\n        )?;\n        let mut hits = stmt.query_map([query], |r| r.get(0))?\n            .collect::\u003cstd::result::Result\u003cVec\u003c_\u003e, rusqlite::Error\u003e\u003e()?;\n\n        if hits.is_empty() \u0026\u0026 !query.contains(':') {\n            hits = self.fallback_search(query)?;\n        }\n        Ok(hits)\n    }\n\n    fn fallback_search(\u0026self, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let needle = term.to_lowercase();\n        let mut stmt = self.conn.prepare(\"SELECT path FROM files\")?;\n        let rows = stmt.query_map([], |r| r.get(0))?;\n        let mut out = Vec::new();\n        for res in rows {\n            let p: String = res?;\n            if p.to_lowercase().contains(\u0026needle) {\n                out.push(p.clone());\n                continue;\n            }\n            if let Ok(meta) = fs::metadata(\u0026p) {\n                if meta.len() \u003c= 65_536 { \n                    if let Ok(body) = fs::read_to_string(\u0026p) {\n                        if body.to_lowercase().contains(\u0026needle) {\n                            out.push(p.clone());\n                        }\n                    }\n                }\n            }\n        }\n        Ok(out)\n    }\n\n    /// Borrow the raw SQLite connection.\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n\n    /// Spawn a file-watcher that indexes changes in real time.\n    pub fn watch\u003cP: AsRef\u003cPath\u003e\u003e(\n        \u0026mut self,\n        path: P,\n        config: Option\u003cwatcher::WatcherConfig\u003e,\n    ) -\u003e Result\u003cwatcher::FileWatcher\u003e {\n        let cfg = config.unwrap_or_default();\n        let p = path.as_ref().to_path_buf();\n        let new_conn = db::open(\u0026self.cfg.db_path)\n            .context(\"opening database for watcher\")?;\n        let watcher_db = Arc::new(Mutex::new(db::Database::new(new_conn)));\n        \n        let mut owned_w = watcher::FileWatcher::new(vec![p], cfg)?;\n        owned_w.with_database(watcher_db); // Modifies owned_w in place\n        owned_w.start()?; // Start the watcher after it has been fully configured\n        \n        Ok(owned_w) // Return the owned FileWatcher\n    }\n}","traces":[{"line":48,"address":[5358509,5358515,5357376],"length":1,"stats":{"Line":1}},{"line":50,"address":[1730385],"length":1,"stats":{"Line":1}},{"line":52,"address":[1730565,1730629],"length":1,"stats":{"Line":2}},{"line":53,"address":[1730776,1730739],"length":1,"stats":{"Line":2}},{"line":56,"address":[1731442,1731200,1731242,1730764,1731137,1730888],"length":1,"stats":{"Line":4}},{"line":57,"address":[1731226,1730918,1730901,1731176,1731455],"length":1,"stats":{"Line":2}},{"line":58,"address":[1731289],"length":1,"stats":{"Line":1}},{"line":63,"address":[],"length":0,"stats":{"Line":1}},{"line":64,"address":[2072710,2072789],"length":1,"stats":{"Line":2}},{"line":66,"address":[],"length":0,"stats":{"Line":1}},{"line":67,"address":[],"length":0,"stats":{"Line":2}},{"line":70,"address":[2073065,2072938],"length":1,"stats":{"Line":2}},{"line":72,"address":[],"length":0,"stats":{"Line":4}},{"line":73,"address":[2073186,2073716,2073465,2073415,2073170],"length":1,"stats":{"Line":2}},{"line":74,"address":[],"length":0,"stats":{"Line":1}},{"line":78,"address":[],"length":0,"stats":{"Line":2}},{"line":79,"address":[],"length":0,"stats":{"Line":2}},{"line":80,"address":[],"length":0,"stats":{"Line":4}},{"line":81,"address":[2074059,2073981,2073882],"length":1,"stats":{"Line":2}},{"line":83,"address":[],"length":0,"stats":{"Line":2}},{"line":88,"address":[5362862,5362546,5358528],"length":1,"stats":{"Line":1}},{"line":92,"address":[1731597],"length":1,"stats":{"Line":1}},{"line":95,"address":[5358771],"length":1,"stats":{"Line":1}},{"line":96,"address":[1731749],"length":1,"stats":{"Line":1}},{"line":97,"address":[5358813,5359260],"length":1,"stats":{"Line":2}},{"line":98,"address":[5358851],"length":1,"stats":{"Line":1}},{"line":99,"address":[1732213,1731931,1732106,1731919],"length":1,"stats":{"Line":2}},{"line":101,"address":[1731923],"length":1,"stats":{"Line":1}},{"line":102,"address":[2074096,2074080],"length":1,"stats":{"Line":2}},{"line":107,"address":[5358893,5359316],"length":1,"stats":{"Line":2}},{"line":108,"address":[5359568,5362844,5359434,5359351],"length":1,"stats":{"Line":2}},{"line":109,"address":[5359552],"length":1,"stats":{"Line":0}},{"line":111,"address":[1735626,1732660,1732735],"length":1,"stats":{"Line":2}},{"line":112,"address":[5559630,5559584],"length":1,"stats":{"Line":4}},{"line":114,"address":[5360451,5360523,5362633,5360645],"length":1,"stats":{"Line":2}},{"line":118,"address":[5360850],"length":1,"stats":{"Line":1}},{"line":119,"address":[1733761,1733868,1733944],"length":1,"stats":{"Line":3}},{"line":120,"address":[1734061,1735414,1734235],"length":1,"stats":{"Line":2}},{"line":121,"address":[1734473,1734556],"length":1,"stats":{"Line":2}},{"line":122,"address":[5361923,5361749],"length":1,"stats":{"Line":0}},{"line":124,"address":[1734594,1734649],"length":1,"stats":{"Line":2}},{"line":126,"address":[5560110,5560096],"length":1,"stats":{"Line":2}},{"line":127,"address":[5560146,5560128],"length":1,"stats":{"Line":2}},{"line":130,"address":[1734763],"length":1,"stats":{"Line":1}},{"line":134,"address":[5361983],"length":1,"stats":{"Line":1}},{"line":135,"address":[1734861],"length":1,"stats":{"Line":1}},{"line":136,"address":[1735328,1735135,1734999],"length":1,"stats":{"Line":3}},{"line":137,"address":[5362470],"length":1,"stats":{"Line":1}},{"line":140,"address":[5362192,5362259],"length":1,"stats":{"Line":2}},{"line":141,"address":[1735078,1735115],"length":1,"stats":{"Line":1}},{"line":144,"address":[1734086],"length":1,"stats":{"Line":1}},{"line":148,"address":[5364345,5362880,5364355],"length":1,"stats":{"Line":1}},{"line":149,"address":[1735784,1735901],"length":1,"stats":{"Line":1}},{"line":152,"address":[1736081,1737166,1736182,1736496],"length":1,"stats":{"Line":4}},{"line":155,"address":[1737112,1736776,1736585,1736656],"length":1,"stats":{"Line":4}},{"line":156,"address":[5364174,5364010],"length":1,"stats":{"Line":1}},{"line":158,"address":[1736667],"length":1,"stats":{"Line":1}},{"line":161,"address":[5366877,5367225,5364368],"length":1,"stats":{"Line":1}},{"line":162,"address":[1737265],"length":1,"stats":{"Line":1}},{"line":163,"address":[1739967,1737381,1737306],"length":1,"stats":{"Line":2}},{"line":164,"address":[5367202,5364884,5364955],"length":1,"stats":{"Line":4}},{"line":165,"address":[1737976],"length":1,"stats":{"Line":1}},{"line":166,"address":[1738204,1738128,1738036],"length":1,"stats":{"Line":3}},{"line":167,"address":[1738466,1738321],"length":1,"stats":{"Line":2}},{"line":168,"address":[1738743,1738672],"length":1,"stats":{"Line":2}},{"line":169,"address":[1739784],"length":1,"stats":{"Line":0}},{"line":172,"address":[1738924,1739014],"length":1,"stats":{"Line":2}},{"line":173,"address":[1739082,1739694,1739021],"length":1,"stats":{"Line":3}},{"line":174,"address":[1739110,1739208],"length":1,"stats":{"Line":2}},{"line":175,"address":[1739256,1739327],"length":1,"stats":{"Line":2}},{"line":176,"address":[1739511],"length":1,"stats":{"Line":1}},{"line":182,"address":[1738354],"length":1,"stats":{"Line":1}},{"line":186,"address":[1739984],"length":1,"stats":{"Line":0}},{"line":187,"address":[1739992],"length":1,"stats":{"Line":0}},{"line":191,"address":[2496392,2494832,2494916],"length":1,"stats":{"Line":0}},{"line":196,"address":[],"length":0,"stats":{"Line":0}},{"line":197,"address":[],"length":0,"stats":{"Line":0}},{"line":198,"address":[],"length":0,"stats":{"Line":0}},{"line":200,"address":[],"length":0,"stats":{"Line":0}},{"line":202,"address":[],"length":0,"stats":{"Line":0}},{"line":203,"address":[2496078],"length":1,"stats":{"Line":0}},{"line":204,"address":[2496149],"length":1,"stats":{"Line":0}},{"line":206,"address":[2496275],"length":1,"stats":{"Line":0}}],"covered":69,"coverable":83},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging.rs"],"content":"use tracing_subscriber::{fmt, EnvFilter};\n\n/// Initialise global tracing subscriber.\n///\n/// Reads `RUST_LOG` for filtering, falls back to `info`.\npub fn init() {\n    let filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new(\"info\"));\n\n    // All tracing output (INFO, WARN, ERROR …) now goes to *stderr* so the\n    // integration tests can assert on warnings / errors reliably.\n    fmt()\n        .with_target(false)        // hide module targets\n        .with_level(true)          // include log level\n        .with_env_filter(filter)   // respect RUST_LOG\n        .with_writer(std::io::stderr) // \u003c-- NEW: send to stderr\n        .init();\n}\n","traces":[{"line":6,"address":[1990158,1990187,1989824],"length":1,"stats":{"Line":1}},{"line":7,"address":[1710416,1710432],"length":1,"stats":{"Line":1}},{"line":11,"address":[1989921,1989999,1990077],"length":1,"stats":{"Line":3}},{"line":14,"address":[1990034],"length":1,"stats":{"Line":1}}],"covered":4,"coverable":4},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging_tests.rs"],"content":"// libmarlin/src/logging_tests.rs\n\nuse super::logging;\nuse tracing::Level;\n\n#[test]\nfn init_sets_up_subscriber() {\n    // set RUST_LOG to something to test the EnvFilter path\n    std::env::set_var(\"RUST_LOG\", \"debug\");\n    logging::init();\n    tracing::event!(Level::INFO, \"this is a test log\");\n    // if we made it here without panic, we’re good\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan.rs"],"content":"// src/scan.rs\n\nuse std::fs;\nuse std::path::Path;\n\nuse anyhow::Result;\nuse rusqlite::{params, Connection};\nuse tracing::{debug, info};\nuse walkdir::WalkDir;\n\n/// Recursively walk `root` and upsert file metadata.\n/// Triggers keep the FTS table in sync.\npub fn scan_directory(conn: \u0026mut Connection, root: \u0026Path) -\u003e Result\u003cusize\u003e {\n    // Begin a transaction so we batch many inserts/updates together\n    let tx = conn.transaction()?;\n\n    // Prepare the upsert statement once\n    let mut stmt = tx.prepare(\n        r#\"\n        INSERT INTO files(path, size, mtime)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(path) DO UPDATE\n            SET size  = excluded.size,\n                mtime = excluded.mtime\n        \"#,\n    )?;\n\n    let mut count = 0usize;\n\n    // Walk the directory recursively\n    for entry in WalkDir::new(root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let path = entry.path();\n\n        // Skip the database file and its WAL/SHM siblings\n        if let Some(name) = path.file_name().and_then(|n| n.to_str()) {\n            if name.ends_with(\".db\") || name.ends_with(\"-wal\") || name.ends_with(\"-shm\") {\n                continue;\n            }\n        }\n\n        // Gather file metadata\n        let meta = fs::metadata(path)?;\n        let size = meta.len() as i64;\n        let mtime = meta\n            .modified()?\n            .duration_since(std::time::UNIX_EPOCH)?\n            .as_secs() as i64;\n\n        // Execute the upsert\n        let path_str = path.to_string_lossy();\n        stmt.execute(params![path_str, size, mtime])?;\n        count += 1;\n\n        debug!(file = %path_str, \"indexed\");\n    }\n\n    // Finalize and commit\n    drop(stmt);\n    tx.commit()?;\n\n    info!(indexed = count, \"scan complete\");\n    Ok(count)\n}\n","traces":[{"line":13,"address":[5372288,5372539,5367264],"length":1,"stats":{"Line":1}},{"line":15,"address":[1653524],"length":1,"stats":{"Line":1}},{"line":18,"address":[1653739,1658578,1653952,1653803],"length":1,"stats":{"Line":2}},{"line":28,"address":[1654177],"length":1,"stats":{"Line":1}},{"line":31,"address":[1654197,1654245,1654430],"length":1,"stats":{"Line":3}},{"line":34,"address":[2175600,2175627],"length":1,"stats":{"Line":2}},{"line":36,"address":[1654515,1655941],"length":1,"stats":{"Line":2}},{"line":39,"address":[1655979],"length":1,"stats":{"Line":3}},{"line":40,"address":[1656231,1656312,1656156],"length":1,"stats":{"Line":5}},{"line":46,"address":[1656202,1658465,1656380],"length":1,"stats":{"Line":3}},{"line":47,"address":[5370458],"length":1,"stats":{"Line":1}},{"line":48,"address":[1656619,1656715,1656891,1658397],"length":1,"stats":{"Line":2}},{"line":49,"address":[5370573],"length":1,"stats":{"Line":0}},{"line":50,"address":[5370743],"length":1,"stats":{"Line":0}},{"line":54,"address":[1657023],"length":1,"stats":{"Line":1}},{"line":55,"address":[5370924,5372234,5371086],"length":1,"stats":{"Line":3}},{"line":56,"address":[1657435,1657375],"length":1,"stats":{"Line":2}},{"line":58,"address":[1657459,1657704,1657410],"length":1,"stats":{"Line":4}},{"line":62,"address":[1654568],"length":1,"stats":{"Line":2}},{"line":63,"address":[1655846,1654671],"length":1,"stats":{"Line":1}},{"line":65,"address":[1654878,1655227],"length":1,"stats":{"Line":6}},{"line":66,"address":[1655178],"length":1,"stats":{"Line":3}}],"covered":20,"coverable":22},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan_tests.rs"],"content":"// libmarlin/src/scan_tests.rs\n\nuse super::scan::scan_directory;\nuse super::db;\nuse tempfile::tempdir;\nuse std::fs::File;\n\n#[test]\nfn scan_directory_counts_files() {\n    let tmp = tempdir().unwrap();\n\n    // create a couple of files\n    File::create(tmp.path().join(\"a.txt\")).unwrap();\n    File::create(tmp.path().join(\"b.log\")).unwrap();\n\n    // open an in-memory DB (runs migrations)\n    let mut conn = db::open(\":memory:\").unwrap();\n\n    let count = scan_directory(\u0026mut conn, tmp.path()).unwrap();\n    assert_eq!(count, 2);\n\n    // ensure the paths were inserted\n    let mut stmt = conn.prepare(\"SELECT COUNT(*) FROM files\").unwrap();\n    let total: i64 = stmt.query_row([], |r| r.get(0)).unwrap();\n    assert_eq!(total, 2);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils.rs"],"content":"//! Misc shared helpers.\n\nuse std::path::PathBuf;\n\n/// Determine a filesystem root to limit recursive walking on glob scans.\n///\n/// If the pattern contains any of `*?[`, we take everything up to the\n/// first such character, and then (if that still contains metacharacters)\n/// walk up until there aren’t any left.  If there are *no* metachars at\n/// all, we treat the entire string as a path and return its parent\n/// directory (or `.` if it has no parent).\npub fn determine_scan_root(pattern: \u0026str) -\u003e PathBuf {\n    // find first wildcard char\n    let first_wild = pattern\n        .find(|c| matches!(c, '*' | '?' | '['))\n        .unwrap_or(pattern.len());\n\n    // everything up to the wildcard (or the whole string if none)\n    let prefix = \u0026pattern[..first_wild];\n    let mut root = PathBuf::from(prefix);\n\n    // If there were NO wildcards at all, just return the parent directory\n    if first_wild == pattern.len() {\n        return root.parent().map(|p| p.to_path_buf()).unwrap_or_else(|| PathBuf::from(\".\"));\n    }\n\n    // Otherwise, if the prefix still has any wildcards (e.g. \"foo*/bar\"),\n    // walk back up until it doesn’t\n    while root\n        .as_os_str()\n        .to_string_lossy()\n        .chars()\n        .any(|c| matches!(c, '*' | '?' | '['))\n    {\n        root = root.parent().map(|p| p.to_path_buf()).unwrap_or_default();\n    }\n\n    if root.as_os_str().is_empty() {\n        PathBuf::from(\".\")\n    } else {\n        root\n    }\n}\n","traces":[{"line":12,"address":[5284050,5282864,5284181],"length":1,"stats":{"Line":1}},{"line":14,"address":[2101341,2101410],"length":1,"stats":{"Line":3}},{"line":15,"address":[2083581,2083568],"length":1,"stats":{"Line":2}},{"line":16,"address":[2101386],"length":1,"stats":{"Line":2}},{"line":19,"address":[2101457],"length":1,"stats":{"Line":2}},{"line":20,"address":[2101492],"length":1,"stats":{"Line":2}},{"line":23,"address":[2101608,2101533],"length":1,"stats":{"Line":4}},{"line":24,"address":[5594812,5594752,5594774,5594800],"length":1,"stats":{"Line":4}},{"line":29,"address":[2101831,2101694,2101621,2102429],"length":1,"stats":{"Line":6}},{"line":33,"address":[2083728,2083741],"length":1,"stats":{"Line":3}},{"line":35,"address":[2083792,2083814],"length":1,"stats":{"Line":0}},{"line":38,"address":[2102078,2101952],"length":1,"stats":{"Line":2}},{"line":39,"address":[2102088,2102123],"length":1,"stats":{"Line":2}},{"line":41,"address":[2102035],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":14},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils_tests.rs"],"content":"// libmarlin/src/utils_tests.rs\n\nuse super::utils::determine_scan_root;\nuse std::path::PathBuf;\n\n#[test]\nfn determine_scan_root_plain_path() {\n    let root = determine_scan_root(\"foo/bar/baz.txt\");\n    assert_eq!(root, PathBuf::from(\"foo/bar\"));\n}\n\n#[test]\nfn determine_scan_root_glob() {\n    let root = determine_scan_root(\"foo/*/baz.rs\");\n    assert_eq!(root, PathBuf::from(\"foo\"));\n}\n\n#[test]\nfn determine_scan_root_only_wildcards() {\n    let root = determine_scan_root(\"**/*.txt\");\n    assert_eq!(root, PathBuf::from(\".\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher.rs"],"content":"// libmarlin/src/watcher.rs\n\n//! File system watcher implementation for Marlin\n//!\n//! This module provides real-time index updates by monitoring file system events\n//! (create, modify, delete) using the `notify` crate. It implements event debouncing,\n//! batch processing, and a state machine for robust lifecycle management.\n\nuse anyhow::{Result, Context};\nuse crate::db::Database;\nuse crossbeam_channel::{bounded, Receiver};\nuse notify::{Event, EventKind, RecommendedWatcher, RecursiveMode, Watcher as NotifyWatcherTrait};\nuse std::collections::HashMap;\nuse std::path::PathBuf;\nuse std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};\nuse std::sync::{Arc, Mutex};\nuse std::thread::{self, JoinHandle};\nuse std::time::{Duration, Instant};\n// REMOVED: use std::fs; // \u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c THIS LINE WAS REMOVED\n\n/// Configuration for the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherConfig {\n    /// Time in milliseconds to debounce file events\n    pub debounce_ms: u64,\n\n    /// Maximum number of events to process in a single batch\n    pub batch_size: usize,\n\n    /// Maximum size of the event queue before applying backpressure\n    pub max_queue_size: usize,\n\n    /// Time in milliseconds to wait for events to drain during shutdown\n    pub drain_timeout_ms: u64,\n}\n\nimpl Default for WatcherConfig {\n    fn default() -\u003e Self {\n        Self {\n            debounce_ms: 100,\n            batch_size: 1000,\n            max_queue_size: 100_000,\n            drain_timeout_ms: 5000,\n        }\n    }\n}\n\n/// State of the file watcher\n#[derive(Debug, Clone, PartialEq, Eq)]\npub enum WatcherState {\n    Initializing,\n    Watching,\n    Paused,\n    ShuttingDown,\n    Stopped,\n}\n\n/// Status information about the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherStatus {\n    pub state: WatcherState,\n    pub events_processed: usize,\n    pub queue_size: usize,\n    pub start_time: Option\u003cInstant\u003e,\n    pub watched_paths: Vec\u003cPathBuf\u003e,\n}\n\n#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]\nenum EventPriority {\n    Create = 0,\n    Delete = 1,\n    Modify = 2,\n    Access = 3,\n}\n\n#[derive(Debug, Clone)]\nstruct ProcessedEvent {\n    path: PathBuf,\n    kind: EventKind,\n    priority: EventPriority,\n    timestamp: Instant,\n}\n\nstruct EventDebouncer {\n    events: HashMap\u003cPathBuf, ProcessedEvent\u003e,\n    debounce_window_ms: u64,\n    last_flush: Instant,\n}\n\nimpl EventDebouncer {\n    fn new(debounce_window_ms: u64) -\u003e Self {\n        Self {\n            events: HashMap::new(),\n            debounce_window_ms,\n            last_flush: Instant::now(),\n        }\n    }\n\n    fn add_event(\u0026mut self, event: ProcessedEvent) {\n        let path = event.path.clone();\n        if path.is_dir() { // This relies on the PathBuf itself knowing if it's a directory\n                           // or on the underlying FS. For unit tests, ensure paths are created.\n            self.events.retain(|file_path, _| !file_path.starts_with(\u0026path) || file_path == \u0026path );\n        }\n        match self.events.get_mut(\u0026path) {\n            Some(existing) =\u003e {\n                if event.priority \u003c existing.priority {\n                    existing.priority = event.priority;\n                }\n                existing.timestamp = event.timestamp;\n                existing.kind = event.kind;\n            }\n            None =\u003e {\n                self.events.insert(path, event);\n            }\n        }\n    }\n\n    fn is_ready_to_flush(\u0026self) -\u003e bool {\n        self.last_flush.elapsed() \u003e= Duration::from_millis(self.debounce_window_ms)\n    }\n\n    fn flush(\u0026mut self) -\u003e Vec\u003cProcessedEvent\u003e {\n        let mut events: Vec\u003cProcessedEvent\u003e = self.events.drain().map(|(_, e)| e).collect();\n        events.sort_by_key(|e| e.priority);\n        self.last_flush = Instant::now();\n        events\n    }\n\n    #[allow(dead_code)]\n    fn len(\u0026self) -\u003e usize {\n        self.events.len()\n    }\n}\n\n#[cfg(test)]\nmod event_debouncer_tests {\n    use super::*;\n    use notify::event::{CreateKind, DataChange, ModifyKind, RemoveKind, RenameMode};\n    use std::fs; // fs is needed for these tests to create dirs/files\n    use tempfile; \n\n    #[test]\n    fn debouncer_add_and_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110)); \n        assert!(debouncer.is_ready_to_flush());\n        assert_eq!(debouncer.len(), 0);\n\n        let path1 = PathBuf::from(\"file1.txt\");\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 1);\n        \n        debouncer.last_flush = Instant::now(); \n        assert!(!debouncer.is_ready_to_flush());\n\n        std::thread::sleep(Duration::from_millis(110));\n        assert!(debouncer.is_ready_to_flush());\n\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(debouncer.len(), 0);\n        assert!(!debouncer.is_ready_to_flush()); \n    }\n\n    #[test]\n    fn debouncer_coalesce_events() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n\n        let t1 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: t1,\n        });\n        std::thread::sleep(Duration::from_millis(10));\n        let t2 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Modify(ModifyKind::Data(DataChange::Any)),\n            priority: EventPriority::Modify,\n            timestamp: t2,\n        });\n        \n        assert_eq!(debouncer.len(), 1);\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!( \n            flushed[0].kind,\n            EventKind::Modify(ModifyKind::Data(DataChange::Any))\n        );\n        assert_eq!(flushed[0].timestamp, t2);\n    }\n\n    #[test]\n    fn debouncer_hierarchical() {\n        let mut debouncer_h = EventDebouncer::new(100);\n        let temp_dir_obj = tempfile::tempdir().expect(\"Failed to create temp dir\");\n        let p_dir = temp_dir_obj.path().to_path_buf(); \n        let p_file = p_dir.join(\"file.txt\");\n        \n        fs::File::create(\u0026p_file).expect(\"Failed to create test file for hierarchical debounce\");\n\n        debouncer_h.add_event(ProcessedEvent {\n            path: p_file.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1);\n        \n        debouncer_h.add_event(ProcessedEvent {\n            path: p_dir.clone(), \n            kind: EventKind::Remove(RemoveKind::Folder), \n            priority: EventPriority::Delete,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1, \"Hierarchical debounce should remove child event, leaving only parent dir event\");\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer_h.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, p_dir);\n    }\n\n    #[test]\n    fn debouncer_different_files() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n        let path2 = PathBuf::from(\"file2.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: path2.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n    }\n\n    #[test]\n    fn debouncer_priority_sorting_on_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\"); \n        let path2 = PathBuf::from(\"file2.txt\"); \n        let path3 = PathBuf::from(\"file3.txt\"); \n\n        debouncer.add_event(ProcessedEvent { path: path1, kind: EventKind::Modify(ModifyKind::Name(RenameMode::To)), priority: EventPriority::Modify, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path2, kind: EventKind::Create(CreateKind::File), priority: EventPriority::Create, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path3, kind: EventKind::Remove(RemoveKind::File), priority: EventPriority::Delete, timestamp: Instant::now() });\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 3);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!(flushed[1].priority, EventPriority::Delete); \n        assert_eq!(flushed[2].priority, EventPriority::Modify); \n    }\n\n    #[test]\n    fn debouncer_no_events_flush_empty() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert!(flushed.is_empty());\n        assert_eq!(debouncer.len(), 0);\n    }\n\n    #[test]\n    fn debouncer_dir_then_file_hierarchical() {\n        let mut debouncer = EventDebouncer::new(100);\n        let temp_dir = tempfile::tempdir().expect(\"create temp dir\");\n        let dir = temp_dir.path().to_path_buf();\n        let file = dir.join(\"child.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: dir.clone(),\n            kind: EventKind::Create(CreateKind::Folder),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: file,\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n        assert!(flushed.iter().any(|e| e.path == dir));\n    }\n}\n\n\npub struct FileWatcher {\n    state: Arc\u003cMutex\u003cWatcherState\u003e\u003e,\n    #[allow(dead_code)]\n    config: WatcherConfig,\n    watched_paths: Vec\u003cPathBuf\u003e,\n    #[allow(dead_code)]\n    event_receiver: Receiver\u003cstd::result::Result\u003cEvent, notify::Error\u003e\u003e,\n    #[allow(dead_code)] \n    watcher: RecommendedWatcher,\n    processor_thread: Option\u003cJoinHandle\u003c()\u003e\u003e,\n    stop_flag: Arc\u003cAtomicBool\u003e,\n    events_processed: Arc\u003cAtomicUsize\u003e,\n    queue_size: Arc\u003cAtomicUsize\u003e,\n    start_time: Instant,\n    db_shared: Arc\u003cMutex\u003cOption\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e\u003e\u003e,\n}\n\nimpl FileWatcher {\n    pub fn new(paths: Vec\u003cPathBuf\u003e, config: WatcherConfig) -\u003e Result\u003cSelf\u003e {\n        let stop_flag = Arc::new(AtomicBool::new(false));\n        let events_processed = Arc::new(AtomicUsize::new(0));\n        let queue_size = Arc::new(AtomicUsize::new(0));\n        let state = Arc::new(Mutex::new(WatcherState::Initializing));\n\n        let (tx, rx) = bounded(config.max_queue_size);\n\n        let event_tx = tx.clone();\n        let mut actual_watcher = RecommendedWatcher::new(\n            move |event_res: std::result::Result\u003cEvent, notify::Error\u003e| {\n                if event_tx.send(event_res).is_err() {\n                    // Receiver dropped\n                }\n            },\n            notify::Config::default(),\n        )?;\n\n        for path_to_watch in \u0026paths {\n            actual_watcher\n                .watch(path_to_watch, RecursiveMode::Recursive)\n                .with_context(|| format!(\"Failed to watch path: {}\", path_to_watch.display()))?;\n        }\n\n        let config_clone = config.clone();\n        let stop_flag_clone = stop_flag.clone();\n        let events_processed_clone = events_processed.clone();\n        let queue_size_clone = queue_size.clone();\n        let state_clone = state.clone();\n        let receiver_clone = rx.clone(); \n\n        let db_shared_for_thread = Arc::new(Mutex::new(None::\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e));\n        let db_captured_for_thread = db_shared_for_thread.clone();\n\n        let processor_thread = thread::spawn(move || {\n            let mut debouncer = EventDebouncer::new(config_clone.debounce_ms);\n\n            while !stop_flag_clone.load(Ordering::Relaxed) { \n                let current_state = { state_clone.lock().unwrap().clone() };\n\n                if current_state == WatcherState::Paused {\n                    thread::sleep(Duration::from_millis(100));\n                    continue;\n                }\n                if current_state == WatcherState::ShuttingDown || current_state == WatcherState::Stopped {\n                    break;\n                }\n\n                let mut received_in_batch = 0;\n                while let Ok(evt_res) = receiver_clone.try_recv() {\n                    received_in_batch +=1;\n                    match evt_res {\n                        Ok(event) =\u003e {\n                            for path in event.paths {\n                                let prio = match event.kind {\n                                    EventKind::Create(_) =\u003e EventPriority::Create,\n                                    EventKind::Remove(_) =\u003e EventPriority::Delete,\n                                    EventKind::Modify(_) =\u003e EventPriority::Modify,\n                                    EventKind::Access(_) =\u003e EventPriority::Access,\n                                    _ =\u003e EventPriority::Modify,\n                                };\n                                debouncer.add_event(ProcessedEvent {\n                                    path,\n                                    kind: event.kind.clone(),\n                                    priority: prio,\n                                    timestamp: Instant::now(),\n                                });\n                            }\n                        }\n                        Err(e) =\u003e {\n                            eprintln!(\"Watcher channel error: {:?}\", e);\n                        }\n                    }\n                    if received_in_batch \u003e= config_clone.batch_size {\n                        break;\n                    }\n                }\n\n                queue_size_clone.store(debouncer.len(), Ordering::SeqCst);\n\n                if debouncer.is_ready_to_flush() \u0026\u0026 debouncer.len() \u003e 0 {\n                    let evts_to_process = debouncer.flush();\n                    let num_evts = evts_to_process.len();\n                    events_processed_clone.fetch_add(num_evts, Ordering::SeqCst);\n\n                    let db_guard_option = db_captured_for_thread.lock().unwrap();\n                    if let Some(db_mutex) = \u0026*db_guard_option {\n                        let mut _db_instance_guard = db_mutex.lock().unwrap();\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (DB available): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    } else {\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (no DB): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    }\n                }\n                thread::sleep(Duration::from_millis(50));\n            }\n\n            if debouncer.len() \u003e 0 {\n                let final_evts = debouncer.flush();\n                events_processed_clone.fetch_add(final_evts.len(), Ordering::SeqCst);\n                for processed_event in final_evts {\n                    println!(\n                        \"Processing final event: {:?} for path {:?}\",\n                        processed_event.kind, processed_event.path\n                    );\n                }\n            }\n            let mut final_state_guard = state_clone.lock().unwrap();\n            *final_state_guard = WatcherState::Stopped;\n        });\n\n        Ok(Self {\n            state,\n            config,\n            watched_paths: paths,\n            event_receiver: rx,\n            watcher: actual_watcher,\n            processor_thread: Some(processor_thread),\n            stop_flag,\n            events_processed,\n            queue_size,\n            start_time: Instant::now(),\n            db_shared: db_shared_for_thread,\n        })\n    }\n\n    pub fn with_database(\u0026mut self, db_arc: Arc\u003cMutex\u003cDatabase\u003e\u003e) -\u003e \u0026mut Self {\n        { \n            let mut shared_db_guard = self.db_shared.lock().unwrap();\n            *shared_db_guard = Some(db_arc);\n        } \n        self\n    }\n\n    pub fn start(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        if *state_guard == WatcherState::Watching || self.processor_thread.is_none() {\n            if self.processor_thread.is_none() {\n                return Err(anyhow::anyhow!(\"Watcher thread not available to start.\"));\n            }\n            if *state_guard == WatcherState::Initializing {\n                 *state_guard = WatcherState::Watching;\n            }\n            return Ok(());\n        }\n        if *state_guard != WatcherState::Initializing \u0026\u0026 *state_guard != WatcherState::Stopped \u0026\u0026 *state_guard != WatcherState::Paused {\n            return Err(anyhow::anyhow!(format!(\"Cannot start watcher from state {:?}\", *state_guard)));\n        }\n\n        *state_guard = WatcherState::Watching;\n        Ok(())\n    }\n\n    pub fn pause(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Watching =\u003e {\n                *state_guard = WatcherState::Paused;\n                Ok(())\n            }\n            WatcherState::Paused =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in watching state to pause (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn resume(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Paused =\u003e {\n                *state_guard = WatcherState::Watching;\n                Ok(())\n            }\n            WatcherState::Watching =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in paused state to resume (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn stop(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut current_state_guard = self.state.lock().unwrap();\n        if *current_state_guard == WatcherState::Stopped || *current_state_guard == WatcherState::ShuttingDown {\n            return Ok(());\n        }\n        *current_state_guard = WatcherState::ShuttingDown;\n        drop(current_state_guard);\n\n        self.stop_flag.store(true, Ordering::SeqCst);\n\n        if let Some(handle) = self.processor_thread.take() {\n            match handle.join() {\n                Ok(_) =\u003e { /* Thread joined cleanly */ }\n                Err(join_err) =\u003e {\n                    eprintln!(\"Watcher processor thread panicked: {:?}\", join_err);\n                }\n            }\n        }\n        \n        let mut final_state_guard = self.state.lock().unwrap();\n        *final_state_guard = WatcherState::Stopped;\n        Ok(())\n    }\n\n    pub fn status(\u0026self) -\u003e WatcherStatus {\n        let state_guard = self.state.lock().unwrap().clone();\n        WatcherStatus {\n            state: state_guard,\n            events_processed: self.events_processed.load(Ordering::SeqCst),\n            queue_size: self.queue_size.load(Ordering::SeqCst),\n            start_time: Some(self.start_time),\n            watched_paths: self.watched_paths.clone(),\n        }\n    }\n}\n\nimpl Drop for FileWatcher {\n    fn drop(\u0026mut self) {\n        if let Err(e) = self.stop() {\n            eprintln!(\"Error stopping watcher in Drop: {:?}\", e);\n        }\n    }\n}\n\n\n#[cfg(test)]\nmod file_watcher_state_tests { \n    use super::*;\n    use tempfile::tempdir;\n    use std::fs as FsMod; // Alias to avoid conflict with local `fs` module name if any\n\n    #[test]\n    fn test_watcher_pause_resume_stop() {\n        let tmp_dir = tempdir().unwrap();\n        let watch_path = tmp_dir.path().to_path_buf();\n        FsMod::create_dir_all(\u0026watch_path).expect(\"Failed to create temp dir for watching\");\n\n        let config = WatcherConfig::default();\n\n        let mut watcher = FileWatcher::new(vec![watch_path], config).expect(\"Failed to create watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Initializing);\n\n        watcher.start().expect(\"Start failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.pause().expect(\"Pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.pause().expect(\"Second pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.resume().expect(\"Resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        watcher.resume().expect(\"Second resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.stop().expect(\"Stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n\n        watcher.stop().expect(\"Second stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n    }\n\n    #[test]\n    fn test_watcher_start_errors() {\n        let tmp_dir = tempdir().unwrap();\n        FsMod::create_dir_all(tmp_dir.path()).expect(\"Failed to create temp dir for watching\");\n        let mut watcher = FileWatcher::new(vec![tmp_dir.path().to_path_buf()], WatcherConfig::default()).unwrap();\n        \n        {\n            let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::Watching; \n        }\n        assert!(watcher.start().is_ok(), \"Should be able to call start when already Watching (idempotent state change)\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        {\n             let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::ShuttingDown;\n        }\n        assert!(watcher.start().is_err(), \"Should not be able to start from ShuttingDown\");\n    }\n\n     #[test]\n    fn test_new_watcher_with_nonexistent_path() {\n        let non_existent_path = PathBuf::from(\"/path/that/REALLY/does/not/exist/for/sure/and/cannot/be/created\");\n        let config = WatcherConfig::default();\n        let watcher_result = FileWatcher::new(vec![non_existent_path], config);\n        assert!(watcher_result.is_err());\n        if let Err(e) = watcher_result {\n            let err_string = e.to_string();\n            assert!(err_string.contains(\"Failed to watch path\") || err_string.contains(\"os error 2\"), \"Error was: {}\", err_string);\n        }\n    }\n\n    #[test]\n    fn test_watcher_default_config() {\n        let config = WatcherConfig::default(); \n        assert_eq!(config.debounce_ms, 100);\n        assert_eq!(config.batch_size, 1000);\n        assert_eq!(config.max_queue_size, 100_000);\n        assert_eq!(config.drain_timeout_ms, 5000);\n    }\n}","traces":[{"line":38,"address":[5544800],"length":1,"stats":{"Line":1}},{"line":91,"address":[1891888,1892030,1892036],"length":1,"stats":{"Line":1}},{"line":93,"address":[1891917],"length":1,"stats":{"Line":1}},{"line":95,"address":[1891922],"length":1,"stats":{"Line":3}},{"line":99,"address":[1892048,1892677],"length":1,"stats":{"Line":2}},{"line":100,"address":[1892150,1892073],"length":1,"stats":{"Line":4}},{"line":101,"address":[1892163,1892228],"length":1,"stats":{"Line":4}},{"line":103,"address":[1892285],"length":1,"stats":{"Line":3}},{"line":105,"address":[1892299,1892263],"length":1,"stats":{"Line":4}},{"line":106,"address":[1892337],"length":1,"stats":{"Line":1}},{"line":107,"address":[1892600,1892355,1892520],"length":1,"stats":{"Line":2}},{"line":108,"address":[1892594],"length":1,"stats":{"Line":0}},{"line":110,"address":[1892536],"length":1,"stats":{"Line":1}},{"line":111,"address":[5545546],"length":1,"stats":{"Line":1}},{"line":114,"address":[1892387],"length":1,"stats":{"Line":2}},{"line":119,"address":[1892720],"length":1,"stats":{"Line":1}},{"line":120,"address":[1892734],"length":1,"stats":{"Line":1}},{"line":123,"address":[1892800,1893049,1893055],"length":1,"stats":{"Line":1}},{"line":124,"address":[1892843],"length":1,"stats":{"Line":4}},{"line":125,"address":[1787232,1787242],"length":1,"stats":{"Line":4}},{"line":126,"address":[1892964],"length":1,"stats":{"Line":1}},{"line":127,"address":[1893015],"length":1,"stats":{"Line":1}},{"line":131,"address":[1893072],"length":1,"stats":{"Line":1}},{"line":132,"address":[5546101],"length":1,"stats":{"Line":1}},{"line":337,"address":[1896187,1896949,1893088],"length":1,"stats":{"Line":1}},{"line":338,"address":[5546151,5546327],"length":1,"stats":{"Line":2}},{"line":339,"address":[1893393,1893457],"length":1,"stats":{"Line":2}},{"line":340,"address":[1893548,1893612],"length":1,"stats":{"Line":2}},{"line":341,"address":[1893699,1893779],"length":1,"stats":{"Line":2}},{"line":343,"address":[1893934,1893874],"length":1,"stats":{"Line":3}},{"line":345,"address":[1894014,1894094],"length":1,"stats":{"Line":2}},{"line":347,"address":[1787346,1787248,1787340],"length":1,"stats":{"Line":4}},{"line":348,"address":[1787263],"length":1,"stats":{"Line":1}},{"line":352,"address":[1894134],"length":1,"stats":{"Line":1}},{"line":355,"address":[5547537,5547621],"length":1,"stats":{"Line":2}},{"line":356,"address":[1896429,1896579],"length":1,"stats":{"Line":2}},{"line":357,"address":[1894668,1896421],"length":1,"stats":{"Line":2}},{"line":358,"address":[1787382,1787360],"length":1,"stats":{"Line":3}},{"line":361,"address":[1894704],"length":1,"stats":{"Line":2}},{"line":362,"address":[1894711],"length":1,"stats":{"Line":1}},{"line":363,"address":[1894822,1894764],"length":1,"stats":{"Line":2}},{"line":364,"address":[5547973,5547906],"length":1,"stats":{"Line":2}},{"line":365,"address":[1894925,1894980],"length":1,"stats":{"Line":2}},{"line":366,"address":[1895004,1895069],"length":1,"stats":{"Line":2}},{"line":368,"address":[1895093,1895174],"length":1,"stats":{"Line":3}},{"line":369,"address":[1895207,1895261],"length":1,"stats":{"Line":4}},{"line":371,"address":[1895269],"length":1,"stats":{"Line":3}},{"line":372,"address":[1787551,1787642],"length":1,"stats":{"Line":3}},{"line":374,"address":[1787652,1787720],"length":1,"stats":{"Line":4}},{"line":375,"address":[1787771,1787832],"length":1,"stats":{"Line":4}},{"line":377,"address":[1788022],"length":1,"stats":{"Line":3}},{"line":378,"address":[1791130,1788098],"length":1,"stats":{"Line":0}},{"line":381,"address":[1788064,1788130],"length":1,"stats":{"Line":4}},{"line":385,"address":[1788186],"length":1,"stats":{"Line":2}},{"line":386,"address":[1788294,1789619,1788214],"length":1,"stats":{"Line":5}},{"line":387,"address":[1788344,1788418],"length":1,"stats":{"Line":1}},{"line":388,"address":[1788385],"length":1,"stats":{"Line":1}},{"line":389,"address":[1788593],"length":1,"stats":{"Line":1}},{"line":390,"address":[1788649,1788752,1788887],"length":1,"stats":{"Line":3}},{"line":391,"address":[1788956],"length":1,"stats":{"Line":1}},{"line":392,"address":[1789094],"length":1,"stats":{"Line":1}},{"line":393,"address":[1789114],"length":1,"stats":{"Line":1}},{"line":394,"address":[1789104],"length":1,"stats":{"Line":1}},{"line":395,"address":[1789084],"length":1,"stats":{"Line":1}},{"line":396,"address":[1789074],"length":1,"stats":{"Line":0}},{"line":398,"address":[1789340],"length":1,"stats":{"Line":1}},{"line":399,"address":[5565546],"length":1,"stats":{"Line":1}},{"line":400,"address":[1789154,1789227],"length":1,"stats":{"Line":2}},{"line":401,"address":[1789278],"length":1,"stats":{"Line":1}},{"line":402,"address":[1789292],"length":1,"stats":{"Line":1}},{"line":406,"address":[1788495],"length":1,"stats":{"Line":0}},{"line":407,"address":[1788583,1789504],"length":1,"stats":{"Line":0}},{"line":410,"address":[1789051],"length":1,"stats":{"Line":1}},{"line":415,"address":[1789735,1789791],"length":1,"stats":{"Line":6}},{"line":417,"address":[1789853,1789918],"length":1,"stats":{"Line":4}},{"line":418,"address":[1789963],"length":1,"stats":{"Line":1}},{"line":419,"address":[1789978,1790049],"length":1,"stats":{"Line":2}},{"line":420,"address":[1790057],"length":1,"stats":{"Line":1}},{"line":422,"address":[5566563],"length":1,"stats":{"Line":1}},{"line":423,"address":[5566765,5566686],"length":1,"stats":{"Line":2}},{"line":424,"address":[5566807,5566869],"length":1,"stats":{"Line":0}},{"line":425,"address":[1790548,1790481],"length":1,"stats":{"Line":0}},{"line":426,"address":[5567137,5567206],"length":1,"stats":{"Line":0}},{"line":432,"address":[5567328,5566826],"length":1,"stats":{"Line":2}},{"line":433,"address":[5567437,5567518],"length":1,"stats":{"Line":2}},{"line":440,"address":[5566313,5567497],"length":1,"stats":{"Line":2}},{"line":443,"address":[1791154,1791660,1787798],"length":1,"stats":{"Line":2}},{"line":444,"address":[5567719],"length":1,"stats":{"Line":0}},{"line":445,"address":[5567803,5567742],"length":1,"stats":{"Line":0}},{"line":446,"address":[5568062,5567860],"length":1,"stats":{"Line":0}},{"line":447,"address":[1791915,1791611],"length":1,"stats":{"Line":0}},{"line":453,"address":[5568214,5567680],"length":1,"stats":{"Line":2}},{"line":454,"address":[1791742,1791815],"length":1,"stats":{"Line":2}},{"line":457,"address":[5548912],"length":1,"stats":{"Line":2}},{"line":458,"address":[5548576],"length":1,"stats":{"Line":1}},{"line":460,"address":[1895500],"length":1,"stats":{"Line":1}},{"line":461,"address":[1895531],"length":1,"stats":{"Line":1}},{"line":462,"address":[5548671],"length":1,"stats":{"Line":2}},{"line":463,"address":[5548711],"length":1,"stats":{"Line":2}},{"line":464,"address":[5548743],"length":1,"stats":{"Line":2}},{"line":465,"address":[1895667],"length":1,"stats":{"Line":2}},{"line":466,"address":[1895691],"length":1,"stats":{"Line":1}},{"line":467,"address":[5548815],"length":1,"stats":{"Line":2}},{"line":468,"address":[1895800],"length":1,"stats":{"Line":1}},{"line":472,"address":[1896992,1897340,1897346],"length":1,"stats":{"Line":0}},{"line":474,"address":[1897090,1897029],"length":1,"stats":{"Line":0}},{"line":475,"address":[5550341,5550540,5550435,5550382],"length":1,"stats":{"Line":0}},{"line":477,"address":[5550198],"length":1,"stats":{"Line":0}},{"line":480,"address":[5551803,5550592,5551578],"length":1,"stats":{"Line":2}},{"line":481,"address":[5550615],"length":1,"stats":{"Line":2}},{"line":482,"address":[5550880,5550706,5550785],"length":1,"stats":{"Line":5}},{"line":483,"address":[1897611,1898298],"length":1,"stats":{"Line":2}},{"line":484,"address":[5551618,5551750],"length":1,"stats":{"Line":0}},{"line":486,"address":[5551740,5551649,5551594],"length":1,"stats":{"Line":2}},{"line":487,"address":[1898400],"length":1,"stats":{"Line":0}},{"line":489,"address":[5551677],"length":1,"stats":{"Line":1}},{"line":491,"address":[5550982,5550886],"length":1,"stats":{"Line":2}},{"line":492,"address":[5551386,5551556,5551107,5551192],"length":1,"stats":{"Line":2}},{"line":495,"address":[5550947,5551136],"length":1,"stats":{"Line":2}},{"line":496,"address":[5551145],"length":1,"stats":{"Line":1}},{"line":499,"address":[5552479,5552485,5551824],"length":1,"stats":{"Line":1}},{"line":500,"address":[1898543],"length":1,"stats":{"Line":1}},{"line":501,"address":[1898666,1898612],"length":1,"stats":{"Line":2}},{"line":503,"address":[5552074,5552032],"length":1,"stats":{"Line":2}},{"line":504,"address":[1898756],"length":1,"stats":{"Line":1}},{"line":506,"address":[1898734],"length":1,"stats":{"Line":1}},{"line":507,"address":[1898801,1898700,1898973],"length":1,"stats":{"Line":0}},{"line":511,"address":[5553169,5553175,5552512],"length":1,"stats":{"Line":1}},{"line":512,"address":[1899183],"length":1,"stats":{"Line":1}},{"line":513,"address":[5552603,5552670],"length":1,"stats":{"Line":2}},{"line":515,"address":[1899363,1899413],"length":1,"stats":{"Line":2}},{"line":516,"address":[1899419],"length":1,"stats":{"Line":1}},{"line":518,"address":[5552720],"length":1,"stats":{"Line":1}},{"line":519,"address":[1899443,1899615,1899340],"length":1,"stats":{"Line":0}},{"line":523,"address":[1900630,1900896,1899808],"length":1,"stats":{"Line":1}},{"line":524,"address":[1899828],"length":1,"stats":{"Line":1}},{"line":525,"address":[5553385,5553318,5553472],"length":1,"stats":{"Line":3}},{"line":526,"address":[1900022],"length":1,"stats":{"Line":1}},{"line":528,"address":[5553500],"length":1,"stats":{"Line":1}},{"line":529,"address":[1900126],"length":1,"stats":{"Line":1}},{"line":531,"address":[1900159],"length":1,"stats":{"Line":1}},{"line":533,"address":[1900217],"length":1,"stats":{"Line":1}},{"line":534,"address":[5553743,5553822],"length":1,"stats":{"Line":2}},{"line":536,"address":[1900440],"length":1,"stats":{"Line":0}},{"line":537,"address":[1900539,1900488],"length":1,"stats":{"Line":0}},{"line":542,"address":[1900707,1900659],"length":1,"stats":{"Line":2}},{"line":543,"address":[1900771,1900842],"length":1,"stats":{"Line":2}},{"line":544,"address":[1900851],"length":1,"stats":{"Line":1}},{"line":547,"address":[5554806,5554384,5554812],"length":1,"stats":{"Line":1}},{"line":548,"address":[1900966],"length":1,"stats":{"Line":1}},{"line":551,"address":[5554595],"length":1,"stats":{"Line":1}},{"line":552,"address":[1901154],"length":1,"stats":{"Line":1}},{"line":553,"address":[1901191],"length":1,"stats":{"Line":1}},{"line":554,"address":[1901207],"length":1,"stats":{"Line":1}},{"line":560,"address":[1703384,1703152,1703378],"length":1,"stats":{"Line":1}},{"line":561,"address":[1703164],"length":1,"stats":{"Line":1}},{"line":562,"address":[1703234,1703308],"length":1,"stats":{"Line":0}}],"covered":134,"coverable":157},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher_tests.rs"],"content":"//! Tests for the file system watcher functionality\n\n#[cfg(test)]\nmod tests {\n    // Updated import for BackupManager from the new backup module\n    use crate::backup::BackupManager;\n    // These are still from the watcher module\n    use crate::watcher::{FileWatcher, WatcherConfig, WatcherState};\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n\n\n    use std::fs::{self, File};\n    use std::io::Write;\n    // No longer need: use std::path::PathBuf;\n    use std::thread;\n    use std::time::Duration;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_watcher_lifecycle() {\n        // Create a temp directory for testing\n        let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n        let temp_path = temp_dir.path();\n\n        // Create a test file\n        let test_file_path = temp_path.join(\"test.txt\");\n        let mut file = File::create(\u0026test_file_path).expect(\"Failed to create test file\");\n        writeln!(file, \"Test content\").expect(\"Failed to write to test file\");\n        drop(file);\n\n        // Configure and start the watcher\n        let config = WatcherConfig {\n            debounce_ms: 100,\n            batch_size: 10,\n            max_queue_size: 100,\n            drain_timeout_ms: 1000,\n        };\n\n        let mut watcher = FileWatcher::new(vec![temp_path.to_path_buf()], config)\n            .expect(\"Failed to create watcher\");\n\n        watcher.start().expect(\"Failed to start watcher\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        thread::sleep(Duration::from_millis(200));\n        let new_file_path = temp_path.join(\"new_file.txt\");\n        let mut new_file_handle = File::create(\u0026new_file_path).expect(\"Failed to create new file\");\n        writeln!(new_file_handle, \"New file content\").expect(\"Failed to write to new file\");\n        drop(new_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        let mut existing_file_handle = fs::OpenOptions::new()\n            .write(true)\n            .append(true)\n            .open(\u0026test_file_path)\n            .expect(\"Failed to open test file for modification\");\n        writeln!(existing_file_handle, \"Additional content\").expect(\"Failed to append to test file\");\n        drop(existing_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        fs::remove_file(\u0026new_file_path).expect(\"Failed to remove file\");\n\n        thread::sleep(Duration::from_millis(500));\n        watcher.stop().expect(\"Failed to stop watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n        assert!(watcher.status().events_processed \u003e 0, \"Expected some file events to be processed\");\n    }\n\n    #[test]\n    fn test_backup_manager_related_functionality() {\n        let live_db_tmp_dir = tempdir().expect(\"Failed to create temp directory for live DB\");\n        let backups_storage_tmp_dir = tempdir().expect(\"Failed to create temp directory for backups storage\");\n        \n        let live_db_path = live_db_tmp_dir.path().join(\"test_live_watcher.db\"); // Unique name\n        let backups_actual_dir = backups_storage_tmp_dir.path().join(\"my_backups_watcher\"); // Unique name\n\n        // Initialize a proper SQLite DB for the \"live\" database\n        let _conn = open_marlin_db(\u0026live_db_path).expect(\"Failed to open test_live_watcher.db for backup test\");\n        \n        let backup_manager = BackupManager::new(\u0026live_db_path, \u0026backups_actual_dir)\n            .expect(\"Failed to create BackupManager instance\");\n        \n        let backup_info = backup_manager.create_backup().expect(\"Failed to create first backup\");\n        \n        assert!(backups_actual_dir.join(\u0026backup_info.id).exists(), \"Backup file should exist\");\n        assert!(backup_info.size_bytes \u003e 0, \"Backup size should be greater than 0\");\n        \n        for i in 0..3 {\n            std::thread::sleep(std::time::Duration::from_millis(30)); // Ensure timestamp difference\n            backup_manager.create_backup().unwrap_or_else(|e| panic!(\"Failed to create additional backup {}: {:?}\", i, e));\n        }\n        \n        let backups = backup_manager.list_backups().expect(\"Failed to list backups\");\n        assert_eq!(backups.len(), 4, \"Should have 4 backups listed\");\n        \n        let prune_result = backup_manager.prune(2).expect(\"Failed to prune backups\");\n        \n        assert_eq!(prune_result.kept.len(), 2, \"Should have kept 2 backups\");\n        assert_eq!(prune_result.removed.len(), 2, \"Should have removed 2 backups (4 initial - 2 kept)\");\n        \n        let remaining_backups = backup_manager.list_backups().expect(\"Failed to list backups after prune\");\n        assert_eq!(remaining_backups.len(), 2, \"Should have 2 backups remaining after prune\");\n\n        for removed_info in prune_result.removed {\n            assert!(!backups_actual_dir.join(\u0026removed_info.id).exists(), \"Removed backup file {} should not exist\", removed_info.id);\n        }\n        for kept_info in prune_result.kept {\n            assert!(backups_actual_dir.join(\u0026kept_info.id).exists(), \"Kept backup file {} should exist\", kept_info.id);\n        }\n    }\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","tui-bin","src","main.rs"],"content":"// tui-bin/src/main.rs\n\nfn main() {\n    eprintln!(\"marlin-tui is not yet implemented. Stay tuned!\");\n}\n","traces":[{"line":3,"address":[127392],"length":1,"stats":{"Line":0}},{"line":4,"address":[127396],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2}]};
+        var previousData = {"files":[{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","build.rs"],"content":"// cli-bin/build.rs\n//\n// Build script to generate the CLI cheatsheet at compile time.  It\n// parses `src/cli/commands.yaml` and emits a simple Markdown table of\n// commands and flags to `docs/cli_cheatsheet.md`.\n\nuse std::{fs, path::Path};\n\nuse serde_yaml::Value;\n\nfn main() {\n    println!(\"cargo:rerun-if-changed=build.rs\");\n    println!(\"cargo:rerun-if-changed=src/cli/commands.yaml\");\n\n    if let Err(e) = generate_cheatsheet() {\n        eprintln!(\"Failed to generate CLI cheatsheet: {e}\");\n        std::process::exit(1);\n    }\n}\n\nfn generate_cheatsheet() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    let yaml_str = fs::read_to_string(\"src/cli/commands.yaml\")?;\n    let parsed: Value = serde_yaml::from_str(\u0026yaml_str)?;\n\n    let mut table = String::from(\"| Command | Flags |\\n| ------- | ----- |\\n\");\n\n    if let Value::Mapping(cmds) = parsed {\n        for (cmd_name_val, cmd_details_val) in cmds {\n            let cmd_name = cmd_name_val.as_str().unwrap_or(\"\");\n            if let Value::Mapping(cmd_details) = cmd_details_val {\n                if let Some(Value::Mapping(actions)) = cmd_details.get(\u0026Value::String(\"actions\".into())) {\n                    for (action_name_val, action_body_val) in actions {\n                        let action_name = action_name_val.as_str().unwrap_or(\"\");\n                        let flags = if let Value::Mapping(action_map) = action_body_val {\n                            match action_map.get(\u0026Value::String(\"flags\".into())) {\n                                Some(Value::Sequence(seq)) =\u003e seq\n                                    .iter()\n                                    .filter_map(|v| v.as_str())\n                                    .collect::\u003cVec\u003c_\u003e\u003e()\n                                    .join(\", \"),\n                                _ =\u003e String::new(),\n                            }\n                        } else {\n                            String::new()\n                        };\n\n                        let flags_disp = if flags.is_empty() { \"—\" } else { \u0026flags };\n                        table.push_str(\u0026format!(\"| `{}` | {} |\\n\", format!(\"{} {}\", cmd_name, action_name), flags_disp));\n                    }\n                }\n            }\n        }\n    }\n\n    fs::create_dir_all(Path::new(\"docs\"))?;\n    fs::write(\"docs/cli_cheatsheet.md\", table)?;\n\n    Ok(())\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","annotate.rs"],"content":"// src/cli/annotate.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum AnnotateCmd {\n    Add (ArgsAdd),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub note: String,\n    #[arg(long)] pub range: Option\u003cString\u003e,\n    #[arg(long)] pub highlight: bool,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsList { pub file_pattern: String }\n\npub fn run(cmd: \u0026AnnotateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        AnnotateCmd::Add(a)  =\u003e todo!(\"annotate add {:?}\", a),\n        AnnotateCmd::List(a) =\u003e todo!(\"annotate list {:?}\", a),\n    }\n}\n","traces":[{"line":23,"address":[2450848],"length":1,"stats":{"Line":0}},{"line":24,"address":[2450887],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","coll.rs"],"content":"//! `marlin coll …` – named collections of files (simple “playlists”).\n\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // local enum for text / json output\nuse libmarlin::db;        // core DB helpers from the library crate\n\n#[derive(Subcommand, Debug)]\npub enum CollCmd {\n    /// Create an empty collection\n    Create(CreateArgs),\n    /// Add files (glob) to a collection\n    Add(AddArgs),\n    /// List files inside a collection\n    List(ListArgs),\n}\n\n#[derive(Args, Debug)]\npub struct CreateArgs {\n    pub name: String,\n}\n\n#[derive(Args, Debug)]\npub struct AddArgs {\n    pub name: String,\n    pub file_pattern: String,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub name: String,\n}\n\n/// Look-up an existing collection **without** implicitly creating it.\n///\n/// Returns the collection ID or an error if it doesn’t exist.\nfn lookup_collection_id(conn: \u0026Connection, name: \u0026str) -\u003e anyhow::Result\u003ci64\u003e {\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        [name],\n        |r| r.get(0),\n    )\n    .map_err(|_| anyhow::anyhow!(\"collection not found: {}\", name))\n}\n\npub fn run(cmd: \u0026CollCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── coll create ──────────────────────────────────────────── */\n        CollCmd::Create(a) =\u003e {\n            db::ensure_collection(conn, \u0026a.name)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Created collection '{}'\", a.name);\n            }\n        }\n\n        /* ── coll add ─────────────────────────────────────────────── */\n        CollCmd::Add(a) =\u003e {\n            // Fail if the target collection does not yet exist\n            let coll_id = lookup_collection_id(conn, \u0026a.name)?;\n\n            let like = a.file_pattern.replace('*', \"%\");\n            let mut stmt = conn.prepare(\"SELECT id FROM files WHERE path LIKE ?1\")?;\n            let ids: Vec\u003ci64\u003e = stmt\n                .query_map([\u0026like], |r| r.get::\u003c_, i64\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            for fid in \u0026ids {\n                db::add_file_to_collection(conn, coll_id, *fid)?;\n            }\n\n            match fmt {\n                Format::Text =\u003e println!(\"Added {} file(s) → '{}'\", ids.len(), a.name),\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\n                            \"{{\\\"collection\\\":\\\"{}\\\",\\\"added\\\":{}}}\",\n                            a.name,\n                            ids.len()\n                        );\n                    }\n                }\n            }\n        }\n\n        /* ── coll list ────────────────────────────────────────────── */\n        CollCmd::List(a) =\u003e {\n            let files = db::list_collection(conn, \u0026a.name)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for f in files {\n                        println!(\"{f}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026files)?);\n                    }\n                }\n            }\n        }\n    }\n    Ok(())\n}\n","traces":[{"line":38,"address":[2169520],"length":1,"stats":{"Line":0}},{"line":39,"address":[2169565],"length":1,"stats":{"Line":0}},{"line":41,"address":[2169545],"length":1,"stats":{"Line":0}},{"line":42,"address":[2296656,2296672],"length":1,"stats":{"Line":0}},{"line":44,"address":[2296704,2296721],"length":1,"stats":{"Line":0}},{"line":47,"address":[2171921,2169632,2171991],"length":1,"stats":{"Line":0}},{"line":48,"address":[2169683],"length":1,"stats":{"Line":0}},{"line":50,"address":[2169766],"length":1,"stats":{"Line":0}},{"line":51,"address":[2170057,2169783],"length":1,"stats":{"Line":0}},{"line":52,"address":[2170122],"length":1,"stats":{"Line":0}},{"line":53,"address":[2170138],"length":1,"stats":{"Line":0}},{"line":58,"address":[2169858],"length":1,"stats":{"Line":0}},{"line":60,"address":[2169866,2170255],"length":1,"stats":{"Line":0}},{"line":62,"address":[2170320],"length":1,"stats":{"Line":0}},{"line":63,"address":[2170372,2170443,2171981],"length":1,"stats":{"Line":0}},{"line":64,"address":[2170882,2170990,2171932,2171195,2170775],"length":1,"stats":{"Line":0}},{"line":65,"address":[2170926,2170767],"length":1,"stats":{"Line":0}},{"line":68,"address":[2171376,2171293],"length":1,"stats":{"Line":0}},{"line":69,"address":[2171767,2171486],"length":1,"stats":{"Line":0}},{"line":72,"address":[2171515],"length":1,"stats":{"Line":0}},{"line":73,"address":[2171558],"length":1,"stats":{"Line":0}},{"line":88,"address":[2169940],"length":1,"stats":{"Line":0}},{"line":89,"address":[2172004,2172061,2169952],"length":1,"stats":{"Line":0}},{"line":90,"address":[2172165],"length":1,"stats":{"Line":0}},{"line":92,"address":[2172197,2172305,2172440],"length":1,"stats":{"Line":0}},{"line":93,"address":[2172602,2172509],"length":1,"stats":{"Line":0}},{"line":105,"address":[2170227],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":27},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","event.rs"],"content":"// src/cli/event.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum EventCmd {\n    Add     (ArgsAdd),\n    Timeline,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsAdd {\n    pub file: String,\n    pub date: String,\n    pub description: String,\n}\n\npub fn run(cmd: \u0026EventCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        EventCmd::Add(a)      =\u003e todo!(\"event add {:?}\", a),\n        EventCmd::Timeline    =\u003e todo!(\"event timeline\"),\n    }\n}\n","traces":[{"line":19,"address":[2433520],"length":1,"stats":{"Line":0}},{"line":20,"address":[2433559],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","link.rs"],"content":"//! src/cli/link.rs – manage typed relationships between files\n\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector\nuse libmarlin::db;        // ← switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum LinkCmd {\n    Add(LinkArgs),\n    Rm (LinkArgs),\n    List(ListArgs),\n    Backlinks(BacklinksArgs),\n}\n\n#[derive(Args, Debug)]\npub struct LinkArgs {\n    pub from: String,\n    pub to:   String,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct ListArgs {\n    pub pattern: String,\n    #[arg(long)]\n    pub direction: Option\u003cString\u003e,\n    #[arg(long)]\n    pub r#type: Option\u003cString\u003e,\n}\n\n#[derive(Args, Debug)]\npub struct BacklinksArgs {\n    pub pattern: String,\n}\n\npub fn run(cmd: \u0026LinkCmd, conn: \u0026mut Connection, format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        LinkCmd::Add(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::add_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Linked '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Linked '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::Rm(args) =\u003e {\n            let src_id = db::file_id(conn, \u0026args.from)?;\n            let dst_id = db::file_id(conn, \u0026args.to)?;\n            db::remove_link(conn, src_id, dst_id, args.r#type.as_deref())?;\n            match format {\n                Format::Text =\u003e {\n                    if let Some(t) = \u0026args.r#type {\n                        println!(\"Removed link '{}' → '{}' [type='{}']\", args.from, args.to, t);\n                    } else {\n                        println!(\"Removed link '{}' → '{}'\", args.from, args.to);\n                    }\n                }\n                Format::Json =\u003e {\n                    let typ = args\n                        .r#type\n                        .as_ref()\n                        .map(|s| format!(\"\\\"{}\\\"\", s))\n                        .unwrap_or_else(|| \"null\".into());\n                    println!(\n                        \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                        args.from, args.to, typ\n                    );\n                }\n            }\n        }\n        LinkCmd::List(args) =\u003e {\n            let results = db::list_links(\n                conn,\n                \u0026args.pattern,\n                args.direction.as_deref(),\n                args.r#type.as_deref(),\n            )?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, dst, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\n                                \"{{\\\"from\\\":\\\"{}\\\",\\\"to\\\":\\\"{}\\\",\\\"type\\\":{}}}\",\n                                src, dst, typ\n                            )\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, dst, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} → {} [type='{}']\", src, dst, t);\n                        } else {\n                            println!(\"{} → {}\", src, dst);\n                        }\n                    }\n                }\n            }\n        }\n        LinkCmd::Backlinks(args) =\u003e {\n            let results = db::find_backlinks(conn, \u0026args.pattern)?;\n            match format {\n                Format::Json =\u003e {\n                    let items: Vec\u003cString\u003e = results\n                        .into_iter()\n                        .map(|(src, t)| {\n                            let typ = t\n                                .as_ref()\n                                .map(|s| format!(\"\\\"{}\\\"\", s))\n                                .unwrap_or_else(|| \"null\".into());\n                            format!(\"{{\\\"from\\\":\\\"{}\\\",\\\"type\\\":{}}}\", src, typ)\n                        })\n                        .collect();\n                    println!(\"[{}]\", items.join(\",\"));\n                }\n                Format::Text =\u003e {\n                    for (src, t) in results {\n                        if let Some(t) = t {\n                            println!(\"{} [type='{}']\", src, t);\n                        } else {\n                            println!(\"{}\", src);\n                        }\n                    }\n                }\n            }\n        }\n    }\n\n    Ok(())\n}\n","traces":[{"line":39,"address":[2065785,2063952,2065779],"length":1,"stats":{"Line":0}},{"line":40,"address":[2064009],"length":1,"stats":{"Line":0}},{"line":41,"address":[2064086],"length":1,"stats":{"Line":0}},{"line":42,"address":[2064644,2064106],"length":1,"stats":{"Line":0}},{"line":43,"address":[2064715],"length":1,"stats":{"Line":0}},{"line":44,"address":[2064854],"length":1,"stats":{"Line":0}},{"line":45,"address":[2064991],"length":1,"stats":{"Line":0}},{"line":47,"address":[2065109],"length":1,"stats":{"Line":0}},{"line":48,"address":[2065179],"length":1,"stats":{"Line":0}},{"line":50,"address":[2065393],"length":1,"stats":{"Line":0}},{"line":54,"address":[2065012],"length":1,"stats":{"Line":0}},{"line":57,"address":[2422784,2422805],"length":1,"stats":{"Line":0}},{"line":58,"address":[2422912,2422924],"length":1,"stats":{"Line":0}},{"line":59,"address":[2065079,2065609],"length":1,"stats":{"Line":0}},{"line":66,"address":[2064187],"length":1,"stats":{"Line":0}},{"line":67,"address":[2065814,2064207],"length":1,"stats":{"Line":0}},{"line":68,"address":[2065882],"length":1,"stats":{"Line":0}},{"line":69,"address":[2066021],"length":1,"stats":{"Line":0}},{"line":70,"address":[2066158],"length":1,"stats":{"Line":0}},{"line":72,"address":[2066276],"length":1,"stats":{"Line":0}},{"line":73,"address":[2066346],"length":1,"stats":{"Line":0}},{"line":75,"address":[2066560],"length":1,"stats":{"Line":0}},{"line":79,"address":[2066179],"length":1,"stats":{"Line":0}},{"line":82,"address":[2422981,2422960],"length":1,"stats":{"Line":0}},{"line":83,"address":[2423088,2423100],"length":1,"stats":{"Line":0}},{"line":84,"address":[2066764,2066246],"length":1,"stats":{"Line":0}},{"line":91,"address":[2064288],"length":1,"stats":{"Line":0}},{"line":94,"address":[2064308],"length":1,"stats":{"Line":0}},{"line":95,"address":[2064337],"length":1,"stats":{"Line":0}},{"line":96,"address":[2064371],"length":1,"stats":{"Line":0}},{"line":98,"address":[2067095],"length":1,"stats":{"Line":0}},{"line":100,"address":[2067108,2068413],"length":1,"stats":{"Line":0}},{"line":102,"address":[2423161,2423136,2423710],"length":1,"stats":{"Line":0}},{"line":103,"address":[2423214,2423289],"length":1,"stats":{"Line":0}},{"line":105,"address":[2423744,2423765],"length":1,"stats":{"Line":0}},{"line":106,"address":[2423884,2423872],"length":1,"stats":{"Line":0}},{"line":107,"address":[2423323,2423385],"length":1,"stats":{"Line":0}},{"line":113,"address":[2068443,2068526],"length":1,"stats":{"Line":0}},{"line":116,"address":[2067174,2067405,2067278],"length":1,"stats":{"Line":0}},{"line":117,"address":[2067598,2067665],"length":1,"stats":{"Line":0}},{"line":118,"address":[2067806,2067705],"length":1,"stats":{"Line":0}},{"line":120,"address":[2068085,2067732],"length":1,"stats":{"Line":0}},{"line":126,"address":[2064525],"length":1,"stats":{"Line":0}},{"line":127,"address":[2068818,2064537,2068761],"length":1,"stats":{"Line":0}},{"line":128,"address":[2068922],"length":1,"stats":{"Line":0}},{"line":130,"address":[2068935,2070060],"length":1,"stats":{"Line":0}},{"line":132,"address":[2423945,2424376,2423920],"length":1,"stats":{"Line":0}},{"line":133,"address":[2424052,2423980],"length":1,"stats":{"Line":0}},{"line":135,"address":[2424421,2424400],"length":1,"stats":{"Line":0}},{"line":136,"address":[2424528,2424540],"length":1,"stats":{"Line":0}},{"line":137,"address":[2424145,2424083],"length":1,"stats":{"Line":0}},{"line":140,"address":[2070090,2070173],"length":1,"stats":{"Line":0}},{"line":143,"address":[2069248,2069005,2069113],"length":1,"stats":{"Line":0}},{"line":144,"address":[2069393,2069464],"length":1,"stats":{"Line":0}},{"line":145,"address":[2069605,2069504],"length":1,"stats":{"Line":0}},{"line":147,"address":[2069531,2069841],"length":1,"stats":{"Line":0}},{"line":155,"address":[2065540],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":57},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","remind.rs"],"content":"// src/cli/remind.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum RemindCmd {\n    Set(ArgsSet),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet {\n    pub file_pattern: String,\n    pub timestamp:    String,\n    pub message:      String,\n}\n\npub fn run(cmd: \u0026RemindCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        RemindCmd::Set(a) =\u003e todo!(\"remind set {:?}\", a),\n    }\n}\n","traces":[{"line":18,"address":[2142944],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","state.rs"],"content":"// src/cli/state.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum StateCmd {\n    Set(ArgsSet),\n    TransitionsAdd(ArgsTrans),\n    Log(ArgsLog),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSet   { pub file_pattern: String, pub new_state: String }\n#[derive(Args, Debug)]\npub struct ArgsTrans { pub from_state: String,   pub to_state: String }\n#[derive(Args, Debug)]\npub struct ArgsLog   { pub file_pattern: String }\n\npub fn run(cmd: \u0026StateCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        StateCmd::Set(a)           =\u003e todo!(\"state set {:?}\", a),\n        StateCmd::TransitionsAdd(a)=\u003e todo!(\"state transitions-add {:?}\", a),\n        StateCmd::Log(a)           =\u003e todo!(\"state log {:?}\", a),\n    }\n}\n","traces":[{"line":20,"address":[2474816],"length":1,"stats":{"Line":0}},{"line":21,"address":[2474855],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","task.rs"],"content":"// src/cli/task.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum TaskCmd {\n    Scan(ArgsScan),\n    List(ArgsList),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsScan { pub directory: String }\n#[derive(Args, Debug)]\npub struct ArgsList { #[arg(long)] pub due_today: bool }\n\npub fn run(cmd: \u0026TaskCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        TaskCmd::Scan(a) =\u003e todo!(\"task scan {:?}\", a),\n        TaskCmd::List(a) =\u003e todo!(\"task list {:?}\", a),\n    }\n}\n","traces":[{"line":17,"address":[2403248],"length":1,"stats":{"Line":0}},{"line":18,"address":[2403287],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","version.rs"],"content":"// src/cli/version.rs\nuse clap::{Subcommand, Args};\nuse rusqlite::Connection;\nuse crate::cli::Format;\n\n#[derive(Subcommand, Debug)]\npub enum VersionCmd {\n    Diff(ArgsDiff),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsDiff { pub file: String }\n\npub fn run(cmd: \u0026VersionCmd, _conn: \u0026mut Connection, _format: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        VersionCmd::Diff(a) =\u003e todo!(\"version diff {:?}\", a),\n    }\n}\n","traces":[{"line":14,"address":[2314960],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":1},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","view.rs"],"content":"//! `marlin view …` – save \u0026 use “smart folders” (named queries).\n\nuse std::fs;\n\nuse anyhow::Result;\nuse clap::{Args, Subcommand};\nuse rusqlite::Connection;\n\nuse crate::cli::Format;   // output selector stays local\nuse libmarlin::db;        // ← path switched from `crate::db`\n\n#[derive(Subcommand, Debug)]\npub enum ViewCmd {\n    /// Save (or update) a view\n    Save(ArgsSave),\n    /// List all saved views\n    List,\n    /// Execute a view (print matching paths)\n    Exec(ArgsExec),\n}\n\n#[derive(Args, Debug)]\npub struct ArgsSave {\n    pub view_name: String,\n    pub query: String,\n}\n\n#[derive(Args, Debug)]\npub struct ArgsExec {\n    pub view_name: String,\n}\n\npub fn run(cmd: \u0026ViewCmd, conn: \u0026mut Connection, fmt: Format) -\u003e anyhow::Result\u003c()\u003e {\n    match cmd {\n        /* ── view save ───────────────────────────────────────────── */\n        ViewCmd::Save(a) =\u003e {\n            db::save_view(conn, \u0026a.view_name, \u0026a.query)?;\n            if matches!(fmt, Format::Text) {\n                println!(\"Saved view '{}' = {}\", a.view_name, a.query);\n            }\n        }\n\n        /* ── view list ───────────────────────────────────────────── */\n        ViewCmd::List =\u003e {\n            let views = db::list_views(conn)?;\n            match fmt {\n                Format::Text =\u003e {\n                    for (name, q) in views {\n                        println!(\"{name}: {q}\");\n                    }\n                }\n                Format::Json =\u003e {\n                    #[cfg(feature = \"json\")]\n                    {\n                        println!(\"{}\", serde_json::to_string(\u0026views)?);\n                    }\n                }\n            }\n        }\n\n        /* ── view exec ───────────────────────────────────────────── */\n        ViewCmd::Exec(a) =\u003e {\n            let raw = db::view_query(conn, \u0026a.view_name)?;\n\n            // Re-use the tiny parser from marlin search\n            let fts_expr = build_fts_match(\u0026raw);\n\n            let mut stmt = conn.prepare(\n                r#\"\n                SELECT f.path\n                  FROM files_fts\n                  JOIN files f ON f.rowid = files_fts.rowid\n                 WHERE files_fts MATCH ?1\n                 ORDER BY rank\n                \"#,\n            )?;\n            let mut paths: Vec\u003cString\u003e = stmt\n                .query_map([fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n                .collect::\u003cResult\u003c_, _\u003e\u003e()?;\n\n            /* ── NEW: graceful fallback when FTS finds nothing ───── */\n            if paths.is_empty() \u0026\u0026 !raw.contains(':') {\n                paths = naive_search(conn, \u0026raw)?;\n            }\n\n            if paths.is_empty() \u0026\u0026 matches!(fmt, Format::Text) {\n                eprintln!(\"(view '{}' has no matches)\", a.view_name);\n            } else {\n                for p in paths {\n                    println!(\"{p}\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\n/* ─── naive substring path/content search (≤ 64 kB files) ───────── */\n\nfn naive_search(conn: \u0026Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let term_lc = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut hits = Vec::new();\n    for p in rows {\n        let p = p?;\n        /* path match */\n        if p.to_lowercase().contains(\u0026term_lc) {\n            hits.push(p);\n            continue;\n        }\n        /* small-file content match */\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 64_000 {\n                continue;\n            }\n        }\n        if let Ok(content) = fs::read_to_string(\u0026p) {\n            if content.to_lowercase().contains(\u0026term_lc) {\n                hits.push(p);\n            }\n        }\n    }\n    Ok(hits)\n}\n\n/* ─── minimal copy of search-string → FTS5 translator ───────────── */\n\nfn build_fts_match(raw_query: \u0026str) -\u003e String {\n    use shlex;\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 {\n                    parts.push(\"AND\".into());\n                }\n                parts.push(format!(\"tags_text:{}\", escape(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape(key)));\n            }\n        } else {\n            parts.push(escape(\u0026tok));\n        }\n    }\n    parts.join(\" \")\n}\n\nfn escape(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n","traces":[{"line":33,"address":[2361648,2363240,2363246],"length":1,"stats":{"Line":0}},{"line":34,"address":[2361705],"length":1,"stats":{"Line":0}},{"line":36,"address":[2361821],"length":1,"stats":{"Line":0}},{"line":37,"address":[2362169,2361829],"length":1,"stats":{"Line":0}},{"line":38,"address":[2362218],"length":1,"stats":{"Line":0}},{"line":39,"address":[2362241],"length":1,"stats":{"Line":0}},{"line":45,"address":[2361956,2362416,2362470],"length":1,"stats":{"Line":0}},{"line":46,"address":[2362574],"length":1,"stats":{"Line":0}},{"line":48,"address":[2362714,2362606,2362849],"length":1,"stats":{"Line":0}},{"line":49,"address":[2362950,2363043],"length":1,"stats":{"Line":0}},{"line":62,"address":[2362045],"length":1,"stats":{"Line":0}},{"line":63,"address":[2363307,2362062],"length":1,"stats":{"Line":0}},{"line":66,"address":[2363421,2363500],"length":1,"stats":{"Line":0}},{"line":68,"address":[2363710,2363523,2363588,2365825],"length":1,"stats":{"Line":0}},{"line":77,"address":[2364000,2364067,2364175,2365777,2364384],"length":1,"stats":{"Line":0}},{"line":78,"address":[2096051,2096016],"length":1,"stats":{"Line":0}},{"line":82,"address":[2364598,2364490,2365008,2364558],"length":1,"stats":{"Line":0}},{"line":83,"address":[2364869,2365017,2364663],"length":1,"stats":{"Line":0}},{"line":86,"address":[2365161,2365078,2364564],"length":1,"stats":{"Line":0}},{"line":87,"address":[2365177],"length":1,"stats":{"Line":0}},{"line":89,"address":[2365084,2365421,2365286],"length":1,"stats":{"Line":0}},{"line":90,"address":[2365659,2365490],"length":1,"stats":{"Line":0}},{"line":95,"address":[2362388],"length":1,"stats":{"Line":0}},{"line":100,"address":[2368916,2365904,2367885],"length":1,"stats":{"Line":0}},{"line":101,"address":[2365985],"length":1,"stats":{"Line":0}},{"line":102,"address":[2366105,2368914,2366034],"length":1,"stats":{"Line":0}},{"line":103,"address":[2096115,2096080],"length":1,"stats":{"Line":0}},{"line":105,"address":[2366708],"length":1,"stats":{"Line":0}},{"line":106,"address":[2366936,2366768,2366860,2368590],"length":1,"stats":{"Line":0}},{"line":107,"address":[2367202,2367037],"length":1,"stats":{"Line":0}},{"line":109,"address":[2367488,2367420],"length":1,"stats":{"Line":0}},{"line":110,"address":[2368673],"length":1,"stats":{"Line":0}},{"line":114,"address":[2367767,2367657],"length":1,"stats":{"Line":0}},{"line":115,"address":[2367835,2367774],"length":1,"stats":{"Line":0}},{"line":119,"address":[2367891,2367982],"length":1,"stats":{"Line":0}},{"line":120,"address":[2368030,2368101],"length":1,"stats":{"Line":0}},{"line":121,"address":[2368289],"length":1,"stats":{"Line":0}},{"line":125,"address":[2367090],"length":1,"stats":{"Line":0}},{"line":130,"address":[2372260,2368944,2370638],"length":1,"stats":{"Line":0}},{"line":132,"address":[2368999],"length":1,"stats":{"Line":0}},{"line":133,"address":[2096144,2096178],"length":1,"stats":{"Line":0}},{"line":134,"address":[2369311,2369149,2372214],"length":1,"stats":{"Line":0}},{"line":135,"address":[2369611,2369396],"length":1,"stats":{"Line":0}},{"line":136,"address":[2372201,2369709],"length":1,"stats":{"Line":0}},{"line":137,"address":[2369802,2369686],"length":1,"stats":{"Line":0}},{"line":138,"address":[2096416,2096430],"length":1,"stats":{"Line":0}},{"line":139,"address":[2370204],"length":1,"stats":{"Line":0}},{"line":140,"address":[2370259],"length":1,"stats":{"Line":0}},{"line":142,"address":[2370252,2370333],"length":1,"stats":{"Line":0}},{"line":144,"address":[2370660,2369968],"length":1,"stats":{"Line":0}},{"line":145,"address":[2370782],"length":1,"stats":{"Line":0}},{"line":146,"address":[2370840],"length":1,"stats":{"Line":0}},{"line":147,"address":[2370949],"length":1,"stats":{"Line":0}},{"line":148,"address":[2371130,2371095],"length":1,"stats":{"Line":0}},{"line":149,"address":[2371430],"length":1,"stats":{"Line":0}},{"line":150,"address":[2371520],"length":1,"stats":{"Line":0}},{"line":152,"address":[2371120,2371832],"length":1,"stats":{"Line":0}},{"line":155,"address":[2372155,2370820],"length":1,"stats":{"Line":0}},{"line":158,"address":[2369441],"length":1,"stats":{"Line":0}},{"line":161,"address":[2372650,2372288,2372656],"length":1,"stats":{"Line":0}},{"line":162,"address":[2096464,2096492],"length":1,"stats":{"Line":0}},{"line":163,"address":[2372621,2372484,2372366],"length":1,"stats":{"Line":0}},{"line":165,"address":[2372417,2372669],"length":1,"stats":{"Line":0}},{"line":167,"address":[2372613],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":64},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli","watch.rs"],"content":"// src/cli/watch.rs\n\nuse anyhow::Result;\nuse clap::Subcommand;\nuse libmarlin::watcher::{WatcherConfig, WatcherState};\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse std::sync::Arc;\nuse std::sync::atomic::{AtomicBool, Ordering};\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tracing::info;\n\n/// Commands related to file watching functionality\n#[derive(Subcommand, Debug)]\npub enum WatchCmd {\n    /// Start watching a directory for changes\n    Start {\n        /// Directory to watch (defaults to current directory)\n        #[arg(default_value = \".\")]\n        path: PathBuf,\n        \n        /// Debounce window in milliseconds (default: 100ms)\n        #[arg(long, default_value = \"100\")]\n        debounce_ms: u64,\n    },\n    \n    /// Show status of currently active watcher\n    Status,\n    \n    /// Stop the currently running watcher\n    Stop,\n}\n\n/// Run a watch command\npub fn run(cmd: \u0026WatchCmd, _conn: \u0026mut Connection, _format: super::Format) -\u003e Result\u003c()\u003e {\n    match cmd {\n        WatchCmd::Start { path, debounce_ms } =\u003e {\n            let mut marlin = libmarlin::Marlin::open_default()?;\n            let config = WatcherConfig {\n                debounce_ms: *debounce_ms,\n                ..Default::default()\n            };\n            let canon_path = path.canonicalize().unwrap_or_else(|_| path.clone());\n            info!(\"Starting watcher for directory: {}\", canon_path.display());\n\n            let mut watcher = marlin.watch(\u0026canon_path, Some(config))?;\n            \n            let status = watcher.status();\n            info!(\"Watcher started. Press Ctrl+C to stop watching.\");\n            info!(\"Watching {} paths\", status.watched_paths.len());\n            \n            let start_time = Instant::now();\n            let mut last_status_time = Instant::now();\n            let running = Arc::new(AtomicBool::new(true));\n            let r_clone = running.clone();\n\n            ctrlc::set_handler(move || {\n                info!(\"Ctrl+C received. Signaling watcher to stop...\");\n                r_clone.store(false, Ordering::SeqCst);\n            })?;\n\n            info!(\"Watcher run loop started. Waiting for Ctrl+C or stop signal...\");\n            while running.load(Ordering::SeqCst) {\n                let current_status = watcher.status();\n                if current_status.state == WatcherState::Stopped {\n                    info!(\"Watcher has stopped (detected by state). Exiting loop.\");\n                    break;\n                }\n\n                // Corrected line: removed the extra closing parenthesis\n                if last_status_time.elapsed() \u003e Duration::from_secs(10) { \n                    let uptime = start_time.elapsed();\n                    info!(\n                        \"Watcher running for {}s, processed {} events, queue: {}, state: {:?}\",\n                        uptime.as_secs(),\n                        current_status.events_processed,\n                        current_status.queue_size,\n                        current_status.state\n                    );\n                    last_status_time = Instant::now();\n                }\n                thread::sleep(Duration::from_millis(200));\n            }\n\n            info!(\"Watcher run loop ended. Explicitly stopping watcher instance...\");\n            watcher.stop()?; \n            info!(\"Watcher instance fully stopped.\");\n            Ok(())\n        }\n        WatchCmd::Status =\u003e {\n            info!(\"Status command: No active watcher process to query in this CLI invocation model.\");\n            info!(\"To see live status, run 'marlin watch start' which prints periodic updates.\");\n            Ok(())\n        }\n        WatchCmd::Stop =\u003e {\n            info!(\"Stop command: No active watcher process to stop in this CLI invocation model.\");\n            info!(\"Please use Ctrl+C in the terminal where 'marlin watch start' is running.\");\n            Ok(())\n        }\n    }\n}","traces":[{"line":36,"address":[2346893,2347011,2338224],"length":1,"stats":{"Line":0}},{"line":37,"address":[2338281],"length":1,"stats":{"Line":0}},{"line":38,"address":[2338369],"length":1,"stats":{"Line":0}},{"line":39,"address":[2338397,2338535],"length":1,"stats":{"Line":0}},{"line":41,"address":[2338841],"length":1,"stats":{"Line":0}},{"line":44,"address":[2056512,2056533],"length":1,"stats":{"Line":0}},{"line":45,"address":[2339079,2339158,2339509],"length":1,"stats":{"Line":0}},{"line":47,"address":[2346982,2340089,2339423],"length":1,"stats":{"Line":0}},{"line":49,"address":[2340273],"length":1,"stats":{"Line":0}},{"line":50,"address":[2340708,2340336,2340412],"length":1,"stats":{"Line":0}},{"line":51,"address":[2340677,2341420,2341126],"length":1,"stats":{"Line":0}},{"line":53,"address":[2341391,2341936],"length":1,"stats":{"Line":0}},{"line":54,"address":[2341951],"length":1,"stats":{"Line":0}},{"line":55,"address":[2342012],"length":1,"stats":{"Line":0}},{"line":56,"address":[2342111,2342190],"length":1,"stats":{"Line":0}},{"line":58,"address":[2056624],"length":1,"stats":{"Line":0}},{"line":59,"address":[2056644,2056834],"length":1,"stats":{"Line":0}},{"line":60,"address":[2056794],"length":1,"stats":{"Line":0}},{"line":63,"address":[2342312,2342642],"length":1,"stats":{"Line":0}},{"line":64,"address":[2343061,2342612],"length":1,"stats":{"Line":0}},{"line":65,"address":[2343135],"length":1,"stats":{"Line":0}},{"line":66,"address":[2343162,2343242],"length":1,"stats":{"Line":0}},{"line":67,"address":[2344873,2344586,2343282],"length":1,"stats":{"Line":0}},{"line":72,"address":[2344526,2343328,2343248],"length":1,"stats":{"Line":0}},{"line":73,"address":[2343473],"length":1,"stats":{"Line":0}},{"line":74,"address":[2344056],"length":1,"stats":{"Line":0}},{"line":81,"address":[2343837,2344511],"length":1,"stats":{"Line":0}},{"line":83,"address":[2343448,2344546],"length":1,"stats":{"Line":0}},{"line":86,"address":[2343104,2345291,2345586],"length":1,"stats":{"Line":0}},{"line":87,"address":[2345556,2345999,2346866],"length":1,"stats":{"Line":0}},{"line":88,"address":[2346101,2346387],"length":1,"stats":{"Line":0}},{"line":89,"address":[2346353],"length":1,"stats":{"Line":0}},{"line":92,"address":[2347205,2347024,2338471],"length":1,"stats":{"Line":0}},{"line":93,"address":[2347173,2347740,2347574],"length":1,"stats":{"Line":0}},{"line":94,"address":[2347723],"length":1,"stats":{"Line":0}},{"line":97,"address":[2338503,2348290,2348109],"length":1,"stats":{"Line":0}},{"line":98,"address":[2348258,2348659,2348825],"length":1,"stats":{"Line":0}},{"line":99,"address":[2348808],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":38},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","cli.rs"],"content":"// src/cli.rs\n\npub mod link;\npub mod coll;\npub mod view;\npub mod state;\npub mod task;\npub mod remind;\npub mod annotate;\npub mod version;\npub mod event;\npub mod watch;\n\nuse clap::{Parser, Subcommand, ValueEnum};\nuse clap_complete::Shell;\n\n/// Output format for commands.\n#[derive(ValueEnum, Clone, Copy, Debug)]\npub enum Format {\n    Text,\n    Json,\n}\n\n/// Marlin – metadata-driven file explorer (CLI utilities)\n#[derive(Parser, Debug)]\n#[command(author, version, about, propagate_version = true)]\npub struct Cli {\n    /// Enable debug logging and extra output\n    #[arg(long)]\n    pub verbose: bool,\n\n    /// Output format (text or JSON)\n    #[arg(long, default_value = \"text\", value_enum, global = true)]\n    pub format: Format,\n\n    #[command(subcommand)]\n    pub command: Commands,\n}\n\n#[derive(Subcommand, Debug)]\npub enum Commands {\n    /// Initialise the database (idempotent)\n    Init,\n\n    /// Scan one or more directories and populate the file index\n    Scan {\n        /// Only re-index files marked dirty by `marlin watch`\n        #[arg(long)]\n        dirty: bool,\n\n        /// Directories to scan (defaults to cwd)\n        paths: Vec\u003cstd::path::PathBuf\u003e,\n    },\n\n    /// Tag files matching a glob pattern (hierarchical tags use `/`)\n    Tag {\n        /// Glob or path pattern\n        pattern: String,\n        /// Hierarchical tag name (`foo/bar`)\n        tag_path: String,\n    },\n\n    /// Manage custom attributes\n    Attr {\n        #[command(subcommand)]\n        action: AttrCmd,\n    },\n\n    /// Full-text search; `--exec CMD` runs CMD on each hit (`{}` placeholder)\n    Search {\n        query: String,\n        #[arg(long)]\n        exec: Option\u003cString\u003e,\n    },\n\n    /// Create a timestamped backup of the database\n    Backup,\n\n    /// Restore from a backup file (overwrites current DB)\n    Restore {\n        backup_path: std::path::PathBuf,\n    },\n\n    /// Generate shell completions (hidden)\n    #[command(hide = true)]\n    Completions {\n        /// Which shell to generate for\n        #[arg(value_enum)]\n        shell: Shell,\n    },\n\n    /// File-to-file links\n    #[command(subcommand)]\n    Link(link::LinkCmd),\n\n    /// Collections (groups) of files\n    #[command(subcommand)]\n    Coll(coll::CollCmd),\n\n    /// Smart views (saved queries)\n    #[command(subcommand)]\n    View(view::ViewCmd),\n\n    /// Workflow states on files\n    #[command(subcommand)]\n    State(state::StateCmd),\n\n    /// TODO/tasks management\n    #[command(subcommand)]\n    Task(task::TaskCmd),\n\n    /// Reminders on files\n    #[command(subcommand)]\n    Remind(remind::RemindCmd),\n\n    /// File annotations and highlights\n    #[command(subcommand)]\n    Annotate(annotate::AnnotateCmd),\n\n    /// Version diffs\n    #[command(subcommand)]\n    Version(version::VersionCmd),\n\n    /// Calendar events \u0026 timelines\n    #[command(subcommand)]\n    Event(event::EventCmd),\n\n    /// Watch directories for changes\n    #[command(subcommand)]\n    Watch(watch::WatchCmd),\n}\n\n#[derive(Subcommand, Debug)]\npub enum AttrCmd {\n    Set { pattern: String, key: String, value: String },\n    Ls  { path: std::path::PathBuf },\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","src","main.rs"],"content":"//! Marlin CLI entry-point (post crate-split)\n//!\n//! All heavy lifting now lives in the `libmarlin` crate; this file\n//! handles argument parsing, logging, orchestration and the few\n//! helpers that remain CLI-specific.\n\n#![deny(warnings)]\n\nmod cli; // sub-command definitions and argument structs\n\n/* ── shared modules re-exported from libmarlin ─────────────────── */\nuse libmarlin::{\n    config,\n    db,\n    logging,\n    scan,\n    utils::determine_scan_root,\n};\nuse libmarlin::db::take_dirty;\n\nuse anyhow::{Context, Result};\nuse clap::{CommandFactory, Parser};\nuse clap_complete::generate;\nuse glob::Pattern;\nuse shellexpand;\nuse shlex;\nuse std::{\n    env,\n    fs,\n    io,\n    path::Path,\n    process::Command,\n};\nuse tracing::{debug, error, info};\nuse walkdir::WalkDir;\n\nuse cli::{Cli, Commands};\n\nfn main() -\u003e Result\u003c()\u003e {\n    /* ── CLI parsing \u0026 logging ────────────────────────────────── */\n    let args = Cli::parse();\n    if args.verbose {\n        env::set_var(\"RUST_LOG\", \"debug\");\n    }\n    logging::init();\n\n    /* ── shell-completion shortcut ────────────────────────────── */\n    if let Commands::Completions { shell } = \u0026args.command {\n        let mut cmd = Cli::command();\n        generate(*shell, \u0026mut cmd, \"marlin\", \u0026mut io::stdout());\n        return Ok(());\n    }\n\n    /* ── config \u0026 automatic backup ───────────────────────────── */\n    let cfg = config::Config::load()?; // resolves DB path\n\n    match \u0026args.command {\n        Commands::Init | Commands::Backup | Commands::Restore { .. } =\u003e {}\n        _ =\u003e match db::backup(\u0026cfg.db_path) {\n            Ok(p)  =\u003e info!(\"Pre-command auto-backup created at {}\", p.display()),\n            Err(e) =\u003e error!(\"Failed to create pre-command auto-backup: {e}\"),\n        },\n    }\n\n    /* ── open DB (runs migrations) ───────────────────────────── */\n    let mut conn = db::open(\u0026cfg.db_path)?;\n\n    /* ── command dispatch ────────────────────────────────────── */\n    match args.command {\n        Commands::Completions { .. } =\u003e {} // handled above\n\n        /* ---- init ------------------------------------------------ */\n        Commands::Init =\u003e {\n            info!(\"Database initialised at {}\", cfg.db_path.display());\n            let cwd   = env::current_dir().context(\"getting current directory\")?;\n            let count = scan::scan_directory(\u0026mut conn, \u0026cwd)\n                .context(\"initial scan failed\")?;\n            info!(\"Initial scan complete – indexed/updated {count} files\");\n        }\n\n        /* ---- scan ------------------------------------------------ */\n        Commands::Scan { dirty, paths } =\u003e {\n            let scan_paths: Vec\u003cstd::path::PathBuf\u003e = if paths.is_empty() {\n                vec![env::current_dir()?]\n            } else {\n                paths.into_iter().collect()\n            };\n\n            if dirty {\n                let dirty_ids = take_dirty(\u0026conn)?;\n                for id in dirty_ids {\n                    let path: String = conn.query_row(\n                        \"SELECT path FROM files WHERE id = ?1\",\n                        [id],\n                        |r| r.get(0),\n                    )?;\n                    scan::scan_directory(\u0026mut conn, Path::new(\u0026path))?;\n                }\n            } else {\n                for p in scan_paths {\n                    scan::scan_directory(\u0026mut conn, \u0026p)?;\n                }\n            }\n        }\n\n        /* ---- tag / attribute / search --------------------------- */\n        Commands::Tag { pattern, tag_path } =\u003e\n            apply_tag(\u0026conn, \u0026pattern, \u0026tag_path)?,\n\n        Commands::Attr { action } =\u003e match action {\n            cli::AttrCmd::Set { pattern, key, value } =\u003e\n                attr_set(\u0026conn, \u0026pattern, \u0026key, \u0026value)?,\n            cli::AttrCmd::Ls { path } =\u003e\n                attr_ls(\u0026conn, \u0026path)?,\n        },\n\n        Commands::Search { query, exec } =\u003e\n            run_search(\u0026conn, \u0026query, exec)?,\n\n        /* ---- maintenance ---------------------------------------- */\n        Commands::Backup =\u003e {\n            let p = db::backup(\u0026cfg.db_path)?;\n            println!(\"Backup created: {}\", p.display());\n        }\n\n        Commands::Restore { backup_path } =\u003e {\n            drop(conn);\n            db::restore(\u0026backup_path, \u0026cfg.db_path).with_context(|| {\n                format!(\"Failed to restore DB from {}\", backup_path.display())\n            })?;\n            println!(\"Restored DB from {}\", backup_path.display());\n            db::open(\u0026cfg.db_path).with_context(|| {\n                format!(\"Could not open restored DB at {}\", cfg.db_path.display())\n            })?;\n            info!(\"Successfully opened restored database.\");\n        }\n\n        /* ---- passthrough sub-modules (some still stubs) ---------- */\n        Commands::Link(link_cmd)   =\u003e cli::link::run(\u0026link_cmd,   \u0026mut conn, args.format)?,\n        Commands::Coll(coll_cmd)   =\u003e cli::coll::run(\u0026coll_cmd,   \u0026mut conn, args.format)?,\n        Commands::View(view_cmd)   =\u003e cli::view::run(\u0026view_cmd,   \u0026mut conn, args.format)?,\n        Commands::State(state_cmd) =\u003e cli::state::run(\u0026state_cmd, \u0026mut conn, args.format)?,\n        Commands::Task(task_cmd)   =\u003e cli::task::run(\u0026task_cmd,   \u0026mut conn, args.format)?,\n        Commands::Remind(rm_cmd)   =\u003e cli::remind::run(\u0026rm_cmd,   \u0026mut conn, args.format)?,\n        Commands::Annotate(a_cmd)  =\u003e cli::annotate::run(\u0026a_cmd,  \u0026mut conn, args.format)?,\n        Commands::Version(v_cmd)   =\u003e cli::version::run(\u0026v_cmd,   \u0026mut conn, args.format)?,\n        Commands::Event(e_cmd)     =\u003e cli::event::run(\u0026e_cmd,     \u0026mut conn, args.format)?,\n        Commands::Watch(watch_cmd) =\u003e cli::watch::run(\u0026watch_cmd, \u0026mut conn, args.format)?,\n    }\n\n    Ok(())\n}\n\n/* ─────────────────── helpers \u0026 sub-routines ─────────────────── */\n\n/* ---------- TAGS ---------- */\nfn apply_tag(conn: \u0026rusqlite::Connection, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003c()\u003e {\n    let leaf_tag_id = db::ensure_tag_path(conn, tag_path)?;\n    let mut tag_ids = Vec::new();\n    let mut current = Some(leaf_tag_id);\n    while let Some(id) = current {\n        tag_ids.push(id);\n        current = conn.query_row(\n            \"SELECT parent_id FROM tags WHERE id=?1\",\n            [id],\n            |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n        )?;\n    }\n\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file   = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut stmt_insert = conn.prepare(\n        \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n    )?;\n\n    let mut count = 0usize;\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                let mut newly = false;\n                for \u0026tid in \u0026tag_ids {\n                    if stmt_insert.execute([fid, tid])? \u003e 0 {\n                        newly = true;\n                    }\n                }\n                if newly {\n                    info!(file=%p, tag=tag_path, \"tagged\");\n                    count += 1;\n                }\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Applied tag '{}' to {} file(s).\", tag_path, count);\n    Ok(())\n}\n\n/* ---------- ATTRIBUTES ---------- */\nfn attr_set(conn: \u0026rusqlite::Connection, pattern: \u0026str, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    let expanded = shellexpand::tilde(pattern).into_owned();\n    let pat  = Pattern::new(\u0026expanded)\n        .with_context(|| format!(\"Invalid glob pattern `{expanded}`\"))?;\n    let root = determine_scan_root(\u0026expanded);\n\n    let mut stmt_file = conn.prepare(\"SELECT id FROM files WHERE path=?1\")?;\n    let mut count = 0usize;\n\n    for entry in WalkDir::new(\u0026root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let p = entry.path().to_string_lossy();\n        if !pat.matches(\u0026p) { continue; }\n\n        match stmt_file.query_row([p.as_ref()], |r| r.get::\u003c_, i64\u003e(0)) {\n            Ok(fid) =\u003e {\n                db::upsert_attr(conn, fid, key, value)?;\n                info!(file=%p, key, value, \"attr set\");\n                count += 1;\n            }\n            Err(rusqlite::Error::QueryReturnedNoRows) =\u003e\n                error!(file=%p, \"not indexed – run `marlin scan` first\"),\n            Err(e) =\u003e\n                error!(file=%p, error=%e, \"could not lookup file ID\"),\n        }\n    }\n\n    info!(\"Attribute '{}={}' set on {} file(s).\", key, value, count);\n    Ok(())\n}\n\nfn attr_ls(conn: \u0026rusqlite::Connection, path: \u0026Path) -\u003e Result\u003c()\u003e {\n    let fid = db::file_id(conn, \u0026path.to_string_lossy())?;\n    let mut stmt = conn.prepare(\n        \"SELECT key, value FROM attributes WHERE file_id=?1 ORDER BY key\"\n    )?;\n    for row in stmt\n        .query_map([fid], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?\n    {\n        let (k, v) = row?;\n        println!(\"{k} = {v}\");\n    }\n    Ok(())\n}\n\n/* ---------- SEARCH ---------- */\nfn run_search(conn: \u0026rusqlite::Connection, raw_query: \u0026str, exec: Option\u003cString\u003e) -\u003e Result\u003c()\u003e {\n    let mut parts = Vec::new();\n    let toks = shlex::split(raw_query).unwrap_or_else(|| vec![raw_query.to_string()]);\n    for tok in toks {\n        if [\"AND\", \"OR\", \"NOT\"].contains(\u0026tok.as_str()) {\n            parts.push(tok);\n        } else if let Some(tag) = tok.strip_prefix(\"tag:\") {\n            for (i, seg) in tag.split('/').filter(|s| !s.is_empty()).enumerate() {\n                if i \u003e 0 { parts.push(\"AND\".into()); }\n                parts.push(format!(\"tags_text:{}\", escape_fts(seg)));\n            }\n        } else if let Some(attr) = tok.strip_prefix(\"attr:\") {\n            let mut kv = attr.splitn(2, '=');\n            let key = kv.next().unwrap();\n            if let Some(val) = kv.next() {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n                parts.push(\"AND\".into());\n                parts.push(format!(\"attrs_text:{}\", escape_fts(val)));\n            } else {\n                parts.push(format!(\"attrs_text:{}\", escape_fts(key)));\n            }\n        } else {\n            parts.push(escape_fts(\u0026tok));\n        }\n    }\n    let fts_expr = parts.join(\" \");\n    debug!(\"FTS MATCH expression: {fts_expr}\");\n\n    let mut stmt = conn.prepare(\n        r#\"\n        SELECT f.path\n          FROM files_fts\n          JOIN files f ON f.rowid = files_fts.rowid\n         WHERE files_fts MATCH ?1\n         ORDER BY rank\n        \"#,\n    )?;\n    let mut hits: Vec\u003cString\u003e = stmt\n        .query_map([\u0026fts_expr], |r| r.get::\u003c_, String\u003e(0))?\n        .filter_map(Result::ok)\n        .collect();\n\n    if hits.is_empty() \u0026\u0026 !raw_query.contains(':') {\n        hits = naive_substring_search(conn, raw_query)?;\n    }\n\n    if let Some(cmd_tpl) = exec {\n        run_exec(\u0026hits, \u0026cmd_tpl)?;\n    } else {\n        if hits.is_empty() {\n            eprintln!(\n                \"No matches for query: `{raw_query}` (FTS expr: `{fts_expr}`)\"\n            );\n        } else {\n            for p in hits { println!(\"{p}\"); }\n        }\n    }\n    Ok(())\n}\n\nfn naive_substring_search(conn: \u0026rusqlite::Connection, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let needle = term.to_lowercase();\n    let mut stmt = conn.prepare(\"SELECT path FROM files\")?;\n    let rows = stmt.query_map([], |r| r.get::\u003c_, String\u003e(0))?;\n\n    let mut out = Vec::new();\n    for p in rows {\n        let p = p?;\n        if p.to_lowercase().contains(\u0026needle) {\n            out.push(p.clone());\n            continue;\n        }\n        if let Ok(meta) = fs::metadata(\u0026p) {\n            if meta.len() \u003e 65_536 { continue; }\n        }\n        if let Ok(body) = fs::read_to_string(\u0026p) {\n            if body.to_lowercase().contains(\u0026needle) {\n                out.push(p);\n            }\n        }\n    }\n    Ok(out)\n}\n\nfn run_exec(paths: \u0026[String], cmd_tpl: \u0026str) -\u003e Result\u003c()\u003e {\n    let mut ran_without_placeholder = false;\n\n    if paths.is_empty() \u0026\u0026 !cmd_tpl.contains(\"{}\") {\n        if let Some(mut parts) = shlex::split(cmd_tpl) {\n            if !parts.is_empty() {\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(command=%cmd_tpl, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n        ran_without_placeholder = true;\n    }\n\n    if !ran_without_placeholder {\n        for p in paths {\n            let quoted = shlex::try_quote(p).unwrap_or_else(|_| p.into());\n            let final_cmd = if cmd_tpl.contains(\"{}\") {\n                cmd_tpl.replace(\"{}\", \u0026quoted)\n            } else {\n                format!(\"{cmd_tpl} {quoted}\")\n            };\n            if let Some(mut parts) = shlex::split(\u0026final_cmd) {\n                if parts.is_empty() { continue; }\n                let prog = parts.remove(0);\n                let status = Command::new(\u0026prog).args(parts).status()?;\n                if !status.success() {\n                    error!(file=%p, command=%final_cmd, code=?status.code(), \"command failed\");\n                }\n            }\n        }\n    }\n    Ok(())\n}\n\nfn escape_fts(term: \u0026str) -\u003e String {\n    if term.contains(|c: char| c.is_whitespace() || \"-:()\\\"\".contains(c))\n        || [\"AND\", \"OR\", \"NOT\", \"NEAR\"].contains(\u0026term.to_uppercase().as_str())\n    {\n        format!(\"\\\"{}\\\"\", term.replace('\"', \"\\\"\\\"\"))\n    } else {\n        term.to_string()\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use assert_cmd::Command;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_help_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--help\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"Usage: marlin\"));\n    }\n\n    #[test]\n    fn test_version_command() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"--version\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"marlin-cli 0.1.0\"));\n    }\n\n    #[test]\n    fn test_verbose_logging() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"--verbose\").arg(\"init\");\n        let output = cmd.output().unwrap();\n        assert!(output.status.success());\n        let stderr = String::from_utf8_lossy(\u0026output.stderr);\n        assert!(\n            stderr.contains(\"DEBUG\"),\n            \"Expected debug logs in stderr, got: {}\",\n            stderr\n        );\n    }\n\n    #[test]\n    fn test_shell_completions() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"completions\").arg(\"bash\");\n        cmd.assert()\n            .success()\n            .stdout(predicates::str::contains(\"_marlin()\"))\n            .stdout(predicates::str::contains(\"init\"))\n            .stdout(predicates::str::contains(\"scan\"));\n    }\n\n    #[test]\n    fn test_invalid_subcommand() {\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.arg(\"invalid_cmd\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"error: unrecognized subcommand\"));\n    }\n\n    #[test]\n    fn test_init_command() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd.arg(\"init\");\n        cmd.assert().success();\n        assert!(db_path.exists(), \"Database file should exist after init\");\n    }\n\n    #[test]\n    fn test_automatic_backup() {\n        let tmp = tempdir().unwrap();\n        let db_path = tmp.path().join(\"index.db\");\n        let backups_dir = tmp.path().join(\"backups\");\n\n        // Init: no backup\n        let mut cmd_init = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_init.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_init.arg(\"init\");\n        cmd_init.assert().success();\n        assert!(\n            !backups_dir.exists() || backups_dir.read_dir().unwrap().next().is_none(),\n            \"No backup should be created for init\"\n        );\n\n        // Scan: backup created\n        let mut cmd_scan = Command::cargo_bin(\"marlin\").unwrap();\n        cmd_scan.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        cmd_scan.arg(\"scan\");\n        cmd_scan.assert().success();\n        assert!(backups_dir.exists(), \"Backups directory should exist after scan\");\n        let backups: Vec\u003c_\u003e = backups_dir.read_dir().unwrap().collect();\n        assert_eq!(backups.len(), 1, \"One backup should be created for scan\");\n    }\n\n    #[test]\n    fn test_annotate_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"annotate\").arg(\"add\").arg(\"file.txt\").arg(\"note\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n\n    #[test]\n    fn test_event_stub() {\n        let tmp = tempdir().unwrap();\n        let mut cmd = Command::cargo_bin(\"marlin\").unwrap();\n        cmd.env(\"MARLIN_DB_PATH\", tmp.path().join(\"index.db\"));\n        cmd.arg(\"event\").arg(\"add\").arg(\"file.txt\").arg(\"2025-05-20\").arg(\"desc\");\n        cmd.assert()\n            .failure()\n            .stderr(predicates::str::contains(\"not yet implemented\"));\n    }\n}\n","traces":[{"line":39,"address":[2201872,2218682,2202655],"length":1,"stats":{"Line":0}},{"line":41,"address":[2201894],"length":1,"stats":{"Line":0}},{"line":42,"address":[2202219],"length":1,"stats":{"Line":0}},{"line":43,"address":[2202346,2202240],"length":1,"stats":{"Line":0}},{"line":45,"address":[2202229],"length":1,"stats":{"Line":0}},{"line":48,"address":[2202348],"length":1,"stats":{"Line":0}},{"line":49,"address":[2202394],"length":1,"stats":{"Line":0}},{"line":50,"address":[2202518,2202431],"length":1,"stats":{"Line":0}},{"line":51,"address":[2202571],"length":1,"stats":{"Line":0}},{"line":55,"address":[2202661,2218129,2202401],"length":1,"stats":{"Line":0}},{"line":57,"address":[2202834],"length":1,"stats":{"Line":0}},{"line":59,"address":[2202893,2202974],"length":1,"stats":{"Line":0}},{"line":60,"address":[2203058],"length":1,"stats":{"Line":0}},{"line":61,"address":[2203011,2204020],"length":1,"stats":{"Line":0}},{"line":66,"address":[2202900,2204816,2218111],"length":1,"stats":{"Line":0}},{"line":69,"address":[2205102],"length":1,"stats":{"Line":0}},{"line":74,"address":[2206936,2205144,2207223],"length":1,"stats":{"Line":0}},{"line":75,"address":[2209168,2207201,2207787],"length":1,"stats":{"Line":0}},{"line":76,"address":[2207999,2208082,2209114,2208269],"length":1,"stats":{"Line":0}},{"line":78,"address":[2208644,2208322],"length":1,"stats":{"Line":0}},{"line":82,"address":[2205175],"length":1,"stats":{"Line":0}},{"line":83,"address":[2209226,2209760,2205244],"length":1,"stats":{"Line":0}},{"line":84,"address":[2211968,2209383,2209309,2211871],"length":1,"stats":{"Line":0}},{"line":86,"address":[2209232,2209340],"length":1,"stats":{"Line":0}},{"line":89,"address":[2209362,2211077],"length":1,"stats":{"Line":0}},{"line":90,"address":[2209832,2210525,2211788],"length":1,"stats":{"Line":0}},{"line":91,"address":[2210686,2210790,2210941],"length":1,"stats":{"Line":0}},{"line":92,"address":[2211735,2210995,2211281,2211153],"length":1,"stats":{"Line":0}},{"line":94,"address":[2210987],"length":1,"stats":{"Line":0}},{"line":95,"address":[2298256,2298240],"length":1,"stats":{"Line":0}},{"line":97,"address":[2211685,2211382,2211477],"length":1,"stats":{"Line":0}},{"line":100,"address":[2209765,2209903,2210038],"length":1,"stats":{"Line":0}},{"line":101,"address":[2210236,2210115,2210444],"length":1,"stats":{"Line":0}},{"line":107,"address":[2205273],"length":1,"stats":{"Line":0}},{"line":108,"address":[2212000,2205361],"length":1,"stats":{"Line":0}},{"line":110,"address":[2205387],"length":1,"stats":{"Line":0}},{"line":111,"address":[2212486],"length":1,"stats":{"Line":0}},{"line":112,"address":[2212590],"length":1,"stats":{"Line":0}},{"line":113,"address":[2212420],"length":1,"stats":{"Line":0}},{"line":114,"address":[2213200,2212460],"length":1,"stats":{"Line":0}},{"line":117,"address":[2205471],"length":1,"stats":{"Line":0}},{"line":118,"address":[2213459,2205567],"length":1,"stats":{"Line":0}},{"line":122,"address":[2205609,2214261,2213836],"length":1,"stats":{"Line":0}},{"line":123,"address":[2214080,2213997],"length":1,"stats":{"Line":0}},{"line":126,"address":[2205619],"length":1,"stats":{"Line":0}},{"line":127,"address":[2205659],"length":1,"stats":{"Line":0}},{"line":128,"address":[2214334,2214470,2215831],"length":1,"stats":{"Line":0}},{"line":129,"address":[2298310],"length":1,"stats":{"Line":0}},{"line":131,"address":[2214507],"length":1,"stats":{"Line":0}},{"line":132,"address":[2215793,2214812,2214697],"length":1,"stats":{"Line":0}},{"line":133,"address":[2298486],"length":1,"stats":{"Line":0}},{"line":135,"address":[2215052,2215374],"length":1,"stats":{"Line":0}},{"line":139,"address":[2205812,2215849],"length":1,"stats":{"Line":0}},{"line":140,"address":[2205942,2216057],"length":1,"stats":{"Line":0}},{"line":141,"address":[2206040,2216265],"length":1,"stats":{"Line":0}},{"line":142,"address":[2206138,2216467],"length":1,"stats":{"Line":0}},{"line":143,"address":[2216663,2206252],"length":1,"stats":{"Line":0}},{"line":144,"address":[2216859,2206334],"length":1,"stats":{"Line":0}},{"line":145,"address":[2217055,2206464],"length":1,"stats":{"Line":0}},{"line":146,"address":[2217251,2206594],"length":1,"stats":{"Line":0}},{"line":147,"address":[2217447,2206676],"length":1,"stats":{"Line":0}},{"line":148,"address":[2217643,2218006,2206806],"length":1,"stats":{"Line":0}},{"line":151,"address":[2205781],"length":1,"stats":{"Line":0}},{"line":157,"address":[2227697,2219744,2227856],"length":1,"stats":{"Line":0}},{"line":158,"address":[2219830],"length":1,"stats":{"Line":0}},{"line":159,"address":[2219968],"length":1,"stats":{"Line":0}},{"line":160,"address":[2219990],"length":1,"stats":{"Line":0}},{"line":161,"address":[2220010,2220441],"length":1,"stats":{"Line":0}},{"line":162,"address":[2220048],"length":1,"stats":{"Line":0}},{"line":163,"address":[2220454,2220180,2220359],"length":1,"stats":{"Line":0}},{"line":165,"address":[2220172],"length":1,"stats":{"Line":0}},{"line":166,"address":[2298640,2298656],"length":1,"stats":{"Line":0}},{"line":170,"address":[2220481,2220090],"length":1,"stats":{"Line":0}},{"line":171,"address":[2220599,2220516,2227846,2220729],"length":1,"stats":{"Line":0}},{"line":172,"address":[2220713],"length":1,"stats":{"Line":0}},{"line":173,"address":[2220977,2220894],"length":1,"stats":{"Line":0}},{"line":175,"address":[2221004,2221075,2227787],"length":1,"stats":{"Line":0}},{"line":176,"address":[2221473,2221595,2221402,2227747],"length":1,"stats":{"Line":0}},{"line":180,"address":[2221792],"length":1,"stats":{"Line":0}},{"line":181,"address":[2221871,2222060,2221820],"length":1,"stats":{"Line":0}},{"line":184,"address":[2298816,2298843],"length":1,"stats":{"Line":0}},{"line":186,"address":[2222145,2223211],"length":1,"stats":{"Line":0}},{"line":187,"address":[2223313,2223218],"length":1,"stats":{"Line":0}},{"line":189,"address":[2223444,2223371],"length":1,"stats":{"Line":0}},{"line":190,"address":[2223585],"length":1,"stats":{"Line":0}},{"line":191,"address":[2223609],"length":1,"stats":{"Line":0}},{"line":192,"address":[2223617,2223712],"length":1,"stats":{"Line":0}},{"line":193,"address":[2225104,2225300,2223829],"length":1,"stats":{"Line":0}},{"line":194,"address":[2225292],"length":1,"stats":{"Line":0}},{"line":197,"address":[2225079,2223883],"length":1,"stats":{"Line":0}},{"line":198,"address":[2223915,2224249],"length":1,"stats":{"Line":0}},{"line":199,"address":[2225084,2224215,2225071],"length":1,"stats":{"Line":0}},{"line":203,"address":[2225489,2225627],"length":1,"stats":{"Line":0}},{"line":204,"address":[2225517],"length":1,"stats":{"Line":0}},{"line":205,"address":[2226490,2225589],"length":1,"stats":{"Line":0}},{"line":209,"address":[2222198,2222532],"length":1,"stats":{"Line":0}},{"line":210,"address":[2222498],"length":1,"stats":{"Line":0}},{"line":214,"address":[2234849,2227872,2234730],"length":1,"stats":{"Line":0}},{"line":215,"address":[2227966],"length":1,"stats":{"Line":0}},{"line":216,"address":[2228253,2234839,2228040,2228123],"length":1,"stats":{"Line":0}},{"line":217,"address":[2228237],"length":1,"stats":{"Line":0}},{"line":218,"address":[2228501,2228418],"length":1,"stats":{"Line":0}},{"line":220,"address":[2228528,2228599,2234780],"length":1,"stats":{"Line":0}},{"line":221,"address":[2228918],"length":1,"stats":{"Line":0}},{"line":223,"address":[2228946,2228997,2229186],"length":1,"stats":{"Line":0}},{"line":226,"address":[2299083,2299056],"length":1,"stats":{"Line":0}},{"line":228,"address":[2230342,2229271],"length":1,"stats":{"Line":0}},{"line":229,"address":[2230444,2230349],"length":1,"stats":{"Line":0}},{"line":231,"address":[2230502,2230575],"length":1,"stats":{"Line":0}},{"line":232,"address":[2230724],"length":1,"stats":{"Line":0}},{"line":233,"address":[2230843,2230740,2232346],"length":1,"stats":{"Line":0}},{"line":234,"address":[2231288,2230954],"length":1,"stats":{"Line":0}},{"line":235,"address":[2232286,2232296,2231254],"length":1,"stats":{"Line":0}},{"line":238,"address":[2232660,2232522],"length":1,"stats":{"Line":0}},{"line":239,"address":[2232550],"length":1,"stats":{"Line":0}},{"line":240,"address":[2233523,2232622],"length":1,"stats":{"Line":0}},{"line":244,"address":[2229658,2229324],"length":1,"stats":{"Line":0}},{"line":245,"address":[2229624],"length":1,"stats":{"Line":0}},{"line":248,"address":[2236624,2236563,2234864],"length":1,"stats":{"Line":0}},{"line":249,"address":[2236642,2234913],"length":1,"stats":{"Line":0}},{"line":250,"address":[2235171,2235279],"length":1,"stats":{"Line":0}},{"line":253,"address":[2236617,2235483,2235698,2235590,2235870],"length":1,"stats":{"Line":0}},{"line":254,"address":[2235475,2235634],"length":1,"stats":{"Line":0}},{"line":256,"address":[2235971,2236049,2236573],"length":1,"stats":{"Line":0}},{"line":257,"address":[2236366,2236295],"length":1,"stats":{"Line":0}},{"line":259,"address":[2236013],"length":1,"stats":{"Line":0}},{"line":263,"address":[2243587,2239914,2236672],"length":1,"stats":{"Line":0}},{"line":264,"address":[2236719],"length":1,"stats":{"Line":0}},{"line":265,"address":[2236915,2236839],"length":1,"stats":{"Line":0}},{"line":266,"address":[2237123,2243531,2236961],"length":1,"stats":{"Line":0}},{"line":267,"address":[2237208,2240934],"length":1,"stats":{"Line":0}},{"line":268,"address":[2241032,2243518],"length":1,"stats":{"Line":0}},{"line":269,"address":[2241009,2241125],"length":1,"stats":{"Line":0}},{"line":270,"address":[2241259,2241333],"length":1,"stats":{"Line":0}},{"line":271,"address":[2241527,2241582],"length":1,"stats":{"Line":0}},{"line":272,"address":[2241575,2241656],"length":1,"stats":{"Line":0}},{"line":274,"address":[2241291,2241977],"length":1,"stats":{"Line":0}},{"line":275,"address":[2242099],"length":1,"stats":{"Line":0}},{"line":276,"address":[2242157],"length":1,"stats":{"Line":0}},{"line":277,"address":[2242266],"length":1,"stats":{"Line":0}},{"line":278,"address":[2242447,2242412],"length":1,"stats":{"Line":0}},{"line":279,"address":[2242747],"length":1,"stats":{"Line":0}},{"line":280,"address":[2242837],"length":1,"stats":{"Line":0}},{"line":282,"address":[2243149,2242437],"length":1,"stats":{"Line":0}},{"line":285,"address":[2242137,2243472],"length":1,"stats":{"Line":0}},{"line":288,"address":[2237253],"length":1,"stats":{"Line":0}},{"line":289,"address":[2237336,2237415,2237718],"length":1,"stats":{"Line":0}},{"line":291,"address":[2238180,2238302,2240771,2237688],"length":1,"stats":{"Line":0}},{"line":300,"address":[2238730,2238515,2238622,2240731],"length":1,"stats":{"Line":0}},{"line":301,"address":[2238507,2238666],"length":1,"stats":{"Line":0}},{"line":305,"address":[2238990,2238935,2238861,2239380],"length":1,"stats":{"Line":0}},{"line":306,"address":[2239393,2239050],"length":1,"stats":{"Line":0}},{"line":309,"address":[2239431,2238949],"length":1,"stats":{"Line":0}},{"line":310,"address":[2239854,2239462,2239610],"length":1,"stats":{"Line":0}},{"line":312,"address":[2239497,2239927],"length":1,"stats":{"Line":0}},{"line":313,"address":[2240418,2240000],"length":1,"stats":{"Line":0}},{"line":317,"address":[2239933,2240030],"length":1,"stats":{"Line":0}},{"line":320,"address":[2239815],"length":1,"stats":{"Line":0}},{"line":323,"address":[2246596,2245619,2243632],"length":1,"stats":{"Line":0}},{"line":324,"address":[2243713],"length":1,"stats":{"Line":0}},{"line":325,"address":[2243833,2243762,2246594],"length":1,"stats":{"Line":0}},{"line":326,"address":[2246573,2244168,2244235],"length":1,"stats":{"Line":0}},{"line":328,"address":[2244436],"length":1,"stats":{"Line":0}},{"line":329,"address":[2244496,2246324,2244588,2244664],"length":1,"stats":{"Line":0}},{"line":330,"address":[2244930,2244765],"length":1,"stats":{"Line":0}},{"line":331,"address":[2245219,2245148],"length":1,"stats":{"Line":0}},{"line":332,"address":[2246407],"length":1,"stats":{"Line":0}},{"line":335,"address":[2245498,2245388],"length":1,"stats":{"Line":0}},{"line":336,"address":[2245566,2245505],"length":1,"stats":{"Line":0}},{"line":338,"address":[2245625,2245716],"length":1,"stats":{"Line":0}},{"line":339,"address":[2245835,2245764],"length":1,"stats":{"Line":0}},{"line":340,"address":[2246023],"length":1,"stats":{"Line":0}},{"line":344,"address":[2244818],"length":1,"stats":{"Line":0}},{"line":347,"address":[2246624,2248773,2248808],"length":1,"stats":{"Line":0}},{"line":348,"address":[2246679],"length":1,"stats":{"Line":0}},{"line":350,"address":[2248866,2246748,2246719],"length":1,"stats":{"Line":0}},{"line":351,"address":[2248787,2246786],"length":1,"stats":{"Line":0}},{"line":352,"address":[2246909,2247029],"length":1,"stats":{"Line":0}},{"line":353,"address":[2247035],"length":1,"stats":{"Line":0}},{"line":354,"address":[2248695,2247104,2247155],"length":1,"stats":{"Line":0}},{"line":355,"address":[2247428],"length":1,"stats":{"Line":0}},{"line":356,"address":[2247512,2247455],"length":1,"stats":{"Line":0}},{"line":360,"address":[2248858],"length":1,"stats":{"Line":0}},{"line":363,"address":[2246729],"length":1,"stats":{"Line":0}},{"line":364,"address":[2248903,2248944,2251960],"length":1,"stats":{"Line":0}},{"line":365,"address":[2249013],"length":1,"stats":{"Line":0}},{"line":366,"address":[2249187,2249090],"length":1,"stats":{"Line":0}},{"line":367,"address":[2249450,2249220],"length":1,"stats":{"Line":0}},{"line":369,"address":[2249193,2249258],"length":1,"stats":{"Line":0}},{"line":371,"address":[2251542,2249566,2249411],"length":1,"stats":{"Line":0}},{"line":372,"address":[2249678,2249774],"length":1,"stats":{"Line":0}},{"line":373,"address":[2249780],"length":1,"stats":{"Line":0}},{"line":374,"address":[2251552,2249903,2249852],"length":1,"stats":{"Line":0}},{"line":375,"address":[2250173],"length":1,"stats":{"Line":0}},{"line":376,"address":[2250194,2250245],"length":1,"stats":{"Line":0}},{"line":381,"address":[2248927],"length":1,"stats":{"Line":0}},{"line":384,"address":[2252032,2252394,2252400],"length":1,"stats":{"Line":0}},{"line":385,"address":[2252091],"length":1,"stats":{"Line":0}},{"line":386,"address":[2252365,2252110,2252228],"length":1,"stats":{"Line":0}},{"line":388,"address":[2252413,2252161],"length":1,"stats":{"Line":0}},{"line":390,"address":[2252357],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":201},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","e2e.rs"],"content":"//! tests e2e.rs\n//! End-to-end “happy path” smoke-tests for the `marlin` binary.\n//!\n//! Run with `cargo test --test e2e` (CI does) or `cargo test`.\n\nuse assert_cmd::prelude::*;\nuse predicates::prelude::*;\nuse std::{fs, path::PathBuf, process::Command};\nuse tempfile::tempdir;\n\n/// Absolute path to the freshly-built `marlin` binary.\nfn marlin_bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Create the demo directory structure and seed files.\nfn spawn_demo_tree(root: \u0026PathBuf) {\n    fs::create_dir_all(root.join(\"Projects/Alpha\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Beta\")).unwrap();\n    fs::create_dir_all(root.join(\"Projects/Gamma\")).unwrap();\n    fs::create_dir_all(root.join(\"Logs\")).unwrap();\n    fs::create_dir_all(root.join(\"Reports\")).unwrap();\n\n    fs::write(root.join(\"Projects/Alpha/draft1.md\"), \"- [ ] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Alpha/draft2.md\"), \"- [x] TODO foo\\n\").unwrap();\n    fs::write(root.join(\"Projects/Beta/final.md\"), \"done\\n\").unwrap();\n    fs::write(root.join(\"Projects/Gamma/TODO.txt\"), \"TODO bar\\n\").unwrap();\n    fs::write(root.join(\"Logs/app.log\"),           \"ERROR omg\\n\").unwrap();\n    fs::write(root.join(\"Reports/Q1.pdf\"),         \"PDF\\n\").unwrap();\n}\n\n/// Shorthand for “run and must succeed”.\nfn ok(cmd: \u0026mut Command) -\u003e assert_cmd::assert::Assert {\n    cmd.assert().success()\n}\n\n#[test]\nfn full_cli_flow() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\n    /* ── 1 ░ sandbox ───────────────────────────────────────────── */\n\n    let tmp      = tempdir()?;                 // wiped on drop\n    let demo_dir = tmp.path().join(\"marlin_demo\");\n    spawn_demo_tree(\u0026demo_dir);\n\n    let db_path = demo_dir.join(\"index.db\");\n\n    // Helper to spawn a fresh `marlin` Command with the DB env-var set\n    let marlin = || {\n        let mut c = Command::new(marlin_bin());\n        c.env(\"MARLIN_DB_PATH\", \u0026db_path);\n        c\n    };\n\n    /* ── 2 ░ init ( auto-scan cwd ) ───────────────────────────── */\n\n    ok(marlin()\n        .current_dir(\u0026demo_dir)\n        .arg(\"init\"));\n\n    /* ── 3 ░ tag \u0026 attr demos ─────────────────────────────────── */\n\n    ok(marlin()\n        .arg(\"tag\")\n        .arg(format!(\"{}/Projects/**/*.md\", demo_dir.display()))\n        .arg(\"project/md\"));\n\n    ok(marlin()\n        .arg(\"attr\")\n        .arg(\"set\")\n        .arg(format!(\"{}/Reports/*.pdf\", demo_dir.display()))\n        .arg(\"reviewed\")\n        .arg(\"yes\"));\n\n    /* ── 4 ░ quick search sanity checks ───────────────────────── */\n\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    marlin()\n        .arg(\"search\").arg(\"attr:reviewed=yes\")\n        .assert()\n        .stdout(predicate::str::contains(\"Q1.pdf\"));\n\n    /* ── 5 ░ link flow \u0026 backlinks ────────────────────────────── */\n\n    let foo = demo_dir.join(\"foo.txt\");\n    let bar = demo_dir.join(\"bar.txt\");\n    fs::write(\u0026foo, \"\")?;\n    fs::write(\u0026bar, \"\")?;\n\n    ok(marlin().arg(\"scan\").arg(\u0026demo_dir));\n\n    ok(marlin()\n        .arg(\"link\").arg(\"add\")\n        .arg(\u0026foo).arg(\u0026bar));\n\n    marlin()\n        .arg(\"link\").arg(\"backlinks\").arg(\u0026bar)\n        .assert()\n        .stdout(predicate::str::contains(\"foo.txt\"));\n\n    /* ── 6 ░ backup → delete DB → restore ────────────────────── */\n\n    let backup_path = String::from_utf8(\n        marlin().arg(\"backup\").output()?.stdout\n    )?;\n    let backup_file = backup_path.split_whitespace().last().unwrap();\n\n    fs::remove_file(\u0026db_path)?;                        // simulate corruption\n    ok(marlin().arg(\"restore\").arg(backup_file));      // restore\n\n    // Search must still work afterwards\n    marlin()\n        .arg(\"search\").arg(\"TODO\")\n        .assert()\n        .stdout(predicate::str::contains(\"TODO.txt\"));\n\n    Ok(())\n}\n\n","traces":[{"line":12,"address":[789200],"length":1,"stats":{"Line":1}},{"line":13,"address":[789208],"length":1,"stats":{"Line":1}},{"line":17,"address":[789232],"length":1,"stats":{"Line":1}},{"line":18,"address":[789251],"length":1,"stats":{"Line":1}},{"line":19,"address":[789312],"length":1,"stats":{"Line":1}},{"line":20,"address":[789373],"length":1,"stats":{"Line":1}},{"line":21,"address":[789434],"length":1,"stats":{"Line":1}},{"line":22,"address":[789495],"length":1,"stats":{"Line":1}},{"line":24,"address":[789556],"length":1,"stats":{"Line":1}},{"line":25,"address":[789635],"length":1,"stats":{"Line":1}},{"line":26,"address":[789714],"length":1,"stats":{"Line":1}},{"line":27,"address":[789793],"length":1,"stats":{"Line":1}},{"line":28,"address":[789872],"length":1,"stats":{"Line":1}},{"line":29,"address":[789951],"length":1,"stats":{"Line":1}},{"line":33,"address":[790048],"length":1,"stats":{"Line":1}},{"line":34,"address":[790066],"length":1,"stats":{"Line":1}}],"covered":16,"coverable":16},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","integration","watcher","watcher_test.rs"],"content":"//! Integration test for the file watcher functionality\n//! \n//! Tests various aspects of the file system watcher including:\n//! - Basic event handling (create, modify, delete files)\n//! - Debouncing of events\n//! - Hierarchical event coalescing\n//! - Graceful shutdown and event draining\n\nuse marlin::watcher::{FileWatcher, WatcherConfig, WatcherState};\nuse std::path::{Path, PathBuf};\nuse std::fs::{self, File};\nuse std::io::Write;\nuse std::thread;\nuse std::time::{Duration, Instant};\nuse tempfile::tempdir;\n\n// Mock filesystem event simulator inspired by inotify-sim\nstruct MockEventSimulator {\n    temp_dir: PathBuf,\n    files_created: Vec\u003cPathBuf\u003e,\n}\n\nimpl MockEventSimulator {\n    fn new(temp_dir: PathBuf) -\u003e Self {\n        Self {\n            temp_dir,\n            files_created: Vec::new(),\n        }\n    }\n\n    fn create_file(\u0026mut self, relative_path: \u0026str, content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        if let Some(parent) = path.parent() {\n            fs::create_dir_all(parent).expect(\"Failed to create parent directory\");\n        }\n        \n        let mut file = File::create(\u0026path).expect(\"Failed to create file\");\n        file.write_all(content.as_bytes()).expect(\"Failed to write content\");\n        \n        self.files_created.push(path.clone());\n        path\n    }\n    \n    fn modify_file(\u0026self, relative_path: \u0026str, new_content: \u0026str) -\u003e PathBuf {\n        let path = self.temp_dir.join(relative_path);\n        let mut file = File::create(\u0026path).expect(\"Failed to update file\");\n        file.write_all(new_content.as_bytes()).expect(\"Failed to write content\");\n        path\n    }\n    \n    fn delete_file(\u0026mut self, relative_path: \u0026str) {\n        let path = self.temp_dir.join(relative_path);\n        fs::remove_file(\u0026path).expect(\"Failed to delete file\");\n        \n        self.files_created.retain(|p| p != \u0026path);\n    }\n    \n    fn create_burst(\u0026mut self, count: usize, prefix: \u0026str) -\u003e Vec\u003cPathBuf\u003e {\n        let mut paths = Vec::with_capacity(count);\n        \n        for i in 0..count {\n            let file_path = format!(\"{}/burst_file_{}.txt\", prefix, i);\n            let path = self.create_file(\u0026file_path, \u0026format!(\"Content {}\", i));\n            paths.push(path);\n            \n            // Small delay to simulate rapid but not instantaneous file creation\n            thread::sleep(Duration::from_micros(10));\n        }\n        \n        paths\n    }\n    \n    fn cleanup(\u0026self) {\n        // No need to do anything as tempdir will clean itself\n    }\n}\n\n#[test]\nfn test_basic_watch_functionality() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Create a test file before starting the watcher\n    let initial_file = simulator.create_file(\"initial.txt\", \"Initial content\");\n    \n    // Configure and start the watcher\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for a short time\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Generate events\n    let file1 = simulator.create_file(\"test1.txt\", \"Hello, world!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    let file2 = simulator.create_file(\"dir1/test2.txt\", \"Hello from subdirectory!\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.modify_file(\"test1.txt\", \"Updated content\");\n    thread::sleep(Duration::from_millis(200));\n    \n    simulator.delete_file(\"test1.txt\");\n    \n    // Wait for watcher thread to complete\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Check status after processing events\n    let status = finished_watcher.status();\n    \n    // Assertions\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with larger debounce window for this test\n    let config = WatcherConfig {\n        debounce_ms: 200,  // 200ms debounce window\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher in a separate thread\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to observe debouncing\n        thread::sleep(Duration::from_secs(3));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Rapidly update the same file multiple times within the debounce window\n    let test_file = \"test_debounce.txt\";\n    simulator.create_file(test_file, \"Initial content\");\n    \n    // Update the same file multiple times within debounce window\n    for i in 1..10 {\n        simulator.modify_file(test_file, \u0026format!(\"Update {}\", i));\n        thread::sleep(Duration::from_millis(10)); // Short delay between updates\n    }\n    \n    // Wait for debounce window and processing\n    thread::sleep(Duration::from_millis(500));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // We should have processed fewer events than modifications made\n    // due to debouncing (exact count depends on implementation details)\n    assert!(status.events_processed \u003c 10, \n            \"Expected fewer events processed than modifications due to debouncing\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_event_flood() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure with settings tuned for burst handling\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 500,  // Handle larger batches\n        max_queue_size: 10000,  // Large queue for burst\n        drain_timeout_ms: 5000, // Longer drain time for cleanup\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run for enough time to process a large burst\n        thread::sleep(Duration::from_secs(10));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher for inspection\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create 1000 files in rapid succession (smaller scale for test)\n    let start_time = Instant::now();\n    let created_files = simulator.create_burst(1000, \"flood\");\n    let creation_time = start_time.elapsed();\n    \n    println!(\"Created 1000 files in {:?}\", creation_time);\n    \n    // Wait for processing to complete\n    thread::sleep(Duration::from_secs(5));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    let status = finished_watcher.status();\n    \n    // Verify processing occurred\n    assert!(status.events_processed \u003e 0, \"Expected events to be processed\");\n    assert_eq!(status.queue_size, 0, \"Expected empty queue after stopping\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_hierarchical_debouncing() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher\n    let config = WatcherConfig {\n        debounce_ms: 200,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 1000,\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    let watcher_thread = thread::spawn(move || {\n        watcher.start().expect(\"Failed to start watcher\");\n        \n        // Let it run\n        thread::sleep(Duration::from_secs(5));\n        \n        // Stop the watcher\n        watcher.stop().expect(\"Failed to stop watcher\");\n        \n        // Return the watcher\n        watcher\n    });\n    \n    // Wait for watcher to initialize\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create directory structure\n    let nested_dir = \"parent/child/grandchild\";\n    fs::create_dir_all(temp_path.join(nested_dir)).expect(\"Failed to create nested directories\");\n    \n    // Create files in the hierarchy\n    simulator.create_file(\"parent/file1.txt\", \"Content 1\");\n    simulator.create_file(\"parent/child/file2.txt\", \"Content 2\");\n    simulator.create_file(\"parent/child/grandchild/file3.txt\", \"Content 3\");\n    \n    // Wait a bit\n    thread::sleep(Duration::from_millis(300));\n    \n    // Complete the test\n    let finished_watcher = watcher_thread.join().expect(\"Watcher thread panicked\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n\n#[test]\nfn test_graceful_shutdown() {\n    let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n    let temp_path = temp_dir.path().to_path_buf();\n    \n    let mut simulator = MockEventSimulator::new(temp_path.clone());\n    \n    // Configure watcher with specific drain timeout\n    let config = WatcherConfig {\n        debounce_ms: 100,\n        batch_size: 100,\n        max_queue_size: 1000,\n        drain_timeout_ms: 2000, // 2 second drain timeout\n    };\n    \n    let mut watcher = FileWatcher::new(vec![temp_path.clone()], config)\n        .expect(\"Failed to create file watcher\");\n    \n    // Start the watcher\n    watcher.start().expect(\"Failed to start watcher\");\n    \n    // Wait for initialization\n    thread::sleep(Duration::from_millis(500));\n    \n    // Create files\n    for i in 0..10 {\n        simulator.create_file(\u0026format!(\"shutdown_test_{}.txt\", i), \"Shutdown test\");\n        thread::sleep(Duration::from_millis(10));\n    }\n    \n    // Immediately request shutdown while events are being processed\n    let shutdown_start = Instant::now();\n    watcher.stop().expect(\"Failed to stop watcher\");\n    let shutdown_duration = shutdown_start.elapsed();\n    \n    // Shutdown should take close to the drain timeout but not excessively longer\n    println!(\"Shutdown took {:?}\", shutdown_duration);\n    assert!(shutdown_duration \u003e= Duration::from_millis(100), \n            \"Shutdown was too quick, may not have drained properly\");\n    assert!(shutdown_duration \u003c= Duration::from_millis(3000), \n            \"Shutdown took too long\");\n    \n    // Verify final state\n    let status = watcher.status();\n    assert_eq!(status.state, WatcherState::Stopped);\n    assert_eq!(status.queue_size, 0, \"Queue should be empty after shutdown\");\n    \n    // Clean up\n    simulator.cleanup();\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","neg.rs"],"content":"//! tests neg.rs\n//! Negative-path integration tests (“should fail / warn”).\n\nuse predicates::str;\nuse tempfile::tempdir;\n\nmod util;\nuse util::marlin;\n\n/* ───────────────────────── LINKS ─────────────────────────────── */\n\n#[test]\nfn link_non_indexed_should_fail() {\n    let tmp = tempdir().unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    std::fs::write(tmp.path().join(\"foo.txt\"), \"\").unwrap();\n    std::fs::write(tmp.path().join(\"bar.txt\"), \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .current_dir(tmp.path())\n        .args([\n            \"link\", \"add\",\n            \u0026tmp.path().join(\"foo.txt\").to_string_lossy(),\n            \u0026tmp.path().join(\"bar.txt\").to_string_lossy()\n        ])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"file not indexed\"));\n}\n\n/* ───────────────────────── ATTR ─────────────────────────────── */\n\n#[test]\nfn attr_set_on_non_indexed_file_should_warn() {\n    let tmp = tempdir().unwrap();\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    let ghost = tmp.path().join(\"ghost.txt\");\n    std::fs::write(\u0026ghost, \"\").unwrap();\n\n    marlin(\u0026tmp)\n        .args([\"attr\",\"set\",\n               \u0026ghost.to_string_lossy(),\"foo\",\"bar\"])\n        .assert()\n        .success()                       // exits 0\n        .stderr(str::contains(\"not indexed\"));\n}\n\n/* ───────────────────── COLLECTIONS ───────────────────────────── */\n\n#[test]\nfn coll_add_unknown_collection_should_fail() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"doc.txt\");\n    std::fs::write(\u0026file, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"coll\",\"add\",\"nope\",\u0026file.to_string_lossy()])\n        .assert()\n        .failure();\n}\n\n/* ───────────────────── RESTORE (bad file) ───────────────────── */\n\n#[test]\nfn restore_with_nonexistent_backup_should_fail() {\n    let tmp   = tempdir().unwrap();\n\n    // create an empty DB first\n    marlin(\u0026tmp).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"restore\", \"/definitely/not/here.db\"])\n        .assert()\n        .failure()\n        .stderr(str::contains(\"Failed to restore\"));\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","pos.rs"],"content":"//! tests pos.rs\n//! Positive-path integration checks for every sub-command\n//! that already has real logic behind it.\n\nmod util;\nuse util::marlin;\n\nuse predicates::{prelude::*, str};          // brings `PredicateBooleanExt::and`\nuse std::fs;\nuse tempfile::tempdir;\n\n/* ─────────────────────────── TAG ─────────────────────────────── */\n\n#[test]\nfn tag_should_add_hierarchical_tag_and_search_finds_it() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"foo.md\");\n    fs::write(\u0026file, \"# test\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"tag\", file.to_str().unwrap(), \"project/md\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"search\", \"tag:project/md\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"foo.md\"));\n}\n\n/* ─────────────────────────── ATTR ────────────────────────────── */\n\n#[test]\nfn attr_set_then_ls_roundtrip() {\n    let tmp  = tempdir().unwrap();\n    let file = tmp.path().join(\"report.pdf\");\n    fs::write(\u0026file, \"%PDF-1.4\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"set\", file.to_str().unwrap(), \"reviewed\", \"yes\"])\n        .assert().success();\n\n    marlin(\u0026tmp)\n        .args([\"attr\", \"ls\", file.to_str().unwrap()])\n        .assert()\n        .success()\n        .stdout(str::contains(\"reviewed = yes\"));\n}\n\n/* ─────────────────────── COLLECTIONS ────────────────────────── */\n\n#[test]\nfn coll_create_add_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let a = tmp.path().join(\"a.txt\");\n    let b = tmp.path().join(\"b.txt\");\n    fs::write(\u0026a, \"\").unwrap();\n    fs::write(\u0026b, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    marlin(\u0026tmp).args([\"coll\", \"create\", \"Set\"]).assert().success();\n    for f in [\u0026a, \u0026b] {\n        marlin(\u0026tmp).args([\"coll\", \"add\", \"Set\", f.to_str().unwrap()]).assert().success();\n    }\n\n    marlin(\u0026tmp)\n        .args([\"coll\", \"list\", \"Set\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"a.txt\").and(str::contains(\"b.txt\")));\n}\n\n/* ─────────────────────────── VIEWS ───────────────────────────── */\n\n#[test]\nfn view_save_list_and_exec() {\n    let tmp  = tempdir().unwrap();\n\n    let todo = tmp.path().join(\"TODO.txt\");\n    fs::write(\u0026todo, \"remember the milk\\n\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // save \u0026 list\n    marlin(\u0026tmp).args([\"view\", \"save\", \"tasks\", \"milk\"]).assert().success();\n    marlin(\u0026tmp)\n        .args([\"view\", \"list\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"tasks: milk\"));\n\n    // exec\n    marlin(\u0026tmp)\n        .args([\"view\", \"exec\", \"tasks\"])\n        .assert()\n        .success()\n        .stdout(str::contains(\"TODO.txt\"));\n}\n\n/* ─────────────────────────── LINKS ───────────────────────────── */\n\n#[test]\nfn link_add_rm_and_list() {\n    let tmp = tempdir().unwrap();\n\n    let foo = tmp.path().join(\"foo.txt\");\n    let bar = tmp.path().join(\"bar.txt\");\n    fs::write(\u0026foo, \"\").unwrap();\n    fs::write(\u0026bar, \"\").unwrap();\n\n    // handy closure\n    let mc = || marlin(\u0026tmp);\n\n    mc().current_dir(tmp.path()).arg(\"init\").assert().success();\n    mc().args([\"scan\", tmp.path().to_str().unwrap()]).assert().success();\n\n    // add\n    mc().args([\"link\", \"add\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list (outgoing default)\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::contains(\"foo.txt\").and(str::contains(\"bar.txt\")));\n\n    // remove\n    mc().args([\"link\", \"rm\", foo.to_str().unwrap(), bar.to_str().unwrap()])\n        .assert().success();\n\n    // list now empty\n    mc().args([\"link\", \"list\", foo.to_str().unwrap()])\n        .assert().success()\n        .stdout(str::is_empty());\n}\n\n/* ─────────────────────── SCAN (multi-path) ───────────────────── */\n\n#[test]\nfn scan_with_multiple_paths_indexes_all() {\n    let tmp = tempdir().unwrap();\n\n    let dir_a = tmp.path().join(\"A\");\n    let dir_b = tmp.path().join(\"B\");\n    std::fs::create_dir_all(\u0026dir_a).unwrap();\n    std::fs::create_dir_all(\u0026dir_b).unwrap();\n    let f1 = dir_a.join(\"one.txt\");\n    let f2 = dir_b.join(\"two.txt\");\n    fs::write(\u0026f1, \"\").unwrap();\n    fs::write(\u0026f2, \"\").unwrap();\n\n    marlin(\u0026tmp).current_dir(tmp.path()).arg(\"init\").assert().success();\n\n    // multi-path scan\n    marlin(\u0026tmp)\n        .args([\"scan\", dir_a.to_str().unwrap(), dir_b.to_str().unwrap()])\n        .assert().success();\n\n    // both files findable\n    for term in [\"one.txt\", \"two.txt\"] {\n        marlin(\u0026tmp).args([\"search\", term])\n            .assert()\n            .success()\n            .stdout(str::contains(term));\n    }\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","cli-bin","tests","util.rs"],"content":"//! tests/util.rs\n//! Small helpers shared across integration tests.\n\nuse std::path::{Path, PathBuf};\nuse tempfile::TempDir;\nuse assert_cmd::Command; \n/// Absolute path to the freshly-built `marlin` binary.\npub fn bin() -\u003e PathBuf {\n    PathBuf::from(env!(\"CARGO_BIN_EXE_marlin\"))\n}\n\n/// Build a `Command` for `marlin` whose `MARLIN_DB_PATH` is\n/// `\u003ctmp\u003e/index.db`.\n///\n/// Each call yields a brand-new `Command`, so callers can freely add\n/// arguments, change the working directory, etc., without affecting\n/// other invocations.\npub fn marlin(tmp: \u0026TempDir) -\u003e Command {\n    let db_path: \u0026Path = \u0026tmp.path().join(\"index.db\");\n    let mut cmd = Command::new(bin());\n    cmd.env(\"MARLIN_DB_PATH\", db_path);\n    cmd\n}\n","traces":[{"line":8,"address":[776352],"length":1,"stats":{"Line":10}},{"line":9,"address":[776360],"length":1,"stats":{"Line":10}},{"line":18,"address":[776721,776384,776727],"length":1,"stats":{"Line":10}},{"line":19,"address":[776535,776422],"length":1,"stats":{"Line":20}},{"line":20,"address":[776575],"length":1,"stats":{"Line":10}},{"line":21,"address":[776612],"length":1,"stats":{"Line":10}},{"line":22,"address":[776682],"length":1,"stats":{"Line":10}}],"covered":7,"coverable":7},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","backup.rs"],"content":"// libmarlin/src/backup.rs\n\nuse anyhow::{anyhow, Context, Result};\nuse chrono::{DateTime, Local, NaiveDateTime, Utc, TimeZone};\nuse rusqlite;\nuse std::fs;\nuse std::path::{Path, PathBuf};\nuse std::time::Duration;\n\nuse crate::error as marlin_error;\n\n#[derive(Debug, Clone)]\npub struct BackupInfo {\n    pub id: String,\n    pub timestamp: DateTime\u003cUtc\u003e,\n    pub size_bytes: u64,\n    pub hash: Option\u003cString\u003e,\n}\n\n#[derive(Debug)]\npub struct PruneResult {\n    pub kept: Vec\u003cBackupInfo\u003e,\n    pub removed: Vec\u003cBackupInfo\u003e,\n}\n\n#[derive(Debug)]\npub struct BackupManager {\n    live_db_path: PathBuf,\n    backups_dir: PathBuf,\n}\n\nimpl BackupManager {\n    pub fn new\u003cP1: AsRef\u003cPath\u003e, P2: AsRef\u003cPath\u003e\u003e(live_db_path: P1, backups_dir: P2) -\u003e Result\u003cSelf\u003e {\n        let backups_dir_path = backups_dir.as_ref().to_path_buf();\n        if !backups_dir_path.exists() {\n            fs::create_dir_all(\u0026backups_dir_path).with_context(|| {\n                format!(\n                    \"Failed to create backup directory at {}\",\n                    backups_dir_path.display()\n                )\n            })?;\n        } else if !backups_dir_path.is_dir() {\n            return Err(anyhow!(\"Backups path exists but is not a directory: {}\", backups_dir_path.display()));\n        }\n        Ok(Self {\n            live_db_path: live_db_path.as_ref().to_path_buf(),\n            backups_dir: backups_dir_path,\n        })\n    }\n\n    pub fn create_backup(\u0026self) -\u003e Result\u003cBackupInfo\u003e {\n        let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S_%f\");\n        let backup_file_name = format!(\"backup_{stamp}.db\");\n        let backup_file_path = self.backups_dir.join(\u0026backup_file_name);\n\n        if !self.live_db_path.exists() {\n             return Err(anyhow::Error::new(std::io::Error::new(\n                std::io::ErrorKind::NotFound,\n                format!(\"Live DB path does not exist: {}\", self.live_db_path.display()),\n            )).context(\"Cannot create backup from non-existent live DB\"));\n        }\n\n        let src_conn = rusqlite::Connection::open_with_flags(\n            \u0026self.live_db_path,\n            rusqlite::OpenFlags::SQLITE_OPEN_READ_ONLY,\n        )\n        .with_context(|| {\n            format!(\n                \"Failed to open source DB ('{}') for backup\",\n                self.live_db_path.display()\n            )\n        })?;\n\n        let mut dst_conn = rusqlite::Connection::open(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to open destination backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        let backup_op =\n            rusqlite::backup::Backup::new(\u0026src_conn, \u0026mut dst_conn).with_context(|| {\n                format!(\n                    \"Failed to initialize backup from {} to {}\",\n                    self.live_db_path.display(),\n                    backup_file_path.display()\n                )\n            })?;\n\n        backup_op\n            .run_to_completion(100, Duration::from_millis(250), None)\n            .map_err(|e| anyhow::Error::new(e).context(\"SQLite backup operation failed\"))?;\n\n        let metadata = fs::metadata(\u0026backup_file_path).with_context(|| {\n            format!(\n                \"Failed to get metadata for backup file: {}\",\n                backup_file_path.display()\n            )\n        })?;\n\n        Ok(BackupInfo {\n            id: backup_file_name,\n            timestamp: DateTime::from(metadata.modified()?),\n            size_bytes: metadata.len(),\n            hash: None,\n        })\n    }\n\n    pub fn list_backups(\u0026self) -\u003e Result\u003cVec\u003cBackupInfo\u003e\u003e {\n        let mut backup_infos = Vec::new();\n        \n        if !self.backups_dir.exists() { \n            return Ok(backup_infos);\n        }\n\n        for entry_result in fs::read_dir(\u0026self.backups_dir).with_context(|| {\n            format!(\n                \"Failed to read backup directory: {}\",\n                self.backups_dir.display()\n            )\n        })? {\n            let entry = entry_result?;\n            let path = entry.path();\n\n            if path.is_file() {\n                if let Some(filename_osstr) = path.file_name() {\n                    if let Some(filename) = filename_osstr.to_str() {\n                        if filename.starts_with(\"backup_\") \u0026\u0026 filename.ends_with(\".db\") {\n                            let ts_str = filename\n                                .trim_start_matches(\"backup_\")\n                                .trim_end_matches(\".db\");\n                            \n                            let naive_dt = match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S_%f\") {\n                                Ok(dt) =\u003e dt,\n                                Err(_) =\u003e match NaiveDateTime::parse_from_str(ts_str, \"%Y-%m-%d_%H-%M-%S\") {\n                                    Ok(dt) =\u003e dt,\n                                    Err(_) =\u003e { \n                                        let metadata = fs::metadata(\u0026path).with_context(|| format!(\"Failed to get metadata for {}\", path.display()))?;\n                                        DateTime::\u003cUtc\u003e::from(metadata.modified()?).naive_utc()\n                                    }\n                                }\n                            };\n                            \n                            let local_dt_result = Local.from_local_datetime(\u0026naive_dt);\n                            let local_dt = match local_dt_result {\n                                chrono::LocalResult::Single(dt) =\u003e dt,\n                                chrono::LocalResult::Ambiguous(dt1, _dt2) =\u003e {\n                                    eprintln!(\"Warning: Ambiguous local time for backup {}, taking first interpretation.\", filename);\n                                    dt1\n                                },\n                                chrono::LocalResult::None =\u003e {\n                                    eprintln!(\"Warning: Invalid local time for backup {}, skipping.\", filename);\n                                    continue; \n                                }\n                            };\n                            let timestamp_utc = DateTime::\u003cUtc\u003e::from(local_dt);\n\n                            let metadata = fs::metadata(\u0026path)?;\n                            backup_infos.push(BackupInfo {\n                                id: filename.to_string(),\n                                timestamp: timestamp_utc,\n                                size_bytes: metadata.len(),\n                                hash: None,\n                            });\n                        }\n                    }\n                }\n            }\n        }\n        backup_infos.sort_by_key(|b| std::cmp::Reverse(b.timestamp));\n        Ok(backup_infos)\n    }\n\n    pub fn prune(\u0026self, keep_count: usize) -\u003e Result\u003cPruneResult\u003e {\n        let all_backups = self.list_backups()?; \n\n        let mut kept = Vec::new();\n        let mut removed = Vec::new();\n\n        if keep_count \u003e= all_backups.len() { \n            kept = all_backups;\n        } else {\n            for (index, backup_info) in all_backups.into_iter().enumerate() {\n                if index \u003c keep_count {\n                    kept.push(backup_info);\n                } else {\n                    let backup_file_path = self.backups_dir.join(\u0026backup_info.id);\n                    if backup_file_path.exists() { \n                        fs::remove_file(\u0026backup_file_path).with_context(|| {\n                            format!(\n                                \"Failed to remove old backup file: {}\",\n                                backup_file_path.display()\n                            )\n                        })?;\n                    }\n                    removed.push(backup_info);\n                }\n            }\n        }\n        Ok(PruneResult { kept, removed })\n    }\n\n    pub fn restore_from_backup(\u0026self, backup_id: \u0026str) -\u003e Result\u003c()\u003e {\n        let backup_file_path = self.backups_dir.join(backup_id);\n        if !backup_file_path.exists() || !backup_file_path.is_file() {\n            return Err(anyhow::Error::new(marlin_error::Error::NotFound(format!(\n                \"Backup file not found or is not a file: {}\",\n                backup_file_path.display()\n            ))));\n        }\n\n        fs::copy(\u0026backup_file_path, \u0026self.live_db_path).with_context(|| {\n            format!(\n                \"Failed to copy backup {} to live DB {}\",\n                backup_file_path.display(),\n                self.live_db_path.display()\n            )\n        })?;\n        Ok(())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use tempfile::tempdir;\n    use crate::db::open as open_marlin_db;\n\n    fn create_valid_live_db(path: \u0026Path) -\u003e rusqlite::Connection {\n        let conn = open_marlin_db(path)\n            .unwrap_or_else(|e| panic!(\"Failed to open/create test DB at {}: {:?}\", path.display(), e));\n        conn.execute_batch(\n            \"CREATE TABLE IF NOT EXISTS test_table (id INTEGER PRIMARY KEY, data TEXT);\n             INSERT INTO test_table (data) VALUES ('initial_data');\"\n        ).expect(\"Failed to initialize test table\");\n        conn\n    }\n\n    #[test]\n    fn test_backup_manager_new_creates_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_new_creates.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_new_creates_test\");\n\n        assert!(!backups_dir.exists());\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        assert!(manager.backups_dir.exists()); \n        assert!(backups_dir.exists());\n    }\n\n    #[test]\n    fn test_backup_manager_new_with_existing_dir() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_existing_dir.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = base_tmp.path().join(\"my_backups_existing_test\");\n        std::fs::create_dir_all(\u0026backups_dir).unwrap(); \n\n        assert!(backups_dir.exists());\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026backups_dir);\n        assert!(manager_res.is_ok());\n        let manager = manager_res.unwrap();\n        assert_eq!(manager.backups_dir, backups_dir);\n    }\n    \n    #[test]\n    fn test_backup_manager_new_fails_if_backup_path_is_file() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"live_backup_path_is_file.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n        let file_as_backups_dir = base_tmp.path().join(\"file_as_backups_dir\");\n        std::fs::write(\u0026file_as_backups_dir, \"i am a file\").unwrap();\n\n        let manager_res = BackupManager::new(\u0026live_db_path, \u0026file_as_backups_dir);\n        assert!(manager_res.is_err());\n        assert!(manager_res.unwrap_err().to_string().contains(\"Backups path exists but is not a directory\"));\n    }\n\n    #[test]\n    fn test_create_backup_failure_non_existent_live_db() {\n        let base_tmp = tempdir().unwrap();\n        let live_db_path = base_tmp.path().join(\"non_existent_live.db\"); \n        let backups_dir = base_tmp.path().join(\"backups_fail_test\");\n\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n        let backup_result = manager.create_backup();\n        assert!(backup_result.is_err());\n        let err_str = backup_result.unwrap_err().to_string();\n        assert!(err_str.contains(\"Cannot create backup from non-existent live DB\") || err_str.contains(\"Failed to open source DB\"));\n    }\n\n    #[test]\n    fn test_create_list_prune_backups() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_clp_test.db\");\n        let _conn_live = create_valid_live_db(\u0026live_db_file);\n\n        let backups_storage_dir = tmp.path().join(\"backups_clp_storage_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_storage_dir).unwrap();\n\n        let initial_list = manager.list_backups().unwrap();\n        assert!(initial_list.is_empty(), \"Backup list should be empty initially\");\n\n        let prune_empty_result = manager.prune(2).unwrap();\n        assert!(prune_empty_result.kept.is_empty());\n        assert!(prune_empty_result.removed.is_empty());\n\n        let mut created_backup_ids = Vec::new();\n        for i in 0..5 {\n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone()); \n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(listed_backups.len(), 5);\n        for id in \u0026created_backup_ids {\n            assert!(\n                listed_backups.iter().any(|b| \u0026b.id == id),\n                \"Backup ID {} not found in list\", id\n            );\n        }\n        if listed_backups.len() \u003e= 2 {\n            assert!(listed_backups[0].timestamp \u003e= listed_backups[1].timestamp);\n        }\n\n        let prune_to_zero_result = manager.prune(0).unwrap();\n        assert_eq!(prune_to_zero_result.kept.len(), 0);\n        assert_eq!(prune_to_zero_result.removed.len(), 5);\n        let listed_after_prune_zero = manager.list_backups().unwrap();\n        assert!(listed_after_prune_zero.is_empty());\n\n        created_backup_ids.clear();\n        for i in 0..5 { \n            let info = manager\n                .create_backup()\n                .unwrap_or_else(|e| panic!(\"Failed to create backup {}: {:?}\", i, e));\n            created_backup_ids.push(info.id.clone());\n            std::thread::sleep(std::time::Duration::from_millis(30));\n        }\n\n        let prune_keep_more_result = manager.prune(10).unwrap();\n        assert_eq!(prune_keep_more_result.kept.len(), 5);\n        assert_eq!(prune_keep_more_result.removed.len(), 0);\n        let listed_after_prune_more = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune_more.len(), 5);\n\n        let prune_result = manager.prune(2).unwrap();\n        assert_eq!(prune_result.kept.len(), 2);\n        assert_eq!(prune_result.removed.len(), 3);\n\n        let listed_after_prune = manager.list_backups().unwrap();\n        assert_eq!(listed_after_prune.len(), 2);\n\n        assert_eq!(listed_after_prune[0].id, created_backup_ids[4]);\n        assert_eq!(listed_after_prune[1].id, created_backup_ids[3]);\n        \n        for removed_info in prune_result.removed {\n            assert!(\n                !backups_storage_dir.join(\u0026removed_info.id).exists(),\n                \"Removed backup file {} should not exist\", removed_info.id\n            );\n        }\n        for kept_info in prune_result.kept {\n            assert!(\n                backups_storage_dir.join(\u0026kept_info.id).exists(),\n                \"Kept backup file {} should exist\", kept_info.id\n            );\n        }\n    }\n\n     #[test]\n    fn test_restore_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_test.db\");\n        \n        let initial_value = \"initial_data_for_restore\";\n        {\n            let conn = create_valid_live_db(\u0026live_db_path);\n            conn.execute(\"DELETE FROM test_table\", []).unwrap(); \n            conn.execute(\"INSERT INTO test_table (data) VALUES (?1)\", [initial_value]).unwrap();\n        }\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_test_dir\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let backup_info = manager.create_backup().unwrap();\n\n        let modified_value = \"modified_data_for_restore\";\n        {\n            let conn = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB for modification\");\n            conn.execute(\"UPDATE test_table SET data = ?1\", [modified_value])\n                .expect(\"Failed to update data\");\n            let modified_check: String = conn\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(modified_check, modified_value);\n        }\n        \n        manager.restore_from_backup(\u0026backup_info.id).unwrap();\n\n        {\n            let conn_after_restore = rusqlite::Connection::open(\u0026live_db_path)\n                .expect(\"Failed to open live DB after restore\");\n            let restored_data: String = conn_after_restore\n                .query_row(\"SELECT data FROM test_table\", [], |row| row.get(0))\n                .unwrap();\n            assert_eq!(restored_data, initial_value);\n        }\n    }\n\n    #[test]\n    fn test_restore_non_existent_backup() {\n        let tmp = tempdir().unwrap();\n        let live_db_path = tmp.path().join(\"live_for_restore_fail_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_path);\n\n        let backups_dir = tmp.path().join(\"backups_for_restore_fail_test\");\n        let manager = BackupManager::new(\u0026live_db_path, \u0026backups_dir).unwrap();\n\n        let result = manager.restore_from_backup(\"non_existent_backup.db\");\n        assert!(result.is_err());\n        let err_string = result.unwrap_err().to_string();\n        assert!(err_string.contains(\"Backup file not found\"), \"Error string was: {}\", err_string);\n    }\n\n    #[test]\n    fn list_backups_with_non_backup_files() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_test.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        let backups_dir = tmp.path().join(\"backups_list_mixed_files_test\");\n        \n        let manager = BackupManager::new(\u0026live_db_file, \u0026backups_dir).unwrap();\n\n        manager.create_backup().unwrap(); \n        \n        std::fs::write(backups_dir.join(\"not_a_backup.txt\"), \"hello\").unwrap();\n        std::fs::write(\n            backups_dir.join(\"backup_malformed.db.tmp\"),\n            \"temp data\",\n        )\n        .unwrap();\n        std::fs::create_dir(backups_dir.join(\"a_subdir\")).unwrap();\n\n        let listed_backups = manager.list_backups().unwrap();\n        assert_eq!(\n            listed_backups.len(),\n            1,\n            \"Should only list the valid backup file\"\n        );\n        assert!(listed_backups[0].id.starts_with(\"backup_\"));\n        assert!(listed_backups[0].id.ends_with(\".db\"));\n    }\n\n     #[test]\n    fn list_backups_handles_io_error_on_read_dir() {\n        let tmp = tempdir().unwrap();\n        let live_db_file = tmp.path().join(\"live_for_list_io_error.db\");\n        let _conn = create_valid_live_db(\u0026live_db_file);\n        \n        let backups_dir_for_deletion = tmp.path().join(\"backups_dir_to_delete_test\");\n        let manager_for_deletion = BackupManager::new(\u0026live_db_file, \u0026backups_dir_for_deletion).unwrap();\n        std::fs::remove_dir_all(\u0026backups_dir_for_deletion).unwrap(); \n\n        let list_res = manager_for_deletion.list_backups().unwrap();\n        assert!(list_res.is_empty());\n    }\n}","traces":[{"line":34,"address":[1940518,1940524,1939536],"length":1,"stats":{"Line":1}},{"line":35,"address":[],"length":0,"stats":{"Line":2}},{"line":36,"address":[],"length":0,"stats":{"Line":2}},{"line":37,"address":[1939830,1939927,1940544,1939777,1939973],"length":1,"stats":{"Line":2}},{"line":38,"address":[],"length":0,"stats":{"Line":0}},{"line":39,"address":[],"length":0,"stats":{"Line":0}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":43,"address":[],"length":0,"stats":{"Line":4}},{"line":44,"address":[],"length":0,"stats":{"Line":1}},{"line":46,"address":[1940399],"length":1,"stats":{"Line":1}},{"line":47,"address":[1940324,1939941],"length":1,"stats":{"Line":2}},{"line":48,"address":[],"length":0,"stats":{"Line":1}},{"line":52,"address":[1715148,1715154,1711872],"length":1,"stats":{"Line":1}},{"line":53,"address":[1711911],"length":1,"stats":{"Line":1}},{"line":54,"address":[1712001,1712048],"length":1,"stats":{"Line":2}},{"line":55,"address":[1712248,1712164],"length":1,"stats":{"Line":2}},{"line":57,"address":[5530103,5530186],"length":1,"stats":{"Line":2}},{"line":58,"address":[5530494],"length":1,"stats":{"Line":1}},{"line":59,"address":[1712401],"length":1,"stats":{"Line":1}},{"line":60,"address":[1712409,1712500],"length":1,"stats":{"Line":2}},{"line":68,"address":[1940720],"length":1,"stats":{"Line":0}},{"line":69,"address":[1940779],"length":1,"stats":{"Line":0}},{"line":71,"address":[5443926],"length":1,"stats":{"Line":0}},{"line":75,"address":[5531116,5531016,5530945,5533143],"length":1,"stats":{"Line":2}},{"line":76,"address":[1940955],"length":1,"stats":{"Line":0}},{"line":78,"address":[1940918],"length":1,"stats":{"Line":0}},{"line":82,"address":[5444256],"length":1,"stats":{"Line":3}},{"line":84,"address":[1941194,1941135],"length":1,"stats":{"Line":0}},{"line":86,"address":[1941098],"length":1,"stats":{"Line":0}},{"line":87,"address":[5444341],"length":1,"stats":{"Line":0}},{"line":91,"address":[5531838,5533098,5531685],"length":1,"stats":{"Line":1}},{"line":92,"address":[5531603,5531673],"length":1,"stats":{"Line":2}},{"line":93,"address":[1713942],"length":1,"stats":{"Line":0}},{"line":95,"address":[1714108,1713975,1715167],"length":1,"stats":{"Line":1}},{"line":96,"address":[5444619],"length":1,"stats":{"Line":0}},{"line":98,"address":[5444582],"length":1,"stats":{"Line":0}},{"line":102,"address":[1714546],"length":1,"stats":{"Line":2}},{"line":103,"address":[1714205],"length":1,"stats":{"Line":1}},{"line":104,"address":[1714324,1714245],"length":1,"stats":{"Line":3}},{"line":105,"address":[5532407],"length":1,"stats":{"Line":1}},{"line":106,"address":[1714538],"length":1,"stats":{"Line":1}},{"line":110,"address":[1715312,1718888,1718643],"length":1,"stats":{"Line":1}},{"line":111,"address":[1715351],"length":1,"stats":{"Line":2}},{"line":113,"address":[1715471,1715388],"length":1,"stats":{"Line":4}},{"line":114,"address":[1715506],"length":1,"stats":{"Line":1}},{"line":117,"address":[5444736],"length":1,"stats":{"Line":3}},{"line":118,"address":[1941615],"length":1,"stats":{"Line":0}},{"line":120,"address":[1941574],"length":1,"stats":{"Line":0}},{"line":123,"address":[1716210,1718853,1716004],"length":1,"stats":{"Line":2}},{"line":124,"address":[1716378],"length":1,"stats":{"Line":1}},{"line":126,"address":[1716457,1716537],"length":1,"stats":{"Line":2}},{"line":127,"address":[1716598],"length":1,"stats":{"Line":1}},{"line":128,"address":[1716763],"length":1,"stats":{"Line":1}},{"line":129,"address":[1716885],"length":1,"stats":{"Line":1}},{"line":130,"address":[1717009],"length":1,"stats":{"Line":1}},{"line":134,"address":[5535107],"length":1,"stats":{"Line":1}},{"line":135,"address":[5535208],"length":1,"stats":{"Line":1}},{"line":136,"address":[1717208,1717335],"length":1,"stats":{"Line":0}},{"line":137,"address":[1717389],"length":1,"stats":{"Line":0}},{"line":139,"address":[5444912,5444934],"length":1,"stats":{"Line":0}},{"line":140,"address":[1717657,1718780],"length":1,"stats":{"Line":0}},{"line":145,"address":[5535268],"length":1,"stats":{"Line":1}},{"line":146,"address":[5535839],"length":1,"stats":{"Line":1}},{"line":147,"address":[1717887],"length":1,"stats":{"Line":1}},{"line":148,"address":[1717953],"length":1,"stats":{"Line":0}},{"line":149,"address":[5535973,5536073],"length":1,"stats":{"Line":0}},{"line":150,"address":[1718154],"length":1,"stats":{"Line":0}},{"line":153,"address":[1718670,1718012],"length":1,"stats":{"Line":0}},{"line":157,"address":[5536030],"length":1,"stats":{"Line":1}},{"line":159,"address":[1718191,1718649],"length":1,"stats":{"Line":1}},{"line":160,"address":[1718506],"length":1,"stats":{"Line":1}},{"line":161,"address":[1718384],"length":1,"stats":{"Line":1}},{"line":163,"address":[1718427],"length":1,"stats":{"Line":1}},{"line":164,"address":[1718498],"length":1,"stats":{"Line":1}},{"line":171,"address":[1716041],"length":1,"stats":{"Line":3}},{"line":172,"address":[1716095],"length":1,"stats":{"Line":1}},{"line":175,"address":[1720827,1718912,1720660],"length":1,"stats":{"Line":1}},{"line":176,"address":[1718955],"length":1,"stats":{"Line":1}},{"line":178,"address":[1719157],"length":1,"stats":{"Line":1}},{"line":179,"address":[5537212],"length":1,"stats":{"Line":1}},{"line":181,"address":[5537272,5537344,5538907],"length":1,"stats":{"Line":3}},{"line":182,"address":[1720686,1719386],"length":1,"stats":{"Line":1}},{"line":184,"address":[1719457,1720555,1719326,1719576],"length":1,"stats":{"Line":4}},{"line":185,"address":[1719682],"length":1,"stats":{"Line":1}},{"line":186,"address":[1719968,1720666],"length":1,"stats":{"Line":2}},{"line":188,"address":[1720140,1719944],"length":1,"stats":{"Line":2}},{"line":189,"address":[1720175,1720243],"length":1,"stats":{"Line":2}},{"line":190,"address":[1941952],"length":1,"stats":{"Line":1}},{"line":191,"address":[1942011],"length":1,"stats":{"Line":0}},{"line":193,"address":[1941974],"length":1,"stats":{"Line":0}},{"line":197,"address":[5538319],"length":1,"stats":{"Line":1}},{"line":201,"address":[1719716],"length":1,"stats":{"Line":1}},{"line":204,"address":[1721706,1721712,1720864],"length":1,"stats":{"Line":1}},{"line":205,"address":[1720919],"length":1,"stats":{"Line":1}},{"line":206,"address":[1720980,1721117,1721063],"length":1,"stats":{"Line":3}},{"line":207,"address":[1721258],"length":1,"stats":{"Line":1}},{"line":209,"address":[5539315,5539188],"length":1,"stats":{"Line":2}},{"line":213,"address":[1721693,1721613,1721513,1721185],"length":1,"stats":{"Line":2}},{"line":214,"address":[1942191,1942250],"length":1,"stats":{"Line":0}},{"line":216,"address":[1942154],"length":1,"stats":{"Line":0}},{"line":217,"address":[1942213],"length":1,"stats":{"Line":0}},{"line":220,"address":[1721647],"length":1,"stats":{"Line":1}}],"covered":73,"coverable":102},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config.rs"],"content":"use anyhow::Result;\nuse directories::ProjectDirs;\nuse std::{\n    collections::hash_map::DefaultHasher,\n    hash::{Hash, Hasher},\n    path::{Path, PathBuf},\n};\n\n/// Runtime configuration (currently just the DB path).\n#[derive(Debug, Clone)]\npub struct Config {\n    pub db_path: PathBuf,\n}\n\nimpl Config {\n    /// Resolve configuration from environment or derive one per-workspace.\n    ///\n    /// Priority:\n    /// 1. `MARLIN_DB_PATH` env-var (explicit override)\n    /// 2. *Workspace-local* file under XDG data dir\n    ///    (`~/.local/share/marlin/index_\u003chash\u003e.db`)\n    /// 3. Fallback to   `./index.db`  when we cannot locate an XDG dir\n    pub fn load() -\u003e Result\u003cSelf\u003e {\n        // 1) explicit override\n        if let Some(val) = std::env::var_os(\"MARLIN_DB_PATH\") {\n            let p = PathBuf::from(val);\n            std::fs::create_dir_all(p.parent().expect(\"has parent\"))?;\n            return Ok(Self { db_path: p });\n        }\n\n        // 2) derive per-workspace DB name from CWD hash\n        let cwd = std::env::current_dir()?;\n        let mut h = DefaultHasher::new();\n        cwd.hash(\u0026mut h);\n        let digest = h.finish(); // 64-bit\n        let file_name = format!(\"index_{digest:016x}.db\");\n\n        if let Some(dirs) = ProjectDirs::from(\"io\", \"Marlin\", \"marlin\") {\n            let dir = dirs.data_dir();\n            std::fs::create_dir_all(dir)?;\n            return Ok(Self {\n                db_path: dir.join(file_name),\n            });\n        }\n\n        // 3) very last resort – workspace-relative DB\n        Ok(Self {\n            db_path: Path::new(\u0026file_name).to_path_buf(),\n        })\n    }\n}\n","traces":[{"line":23,"address":[5516623,5515840,5516629],"length":1,"stats":{"Line":1}},{"line":25,"address":[2078215],"length":1,"stats":{"Line":1}},{"line":26,"address":[2078350],"length":1,"stats":{"Line":1}},{"line":27,"address":[2078371,2078919,2078553],"length":1,"stats":{"Line":3}},{"line":28,"address":[2078768],"length":1,"stats":{"Line":2}},{"line":32,"address":[2078411,2078990],"length":1,"stats":{"Line":1}},{"line":33,"address":[2079092],"length":1,"stats":{"Line":1}},{"line":34,"address":[2079143],"length":1,"stats":{"Line":1}},{"line":35,"address":[2079178],"length":1,"stats":{"Line":1}},{"line":36,"address":[2079203],"length":1,"stats":{"Line":1}},{"line":38,"address":[2079590,2079488],"length":1,"stats":{"Line":2}},{"line":39,"address":[2079760,2079667],"length":1,"stats":{"Line":2}},{"line":40,"address":[2080093,2079792],"length":1,"stats":{"Line":1}},{"line":41,"address":[2079991],"length":1,"stats":{"Line":1}},{"line":42,"address":[2079920],"length":1,"stats":{"Line":1}},{"line":47,"address":[2080213],"length":1,"stats":{"Line":0}},{"line":48,"address":[2080159],"length":1,"stats":{"Line":0}}],"covered":15,"coverable":17},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","config_tests.rs"],"content":"// libmarlin/src/config_tests.rs\n\nuse super::config::Config;\nuse std::env;\nuse tempfile::tempdir;\n\n#[test]\nfn load_env_override() {\n    let tmp = tempdir().unwrap();\n    let db = tmp.path().join(\"custom.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db);\n    let cfg = Config::load().unwrap();\n    assert_eq!(cfg.db_path, db);\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn load_xdg_or_fallback() {\n    // since XDG_DATA_HOME will normally be present, just test it doesn't error\n    let cfg = Config::load().unwrap();\n    assert!(cfg.db_path.to_string_lossy().ends_with(\".db\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","database.rs"],"content":"//! Database abstraction for Marlin\n//! \n//! This module provides a database abstraction layer that wraps the SQLite connection\n//! and provides methods for common database operations.\n\nuse rusqlite::Connection;\nuse std::path::PathBuf;\nuse anyhow::Result;\n\n/// Options for indexing files\n#[derive(Debug, Clone)]\npub struct IndexOptions {\n    /// Only update files marked as dirty\n    pub dirty_only: bool,\n    \n    /// Index file contents (not just metadata)\n    pub index_contents: bool,\n    \n    /// Maximum file size to index (in bytes)\n    pub max_size: Option\u003cu64\u003e,\n}\n\nimpl Default for IndexOptions {\n    fn default() -\u003e Self {\n        Self {\n            dirty_only: false,\n            index_contents: true,\n            max_size: Some(1_000_000), // 1MB default limit\n        }\n    }\n}\n\n/// Database wrapper for Marlin\npub struct Database {\n    /// The SQLite connection\n    conn: Connection,\n}\n\nimpl Database {\n    /// Create a new database wrapper around an existing connection\n    pub fn new(conn: Connection) -\u003e Self {\n        Self { conn }\n    }\n    \n    /// Get a reference to the underlying connection\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n    \n    /// Get a mutable reference to the underlying connection\n    pub fn conn_mut(\u0026mut self) -\u003e \u0026mut Connection {\n        \u0026mut self.conn\n    }\n    \n    /// Index one or more files\n    pub fn index_files(\u0026mut self, paths: \u0026[PathBuf], _options: \u0026IndexOptions) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would index the files\n        // For now, we just return the number of files \"indexed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n    \n    /// Remove files from the index\n    pub fn remove_files(\u0026mut self, paths: \u0026[PathBuf]) -\u003e Result\u003cusize\u003e {\n        // In a real implementation, this would remove the files\n        // For now, we just return the number of files \"removed\"\n        if paths.is_empty() { // Add a branch for coverage\n            return Ok(0);\n        }\n        Ok(paths.len())\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n    use tempfile::tempdir;\n    use std::fs::File;\n\n    fn setup_db() -\u003e Database {\n        let conn = open_marlin_db(\":memory:\").expect(\"Failed to open in-memory DB\");\n        Database::new(conn)\n    }\n\n    #[test]\n    fn test_database_new_conn_conn_mut() {\n        let mut db = setup_db();\n        let _conn_ref = db.conn();\n        let _conn_mut_ref = db.conn_mut();\n        // Just checking they don't panic and can be called.\n    }\n\n    #[test]\n    fn test_index_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap();\n\n        let paths = vec![file1.to_path_buf()];\n        let options = IndexOptions::default();\n        \n        assert_eq!(db.index_files(\u0026paths, \u0026options).unwrap(), 1);\n        assert_eq!(db.index_files(\u0026[], \u0026options).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_remove_files_stub() {\n        let mut db = setup_db();\n        let tmp = tempdir().unwrap();\n        let file1 = tmp.path().join(\"file1.txt\");\n        File::create(\u0026file1).unwrap(); // File doesn't need to be in DB for this stub\n\n        let paths = vec![file1.to_path_buf()];\n        \n        assert_eq!(db.remove_files(\u0026paths).unwrap(), 1);\n        assert_eq!(db.remove_files(\u0026[]).unwrap(), 0); // Test empty case\n    }\n\n    #[test]\n    fn test_index_options_default() {\n        let options = IndexOptions::default();\n        assert!(!options.dirty_only);\n        assert!(options.index_contents);\n        assert_eq!(options.max_size, Some(1_000_000));\n    }\n}\n","traces":[{"line":24,"address":[5509984],"length":1,"stats":{"Line":1}},{"line":28,"address":[2083427],"length":1,"stats":{"Line":1}},{"line":41,"address":[2083472],"length":1,"stats":{"Line":3}},{"line":46,"address":[2083504],"length":1,"stats":{"Line":1}},{"line":51,"address":[2083520],"length":1,"stats":{"Line":1}},{"line":56,"address":[2083536],"length":1,"stats":{"Line":1}},{"line":59,"address":[2083589],"length":1,"stats":{"Line":1}},{"line":60,"address":[2083619],"length":1,"stats":{"Line":1}},{"line":62,"address":[2083603],"length":1,"stats":{"Line":1}},{"line":66,"address":[2083664],"length":1,"stats":{"Line":1}},{"line":69,"address":[2083714],"length":1,"stats":{"Line":1}},{"line":70,"address":[2083744],"length":1,"stats":{"Line":1}},{"line":72,"address":[2083728],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":13},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db","mod.rs"],"content":"//! Central DB helper – connection bootstrap, migrations **and** most\n//! data-access helpers (tags, links, collections, saved views, …).\n\nmod database;\npub use database::{Database, IndexOptions};\n\nuse std::{\n    fs,\n    path::{Path, PathBuf},\n};\n\nuse std::result::Result as StdResult;\nuse anyhow::{Context, Result};\nuse chrono::Local;\nuse rusqlite::{\n    backup::{Backup, StepResult},\n    params,\n    Connection,\n    OpenFlags,\n    OptionalExtension,\n    TransactionBehavior,\n};\nuse tracing::{debug, info, warn};\n\n/* ─── embedded migrations ─────────────────────────────────────────── */\n\nconst MIGRATIONS: \u0026[(\u0026str, \u0026str)] = \u0026[\n    (\"0001_initial_schema.sql\", include_str!(\"migrations/0001_initial_schema.sql\")),\n    (\"0002_update_fts_and_triggers.sql\", include_str!(\"migrations/0002_update_fts_and_triggers.sql\")),\n    (\"0003_create_links_collections_views.sql\", include_str!(\"migrations/0003_create_links_collections_views.sql\")),\n    (\"0004_fix_hierarchical_tags_fts.sql\", include_str!(\"migrations/0004_fix_hierarchical_tags_fts.sql\")),\n    (\"0005_add_dirty_table.sql\", include_str!(\"migrations/0005_add_dirty_table.sql\")),\n];\n\n/* ─── connection bootstrap ────────────────────────────────────────── */\n\npub fn open\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cConnection\u003e {\n    let db_path_ref = db_path.as_ref();\n    let mut conn = Connection::open(db_path_ref)\n        .with_context(|| format!(\"failed to open DB at {}\", db_path_ref.display()))?;\n\n    conn.pragma_update(None, \"journal_mode\", \"WAL\")?;\n    conn.pragma_update(None, \"foreign_keys\", \"ON\")?;\n\n    // Wait up to 30 s for a competing writer before giving up\n    conn.busy_timeout(std::time::Duration::from_secs(30))?;\n\n    apply_migrations(\u0026mut conn)?;\n    Ok(conn)\n}\n\n/* ─── migration runner ────────────────────────────────────────────── */\n\npub(crate) fn apply_migrations(conn: \u0026mut Connection) -\u003e Result\u003c()\u003e {\n    // Ensure schema_version bookkeeping table exists\n    conn.execute_batch(\n        \"CREATE TABLE IF NOT EXISTS schema_version (\n             version     INTEGER PRIMARY KEY,\n             applied_on  TEXT NOT NULL\n         );\",\n    )?;\n\n    // Legacy patch – ignore errors if column already exists\n    let _ = conn.execute(\"ALTER TABLE schema_version ADD COLUMN applied_on TEXT\", []);\n\n    // Grab the write-lock up-front so migrations can run uninterrupted\n    let tx = conn.transaction_with_behavior(TransactionBehavior::Immediate)?;\n\n    for (fname, sql) in MIGRATIONS {\n        let version: i64 = fname\n            .split('_')\n            .next()\n            .and_then(|s| s.parse().ok())\n            .expect(\"migration filenames start with number\");\n\n        let already: Option\u003ci64\u003e = tx\n            .query_row(\n                \"SELECT version FROM schema_version WHERE version = ?1\",\n                [version],\n                |r| r.get(0),\n            )\n            .optional()?;\n\n        if already.is_some() {\n            debug!(\"migration {} already applied\", fname);\n            continue;\n        }\n\n        info!(\"applying migration {}\", fname);\n        tx.execute_batch(sql)\n            .with_context(|| format!(\"could not apply migration {}\", fname))?;\n\n        tx.execute(\n            \"INSERT INTO schema_version (version, applied_on) VALUES (?1, ?2)\",\n            params![version, Local::now().to_rfc3339()],\n        )?;\n    }\n\n    tx.commit()?;\n\n    // sanity – warn if any embedded migration got skipped\n    let mut missing = Vec::new();\n    for (fname, _) in MIGRATIONS {\n        let v: i64 = fname.split('_').next().unwrap().parse().unwrap();\n        let ok: bool = conn\n            .query_row(\n                \"SELECT 1 FROM schema_version WHERE version = ?1\",\n                [v],\n                |_| Ok(true),\n            )\n            .optional()?\n            .unwrap_or(false);\n        if !ok {\n            missing.push(v);\n        }\n    }\n    if !missing.is_empty() {\n        warn!(\"migrations not applied: {:?}\", missing);\n    }\n\n    Ok(())\n}\n\n/* ─── tag helpers ─────────────────────────────────────────────────── */\n\npub fn ensure_tag_path(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    let mut parent: Option\u003ci64\u003e = None;\n    for segment in path.split('/').filter(|s| !s.is_empty()) {\n        conn.execute(\n            \"INSERT OR IGNORE INTO tags(name, parent_id) VALUES (?1, ?2)\",\n            params![segment, parent],\n        )?;\n        let id: i64 = conn.query_row(\n            \"SELECT id FROM tags WHERE name = ?1 AND (parent_id IS ?2 OR parent_id = ?2)\",\n            params![segment, parent],\n            |r| r.get(0),\n        )?;\n        parent = Some(id);\n    }\n    parent.ok_or_else(|| anyhow::anyhow!(\"empty tag path\"))\n}\n\npub fn file_id(conn: \u0026Connection, path: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.query_row(\"SELECT id FROM files WHERE path = ?1\", [path], |r| r.get(0))\n        .map_err(|_| anyhow::anyhow!(\"file not indexed: {}\", path))\n}\n\n/* ─── attributes ──────────────────────────────────────────────────── */\n\npub fn upsert_attr(conn: \u0026Connection, file_id: i64, key: \u0026str, value: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        r#\"\n        INSERT INTO attributes(file_id, key, value)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(file_id, key) DO UPDATE SET value = excluded.value\n        \"#,\n        params![file_id, key, value],\n    )?;\n    Ok(())\n}\n\n/* ─── links ───────────────────────────────────────────────────────── */\n\npub fn add_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO links(src_file_id, dst_file_id, type)\n         VALUES (?1, ?2, ?3)\n         ON CONFLICT(src_file_id, dst_file_id, type) DO NOTHING\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn remove_link(\n    conn: \u0026Connection,\n    src_file_id: i64,\n    dst_file_id: i64,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"DELETE FROM links\n         WHERE src_file_id = ?1\n           AND dst_file_id = ?2\n           AND (type IS ?3 OR type = ?3)\",\n        params![src_file_id, dst_file_id, link_type],\n    )?;\n    Ok(())\n}\n\npub fn list_links(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n    direction: Option\u003c\u0026str\u003e,\n    link_type: Option\u003c\u0026str\u003e,\n) -\u003e Result\u003cVec\u003c(String, String, Option\u003cString\u003e)\u003e\u003e {\n    let like_pattern = pattern.replace('*', \"%\");\n\n    // Files matching pattern\n    let mut stmt = conn.prepare(\"SELECT id, path FROM files WHERE path LIKE ?1\")?;\n    let rows = stmt\n        .query_map(params![like_pattern], |r| {\n            Ok((r.get::\u003c_, i64\u003e(0)?, r.get::\u003c_, String\u003e(1)?))\n        })?\n        .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n    let mut out = Vec::new();\n    for (fid, fpath) in rows {\n        let (src_col, dst_col) = match direction {\n            Some(\"in\") =\u003e (\"dst_file_id\", \"src_file_id\"),\n            _ =\u003e (\"src_file_id\", \"dst_file_id\"),\n        };\n\n        let sql = format!(\n            \"SELECT f2.path, l.type\n               FROM links l\n               JOIN files f2 ON f2.id = l.{dst_col}\n              WHERE l.{src_col} = ?1\n                AND (?2 IS NULL OR l.type = ?2)\",\n        );\n\n        let mut stmt2 = conn.prepare(\u0026sql)?;\n        let links = stmt2\n            .query_map(params![fid, link_type], |r| {\n                Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n            })?\n            .collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n\n        for (other, typ) in links {\n            out.push((fpath.clone(), other, typ));\n        }\n    }\n    Ok(out)\n}\n\npub fn find_backlinks(\n    conn: \u0026Connection,\n    pattern: \u0026str,\n) -\u003e Result\u003cVec\u003c(String, Option\u003cString\u003e)\u003e\u003e {\n    let like = pattern.replace('*', \"%\");\n\n    let mut stmt = conn.prepare(\n        \"SELECT f1.path, l.type\n           FROM links l\n           JOIN files f1 ON f1.id = l.src_file_id\n           JOIN files f2 ON f2.id = l.dst_file_id\n          WHERE f2.path LIKE ?1\",\n    )?;\n\n    let rows = stmt.query_map([like], |r| {\n        Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, Option\u003cString\u003e\u003e(1)?))\n    })?;\n\n    let out = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(out)\n}\n\n/* ─── collections helpers ────────────────────────────────────────── */\n\npub fn ensure_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003ci64\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collections(name) VALUES (?1)\",\n        params![name],\n    )?;\n    conn.query_row(\n        \"SELECT id FROM collections WHERE name = ?1\",\n        params![name],\n        |r| r.get(0),\n    )\n    .context(\"collection lookup failed\")\n}\n\npub fn add_file_to_collection(conn: \u0026Connection, coll_id: i64, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO collection_files(collection_id, file_id)\n         VALUES (?1, ?2)\",\n        params![coll_id, file_id],\n    )?;\n    Ok(())\n}\n\npub fn list_collection(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n    let mut stmt = conn.prepare(\n        r#\"SELECT f.path\n            FROM collections        c\n            JOIN collection_files cf ON cf.collection_id = c.id\n            JOIN files            f  ON f.id            = cf.file_id\n           WHERE c.name = ?1\n           ORDER BY f.path\"#,\n    )?;\n\n    let rows = stmt.query_map([name], |r| r.get::\u003c_, String\u003e(0))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\n/* ─── saved views (smart folders) ───────────────────────────────── */\n\npub fn save_view(conn: \u0026Connection, name: \u0026str, query: \u0026str) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT INTO views(name, query)\n         VALUES (?1, ?2)\n         ON CONFLICT(name) DO UPDATE SET query = excluded.query\",\n        params![name, query],\n    )?;\n    Ok(())\n}\n\npub fn list_views(conn: \u0026Connection) -\u003e Result\u003cVec\u003c(String, String)\u003e\u003e {\n    let mut stmt = conn.prepare(\"SELECT name, query FROM views ORDER BY name\")?;\n    let rows = stmt.query_map([], |r| Ok((r.get::\u003c_, String\u003e(0)?, r.get::\u003c_, String\u003e(1)?)))?;\n    let list = rows.collect::\u003cStdResult\u003cVec\u003c_\u003e, _\u003e\u003e()?;\n    Ok(list)\n}\n\npub fn view_query(conn: \u0026Connection, name: \u0026str) -\u003e Result\u003cString\u003e {\n    conn.query_row(\n        \"SELECT query FROM views WHERE name = ?1\",\n        [name],\n        |r| r.get::\u003c_, String\u003e(0),\n    )\n    .context(format!(\"no view called '{}'\", name))\n}\n\n/* ─── dirty‐scan helpers ─────────────────────────────────────────── */\n\n/// Mark a file as “dirty” so it’ll be picked up by `scan_dirty`.\npub fn mark_dirty(conn: \u0026Connection, file_id: i64) -\u003e Result\u003c()\u003e {\n    conn.execute(\n        \"INSERT OR IGNORE INTO file_changes(file_id, marked_at)\n         VALUES (?1, strftime('%s','now'))\",\n        params![file_id],\n    )?;\n    Ok(())\n}\n\n/// Take and clear all dirty file IDs for incremental re-scan.\npub fn take_dirty(conn: \u0026Connection) -\u003e Result\u003cVec\u003ci64\u003e\u003e {\n    let mut ids = Vec::new();\n    {\n        let mut stmt = conn.prepare(\"SELECT file_id FROM file_changes\")?;\n        for row in stmt.query_map([], |r| r.get(0))? {\n            ids.push(row?);\n        }\n    }\n    conn.execute(\"DELETE FROM file_changes\", [])?;\n    Ok(ids)\n}\n\n/* ─── backup / restore helpers ────────────────────────────────────── */\n\npub fn backup\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cPathBuf\u003e {\n    let src = db_path.as_ref();\n    let dir = src\n        .parent()\n        .ok_or_else(|| anyhow::anyhow!(\"invalid DB path: {}\", src.display()))?\n        .join(\"backups\");\n    fs::create_dir_all(\u0026dir)?;\n\n    let stamp = Local::now().format(\"%Y-%m-%d_%H-%M-%S\");\n    let dst = dir.join(format!(\"backup_{stamp}.db\"));\n\n    let src_conn = Connection::open_with_flags(src, OpenFlags::SQLITE_OPEN_READ_ONLY)?;\n    let mut dst_conn = Connection::open(\u0026dst)?;\n\n    let bk = Backup::new(\u0026src_conn, \u0026mut dst_conn)?;\n    while let StepResult::More = bk.step(100)? {}\n    Ok(dst)\n}\n\npub fn restore\u003cP: AsRef\u003cPath\u003e\u003e(backup_path: P, live_db_path: P) -\u003e Result\u003c()\u003e {\n    fs::copy(\u0026backup_path, \u0026live_db_path)?;\n    Ok(())\n}\n\n/* ─── tests ───────────────────────────────────────────────────────── */\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn migrations_apply_in_memory() {\n        open(\":memory:\").expect(\"all migrations apply\");\n    }\n}\n","traces":[{"line":37,"address":[5479632,5479584,5480989],"length":1,"stats":{"Line":10}},{"line":38,"address":[],"length":0,"stats":{"Line":20}},{"line":39,"address":[5479827,5480995,5479709],"length":1,"stats":{"Line":10}},{"line":40,"address":[],"length":0,"stats":{"Line":0}},{"line":42,"address":[1759969,1760529,1762721,1761913,1760418,1761337,1759050,1761802,1759161],"length":1,"stats":{"Line":16}},{"line":43,"address":[1759319,1760687,1761335,1762719,1762071,1759967],"length":1,"stats":{"Line":4}},{"line":46,"address":[1762304,1762717,1759552,1760920,1761333,1759965],"length":1,"stats":{"Line":7}},{"line":48,"address":[],"length":0,"stats":{"Line":7}},{"line":49,"address":[5480888],"length":1,"stats":{"Line":3}},{"line":54,"address":[5370432,5373047,5375769],"length":1,"stats":{"Line":1}},{"line":56,"address":[5370458,5370577],"length":1,"stats":{"Line":1}},{"line":64,"address":[5370619],"length":1,"stats":{"Line":1}},{"line":67,"address":[2110984],"length":1,"stats":{"Line":1}},{"line":69,"address":[2111275,2111183],"length":1,"stats":{"Line":2}},{"line":70,"address":[2111405,2113314],"length":1,"stats":{"Line":2}},{"line":73,"address":[5481184,5481204],"length":1,"stats":{"Line":2}},{"line":76,"address":[5373476,5373227,5375727,5373266],"length":1,"stats":{"Line":2}},{"line":79,"address":[5373250],"length":1,"stats":{"Line":1}},{"line":80,"address":[5481248,5481264],"length":1,"stats":{"Line":2}},{"line":84,"address":[5373561],"length":1,"stats":{"Line":6}},{"line":85,"address":[5375061,5373628],"length":1,"stats":{"Line":2}},{"line":89,"address":[5373600,5373666,5373957],"length":1,"stats":{"Line":5}},{"line":90,"address":[2114628,2114154,2114759,2115228],"length":1,"stats":{"Line":6}},{"line":91,"address":[2114743],"length":1,"stats":{"Line":0}},{"line":93,"address":[2114995,2114910,2115193,2114789,2115123],"length":1,"stats":{"Line":5}},{"line":95,"address":[2114801],"length":1,"stats":{"Line":3}},{"line":99,"address":[5373061,5371140],"length":1,"stats":{"Line":7}},{"line":102,"address":[5371343],"length":1,"stats":{"Line":6}},{"line":103,"address":[2111661,2111752],"length":1,"stats":{"Line":7}},{"line":104,"address":[2112731,2111854],"length":1,"stats":{"Line":7}},{"line":105,"address":[2112913,2113111,2113248],"length":1,"stats":{"Line":1}},{"line":108,"address":[2112905],"length":1,"stats":{"Line":6}},{"line":109,"address":[1763512,1763504],"length":1,"stats":{"Line":7}},{"line":113,"address":[2113197],"length":1,"stats":{"Line":6}},{"line":114,"address":[5372962],"length":1,"stats":{"Line":0}},{"line":117,"address":[5371601],"length":1,"stats":{"Line":2}},{"line":118,"address":[2111923,2111988],"length":1,"stats":{"Line":0}},{"line":121,"address":[2111951],"length":1,"stats":{"Line":6}},{"line":126,"address":[5375808],"length":1,"stats":{"Line":1}},{"line":127,"address":[5375844],"length":1,"stats":{"Line":1}},{"line":128,"address":[2116766,2116029],"length":1,"stats":{"Line":4}},{"line":129,"address":[2116264,2116433],"length":1,"stats":{"Line":1}},{"line":131,"address":[5376032],"length":1,"stats":{"Line":1}},{"line":133,"address":[2116545,2116669],"length":1,"stats":{"Line":1}},{"line":135,"address":[5376316],"length":1,"stats":{"Line":1}},{"line":136,"address":[1763600,1763584],"length":1,"stats":{"Line":2}},{"line":138,"address":[2116720],"length":1,"stats":{"Line":1}},{"line":140,"address":[2116364],"length":1,"stats":{"Line":1}},{"line":143,"address":[2116784],"length":1,"stats":{"Line":0}},{"line":144,"address":[2116809],"length":1,"stats":{"Line":0}},{"line":145,"address":[1763761,1763744],"length":1,"stats":{"Line":0}},{"line":150,"address":[2116896],"length":1,"stats":{"Line":1}},{"line":151,"address":[2117135,2117026],"length":1,"stats":{"Line":1}},{"line":157,"address":[2116942],"length":1,"stats":{"Line":1}},{"line":159,"address":[2117175],"length":1,"stats":{"Line":1}},{"line":164,"address":[5377024],"length":1,"stats":{"Line":1}},{"line":170,"address":[2117431,2117322],"length":1,"stats":{"Line":1}},{"line":174,"address":[5377064],"length":1,"stats":{"Line":1}},{"line":176,"address":[2117471],"length":1,"stats":{"Line":1}},{"line":179,"address":[2117504],"length":1,"stats":{"Line":1}},{"line":185,"address":[2117735,2117626],"length":1,"stats":{"Line":1}},{"line":190,"address":[2117544],"length":1,"stats":{"Line":1}},{"line":192,"address":[2117775],"length":1,"stats":{"Line":1}},{"line":195,"address":[2117808,2121615,2121829],"length":1,"stats":{"Line":1}},{"line":201,"address":[2117916],"length":1,"stats":{"Line":1}},{"line":204,"address":[2121827,2118053,2117985],"length":1,"stats":{"Line":2}},{"line":205,"address":[2118602,2118489,2121807,2118422,2118803],"length":1,"stats":{"Line":2}},{"line":206,"address":[2118370],"length":1,"stats":{"Line":2}},{"line":207,"address":[1764030],"length":1,"stats":{"Line":1}},{"line":211,"address":[2118908],"length":1,"stats":{"Line":1}},{"line":212,"address":[2119056,2118956,2119183],"length":1,"stats":{"Line":3}},{"line":213,"address":[2119644,2119284],"length":1,"stats":{"Line":2}},{"line":214,"address":[5379323,5379460],"length":1,"stats":{"Line":0}},{"line":215,"address":[2119480],"length":1,"stats":{"Line":1}},{"line":218,"address":[5379584],"length":1,"stats":{"Line":1}},{"line":226,"address":[2119886,2119970,2121711],"length":1,"stats":{"Line":2}},{"line":227,"address":[2120444,2121690,2120377,2120557,2120758,2121661],"length":1,"stats":{"Line":2}},{"line":228,"address":[2120297],"length":1,"stats":{"Line":2}},{"line":229,"address":[5482462,5483060],"length":1,"stats":{"Line":1}},{"line":233,"address":[2121576,2120959,2121086,2120855],"length":1,"stats":{"Line":4}},{"line":234,"address":[5381277,5381119],"length":1,"stats":{"Line":2}},{"line":237,"address":[5379217],"length":1,"stats":{"Line":1}},{"line":240,"address":[2123080,2121856,2123125],"length":1,"stats":{"Line":1}},{"line":244,"address":[2121926],"length":1,"stats":{"Line":1}},{"line":246,"address":[5383068,5381923,5381991,5382118],"length":1,"stats":{"Line":2}},{"line":254,"address":[5383054,5382567,5382434,5382295],"length":1,"stats":{"Line":3}},{"line":255,"address":[1765246,1765829],"length":1,"stats":{"Line":1}},{"line":258,"address":[2123036,2122796,2122700],"length":1,"stats":{"Line":2}},{"line":259,"address":[5382932],"length":1,"stats":{"Line":1}},{"line":264,"address":[2123168],"length":1,"stats":{"Line":1}},{"line":265,"address":[5383199,5383309],"length":1,"stats":{"Line":1}},{"line":267,"address":[2123203],"length":1,"stats":{"Line":1}},{"line":269,"address":[5383387],"length":1,"stats":{"Line":1}},{"line":271,"address":[5383359],"length":1,"stats":{"Line":1}},{"line":272,"address":[1765920,1765904],"length":1,"stats":{"Line":2}},{"line":277,"address":[2123520],"length":1,"stats":{"Line":1}},{"line":278,"address":[2123604,2123713],"length":1,"stats":{"Line":1}},{"line":281,"address":[5383518],"length":1,"stats":{"Line":1}},{"line":283,"address":[2123753],"length":1,"stats":{"Line":1}},{"line":286,"address":[2124801,2124809,2123776],"length":1,"stats":{"Line":1}},{"line":287,"address":[2123826,2123938],"length":1,"stats":{"Line":1}},{"line":296,"address":[1765987,1765952],"length":1,"stats":{"Line":4}},{"line":297,"address":[2124505,2124409,2124760],"length":1,"stats":{"Line":2}},{"line":298,"address":[5384702],"length":1,"stats":{"Line":1}},{"line":303,"address":[2124832],"length":1,"stats":{"Line":1}},{"line":304,"address":[2124926,2125035],"length":1,"stats":{"Line":1}},{"line":308,"address":[2124872],"length":1,"stats":{"Line":1}},{"line":310,"address":[2125075],"length":1,"stats":{"Line":1}},{"line":313,"address":[2125104,2126063,2126071],"length":1,"stats":{"Line":1}},{"line":314,"address":[2125128],"length":1,"stats":{"Line":1}},{"line":315,"address":[5483968,5484014],"length":1,"stats":{"Line":4}},{"line":316,"address":[2125769,2125673,2126022],"length":1,"stats":{"Line":2}},{"line":317,"address":[2125955],"length":1,"stats":{"Line":1}},{"line":320,"address":[2126096,2126405,2126430],"length":1,"stats":{"Line":1}},{"line":321,"address":[2126158,2126359,2126130],"length":1,"stats":{"Line":3}},{"line":323,"address":[2126138],"length":1,"stats":{"Line":1}},{"line":324,"address":[1766736,1766720],"length":1,"stats":{"Line":2}},{"line":326,"address":[2126217,2126423,2126193,2126389],"length":1,"stats":{"Line":2}},{"line":332,"address":[2126448],"length":1,"stats":{"Line":0}},{"line":333,"address":[2126611,2126502],"length":1,"stats":{"Line":0}},{"line":336,"address":[2126474],"length":1,"stats":{"Line":0}},{"line":338,"address":[2126651],"length":1,"stats":{"Line":0}},{"line":342,"address":[2128134,2128121,2126688],"length":1,"stats":{"Line":0}},{"line":343,"address":[2126723],"length":1,"stats":{"Line":0}},{"line":345,"address":[2126733,2128129,2126797],"length":1,"stats":{"Line":0}},{"line":346,"address":[2127448,2127174,2127110,2128127],"length":1,"stats":{"Line":0}},{"line":347,"address":[2127919,2127549],"length":1,"stats":{"Line":0}},{"line":350,"address":[2127615,2127905],"length":1,"stats":{"Line":0}},{"line":351,"address":[2127818],"length":1,"stats":{"Line":0}},{"line":356,"address":[],"length":0,"stats":{"Line":1}},{"line":357,"address":[],"length":0,"stats":{"Line":2}},{"line":358,"address":[1769333,1766965,1767096],"length":1,"stats":{"Line":1}},{"line":360,"address":[],"length":0,"stats":{"Line":0}},{"line":362,"address":[],"length":0,"stats":{"Line":2}},{"line":364,"address":[],"length":0,"stats":{"Line":1}},{"line":365,"address":[],"length":0,"stats":{"Line":2}},{"line":367,"address":[2498760,2497145,2497253],"length":1,"stats":{"Line":2}},{"line":368,"address":[1768151,1768084,1769239],"length":1,"stats":{"Line":2}},{"line":370,"address":[1769218,1768482,1768549],"length":1,"stats":{"Line":2}},{"line":371,"address":[1768807,1768756],"length":1,"stats":{"Line":2}},{"line":372,"address":[],"length":0,"stats":{"Line":1}},{"line":375,"address":[],"length":0,"stats":{"Line":1}},{"line":376,"address":[],"length":0,"stats":{"Line":2}},{"line":377,"address":[],"length":0,"stats":{"Line":1}}],"covered":124,"coverable":144},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","db_tests.rs"],"content":"// libmarlin/src/db_tests.rs\n\nuse super::db;\nuse rusqlite::Connection;\nuse tempfile::tempdir;\n\nfn open_mem() -\u003e Connection {\n    // helper to open an in-memory DB with migrations applied\n    db::open(\":memory:\").expect(\"open in-memory DB\")\n}\n\n#[test]\nfn ensure_tag_path_creates_hierarchy() {\n    let conn = open_mem();\n    // create foo/bar/baz\n    let leaf = db::ensure_tag_path(\u0026conn, \"foo/bar/baz\").unwrap();\n    // foo should exist as a root tag\n    let foo: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='foo' AND parent_id IS NULL\",\n            [],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // bar should be child of foo\n    let bar: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='bar' AND parent_id = ?1\",\n            [foo],\n            |r| r.get(0),\n        )\n        .unwrap();\n    // baz should be child of bar, and its ID is what we got back\n    let baz: i64 = conn\n        .query_row(\n            \"SELECT id FROM tags WHERE name='baz' AND parent_id = ?1\",\n            [bar],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(leaf, baz);\n}\n\n#[test]\nfn upsert_attr_inserts_and_updates() {\n    let conn = open_mem();\n    // insert a dummy file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"a.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='a.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // insert\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v\").unwrap();\n    let v1: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v1, \"v\");\n\n    // update\n    db::upsert_attr(\u0026conn, fid, \"k\", \"v2\").unwrap();\n    let v2: String = conn\n        .query_row(\n            \"SELECT value FROM attributes WHERE file_id=?1 AND key='k'\",\n            [fid],\n            |r| r.get(0),\n        )\n        .unwrap();\n    assert_eq!(v2, \"v2\");\n}\n\n#[test]\nfn add_and_remove_links_and_backlinks() {\n    let conn = open_mem();\n    // create two files\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"one.txt\"],\n    )\n    .unwrap();\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"two.txt\"],\n    )\n    .unwrap();\n    let src: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='one.txt'\", [], |r| r.get(0))\n        .unwrap();\n    let dst: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='two.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    // add a link of type \"ref\"\n    db::add_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let out = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert_eq!(out.len(), 1);\n    assert_eq!(out[0].2.as_deref(), Some(\"ref\"));\n\n    // backlinks should mirror\n    let back = db::find_backlinks(\u0026conn, \"two%\").unwrap();\n    assert_eq!(back.len(), 1);\n    assert_eq!(back[0].1.as_deref(), Some(\"ref\"));\n\n    // remove it\n    db::remove_link(\u0026conn, src, dst, Some(\"ref\")).unwrap();\n    let empty = db::list_links(\u0026conn, \"one%\", None, None).unwrap();\n    assert!(empty.is_empty());\n}\n\n#[test]\nfn collections_roundtrip() {\n    let conn = open_mem();\n    // create collection \"C\"\n    let cid = db::ensure_collection(\u0026conn, \"C\").unwrap();\n\n    // add a file\n    conn.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"f.txt\"],\n    )\n    .unwrap();\n    let fid: i64 = conn\n        .query_row(\"SELECT id FROM files WHERE path='f.txt'\", [], |r| r.get(0))\n        .unwrap();\n\n    db::add_file_to_collection(\u0026conn, cid, fid).unwrap();\n    let files = db::list_collection(\u0026conn, \"C\").unwrap();\n    assert_eq!(files, vec![\"f.txt\".to_string()]);\n}\n\n#[test]\nfn views_save_and_query() {\n    let conn = open_mem();\n    db::save_view(\u0026conn, \"v1\", \"some_query\").unwrap();\n    let all = db::list_views(\u0026conn).unwrap();\n    assert_eq!(all, vec![(\"v1\".to_string(), \"some_query\".to_string())]);\n\n    let q = db::view_query(\u0026conn, \"v1\").unwrap();\n    assert_eq!(q, \"some_query\");\n}\n\n#[test]\nfn backup_and_restore_cycle() {\n    let tmp = tempdir().unwrap();\n    let db_path = tmp.path().join(\"data.db\");\n    let live = db::open(\u0026db_path).unwrap();\n\n    // insert a file\n    live.execute(\n        \"INSERT INTO files(path, size, mtime) VALUES (?1, 0, 0)\",\n        [\"x.bin\"],\n    )\n    .unwrap();\n\n    // backup\n    let backup = db::backup(\u0026db_path).unwrap();\n    // remove original\n    std::fs::remove_file(\u0026db_path).unwrap();\n    // restore\n    db::restore(\u0026backup, \u0026db_path).unwrap();\n\n    // reopen and check that x.bin survived\n    let conn2 = db::open(\u0026db_path).unwrap();\n    let cnt: i64 =\n        conn2.query_row(\"SELECT COUNT(*) FROM files WHERE path='x.bin'\", [], |r| r.get(0)).unwrap();\n    assert_eq!(cnt, 1);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","error.rs"],"content":"// libmarlin/src/error.rs\n\nuse std::io;\nuse std::fmt;\n// Ensure these are present if Error enum variants use them directly\n// use rusqlite;\n// use notify;\n\npub type Result\u003cT\u003e = std::result::Result\u003cT, Error\u003e;\n\n#[derive(Debug)]\npub enum Error {\n    Io(io::Error),\n    Database(rusqlite::Error), \n    Watch(notify::Error),    \n    InvalidState(String),\n    NotFound(String),\n    Config(String),\n    Other(String),\n}\n\nimpl fmt::Display for Error {\n    fn fmt(\u0026self, f: \u0026mut fmt::Formatter\u003c'_\u003e) -\u003e fmt::Result {\n        match self {\n            Self::Io(err) =\u003e write!(f, \"IO error: {}\", err),\n            Self::Database(err) =\u003e write!(f, \"Database error: {}\", err),\n            Self::Watch(err) =\u003e write!(f, \"Watch error: {}\", err),\n            Self::InvalidState(msg) =\u003e write!(f, \"Invalid state: {}\", msg),\n            Self::NotFound(path) =\u003e write!(f, \"Not found: {}\", path),\n            Self::Config(msg) =\u003e write!(f, \"Configuration error: {}\", msg),\n            Self::Other(msg) =\u003e write!(f, \"Error: {}\", msg),\n        }\n    }\n}\n\nimpl std::error::Error for Error {\n    fn source(\u0026self) -\u003e Option\u003c\u0026(dyn std::error::Error + 'static)\u003e {\n        match self {\n            Self::Io(err) =\u003e Some(err),\n            Self::Database(err) =\u003e Some(err),\n            Self::Watch(err) =\u003e Some(err),\n            Self::InvalidState(_) | Self::NotFound(_) | Self::Config(_) | Self::Other(_) =\u003e None,\n        }\n    }\n}\n\nimpl From\u003cio::Error\u003e for Error {\n    fn from(err: io::Error) -\u003e Self {\n        Self::Io(err)\n    }\n}\n\nimpl From\u003crusqlite::Error\u003e for Error {\n    fn from(err: rusqlite::Error) -\u003e Self {\n        Self::Database(err)\n    }\n}\n\nimpl From\u003cnotify::Error\u003e for Error {\n    fn from(err: notify::Error) -\u003e Self {\n        Self::Watch(err)\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n    use std::error::Error as StdError; \n\n    #[test]\n    fn test_error_display_and_from() {\n        // Test Io variant\n        let io_err_inner_for_source_check = io::Error::new(io::ErrorKind::NotFound, \"test io error\");\n        let io_err_marlin = Error::from(io::Error::new(io::ErrorKind::NotFound, \"test io error\"));\n        assert_eq!(io_err_marlin.to_string(), \"IO error: test io error\");\n        let source = io_err_marlin.source();\n        assert!(source.is_some(), \"Io error should have a source\");\n        if let Some(s) = source {\n            // Compare details of the source if necessary, or just its string representation\n            assert_eq!(s.to_string(), io_err_inner_for_source_check.to_string());\n        }\n\n        // Test Database variant\n        let rusqlite_err_inner_for_source_check = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        );\n        // We need to create the error again for the From conversion if we want to compare the source\n        let db_err_marlin = Error::from(rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_ERROR), \n            Some(\"test db error\".to_string()),\n        ));\n        assert!(db_err_marlin.to_string().contains(\"Database error: test db error\"));\n        let source = db_err_marlin.source();\n        assert!(source.is_some(), \"Database error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), rusqlite_err_inner_for_source_check.to_string());\n        }\n\n\n        // Test Watch variant\n        let notify_raw_err_inner_for_source_check = notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string()));\n        let watch_err_marlin = Error::from(notify::Error::new(notify::ErrorKind::Generic(\"test watch error\".to_string())));\n        assert!(watch_err_marlin.to_string().contains(\"Watch error: test watch error\"));\n        let source = watch_err_marlin.source();\n        assert!(source.is_some(), \"Watch error should have a source\");\n        if let Some(s) = source {\n            assert_eq!(s.to_string(), notify_raw_err_inner_for_source_check.to_string());\n        }\n\n\n        let invalid_state_err = Error::InvalidState(\"bad state\".to_string());\n        assert_eq!(invalid_state_err.to_string(), \"Invalid state: bad state\");\n        assert!(invalid_state_err.source().is_none());\n\n        let not_found_err = Error::NotFound(\"missing_file.txt\".to_string());\n        assert_eq!(not_found_err.to_string(), \"Not found: missing_file.txt\");\n        assert!(not_found_err.source().is_none());\n\n        let config_err = Error::Config(\"bad config\".to_string());\n        assert_eq!(config_err.to_string(), \"Configuration error: bad config\");\n        assert!(config_err.source().is_none());\n\n        let other_err = Error::Other(\"some other issue\".to_string());\n        assert_eq!(other_err.to_string(), \"Error: some other issue\");\n        assert!(other_err.source().is_none());\n    }\n\n    #[test]\n    fn test_rusqlite_error_without_message() {\n        let sqlite_busy_error = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        );\n        let db_err_no_msg = Error::from(sqlite_busy_error);\n        \n        let expected_rusqlite_msg = rusqlite::Error::SqliteFailure(\n            rusqlite::ffi::Error::new(rusqlite::ffi::SQLITE_BUSY),\n            None,\n        ).to_string(); \n        \n        let expected_marlin_msg = format!(\"Database error: {}\", expected_rusqlite_msg);\n        \n        // Verify the string matches the expected format\n        assert_eq!(db_err_no_msg.to_string(), expected_marlin_msg);\n        \n        // Check the error code directly instead of the string\n        if let Error::Database(rusqlite::Error::SqliteFailure(err, _)) = \u0026db_err_no_msg {\n            assert_eq!(err.code, rusqlite::ffi::ErrorCode::DatabaseBusy);\n        } else {\n            panic!(\"Expected Error::Database variant\");\n        }\n        \n        // Verify the source exists\n        assert!(db_err_no_msg.source().is_some());\n    }\n}","traces":[{"line":23,"address":[5592736],"length":1,"stats":{"Line":1}},{"line":24,"address":[2070560],"length":1,"stats":{"Line":1}},{"line":25,"address":[2070624],"length":1,"stats":{"Line":1}},{"line":26,"address":[2070722],"length":1,"stats":{"Line":1}},{"line":27,"address":[2070839],"length":1,"stats":{"Line":1}},{"line":28,"address":[2070966],"length":1,"stats":{"Line":1}},{"line":29,"address":[2071094],"length":1,"stats":{"Line":1}},{"line":30,"address":[2071222],"length":1,"stats":{"Line":1}},{"line":31,"address":[2071347],"length":1,"stats":{"Line":1}},{"line":37,"address":[2071488],"length":1,"stats":{"Line":1}},{"line":38,"address":[2071498],"length":1,"stats":{"Line":1}},{"line":39,"address":[2071563],"length":1,"stats":{"Line":1}},{"line":40,"address":[5593804],"length":1,"stats":{"Line":2}},{"line":41,"address":[2071625],"length":1,"stats":{"Line":1}},{"line":42,"address":[2071653],"length":1,"stats":{"Line":1}},{"line":48,"address":[2071680],"length":1,"stats":{"Line":1}},{"line":49,"address":[2071688],"length":1,"stats":{"Line":1}},{"line":54,"address":[2071712],"length":1,"stats":{"Line":1}},{"line":55,"address":[2071720],"length":1,"stats":{"Line":1}},{"line":60,"address":[2071744],"length":1,"stats":{"Line":1}},{"line":61,"address":[2071761],"length":1,"stats":{"Line":1}}],"covered":21,"coverable":21},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","facade_tests.rs"],"content":"// libmarlin/src/facade_tests.rs\n\nuse super::*;             // brings Marlin, config, etc.\nuse std::{env, fs};\nuse tempfile::tempdir;\n\n#[test]\nfn open_at_and_scan_and_search() {\n    // 1) Prepare a temp workspace with one file\n    let tmp = tempdir().unwrap();\n    let file = tmp.path().join(\"hello.txt\");\n    fs::write(\u0026file, \"hello FAÇT\").unwrap();\n\n    // 2) Use open_at to create a fresh DB\n    let db_path = tmp.path().join(\"explicit.db\");\n    let mut m = Marlin::open_at(\u0026db_path).expect(\"open_at should succeed\");\n    assert!(db_path.exists(), \"DB file should be created\");\n\n    // 3) Scan the directory\n    let count = m.scan(\u0026[tmp.path()]).expect(\"scan should succeed\");\n    assert_eq!(count, 1, \"we created exactly one file\");\n\n    // 4) Search using an FTS hit\n    let hits = m.search(\"hello\").expect(\"search must not error\");\n    assert_eq!(hits.len(), 1);\n    assert!(hits[0].ends_with(\"hello.txt\"));\n\n    // 5) Search a substring that isn't a valid token (fires fallback)\n    let fallback_hits = m.search(\"FAÇT\").expect(\"fallback search works\");\n    assert_eq!(fallback_hits.len(), 1);\n    assert!(fallback_hits[0].ends_with(\"hello.txt\"));\n}\n\n#[test]\nfn tag_and_search_by_tag() {\n    let tmp = tempdir().unwrap();\n    let a = tmp.path().join(\"a.md\");\n    let b = tmp.path().join(\"b.md\");\n    fs::write(\u0026a, \"# a\").unwrap();\n    fs::write(\u0026b, \"# b\").unwrap();\n\n    let db_path = tmp.path().join(\"my.db\");\n    env::set_var(\"MARLIN_DB_PATH\", \u0026db_path);\n\n    let mut m = Marlin::open_default().unwrap();\n    m.scan(\u0026[tmp.path()]).unwrap();\n\n    let changed = m.tag(\"*.md\", \"foo/bar\").unwrap();\n    assert_eq!(changed, 2);\n\n    let tagged = m.search(\"tags_text:\\\"foo/bar\\\"\").unwrap();\n    assert_eq!(tagged.len(), 2);\n\n    env::remove_var(\"MARLIN_DB_PATH\");\n}\n\n#[test]\nfn open_default_fallback_config() {\n    // Unset all overrides\n    env::remove_var(\"MARLIN_DB_PATH\");\n    env::remove_var(\"XDG_DATA_HOME\");\n\n    // Simulate no XDG: temporarily point HOME to a read-only dir\n    let fake_home = tempdir().unwrap();\n    env::set_var(\"HOME\", fake_home.path());\n    // This should fall back to \"./index_\u003chash\u003e.db\"\n    let cfg = config::Config::load().unwrap();\n    let fname = cfg.db_path.file_name().unwrap().to_string_lossy();\n    assert!(fname.starts_with(\"index_\") \u0026\u0026 fname.ends_with(\".db\"));\n\n    // Clean up\n    env::remove_var(\"HOME\");\n}\n\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","lib.rs"],"content":"//! libmarlin – public API surface for the Marlin core.\n//!\n//! Down-stream crates (`cli-bin`, `tui-bin`, tests, plugins) should depend\n//! *only* on the helpers re-exported here, never on internal modules\n//! directly.  That gives us room to refactor internals without breaking\n//! callers.\n\n#![deny(warnings)]\n\npub mod backup;\npub mod config;\npub mod db;\npub mod error;\npub mod logging;\npub mod scan;\npub mod utils;\npub mod watcher;\n\n#[cfg(test)]\nmod utils_tests;\n#[cfg(test)]\nmod config_tests;\n#[cfg(test)]\nmod scan_tests;\n#[cfg(test)]\nmod logging_tests;\n#[cfg(test)]\nmod db_tests;\n#[cfg(test)]\nmod facade_tests;\n#[cfg(test)]\nmod watcher_tests;\n\nuse anyhow::{Context, Result};\nuse rusqlite::Connection;\nuse std::{fs, path::Path, sync::{Arc, Mutex}};\n\n/// Main handle for interacting with a Marlin database.\npub struct Marlin {\n    #[allow(dead_code)]\n    cfg: config::Config,\n    conn: Connection,\n}\n\nimpl Marlin {\n    /// Open using the default config (env override or XDG/CWD fallback),\n    /// ensuring parent directories exist and applying migrations.\n    pub fn open_default() -\u003e Result\u003cSelf\u003e {\n        // 1) Load configuration\n        let cfg = config::Config::load()?;\n        // 2) Ensure the DB's parent directory exists\n        if let Some(parent) = cfg.db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // 3) Open the database and run migrations\n        let conn = db::open(\u0026cfg.db_path)\n            .context(format!(\"opening database at {}\", cfg.db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Open a Marlin instance at the specified database path,\n    /// creating parent directories and applying migrations.\n    pub fn open_at\u003cP: AsRef\u003cPath\u003e\u003e(db_path: P) -\u003e Result\u003cSelf\u003e {\n        let db_path = db_path.as_ref();\n        // Ensure the specified DB directory exists\n        if let Some(parent) = db_path.parent() {\n            fs::create_dir_all(parent)?;\n        }\n        // Build a minimal Config so callers can still inspect cfg.db_path\n        let cfg = config::Config { db_path: db_path.to_path_buf() };\n        // Open the database and run migrations\n        let conn = db::open(db_path)\n            .context(format!(\"opening database at {}\", db_path.display()))?;\n        Ok(Marlin { cfg, conn })\n    }\n\n    /// Recursively index one or more directories.\n    pub fn scan\u003cP: AsRef\u003cPath\u003e\u003e(\u0026mut self, paths: \u0026[P]) -\u003e Result\u003cusize\u003e {\n        let mut total = 0;\n        for p in paths {\n            total += scan::scan_directory(\u0026mut self.conn, p.as_ref())?;\n        }\n        Ok(total)\n    }\n\n    /// Attach a hierarchical tag (`foo/bar`) to every _indexed_ file\n    /// matching the glob.  Returns the number of files actually updated.\n    pub fn tag(\u0026mut self, pattern: \u0026str, tag_path: \u0026str) -\u003e Result\u003cusize\u003e {\n        use glob::Pattern;\n\n        // 1) ensure tag hierarchy\n        let leaf = db::ensure_tag_path(\u0026self.conn, tag_path)?;\n\n        // 2) collect leaf + ancestors\n        let mut tag_ids = Vec::new();\n        let mut cur = Some(leaf);\n        while let Some(id) = cur {\n            tag_ids.push(id);\n            cur = self.conn.query_row(\n                \"SELECT parent_id FROM tags WHERE id = ?1\",\n                [id],\n                |r| r.get::\u003c_, Option\u003ci64\u003e\u003e(0),\n            )?;\n        }\n\n        // 3) match files by glob against stored paths\n        let expanded = shellexpand::tilde(pattern).into_owned();\n        let pat = Pattern::new(\u0026expanded)\n            .with_context(|| format!(\"Invalid glob pattern `{}`\", expanded))?;\n\n        let mut stmt_all = self.conn.prepare(\"SELECT id, path FROM files\")?;\n        let rows = stmt_all.query_map([], |r| Ok((r.get(0)?, r.get(1)?)))?;\n\n        let mut stmt_ins = self.conn.prepare(\n            \"INSERT OR IGNORE INTO file_tags(file_id, tag_id) VALUES (?1, ?2)\",\n        )?;\n\n        let mut changed = 0;\n        for row in rows {\n            let (fid, path_str): (i64, String) = row?;\n            let is_match = if expanded.contains(std::path::MAIN_SEPARATOR) {\n                pat.matches(\u0026path_str)\n            } else {\n                Path::new(\u0026path_str)\n                    .file_name()\n                    .and_then(|n| n.to_str())\n                    .map(|n| pat.matches(n))\n                    .unwrap_or(false)\n            };\n            if !is_match {\n                continue;\n            }\n\n            let mut newly = false;\n            for \u0026tid in \u0026tag_ids {\n                if stmt_ins.execute([fid, tid])? \u003e 0 {\n                    newly = true;\n                }\n            }\n            if newly {\n                changed += 1;\n            }\n        }\n        Ok(changed)\n    }\n\n    /// Full-text search over path, tags, and attrs, with substring fallback.\n    pub fn search(\u0026self, query: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let mut stmt = self.conn.prepare(\n            \"SELECT f.path FROM files_fts JOIN files f ON f.rowid = files_fts.rowid WHERE files_fts MATCH ?1 ORDER BY rank\",\n        )?;\n        let mut hits = stmt.query_map([query], |r| r.get(0))?\n            .collect::\u003cstd::result::Result\u003cVec\u003c_\u003e, rusqlite::Error\u003e\u003e()?;\n\n        if hits.is_empty() \u0026\u0026 !query.contains(':') {\n            hits = self.fallback_search(query)?;\n        }\n        Ok(hits)\n    }\n\n    fn fallback_search(\u0026self, term: \u0026str) -\u003e Result\u003cVec\u003cString\u003e\u003e {\n        let needle = term.to_lowercase();\n        let mut stmt = self.conn.prepare(\"SELECT path FROM files\")?;\n        let rows = stmt.query_map([], |r| r.get(0))?;\n        let mut out = Vec::new();\n        for res in rows {\n            let p: String = res?;\n            if p.to_lowercase().contains(\u0026needle) {\n                out.push(p.clone());\n                continue;\n            }\n            if let Ok(meta) = fs::metadata(\u0026p) {\n                if meta.len() \u003c= 65_536 { \n                    if let Ok(body) = fs::read_to_string(\u0026p) {\n                        if body.to_lowercase().contains(\u0026needle) {\n                            out.push(p.clone());\n                        }\n                    }\n                }\n            }\n        }\n        Ok(out)\n    }\n\n    /// Borrow the raw SQLite connection.\n    pub fn conn(\u0026self) -\u003e \u0026Connection {\n        \u0026self.conn\n    }\n\n    /// Spawn a file-watcher that indexes changes in real time.\n    pub fn watch\u003cP: AsRef\u003cPath\u003e\u003e(\n        \u0026mut self,\n        path: P,\n        config: Option\u003cwatcher::WatcherConfig\u003e,\n    ) -\u003e Result\u003cwatcher::FileWatcher\u003e {\n        let cfg = config.unwrap_or_default();\n        let p = path.as_ref().to_path_buf();\n        let new_conn = db::open(\u0026self.cfg.db_path)\n            .context(\"opening database for watcher\")?;\n        let watcher_db = Arc::new(Mutex::new(db::Database::new(new_conn)));\n        \n        let mut owned_w = watcher::FileWatcher::new(vec![p], cfg)?;\n        owned_w.with_database(watcher_db); // Modifies owned_w in place\n        owned_w.start()?; // Start the watcher after it has been fully configured\n        \n        Ok(owned_w) // Return the owned FileWatcher\n    }\n}","traces":[{"line":48,"address":[5390765,5389632,5390771],"length":1,"stats":{"Line":1}},{"line":50,"address":[2099265],"length":1,"stats":{"Line":1}},{"line":52,"address":[2099509,2099445],"length":1,"stats":{"Line":2}},{"line":53,"address":[2099619,2099656],"length":1,"stats":{"Line":2}},{"line":56,"address":[2099768,2100122,2100080,2100017,2099644,2100322],"length":1,"stats":{"Line":4}},{"line":57,"address":[2100335,2099781,2100056,2099798,2100106],"length":1,"stats":{"Line":2}},{"line":58,"address":[2100169],"length":1,"stats":{"Line":1}},{"line":63,"address":[],"length":0,"stats":{"Line":1}},{"line":64,"address":[1683573,1683494],"length":1,"stats":{"Line":2}},{"line":66,"address":[],"length":0,"stats":{"Line":1}},{"line":67,"address":[],"length":0,"stats":{"Line":2}},{"line":70,"address":[1683849,1683722],"length":1,"stats":{"Line":2}},{"line":72,"address":[],"length":0,"stats":{"Line":4}},{"line":73,"address":[1683970,1684199,1683954,1684249,1684500],"length":1,"stats":{"Line":2}},{"line":74,"address":[],"length":0,"stats":{"Line":1}},{"line":78,"address":[],"length":0,"stats":{"Line":1}},{"line":79,"address":[],"length":0,"stats":{"Line":1}},{"line":80,"address":[],"length":0,"stats":{"Line":2}},{"line":81,"address":[1684843,1684765,1684666],"length":1,"stats":{"Line":1}},{"line":83,"address":[],"length":0,"stats":{"Line":1}},{"line":88,"address":[5395118,5394802,5390784],"length":1,"stats":{"Line":1}},{"line":92,"address":[2100477],"length":1,"stats":{"Line":1}},{"line":95,"address":[5391027],"length":1,"stats":{"Line":1}},{"line":96,"address":[2100629],"length":1,"stats":{"Line":1}},{"line":97,"address":[5391516,5391069],"length":1,"stats":{"Line":2}},{"line":98,"address":[5391107],"length":1,"stats":{"Line":1}},{"line":99,"address":[2100811,2100799,2101093,2100986],"length":1,"stats":{"Line":2}},{"line":101,"address":[2100803],"length":1,"stats":{"Line":1}},{"line":102,"address":[1684864,1684880],"length":1,"stats":{"Line":2}},{"line":107,"address":[5391149,5391572],"length":1,"stats":{"Line":2}},{"line":108,"address":[5391607,5391824,5395100,5391690],"length":1,"stats":{"Line":2}},{"line":109,"address":[5391808],"length":1,"stats":{"Line":0}},{"line":111,"address":[2101540,2104506,2101615],"length":1,"stats":{"Line":2}},{"line":112,"address":[5600128,5600174],"length":1,"stats":{"Line":4}},{"line":114,"address":[5392707,5392901,5394889,5392779],"length":1,"stats":{"Line":2}},{"line":118,"address":[5393106],"length":1,"stats":{"Line":1}},{"line":119,"address":[2102748,2102641,2102824],"length":1,"stats":{"Line":3}},{"line":120,"address":[2102941,2104294,2103115],"length":1,"stats":{"Line":2}},{"line":121,"address":[2103353,2103436],"length":1,"stats":{"Line":2}},{"line":122,"address":[5394005,5394179],"length":1,"stats":{"Line":0}},{"line":124,"address":[2103474,2103529],"length":1,"stats":{"Line":2}},{"line":126,"address":[5600654,5600640],"length":1,"stats":{"Line":2}},{"line":127,"address":[5600690,5600672],"length":1,"stats":{"Line":2}},{"line":130,"address":[2103643],"length":1,"stats":{"Line":1}},{"line":134,"address":[5394239],"length":1,"stats":{"Line":1}},{"line":135,"address":[2103741],"length":1,"stats":{"Line":1}},{"line":136,"address":[2103879,2104015,2104208],"length":1,"stats":{"Line":3}},{"line":137,"address":[5394726],"length":1,"stats":{"Line":1}},{"line":140,"address":[5394448,5394515],"length":1,"stats":{"Line":2}},{"line":141,"address":[2103995,2103958],"length":1,"stats":{"Line":1}},{"line":144,"address":[2102966],"length":1,"stats":{"Line":1}},{"line":148,"address":[5396601,5395136,5396611],"length":1,"stats":{"Line":1}},{"line":149,"address":[2104664,2104781],"length":1,"stats":{"Line":1}},{"line":152,"address":[1685667,1685632],"length":1,"stats":{"Line":4}},{"line":155,"address":[2105465,2105536,2105656,2105992],"length":1,"stats":{"Line":4}},{"line":156,"address":[5396430,5396266],"length":1,"stats":{"Line":1}},{"line":158,"address":[2105547],"length":1,"stats":{"Line":1}},{"line":161,"address":[5399481,5399133,5396624],"length":1,"stats":{"Line":1}},{"line":162,"address":[2106145],"length":1,"stats":{"Line":1}},{"line":163,"address":[2106261,2106186,2108847],"length":1,"stats":{"Line":2}},{"line":164,"address":[5397140,5397211,5399458],"length":1,"stats":{"Line":4}},{"line":165,"address":[2106856],"length":1,"stats":{"Line":1}},{"line":166,"address":[2106916,2107008,2107084],"length":1,"stats":{"Line":3}},{"line":167,"address":[2107346,2107201],"length":1,"stats":{"Line":2}},{"line":168,"address":[2107552,2107623],"length":1,"stats":{"Line":2}},{"line":169,"address":[2108664],"length":1,"stats":{"Line":0}},{"line":172,"address":[2107894,2107804],"length":1,"stats":{"Line":2}},{"line":173,"address":[2107962,2108574,2107901],"length":1,"stats":{"Line":3}},{"line":174,"address":[2107990,2108088],"length":1,"stats":{"Line":2}},{"line":175,"address":[2108136,2108207],"length":1,"stats":{"Line":2}},{"line":176,"address":[2108391],"length":1,"stats":{"Line":1}},{"line":182,"address":[2107234],"length":1,"stats":{"Line":1}},{"line":186,"address":[2108864],"length":1,"stats":{"Line":0}},{"line":187,"address":[2108872],"length":1,"stats":{"Line":0}},{"line":191,"address":[2308196,2309672,2308112],"length":1,"stats":{"Line":0}},{"line":196,"address":[],"length":0,"stats":{"Line":0}},{"line":197,"address":[],"length":0,"stats":{"Line":0}},{"line":198,"address":[],"length":0,"stats":{"Line":0}},{"line":200,"address":[],"length":0,"stats":{"Line":0}},{"line":202,"address":[],"length":0,"stats":{"Line":0}},{"line":203,"address":[2309358],"length":1,"stats":{"Line":0}},{"line":204,"address":[2309429],"length":1,"stats":{"Line":0}},{"line":206,"address":[2309555],"length":1,"stats":{"Line":0}}],"covered":69,"coverable":83},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging.rs"],"content":"use tracing_subscriber::{fmt, EnvFilter};\n\n/// Initialise global tracing subscriber.\n///\n/// Reads `RUST_LOG` for filtering, falls back to `info`.\npub fn init() {\n    let filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new(\"info\"));\n\n    // All tracing output (INFO, WARN, ERROR …) now goes to *stderr* so the\n    // integration tests can assert on warnings / errors reliably.\n    fmt()\n        .with_target(false)        // hide module targets\n        .with_level(true)          // include log level\n        .with_env_filter(filter)   // respect RUST_LOG\n        .with_writer(std::io::stderr) // \u003c-- NEW: send to stderr\n        .init();\n}\n","traces":[{"line":6,"address":[2108944,2109307,2109278],"length":1,"stats":{"Line":1}},{"line":7,"address":[2108981],"length":1,"stats":{"Line":1}},{"line":11,"address":[2109041,2109119,2109197],"length":1,"stats":{"Line":3}},{"line":14,"address":[2109154],"length":1,"stats":{"Line":1}}],"covered":4,"coverable":4},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","logging_tests.rs"],"content":"// libmarlin/src/logging_tests.rs\n\nuse super::logging;\nuse tracing::Level;\n\n#[test]\nfn init_sets_up_subscriber() {\n    // set RUST_LOG to something to test the EnvFilter path\n    std::env::set_var(\"RUST_LOG\", \"debug\");\n    logging::init();\n    tracing::event!(Level::INFO, \"this is a test log\");\n    // if we made it here without panic, we’re good\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan.rs"],"content":"// src/scan.rs\n\nuse std::fs;\nuse std::path::Path;\n\nuse anyhow::Result;\nuse rusqlite::{params, Connection};\nuse tracing::{debug, info};\nuse walkdir::WalkDir;\n\n/// Recursively walk `root` and upsert file metadata.\n/// Triggers keep the FTS table in sync.\npub fn scan_directory(conn: \u0026mut Connection, root: \u0026Path) -\u003e Result\u003cusize\u003e {\n    // Begin a transaction so we batch many inserts/updates together\n    let tx = conn.transaction()?;\n\n    // Prepare the upsert statement once\n    let mut stmt = tx.prepare(\n        r#\"\n        INSERT INTO files(path, size, mtime)\n        VALUES (?1, ?2, ?3)\n        ON CONFLICT(path) DO UPDATE\n            SET size  = excluded.size,\n                mtime = excluded.mtime\n        \"#,\n    )?;\n\n    let mut count = 0usize;\n\n    // Walk the directory recursively\n    for entry in WalkDir::new(root)\n        .into_iter()\n        .filter_map(Result::ok)\n        .filter(|e| e.file_type().is_file())\n    {\n        let path = entry.path();\n\n        // Skip the database file and its WAL/SHM siblings\n        if let Some(name) = path.file_name().and_then(|n| n.to_str()) {\n            if name.ends_with(\".db\") || name.ends_with(\"-wal\") || name.ends_with(\"-shm\") {\n                continue;\n            }\n        }\n\n        // Gather file metadata\n        let meta = fs::metadata(path)?;\n        let size = meta.len() as i64;\n        let mtime = meta\n            .modified()?\n            .duration_since(std::time::UNIX_EPOCH)?\n            .as_secs() as i64;\n\n        // Execute the upsert\n        let path_str = path.to_string_lossy();\n        stmt.execute(params![path_str, size, mtime])?;\n        count += 1;\n\n        debug!(file = %path_str, \"indexed\");\n    }\n\n    // Finalize and commit\n    drop(stmt);\n    tx.commit()?;\n\n    info!(indexed = count, \"scan complete\");\n    Ok(count)\n}\n","traces":[{"line":13,"address":[5442107,5436832,5441856],"length":1,"stats":{"Line":1}},{"line":15,"address":[1954756],"length":1,"stats":{"Line":1}},{"line":18,"address":[1959810,1954971,1955035,1955184],"length":1,"stats":{"Line":2}},{"line":28,"address":[1955409],"length":1,"stats":{"Line":1}},{"line":31,"address":[1955477,1955429,1955662],"length":1,"stats":{"Line":3}},{"line":34,"address":[2057035,2057008],"length":1,"stats":{"Line":2}},{"line":36,"address":[1957173,1955747],"length":1,"stats":{"Line":2}},{"line":39,"address":[1957211],"length":1,"stats":{"Line":3}},{"line":40,"address":[1957388,1957463,1957544],"length":1,"stats":{"Line":3}},{"line":46,"address":[1957612,1959697,1957434],"length":1,"stats":{"Line":2}},{"line":47,"address":[5440026],"length":1,"stats":{"Line":1}},{"line":48,"address":[1958123,1957851,1959629,1957947],"length":1,"stats":{"Line":1}},{"line":49,"address":[5440141],"length":1,"stats":{"Line":0}},{"line":50,"address":[5440311],"length":1,"stats":{"Line":0}},{"line":54,"address":[1958255],"length":1,"stats":{"Line":1}},{"line":55,"address":[5441802,5440654,5440492],"length":1,"stats":{"Line":2}},{"line":56,"address":[1958607,1958667],"length":1,"stats":{"Line":1}},{"line":58,"address":[1958691,1958642,1958936],"length":1,"stats":{"Line":3}},{"line":62,"address":[1955800],"length":1,"stats":{"Line":1}},{"line":63,"address":[1957078,1955903],"length":1,"stats":{"Line":1}},{"line":65,"address":[1956459,1956110],"length":1,"stats":{"Line":2}},{"line":66,"address":[1956410],"length":1,"stats":{"Line":1}}],"covered":20,"coverable":22},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","scan_tests.rs"],"content":"// libmarlin/src/scan_tests.rs\n\nuse super::scan::scan_directory;\nuse super::db;\nuse tempfile::tempdir;\nuse std::fs::File;\n\n#[test]\nfn scan_directory_counts_files() {\n    let tmp = tempdir().unwrap();\n\n    // create a couple of files\n    File::create(tmp.path().join(\"a.txt\")).unwrap();\n    File::create(tmp.path().join(\"b.log\")).unwrap();\n\n    // open an in-memory DB (runs migrations)\n    let mut conn = db::open(\":memory:\").unwrap();\n\n    let count = scan_directory(\u0026mut conn, tmp.path()).unwrap();\n    assert_eq!(count, 2);\n\n    // ensure the paths were inserted\n    let mut stmt = conn.prepare(\"SELECT COUNT(*) FROM files\").unwrap();\n    let total: i64 = stmt.query_row([], |r| r.get(0)).unwrap();\n    assert_eq!(total, 2);\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils.rs"],"content":"//! Misc shared helpers.\n\nuse std::path::PathBuf;\n\n/// Determine a filesystem root to limit recursive walking on glob scans.\n///\n/// If the pattern contains any of `*?[`, we take everything up to the\n/// first such character, and then (if that still contains metacharacters)\n/// walk up until there aren’t any left.  If there are *no* metachars at\n/// all, we treat the entire string as a path and return its parent\n/// directory (or `.` if it has no parent).\npub fn determine_scan_root(pattern: \u0026str) -\u003e PathBuf {\n    // find first wildcard char\n    let first_wild = pattern\n        .find(|c| matches!(c, '*' | '?' | '['))\n        .unwrap_or(pattern.len());\n\n    // everything up to the wildcard (or the whole string if none)\n    let prefix = \u0026pattern[..first_wild];\n    let mut root = PathBuf::from(prefix);\n\n    // If there were NO wildcards at all, just return the parent directory\n    if first_wild == pattern.len() {\n        return root.parent().map(|p| p.to_path_buf()).unwrap_or_else(|| PathBuf::from(\".\"));\n    }\n\n    // Otherwise, if the prefix still has any wildcards (e.g. \"foo*/bar\"),\n    // walk back up until it doesn’t\n    while root\n        .as_os_str()\n        .to_string_lossy()\n        .chars()\n        .any(|c| matches!(c, '*' | '?' | '['))\n    {\n        root = root.parent().map(|p| p.to_path_buf()).unwrap_or_default();\n    }\n\n    if root.as_os_str().is_empty() {\n        PathBuf::from(\".\")\n    } else {\n        root\n    }\n}\n","traces":[{"line":12,"address":[5518304,5519621,5519490],"length":1,"stats":{"Line":1}},{"line":14,"address":[1785170,1785101],"length":1,"stats":{"Line":2}},{"line":15,"address":[2163328,2163341],"length":1,"stats":{"Line":2}},{"line":16,"address":[1785146],"length":1,"stats":{"Line":1}},{"line":19,"address":[1785217],"length":1,"stats":{"Line":1}},{"line":20,"address":[1785252],"length":1,"stats":{"Line":1}},{"line":23,"address":[1785293,1785368],"length":1,"stats":{"Line":2}},{"line":24,"address":[5629760,5629772,5629712,5629734],"length":1,"stats":{"Line":4}},{"line":29,"address":[1785381,1785454,1785591,1786189],"length":1,"stats":{"Line":3}},{"line":33,"address":[1785537,1785663],"length":1,"stats":{"Line":4}},{"line":35,"address":[1786050,1785935],"length":1,"stats":{"Line":0}},{"line":38,"address":[1785838,1785712],"length":1,"stats":{"Line":3}},{"line":39,"address":[1785883,1785848],"length":1,"stats":{"Line":2}},{"line":41,"address":[1785795],"length":1,"stats":{"Line":1}}],"covered":13,"coverable":14},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","utils_tests.rs"],"content":"// libmarlin/src/utils_tests.rs\n\nuse super::utils::determine_scan_root;\nuse std::path::PathBuf;\n\n#[test]\nfn determine_scan_root_plain_path() {\n    let root = determine_scan_root(\"foo/bar/baz.txt\");\n    assert_eq!(root, PathBuf::from(\"foo/bar\"));\n}\n\n#[test]\nfn determine_scan_root_glob() {\n    let root = determine_scan_root(\"foo/*/baz.rs\");\n    assert_eq!(root, PathBuf::from(\"foo\"));\n}\n\n#[test]\nfn determine_scan_root_only_wildcards() {\n    let root = determine_scan_root(\"**/*.txt\");\n    assert_eq!(root, PathBuf::from(\".\"));\n}\n","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher.rs"],"content":"// libmarlin/src/watcher.rs\n\n//! File system watcher implementation for Marlin\n//!\n//! This module provides real-time index updates by monitoring file system events\n//! (create, modify, delete) using the `notify` crate. It implements event debouncing,\n//! batch processing, and a state machine for robust lifecycle management.\n\nuse anyhow::{Result, Context};\nuse crate::db::Database;\nuse crossbeam_channel::{bounded, Receiver};\nuse notify::{Event, EventKind, RecommendedWatcher, RecursiveMode, Watcher as NotifyWatcherTrait};\nuse std::collections::HashMap;\nuse std::path::PathBuf;\nuse std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};\nuse std::sync::{Arc, Mutex};\nuse std::thread::{self, JoinHandle};\nuse std::time::{Duration, Instant};\n// REMOVED: use std::fs; // \u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c\u003c THIS LINE WAS REMOVED\n\n/// Configuration for the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherConfig {\n    /// Time in milliseconds to debounce file events\n    pub debounce_ms: u64,\n\n    /// Maximum number of events to process in a single batch\n    pub batch_size: usize,\n\n    /// Maximum size of the event queue before applying backpressure\n    pub max_queue_size: usize,\n\n    /// Time in milliseconds to wait for events to drain during shutdown\n    pub drain_timeout_ms: u64,\n}\n\nimpl Default for WatcherConfig {\n    fn default() -\u003e Self {\n        Self {\n            debounce_ms: 100,\n            batch_size: 1000,\n            max_queue_size: 100_000,\n            drain_timeout_ms: 5000,\n        }\n    }\n}\n\n/// State of the file watcher\n#[derive(Debug, Clone, PartialEq, Eq)]\npub enum WatcherState {\n    Initializing,\n    Watching,\n    Paused,\n    ShuttingDown,\n    Stopped,\n}\n\n/// Status information about the file watcher\n#[derive(Debug, Clone)]\npub struct WatcherStatus {\n    pub state: WatcherState,\n    pub events_processed: usize,\n    pub queue_size: usize,\n    pub start_time: Option\u003cInstant\u003e,\n    pub watched_paths: Vec\u003cPathBuf\u003e,\n}\n\n#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]\nenum EventPriority {\n    Create = 0,\n    Delete = 1,\n    Modify = 2,\n    Access = 3,\n}\n\n#[derive(Debug, Clone)]\nstruct ProcessedEvent {\n    path: PathBuf,\n    kind: EventKind,\n    priority: EventPriority,\n    timestamp: Instant,\n}\n\nstruct EventDebouncer {\n    events: HashMap\u003cPathBuf, ProcessedEvent\u003e,\n    debounce_window_ms: u64,\n    last_flush: Instant,\n}\n\nimpl EventDebouncer {\n    fn new(debounce_window_ms: u64) -\u003e Self {\n        Self {\n            events: HashMap::new(),\n            debounce_window_ms,\n            last_flush: Instant::now(),\n        }\n    }\n\n    fn add_event(\u0026mut self, event: ProcessedEvent) {\n        let path = event.path.clone();\n        if path.is_dir() { // This relies on the PathBuf itself knowing if it's a directory\n                           // or on the underlying FS. For unit tests, ensure paths are created.\n            self.events.retain(|file_path, _| !file_path.starts_with(\u0026path) || file_path == \u0026path );\n        }\n        match self.events.get_mut(\u0026path) {\n            Some(existing) =\u003e {\n                if event.priority \u003c existing.priority {\n                    existing.priority = event.priority;\n                }\n                existing.timestamp = event.timestamp;\n                existing.kind = event.kind;\n            }\n            None =\u003e {\n                self.events.insert(path, event);\n            }\n        }\n    }\n\n    fn is_ready_to_flush(\u0026self) -\u003e bool {\n        self.last_flush.elapsed() \u003e= Duration::from_millis(self.debounce_window_ms)\n    }\n\n    fn flush(\u0026mut self) -\u003e Vec\u003cProcessedEvent\u003e {\n        let mut events: Vec\u003cProcessedEvent\u003e = self.events.drain().map(|(_, e)| e).collect();\n        events.sort_by_key(|e| e.priority);\n        self.last_flush = Instant::now();\n        events\n    }\n\n    #[allow(dead_code)]\n    fn len(\u0026self) -\u003e usize {\n        self.events.len()\n    }\n}\n\n#[cfg(test)]\nmod event_debouncer_tests {\n    use super::*;\n    use notify::event::{CreateKind, DataChange, ModifyKind, RemoveKind, RenameMode};\n    use std::fs; // fs is needed for these tests to create dirs/files\n    use tempfile; \n\n    #[test]\n    fn debouncer_add_and_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110)); \n        assert!(debouncer.is_ready_to_flush());\n        assert_eq!(debouncer.len(), 0);\n\n        let path1 = PathBuf::from(\"file1.txt\");\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 1);\n        \n        debouncer.last_flush = Instant::now(); \n        assert!(!debouncer.is_ready_to_flush());\n\n        std::thread::sleep(Duration::from_millis(110));\n        assert!(debouncer.is_ready_to_flush());\n\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(debouncer.len(), 0);\n        assert!(!debouncer.is_ready_to_flush()); \n    }\n\n    #[test]\n    fn debouncer_coalesce_events() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n\n        let t1 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: t1,\n        });\n        std::thread::sleep(Duration::from_millis(10));\n        let t2 = Instant::now();\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Modify(ModifyKind::Data(DataChange::Any)),\n            priority: EventPriority::Modify,\n            timestamp: t2,\n        });\n        \n        assert_eq!(debouncer.len(), 1);\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, path1);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!( \n            flushed[0].kind,\n            EventKind::Modify(ModifyKind::Data(DataChange::Any))\n        );\n        assert_eq!(flushed[0].timestamp, t2);\n    }\n\n    #[test]\n    fn debouncer_hierarchical() {\n        let mut debouncer_h = EventDebouncer::new(100);\n        let temp_dir_obj = tempfile::tempdir().expect(\"Failed to create temp dir\");\n        let p_dir = temp_dir_obj.path().to_path_buf(); \n        let p_file = p_dir.join(\"file.txt\");\n        \n        fs::File::create(\u0026p_file).expect(\"Failed to create test file for hierarchical debounce\");\n\n        debouncer_h.add_event(ProcessedEvent {\n            path: p_file.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1);\n        \n        debouncer_h.add_event(ProcessedEvent {\n            path: p_dir.clone(), \n            kind: EventKind::Remove(RemoveKind::Folder), \n            priority: EventPriority::Delete,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer_h.len(), 1, \"Hierarchical debounce should remove child event, leaving only parent dir event\");\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer_h.flush();\n        assert_eq!(flushed.len(), 1);\n        assert_eq!(flushed[0].path, p_dir);\n    }\n\n    #[test]\n    fn debouncer_different_files() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\");\n        let path2 = PathBuf::from(\"file2.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: path1.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: path2.clone(),\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n    }\n\n    #[test]\n    fn debouncer_priority_sorting_on_flush() {\n        let mut debouncer = EventDebouncer::new(100);\n        let path1 = PathBuf::from(\"file1.txt\"); \n        let path2 = PathBuf::from(\"file2.txt\"); \n        let path3 = PathBuf::from(\"file3.txt\"); \n\n        debouncer.add_event(ProcessedEvent { path: path1, kind: EventKind::Modify(ModifyKind::Name(RenameMode::To)), priority: EventPriority::Modify, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path2, kind: EventKind::Create(CreateKind::File), priority: EventPriority::Create, timestamp: Instant::now() });\n        debouncer.add_event(ProcessedEvent { path: path3, kind: EventKind::Remove(RemoveKind::File), priority: EventPriority::Delete, timestamp: Instant::now() });\n        \n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 3);\n        assert_eq!(flushed[0].priority, EventPriority::Create); \n        assert_eq!(flushed[1].priority, EventPriority::Delete); \n        assert_eq!(flushed[2].priority, EventPriority::Modify); \n    }\n\n    #[test]\n    fn debouncer_no_events_flush_empty() {\n        let mut debouncer = EventDebouncer::new(100);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert!(flushed.is_empty());\n        assert_eq!(debouncer.len(), 0);\n    }\n\n    #[test]\n    fn debouncer_dir_then_file_hierarchical() {\n        let mut debouncer = EventDebouncer::new(100);\n        let temp_dir = tempfile::tempdir().expect(\"create temp dir\");\n        let dir = temp_dir.path().to_path_buf();\n        let file = dir.join(\"child.txt\");\n\n        debouncer.add_event(ProcessedEvent {\n            path: dir.clone(),\n            kind: EventKind::Create(CreateKind::Folder),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n        debouncer.add_event(ProcessedEvent {\n            path: file,\n            kind: EventKind::Create(CreateKind::File),\n            priority: EventPriority::Create,\n            timestamp: Instant::now(),\n        });\n\n        assert_eq!(debouncer.len(), 2);\n        std::thread::sleep(Duration::from_millis(110));\n        let flushed = debouncer.flush();\n        assert_eq!(flushed.len(), 2);\n        assert!(flushed.iter().any(|e| e.path == dir));\n    }\n}\n\n\npub struct FileWatcher {\n    state: Arc\u003cMutex\u003cWatcherState\u003e\u003e,\n    #[allow(dead_code)]\n    config: WatcherConfig,\n    watched_paths: Vec\u003cPathBuf\u003e,\n    #[allow(dead_code)]\n    event_receiver: Receiver\u003cstd::result::Result\u003cEvent, notify::Error\u003e\u003e,\n    #[allow(dead_code)] \n    watcher: RecommendedWatcher,\n    processor_thread: Option\u003cJoinHandle\u003c()\u003e\u003e,\n    stop_flag: Arc\u003cAtomicBool\u003e,\n    events_processed: Arc\u003cAtomicUsize\u003e,\n    queue_size: Arc\u003cAtomicUsize\u003e,\n    start_time: Instant,\n    db_shared: Arc\u003cMutex\u003cOption\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e\u003e\u003e,\n}\n\nimpl FileWatcher {\n    pub fn new(paths: Vec\u003cPathBuf\u003e, config: WatcherConfig) -\u003e Result\u003cSelf\u003e {\n        let stop_flag = Arc::new(AtomicBool::new(false));\n        let events_processed = Arc::new(AtomicUsize::new(0));\n        let queue_size = Arc::new(AtomicUsize::new(0));\n        let state = Arc::new(Mutex::new(WatcherState::Initializing));\n\n        let (tx, rx) = bounded(config.max_queue_size);\n\n        let event_tx = tx.clone();\n        let mut actual_watcher = RecommendedWatcher::new(\n            move |event_res: std::result::Result\u003cEvent, notify::Error\u003e| {\n                if event_tx.send(event_res).is_err() {\n                    // Receiver dropped\n                }\n            },\n            notify::Config::default(),\n        )?;\n\n        for path_to_watch in \u0026paths {\n            actual_watcher\n                .watch(path_to_watch, RecursiveMode::Recursive)\n                .with_context(|| format!(\"Failed to watch path: {}\", path_to_watch.display()))?;\n        }\n\n        let config_clone = config.clone();\n        let stop_flag_clone = stop_flag.clone();\n        let events_processed_clone = events_processed.clone();\n        let queue_size_clone = queue_size.clone();\n        let state_clone = state.clone();\n        let receiver_clone = rx.clone(); \n\n        let db_shared_for_thread = Arc::new(Mutex::new(None::\u003cArc\u003cMutex\u003cDatabase\u003e\u003e\u003e));\n        let db_captured_for_thread = db_shared_for_thread.clone();\n\n        let processor_thread = thread::spawn(move || {\n            let mut debouncer = EventDebouncer::new(config_clone.debounce_ms);\n\n            while !stop_flag_clone.load(Ordering::Relaxed) { \n                let current_state = { state_clone.lock().unwrap().clone() };\n\n                if current_state == WatcherState::Paused {\n                    thread::sleep(Duration::from_millis(100));\n                    continue;\n                }\n                if current_state == WatcherState::ShuttingDown || current_state == WatcherState::Stopped {\n                    break;\n                }\n\n                let mut received_in_batch = 0;\n                while let Ok(evt_res) = receiver_clone.try_recv() {\n                    received_in_batch +=1;\n                    match evt_res {\n                        Ok(event) =\u003e {\n                            for path in event.paths {\n                                let prio = match event.kind {\n                                    EventKind::Create(_) =\u003e EventPriority::Create,\n                                    EventKind::Remove(_) =\u003e EventPriority::Delete,\n                                    EventKind::Modify(_) =\u003e EventPriority::Modify,\n                                    EventKind::Access(_) =\u003e EventPriority::Access,\n                                    _ =\u003e EventPriority::Modify,\n                                };\n                                debouncer.add_event(ProcessedEvent {\n                                    path,\n                                    kind: event.kind.clone(),\n                                    priority: prio,\n                                    timestamp: Instant::now(),\n                                });\n                            }\n                        }\n                        Err(e) =\u003e {\n                            eprintln!(\"Watcher channel error: {:?}\", e);\n                        }\n                    }\n                    if received_in_batch \u003e= config_clone.batch_size {\n                        break;\n                    }\n                }\n\n                queue_size_clone.store(debouncer.len(), Ordering::SeqCst);\n\n                if debouncer.is_ready_to_flush() \u0026\u0026 debouncer.len() \u003e 0 {\n                    let evts_to_process = debouncer.flush();\n                    let num_evts = evts_to_process.len();\n                    events_processed_clone.fetch_add(num_evts, Ordering::SeqCst);\n\n                    let db_guard_option = db_captured_for_thread.lock().unwrap();\n                    if let Some(db_mutex) = \u0026*db_guard_option {\n                        let mut _db_instance_guard = db_mutex.lock().unwrap();\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (DB available): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    } else {\n                        for event_item in \u0026evts_to_process {\n                             println!( \n                                \"Processing event (no DB): {:?} for path {:?}\",\n                                event_item.kind, event_item.path\n                            );\n                        }\n                    }\n                }\n                thread::sleep(Duration::from_millis(50));\n            }\n\n            if debouncer.len() \u003e 0 {\n                let final_evts = debouncer.flush();\n                events_processed_clone.fetch_add(final_evts.len(), Ordering::SeqCst);\n                for processed_event in final_evts {\n                    println!(\n                        \"Processing final event: {:?} for path {:?}\",\n                        processed_event.kind, processed_event.path\n                    );\n                }\n            }\n            let mut final_state_guard = state_clone.lock().unwrap();\n            *final_state_guard = WatcherState::Stopped;\n        });\n\n        Ok(Self {\n            state,\n            config,\n            watched_paths: paths,\n            event_receiver: rx,\n            watcher: actual_watcher,\n            processor_thread: Some(processor_thread),\n            stop_flag,\n            events_processed,\n            queue_size,\n            start_time: Instant::now(),\n            db_shared: db_shared_for_thread,\n        })\n    }\n\n    pub fn with_database(\u0026mut self, db_arc: Arc\u003cMutex\u003cDatabase\u003e\u003e) -\u003e \u0026mut Self {\n        { \n            let mut shared_db_guard = self.db_shared.lock().unwrap();\n            *shared_db_guard = Some(db_arc);\n        } \n        self\n    }\n\n    pub fn start(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        if *state_guard == WatcherState::Watching || self.processor_thread.is_none() {\n            if self.processor_thread.is_none() {\n                return Err(anyhow::anyhow!(\"Watcher thread not available to start.\"));\n            }\n            if *state_guard == WatcherState::Initializing {\n                 *state_guard = WatcherState::Watching;\n            }\n            return Ok(());\n        }\n        if *state_guard != WatcherState::Initializing \u0026\u0026 *state_guard != WatcherState::Stopped \u0026\u0026 *state_guard != WatcherState::Paused {\n            return Err(anyhow::anyhow!(format!(\"Cannot start watcher from state {:?}\", *state_guard)));\n        }\n\n        *state_guard = WatcherState::Watching;\n        Ok(())\n    }\n\n    pub fn pause(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Watching =\u003e {\n                *state_guard = WatcherState::Paused;\n                Ok(())\n            }\n            WatcherState::Paused =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in watching state to pause (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn resume(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut state_guard = self.state.lock().unwrap();\n        match *state_guard {\n            WatcherState::Paused =\u003e {\n                *state_guard = WatcherState::Watching;\n                Ok(())\n            }\n            WatcherState::Watching =\u003e Ok(()), \n            _ =\u003e Err(anyhow::anyhow!(format!(\"Watcher not in paused state to resume (current: {:?})\", *state_guard))),\n        }\n    }\n\n    pub fn stop(\u0026mut self) -\u003e Result\u003c()\u003e {\n        let mut current_state_guard = self.state.lock().unwrap();\n        if *current_state_guard == WatcherState::Stopped || *current_state_guard == WatcherState::ShuttingDown {\n            return Ok(());\n        }\n        *current_state_guard = WatcherState::ShuttingDown;\n        drop(current_state_guard);\n\n        self.stop_flag.store(true, Ordering::SeqCst);\n\n        if let Some(handle) = self.processor_thread.take() {\n            match handle.join() {\n                Ok(_) =\u003e { /* Thread joined cleanly */ }\n                Err(join_err) =\u003e {\n                    eprintln!(\"Watcher processor thread panicked: {:?}\", join_err);\n                }\n            }\n        }\n        \n        let mut final_state_guard = self.state.lock().unwrap();\n        *final_state_guard = WatcherState::Stopped;\n        Ok(())\n    }\n\n    pub fn status(\u0026self) -\u003e WatcherStatus {\n        let state_guard = self.state.lock().unwrap().clone();\n        WatcherStatus {\n            state: state_guard,\n            events_processed: self.events_processed.load(Ordering::SeqCst),\n            queue_size: self.queue_size.load(Ordering::SeqCst),\n            start_time: Some(self.start_time),\n            watched_paths: self.watched_paths.clone(),\n        }\n    }\n}\n\nimpl Drop for FileWatcher {\n    fn drop(\u0026mut self) {\n        if let Err(e) = self.stop() {\n            eprintln!(\"Error stopping watcher in Drop: {:?}\", e);\n        }\n    }\n}\n\n\n#[cfg(test)]\nmod file_watcher_state_tests { \n    use super::*;\n    use tempfile::tempdir;\n    use std::fs as FsMod; // Alias to avoid conflict with local `fs` module name if any\n\n    #[test]\n    fn test_watcher_pause_resume_stop() {\n        let tmp_dir = tempdir().unwrap();\n        let watch_path = tmp_dir.path().to_path_buf();\n        FsMod::create_dir_all(\u0026watch_path).expect(\"Failed to create temp dir for watching\");\n\n        let config = WatcherConfig::default();\n\n        let mut watcher = FileWatcher::new(vec![watch_path], config).expect(\"Failed to create watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Initializing);\n\n        watcher.start().expect(\"Start failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.pause().expect(\"Pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.pause().expect(\"Second pause failed\");\n        assert_eq!(watcher.status().state, WatcherState::Paused);\n\n        watcher.resume().expect(\"Resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        watcher.resume().expect(\"Second resume failed\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        watcher.stop().expect(\"Stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n\n        watcher.stop().expect(\"Second stop failed\");\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n    }\n\n    #[test]\n    fn test_watcher_start_errors() {\n        let tmp_dir = tempdir().unwrap();\n        FsMod::create_dir_all(tmp_dir.path()).expect(\"Failed to create temp dir for watching\");\n        let mut watcher = FileWatcher::new(vec![tmp_dir.path().to_path_buf()], WatcherConfig::default()).unwrap();\n        \n        {\n            let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::Watching; \n        }\n        assert!(watcher.start().is_ok(), \"Should be able to call start when already Watching (idempotent state change)\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n        \n        {\n             let mut state_guard = watcher.state.lock().unwrap();\n            *state_guard = WatcherState::ShuttingDown;\n        }\n        assert!(watcher.start().is_err(), \"Should not be able to start from ShuttingDown\");\n    }\n\n     #[test]\n    fn test_new_watcher_with_nonexistent_path() {\n        let non_existent_path = PathBuf::from(\"/path/that/REALLY/does/not/exist/for/sure/and/cannot/be/created\");\n        let config = WatcherConfig::default();\n        let watcher_result = FileWatcher::new(vec![non_existent_path], config);\n        assert!(watcher_result.is_err());\n        if let Err(e) = watcher_result {\n            let err_string = e.to_string();\n            assert!(err_string.contains(\"Failed to watch path\") || err_string.contains(\"os error 2\"), \"Error was: {}\", err_string);\n        }\n    }\n\n    #[test]\n    fn test_watcher_default_config() {\n        let config = WatcherConfig::default(); \n        assert_eq!(config.debounce_ms, 100);\n        assert_eq!(config.batch_size, 1000);\n        assert_eq!(config.max_queue_size, 100_000);\n        assert_eq!(config.drain_timeout_ms, 5000);\n    }\n}","traces":[{"line":38,"address":[5542400],"length":1,"stats":{"Line":1}},{"line":91,"address":[2059012,2059006,2058864],"length":1,"stats":{"Line":1}},{"line":93,"address":[2058893],"length":1,"stats":{"Line":1}},{"line":95,"address":[2058898],"length":1,"stats":{"Line":1}},{"line":99,"address":[2059024,2059653],"length":1,"stats":{"Line":1}},{"line":100,"address":[2059049,2059126],"length":1,"stats":{"Line":2}},{"line":101,"address":[2059139,2059204],"length":1,"stats":{"Line":2}},{"line":103,"address":[2059261],"length":1,"stats":{"Line":3}},{"line":105,"address":[2059239,2059275],"length":1,"stats":{"Line":2}},{"line":106,"address":[2059313],"length":1,"stats":{"Line":1}},{"line":107,"address":[2059576,2059496,2059331],"length":1,"stats":{"Line":2}},{"line":108,"address":[2059570],"length":1,"stats":{"Line":0}},{"line":110,"address":[2059512],"length":1,"stats":{"Line":1}},{"line":111,"address":[5543146],"length":1,"stats":{"Line":1}},{"line":114,"address":[2059363],"length":1,"stats":{"Line":1}},{"line":119,"address":[2059696],"length":1,"stats":{"Line":1}},{"line":120,"address":[2059710],"length":1,"stats":{"Line":1}},{"line":123,"address":[2059776,2060031,2060025],"length":1,"stats":{"Line":1}},{"line":124,"address":[2059819],"length":1,"stats":{"Line":5}},{"line":125,"address":[2004160,2004170],"length":1,"stats":{"Line":5}},{"line":126,"address":[2059940],"length":1,"stats":{"Line":1}},{"line":127,"address":[2059991],"length":1,"stats":{"Line":1}},{"line":131,"address":[2060048],"length":1,"stats":{"Line":1}},{"line":132,"address":[5543701],"length":1,"stats":{"Line":2}},{"line":310,"address":[2063925,2063163,2060064],"length":1,"stats":{"Line":1}},{"line":311,"address":[5543927,5543751],"length":1,"stats":{"Line":2}},{"line":312,"address":[2060369,2060433],"length":1,"stats":{"Line":2}},{"line":313,"address":[2060524,2060588],"length":1,"stats":{"Line":2}},{"line":314,"address":[2060755,2060675],"length":1,"stats":{"Line":2}},{"line":316,"address":[2060910,2060850],"length":1,"stats":{"Line":2}},{"line":318,"address":[2060990,2061070],"length":1,"stats":{"Line":2}},{"line":320,"address":[2004268,2004274,2004176],"length":1,"stats":{"Line":2}},{"line":321,"address":[2004191],"length":1,"stats":{"Line":1}},{"line":325,"address":[2061110],"length":1,"stats":{"Line":1}},{"line":328,"address":[5545221,5545137],"length":1,"stats":{"Line":2}},{"line":329,"address":[2063405,2063555],"length":1,"stats":{"Line":2}},{"line":330,"address":[2061644,2063397],"length":1,"stats":{"Line":2}},{"line":331,"address":[2004288,2004310],"length":1,"stats":{"Line":3}},{"line":334,"address":[2061680],"length":1,"stats":{"Line":1}},{"line":335,"address":[2061687],"length":1,"stats":{"Line":1}},{"line":336,"address":[2061740,2061798],"length":1,"stats":{"Line":2}},{"line":337,"address":[5545573,5545506],"length":1,"stats":{"Line":2}},{"line":338,"address":[2061956,2061901],"length":1,"stats":{"Line":2}},{"line":339,"address":[2062045,2061980],"length":1,"stats":{"Line":2}},{"line":341,"address":[2062150,2062069],"length":1,"stats":{"Line":2}},{"line":342,"address":[2062183,2062237],"length":1,"stats":{"Line":2}},{"line":344,"address":[2062245],"length":1,"stats":{"Line":2}},{"line":345,"address":[2004479,2004570],"length":1,"stats":{"Line":2}},{"line":347,"address":[2004580,2004648],"length":1,"stats":{"Line":2}},{"line":348,"address":[2004760,2004699],"length":1,"stats":{"Line":2}},{"line":350,"address":[2004950],"length":1,"stats":{"Line":1}},{"line":351,"address":[2005026,2008058],"length":1,"stats":{"Line":0}},{"line":354,"address":[2005058,2004992],"length":1,"stats":{"Line":2}},{"line":358,"address":[2005114],"length":1,"stats":{"Line":1}},{"line":359,"address":[2006547,2005222,2005142],"length":1,"stats":{"Line":3}},{"line":360,"address":[2005272,2005346],"length":1,"stats":{"Line":1}},{"line":361,"address":[2005313],"length":1,"stats":{"Line":1}},{"line":362,"address":[2005521],"length":1,"stats":{"Line":1}},{"line":363,"address":[2005815,2005680,2005577],"length":1,"stats":{"Line":3}},{"line":364,"address":[2005884],"length":1,"stats":{"Line":1}},{"line":365,"address":[2006022],"length":1,"stats":{"Line":1}},{"line":366,"address":[2006042],"length":1,"stats":{"Line":1}},{"line":367,"address":[2006032],"length":1,"stats":{"Line":1}},{"line":368,"address":[2006012],"length":1,"stats":{"Line":1}},{"line":369,"address":[2006002],"length":1,"stats":{"Line":0}},{"line":371,"address":[2006268],"length":1,"stats":{"Line":1}},{"line":372,"address":[5524074],"length":1,"stats":{"Line":1}},{"line":373,"address":[2006082,2006155],"length":1,"stats":{"Line":2}},{"line":374,"address":[2006206],"length":1,"stats":{"Line":1}},{"line":375,"address":[2006220],"length":1,"stats":{"Line":1}},{"line":379,"address":[2005423],"length":1,"stats":{"Line":0}},{"line":380,"address":[2005511,2006432],"length":1,"stats":{"Line":0}},{"line":383,"address":[2005979],"length":1,"stats":{"Line":1}},{"line":388,"address":[2006719,2006663],"length":1,"stats":{"Line":2}},{"line":390,"address":[2006781,2006846],"length":1,"stats":{"Line":2}},{"line":391,"address":[2006891],"length":1,"stats":{"Line":1}},{"line":392,"address":[2006977,2006906],"length":1,"stats":{"Line":2}},{"line":393,"address":[2006985],"length":1,"stats":{"Line":1}},{"line":395,"address":[5525091],"length":1,"stats":{"Line":1}},{"line":396,"address":[5525214,5525293],"length":1,"stats":{"Line":2}},{"line":397,"address":[5525335,5525397],"length":1,"stats":{"Line":0}},{"line":398,"address":[2007409,2007476],"length":1,"stats":{"Line":0}},{"line":399,"address":[5525734,5525665],"length":1,"stats":{"Line":0}},{"line":405,"address":[5525856,5525354],"length":1,"stats":{"Line":2}},{"line":406,"address":[5526046,5525965],"length":1,"stats":{"Line":2}},{"line":413,"address":[5526025,5524841],"length":1,"stats":{"Line":2}},{"line":416,"address":[2004726,2008588,2008082],"length":1,"stats":{"Line":2}},{"line":417,"address":[5526247],"length":1,"stats":{"Line":0}},{"line":418,"address":[5526331,5526270],"length":1,"stats":{"Line":0}},{"line":419,"address":[5526388,5526590],"length":1,"stats":{"Line":0}},{"line":420,"address":[2008843,2008539],"length":1,"stats":{"Line":0}},{"line":426,"address":[5526208,5526742],"length":1,"stats":{"Line":2}},{"line":427,"address":[2008743,2008670],"length":1,"stats":{"Line":2}},{"line":430,"address":[5546512],"length":1,"stats":{"Line":1}},{"line":431,"address":[5546176],"length":1,"stats":{"Line":1}},{"line":433,"address":[2062476],"length":1,"stats":{"Line":1}},{"line":434,"address":[2062507],"length":1,"stats":{"Line":1}},{"line":435,"address":[5546271],"length":1,"stats":{"Line":1}},{"line":436,"address":[5546311],"length":1,"stats":{"Line":1}},{"line":437,"address":[5546343],"length":1,"stats":{"Line":1}},{"line":438,"address":[2062643],"length":1,"stats":{"Line":1}},{"line":439,"address":[2062667],"length":1,"stats":{"Line":1}},{"line":440,"address":[5546415],"length":1,"stats":{"Line":1}},{"line":441,"address":[2062776],"length":1,"stats":{"Line":1}},{"line":445,"address":[2063968,2064316,2064322],"length":1,"stats":{"Line":0}},{"line":447,"address":[2064066,2064005],"length":1,"stats":{"Line":0}},{"line":448,"address":[5548035,5547941,5547982,5548140],"length":1,"stats":{"Line":0}},{"line":450,"address":[5547798],"length":1,"stats":{"Line":0}},{"line":453,"address":[5549403,5548192,5549178],"length":1,"stats":{"Line":1}},{"line":454,"address":[5548215],"length":1,"stats":{"Line":1}},{"line":455,"address":[5548385,5548480,5548306],"length":1,"stats":{"Line":3}},{"line":456,"address":[2064587,2065274],"length":1,"stats":{"Line":2}},{"line":457,"address":[5549218,5549350],"length":1,"stats":{"Line":0}},{"line":459,"address":[5549249,5549194,5549340],"length":1,"stats":{"Line":2}},{"line":460,"address":[2065376],"length":1,"stats":{"Line":0}},{"line":462,"address":[5549277],"length":1,"stats":{"Line":1}},{"line":464,"address":[5548486,5548582],"length":1,"stats":{"Line":2}},{"line":465,"address":[5548986,5548792,5548707,5549156],"length":1,"stats":{"Line":2}},{"line":468,"address":[5548736,5548547],"length":1,"stats":{"Line":2}},{"line":469,"address":[5548745],"length":1,"stats":{"Line":1}},{"line":472,"address":[5549424,5550079,5550085],"length":1,"stats":{"Line":1}},{"line":473,"address":[2065519],"length":1,"stats":{"Line":1}},{"line":474,"address":[2065588,2065642],"length":1,"stats":{"Line":2}},{"line":476,"address":[5549632,5549674],"length":1,"stats":{"Line":2}},{"line":477,"address":[2065732],"length":1,"stats":{"Line":1}},{"line":479,"address":[2065710],"length":1,"stats":{"Line":1}},{"line":480,"address":[2065676,2065777,2065949],"length":1,"stats":{"Line":0}},{"line":484,"address":[5550775,5550769,5550112],"length":1,"stats":{"Line":1}},{"line":485,"address":[2066159],"length":1,"stats":{"Line":1}},{"line":486,"address":[5550203,5550270],"length":1,"stats":{"Line":2}},{"line":488,"address":[2066339,2066389],"length":1,"stats":{"Line":2}},{"line":489,"address":[2066395],"length":1,"stats":{"Line":1}},{"line":491,"address":[5550320],"length":1,"stats":{"Line":1}},{"line":492,"address":[2066419,2066591,2066316],"length":1,"stats":{"Line":0}},{"line":496,"address":[2067606,2067872,2066784],"length":1,"stats":{"Line":1}},{"line":497,"address":[2066804],"length":1,"stats":{"Line":1}},{"line":498,"address":[5550918,5551072,5550985],"length":1,"stats":{"Line":3}},{"line":499,"address":[2066998],"length":1,"stats":{"Line":1}},{"line":501,"address":[5551100],"length":1,"stats":{"Line":1}},{"line":502,"address":[2067102],"length":1,"stats":{"Line":1}},{"line":504,"address":[2067135],"length":1,"stats":{"Line":1}},{"line":506,"address":[2067193],"length":1,"stats":{"Line":1}},{"line":507,"address":[5551422,5551343],"length":1,"stats":{"Line":2}},{"line":509,"address":[2067416],"length":1,"stats":{"Line":0}},{"line":510,"address":[2067464,2067515],"length":1,"stats":{"Line":0}},{"line":515,"address":[2067683,2067635],"length":1,"stats":{"Line":2}},{"line":516,"address":[2067818,2067747],"length":1,"stats":{"Line":2}},{"line":517,"address":[2067827],"length":1,"stats":{"Line":1}},{"line":520,"address":[5552406,5552412,5551984],"length":1,"stats":{"Line":1}},{"line":521,"address":[2067942],"length":1,"stats":{"Line":1}},{"line":524,"address":[5552195],"length":1,"stats":{"Line":1}},{"line":525,"address":[2068130],"length":1,"stats":{"Line":1}},{"line":526,"address":[2068167],"length":1,"stats":{"Line":1}},{"line":527,"address":[2068183],"length":1,"stats":{"Line":1}},{"line":533,"address":[2001328,2001554,2001560],"length":1,"stats":{"Line":1}},{"line":534,"address":[2001340],"length":1,"stats":{"Line":1}},{"line":535,"address":[2001484,2001410],"length":1,"stats":{"Line":0}}],"covered":134,"coverable":157},{"path":["/","home","user","Documents","GitHub","Marlin","libmarlin","src","watcher_tests.rs"],"content":"//! Tests for the file system watcher functionality\n\n#[cfg(test)]\nmod tests {\n    // Updated import for BackupManager from the new backup module\n    use crate::backup::BackupManager;\n    // These are still from the watcher module\n    use crate::watcher::{FileWatcher, WatcherConfig, WatcherState};\n    use crate::db::open as open_marlin_db; // Use your project's DB open function\n\n\n    use std::fs::{self, File};\n    use std::io::Write;\n    // No longer need: use std::path::PathBuf;\n    use std::thread;\n    use std::time::Duration;\n    use tempfile::tempdir;\n\n    #[test]\n    fn test_watcher_lifecycle() {\n        // Create a temp directory for testing\n        let temp_dir = tempdir().expect(\"Failed to create temp directory\");\n        let temp_path = temp_dir.path();\n\n        // Create a test file\n        let test_file_path = temp_path.join(\"test.txt\");\n        let mut file = File::create(\u0026test_file_path).expect(\"Failed to create test file\");\n        writeln!(file, \"Test content\").expect(\"Failed to write to test file\");\n        drop(file);\n\n        // Configure and start the watcher\n        let config = WatcherConfig {\n            debounce_ms: 100,\n            batch_size: 10,\n            max_queue_size: 100,\n            drain_timeout_ms: 1000,\n        };\n\n        let mut watcher = FileWatcher::new(vec![temp_path.to_path_buf()], config)\n            .expect(\"Failed to create watcher\");\n\n        watcher.start().expect(\"Failed to start watcher\");\n        assert_eq!(watcher.status().state, WatcherState::Watching);\n\n        thread::sleep(Duration::from_millis(200));\n        let new_file_path = temp_path.join(\"new_file.txt\");\n        let mut new_file_handle = File::create(\u0026new_file_path).expect(\"Failed to create new file\");\n        writeln!(new_file_handle, \"New file content\").expect(\"Failed to write to new file\");\n        drop(new_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        let mut existing_file_handle = fs::OpenOptions::new()\n            .write(true)\n            .append(true)\n            .open(\u0026test_file_path)\n            .expect(\"Failed to open test file for modification\");\n        writeln!(existing_file_handle, \"Additional content\").expect(\"Failed to append to test file\");\n        drop(existing_file_handle);\n\n        thread::sleep(Duration::from_millis(200));\n        fs::remove_file(\u0026new_file_path).expect(\"Failed to remove file\");\n\n        thread::sleep(Duration::from_millis(500));\n        watcher.stop().expect(\"Failed to stop watcher\");\n\n        assert_eq!(watcher.status().state, WatcherState::Stopped);\n        assert!(watcher.status().events_processed \u003e 0, \"Expected some file events to be processed\");\n    }\n\n    #[test]\n    fn test_backup_manager_related_functionality() {\n        let live_db_tmp_dir = tempdir().expect(\"Failed to create temp directory for live DB\");\n        let backups_storage_tmp_dir = tempdir().expect(\"Failed to create temp directory for backups storage\");\n        \n        let live_db_path = live_db_tmp_dir.path().join(\"test_live_watcher.db\"); // Unique name\n        let backups_actual_dir = backups_storage_tmp_dir.path().join(\"my_backups_watcher\"); // Unique name\n\n        // Initialize a proper SQLite DB for the \"live\" database\n        let _conn = open_marlin_db(\u0026live_db_path).expect(\"Failed to open test_live_watcher.db for backup test\");\n        \n        let backup_manager = BackupManager::new(\u0026live_db_path, \u0026backups_actual_dir)\n            .expect(\"Failed to create BackupManager instance\");\n        \n        let backup_info = backup_manager.create_backup().expect(\"Failed to create first backup\");\n        \n        assert!(backups_actual_dir.join(\u0026backup_info.id).exists(), \"Backup file should exist\");\n        assert!(backup_info.size_bytes \u003e 0, \"Backup size should be greater than 0\");\n        \n        for i in 0..3 {\n            std::thread::sleep(std::time::Duration::from_millis(30)); // Ensure timestamp difference\n            backup_manager.create_backup().unwrap_or_else(|e| panic!(\"Failed to create additional backup {}: {:?}\", i, e));\n        }\n        \n        let backups = backup_manager.list_backups().expect(\"Failed to list backups\");\n        assert_eq!(backups.len(), 4, \"Should have 4 backups listed\");\n        \n        let prune_result = backup_manager.prune(2).expect(\"Failed to prune backups\");\n        \n        assert_eq!(prune_result.kept.len(), 2, \"Should have kept 2 backups\");\n        assert_eq!(prune_result.removed.len(), 2, \"Should have removed 2 backups (4 initial - 2 kept)\");\n        \n        let remaining_backups = backup_manager.list_backups().expect(\"Failed to list backups after prune\");\n        assert_eq!(remaining_backups.len(), 2, \"Should have 2 backups remaining after prune\");\n\n        for removed_info in prune_result.removed {\n            assert!(!backups_actual_dir.join(\u0026removed_info.id).exists(), \"Removed backup file {} should not exist\", removed_info.id);\n        }\n        for kept_info in prune_result.kept {\n            assert!(backups_actual_dir.join(\u0026kept_info.id).exists(), \"Kept backup file {} should exist\", kept_info.id);\n        }\n    }\n}","traces":[],"covered":0,"coverable":0},{"path":["/","home","user","Documents","GitHub","Marlin","tui-bin","src","main.rs"],"content":"// tui-bin/src/main.rs\n\nfn main() {\n    eprintln!(\"marlin-tui is not yet implemented. Stay tuned!\");\n}\n","traces":[{"line":3,"address":[127488],"length":1,"stats":{"Line":0}},{"line":4,"address":[127492],"length":1,"stats":{"Line":0}}],"covered":0,"coverable":2}]};
     </script>
     <script crossorigin>/** @license React v16.13.1
  * react.production.min.js