opencastle 0.10.7 → 0.12.0

package/README.md

@@ -40,6 +40,10 @@ One command. Any repo. Any IDE.
 npx opencastle init
 ```
 
+<p align="center">
+  <img src="opencastle-init.gif" alt="npx opencastle init" width="720" />
+</p>
+
 The CLI asks about your IDEs and stack. It installs agents, skills, and MCP servers tailored to your project.
 
 You can select multiple IDEs and tools — the output is adapted for each one.

package/bin/cli.mjs

@@ -24,6 +24,8 @@ const HELP = `
     run         Process a task queue from a spec file autonomously
     dashboard   View agent observability dashboard in your browser
     doctor      Validate your OpenCastle setup
+    log         Append a structured event to the observability log
+    lesson      Append a structured lesson to LESSONS-LEARNED.md
 
   Options:
     --dry-run        Preview what a command would change without writing files
@@ -51,6 +53,8 @@ const commands = {
   run: () => import('../dist/cli/run.js'),
   dashboard: () => import('../dist/cli/dashboard.js'),
   doctor: () => import('../dist/cli/doctor.js'),
+  log: () => import('../dist/cli/log.js'),
+  lesson: () => import('../dist/cli/lesson.js'),
 }
 
 if (!commands[command]) {

package/dist/cli/convoy/events.d.ts

@@ -0,0 +1,10 @@
+import type { ConvoyStore } from './store.js';
+export interface ConvoyEventEmitter {
+    emit(type: string, data?: Record<string, unknown>, ids?: {
+        convoy_id?: string;
+        task_id?: string;
+        worker_id?: string;
+    }): void;
+}
+export declare function createEventEmitter(store: ConvoyStore, logsDir?: string): ConvoyEventEmitter;
+//# sourceMappingURL=events.d.ts.map

package/dist/cli/convoy/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,IAAI,CAAA;CACR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA6B3F"}

package/dist/cli/convoy/events.js

@@ -0,0 +1,27 @@
+import { appendEvent as appendNdjson } from '../log.js';
+export function createEventEmitter(store, logsDir) {
+    return {
+        emit(type, data, ids) {
+            const now = new Date().toISOString();
+            store.insertEvent({
+                convoy_id: ids?.convoy_id ?? null,
+                task_id: ids?.task_id ?? null,
+                worker_id: ids?.worker_id ?? null,
+                type,
+                data: data !== undefined ? JSON.stringify(data) : null,
+                created_at: now,
+            });
+            appendNdjson({
+                timestamp: now,
+                type,
+                convoy_id: ids?.convoy_id ?? null,
+                task_id: ids?.task_id ?? null,
+                worker_id: ids?.worker_id ?? null,
+                ...(data ?? {}),
+            }, logsDir ?? null).catch(() => {
+                // fire-and-forget: NDJSON write failure must not crash the convoy engine
+            });
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/cli/convoy/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,WAAW,CAAA;AAWvD,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,OAAgB;IACrE,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG;YAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAEpC,KAAK,CAAC,WAAW,CAAC;gBAChB,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;gBACjC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI;gBAC7B,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;gBACjC,IAAI;gBACJ,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtD,UAAU,EAAE,GAAG;aAChB,CAAC,CAAA;YAEF,YAAY,CACV;gBACE,SAAS,EAAE,GAAG;gBACd,IAAI;gBACJ,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;gBACjC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI;gBAC7B,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;gBACjC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;aAChB,EACD,OAAO,IAAI,IAAI,CAChB,CAAC,KAAK,CAAC,GAAG,EAAE;gBACX,yEAAyE;YAC3E,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/cli/convoy/events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.test.d.ts.map

package/dist/cli/convoy/events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/events.test.ts"],"names":[],"mappings":""}

package/dist/cli/convoy/events.test.js

@@ -0,0 +1,94 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createConvoyStore } from './store.js';
+import { createEventEmitter } from './events.js';
+vi.mock('../log.js', () => ({
+    appendEvent: vi.fn().mockResolvedValue(undefined),
+}));
+import { appendEvent } from '../log.js';
+const mockAppend = vi.mocked(appendEvent);
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), 'emitter-test-'));
+    store = createConvoyStore(join(tmpDir, 'test.db'));
+    vi.clearAllMocks();
+    store.insertConvoy({
+        id: 'c1',
+        name: 'Test',
+        spec_hash: 'x',
+        status: 'pending',
+        branch: null,
+        created_at: new Date().toISOString(),
+        spec_yaml: 'name: test',
+    });
+});
+afterEach(() => {
+    store.close();
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+describe('createEventEmitter', () => {
+    it('inserts the event into SQLite', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('task_started', { msg: 'started' }, { convoy_id: 'c1' });
+        const events = store.getEvents('c1');
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('task_started');
+        expect(events[0].convoy_id).toBe('c1');
+    });
+    it('serializes event data to JSON in SQLite', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('task_done', { exitCode: 0, output: 'ok' }, { convoy_id: 'c1' });
+        const events = store.getEvents('c1');
+        const parsed = JSON.parse(events[0].data);
+        expect(parsed.exitCode).toBe(0);
+        expect(parsed.output).toBe('ok');
+    });
+    it('stores null data when no data object is provided', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('heartbeat', undefined, { convoy_id: 'c1' });
+        const events = store.getEvents('c1');
+        expect(events[0].data).toBeNull();
+    });
+    it('calls appendEvent for NDJSON dual-write', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('convoy_started', { name: 'test' }, { convoy_id: 'c1' });
+        expect(mockAppend).toHaveBeenCalledOnce();
+    });
+    it('passes logs dir to appendEvent', () => {
+        const emitter = createEventEmitter(store, '/some/logs');
+        emitter.emit('convoy_started', {}, { convoy_id: 'c1' });
+        expect(mockAppend).toHaveBeenCalledWith(expect.objectContaining({ type: 'convoy_started', convoy_id: 'c1' }), '/some/logs');
+    });
+    it('defaults all ids to null when ids are not provided', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('generic_event');
+        const db = require('node:sqlite').DatabaseSync;
+        // Verify via NDJSON mock payload
+        expect(mockAppend).toHaveBeenCalledWith(expect.objectContaining({
+            convoy_id: null,
+            task_id: null,
+            worker_id: null,
+        }), null);
+    });
+    it('includes all provided ids in the NDJSON record', () => {
+        const emitter = createEventEmitter(store, tmpDir);
+        emitter.emit('worker_spawned', {}, { convoy_id: 'c1', task_id: 't1', worker_id: 'w1' });
+        expect(mockAppend).toHaveBeenCalledWith(expect.objectContaining({ convoy_id: 'c1', task_id: 't1', worker_id: 'w1' }), tmpDir);
+    });
+    it('SQLite event stores correct ids', () => {
+        const emitter = createEventEmitter(store);
+        emitter.emit('worker_done', {}, { convoy_id: 'c1', task_id: 'task-x', worker_id: 'wkr-y' });
+        const events = store.getEvents('c1');
+        expect(events[0].task_id).toBe('task-x');
+        expect(events[0].worker_id).toBe('wkr-y');
+    });
+    it('does not throw if NDJSON write fails', () => {
+        mockAppend.mockRejectedValueOnce(new Error('disk full'));
+        const emitter = createEventEmitter(store);
+        expect(() => emitter.emit('test', {}, { convoy_id: 'c1' })).not.toThrow();
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/cli/convoy/events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.js","sourceRoot":"","sources":["../../../src/cli/convoy/events.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/convoy/store.d.ts

@@ -0,0 +1,23 @@
+import type { ConvoyRecord, ConvoyStatus, TaskRecord, ConvoyTaskStatus, WorkerRecord, WorkerStatus, EventRecord } from './types.js';
+export interface ConvoyStore {
+    insertConvoy(record: Omit<ConvoyRecord, 'started_at' | 'finished_at'>): void;
+    getConvoy(id: string): ConvoyRecord | undefined;
+    updateConvoyStatus(id: string, status: ConvoyStatus, extra?: {
+        started_at?: string;
+        finished_at?: string;
+    }): void;
+    insertTask(record: Omit<TaskRecord, 'worker_id' | 'worktree' | 'output' | 'exit_code' | 'started_at' | 'finished_at'>): void;
+    getTask(id: string, convoyId: string): TaskRecord | undefined;
+    getTasksByConvoy(convoyId: string): TaskRecord[];
+    updateTaskStatus(id: string, convoyId: string, status: ConvoyTaskStatus, extra?: Partial<Pick<TaskRecord, 'worker_id' | 'worktree' | 'output' | 'exit_code' | 'started_at' | 'finished_at' | 'retries'>>): void;
+    getReadyTasks(convoyId: string): TaskRecord[];
+    insertWorker(record: Omit<WorkerRecord, 'finished_at' | 'last_heartbeat'>): void;
+    getWorker(id: string): WorkerRecord | undefined;
+    updateWorkerStatus(id: string, status: WorkerStatus, extra?: Partial<Pick<WorkerRecord, 'finished_at' | 'last_heartbeat' | 'pid'>>): void;
+    insertEvent(record: Omit<EventRecord, 'id'>): void;
+    getEvents(convoyId: string): EventRecord[];
+    withTransaction<T>(fn: () => T): T;
+    close(): void;
+}
+export declare function createConvoyStore(dbPath: string): ConvoyStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/cli/convoy/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,CAAC,GAAG,IAAI,CAAA;IAC5E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC/C,kBAAkB,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,IAAI,CAAA;IACP,UAAU,CACR,MAAM,EAAE,IAAI,CACV,UAAU,EACV,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CACjF,GACA,IAAI,CAAA;IACP,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;IAC7D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAAA;IAChD,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,OAAO,CACb,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC,CAC/G,GACA,IAAI,CAAA;IACP,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAAA;IAC7C,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,gBAAgB,CAAC,GAAG,IAAI,CAAA;IAChF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC/C,kBAAkB,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,gBAAgB,GAAG,KAAK,CAAC,CAAC,GAC5E,IAAI,CAAA;IACP,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,IAAI,CAAA;IAClD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAAA;IAC1C,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IAClC,KAAK,IAAI,IAAI,CAAA;CACd;AAgQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAE7D"}

package/dist/cli/convoy/store.js

@@ -0,0 +1,210 @@
+import { DatabaseSync } from 'node:sqlite';
+const SCHEMA_VERSION = 1;
+class ConvoyStoreImpl {
+    db;
+    constructor(dbPath) {
+        this.db = new DatabaseSync(dbPath);
+        this.db.exec('PRAGMA journal_mode = WAL');
+        this.db.exec('PRAGMA synchronous = NORMAL');
+        this.initSchema();
+    }
+    initSchema() {
+        const row = this.db.prepare('PRAGMA user_version').get();
+        if (row.user_version === 0) {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS convoy (
+          id          TEXT PRIMARY KEY,
+          name        TEXT NOT NULL,
+          spec_hash   TEXT NOT NULL,
+          status      TEXT NOT NULL DEFAULT 'pending',
+          branch      TEXT,
+          created_at  TEXT NOT NULL,
+          started_at  TEXT,
+          finished_at TEXT,
+          spec_yaml   TEXT NOT NULL
+        );
+
+        CREATE TABLE IF NOT EXISTS task (
+          id          TEXT PRIMARY KEY,
+          convoy_id   TEXT NOT NULL REFERENCES convoy(id),
+          phase       INTEGER NOT NULL,
+          prompt      TEXT NOT NULL,
+          agent       TEXT NOT NULL DEFAULT 'developer',
+          model       TEXT,
+          timeout_ms  INTEGER NOT NULL DEFAULT 1800000,
+          status      TEXT NOT NULL DEFAULT 'pending',
+          worker_id   TEXT,
+          worktree    TEXT,
+          output      TEXT,
+          exit_code   INTEGER,
+          started_at  TEXT,
+          finished_at TEXT,
+          retries     INTEGER NOT NULL DEFAULT 0,
+          max_retries INTEGER NOT NULL DEFAULT 1,
+          files       TEXT,
+          depends_on  TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS worker (
+          id             TEXT PRIMARY KEY,
+          task_id        TEXT REFERENCES task(id),
+          adapter        TEXT NOT NULL,
+          pid            INTEGER,
+          session_id     TEXT,
+          status         TEXT NOT NULL DEFAULT 'spawned',
+          worktree       TEXT,
+          created_at     TEXT NOT NULL,
+          finished_at    TEXT,
+          last_heartbeat TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS event (
+          id         INTEGER PRIMARY KEY AUTOINCREMENT,
+          convoy_id  TEXT REFERENCES convoy(id),
+          task_id    TEXT,
+          worker_id  TEXT,
+          type       TEXT NOT NULL,
+          data       TEXT,
+          created_at TEXT NOT NULL
+        );
+      `);
+            this.db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+        }
+    }
+    insertConvoy(record) {
+        this.db
+            .prepare(`INSERT INTO convoy (id, name, spec_hash, status, branch, created_at, started_at, finished_at, spec_yaml)
+         VALUES (:id, :name, :spec_hash, :status, :branch, :created_at, NULL, NULL, :spec_yaml)`)
+            .run(record);
+    }
+    getConvoy(id) {
+        return this.db
+            .prepare('SELECT * FROM convoy WHERE id = :id')
+            .get({ id });
+    }
+    updateConvoyStatus(id, status, extra) {
+        const sets = ['status = :status'];
+        const params = { id, status };
+        if (extra?.started_at !== undefined) {
+            sets.push('started_at = :started_at');
+            params.started_at = extra.started_at;
+        }
+        if (extra?.finished_at !== undefined) {
+            sets.push('finished_at = :finished_at');
+            params.finished_at = extra.finished_at;
+        }
+        this.db.prepare(`UPDATE convoy SET ${sets.join(', ')} WHERE id = :id`).run(params);
+    }
+    insertTask(record) {
+        this.db
+            .prepare(`INSERT INTO task
+           (id, convoy_id, phase, prompt, agent, model, timeout_ms, status,
+            worker_id, worktree, output, exit_code, started_at, finished_at,
+            retries, max_retries, files, depends_on)
+         VALUES
+           (:id, :convoy_id, :phase, :prompt, :agent, :model, :timeout_ms, :status,
+            NULL, NULL, NULL, NULL, NULL, NULL,
+            :retries, :max_retries, :files, :depends_on)`)
+            .run(record);
+    }
+    getTask(id, convoyId) {
+        return this.db
+            .prepare('SELECT * FROM task WHERE id = :id AND convoy_id = :convoy_id')
+            .get({ id, convoy_id: convoyId });
+    }
+    getTasksByConvoy(convoyId) {
+        return this.db
+            .prepare('SELECT * FROM task WHERE convoy_id = :convoy_id ORDER BY phase, id')
+            .all({ convoy_id: convoyId });
+    }
+    updateTaskStatus(id, convoyId, status, extra) {
+        const sets = ['status = :status'];
+        const params = { id, convoy_id: convoyId, status };
+        const extraFields = ['worker_id', 'worktree', 'output', 'exit_code', 'started_at', 'finished_at', 'retries'];
+        if (extra) {
+            for (const field of extraFields) {
+                if (field in extra && extra[field] !== undefined) {
+                    sets.push(`${field} = :${field}`);
+                    params[field] = extra[field];
+                }
+            }
+        }
+        this.db
+            .prepare(`UPDATE task SET ${sets.join(', ')} WHERE id = :id AND convoy_id = :convoy_id`)
+            .run(params);
+    }
+    getReadyTasks(convoyId) {
+        const allTasks = this.getTasksByConvoy(convoyId);
+        const doneTaskIds = new Set(allTasks.filter(t => t.status === 'done').map(t => t.id));
+        return allTasks.filter(task => {
+            if (task.status !== 'pending')
+                return false;
+            if (!task.depends_on)
+                return true;
+            const deps = JSON.parse(task.depends_on);
+            return deps.length === 0 || deps.every(depId => doneTaskIds.has(depId));
+        });
+    }
+    insertWorker(record) {
+        this.db
+            .prepare(`INSERT INTO worker
+           (id, task_id, adapter, pid, session_id, status, worktree, created_at,
+            finished_at, last_heartbeat)
+         VALUES
+           (:id, :task_id, :adapter, :pid, :session_id, :status, :worktree, :created_at,
+            NULL, NULL)`)
+            .run(record);
+    }
+    getWorker(id) {
+        return this.db
+            .prepare('SELECT * FROM worker WHERE id = :id')
+            .get({ id });
+    }
+    updateWorkerStatus(id, status, extra) {
+        const sets = ['status = :status'];
+        const params = { id, status };
+        if (extra?.finished_at !== undefined) {
+            sets.push('finished_at = :finished_at');
+            params.finished_at = extra.finished_at;
+        }
+        if (extra?.last_heartbeat !== undefined) {
+            sets.push('last_heartbeat = :last_heartbeat');
+            params.last_heartbeat = extra.last_heartbeat;
+        }
+        if (extra?.pid !== undefined) {
+            sets.push('pid = :pid');
+            params.pid = extra.pid;
+        }
+        this.db.prepare(`UPDATE worker SET ${sets.join(', ')} WHERE id = :id`).run(params);
+    }
+    insertEvent(record) {
+        this.db
+            .prepare(`INSERT INTO event (convoy_id, task_id, worker_id, type, data, created_at)
+         VALUES (:convoy_id, :task_id, :worker_id, :type, :data, :created_at)`)
+            .run(record);
+    }
+    getEvents(convoyId) {
+        return this.db
+            .prepare('SELECT * FROM event WHERE convoy_id = :convoy_id ORDER BY id')
+            .all({ convoy_id: convoyId });
+    }
+    withTransaction(fn) {
+        this.db.exec('BEGIN');
+        try {
+            const result = fn();
+            this.db.exec('COMMIT');
+            return result;
+        }
+        catch (err) {
+            this.db.exec('ROLLBACK');
+            throw err;
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+export function createConvoyStore(dbPath) {
+    return new ConvoyStoreImpl(dbPath);
+}
+//# sourceMappingURL=store.js.map

package/dist/cli/convoy/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/cli/convoy/store.ts"],"names":[],"mappings":"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"}

package/dist/cli/convoy/store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/cli/convoy/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/store.test.ts"],"names":[],"mappings":""}