@synctek/forgeos 2.0.0 → 2.1.0

package/dist/client.d.ts

@@ -1,46 +0,0 @@
-/**
- * ForgeOS Engine HTTP client.
- * Thin wrapper over fetch() that calls the ForgeOS Engine REST API.
- *
- * Board Conditions (Engineering Director):
- * - 10-second timeout per request (AbortController)
- * - One automatic retry on network errors (fetch failures, not HTTP errors)
- * - X-ForgeOS-API-Key header when apiKey is provided
- *
- * Design note: API key is accepted only as a constructor parameter.
- * The module-level singleton `client` uses env vars for backward-compat
- * with the stdio transport. The HTTP transport creates per-request instances
- * with the key threaded from the Authorization header — no env mutation.
- */
-export declare class ForgeOSClient {
-    private baseUrl;
-    private apiKey;
-    /**
-     * @param baseUrl  Engine base URL. Defaults to FORGEOS_ENGINE_URL env var or http://localhost:8400.
-     * @param apiKey   API key to send as X-ForgeOS-API-Key. Pass explicitly; do NOT read from env here.
-     */
-    constructor(baseUrl?: string, apiKey?: string);
-    /** Build common headers for every request. */
-    private headers;
-    /**
-     * Core fetch wrapper with timeout and retry.
-     * - Aborts after REQUEST_TIMEOUT_MS via AbortController.
-     * - Retries once on network errors (TypeError from fetch).
-     * - Does NOT retry on HTTP error responses (4xx/5xx) or timeouts.
-     */
-    private fetchWithRetry;
-    /** Parse a non-ok response into a descriptive error. */
-    private throwHttpError;
-    get(path: string, params?: Record<string, string>): Promise<unknown>;
-    post(path: string, body?: unknown): Promise<unknown>;
-    patch(path: string, body?: unknown): Promise<unknown>;
-    put(path: string, body?: unknown): Promise<unknown>;
-}
-/**
- * Module-level singleton for the stdio transport path.
- * Reads FORGEOS_API_KEY from env at startup — safe because stdio is
- * single-tenant (one process = one user). The HTTP transport MUST NOT
- * use this singleton; it must construct per-request ForgeOSClient instances.
- */
-export declare const client: ForgeOSClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAkBH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK7C,8CAA8C;IAC9C,OAAO,CAAC,OAAO;IAQf;;;;;OAKG;YACW,cAAc;IA6C5B,wDAAwD;YAC1C,cAAc;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAU1D;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,eAGlB,CAAC"}

package/dist/client.js

@@ -1,146 +0,0 @@
-/**
- * ForgeOS Engine HTTP client.
- * Thin wrapper over fetch() that calls the ForgeOS Engine REST API.
- *
- * Board Conditions (Engineering Director):
- * - 10-second timeout per request (AbortController)
- * - One automatic retry on network errors (fetch failures, not HTTP errors)
- * - X-ForgeOS-API-Key header when apiKey is provided
- *
- * Design note: API key is accepted only as a constructor parameter.
- * The module-level singleton `client` uses env vars for backward-compat
- * with the stdio transport. The HTTP transport creates per-request instances
- * with the key threaded from the Authorization header — no env mutation.
- */
-const ENGINE_URL = process.env.FORGEOS_ENGINE_URL || "http://localhost:8400";
-const REQUEST_TIMEOUT_MS = 10_000;
-const MAX_RETRIES = 1;
-/** Check if an error is a network-level failure (not an HTTP status error). */
-function isNetworkError(err) {
-    if (err instanceof TypeError)
-        return true; // fetch throws TypeError for network issues
-    if (err instanceof DOMException && err.name === "AbortError")
-        return false; // timeout — do not retry
-    return false;
-}
-/** Small delay for retry backoff. */
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export class ForgeOSClient {
-    baseUrl;
-    apiKey;
-    /**
-     * @param baseUrl  Engine base URL. Defaults to FORGEOS_ENGINE_URL env var or http://localhost:8400.
-     * @param apiKey   API key to send as X-ForgeOS-API-Key. Pass explicitly; do NOT read from env here.
-     */
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = (baseUrl || ENGINE_URL).replace(/\/+$/, "");
-        this.apiKey = apiKey ?? "";
-    }
-    /** Build common headers for every request. */
-    headers(extra) {
-        const h = { ...extra };
-        if (this.apiKey) {
-            h["X-ForgeOS-API-Key"] = this.apiKey;
-        }
-        return h;
-    }
-    /**
-     * Core fetch wrapper with timeout and retry.
-     * - Aborts after REQUEST_TIMEOUT_MS via AbortController.
-     * - Retries once on network errors (TypeError from fetch).
-     * - Does NOT retry on HTTP error responses (4xx/5xx) or timeouts.
-     */
-    async fetchWithRetry(url, init) {
-        let lastError;
-        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-            const controller = new AbortController();
-            const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-            try {
-                const res = await fetch(url, {
-                    ...init,
-                    signal: controller.signal,
-                });
-                clearTimeout(timer);
-                return res;
-            }
-            catch (err) {
-                clearTimeout(timer);
-                lastError = err;
-                // Only retry on network errors, not on timeouts or other issues
-                if (isNetworkError(err) && attempt < MAX_RETRIES) {
-                    await delay(500);
-                    continue;
-                }
-                // Timeout — throw a clearer message
-                if (err instanceof DOMException && err.name === "AbortError") {
-                    throw new Error(`Request timed out after ${REQUEST_TIMEOUT_MS}ms: ${init.method ?? "GET"} ${url}`);
-                }
-                throw err;
-            }
-        }
-        // Should not reach here, but safety net
-        throw lastError;
-    }
-    /** Parse a non-ok response into a descriptive error. */
-    async throwHttpError(res) {
-        const text = await res.text().catch(() => "(unreadable body)");
-        throw new Error(`${res.status} ${res.statusText}: ${text}`);
-    }
-    async get(path, params) {
-        let url = `${this.baseUrl}${path}`;
-        if (params) {
-            const searchParams = new URLSearchParams(params);
-            url += `?${searchParams.toString()}`;
-        }
-        const res = await this.fetchWithRetry(url, {
-            method: "GET",
-            headers: this.headers(),
-        });
-        if (!res.ok)
-            await this.throwHttpError(res);
-        return res.json();
-    }
-    async post(path, body) {
-        const url = `${this.baseUrl}${path}`;
-        const res = await this.fetchWithRetry(url, {
-            method: "POST",
-            headers: this.headers({ "Content-Type": "application/json" }),
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-        });
-        if (!res.ok)
-            await this.throwHttpError(res);
-        return res.json();
-    }
-    async patch(path, body) {
-        const url = `${this.baseUrl}${path}`;
-        const res = await this.fetchWithRetry(url, {
-            method: "PATCH",
-            headers: this.headers({ "Content-Type": "application/json" }),
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-        });
-        if (!res.ok)
-            await this.throwHttpError(res);
-        return res.json();
-    }
-    async put(path, body) {
-        const url = `${this.baseUrl}${path}`;
-        const res = await this.fetchWithRetry(url, {
-            method: "PUT",
-            headers: this.headers({ "Content-Type": "application/json" }),
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-        });
-        if (!res.ok)
-            await this.throwHttpError(res);
-        return res.json();
-    }
-}
-/**
- * Module-level singleton for the stdio transport path.
- * Reads FORGEOS_API_KEY from env at startup — safe because stdio is
- * single-tenant (one process = one user). The HTTP transport MUST NOT
- * use this singleton; it must construct per-request ForgeOSClient instances.
- */
-export const client = new ForgeOSClient(process.env.FORGEOS_ENGINE_URL, process.env.FORGEOS_API_KEY);
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/handlers.d.ts

@@ -1,11 +0,0 @@
-import { ForgeOSClient } from "./client.js";
-declare function ok(data: unknown): {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-};
-export declare function createHandleTool(forgeClient: ForgeOSClient): (name: string, rawArgs: Record<string, unknown>) => Promise<ReturnType<typeof ok>>;
-export declare function handleTool(name: string, rawArgs: Record<string, unknown>): Promise<ReturnType<typeof ok>>;
-export {};
-//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,aAAa,EAAE,MAAM,aAAa,CAAC;AAMrE,iBAAS,EAAE,CAAC,IAAI,EAAE,OAAO;;;;;EAMxB;AA2JD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,aAAa,GACzB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAEpF;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAEhC"}

package/dist/handlers.js

@@ -1,424 +0,0 @@
-import { z } from "zod";
-import { client as defaultClient } from "./client.js";
-// ---------------------------------------------------------------------------
-// Response helpers
-// ---------------------------------------------------------------------------
-function ok(data) {
-    return {
-        content: [
-            { type: "text", text: JSON.stringify(data, null, 2) },
-        ],
-    };
-}
-function fail(error) {
-    return {
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify({ ok: false, error }, null, 2),
-            },
-        ],
-        isError: true,
-    };
-}
-// ---------------------------------------------------------------------------
-// Input schemas (Zod validation)
-// ---------------------------------------------------------------------------
-const InitArgs = z.object({
-    project_id: z.string(),
-    developer_id: z.string().optional().default("local"),
-});
-const CreateInitiativeArgs = z.object({
-    project_id: z.string(),
-    title: z.string(),
-    description: z.string(),
-    priority: z
-        .enum(["low", "medium", "high", "critical"])
-        .optional()
-        .default("medium"),
-});
-const ProposeChangesetArgs = z.object({
-    project_id: z.string(),
-    initiative_id: z.string(),
-    description: z.string(),
-    files_changed: z.array(z.string()),
-    modules_affected: z.array(z.string()),
-    branch: z.string().optional(),
-});
-const GetProfileArgs = z.object({
-    role: z.string(),
-    project_id: z.string().optional(),
-    team_id: z.string().optional().default("default"),
-    modules_affected: z.array(z.string()).optional(),
-    files_changed: z.array(z.string()).optional(),
-});
-const SubmitEvidenceArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-    type: z.string(),
-    summary: z.string(),
-    file_refs: z.array(z.string()).optional().default([]),
-});
-const SubmitReviewArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-    role: z.string(),
-    status: z.enum(["approved", "blocked", "pending"]),
-    notes: z.string(),
-    findings: z.array(z.object({
-        category: z.string(),
-        severity: z.string(),
-        observation: z.string(),
-        recommendation: z.string().optional(),
-    })),
-});
-const CheckGatesArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-});
-const PromoteGateArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-    gate_id: z.string(),
-    promoted_by: z.string().optional().default("local_agent"),
-});
-const ReleaseCheckArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-});
-const QueryMindArgs = z.object({
-    team_id: z.string().optional().default("default"),
-    context: z.string(),
-    domain: z.string().optional(),
-});
-const ObserveArgs = z.object({
-    team_id: z.string().optional().default("default"),
-    domain: z.string(),
-    observation_type: z.string(),
-    content: z.string(),
-    confidence: z.number().optional().default(0.8),
-    tags: z.array(z.string()).optional().default([]),
-});
-const GetWorkflowArgs = z.object({
-    initiative_id: z.string(),
-});
-const CreateProjectArgs = z.object({
-    name: z.string().min(1),
-    description: z.string().optional(),
-    platform: z
-        .enum(["web", "mobile", "api", "cli", "desktop", "other"])
-        .optional(),
-});
-const QuickstartArgs = z.object({});
-const DiscoverArgs = z.object({
-    languages: z.array(z.string()).optional().default([]),
-    ci_tools: z.array(z.string()).optional().default([]),
-    test_frameworks: z.array(z.string()).optional().default([]),
-    team_size: z.number().optional(),
-    repo_type: z.string().optional(),
-});
-const GetPresetsArgs = z.object({});
-const ConfigureProjectGatesArgs = z.object({
-    project_id: z.string(),
-    preset: z.string().optional(),
-    custom_template: z.record(z.string(), z.unknown()).optional(),
-});
-const RecommendGatesArgs = z.object({
-    project_id: z.string(),
-    changeset_id: z.string(),
-});
-const ScorecardArgs = z.object({});
-const WorkflowTemplateArgs = z.object({
-    template_id: z.string().optional(),
-});
-// ---------------------------------------------------------------------------
-// Handler factory — returns a bound handleTool for the given client.
-// Use createHandleTool(client) in the HTTP transport so each request uses
-// its own ForgeOSClient carrying the per-request API key.
-// The plain handleTool export exists for the stdio transport (uses the
-// module-level singleton).
-// ---------------------------------------------------------------------------
-export function createHandleTool(forgeClient) {
-    return (name, rawArgs) => _handleTool(name, rawArgs, forgeClient);
-}
-export async function handleTool(name, rawArgs) {
-    return _handleTool(name, rawArgs, defaultClient);
-}
-async function _handleTool(name, rawArgs, client) {
-    switch (name) {
-        // -----------------------------------------------------------------
-        // forge_init — GET /api/bootstrap?project_id=...&developer_id=...
-        // Also fetches GET /api/sandbox/scorecard to include setup status.
-        // -----------------------------------------------------------------
-        case "forge_init": {
-            const a = InitArgs.parse(rawArgs);
-            const [bootstrap, scorecard] = await Promise.allSettled([
-                client.get("/api/bootstrap", {
-                    project_id: a.project_id,
-                    developer_id: a.developer_id,
-                }),
-                client.get("/api/sandbox/scorecard"),
-            ]);
-            const result = bootstrap.status === "fulfilled"
-                ? bootstrap.value
-                : { error: bootstrap.reason?.message };
-            result.setup_scorecard =
-                scorecard.status === "fulfilled"
-                    ? scorecard.value
-                    : { error: scorecard.reason?.message };
-            return ok(result);
-        }
-        // -----------------------------------------------------------------
-        // forge_create_initiative — POST /api/projects/{project_id}/initiatives
-        // -----------------------------------------------------------------
-        case "forge_create_initiative": {
-            const a = CreateInitiativeArgs.parse(rawArgs);
-            const data = await client.post(`/api/projects/${a.project_id}/initiatives`, { title: a.title, description: a.description, priority: a.priority });
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_propose_changeset — POST /api/projects/{project_id}/changesets
-        // After creating the changeset, also calls recommend-gates and merges
-        // the result so the caller has the full risk/gate analysis in one shot.
-        // -----------------------------------------------------------------
-        case "forge_propose_changeset": {
-            const a = ProposeChangesetArgs.parse(rawArgs);
-            const body = {
-                initiative_id: a.initiative_id,
-                description: a.description,
-                files_changed: a.files_changed,
-                modules_affected: a.modules_affected,
-            };
-            if (a.branch)
-                body.branch = a.branch;
-            const changeset = (await client.post(`/api/projects/${a.project_id}/changesets`, body));
-            // Extract changeset id — engine may return it at various keys
-            const csId = changeset.id ??
-                changeset.changeset_id;
-            let recommendation = null;
-            if (csId) {
-                const rec = await (async () => {
-                    try {
-                        return await client.post(`/api/projects/${a.project_id}/changesets/${csId}/recommend-gates`);
-                    }
-                    catch {
-                        return null;
-                    }
-                })();
-                recommendation = rec;
-            }
-            return ok({ ...changeset, gate_recommendation: recommendation });
-        }
-        // -----------------------------------------------------------------
-        // forge_get_profile
-        //   Base:          GET  /api/profiles/{role}
-        //   Contextualized: POST /api/profiles/contextualize
-        // -----------------------------------------------------------------
-        case "forge_get_profile": {
-            const a = GetProfileArgs.parse(rawArgs);
-            if (a.project_id) {
-                // Contextualized profile with Shared Mind data
-                const data = await client.post("/api/profiles/contextualize", {
-                    role: a.role,
-                    project_id: a.project_id,
-                    team_id: a.team_id,
-                    modules_affected: a.modules_affected || [],
-                    files_changed: a.files_changed || [],
-                });
-                return ok(data);
-            }
-            else {
-                // Base profile (no project context)
-                const data = await client.get(`/api/profiles/${a.role}`);
-                return ok(data);
-            }
-        }
-        // -----------------------------------------------------------------
-        // forge_submit_evidence
-        //   POST /api/projects/{project_id}/changesets/{changeset_id}/evidence
-        // -----------------------------------------------------------------
-        case "forge_submit_evidence": {
-            const a = SubmitEvidenceArgs.parse(rawArgs);
-            const data = await client.post(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/evidence`, {
-                type: a.type,
-                summary: a.summary,
-                file_refs: a.file_refs,
-            });
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_submit_review
-        //   POST /api/projects/{project_id}/changesets/{changeset_id}/reviews/complete
-        // -----------------------------------------------------------------
-        case "forge_submit_review": {
-            const a = SubmitReviewArgs.parse(rawArgs);
-            const data = await client.post(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/reviews/complete`, {
-                role: a.role,
-                status: a.status,
-                notes: a.notes,
-                findings: a.findings,
-                reviewer_type: "ai_agent",
-                reviewer_id: `local_agent_${a.role}`,
-            });
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_check_gates
-        //   GET /api/projects/{project_id}/changesets/{changeset_id}/gates
-        // -----------------------------------------------------------------
-        case "forge_check_gates": {
-            const a = CheckGatesArgs.parse(rawArgs);
-            const data = await client.get(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/gates`);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_promote_gate
-        //   POST /api/projects/{project_id}/changesets/{changeset_id}/gates/{gate_id}/promote
-        // -----------------------------------------------------------------
-        case "forge_promote_gate": {
-            const a = PromoteGateArgs.parse(rawArgs);
-            const data = await client.post(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/gates/${a.gate_id}/promote`, { promoted_by: a.promoted_by });
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_release_check
-        //   GET /api/projects/{project_id}/changesets/{changeset_id}/release-check
-        // -----------------------------------------------------------------
-        case "forge_release_check": {
-            const a = ReleaseCheckArgs.parse(rawArgs);
-            const data = await client.get(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/release-check`);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_query_mind
-        //   GET /api/shared-mind/{team_id}/query?context=...&domain=...
-        //   (shared_mind router has prefix="/api/shared-mind" in its own
-        //    APIRouter, registered without additional prefix at app level)
-        // -----------------------------------------------------------------
-        case "forge_query_mind": {
-            const a = QueryMindArgs.parse(rawArgs);
-            const params = { context: a.context };
-            if (a.domain)
-                params.domain = a.domain;
-            const data = await client.get(`/api/shared-mind/${a.team_id}/query`, params);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_observe
-        //   POST /api/shared-mind/{team_id}/observe
-        // -----------------------------------------------------------------
-        case "forge_observe": {
-            const a = ObserveArgs.parse(rawArgs);
-            const data = await client.post(`/api/shared-mind/${a.team_id}/observe`, {
-                domain: a.domain,
-                source_agent: "forge_mcp_local",
-                observation_type: a.observation_type,
-                content: a.content,
-                confidence: a.confidence,
-                tags: a.tags,
-            });
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_get_workflow
-        //   GET /api/workflow/{initiative_id}
-        // -----------------------------------------------------------------
-        case "forge_get_workflow": {
-            const a = GetWorkflowArgs.parse(rawArgs);
-            const data = await client.get(`/api/workflow/${a.initiative_id}`);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_create_project — POST /api/projects
-        // -----------------------------------------------------------------
-        case "forge_create_project": {
-            const a = CreateProjectArgs.parse(rawArgs);
-            const body = { name: a.name };
-            if (a.description)
-                body.description = a.description;
-            if (a.platform)
-                body.platform = a.platform;
-            const data = await client.post("/api/projects", body);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_quickstart — POST /api/sandbox/quickstart
-        // -----------------------------------------------------------------
-        case "forge_quickstart": {
-            QuickstartArgs.parse(rawArgs);
-            const data = await client.post("/api/sandbox/quickstart");
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_discover — POST /api/sandbox/discover
-        // -----------------------------------------------------------------
-        case "forge_discover": {
-            const a = DiscoverArgs.parse(rawArgs);
-            const body = {
-                languages: a.languages,
-                ci_tools: a.ci_tools,
-                test_frameworks: a.test_frameworks,
-            };
-            if (a.team_size !== undefined)
-                body.team_size = a.team_size;
-            if (a.repo_type !== undefined)
-                body.repo_type = a.repo_type;
-            const data = await client.post("/api/sandbox/discover", body);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_get_presets — GET /api/gate-presets
-        // -----------------------------------------------------------------
-        case "forge_get_presets": {
-            GetPresetsArgs.parse(rawArgs);
-            const data = await client.get("/api/gate-presets");
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_configure_project_gates — PUT /api/projects/{id}/gate-template
-        // -----------------------------------------------------------------
-        case "forge_configure_project_gates": {
-            const a = ConfigureProjectGatesArgs.parse(rawArgs);
-            const body = {};
-            if (a.preset !== undefined)
-                body.preset = a.preset;
-            if (a.custom_template !== undefined)
-                body.custom_template = a.custom_template;
-            const data = await client.put(`/api/projects/${a.project_id}/gate-template`, body);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_recommend_gates
-        //   POST /api/projects/{project_id}/changesets/{changeset_id}/recommend-gates
-        // -----------------------------------------------------------------
-        case "forge_recommend_gates": {
-            const a = RecommendGatesArgs.parse(rawArgs);
-            const data = await client.post(`/api/projects/${a.project_id}/changesets/${a.changeset_id}/recommend-gates`);
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_scorecard — GET /api/sandbox/scorecard
-        // -----------------------------------------------------------------
-        case "forge_scorecard": {
-            ScorecardArgs.parse(rawArgs);
-            const data = await client.get("/api/sandbox/scorecard");
-            return ok(data);
-        }
-        // -----------------------------------------------------------------
-        // forge_workflow_template
-        //   GET /api/workflow-templates        (all)
-        //   GET /api/workflow-templates/{id}   (specific)
-        // -----------------------------------------------------------------
-        case "forge_workflow_template": {
-            const a = WorkflowTemplateArgs.parse(rawArgs);
-            const path = a.template_id
-                ? `/api/workflow-templates/${a.template_id}`
-                : "/api/workflow-templates";
-            const data = await client.get(path);
-            return ok(data);
-        }
-        default:
-            return fail(`Unknown tool: ${name}`);
-    }
-}
-//# sourceMappingURL=handlers.js.map