@frehilm/ordna-core 0.1.4 → 0.2.0

package/dist/storage/sync-ref.js

@@ -0,0 +1,191 @@
+import { formatId } from "../ids.js";
+const DEFAULT_REF = "refs/ordna/state";
+const EMPTY_OID = ""; // CAS sentinel for "must not exist"
+const EMPTY_STATE = { next_id: 1, ops: [] };
+/**
+ * Wraps a single git ref carrying a JSON `SyncState` blob.
+ *
+ * The CAS pattern: every write reads the current blob, computes the
+ * new state, hashes the new blob, and `update-ref`s with the old OID
+ * as the expected-old value. If the ref has moved underneath us
+ * (another writer slipped in), the CAS fails non-fast-forward and we
+ * fetch + retry once. Beyond that, we surface a clear "diverged"
+ * error so the user can intervene.
+ *
+ * Reads are cached in memory until invalidated (after a CAS conflict)
+ * or after a successful write (cache is updated to the new state).
+ */
+export class SyncRef {
+    git;
+    refname;
+    #cached = null;
+    constructor(git, refname = DEFAULT_REF) {
+        this.git = git;
+        this.refname = refname;
+    }
+    /**
+     * Read the current state. Returns an empty state if the ref
+     * doesn't yet exist. Hits the cache when available.
+     */
+    async read() {
+        if (this.#cached)
+            return this.#cached.state;
+        const fresh = await this.#readUncached();
+        this.#cached = fresh;
+        return fresh.state;
+    }
+    /** Drop the cache. Next `read()` hits the ref again. */
+    invalidate() {
+        this.#cached = null;
+    }
+    /**
+     * Seed the ref with `initial` only if it doesn't yet exist. Used by
+     * namespace mode to migrate pre-state-ref repos: scan existing
+     * `refs/ordna/tasks/*` for the max id, then call this with
+     * `{ next_id: max + 1, ops: [] }`. Safe to call concurrently — if
+     * another process initialises first, we just adopt its value.
+     */
+    async ensureInitialized(initial) {
+        const fresh = await this.#readUncached();
+        if (fresh.oid !== null) {
+            // Already initialised by someone (us in a previous run, or
+            // another process racing with us). Adopt their state.
+            this.#cached = fresh;
+            return;
+        }
+        try {
+            await this.#writeCAS(null, initial);
+        }
+        catch (err) {
+            if (isCASConflict(err)) {
+                // Lost the bootstrap race; another writer landed first.
+                // Re-read to pick up their state.
+                this.invalidate();
+                await this.read();
+                return;
+            }
+            throw err;
+        }
+    }
+    async #readUncached() {
+        const refs = await this.git.forEachRef(this.refname);
+        const match = refs.find((r) => r.refname === this.refname);
+        if (!match)
+            return { oid: null, state: structuredClone(EMPTY_STATE) };
+        try {
+            const raw = await this.git.catBlob(match.oid);
+            const parsed = JSON.parse(raw);
+            // Defensive normalisation: tolerate missing fields in old blobs.
+            return {
+                oid: match.oid,
+                state: {
+                    next_id: typeof parsed.next_id === "number" ? parsed.next_id : 1,
+                    ops: Array.isArray(parsed.ops) ? parsed.ops : [],
+                },
+            };
+        }
+        catch {
+            // Corrupt blob — fall back to empty state and let the next
+            // write overwrite it. Surfacing an error here would block
+            // every read; we prefer self-healing.
+            return { oid: match.oid, state: structuredClone(EMPTY_STATE) };
+        }
+    }
+    /**
+     * Allocate the next id, bump the counter, and persist atomically.
+     * Returns the formatted id (e.g. `T-007`) for the caller.
+     *
+     * On CAS conflict, fetches the ref from origin (if any) and
+     * retries once. Further conflicts throw a clear error.
+     */
+    async allocateNextId(config) {
+        return this.#withRetry(async () => {
+            const { oid, state } = await this.#readUncachedAndCache();
+            const allocated = formatId(config, state.next_id);
+            const nextState = {
+                next_id: state.next_id + 1,
+                ops: state.ops,
+            };
+            await this.#writeCAS(oid, nextState);
+            return allocated;
+        });
+    }
+    /** Append a single op to the audit log and persist atomically. */
+    async appendOp(op) {
+        await this.#withRetry(async () => {
+            const { oid, state } = await this.#readUncachedAndCache();
+            const nextState = {
+                next_id: state.next_id,
+                ops: [...state.ops, op],
+            };
+            await this.#writeCAS(oid, nextState);
+        });
+    }
+    async #readUncachedAndCache() {
+        const fresh = await this.#readUncached();
+        this.#cached = fresh;
+        return fresh;
+    }
+    async #writeCAS(expectedOid, nextState) {
+        const blob = `${JSON.stringify(nextState, null, 2)}\n`;
+        const newOid = await this.git.hashObject(blob);
+        // CAS: `""` if the ref must not exist; otherwise the captured oid.
+        const expectedOld = expectedOid ?? EMPTY_OID;
+        await this.git.updateRef(this.refname, newOid, expectedOld);
+        // Successful write: update the cache to the new state.
+        this.#cached = { oid: newOid, state: nextState };
+    }
+    /**
+     * Run an operation that does read-then-CAS-write. On CAS conflict,
+     * fetch the ref (best-effort if a remote exists) and retry once.
+     */
+    async #withRetry(operation) {
+        try {
+            return await operation();
+        }
+        catch (err) {
+            if (!isCASConflict(err))
+                throw err;
+            // Fetch from origin if it exists, then retry. If fetch fails
+            // (no remote, network down), the retry still re-reads local
+            // state via forEachRef so concurrent in-process writers are
+            // handled too.
+            if (await this.git.hasRemote()) {
+                try {
+                    await this.git.fetchRef(this.refname);
+                }
+                catch {
+                    // Best-effort; fall through to retry against local state.
+                }
+            }
+            this.invalidate();
+            try {
+                return await operation();
+            }
+            catch (retryErr) {
+                if (isCASConflict(retryErr)) {
+                    throw new Error(`ordna: sync ref ${this.refname} diverged. Run \`git fetch origin '+${this.refname}:${this.refname}'\` to reconcile, then retry.`);
+                }
+                throw retryErr;
+            }
+        }
+    }
+}
+/**
+ * Heuristic: a CAS conflict surfaces as a `git update-ref` failure
+ * whose stderr mentions either a missing-ref / wrong-old / non-fast-
+ * forward condition. We pattern-match on the thrown message rather
+ * than introducing a typed error from `GitRunner` — keeps the runner
+ * generic.
+ */
+function isCASConflict(err) {
+    if (!(err instanceof Error))
+        return false;
+    const msg = err.message.toLowerCase();
+    return (msg.includes("update-ref") &&
+        (msg.includes("cannot lock ref") ||
+            msg.includes("is at") ||
+            msg.includes("expected") ||
+            msg.includes("missing")));
+}
+//# sourceMappingURL=sync-ref.js.map

package/dist/storage/sync-ref.js.map

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

package/dist/store.d.ts

@@ -1,22 +1,70 @@
 import { type OrdnaConfig } from "./config.js";
 import type { Task, TaskCreateInput, TaskUpdateInput } from "./schema.js";
+import { type Backend, type FetchResult, type ListOptions, ARCHIVED_STATUS, isKnownStatus } from "./storage/backend.js";
+/**
+ * Public context object passed to every store function. The `backend`
+ * field carries the storage strategy chosen at `createContext` time;
+ * the strategy interface itself is private (not exported from
+ * `index.ts`).
+ *
+ * `backend` is typed as `Backend`, which is unexported, so consumers
+ * can read the field but can't declare their own `Backend`-typed
+ * variables without importing internals. That's intentional — the
+ * field is public for now (future cleanup may hide it behind a
+ * method) but the interface stays a TS-internal seam.
+ */
 export interface StoreContext {
     cwd: string;
     config: OrdnaConfig;
     tasksDir: string;
+    backend: Backend;
 }
-export declare const ARCHIVED_STATUS = "archived";
-export declare function isKnownStatus(config: OrdnaConfig, status: string): boolean;
-export interface ListTasksOptions {
-    status?: string;
-    assignee?: string;
-    tag?: string;
-}
+export { ARCHIVED_STATUS, isKnownStatus };
+/**
+ * @deprecated Use `ListOptions` from the backend layer (not exported).
+ *             Kept as the public type name for back-compat with
+ *             0.1.x consumers. Same shape.
+ */
+export type ListTasksOptions = ListOptions;
+/**
+ * Build a context bound to the active working directory.
+ *
+ * Stays SYNCHRONOUS. The chosen backend is constructed cheaply (no
+ * I/O); the first method call on the backend triggers lazy `init()`
+ * internally. This is what lets the IDE that embeds core construct
+ * contexts without awaiting.
+ *
+ * Backend selection is driven by `config.storage`. Combinations that
+ * make no sense are rejected eagerly so the user sees a clear error
+ * up front rather than a confusing failure deep inside a method call.
+ *
+ *  - `storage: hybrid` requires a git repository (`.git/` present at
+ *    `cwd` or any parent)
+ *  - `storage: hybrid` + `schema: backlog` is rejected — the audit-
+ *    log model and Backlog's filename conventions are out of scope
+ *    for v1 to combine
+ *  - `storage: namespace` is reserved for T-032; rejected for now
+ */
 export declare function createContext(cwd?: string): StoreContext;
-export declare function listTasks(ctx?: StoreContext, options?: ListTasksOptions): Promise<Task[]>;
+export declare function listTasks(ctx?: StoreContext, options?: ListOptions): Promise<Task[]>;
 export declare function getTask(id: string, ctx?: StoreContext): Promise<Task | null>;
 export declare function createTask(input: TaskCreateInput, ctx?: StoreContext): Promise<Task>;
 export declare function updateTask(id: string, patch: TaskUpdateInput, ctx?: StoreContext): Promise<Task>;
+/**
+ * Move a task to a new status. The `depends_on` gate stays in core so
+ * backends don't have to re-implement Ordna's business rules — the
+ * gate fires here, then the actual write is delegated to the backend.
+ */
 export declare function moveTask(id: string, status: string, ctx?: StoreContext): Promise<Task>;
 export declare function deleteTask(id: string, ctx?: StoreContext): Promise<void>;
+/**
+ * Pull remote updates into the active backend. Only namespace
+ * implements this in v1 — see `Backend.fetch` for the rationale.
+ *
+ * File / hybrid throw a clear error so callers (UI buttons, CLI
+ * commands) can show a useful message rather than silently no-op.
+ */
+export declare function fetchTasks(ctx?: StoreContext): Promise<FetchResult>;
+/** True if the active backend exposes a `fetch()` capability. */
+export declare function canFetch(ctx: StoreContext): boolean;
 //# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAA+B,MAAM,aAAa,CAAC;AAG5E,OAAO,KAAK,EAAuB,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG/F,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,YAAY,CAI/D;AAwBD,wBAAsB,SAAS,CAC9B,GAAG,GAAE,YAA8B,EACnC,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,IAAI,EAAE,CAAC,CAuBjB;AAED,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,YAA8B,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAGnG;AAED,wBAAsB,UAAU,CAC/B,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED,wBAAsB,UAAU,CAC/B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,QAAQ,CAC7B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,YAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAA+B,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,eAAe,EACf,aAAa,EACb,MAAM,sBAAsB,CAAC;AAK9B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAsB,GAAG,YAAY,CA4BvE;AAkBD,wBAAsB,SAAS,CAC9B,GAAG,GAAE,YAA8B,EACnC,OAAO,GAAE,WAAgB,GACvB,OAAO,CAAC,IAAI,EAAE,CAAC,CAEjB;AAED,wBAAsB,OAAO,CAC5B,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAEtB;AAED,wBAAsB,UAAU,CAC/B,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,UAAU,CAC/B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC7B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,UAAU,CAC/B,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC/B,GAAG,GAAE,YAA8B,GACjC,OAAO,CAAC,WAAW,CAAC,CAOtB;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAEnD"}

package/dist/store.js

@@ -1,135 +1,99 @@
-import { existsSync, mkdirSync, readdirSync } from "node:fs";
-import { readFile, unlink, writeFile } from "node:fs/promises";
-import { basename, join } from "node:path";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 import { loadConfig, resolveTasksDir } from "./config.js";
-import { formatId, nextId, parseId } from "./ids.js";
-import { parseTask } from "./parser.js";
-import { defaultSectionsFor, serializeTask } from "./writer.js";
-export const ARCHIVED_STATUS = "archived";
-export function isKnownStatus(config, status) {
-    if (status === ARCHIVED_STATUS)
-        return true;
-    return config.statuses.includes(status);
-}
+import { ARCHIVED_STATUS, isKnownStatus, } from "./storage/backend.js";
+import { FileBackend } from "./storage/backends/file.js";
+import { HybridBackend } from "./storage/backends/hybrid.js";
+import { NamespaceBackend } from "./storage/backends/namespace.js";
+export { ARCHIVED_STATUS, isKnownStatus };
+/**
+ * Build a context bound to the active working directory.
+ *
+ * Stays SYNCHRONOUS. The chosen backend is constructed cheaply (no
+ * I/O); the first method call on the backend triggers lazy `init()`
+ * internally. This is what lets the IDE that embeds core construct
+ * contexts without awaiting.
+ *
+ * Backend selection is driven by `config.storage`. Combinations that
+ * make no sense are rejected eagerly so the user sees a clear error
+ * up front rather than a confusing failure deep inside a method call.
+ *
+ *  - `storage: hybrid` requires a git repository (`.git/` present at
+ *    `cwd` or any parent)
+ *  - `storage: hybrid` + `schema: backlog` is rejected — the audit-
+ *    log model and Backlog's filename conventions are out of scope
+ *    for v1 to combine
+ *  - `storage: namespace` is reserved for T-032; rejected for now
+ */
 export function createContext(cwd = process.cwd()) {
     const config = loadConfig({ cwd });
     const tasksDir = resolveTasksDir(config, cwd);
-    return { cwd, config, tasksDir };
-}
-function today() {
-    return new Date().toISOString().slice(0, 10);
-}
-function slugifyTitle(title) {
-    return title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 60);
+    if (config.storage === "hybrid") {
+        assertGitRepo(cwd, "hybrid");
+        if (config.schema === "backlog") {
+            throw new Error("ordna: `storage: hybrid` is not supported with `schema: backlog` in v1. Use `schema: ordna`, or stay on `storage: file` if you need Backlog.md compatibility.");
+        }
+        const backend = new HybridBackend(cwd, config, tasksDir);
+        return { cwd, config, tasksDir, backend };
+    }
+    if (config.storage === "namespace") {
+        assertGitRepo(cwd, "namespace");
+        if (config.schema === "backlog") {
+            throw new Error("ordna: `storage: namespace` is not supported with `schema: backlog`. Backlog's filename convention has no analogue in a ref-only store; use `schema: ordna`, or stay on `storage: file` if you need Backlog.md compatibility.");
+        }
+        const backend = new NamespaceBackend(cwd, config);
+        return { cwd, config, tasksDir, backend };
+    }
+    const backend = new FileBackend(cwd, config, tasksDir);
+    return { cwd, config, tasksDir, backend };
 }
-function filenameFor(id, title, mode, config) {
-    if (mode === "backlog") {
-        const numeric = parseId(config, id);
-        const numericPart = numeric ?? id;
-        const slug = slugifyTitle(title) || "task";
-        return `task-${numericPart} - ${slug}.md`;
+function assertGitRepo(cwd, mode) {
+    // Walk up from cwd looking for a `.git/` directory. A bare repo
+    // would lack the working tree but still has `.git` as a file
+    // pointer or directory; we accept either.
+    let dir = cwd;
+    for (let i = 0; i < 64; i++) {
+        if (existsSync(join(dir, ".git")))
+            return;
+        const parent = join(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
     }
-    return `${id}.md`;
+    throw new Error(`ordna: \`storage: ${mode}\` requires a git repository. Run \`git init\` in this directory, or switch back to \`storage: file\` in .ordna/config.yaml.`);
 }
 export async function listTasks(ctx = createContext(), options = {}) {
-    if (!existsSync(ctx.tasksDir))
-        return [];
-    const entries = readdirSync(ctx.tasksDir, { withFileTypes: true });
-    const tasks = [];
-    for (const entry of entries) {
-        if (!entry.isFile() || !entry.name.endsWith(".md"))
-            continue;
-        const filePath = join(ctx.tasksDir, entry.name);
-        const raw = await readFile(filePath, "utf8");
-        try {
-            tasks.push(parseTask(raw, filePath));
-        }
-        catch {
-            // Skip malformed tasks silently; surfaced via dedicated validator later.
-        }
-    }
-    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)
-        filtered = filtered.filter((t) => t.tags.includes(options.tag));
-    filtered.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }));
-    return filtered;
+    return ctx.backend.list(options);
 }
 export async function getTask(id, ctx = createContext()) {
-    const tasks = await listTasks(ctx);
-    return tasks.find((t) => t.id === id) ?? null;
+    return ctx.backend.get(id);
 }
 export async function createTask(input, ctx = createContext()) {
-    if (!existsSync(ctx.tasksDir))
-        mkdirSync(ctx.tasksDir, { recursive: true });
-    const id = nextId(ctx.config, ctx.tasksDir);
-    const status = input.status ?? ctx.config.statuses[0];
-    if (!status)
-        throw new Error("Config has no statuses defined.");
-    if (!isKnownStatus(ctx.config, status)) {
-        throw new Error(`Status "${status}" is not in configured statuses.`);
-    }
-    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(ctx.config.schema),
-        extra_frontmatter: {},
-        filePath: "",
-        rawContent: "",
-    };
-    const filename = filenameFor(id, task.title, ctx.config.schema, ctx.config);
-    task.filePath = join(ctx.tasksDir, filename);
-    const serialized = serializeTask(task, ctx.config.schema);
-    task.rawContent = serialized;
-    await writeFile(task.filePath, serialized, "utf8");
-    return task;
+    return ctx.backend.create(input);
 }
 export async function updateTask(id, patch, ctx = createContext()) {
-    const existing = await getTask(id, ctx);
-    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(ctx.config, next.status)) {
-        throw new Error(`Status "${next.status}" is not in configured statuses.`);
+    if (patch.status !== undefined &&
+        !isKnownStatus(ctx.config, patch.status)) {
+        throw new Error(`Status "${patch.status}" is not in configured statuses.`);
     }
-    const serialized = serializeTask(next, ctx.config.schema);
-    next.rawContent = serialized;
-    await writeFile(existing.filePath, serialized, "utf8");
-    return next;
+    return ctx.backend.update(id, patch);
 }
+/**
+ * Move a task to a new status. The `depends_on` gate stays in core so
+ * backends don't have to re-implement Ordna's business rules — the
+ * gate fires here, then the actual write is delegated to the backend.
+ */
 export async function moveTask(id, status, ctx = createContext()) {
+    if (!isKnownStatus(ctx.config, status)) {
+        throw new Error(`Status "${status}" is not in configured statuses.`);
+    }
     const terminal = ctx.config.statuses[ctx.config.statuses.length - 1];
     if (status === terminal) {
-        const task = await getTask(id, ctx);
+        const task = await ctx.backend.get(id);
         if (!task)
             throw new Error(`Task ${id} not found.`);
         if (task.depends_on.length > 0) {
-            const all = await listTasks(ctx);
+            const all = await ctx.backend.list();
             const byId = new Map(all.map((t) => [t.id, t]));
             const unfinished = task.depends_on.filter((dep) => {
                 const d = byId.get(dep);
@@ -140,12 +104,26 @@ export async function moveTask(id, status, ctx = createContext()) {
             }
         }
     }
-    return updateTask(id, { status }, ctx);
+    return ctx.backend.update(id, { status });
 }
 export async function deleteTask(id, ctx = createContext()) {
-    const task = await getTask(id, ctx);
-    if (!task)
-        throw new Error(`Task ${id} not found.`);
-    await unlink(task.filePath);
+    return ctx.backend.delete(id);
+}
+/**
+ * Pull remote updates into the active backend. Only namespace
+ * implements this in v1 — see `Backend.fetch` for the rationale.
+ *
+ * File / hybrid throw a clear error so callers (UI buttons, CLI
+ * commands) can show a useful message rather than silently no-op.
+ */
+export async function fetchTasks(ctx = createContext()) {
+    if (typeof ctx.backend.fetch !== "function") {
+        throw new Error(`storage: ${ctx.backend.kind} doesn't support fetch (namespace only in v1)`);
+    }
+    return ctx.backend.fetch();
+}
+/** True if the active backend exposes a `fetch()` capability. */
+export function canFetch(ctx) {
+    return typeof ctx.backend.fetch === "function";
 }
 //# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/watcher.d.ts

@@ -1,5 +1,18 @@
 import type { StoreContext } from "./store.js";
 import type { Task } from "./schema.js";
+/**
+ * Event emitted by the backend's watcher.
+ *
+ * - `added`    : a new task appeared
+ * - `changed`  : an existing task's content changed
+ * - `removed`  : a task was deleted; carries `filePath` for file/hybrid
+ *                (and the synthetic `ref:<refname>` for namespace)
+ * - `renamed`  : namespace auto-renumber resolved a push-collision by
+ *                reallocating a fresh ID; carries both the old and new
+ *                IDs so the UI can show "previously known as X" and
+ *                clear any cached views keyed on `oldId`. Only the
+ *                namespace backend emits this.
+ */
 export type TaskEvent = {
     type: "added";
     task: Task;
@@ -9,10 +22,29 @@ export type TaskEvent = {
 } | {
     type: "removed";
     filePath: string;
+} | {
+    type: "renamed";
+    oldId: string;
+    newId: string;
+    task: Task;
 };
 export type TaskEventListener = (event: TaskEvent) => void;
 export interface WatchOptions {
+    /**
+     * Reserved for future use. Today this is unused — the active
+     * backend controls its own watch behaviour.
+     */
     ignoreInitial?: boolean;
 }
-export declare function watchTasks(ctx: StoreContext, listener: TaskEventListener, options?: WatchOptions): () => Promise<void>;
+/**
+ * Subscribe to task changes.
+ *
+ * Delegates to the active backend's `watch` method. The file backend
+ * uses chokidar on `<tasksDir>`; future remote backends (hybrid uses
+ * the same chokidar pattern; namespace polls `git for-each-ref`)
+ * plug their own implementations behind the same listener contract.
+ *
+ * Returns an unsubscribe function. Call it on shutdown.
+ */
+export declare function watchTasks(ctx: StoreContext, listener: TaskEventListener, _options?: WatchOptions): () => Promise<void>;
 //# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,SAAS,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,UAAU,CACzB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,YAAiB,GACxB,MAAM,OAAO,CAAC,IAAI,CAAC,CA8BrB"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,GAAE,YAAiB,GACzB,MAAM,OAAO,CAAC,IAAI,CAAC,CAErB"}