@loucompanion/forge-bridge 0.1.1-dev.7d43998c4521 → 0.1.1-dev.ac486debe210

package/dist/cli/local-config.d.ts

@@ -1,6 +1,6 @@
 import type { BridgeProviderStatus, BridgeRepoMapping, BridgeServiceConfig } from "../bridge/bridge.types.js";
 export interface BridgeLocalConfig {
-    readonly schemaVersion: 1;
+    readonly schemaVersion: 1 | 2;
     readonly serverUrl?: string;
     readonly runnerId?: string;
     readonly deviceToken?: string;
@@ -13,6 +13,9 @@ export interface BridgeLocalConfig {
     readonly repoMappings?: readonly LocalRepoMapping[];
     readonly sandboxProfiles?: readonly string[];
     readonly supportsApiSecretGrant?: boolean;
+    readonly supportsManagedWorktrees?: boolean;
+    readonly supportsManagedForgeArtifacts?: boolean;
+    readonly supportsRunnerAuthoredPhaseArtifacts?: boolean;
 }
 export interface LocalRepoMapping extends BridgeRepoMapping {
     readonly label: string;

package/dist/cli/local-config.js

@@ -46,11 +46,14 @@ export function applyLocalConfigDefaults(config, local) {
         defaultRepoRoot: process.env.FORGE_REPO_ROOT ?? local.defaultRepoRoot ?? config.defaultRepoRoot,
         cleanupWorktrees: local.cleanupWorktrees ?? config.cleanupWorktrees,
         cliProviders,
-        providerStatuses: local.providerStatuses ?? providerStatusesFor(cliProviders),
+        providerStatuses: normalizeProviderStatuses(local.providerStatuses) ?? providerStatusesFor(cliProviders),
         projectLabels: local.projectLabels ?? config.projectLabels,
         repoMappings: local.repoMappings ?? config.repoMappings,
         sandboxProfiles: local.sandboxProfiles ?? config.sandboxProfiles,
-        supportsApiSecretGrant: local.supportsApiSecretGrant ?? config.supportsApiSecretGrant
+        supportsApiSecretGrant: local.supportsApiSecretGrant ?? config.supportsApiSecretGrant,
+        supportsManagedWorktrees: local.supportsManagedWorktrees ?? config.supportsManagedWorktrees,
+        supportsManagedForgeArtifacts: local.supportsManagedForgeArtifacts ?? config.supportsManagedForgeArtifacts,
+        supportsRunnerAuthoredPhaseArtifacts: local.supportsRunnerAuthoredPhaseArtifacts ?? config.supportsRunnerAuthoredPhaseArtifacts
     };
 }
 export async function addRepoMapping(label, repoPath) {
@@ -83,7 +86,7 @@ export async function removeRepoMapping(label) {
     return { config: next, removed: after.length !== before.length };
 }
 export function providerStatusesFor(providers) {
-    return Object.fromEntries(providers.map((provider) => [provider, { signedIn: true, version: "" }]));
+    return Object.fromEntries(providers.map((provider) => [provider, { signedIn: true, version: "", models: configuredModelsFor(provider) }]));
 }
 function parseLocalConfig(raw) {
     if (!raw.trim()) {
@@ -93,7 +96,7 @@ function parseLocalConfig(raw) {
 }
 function normalizeLocalConfig(config) {
     return {
-        schemaVersion: 1,
+        schemaVersion: 2,
         serverUrl: cleanString(config.serverUrl),
         runnerId: cleanString(config.runnerId),
         deviceToken: cleanString(config.deviceToken),
@@ -101,19 +104,51 @@ function normalizeLocalConfig(config) {
         defaultRepoRoot: cleanString(config.defaultRepoRoot),
         cleanupWorktrees: config.cleanupWorktrees,
         cliProviders: cleanList(config.cliProviders),
-        providerStatuses: config.providerStatuses,
+        providerStatuses: normalizeProviderStatuses(config.providerStatuses),
         projectLabels: cleanList(config.projectLabels),
         repoMappings: normalizeRepoMappings(config.repoMappings),
         sandboxProfiles: cleanList(config.sandboxProfiles),
-        supportsApiSecretGrant: config.supportsApiSecretGrant
+        supportsApiSecretGrant: config.supportsApiSecretGrant,
+        supportsManagedWorktrees: config.supportsManagedWorktrees,
+        supportsManagedForgeArtifacts: config.supportsManagedForgeArtifacts,
+        supportsRunnerAuthoredPhaseArtifacts: config.supportsRunnerAuthoredPhaseArtifacts
     };
 }
 function emptyConfig() {
     return {
-        schemaVersion: 1,
+        schemaVersion: 2,
         repoMappings: []
     };
 }
+function normalizeProviderStatuses(values) {
+    if (!values)
+        return undefined;
+    const entries = [];
+    for (const [provider, status] of Object.entries(values)) {
+        const key = provider.trim();
+        if (!key)
+            continue;
+        entries.push([
+            key,
+            {
+                signedIn: status?.signedIn ?? true,
+                version: cleanString(status?.version),
+                models: cleanList(status?.models) ?? configuredModelsFor(key)
+            }
+        ]);
+    }
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function configuredModelsFor(provider) {
+    const envName = `FORGE_${provider.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase()}_MODELS`;
+    return splitCsv(process.env[envName] ?? "");
+}
+function splitCsv(value) {
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
 function normalizeRepoMappings(values) {
     return (values ?? [])
         .filter((mapping) => !!mapping.label?.trim() && !!mapping.localPath?.trim())

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,7 +1,9 @@
 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, buildProviderCliCommand } from "./provider-cli/provider-cli.service.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 } from "./provider-cli/provider-cli.service.js";
+export type { ProviderCliCommand, ProviderProcessRunner, ProviderProcessRunRequest, ProviderProcessRunResult } from "./provider-cli/provider-cli.service.js";
 export type { ProviderCliRunContext, ProviderCliRunResult } from "./provider-cli/provider-cli.types.js";

package/dist/session/internals.js

@@ -1,2 +1,3 @@
 export { parseRunOnceDispatchPacket, failureResult } from "./session.types.js";
-export { DeterministicProviderCliService, buildProviderCliCommand } from "./provider-cli/provider-cli.service.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,86 @@
+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;
+    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";
+        readonly nextInstruction: 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 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;
+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 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>;
+export declare function parseCompletionMcpArgs(argv: readonly string[]): {
+    readonly ok: true;
+    readonly config: CompletionToolServerConfig;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+export declare function completionRedactionEnv(secrets: readonly string[]): Readonly<Record<string, string>>;