swarm-mail 0.5.0 → 1.1.0

package/dist/types/beads-adapter.d.ts

@@ -0,0 +1,397 @@
+/**
+ * BeadsAdapter - High-level interface for beads operations
+ *
+ * This interface abstracts all beads operations (CRUD, dependencies, labels,
+ * comments, epic management) to enable different storage backends.
+ *
+ * ## Design Goals
+ * - Database-agnostic (works with PGLite, SQLite, PostgreSQL, etc.)
+ * - Parallel to SwarmMailAdapter pattern
+ * - Event sourcing with projections for queries
+ * - No implementation details leak through interface
+ *
+ * ## Layering
+ * - DatabaseAdapter: Low-level SQL execution (shared with swarm-mail)
+ * - BeadsAdapter: High-level beads operations (uses DatabaseAdapter internally)
+ * - Plugin tools: Type-safe Zod-validated wrappers (use BeadsAdapter)
+ *
+ * ## Relationship to steveyegge/beads
+ * This is a TypeScript rewrite of steveyegge/beads internal/storage/storage.go
+ * interface, adapted for event sourcing and shared PGLite database.
+ */
+import type { DatabaseAdapter } from "./database.js";
+export type BeadStatus = "open" | "in_progress" | "blocked" | "closed" | "tombstone";
+export type BeadType = "bug" | "feature" | "task" | "epic" | "chore" | "message";
+export type DependencyRelationship = "blocks" | "related" | "parent-child" | "discovered-from" | "replies-to" | "relates-to" | "duplicates" | "supersedes";
+/**
+ * Full bead record (projection)
+ */
+export interface Bead {
+    id: string;
+    project_key: string;
+    type: BeadType;
+    status: BeadStatus;
+    title: string;
+    description: string | null;
+    priority: number;
+    parent_id: string | null;
+    assignee: string | null;
+    created_at: number;
+    updated_at: number;
+    closed_at: number | null;
+    closed_reason: string | null;
+    deleted_at: number | null;
+    deleted_by: string | null;
+    delete_reason: string | null;
+    created_by: string | null;
+}
+/**
+ * Bead creation options
+ */
+export interface CreateBeadOptions {
+    title: string;
+    description?: string;
+    type: BeadType;
+    priority?: number;
+    parent_id?: string;
+    assignee?: string;
+    created_by?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Bead update options
+ */
+export interface UpdateBeadOptions {
+    title?: string;
+    description?: string;
+    priority?: number;
+    assignee?: string;
+    updated_by?: string;
+}
+/**
+ * Bead query filters
+ */
+export interface QueryBeadsOptions {
+    status?: BeadStatus | BeadStatus[];
+    type?: BeadType | BeadType[];
+    parent_id?: string;
+    assignee?: string;
+    labels?: string[];
+    limit?: number;
+    offset?: number;
+    /** Include deleted beads */
+    include_deleted?: boolean;
+    /** Include children for epics */
+    include_children?: boolean;
+}
+export interface BeadAdapter {
+    /**
+     * Create a new bead
+     *
+     * Emits: bead_created event
+     */
+    createBead(projectKey: string, options: CreateBeadOptions, projectPath?: string): Promise<Bead>;
+    /**
+     * Get a bead by ID
+     */
+    getBead(projectKey: string, beadId: string, projectPath?: string): Promise<Bead | null>;
+    /**
+     * Query beads with filters
+     */
+    queryBeads(projectKey: string, options?: QueryBeadsOptions, projectPath?: string): Promise<Bead[]>;
+    /**
+     * Update bead fields
+     *
+     * Emits: bead_updated event
+     */
+    updateBead(projectKey: string, beadId: string, options: UpdateBeadOptions, projectPath?: string): Promise<Bead>;
+    /**
+     * Change bead status
+     *
+     * Emits: bead_status_changed event
+     */
+    changeBeadStatus(projectKey: string, beadId: string, toStatus: BeadStatus, options?: {
+        reason?: string;
+        changed_by?: string;
+    }, projectPath?: string): Promise<Bead>;
+    /**
+     * Close a bead
+     *
+     * Emits: bead_closed event
+     */
+    closeBead(projectKey: string, beadId: string, reason: string, options?: {
+        closed_by?: string;
+        files_touched?: string[];
+        duration_ms?: number;
+    }, projectPath?: string): Promise<Bead>;
+    /**
+     * Reopen a closed bead
+     *
+     * Emits: bead_reopened event
+     */
+    reopenBead(projectKey: string, beadId: string, options?: {
+        reason?: string;
+        reopened_by?: string;
+    }, projectPath?: string): Promise<Bead>;
+    /**
+     * Delete a bead (soft delete)
+     *
+     * Emits: bead_deleted event
+     */
+    deleteBead(projectKey: string, beadId: string, options?: {
+        reason?: string;
+        deleted_by?: string;
+    }, projectPath?: string): Promise<void>;
+}
+/**
+ * Dependency between beads
+ */
+export interface BeadDependency {
+    bead_id: string;
+    depends_on_id: string;
+    relationship: DependencyRelationship;
+    created_at: number;
+    created_by: string | null;
+}
+export interface DependencyAdapter {
+    /**
+     * Add a dependency between beads
+     *
+     * Emits: bead_dependency_added event
+     */
+    addDependency(projectKey: string, beadId: string, dependsOnId: string, relationship: DependencyRelationship, options?: {
+        reason?: string;
+        added_by?: string;
+    }, projectPath?: string): Promise<BeadDependency>;
+    /**
+     * Remove a dependency
+     *
+     * Emits: bead_dependency_removed event
+     */
+    removeDependency(projectKey: string, beadId: string, dependsOnId: string, relationship: DependencyRelationship, options?: {
+        reason?: string;
+        removed_by?: string;
+    }, projectPath?: string): Promise<void>;
+    /**
+     * Get all dependencies for a bead
+     */
+    getDependencies(projectKey: string, beadId: string, projectPath?: string): Promise<BeadDependency[]>;
+    /**
+     * Get beads that depend on this bead
+     */
+    getDependents(projectKey: string, beadId: string, projectPath?: string): Promise<BeadDependency[]>;
+    /**
+     * Check if a bead is blocked
+     *
+     * Uses blocked_beads_cache for fast lookups
+     */
+    isBlocked(projectKey: string, beadId: string, projectPath?: string): Promise<boolean>;
+    /**
+     * Get all blockers for a bead
+     */
+    getBlockers(projectKey: string, beadId: string, projectPath?: string): Promise<string[]>;
+}
+/**
+ * Label on a bead
+ */
+export interface BeadLabel {
+    bead_id: string;
+    label: string;
+    created_at: number;
+}
+export interface LabelAdapter {
+    /**
+     * Add a label to a bead
+     *
+     * Emits: bead_label_added event
+     */
+    addLabel(projectKey: string, beadId: string, label: string, options?: {
+        added_by?: string;
+    }, projectPath?: string): Promise<BeadLabel>;
+    /**
+     * Remove a label from a bead
+     *
+     * Emits: bead_label_removed event
+     */
+    removeLabel(projectKey: string, beadId: string, label: string, options?: {
+        removed_by?: string;
+    }, projectPath?: string): Promise<void>;
+    /**
+     * Get all labels for a bead
+     */
+    getLabels(projectKey: string, beadId: string, projectPath?: string): Promise<string[]>;
+    /**
+     * Get all beads with a label
+     */
+    getBeadsWithLabel(projectKey: string, label: string, projectPath?: string): Promise<Bead[]>;
+}
+/**
+ * Comment on a bead
+ */
+export interface BeadComment {
+    id: number;
+    bead_id: string;
+    author: string;
+    body: string;
+    parent_id: number | null;
+    created_at: number;
+    updated_at: number | null;
+}
+export interface CommentAdapter {
+    /**
+     * Add a comment to a bead
+     *
+     * Emits: bead_comment_added event
+     */
+    addComment(projectKey: string, beadId: string, author: string, body: string, options?: {
+        parent_id?: number;
+        metadata?: Record<string, unknown>;
+    }, projectPath?: string): Promise<BeadComment>;
+    /**
+     * Update a comment
+     *
+     * Emits: bead_comment_updated event
+     */
+    updateComment(projectKey: string, commentId: number, newBody: string, updated_by: string, projectPath?: string): Promise<BeadComment>;
+    /**
+     * Delete a comment
+     *
+     * Emits: bead_comment_deleted event
+     */
+    deleteComment(projectKey: string, commentId: number, deleted_by: string, options?: {
+        reason?: string;
+    }, projectPath?: string): Promise<void>;
+    /**
+     * Get all comments for a bead
+     */
+    getComments(projectKey: string, beadId: string, projectPath?: string): Promise<BeadComment[]>;
+}
+export interface EpicAdapter {
+    /**
+     * Add a child bead to an epic
+     *
+     * Emits: bead_epic_child_added event
+     */
+    addChildToEpic(projectKey: string, epicId: string, childId: string, options?: {
+        child_index?: number;
+        added_by?: string;
+    }, projectPath?: string): Promise<void>;
+    /**
+     * Remove a child from an epic
+     *
+     * Emits: bead_epic_child_removed event
+     */
+    removeChildFromEpic(projectKey: string, epicId: string, childId: string, options?: {
+        reason?: string;
+        removed_by?: string;
+    }, projectPath?: string): Promise<void>;
+    /**
+     * Get all children of an epic
+     */
+    getEpicChildren(projectKey: string, epicId: string, projectPath?: string): Promise<Bead[]>;
+    /**
+     * Check if epic is eligible for closure
+     *
+     * Returns true if all children are closed
+     */
+    isEpicClosureEligible(projectKey: string, epicId: string, projectPath?: string): Promise<boolean>;
+}
+export interface QueryAdapter {
+    /**
+     * Get next ready bead (unblocked, highest priority)
+     *
+     * Implements steveyegge/beads ready_issues view logic
+     */
+    getNextReadyBead(projectKey: string, projectPath?: string): Promise<Bead | null>;
+    /**
+     * Get all in-progress beads
+     */
+    getInProgressBeads(projectKey: string, projectPath?: string): Promise<Bead[]>;
+    /**
+     * Get all blocked beads with their blockers
+     */
+    getBlockedBeads(projectKey: string, projectPath?: string): Promise<Array<{
+        bead: Bead;
+        blockers: string[];
+    }>>;
+    /**
+     * Mark bead as dirty for JSONL export
+     */
+    markDirty(projectKey: string, beadId: string, projectPath?: string): Promise<void>;
+    /**
+     * Get all dirty beads (for incremental export)
+     */
+    getDirtyBeads(projectKey: string, projectPath?: string): Promise<string[]>;
+    /**
+     * Clear dirty flag after export
+     */
+    clearDirty(projectKey: string, beadId: string, projectPath?: string): Promise<void>;
+}
+export interface BeadsSchemaAdapter {
+    /**
+     * Run beads-specific migrations
+     *
+     * Adds beads tables to shared PGLite database
+     */
+    runMigrations(projectPath?: string): Promise<void>;
+    /**
+     * Get beads statistics
+     */
+    getBeadsStats(projectPath?: string): Promise<{
+        total_beads: number;
+        open: number;
+        in_progress: number;
+        blocked: number;
+        closed: number;
+        by_type: Record<BeadType, number>;
+    }>;
+    /**
+     * Rebuild blocked beads cache
+     *
+     * Recalculates all blockers and updates blocked_beads_cache
+     */
+    rebuildBlockedCache(projectKey: string, projectPath?: string): Promise<void>;
+}
+/**
+ * BeadsAdapter - Complete interface for beads operations
+ *
+ * Combines all sub-adapters into a single interface.
+ * Implementations provide a DatabaseAdapter and implement all operations.
+ *
+ * This adapter shares the same PGLite database with SwarmMailAdapter.
+ */
+export interface BeadsAdapter extends BeadAdapter, DependencyAdapter, LabelAdapter, CommentAdapter, EpicAdapter, QueryAdapter, BeadsSchemaAdapter {
+    /**
+     * Get the underlying database adapter
+     *
+     * Same instance as SwarmMailAdapter uses
+     */
+    getDatabase(projectPath?: string): Promise<DatabaseAdapter>;
+    /**
+     * Close the database connection
+     *
+     * Note: This is shared with SwarmMailAdapter, so closing should be coordinated
+     */
+    close(projectPath?: string): Promise<void>;
+    /**
+     * Close all database connections
+     */
+    closeAll(): Promise<void>;
+}
+/**
+ * BeadsAdapterFactory - Function that creates a BeadsAdapter instance
+ *
+ * Adapters export a factory function with this signature.
+ *
+ * @example
+ * ```typescript
+ * import { createPGLiteBeadsAdapter } from '@opencode/swarm-mail/adapters/pglite-beads';
+ *
+ * const adapter = createPGLiteBeadsAdapter({ path: './streams.db' });
+ * ```
+ */
+export type BeadsAdapterFactory = (config: {
+    path?: string;
+    timeout?: number;
+}) => BeadsAdapter;
+//# sourceMappingURL=beads-adapter.d.ts.map

package/dist/types/beads-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads-adapter.d.ts","sourceRoot":"","sources":["../../src/types/beads-adapter.ts"],"names":[],"mappings":"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"}

package/dist/types/database.d.ts

@@ -89,6 +89,73 @@ export interface DatabaseAdapter {
      * If not provided, swarm-mail assumes connection is managed externally.
      */
     close?(): Promise<void>;
+    /**
+     * Force a checkpoint to flush WAL to data files (optional)
+     *
+     * PostgreSQL CHECKPOINT command forces write-ahead log (WAL) to be written
+     * to data files, allowing WAL to be recycled. Critical for preventing WAL
+     * bloat in embedded databases like PGLite.
+     *
+     * Root cause from pdf-brain: PGLite accumulated 930 WAL files (930MB) without
+     * explicit CHECKPOINT, causing WASM OOM crash.
+     *
+     * Call after batch operations:
+     * - Migration batches
+     * - Bulk event appends
+     * - Large projection updates
+     *
+     * @example
+     * ```typescript
+     * await db.exec("CREATE TABLE ...");
+     * await db.checkpoint?.(); // Force WAL flush
+     * ```
+     */
+    checkpoint?(): Promise<void>;
+    /**
+     * Get WAL statistics (optional)
+     *
+     * Returns current size and file count of write-ahead log (WAL) files.
+     * Use for monitoring WAL bloat to prevent WASM OOM crashes in PGLite.
+     *
+     * For PGLite: checks pg_wal directory in dataDir
+     * For PostgreSQL: queries pg_stat_wal (if available)
+     *
+     * @returns WAL stats with size in bytes and file count
+     *
+     * @example
+     * ```typescript
+     * const stats = await db.getWalStats?.();
+     * console.log(`WAL: ${stats.walSize / 1024 / 1024}MB, ${stats.walFileCount} files`);
+     * ```
+     */
+    getWalStats?(): Promise<{
+        walSize: number;
+        walFileCount: number;
+    }>;
+    /**
+     * Check WAL health against threshold (optional)
+     *
+     * Monitors WAL size and warns when it exceeds a configurable threshold.
+     * Default threshold: 100MB (warns before critical 930MB from pdf-brain crash).
+     *
+     * Returns health status with message describing current WAL state.
+     *
+     * @param thresholdMb - Warning threshold in megabytes (default: 100)
+     * @returns Health result with boolean status and descriptive message
+     *
+     * @example
+     * ```typescript
+     * const health = await db.checkWalHealth?.(100);
+     * if (!health.healthy) {
+     *   console.warn(health.message);
+     *   await db.checkpoint?.(); // Trigger checkpoint
+     * }
+     * ```
+     */
+    checkWalHealth?(thresholdMb?: number): Promise<{
+        healthy: boolean;
+        message: string;
+    }>;
 }
 /**
  * Database configuration options

package/dist/types/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/types/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,EAAE,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;;;OAKG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE;QACP,0CAA0C;QAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,+BAA+B;QAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;KACd,CAAC;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,GAAG,eAAe,CAE7E"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/types/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,EAAE,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;;;OAKG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,CACd,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE;QACP,0CAA0C;QAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,+BAA+B;QAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;KACd,CAAC;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,GAAG,eAAe,CAE7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarm-mail",
-  "version": "0.5.0",
+  "version": "1.1.0",
   "description": "Event sourcing primitives for multi-agent coordination. Local-first, no external servers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,6 +19,10 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/joelhooks/opencode-swarm-plugin"
@@ -31,8 +35,7 @@
     "test:beads": "bun test src/beads/ --timeout 60000",
     "test:integration": "vitest run src/streams/**/*.integration-test.ts --testTimeout 60000",
     "test:all": "bun test src/ --timeout 60000",
-    "typecheck": "tsc --noEmit",
-    "publish:pkg": "npm publish --access public --provenance"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.3.14",