opencode-plugin-flow 4.4.0 → 5.1.0

package/dist/application/ports/session-repository.d.ts

@@ -0,0 +1,18 @@
+import type { Session } from "../../domain/session.js";
+import type { EvidenceArtifactStore } from "./evidence-artifact-store.js";
+import type { SourceIdentityProvider } from "./source-identity.js";
+export declare class ArchivedSessionLookupError extends Error {
+    readonly code = "FLOW_ARCHIVE_LOOKUP_FAILED";
+    constructor(message: string, options?: ErrorOptions);
+}
+export type SessionTransaction = EvidenceArtifactStore & SourceIdentityProvider & {
+    load(): Promise<Session | null>;
+    findArchivedByOperationId(operationId: string): Promise<Session | null>;
+    save(session: Session): Promise<Session>;
+    archiveAndClear(session: Session): Promise<void>;
+    quarantineUnreadable(): Promise<string | null>;
+};
+export interface SessionRepository {
+    read(): Promise<Session | null>;
+    transact<T>(task: (transaction: SessionTransaction) => Promise<T>): Promise<T>;
+}

package/dist/application/ports/source-identity.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Application port for the authoritative source/worktree identity boundary.
+ *
+ * The provider derives a canonical, deterministic digest of the workspace
+ * source state (the "A1 canonical source digest"). It is the single trusted
+ * producer of source identity used by the transactional completion boundary.
+ * Callers never assert source identity; Flow recomputes it and binds evidence
+ * to it. The source-v2 manifest is materialization-sensitive:
+ * an indexed sparse-checkout path absent from disk is distinct from the same
+ * path materialized in a dense worktree.
+ */
+export type SourceDigest = `sha256:${string}`;
+export type SourceIdentity = {
+    /** Canonical lowercase SHA-256 digest of the source state. */
+    readonly digest: SourceDigest;
+    /** Whether the digest was derived from a Git manifest or a full-tree walk. */
+    readonly mode: "git" | "non-git";
+    /** Number of source entries that contributed to the digest. */
+    readonly entryCount: number;
+};
+export interface SourceIdentityProvider {
+    /**
+     * Compute the canonical source digest for the workspace. Implementations
+     * must fail closed on unsafe symlinks, unreadable entries, resource limits,
+     * or a workspace mutation observed while the source is being measured.
+     */
+    computeSourceIdentity(): Promise<SourceIdentity>;
+}
+/**
+ * Base class for source-identity failures. The message never carries absolute
+ * paths, file contents, or command output; only a bounded, safe reason.
+ */
+export declare class SourceIdentityError extends Error {
+    readonly code: string;
+    constructor(message: string, options?: ErrorOptions);
+}
+/** A symlink whose target escapes the workspace root or is absolute. */
+export declare class SourceIdentityUnsafeSymlinkError extends SourceIdentityError {
+    readonly code = "FLOW_SOURCE_IDENTITY_UNSAFE_SYMLINK";
+    constructor(message: string, options?: ErrorOptions);
+}
+/** An entry that could not be read; measurement never silently skips state. */
+export declare class SourceIdentityUnreadableError extends SourceIdentityError {
+    readonly code = "FLOW_SOURCE_IDENTITY_UNREADABLE";
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The source exceeded the bounded file-count or byte budget. */
+export declare class SourceIdentityOverflowError extends SourceIdentityError {
+    readonly code = "FLOW_SOURCE_IDENTITY_OVERFLOW";
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The workspace changed while it was being measured. */
+export declare class SourceIdentityRaceError extends SourceIdentityError {
+    readonly code = "FLOW_SOURCE_IDENTITY_RACE";
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Git enumeration failed for a Git workspace. */
+export declare class SourceIdentityGitError extends SourceIdentityError {
+    readonly code = "FLOW_SOURCE_IDENTITY_GIT";
+    constructor(message: string, options?: ErrorOptions);
+}

package/dist/application/replay/canonical-json.d.ts

@@ -0,0 +1,7 @@
+export type CanonicalJsonValue = null | boolean | number | string | readonly CanonicalJsonValue[] | {
+    readonly [key: string]: CanonicalJsonValue;
+};
+/** Stable, whitespace-free JSON with recursively sorted object keys. */
+export declare function canonicalizeReplayJson(value: CanonicalJsonValue): string;
+export declare const canonicalizeJson: typeof canonicalizeReplayJson;
+export declare const canonicalReplayJson: typeof canonicalizeReplayJson;