codex-dev-mcp-suite 1.0.0 → 1.2.0

package/_testkit/harness.mjs

@@ -1,126 +0,0 @@
-/**
- * Minimal MCP stdio test harness — zero external deps.
- * Provides: McpClient (spawn server, initialize, callTool), and a tiny
- * assert/test runner (describe/it/run) with colored-ish plain output.
- */
-import { spawn } from "child_process";
-
-export class McpClient {
-  constructor(serverPath, env = {}) {
-    this.serverPath = serverPath;
-    this.env = { ...process.env, ...env };
-    this.proc = null;
-    this.buf = "";
-    this.pending = new Map();
-    this.nextId = 1;
-  }
-
-  async start() {
-    this.proc = spawn("node", [this.serverPath], { env: this.env, stdio: ["pipe", "pipe", "ignore"] });
-    this.proc.stdout.on("data", (d) => this._onData(d.toString()));
-    await this._rpc("initialize", {
-      protocolVersion: "2024-11-05",
-      capabilities: {},
-      clientInfo: { name: "testkit", version: "1.0.0" },
-    });
-    this._notify("notifications/initialized");
-    await new Promise((r) => setTimeout(r, 50));
-  }
-
-  _onData(chunk) {
-    this.buf += chunk;
-    let idx;
-    while ((idx = this.buf.indexOf("\n")) !== -1) {
-      const line = this.buf.slice(0, idx).trim();
-      this.buf = this.buf.slice(idx + 1);
-      if (!line) continue;
-      let msg;
-      try { msg = JSON.parse(line); } catch { continue; }
-      if (msg.id != null && this.pending.has(msg.id)) {
-        const { resolve } = this.pending.get(msg.id);
-        this.pending.delete(msg.id);
-        resolve(msg);
-      }
-    }
-  }
-
-  _send(obj) { this.proc.stdin.write(JSON.stringify(obj) + "\n"); }
-  _notify(method, params) { this._send({ jsonrpc: "2.0", method, params }); }
-
-  _rpc(method, params, timeoutMs = 30000) {
-    const id = this.nextId++;
-    return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error(`RPC timeout: ${method}`));
-      }, timeoutMs);
-      this.pending.set(id, { resolve: (m) => { clearTimeout(timer); resolve(m); } });
-      this._send({ jsonrpc: "2.0", id, method, params });
-    });
-  }
-
-  async listTools() {
-    const res = await this._rpc("tools/list", {});
-    return (res.result?.tools || []).map((t) => t.name);
-  }
-
-  async callTool(name, args = {}, timeoutMs = 30000) {
-    const res = await this._rpc("tools/call", { name, arguments: args }, timeoutMs);
-    if (res.error) throw new Error(`RPC error: ${res.error.message}`);
-    const text = res.result?.content?.[0]?.text ?? "";
-    return { text, isError: Boolean(res.result?.isError), raw: res.result };
-  }
-
-  async stop() {
-    try { this.proc?.kill(); } catch { /* ignore */ }
-  }
-}
-
-// ---- tiny test runner ----
-const tests = [];
-let currentSuite = "";
-export function describe(name, fn) { currentSuite = name; fn(); currentSuite = ""; }
-export function it(name, fn) { tests.push({ suite: currentSuite, name, fn }); }
-
-export function assert(cond, msg) {
-  if (!cond) throw new Error("assertion failed: " + (msg || ""));
-}
-export function assertIncludes(haystack, needle, msg) {
-  if (!String(haystack).includes(needle)) {
-    throw new Error(`expected to include "${needle}"${msg ? " — " + msg : ""}\n  got: ${String(haystack).slice(0, 300)}`);
-  }
-}
-export function assertEqual(a, b, msg) {
-  if (a !== b) throw new Error(`expected ${JSON.stringify(b)}, got ${JSON.stringify(a)}${msg ? " — " + msg : ""}`);
-}
-
-export async function run() {
-  let pass = 0, fail = 0;
-  const failures = [];
-  for (const t of tests) {
-    const label = t.suite ? `${t.suite} › ${t.name}` : t.name;
-    try {
-      await t.fn();
-      pass++;
-      console.log(`  ✓ ${label}`);
-    } catch (e) {
-      fail++;
-      failures.push({ label, err: e });
-      console.log(`  ✗ ${label}`);
-      console.log(`      ${e.message.split("\n").join("\n      ")}`);
-    }
-  }
-  console.log(`\n${pass} passed, ${fail} failed (${tests.length} total)`);
-  if (fail > 0) process.exitCode = 1;
-  return { pass, fail, failures };
-}
-
-// unique temp dir helper
-import os from "os";
-import path from "path";
-import fs from "fs";
-export function tmpDir(prefix = "mcp-test-") {
-  const d = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-  return d;
-}
-export function rmrf(p) { try { fs.rmSync(p, { recursive: true, force: true }); } catch { /* ignore */ } }

package/checkpoint/test.mjs

@@ -1,73 +0,0 @@
-import { McpClient, describe, it, assert, assertIncludes, run, tmpDir, rmrf } from "../_testkit/harness.mjs";
-import path from "path";
-import fs from "fs";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVER = path.join(__dirname, "server.js");
-const STORE = tmpDir("cp-store-");
-const PROJ = tmpDir("cp-proj-");
-
-// seed project files
-fs.mkdirSync(path.join(PROJ, "src"), { recursive: true });
-fs.writeFileSync(path.join(PROJ, "src", "a.txt"), "original A\n");
-fs.writeFileSync(path.join(PROJ, "README.md"), "# Title\n");
-
-const client = new McpClient(SERVER, { CHECKPOINT_DIR: STORE });
-let cpId = "";
-
-describe("checkpoint", () => {
-  it("lists expected tools", async () => {
-    const tools = await client.listTools();
-    for (const t of ["checkpoint_create", "checkpoint_list", "checkpoint_restore", "checkpoint_diff", "checkpoint_delete"])
-      assert(tools.includes(t), `missing ${t}`);
-  });
-
-  it("creates a checkpoint", async () => {
-    const r = await client.callTool("checkpoint_create", { dir: PROJ, label: "baseline" });
-    assertIncludes(r.text, "Checkpoint");
-    assertIncludes(r.text, "Files stored: 2");
-    cpId = (r.text.match(/Checkpoint (\S+) created/) || [])[1] || "";
-    assert(cpId, "could not parse checkpoint id");
-  });
-
-  it("diff detects add/modify/delete", async () => {
-    fs.writeFileSync(path.join(PROJ, "src", "a.txt"), "CHANGED A\n");
-    fs.writeFileSync(path.join(PROJ, "src", "new.txt"), "brand new\n");
-    fs.rmSync(path.join(PROJ, "README.md"));
-    const r = await client.callTool("checkpoint_diff", { dir: PROJ, id: cpId });
-    assertIncludes(r.text, "Added (1)");
-    assertIncludes(r.text, "src/new.txt");
-    assertIncludes(r.text, "Modified (1)");
-    assertIncludes(r.text, "src/a.txt");
-    assertIncludes(r.text, "Deleted (1)");
-    assertIncludes(r.text, "README.md");
-  });
-
-  it("restores with clean (revert + remove new)", async () => {
-    const r = await client.callTool("checkpoint_restore", { dir: PROJ, id: cpId, clean: true });
-    assertIncludes(r.text, "Restored 2 files");
-    assert(fs.readFileSync(path.join(PROJ, "src", "a.txt"), "utf8").includes("original A"), "a.txt not reverted");
-    assert(fs.existsSync(path.join(PROJ, "README.md")), "README not restored");
-    assert(!fs.existsSync(path.join(PROJ, "src", "new.txt")), "new.txt not removed");
-  });
-
-  it("errors on unknown id", async () => {
-    const r = await client.callTool("checkpoint_diff", { dir: PROJ, id: "nope-123" });
-    assert(r.isError, "expected error flag");
-    assertIncludes(r.text, "not found");
-  });
-
-  it("deletes the checkpoint", async () => {
-    const r = await client.callTool("checkpoint_delete", { dir: PROJ, id: cpId });
-    assertIncludes(r.text, "Deleted checkpoint");
-    const r2 = await client.callTool("checkpoint_list", { dir: PROJ });
-    assertIncludes(r2.text, "No checkpoints");
-  });
-});
-
-await client.start();
-const { fail } = await run();
-await client.stop();
-rmrf(STORE); rmrf(PROJ);
-process.exit(fail > 0 ? 1 : 0);

package/context-pack/test.mjs

@@ -1,66 +0,0 @@
-import { McpClient, describe, it, assert, assertIncludes, run, tmpDir, rmrf } from "../_testkit/harness.mjs";
-import path from "path";
-import fs from "fs";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVER = path.join(__dirname, "server.js");
-const PROJ = tmpDir("ctx-proj-");
-
-fs.mkdirSync(path.join(PROJ, "src"), { recursive: true });
-fs.writeFileSync(path.join(PROJ, "package.json"), JSON.stringify({
-  name: "sample", version: "1.0.0",
-  scripts: { dev: "vite", test: "vitest" },
-  dependencies: { react: "^18.0.0", next: "^14.0.0" },
-}, null, 2));
-fs.writeFileSync(path.join(PROJ, "README.md"), "# Sample Project\nDemo app.\n## Setup\nnpm install\n");
-fs.writeFileSync(path.join(PROJ, "src", "auth.ts"),
-  "export function login(user: string) { return true; }\nexport class AuthService { verify() {} }\nfunction helperInternal() {}\n");
-
-const client = new McpClient(SERVER, {});
-
-describe("context-pack", () => {
-  it("lists expected tools", async () => {
-    const tools = await client.listTools();
-    for (const t of ["pack_overview", "pack_tree", "pack_outline", "pack_search"])
-      assert(tools.includes(t), `missing ${t}`);
-  });
-
-  it("overview detects stack + scripts + readme", async () => {
-    const r = await client.callTool("pack_overview", { dir: PROJ });
-    assertIncludes(r.text, "Next.js");
-    assertIncludes(r.text, "React");
-    assertIncludes(r.text, "dev: vite");
-    assertIncludes(r.text, "Sample Project");
-  });
-
-  it("tree shows dirs and files", async () => {
-    const r = await client.callTool("pack_tree", { dir: PROJ, max_depth: 3 });
-    assertIncludes(r.text, "src/");
-    assertIncludes(r.text, "auth.ts");
-  });
-
-  it("outline extracts symbols", async () => {
-    const r = await client.callTool("pack_outline", { dir: PROJ, file: "src/auth.ts" });
-    assertIncludes(r.text, "login");
-    assertIncludes(r.text, "AuthService");
-    assertIncludes(r.text, "helperInternal");
-  });
-
-  it("outline errors on missing file", async () => {
-    const r = await client.callTool("pack_outline", { dir: PROJ, file: "does/not/exist.ts" });
-    assert(r.isError, "expected error");
-    assertIncludes(r.text, "File not found");
-  });
-
-  it("search matches by path substring", async () => {
-    const r = await client.callTool("pack_search", { dir: PROJ, query: "auth" });
-    assertIncludes(r.text, "src/auth.ts");
-  });
-});
-
-await client.start();
-const { fail } = await run();
-await client.stop();
-rmrf(PROJ);
-process.exit(fail > 0 ? 1 : 0);

package/devjournal/test.mjs

@@ -1,68 +0,0 @@
-import { McpClient, describe, it, assert, assertIncludes, run, tmpDir, rmrf } from "../_testkit/harness.mjs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVER = path.join(__dirname, "server.js");
-const STORE = tmpDir("jrnl-");
-const PROJ = "/tmp/jrnl-demo-project";
-
-const client = new McpClient(SERVER, { JOURNAL_DIR: STORE });
-
-describe("devjournal", () => {
-  it("lists expected tools", async () => {
-    const tools = await client.listTools();
-    for (const t of ["journal_log", "journal_handoff", "journal_resume", "journal_timeline", "journal_search", "journal_clear_handoff"])
-      assert(tools.includes(t), `missing ${t}`);
-  });
-
-  it("logs entries", async () => {
-    const r1 = await client.callTool("journal_log", { dir: PROJ, title: "Set up auth", type: "done", body: "login + AuthService" });
-    assertIncludes(r1.text, "Logged [done]");
-    const r2 = await client.callTool("journal_log", { dir: PROJ, title: "Refresh undecided", type: "blocker" });
-    assertIncludes(r2.text, "Logged [blocker]");
-  });
-
-  it("saves a handoff", async () => {
-    const r = await client.callTool("journal_handoff", {
-      dir: PROJ, summary: "Auth scaffolding done; wiring refresh next.",
-      next_steps: ["Implement refresh", "Add tests"],
-      open_questions: ["Cookie or header?"], active_files: ["src/auth.ts"],
-    });
-    assertIncludes(r.text, "Handoff saved");
-    assertIncludes(r.text, "Next steps: 2");
-  });
-
-  it("resume returns handoff + recent entries", async () => {
-    const r = await client.callTool("journal_resume", { dir: PROJ });
-    assertIncludes(r.text, "Latest handoff");
-    assertIncludes(r.text, "Implement refresh");
-    assertIncludes(r.text, "Cookie or header?");
-    assertIncludes(r.text, "Recent entries");
-  });
-
-  it("timeline filters by type", async () => {
-    const r = await client.callTool("journal_timeline", { dir: PROJ, type: "blocker" });
-    assertIncludes(r.text, "Refresh undecided");
-    assert(!r.text.includes("Set up auth"), "should not include done entries when filtering blocker");
-  });
-
-  it("search finds entries by keyword (offline mode)", async () => {
-    const r = await client.callTool("journal_search", { dir: PROJ, query: "auth login refresh" });
-    assertIncludes(r.text, "[keyword]");
-    assertIncludes(r.text, "Set up auth");
-  });
-
-  it("clears handoff", async () => {
-    const r = await client.callTool("journal_clear_handoff", { dir: PROJ });
-    assertIncludes(r.text, "Cleared handoff");
-    const r2 = await client.callTool("journal_resume", { dir: PROJ });
-    assert(!r2.text.includes("Latest handoff"), "handoff should be gone");
-  });
-});
-
-await client.start();
-const { fail } = await run();
-await client.stop();
-rmrf(STORE);
-process.exit(fail > 0 ? 1 : 0);

package/project-memory/test.mjs

@@ -1,72 +0,0 @@
-import { McpClient, describe, it, assert, assertIncludes, run, tmpDir, rmrf } from "../_testkit/harness.mjs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVER = path.join(__dirname, "server.js");
-const VAULT = tmpDir("pm-");
-const DEMO = "/tmp/pm-demo-project";
-
-// Force keyword mode (no embedding key) so the suite is deterministic/offline.
-const client = new McpClient(SERVER, { MEMORY_VAULT_DIR: VAULT, NINEROUTER_KEY: "", EMBED_KEY: "" });
-
-let savedId = "";
-
-describe("project-memory", () => {
-  it("lists expected tools", async () => {
-    const tools = await client.listTools();
-    for (const t of ["memory_save", "memory_recall", "memory_list", "memory_get", "memory_delete", "memory_reindex"])
-      assert(tools.includes(t), `missing ${t}`);
-  });
-
-  it("saves a note (keyword mode without embeddings)", async () => {
-    const r = await client.callTool("memory_save", {
-      dir: DEMO, title: "JWT login flow",
-      content: "login() issues JWT; refresh token in httpOnly cookie; clock skew bug on verify.",
-      tags: ["auth", "jwt"], kind: "decision",
-    });
-    assertIncludes(r.text, "Saved note");
-    assertIncludes(r.text, "keyword-only");
-    savedId = (r.text.match(/Saved note (\S+)/) || [])[1] || "";
-    assert(savedId, "could not parse note id");
-  });
-
-  it("recalls by keyword and tags mode label", async () => {
-    const r = await client.callTool("memory_recall", { dir: DEMO, query: "jwt auth cookie" });
-    assertIncludes(r.text, "[keyword]");
-    assertIncludes(r.text, "JWT login flow");
-  });
-
-  it("returns no-match gracefully", async () => {
-    const r = await client.callTool("memory_recall", { dir: DEMO, query: "kubernetes helm chart xyzzy" });
-    assertIncludes(r.text, "No relevant memories");
-  });
-
-  it("lists saved notes", async () => {
-    const r = await client.callTool("memory_list", { dir: DEMO });
-    assertIncludes(r.text, "JWT login flow");
-  });
-
-  it("gets full note by id", async () => {
-    const r = await client.callTool("memory_get", { dir: DEMO, id: savedId });
-    assertIncludes(r.text, "httpOnly cookie");
-  });
-
-  it("reindex reports gracefully without embeddings", async () => {
-    const r = await client.callTool("memory_reindex", { dir: DEMO });
-    assertIncludes(r.text, "failed");
-  });
-
-  it("deletes a note", async () => {
-    const r = await client.callTool("memory_delete", { dir: DEMO, id: savedId });
-    assertIncludes(r.text, "Deleted note");
-    const r2 = await client.callTool("memory_list", { dir: DEMO });
-    assertIncludes(r2.text, "No memories");
-  });
-});
-
-await client.start();
-const { fail } = await run();
-await client.stop();
-rmrf(VAULT);
-process.exit(fail > 0 ? 1 : 0);

package/project-memory/test.rerank.mjs

@@ -1,53 +0,0 @@
-// Optional online test: LLM rerank via 9router Kiro. Skips cleanly if offline.
-import { McpClient, describe, it, assert, assertIncludes, run, tmpDir, rmrf } from "../_testkit/harness.mjs";
-import path from "path";
-import http from "http";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVER = path.join(__dirname, "server.js");
-const KEY = process.env.LLM_API_KEY || process.env.RERANK_KEY || process.env.NINEROUTER_KEY || "";
-const URL_BASE = "http://localhost:20128";
-
-function ping() {
-  return new Promise((resolve) => {
-    const req = http.request(URL_BASE + "/v1/models", { method: "GET", timeout: 4000, headers: { Authorization: `Bearer ${KEY}` } }, (r) => { r.resume(); resolve(r.statusCode === 200); });
-    req.on("error", () => resolve(false));
-    req.on("timeout", () => { req.destroy(); resolve(false); });
-    req.end();
-  });
-}
-
-if (!KEY) { console.log("  ⚠ rerank test skipped (no LLM_API_KEY in env)"); process.exit(0); }
-const online = await ping();
-if (!online) {
-  console.log("  ⚠ rerank test skipped (9router not reachable)");
-  process.exit(0);
-}
-
-const VAULT = tmpDir("pm-rr-");
-const DEMO = "/tmp/pm-rr-demo";
-const env = { MEMORY_VAULT_DIR: VAULT, LLM_BASE_URL: URL_BASE, LLM_API_KEY: KEY, EMBED_KEY: "", RERANK_MODEL: "kr/claude-haiku-4.5", RERANK_TIMEOUT_MS: "40000" };
-const client = new McpClient(SERVER, env);
-
-describe("project-memory (rerank/online)", () => {
-  it("seeds distinct notes", async () => {
-    await client.callTool("memory_save", { dir: DEMO, title: "JWT auth flow", content: "login issues JWT; refresh token stored in httpOnly cookie", tags: ["auth"] });
-    await client.callTool("memory_save", { dir: DEMO, title: "Dark mode toggle", content: "CSS variables and localStorage for theme switching", tags: ["ui"] });
-    await client.callTool("memory_save", { dir: DEMO, title: "Nginx docker setup", content: "Dockerfile and compose for nginx reverse proxy", tags: ["infra"] });
-    const r = await client.callTool("memory_list", { dir: DEMO });
-    assertIncludes(r.text, "(3)");
-  });
-
-  it("reranks a semantic query to the auth note (no keyword overlap)", async () => {
-    const r = await client.callTool("memory_recall", { dir: DEMO, query: "how do users sign in securely with tokens", limit: 1 }, 60000);
-    assertIncludes(r.text, "[rerank]");
-    assertIncludes(r.text, "JWT auth flow");
-  });
-});
-
-await client.start();
-const { fail } = await run();
-await client.stop();
-rmrf(VAULT);
-process.exit(fail > 0 ? 1 : 0);

package/run-tests.mjs

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/**
- * Runs every server's test.mjs and prints a combined summary.
- * Usage: node run-tests.mjs   (from ~/.codex/mcp-servers)
- */
-import { spawn } from "child_process";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SERVERS = ["project-memory", "checkpoint", "context-pack", "devjournal"];
-
-function runOne(name) {
-  return new Promise((resolve) => {
-    const test = path.join(__dirname, name, "test.mjs");
-    const proc = spawn("node", [test], { stdio: ["ignore", "pipe", "pipe"] });
-    let out = "";
-    proc.stdout.on("data", (d) => (out += d));
-    proc.stderr.on("data", (d) => (out += d));
-    proc.on("close", (code) => resolve({ name, code, out }));
-  });
-}
-
-const results = [];
-for (const s of SERVERS) {
-  console.log(`\n=== ${s} ===`);
-  const r = await runOne(s);
-  process.stdout.write(r.out);
-  results.push(r);
-}
-
-console.log("\n================ SUMMARY ================");
-let anyFail = false;
-for (const r of results) {
-  const ok = r.code === 0;
-  if (!ok) anyFail = true;
-  const m = r.out.match(/(\d+) passed, (\d+) failed/);
-  const stat = m ? `${m[1]} passed, ${m[2]} failed` : (ok ? "ok" : "FAILED");
-  console.log(`  ${ok ? "✓" : "✗"} ${r.name.padEnd(16)} ${stat}`);
-}
-console.log("========================================");
-process.exit(anyFail ? 1 : 0);