opencode-plugin-flow 4.3.9 → 5.0.0

package/dist/infrastructure/fs/session-repository.d.ts

@@ -0,0 +1,2 @@
+import type { SessionRepository } from "../../application/ports/session-repository.js";
+export declare function createFileSessionRepository(workspace: string): SessionRepository;

package/dist/infrastructure/fs/workspace-flow-service.d.ts

@@ -0,0 +1,9 @@
+import { type FlowResponse, type FlowService } from "../../application/flow-service.js";
+export declare function createWorkspaceFlowService(workspace: string): FlowService;
+export declare function flowStatus(workspace: string): Promise<FlowResponse>;
+export declare function flowPlanSave(workspace: string, input: unknown): Promise<FlowResponse>;
+export declare function flowPlanApprove(workspace: string): Promise<FlowResponse>;
+export declare function flowRunStart(workspace: string, input: unknown): Promise<FlowResponse>;
+export declare function flowFeatureComplete(workspace: string, input: unknown): Promise<FlowResponse>;
+export declare function flowFeatureReset(workspace: string, input: unknown): Promise<FlowResponse>;
+export declare function flowSessionClose(workspace: string, input: unknown): Promise<FlowResponse>;

package/dist/{runtime → infrastructure/fs}/workspace.d.ts

@@ -1,7 +1,15 @@
-import { type Session } from "./schema";
+import type { Session } from "../../domain/session.js";
 export declare class InvalidFlowWorkspaceRootError extends Error {
     readonly code = "INVALID_FLOW_WORKSPACE_ROOT";
-    constructor(message: string);
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class UnsafeFlowWorkspaceLayoutError extends Error {
+    readonly code = "UNSAFE_FLOW_WORKSPACE_LAYOUT";
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ArchiveCollisionError extends Error {
+    readonly code = "FLOW_ARCHIVE_COLLISION";
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare function normalizeWorkspaceRoot(rawPath: string | undefined): string | null;
 export declare function assertMutableWorkspaceRoot(rawPath: string): string;
@@ -11,25 +19,13 @@ export declare function resolveWorkspaceRoot(context: {
 }): string;
 export declare function flowDir(worktree: string): string;
 export declare function sessionPath(worktree: string): string;
-export declare function flowInstructionPath(worktree: string): string;
 export declare function historyDir(worktree: string): string;
 export declare function archivedSessionPath(worktree: string, sessionId: string): string;
 export type SessionLockOptions = {
     timeoutMs?: number;
-    staleMs?: number;
 };
 export declare function withSessionLock<T>(worktree: string, task: () => Promise<T>, lockOptions?: SessionLockOptions): Promise<T>;
-export declare class UnreadableFlowSessionError extends Error {
-    readonly reason: string;
-    readonly code = "UNREADABLE_FLOW_SESSION";
-    constructor(message: string, reason: string);
-}
 export declare function loadSession(worktree: string): Promise<Session | null>;
 export declare function quarantineUnreadableSession(worktree: string): Promise<string | null>;
-export declare function flowSessionProgress(session: Session): {
-    completed: number;
-    total: number;
-};
-export declare function refreshFlowInstructionFile(worktree: string): Promise<void>;
 export declare function saveSession(worktree: string, session: Session): Promise<Session>;
 export declare function archiveAndClearSession(worktree: string, session: Session): Promise<void>;

package/dist/infrastructure/system/transition-environment.d.ts

@@ -0,0 +1,2 @@
+import type { TransitionEnvironment } from "../../domain/transitions.js";
+export declare const systemTransitionEnvironment: TransitionEnvironment;

package/dist/platform/opencode/config.d.ts

@@ -0,0 +1,2 @@
+import { type MutableFlowConfig } from "../../config-shared.js";
+export declare function createConfigHook(ctx: unknown): (config: MutableFlowConfig) => Promise<void>;

package/dist/{adapters → platform}/opencode/plugin.d.ts

@@ -1,3 +1,3 @@
-import type { Plugin } from "./sdk";
+import type { Plugin } from "./sdk.js";
 declare const FlowPlugin: Plugin;
 export default FlowPlugin;

package/dist/{adapters → platform}/opencode/sdk.d.ts

@@ -1,3 +1,2 @@
 export type { Hooks, Plugin, ToolContext } from "@opencode-ai/plugin";
 export { tool } from "@opencode-ai/plugin";
-export type { Part } from "@opencode-ai/sdk";

package/dist/platform/opencode/tools.d.ts

@@ -0,0 +1,6 @@
+import { type Hooks } from "@opencode-ai/plugin";
+export type FlowHostInputOperation = "planSave" | "runStart" | "featureComplete" | "featureReset" | "sessionClose";
+export declare function acceptsFlowHostInput(operation: FlowHostInputOperation, input: unknown): boolean;
+type FlowTools = NonNullable<Hooks["tool"]>;
+export declare function createTools(ctx: unknown): FlowTools;
+export {};

package/dist/prompt-baseline-fixtures.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Frozen historical prompt assembly used only for comparative evaluation.
+ *
+ * These strings capture the pre-compiler public startup and hidden-worker
+ * prompts. They are not production prompt sources and must never be selected by
+ * the default compiled Flow surfaces. Keep the exception explicit so manual
+ * baseline text cannot be mistaken for a maintained projection of skill rules.
+ */
+export declare const LEGACY_PROMPT_BASELINE: Readonly<{
+    publicCommandPreflight: string;
+    workerPrompts: Readonly<{
+        "flow-evidence-worker": "Use Flow evidence mode. Inspect only the assigned slice, do not edit files, do not call state-changing Flow tools, and return coverage, evidence inspected, confidence-tagged findings or facts, gaps, and manager follow-ups. Return only the assigned Flow handoff. Cite or drop every claim, label single-source, inferred, and unsettled claims, and report blocked if the assigned scope, expected coverage, or handoff shape is missing. Empty or unstructured output is a failed handoff; return blocked with the missing elements instead.";
+        "flow-validation-worker": "Use Flow validation mode. Run only manager-specified commands or propose focused checks, do not edit files, do not call state-changing Flow tools, and report exact command, status, raw outcome summary, coverage, confidence, gaps, and manager follow-ups. Return only the assigned Flow handoff. Cite or drop every claim, label single-source, inferred, and unsettled claims, and report blocked if the assigned scope, expected coverage, or handoff shape is missing. Empty or unstructured output is a failed handoff; return blocked with the missing elements instead.";
+        "flow-audit-worker": "Use Flow audit mode. Inspect only the assigned slice, actively refute candidate findings before reporting them, do not edit files, do not call state-changing Flow tools, and return coverage, evidence, guards checked, confidence, gaps, and manager follow-ups. Return only the assigned Flow handoff. Cite or drop every claim, label single-source, inferred, and unsettled claims, and report blocked if the assigned scope, expected coverage, or handoff shape is missing. Empty or unstructured output is a failed handoff; return blocked with the missing elements instead.";
+        "flow-candidate-worker": "Use Flow candidate-implementation mode only when the manager assigned an isolated worktree or exact non-overlapping path ownership. Do not edit .flow/**, do not call state-changing Flow tools, do not complete Flow state, and return changed or proposed patch, verification run, coverage, confidence, merge risks, and manager follow-ups. Return only the assigned Flow handoff. Cite or drop every claim, label single-source, inferred, and unsettled claims, and report blocked if the assigned scope, expected coverage, or handoff shape is missing. Empty or unstructured output is a failed handoff; return blocked with the missing elements instead.";
+        "flow-verifier-worker": "Use Flow verifier mode. Verify only the assigned claims against the provided sources, commands, counts, or current docs. Do not generate new scope, do not edit files, do not call state-changing Flow tools, and return supported, partly-supported, unsupported, or source-not-found per claim with evidence, confidence, gaps, and manager follow-ups. Return only the assigned Flow handoff. Cite or drop every claim, label single-source, inferred, and unsettled claims, and report blocked if the assigned scope, expected coverage, or handoff shape is missing. Empty or unstructured output is a failed handoff; return blocked with the missing elements instead.";
+    }>;
+    reviewerSections: readonly string[];
+}>;

package/dist/prompt-model-evaluation.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { type FlowPromptVariant } from "./prompt-surfaces.js";
+declare const ModelDecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    route: z.ZodEnum<{
+        "flow-audit-worker": "flow-audit-worker";
+        "flow-auto": "flow-auto";
+        "flow-candidate-worker": "flow-candidate-worker";
+        "flow-evidence-worker": "flow-evidence-worker";
+        "flow-plan": "flow-plan";
+        "flow-review": "flow-review";
+        "flow-reviewer": "flow-reviewer";
+        "flow-run": "flow-run";
+        "flow-status": "flow-status";
+        "flow-validation-worker": "flow-validation-worker";
+        "flow-verifier-worker": "flow-verifier-worker";
+    }>;
+    executionMode: z.ZodEnum<{
+        blocked: "blocked";
+        candidate_worker: "candidate_worker";
+        readonly_parallel: "readonly_parallel";
+        serial: "serial";
+    }>;
+    workers: z.ZodArray<z.ZodString>;
+    stateOwner: z.ZodEnum<{
+        "root-manager": "root-manager";
+        worker: "worker";
+    }>;
+    callsStatusFirst: z.ZodBoolean;
+    planOnly: z.ZodBoolean;
+    reviewFirst: z.ZodBoolean;
+    validation: z.ZodArray<z.ZodEnum<{
+        behavioral: "behavioral";
+        broad: "broad";
+        browser: "browser";
+        focused: "focused";
+        ui: "ui";
+    }>>;
+    independentReview: z.ZodBoolean;
+    reviewDepth: z.ZodEnum<{
+        broad: "broad";
+        detailed: "detailed";
+        not_applicable: "not_applicable";
+        quick: "quick";
+        standard: "standard";
+    }>;
+    manifestComplete: z.ZodBoolean;
+    coverage: z.ZodEnum<{
+        complete: "complete";
+        missing: "missing";
+        not_applicable: "not_applicable";
+        partial: "partial";
+    }>;
+    handoffStatus: z.ZodEnum<{
+        blocked: "blocked";
+        not_applicable: "not_applicable";
+        partial: "partial";
+        success: "success";
+    }>;
+    handoffHasRequiredSections: z.ZodBoolean;
+    retryReviews: z.ZodNumber;
+    stopsAfterRetryFailure: z.ZodBoolean;
+    candidateDecision: z.ZodEnum<{
+        not_applicable: "not_applicable";
+        serial_required: "serial_required";
+        used: "used";
+    }>;
+    completionClaimed: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type ModelDecision = z.infer<typeof ModelDecisionSchema>;
+export type ModelEvaluationGrade = {
+    passedScenarios: number;
+    totalScenarios: number;
+    passedCriteria: number;
+    totalCriteria: number;
+    scenarios: Array<{
+        id: string;
+        passed: boolean;
+        passedCriteria: number;
+        totalCriteria: number;
+        failures: string[];
+    }>;
+};
+export declare function buildPromptModelEvaluationPacket(variant: FlowPromptVariant): string;
+export declare function parseModelDecisionResponse(text: string): ModelDecision[];
+export declare function gradeModelDecisions(decisions: readonly ModelDecision[]): ModelEvaluationGrade;
+export {};

package/dist/prompt-quality.d.ts

@@ -0,0 +1,73 @@
+import { type CompiledFlowPrompt, type FlowPromptSurfaceName, type FlowPromptVariant } from "./prompt-surfaces.js";
+export type PromptMetric = {
+    surface: string;
+    variant: FlowPromptVariant | "runtime";
+    sources: string[];
+    characters: number;
+    words: number;
+    approximateTokens: number;
+    actionableInstructions: number;
+    exactDuplicateLines: number;
+    repeatedFiveGrams: number;
+    nearDuplicateLinePairs: number;
+    negativeInstructions: number;
+    negativeInstructionDensity: number;
+    codeFences: number;
+    conditionalFragments: string[];
+    roleInapplicableFragments: string[];
+    roleInapplicableLines: number;
+    criticalRulePositions: Record<string, number | null>;
+    structurallyEnforcedRulesPresent: string[];
+    terminologyWarnings: string[];
+};
+export type PromptEvaluationResult = {
+    variant: FlowPromptVariant;
+    scenariosPassed: number;
+    scenariosTotal: number;
+    criteriaPassed: number;
+    criteriaTotal: number;
+    staticApproximateTokens: number;
+    roleInapplicableLines: number;
+    exactDuplicateLines: number;
+    scenarios: Array<{
+        id: string;
+        name: string;
+        passed: boolean;
+        passedCriteria: number;
+        totalCriteria: number;
+        failures: string[];
+    }>;
+};
+export type PromptRepetitionClassification = {
+    id: string;
+    classification: "keep" | "consolidate" | "enforce-structurally" | "load-conditionally" | "remove" | "evaluate";
+    occurrences: string[];
+    rationale: string;
+};
+export declare function measurePromptText(options: {
+    surface: string;
+    variant: FlowPromptVariant | "runtime";
+    text: string;
+    compiled?: CompiledFlowPrompt;
+}): PromptMetric;
+export declare function measureCompiledPrompt(compiled: CompiledFlowPrompt): PromptMetric;
+type PromptScenario = {
+    id: string;
+    name: string;
+    input: string;
+    expectedRoute: FlowPromptSurfaceName;
+    surface: FlowPromptSurfaceName;
+    required: Array<{
+        label: string;
+        pattern: RegExp;
+    }>;
+    forbidden?: Array<{
+        label: string;
+        pattern: RegExp;
+    }>;
+};
+export declare const PROMPT_EVALUATION_SCENARIOS: readonly PromptScenario[];
+export declare function evaluatePromptVariant(variant: FlowPromptVariant): PromptEvaluationResult;
+export declare const PROMPT_REPETITION_CLASSIFICATIONS: readonly PromptRepetitionClassification[];
+export declare function promptInventoryForVariant(variant: FlowPromptVariant): PromptMetric[];
+export {};

package/dist/prompt-surfaces.d.ts

@@ -0,0 +1,28 @@
+export type FlowPromptVariant = "baseline" | "lexically-deduplicated" | "surface-specific" | "surface-specific-bookended";
+export type FlowPromptSurfaceName = "flow-auto" | "flow-plan" | "flow-run" | "flow-review" | "flow-status" | "flow-reviewer" | "flow-evidence-worker" | "flow-validation-worker" | "flow-audit-worker" | "flow-candidate-worker" | "flow-verifier-worker";
+export type FlowPromptRole = "manager" | "reviewer" | "evidence-worker" | "validation-worker" | "audit-worker" | "candidate-worker" | "verifier-worker";
+export type FlowPromptFragmentKind = "purpose" | "invariant" | "procedure" | "reference" | "schema" | "checkpoint";
+export type FlowPromptFragment = {
+    id: string;
+    source: string;
+    origin: "skill-source" | "compiler";
+    kind: FlowPromptFragmentKind;
+    text: string;
+    roles: readonly FlowPromptRole[];
+    conditional?: boolean;
+};
+export type CompiledFlowPrompt = {
+    surface: FlowPromptSurfaceName;
+    variant: FlowPromptVariant;
+    role: FlowPromptRole;
+    text: string;
+    fragments: readonly FlowPromptFragment[];
+};
+export type FlowWorkerHandoffKind = "evidence" | "validation" | "audit" | "review-slice" | "verifier" | "candidate";
+export declare function compileFlowPromptSurface(surface: FlowPromptSurfaceName, variant?: FlowPromptVariant): CompiledFlowPrompt;
+export declare const FLOW_STATIC_PROMPT_SURFACES: readonly FlowPromptSurfaceName[];
+export declare function compiledFlowPromptSurfaces(variant?: FlowPromptVariant): Record<FlowPromptSurfaceName, CompiledFlowPrompt>;
+export declare function validateFlowWorkerHandoff(kind: FlowWorkerHandoffKind, text: string): {
+    ok: boolean;
+    errors: string[];
+};

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare function resolveFlowPluginVersion(): string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-plugin-flow",
-	"version": "4.3.9",
+	"version": "5.0.0",
 	"description": "Stateful planning and execution workflow plugin for OpenCode",
 	"type": "module",
 	"repository": {
@@ -26,18 +26,20 @@
 		"CHANGELOG.md"
 	],
 	"scripts": {
-		"build": "bun run build:plugin && bun run build:cli && bun run build:types",
+		"build": "bun run clean && bun run build:plugin && bun run build:cli && bun run build:types",
 		"build:plugin": "bun build --target=node --outdir=./dist --entry-naming=index.js --external=@opencode-ai/plugin --external=zod --sourcemap=external ./src/index.ts",
 		"build:cli": "bun build --target=node --outdir=./dist --entry-naming=cli.js --banner='#!/usr/bin/env node' --sourcemap=external ./src/cli.ts",
 		"build:types": "tsc -p tsconfig.types.json",
-		"lint": "bunx biome check src tests --files-ignore-unknown=true --vcs-use-ignore-file=true",
+		"clean": "bun run scripts/clean-dist.ts",
+		"lint": "bunx biome check src tests scripts --files-ignore-unknown=true --vcs-use-ignore-file=true",
+		"prompt:quality": "bun run scripts/prompt-quality.ts",
+		"prompt:model-eval": "bun run scripts/prompt-model-eval.ts",
 		"package:smoke": "bun test tests/package-smoke.test.ts",
 		"release:monitor": "node scripts/release-monitor.mjs",
 		"smoke:live": "FLOW_LIVE_SMOKE=1 bun test tests/live-opencode-smoke.test.ts",
 		"test": "bun test tests",
 		"typecheck": "tsc --noEmit",
-		"uninstall:opencode": "bun run ./src/cli.ts uninstall",
-		"check": "bun run typecheck && bun run lint && bun run build && bun run test"
+		"check": "bun run typecheck && bun run lint && bun run prompt:quality && bun run build && bun run test"
 	},
 	"keywords": [
 		"opencode",
@@ -48,19 +50,24 @@
 	],
 	"author": "Douwe de Vries",
 	"license": "MIT",
+	"packageManager": "bun@1.3.14",
 	"engines": {
-		"node": ">=20.12.0"
+		"node": ">=24"
 	},
 	"peerDependencies": {
-		"@opencode-ai/plugin": ">=1.17.3 <2"
+		"@opencode-ai/plugin": ">=1.18.3 <2"
 	},
 	"dependencies": {
-		"zod": "4.1.8"
+		"zod": "4.4.3"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.2.6",
-		"@opencode-ai/plugin": "1.17.3",
-		"bun-types": "latest",
-		"typescript": "^6.0.2"
+		"@biomejs/biome": "2.5.4",
+		"@opencode-ai/plugin": "1.18.3",
+		"@types/bun": "1.3.14",
+		"@types/node": "24.13.3",
+		"typescript": "7.0.2"
+	},
+	"overrides": {
+		"@types/node": "24.13.3"
 	}
 }

package/dist/adapters/opencode/config.d.ts

@@ -1,3 +0,0 @@
-import { type MutableFlowConfig } from "../../config-shared";
-import type { ToolContext } from "./sdk";
-export declare function createConfigHook(ctx: Pick<ToolContext, "worktree" | "directory">): (config: MutableFlowConfig) => Promise<void>;