@testchimp/cli 0.1.33 → 0.1.35

package/dist/chimphands/run.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ChimpHands GitHub Actions bridge: bootstrap → OpenCode → inbound SSE turns.
+ * Relies on TESTCHIMP_API_KEY (+ optional TESTCHIMP_BACKEND_URL; defaults to prod).
+ * Does not write mcp.json — CLI/skill use process env.
+ */
+type RunOptions = {
+    sessionId: string;
+    prompt?: string;
+};
+export declare function runChimphands(opts: RunOptions): Promise<void>;
+export {};

package/dist/chimphands/run.js

@@ -0,0 +1,266 @@
+/**
+ * ChimpHands GitHub Actions bridge: bootstrap → OpenCode → inbound SSE turns.
+ * Relies on TESTCHIMP_API_KEY (+ optional TESTCHIMP_BACKEND_URL; defaults to prod).
+ * Does not write mcp.json — CLI/skill use process env.
+ */
+import { spawn, execFileSync } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import http from "node:http";
+import https from "node:https";
+import { URL } from "node:url";
+import { getBackendUrl, requireApiKey } from "../core/client.js";
+const ROLE_ASSISTANT = "CHIMPHANDS_MESSAGE_ROLE_ASSISTANT";
+const ROLE_TOOL = "CHIMPHANDS_MESSAGE_ROLE_TOOL";
+const ROLE_STATUS = "CHIMPHANDS_MESSAGE_ROLE_STATUS";
+const STATUS_RUNNING = "CHIMPHANDS_SESSION_STATUS_RUNNING";
+const STATUS_WAITING_USER = "CHIMPHANDS_SESSION_STATUS_WAITING_USER";
+const STATUS_IDLE = "CHIMPHANDS_SESSION_STATUS_IDLE";
+const STATUS_FAILED = "CHIMPHANDS_SESSION_STATUS_FAILED";
+function apiHeaders(apiKey) {
+    return {
+        "Content-Type": "application/json",
+        "TestChimp-Api-Key": apiKey,
+    };
+}
+async function postJson(backend, apiKey, path, body) {
+    const res = await fetch(`${backend}${path}`, {
+        method: "POST",
+        headers: apiHeaders(apiKey),
+        body: JSON.stringify(body ?? {}),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        throw new Error(`ChimpHands API ${res.status} ${path}: ${text}`);
+    }
+    return text;
+}
+function postJsonFireAndForget(backend, apiKey, path, body) {
+    void postJson(backend, apiKey, path, body).catch(() => {
+        /* best-effort agent telemetry */
+    });
+}
+function writeOpencodeConfig(backend, apiKey, boot) {
+    const llmBase = (boot.llm_base_url || `${backend}/v1`).replace(/\/$/, "");
+    const llmKey = apiKey || boot.llm_api_key || "";
+    const llmModel = boot.llm_model || "gpt-4o-mini";
+    writeFileSync("opencode.json", JSON.stringify({
+        model: llmModel,
+        provider: {
+            openai: {
+                apiKey: llmKey,
+                baseURL: llmBase,
+            },
+        },
+    }, null, 2));
+}
+function runOpencode(prompt, childEnv, postEvent) {
+    const help = (() => {
+        try {
+            return execFileSync("opencode", ["run", "--help"], { encoding: "utf8", env: childEnv });
+        }
+        catch {
+            return "";
+        }
+    })();
+    const useJson = help.includes("--format");
+    if (useJson) {
+        const child = spawn("opencode", ["run", prompt, "--format", "json"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: childEnv,
+        });
+        let err = "";
+        child.stderr.on("data", (d) => {
+            err += d.toString();
+        });
+        return new Promise((resolve) => {
+            let buf = "";
+            child.stdout.on("data", (chunk) => {
+                buf += chunk.toString();
+                const lines = buf.split("\n");
+                buf = lines.pop() || "";
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    let content = line;
+                    let role = ROLE_ASSISTANT;
+                    try {
+                        const ev = JSON.parse(line);
+                        content = ev.content || ev.message || ev.text || JSON.stringify(ev);
+                        if (ev.type === "tool" || ev.role === "tool")
+                            role = ROLE_TOOL;
+                        if (ev.type === "status")
+                            role = ROLE_STATUS;
+                    }
+                    catch {
+                        /* plain line */
+                    }
+                    postEvent(role, content);
+                }
+            });
+            child.on("close", (code) => {
+                if (buf.trim())
+                    postEvent(ROLE_ASSISTANT, buf.trim());
+                resolve({ code: code == null ? 1 : code, err });
+            });
+        });
+    }
+    try {
+        const out = execFileSync("opencode", ["run", prompt], {
+            encoding: "utf8",
+            maxBuffer: 20 * 1024 * 1024,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: childEnv,
+        });
+        if (out)
+            postEvent(ROLE_ASSISTANT, out);
+        return Promise.resolve({ code: 0, err: "" });
+    }
+    catch (e) {
+        const errObj = e;
+        const err = (errObj.stderr && errObj.stderr.toString()) || errObj.message || "opencode failed";
+        return Promise.resolve({ code: errObj.status || 1, err });
+    }
+}
+function connectInbound(backend, apiKey, sessionId, onUserMessage, onIdle, onClosed) {
+    const url = new URL(`${backend}/api/chimphands/sessions/${encodeURIComponent(sessionId)}/inbound`);
+    const lib = url.protocol === "https:" ? https : http;
+    const req = lib.request({
+        hostname: url.hostname,
+        port: url.port || (url.protocol === "https:" ? 443 : 80),
+        path: url.pathname + url.search,
+        method: "GET",
+        headers: {
+            "TestChimp-Api-Key": apiKey,
+            Accept: "text/event-stream",
+            "Cache-Control": "no-cache",
+        },
+    }, (res) => {
+        let buf = "";
+        let eventName = "message";
+        res.on("data", (chunk) => {
+            buf += chunk.toString();
+            const parts = buf.split("\n");
+            buf = parts.pop() || "";
+            for (const line of parts) {
+                if (line.startsWith("event:")) {
+                    eventName = line.slice(6).trim() || "message";
+                }
+                else if (line.startsWith("data:")) {
+                    const data = line.slice(5).trim();
+                    if (eventName === "idle") {
+                        onIdle();
+                    }
+                    else if (eventName === "user_message" || eventName === "message") {
+                        try {
+                            const msg = JSON.parse(data);
+                            const content = msg.content || "";
+                            if (content)
+                                onUserMessage(content);
+                        }
+                        catch {
+                            /* ignore */
+                        }
+                    }
+                    eventName = "message";
+                }
+                else if (line === "") {
+                    eventName = "message";
+                }
+            }
+        });
+        res.on("end", () => onClosed());
+    });
+    req.on("error", () => onClosed());
+    req.end();
+}
+export async function runChimphands(opts) {
+    const apiKey = requireApiKey();
+    const backend = getBackendUrl();
+    // Ensure child processes see the resolved backend (prod default when unset).
+    process.env.TESTCHIMP_BACKEND_URL = backend;
+    const sessionId = (opts.sessionId || process.env.SESSION_ID || "").trim();
+    if (!sessionId) {
+        throw new Error("session_id is required (pass --session-id or SESSION_ID)");
+    }
+    const promptInput = (opts.prompt ?? process.env.PROMPT ?? "").trim();
+    const bootText = await postJson(backend, apiKey, "/api/chimphands/bootstrap", {
+        session_id: sessionId,
+    });
+    const boot = JSON.parse(bootText);
+    const userId = boot.chimphands_service_account_user_id || "";
+    if (userId) {
+        process.env.TESTCHIMP_USER_ID = userId;
+    }
+    mkdirSync(".opencode", { recursive: true });
+    writeOpencodeConfig(backend, apiKey, boot);
+    const idleMs = (Number(boot.idle_timeout_seconds) || 600) * 1000;
+    const queue = [];
+    let idle = false;
+    let closed = false;
+    let lastUserActivity = Date.now();
+    const postEvent = (role, content, status) => {
+        const body = {
+            session_id: sessionId,
+            role,
+            content: String(content || "").slice(0, 20000),
+        };
+        if (status != null)
+            body.status = status;
+        postJsonFireAndForget(backend, apiKey, "/api/chimphands/post_agent_event", body);
+    };
+    const complete = (status, errorMessage) => {
+        const body = { session_id: sessionId, status };
+        if (errorMessage)
+            body.error_message = String(errorMessage).slice(0, 4000);
+        postJsonFireAndForget(backend, apiKey, "/api/chimphands/complete_session", body);
+    };
+    const childEnv = {
+        ...process.env,
+        TESTCHIMP_API_KEY: apiKey,
+        TESTCHIMP_BACKEND_URL: backend,
+    };
+    if (userId)
+        childEnv.TESTCHIMP_USER_ID = userId;
+    connectInbound(backend, apiKey, sessionId, (content) => {
+        queue.push(content);
+        lastUserActivity = Date.now();
+    }, () => {
+        idle = true;
+    }, () => {
+        closed = true;
+    });
+    postEvent(ROLE_STATUS, "Agent ready", STATUS_RUNNING);
+    let prompt = promptInput || boot.initial_prompt || "";
+    if (boot.conversation_summary) {
+        prompt = `Conversation so far:\n${boot.conversation_summary}\n\nCurrent task:\n${prompt}`;
+    }
+    for (const m of boot.pending_user_messages || []) {
+        if (m?.content)
+            queue.push(m.content);
+    }
+    const waitForNextPrompt = () => new Promise((resolve) => {
+        const tick = () => {
+            if (queue.length) {
+                resolve(queue.shift());
+                return;
+            }
+            if (idle || closed || Date.now() - lastUserActivity >= idleMs) {
+                resolve(null);
+                return;
+            }
+            setTimeout(tick, 500);
+        };
+        tick();
+    });
+    while (prompt) {
+        const result = await runOpencode(prompt, childEnv, postEvent);
+        if (result.code !== 0) {
+            complete(STATUS_FAILED, result.err || "opencode failed");
+            process.exitCode = result.code || 1;
+            return;
+        }
+        postEvent(ROLE_STATUS, "Waiting for user input", STATUS_WAITING_USER);
+        prompt = (await waitForNextPrompt()) || "";
+    }
+    complete(STATUS_IDLE);
+}

package/dist/cli/program.js

@@ -609,6 +609,60 @@ export function buildCliProgram() {
         const out = await runTool("update-test-scenario", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("get-project-init-status")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-project-init-status").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("get-project-init-status", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("update-project-init-status")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-project-init-status").description)
+        .addOption(jsonInputOption())
+        .option("--status-json <json>", "ProjectInitStatus JSON object")
+        .action(async (opts) => {
+        let status;
+        if (opts.statusJson) {
+            status = JSON.parse(String(opts.statusJson));
+        }
+        const body = {};
+        if (status != null)
+            body.status = status;
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("update-project-init-status", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("get-git-folder-mapping")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-git-folder-mapping").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("get-git-folder-mapping", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("update-git-folder-mapping")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-git-folder-mapping").description)
+        .addOption(jsonInputOption())
+        .option("--tests-folder-path <path>")
+        .option("--plans-folder-path <path>")
+        .option("--repository-full-name <name>")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.testsFolderPath)
+            body.tests_folder_path = opts.testsFolderPath;
+        if (opts.plansFolderPath)
+            body.plans_folder_path = opts.plansFolderPath;
+        if (opts.repositoryFullName)
+            body.repository_full_name = opts.repositoryFullName;
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("update-git-folder-mapping", merged, { postMcp });
+        console.log(out);
+    });
     program
         .command("get-eaas-config")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-eaas-config").description)
@@ -1507,6 +1561,26 @@ export function buildCliProgram() {
             body.limit = opts.limit;
         console.log(await runTool("list-api-operation-interactions", mergeBodies(body, opts.jsonInput), { postMcp }));
     });
+    const chimphands = program.command("chimphands").description("ChimpHands GitHub Actions agent bridge");
+    chimphands
+        .command("run")
+        .description("Bootstrap session, configure OpenCode, and run the interactive bridge")
+        .option("--session-id <id>", "ChimpHands session id (or SESSION_ID env)")
+        .option("--prompt <text>", "Initial prompt (or PROMPT env)")
+        .action(async (opts) => {
+        const { runChimphands } = await import("../chimphands/run.js");
+        try {
+            await runChimphands({
+                sessionId: String(opts.sessionId || process.env.SESSION_ID || "").trim(),
+                prompt: opts.prompt != null ? String(opts.prompt) : undefined,
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`[testchimp chimphands] ${msg}`);
+            process.exitCode = 1;
+        }
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/schemas.d.ts

@@ -439,6 +439,340 @@ export declare const createIssueInput: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const emptyInput: z.ZodObject<{}, z.core.$strip>;
+export declare const projectInitStatusSchema: z.ZodObject<{
+    platformComms: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    folderMapping: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    connectToTestEnv: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    ciWiring: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    importPlans: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    importTests: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    smokeValidation: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    overallComplete: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    platform_comms: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    folder_mapping: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    connect_to_test_env: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    ci_wiring: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    import_plans: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    import_tests: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    smoke_validation: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+    overall_complete: z.ZodOptional<z.ZodEnum<{
+        PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+        PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+        PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+        PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+        INCOMPLETE: "INCOMPLETE";
+        DONE: "DONE";
+        SKIPPED: "SKIPPED";
+        NOT_APPLICABLE: "NOT_APPLICABLE";
+    }>>;
+}, z.core.$loose>;
+export declare const updateProjectInitStatusInput: z.ZodObject<{
+    status: z.ZodObject<{
+        platformComms: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        folderMapping: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        connectToTestEnv: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        ciWiring: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        importPlans: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        importTests: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        smokeValidation: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        overallComplete: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        platform_comms: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        folder_mapping: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        connect_to_test_env: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        ci_wiring: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        import_plans: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        import_tests: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        smoke_validation: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+        overall_complete: z.ZodOptional<z.ZodEnum<{
+            PROJECT_INIT_ITEM_STATUS_INCOMPLETE: "PROJECT_INIT_ITEM_STATUS_INCOMPLETE";
+            PROJECT_INIT_ITEM_STATUS_DONE: "PROJECT_INIT_ITEM_STATUS_DONE";
+            PROJECT_INIT_ITEM_STATUS_SKIPPED: "PROJECT_INIT_ITEM_STATUS_SKIPPED";
+            PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE: "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE";
+            INCOMPLETE: "INCOMPLETE";
+            DONE: "DONE";
+            SKIPPED: "SKIPPED";
+            NOT_APPLICABLE: "NOT_APPLICABLE";
+        }>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const updateGitFolderMappingInput: z.ZodObject<{
+    testsFolderPath: z.ZodOptional<z.ZodString>;
+    plansFolderPath: z.ZodOptional<z.ZodString>;
+    repositoryFullName: z.ZodOptional<z.ZodString>;
+    tests_folder_path: z.ZodOptional<z.ZodString>;
+    plans_folder_path: z.ZodOptional<z.ZodString>;
+    repository_full_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const getBranchSpecificEndpointConfigInput: z.ZodObject<{
     branchName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/core/schemas.js

@@ -246,6 +246,47 @@ export const createIssueInput = z.object({
     artifactReference: z.record(z.string(), z.unknown()).optional(),
 }).merge(agentTraceabilityFieldsSchema);
 export const emptyInput = z.object({});
+const projectInitItemStatusSchema = z.enum([
+    "PROJECT_INIT_ITEM_STATUS_INCOMPLETE",
+    "PROJECT_INIT_ITEM_STATUS_DONE",
+    "PROJECT_INIT_ITEM_STATUS_SKIPPED",
+    "PROJECT_INIT_ITEM_STATUS_NOT_APPLICABLE",
+    "INCOMPLETE",
+    "DONE",
+    "SKIPPED",
+    "NOT_APPLICABLE",
+]);
+export const projectInitStatusSchema = z
+    .object({
+    platformComms: projectInitItemStatusSchema.optional(),
+    folderMapping: projectInitItemStatusSchema.optional(),
+    connectToTestEnv: projectInitItemStatusSchema.optional(),
+    ciWiring: projectInitItemStatusSchema.optional(),
+    importPlans: projectInitItemStatusSchema.optional(),
+    importTests: projectInitItemStatusSchema.optional(),
+    smokeValidation: projectInitItemStatusSchema.optional(),
+    overallComplete: projectInitItemStatusSchema.optional(),
+    platform_comms: projectInitItemStatusSchema.optional(),
+    folder_mapping: projectInitItemStatusSchema.optional(),
+    connect_to_test_env: projectInitItemStatusSchema.optional(),
+    ci_wiring: projectInitItemStatusSchema.optional(),
+    import_plans: projectInitItemStatusSchema.optional(),
+    import_tests: projectInitItemStatusSchema.optional(),
+    smoke_validation: projectInitItemStatusSchema.optional(),
+    overall_complete: projectInitItemStatusSchema.optional(),
+})
+    .passthrough();
+export const updateProjectInitStatusInput = z.object({
+    status: projectInitStatusSchema,
+});
+export const updateGitFolderMappingInput = z.object({
+    testsFolderPath: z.string().min(1).optional(),
+    plansFolderPath: z.string().min(1).optional(),
+    repositoryFullName: z.string().optional(),
+    tests_folder_path: z.string().min(1).optional(),
+    plans_folder_path: z.string().min(1).optional(),
+    repository_full_name: z.string().optional(),
+});
 export const getBranchSpecificEndpointConfigInput = z.object({
     branchName: z.string().optional(),
 });

package/dist/core/tools.js

@@ -1390,6 +1390,46 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/compare_perf_to_baseline", body);
         },
     },
+    {
+        kebab: "get-project-init-status",
+        description: "Return project-init progress for the current project (platform comms, folder mapping, test env, CI, optional imports).",
+        inputSchema: S.emptyInput,
+        execute: async (_args, { postMcp }) => postMcp("/api/mcp/get_project_init_status", {}),
+    },
+    {
+        kebab: "update-project-init-status",
+        description: "Merge project-init progress fields for the current project. Server recomputes overall_complete when required items are DONE.",
+        inputSchema: S.updateProjectInitStatusInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/update_project_init_status", { status: a.status });
+        },
+    },
+    {
+        kebab: "get-git-folder-mapping",
+        description: "Return git provider, repository, and mapped plans/tests folder paths for the project.",
+        inputSchema: S.emptyInput,
+        execute: async (_args, { postMcp }) => postMcp("/api/mcp/get_git_folder_mapping", {}),
+    },
+    {
+        kebab: "update-git-folder-mapping",
+        description: "Update mapped plans/tests folder paths (and optional repository) on the platform. Agent scaffolds folders in a PR; this records platform mapping.",
+        inputSchema: S.updateGitFolderMappingInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            const tests = a.testsFolderPath ?? a.tests_folder_path;
+            const plans = a.plansFolderPath ?? a.plans_folder_path;
+            const repo = a.repositoryFullName ?? a.repository_full_name;
+            if (tests)
+                body.tests_folder_path = tests;
+            if (plans)
+                body.plans_folder_path = plans;
+            if (repo)
+                body.repository_full_name = repo;
+            return postMcp("/api/mcp/update_git_folder_mapping", body);
+        },
+    },
     {
         kebab: "list-related-perf-tests",
         description: "Find JOURNEY and, by default, COMPOSITE performance tests related to scenario titles and/or TestChimp ids.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testchimp/cli",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "TestChimp CLI and MCP server — coverage, plans, EaaS, TrueCoverage, API operations (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",