@ambitresearch/genie 1.3.1

package/dist/tools/refine.js

@@ -0,0 +1,501 @@
+import { createTwoFilesPatch } from "diff";
+import { z } from "zod";
+import {} from "../llm/schema.js";
+import { REFINE_COMPONENT_SYSTEM_PROMPT_FILE, loadPrompt, } from "../llm/prompts.js";
+// The shared request/validate/retry harness (M2-03/M2-04) — the same Ajv
+// validate, response_format envelope, retry-feedback wording, and two-attempt
+// loop `conjure` uses (AC6).
+import { appendRetryFeedback, logStderr, runComponentGeneration, } from "../llm/component-response.js";
+// Value import (not type-only): `retry.ts` has no import-time side effects —
+// unlike `client.ts`, it never touches `GENIE_LLM_*` env or constructs
+// anything eagerly at module load — so wrapping `defaultChatCompletion`
+// below in `withRetry` is safe to do statically (same reasoning as
+// `conjure.ts`; DRO-253 / DRO-618: `refine` shares the exact same gap
+// conjure had — `withRetry` existed but no production call site applied it).
+import { withRetry } from "../llm/retry.js";
+import { normalizeGeneratedFiles, validateGeneratedBinaryContent, } from "../llm/generated-files.js";
+import { KIT_ID_PATTERN } from "./get_kit.js";
+export const REFINE_TOOL_NAME = "mcp__genie__refine";
+/** Default model routing alias — the same one `conjure` uses (M2-05). Resolved
+ * to a concrete provider model by the configured endpoint/gateway. Defined
+ * locally to keep `refine` decoupled from `conjure`'s module. */
+export const DEFAULT_MODEL = "design-default";
+/** PascalCase component-name shape — identical to `COMPONENT_SCHEMA`'s
+ * `componentName` pattern, so an id `refine` accepts is one `conjure` could have
+ * produced. */
+export const COMPONENT_NAME_PATTERN = /^[A-Z][A-Za-z0-9]{1,63}$/;
+/** Directory prefix every kit component's files live under. */
+const COMPONENTS_ROOT = "components";
+// ── Input schema (AC2) ────────────────────────────────────────────────────────
+//
+// { kitId, componentName, instruction, region?: { x, y, w, h }, model? }
+// (research §3.1). `region` bounds mirror COMPONENT_SCHEMA's viewport limits
+// (≤4096) so a canvas selection can't request an absurd crop; `w`/`h` are ≥1
+// (a zero-area rect is not a selection). `model` defaults like `conjure`.
+const regionSchema = z
+    .object({
+    x: z.number().int().min(0).max(4096),
+    y: z.number().int().min(0).max(4096),
+    w: z.number().int().min(1).max(4096),
+    h: z.number().int().min(1).max(4096),
+})
+    .strict();
+const refineInputShape = {
+    kitId: z
+        .string()
+        .regex(KIT_ID_PATTERN, "kitId must be a 3-64 character slug of lowercase letters, numbers, and hyphens."),
+    componentName: z
+        .string()
+        .regex(COMPONENT_NAME_PATTERN, "componentName must be PascalCase, 2-64 chars (e.g. Button)."),
+    instruction: z.string().min(1).max(8192),
+    region: regionSchema.optional(),
+    model: z.string().min(1).max(128).default(DEFAULT_MODEL),
+};
+const refineArgsSchema = z.object(refineInputShape).strict();
+/** Typed failure surfaced to the tool boundary (mapped to an MCP error result).
+ * `ERR_COMPONENT_NOT_FOUND` — no files for `componentName` in the kit (or the
+ * kit itself is absent); `ERR_LLM_OUTPUT_INVALID` — the model did not return a
+ * schema-valid component after the retry (same code `conjure` throws). */
+export class RefineError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "RefineError";
+    }
+}
+// ── Default (production) chat impl: lazy client import (same as conjure) ───────
+/**
+ * Default `chat` seam: dynamically imports the M2-01 client on first call, so
+ * building the server never eagerly triggers `MissingLLMConfigError` (see module
+ * header). A real `refine` call in a properly-configured deployment resolves
+ * this to `withRetry(createChatCompletion)` (M2-06, DRO-253) — every
+ * production LLM call this tool makes is retry/backoff-wrapped by default,
+ * same as `conjure`; callers (and tests, via `deps.chat`) never need to
+ * remember to apply the wrapper themselves.
+ *
+ * `withRetry` is called fresh on every invocation rather than wrapped once at
+ * module scope: the module-scope `createChatCompletion` binding doesn't exist
+ * until the dynamic import resolves, and re-wrapping a plain async function
+ * is cheap (no state beyond reading `GENIE_LLM_RETRY_MAX` from `process.env`
+ * per call, matching `conjure.ts`'s identical seam).
+ */
+const defaultChatCompletion = async (input) => {
+    const { createChatCompletion } = await import("../llm/client.js");
+    return withRetry(createChatCompletion)(input);
+};
+/** Load Playwright at runtime, or `null` if it is not installed. The non-literal
+ * specifier keeps `tsc` from resolving the (non-dependency) module at build. */
+async function importPlaywright() {
+    const specifier = "playwright";
+    try {
+        return (await import(specifier));
+    }
+    catch (error) {
+        logStderr({
+            event: "refine.region.unavailable",
+            reason: "playwright-not-installed",
+            error: String(error),
+        });
+        return null;
+    }
+}
+/**
+ * Default cropper (AC7): render the preview HTML in headless Chromium and
+ * screenshot the region rect, returning it as a PNG data URL for vision input.
+ * Degrades gracefully — if Playwright is absent, or launch/render/screenshot
+ * fails, it logs and returns `{ dataUrl: null }` so `refine` continues without
+ * the image rather than failing the whole call over an optional enhancement.
+ */
+export const defaultRegionCropper = {
+    async crop({ html, region, viewport }) {
+        const pw = await importPlaywright();
+        if (!pw)
+            return { dataUrl: null };
+        let browser;
+        try {
+            // `--no-sandbox` so it runs in restricted CI/container environments.
+            browser = await pw.chromium.launch({ args: ["--no-sandbox"] });
+            const page = await browser.newPage({ viewport });
+            // `load` (not `networkidle`): an embedded-CSP preview has no network to go
+            // idle on (`default-src 'none'`), so waiting for idle would just add the
+            // default timeout to every crop.
+            await page.setContent(html, { waitUntil: "load" });
+            const buf = await page.screenshot({
+                clip: { x: region.x, y: region.y, width: region.w, height: region.h },
+            });
+            return { dataUrl: `data:image/png;base64,${buf.toString("base64")}` };
+        }
+        catch (error) {
+            logStderr({ event: "refine.region.error", error: String(error) });
+            return { dataUrl: null };
+        }
+        finally {
+            if (browser)
+                await browser.close();
+        }
+    },
+};
+// ── File discovery (AC3) ──────────────────────────────────────────────────────
+/**
+ * Split a kit-relative path into its `components/<group>/<Name>/…` parts, or
+ * `null` if it is not a component file. Used to find every file belonging to
+ * `componentName` and to read its group off the first match.
+ */
+function parseComponentPath(path) {
+    const parts = path.split("/");
+    if (parts.length < 4 || parts[0] !== COMPONENTS_ROOT)
+        return null;
+    return { group: parts[1], name: parts[2], rest: parts.slice(3).join("/") };
+}
+/**
+ * Load every file of `componentName` from the kit (AC3): `listFiles` to discover
+ * the set, then `readFile` per file (one call each, as the AC specifies). The
+ * group is derived from the matched paths — a component's directory names it.
+ * Throws `RefineError("ERR_COMPONENT_NOT_FOUND")` when nothing matches (a missing
+ * kit surfaces the same way: no files, nothing to refine).
+ */
+async function loadComponentFiles(kitStore, kitId, componentName) {
+    let entries;
+    try {
+        entries = await kitStore.listFiles(kitId);
+    }
+    catch (error) {
+        // A missing kit (NotFoundError) is just "nothing to refine" — one clear code.
+        throw new RefineError("ERR_COMPONENT_NOT_FOUND", `Could not load component "${componentName}" from kit "${kitId}": ${String(error?.message ?? error)}`, { kitId, componentName });
+    }
+    // Match files whose 3rd path segment is exactly the component name. Sort by
+    // path so group derivation and file order are deterministic.
+    const matches = entries
+        .map((e) => ({ path: e.path, parsed: parseComponentPath(e.path) }))
+        .filter((m) => m.parsed !== null && m.parsed.name === componentName)
+        .sort((a, b) => a.path.localeCompare(b.path));
+    if (matches.length === 0) {
+        throw new RefineError("ERR_COMPONENT_NOT_FOUND", `No component named "${componentName}" was found in kit "${kitId}". ` +
+            `Expected files under ${COMPONENTS_ROOT}/<group>/${componentName}/.`, { kitId, componentName });
+    }
+    // A component lives in ONE group; take it from the first match and keep only
+    // that group's files (guards the pathological case of two same-named dirs).
+    const group = matches[0].parsed.group;
+    const inGroup = matches.filter((m) => m.parsed.group === group);
+    const files = await Promise.all(inGroup.map(async ({ path }) => {
+        const read = await kitStore.readFile(kitId, path);
+        return { path, content: read.content, encoding: read.encoding, mimeType: read.mimeType };
+    }));
+    return { group, files };
+}
+// ── Preview + viewport helpers (AC4/AC7) ──────────────────────────────────────
+/** The `<Name>.html` preview file among the loaded set, if present. */
+function findPreview(files, componentName) {
+    const suffix = `/${componentName}/${componentName}.html`;
+    return files.find((f) => f.path.endsWith(suffix));
+}
+/**
+ * Choose a render viewport for the crop that (a) is at least the component's
+ * natural preview size (read from `meta.json`'s `viewport` when available, so the
+ * layout matches how the card really renders) and (b) is big enough to contain
+ * the requested region. Falls back to a sensible default when there is no
+ * parseable meta.
+ */
+export function deriveRenderViewport(files, region) {
+    const DEFAULT = { width: 400, height: 300 };
+    const meta = files.find((f) => f.path.endsWith("/meta.json"));
+    let base = DEFAULT;
+    if (meta) {
+        try {
+            const parsed = JSON.parse(meta.content);
+            const w = parsed.viewport?.width;
+            const h = parsed.viewport?.height;
+            if (typeof w === "number" && typeof h === "number" && w > 0 && h > 0) {
+                base = { width: w, height: h };
+            }
+        }
+        catch {
+            // Non-JSON / unexpected meta → keep the default. Best-effort only.
+        }
+    }
+    return {
+        width: Math.max(base.width, region.x + region.w),
+        height: Math.max(base.height, region.y + region.h),
+    };
+}
+// ── Prompt / message assembly (AC4) ───────────────────────────────────────────
+/** True for files we inline verbatim into the prompt. Binary (base64) files are
+ * summarized rather than dumped as base64 into the context. */
+function isTextFile(file) {
+    return file.encoding !== "base64";
+}
+/** Build the natural-language user instruction block (everything except the
+ * optional vision crop image, attached separately). */
+function buildUserText(args, group, files, cropAttached) {
+    const lines = [
+        "## Instruction",
+        args.instruction,
+        "",
+        "## Component",
+        `Name: ${args.componentName}`,
+        `Group: ${group}`,
+    ];
+    if (args.region) {
+        const { x, y, w, h } = args.region;
+        lines.push("", "## Region (canvas selection)", `The instruction targets this rectangle of the preview, in the preview's own ` +
+            `pixel coordinates: x=${x}, y=${y}, width=${w}, height=${h}.`);
+        lines.push(cropAttached
+            ? "A cropped screenshot of that region is attached as a reference image — " +
+                "focus your edit on the element(s) it shows and leave the rest unchanged."
+            : "(A rendered crop of that region could not be produced; identify which " +
+                "element sits at those coordinates from the preview markup below.)");
+    }
+    lines.push("", "## Current files", "Apply only the instruction. Return every file below (updated where the edit " +
+        "touches it, unchanged otherwise); do not rename the component or drop files.");
+    for (const file of files) {
+        lines.push("", `### File: ${file.path} (${file.mimeType})`);
+        lines.push(isTextFile(file) ? file.content : `[binary file, ${file.encoding} — omitted]`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Assemble the messages for one attempt (AC4). System prompt is message 0; the
+ * user message carries the instruction + current files, and — when a region crop
+ * was produced — becomes a content-parts array with a vision `image_url` part
+ * (the same shape `conjure` uses for its reference image). `retry` appends the
+ * shared validation-feedback block on the single retry (AC6).
+ */
+function buildMessages(systemPrompt, args, group, files, cropDataUrl, retry) {
+    let userText = buildUserText(args, group, files, cropDataUrl !== null);
+    if (retry)
+        userText = appendRetryFeedback(userText, retry);
+    const userContent = cropDataUrl
+        ? [
+            { type: "text", text: userText },
+            { type: "image_url", image_url: { url: cropDataUrl } },
+        ]
+        : userText;
+    return [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userContent },
+    ];
+}
+// ── Unified diff (AC5) ────────────────────────────────────────────────────────
+/**
+ * Build a git-style unified diff from the original file set to the updated one,
+ * matched by path. Only CHANGED files contribute a hunk (unchanged files are
+ * omitted so the diff shows exactly what the refinement did); added/removed
+ * files diff against `/dev/null`. Informational only — `files` is authoritative.
+ */
+export function buildUnifiedDiff(originals, updated) {
+    const paths = new Set([...originals.keys(), ...updated.keys()]);
+    const sorted = [...paths].sort((a, b) => a.localeCompare(b));
+    const parts = [];
+    for (const path of sorted) {
+        const before = originals.get(path) ?? "";
+        const after = updated.get(path) ?? "";
+        if (before === after)
+            continue;
+        parts.push(createTwoFilesPatch(originals.has(path) ? `a/${path}` : "/dev/null", updated.has(path) ? `b/${path}` : "/dev/null", before, after));
+    }
+    return parts.join("\n");
+}
+// ── Core ──────────────────────────────────────────────────────────────────────
+/**
+ * Refine one existing component. Flow: load current files (AC3) → optionally
+ * render a region crop (AC4/AC7) → run the shared request/validate/retry loop
+ * with the diff-mode prompt (AC6) → compute the unified diff (AC5) → return
+ * `{ diff, files, … }` and log a per-call line (AC8).
+ */
+export async function refine(deps, args) {
+    const parsed = refineArgsSchema.parse(args);
+    const chat = deps.chat ?? defaultChatCompletion;
+    const cropper = deps.cropper ?? defaultRegionCropper;
+    const systemPrompt = (deps.loadSystemPrompt ?? (() => loadPrompt(REFINE_COMPONENT_SYSTEM_PROMPT_FILE)))();
+    const startedAt = performance.now();
+    const hasRegion = parsed.region !== undefined;
+    // AC3 — load the component's current files from the kit.
+    const { group, files: originalFiles } = await loadComponentFiles(deps.kitStore, parsed.kitId, parsed.componentName);
+    const originalBinaryPaths = new Set(originalFiles.filter((file) => !isTextFile(file)).map((file) => file.path));
+    // AC4/AC7 — if a region was given, try to render a crop of it for vision input.
+    let cropDataUrl = null;
+    if (parsed.region) {
+        const preview = findPreview(originalFiles, parsed.componentName);
+        if (preview && isTextFile(preview)) {
+            const viewport = deriveRenderViewport(originalFiles, parsed.region);
+            const { dataUrl } = await cropper.crop({
+                html: preview.content,
+                region: parsed.region,
+                viewport,
+            });
+            cropDataUrl = dataUrl;
+        }
+        else {
+            // No preview to render — the coordinates still reach the prompt as text.
+            logStderr({
+                event: "refine.region.no_preview",
+                componentName: parsed.componentName,
+                kitId: parsed.kitId,
+            });
+        }
+    }
+    // AC6 — shared request/validate/retry-once loop (same as conjure).
+    const { outcome, usage, attempts } = await runComponentGeneration({
+        chat,
+        model: parsed.model,
+        validateGeneratedComponent: (component) => validateGeneratedBinaryContent(component, originalBinaryPaths),
+        buildMessages: (retry) => buildMessages(systemPrompt.text, parsed, group, originalFiles, cropDataUrl, retry),
+    });
+    const latencyMs = Math.round(performance.now() - startedAt);
+    if (!outcome.ok) {
+        logStderr({
+            event: "refine",
+            ok: false,
+            componentName: parsed.componentName,
+            hasRegion,
+            model: parsed.model,
+            promptTokens: usage.promptTokens,
+            completionTokens: usage.completionTokens,
+            latencyMs,
+            promptVersion: systemPrompt.version,
+            attempts,
+        });
+        throw new RefineError("ERR_LLM_OUTPUT_INVALID", `The model did not return a schema-valid component after ${attempts} attempt(s). ` +
+            `Last validation error:\n${outcome.reason}`, { attempts, reason: outcome.reason });
+    }
+    const component = outcome.component;
+    // Binary (base64) originals are never sent to the model (they can't be inlined
+    // as prompt text — see buildUserText), so the model cannot echo them back. If
+    // we returned `component.files` as-is, any binary asset in the component
+    // directory would be silently DROPPED from the returned set and the diff would
+    // misreport it as deleted (diffed against /dev/null) — a refine round-trip
+    // would lose it (Copilot review, PR #127). So carry every original binary file
+    // forward into the result, even if the model fabricates the same path. Because
+    // that file is byte-identical on both sides, `buildUnifiedDiff`'s
+    // `before === after` check omits it automatically.
+    //
+    // Deliberate consequence (Copilot review, PR #128): because omission of a
+    // binary can't be distinguished from "the model never saw it", this carry-
+    // forward means `refine` cannot DELETE a binary asset — omission always
+    // resurrects it. That is intentional for v1: `refine` is an *edit* verb whose
+    // prompt explicitly says "don't drop files", and the kit's own system prompt
+    // steers components toward inline SVG / `data:` URIs rather than binary assets
+    // in the first place. Removing a binary from a component is the job of the
+    // dedicated, plan-gated `delete_files` / `write_files` verbs, not a side effect
+    // of a natural-language refine instruction. If a future version needs
+    // refine-driven binary deletion, it would take an explicit keep/delete marker
+    // protocol (the model returns the path with a sentinel the tool resolves to the
+    // original bytes, and true omission then means delete) — out of scope here.
+    // A model-supplied entry for an ORIGINAL binary path cannot be trusted: the
+    // prompt exposed only a placeholder, never those bytes. Preserve the original
+    // until a future explicit binary replacement/delete protocol exists. New
+    // binary paths are still allowed when their returned content validates.
+    const returnedFiles = normalizeGeneratedFiles(component.files).filter((file) => !originalBinaryPaths.has(file.path));
+    const carriedBinaries = originalFiles
+        .filter((f) => !isTextFile(f))
+        .map((f) => ({
+        path: f.path,
+        content: f.content,
+        mimeType: f.mimeType,
+        encoding: "base64",
+    }));
+    const files = [...returnedFiles, ...carriedBinaries];
+    // AC5 — unified diff (informational) from originals → updated, by path. Built
+    // from the merged `files` so carried-forward binaries (identical on both sides)
+    // are excluded, while genuine text edits still surface.
+    const originalsByPath = new Map(originalFiles.map((f) => [f.path, f.content]));
+    const updatedByPath = new Map(files.map((f) => [f.path, f.content]));
+    const diff = buildUnifiedDiff(originalsByPath, updatedByPath);
+    // AC8 — per-call structured log.
+    logStderr({
+        event: "refine",
+        ok: true,
+        componentName: component.componentName,
+        hasRegion,
+        model: parsed.model,
+        promptTokens: usage.promptTokens,
+        completionTokens: usage.completionTokens,
+        latencyMs,
+        promptVersion: systemPrompt.version,
+        attempts,
+    });
+    return {
+        componentName: component.componentName,
+        group: component.group,
+        diff,
+        files,
+        manifestEntry: component.manifestEntry,
+        usage,
+    };
+}
+// ── MCP registration ──────────────────────────────────────────────────────────
+const refineOutputShape = {
+    componentName: z.string(),
+    group: z.string(),
+    diff: z.string(),
+    files: z.array(z
+        .object({
+        path: z.string(),
+        content: z.string(),
+        mimeType: z.string(),
+        encoding: z.enum(["utf-8", "base64"]),
+    })
+        .strict()),
+    manifestEntry: z
+        .object({
+        viewport: z.object({ width: z.number(), height: z.number() }).strict(),
+        subtitle: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    })
+        .strict(),
+    usage: z
+        .object({
+        promptTokens: z.number().int().min(0),
+        completionTokens: z.number().int().min(0),
+        totalTokens: z.number().int().min(0),
+    })
+        .strict(),
+};
+export function registerRefineTool(server, deps) {
+    server.registerTool(REFINE_TOOL_NAME, {
+        title: "Refine component",
+        description: "Iterate on an existing component in a UI kit. Takes a free-form instruction " +
+            '(e.g. "make the border radius softer") and an optional region { x, y, w, h } rect ' +
+            'for a canvas-style "fix this element" edit, and returns a unified diff plus the full ' +
+            "updated files (the files are the source of truth; the diff is informational). Loads the " +
+            "component's current source from the kit, validates the model's reply against " +
+            "COMPONENT_SCHEMA (retried once on a validation failure), and — when a region is given — " +
+            "attaches a rendered crop of it as a visual reference. Reach for this to adjust a " +
+            "component already written to the kit (typically after conjure → write_files → preview); " +
+            "`design-default` is the valid gateway routing alias. Persist the returned files via " +
+            "plan, mapping each {path, content, mimeType, encoding} to write_files " +
+            "{path, data: content, mimeType, encoding}, before previewing.",
+        inputSchema: refineInputShape,
+        outputSchema: refineOutputShape,
+    }, async (args) => {
+        try {
+            const result = await refine(deps, args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            if (error instanceof RefineError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                code: error.code,
+                                message: error.message,
+                                ...(error.details ? { details: error.details } : {}),
+                            }),
+                        },
+                    ],
+                };
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=refine.js.map

package/dist/tools/refine.js.map

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

package/dist/tools/validate.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Registry } from "prom-client";
+import { type FullScanKitStore, type FullScanResult, type Renderer } from "../validate/index.js";
+/** Input schema for validate (counter-persistence facet). */
+declare const countsSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    bad: z.ZodNumber;
+    thin: z.ZodNumber;
+    variantsIdentical: z.ZodNumber;
+    iterations: z.ZodNumber;
+}, z.core.$strip>;
+type ValidateCounts = z.infer<typeof countsSchema>;
+/**
+ * Prometheus metrics registry and counters.
+ * Exposed as a module singleton so M6-01 can register it with the HTTP endpoint.
+ */
+export declare const metricsRegistry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+/**
+ * Persist validation counts to a timestamped JSON report file.
+ *
+ * @param reportsDir - Directory where reports are stored (.genie/reports)
+ * @param kitId - Kit identifier
+ * @param counts - Validation counts to persist
+ * @returns The path to the created report file
+ */
+export declare function persistReport(reportsDir: string, kitId: string, counts: ValidateCounts): Promise<string>;
+/**
+ * Emit Prometheus metrics for the given validation counts.
+ *
+ * @param kitId - Kit identifier (used as metric label)
+ * @param counts - Validation counts to emit
+ */
+export declare function emitMetrics(kitId: string, counts: ValidateCounts): void;
+/**
+ * Derive the M1-12 counter shape from a full-scan result (AC8: the full-scan
+ * facet persists its run via the SAME `persistReport`/`emitMetrics` path as the
+ * counter facet). `iterations` is 1 — a single scan pass — and the four
+ * validation dimensions come straight off the scan. `bad` is the scan's own
+ * literal sum (`markerMissing + thin + variantsIdentical`).
+ */
+export declare function countsFromScan(result: FullScanResult): ValidateCounts;
+/** Options for {@link registerValidate}. */
+export interface RegisterValidateOptions {
+    /** Where the counter facet + full-scan facet persist their JSON reports.
+     * Defaults to `GENIE_REPORTS_DIR` / `.genie/reports`. */
+    reportsDir?: string;
+    /**
+     * The kit read-port the full-scan facet walks (`listFiles`/`readFile`). When
+     * omitted, the full-scan facet is unavailable and a no-`counts` call returns a
+     * typed error — the counter-persistence facet still works standalone (so a
+     * deployment that only uses telemetry needs no store wired here). `server.ts`
+     * passes the shared `kitStore`.
+     */
+    kitStore?: FullScanKitStore;
+    /**
+     * Factory for the one headless renderer the full-scan facet reuses across a
+     * scan (AC7). Defaults to {@link createDefaultRenderer} (lazy Playwright,
+     * `null` when unavailable → the scan degrades to marker-only). Injectable so
+     * tests supply a stub and never launch a browser.
+     */
+    createRenderer?: () => Promise<Renderer | null>;
+}
+/**
+ * Register the `mcp__genie__validate` tool on the given MCP server (both
+ * facets — see the module header).
+ *
+ * Backward-compatible call shape: `registerValidate(server, reportsDir?)` still
+ * works (the M1-12 wiring), and `registerValidate(server, options)` opts into
+ * the full-scan facet by supplying a `kitStore`.
+ */
+export declare function registerValidate(server: McpServer, reportsDirOrOptions?: string | RegisterValidateOptions): void;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAW,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAE9B,6DAA6D;AAC7D,QAAA,MAAM,YAAY;;;;;;iBAMhB,CAAC;AAuBH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,sDAAiB,CAAC;AAqC9C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAMvE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAQrE;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC;6DACyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,mBAAmB,CAAC,EAAE,MAAM,GAAG,uBAAuB,GACrD,IAAI,CAuFN"}