feat(index-generator): refactor to extract utility functions and ensure schema consistency in search index

Author: mankinskin

.ticket/tickets/6d07d610-75c1-448a-afd5-6ae15098ca21/history.ndjson

@@ -10,3 +10,4 @@
 {"rev":10,"ts":"2026-06-14T20:35:37.330491+00:00","fields":{"component":"ticket-vscode","depends_on":["011563c2-59e7-48f1-a61f-d8fdc80d2f6e","14047b99-41d6-4899-bec6-4a919bffcc2d","362448d4-ccf1-4b9d-90f3-d4577da83a65","6de424b0-68ec-43c7-9d70-eb8d17305ab3","93f7e422-1e41-4145-b8ba-0dcf7fc730ac","bfafde19-ddf7-47ef-966e-a1135be4efd6"],"priority":"high","risk_level":"high","state":"ready","title":"[ticket-vscode] Rust/WASM port track","type":"tracker-improvement"}}
 {"rev":11,"ts":"2026-06-14T20:36:32.628613800+00:00","fields":{"component":"ticket-vscode","depends_on":["011563c2-59e7-48f1-a61f-d8fdc80d2f6e","14047b99-41d6-4899-bec6-4a919bffcc2d","6de424b0-68ec-43c7-9d70-eb8d17305ab3","93f7e422-1e41-4145-b8ba-0dcf7fc730ac","bfafde19-ddf7-47ef-966e-a1135be4efd6"],"priority":"high","risk_level":"high","state":"ready","title":"[ticket-vscode] Rust/WASM port track","type":"tracker-improvement"}}
 {"rev":12,"ts":"2026-06-14T20:36:35.758370900+00:00","fields":{"component":"ticket-vscode","depends_on":["011563c2-59e7-48f1-a61f-d8fdc80d2f6e","14047b99-41d6-4899-bec6-4a919bffcc2d","362448d4-ccf1-4b9d-90f3-d4577da83a65","6de424b0-68ec-43c7-9d70-eb8d17305ab3","93f7e422-1e41-4145-b8ba-0dcf7fc730ac","bfafde19-ddf7-47ef-966e-a1135be4efd6"],"priority":"high","risk_level":"high","state":"ready","title":"[ticket-vscode] Rust/WASM port track","type":"tracker-improvement"}}
+{"rev":13,"ts":"2026-06-15T00:22:55.909399600+00:00","fields":{"component":"ticket-vscode","depends_on":["011563c2-59e7-48f1-a61f-d8fdc80d2f6e","14047b99-41d6-4899-bec6-4a919bffcc2d","362448d4-ccf1-4b9d-90f3-d4577da83a65","694d74b4-028b-4602-8090-d6200d577d4a","6de424b0-68ec-43c7-9d70-eb8d17305ab3","93f7e422-1e41-4145-b8ba-0dcf7fc730ac","bfafde19-ddf7-47ef-966e-a1135be4efd6"],"priority":"high","risk_level":"high","state":"ready","title":"[ticket-vscode] Rust/WASM port track","type":"tracker-improvement"}}

.ticket/tickets/6d07d610-75c1-448a-afd5-6ae15098ca21/ticket.toml

@@ -3,7 +3,7 @@ created_at = "2026-05-18T10:56:02.378708400+00:00"
 title = "[ticket-vscode] Rust/WASM port track"
 state = "ready"
 component = "ticket-vscode"
-depends_on = ["011563c2-59e7-48f1-a61f-d8fdc80d2f6e", "14047b99-41d6-4899-bec6-4a919bffcc2d", "362448d4-ccf1-4b9d-90f3-d4577da83a65", "6de424b0-68ec-43c7-9d70-eb8d17305ab3", "93f7e422-1e41-4145-b8ba-0dcf7fc730ac", "bfafde19-ddf7-47ef-966e-a1135be4efd6"]
+depends_on = ["011563c2-59e7-48f1-a61f-d8fdc80d2f6e", "14047b99-41d6-4899-bec6-4a919bffcc2d", "362448d4-ccf1-4b9d-90f3-d4577da83a65", "694d74b4-028b-4602-8090-d6200d577d4a", "6de424b0-68ec-43c7-9d70-eb8d17305ab3", "93f7e422-1e41-4145-b8ba-0dcf7fc730ac", "bfafde19-ddf7-47ef-966e-a1135be4efd6"]
 priority = "high"
 risk_level = "high"
 type = "tracker-improvement"

.ticket/tickets/6de424b0-68ec-43c7-9d70-eb8d17305ab3/history.ndjson

@@ -7,3 +7,4 @@
 {"rev":7,"ts":"2026-06-14T22:55:43.927310900+00:00","fields":{"component":"ticket-vscode","depends_on":["362448d4-ccf1-4b9d-90f3-d4577da83a65"],"priority":"high","risk_level":"medium","state":"in-implementation","title":"[ticket-vscode] Validate Rust/WASM parity across desktop, web, and remote hosts","type":"tracker-improvement"}}
 {"rev":8,"ts":"2026-06-14T23:00:30.288971100+00:00","fields":{"component":"ticket-vscode","depends_on":["362448d4-ccf1-4b9d-90f3-d4577da83a65"],"priority":"high","risk_level":"medium","state":"in-implementation","title":"[ticket-vscode] Validate Rust/WASM parity across desktop, web, and remote hosts","type":"tracker-improvement"}}
 {"rev":9,"ts":"2026-06-14T23:14:52.645345600+00:00","fields":{"component":"ticket-vscode","depends_on":["362448d4-ccf1-4b9d-90f3-d4577da83a65"],"priority":"high","risk_level":"medium","state":"in-implementation","title":"[ticket-vscode] Validate Rust/WASM parity across desktop, web, and remote hosts","type":"tracker-improvement"}}
+{"rev":10,"ts":"2026-06-15T00:23:07.043777100+00:00","fields":{"component":"ticket-vscode","depends_on":["362448d4-ccf1-4b9d-90f3-d4577da83a65","694d74b4-028b-4602-8090-d6200d577d4a"],"priority":"high","risk_level":"medium","state":"in-implementation","title":"[ticket-vscode] Validate Rust/WASM parity across desktop, web, and remote hosts","type":"tracker-improvement"}}

.ticket/tickets/6de424b0-68ec-43c7-9d70-eb8d17305ab3/ticket.toml

@@ -3,7 +3,7 @@ created_at = "2026-05-18T10:56:19.146718300+00:00"
 title = "[ticket-vscode] Validate Rust/WASM parity across desktop, web, and remote hosts"
 state = "in-implementation"
 component = "ticket-vscode"
-depends_on = ["362448d4-ccf1-4b9d-90f3-d4577da83a65"]
+depends_on = ["362448d4-ccf1-4b9d-90f3-d4577da83a65", "694d74b4-028b-4602-8090-d6200d577d4a"]
 priority = "high"
 risk_level = "medium"
 type = "tracker-improvement"

crates/memory-api/src/index_generator/audit.rs

@@ -19,7 +19,7 @@ use crate::model::index_entry::{
 };
 use crate::model::index_sidecar::IndexSidecar;
 
-use super::ticket::deterministic_uuid;
+use super::util::deterministic_uuid;
 
 /// Namespace UUID for deterministic audit root UUIDs.
 const AUDIT_NS: Uuid = Uuid::from_bytes([

crates/memory-api/src/index_generator/mod.rs

@@ -18,13 +18,16 @@
 //!   if they need deterministic timestamps in tests.
 
 pub mod audit;
-pub mod rule;
 pub mod spec;
 pub mod ticket;
+pub mod util;
 pub mod workspace;
 
 pub use audit::generate_audit_sidecar;
-pub use rule::generate_rule_sidecar;
 pub use spec::generate_spec_sidecar;
 pub use ticket::generate_ticket_sidecar;
+pub use util::{
+    deterministic_uuid,
+    to_relative_slash,
+};
 pub use workspace::generate_workspace_sidecar;

crates/memory-api/src/index_generator/rule.rs

@@ -17,7 +17,7 @@ use crate::model::index_entry::{
 use crate::model::index_sidecar::IndexSidecar;
 use crate::storage::indexed::IndexedEntity;
 
-use super::ticket::to_relative_slash;
+use super::util::to_relative_slash;
 
 /// Input for the spec sidecar generator.
 pub struct SpecIndexInput<'a> {

crates/memory-api/src/index_generator/spec.rs

@@ -11,8 +11,8 @@
 use std::path::Path;
 
 use chrono::Utc;
-use uuid::Uuid;
 
+use super::util::to_relative_slash;
 use crate::model::index_entry::{
     ContentKind,
     IndexEntry,
@@ -103,30 +103,12 @@ fn make_ticket_entry(
     }
 }
 
-/// Convert an absolute path to a workspace-relative string with `/` separators.
-pub(super) fn to_relative_slash(
-    workspace_root: &Path,
-    abs_path: &Path,
-) -> String {
-    abs_path
-        .strip_prefix(workspace_root)
-        .unwrap_or(abs_path)
-        .to_string_lossy()
-        .replace('\\', "/")
-}
-
-/// Stable synthetic UUID derived from a fixed namespace + slug string.
-///
-/// Used for workspace summary and agent-hook entries that have no store UUID.
-pub(super) fn deterministic_uuid(namespace: Uuid, slug: &str) -> Uuid {
-    Uuid::new_v5(&namespace, slug.as_bytes())
-}
-
 #[cfg(test)]
 mod tests {
     use super::*;
     use std::path::PathBuf;
     use chrono::Utc;
+    use uuid::Uuid;
 
     fn fake_ticket(id: Uuid, title: &str, state: &str, path: PathBuf) -> IndexedEntity {
         IndexedEntity {

crates/memory-api/src/index_generator/ticket.rs

@@ -0,0 +1,66 @@
+//! Generic, domain-agnostic helpers shared by every store-index generator.
+//!
+//! These helpers were promoted out of `index_generator/ticket.rs` so that
+//! domain-owned generators (which live in their own crates, e.g. `rule-api`)
+//! can reuse them without depending on the ticket generator (decision Q1.1 of
+//! the `thin-generator-architecture` spec).
+
+use std::path::Path;
+
+use uuid::Uuid;
+
+/// Convert an absolute path to a workspace-relative string with `/` separators.
+///
+/// When `abs_path` is not under `workspace_root` the original path is returned
+/// (with separators normalized). Output is always `/`-separated so generated
+/// artifacts are byte-identical across platforms.
+pub fn to_relative_slash(
+    workspace_root: &Path,
+    abs_path: &Path,
+) -> String {
+    abs_path
+        .strip_prefix(workspace_root)
+        .unwrap_or(abs_path)
+        .to_string_lossy()
+        .replace('\\', "/")
+}
+
+/// Stable synthetic UUID derived from a fixed namespace + slug string.
+///
+/// Used for workspace summary and agent-hook entries that have no store UUID.
+/// Deterministic: identical inputs always yield the same UUID (UUID v5).
+pub fn deterministic_uuid(
+    namespace: Uuid,
+    slug: &str,
+) -> Uuid {
+    Uuid::new_v5(&namespace, slug.as_bytes())
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use std::path::PathBuf;
+
+    #[test]
+    fn to_relative_slash_strips_root_and_normalizes() {
+        let root = PathBuf::from("/workspace");
+        let abs = PathBuf::from("/workspace/.rule/entries/x/rule.toml");
+        assert_eq!(
+            to_relative_slash(&root, &abs),
+            ".rule/entries/x/rule.toml"
+        );
+    }
+
+    #[test]
+    fn deterministic_uuid_is_stable() {
+        let ns = Uuid::nil();
+        assert_eq!(
+            deterministic_uuid(ns, "shared/agent-rules"),
+            deterministic_uuid(ns, "shared/agent-rules")
+        );
+        assert_ne!(
+            deterministic_uuid(ns, "a"),
+            deterministic_uuid(ns, "b")
+        );
+    }
+}