opencode-plugin-flow 4.3.9 → 5.0.0

package/dist/domain/transitions.d.ts

@@ -0,0 +1,80 @@
+import type { ExecutionHistoryEntry, Feature, FeatureId, PlanInput, Session, SessionId, WorkerResult } from "./session.js";
+export type TransitionEnvironment = {
+    now(): string;
+    newSessionId(): SessionId;
+};
+export type TransitionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    message: string;
+    recovery?: string;
+    session?: Session;
+};
+export declare function createSession(goal: string, environment: TransitionEnvironment): Session;
+export declare function applyPlan(session: Session, planInput: PlanInput, environment: TransitionEnvironment): TransitionResult<Session>;
+export declare function approvePlan(session: Session, environment: TransitionEnvironment): TransitionResult<Session>;
+export declare function startRun(session: Session, environment: TransitionEnvironment, featureId?: FeatureId): TransitionResult<{
+    session: Session;
+    feature: Feature;
+}>;
+export declare function completeFeature(session: Session, worker: WorkerResult, environment: TransitionEnvironment): TransitionResult<Session>;
+export declare function resetFeature(session: Session, featureId: FeatureId, environment: TransitionEnvironment): TransitionResult<Session>;
+export declare function closeSession(session: Session, kind: "completed" | "deferred" | "abandoned", environment: TransitionEnvironment, summary?: string): TransitionResult<Session>;
+export declare function summarizeSession(session: Session | null): {
+    status: "missing_session";
+    summary: string;
+    nextAction: string;
+    statusSummary?: never;
+    dataNote?: never;
+    workflowData?: never;
+} | {
+    status: "ok";
+    summary: string;
+    statusSummary: string;
+    nextAction: string;
+    dataNote: string;
+    workflowData: {
+        session: {
+            sourceSummary: string;
+            id: SessionId;
+            goal: string;
+            status: import("./session.js").SessionStatus;
+            approval: "approved" | "pending";
+            activeFeature: Feature | null;
+            nextFeature: Feature | null;
+            pendingFeatures: Feature[];
+            progress: {
+                completed: number;
+                total: number;
+                remaining: number;
+            };
+            features: Feature[];
+            budget: {
+                reviewCount: number;
+                failedReviewCount: number;
+                failedReviewAttemptsByFeature: Record<string, number>;
+                orchestration: import("./session.js").OrchestrationTelemetry;
+            };
+            closure: {
+                kind: "completed" | "deferred" | "abandoned";
+                summary: string;
+                recordedAt: string;
+            } | null;
+            lastError: {
+                tool: string;
+                summary: string;
+                recovery?: string | undefined;
+                recordedAt: string;
+            } | null;
+            latestHistoryEntry: ExecutionHistoryEntry | null;
+            historyCount: number;
+            timestamps: {
+                createdAt: string;
+                updatedAt: string;
+                completedAt: string | null;
+            };
+        };
+    };
+};

package/dist/guidance/catalog.d.ts

@@ -0,0 +1,18 @@
+import { type FlowGuidanceId, type FlowGuidanceTopic } from "./ids.js";
+export { FLOW_GUIDANCE_IDS, FLOW_GUIDANCE_TOPICS, type FlowGuidanceId, type FlowGuidanceTopic, } from "./ids.js";
+export type FlowGuidanceFile = {
+    relativePath: string;
+    content: string;
+};
+export type FlowGuidanceDefinition = {
+    name: FlowGuidanceTopic;
+    files: FlowGuidanceFile[];
+};
+export declare const FLOW_GUIDANCE_DEFINITIONS: readonly FlowGuidanceDefinition[];
+export type FlowGuidanceDocument = FlowGuidanceFile & {
+    id: FlowGuidanceId;
+    topic: FlowGuidanceTopic;
+};
+export declare const FLOW_GUIDANCE_DOCUMENTS: readonly FlowGuidanceDocument[];
+export declare function getFlowGuidance(id: FlowGuidanceId): FlowGuidanceDocument;
+export declare function findFlowGuidance(topic: string, relativePath: string): FlowGuidanceDocument | undefined;

package/dist/guidance/ids.d.ts

@@ -0,0 +1,4 @@
+export declare const FLOW_GUIDANCE_TOPICS: readonly ["flow", "flow-plan", "flow-run", "flow-test", "flow-review", "flow-deslop", "flow-ui-quality", "flow-commit"];
+export type FlowGuidanceTopic = (typeof FLOW_GUIDANCE_TOPICS)[number];
+export declare const FLOW_GUIDANCE_IDS: readonly ["flow", "flow/references/recovery-playbook.md", "flow/references/parallel-orchestration.md", "flow/references/parallel-decision.md", "flow/references/parallel-manifest.md", "flow/references/parallel-execution.md", "flow/references/parallel-synthesis.md", "flow/references/parallel-pass-example.md", "flow/references/handoff-format.md", "flow-plan", "flow-plan/references/planning-examples.md", "flow-plan/references/plan-quality-checklist.md", "flow-plan/references/parallel-discovery.md", "flow-run", "flow-run/references/validation-rubric.md", "flow-run/references/audit-rubric.md", "flow-test", "flow-review", "flow-review/references/hidden-reviewer-contract.md", "flow-review/references/review-rubric.md", "flow-deslop", "flow-deslop/references/smell-rubric.md", "flow-deslop/references/refactor-workflow.md", "flow-ui-quality", "flow-ui-quality/references/ui-rubric.md", "flow-ui-quality/references/visual-verification.md", "flow-commit"];
+export type FlowGuidanceId = (typeof FLOW_GUIDANCE_IDS)[number];

package/dist/index.d.ts

@@ -1 +1 @@
-export { default } from "./adapters/opencode/plugin";
+export { default } from "./platform/opencode/plugin.js";