@loucompanion/forge-bridge 0.1.1-dev.2ac58b6f94ce → 0.1.1-dev.2d1a116ca78d

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

@@ -1,6 +1,9 @@
 import type { RunOnceDispatchPacket, RunnerDispatchArtifact } from "./session.types.js";
 import type { WorktreeHandle } from "../worktree/worktree.types.js";
-export type CompletionPhase = "implementation" | "self_review" | "validation" | "qa";
+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;
@@ -25,6 +28,8 @@ export interface CompletionToolServerConfig {
     readonly redactionSecrets?: readonly string[];
     readonly developCycle?: boolean;
     readonly qaCycle?: boolean;
+    readonly debugCycle?: boolean;
+    readonly architectCycle?: boolean;
 }
 export interface CompletionToolCallResult {
     readonly content: readonly {
@@ -39,7 +44,7 @@ export interface CompletionToolCallResult {
             readonly allowed: boolean;
             readonly reason: string;
         };
-        readonly nextPhase: CompletionPhase | "dev_test_ready" | "sign_off_ready";
+        readonly nextPhase: CompletionPhase | "dev_test_ready" | "qa_ready" | "sign_off_ready";
         readonly nextInstruction: string;
     };
 }
@@ -55,18 +60,24 @@ 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;
+export declare function artifactRootForOwner(worktreePath: string, ownerType: string, ownerId: string): string;
+export declare function completionArtifactJsonPath(worktreePath: string, workItemId: string, phase: CompletionPhase, ownerType?: string | null, ownerId?: string | null): string;
+export declare function completionArtifactReportPath(worktreePath: string, workItemId: string, phase: CompletionPhase, ownerType?: string | null, ownerId?: string | null): 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[];
@@ -74,6 +85,7 @@ export declare function cursorMcpServerConfig(runtime: CompletionToolRuntime): u
 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;
@@ -84,12 +96,14 @@ export declare class CompletionToolServerSession {
     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 readCompletionArtifact(worktreePath: string, workItemId: string, phase: CompletionPhase, ownerType?: string | null, ownerId?: string | null): Promise<RunnerDispatchArtifact | null>;
 export declare function runCompletionMcpServer(config: CompletionToolServerConfig): Promise<void>;
 export declare function parseCompletionMcpArgs(argv: readonly string[]): {
     readonly ok: true;