@loucompanion/forge-bridge 0.1.1-dev.03b8ba168599 → 0.1.1-dev.32d4dd5874ee

package/dist/cli/cli.service.d.ts

@@ -14,6 +14,10 @@ export declare function parseArgs(argv: readonly string[]): {
     readonly command: "run-once";
     readonly dispatchPath: string;
     readonly resultPath: string;
+} | {
+    readonly ok: true;
+    readonly command: "mcp";
+    readonly argv: readonly string[];
 } | {
     readonly ok: true;
     readonly command: "connect";

package/dist/cli/cli.service.js

@@ -4,10 +4,12 @@ import os from "node:os";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { promisify } from "node:util";
+import { resolveCursorAgentDirectLaunch } from "../shared/cursor-agent/cursor-agent.launch.js";
 import { redactSecrets, redactText } from "../shared/redaction/redaction.js";
 import { defaultBridgeServiceConfig, ForgeBridgeService } from "../bridge/bridge.service.js";
 import { addRepoMapping, applyLocalConfigDefaults, providerStatusesFor, readLocalConfigSync, removeRepoMapping, resolveLocalConfigPath, writeLocalConfig } from "./local-config.js";
 import { BridgeSessionService } from "../session/session.service.js";
+import { parseCompletionMcpArgs, runCompletionMcpServer } from "../session/phase-completion.js";
 import { failureResult, parseRunOnceDispatchPacket } from "../session/session.types.js";
 const apiKeySecretGrantEnv = "FORGE_API_KEY_SECRET_GRANT";
 const execFileAsync = promisify(execFile);
@@ -102,6 +104,15 @@ export class ForgeBridgeCliService {
         if (args.command === "cleanup") {
             return await cleanupRepos(args.config, args.mode, args.force, io);
         }
+        if (args.command === "mcp") {
+            const parsed = parseCompletionMcpArgs(args.argv);
+            if (!parsed.ok) {
+                io.stderr.write(`${parsed.error}\n`);
+                return 2;
+            }
+            await runCompletionMcpServer(parsed.config);
+            return 0;
+        }
         let redactionSecrets = readEnvSecretValuesForRedaction();
         try {
             const dispatchJson = await fs.readFile(args.dispatchPath, "utf8");
@@ -214,6 +225,9 @@ export function parseArgs(argv) {
     if (argv[0] === "cleanup") {
         return parseCleanupArgs(argv);
     }
+    if (argv[0] === "mcp") {
+        return { ok: true, command: "mcp", argv };
+    }
     if (argv[0] !== "run-once") {
         return {
             ok: false,
@@ -508,7 +522,7 @@ function normalizeServerUrl(serverUrl) {
     return serverUrl.endsWith("/") ? serverUrl : `${serverUrl}/`;
 }
 function usage() {
-    return "Usage: forge-bridge run-once --dispatch <dispatch-json-path> --result <result-json-path> | forge-bridge pair [code] [--server <url>] | forge-bridge connect --server <url> --runner-id <id> --device-token <token> | forge-bridge add-repo <label> <path> | forge-bridge remove-repo <label> | forge-bridge status [--check-updates] | forge-bridge cleanup [--stale|--merged|--all|--force]";
+    return "Usage: forge-bridge run-once --dispatch <dispatch-json-path> --result <result-json-path> | forge-bridge mcp --worktree <path> --work-item-id <id> --phase <phase> | forge-bridge pair [code] [--server <url>] | forge-bridge connect --server <url> --runner-id <id> --device-token <token> | forge-bridge add-repo <label> <path> | forge-bridge remove-repo <label> | forge-bridge status [--check-updates] | forge-bridge cleanup [--stale|--merged|--all|--force]";
 }
 async function writeJsonAtomic(outputPath, value) {
     await fs.mkdir(path.dirname(outputPath), { recursive: true });
@@ -620,6 +634,12 @@ function cliProbeCommandsFor(provider) {
     ];
 }
 async function execVersionCommand(probe, timeout = 2000) {
+    const directLaunch = process.platform === "win32"
+        ? await resolveCursorAgentDirectLaunch(probe.command, probe.args)
+        : null;
+    if (directLaunch) {
+        return await execFileAsync(directLaunch.command, [...directLaunch.args], { timeout });
+    }
     try {
         return await execFileAsync(probe.command, probe.args, { timeout });
     }

package/dist/session/index.d.ts

@@ -1,2 +1,4 @@
 export { BridgeSessionService } from "./session.service.js";
+export { buildCompletionToolServerArgs, codexMcpConfigArgs, completionPhaseFromDispatch, expectedCompletionToolName, prepareCompletionToolRuntime, readCompletionArtifact, writeCompletionArtifact } from "./phase-completion.js";
+export type { CompletionArtifactReference, CompletionPhase, CompletionToolRuntime } from "./phase-completion.js";
 export type { SessionService } from "./session.base.js";

package/dist/session/index.js

@@ -1 +1,2 @@
 export { BridgeSessionService } from "./session.service.js";
+export { buildCompletionToolServerArgs, codexMcpConfigArgs, completionPhaseFromDispatch, expectedCompletionToolName, prepareCompletionToolRuntime, readCompletionArtifact, writeCompletionArtifact } from "./phase-completion.js";

package/dist/session/internals.d.ts

@@ -1,4 +1,6 @@
 export { parseRunOnceDispatchPacket, failureResult } from "./session.types.js";
+export { buildCompletionToolServerArgs, codexMcpConfigArgs, completionPhaseFromDispatch, expectedCompletionToolName, prepareCompletionToolRuntime, readCompletionArtifact, writeCompletionArtifact } from "./phase-completion.js";
+export type { CompletionArtifactReference, CompletionPhase, CompletionToolRuntime } from "./phase-completion.js";
 export type { SessionEventSink, SessionService } from "./session.base.js";
 export type { ApiKeySecretGrant, DispatchCycleRun, DispatchExecution, DispatchLease, DispatchSession, DispatchRepo, DispatchServerLocalConfig, DispatchWorkItem, RunOnceDispatchPacket, RunOnceResultPacket, RunnerDispatchArtifact, RunnerDispatchEvent, RunnerDispatchSpec, RunnerEventLine } from "./session.types.js";
 export { DeterministicProviderCliService, ProcessBackedProviderCliService, RoutingProviderCliService, buildProviderCliCommand } from "./provider-cli/provider-cli.service.js";

package/dist/session/internals.js

@@ -1,2 +1,3 @@
 export { parseRunOnceDispatchPacket, failureResult } from "./session.types.js";
+export { buildCompletionToolServerArgs, codexMcpConfigArgs, completionPhaseFromDispatch, expectedCompletionToolName, prepareCompletionToolRuntime, readCompletionArtifact, writeCompletionArtifact } from "./phase-completion.js";
 export { DeterministicProviderCliService, ProcessBackedProviderCliService, RoutingProviderCliService, buildProviderCliCommand } from "./provider-cli/provider-cli.service.js";

package/dist/session/phase-completion.d.ts

@@ -0,0 +1,54 @@
+import type { RunOnceDispatchPacket, RunnerDispatchArtifact } from "./session.types.js";
+import type { WorktreeHandle } from "../worktree/worktree.types.js";
+export type CompletionPhase = "implementation" | "self_review" | "validation";
+export interface CompletionToolRuntime {
+    readonly serverName: string;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly cursorMcpConfigPath?: string | null;
+    cleanup(): Promise<void>;
+}
+export interface CompletionToolRuntimeOptions {
+    readonly dispatch: RunOnceDispatchPacket;
+    readonly worktree: WorktreeHandle;
+    readonly phase?: CompletionPhase;
+}
+export interface CompletionToolServerConfig {
+    readonly worktreePath: string;
+    readonly workItemId: string;
+    readonly phase: CompletionPhase;
+    readonly producedBy?: string;
+}
+export interface CompletionArtifactReference {
+    readonly phase: CompletionPhase;
+    readonly workItemId: string;
+    readonly repoPath: string;
+    readonly path: string;
+    readonly reportPath: string;
+    readonly contentHash: string;
+    readonly status: string;
+    readonly producedBy: string;
+}
+export declare function completionPhaseFromDispatch(dispatch: RunOnceDispatchPacket): CompletionPhase;
+export declare function normalizeCompletionPhase(value: string | null | undefined): CompletionPhase;
+export declare function completionToolNamesForPhase(phase: CompletionPhase): readonly string[];
+export declare function expectedCompletionToolName(phase: CompletionPhase): string;
+export declare function artifactRootFor(worktreePath: string, workItemId: string): string;
+export declare function completionArtifactJsonPath(worktreePath: string, workItemId: string, phase: CompletionPhase): string;
+export declare function completionArtifactReportPath(worktreePath: string, workItemId: string, phase: CompletionPhase): string;
+export declare function prepareCompletionToolRuntime(options: CompletionToolRuntimeOptions): Promise<CompletionToolRuntime>;
+export declare function buildCompletionToolServerArgs(config: CompletionToolServerConfig): readonly string[];
+export declare function codexMcpConfigArgs(runtime: CompletionToolRuntime): readonly string[];
+export declare function cursorMcpServerConfig(runtime: CompletionToolRuntime): unknown;
+export declare function completionPromptForPhase(phase: CompletionPhase): string;
+export declare function writeCompletionArtifact(config: CompletionToolServerConfig, toolName: string, input: unknown): Promise<CompletionArtifactReference>;
+export declare function readCompletionArtifact(worktreePath: string, workItemId: string, phase: CompletionPhase): Promise<RunnerDispatchArtifact | null>;
+export declare function runCompletionMcpServer(config: CompletionToolServerConfig): Promise<void>;
+export declare function parseCompletionMcpArgs(argv: readonly string[]): {
+    readonly ok: true;
+    readonly config: CompletionToolServerConfig;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};