opencode-plugin-flow 4.3.3 → 4.3.5

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 One short entry per release, written for users deciding whether to upgrade.
 
+## [4.3.5] - 2026-07-08
+
+Flow now stops long autonomous loops more deliberately without making reviews
+shallower:
+
+- Runtime budget telemetry records completed features since the last phase
+  boundary, feature/final review counts, failed review counts, per-feature
+  retry attempts, and host token telemetry availability.
+- Failed feature and final reviews now pause by default, allow only one
+  autonomous repair plus one retry, then block the feature with a compact
+  resume packet instead of continuing to edit in the same root session.
+- Feature completion now records `featureReviewDepth` and rejects evidence that
+  is shallower than the approved feature requires.
+- Large sessions now checkpoint after three completed features and require an
+  explicit `phaseBoundaryAck` in a fresh phase before the next feature starts.
+- Flow planning, running, review, README, maintainer docs, and wiki pages now
+  describe scoped review packets, risk-based review depth, retry limits, and
+  phase-boundary handoffs.
+
+## [4.3.4] - 2026-07-07
+
+Planning and final-review lore sharpened without changing the runtime surface:
+
+- `flow-plan` now has a pre-approval quality gate that checks outcome,
+  requirements, decisions, uncertainty, feature shape, bounded targets,
+  validation levels, dependencies, and review policy before a plan is saved or
+  approved.
+- Planning examples now cover bugfix, UI/frontend, runtime/schema, docs-only,
+  audit-first, and stronger validation patterns, giving agents better few-shot
+  guidance for common Flow sessions.
+- Final review now includes a convergence scan that traces the original goal,
+  approved requirements, every planned feature, changed artifacts, and
+  validation evidence before returning a passing `finalReview`.
+- The new planning checklist is shipped through synced skills and bundled
+  `/flow-plan` and `/flow-auto` command instructions, so fresh and stale skill
+  discovery paths get the same guidance.
+
 ## [4.3.3] - 2026-07-07
 
 Verification only — no behavior change:

package/README.md

@@ -17,8 +17,8 @@ Full project documentation is available in the
 ## Quick start
 
 ```bash
-opencode plugin opencode-plugin-flow@4.3.3 --global --force
-npx -y opencode-plugin-flow@4.3.3 sync
+opencode plugin opencode-plugin-flow@4.3.5 --global --force
+npx -y opencode-plugin-flow@4.3.5 sync
 ```
 
 Restart OpenCode, then give Flow a goal:
@@ -46,6 +46,7 @@ restart.
   ... implementation, tests ...
   flow_feature_complete
                     validationRun: "bun test tests/middleware.test.ts" passed
+                    featureReviewDepth: standard
                     featureReview: passed
   flow_run_start    feature: per-route-config
   ...
@@ -93,8 +94,8 @@ The runtime exposes seven tools:
 | `flow_session_close` | Archive the active session as completed, deferred, or abandoned. |
 
 Review evidence is part of `flow_feature_complete`: every completed feature
-needs a passing `featureReview`, and the final feature also needs a passing
-`finalReview`.
+needs a passing `featureReview` at the feature's planned `reviewDepth`, and the
+final feature also needs a passing `finalReview`.
 
 ## What the runtime enforces
 
@@ -107,6 +108,13 @@ The runtime owns only safety; judgment lives in the skills:
 - Completion requires passing validation evidence: `targeted` scope for
   ordinary features, `broad` scope plus a passing final review for the last
   one.
+- Completion records `featureReviewDepth`; the runtime rejects review evidence
+  that is shallower than the approved feature requires.
+- Failed reviews are bounded: a failed review pauses by default, and autonomous
+  repair is limited to one repair plus one retry before the feature blocks.
+- Long sessions hit phase boundaries after a small number of completed
+  features. Flow returns a compact resume packet and requires explicit
+  `phaseBoundaryAck` before starting the next feature.
 - A session can close as `completed` only after final completion has passed.
 - Crash recovery is built in: stale session locks expire automatically and
   unreadable session files are quarantined with recovery guidance, never
@@ -135,7 +143,7 @@ To update a pinned Flow version, rerun the install command with the new
 version. To inspect skill health:
 
 ```bash
-npx -y opencode-plugin-flow@4.3.3 doctor
+npx -y opencode-plugin-flow@4.3.5 doctor
 ```
 
 ## Experimental: compaction context

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

@@ -28,6 +28,11 @@ export declare function createTools(ctx: unknown): {
                         completed: "completed";
                         blocked: "blocked";
                     }>>;
+                    reviewDepth: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        quick: "quick";
+                        standard: "standard";
+                        detailed: "detailed";
+                    }>>;
                     targets: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
                     validation: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
                     dependsOn: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
@@ -46,6 +51,7 @@ export declare function createTools(ctx: unknown): {
                     id: string;
                     title: string;
                     status?: "pending" | "in_progress" | "completed" | "blocked" | undefined;
+                    reviewDepth?: "quick" | "standard" | "detailed" | undefined;
                     targets?: string[] | undefined;
                     validation?: string[] | undefined;
                     dependsOn?: string[] | undefined;
@@ -63,9 +69,11 @@ export declare function createTools(ctx: unknown): {
         description: string;
         args: {
             featureId: import("zod").ZodOptional<import("zod").ZodString>;
+            phaseBoundaryAck: import("zod").ZodOptional<import("zod").ZodBoolean>;
         };
         execute(args: {
             featureId?: string | undefined;
+            phaseBoundaryAck?: boolean | undefined;
         }, context: ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
     };
     flow_feature_complete: {
@@ -92,6 +100,11 @@ export declare function createTools(ctx: unknown): {
                 targeted: "targeted";
                 broad: "broad";
             }>>;
+            featureReviewDepth: import("zod").ZodOptional<import("zod").ZodEnum<{
+                quick: "quick";
+                standard: "standard";
+                detailed: "detailed";
+            }>>;
             featureReview: import("zod").ZodOptional<import("zod").ZodObject<{
                 status: import("zod").ZodEnum<{
                     passed: "passed";
@@ -156,6 +169,7 @@ export declare function createTools(ctx: unknown): {
                 summary: string;
             }[] | undefined;
             validationScope?: "targeted" | "broad" | undefined;
+            featureReviewDepth?: "quick" | "standard" | "detailed" | undefined;
             featureReview?: {
                 status: "passed" | "failed";
                 summary: string;