opencode-plugin-flow 5.1.0 → 5.2.0

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

@@ -1,9 +1,10 @@
 import { type FlowResponse, type FlowService } from "../../application/flow-service.js";
 export declare function createWorkspaceFlowService(workspace: string): FlowService;
-export declare function flowStatus(workspace: string, input?: unknown): Promise<FlowResponse>;
+export declare function flowStatus(workspace: string, input: unknown): 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 flowReviewStart(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/infrastructure/fs/workspace.d.ts

@@ -11,6 +11,10 @@ export declare class ArchiveCollisionError extends Error {
     readonly code = "FLOW_ARCHIVE_COLLISION";
     constructor(message: string, options?: ErrorOptions);
 }
+export declare class UnclosedSessionArchiveError extends Error {
+    readonly code = "FLOW_ARCHIVE_REQUIRES_CLOSURE";
+    constructor(message: string);
+}
 export declare function normalizeWorkspaceRoot(rawPath: string | undefined): string | null;
 export declare function assertMutableWorkspaceRoot(rawPath: string): string;
 export declare function resolveWorkspaceRoot(context: {
@@ -20,14 +24,39 @@ export declare function resolveWorkspaceRoot(context: {
 export declare function flowDir(worktree: string): string;
 export declare function sessionPath(worktree: string): string;
 export declare function historyDir(worktree: string): string;
+/**
+ * Map the exact, case-sensitive session identity into a portable lowercase
+ * archive component. The fixed digest avoids both case-fold collisions and
+ * filesystem component growth while lookup still verifies the parsed id.
+ */
+export declare function archivedSessionFilename(sessionId: string): string;
 export declare function archivedSessionPath(worktree: string, sessionId: string): string;
+type ArchiveAndClearTestHooks = {
+    afterHistoryPinned?: (() => Promise<void>) | undefined;
+    afterFlowPinnedBeforeDelete?: (() => Promise<void>) | undefined;
+    pinnedHelperTestExecutable?: string | undefined;
+    pinnedHelperReadyTimeoutMs?: number | undefined;
+    pinnedHelperCompletionTimeoutMs?: number | undefined;
+};
 export type SessionLockOptions = {
     timeoutMs?: number;
 };
 export declare function withSessionLock<T>(worktree: string, task: () => Promise<T>, lockOptions?: SessionLockOptions): Promise<T>;
 export declare function loadSession(worktree: string): Promise<Session | null>;
+/**
+ * Find any canonical archive containing an operation id. Close-start preflight
+ * uses this wider lookup because a retry handle must not collide with any
+ * historical mutation identity.
+ */
 export declare function findArchivedSessionByOperationId(worktree: string, operationId: string): Promise<Session | null>;
-export declare function quarantineUnreadableSession(worktree: string): Promise<string | null>;
+/**
+ * Recover only the archive whose accepted closure owns this retry handle.
+ * A later session may reuse the same text for a non-close mutation without
+ * making the original accepted close ambiguous.
+ */
+export declare function findArchivedSessionByCloseRetryOperationId(worktree: string, operationId: string): Promise<Session | null>;
+export declare function quarantineUnreadableSession(worktree: string, hooks?: ArchiveAndClearTestHooks): Promise<string | null>;
 export declare function saveSession(worktree: string, session: Session): Promise<Session>;
-export declare function archiveAndClearSession(worktree: string, session: Session): Promise<void>;
+export declare function archiveAndClearSession(worktree: string, session: Session, hooks?: ArchiveAndClearTestHooks): Promise<void>;
 export declare function ensureFlowGitignore(worktree: string): Promise<void>;
+export {};

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

@@ -1,6 +1,4 @@
 import { type Hooks } from "@opencode-ai/plugin";
-export type FlowHostInputOperation = "status" | "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

@@ -1,9 +1,10 @@
 /**
- * Frozen historical prompt assembly used only for comparative evaluation.
+ * Frozen comparison prompt assembly used only for compiler-shape 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
+ * topology while retaining the current Session v4 lifecycle and nested wire
+ * contract. 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<{

package/dist/prompt-quality.d.ts

@@ -44,6 +44,13 @@ export type PromptRepetitionClassification = {
     occurrences: string[];
     rationale: string;
 };
+export type LifecycleFlatRequestExample = {
+    tool: "flow_status" | "flow_review_start" | "flow_feature_complete" | "flow_session_close";
+    line: number;
+    topLevelField: string | null;
+};
+/** Finds lifecycle-tool examples that bypass the required `request` envelope. */
+export declare function auditLifecycleFlatRequestExamples(text: string): LifecycleFlatRequestExample[];
 export declare function measurePromptText(options: {
     surface: string;
     variant: FlowPromptVariant | "runtime";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-plugin-flow",
-	"version": "5.1.0",
+	"version": "5.2.0",
 	"description": "Stateful planning and execution workflow plugin for OpenCode",
 	"type": "module",
 	"repository": {
@@ -39,6 +39,10 @@
 		"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:lifecycle:invariants": "bun test tests/review-lifecycle-coverage-map.test.ts tests/lifecycle-invariant-sequences.test.ts tests/lifecycle-invariant-v4-only.test.ts",
+		"test:lifecycle:recovery": "bun test tests/lifecycle-invariant-recovery.test.ts",
+		"test:contracts": "bun test tests/lifecycle-invariant-contracts.test.ts tests/opencode-schema-contract.test.ts",
+		"verify:lifecycle": "bun run test:lifecycle:invariants && bun run test:lifecycle:recovery && bun run test:contracts",
 		"test": "bun test tests",
 		"typecheck": "tsc --noEmit",
 		"check": "bun run typecheck && bun run lint && bun run prompt:quality && bun run build && bun run test"