codeweave-mcp: Skill for Claude Code

codeweave-mcp Test Harness

TestHarness in src/test-harness.ts. Write a temp .ts file and run with npx tsx <file> from the project root.

Modes

import { TestHarness } from "./src/test-harness.js";

const h = await TestHarness.setup("/absolute/path/to/project");

// All built-in tests (covers the 3 retained tools)
await h.testAll();

// Single tool
await h.test("semantic_search");

// Custom assertions
await h.run([
  {
    tool: "semantic_search",
    args: { query: "user authentication", top_k: 5 },
    label: "search: auth",
    assert: d => d?.results?.length > 0 || "no results",
  },
]);

// Manual call — returns parsed JSON
const data = await h.call("get_index_status", { workspace: "wordbox-api" });

await h.close(); // always close

Tool params & response shapes

semantic_search

Params: query (string, required), workspace?, scope?, top_k? (default 10), tags_filter? (string[]), side_effects_filter? (string[]) Response: { results, total_indexed, search_mode, warning? } Each result: { function, file, module, signature, summary, tags, score, line_start, line_end, workspace? }

reindex

Params: workspace?, files? (string[]), force? (default false) Response: { workspace?, status, mode, ast_index: { files, functions, classes }, embedded, vector_store_rows, elapsed_ms }

get_index_status

Params: workspace? Single: { status, workspace, ast_index, vector_store, call_graph, type_graph, embedding_available, docstring_coverage, languages } Multi: { status, workspaces[], embedding_available, model }

assert

Receives parsed JSON response. Return true = pass, string = fail reason.

Multi-workspace

Pass workspace as the short name (not full path): { workspace: "wordbox-api" }

Notes

• setup() loads from cache — fast after first run.
• testAll() includes a force-full reindex at the end — slow on large projects.