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

package/dist/bridge/bridge.service.js

@@ -123,6 +123,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 +134,13 @@ export class ForgeBridgeService {
             serverLocal: {
                 repoRoot,
                 cleanupWorktrees: this.config.cleanupWorktrees
-            }
+            },
+            qaBrowser: dispatch.qaBrowser
+                ? {
+                    ...dispatch.qaBrowser,
+                    launchTarget: qaLaunchTarget
+                }
+                : dispatch.qaBrowser
         };
     }
     async sendResult(leaseId, fencingToken, result) {
@@ -323,6 +330,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/phase-completion.d.ts

@@ -1,6 +1,6 @@
 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 CompletionPhase = "implementation" | "self_review" | "validation" | "qa";
 export interface CompletionToolRuntime {
     readonly serverName: string;
     readonly command: string;
@@ -17,12 +17,34 @@ 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;
+}
+export interface CompletionToolCallResult {
+    readonly content: readonly {
+        readonly type: "text";
+        readonly text: string;
+    }[];
+    readonly structuredContent: CompletionArtifactReference & {
+        readonly gate: {
+            readonly phase: CompletionPhase;
+            readonly status: string;
+            readonly allowed: boolean;
+            readonly reason: string;
+        };
+        readonly nextPhase: CompletionPhase | "dev_test_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;
@@ -32,6 +54,7 @@ export interface CompletionArtifactReference {
 }
 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 completionToolNamesForPhase(phase: CompletionPhase): readonly string[];
 export declare function expectedCompletionToolName(phase: CompletionPhase): string;
 export declare function artifactRootFor(worktreePath: string, workItemId: string): string;
@@ -42,6 +65,18 @@ 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 completionToolNamesForServer(config: CompletionToolServerConfig): readonly string[];
+export declare class CompletionToolServerSession {
+    private readonly config;
+    private currentPhase;
+    private completed;
+    constructor(config: CompletionToolServerConfig);
+    get instructions(): string;
+    toolDefinitions(): readonly unknown[];
+    callTool(toolName: string, input: unknown): Promise<CompletionToolCallResult>;
+    private advanceAfterPass;
+}
 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 +87,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>>;