@waycraft/waypoint-mcp 0.1.0 → 0.1.2

package/dist/tools/measure.js

@@ -1,101 +0,0 @@
-import { getBaseContext, getArtifact, saveArtifact } from "../context.js";
-export const definition = {
-    name: "waypoint_measure",
-    description: "Evaluate overall project success against defined goals.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            workspacePath: {
-                type: "string",
-                description: "Absolute path to the workspace root.",
-            },
-        },
-        required: ["workspacePath"],
-    },
-};
-export async function run(args) {
-    const { workspacePath } = args;
-    const ctx = await getBaseContext(workspacePath);
-    const goalArtifact = await getArtifact(workspacePath, "goal.md");
-    const buildArtifact = await getArtifact(workspacePath, "build.md");
-    const testArtifact = await getArtifact(workspacePath, "test.md");
-    if (!goalArtifact) {
-        return [
-            "## waypoint_measure — No goal found",
-            "",
-            "Run `waypoint_goal` first — measurement requires a defined goal to evaluate against.",
-        ].join("\n");
-    }
-    const goalLine = goalArtifact.match(/^# Goal\n+(.+)/m)?.[1] ?? "(goal not parsed)";
-    const successCriteriaBlock = goalArtifact.match(/## Success criteria\n([\s\S]*?)(?=\n##|$)/)?.[1]?.trim() ?? "";
-    const criteriaLines = successCriteriaBlock
-        .split("\n")
-        .filter((l) => l.trim().startsWith("- ["))
-        .map((l) => l.trim());
-    const criteriaRows = criteriaLines.length > 0
-        ? criteriaLines.map((c) => `| ${c} | | |`)
-        : ["| - (no criteria defined in goal.md) | | |"];
-    const missing = [
-        !buildArtifact && "build.md",
-        !testArtifact && "test.md",
-    ].filter(Boolean);
-    const artifact = [
-        "# Measure",
-        "",
-        `**Goal:** ${goalLine}`,
-        missing.length > 0
-            ? `\n> ⚠️ Missing: ${missing.join(", ")} — measurement may be incomplete.`
-            : "",
-        "",
-        "## Success criteria scorecard",
-        "| Criterion | Status | Evidence |",
-        "|-----------|--------|----------|",
-        ...criteriaRows,
-        "",
-        "## Overall verdict",
-        "<!-- One of: ✅ Goal met | ⚠️ Partially met | ❌ Not met -->",
-        "**Verdict:** ",
-        "**Summary:** ",
-        "",
-        "## What worked well",
-        "- ",
-        "",
-        "## What fell short",
-        "- ",
-        "",
-        "## Quantitative signals",
-        "<!-- Add any measurable data: test pass rate, latency, bundle size, etc. -->",
-        "| Metric | Target | Actual | Pass? |",
-        "|--------|--------|--------|-------|",
-        "| | | | |",
-        "",
-        `_Generated by waypoint_measure — ${new Date().toISOString()}_`,
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-    await saveArtifact(workspacePath, "measure.md", artifact);
-    return [
-        "## waypoint_measure — Measurement framework generated",
-        "",
-        `**Goal:** ${goalLine}`,
-        missing.length > 0 ? `\n> Missing: ${missing.join(", ")} — add these for fuller measurement.` : "",
-        "",
-        criteriaLines.length > 0
-            ? `**${criteriaLines.length} success criteria** pulled from goal.md into scorecard.`
-            : "**No success criteria found in goal.md.** Fill in the scorecard manually.",
-        "",
-        "### How to use measure.md",
-        "1. Score each criterion: ✅ met / ⚠️ partial / ❌ not met",
-        "2. Add evidence for each",
-        "3. Record quantitative signals where available",
-        "4. Write the overall verdict",
-        "",
-        "### Artifact saved",
-        "`measure.md` written to `.waypoint/measure.md`.",
-        "",
-        "### Suggested next step",
-        "Run `waypoint_improve` to identify refinements based on what fell short.",
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-}

package/dist/tools/plan.js

@@ -1,107 +0,0 @@
-import { getBaseContext, getArtifact, saveArtifact } from "../context.js";
-export const definition = {
-    name: "waypoint_plan",
-    description: "Create a structured plan for new features or significant changes only.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            workspacePath: {
-                type: "string",
-                description: "Absolute path to the workspace root.",
-            },
-            scope: {
-                type: "string",
-                description: "Specific scope or milestone to plan (optional). Omit to plan the full goal.",
-            },
-        },
-        required: ["workspacePath"],
-    },
-};
-export async function run(args) {
-    const { workspacePath, scope } = args;
-    const ctx = await getBaseContext(workspacePath);
-    const goalArtifact = await getArtifact(workspacePath, "goal.md");
-    const optionsArtifact = await getArtifact(workspacePath, "compare.md");
-    const researchArtifact = await getArtifact(workspacePath, "research.md");
-    if (!goalArtifact) {
-        return [
-            "## waypoint_plan — No goal found",
-            "",
-            "Run `waypoint_goal` before planning.",
-        ].join("\n");
-    }
-    const goalLine = goalArtifact.match(/^# Goal\n+(.+)/m)?.[1] ?? "(goal not parsed)";
-    const missing = [
-        !researchArtifact && "research.md",
-        !optionsArtifact && "compare.md",
-    ].filter(Boolean);
-    const artifact = [
-        "# Plan",
-        "",
-        `**Goal:** ${goalLine}`,
-        scope ? `**Scope:** ${scope}` : "",
-        missing.length > 0
-            ? `\n> ⚠️ Missing prior artifacts: ${missing.join(", ")}. Plan may be incomplete.`
-            : "",
-        "",
-        "## Milestones",
-        "<!-- Break the work into 2–5 ordered milestones -->",
-        "",
-        "### Milestone 1 — Foundation",
-        "**Deliverable:** ",
-        "**Done when:** ",
-        "**Steps:**",
-        "- [ ] ",
-        "",
-        "### Milestone 2 — Core feature",
-        "**Deliverable:** ",
-        "**Done when:** ",
-        "**Steps:**",
-        "- [ ] ",
-        "",
-        "### Milestone 3 — Polish & ship",
-        "**Deliverable:** ",
-        "**Done when:** ",
-        "**Steps:**",
-        "- [ ] ",
-        "",
-        "## Dependencies",
-        "<!-- External dependencies or blockers between milestones -->",
-        "- ",
-        "",
-        "## Out of scope for this plan",
-        "- ",
-        "",
-        "## Risk register",
-        "| Risk | Likelihood | Impact | Mitigation |",
-        "|------|-----------|--------|------------|",
-        "| | | | |",
-        "",
-        `_Generated by waypoint_plan — ${new Date().toISOString()}_`,
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-    await saveArtifact(workspacePath, "plan.md", artifact);
-    return [
-        "## waypoint_plan — Plan generated",
-        "",
-        `**Goal:** ${goalLine}`,
-        scope ? `**Scope:** ${scope}` : "",
-        missing.length > 0
-            ? `\n> Missing: ${missing.join(", ")} — plan may be incomplete.`
-            : "",
-        "",
-        "### Structure",
-        "- **3 milestones** scaffolded — fill in deliverables, done-when criteria, and steps",
-        "- **Risk register** — add any known risks before building",
-        "- **Dependencies** — note anything that must be resolved first",
-        "",
-        "### Artifact saved",
-        "`plan.md` written to `.waypoint/plan.md`.",
-        "",
-        "### Suggested next step",
-        "Run `waypoint_build` to scaffold implementation from this plan.",
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-}

package/dist/tools/research.js

@@ -1,104 +0,0 @@
-import { getBaseContext, getArtifact, saveArtifact } from "../context.js";
-export const definition = {
-    name: "waypoint_research",
-    description: "Gather best practices, surface the right questions, explore the solution space.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            workspacePath: {
-                type: "string",
-                description: "Absolute path to the workspace root.",
-            },
-            topic: {
-                type: "string",
-                description: "Specific research focus (optional). Omit to research the full goal.",
-            },
-        },
-        required: ["workspacePath"],
-    },
-};
-export async function run(args) {
-    const { workspacePath, topic } = args;
-    const ctx = await getBaseContext(workspacePath);
-    const goalArtifact = await getArtifact(workspacePath, "goal.md");
-    if (!goalArtifact) {
-        return [
-            "## waypoint_research — No goal found",
-            "",
-            "Run `waypoint_goal` first to define the project goal before researching.",
-        ].join("\n");
-    }
-    const goalLine = goalArtifact.match(/^# Goal\n+(.+)/m)?.[1] ?? "(goal not parsed)";
-    const focus = topic ?? goalLine;
-    const artifact = [
-        "# Research",
-        "",
-        `**Goal:** ${goalLine}`,
-        topic ? `**Focus:** ${topic}` : "",
-        "",
-        "## Key questions to answer",
-        "<!-- What must be understood before committing to a design? -->",
-        "- What existing solutions or libraries handle this well?",
-        "- What constraints (performance, security, compatibility) apply?",
-        "- What has failed in similar past attempts?",
-        "- What unknowns could invalidate the plan?",
-        "",
-        "## Areas to investigate",
-        "",
-        "### Prior art & libraries",
-        "- [ ] Survey existing libraries and tools relevant to the goal",
-        "- [ ] Review documentation and known limitations",
-        "",
-        "### Architecture & patterns",
-        "- [ ] Identify applicable design patterns",
-        "- [ ] Assess integration points with existing code",
-        "",
-        "### Risks & constraints",
-        "- [ ] List technical risks",
-        "- [ ] Note hard constraints (runtime, platform, team)",
-        "",
-        "### Open decisions",
-        "<!-- Questions that will need to be resolved in waypoint_compare -->",
-        "- [ ] ",
-        "",
-        "## Workspace observations",
-        `**Path:** ${workspacePath}`,
-        ctx.packageJson
-            ? (() => {
-                try {
-                    const p = JSON.parse(ctx.packageJson);
-                    return `**Package:** ${p.name ?? "unnamed"} v${p.version ?? "?"}`;
-                }
-                catch {
-                    return "**Package:** present (unparseable)";
-                }
-            })()
-            : "**Package:** none detected",
-        "",
-        `_Generated by waypoint_research — ${new Date().toISOString()}_`,
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-    await saveArtifact(workspacePath, "research.md", artifact);
-    return [
-        "## waypoint_research — Research brief generated",
-        "",
-        `**Goal:** ${goalLine}`,
-        topic ? `**Focus:** ${topic}` : "",
-        "",
-        "### What to investigate",
-        "1. **Prior art & libraries** — survey what exists, note limitations",
-        "2. **Architecture & patterns** — find applicable patterns, assess fit",
-        "3. **Risks & constraints** — surface blockers early",
-        "4. **Open decisions** — list what must be resolved before planning",
-        "",
-        "### Artifact saved",
-        "`research.md` written to `.waypoint/research.md`.",
-        "Fill in findings before moving forward.",
-        "",
-        "### Suggested next step",
-        "Run `waypoint_compare` to turn research findings into concrete decision tradeoffs.",
-    ]
-        .filter((l) => l !== undefined)
-        .join("\n");
-}

package/dist/tools/review.js

@@ -1,123 +0,0 @@
-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

@@ -1,107 +0,0 @@
-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");
-}