Skip to content

[v3.8.0] feat: Vane bridge (citation-backed research) + stack command #62

Description

@Delqhi

Summary

v3.7.0 lieferte Superpowers (methodology) + DOX (context) als zwei eigenständige Brücken/Protokolle. v3.8.0 ergänzt die dritte Schicht + das Konsolidierungs-Glue:

  • Vane-Bridge (internal/vane/): HTTP-Bridge zur ItzCrazyKns/Vane (MIT) Self-Hosted AI-Answering-Engine mit zitierten Quellen. Niemals vendored (Bridged-External-Contract analog GitNexus/RTK), stdlib-only, stdio MCP server mit 2 Tools (vane_research, vane_health), graceful degradation → websearch fallback wenn Instanz down.
  • Stack-Consolidation (internal/stack/): unified sin-code stack install|doctor über Superpowers + DOX + Vane; eine Datei, idempotent, mit Graceful Degradation pro Layer.

Acceptance Criteria

  • internal/vane/ Paket mit Config, Client, Search, Healthy, RegisterMCP, FormatAnswer
  • internal/vane/mcpserver.go mit Serve() (stdio JSON-RPC, 2 Tools)
  • cmd/sin-code/vane_cmd.go mit NewVaneCmd() (cobra pattern, Subcommands: setup/doctor/search/config/serve)
  • internal/stack/ Paket mit Install(), Doctor(), Format()
  • cmd/sin-code/stack_cmd.go mit NewStackCmd() (install/doctor, --skip-* flags, --json)
  • cmd/sin-code/main.go: NewVaneCmd() und NewStackCmd() registriert via AddCommand
  • internal/permission_defaults.go: vane__* → allow, vane_research → allow, vane_health → allow
  • ECOSYSTEM.md: Vane in "Bridged External Tools" Tabelle, Stack-Eintrag in v3.8.0 Sektion
  • README.md: stack-Command, vane-Command
  • AGENTS.md: Stack-Architecture-Section, neue Pakete
  • CHANGELOG.md: v3.8.0 Eintrag
  • Race-clean: go test -race -count=1 ./... grün (M7)
  • Coverage >70% in vane/ + stack/
  • n8n-CI ecosystem-sync grün (kein GitHub-Actions-Workflow für Tests, M1)
  • CoDocs: internal/vane/vane.doc.md + internal/stack/stack.doc.md
  • Tag v3.8.0 nach Merge
  • EPIC-Referenz [v3.8.0] hardening: sin config init/show/validate, README propagation, self-update e2e, race-flake hardening #59 (v3.8.0 hardening)

Mandate Compliance

  • M1 n8n-CI only, kein GitHub-Actions-Test-Workflow
  • M2 CGo-free, statisches Go-Binary, stdlib-only für vane/stack
  • M3 Verification-Gate: PoC + Oracle vor Tag
  • M4 Permission-Defaults korrekt, ecosystem-sync grün
  • M5 Module github.com/OpenSIN-Code/SIN-Code
  • M7 go test -race clean

Out of Scope

  • TypeScript-Code aus Vane-Repo kopieren (M2)
  • Bestehenden websearch-Skill entfernen (komplementär, Vane liefert Evidenz + Zitate statt roher Treffer)
  • Vane-Konfiguration hardcoden (User konfiguriert in Vane-UI oder via vane config / VANE_API_URL)

References

Closes: #62 (eigenes Issue, ersetzt durch diesen Eintrag)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions