@waycraft/waypoint-mcp 0.1.0

package/dist/tools/review.js

@@ -0,0 +1,123 @@
+import { getBaseContext, getArtifact, saveArtifact } from "../context.js";
+export const definition = {
+    name: "waypoint_review",
+    description: "Final quality check before shipping or handoff. Reads all prior artifacts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspacePath: {
+                type: "string",
+                description: "Absolute path to the workspace root.",
+            },
+        },
+        required: ["workspacePath"],
+    },
+};
+const ALL_ARTIFACTS = [
+    "goal.md",
+    "research.md",
+    "compare.md",
+    "plan.md",
+    "design.md",
+    "build.md",
+    "test.md",
+    "fix.md",
+    "debug.md",
+    "audit.md",
+    "measure.md",
+    "improve.md",
+    "docs.md",
+];
+export async function run(args) {
+    const { workspacePath } = args;
+    const ctx = await getBaseContext(workspacePath);
+    const goalArtifact = await getArtifact(workspacePath, "goal.md");
+    if (!goalArtifact) {
+        return [
+            "## waypoint_review — No goal found",
+            "",
+            "Run `waypoint_goal` first — review requires a defined goal to evaluate against.",
+        ].join("\n");
+    }
+    const goalLine = goalArtifact.match(/^# Goal\n+(.+)/m)?.[1] ?? "(goal not parsed)";
+    // inventory all artifacts
+    const inventory = [];
+    for (const name of ALL_ARTIFACTS) {
+        const content = await getArtifact(workspacePath, name);
+        inventory.push({ name, present: !!content });
+    }
+    const present = inventory.filter((a) => a.present);
+    const missing = inventory.filter((a) => !a.present);
+    const inventoryRows = inventory.map((a) => `| ${a.name} | ${a.present ? "✅" : "❌"} |`);
+    const artifact = [
+        "# Review",
+        "",
+        `**Goal:** ${goalLine}`,
+        "",
+        "## Artifact inventory",
+        "| Artifact | Present |",
+        "|----------|---------|",
+        ...inventoryRows,
+        "",
+        `**${present.length} of ${ALL_ARTIFACTS.length} artifacts present.**`,
+        missing.length > 0
+            ? `Missing: ${missing.map((a) => a.name).join(", ")}`
+            : "All artifacts present.",
+        "",
+        "## Pre-ship checklist",
+        "<!-- Work through these before marking done -->",
+        "",
+        "### Goal",
+        "- [ ] Goal is clearly stated and success criteria are defined",
+        "- [ ] All success criteria are met (see measure.md)",
+        "",
+        "### Code quality",
+        "- [ ] No dead code or commented-out blocks",
+        "- [ ] No hardcoded values that should be configuration",
+        "- [ ] Error states produce safe, clear output",
+        "",
+        "### Tests",
+        "- [ ] Happy path tested",
+        "- [ ] Edge cases tested",
+        "- [ ] No known failing tests",
+        "",
+        "### Documentation",
+        "- [ ] README or docs.md reflects current state",
+        "- [ ] Breaking changes documented",
+        "",
+        "### Security",
+        "- [ ] No secrets or credentials in code or artifacts",
+        "- [ ] Input validation at system boundaries",
+        "",
+        "## Reviewer notes",
+        "<!-- Open issues, questions for the team, or follow-up items -->",
+        "- ",
+        "",
+        "## Verdict",
+        "<!-- ✅ Ready to ship | ⚠️ Ship with caveats | ❌ Not ready -->",
+        "**Verdict:** ",
+        "**Rationale:** ",
+        "",
+        `_Generated by waypoint_review — ${new Date().toISOString()}_`,
+    ].join("\n");
+    await saveArtifact(workspacePath, "review.md", artifact);
+    return [
+        "## waypoint_review — Final review generated",
+        "",
+        `**Goal:** ${goalLine}`,
+        "",
+        `### Artifact inventory: ${present.length}/${ALL_ARTIFACTS.length} present`,
+        ...inventory.map((a) => `- ${a.present ? "✅" : "❌"} ${a.name}`),
+        "",
+        "### Pre-ship checklist covers",
+        "Goal, code quality, tests, documentation, security",
+        "",
+        "### Artifact saved",
+        "`review.md` written to `.waypoint/review.md`.",
+        "Complete the checklist and record your verdict.",
+        "",
+        missing.length > 0
+            ? `### Missing artifacts\nConsider running: ${missing.map((a) => `\`waypoint_${a.name.replace(".md", "")}\``).join(", ")}`
+            : "### All artifacts present — ready for final checklist.",
+    ].join("\n");
+}

package/dist/tools/test.js

@@ -0,0 +1,107 @@
+import { getBaseContext, getArtifact, saveArtifact } from "../context.js";
+export const definition = {
+    name: "waypoint_test",
+    description: "Verify feature-level requirements. Generate test checklists and prompts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspacePath: {
+                type: "string",
+                description: "Absolute path to the workspace root.",
+            },
+            feature: {
+                type: "string",
+                description: "Specific feature or behavior to test (optional). Omit to test all built features.",
+            },
+        },
+        required: ["workspacePath"],
+    },
+};
+export async function run(args) {
+    const { workspacePath, feature } = args;
+    const ctx = await getBaseContext(workspacePath);
+    const buildArtifact = await getArtifact(workspacePath, "build.md");
+    const goalArtifact = await getArtifact(workspacePath, "goal.md");
+    if (!buildArtifact && !goalArtifact) {
+        return [
+            "## waypoint_test — No build or goal found",
+            "",
+            "Run `waypoint_build` before testing.",
+        ].join("\n");
+    }
+    const goalLine = goalArtifact?.match(/^# Goal\n+(.+)/m)?.[1] ?? "(goal not parsed)";
+    const hasBuild = !!buildArtifact;
+    const focus = feature ?? goalLine;
+    const artifact = [
+        "# Test",
+        "",
+        `**Goal:** ${goalLine}`,
+        feature ? `**Feature under test:** ${feature}` : "",
+        !hasBuild ? "\n> ⚠️ No build.md found — test coverage may be incomplete." : "",
+        "",
+        "## Feature checklist",
+        "<!-- Verify each feature works as intended from a user perspective -->",
+        `- [ ] ${focus} — happy path works end to end`,
+        "- [ ] Edge cases handled correctly",
+        "- [ ] Error states produce clear, safe output",
+        "- [ ] No regressions in adjacent functionality",
+        "",
+        "## Test prompts for AI coding tools",
+        "",
+        "### Unit test prompt",
+        "```",
+        `Write unit tests for: ${focus}`,
+        "Requirements:",
+        "- Test the happy path",
+        "- Test at least 2 edge cases",
+        "- Test error/failure paths",
+        "- No mocks unless absolutely necessary",
+        "```",
+        "",
+        "### Integration test prompt",
+        "```",
+        `Write integration tests for: ${focus}`,
+        "Requirements:",
+        "- Exercise the full stack from entry point to output",
+        "- Verify against real data or fixtures, not mocks",
+        "- Assert on observable behavior, not implementation details",
+        "```",
+        "",
+        "## Manual test cases",
+        "<!-- Scenarios that are hard to automate -->",
+        "| Scenario | Steps | Expected | Actual | Pass? |",
+        "|----------|-------|----------|--------|-------|",
+        "| Happy path | | | | |",
+        "| Empty input | | | | |",
+        "| Invalid input | | | | |",
+        "",
+        "## Known gaps",
+        "<!-- Tests not written yet and why -->",
+        "- ",
+        "",
+        `_Generated by waypoint_test — ${new Date().toISOString()}_`,
+    ]
+        .filter((l) => l !== undefined)
+        .join("\n");
+    await saveArtifact(workspacePath, "test.md", artifact);
+    return [
+        "## waypoint_test — Test plan generated",
+        "",
+        `**Goal:** ${goalLine}`,
+        feature ? `**Feature:** ${feature}` : "",
+        !hasBuild ? "\n> No build.md found — test plan may be incomplete." : "",
+        "",
+        "### Coverage areas",
+        "- **Feature checklist** — happy path, edge cases, errors, regressions",
+        "- **AI test prompts** — unit and integration test generation",
+        "- **Manual test cases** — scenarios needing human verification",
+        "",
+        "### Artifact saved",
+        "`test.md` written to `.waypoint/test.md`.",
+        "",
+        "### Suggested next step",
+        "If tests reveal bugs, run `waypoint_fix`. Otherwise run `waypoint_measure` to evaluate overall success.",
+    ]
+        .filter((l) => l !== undefined)
+        .join("\n");
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@waycraft/waypoint-mcp",
+  "version": "0.1.0",
+  "description": "A structured development protocol as an MCP server. 14 tools that guide any project from goal to ship.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "engineering",
+    "development-process",
+    "protocol",
+    "ai-native",
+    "workflow"
+  ],
+  "bin": {
+    "waypoint-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "tsx tests/goal.test.ts && tsx tests/research.test.ts && tsx tests/compare.test.ts && tsx tests/plan.test.ts && tsx tests/build.test.ts && tsx tests/test.test.ts && tsx tests/fix.test.ts && tsx tests/debug.test.ts && tsx tests/measure.test.ts && tsx tests/improve.test.ts && tsx tests/document.test.ts && tsx tests/review.test.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}