Release v1.19.2

.docs/releases/v2026.05.19.md

@@ -0,0 +1,55 @@
+# Release v2026.05.19
+
+**Date:** 2026-05-19
+**Author:** Alex
+
+## Highlights
+
+### Project-Level Config Discovery for terraphim-agent
+
+This release introduces project-level configuration support for `terraphim-agent`, enabling developers to define project-specific roles, global shortcuts, and configuration overrides in a `.terraphim/config.json` file within their project directories.
+
+**Key Features:**
+- **Automatic Discovery**: Searches parent directories for `.terraphim/` directory starting from current working directory
+- **Role Merging**: Project-specific roles override global roles by `RoleName` (full replacement, not deep merge)
+- **Global Shortcut**: Optional `global_shortcut` field allows project configs to omit it
+- **Non-Invasive**: Global config remains unchanged; project config is optional
+
+**Usage:**
+```json
+{
+  "global_shortcut": "Cmd+K",
+  "roles": {
+    "MyProjectRole": {
+      "haystacks": ["/path/to/project/docs"],
+      ...
+    }
+  }
+}
+```
+
+### Security Fix
+
+- **fix(security): char-safe truncation in sanitize_system_prompt** (Fixes #1721)
+
+### Build Improvements
+
+- **fix(build-runner): tee output to file and fix BUILD.md parsing**
+
+## Full Changelog
+
+| Commit | Description |
+|--------|-------------|
+| `59cd233b7` | feat(config): implement project-level config discovery for .terraphim/ |
+| `26f5b8728` | feat(config): implement project-level config discovery for .terraphim/ |
+| `82c746757` | fix(config): remove needless borrows in project.rs clippy warnings |
+| `511813479` | fix(security): char-safe truncation in sanitize_system_prompt Fixes #1721 |
+| `0b1ebf9d2` | fix(build-runner): tee output to file and fix BUILD.md parsing |
+
+## Upgrade Notes
+
+No breaking changes. Project-level config is entirely optional and backward-compatible with existing global configurations.
+
+## Related Issues
+
+- #1721 - Security: UTF-8 boundary panic in sanitize_system_prompt

.docs/summary-crates-terraphim_config-src-lib.rs.md

@@ -7,6 +7,13 @@
 2. Saved config retrieved from persistence layer
 3. Hard-coded defaults in `terraphim_server/default/`
 
+**Project-Level Config Discovery:**
+- Searches parent directories for `.terraphim/` directory starting from current working directory
+- Enables project-specific roles, global shortcuts, and configuration overrides
+- Merged with global config via `Config::with_project()` and `Config::merge_with()`
+- Roles merged by `RoleName`: project role fully replaces global role (no deep merge)
+- `global_shortcut` field is optional in project configs
+
 **Key Types:**
 - **`Config`**: Top-level configuration holding all roles, global shortcut, default/selected role
 - **`Role`**: User profile with haystacks, relevance function, theme, LLM settings

.docs/summary.md

@@ -97,6 +97,14 @@ User Query
 - `Role`: User profile with haystacks, relevance function, theme, LLM settings
 - `Haystack`: Data source descriptor with service type
 - `KnowledgeGraph`: Automata path and/or local KG files
+- `ProjectConfig`: Project-level overrides in `.terraphim/config.json`
+
+**Project-Level Config Discovery:**
+- Searches parent directories for `.terraphim/` directory starting from CWD
+- Enables project-specific roles, global shortcuts, and configuration overrides
+- Merged with global config via `Config::with_project()` and `Config::merge_with()`
+- Roles merged by `RoleName`: project role fully replaces global role
+- Optional `global_shortcut` field allows project configs to omit it
 
 **Service Types Supported:**
 - Ripgrep, Atomic Server, QueryRs, ClickUp, MCP, Perplexity, GrepApp, AiAssistant, Quickwit, JMAP

Cargo.toml

@@ -44,7 +44,7 @@ exclude = [
 default-members = ["terraphim_server"]
 
 [workspace.package]
-version = "1.17.1"
+version = "1.19.2"
 edition = "2024"
 
 [workspace.dependencies]

crates/haystack_grepapp/Cargo.toml

@@ -8,7 +8,7 @@ license = "MIT"
 repository = "https://github.com/terraphim/terraphim-ai"
 
 [dependencies]
-haystack_core = { path = "../haystack_core", version = "1.0.0" }
+haystack_core = { path = "../haystack_core", version = "1.19.2" }
 terraphim_types = { path = "../terraphim_types", version = "1.0.0" }
 reqwest = { workspace = true, features = ["json", "rustls-tls"] }
 

crates/haystack_jmap/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "haystack_jmap"
-version = "1.0.0"
+version = "1.19.2"
 edition.workspace = true
 license = "MIT"
 

crates/terraphim-markdown-parser/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "terraphim-markdown-parser"
-version = "1.0.0"
+version = "1.19.2"
 edition.workspace = true
 authors = ["Terraphim Contributors"]
 description = "Terraphim Markdown Parser"

crates/terraphim-session-analyzer/Cargo.toml

@@ -78,7 +78,7 @@ tracing = { workspace = true }
 tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 
 # Feature-gated Terraphim dependencies (sibling crates in workspace)
-terraphim_automata = { path = "../terraphim_automata", version = "1.0.0", optional = true }
+terraphim_automata = { path = "../terraphim_automata", version = "1.19.2", optional = true }
 terraphim_types = { path = "../terraphim_types", version = "1.0.0", optional = true }
 terraphim_config = { path = "../terraphim_config", version = "1.0.0", optional = true }
 

crates/terraphim_agent/Cargo.toml

@@ -72,7 +72,7 @@ terraphim_types = { path = "../terraphim_types", version = "1.0.0" }
 terraphim_settings = { path = "../terraphim_settings", version = "1.0.0" }
 terraphim_persistence = { path = "../terraphim_persistence", version = "1.0.0" }
 terraphim_config = { path = "../terraphim_config", version = "1.0.0" }
-terraphim_automata = { path = "../terraphim_automata", version = "1.0.0" }
+terraphim_automata = { path = "../terraphim_automata", version = "1.19.2" }
 terraphim_service = { path = "../terraphim_service", version = "1.0.0", default-features = false }
 terraphim_middleware = { path = "../terraphim_middleware", version = "1.0.0" }
 terraphim_rolegraph = { path = "../terraphim_rolegraph", version = "1.0.0" }

crates/terraphim_agent/src/main.rs

@@ -2049,7 +2049,7 @@ async fn run_offline_command(
         return run_learn_command(sub).await;
     }
 
-    let service = TuiService::new(config_path).await?;
+    let service = TuiService::new(config_path, false).await?;
 
     match command {
         Command::Search {
@@ -5087,7 +5087,7 @@ fn ui_loop(
 
     #[cfg(not(feature = "server"))]
     let backend = {
-        let service = rt.block_on(async { TuiService::new(None).await })?;
+        let service = rt.block_on(async { TuiService::new(None, false).await })?;
         crate::tui_backend::TuiBackend::Local(service)
     };
 

crates/terraphim_agent/src/repl/handler.rs

@@ -2882,7 +2882,7 @@ impl ReplHandler {
 
 /// Run REPL in offline mode
 pub async fn run_repl_offline_mode() -> Result<()> {
-    let service = TuiService::new(None).await?;
+    let service = TuiService::new(None, false).await?;
     let mut handler = ReplHandler::new_offline(service);
     handler.run().await
 }