@frehilm/ordna-core 0.1.3 → 0.2.0

package/README.md

@@ -117,6 +117,40 @@ webPort: 7420              # consumed by @frehilm/ordna-web
 
 The last entry of `statuses` is the **terminal status** for the dependency gate.
 
+## Storage modes
+
+Ordna ships three storage backends. Pick one with a single config key:
+
+```yaml
+storage: file        # default
+# storage: hybrid    # files + synced ID allocator + audit log in git
+# storage: namespace # tasks as git refs; working tree stays clean
+```
+
+| Mode | Where tasks live | Working tree | Requires git | Use case |
+|---|---|---|---|---|
+| `file` | `tasks/*.md` | yes | no | Single-machine, agent-friendly, the default. |
+| `hybrid` | `tasks/*.md` + `refs/ordna/state` (next-id + audit log) | yes | yes | Multi-machine collaboration; prevents two offline writers picking the same ID. |
+| `namespace` | `refs/ordna/tasks/<id>` (blobs only) | untouched | yes | Decentralised, working-tree-clean, sync via standard `git push`/`fetch`. |
+
+`schema: backlog` is only supported with `storage: file`. `hybrid` and `namespace` require a git repository.
+
+### Auto-detection
+
+When no `.ordna/config.yaml` exists, Ordna inspects the directory and picks a mode:
+
+1. `refs/ordna/tasks/*` refs exist → `namespace`
+2. `refs/ordna/state` ref exists → `hybrid`
+3. `tasks/*.md` files exist → `file`
+4. cwd is a git repo (none of the above) → prompts the user (TUI modal, web setup page, CLI 1/2/3 on TTY)
+5. else (no git, no signals) → silently runs in `file` mode
+
+Confident detections (1–3) auto-write `.ordna/config.yaml` so the choice is durable across runs and visible to anyone reading the repo.
+
+### `ORDNA_STORAGE` env var
+
+Set `ORDNA_STORAGE=file|hybrid|namespace` to override both the config file and auto-detection for a single process invocation. Useful for CI (predictable storage mode, no on-disk side effects) and for tests pinning a specific mode against arbitrary directories.
+
 ## Backlog.md compatibility
 
 Ordna reads [Backlog.md](https://github.com/MrLesk/Backlog.md) repos out of the box. The parser normalizes both field sets:

package/dist/config.d.ts

@@ -7,6 +7,20 @@ export declare const configSchema: z.ZodObject<{
     idPrefix: z.ZodDefault<z.ZodString>;
     zeroPaddedIds: z.ZodDefault<z.ZodNumber>;
     webPort: z.ZodDefault<z.ZodNumber>;
+    storage: z.ZodDefault<z.ZodEnum<["file", "hybrid", "namespace"]>>;
+    namespace: z.ZodDefault<z.ZodObject<{
+        pollIntervalMs: z.ZodDefault<z.ZodNumber>;
+        autoFetchIntervalMs: z.ZodDefault<z.ZodNumber>;
+        autoRenumberOnConflict: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        pollIntervalMs: number;
+        autoFetchIntervalMs: number;
+        autoRenumberOnConflict: boolean;
+    }, {
+        pollIntervalMs?: number | undefined;
+        autoFetchIntervalMs?: number | undefined;
+        autoRenumberOnConflict?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     tasksDir: string;
     schema: "ordna" | "backlog";
@@ -14,6 +28,12 @@ export declare const configSchema: z.ZodObject<{
     idPrefix: string;
     zeroPaddedIds: number;
     webPort: number;
+    namespace: {
+        pollIntervalMs: number;
+        autoFetchIntervalMs: number;
+        autoRenumberOnConflict: boolean;
+    };
+    storage: "file" | "hybrid" | "namespace";
 }, {
     tasksDir?: string | undefined;
     schema?: "ordna" | "backlog" | undefined;
@@ -21,6 +41,12 @@ export declare const configSchema: z.ZodObject<{
     idPrefix?: string | undefined;
     zeroPaddedIds?: number | undefined;
     webPort?: number | undefined;
+    namespace?: {
+        pollIntervalMs?: number | undefined;
+        autoFetchIntervalMs?: number | undefined;
+        autoRenumberOnConflict?: boolean | undefined;
+    } | undefined;
+    storage?: "file" | "hybrid" | "namespace" | undefined;
 }>;
 export type OrdnaConfig = z.infer<typeof configSchema>;
 export declare const DEFAULT_CONFIG: OrdnaConfig;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,WAAoC,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,WAAW,CAYvE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAgB,GAAG,MAAM,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAEjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,WAAoC,CAAC;AAIlE,MAAM,WAAW,iBAAiB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,WAAW,CA6BvE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAgB,GAAG,MAAM,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAEjE"}

package/dist/config.js

@@ -9,6 +9,33 @@ export const configSchema = z.object({
     idPrefix: z.string().default("T"),
     zeroPaddedIds: z.number().int().min(0).max(10).default(3),
     webPort: z.number().int().min(1).max(65535).default(7420),
+    // T-031: storage mode selector. "file" (current default) keeps the
+    // existing on-disk layout. "hybrid" adds a sync ref for the next-id
+    // allocator + audit log. "namespace" (T-032) stores tasks as git
+    // blobs under `refs/ordna/tasks/<id>` with no working-tree presence.
+    storage: z.enum(["file", "hybrid", "namespace"]).default("file"),
+    // T-032: namespace-mode tuning. Polling interval for the watcher
+    // (refs have no kernel-level change-notification path, so polling
+    // is the only reliable mechanism). Default 1s. `autoFetchIntervalMs`
+    // runs `git fetch origin '+refs/ordna/tasks/*:refs/ordna/tasks/*'`
+    // in the background so other machines' updates land without manual
+    // pulls; set to 0 to disable auto-fetch entirely (manual fetch via
+    // the TUI / web button still works). `autoRenumberOnConflict`
+    // controls whether a push-rejection on a colliding create silently
+    // reallocates a fresh ID for the local task (true, default) or
+    // surfaces a loud error (false, for projects where stable IDs in
+    // commit messages / external links are load-bearing).
+    namespace: z
+        .object({
+        pollIntervalMs: z.number().int().min(50).default(1000),
+        autoFetchIntervalMs: z.number().int().min(0).default(60000),
+        autoRenumberOnConflict: z.boolean().default(true),
+    })
+        .default({
+        pollIntervalMs: 1000,
+        autoFetchIntervalMs: 60000,
+        autoRenumberOnConflict: true,
+    }),
 });
 export const DEFAULT_CONFIG = configSchema.parse({});
 const CONFIG_PATH = ".ordna/config.yaml";
@@ -20,7 +47,20 @@ export function loadConfig(options = {}) {
         const raw = readFileSync(configFile, "utf8");
         fromFile = parseYaml(raw) ?? {};
     }
-    const merged = { ...fromFile, ...(options.overrides ?? {}) };
+    const merged = {
+        ...fromFile,
+        ...(options.overrides ?? {}),
+    };
+    // T-033: `ORDNA_STORAGE` is a runtime override — when set to one of
+    // the known modes, it wins over whatever the YAML says. CI uses
+    // this to pin storage without writing a file; tests use it to
+    // exercise specific modes without polluting the test directory.
+    const envStorage = process.env.ORDNA_STORAGE;
+    if (envStorage === "file" ||
+        envStorage === "hybrid" ||
+        envStorage === "namespace") {
+        merged.storage = envStorage;
+    }
     return configSchema.parse(merged);
 }
 export function resolveTasksDir(config, cwd = process.cwd()) {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CACzD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAElE,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAOzC,MAAM,UAAU,UAAU,CAAC,UAA6B,EAAE;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE1C,IAAI,QAAQ,GAAY,EAAE,CAAC;IAC3B,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7C,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAI,QAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;IACzE,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACvE,OAAO,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC;AACtB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/git.d.ts

@@ -1,3 +1,13 @@
 import type { StoreContext } from "./store.js";
+/**
+ * Commit pending task changes.
+ *
+ * Delegates to the active backend's optional `commit()` method. The
+ * built-in file backend implements it (stages the tasks directory and
+ * runs `git commit`); future non-file backends (hybrid keeps it for
+ * the file half; namespace deliberately omits it because tasks aren't
+ * in the working tree) leave it undefined, in which case this throws
+ * a clear error pointing the user at the right sync flow.
+ */
 export declare function commitTasks(ctx: StoreContext, message?: string): Promise<void>;
 //# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqB/C,wBAAsB,WAAW,CAChC,GAAG,EAAE,YAAY,EACjB,OAAO,SAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,YAAY,EACjB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/git.js

@@ -1,30 +1,17 @@
-import { spawn } from "node:child_process";
-function run(cwd, args) {
-    return new Promise((resolve, reject) => {
-        const proc = spawn("git", args, { cwd });
-        let stdout = "";
-        let stderr = "";
-        proc.stdout.on("data", (chunk) => {
-            stdout += chunk.toString();
-        });
-        proc.stderr.on("data", (chunk) => {
-            stderr += chunk.toString();
-        });
-        proc.on("error", reject);
-        proc.on("close", (code) => {
-            if (code === 0)
-                resolve({ stdout, stderr });
-            else
-                reject(new Error(`git ${args.join(" ")} failed (${code}): ${stderr.trim()}`));
-        });
-    });
-}
-export async function commitTasks(ctx, message = "chore(tasks): update") {
-    await run(ctx.cwd, ["add", "--", ctx.config.tasksDir]);
-    const status = await run(ctx.cwd, ["status", "--porcelain", "--", ctx.config.tasksDir]);
-    if (status.stdout.trim().length === 0) {
-        throw new Error("No task changes to commit.");
+/**
+ * Commit pending task changes.
+ *
+ * Delegates to the active backend's optional `commit()` method. The
+ * built-in file backend implements it (stages the tasks directory and
+ * runs `git commit`); future non-file backends (hybrid keeps it for
+ * the file half; namespace deliberately omits it because tasks aren't
+ * in the working tree) leave it undefined, in which case this throws
+ * a clear error pointing the user at the right sync flow.
+ */
+export async function commitTasks(ctx, message) {
+    if (!ctx.backend.commit) {
+        throw new Error(`Backend "${ctx.backend.kind}" does not support \`ordna commit\`. Use the backend's own sync flow instead.`);
     }
-    await run(ctx.cwd, ["commit", "-m", message, "--", ctx.config.tasksDir]);
+    return ctx.backend.commit(message);
 }
 //# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;gBACvC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,GAAiB,EACjB,OAAO,GAAG,sBAAsB;IAEhC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,GAAiB,EACjB,OAAgB;IAEhB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,YAAY,GAAG,CAAC,OAAO,CAAC,IAAI,+EAA+E,CAC3G,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/index.d.ts

@@ -4,7 +4,9 @@ export { extractIdFromFilename, formatId, nextId, parseId } from "./ids.js";
 export { extractAcceptanceCriteria, findSection, parseTask, parseTaskFile, splitSections, } from "./parser.js";
 export type { AcceptanceItem, Priority, RawFrontmatter, SchemaMode, Section, Task, TaskCreateInput, TaskUpdateInput, } from "./schema.js";
 export { BACKLOG_BODY_HEADINGS, BODY_HEADING_ALIASES, FRONTMATTER_ALIASES, ORDNA_BODY_HEADINGS, frontmatterSchema, priorityEnum, } from "./schema.js";
-export { ARCHIVED_STATUS, createContext, createTask, deleteTask, getTask, isKnownStatus, listTasks, moveTask, updateTask, type ListTasksOptions, type StoreContext, } from "./store.js";
+export { ARCHIVED_STATUS, canFetch, createContext, createTask, deleteTask, fetchTasks, getTask, isKnownStatus, listTasks, moveTask, updateTask, type ListTasksOptions, type StoreContext, } from "./store.js";
+export type { FetchResult } from "./storage/backend.js";
 export { defaultSectionsFor, serializeTask } from "./writer.js";
 export { watchTasks, type TaskEvent, type TaskEventListener, type WatchOptions } from "./watcher.js";
+export { type DetectedMode, NeedsModeSelection, detectStorageMode, ensureStorageConfig, readEnvStorageMode, writeStorageConfig, } from "./storage/auto-detect.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACN,yBAAyB,EACzB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,UAAU,EACV,OAAO,EACP,IAAI,EACJ,eAAe,EACf,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACN,yBAAyB,EACzB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,UAAU,EACV,OAAO,EACP,IAAI,EACJ,eAAe,EACf,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,eAAe,EACf,QAAQ,EACR,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACrG,OAAO,EACN,KAAK,YAAY,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -3,7 +3,8 @@ export { commitTasks } from "./git.js";
 export { extractIdFromFilename, formatId, nextId, parseId } from "./ids.js";
 export { extractAcceptanceCriteria, findSection, parseTask, parseTaskFile, splitSections, } from "./parser.js";
 export { BACKLOG_BODY_HEADINGS, BODY_HEADING_ALIASES, FRONTMATTER_ALIASES, ORDNA_BODY_HEADINGS, frontmatterSchema, priorityEnum, } from "./schema.js";
-export { ARCHIVED_STATUS, createContext, createTask, deleteTask, getTask, isKnownStatus, listTasks, moveTask, updateTask, } from "./store.js";
+export { ARCHIVED_STATUS, canFetch, createContext, createTask, deleteTask, fetchTasks, getTask, isKnownStatus, listTasks, moveTask, updateTask, } from "./store.js";
 export { defaultSectionsFor, serializeTask } from "./writer.js";
 export { watchTasks } from "./watcher.js";
+export { NeedsModeSelection, detectStorageMode, ensureStorageConfig, readEnvStorageMode, writeStorageConfig, } from "./storage/auto-detect.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACN,yBAAyB,EACzB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,GACb,MAAM,aAAa,CAAC;AAWrB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,eAAe,EACf,aAAa,EACb,UAAU,EACV,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,EACT,QAAQ,EACR,UAAU,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAA6D,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EACN,yBAAyB,EACzB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,GACb,MAAM,aAAa,CAAC;AAWrB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,eAAe,EACf,QAAQ,EACR,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,EACT,QAAQ,EACR,UAAU,GAGV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAA6D,MAAM,cAAc,CAAC;AACrG,OAAO,EAEN,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/providers/load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/providers/load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,KACP,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAa1C;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,CAAC,CA6BvB"}
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/providers/load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,KACP,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AA0B1C;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,CAAC,CA6BvB"}

package/dist/providers/load.js

@@ -4,9 +4,20 @@ function isModuleNotFoundError(err, packageName) {
     if (!(err instanceof Error))
         return false;
     const code = err.code;
+    // Native Node ESM / CJS resolver.
     if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
         return err.message.includes(packageName);
     }
+    // Vite-node (used by Vitest) wraps unresolved imports without setting a
+    // recognizable error code. Match its message shape so the loader still
+    // surfaces the install hint when exercised from the test runner.
+    const msg = err.message;
+    if (msg.includes(packageName) &&
+        (msg.startsWith("Failed to load url") ||
+            msg.startsWith("Cannot find package") ||
+            msg.startsWith("Cannot find module"))) {
+        return true;
+    }
     return false;
 }
 /**

package/dist/providers/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/providers/load.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAY7C,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEhD,SAAS,qBAAqB,CAAC,GAAY,EAAE,WAAmB;IAC/D,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;IACjD,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACpE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAmB,EACnB,GAAW;IAEX,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE7B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,qBAAqB,GAAG,IAAI,EAAE,CAAC;IACtD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACd,aAAa,IAAI,kCAAkC,WAAW,EAAE,CAChE,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAI,GAAoC,CAAC,cAAc,CAAC;IACrE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACd,qBAAqB,WAAW,2KAA2K,CAC3M,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAO,OAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AACjB,CAAC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/providers/load.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAY7C,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEhD,SAAS,qBAAqB,CAAC,GAAY,EAAE,WAAmB;IAC/D,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;IACjD,kCAAkC;IAClC,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACpE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;IACxB,IACC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QACzB,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC;YACpC,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC;YACrC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,EACrC,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,MAAmB,EACnB,GAAW;IAEX,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE7B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,qBAAqB,GAAG,IAAI,EAAE,CAAC;IACtD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,qBAAqB,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACd,aAAa,IAAI,kCAAkC,WAAW,EAAE,CAChE,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAI,GAAoC,CAAC,cAAc,CAAC;IACrE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACd,qBAAqB,WAAW,2KAA2K,CAC3M,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAO,OAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/schema.d.ts

@@ -22,8 +22,25 @@ export interface Task {
     updated_at: string;
     sections: Section[];
     extra_frontmatter: Record<string, unknown>;
-    filePath: string;
+    /**
+     * On-disk location of the task file.
+     *
+     * Set by the file and hybrid backends (tasks live as `.md` files).
+     * **Unset** by the namespace backend — tasks there live as git
+     * blobs at `refs/ordna/tasks/<id>` with no working-tree presence.
+     * Consumers must guard against `undefined` (the CLI editor launcher
+     * and the create-command path-log already do).
+     */
+    filePath?: string;
     rawContent: string;
+    /**
+     * Most recent previous id this task had, if the namespace backend
+     * auto-renumbered it on a push collision. Surfaced as a
+     * "previously known as X" banner in the UIs. Populated only by the
+     * namespace backend (it reads the state ref's audit log on each
+     * `get`/`list`); file and hybrid leave it `undefined`.
+     */
+    renamed_from?: string;
 }
 export interface TaskCreateInput {
     title: string;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAUxD,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAMzD,CAAC;AAEF,eAAO,MAAM,YAAY,sCAAoC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAgBf,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAUxD,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAMzD,CAAC;AAEF,eAAO,MAAM,YAAY,sCAAoC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAgBf,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqDxB,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC5D,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;IACxB,UAAU,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;IAC1C,UAAU,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,CAAC;IACpD,UAAU,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,CAAC;IACpD,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,EAAE,EAAE,CAAC,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,WAAW,EAAE,MAAM;IACnB,mBAAmB,EAAE,qBAAqB;IAC1C,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,WAAW,EAAE,aAAa;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,aAAa,EAAE,eAAe;CACrB,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC7D,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;IACpC,mBAAmB,EAAE,CAAC,qBAAqB,CAAC;IAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACxC,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;IACvC,mBAAmB,EAAE,CAAC,qBAAqB,CAAC;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAChC,MAAM,CAAC;IACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC;KACD,WAAW,EAAE,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/storage/auto-detect.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Result of `detectStorageMode`. Three confident outcomes
+ * (`file` / `hybrid` / `namespace`) lead to auto-configuration; `ask`
+ * needs a user prompt; `default-file` is the "no signals, no git"
+ * fallback that runs in file mode without writing a config (the user
+ * might `git init` later).
+ */
+export type DetectedMode = {
+    mode: "file" | "hybrid" | "namespace";
+    reason: string;
+} | {
+    mode: "ask";
+    reason: string;
+} | {
+    mode: "default-file";
+    reason: string;
+};
+/**
+ * Thrown when `ensureStorageConfig` detects a git repo with no storage
+ * signals and no config — there's no defensible default, so the
+ * consumer must prompt the user. The TUI catches this and shows a
+ * modal, the web server catches it and serves a setup page, the CLI
+ * one-shots prompt on TTY or fail with a clear hint.
+ */
+export declare class NeedsModeSelection extends Error {
+    readonly cwd: string;
+    readonly reason: string;
+    constructor(cwd: string, reason: string);
+}
+/**
+ * Inspect `cwd` for storage signals. Pure detection — never writes,
+ * never creates anything. Returns a `DetectedMode` for the caller to
+ * act on.
+ *
+ * Detection order:
+ *   1. `refs/ordna/tasks/*` exist → `namespace`
+ *   2. `refs/ordna/state` exists → `hybrid`
+ *   3. `tasks/*.md` files exist → `file`
+ *   4. cwd is a git repo (none of the above) → `ask`
+ *   5. else → `default-file`
+ *
+ * Uses `git for-each-ref` to authoritative-check refs (handles packed
+ * refs after `git gc` correctly, where direct filesystem reads of
+ * `.git/refs/...` would miss them).
+ */
+export declare function detectStorageMode(cwd: string): Promise<DetectedMode>;
+/**
+ * Compose detection + write into one call.
+ *
+ * - If `ORDNA_STORAGE` is set to a valid mode, return immediately
+ *   without writing or detecting. The caller relies on `loadConfig`
+ *   honouring the env var.
+ * - If `.ordna/config.yaml` already exists, return immediately.
+ * - Otherwise run `detectStorageMode` and:
+ *   - `file` / `hybrid` / `namespace` → write the config with the
+ *     detected storage key
+ *   - `ask` → throw `NeedsModeSelection`
+ *   - `default-file` → return without writing (let the caller fall
+ *     back to in-memory file mode; if the user later `git init`s,
+ *     detection re-evaluates from scratch on next run)
+ */
+export declare function ensureStorageConfig(cwd: string): Promise<void>;
+/**
+ * Write a minimal `.ordna/config.yaml` containing the chosen storage
+ * mode. Other config keys are left to the schema defaults so the file
+ * doesn't pin values the user hasn't deliberately chosen.
+ *
+ * Idempotent — overwrites an existing config file. Callers that don't
+ * want that should check first (see `ensureStorageConfig`).
+ */
+export declare function writeStorageConfig(cwd: string, storage: "file" | "hybrid" | "namespace"): void;
+/**
+ * Read `ORDNA_STORAGE` from the environment, validating against the
+ * three known modes. Anything else (including unset / empty) returns
+ * `null` so the normal detection path runs.
+ *
+ * Exported so `config.ts` can apply the same override when reading the
+ * YAML — keeps the env-var semantics consistent across the two
+ * entrypoints.
+ */
+export declare function readEnvStorageMode(): "file" | "hybrid" | "namespace" | null;
+//# sourceMappingURL=auto-detect.d.ts.map

package/dist/storage/auto-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-detect.d.ts","sourceRoot":"","sources":["../../src/storage/auto-detect.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACrB;IAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAE3B,GAAG,EAAE,MAAM;aACX,MAAM,EAAE,MAAM;gBADd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM;CAO/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8C1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GACtC,IAAI,CAKN;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAC/B,MAAM,GACN,QAAQ,GACR,WAAW,GACX,IAAI,CAIN"}

package/dist/storage/auto-detect.js

@@ -0,0 +1,158 @@
+import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { GitRunner } from "./git-ref.js";
+/**
+ * Thrown when `ensureStorageConfig` detects a git repo with no storage
+ * signals and no config — there's no defensible default, so the
+ * consumer must prompt the user. The TUI catches this and shows a
+ * modal, the web server catches it and serves a setup page, the CLI
+ * one-shots prompt on TTY or fail with a clear hint.
+ */
+export class NeedsModeSelection extends Error {
+    cwd;
+    reason;
+    constructor(cwd, reason) {
+        super(`Ordna needs to know which storage mode to use in ${cwd}. ${reason}`);
+        this.cwd = cwd;
+        this.reason = reason;
+        this.name = "NeedsModeSelection";
+    }
+}
+/**
+ * Inspect `cwd` for storage signals. Pure detection — never writes,
+ * never creates anything. Returns a `DetectedMode` for the caller to
+ * act on.
+ *
+ * Detection order:
+ *   1. `refs/ordna/tasks/*` exist → `namespace`
+ *   2. `refs/ordna/state` exists → `hybrid`
+ *   3. `tasks/*.md` files exist → `file`
+ *   4. cwd is a git repo (none of the above) → `ask`
+ *   5. else → `default-file`
+ *
+ * Uses `git for-each-ref` to authoritative-check refs (handles packed
+ * refs after `git gc` correctly, where direct filesystem reads of
+ * `.git/refs/...` would miss them).
+ */
+export async function detectStorageMode(cwd) {
+    const isGitRepo = isGitWorkingTree(cwd);
+    if (isGitRepo) {
+        const git = new GitRunner(cwd);
+        const taskRefs = await git.forEachRef("refs/ordna/tasks/*");
+        if (taskRefs.length > 0) {
+            return {
+                mode: "namespace",
+                reason: `found ${taskRefs.length} ref(s) under refs/ordna/tasks/`,
+            };
+        }
+        const stateRefs = await git.forEachRef("refs/ordna/state");
+        if (stateRefs.length > 0) {
+            return { mode: "hybrid", reason: "found refs/ordna/state" };
+        }
+    }
+    // File-mode signal: `tasks/` with at least one `.md` file. Without
+    // a loaded config we can only check the default path; non-default
+    // `tasksDir` configurations imply a config exists, in which case
+    // detection never runs.
+    const tasksDir = join(cwd, "tasks");
+    if (existsSync(tasksDir)) {
+        try {
+            const entries = readdirSync(tasksDir, { withFileTypes: true });
+            const hasMd = entries.some((e) => e.isFile() && e.name.endsWith(".md"));
+            if (hasMd) {
+                return { mode: "file", reason: "found tasks/*.md files" };
+            }
+        }
+        catch {
+            // readdirSync error (permissions, etc.) — treat as "no signal."
+        }
+    }
+    if (isGitRepo) {
+        return {
+            mode: "ask",
+            reason: "no storage signals found, but this is a git repo",
+        };
+    }
+    return {
+        mode: "default-file",
+        reason: "no git, no existing tasks — defaulting to file mode",
+    };
+}
+/**
+ * Compose detection + write into one call.
+ *
+ * - If `ORDNA_STORAGE` is set to a valid mode, return immediately
+ *   without writing or detecting. The caller relies on `loadConfig`
+ *   honouring the env var.
+ * - If `.ordna/config.yaml` already exists, return immediately.
+ * - Otherwise run `detectStorageMode` and:
+ *   - `file` / `hybrid` / `namespace` → write the config with the
+ *     detected storage key
+ *   - `ask` → throw `NeedsModeSelection`
+ *   - `default-file` → return without writing (let the caller fall
+ *     back to in-memory file mode; if the user later `git init`s,
+ *     detection re-evaluates from scratch on next run)
+ */
+export async function ensureStorageConfig(cwd) {
+    const envMode = readEnvStorageMode();
+    if (envMode) {
+        // Env var is a runtime override; do not write the config file.
+        return;
+    }
+    if (configFileExists(cwd)) {
+        return;
+    }
+    const detected = await detectStorageMode(cwd);
+    switch (detected.mode) {
+        case "file":
+        case "hybrid":
+        case "namespace":
+            writeStorageConfig(cwd, detected.mode);
+            return;
+        case "ask":
+            throw new NeedsModeSelection(cwd, detected.reason);
+        case "default-file":
+            return; // run with in-memory defaults; don't litter
+    }
+}
+/**
+ * Write a minimal `.ordna/config.yaml` containing the chosen storage
+ * mode. Other config keys are left to the schema defaults so the file
+ * doesn't pin values the user hasn't deliberately chosen.
+ *
+ * Idempotent — overwrites an existing config file. Callers that don't
+ * want that should check first (see `ensureStorageConfig`).
+ */
+export function writeStorageConfig(cwd, storage) {
+    const configDir = join(cwd, ".ordna");
+    if (!existsSync(configDir))
+        mkdirSync(configDir, { recursive: true });
+    const body = `# Ordna config — auto-written from storage detection.\nstorage: ${storage}\n`;
+    writeFileSync(join(configDir, "config.yaml"), body, "utf8");
+}
+/**
+ * Read `ORDNA_STORAGE` from the environment, validating against the
+ * three known modes. Anything else (including unset / empty) returns
+ * `null` so the normal detection path runs.
+ *
+ * Exported so `config.ts` can apply the same override when reading the
+ * YAML — keeps the env-var semantics consistent across the two
+ * entrypoints.
+ */
+export function readEnvStorageMode() {
+    const raw = process.env.ORDNA_STORAGE;
+    if (raw === "file" || raw === "hybrid" || raw === "namespace")
+        return raw;
+    return null;
+}
+function configFileExists(cwd) {
+    return existsSync(join(cwd, ".ordna", "config.yaml"));
+}
+function isGitWorkingTree(cwd) {
+    // `.git` can be a directory (regular repo), a file (worktree
+    // pointing at the main repo's gitdir), or absent. `existsSync` on
+    // `<cwd>/.git` covers all three cases — present (any type) means
+    // "this is a git checkout."
+    return existsSync(join(cwd, ".git"));
+}
+//# sourceMappingURL=auto-detect.js.map

package/dist/storage/auto-detect.js.map

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