ddd07ae7eb
Adds the `brain_tunnel` MCP tool and auto-tunnel behaviour for `brain_write`, so concepts that appear in multiple wings become navigable from any of them. New surface in package brain: - WriteTunnel(brainDir, src, tgt) — appends a `## See also` bidirectional wikilink between two notes in different wings. Idempotent (link not duplicated on re-call) and reuses an existing See also section. - DetectTunnels(brainDir, content) — walks brain/wiki/, returns TunnelCandidates for notes whose title appears in content. Tags whole-word case-insensitive hits as Exact=true and substring-only hits as Exact=false. - AutoTunnel(brainDir, src, content) — wraps DetectTunnels: writes cross-wing exact matches, stages fuzzy matches into brain/raw/tunnel-candidates-<YYYY-MM-DD>.md for human review. MCP wiring: - `brain_tunnel` tool: explicit manual link (source, target). - `brain_write` with wing+hall now triggers AutoTunnel on the new content. Failures are logged and never abort the primary write. readTitleAndCreated also humanises the slug fallback (hyphens → spaces) so titleless notes participate in content matching. Closes hyperguild#16. Tests: idempotency, same-wing rejection, missing-note rejection, See-also reuse, exact/fuzzy detection, slug fallback, MCP tool happy path, auto-tunnel hook (cross-wing exact → linked; same-wing → skipped; fuzzy → candidates file).
335 lines
11 KiB
Go
335 lines
11 KiB
Go
package mcp_test
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/json"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"os"
|
|
"path/filepath"
|
|
"testing"
|
|
|
|
"github.com/mathiasbq/hyperguild/ingestion/internal/mcp"
|
|
"github.com/stretchr/testify/assert"
|
|
"github.com/stretchr/testify/require"
|
|
)
|
|
|
|
func toolCall(t *testing.T, srv http.Handler, name string, args map[string]any) map[string]any {
|
|
t.Helper()
|
|
bodyBytes, err := json.Marshal(map[string]any{
|
|
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
|
|
"params": map[string]any{"name": name, "arguments": args},
|
|
})
|
|
require.NoError(t, err)
|
|
req := httptest.NewRequest(http.MethodPost, "/mcp", bytes.NewReader(bodyBytes))
|
|
rr := httptest.NewRecorder()
|
|
srv.ServeHTTP(rr, req)
|
|
require.Equal(t, http.StatusOK, rr.Code)
|
|
var resp map[string]any
|
|
require.NoError(t, json.Unmarshal(rr.Body.Bytes(), &resp))
|
|
return resp
|
|
}
|
|
|
|
func TestBrainQueryReturnsResults(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
knowledge := filepath.Join(brainDir, "knowledge")
|
|
require.NoError(t, os.MkdirAll(knowledge, 0o755))
|
|
require.NoError(t, os.WriteFile(
|
|
filepath.Join(knowledge, "tdd.md"),
|
|
[]byte("# TDD\n\nTest-driven development is iterative.\n"),
|
|
0o644,
|
|
))
|
|
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_query", map[string]any{"query": "tdd"})
|
|
|
|
require.Nil(t, resp["error"])
|
|
result := resp["result"].(map[string]any)
|
|
content := result["content"].([]any)
|
|
require.NotEmpty(t, content)
|
|
text := content[0].(map[string]any)["text"].(string)
|
|
assert.Contains(t, text, "tdd.md")
|
|
}
|
|
|
|
func TestBrainWriteCreatesFile(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "# Test\n\nbody",
|
|
"filename": "test.md",
|
|
"type": "note",
|
|
"domain": "personal",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
got, err := os.ReadFile(filepath.Join(brainDir, "knowledge", "test.md"))
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(got), "type: note")
|
|
assert.Contains(t, string(got), "domain: personal")
|
|
assert.Contains(t, string(got), "# Test")
|
|
}
|
|
|
|
func TestBrainWriteWingHallRoutesToWiki(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "# Val Vol\n\nbody",
|
|
"filename": "val-vol-r2",
|
|
"wing": "jepa-fx",
|
|
"hall": "decisions",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
got, err := os.ReadFile(filepath.Join(brainDir, "wiki", "jepa-fx", "decisions", "val-vol-r2.md"))
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(got), "wing: jepa-fx")
|
|
assert.Contains(t, string(got), "hall: decisions")
|
|
assert.Contains(t, string(got), "created_at:")
|
|
assert.Contains(t, string(got), "# Val Vol")
|
|
}
|
|
|
|
func TestBrainWriteRejectsInvalidHall(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "x",
|
|
"wing": "jepa-fx",
|
|
"hall": "garbage",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainQueryWingScope(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
for _, p := range []struct{ rel, body string }{
|
|
{"wiki/jepa-fx/facts/x.md", "---\nwing: jepa-fx\nhall: facts\n---\nfoo keyword.\n"},
|
|
{"wiki/other/facts/y.md", "---\nwing: other\nhall: facts\n---\nfoo keyword.\n"},
|
|
} {
|
|
full := filepath.Join(brainDir, p.rel)
|
|
require.NoError(t, os.MkdirAll(filepath.Dir(full), 0o755))
|
|
require.NoError(t, os.WriteFile(full, []byte(p.body), 0o644))
|
|
}
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_query", map[string]any{
|
|
"query": "foo",
|
|
"wing": "jepa-fx",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
text := resp["result"].(map[string]any)["content"].([]any)[0].(map[string]any)["text"].(string)
|
|
assert.Contains(t, text, "wiki/jepa-fx/facts/x.md")
|
|
assert.NotContains(t, text, "wiki/other/facts/y.md")
|
|
}
|
|
|
|
func TestBrainWriteAutoTunnelsOnExactMatch(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
// Seed a pre-existing note in wing "other".
|
|
existing := filepath.Join(brainDir, "wiki/other/facts/widget.md")
|
|
require.NoError(t, os.MkdirAll(filepath.Dir(existing), 0o755))
|
|
require.NoError(t, os.WriteFile(existing,
|
|
[]byte("---\nwing: other\nhall: facts\ntitle: Widget\n---\nbody.\n"), 0o644))
|
|
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
// Write a new note in a *different* wing whose content references "Widget".
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "# Notes\n\nThis note discusses the Widget concept.\n",
|
|
"filename": "notes",
|
|
"wing": "jepa-fx",
|
|
"hall": "facts",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
newNote := filepath.Join(brainDir, "wiki/jepa-fx/facts/notes.md")
|
|
got, err := os.ReadFile(newNote)
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(got), "[[other/facts/widget]]", "new note should link to existing")
|
|
|
|
gotTgt, err := os.ReadFile(existing)
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(gotTgt), "[[jepa-fx/facts/notes]]", "existing note should backlink")
|
|
}
|
|
|
|
func TestBrainWriteAutoTunnelSkipsSameWing(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
existing := filepath.Join(brainDir, "wiki/jepa-fx/facts/widget.md")
|
|
require.NoError(t, os.MkdirAll(filepath.Dir(existing), 0o755))
|
|
require.NoError(t, os.WriteFile(existing,
|
|
[]byte("---\nwing: jepa-fx\nhall: facts\ntitle: Widget\n---\nbody.\n"), 0o644))
|
|
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "Same wing reference to Widget here.\n",
|
|
"filename": "notes",
|
|
"wing": "jepa-fx",
|
|
"hall": "facts",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
newNote := filepath.Join(brainDir, "wiki/jepa-fx/facts/notes.md")
|
|
got, err := os.ReadFile(newNote)
|
|
require.NoError(t, err)
|
|
assert.NotContains(t, string(got), "[[jepa-fx/facts/widget]]", "same-wing match must not auto-tunnel")
|
|
}
|
|
|
|
func TestBrainTunnelLinksTwoNotes(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
for _, p := range []struct{ rel, body string }{
|
|
{"wiki/jepa-fx/decisions/val-vol.md", "---\nwing: jepa-fx\nhall: decisions\n---\n# Val Vol\n"},
|
|
{"wiki/hyperguild/decisions/routing.md", "---\nwing: hyperguild\nhall: decisions\n---\n# Routing\n"},
|
|
} {
|
|
full := filepath.Join(brainDir, p.rel)
|
|
require.NoError(t, os.MkdirAll(filepath.Dir(full), 0o755))
|
|
require.NoError(t, os.WriteFile(full, []byte(p.body), 0o644))
|
|
}
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_tunnel", map[string]any{
|
|
"source": "wiki/jepa-fx/decisions/val-vol.md",
|
|
"target": "wiki/hyperguild/decisions/routing.md",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
src, err := os.ReadFile(filepath.Join(brainDir, "wiki/jepa-fx/decisions/val-vol.md"))
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(src), "[[hyperguild/decisions/routing]]")
|
|
tgt, err := os.ReadFile(filepath.Join(brainDir, "wiki/hyperguild/decisions/routing.md"))
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(tgt), "[[jepa-fx/decisions/val-vol]]")
|
|
}
|
|
|
|
func TestBrainTunnelRejectsMissing(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
resp := toolCall(t, srv, "brain_tunnel", map[string]any{
|
|
"source": "wiki/a/facts/ghost.md",
|
|
"target": "wiki/b/facts/ghost.md",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainWriteRejectsTraversal(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "x",
|
|
"filename": "../escape.md",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainWriteAcceptsDoubleDotInName(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_write", map[string]any{
|
|
"content": "x",
|
|
"filename": "notes..draft.md",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
_, err := os.Stat(filepath.Join(brainDir, "knowledge", "notes..draft.md"))
|
|
require.NoError(t, err, "filename with embedded .. should be allowed")
|
|
}
|
|
|
|
func TestBrainIngestRawDryRun(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
require.NoError(t, os.MkdirAll(filepath.Join(brainDir, "wiki", "concepts"), 0o755))
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_ingest_raw", map[string]any{
|
|
"source": "test-source",
|
|
"dry_run": true,
|
|
"pages": []map[string]any{
|
|
{
|
|
"title": "Test Concept",
|
|
"type": "concept",
|
|
"content": "## Definition\nA test concept.",
|
|
},
|
|
},
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
result := resp["result"].(map[string]any)
|
|
content := result["content"].([]any)
|
|
text := content[0].(map[string]any)["text"].(string)
|
|
|
|
var parsed struct {
|
|
Pages []string `json:"pages"`
|
|
}
|
|
require.NoError(t, json.Unmarshal([]byte(text), &parsed))
|
|
require.NotEmpty(t, parsed.Pages, "expected at least one page path")
|
|
assert.Contains(t, parsed.Pages[0], "wiki/concepts/test-concept.md")
|
|
|
|
// dry_run: no file should exist
|
|
_, err := os.Stat(filepath.Join(brainDir, "wiki", "concepts", "test-concept.md"))
|
|
assert.True(t, os.IsNotExist(err))
|
|
}
|
|
|
|
func TestBrainIngestRejectsBoth(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_ingest", map[string]any{
|
|
"content": "x",
|
|
"source": "y",
|
|
"path": "/tmp/foo.md",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainIngestRequiresOne(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_ingest", map[string]any{})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainIngestRejectsContentWithoutSource(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "brain_ingest", map[string]any{
|
|
"content": "x",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
}
|
|
|
|
func TestBrainIngestRequiresLLMConfigured(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil) // nil pipelineCfg → no LLM
|
|
|
|
resp := toolCall(t, srv, "brain_ingest", map[string]any{
|
|
"content": "some content",
|
|
"source": "test",
|
|
})
|
|
require.NotNil(t, resp["error"])
|
|
errObj := resp["error"].(map[string]any)
|
|
assert.Contains(t, errObj["message"].(string), "LLM not configured")
|
|
}
|
|
|
|
func TestSessionLogAppends(t *testing.T) {
|
|
brainDir := t.TempDir()
|
|
srv := mcp.NewServer(brainDir, nil, nil, nil)
|
|
|
|
resp := toolCall(t, srv, "session_log", map[string]any{
|
|
"session_id": "session-x",
|
|
"skill": "tdd",
|
|
"phase": "red",
|
|
"final_status": "ok",
|
|
})
|
|
require.Nil(t, resp["error"])
|
|
|
|
got, err := os.ReadFile(filepath.Join(brainDir, "sessions", "session-x.jsonl"))
|
|
require.NoError(t, err)
|
|
assert.Contains(t, string(got), `"skill":"tdd"`)
|
|
assert.Contains(t, string(got), `"phase":"red"`)
|
|
}
|
|
|
|
func TestSessionLogRequiresSessionID(t *testing.T) {
|
|
srv := mcp.NewServer(t.TempDir(), nil, nil, nil)
|
|
resp := toolCall(t, srv, "session_log", map[string]any{"skill": "tdd"})
|
|
require.NotNil(t, resp["error"])
|
|
}
|