refactor(store): extract SQLite storage boundary

CHANGELOG.md

@@ -4,6 +4,8 @@ All notable Darc release changes should be summarized here.
 
 ## Unreleased
 
+- Narrow internal Rust storage APIs so SQLite schema details are no longer exposed outside the storage crate.
+
 ## [0.1.5] - 2026-05-11
 
 - Clarify README guidance for agent setup and prompt-driven prior-session investigations.

Cargo.toml

@@ -9,6 +9,7 @@ members = [
     "crates/query",
     "crates/rollout-audit",
     "crates/rollout",
+    "crates/store",
     "crates/sync",
     "crates/test-utils",
 ]
@@ -31,6 +32,7 @@ darc-paths = { path = "crates/paths" }
 darc-query = { path = "crates/query" }
 darc-rollout-audit = { path = "crates/rollout-audit" }
 darc-rollout = { path = "crates/rollout" }
+darc-store = { path = "crates/store" }
 darc-sync = { path = "crates/sync" }
 darc-test-utils = { path = "crates/test-utils" }
 # External Dependencies

README.md

@@ -322,7 +322,8 @@ Darc is split into focused Rust crates:
 - `crates/cli`: command-line surface.
 - `darc-core`: thin facade and orchestration layer.
 - `darc-sync`: source discovery, sync planning, and archive copy execution.
-- `darc-index`: normalized ingestion, SQLite schema, migrations, and indexing metrics.
+- `darc-store`: SQLite schema, migrations, and derived-index analytics shared by indexing and query.
+- `darc-index`: normalized archive ingestion and duplicate resolution.
 - `darc-query`: read-only query, search, and stats over indexed data.
 - `darc-rollout`: provider transcript models and parsers.
 - `darc-paths`, `darc-rollout-audit`, and `darc-test-utils`: shared support, maintainer audits, and tests.

crates/cli/Cargo.toml

@@ -32,9 +32,9 @@ serde_json = { workspace = true }
 notify = { workspace = true }
 
 [dev-dependencies]
-darc-index = { workspace = true }
 darc-paths = { workspace = true }
 darc-rollout = { workspace = true }
+darc-store = { workspace = true }
 darc-test-utils = { workspace = true }
 rusqlite = { workspace = true }
 toml = { workspace = true }

crates/cli/tests/query_protocol.rs

@@ -8,8 +8,8 @@ use anyhow::{Context, Result};
 use darc_core::query::{
     DEFAULT_QUERY_PAGE_LIMIT, DEFAULT_SESSION_BUNDLE_TURN_LIMIT, DEFAULT_TURN_STEP_LIMIT,
 };
-use darc_index::open_index_database;
 use darc_paths::SourceKind;
+use darc_store::open_index_database;
 use darc_test_utils::{
     IndexedSessionFixture, IndexedTurnFixture, insert_indexed_session, insert_indexed_turn,
     unique_test_dir, write_file,

crates/cli/tests/read_scale_bench.rs

@@ -6,8 +6,8 @@ use std::{
 };
 
 use anyhow::{Context, Result, bail};
-use darc_index::open_index_database;
 use darc_paths::SourceKind;
+use darc_store::open_index_database;
 use darc_test_utils::{
     IndexedSessionFixture, IndexedTurnFixture, insert_indexed_session, insert_indexed_turn,
     unique_test_dir, write_file,

crates/cli/tests/status.rs

@@ -1,8 +1,8 @@
 use std::{fs, path::Path, process::Command};
 
 use anyhow::{Context, Result};
-use darc_index::open_index_database;
 use darc_paths::SourceKind;
+use darc_store::open_index_database;
 use darc_test_utils::{
     IndexedSessionFixture, IndexedTurnFixture, insert_indexed_session, insert_indexed_turn,
     unique_test_dir, write_file,

crates/core/Cargo.toml

@@ -10,6 +10,7 @@ repository.workspace = true
 darc-query = { workspace = true }
 darc-index = { workspace = true }
 darc-paths = { workspace = true }
+darc-store = { workspace = true }
 darc-sync = { workspace = true }
 anyhow = { workspace = true }
 directories = { workspace = true }

crates/core/src/index.rs

@@ -5,9 +5,10 @@ use std::{
 };
 
 use anyhow::{Context, Result};
-use darc_index::{INDEX_DB_FILE_NAME, ProjectIndexRequest, index_project_archived_sessions};
 pub use darc_index::{IndexReport, SkippedCodexRollout, SkippedRollout};
+use darc_index::{ProjectIndexRequest, index_project_archived_sessions};
 use darc_paths::SourceKind;
+use darc_store::INDEX_DB_FILE_NAME;
 
 use crate::{
     active_project::{ActiveProject, load_active_project},

crates/core/src/init/tests.rs

@@ -6,7 +6,7 @@ use std::{
 };
 
 use anyhow::Result;
-use darc_index::INDEX_DB_FILE_NAME;
+use darc_store::INDEX_DB_FILE_NAME;
 
 use super::{
     config_io::{ExistingConfig, build_config, load_existing_config},

crates/core/src/init/types.rs

@@ -4,7 +4,7 @@ use std::{
 };
 
 use anyhow::{Context, Result};
-use darc_index::INDEX_DB_FILE_NAME;
+use darc_store::INDEX_DB_FILE_NAME;
 
 use crate::{
     config::{ProjectConfig, SharedConfig, SourceKind},

crates/core/src/init/workflow.rs

@@ -1,7 +1,7 @@
 use std::{env, fs, path::PathBuf};
 
 use anyhow::{Context, Result, bail};
-use darc_index::ensure_index_database;
+use darc_store::ensure_index_database;
 use directories::BaseDirs;
 
 use super::{

crates/core/src/project/remove.rs

@@ -1,7 +1,7 @@
 use std::{fs, path::Path};
 
 use anyhow::{Context, Result, bail};
-use darc_index::{INDEX_DB_FILE_NAME, count_project_index_rows_read_only, open_index_database};
+use darc_store::{INDEX_DB_FILE_NAME, count_project_index_rows_read_only, open_index_database};
 use rusqlite::params;
 
 use super::{

crates/core/src/project/tests.rs

@@ -6,7 +6,7 @@ use std::{
 };
 
 use anyhow::{Context, Result};
-use darc_index::{INDEX_DB_FILE_NAME, open_index_database};
+use darc_store::{INDEX_DB_FILE_NAME, open_index_database};
 use darc_test_utils::init_git_repo;
 use rusqlite::{Connection, params};
 

crates/core/src/query.rs

@@ -5,7 +5,6 @@ use std::{
 };
 
 use anyhow::{Context, Result, bail};
-use darc_index::INDEX_DB_FILE_NAME;
 use darc_paths::SourceKind;
 pub use darc_query::{
     ActiveProjectSummary, DEFAULT_MATCHED_PATH_LIMIT, DEFAULT_QUERY_PAGE_LIMIT,
@@ -33,6 +32,7 @@ use darc_query::{
     query_session_turn_details as query_project_session_turn_details, query_turn_detail,
     query_turn_insights, query_workspace_insights,
 };
+use darc_store::INDEX_DB_FILE_NAME;
 use serde_json::{Value as JsonValue, json};
 use thiserror::Error;
 

crates/index/Cargo.toml

@@ -7,11 +7,12 @@ authors.workspace = true
 repository.workspace = true
 
 [features]
-test-support = []
+test-support = ["darc-store/test-support"]
 
 [dependencies]
 darc-paths = { workspace = true }
 darc-rollout = { workspace = true }
+darc-store = { workspace = true }
 anyhow = { workspace = true }
 rusqlite = { workspace = true }
 serde_json = { workspace = true }