@davesheffer/hunch 0.9.0 → 0.10.0

package/README.md

@@ -124,6 +124,7 @@ they all consult the same memory:
 | Cursor | `.cursor/mcp.json` | `.cursor/rules/hunch.mdc` (always-applied) |
 | VS Code (Copilot) | `.vscode/mcp.json` | `.github/copilot-instructions.md` |
 | Codex CLI | `.codex/config.toml` | `AGENTS.md` |
+| Windsurf | `.windsurf/mcp_config.json` | `.windsurf/rules/hunch.md` (always-on) |
 | Anything else | — | `AGENTS.md` (cross-tool standard) |
 
 Each writer **merges** into existing files (other MCP servers and your own prose are
@@ -133,7 +134,7 @@ preserved) and is idempotent. Opt out with `hunch init --no-providers`.
 
 | Command | What |
 |---|---|
-| `hunch init` | scaffold `.hunch/`, index, install hook + merge driver, auto-install the advisory pre-commit guard, install the **Claude Code agent hooks**, and wire up **every assistant** (Claude Code, Cursor, VS Code/Copilot, Codex, AGENTS.md). Flags: `--no-enforce`, `--enforce-strict`, `--no-providers`, `--no-agent-hooks`, `--firmness <level>` |
+| `hunch init` | scaffold `.hunch/`, index, install hook + merge driver, auto-install the advisory pre-commit guard, install the **Claude Code agent hooks**, and wire up **every assistant** (Claude Code, Cursor, VS Code/Copilot, Codex, Windsurf, AGENTS.md). Flags: `--no-enforce`, `--enforce-strict`, `--no-providers`, `--no-agent-hooks`, `--firmness <level>` |
 | `hunch index` | parse repo → symbols / edges / components (deterministic, no LLM) |
 | `hunch backfill --since 90d` | replay git history → seed decisions |
 | `hunch sync [sha]` | turn a commit into a Decision (run automatically by the hook) |

package/dist/integrations/providers.js

@@ -11,6 +11,7 @@
  *   Cursor      | .cursor/mcp.json        | mcpServers     | .cursor/rules/hunch.mdc
  *   VS Code     | .vscode/mcp.json        | servers (+type)| .github/copilot-instructions.md
  *   Codex CLI   | .codex/config.toml      | [mcp_servers.*]| AGENTS.md
+ *   Windsurf    | .windsurf/mcp_config.json| mcpServers    | .windsurf/rules/hunch.md
  *   (any other) | —                       | —              | AGENTS.md (cross-tool standard)
  *
  * Every writer MERGES into existing files (preserving other servers / user prose)
@@ -206,6 +207,25 @@ export function writeCursorRule(root, store) {
     writeFileSync(file, body);
     return file;
 }
+/** Windsurf (Cascade): .windsurf/mcp_config.json — same `mcpServers` shape as
+ *  Cursor. Repo-local (committed, shared via git) to match Hunch's other configs,
+ *  rather than the global ~/.codeium/windsurf path. Merges; refuses to clobber. */
+export function writeWindsurfMcp(root, inv) {
+    const file = join(root, ".windsurf", "mcp_config.json");
+    const json = readJsonObj(file);
+    json.mcpServers = json.mcpServers ?? {};
+    json.mcpServers.hunch = { command: inv.command, args: [...inv.args, "mcp"] };
+    return writeJson(file, json);
+}
+/** Windsurf project rule (.windsurf/rules/hunch.md). `trigger: always_on` keeps the
+ *  Hunch grounding in Cascade's context for every request. Fully managed (overwritten). */
+export function writeWindsurfRule(root, store) {
+    const file = join(root, ".windsurf", "rules", "hunch.md");
+    const body = `---\ntrigger: always_on\ndescription: Hunch engineering memory — consult the hunch_* MCP tools before editing\n---\n\n${renderHunchSection(store)}\n`;
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, body);
+    return file;
+}
 /** Scaffold MCP config + grounding for all supported assistants. Returns a
  *  per-assistant summary for `hunch init` to print. Each assistant is isolated:
  *  a writer that refuses to clobber a malformed file degrades to a warning rather
@@ -215,6 +235,7 @@ export function scaffoldProviders(root, inv, store) {
         ["Cursor", () => [writeCursorMcp(root, inv), writeCursorRule(root, store)]],
         ["VS Code (Copilot)", () => [writeVscodeMcp(root, inv), writeCopilotInstructions(root, store)]],
         ["Codex CLI", () => [writeCodexConfig(root, inv)]],
+        ["Windsurf", () => [writeWindsurfMcp(root, inv), writeWindsurfRule(root, store)]],
         ["Any (AGENTS.md)", () => [writeAgentsMd(root, store)]],
     ];
     return tasks.map(([assistant, run]) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",
   "description": "Hunch — an Engineering Memory OS: a persistent, git-native reasoning graph over a codebase, exposed to Claude Code via MCP.",