From ca47b053ed36246737b74b389fbaae0ff18f02df Mon Sep 17 00:00:00 2001 From: Terraphim CI Date: Wed, 4 Mar 2026 21:58:44 +0000 Subject: [PATCH] docs: organize root files and role configs Documentation cleanup: - Move 8 stale CI/report .md files to docs/archive/root/ - Move PERFORMANCE_BENCHMARKING_README.md to docs/ - Move TAURI_SETUP_INSTRUCTIONS.md to desktop/ Role config organization: - Move 12 specialized/experimental configs to examples/role-configs/ - Remove stale terraphim_engineer_config_fixed.json - Keep core configs in terraphim_server/default/ (engineer, default, system_operator, rust_engineer, ollama_*, combined) - Update integration test paths for moved configs Refs: #625 Co-Authored-By: Terraphim AI --- .../TAURI_SETUP_INSTRUCTIONS.md | 0 .../PERFORMANCE_BENCHMARKING_README.md | 0 .../archive/root/CI_FIX_STATUS.md | 0 .../archive/root/CRASH_ANALYSIS_REPORT.md | 0 .../root/DEPENDENCY_MINIMIZATION_REPORT.md | 0 .../archive/root/FIX_VERIFICATION_REPORT.md | 0 .../root/PHASE2_COMPLETE_IMPLEMENTATION.md | 0 .../archive/root/RELEASE_PUBLISHED.md | 0 .../archive/root/ci_critical_fixes.md | 0 .../archive/root/ci_fixes_proposal.md | 0 .../role-configs}/ai_engineer_config.json | 0 .../context_engineer_config.json | 0 .../role-configs}/devops_cicd_config.json | 0 .../dynamic_ontology_config.json | 0 .../frontend_engineer_config.json | 0 .../local_knowledge_engineer_config.json | 0 .../perplexity_researcher_config.json | 0 .../role-configs}/python_engineer_config.json | 0 .../quickwit_autodiscovery_config.json | 0 .../quickwit_engineer_config.json | 0 .../quickwit_production_config.json | 0 ...aphim_engineer_config_with_openrouter.json | 0 .../terraphim_engineer_config_fixed.json | 59 ------------------- .../frontend_engineer_integration_test.rs | 8 +-- .../tests/python_engineer_integration_test.rs | 8 +-- 25 files changed, 8 insertions(+), 67 deletions(-) rename TAURI_SETUP_INSTRUCTIONS.md => desktop/TAURI_SETUP_INSTRUCTIONS.md (100%) rename PERFORMANCE_BENCHMARKING_README.md => docs/PERFORMANCE_BENCHMARKING_README.md (100%) rename CI_FIX_STATUS.md => docs/archive/root/CI_FIX_STATUS.md (100%) rename CRASH_ANALYSIS_REPORT.md => docs/archive/root/CRASH_ANALYSIS_REPORT.md (100%) rename DEPENDENCY_MINIMIZATION_REPORT.md => docs/archive/root/DEPENDENCY_MINIMIZATION_REPORT.md (100%) rename FIX_VERIFICATION_REPORT.md => docs/archive/root/FIX_VERIFICATION_REPORT.md (100%) rename PHASE2_COMPLETE_IMPLEMENTATION.md => docs/archive/root/PHASE2_COMPLETE_IMPLEMENTATION.md (100%) rename RELEASE_PUBLISHED.md => docs/archive/root/RELEASE_PUBLISHED.md (100%) rename ci_critical_fixes.md => docs/archive/root/ci_critical_fixes.md (100%) rename ci_fixes_proposal.md => docs/archive/root/ci_fixes_proposal.md (100%) rename {terraphim_server/default => examples/role-configs}/ai_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/context_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/devops_cicd_config.json (100%) rename {terraphim_server/default => examples/role-configs}/dynamic_ontology_config.json (100%) rename {terraphim_server/default => examples/role-configs}/frontend_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/local_knowledge_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/perplexity_researcher_config.json (100%) rename {terraphim_server/default => examples/role-configs}/python_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/quickwit_autodiscovery_config.json (100%) rename {terraphim_server/default => examples/role-configs}/quickwit_engineer_config.json (100%) rename {terraphim_server/default => examples/role-configs}/quickwit_production_config.json (100%) rename {terraphim_server/default => examples/role-configs}/terraphim_engineer_config_with_openrouter.json (100%) delete mode 100644 terraphim_server/default/terraphim_engineer_config_fixed.json diff --git a/TAURI_SETUP_INSTRUCTIONS.md b/desktop/TAURI_SETUP_INSTRUCTIONS.md similarity index 100% rename from TAURI_SETUP_INSTRUCTIONS.md rename to desktop/TAURI_SETUP_INSTRUCTIONS.md diff --git a/PERFORMANCE_BENCHMARKING_README.md b/docs/PERFORMANCE_BENCHMARKING_README.md similarity index 100% rename from PERFORMANCE_BENCHMARKING_README.md rename to docs/PERFORMANCE_BENCHMARKING_README.md diff --git a/CI_FIX_STATUS.md b/docs/archive/root/CI_FIX_STATUS.md similarity index 100% rename from CI_FIX_STATUS.md rename to docs/archive/root/CI_FIX_STATUS.md diff --git a/CRASH_ANALYSIS_REPORT.md b/docs/archive/root/CRASH_ANALYSIS_REPORT.md similarity index 100% rename from CRASH_ANALYSIS_REPORT.md rename to docs/archive/root/CRASH_ANALYSIS_REPORT.md diff --git a/DEPENDENCY_MINIMIZATION_REPORT.md b/docs/archive/root/DEPENDENCY_MINIMIZATION_REPORT.md similarity index 100% rename from DEPENDENCY_MINIMIZATION_REPORT.md rename to docs/archive/root/DEPENDENCY_MINIMIZATION_REPORT.md diff --git a/FIX_VERIFICATION_REPORT.md b/docs/archive/root/FIX_VERIFICATION_REPORT.md similarity index 100% rename from FIX_VERIFICATION_REPORT.md rename to docs/archive/root/FIX_VERIFICATION_REPORT.md diff --git a/PHASE2_COMPLETE_IMPLEMENTATION.md b/docs/archive/root/PHASE2_COMPLETE_IMPLEMENTATION.md similarity index 100% rename from PHASE2_COMPLETE_IMPLEMENTATION.md rename to docs/archive/root/PHASE2_COMPLETE_IMPLEMENTATION.md diff --git a/RELEASE_PUBLISHED.md b/docs/archive/root/RELEASE_PUBLISHED.md similarity index 100% rename from RELEASE_PUBLISHED.md rename to docs/archive/root/RELEASE_PUBLISHED.md diff --git a/ci_critical_fixes.md b/docs/archive/root/ci_critical_fixes.md similarity index 100% rename from ci_critical_fixes.md rename to docs/archive/root/ci_critical_fixes.md diff --git a/ci_fixes_proposal.md b/docs/archive/root/ci_fixes_proposal.md similarity index 100% rename from ci_fixes_proposal.md rename to docs/archive/root/ci_fixes_proposal.md diff --git a/terraphim_server/default/ai_engineer_config.json b/examples/role-configs/ai_engineer_config.json similarity index 100% rename from terraphim_server/default/ai_engineer_config.json rename to examples/role-configs/ai_engineer_config.json diff --git a/terraphim_server/default/context_engineer_config.json b/examples/role-configs/context_engineer_config.json similarity index 100% rename from terraphim_server/default/context_engineer_config.json rename to examples/role-configs/context_engineer_config.json diff --git a/terraphim_server/default/devops_cicd_config.json b/examples/role-configs/devops_cicd_config.json similarity index 100% rename from terraphim_server/default/devops_cicd_config.json rename to examples/role-configs/devops_cicd_config.json diff --git a/terraphim_server/default/dynamic_ontology_config.json b/examples/role-configs/dynamic_ontology_config.json similarity index 100% rename from terraphim_server/default/dynamic_ontology_config.json rename to examples/role-configs/dynamic_ontology_config.json diff --git a/terraphim_server/default/frontend_engineer_config.json b/examples/role-configs/frontend_engineer_config.json similarity index 100% rename from terraphim_server/default/frontend_engineer_config.json rename to examples/role-configs/frontend_engineer_config.json diff --git a/terraphim_server/default/local_knowledge_engineer_config.json b/examples/role-configs/local_knowledge_engineer_config.json similarity index 100% rename from terraphim_server/default/local_knowledge_engineer_config.json rename to examples/role-configs/local_knowledge_engineer_config.json diff --git a/terraphim_server/default/perplexity_researcher_config.json b/examples/role-configs/perplexity_researcher_config.json similarity index 100% rename from terraphim_server/default/perplexity_researcher_config.json rename to examples/role-configs/perplexity_researcher_config.json diff --git a/terraphim_server/default/python_engineer_config.json b/examples/role-configs/python_engineer_config.json similarity index 100% rename from terraphim_server/default/python_engineer_config.json rename to examples/role-configs/python_engineer_config.json diff --git a/terraphim_server/default/quickwit_autodiscovery_config.json b/examples/role-configs/quickwit_autodiscovery_config.json similarity index 100% rename from terraphim_server/default/quickwit_autodiscovery_config.json rename to examples/role-configs/quickwit_autodiscovery_config.json diff --git a/terraphim_server/default/quickwit_engineer_config.json b/examples/role-configs/quickwit_engineer_config.json similarity index 100% rename from terraphim_server/default/quickwit_engineer_config.json rename to examples/role-configs/quickwit_engineer_config.json diff --git a/terraphim_server/default/quickwit_production_config.json b/examples/role-configs/quickwit_production_config.json similarity index 100% rename from terraphim_server/default/quickwit_production_config.json rename to examples/role-configs/quickwit_production_config.json diff --git a/terraphim_server/default/terraphim_engineer_config_with_openrouter.json b/examples/role-configs/terraphim_engineer_config_with_openrouter.json similarity index 100% rename from terraphim_server/default/terraphim_engineer_config_with_openrouter.json rename to examples/role-configs/terraphim_engineer_config_with_openrouter.json diff --git a/terraphim_server/default/terraphim_engineer_config_fixed.json b/terraphim_server/default/terraphim_engineer_config_fixed.json deleted file mode 100644 index e445df7f7..000000000 --- a/terraphim_server/default/terraphim_engineer_config_fixed.json +++ /dev/null @@ -1,59 +0,0 @@ -{ - "id": "Server", - "global_shortcut": "Ctrl+Shift+T", - "roles": { - "Default": { - "shortname": "Default", - "name": "Default", - "relevance_function": "title-scorer", - "terraphim_it": false, - "theme": "spacelab", - "kg": null, - "haystacks": [ - { - "location": "docs/src", - "service": "Ripgrep", - "read_only": true, - "atomic_server_secret": null, - "extra_parameters": {} - } - ], - "extra": {} - }, - "Terraphim Engineer": { - "shortname": "TerraEng", - "name": "Terraphim Engineer", - "relevance_function": "terraphim-graph", - "terraphim_it": true, - "theme": "lumen", - "kg": { - "automata_path": null, - "knowledge_graph_local": { - "input_type": "markdown", - "path": "docs/src/kg" - }, - "public": true, - "publish": true - }, - "haystacks": [ - { - "location": "docs/src", - "service": "Ripgrep", - "read_only": true, - "atomic_server_secret": null, - "extra_parameters": {} - } - ], - "extra": { - "llm_provider": "openrouter", - "openrouter_api_key": "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", - "openrouter_model": "openai/gpt-3.5-turbo", - "openrouter_chat_enabled": true, - "openrouter_chat_model": "openai/gpt-3.5-turbo", - "openrouter_chat_system_prompt": "You are a helpful AI assistant that works with the Terraphim AI project. You help with Rust programming, knowledge graphs, and system architecture questions." - } - } - }, - "default_role": "Terraphim Engineer", - "selected_role": "Terraphim Engineer" -} diff --git a/terraphim_server/tests/frontend_engineer_integration_test.rs b/terraphim_server/tests/frontend_engineer_integration_test.rs index fa39d85fd..09cab54ae 100644 --- a/terraphim_server/tests/frontend_engineer_integration_test.rs +++ b/terraphim_server/tests/frontend_engineer_integration_test.rs @@ -28,9 +28,9 @@ async fn test_frontend_engineer_grepapp_integration() { // Load the Front End Engineer configuration let config_path = if current_dir.ends_with("terraphim_server") { - PathBuf::from("default/frontend_engineer_config.json") + PathBuf::from("../examples/role-configs/frontend_engineer_config.json") } else { - PathBuf::from("terraphim_server/default/frontend_engineer_config.json") + PathBuf::from("examples/role-configs/frontend_engineer_config.json") }; if !config_path.exists() { @@ -251,9 +251,9 @@ async fn test_frontend_engineer_config_structure() { let current_dir = std::env::current_dir().unwrap(); let config_path = if current_dir.ends_with("terraphim_server") { - PathBuf::from("default/frontend_engineer_config.json") + PathBuf::from("../examples/role-configs/frontend_engineer_config.json") } else { - PathBuf::from("terraphim_server/default/frontend_engineer_config.json") + PathBuf::from("examples/role-configs/frontend_engineer_config.json") }; if !config_path.exists() { diff --git a/terraphim_server/tests/python_engineer_integration_test.rs b/terraphim_server/tests/python_engineer_integration_test.rs index 53b527ade..80ef0fb9b 100644 --- a/terraphim_server/tests/python_engineer_integration_test.rs +++ b/terraphim_server/tests/python_engineer_integration_test.rs @@ -28,9 +28,9 @@ async fn test_python_engineer_grepapp_integration() { // Load the Python Engineer configuration let config_path = if current_dir.ends_with("terraphim_server") { - PathBuf::from("default/python_engineer_config.json") + PathBuf::from("../examples/role-configs/python_engineer_config.json") } else { - PathBuf::from("terraphim_server/default/python_engineer_config.json") + PathBuf::from("examples/role-configs/python_engineer_config.json") }; if !config_path.exists() { @@ -221,9 +221,9 @@ async fn test_python_engineer_config_structure() { let current_dir = std::env::current_dir().unwrap(); let config_path = if current_dir.ends_with("terraphim_server") { - PathBuf::from("default/python_engineer_config.json") + PathBuf::from("../examples/role-configs/python_engineer_config.json") } else { - PathBuf::from("terraphim_server/default/python_engineer_config.json") + PathBuf::from("examples/role-configs/python_engineer_config.json") }; if !config_path.exists() {