
grounded-harness
dev.krusch/grounded-harness
Turn-0 workspace grounding, spin-loop blocker, and defect-only stop gate for AI coding agents.
Documentation
Krusch Grounded Harness (krusch-grounded-harness v0.2.0)
Standalone Turn-0 workspace grounder, duplicate-call spin-loop blocker, and zero-turn defect-only output gate for AI coding and data agents. Runs 100% locally on Node 22 node:sqlite (7 MCP tools + HTTP :3782 gateway + ESM library) with zero cloud calls.
Turn-0 Grounded, Scale-Aware, Low-Tool-Call Agent Harness (HTTP :3782 Control Gateway + 7-tool stdio MCP Server + Node 22 ESM library) built on @krusch/toolkit (v1.8.1).
⚡ 30-Second Standalone Quickstart (Zero Cloud, Zero Docker)
1. Clone, Test & Ground Any Workspace Locally
Requires only Node.js >= 22.0.0 (uses built-in node:sqlite in WAL mode with zero Docker containers, zero native C++ compilation, and zero API keys):
git clone https://github.com/kruschdev/grounded-harness.git
cd grounded-harness
npm ci
npm test
# Verify SQLite WAL engine, 7 annotated MCP tools, and v0.2.0 invariants
node bin/krusch-grounded-harness.js doctor
# Compile Turn-0 workspace schemas, dataset hazard flags & Raw-RAG chunks (0 LLM calls)
node bin/krusch-grounded-harness.js ground --dir . --goal "Inspect workspace schemas and hazards"
2. Connect to Your Agent (.mcp.json / Cursor) or Run via krusch-stack
Paste into your project .mcp.json, Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), or Antigravity (~/.gemini/antigravity/mcp_config.json):
{
"mcpServers": {
"krusch-grounded-harness": {
"command": "node",
"args": ["/absolute/path/to/grounded-harness/bin/krusch-grounded-harness.js", "mcp"]
}
}
}
Prefer a zero-clone npx command or single-package ESM import? Run the bundled engine directly through krusch-stack:
# Start the 7-tool stdio MCP server without cloning a separate repo
npx -y krusch-stack mcp --server krusch-grounded-harness
// Embed via krusch-stack (zero external runtime dependencies) or standalone package
import { createGroundedHarnessEngine } from 'krusch-stack/grounded-harness';
// Standalone repo import: import { createGroundedHarness } from 'krusch-grounded-harness';
🩹 Before vs. After (What It Fixes)
| Common Agent Failure Mode | Without krusch-grounded-harness | With krusch-grounded-harness ($0.00, 0 Cloud Calls) |
|---|---|---|
Blind file foraging & CSV "NA" = North America NaN corruption | Wastes 60%–75% of turns running ls/head/cat and silently drops "NA" country codes as NaN or misreads JSON null vs. [] wildcards. | compileTurnZeroGrounding introspects RFC-4180 CSV/TSV, JSON/JSONL, read-only SQLite DDL, code symbols, and 256/32-tok Raw-RAG docs before Step 1, flagging keep_default_na=False and null/[] hazards automatically. |
| Identical failing or redundant tool-call spin loops | Re-runs the same broken query or file read with tweaked comments/whitespace, burning context and API budget. | normalizeCodeSnippetForHash strips comments outside strings (preserving Python // floor division) to serve MEMOIZED_PRIOR_READ on repeats and BLOCK_SPIN_LOOP (0 wasted re-executions) on repeat failures while keeping maxReadStreak = 0 for distinct reads. |
Raw np.float64(...) / <tool_call> leaks or self-doubt nudges | Leaks raw np.float64(...), pandas dtype:, <tool_call> XML, or NaN into final answers, or loses accuracy from unconditional "are you sure?" stop-nudges. | inspectOutputDefects approves clean answers in 0 extra turns and triggers a single targeted repair (maxDefectRetries = 1) strictly on objective output defects. |
🧩 Ecosystem Fit (Use Standalone or Combined)
krusch-grounded-harness has zero runtime service dependencies and works standalone out of the box, or pairs cleanly with sibling tools when you want deeper state guarantees:
krusch-context-mcp(Persistent Working Memory): Pair Turn-0 workspace grounding with cross-session episodic memory, decision lineage, and pre-commit invariant nudges (5MCP tools onnode:sqlite).krusch-coding-harness(2PC Staged File Diffs): Add content-addressed diff staging, Bubblewrap sandbox verification, andSIGKILL-recoverable write-ahead disk apply for unattended background daemons.krusch-stack(Unified One-Command Bundle): Run Turn-0 grounding alongside memory, Git/AST symbol graphs, and staged execution vianpx -y krusch-stack init(supports--server krusch-grounded-harness,--components grounded-harness, and--profile coding-agent).
⚡ Overview & Six Empirical Design Laws (INV-GH-01..10)
Distilled from 16,800 Official DolphinBench traces (28 official 600-task multi-session tool runs across 6 model families: 17 $0.00 open-weights + 11 frontier/model-matched runs, 98.33% Oracle@28, 83.17% $0.00 Oracle@17), 120 DABstep multi-step analytics episodes, BEAM (100K–10M tokens), and BFCL v3 (64 live tools), krusch-grounded-harness replaces unconditional outer-loop 2PC stop-nudging with six zero-overhead-when-healthy structural laws:
- Turn-0 Schema +
Raw-RAGBriefing with Dataset Hazard Flags (INV-GH-01,INV-GH-02)compileTurnZeroGroundingintrospects RFC-4180 CSV/TSV columns, JSON/JSONL object arrays, read-only SQLite DDL & row counts, code symbols, and256/32-tokenRaw-RAGdocumentation chunks with0LLM ingestion calls, paired with Okapi BM25 tool deferral (-70%to-80%schema tokens) and SHA-256prefixHashKV-cache normalization.- Explicitly flags CSV
"NA"string literals (keep_default_na=Falseinpandas.read_csv) and JSONnullvs. empty-list[]wildcards before Step 1 (skipping.env/ secret files automatically).
- Gemini Tool-Less
functionCallingConfig: { mode: "NONE" }Guard (INV-GH-09)buildSafeGeminiToolConfig(andbuildGeminiPayloadin@krusch/toolkit/llm) automatically injectstoolConfig: { functionCallingConfig: { mode: 'NONE' } }whenevertoolsis omitted or empty[], eliminatingMALFORMED_FUNCTION_CALLempty turns on markdown```pycode blocks.
- Zero-Turn Defect-Only Output Gate (
inspectOutputDefects,INV-GH-05)- Approves clean completions in
0extra turns while blocking objective output defects (maxDefectRetries = 1):EMPTY_OR_NULL_BAILOUT: literal"",None,null,NaN,[],{}when an answer is expected (never blocking"0",0,false,"Not Applicable", or"N/A").TRUNCATED_OUTPUT:finishReasoninMAX_TOKENS/length/MALFORMED_FUNCTION_CALLor truncated tool JSON.SERIALIZED_TOOL_CALL_IN_TEXT: raw<tool_call>{...}</tool_call>orcall:fn{...}emitted in prose whentoolCalls.length === 0.RAW_DATAFRAME_OR_NUMPY_REPR: unformattednp.float64(...)or pandasdtype:repr leaks in final answers.
- Approves clean completions in
- Quote-Safe Comment-Normalized Call Hashing (
BLOCK_SPIN_LOOP) &maxReadStreak = 0(INV-GH-04)normalizeCodeSnippetForHashstrips comments outside string literals (preserving Python//floor division and indentation) prior to SHA-256 hashing. First repeats ofCOMMITTEDreads returnMEMOIZED_PRIOR_READwith cached preview; repeat identicalFAILEDcalls or repeats afterMEMOIZED_PRIOR_READreturnBLOCK_SPIN_LOOPwith0tool re-executions. Distinct multi-step reads (1..N) are never throttled (maxReadStreak === 0).
- Scale-Aware Thinking Curve & Staged-Diff-Only
FORCE_VERIFY(INV-GH-03,INV-GH-05)SMALL_MODEL(< 15Bnon-thinking) receives compact[PLAN -> BIND -> ACT]guidance plus placeholder ({{var}}) and invalid-calendar-date soft-holds (HOLD);MID_MODEL(15B–70B) andFRONTIER_REASONING(>= 70Bor native thinking) execute with0outer thinking overhead.FORCE_VERIFYfires strictly whenpendingDiffsCount > 0 && !latestVerificationPassed, never on read-only analytics or policy abstentions.
- Partial
stdoutPreservation on Sandbox Timeouts (INV-GH-10)execCommandWithPartialStdoutandformatTimeoutWithPartialStdoutpreserve partialstdoutemitted prior to timeout alongsideTimeoutErrorwhile clearing stalefinalAnswer: null(hasFinalAnswer: false).
📊 Empirical Benchmark Results (4,200 Grounded / 16,800 Total Official DolphinBench Traces & 120 Adyen DABstep Episodes)
1. Official DolphinBench Multi-App Suite (7 × 600 = 4,200 Grounded Traces Within 28 Runs / 16,800 openai/gpt-5.6-sol Traces, 0o444 Frozen SQLite, 5/5 Clean-Room Gates)
Model & Scale Tier (N = 600 Tasks/Run) | Standard Harness | + Grounded Harness (v0.2.0 / v0.3) | Key Latency, Persona & Telemetry Outcomes | Archive SHA-256 |
|---|---|---|---|---|
Google Gemini 4 Argon (FRONTIER_REASONING, Low, v0.3, $24.54 / $30.54) | 91.17% (547/600, uploaded dolphinbench.ai submission UUID c047b063, status: "queued" awaiting leaderboard acceptance; exceeds current 70.67% published leaderboard entry in independent 600/600 evaluation) | 90.67% (544/600, self-run clean-room evaluation; highest Riley slice 181/200 = 90.50%, published SHA-256 audit logs) | +1.50 pp (+9 tasks: +28W / -19L) over Grounded v0.2 (statistically tied w/ Std., exact McNemar $p = 0.766$ NS) · Morgan 94.5% (189), Alex 87.0% (174), Riley 90.5% (181, first-ever 90%+ on Riley) · 192/600 (32.0%) zero-turn live-state delta hydrations, 80/600 deep 4–8 memory-search tasks, 7,994 passive duplicates suppressed · +21 unique wins vs. Std. (Argon Low Oracle@2 = 94.67% [568/600], Argon Low Oracle@3 = 95.83% [575/600], Argon Oracle@4 = 96.83% [581/600]) | 665fb7ad5a042eeb943f15a875b3be1a06f7d1aa26e21842a69fb597d1939ba7 |
krush420/gemma4-31b-sre-lora (Wave-6 QLoRA+DPO, MID_MODEL, Thinking ON, $0.00) | 54.83% (329/600 Wave-5) / 54.17% (325/600 Stock, uploaded & queued UUID 288671ad) | 57.33% (344/600, highest open-weights score in self-run 28-run evaluation) | +3.17 pp (+19 tasks) over 54.17% Stock (+0.67 pp / +4 tasks over 56.67% Stock + Grounded) · Morgan 74.5% (149), Alex 51.5% (103), Riley 46.0% (92) · 50.81s median · Beats all 8 non-Luna cloud stacks up to $1,830.57 (Grounded Oracle@2 = 65.33% [392/600], Gemma 4 Oracle@6 = 71.83% [431/600, +1.16 pp > published 70.67% Mem0 entry]) | b7a26ef96ae99a93042ba2270ed5cae4094850f4cb789c782143e145a2eb069e |
Google Gemma 4 31B Dense Stock (MID_MODEL, Thinking ON, $0.00) | 54.17% (325/600, uploaded & queued UUID 288671ad) | 56.67% (340/600, clean-room stock + Grounded) | +2.50 pp (+15 net tasks) · Lifts every persona (Morgan 73.0% [146], Alex 48.5% [97], Riley 48.5% [97, +5.50 pp]) · 15 spin loops blocked, 4 policy-floor blocks, 1 output defect healed, 1,228 Turn-0 duplicates suppressed · 42.47s median (Oracle@2 = 61.33% [368/600]) | eab600888c276d58490135544e1ecd4ed2c68b63a4504baf1556437f9e62f296 |
krush420/qwen3-coder-30b-sre-lora (Wave-4 QLoRA+DPO, 3.3B/30.5B MoE, $0.00) | 42.67% (256/600 Wave-4) / 42.00% (252/600 Stock) | 43.00% (258/600, highest Qwen/MoE in 28-run self-run evaluation) | +1.00 pp (+6 tasks) over 42.00% Stock · +7.00 pp on Morgan (111 -> 125 [62.5%]) (Alex 31.5% [63], Riley 35.0% [70]) · 42.91s median · +70 complementary passes (Wave-4 Oracle@3 = 58.50% [351/600], 30B Oracle@5 = 61.17% [367/600]); Wave-6 gap-search MoE capacity control = 38.50% (231/600, f00271bb...) | efc93d0234807c1f63d9776787a08a0e3cff21a727039ebb4b64da3f4c006c64 |
OpenAI GPT 5.6 Luna (FRONTIER_REASONING, High, $1.35) | 81.33% (488/600) | 81.50% (489/600, model-matched Luna Pareto vertex) | 30.03s median latency (1.57x faster than 47.02s Standard, 71.1x cheaper than published Mem0 70.67% @ $96.21) · +4.50 pp on Riley (149 -> 158) over unconditional 2PC stop-nudging · 5,318 Turn-0 duplicates suppressed, 1 spin loop blocked, 0 self-doubt nudges (Oracle@2 = 89.33% [536/600], Luna Oracle@5 = 91.83% [551/600]) | 477047fc4852137f3432eaf9a82aa40c659ba2ae4a6269d28ea2b419df17e408 |
Google Gemini 4 Argon (FRONTIER_REASONING, Low, v0.2 Control, $24.54 / $23.92) | 91.17% (547/600, queued UUID c047b063) | 89.17% (535/600) | -2.5% lower cost ($23.92 vs. $24.54, exact McNemar $p = 0.104$ NS) · +17 new tail-recall wins (v0.2 Oracle@2 = 94.00% [564/600]) · 8,092 Turn-0 duplicates suppressed, 0 self-doubt nudges | 5ce8a7f8ac513d706e874f58014fee1e5e7b18bbd520df8a0d7445c1565a798d |
- Ensemble Sufficiency Oracles &
4/4Open-Weights Adapter Lifts (28Runs /16,800Traces Across6Families:8Uploaded & Queued ondolphinbench.ai+20Clean-Room Controls =28/28Validated): Over byte-identical0o444frozen$0.00SovereignMemoryStoreSQLite checkpoints,Oracle@28 = 98.33%(590/600:Morgan 196,Alex 199,Riley 195),Argon Oracle@4 = 96.83%(581/600),$0.00Open-WeightsOracle@17 = 83.17%(499/600,+12.50 pp> published70.67%Mem0entry), andGemma 4 Oracle@6 = 71.83%(431/600,+1.16 pp> published70.67%Mem0entry at$0.00), with4/4DolphinBench lifts acrosskrush420/gemma4-31b-sre-lora(57.33%[344/600] @$0.00, highest open-weights score in self-run 28-run evaluation;54.17%[325/600] stock submissionUUID 288671aduploaded & queued ondolphinbench.ai),krush420/qwen3-coder-30b-sre-lora(43.00%Wave-4 + Grounded /42.67%Wave-4 Std.),krush420/gpt-oss-120b-sre-lora(39.50%), andkrush420/llama3-hermes3-8b-sre-lora(18.33%,15.7xlift). - Cross-Suite Public Ledger & 3-Category Verification Taxonomy: Evaluated across 335,000+ traces and 14 external benchmark suites, with published SHA-256 audit logs and reproducible evaluation artifacts, separating (1) Maintainer-Reviewed & Merged Upstream (
github-actions[bot]CI-Verified) includingRouteWorks/RouterArenaPR #169 (merged by@yl231intomain @ 844e93b;0.7263CI score across8,400/8,400live receipts, leaderboard table row queued for next batch ranking refresh), (2) Uploaded & Queueddolphinbench.aiSubmissions (status: "queued"awaiting leaderboard acceptance, led by91.17%[547/600@$24.54,UUID c047b063] and54.17%[325/600@$0.00,UUID 288671ad]), and (3) Independently Reproducible Clean-Room Evaluations (95/95SHA-256 clean-room gates,49SHA-256-pinned Hugging Face audit logs across64files /40dolphinbench_600rows inkrush420/sovereign-g4-benchmarks, including90.67%[544/600@$30.54,Argon Low + Grounded v0.3, highestRileyslice181/200 = 90.50%],adyen/DABstep90.0%, & Official SnapLoCoMo90.26%acc /95.77%dia_idrecall @$0.00ingest), powered by@krusch/toolkitv1.8.1&krusch_toolkitv1.6.0(40runtime Lego bricks,65+.d.tssubpaths,179/179Node &201/201pytesttests,7blueprints,16<1msSlop-Breaker detectors,104/104[100%] zero-boilerplate compliance).
2. Adyen DABstep Multi-Step Data Analytics (120 Episodes Across 4 Models, 0 LLM Judges, 42/42 Upstream scorer.py Parity)
gemini-4-argon(medium): Reaches90.0%(9/10:100%Easy,85.7%Hard) @$0.81(5.1turns) and delivers-74.5%lower cost with a2.54xwall-clock speedup (75.5svs.191.5sungrounded) by flagging CSV"NA"string literals (keep_default_na=False) and JSONnull/[]wildcards at Turn 0.- Open-Weights (
$0.00Inference): Liftsgemma4:31bfrom20.0%$\rightarrow$40.0%(+20.0 pp) andqwen3-coder-30b-moefrom20.0%$\rightarrow$30.0%(+10.0 pp,6.8 -> 2.4steps,-44.4%prompt tokens) with0LLM ingestion calls.
🛠️ Tech Stack & Package Exports
- Runtime: Node.js
>= 22.0.0(ESM, nativenode:sqliteWAL via@krusch/toolkit/sqlite, zero native C++ build steps required). - Bricks Used:
@krusch/toolkit/http,@krusch/toolkit/mcp,@krusch/toolkit/sqlite,@krusch/toolkit/harness-engineering,@krusch/toolkit/raw-rag,@krusch/toolkit/cli,@krusch/toolkit/config,@krusch/toolkit/log.
| Subpath Import | Core Exports |
|---|---|
krusch-grounded-harness | createGroundedHarness, compileTurnZeroGrounding, introspectWorkspaceSchemas, resolveScaleProfile, createGroundedSessionEngine, inspectOutputDefects, buildSafeGeminiToolConfig, normalizeCodeSnippetForHash, canonicalizeToolCallKey, execCommandWithPartialStdout |
krusch-grounded-harness/scale-policy | SCALE_TIERS, inferModelScaleMetadata, resolveScaleProfile, buildScaleAwareDirective |
krusch-grounded-harness/delta-tool-gate | measureToolSchemaSavings, createToolBudgetGate, createDeltaContextTracker |
krusch-grounded-harness/grounding-compiler | introspectWorkspaceSchemas, compileTurnZeroGrounding |
krusch-grounded-harness/session-engine | GROUNDED_HARNESS_SCHEMA_SQL, createGroundedSessionEngine, inspectOutputDefects, buildSafeGeminiToolConfig, normalizeCodeSnippetForHash, formatTimeoutWithPartialStdout, execCommandWithPartialStdout, classifyToolMutability, canonicalizeToolCallKey |
krusch-grounded-harness/mcp | GROUNDED_MCP_TOOLS, startGroundedMcpServer |
krusch-grounded-harness/server | buildServer |
🚀 Setup & CLI Commands
Agent-Assisted Setup
Ask your coding agent (Claude Code, Codex, Cursor, Windsurf, or Antigravity):
Read https://raw.githubusercontent.com/kruschdev/grounded-harness/main/INSTALL.md and set up grounded-harness on this machine.
# Install dependencies and run full invariant + smoke test suites (15/15 passing)
npm install
npm test
# Verify SQLite WAL engine, 7-tool 4-boolean MCP annotations, and v0.2.0 invariants
node bin/krusch-grounded-harness.js doctor
# Inspect monotonic scale profile for any model
node bin/krusch-grounded-harness.js scale --model qwen2.5-coder:7b
node bin/krusch-grounded-harness.js scale --model gemma4:31b
node bin/krusch-grounded-harness.js scale --model gemini-4-argon
# Compile Turn-0 workspace schemas & zero-LLM Raw-RAG chunks (--json supported)
node bin/krusch-grounded-harness.js ground --dir . --goal "Inspect session engine invariants" --max-tokens 3200
# Run deterministic 3-tier Grounded vs. Un-Grounded vs. Legacy-2PC benchmark
node bin/krusch-grounded-harness.js bench
# Start 7-tool stdio MCP server or HTTP :3782 Control Gateway
node bin/krusch-grounded-harness.js mcp
node bin/krusch-grounded-harness.js serve --port 3782
Docker Compose Deployment
cp .env.example .env
# Set DATA_DIR in .env to a dedicated non-OS storage volume
docker compose up -d --build
curl -s http://127.0.0.1:3782/health
🔌 Stdio MCP Server (7 Tools, INV-STACK-03 Annotated)
| Tool Name | readOnly | destructive | idempotent | openWorld | Purpose |
|---|---|---|---|---|---|
krusch_ground_workspace | true | false | true | false | Introspect CSV/TSV, JSON/JSONL, read-only SQLite DDL, code symbols, and 256/32 Raw-RAG docs (0 LLM calls), defer >12 tools via BM25, and emit prefixHash. |
krusch_resolve_scale_profile | true | false | true | false | Resolve SMALL_MODEL, MID_MODEL, or FRONTIER_REASONING policy from model & thinking hints. |
krusch_grounded_session_start | false | false | true | false | Start or reset a SQLite-tracked session seeded with seen_chunk_ids, file_digests, and schema token savings. |
krusch_grounded_intercept | false | false | false | false | Check proposed tool calls against frozen policy floor, secret-leak guard, duplicate-write guard, Turn-0 digest cache, read memoization, and BLOCK_SPIN_LOOP. |
krusch_grounded_outcome | false | false | true | false | Record tool outcome (COMMITTED/FAILED), cache read previews, preserve timeout partial_stdout, and update pending_diffs_count. |
krusch_grounded_verify_stop | false | false | false | false | Zero-turn-when-healthy stop gate enforcing staged-diff FORCE_VERIFY and inspectOutputDefects. |
krusch_grounded_summary | true | false | true | false | Return session metrics (exploratoryReads, memoizedReads, spinLoopsBlocked, outputDefectsCaught, timeoutsWithPartialStdout, turn0DuplicatesSuppressed) & event log. |
🌐 HTTP Control Gateway (:3782)
All routes return deterministic JSON envelopes { ok: boolean, tool: string, summary: string, data: object } (or { ok: false, error: { code, message } }; no auth required on loopback 127.0.0.1:3782):
| Method & Path | Status | Request Body / Query | Response data Summary |
|---|---|---|---|
GET /health & GET /doctor | 200 | None | Service status, version 0.2.0, SQLite health (db: "ok"), and tracked sessions count. |
GET /api/scale-tiers | 200 | None | { tiers: { SMALL_MODEL, MID_MODEL, FRONTIER_REASONING } }. |
POST /api/scale-profile | 200 | { model, activeParamsB?, totalParamsB?, thinkingEnabled?, reasoningEffort? } | { profile, directive }. |
POST /api/ground | 200 | { workspaceDir, goal, model?, tools?, pinnedToolNames?, deferThreshold?, maxGroundingTokens? } | { scaleProfile, prefixHash, geminiToolConfig, workspace, retrievedChunks, seenChunkIds, fileDigests, exposedTools, toolSavings, tokenStats, llmIngestionCalls: 0 }. |
POST /api/ground-and-start | 201 | Same as /api/ground + optional session_id, anchor_date, max_duplicate_writes | { session, grounding }. |
POST /api/session/start | 201 | { goal, session_id?, model?, seen_chunk_ids?, file_digests?, anchor_date? } | Created grounded_sessions state record. |
POST /api/session/evaluate-turn | 200 | { session_id, turn_response } | Truncation poisoning check ({ poisoned, safeToExecuteTools }). |
POST /api/session/intercept | 200 | { session_id, step?, tool_name, args?, mutating?, suppress_turn0_reads?, block_spin_loop? } | { event_id, decision: "ALLOW" | "MEMOIZED" | "HOLD" | "BLOCK", reason, cachedPreview?, issues }. |
POST /api/session/outcome | 200 | { session_id, event_id, ok?, result_preview?, timed_out?, partial_stdout?, pending_diffs_delta?, verification_passed? } | Updated event status and preserved timeout stdout metadata. |
POST /api/session/verify-stop | 200 | { session_id, assistant_text?, candidate_answer?, finish_reason?, expect_non_empty_answer?, pending_diffs_count?, latest_verification_passed? } | { allowStop, shouldNudge, action, reason?, correctivePrompt?, rescuedToolCalls? }. |
POST /api/session/summary / GET /api/session/summary?session_id=... | 200 | { session_id } or ?session_id=<id> | { session, metrics, events }. |
⚙️ Environment Variables (.env.example)
| Variable | Required | Default | Description |
|---|---|---|---|
PORT | Optional | 3782 | TCP port for the HTTP Control Gateway. |
SERVICE_NAME | Optional | krusch-grounded-harness | Service identifier emitted in /health, /doctor, and JSON logs. |
DATA_DIR | Optional | ./data | Host/Docker volume directory for persistent runtime state (point to a non-OS disk in production). |
DB_PATH | Optional | ./data/app.db | SQLite WAL database file path (:memory: supported for ephemeral/benchmark runs). |
LOG_DIR | Optional | ./logs | Directory for rotating structured JSON logs. |
krusch-grounded-harnessnpm install krusch-grounded-harnessRelated Servers
dev.krusch/g-krusch
Local-first Google Workspace MCP server with hybrid FTS5 Drive RAG, Docs, Calendar, and Gmail.
dev.krusch/hydrascope
Structural graph context, temporal SUPERSEDES lineage, and 4-axis ontology MCP on HydraDB.
dev.krusch/krusch-coding-harness
Two-phase commit coding harness that stages diffs, runs sandboxed tests, and applies atomically.