@wrenautomation/aerie 0.8.1 → 0.8.3

package/dist/bin.js

@@ -2408,9 +2408,9 @@ function formatError2(error62, mapper = (issue2) => issue2.message) {
           let i = 0;
           while (i < fullpath.length) {
             const el = fullpath[i];
-            const terminal = i === fullpath.length - 1;
+            const terminal2 = i === fullpath.length - 1;
             if (el === "_errors") {
-              if (terminal)
+              if (terminal2)
                 curr._errors.push(mapper(issue2));
               i++;
               continue;
@@ -2424,7 +2424,7 @@ function formatError2(error62, mapper = (issue2) => issue2.message) {
               });
             }
             const node2 = curr[el];
-            if (terminal) {
+            if (terminal2) {
               node2._errors.push(mapper(issue2));
             }
             curr = node2;
@@ -2458,7 +2458,7 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
         let i = 0;
         while (i < fullpath.length) {
           const el = fullpath[i];
-          const terminal = i === fullpath.length - 1;
+          const terminal2 = i === fullpath.length - 1;
           if (typeof el === "string") {
             curr.properties ?? (curr.properties = {});
             if (!Object.prototype.hasOwnProperty.call(curr.properties, el)) {
@@ -2475,7 +2475,7 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
             (_a3 = curr.items)[el] ?? (_a3[el] = { errors: [] });
             curr = curr.items[el];
           }
-          if (terminal) {
+          if (terminal2) {
             curr.errors.push(mapper(issue2));
           }
           i++;
@@ -3606,11 +3606,11 @@ function capSize(inst, size) {
   const caps = sizeCaps(inst._zod.def.checks);
   if (!caps.length)
     return;
-  const cap2 = Math.min(...caps.map((c) => c[0]));
+  const cap = Math.min(...caps.map((c) => c[0]));
   const parse6 = inst._zod.parse;
   inst._zod.parse = (payload, ctx) => {
     const n = size(payload.value);
-    if (n > cap2 && !ctx?.skipChecks && ctx?.direction !== "backward") {
+    if (n > cap && !ctx?.skipChecks && ctx?.direction !== "backward") {
       for (const [max, ch] of sizeCaps(inst._zod.def.checks)) {
         if (n > max && ch._zod.def.when(payload)) {
           const start = payload.issues.length;
@@ -22965,7 +22965,7 @@ var init_sql = __esm({
         return new SQL([new StringChunk(str2)]);
       }
       sql2.raw = raw;
-      function join8(chunks, separator) {
+      function join9(chunks, separator) {
         const result = [];
         for (const [i, chunk] of chunks.entries()) {
           if (i > 0 && separator !== void 0) {
@@ -22975,7 +22975,7 @@ var init_sql = __esm({
         }
         return new SQL(result);
       }
-      sql2.join = join8;
+      sql2.join = join9;
       function identifier(value) {
         return new Name(value);
       }
@@ -27253,7 +27253,7 @@ var init_select2 = __esm({
           const baseTableName = this.tableName;
           const tableName = getTableLikeName(table);
           for (const item of extractUsedTable(table)) this.usedTables.add(item);
-          if (typeof tableName === "string" && this.config.joins?.some((join8) => join8.alias === tableName)) {
+          if (typeof tableName === "string" && this.config.joins?.some((join9) => join9.alias === tableName)) {
             throw new Error(`Alias "${tableName}" is already used in this query`);
           }
           if (!this.isPartialSelect) {
@@ -28780,7 +28780,7 @@ var init_update = __esm({
       createJoin(joinType) {
         return (table, on) => {
           const tableName = getTableLikeName(table);
-          if (typeof tableName === "string" && this.config.joins.some((join8) => join8.alias === tableName)) {
+          if (typeof tableName === "string" && this.config.joins.some((join9) => join9.alias === tableName)) {
             throw new Error(`Alias "${tableName}" is already used in this query`);
           }
           if (typeof on === "function") {
@@ -28876,10 +28876,10 @@ var init_update = __esm({
               const fromFields = this.getTableLikeFields(this.config.from);
               fields[tableName] = fromFields;
             }
-            for (const join8 of this.config.joins) {
-              const tableName2 = getTableLikeName(join8.table);
-              if (typeof tableName2 === "string" && !is(join8.table, SQL)) {
-                const fromFields = this.getTableLikeFields(join8.table);
+            for (const join9 of this.config.joins) {
+              const tableName2 = getTableLikeName(join9.table);
+              if (typeof tableName2 === "string" && !is(join9.table, SQL)) {
+                const fromFields = this.getTableLikeFields(join9.table);
                 fields[tableName2] = fromFields;
               }
             }
@@ -30104,7 +30104,7 @@ var init_address = __esm({
 function checks4(cs, e, what) {
   if (!e) return cs;
   let out = cs.map((c) => ({ ...c }));
-  const at3 = (n) => {
+  const at4 = (n) => {
     const c = out[n - 1];
     if (!c) throw new Error(`${what} #${n} does not exist (has ${out.length})`);
     return c;
@@ -30114,10 +30114,10 @@ function checks4(cs, e, what) {
     const was = new Map(out.map((c) => [c.text.trim(), c.done]));
     out = e.replace.map((text3) => ({ text: text3.trim(), done: was.get(text3.trim()) ?? false }));
   }
-  for (const n of e.check ?? []) at3(n).done = true;
-  for (const n of e.uncheck ?? []) at3(n).done = false;
+  for (const n of e.check ?? []) at4(n).done = true;
+  for (const n of e.uncheck ?? []) at4(n).done = false;
   if (e.remove?.length) {
-    for (const n of e.remove) at3(n);
+    for (const n of e.remove) at4(n);
     const drop = new Set(e.remove);
     out = out.filter((_, i) => !drop.has(i + 1));
   }
@@ -31151,13 +31151,13 @@ function aerieStore(o) {
       if (input2.milestone)
         input2 = { ...input2, milestone: await milestoneOf(tx, input2.milestone) };
       const id2 = await nextId(tx, parent?.id);
-      const at3 = now();
+      const at4 = now();
       const blank = {
         id: id2,
         title: input2.title,
         status: input2.status ?? "To Do",
         assignees: [],
-        createdAt: at3,
+        createdAt: at4,
         labels: [],
         dependencies: [],
         references: [],
@@ -31166,7 +31166,7 @@ function aerieStore(o) {
         comments: [],
         extra: {}
       };
-      const t = applyEdit(blank, { ...input2, ...parent ? { parentId: parent.id } : {} }, at3);
+      const t = applyEdit(blank, { ...input2, ...parent ? { parentId: parent.id } : {} }, at4);
       delete t.updatedAt;
       const area2 = input2.area ?? parent?.area ?? areaFor(t, rules);
       await put(tx, t, await ensureArea(tx, area2), input2.place ?? "tasks");
@@ -31299,8 +31299,18 @@ function aerieStore(o) {
   }
   async function statusOf2(ids) {
     if (!ids.length) return /* @__PURE__ */ new Map();
-    const rows3 = await db.select({ id: task.id, status: task.status }).from(task).where(inArray(task.id, [...new Set(ids)]));
-    return new Map(rows3.map((r) => [r.id, r.status]));
+    const rows3 = await db.select({ id: task.id, status: task.status }).from(task).where(inArray(sql`upper(${task.id})`, [...new Set(ids.map((x) => x.toUpperCase()))]));
+    return new Map(rows3.map((r) => [r.id.toUpperCase(), r.status]));
+  }
+  async function dependencyRows() {
+    return db.select({
+      id: task.id,
+      title: task.title,
+      status: task.status,
+      place: task.place,
+      parentId: task.parentId,
+      dependencies: task.dependencies
+    }).from(task);
   }
   async function getSetting(key) {
     const r = await db.select({ v: setting.value }).from(setting).where(eq(setting.key, key));
@@ -31400,7 +31410,12 @@ function aerieStore(o) {
     });
   }
   async function lastEvent(taskId, kind) {
-    const [r] = await db.select().from(taskEvent).where(and(eq(taskEvent.taskId, taskId.toUpperCase()), eq(taskEvent.kind, kind))).orderBy(sql`${taskEvent.seq} desc`).limit(1);
+    const [r] = await db.select().from(taskEvent).where(
+      and(
+        sql`upper(${taskEvent.taskId}) = ${taskId.toUpperCase()}`,
+        eq(taskEvent.kind, kind)
+      )
+    ).orderBy(sql`${taskEvent.seq} desc`).limit(1);
     return r ?? null;
   }
   async function countEvents(taskId, kind, body, after = 0) {
@@ -31455,6 +31470,7 @@ function aerieStore(o) {
     milestones,
     putMilestones,
     statusOf: statusOf2,
+    dependencyRows,
     mirrorFiles,
     setMirrorFile,
     setMirrorFiles,
@@ -31517,10 +31533,10 @@ function rank(ts, query) {
   });
   const q = query.trim().toLowerCase();
   const inTitle = (t) => t.title.toLowerCase().includes(q) ? 1 : 0;
-  const at3 = (t) => t.updatedAt ?? t.createdAt;
+  const at4 = (t) => t.updatedAt ?? t.createdAt;
   return fuse.search(query).map((r) => ({ task: r.item, score: 1 - (r.score ?? 0) })).sort(
     // ties (exact substrings all score 1): a title hit, then the newest
-    (x, y) => y.score - x.score || inTitle(y.task) - inTitle(x.task) || at3(y.task).localeCompare(at3(x.task))
+    (x, y) => y.score - x.score || inTitle(y.task) - inTitle(x.task) || at4(y.task).localeCompare(at4(x.task))
   );
 }
 function searchPlain(hits) {
@@ -32979,7 +32995,7 @@ async function rows2(q, query) {
 function pgCoord(o) {
   const db = o.db;
   const ns = o.ns ?? "main";
-  const clock = () => o.now ? at2(o.now()) : sql`now()`;
+  const clock = () => o.now ? at3(o.now()) : sql`now()`;
   const plus = (t, ms2) => sql`(${t} + ${ms2}::float8 * interval '1 millisecond')`;
   const L = coordLease;
   const C = coordClosing;
@@ -33299,7 +33315,7 @@ function pgCoord(o) {
     };
   return store;
 }
-var COORD_CHANNEL, ms, at2, num, textArr;
+var COORD_CHANNEL, ms, at3, num, textArr;
 var init_postgres = __esm({
   "src/coord/postgres.ts"() {
     "use strict";
@@ -33309,7 +33325,7 @@ var init_postgres = __esm({
     init_store();
     COORD_CHANNEL = "aerie_coord";
     ms = (v) => sql`(extract(epoch from ${v}) * 1000)::float8`;
-    at2 = (v) => sql`to_timestamp(${v}::float8 / 1000)`;
+    at3 = (v) => sql`to_timestamp(${v}::float8 / 1000)`;
     num = (v) => Math.round(Number(v));
     textArr = (v) => sql`${`{${v.map((x) => JSON.stringify(x)).join(",")}}`}::text[]`;
   }
@@ -33676,6 +33692,7 @@ var init_remote = __esm({
       actors: read(),
       milestones: read(),
       statusOf: read([IDS]),
+      dependencyRows: read(),
       routeRules: read(),
       lastEvent: read([ID2, KIND]),
       countEvents: read([
@@ -33892,7 +33909,7 @@ import { spawnSync as spawnSync2 } from "node:child_process";
 import { createHash as createHash2, createHmac, pbkdf2Sync, randomBytes } from "node:crypto";
 import { chmodSync, existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { dirname as dirname4, join as join7 } from "node:path";
 function aerieUrl(adminUrl, role = ROLE) {
   const url2 = new URL(adminUrl);
   if (!url2.password) throw new Error("admin URL has no password; aerie derives its own from it");
@@ -33950,7 +33967,7 @@ function writeSettings(set3, file2 = settingsFile(), drop = []) {
   const lines = existsSync5(file2) ? readFileSync5(file2, "utf8").split("\n").filter(Boolean) : [];
   const gone = [...Object.keys(set3), ...drop];
   const kept = lines.filter((l) => !gone.some((k) => l.startsWith(`${k}=`)));
-  mkdirSync3(dirname3(file2), { recursive: true, mode: 448 });
+  mkdirSync3(dirname4(file2), { recursive: true, mode: 448 });
   writeFileSync3(
     file2,
     `${[...kept, ...Object.entries(set3).map(([k, v]) => `${k}=${v}`)].join("\n")}
@@ -33989,14 +34006,14 @@ var init_setup = __esm({
     ROLE = "aerie";
     SCHEMA = "aerie";
     ATTRS = "LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT NOREPLICATION NOBYPASSRLS";
-    settingsFile = () => join6(homedir3(), ".config", "aerie", "env");
+    settingsFile = () => join7(homedir3(), ".config", "aerie", "env");
   }
 });
 
 // src/bin.ts
 import { readFileSync as readFileSync6 } from "node:fs";
 import { homedir as homedir4, userInfo } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 
 // node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
 var CommanderError = class extends Error {
@@ -37366,6 +37383,9 @@ function useColor() {
 // node_modules/.pnpm/commander@15.0.0/node_modules/commander/index.js
 var program = new Command();
 
+// src/cli.ts
+import { dirname as dirname3, join as join6, relative } from "node:path";
+
 // src/backlog/files.ts
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -40340,11 +40360,11 @@ function check3(words, split, o) {
   const out = { ok: [], failedSpans: [], missed: [] };
   const areas = new Set(o.areas);
   const fuse = new Fuse(o.open, { keys: ["title"], includeScore: true, threshold: 0.3 });
-  split.tasks.forEach((task2, at3) => {
+  split.tasks.forEach((task2, at4) => {
     const span = normal(task2.span);
     const i = span ? src.indexOf(span) : -1;
     if (i < 0) {
-      out.failedSpans.push({ at: at3, title: task2.title, span: task2.span });
+      out.failedSpans.push({ at: at4, title: task2.title, span: task2.span });
       return;
     }
     covered.fill(1, i, i + span.length);
@@ -40352,7 +40372,7 @@ function check3(words, split, o) {
     const best = fuse.search(task2.title, { limit: 1 })[0];
     out.ok.push({
       task: task2,
-      at: at3,
+      at: at4,
       area: area2,
       dup: best && (best.score ?? 1) <= 0.25 ? { id: best.item.id, title: best.item.title, score: best.score ?? 0 } : void 0
     });
@@ -40403,12 +40423,12 @@ async function hear(file2, o = {}) {
   const { hearSpeech, speechHere } = await import("@wrenautomation/read/video");
   const { mkdtemp: mkdtemp2, rm } = await import("node:fs/promises");
   const { tmpdir: tmpdir2 } = await import("node:os");
-  const { join: join8 } = await import("node:path");
+  const { join: join9 } = await import("node:path");
   const cohere = (process.env.COHERE_API_KEY ?? "").split(",").filter(Boolean);
   const ear = speechHere(cohere);
   if (!ear)
     throw new AerieError("no ear: install whisper.cpp and its model, or set COHERE_API_KEY");
-  const dir = await mkdtemp2(join8(tmpdir2(), "aerie-hear-"));
+  const dir = await mkdtemp2(join9(tmpdir2(), "aerie-hear-"));
   const t0 = performance.now();
   try {
     const text3 = await hearSpeech(file2, dir, o.ffmpeg ?? "ffmpeg", ear, {
@@ -41566,10 +41586,10 @@ function registerRunCommands(program3, ctx) {
       const runner = headlessRunners(aerieEnv()).get(name);
       if (!runner) throw new Error(`${name} runs in a live session, not a worker`);
       const caps = parseLanes(await a.getSetting("run_cap") ?? "", "run_cap");
-      const cap2 = o.cap === void 0 ? caps[name] : Number(o.cap);
-      if (cap2 !== void 0 && !(Number.isInteger(cap2) && cap2 > 0))
+      const cap = o.cap === void 0 ? caps[name] : Number(o.cap);
+      if (cap !== void 0 && !(Number.isInteger(cap) && cap > 0))
         throw new Error(
-          `${o.cap === void 0 ? `run_cap ${name}` : "--cap"}: ${cap2} is not a whole number above 0`
+          `${o.cap === void 0 ? `run_cap ${name}` : "--cap"}: ${cap} is not a whole number above 0`
         );
       const stop = new AbortController();
       const quit = () => stop.abort();
@@ -41585,7 +41605,7 @@ function registerRunCommands(program3, ctx) {
           idleMs: Number(o.idle),
           once: !!o.once,
           signal: stop.signal,
-          ...cap2 === void 0 ? {} : { cap: cap2 },
+          ...cap === void 0 ? {} : { cap },
           onOutcome: (w) => print2(
             o.json ? `${JSON.stringify(w)}
 ` : `${w.id} ${w.outcome}${"summary" in w ? `: ${w.summary.split("\n")[0]}` : ""}
@@ -41796,8 +41816,20 @@ async function mirror(a, root, o = {}) {
     } else r.wrote.push(target);
     touched.push(target);
   }
+  const ids = new Set(tasks.map((t) => t.id));
+  const fresh = [...disk.values()].filter((f) => !ids.has(f.task.id) && !state.has(f.task.id));
+  if (fresh.length && !o.dryRun) {
+    await a.importTasks(
+      fresh.map((f) => ({ task: f.task, place: f.where })),
+      o.by ?? "@backlog"
+    );
+    for (const f of fresh) {
+      const now = await a.get(f.task.id);
+      if (now) await a.setMirrorFile(now.id, f.path, sha(f.text), now.version);
+    }
+  }
+  r.imported.push(...fresh.map((f) => f.path));
   if (!o.only) {
-    const ids = new Set(tasks.map((t) => t.id));
     for (const [id, m] of state) if (!ids.has(id)) r.left.push(m.path);
   }
   if (o.commit && touched.length && !o.dryRun) r.committed = commit(root, touched, o.commit);
@@ -41842,24 +41874,251 @@ init_schema2();
 init_search();
 
 // src/shape.ts
-var DONE = "Done";
-function readiness(t, status) {
-  const missing = t.dependencies.filter((d) => !status.has(d));
-  const blocking = t.dependencies.filter((d) => status.has(d) && status.get(d) !== DONE);
+var ARCHIVE = /* @__PURE__ */ new Set(["archive/tasks", "archive/drafts"]);
+var shown = (id, place) => ARCHIVE.has(place) ? id : id.toUpperCase();
+var terminal = (statuses) => (statuses.at(-1) ?? "Done").trim().toLowerCase();
+var finished = (status, statuses) => (status ?? "").trim().toLowerCase() === terminal(statuses);
+function parseTaskId(id) {
+  const body = id.replace(/^[a-zA-Z]+-/i, "");
+  const parts = body.split(".").map((p) => {
+    const n = Number.parseInt(p, 10);
+    return Number.isNaN(n) ? null : n;
+  });
+  if (parts.every((n) => n !== null)) return parts;
+  const tail2 = body.match(/(\d+)$/);
+  return [tail2 ? Number.parseInt(tail2[1] ?? "0", 10) : 0];
+}
+function compareTaskIds(a, b) {
+  const x = parseTaskId(a);
+  const y = parseTaskId(b);
+  for (let i = 0; i < Math.max(x.length, y.length); i++) {
+    const d = (x[i] ?? 0) - (y[i] ?? 0);
+    if (d) return d;
+  }
+  return a.localeCompare(b, void 0, { sensitivity: "base", numeric: true });
+}
+var RANK = { high: 3, medium: 2, low: 1 };
+var rank2 = (p) => RANK[(p ?? "").trim().toLowerCase()] ?? 0;
+function backlogOrder(ts) {
+  return [...ts].sort((a, b) => {
+    if (a.ordinal !== void 0 && b.ordinal === void 0) return -1;
+    if (a.ordinal === void 0 && b.ordinal !== void 0) return 1;
+    if (a.ordinal !== void 0 && b.ordinal !== void 0 && a.ordinal !== b.ordinal)
+      return a.ordinal - b.ordinal;
+    return rank2(b.priority) - rank2(a.priority) || compareTaskIds(a.id, b.id);
+  });
+}
+function readiness(t, resolve, statuses) {
+  if (ARCHIVE.has(t.place) || finished(t.status, statuses))
+    return { isReady: false, isBlocked: false, blockingDependencies: [], missingDependencies: [] };
+  const blocking = [];
+  const missing = [];
+  for (const d of t.dependencies) {
+    const r = resolve(d);
+    if (!r) missing.push(d);
+    else if (!finished(r.status, statuses)) blocking.push(r.id);
+  }
   const isBlocked = blocking.length > 0 || missing.length > 0;
   return {
-    isReady: t.status !== DONE && !isBlocked,
+    isReady: !isBlocked,
     isBlocked,
     blockingDependencies: blocking,
     missingDependencies: missing
   };
 }
-function listItem(t, status) {
+function boardIndex(rows3) {
+  const index2 = /* @__PURE__ */ new Map();
+  for (const r of [
+    ...rows3.filter((x) => x.place === "tasks"),
+    ...rows3.filter((x) => x.place === "archive/tasks")
+  ]) {
+    const k = canonicalId(r.id);
+    index2.set(k, index2.has(k) ? "ambiguous" : r);
+  }
+  return index2;
+}
+var depthIn = (n, d) => d === "dependencies" ? n.dependencyDepth : n.dependentDepth;
+function canonicalId(id) {
+  const t = id.trim();
+  const m = /^([a-z]+)-([0-9]+(?:\.[0-9]+)*)$/i.exec(t);
+  if (!m) return t.toUpperCase();
+  const body = m[2].split(".").map((s) => s.replace(/^0+/, "") || "0").join(".");
+  return `${m[1].toUpperCase()}-${body}`;
+}
+function dependencyGraph(root, rows3, statuses) {
+  const index2 = boardIndex(rows3);
+  const records = rows3.filter((x) => x.place === "tasks" || x.place === "archive/tasks");
+  const rootKey = canonicalId(root.id);
+  const entries = /* @__PURE__ */ new Map();
+  const edges = /* @__PURE__ */ new Map();
+  const rootRow = index2.get(rootKey);
+  entries.set(rootKey, {
+    id: shown(root.id, root.place),
+    title: root.title,
+    status: root.status,
+    state: "resolved",
+    completed: finished(
+      rootRow && rootRow !== "ambiguous" ? rootRow.status : root.status,
+      statuses
+    ),
+    dependencyDepth: 0,
+    dependentDepth: 0
+  });
+  const ensure = (key, ref) => {
+    const have = entries.get(key);
+    if (have) return have;
+    const r = index2.get(key);
+    const base = { completed: false, dependencyDepth: null, dependentDepth: null };
+    const node2 = r === void 0 ? { id: ref.trim() || key, title: null, status: null, state: "missing", ...base } : r === "ambiguous" ? { id: key, title: null, status: null, state: "ambiguous", ...base } : {
+      id: shown(r.id, r.place),
+      title: r.title,
+      status: r.status,
+      state: "resolved",
+      ...base,
+      completed: finished(r.status, statuses)
+    };
+    entries.set(key, node2);
+    return node2;
+  };
+  const depsOf = (key) => {
+    if (key === rootKey) return root.dependencies;
+    const r = index2.get(key);
+    return r && r !== "ambiguous" ? r.dependencies : [];
+  };
+  const declarers = /* @__PURE__ */ new Map();
+  for (const r of records) {
+    const from = canonicalId(r.id);
+    for (const d of r.dependencies) {
+      const to = canonicalId(d);
+      declarers.set(to, (declarers.get(to) ?? /* @__PURE__ */ new Set()).add(from));
+    }
+  }
+  const traverse2 = (dir, next) => {
+    const queue = [{ key: rootKey, depth: 0 }];
+    for (let i = 0; i < queue.length; i++) {
+      const cur = queue[i];
+      if (entries.get(cur.key)?.state !== "resolved") continue;
+      for (const n of next(cur.key)) {
+        const node2 = ensure(n.key, n.ref);
+        const e = dir === "dependencies" ? { fromKey: cur.key, toKey: n.key } : { fromKey: n.key, toKey: cur.key };
+        edges.set(`${e.fromKey} -> ${e.toKey}`, e);
+        if (depthIn(node2, dir) !== null) continue;
+        if (dir === "dependencies") node2.dependencyDepth = cur.depth + 1;
+        else node2.dependentDepth = cur.depth + 1;
+        queue.push({ key: n.key, depth: cur.depth + 1 });
+      }
+    }
+  };
+  traverse2("dependencies", (k) => depsOf(k).map((ref) => ({ key: canonicalId(ref), ref })));
+  traverse2(
+    "dependents",
+    (k) => [...declarers.get(k) ?? []].sort(compareTaskIds).map((d) => ({ key: d, ref: d }))
+  );
+  const rootNode = entries.get(rootKey);
+  const rest = [...entries.entries()].filter(([k]) => k !== rootKey).sort((a, b) => compareTaskIds(a[1].id, b[1].id));
+  const ordered = [[rootKey, rootNode], ...rest];
+  const idOf = new Map(ordered.map(([k, n]) => [k, n.id]));
   return {
-    id: t.id,
+    rootId: shown(root.id, root.place),
+    nodes: ordered.map(([, n]) => n),
+    edges: [...edges.values()].map((e) => ({ from: idOf.get(e.fromKey) ?? e.fromKey, to: idOf.get(e.toKey) ?? e.toKey })).sort((a, b) => compareTaskIds(a.from, b.from) || compareTaskIds(a.to, b.to))
+  };
+}
+function dependencyTree(g, dir) {
+  const byId = new Map(g.nodes.map((n) => [n.id, n]));
+  const kids = /* @__PURE__ */ new Map();
+  for (const e of g.edges) {
+    const [p, c] = dir === "dependencies" ? [e.from, e.to] : [e.to, e.from];
+    kids.set(p, [...kids.get(p) ?? [], c]);
+  }
+  for (const l of kids.values()) l.sort(compareTaskIds);
+  const expanded = /* @__PURE__ */ new Set([g.rootId]);
+  const branch = /* @__PURE__ */ new Set([g.rootId]);
+  const roots = [];
+  const stack = [{ id: g.rootId, ids: kids.get(g.rootId) ?? [], pos: 0, into: roots }];
+  while (stack.length) {
+    const f = stack[stack.length - 1];
+    const id = f.ids[f.pos];
+    if (id === void 0) {
+      stack.pop();
+      branch.delete(f.id);
+      continue;
+    }
+    f.pos += 1;
+    const node2 = byId.get(id);
+    if (!node2) continue;
+    if (branch.has(id)) {
+      f.into.push({ node: node2, children: [], repeat: "cycle" });
+      continue;
+    }
+    if (expanded.has(id)) {
+      f.into.push({ node: node2, children: [], repeat: "repeat" });
+      continue;
+    }
+    expanded.add(id);
+    if (node2.state !== "resolved") {
+      f.into.push({ node: node2, children: [], repeat: null });
+      continue;
+    }
+    branch.add(id);
+    const t = { node: node2, children: [], repeat: null };
+    f.into.push(t);
+    stack.push({ id, ids: kids.get(id) ?? [], pos: 0, into: t.children });
+  }
+  return roots;
+}
+function nodeLabel(n) {
+  if (n.state !== "resolved")
+    return `${n.id} - ${n.state === "missing" ? "unknown task ID" : "ambiguous task ID"}`;
+  const state = n.completed ? "completed" : n.status;
+  const suffix = state ? ` [${state}]` : "";
+  const title = n.title?.trim();
+  return title ? `${n.id} - ${title}${suffix}` : `${n.id}${suffix}`;
+}
+function graphSection(g, dir) {
+  const reached = g.nodes.filter((n) => (depthIn(n, dir) ?? 0) > 0);
+  if (!reached.length) return [];
+  const direct2 = reached.filter((n) => depthIn(n, dir) === 1).length;
+  const out = [
+    `${dir === "dependencies" ? "Depends on" : "Dependents"} (${direct2} direct, ${reached.length} total):`
+  ];
+  const stack = [{ kids: dependencyTree(g, dir), pos: 0, prefix: "" }];
+  while (stack.length) {
+    const f = stack[stack.length - 1];
+    const c = f.kids[f.pos];
+    if (!c) {
+      stack.pop();
+      continue;
+    }
+    f.pos += 1;
+    const last = f.pos === f.kids.length;
+    const rep = c.repeat === "cycle" ? " (cycle)" : c.repeat === "repeat" ? " (shown above)" : "";
+    out.push(`${f.prefix}${last ? "\u2514\u2500 " : "\u251C\u2500 "}${nodeLabel(c.node)}${rep}`);
+    if (c.children.length)
+      stack.push({ kids: c.children, pos: 0, prefix: `${f.prefix}${last ? "   " : "\u2502  "}` });
+  }
+  return out;
+}
+function graphLines(g) {
+  const s = [graphSection(g, "dependencies"), graphSection(g, "dependents")].filter(
+    (x) => x.length
+  );
+  return s.flatMap((x, i) => i === 0 ? x : ["", ...x]);
+}
+function subtasksOf(t, rows3) {
+  const me = canonicalId(t.id);
+  return rows3.filter((r) => r.place === "tasks" && r.parentId && canonicalId(r.parentId) === me).map((r) => ({ id: shown(r.id, r.place), title: r.title })).sort((a, b) => compareTaskIds(a.id, b.id));
+}
+function listItem(t, status, statuses) {
+  const resolve = typeof status === "function" ? status : (d) => {
+    const st = status.get(d.toUpperCase());
+    return st === void 0 ? void 0 : { id: d, status: st };
+  };
+  return {
+    id: shown(t.id, t.place),
     title: t.title,
     status: t.status,
-    archived: t.place.startsWith("archive"),
+    archived: ARCHIVE.has(t.place),
     type: t.type ?? null,
     priority: t.priority ?? null,
     project: null,
@@ -41867,7 +42126,7 @@ function listItem(t, status) {
     reporter: t.reporter ?? null,
     labels: t.labels,
     milestone: t.milestone ?? null,
-    parentTaskId: t.parentId ?? null,
+    parentTaskId: t.parentId ? shown(t.parentId, t.place) : null,
     acceptanceCriteriaCompleted: t.ac.filter((c) => c.done).length,
     acceptanceCriteriaCount: t.ac.length,
     references: t.references,
@@ -41876,21 +42135,29 @@ function listItem(t, status) {
     createdAt: t.createdAt,
     updatedAt: t.updatedAt ?? null,
     dueDate: null,
-    isReady: readiness(t, status).isReady,
+    isReady: readiness(t, resolve, statuses).isReady,
     area: t.area,
     aliases: t.aliases,
     version: t.version
   };
 }
-function viewItem(t, status, subtasks) {
+function viewItem(t, v) {
   const checks5 = (cs) => cs.map((c, i) => ({ index: i + 1, text: c.text, checked: c.done }));
+  const g = dependencyGraph(t, v.rows, v.statuses);
+  const index2 = boardIndex(v.rows);
+  const resolve = (d) => {
+    const r = index2.get(canonicalId(d));
+    return r && r !== "ambiguous" ? { id: shown(r.id, r.place), status: r.status } : void 0;
+  };
   return {
-    ...listItem(t, status),
-    description: t.description ?? null,
+    ...listItem(t, resolve, v.statuses),
+    path: v.path ?? null,
+    description: t.description || null,
     dependencies: t.dependencies,
-    readiness: readiness(t, status),
+    dependencyGraph: { root: g.rootId, nodes: g.nodes, edges: g.edges },
+    readiness: readiness(t, resolve, v.statuses),
     documentation: [],
-    subtasks: subtasks.map((x) => ({ id: x.id, title: x.title, status: x.status })),
+    subtasks: subtasksOf(t, v.rows),
     acceptanceCriteria: checks5(t.ac),
     definitionOfDone: checks5(t.dod),
     implementationPlan: t.plan ?? null,
@@ -41898,69 +42165,118 @@ function viewItem(t, status, subtasks) {
     comments: t.comments.map((c, i) => ({
       index: i + 1,
       body: c.body,
-      author: c.author ?? null,
-      createdAt: c.created
+      createdAt: c.created,
+      author: c.author ?? null
     })),
     finalSummary: t.finalSummary ?? null,
     closedAt: t.closedAt ?? null,
     extra: t.extra
   };
 }
-var RULE = "--------------------------------------------------";
+var RULE = "-".repeat(50);
 var when = (iso2) => `${iso2.slice(0, 10)} ${iso2.slice(11, 16)} (UTC)`;
-var cap = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-function viewPlain(t, subtasks) {
-  const out = [`Task ${t.id} - ${t.title}`, "=".repeat(50), "", `Status: ${t.status}`];
-  if (t.priority) out.push(`Priority: ${cap(t.priority)}`);
+var ICONS = {
+  done: "\u2714",
+  "in progress": "\u25D2",
+  blocked: "\u25CF",
+  "to do": "\u25CB",
+  review: "\u25C6",
+  testing: "\u25A3"
+};
+var withIcon = (s) => `${ICONS[s.trim().toLowerCase()] ?? "\u25CB"} ${s}`;
+var PRIORITY = { high: "High", medium: "Medium", low: "Low" };
+var priorityLabel = (p) => {
+  const n = p.trim().toLowerCase();
+  return PRIORITY[n] ?? n.split(" ").map((x) => x ? x[0]?.toUpperCase() + x.slice(1) : "").join(" ");
+};
+var at2 = (a) => a.startsWith("@") ? a : `@${a}`;
+function viewPlain(t, v) {
+  const out = [];
+  if (v.file) out.push(`File: ${v.file}`, "");
+  out.push(`Task ${shown(t.id, t.place)} - ${t.title}`, "=".repeat(50), "");
+  out.push(`Status: ${withIcon(t.status)}${ARCHIVE.has(t.place) ? " (archived)" : ""}`);
+  if (t.priority) out.push(`Priority: ${priorityLabel(t.priority)}`);
   if (t.type) out.push(`Type: ${t.type}`);
   if (t.ordinal !== void 0) out.push(`Ordinal: ${t.ordinal}`);
-  if (t.assignees.length) out.push(`Assignee: ${t.assignees.join(", ")}`);
+  if (t.assignees.length) out.push(`Assignee: ${t.assignees.map(at2).join(", ")}`);
+  if (t.reporter) out.push(`Reporter: ${at2(t.reporter)}`);
   out.push(`Created: ${when(t.createdAt)}`);
   if (t.updatedAt) out.push(`Updated: ${when(t.updatedAt)}`);
   if (t.labels.length) out.push(`Labels: ${t.labels.join(", ")}`);
   if (t.milestone) out.push(`Milestone: ${t.milestone}`);
-  if (t.parentId) out.push(`Parent: ${t.parentId}`);
-  if (t.dependencies.length) out.push(`Dependencies: ${t.dependencies.join(", ")}`);
+  if (t.parentId) {
+    const key = canonicalId(t.parentId);
+    const p = v.rows.find((r) => r.place === "tasks" && canonicalId(r.id) === key);
+    out.push(`Parent: ${shown(t.parentId, t.place)}${p ? ` - ${p.title}` : ""}`);
+  }
+  const subs = subtasksOf(t, v.rows);
+  if (subs.length)
+    out.push(`Subtasks (${subs.length}):`, ...subs.map((x) => `- ${x.id} - ${x.title}`));
+  if (t.references.length) out.push(`References: ${t.references.join(", ")}`);
+  if (!v.exact)
+    out.push(
+      `Area: ${t.area}${t.aliases.length ? ` (also ${t.aliases.join(", ")})` : ""}`,
+      `Version: ${t.version}`
+    );
+  const graph = graphLines(dependencyGraph(t, v.rows, v.statuses));
+  if (graph.length) out.push("", "Dependency Graph:", RULE, ...graph);
+  const checks5 = (cs, none) => cs.length ? cs.map((c, i) => `- [${c.done ? "x" : " "}] #${i + 1} ${c.text}`) : [none];
+  out.push("", "Description:", RULE, t.description?.trim() || "No description provided", "");
+  out.push("Acceptance Criteria:", RULE, ...checks5(t.ac, "No acceptance criteria defined"), "");
   out.push(
-    `Area: ${t.area}${t.aliases.length ? ` (also ${t.aliases.join(", ")})` : ""}`,
-    `Version: ${t.version}`
+    "Definition of Done:",
+    RULE,
+    ...checks5(t.dod, "No Definition of Done items defined"),
+    ""
   );
-  if (subtasks.length)
-    out.push("", "Subtasks:", RULE, ...subtasks.map((x) => `- ${x.id} - ${x.title} [${x.status}]`));
   const block = (head, body) => {
-    if (body) out.push("", `${head}:`, RULE, body);
+    const b = body?.trim();
+    if (b) out.push(`${head}:`, RULE, b, "");
   };
-  const list2 = (cs) => cs.map((c, i) => `- [${c.done ? "x" : " "}] #${i + 1} ${c.text}`).join("\n");
-  block("Description", t.description);
-  block("Acceptance Criteria", list2(t.ac));
-  block("Definition of Done", list2(t.dod));
   block("Implementation Plan", t.plan);
   block("Implementation Notes", t.notes);
-  block(
-    "Comments",
-    t.comments.map((c, i) => `#${i + 1} - ${c.author ? `${c.author}, ` : ""}${when(c.created)}
-${c.body}`).join("\n\n")
-  );
+  const comments2 = t.comments.filter((c) => c.body.trim());
+  if (comments2.length) {
+    out.push("Comments:", RULE);
+    comments2.forEach((c, i) => {
+      out.push(
+        [
+          `#${i + 1}`,
+          ...c.author ? [c.author] : [],
+          ...c.created ? [when(c.created)] : []
+        ].join(" - ")
+      );
+      out.push(c.body.trim(), "");
+    });
+  }
   block("Final Summary", t.finalSummary);
   return `${out.join("\n")}
 `;
 }
 function listPlain(ts, statuses) {
+  if (!ts.length) return "No tasks found.\n";
+  const canon = new Map(statuses.map((s) => [s.toLowerCase(), s]));
   const groups = /* @__PURE__ */ new Map();
-  for (const t of ts) groups.set(t.status, [...groups.get(t.status) ?? [], t]);
-  const order = [...statuses, ...[...groups.keys()].filter((s) => !statuses.includes(s))];
-  const out = [];
+  for (const t of ts) {
+    const s = canon.get(t.status.trim().toLowerCase()) ?? t.status.trim();
+    groups.set(s, [...groups.get(s) ?? [], t]);
+  }
+  const order = [
+    ...statuses.filter((s) => groups.has(s)),
+    ...[...groups.keys()].filter((s) => !statuses.includes(s))
+  ];
+  let out = "";
   for (const s of order) {
-    const g = groups.get(s);
-    if (!g?.length) continue;
-    out.push(`${s}:`);
-    for (const t of g)
-      out.push(
-        `  ${t.priority ? `[${t.priority.toUpperCase()}] ` : ""}${t.type ? `[${t.type}] ` : ""}${t.id} - ${t.title}`
-      );
-    out.push("");
+    out += `${s || "No Status"}:
+`;
+    for (const t of groups.get(s) ?? []) {
+      const ac = t.ac.length ? ` (ac: ${t.ac.filter((c) => c.done).length}/${t.ac.length})` : "";
+      out += `  ${t.priority ? `[${t.priority.toUpperCase()}] ` : ""}${t.type ? `[${t.type}] ` : ""}${shown(t.id, t.place)} - ${t.title}${ac}
+`;
+    }
+    out += "\n";
   }
-  return out.length ? out.join("\n") : "No tasks found.\n";
+  return out;
 }
 
 // src/sidecar.ts
@@ -42076,10 +42392,19 @@ function editFlags(c, create) {
 function registerCommands(program3, ctx) {
   program3.version(ctx.version, "-v, --version");
   async function show(a, t, o, kind) {
-    const status = await a.statusOf(t.dependencies);
-    const subs = await a.list({ parent: t.id, place: ["tasks", "drafts"] });
-    if (o.json) print3({ schemaVersion: 1, kind, task: viewItem(t, status, subs) });
-    else print3(viewPlain(t, subs));
+    const [rows3, files] = await Promise.all([
+      a.dependencyRows(),
+      ctx.mirrorDir ? a.mirrorFiles([t.id]) : Promise.resolve([])
+    ]);
+    const file2 = files[0] && ctx.mirrorDir ? join6(ctx.mirrorDir, files[0].path) : void 0;
+    const v = {
+      rows: rows3,
+      statuses: STATUSES,
+      ...file2 ? { file: file2, path: relative(dirname3(ctx.mirrorDir), file2) } : {},
+      ...ctx.exact ? { exact: true } : {}
+    };
+    if (o.json) print3({ schemaVersion: 1, kind, task: viewItem(t, v) });
+    else print3(viewPlain(t, v));
   }
   const withBoardOrStore = (fn) => ctx.withBoard ? ctx.withBoard(fn) : ctx.withStore((a) => fn(a, null));
   async function after(a, id) {
@@ -42170,10 +42495,14 @@ function registerCommands(program3, ctx) {
       if (!SORT_FIELDS.includes(field)) throw new Error(`cannot sort by ${field}`);
       return { field, dir: dir === "desc" ? "desc" : "asc" };
     });
-    const ts = await a.list(f, sorts);
+    const ts = sorts.length ? await a.list(f, sorts) : backlogOrder(await a.list(f));
     if (o.json) {
       const status = await a.statusOf(ts.flatMap((t) => t.dependencies));
-      print3({ schemaVersion: 1, kind: "task-list", tasks: ts.map((t) => listItem(t, status)) });
+      print3({
+        schemaVersion: 1,
+        kind: "task-list",
+        tasks: ts.map((t) => listItem(t, status, STATUSES))
+      });
     } else print3(listPlain(ts, STATUSES));
   }
   listCmd(task2.command("list").description("list tasks")).action(
@@ -42205,7 +42534,7 @@ function registerCommands(program3, ctx) {
         print3({
           schemaVersion: 1,
           kind: "search",
-          results: hits.map((h) => ({ type: "task", data: listItem(h.task, status) }))
+          results: hits.map((h) => ({ type: "task", data: listItem(h.task, status, STATUSES) }))
         });
       } else print3(searchPlain(hits));
     })
@@ -42535,7 +42864,7 @@ async function open2(migrateNow) {
   }
   const { PGlite: PGlite2 } = await import("@electric-sql/pglite");
   const { drizzle: drizzle3 } = await Promise.resolve().then(() => (init_pglite(), pglite_exports));
-  const pg = new PGlite2(cfg.dir ?? join7(homedir4(), ".aerie"));
+  const pg = new PGlite2(cfg.dir ?? join8(homedir4(), ".aerie"));
   const db = drizzle3(pg);
   await migrateAerie(db);
   return { db, close: () => pg.close() };
@@ -42556,6 +42885,8 @@ registerCommands(program2, {
   by: cfg.by ?? `@${userInfo().username}`,
   // the mirror is the host's (its files and rows are host-only over the wire)
   ...cfg.mirrorDir && !cfg.remoteUrl ? { mirrorDir: cfg.mirrorDir } : {},
+  // set by the `backlog` shim: Backlog.md's text, byte for byte
+  ...process.env.AERIE_BACKLOG_EXACT ? { exact: true } : {},
   version: pkg.version,
   local: !cfg.url && !cfg.remoteUrl,
   async withStore(fn) {