Dev

.github/workflows/agent_engine_build.yml

@@ -99,6 +99,17 @@ jobs:
         if: startsWith(matrix.os, 'macos')
         run: brew install llvm
 
+      - name: Add swap space (Linux cross-compilation needs extra RAM for LTO)
+        if: matrix.cross
+        run: |
+          sudo swapoff /swapfile 2>/dev/null || true
+          sudo rm -f /swapfile
+          sudo dd if=/dev/zero of=/swapfile bs=128M count=64
+          sudo chmod 600 /swapfile
+          sudo mkswap /swapfile
+          sudo swapon /swapfile
+          free -h
+
       - name: setup cross-rs
         if: matrix.cross
         run: |
@@ -134,6 +145,9 @@ jobs:
 
       - name: build linux-like artifacts
         if: matrix.cross
+        env:
+          # Limit parallel codegen/link jobs to reduce peak RAM (LTO + whisper-rs is very memory-hungry)
+          CARGO_BUILD_JOBS: 2
         run: |
           CROSS_NO_WARNINGS=0 cross test --release --target ${{ matrix.target }} || exit 1
           CROSS_NO_WARNINGS=0 cross build --release --target ${{ matrix.target }} || exit 1

.github/workflows/agent_engine_release.yml

@@ -86,6 +86,17 @@ jobs:
         if: startsWith(matrix.os, 'macos')
         run: brew install llvm
 
+      - name: Add swap space (Linux cross-compilation needs extra RAM for LTO)
+        if: matrix.cross
+        run: |
+          sudo swapoff /swapfile 2>/dev/null || true
+          sudo rm -f /swapfile
+          sudo dd if=/dev/zero of=/swapfile bs=128M count=64
+          sudo chmod 600 /swapfile
+          sudo mkswap /swapfile
+          sudo swapon /swapfile
+          free -h
+
       - name: setup cross-rs
         if: matrix.cross
         run: |
@@ -121,6 +132,9 @@ jobs:
 
       - name: build linux-like artifacts
         if: matrix.cross
+        env:
+          # Limit parallel codegen/link jobs to reduce peak RAM (LTO + whisper-rs is very memory-hungry)
+          CARGO_BUILD_JOBS: 2
         run: |
           CROSS_NO_WARNINGS=0 cross test --release --target ${{ matrix.target }} || exit 1
           CROSS_NO_WARNINGS=0 cross build --release --target ${{ matrix.target }} || exit 1

.github/workflows/agent_gui_build.yml

@@ -16,6 +16,9 @@ defaults:
   run:
     working-directory: refact-agent/gui
 
+env:
+  NODE_OPTIONS: --max-old-space-size=8192
+
 jobs:
   build:
     runs-on: ubuntu-latest

AGENTS.md

@@ -0,0 +1,146 @@
+# Refact Monorepo
+
+AI coding assistant: Rust engine (LSP/HTTP server) + React chat UI + IDE plugins (VSCode, JetBrains) + cloud backend.
+
+## Repository Map
+
+| Subproject | Path | Language | AGENTS.md |
+|---|---|---|---|
+| Agent Engine | `refact-agent/engine/` | Rust 2021, async/tokio | ✅ `refact-agent/engine/AGENTS.md` |
+| Agent GUI | `refact-agent/gui/` | TypeScript/React 18 | ✅ `refact-agent/gui/AGENTS.md` |
+| VSCode Extension | `extra/refact-vscode/` | TypeScript | — |
+| JetBrains Plugin | `extra/refact-intellij/` | Kotlin, Gradle | — |
+| Cloud Backend | `extra/web_v1_backend/` | Python 3.10, FastAPI | — |
+| Documentation | `docs/` | Astro (static site) | — |
+
+Sub-project `AGENTS.md` files contain detailed architecture, patterns, and checklists. Read them before working in those directories.
+
+## Verification Commands
+
+**Always verify your changes compile and pass tests before finishing.** Both engine and GUI builds are heavy — plan accordingly.
+
+### Engine (`refact-agent/engine/`)
+
+```bash
+cd refact-agent/engine
+
+# Fast check — type/borrow errors only (~1-3 min, no codegen)
+cargo check
+
+# Unit + doc tests (~3-8 min first build, ~1-3 min incremental)
+cargo test --lib && cargo test --doc
+
+# Full release build (~10-20 min cold, ~2-5 min incremental)
+# LTO + opt-level=z + strip — very slow from scratch
+cargo build --release
+```
+
+⚠️ **First build compiles ~85 crates + 7 tree-sitter parsers + SQLite. Expect 10-20 minutes cold.** Incremental builds are much faster. CI runs `cargo test --release` on 7 platform targets.
+
+Python integration tests (`tests/*.py`) require a running `refact-lsp` instance — don't run them as a quick check.
+
+### GUI (`refact-agent/gui/`)
+
+```bash
+cd refact-agent/gui
+
+# All CI checks (~1-3 min total)
+npm run test              # vitest (unit, excludes integration)
+npm run format:check      # prettier — no code changes
+npm run types             # tsc --noEmit
+npm run lint              # eslint, 0 warnings allowed
+
+# Full build (~30-60s)
+npm run build
+```
+
+⚠️ **ESLint is strict-type-checked with `--max-warnings 0`.** Any new warning fails CI. Run `npm run lint` before committing TypeScript changes.
+
+### Minimum pre-commit checks
+
+If you changed **only engine Rust code**: `cd refact-agent/engine && cargo check && cargo test --lib`
+If you changed **only GUI TypeScript**: `cd refact-agent/gui && npm run types && npm run lint && npm run test`
+If you changed **both**: run both sets.
+
+## CI Quality Gates (GitHub Actions)
+
+| Workflow | Trigger paths | Checks |
+|---|---|---|
+| `agent_engine_build` | `refact-agent/engine/**` | `cargo test --release` on 7 targets (Win/Linux/macOS × x86_64/aarch64) |
+| `agent_gui_build` | `refact-agent/gui/**` | `npm test` → `format:check` → `types` → `lint` → `build` (Node LTS + latest) |
+| `server_build` | `refact-server/**` | Docker multi-arch build |
+| `docs_build` | `docs/**` | Docker build + push |
+
+## Architecture Overview
+
+```
+┌─────────────────┐     postMessage      ┌──────────────────┐
+│  IDE Plugins    │◄────────────────────►│   Agent GUI      │
+│  (VSCode/JB)    │                      │   (React webview)│
+└────────┬────────┘                      └────────┬─────────┘
+         │ LSP (stdin/stdout)                     │ HTTP + SSE
+         │ or HTTP                                │
+         └──────────────┬─────────────────────────┘
+                        ▼
+              ┌─────────────────────┐
+              │   Agent Engine      │
+              │   (refact-lsp)      │
+              │   HTTP :8001 + LSP  │
+              └──────┬──────────────┘
+                     │
+         ┌───────────┼───────────────┐
+         ▼           ▼               ▼
+    LLM APIs    Local indexes    Integrations
+   (15+ providers) (AST, VecDB)  (GitHub, MCP, shell, etc.)
+```
+
+- **Engine ↔ GUI**: HTTP REST + SSE streaming (`/v1/chats/subscribe`). GUI sends commands via `POST /v1/chats/{id}/commands`, receives state via SSE events with monotonic `seq` numbers.
+- **Engine ↔ IDE**: LSP protocol (tower-lsp) for completions/code-lens, plus HTTP for chat and tools.
+- **IDE ↔ GUI**: `postMessage` bridge (VSCode `acquireVsCodeApi`, JetBrains `postIntellijMessage`). Events: file context, theme, tool calls.
+
+## Cross-Project Conventions
+
+### Rust (Engine)
+
+- **Formatting**: `rustfmt.toml` — 100 char lines, 4-space indent, Unix newlines, `reorder_imports = false`.
+- **Async discipline**: All shared state through `GlobalContext` (`Arc<ARwLock<>>`). Drop read guards before `.await`. Never hold `gcx.read()` across await points.
+- **Shutdown**: Check `shutdown_flag.load(Ordering::Relaxed)` in loops. Use `select!` with shutdown arm for channel receivers. Never `loop { sleep }` without a shutdown check. Store `JoinHandle` for spawned tasks — no fire-and-forget `tokio::spawn`.
+- **Lock ordering**: Always acquire `gcx` ARwLock before inner mutexes. Reversing order risks deadlocks in background threads.
+- **Error handling**: `Result<>` with contextual errors. `.ok_or_else()` over `.unwrap()` for runtime data.
+
+### TypeScript/React (GUI)
+
+- **Linting**: ESLint strict-type-checked, 0 warnings. Prettier enforced in CI.
+- **State**: Redux Toolkit + RTK Query. Always use selectors from `features/Chat/Thread/selectors.ts`. Never access `state.chat.threads[id]` directly.
+- **Styling**: Radix UI primitives + CSS Modules + design tokens. No inline styles, no hardcoded colors, no magic numbers.
+- **File naming**: `PascalCase.tsx` (components), `useCamelCase.ts` (hooks), `camelCase.ts` (utils), `PascalCase.module.css`.
+- **No `any` types.**
+
+### Kotlin (JetBrains Plugin)
+
+- Java 17 target. Gradle build with IntelliJ Platform Plugin. Communicates with engine via HTTP + JCEF webview for chat.
+
+### Python (Backend)
+
+- Python 3.10+. FastAPI + Uvicorn. Type hints expected.
+
+## Project Config Locations
+
+| Scope | Path | Contents |
+|---|---|---|
+| User config | `~/.config/refact/` | `default_privacy.yaml`, `providers.d/*.yaml` |
+| Cache | `~/.cache/refact/` | Shadow repos, logs, telemetry, integrations |
+| Project | `.refact/` | `trajectories/`, `knowledge/`, `tasks/`, `integrations.d/` |
+| System prompts | `refact-agent/engine/yaml_configs/defaults/` | Modes, subagents, toolbox commands |
+
+### AGENTS.md Scoping Rules
+
+AGENTS.md files can appear at any directory level. Scope = entire directory tree rooted at that folder. More-deeply-nested files take precedence on conflicts. Direct user instructions override all AGENTS.md content.
+
+## Common Pitfalls
+
+- **Shutdown hangs**: `loop {}` without `shutdown_flag`, bare `.recv().await`/`.changed().await` without `select!` + timeout, `tokio::spawn` without stored handle.
+- **Lock inversion**: `gcx.read().await` → inner mutex is safe order. Reversing (inner mutex → gcx) causes deadlocks under load.
+- **SSE sequence gaps**: Every event has monotonic `seq`. Gap → client reconnects for fresh snapshot. Never skip or reorder events.
+- **Thinking block signatures**: Anthropic thinking blocks with cryptographic signatures must be preserved byte-for-byte. No JSON rebuilding, no field reordering.
+- **GUI state**: Chat/history state is ephemeral (not persisted). Only `tour` and `userSurvey` survive Redux persist.

refact-agent/engine/Cargo.toml

@@ -6,7 +6,7 @@ lto = true
 
 [package]
 name = "refact-lsp"
-version = "7.0.2"
+version = "7.1.0"
 edition = "2021"
 build = "build.rs"
 
@@ -60,8 +60,7 @@ process-wrap = { version = "8.0.2", features = ["tokio1"] }
 rand = "0.8.5"
 rayon = "1.8.0"
 regex = "1.9.5"
-reqwest = { version = "0.12", default-features = false, features = ["json", "stream", "rustls-tls-webpki-roots", "charset", "http2"] }
-reqwest-eventsource = "0.6.0"
+reqwest = { version = "0.13", default-features = false, features = ["json", "form", "stream", "rustls", "charset", "http2"] }
 eventsource-stream = "0.2"
 resvg = "0.44.0"
 ropey = "1.6"
@@ -112,8 +111,9 @@ petgraph = "0.6"
 zerocopy = "0.8.14"
 
 # There you can use a local copy
-# rmcp = { path = "../../../rust-sdk/crates/rmcp/", "features" = ["client", "transport-child-process", "transport-sse"] }
-rmcp = { git = "https://github.com/smallcloudai/rust-sdk", branch = "main", features = ["client", "transport-child-process", "transport-sse-client", "reqwest"] }
+# rmcp = { path = "../../../rust-sdk/crates/rmcp/", features = ["client", "transport-child-process", "transport-streamable-http-client-reqwest", "auth"] }
+rmcp = { git = "https://github.com/modelcontextprotocol/rust-sdk", branch = "main", features = ["client", "transport-child-process", "transport-streamable-http-client-reqwest", "auth"] }
+oauth2 = "5.0"
 thiserror = "2.0.12"
 dirs = "5.0"
 whisper-rs = { version = "0.12", optional = true }

refact-agent/engine/src/ast/ast_indexer_thread.rs

@@ -46,8 +46,16 @@ async fn ast_indexer_thread(
         )
     };
     let ast_max_files = ast_index.ast_max_files; // cannot change
+    let shutdown_flag = match gcx_weak.upgrade() {
+        Some(gcx) => gcx.read().await.shutdown_flag.clone(),
+        None => return,
+    };
 
     loop {
+        if shutdown_flag.load(std::sync::atomic::Ordering::SeqCst) {
+            info!("AST indexer: shutdown detected, stopping");
+            return;
+        }
         let (cpath, left_todo_count) = {
             let mut ast_service_locked = ast_service.lock().await;
             let mut cpath;
@@ -305,12 +313,17 @@ async fn ast_indexer_thread(
             reported_connect_stats = true;
         }
 
-        tokio::time::timeout(
-            tokio::time::Duration::from_secs(10),
-            ast_sleeping_point.notified(),
-        )
-        .await
-        .ok();
+        tokio::select! {
+            _ = tokio::time::timeout(tokio::time::Duration::from_secs(10), ast_sleeping_point.notified()) => {}
+            _ = async {
+                while !shutdown_flag.load(std::sync::atomic::Ordering::SeqCst) {
+                    tokio::time::sleep(tokio::time::Duration::from_millis(200)).await;
+                }
+            } => {
+                info!("AST indexer: shutdown detected, stopping");
+                return;
+            }
+        }
     }
 }
 

refact-agent/engine/src/call_validation.rs

@@ -429,7 +429,6 @@ pub fn canonical_mode_id(mode: &str) -> Result<String, String> {
         "EXPLORE" => "explore".to_string(),
         "AGENT" => "agent".to_string(),
         "CONFIGURE" | "CONFIGURATOR" => "configurator".to_string(),
-        "PROJECT_SUMMARY" => "project_summary".to_string(),
         "PLAN" => "plan".to_string(),
         "TASK_PLANNER" => "task_planner".to_string(),
         "TASK_AGENT" => "task_agent".to_string(),