@infinitedusky/indusk-mcp 1.7.3 → 1.7.4

package/hooks/check-catchup.js

@@ -3,19 +3,23 @@
  * PreToolUse hook: blocks Edit/Write on project files until /catchup is complete.
  *
  * Reads .claude/handoff.md and checks that all Catchup Status boxes are checked.
- * Allows edits TO the handoff file itself (so catchup can check off boxes).
+ * Allows edits TO the handoff file itself — BUT if the edit is checking off
+ * "mcp-ready", the hook verifies MCP servers are actually reachable first.
  * Allows edits if no handoff file exists (first session, no enforcement).
  *
  * Exit 0 = allow
  * Exit 2 = block (stderr sent to agent)
  */
 
+import { execSync } from "node:child_process";
+import { createConnection } from "node:net";
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
 const input = JSON.parse(readFileSync("/dev/stdin", "utf-8"));
 const toolInput = input.tool_input ?? {};
 const filePath = toolInput.file_path ?? "";
+const newString = toolInput.new_string ?? "";
 
 // Find project root by looking for .claude/ directory
 function findProjectRoot() {
@@ -29,6 +33,17 @@ function findProjectRoot() {
 	return process.cwd();
 }
 
+/** TCP check: can we connect to host:port? */
+function checkTcp(host, port, timeoutMs = 3000) {
+	return new Promise((resolve) => {
+		const sock = createConnection({ host, port });
+		sock.setTimeout(timeoutMs);
+		sock.on("connect", () => { sock.end(); resolve(true); });
+		sock.on("error", () => resolve(false));
+		sock.on("timeout", () => { sock.destroy(); resolve(false); });
+	});
+}
+
 const projectRoot = findProjectRoot();
 const handoffPath = join(projectRoot, ".claude", "handoff.md");
 
@@ -37,8 +52,41 @@ if (!existsSync(handoffPath)) {
 	process.exit(0);
 }
 
-// Always allow edits to the handoff file itself (catchup needs to check boxes)
+// Edits to handoff.md — allowed, but with MCP verification gate
 if (filePath.endsWith("handoff.md")) {
+	// If the edit is checking off mcp-ready, verify MCP servers are actually up
+	if (newString.includes("[x] mcp-ready")) {
+		const errors = [];
+
+		// Check FalkorDB (indusk-infra container) on localhost:6379
+		const falkorUp = await checkTcp("localhost", 6379);
+		if (!falkorUp) {
+			errors.push("FalkorDB not reachable on localhost:6379 — is indusk-infra running? Try: docker start indusk-infra");
+		}
+
+		// Check Graphiti on localhost:8100
+		try {
+			const health = execSync("curl -sf http://localhost:8100/health", {
+				encoding: "utf-8",
+				timeout: 5000,
+				stdio: ["ignore", "pipe", "pipe"],
+			}).trim();
+			if (!health.includes("healthy")) {
+				errors.push("Graphiti responded but not healthy on localhost:8100");
+			}
+		} catch {
+			errors.push("Graphiti MCP server not reachable on localhost:8100 — may still be starting (~90s after container restart)");
+		}
+
+		if (errors.length > 0) {
+			process.stderr.write(
+				`Cannot check off mcp-ready — infrastructure verification failed:\n` +
+				errors.map((e) => `  - ${e}`).join("\n") + "\n" +
+				`Fix the issues above before proceeding with catchup.`,
+			);
+			process.exit(2);
+		}
+	}
 	process.exit(0);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@infinitedusky/indusk-mcp",
-	"version": "1.7.3",
+	"version": "1.7.4",
 	"description": "InDusk development system — skills, MCP tools, and CLI for structured AI-assisted development",
 	"type": "module",
 	"files": [

package/skills/catchup.md

@@ -5,6 +5,28 @@ description: Get caught up on the project. Reads the handoff from the last sessi
 
 You are starting a new session on this project. Before doing anything else, get caught up.
 
+## Step 0. Wait for MCP Servers (BLOCKING)
+
+Before running any catchup steps, verify that ALL required MCP servers are available. Catchup depends on these tools and **cannot proceed without them**.
+
+**Required MCP servers:**
+- **indusk** — `get_system_version` (provides lessons, health, context, plans, extensions, graph tools)
+- **codegraphcontext** — `mcp__codegraphcontext__list_indexed_repositories` (provides code graph queries)
+
+**How to check:** Call `get_system_version` and `mcp__codegraphcontext__list_indexed_repositories`. If either tool is not available or errors, wait 5 seconds and retry. Retry up to 6 times (30 seconds total).
+
+- If all servers become available: check off `- [x] mcp-ready` in the handoff, then proceed with catchup.
+- If any server is still unavailable after 30 seconds: **STOP. Do not proceed.** Tell the user exactly which MCP server(s) failed and how to fix them:
+  - indusk: "InDusk MCP server not available — check `.mcp.json` config or restart Claude Code."
+  - codegraphcontext: "CGC MCP server not available — check `.mcp.json` config or restart Claude Code."
+  - Then say: "Catchup cannot continue with missing servers. Fix the issue and run `/catchup` again."
+
+**This step is enforced by a hook.** The `check-catchup.js` hook verifies that FalkorDB (port 6379) and Graphiti (port 8100) are reachable before allowing `mcp-ready` to be checked off. The agent cannot bypass this.
+
+**Do NOT skip steps. Do NOT fall back to shell commands. Do NOT proceed with partial functionality.** A half-completed catchup is worse than no catchup — it creates the illusion that the system is ready when it isn't.
+
+**CRITICAL: Never run bare `cgc` commands via Bash.** The `cgc` CLI does not have the correct database configuration without env vars that only the MCP tools provide. Running bare `cgc` will connect to FalkorDB Lite (an embedded database) instead of the shared FalkorDB in the indusk-infra container. Always use the indusk MCP tools (`graph_ensure`, `graph_stats`, `index_project`) for all code graph operations.
+
 ## Steps (execute in order)
 
 ### 1. Read Handoff

package/skills/handoff.md

@@ -34,6 +34,7 @@ Create or overwrite `.claude/handoff.md` with:
 {Gotchas the next agent should know. "The FalkorDB graph needs reindexing." "The hooks aren't published yet — version 1.0.3 has them." "Don't touch init.ts until the extension system PR is merged."}
 
 ## Catchup Status
+- [ ] mcp-ready
 - [ ] handoff
 - [ ] lessons
 - [ ] skills