@frehilm/ordna-core 0.1.4 → 0.2.0

package/dist/storage/backends/hybrid.js

@@ -0,0 +1,270 @@
+import { join } from "node:path";
+import chokidar, {} from "chokidar";
+import { ARCHIVED_STATUS, isKnownStatus, } from "../backend.js";
+import { deleteTaskFile, ensureTasksDir, filenameFor, listTaskBytes, writeTaskBytes, } from "../file-io.js";
+import { GitRunner } from "../git-ref.js";
+import { defaultSectionsFor, parseTask, parseTaskFile, serializeTask, } from "../markdown.js";
+import { PushQueue } from "../auto-push.js";
+import { SyncRef } from "../sync-ref.js";
+const SYNC_REF_NAME = "refs/ordna/state";
+const SYNC_PUSH_REFSPEC = `+${SYNC_REF_NAME}:${SYNC_REF_NAME}`;
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Hybrid storage backend.
+ *
+ * Tasks stay as markdown files in `tasks/*.md` — same on-disk layout
+ * as `FileBackend`, so existing tooling that reads task files Just
+ * Works. The difference: shared metadata moves into a single git ref
+ * at `refs/ordna/state`. The blob there holds:
+ *
+ *  - `next_id`: a CAS-bumped allocator that prevents two offline
+ *    collaborators from both picking the same task number
+ *  - `ops`: an append-only audit log of every create / update /
+ *    archive / delete
+ *
+ * Every mutation does two atomic writes (one to disk, one to the
+ * ref) and fires a best-effort coalesced push to keep `origin` in
+ * sync. Reads stay file-system-only (no ref involvement in v1).
+ */
+export class HybridBackend {
+    cwd;
+    config;
+    tasksDir;
+    kind = "hybrid";
+    #initPromise = null;
+    #activeWatchers = new Set();
+    #git;
+    #sync = null;
+    #pushQueue = null;
+    #cachedActor = null;
+    constructor(cwd, config, tasksDir) {
+        this.cwd = cwd;
+        this.config = config;
+        this.tasksDir = tasksDir;
+        this.#git = new GitRunner(cwd);
+    }
+    async init() {
+        await this.#git.ensureRepository();
+        ensureTasksDir(this.tasksDir);
+        this.#sync = new SyncRef(this.#git, SYNC_REF_NAME);
+        this.#pushQueue = new PushQueue(this.#git, SYNC_PUSH_REFSPEC, "ordna-hybrid");
+    }
+    async #ensureInit() {
+        if (!this.#initPromise)
+            this.#initPromise = this.init();
+        return this.#initPromise;
+    }
+    async dispose() {
+        // Close all watchers first so a watcher event doesn't fire
+        // another mutation while we're flushing.
+        const closing = [];
+        for (const w of this.#activeWatchers)
+            closing.push(w.close());
+        this.#activeWatchers.clear();
+        await Promise.all(closing);
+        if (this.#pushQueue) {
+            await this.#pushQueue.flush();
+        }
+    }
+    // ---------------- reads ----------------
+    async list(options = {}) {
+        await this.#ensureInit();
+        const entries = await listTaskBytes(this.tasksDir);
+        const tasks = [];
+        for (const { filePath, raw } of entries) {
+            try {
+                tasks.push(parseTask(raw, filePath));
+            }
+            catch {
+                // Skip malformed tasks silently (same posture as file mode).
+            }
+        }
+        let filtered = tasks;
+        if (options.status)
+            filtered = filtered.filter((t) => t.status === options.status);
+        if (options.assignee)
+            filtered = filtered.filter((t) => t.assignee === options.assignee);
+        if (options.tag) {
+            const tag = options.tag;
+            filtered = filtered.filter((t) => t.tags.includes(tag));
+        }
+        filtered.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }));
+        return filtered;
+    }
+    async get(id) {
+        const tasks = await this.list();
+        return tasks.find((t) => t.id === id) ?? null;
+    }
+    // ---------------- writes ----------------
+    async create(input) {
+        await this.#ensureInit();
+        const sync = this.#sync;
+        const pushQueue = this.#pushQueue;
+        const status = input.status ?? this.config.statuses[0];
+        if (!status)
+            throw new Error("Config has no statuses defined.");
+        if (!isKnownStatus(this.config, status)) {
+            throw new Error(`Status "${status}" is not in configured statuses.`);
+        }
+        // CAS-allocate the next id from the sync ref. This is what
+        // makes hybrid mode safe across offline collaborators.
+        const id = await sync.allocateNextId(this.config);
+        const now = today();
+        const task = {
+            id,
+            title: input.title,
+            status,
+            assignee: input.assignee ?? null,
+            priority: input.priority ?? null,
+            tags: input.tags ?? [],
+            depends_on: input.depends_on ?? [],
+            created_at: now,
+            updated_at: now,
+            sections: defaultSectionsFor(this.config.schema),
+            extra_frontmatter: {},
+            filePath: "",
+            rawContent: "",
+        };
+        const filename = filenameFor(id, task.title, this.config.schema, this.config);
+        task.filePath = join(this.tasksDir, filename);
+        const serialized = serializeTask(task, this.config.schema);
+        task.rawContent = serialized;
+        await writeTaskBytes(task.filePath, serialized);
+        await sync.appendOp(await this.#buildOp("create", id));
+        pushQueue.schedule();
+        return task;
+    }
+    async update(id, patch) {
+        await this.#ensureInit();
+        const sync = this.#sync;
+        const pushQueue = this.#pushQueue;
+        const existing = await this.get(id);
+        if (!existing)
+            throw new Error(`Task ${id} not found.`);
+        const next = {
+            ...existing,
+            title: patch.title ?? existing.title,
+            status: patch.status ?? existing.status,
+            assignee: patch.assignee !== undefined ? patch.assignee : existing.assignee,
+            priority: patch.priority !== undefined ? patch.priority : existing.priority,
+            tags: patch.tags ?? existing.tags,
+            depends_on: patch.depends_on ?? existing.depends_on,
+            sections: patch.sections ?? existing.sections,
+            updated_at: today(),
+        };
+        if (next.status !== existing.status &&
+            !isKnownStatus(this.config, next.status)) {
+            throw new Error(`Status "${next.status}" is not in configured statuses.`);
+        }
+        const serialized = serializeTask(next, this.config.schema);
+        next.rawContent = serialized;
+        if (!existing.filePath) {
+            throw new Error(`Task ${id} has no filePath; cannot update in hybrid mode.`);
+        }
+        await writeTaskBytes(existing.filePath, serialized);
+        // Light op classification: a status-change to "archived" gets
+        // its own op kind; everything else is a generic update. Richer
+        // classification (move via status, changed-field lists) is
+        // deferred to the follow-up that adds op-specific fields.
+        const opKind = patch.status === ARCHIVED_STATUS ? "archive" : "update";
+        await sync.appendOp(await this.#buildOp(opKind, id));
+        pushQueue.schedule();
+        return next;
+    }
+    async delete(id) {
+        await this.#ensureInit();
+        const sync = this.#sync;
+        const pushQueue = this.#pushQueue;
+        const task = await this.get(id);
+        if (!task)
+            throw new Error(`Task ${id} not found.`);
+        if (!task.filePath) {
+            throw new Error(`Task ${id} has no filePath; cannot delete in hybrid mode.`);
+        }
+        await deleteTaskFile(task.filePath);
+        await sync.appendOp(await this.#buildOp("delete", id));
+        pushQueue.schedule();
+    }
+    // ---------------- watch ----------------
+    watch(listener) {
+        // Same chokidar setup as FileBackend. Sync ref doesn't drive
+        // watcher events in v1 — the file watcher is fast and reliable
+        // for the task-content changes that the TUI / web care about.
+        const watcher = chokidar.watch(this.tasksDir, {
+            ignoreInitial: true,
+            depth: 0,
+            persistent: true,
+        });
+        this.#activeWatchers.add(watcher);
+        const emitIfMarkdown = async (type, filePath) => {
+            if (!filePath.endsWith(".md"))
+                return;
+            try {
+                const task = await parseTaskFile(filePath);
+                listener({ type, task });
+            }
+            catch {
+                // Ignore partial writes or malformed files.
+            }
+        };
+        watcher.on("add", (path) => void emitIfMarkdown("added", path));
+        watcher.on("change", (path) => void emitIfMarkdown("changed", path));
+        watcher.on("unlink", (path) => {
+            if (!path.endsWith(".md"))
+                return;
+            listener({ type: "removed", filePath: path });
+        });
+        return async () => {
+            this.#activeWatchers.delete(watcher);
+            await watcher.close();
+        };
+    }
+    // ---------------- commit (file-mode parity) ----------------
+    async commit(message = "chore(tasks): update") {
+        await this.#ensureInit();
+        const tasksDirArg = this.config.tasksDir;
+        await this.#git.run(["add", "--", tasksDirArg]);
+        const status = await this.#git.run([
+            "status",
+            "--porcelain",
+            "--",
+            tasksDirArg,
+        ]);
+        if (status.trim().length === 0) {
+            throw new Error("No task changes to commit.");
+        }
+        await this.#git.run(["commit", "-m", message, "--", tasksDirArg]);
+    }
+    // ---------------- internals ----------------
+    async #buildOp(op, id) {
+        return {
+            ts: nowIso(),
+            actor: await this.#resolveActor(),
+            op,
+            id,
+        };
+    }
+    async #resolveActor() {
+        if (this.#cachedActor !== null)
+            return this.#cachedActor;
+        // Order: git config user.email → ORDNA_ACTOR env → "unknown".
+        const fromGit = await this.#git.userEmail();
+        if (fromGit) {
+            this.#cachedActor = fromGit;
+            return fromGit;
+        }
+        const fromEnv = process.env.ORDNA_ACTOR;
+        if (fromEnv && fromEnv.trim().length > 0) {
+            this.#cachedActor = fromEnv.trim();
+            return this.#cachedActor;
+        }
+        this.#cachedActor = "unknown";
+        return this.#cachedActor;
+    }
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/storage/backends/hybrid.js.map

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

package/dist/storage/backends/namespace.d.ts

@@ -0,0 +1,55 @@
+import type { OrdnaConfig } from "../../config.js";
+import type { Task, TaskCreateInput, TaskUpdateInput } from "../../schema.js";
+import type { TaskEventListener } from "../../watcher.js";
+import { type Backend, type FetchResult, type ListOptions } from "../backend.js";
+/**
+ * Namespace storage backend.
+ *
+ * Tasks live as git **blobs** under `refs/ordna/tasks/<id>` — one ref
+ * per task, no working-tree files. `git status` stays clean. `git log`
+ * on branches doesn't see task mutations.
+ *
+ * **ID allocation.** A shared `refs/ordna/state` ref carries a
+ * `SyncRef`-managed JSON blob `{next_id, ops}`. Same primitive as
+ * hybrid: CAS in-process, auto-fetch-and-retry on conflict.
+ *
+ * **Bootstrap.** On `init()` if the state ref is missing, we scan
+ * existing `refs/ordna/tasks/*` and seed `next_id` from the max
+ * numeric id. Safe across concurrent processes (CAS).
+ *
+ * **Sync.** Every mutation schedules a per-ref push with
+ * `--force-with-lease` (per-ref CAS at the protocol level). On a
+ * rejected `create` (offline collision), the backend fetches,
+ * reallocates a fresh id via `SyncRef`, rewrites the local blob's
+ * `id:` field, cascades the rewrite through any local `depends_on`
+ * references to the old id, and emits a `renamed` event. Update
+ * collisions are deliberately loud — silently picking a winner would
+ * lose user edits.
+ *
+ * **Auto-fetch.** A configurable timer (default 60s) keeps the local
+ * snapshot fresh without manual pulls. A `fetch()` method exposes it
+ * manually for the TUI key / web button.
+ *
+ * **Audit log.** The `ops` array in the state blob records every
+ * `create`/`update`/`archive`/`delete`/`rename`. `rename` entries
+ * carry `renamedFrom` so the UIs can show a "previously known as X"
+ * banner on the affected task.
+ */
+export declare class NamespaceBackend implements Backend {
+    #private;
+    private readonly cwd;
+    private readonly config;
+    readonly kind = "namespace";
+    constructor(cwd: string, config: OrdnaConfig);
+    init(): Promise<void>;
+    dispose(): Promise<void>;
+    list(options?: ListOptions): Promise<Task[]>;
+    get(id: string): Promise<Task | null>;
+    create(input: TaskCreateInput): Promise<Task>;
+    update(id: string, patch: TaskUpdateInput): Promise<Task>;
+    delete(id: string): Promise<void>;
+    watch(listener: TaskEventListener): () => Promise<void>;
+    commit(_message?: string): Promise<void>;
+    fetch(): Promise<FetchResult>;
+}
+//# sourceMappingURL=namespace.d.ts.map

package/dist/storage/backends/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/storage/backends/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EACX,IAAI,EACJ,eAAe,EACf,eAAe,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAEN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAEhB,MAAM,eAAe,CAAC;AAqFvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,gBAAiB,YAAW,OAAO;;IA+B9C,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/BxB,QAAQ,CAAC,IAAI,eAAe;gBA8BV,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW;IAS/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAsChD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAoBrC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+D7C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CvC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;IAuBjD,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;CAofnC"}