@loucompanion/forge-bridge 0.1.3-dev.f66395c3ac21 → 0.1.4-dev.bfa11ebe98c6

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

@@ -1,24 +1,34 @@
-import type { RunOnceDispatchPacket, RunnerDispatchArtifact } from "./session.types.js";
+import type { RunOnceDispatchPacket } from "./session.types.js";
 import type { WorktreeHandle } from "../worktree/worktree.types.js";
+export { isDebugCompletionPhase } from "./phase-completion.validation.js";
+export { readCompletionArtifact, writeCompletionArtifact } from "./phase-completion.artifacts.js";
+export * from "./phase-completion.prompts.js";
+export * from "./phase-completion.runtime.js";
 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 DraftCompletionPhase = "draft";
-export type CompletionPhase = DevelopCompletionPhase | "qa" | DebugCompletionPhase | ArchitectCompletionPhase | DraftCompletionPhase;
+export type DecomposeCompletionPhase = "decompose";
+export type CiRepairCompletionPhase = "ci_repair";
+export type CommentRepairCompletionPhase = "comment_repair";
+export type CompletionPhase = DevelopCompletionPhase | "qa" | DebugCompletionPhase | ArchitectCompletionPhase | DraftCompletionPhase | DecomposeCompletionPhase | CiRepairCompletionPhase | CommentRepairCompletionPhase;
 export type QaCompletionGate = "qa_plan" | "qa_regression" | "qa_api" | "qa_manual_web" | "qa_bug_repro" | "qa_findings" | "qa_verdict";
 export type DraftCompletionGate = "draft_intent" | "draft_repo_context" | "draft_graph_context" | "draft_product_scope" | "draft_work_order_plan" | "draft_critic" | "draft_proposal";
+export type DecomposeCompletionGate = "decompose_subject_intake" | "decompose_context_review" | "decompose_breakdown_strategy" | "decompose_child_items" | "decompose_dependency_graph" | "decompose_critic" | "decompose_proposal";
 export interface CompletionToolRuntime {
     readonly serverName: string;
     readonly command: string;
     readonly args: readonly string[];
     readonly env: Readonly<Record<string, string>>;
     readonly cursorMcpConfigPath?: string | null;
+    readonly claudeMcpConfigPath?: string | null;
     cleanup(): Promise<void>;
 }
 export interface CompletionToolRuntimeOptions {
     readonly dispatch: RunOnceDispatchPacket;
     readonly worktree: WorktreeHandle;
     readonly phase?: CompletionPhase;
+    readonly runtimeEnvironment?: Readonly<Record<string, string>>;
 }
 export interface CompletionToolServerConfig {
     readonly worktreePath: string;
@@ -33,6 +43,7 @@ export interface CompletionToolServerConfig {
     readonly debugCycle?: boolean;
     readonly architectCycle?: boolean;
     readonly draftCycle?: boolean;
+    readonly decomposeCycle?: boolean;
 }
 export interface CompletionToolCallResult {
     readonly content: readonly {
@@ -40,15 +51,23 @@ export interface CompletionToolCallResult {
         readonly text: string;
     }[];
     readonly structuredContent: CompletionArtifactReference & {
+        readonly artifact_written: true;
+        readonly artifact_receipt: {
+            readonly schema_version: 1;
+            readonly path: string;
+            readonly report_path: string;
+            readonly content_hash: string;
+        };
         readonly gate: {
             readonly phase: CompletionPhase;
             readonly qaGate?: QaCompletionGate;
             readonly draftGate?: DraftCompletionGate;
+            readonly decomposeGate?: DecomposeCompletionGate;
             readonly status: string;
             readonly allowed: boolean;
             readonly reason: string;
         };
-        readonly nextPhase: CompletionPhase | "dev_test_ready" | "qa_ready" | "sign_off_ready";
+        readonly nextPhase: CompletionPhase | "dev_test_ready" | "qa_ready" | "sign_off_ready" | "provider_checks_ready";
         readonly nextInstruction: string;
     };
 }
@@ -64,9 +83,38 @@ export interface CompletionArtifactReference {
     readonly status: string;
     readonly producedBy: string;
 }
+export interface CompletionArtifactFiles {
+    readonly jsonFileName: string;
+    readonly reportFileName: string;
+}
+export declare const toolServerName = "forge";
+export declare const completionRedactionSecretsEnv = "FORGE_COMPLETION_REDACTION_SECRETS";
+export declare const completionPhaseOrder: readonly DevelopCompletionPhase[];
 export declare const debugCompletionPhaseOrder: readonly DebugCompletionPhase[];
 export declare const qaCompletionGateOrder: readonly QaCompletionGate[];
 export declare const draftCompletionGateOrder: readonly DraftCompletionGate[];
+export declare const decomposeCompletionGateOrder: readonly DecomposeCompletionGate[];
+export declare const decomposeGateFileNames: Record<DecomposeCompletionGate, string>;
+export declare const decomposeGateToolNames: Record<DecomposeCompletionGate, string>;
+export declare const draftGateFileNames: Record<DraftCompletionGate, string>;
+export declare const draftGateToolNames: Record<DraftCompletionGate, string>;
+export declare const qaGateFileNames: Record<QaCompletionGate, string>;
+export declare const qaGateToolNames: Record<QaCompletionGate, string>;
+export declare const debugGateToolNames: Record<DebugCompletionPhase, string>;
+export declare const qaBlockerReasons: Set<string>;
+export declare const resolvedFindingStatusValues: readonly ["resolved", "disputed", "not_reproduced"];
+export declare const resolvedFindingStatuses: Set<string>;
+export declare const qaFindingSeverities: Set<string>;
+export declare const qaFindingScopes: Set<string>;
+export declare const qaCandidateBugActions: Set<string>;
+export declare const qaScopeSurfaces: Set<string>;
+export declare const qaScopeEvidence: Set<string>;
+export declare const qaScopeCapabilities: Set<string>;
+export declare const qaScopeSources: Set<string>;
+export declare const qaScopeAuthorities: Set<string>;
+export declare const qaScopeConfidence: Set<string>;
+export declare const qaScopeFields: Set<string>;
+export declare const phaseFiles: Record<CompletionPhase, CompletionArtifactFiles>;
 export declare function completionPhaseFromDispatch(dispatch: RunOnceDispatchPacket): CompletionPhase;
 export declare function normalizeCompletionPhase(value: string | null | undefined): CompletionPhase;
 export declare function usesDevelopCycleCompletion(dispatch: RunOnceDispatchPacket): boolean;
@@ -77,50 +125,13 @@ export declare function completionToolNamesForPhase(phase: CompletionPhase): rea
 export declare function completionToolNamesForQaGate(gate: QaCompletionGate): readonly string[];
 export declare function completionToolNamesForDebugGate(gate: DebugCompletionPhase): readonly string[];
 export declare function completionToolNamesForDraftGate(gate: DraftCompletionGate): readonly string[];
+export declare function completionToolNamesForDecomposeGate(gate: DecomposeCompletionGate): 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 expectedDraftCompletionToolName(gate: DraftCompletionGate): string;
+export declare function expectedDecomposeCompletionToolName(gate: DecomposeCompletionGate): string;
 export declare function artifactRootFor(worktreePath: string, workItemId: string): 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[];
-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 completionPromptForDraftCycle(currentGate?: DraftCompletionGate): 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 currentDraftGate;
-    private completed;
-    constructor(config: CompletionToolServerConfig);
-    get instructions(): string;
-    toolDefinitions(): readonly unknown[];
-    callTool(toolName: string, input: unknown): Promise<CompletionToolCallResult>;
-    private callDraftGateTool;
-    private callDebugGateTool;
-    private callQaGateTool;
-    private advanceAfterPass;
-    private advanceAfterDraftGate;
-    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, 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;
-    readonly config: CompletionToolServerConfig;
-} | {
-    readonly ok: false;
-    readonly error: string;
-};
-export declare function completionRedactionEnv(secrets: readonly string[]): Readonly<Record<string, string>>;

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

@@ -0,0 +1,117 @@
+import type { RunOnceDispatchPacket } from "./session.types.js";
+import { type CompletionPhase, type DebugCompletionPhase, type DecomposeCompletionGate, type DevelopCompletionPhase, type DraftCompletionGate, type QaCompletionGate } from "./phase-completion.js";
+export declare function normalizeArtifactPayload(payload: Record<string, unknown>, defaults: {
+    readonly phase: CompletionPhase;
+    readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
+    readonly producedBy: string;
+    readonly status: string;
+}): Record<string, unknown>;
+export declare function normalizeQaGateArtifactPayload(payload: Record<string, unknown>, defaults: {
+    readonly gate: QaCompletionGate;
+    readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
+    readonly producedBy: string;
+    readonly status: string;
+}): Record<string, unknown>;
+export declare function reportMarkdown(payload: Record<string, unknown>, phase: CompletionPhase, status: string, producedBy: string, contentHash: string): string;
+export declare function parseStrictCompletionPhase(value: string | null | undefined): CompletionPhase | null;
+export declare function normalizeDebugCompletionPhase(value: string | null | undefined): DebugCompletionPhase | null;
+export declare function isDevelopCompletionPhase(phase: CompletionPhase): phase is DevelopCompletionPhase;
+export declare function isDebugCompletionPhase(phase: string | null | undefined): phase is DebugCompletionPhase;
+export declare function asDebugCompletionPhase(phase: CompletionPhase): DebugCompletionPhase;
+export declare function parseCompletionRedactionSecrets(raw: string | undefined): readonly string[];
+export declare function phaseFromToolName(toolName: string): CompletionPhase;
+export declare function draftGateFromToolName(toolName: string): DraftCompletionGate | null;
+export declare function decomposeGateFromToolName(toolName: string): DecomposeCompletionGate | null;
+export declare function isDecomposeDispatch(dispatch: RunOnceDispatchPacket): boolean;
+export declare function debugGateFromToolName(toolName: string): DebugCompletionPhase | null;
+export declare function qaGateFromToolName(toolName: string): QaCompletionGate | null;
+export declare function requireField(payload: Record<string, unknown>, key: string): void;
+export declare function requireNonPassEvidence(payload: Record<string, unknown>): void;
+export declare function requireImplementationEvidence(payload: Record<string, unknown>): void;
+export declare function requirePassingCommands(payload: Record<string, unknown>): void;
+export declare class CompletionPayloadValidationError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+export declare function throwCompletionPayloadIssues(issues: readonly string[]): void;
+export declare function requireArray(payload: Record<string, unknown>, key: string): void;
+export declare function requireNonEmptyArray(payload: Record<string, unknown>, key: string): void;
+export declare function arrayLength(payload: Record<string, unknown>, key: string): number;
+export declare function requireAllowedStatus(payload: Record<string, unknown>, key: string, allowed: readonly string[]): void;
+export declare function requireObject(payload: Record<string, unknown>, key: string): void;
+export declare function requiredRecord(payload: Record<string, unknown>, key: string): Record<string, unknown>;
+export declare function requireBoolean(payload: Record<string, unknown>, key: string): void;
+export declare function requireNumericOne(payload: Record<string, unknown>, key: string, pathLabel: string): void;
+export declare function requireSatisfiedAcceptanceCriteria(payload: Record<string, unknown>): void;
+export declare function validateResolvedFindings(payload: Record<string, unknown>): void;
+export declare function qaEvidenceSource(payload: Record<string, unknown>): Record<string, unknown>;
+export declare function qaArray(payload: Record<string, unknown>, key: string, fallback?: Record<string, unknown>): readonly unknown[];
+export declare function qaObjectArray(payload: Record<string, unknown>, key: string): Record<string, unknown>[];
+export declare function qaPolicyWarnings(payload: Record<string, unknown>): Record<string, unknown>[];
+export declare function qaStringArray(payload: Record<string, unknown>, key: string): string[];
+export declare function requireEvidenceRecord(value: unknown, label: string): void;
+export declare function requireNonEmptyStringRecord(source: Record<string, unknown>, key: string, prefix?: string): void;
+export declare function requireArrayRecord(source: Record<string, unknown>, key: string, prefix?: string): void;
+export declare function requireKnownStringRecord(source: Record<string, unknown>, key: string, allowed: ReadonlySet<string>, prefix?: string): void;
+export declare function requireNonEmptyStringArrayRecord(source: Record<string, unknown>, key: string, prefix?: string): void;
+export declare function requireSubstantiveValueRecord(source: Record<string, unknown>, key: string, prefix?: string): void;
+export declare function requireSubstantiveEvidenceRecord(source: Record<string, unknown>, prefix?: string): void;
+export declare function hasSubstantiveJsonValue(value: unknown): boolean;
+export declare function normalizedString(value: unknown): string;
+export declare function normalizedOwnerType(value: unknown): "work_item" | "story" | undefined;
+export declare function artifactOwnerFields(config: {
+    readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
+}): {
+    readonly owner_type?: string;
+    readonly owner_id?: string;
+};
+export declare function artifactReferenceOwnerFields(config: {
+    readonly workItemId: string;
+    readonly ownerType?: string;
+    readonly ownerId?: string;
+}): {
+    readonly ownerType?: string;
+    readonly ownerId?: string;
+};
+export declare function artifactOwnerDirectory(ownerType: string): string;
+export declare function artifactOwnerRelativeRoot(ownerType: string | undefined, ownerId: string | undefined, workItemId: string): string;
+export declare function defaultQaChecklist(status: string): string[];
+export declare function qaArtifactRelativePath(workItemId: string, fileName: string): string;
+export declare function qaArtifactRelativePathForOwner(ownerType: string, ownerId: string, fileName: string): string;
+export declare function jsonText(value: unknown): string;
+export declare function fallbackReport(parsed: Record<string, unknown>, phase: CompletionPhase, artifactPath: string): string;
+export declare function parseJsonObject(content: string, label: string): Record<string, unknown>;
+export declare function parseOptionalJsonObject(content: string, label: string): Record<string, unknown>;
+export declare function asRecord(value: unknown, label: string): Record<string, unknown>;
+export declare function asMutableRecord(value: unknown): Record<string, unknown>;
+export declare function requiredString(source: Record<string, unknown>, key: string): string;
+export declare function optionalString(source: Record<string, unknown>, key: string): string | null;
+export declare function numberOrDefault(value: unknown, fallback: number): number;
+export declare function stripUndefined(value: Record<string, unknown>): Record<string, unknown>;
+export declare function safePathSegment(value: string, label: string): string;
+export declare function readOptionalFile(filePath: string): Promise<string | null>;
+export declare function writeFileAtomic(filePath: string, content: string): Promise<void>;
+export declare function stableStringify(value: unknown): string;
+export declare function sortJson(value: unknown): unknown;
+export declare function sha256(content: string): string;
+export declare function forgeBridgeCliBinPath(): string;
+export declare function tomlString(value: string): string;
+export declare function tomlStringArray(values: readonly string[]): string;
+export declare function writeJsonRpc(message: unknown): void;
+export declare function rpcError(code: number, message: string): {
+    readonly code: number;
+    readonly message: string;
+};
+export declare function asJsonRpcMessage(value: unknown): {
+    readonly id?: string | number | null;
+    readonly method: string;
+    readonly params?: unknown;
+} | null;
+export declare function errorMessage(error: unknown): string;
+export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;