@ronkovic/aad 0.3.0

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/progress.json

@@ -0,0 +1,10 @@
+{
+  "runId": "run-latest",
+  "parentBranch": "main",
+  "totalTasks": 8,
+  "pending": 0,
+  "running": 0,
+  "completed": 8,
+  "failed": 0,
+  "startTime": "2024-01-03T10:00:00Z"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/completed/task-getall-2.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-2",
+  "title": "Task 2",
+  "description": "Task 2",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 2,
+  "status": "completed",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-1.json

@@ -0,0 +1,13 @@
+{
+  "taskId": "task-1",
+  "title": "FS Test Task",
+  "description": "A filesystem test task",
+  "filesToModify": [
+    "file1.ts",
+    "file2.ts"
+  ],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-getall-1.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-1",
+  "title": "Task 1",
+  "description": "Task 1",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-status-change.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-status-change",
+  "title": "Task",
+  "description": "Task",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/workers/worker-1.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-1",
+  "status": "idle",
+  "currentTask": null
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/progress.json

@@ -0,0 +1,10 @@
+{
+  "runId": "run-latest",
+  "parentBranch": "main",
+  "totalTasks": 8,
+  "pending": 0,
+  "running": 0,
+  "completed": 8,
+  "failed": 0,
+  "startTime": "2024-01-03T10:00:00Z"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/completed/task-getall-2.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-2",
+  "title": "Task 2",
+  "description": "Task 2",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 2,
+  "status": "completed",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-1.json

@@ -0,0 +1,13 @@
+{
+  "taskId": "task-1",
+  "title": "FS Test Task",
+  "description": "A filesystem test task",
+  "filesToModify": [
+    "file1.ts",
+    "file2.ts"
+  ],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-getall-1.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-1",
+  "title": "Task 1",
+  "description": "Task 1",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-status-change.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-status-change",
+  "title": "Task",
+  "description": "Task",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/workers/worker-1.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-1",
+  "status": "idle",
+  "currentTask": null
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/progress.json

@@ -0,0 +1,10 @@
+{
+  "runId": "run-latest",
+  "parentBranch": "main",
+  "totalTasks": 8,
+  "pending": 0,
+  "running": 0,
+  "completed": 8,
+  "failed": 0,
+  "startTime": "2024-01-03T10:00:00Z"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/completed/task-getall-2.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-2",
+  "title": "Task 2",
+  "description": "Task 2",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 2,
+  "status": "completed",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/pending/task-1.json

@@ -0,0 +1,13 @@
+{
+  "taskId": "task-1",
+  "title": "FS Test Task",
+  "description": "A filesystem test task",
+  "filesToModify": [
+    "file1.ts",
+    "file2.ts"
+  ],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/pending/task-getall-1.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-1",
+  "title": "Task 1",
+  "description": "Task 1",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/pending/task-status-change.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-status-change",
+  "title": "Task",
+  "description": "Task",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/workers/worker-1.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-1",
+  "status": "idle",
+  "currentTask": null
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/progress.json

@@ -0,0 +1,10 @@
+{
+  "runId": "run-latest",
+  "parentBranch": "main",
+  "totalTasks": 8,
+  "pending": 0,
+  "running": 0,
+  "completed": 8,
+  "failed": 0,
+  "startTime": "2024-01-03T10:00:00Z"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/queue/completed/task-getall-2.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-2",
+  "title": "Task 2",
+  "description": "Task 2",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 2,
+  "status": "completed",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/queue/pending/task-1.json

@@ -0,0 +1,13 @@
+{
+  "taskId": "task-1",
+  "title": "FS Test Task",
+  "description": "A filesystem test task",
+  "filesToModify": [
+    "file1.ts",
+    "file2.ts"
+  ],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/queue/pending/task-getall-1.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-1",
+  "title": "Task 1",
+  "description": "Task 1",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/queue/pending/task-status-change.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-status-change",
+  "title": "Task",
+  "description": "Task",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/workers/worker-1.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-1",
+  "status": "idle",
+  "currentTask": null
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89475/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/progress.json

@@ -0,0 +1,10 @@
+{
+  "runId": "run-latest",
+  "parentBranch": "main",
+  "totalTasks": 8,
+  "pending": 0,
+  "running": 0,
+  "completed": 8,
+  "failed": 0,
+  "startTime": "2024-01-03T10:00:00Z"
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/queue/completed/task-getall-2.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-2",
+  "title": "Task 2",
+  "description": "Task 2",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 2,
+  "status": "completed",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/queue/pending/task-1.json

@@ -0,0 +1,13 @@
+{
+  "taskId": "task-1",
+  "title": "FS Test Task",
+  "description": "A filesystem test task",
+  "filesToModify": [
+    "file1.ts",
+    "file2.ts"
+  ],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/queue/pending/task-getall-1.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-getall-1",
+  "title": "Task 1",
+  "description": "Task 1",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/queue/pending/task-status-change.json

@@ -0,0 +1,10 @@
+{
+  "taskId": "task-status-change",
+  "title": "Task",
+  "description": "Task",
+  "filesToModify": [],
+  "dependsOn": [],
+  "priority": 1,
+  "status": "pending",
+  "retryCount": 0
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/workers/worker-1.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-1",
+  "status": "idle",
+  "currentTask": null
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-89924/workers/worker-2.json

@@ -0,0 +1,5 @@
+{
+  "workerId": "worker-2",
+  "status": "busy",
+  "currentTask": "task-1"
+}

package/src/modules/persistence/__tests__/file-lock.test.ts

@@ -0,0 +1,141 @@
+import { describe, test, expect, beforeEach, afterEach } from "bun:test";
+import { rm, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { FileLock, withFileLock } from "../file-lock";
+import { FileLockError } from "@aad/shared/errors";
+
+const TEST_DIR = join(import.meta.dir, ".tmp-file-lock-test");
+
+describe("FileLock", () => {
+  beforeEach(async () => {
+    await rm(TEST_DIR, { recursive: true, force: true });
+    await mkdir(TEST_DIR, { recursive: true });
+  });
+
+  afterEach(async () => {
+    await rm(TEST_DIR, { recursive: true, force: true });
+  });
+
+  test("acquires and releases lock successfully", async () => {
+    const lockDir = join(TEST_DIR, "test-lock");
+    const lock = new FileLock({ lockDir });
+
+    await lock.acquire();
+    await lock.release();
+
+    expect(true).toBe(true);
+  });
+
+  test("allows sequential lock acquisition", async () => {
+    const lockDir = join(TEST_DIR, "sequential-lock");
+    const lock1 = new FileLock({ lockDir });
+    const lock2 = new FileLock({ lockDir });
+
+    await lock1.acquire();
+    await lock1.release();
+
+    await lock2.acquire();
+    await lock2.release();
+
+    expect(true).toBe(true);
+  });
+
+  test("detects and removes stale locks", async () => {
+    const lockDir = join(TEST_DIR, "stale-lock");
+
+    // Create a stale lock with non-existent PID
+    await mkdir(lockDir);
+    await Bun.write(join(lockDir, "pid"), "999999");
+
+    const lock = new FileLock({ lockDir });
+    await lock.acquire();
+    await lock.release();
+
+    expect(true).toBe(true);
+  });
+
+  test("withFileLock helper auto-releases", async () => {
+    const lockDir = join(TEST_DIR, "helper-lock");
+    let executed = false;
+
+    await withFileLock({ lockDir }, async () => {
+      executed = true;
+    });
+
+    expect(executed).toBe(true);
+
+    // Lock should be released, can acquire again
+    const lock = new FileLock({ lockDir });
+    await lock.acquire();
+    await lock.release();
+  });
+
+  test("withFileLock releases on error", async () => {
+    const lockDir = join(TEST_DIR, "error-lock");
+
+    await expect(
+      withFileLock({ lockDir }, async () => {
+        throw new Error("Test error");
+      })
+    ).rejects.toThrow("Test error");
+
+    // Lock should still be released
+    const lock = new FileLock({ lockDir });
+    await lock.acquire();
+    await lock.release();
+  });
+
+  test("forceRelease removes lock unconditionally", async () => {
+    const lockDir = join(TEST_DIR, "force-lock");
+    const lock1 = new FileLock({ lockDir });
+    const lock2 = new FileLock({ lockDir });
+
+    await lock1.acquire();
+    await lock2.forceRelease();
+
+    // Lock should be removable after force release
+    await lock1.acquire(); // Should not fail
+    await lock1.release();
+  });
+
+  test("acquire throws FileLockError on non-EEXIST mkdir failure", async () => {
+    // Use a path that cannot be created (nested under a file, not a directory)
+    const blockerFile = join(TEST_DIR, "blocker");
+    await Bun.write(blockerFile, "not-a-dir");
+    const lockDir = join(blockerFile, "impossible-lock");
+
+    const lock = new FileLock({ lockDir, timeout: 500, retryInterval: 50 });
+
+    await expect(lock.acquire()).rejects.toThrow(FileLockError);
+  });
+
+  test("forceRelease handles missing lock dir gracefully", async () => {
+    const lockDir = join(TEST_DIR, "missing-force-lock");
+    const lock = new FileLock({ lockDir });
+    // Should not throw even if dir doesn't exist
+    await lock.forceRelease();
+  });
+
+  test("release is no-op when not acquired", async () => {
+    const lockDir = join(TEST_DIR, "noop-release");
+    const lock = new FileLock({ lockDir });
+
+    // Should not throw
+    await lock.release();
+  });
+
+  test("treats non-numeric PID as stale lock", async () => {
+    const lockDir = join(TEST_DIR, "bad-pid-lock");
+
+    // Create lock with non-numeric PID
+    await mkdir(lockDir);
+    await Bun.write(join(lockDir, "pid"), "not-a-number");
+
+    const lock = new FileLock({ lockDir });
+    // Should treat as stale and acquire successfully
+    await lock.acquire();
+    await lock.release();
+
+    expect(true).toBe(true);
+  });
+});

package/src/modules/persistence/__tests__/index.test.ts

@@ -0,0 +1,38 @@
+import { describe, test, expect } from "bun:test";
+import { join } from "node:path";
+import { rm, mkdir } from "node:fs/promises";
+import { createStores } from "../index";
+
+const TEST_DIR = join(import.meta.dir, `.tmp-index-test-${process.pid}`);
+
+describe("createStores factory", () => {
+  test('createStores("memory") returns InMemory stores', () => {
+    const stores = createStores("memory");
+    expect(stores.taskStore).toBeDefined();
+    expect(stores.workerStore).toBeDefined();
+    expect(stores.runStore).toBeDefined();
+  });
+
+  test('createStores("fs", { basePath }) returns FS stores', async () => {
+    await rm(TEST_DIR, { recursive: true, force: true });
+    await mkdir(TEST_DIR, { recursive: true });
+
+    try {
+      const stores = createStores("fs", { basePath: TEST_DIR });
+      expect(stores.taskStore).toBeDefined();
+      expect(stores.workerStore).toBeDefined();
+      expect(stores.runStore).toBeDefined();
+    } finally {
+      await rm(TEST_DIR, { recursive: true, force: true });
+    }
+  });
+
+  test('createStores("fs") without basePath throws Error', () => {
+    expect(() => createStores("fs")).toThrow("basePath is required for fs mode");
+  });
+
+  test('createStores with unknown mode throws Error', () => {
+    // @ts-expect-error testing invalid mode
+    expect(() => createStores("unknown")).toThrow("Unknown store mode: unknown");
+  });
+});