@loucompanion/forge-bridge 0.1.1-dev.af36c7fa102b → 0.1.1-dev.c5b751411a2b

package/dist/bridge/bridge.service.js

@@ -51,7 +51,7 @@ export class ForgeBridgeService {
                     attempt = 0;
                     await this.waitForClose(signal);
                 }
-                catch (error) {
+                catch {
                     if (this.stopped || signal?.aborted) {
                         break;
                     }
@@ -87,11 +87,20 @@ export class ForgeBridgeService {
             const normalized = this.normalizeDispatch(dispatch);
             const result = await this.sessions.runOnce(normalized, {
                 emit: async (event) => {
-                    await this.invokeAck("DispatchEvent", {
-                        leaseId,
-                        fencingToken,
-                        event: redactSecrets(event, redactionSecrets)
-                    });
+                    try {
+                        await this.invokeAck("DispatchEvent", {
+                            leaseId,
+                            fencingToken,
+                            event: redactSecrets(event, redactionSecrets)
+                        });
+                    }
+                    catch (error) {
+                        if (isDispatchNoLongerPending(error)) {
+                            controller.abort(error instanceof Error ? error.message : "Dispatch is no longer pending.");
+                            return;
+                        }
+                        throw error;
+                    }
                 }
             }, controller.signal);
             await this.sendResult(leaseId, fencingToken, redactSecrets(result, redactionSecrets));
@@ -123,6 +132,7 @@ export class ForgeBridgeService {
         const mapping = findRepoMapping(dispatch, this.config.repoMappings);
         const localPath = mapping?.localPath?.trim();
         const repoRoot = localPath ? path.dirname(path.resolve(localPath)) : this.config.defaultRepoRoot;
+        const qaLaunchTarget = normalizeQaAppLaunchTarget(mapping?.qaAppLaunchTarget) ?? dispatch.qaBrowser?.launchTarget ?? null;
         return {
             ...dispatch,
             repo: {
@@ -133,7 +143,13 @@ export class ForgeBridgeService {
             serverLocal: {
                 repoRoot,
                 cleanupWorktrees: this.config.cleanupWorktrees
-            }
+            },
+            qaBrowser: dispatch.qaBrowser
+                ? {
+                    ...dispatch.qaBrowser,
+                    launchTarget: qaLaunchTarget
+                }
+                : dispatch.qaBrowser
         };
     }
     async sendResult(leaseId, fencingToken, result) {
@@ -142,7 +158,15 @@ export class ForgeBridgeService {
             fencingToken,
             result
         };
-        await this.invokeAck("DispatchResult", payload);
+        try {
+            await this.invokeAck("DispatchResult", payload);
+        }
+        catch (error) {
+            if (isDispatchNoLongerPending(error)) {
+                return;
+            }
+            throw error;
+        }
     }
     startHeartbeat() {
         this.stopHeartbeat();
@@ -189,7 +213,7 @@ export class ForgeBridgeService {
         }
         const ack = await connection.invoke(methodName, payload);
         if (!ack.accepted) {
-            throw new Error(ack.message ?? ack.code ?? `${methodName} callback was rejected.`);
+            throw new BridgeCallbackRejectedError(ack.code ?? null, ack.message ?? ack.code ?? `${methodName} callback was rejected.`);
         }
         return ack;
     }
@@ -207,6 +231,20 @@ export class ForgeBridgeService {
         }
     }
 }
+class BridgeCallbackRejectedError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BridgeCallbackRejectedError";
+    }
+}
+function isDispatchNoLongerPending(error) {
+    if (error instanceof BridgeCallbackRejectedError) {
+        return error.code === "bridge.dispatch_not_pending" || error.code === "bridge.stale_dispatch";
+    }
+    return error instanceof Error && error.message === "Dispatch is no longer pending.";
+}
 export class SignalRBridgeConnectionFactory {
     create(config) {
         return new SignalRBridgeConnection(config);
@@ -323,6 +361,27 @@ function findRepoMapping(dispatch, mappings) {
             (!!mapping.remoteUrl?.trim() && equalsIgnoreCase(mapping.remoteUrl, dispatch.repo.remoteUrl)));
     });
 }
+function normalizeQaAppLaunchTarget(target) {
+    if (!target) {
+        return null;
+    }
+    const routes = [...new Set((target.routes ?? []).map((route) => route.trim()).filter(Boolean))];
+    const normalized = {
+        url: cleanString(target.url),
+        command: cleanString(target.command),
+        working_directory: cleanString(target.working_directory),
+        ready_url: cleanString(target.ready_url),
+        routes,
+        notes: cleanString(target.notes)
+    };
+    return normalized.url || normalized.command || normalized.ready_url || routes.length > 0
+        ? normalized
+        : null;
+}
+function cleanString(value) {
+    const clean = value?.trim();
+    return clean ? clean : null;
+}
 function equalsIgnoreCase(left, right) {
     return !!left?.trim() && !!right?.trim() && left.trim().toLowerCase() === right.trim().toLowerCase();
 }

package/dist/bridge/bridge.types.d.ts

@@ -27,6 +27,15 @@ export interface BridgeRepoMapping {
     readonly name?: string | null;
     readonly remoteUrl?: string | null;
     readonly localPath?: string | null;
+    readonly qaAppLaunchTarget?: QaAppLaunchTarget | null;
+}
+export interface QaAppLaunchTarget {
+    readonly url?: string | null;
+    readonly command?: string | null;
+    readonly working_directory?: string | null;
+    readonly ready_url?: string | null;
+    readonly routes?: readonly string[] | null;
+    readonly notes?: string | null;
 }
 export interface BridgeProviderStatus {
     readonly signedIn?: boolean | null;

package/dist/cli/cli.service.js

@@ -4,6 +4,7 @@ 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";
@@ -633,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/cli/local-config.js

@@ -159,7 +159,8 @@ function normalizeRepoMappings(values) {
             repoId: cleanString(mapping.repoId),
             name: cleanString(mapping.name) ?? label,
             remoteUrl: cleanString(mapping.remoteUrl),
-            localPath: path.resolve(mapping.localPath)
+            localPath: path.resolve(mapping.localPath),
+            qaAppLaunchTarget: normalizeQaAppLaunchTarget(mapping.qaAppLaunchTarget)
         };
     })
         .sort((left, right) => left.label.localeCompare(right.label));
@@ -171,6 +172,22 @@ function normalizeLabel(value) {
     }
     return label;
 }
+function normalizeQaAppLaunchTarget(value) {
+    if (!value)
+        return undefined;
+    const routes = cleanList(value.routes);
+    const normalized = {
+        url: cleanString(value.url),
+        command: cleanString(value.command),
+        working_directory: cleanString(value.working_directory),
+        ready_url: cleanString(value.ready_url),
+        routes,
+        notes: cleanString(value.notes)
+    };
+    return normalized.url || normalized.command || normalized.ready_url || routes?.length
+        ? normalized
+        : undefined;
+}
 function cleanString(value) {
     const clean = value?.trim();
     return clean ? clean : undefined;

package/dist/session/internals.d.ts

@@ -2,7 +2,7 @@ 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 type { ApiKeySecretGrant, DispatchCycleRun, DispatchExecution, DispatchLease, DispatchPullRequestContext, 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";
 export type { ProviderCliService } from "./provider-cli/provider-cli.base.js";
 export type { ProviderCliCommand, ProviderProcessRunner, ProviderProcessRunRequest, ProviderProcessRunResult } from "./provider-cli/provider-cli.service.js";

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

@@ -1,6 +1,10 @@
 import type { RunOnceDispatchPacket, RunnerDispatchArtifact } from "./session.types.js";
 import type { WorktreeHandle } from "../worktree/worktree.types.js";
-export type CompletionPhase = "implementation" | "self_review" | "validation";
+export type DevelopCompletionPhase = "implementation" | "self_review" | "validation";
+export type DebugCompletionPhase = "debug_repro" | "debug_root_cause" | "debug_fix" | "debug_regression";
+export type ArchitectCompletionPhase = "architect";
+export type CompletionPhase = DevelopCompletionPhase | "qa" | DebugCompletionPhase | ArchitectCompletionPhase;
+export type QaCompletionGate = "qa_plan" | "qa_regression" | "qa_api" | "qa_manual_web" | "qa_bug_repro" | "qa_findings" | "qa_verdict";
 export interface CompletionToolRuntime {
     readonly serverName: string;
     readonly command: string;
@@ -17,12 +21,38 @@ export interface CompletionToolRuntimeOptions {
 export interface CompletionToolServerConfig {
     readonly worktreePath: string;
     readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
     readonly phase: CompletionPhase;
     readonly producedBy?: string;
+    readonly redactionSecrets?: readonly string[];
+    readonly developCycle?: boolean;
+    readonly qaCycle?: boolean;
+    readonly debugCycle?: boolean;
+    readonly architectCycle?: boolean;
+}
+export interface CompletionToolCallResult {
+    readonly content: readonly {
+        readonly type: "text";
+        readonly text: string;
+    }[];
+    readonly structuredContent: CompletionArtifactReference & {
+        readonly gate: {
+            readonly phase: CompletionPhase;
+            readonly qaGate?: QaCompletionGate;
+            readonly status: string;
+            readonly allowed: boolean;
+            readonly reason: string;
+        };
+        readonly nextPhase: CompletionPhase | "dev_test_ready" | "qa_ready" | "sign_off_ready";
+        readonly nextInstruction: string;
+    };
 }
 export interface CompletionArtifactReference {
     readonly phase: CompletionPhase;
     readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
     readonly repoPath: string;
     readonly path: string;
     readonly reportPath: string;
@@ -30,10 +60,20 @@ export interface CompletionArtifactReference {
     readonly status: string;
     readonly producedBy: string;
 }
+export declare const debugCompletionPhaseOrder: readonly DebugCompletionPhase[];
+export declare const qaCompletionGateOrder: readonly QaCompletionGate[];
 export declare function completionPhaseFromDispatch(dispatch: RunOnceDispatchPacket): CompletionPhase;
 export declare function normalizeCompletionPhase(value: string | null | undefined): CompletionPhase;
+export declare function usesDevelopCycleCompletion(dispatch: RunOnceDispatchPacket): boolean;
+export declare function usesQaCycleCompletion(dispatch: RunOnceDispatchPacket): boolean;
+export declare function usesDebugCycleCompletion(dispatch: RunOnceDispatchPacket): boolean;
+export declare function usesArchitectCycleCompletion(dispatch: RunOnceDispatchPacket): boolean;
 export declare function completionToolNamesForPhase(phase: CompletionPhase): readonly string[];
+export declare function completionToolNamesForQaGate(gate: QaCompletionGate): readonly string[];
+export declare function completionToolNamesForDebugGate(gate: DebugCompletionPhase): readonly string[];
 export declare function expectedCompletionToolName(phase: CompletionPhase): string;
+export declare function expectedQaCompletionToolName(gate: QaCompletionGate): string;
+export declare function expectedDebugCompletionToolName(gate: DebugCompletionPhase): 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;
@@ -42,6 +82,25 @@ export declare function buildCompletionToolServerArgs(config: CompletionToolServ
 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 completionPromptForDevelopCycle(phase: CompletionPhase): string;
+export declare function completionPromptForQaCycle(currentGate?: QaCompletionGate): string;
+export declare function completionPromptForDebugCycle(currentGate?: DebugCompletionPhase): string;
+export declare function completionToolNamesForServer(config: CompletionToolServerConfig): readonly string[];
+export declare class CompletionToolServerSession {
+    private readonly config;
+    private currentPhase;
+    private currentQaGate;
+    private completed;
+    constructor(config: CompletionToolServerConfig);
+    get instructions(): string;
+    toolDefinitions(): readonly unknown[];
+    callTool(toolName: string, input: unknown): Promise<CompletionToolCallResult>;
+    private callDebugGateTool;
+    private callQaGateTool;
+    private advanceAfterPass;
+    private advanceAfterQaGate;
+    private advanceAfterDebugGate;
+}
 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>;
@@ -52,3 +111,4 @@ export declare function parseCompletionMcpArgs(argv: readonly string[]): {
     readonly ok: false;
     readonly error: string;
 };
+export declare function completionRedactionEnv(secrets: readonly string[]): Readonly<Record<string, string>>;