codeloop-mcp-server 0.1.0

package/dist/evidence/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/evidence/artifacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,wBAAgB,YAAY,CAC1B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWnC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,IAAI,CAGN;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAmB7B;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAWnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE"}

package/dist/evidence/artifacts.js

@@ -0,0 +1,60 @@
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync, } from "fs";
+import { join } from "path";
+const RUN_SUBDIRS = ["logs", "screenshots", "baselines", "diffs", "traces", "videos"];
+export function generateRunId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 8);
+    return `run_${timestamp}_${random}`;
+}
+export function getArtifactsBaseDir(cwd = process.cwd()) {
+    return join(cwd, "artifacts", "runs");
+}
+export function createRunDir(runId, baseDir) {
+    const id = runId || generateRunId();
+    const base = baseDir || getArtifactsBaseDir();
+    const runDir = join(base, id);
+    mkdirSync(runDir, { recursive: true });
+    for (const subdir of RUN_SUBDIRS) {
+        mkdirSync(join(runDir, subdir), { recursive: true });
+    }
+    return { runId: id, runDir };
+}
+export function saveRunMeta(runDir, meta) {
+    const metaPath = join(runDir, "meta.json");
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+}
+export function loadRunMeta(runIdOrDir, baseDir) {
+    let metaPath;
+    if (existsSync(join(runIdOrDir, "meta.json"))) {
+        metaPath = join(runIdOrDir, "meta.json");
+    }
+    else {
+        const base = baseDir || getArtifactsBaseDir();
+        metaPath = join(base, runIdOrDir, "meta.json");
+    }
+    if (!existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(metaPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function listRuns(baseDir) {
+    const base = baseDir || getArtifactsBaseDir();
+    if (!existsSync(base)) {
+        return [];
+    }
+    return readdirSync(base, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && d.name.startsWith("run_"))
+        .map((d) => d.name)
+        .sort()
+        .reverse();
+}
+export function getRunDir(runId, baseDir) {
+    const base = baseDir || getArtifactsBaseDir();
+    return join(base, runId);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/evidence/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/evidence/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/evidence/screenshot_diff.d.ts

@@ -0,0 +1,30 @@
+export interface DiffResult {
+    screen: string;
+    diffScore: number;
+    diffPixels: number;
+    totalPixels: number;
+    diffImagePath: string | null;
+    baselineExists: boolean;
+}
+export interface ScreenshotDiffSummary {
+    results: DiffResult[];
+    screenshotsCompared: number;
+    baselineExists: boolean;
+    screensAboveThreshold: string[];
+}
+/**
+ * Compare two PNG images pixel-by-pixel.
+ * Size mismatches are handled by padding both images to the larger width and height (white fill), then comparing.
+ */
+export declare function compareScreenshot(screenshotPath: string, baselinePath: string, diffOutputPath: string, threshold?: number): DiffResult;
+/**
+ * Compare every PNG in `screenshotsDir` to the same filename under `baselinesDir`.
+ * Writes diff images to `diffsDir` using the same base filename.
+ */
+export declare function diffAllScreenshots(screenshotsDir: string, baselinesDir: string, diffsDir: string, threshold?: number): ScreenshotDiffSummary;
+/**
+ * Copy current screenshots into `baselinesDir` (creates the directory if needed).
+ * If `screens` is set, only those screen names (without `.png`) are updated; otherwise all PNGs are copied.
+ */
+export declare function updateBaselines(screenshotsDir: string, baselinesDir: string, screens?: string[]): string[];
+//# sourceMappingURL=screenshot_diff.d.ts.map

package/dist/evidence/screenshot_diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot_diff.d.ts","sourceRoot":"","sources":["../../src/evidence/screenshot_diff.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAqDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAA0B,GACpC,UAAU,CAmCZ;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA0B,GACpC,qBAAqB,CA+CvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,MAAM,EAAE,CAwBV"}

package/dist/evidence/screenshot_diff.js

@@ -0,0 +1,144 @@
+import pixelmatch from "pixelmatch";
+import { PNG } from "pngjs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, } from "fs";
+import { join, basename, dirname } from "path";
+const DEFAULT_THRESHOLD = 0.1;
+function screenNameFromPath(filePath) {
+    const base = basename(filePath);
+    return base.replace(/\.png$/i, "") || base;
+}
+function listPngFiles(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir).filter((f) => f.toLowerCase().endsWith(".png"));
+}
+function readPng(path) {
+    return PNG.sync.read(readFileSync(path));
+}
+/** Pads image data to `width` x `height` (top-left aligned, white background). */
+function rgbaToCanvas(data, srcW, srcH, width, height) {
+    const out = Buffer.alloc(width * height * 4);
+    out.fill(255);
+    for (let y = 0; y < srcH; y++) {
+        for (let x = 0; x < srcW; x++) {
+            const si = (y * srcW + x) * 4;
+            const di = (y * width + x) * 4;
+            data.copy(out, di, si, si + 4);
+        }
+    }
+    return out;
+}
+function prepareCompareBuffers(a, b) {
+    const width = Math.max(a.width, b.width);
+    const height = Math.max(a.height, b.height);
+    if (a.width === width && a.height === height && b.width === width && b.height === height) {
+        return { width, height, buf1: a.data, buf2: b.data };
+    }
+    const buf1 = a.width === width && a.height === height ? a.data : rgbaToCanvas(a.data, a.width, a.height, width, height);
+    const buf2 = b.width === width && b.height === height ? b.data : rgbaToCanvas(b.data, b.width, b.height, width, height);
+    return { width, height, buf1, buf2 };
+}
+/**
+ * Compare two PNG images pixel-by-pixel.
+ * Size mismatches are handled by padding both images to the larger width and height (white fill), then comparing.
+ */
+export function compareScreenshot(screenshotPath, baselinePath, diffOutputPath, threshold = DEFAULT_THRESHOLD) {
+    const screen = screenNameFromPath(screenshotPath);
+    if (!existsSync(screenshotPath) || !existsSync(baselinePath)) {
+        throw new Error(`compareScreenshot: missing file(s) — screenshot: ${screenshotPath}, baseline: ${baselinePath}`);
+    }
+    const img1 = readPng(screenshotPath);
+    const img2 = readPng(baselinePath);
+    const { width, height, buf1, buf2 } = prepareCompareBuffers(img1, img2);
+    const totalPixels = width * height;
+    mkdirSync(dirname(diffOutputPath), { recursive: true });
+    const diff = Buffer.alloc(totalPixels * 4);
+    const diffPixels = pixelmatch(buf1, buf2, diff, width, height, {
+        threshold,
+    });
+    const outPng = new PNG({ width, height });
+    diff.copy(outPng.data);
+    writeFileSync(diffOutputPath, PNG.sync.write(outPng));
+    const diffScore = totalPixels === 0 ? 0 : diffPixels / totalPixels;
+    return {
+        screen,
+        diffScore,
+        diffPixels,
+        totalPixels,
+        diffImagePath: diffOutputPath,
+        baselineExists: true,
+    };
+}
+/**
+ * Compare every PNG in `screenshotsDir` to the same filename under `baselinesDir`.
+ * Writes diff images to `diffsDir` using the same base filename.
+ */
+export function diffAllScreenshots(screenshotsDir, baselinesDir, diffsDir, threshold = DEFAULT_THRESHOLD) {
+    const pngFiles = listPngFiles(screenshotsDir);
+    const results = [];
+    let allHaveBaselines = true;
+    mkdirSync(diffsDir, { recursive: true });
+    for (const file of pngFiles) {
+        const screenshotPath = join(screenshotsDir, file);
+        const baselinePath = join(baselinesDir, file);
+        const screen = screenNameFromPath(file);
+        if (!existsSync(baselinePath)) {
+            allHaveBaselines = false;
+            let totalPixels = 0;
+            try {
+                const png = readPng(screenshotPath);
+                totalPixels = png.width * png.height;
+            }
+            catch {
+                totalPixels = 0;
+            }
+            results.push({
+                screen,
+                diffScore: 0,
+                diffPixels: 0,
+                totalPixels,
+                diffImagePath: null,
+                baselineExists: false,
+            });
+            continue;
+        }
+        const diffOutputPath = join(diffsDir, file);
+        const result = compareScreenshot(screenshotPath, baselinePath, diffOutputPath, threshold);
+        results.push(result);
+    }
+    const screensAboveThreshold = results
+        .filter((r) => r.baselineExists && r.diffScore > threshold)
+        .map((r) => r.screen);
+    return {
+        results,
+        screenshotsCompared: results.length,
+        baselineExists: allHaveBaselines,
+        screensAboveThreshold,
+    };
+}
+/**
+ * Copy current screenshots into `baselinesDir` (creates the directory if needed).
+ * If `screens` is set, only those screen names (without `.png`) are updated; otherwise all PNGs are copied.
+ */
+export function updateBaselines(screenshotsDir, baselinesDir, screens) {
+    if (!existsSync(screenshotsDir)) {
+        return [];
+    }
+    mkdirSync(baselinesDir, { recursive: true });
+    const files = screens?.length
+        ? screens.map((s) => (s.toLowerCase().endsWith(".png") ? s : `${s}.png`))
+        : listPngFiles(screenshotsDir);
+    const updated = [];
+    for (const file of files) {
+        const src = join(screenshotsDir, file);
+        if (!existsSync(src) || !file.toLowerCase().endsWith(".png")) {
+            continue;
+        }
+        const dest = join(baselinesDir, file);
+        writeFileSync(dest, readFileSync(src));
+        updated.push(dest);
+    }
+    return updated;
+}
+//# sourceMappingURL=screenshot_diff.js.map

package/dist/evidence/screenshot_diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot_diff.js","sourceRoot":"","sources":["../../src/evidence/screenshot_diff.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { validateApiKey, isActivationRequired } from "./auth/api_key.js";
+import { trackUsage } from "./auth/usage_tracker.js";
+const config = loadConfig();
+const apiKey = process.env.CODELOOP_API_KEY || config.api_key;
+const server = new McpServer({
+    name: "codeloop",
+    version: "0.1.0",
+});
+async function withAuth(fn) {
+    const result = await validateApiKey(apiKey);
+    if (isActivationRequired(result)) {
+        return result;
+    }
+    if (!result.valid) {
+        return {
+            error: true,
+            status: result.status,
+            message: result.message || "API key is invalid or expired.",
+            upgrade_url: "https://codeloop.tech/dashboard/billing",
+        };
+    }
+    return fn();
+}
+function stubResponse(toolName) {
+    return {
+        status: "not_implemented",
+        tool: toolName,
+        message: `${toolName} is registered but not yet implemented. It will be available in a future release.`,
+    };
+}
+// ── Implemented Tools ────────────────────────────────────────────
+server.tool("codeloop_verify", `Run the CodeLoop verification suite on the current project. Use this tool when:
+- You have implemented or modified code and need to check if it works correctly
+- You want to run all tests, linters, and checks before marking a task complete
+- Tests are failing and you need structured output to understand failures
+Returns: structured report with pass/fail counts, artifact paths, and next-step suggestion.`, {
+    scope: z.enum(["full", "affected"]).default("full"),
+    platform: z.enum(["flutter", "web", "mobile", "auto"]).default("auto"),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runVerify } = await import("./tools/verify.js");
+        const input = {
+            scope: params.scope,
+            platform: params.platform,
+        };
+        const output = await runVerify(input, config);
+        await trackUsage(apiKey, "verification_run");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_diagnose", `Classify failures from a CodeLoop verification run into structured categories with repair tasks. Use this tool when:
+- codeloop_verify reported failures and you need to understand what went wrong
+- You have been attempting to fix an issue multiple times without success
+- You need structured failure analysis instead of guessing from raw output
+Returns: categorized issues with severity, evidence, root cause, and actionable repair tasks.`, {
+    run_id: z.string(),
+    focus_files: z.array(z.string()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runDiagnose } = await import("./tools/diagnose.js");
+        const input = {
+            run_id: params.run_id,
+            focus_files: params.focus_files,
+        };
+        const output = await runDiagnose(input, config);
+        await trackUsage(apiKey, "verification_run");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_gate_check", `Evaluate whether a section or feature meets all quality gates for completion. Use this tool when:
+- You believe a feature is complete and want evidence-based confirmation
+- You need to check if all acceptance criteria are met before moving to the next section
+- You want a confidence score to decide whether to continue fixing or stop
+Returns: pass/fail for each gate, overall confidence score, and recommendation.`, {
+    run_id: z.string(),
+    spec_path: z.string(),
+    acceptance_path: z.string(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runGateCheck } = await import("./tools/gate_check.js");
+        const input = {
+            run_id: params.run_id,
+            spec_path: params.spec_path,
+            acceptance_path: params.acceptance_path,
+        };
+        const output = await runGateCheck(input, config);
+        await trackUsage(apiKey, "verification_run");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── Stub Tools (registered for discovery, implemented in later phases) ──
+server.tool("codeloop_visual_review", `Capture and analyze screenshots of the current UI for visual issues. Use this tool when:
+- You have made UI changes and want to check for visual regressions
+- You want a vision-model review of screenshots against a UX checklist
+- You need to compare the current UI against baseline screenshots
+Returns: visual issues with severity, diff scores against baselines, and layout warnings.`, {
+    run_id: z.string().optional(),
+    screenshots_dir: z.string().optional(),
+    baseline_dir: z.string().optional(),
+    ux_checklist_path: z.string().optional(),
+    viewport_sizes: z.array(z.string()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runVisualReview } = await import("./tools/visual_review.js");
+        const input = {
+            run_id: params.run_id,
+            screenshots_dir: params.screenshots_dir,
+            baseline_dir: params.baseline_dir,
+            ux_checklist_path: params.ux_checklist_path,
+            viewport_sizes: params.viewport_sizes,
+        };
+        const output = await runVisualReview(input, config);
+        await trackUsage(apiKey, "visual_review");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_design_compare", `Compare a reference design image against the actual coded UI. Use this tool when:
+- The user has provided a Figma mockup, screenshot, or design reference
+- You want to measure how closely the coded UI matches the intended design
+- You need structured differences to fix specific design mismatches
+Returns: match score, list of differences with fix hints, and comparison screenshots.`, {
+    reference_image_path: z.string(),
+    screen_name: z.string(),
+    platform: z.string(),
+    viewport_sizes: z.array(z.string()).optional(),
+    ux_checklist_path: z.string().optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runDesignCompare } = await import("./tools/design_compare.js");
+        const input = {
+            reference_image_path: params.reference_image_path,
+            screen_name: params.screen_name,
+            platform: params.platform,
+            viewport_sizes: params.viewport_sizes ?? [],
+            ux_checklist_path: params.ux_checklist_path,
+        };
+        const output = await runDesignCompare(input, config);
+        await trackUsage(apiKey, "visual_review");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_section_status", `Check the progress of multi-section app development. Use this tool when:
+- A master spec exists and you need to know which section to work on next
+- You have completed a section and need to proceed to the next one
+- You need to check if an integration checkpoint is due
+Returns: section states, dependencies, confidence scores, and next action instruction.`, {
+    master_spec_path: z.string().default("docs/specs/_master.md"),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { getSectionStatus } = await import("./tools/section_status.js");
+        return getSectionStatus({ master_spec_path: params.master_spec_path }, config);
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_release_readiness", `Generate a comprehensive release readiness report. Use this tool when:
+- All sections are complete and you need a final quality assessment
+- You want to produce evidence that the app is ready for human UAT
+Returns: overall readiness score, blockers, warnings, and full evidence summary.`, {
+    run_id: z.string(),
+    spec_path: z.string(),
+    include: z.array(z.string()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runReleaseReadiness } = await import("./tools/release_readiness.js");
+        const output = await runReleaseReadiness({ run_id: params.run_id, spec_path: params.spec_path, include: params.include }, config);
+        await trackUsage(apiKey, "verification_run");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_recommend_tool", `Recommend third-party tools and services based on the project stack and constraints. Use this tool when:
+- The user asks about hosting, email services, analytics, auth providers, or other infrastructure
+- You need evidence-based tool comparisons with tradeoffs and pricing
+Returns: ranked recommendations with reasoning, integration complexity, and starter tasks.`, {
+    category: z.string(),
+    stack: z.record(z.string()).optional(),
+    budget: z.enum(["free", "low", "medium", "enterprise"]).default("low"),
+    constraints: z.record(z.unknown()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { selectRecommendations } = await import("./recommendations/selector.js");
+        const output = selectRecommendations({
+            category: params.category,
+            stack: params.stack || {},
+            budget: params.budget,
+            constraints: params.constraints || {},
+        }, config);
+        await trackUsage(apiKey, "verification_run");
+        return output;
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_integration_check", `Run cross-section integration verification on a multi-section project. Use this tool when:
+- Multiple sections have been completed individually and you need to check they work together
+- A later section may have introduced regressions in earlier sections
+- An integration checkpoint is due according to the development plan
+Returns: integration test results, regression list, and section-level confidence updates.`, {
+    master_spec_path: z.string().default("docs/specs/_master.md"),
+    sections: z.array(z.string()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runIntegrationCheck } = await import("./tools/integration_check.js");
+        return runIntegrationCheck({
+            master_spec_path: params.master_spec_path,
+            sections: params.sections,
+        }, config);
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_update_baseline", `Accept current screenshots as the new visual baseline for regression testing. Use this tool when:
+- Visual changes are intentional and the current screenshots should become the new reference
+- A design has been approved and you want to lock in the current state
+- Baseline screenshots are missing and need to be established for the first time
+Returns: list of updated baseline files with before/after paths.`, {
+    run_id: z.string(),
+    screens: z.array(z.string()).optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runUpdateBaseline } = await import("./tools/update_baseline.js");
+        return runUpdateBaseline({ run_id: params.run_id, screens: params.screens }, config);
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("codeloop_replan", `Detect scope changes in the project spec and update section states accordingly. Use this tool when:
+- The master spec has been modified and sections need to be re-evaluated
+- New requirements have been added that affect completed sections
+- You need to determine which sections require rework after a spec change
+Returns: list of affected sections, new states, and recommended next actions.`, {
+    master_spec_path: z.string().default("docs/specs/_master.md"),
+    change_summary: z.string().optional(),
+}, async (params) => {
+    const result = await withAuth(async () => {
+        const { runReplan } = await import("./tools/replan.js");
+        return runReplan({
+            master_spec_path: params.master_spec_path,
+            change_summary: params.change_summary,
+        }, config);
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ── Start Server ─────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/recommendations/knowledge_base.d.ts

@@ -0,0 +1,21 @@
+export interface ToolEntry {
+    name: string;
+    description: string;
+    website: string;
+    category: string;
+    bestFor: string;
+    pricingTier: string;
+    freeTier: boolean;
+    selfHosted: boolean;
+    openSource: boolean;
+    complianceNotes: string;
+    integrationComplexity: "trivial" | "moderate" | "complex";
+    supportedStacks: string[];
+    strengths: string[];
+    weaknesses: string[];
+    tradeoffs: string;
+    starterTasks: string[];
+    recommendationType: "neutral" | "sponsored";
+}
+export declare const KNOWLEDGE_BASE: ToolEntry[];
+//# sourceMappingURL=knowledge_base.d.ts.map

package/dist/recommendations/knowledge_base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_base.d.ts","sourceRoot":"","sources":["../../src/recommendations/knowledge_base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,SAAS,GAAG,WAAW,CAAC;CAC7C;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,EAk3BrC,CAAC"}