opencode-plugin-flow 4.1.11 → 4.1.14

package/dist/runtime/transitions.d.ts

@@ -0,0 +1,112 @@
+import { type Feature, type PlanInput, type Session } from "./schema";
+export type TransitionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    message: string;
+    recovery?: string;
+    session?: Session;
+};
+export declare function createSession(goal: string): Session;
+export declare function applyPlan(session: Session, planInput: PlanInput): TransitionResult<Session>;
+export declare function approvePlan(session: Session): TransitionResult<Session>;
+export declare function startRun(session: Session, featureId?: string): TransitionResult<{
+    session: Session;
+    feature: Feature;
+}>;
+export declare function completeFeature(session: Session, input: unknown): TransitionResult<Session>;
+export declare function resetFeature(session: Session, featureId: string): TransitionResult<Session>;
+export declare function closeSession(session: Session, kind: "completed" | "deferred" | "abandoned", summary?: string): TransitionResult<Session>;
+export declare function summarizeSession(session: Session | null): {
+    status: string;
+    summary: string;
+    nextAction: string;
+    session?: never;
+} | {
+    status: "completed" | "blocked" | "planning" | "ready" | "running";
+    summary: string;
+    nextAction: string;
+    session: {
+        id: string;
+        goal: string;
+        status: "completed" | "blocked" | "planning" | "ready" | "running";
+        approval: "pending" | "approved";
+        activeFeature: {
+            id: string;
+            title: string;
+            summary: string;
+            status: "pending" | "in_progress" | "completed" | "blocked";
+            targets: string[];
+            validation: string[];
+            dependsOn: string[];
+        } | null;
+        progress: {
+            completed: number;
+            total: number;
+        };
+        features: {
+            id: string;
+            title: string;
+            summary: string;
+            status: "pending" | "in_progress" | "completed" | "blocked";
+            targets: string[];
+            validation: string[];
+            dependsOn: string[];
+        }[];
+        closure: {
+            kind: "completed" | "deferred" | "abandoned";
+            summary: string;
+            recordedAt: string;
+        } | null;
+        lastError: {
+            tool: string;
+            summary: string;
+            recordedAt: string;
+            recovery?: string | undefined;
+        } | null;
+        latestHistoryEntry: {
+            featureId: string;
+            status: "completed" | "blocked" | "needs_input";
+            summary: string;
+            recordedAt: string;
+            artifactsChanged: {
+                path: string;
+            }[];
+            validationRun: {
+                command: string;
+                status: "passed" | "failed";
+                summary: string;
+            }[];
+            validationScope?: "targeted" | "broad" | undefined;
+            featureReview?: {
+                status: "passed" | "failed";
+                summary: string;
+                blockingFindings: {
+                    summary: string;
+                    severity: "blocking" | "advisory";
+                }[];
+            } | undefined;
+            finalReview?: {
+                status: "passed" | "failed";
+                summary: string;
+                blockingFindings: {
+                    summary: string;
+                    severity: "blocking" | "advisory";
+                }[];
+                reviewDepth: "broad" | "detailed";
+            } | undefined;
+            outcome?: {
+                kind: "completed" | "blocked" | "needs_input" | "replan_required";
+                summary?: string | undefined;
+                resolutionHint?: string | undefined;
+            } | undefined;
+        } | null;
+        historyCount: number;
+        timestamps: {
+            createdAt: string;
+            updatedAt: string;
+            completedAt: string | null;
+        };
+    };
+};

package/dist/runtime/workspace.d.ts

@@ -0,0 +1,22 @@
+import { type Session } from "./schema";
+export declare class InvalidFlowWorkspaceRootError extends Error {
+    readonly code = "INVALID_FLOW_WORKSPACE_ROOT";
+    constructor(message: string);
+}
+export declare function normalizeWorkspaceRoot(rawPath: string | undefined): string | null;
+export declare function assertMutableWorkspaceRoot(rawPath: string): string;
+export declare function resolveWorkspaceRoot(context: {
+    worktree?: string;
+    directory?: string;
+}): 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 declare function withSessionLock<T>(worktree: string, task: () => Promise<T>): Promise<T>;
+export declare function loadSession(worktree: string): Promise<Session | null>;
+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>;
+export declare function isAbsoluteOrTraversal(value: string): boolean;

package/package.json

@@ -1,11 +1,20 @@
 {
 	"name": "opencode-plugin-flow",
-	"version": "4.1.11",
+	"version": "4.1.14",
 	"description": "Stateful planning and execution workflow plugin for OpenCode",
 	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ddv1982/flow-opencode.git"
+	},
 	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
 	"exports": {
-		".": "./dist/index.js"
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
 	},
 	"bin": {
 		"opencode-plugin-flow": "./dist/cli.js"
@@ -17,10 +26,12 @@
 		"CHANGELOG.md"
 	],
 	"scripts": {
-		"build": "bun run build:plugin && bun run build:cli",
+		"build": "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 --minify --drop=console --sourcemap=external ./src/index.ts",
 		"build:cli": "bun build --target=node --outdir=./dist --entry-naming=cli.js --banner='#!/usr/bin/env node' --minify ./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",
+		"package:smoke": "bun test tests/package-smoke.test.ts",
 		"test": "bun test tests",
 		"typecheck": "tsc --noEmit",
 		"uninstall:opencode": "bun run ./src/cli.ts uninstall",