things-api 0.18.0 → 0.19.1

package/dist/write/vectors/ui-chord.js

@@ -0,0 +1,428 @@
+/**
+ * Within-project HEADING ORDER on the arrow-chord vector (CHORDMH1, built on
+ * the HEADORD1 law — docs/lab/headord1-heading-order.md, docs/lab/chordmh1-move-heading-build.md).
+ *
+ * THE LAW THIS RIDES (measured, Things 3.23 / golden-v4, HEADORD1 cells 1e /
+ * 1g1–1g4 / 1h / 1i3):
+ *
+ *   With a heading row selected in its project view, ⌘↑ / ⌘↓ move that heading
+ *   one slot up / down and ⌘⌥↑ / ⌘⌥↓ move it to the top / bottom of the
+ *   project's heading list. The move rewrites the MOVED heading's `index` and
+ *   nothing else: no sibling heading, loose to-do or child row is renumbered,
+ *   and the heading's children follow through their intact heading FK. A chord
+ *   with nowhere to go is DECLINED — zero delta, one macOS alert beep. The
+ *   chords carry no menu item and no AX action; they are bare keybindings.
+ *
+ * WHY THIS FILE IS A CLOSED LOOP AND NOT A KEYSTROKE MACRO. Two facts force it.
+ * A bare keybinding on an undocumented private surface has no contract at all
+ * (harness.md §AX-drive scrutiny), so nothing may be assumed to have happened
+ * because a chord was posted — the DATABASE is the only oracle. And a chord the
+ * app declines costs the user an audible error tone, so the move count must be
+ * COMPUTED from the pre-state rather than discovered by firing until nothing
+ * changes (HEADORD1 cell 1h5: six wasted chords, six beeps, all writes green).
+ *
+ * So each step is: read the order from the database → compute the ONE chord that
+ * advances it → post exactly that chord → read the order back and prove the
+ * intended heading moved exactly one slot (or reached the endpoint) with every
+ * other row's `index` byte-identical and every child still behind its heading FK.
+ * A step that produces NO delta stops the drive and names the boundary; it is
+ * never re-fired blind. A step that produces the WRONG delta stops the drive and
+ * reports what actually moved. Both are the over-caution direction the doctrine
+ * requires: a refused drive is a bug report, a mis-landed write is corruption.
+ */
+import { createHash } from "node:crypto";
+/**
+ * The client-side default: heading order + child containment, from the open DB.
+ *
+ * The heading read is filtered to `status = 0` so it returns the RENDERED order
+ * (CHORD2 cell 7a′). The child digest is deliberately NOT filtered — it covers
+ * every non-trashed child of every heading of the project, archived headings
+ * included, because no heading chord may disturb any of them.
+ */
+export function createHeadingOrderReader(db) {
+    return (projectUuid) => {
+        const headings = db
+            .prepare(`SELECT uuid, "index" AS idx FROM TMTask
+          WHERE type = 2 AND trashed = 0 AND status = 0 AND project = ? ORDER BY "index", uuid`)
+            .all(projectUuid);
+        const children = db
+            .prepare(`SELECT c.uuid AS uuid, c.heading AS h, c."index" AS idx FROM TMTask c
+          JOIN TMTask hh ON c.heading = hh.uuid
+          WHERE hh.project = ? AND hh.type = 2 AND c.trashed = 0
+          ORDER BY c.uuid`)
+            .all(projectUuid);
+        const hash = createHash("sha256");
+        for (const row of children)
+            hash.update(`${row.uuid}:${row.h}:${row.idx}\n`);
+        return {
+            headings: headings.map((h) => ({ uuid: h.uuid, index: h.idx })),
+            childDigest: hash.digest("hex"),
+            childCount: children.length,
+        };
+    };
+}
+const CHORDS = {
+    "up-one": { code: 126, flags: 0x100000, glyph: "⌘↑" },
+    "down-one": { code: 125, flags: 0x100000, glyph: "⌘↓" },
+    "to-top": { code: 126, flags: 0x180000, glyph: "⌘⌥↑" },
+    "to-bottom": { code: 125, flags: 0x180000, glyph: "⌘⌥↓" },
+};
+export function chordGlyph(id) {
+    return CHORDS[id].glyph;
+}
+/**
+ * Post ONE modifier-bearing key event pair straight at the Things process
+ * (`CGEventPostToPid`), through the same JXA ObjC bridge every other synthetic
+ * input in this codebase rides.
+ *
+ * Why not System Events. The shipped `key` primitive emits `key code N` with no
+ * modifier support at all, and the System-Events spelling that DOES carry
+ * modifiers only lands while Things is FRONTMOST (HEADORD1 cell 1h2b: with
+ * Finder frontmost it produced no delta). `CGEventPostToPid` addresses the
+ * process rather than the focused surface, so the whole gesture — reveal,
+ * select, chord — runs with Things in the background and the user's focus
+ * untouched. Measured on Things 3.23 / golden-v4 (HEADORD1 1h2a; re-measured end
+ * to end, with Things never activated at all, by CHORDMH1's delivery gate).
+ *
+ * Note this is the KEYBOARD tap only. NATIVE1-e measured `CGEventPostToPid` as
+ * inert for Things' MOUSE hit-testing, which is why click synthesis still uses
+ * the HID tap and stays foreground-bound; keyboard events to the pid are a
+ * different path and do land.
+ */
+export function jxaChordScript(id) {
+    const { code, flags } = CHORDS[id];
+    return `ObjC.import('AppKit'); ObjC.import('ApplicationServices'); ObjC.import('CoreGraphics');
+function pidOf(n){ return Application('System Events').processes.byName(n).unixId() }
+function sleepMs(ms){ $.NSThread.sleepForTimeInterval(ms/1000) }
+function run(){
+  var pid = pidOf('Things3');
+  if (!pid) return 'NOPID';
+  var d = $.CGEventCreateKeyboardEvent($(), ${code}, true);
+  var u = $.CGEventCreateKeyboardEvent($(), ${code}, false);
+  $.CGEventSetFlags(d, ${flags}); $.CGEventSetFlags(u, ${flags});
+  $.CGEventPostToPid(pid, d); sleepMs(70);
+  $.CGEventPostToPid(pid, u); sleepMs(70);
+  return 'POSTED';
+}`;
+}
+export function chordCommand(id) {
+    return {
+        primitive: "chord-post",
+        label: `post ${CHORDS[id].glyph} to the Things process`,
+        lang: "javascript",
+        script: jxaChordScript(id),
+        meta: { chord: id, code: CHORDS[id].code, flags: CHORDS[id].flags },
+    };
+}
+/** Select the Nth heading row of the revealed project view (the shipped primitive). */
+export function chordSelectCommand(tablePath, ordinal, script) {
+    return {
+        primitive: "select-heading-row",
+        label: `select the heading row at position ${ordinal + 1}`,
+        script,
+        meta: { ordinal },
+    };
+}
+// -------------------------------------------------------------- the ladder
+/**
+ * Absolute backstop on posted chords. The placement walk below is O(n²) hops in
+ * the worst case (every heading reversed), and the per-step progress guard
+ * already stops a drive that is not converging — this only bounds a pathological
+ * request. 200 chords at ~100ms is well inside the drive budget.
+ */
+const MAX_CHORDS_CEILING = 200;
+/** DB assert poll after a chord: attempts × delay (Things writes `index` on the move). */
+const ASSERT_ATTEMPTS = 12;
+const ASSERT_DELAY_MS = 250;
+const STEP_TIMEOUT_MS = 30_000;
+async function runCmd(ctx, cmd) {
+    return ctx.run(cmd, STEP_TIMEOUT_MS);
+}
+function orderOf(state) {
+    return state.headings.map((h) => h.uuid);
+}
+function positionOf(state, uuid) {
+    return state.headings.findIndex((h) => h.uuid === uuid);
+}
+function indexOf(state, uuid) {
+    return state.headings.find((h) => h.uuid === uuid)?.index ?? null;
+}
+function sameOrder(a, b) {
+    return a.length === b.length && a.every((u, i) => u === b[i]);
+}
+/**
+ * The SINGLE-ROW-WRITE law, asserted per chord (RRF1's untouched-siblings law in
+ * the shape the app actually implements it). Returns a complaint, or null.
+ *
+ * HEADORD1 recorded the law as "the moved heading's `index` is rewritten and no
+ * sibling is renumbered", measured on a ⌘↑. CHORDMH1's certification found that
+ * is half of it: which of the two swapped rows gets the new number depends on
+ * the direction. Moving a heading UP rewrites the MOVER (it takes a value
+ * between its new neighbours: `C 0 → -343`, between `A -532` and `B -246`);
+ * moving one DOWN rewrites the SIBLING it passes (that sibling takes a value
+ * below the mover: `B -201 → -1152`, below `A -543`, which itself did not move).
+ * The ⌘⌥ endpoint chords rewrite the mover. In every measured case exactly ONE
+ * row is renumbered — the app picks whichever single write is cheapest — and it
+ * is always one of the rows the gesture actually passed over.
+ *
+ * So the assertion is: the order must be EXACTLY the order the chord was
+ * supposed to produce, exactly ONE heading's `index` may differ, and that
+ * heading must lie inside the span the move crossed. Anything else — two rows
+ * renumbered, a row outside the span renumbered, an unexpected order — is the
+ * signature of a chord that landed on a row the plan did not address, which is
+ * the one failure a positional heading selection cannot rule out by readback (a
+ * heading exposes no title to the Accessibility tree, so the readback proves
+ * only that A heading is selected, never WHICH — HEADCERT1).
+ */
+function singleRowWriteViolation(before, after, moved, landsAt) {
+    const beforeOrder = orderOf(before);
+    const from = beforeOrder.indexOf(moved);
+    const expected = beforeOrder.filter((u) => u !== moved);
+    expected.splice(landsAt, 0, moved);
+    const observed = orderOf(after);
+    if (!sameOrder(observed, expected)) {
+        return `the heading order after the chord is not the order the step aimed for (${observed.join(" < ")})`;
+    }
+    const lo = Math.min(from, landsAt);
+    const hi = Math.max(from, landsAt);
+    const spanned = new Set(beforeOrder.slice(lo, hi + 1));
+    const rewritten = [];
+    for (const row of before.headings) {
+        const now = after.headings.find((h) => h.uuid === row.uuid);
+        if (now === undefined)
+            return `heading ${row.uuid} disappeared from the project`;
+        if (now.index !== row.index)
+            rewritten.push(row.uuid);
+    }
+    const outside = rewritten.filter((u) => !spanned.has(u));
+    if (outside.length > 0) {
+        return `it also renumbered heading ${outside[0]}, which the move never passed over`;
+    }
+    if (rewritten.length > 1) {
+        return `it renumbered ${rewritten.length} headings at once (${rewritten.join(", ")}) — a chord rewrites exactly one row`;
+    }
+    return null;
+}
+/** Poll the database until `check` passes, or the attempts run out. */
+async function pollState(ctx, check) {
+    for (let i = 0; i < ASSERT_ATTEMPTS; i++) {
+        const state = ctx.state();
+        if (check(state))
+            return state;
+        // polling the same database condition is inherently sequential
+        await ctx.sleep(ASSERT_DELAY_MS);
+    }
+    return null;
+}
+/**
+ * The next chord that advances `order` towards `target`, or null when they
+ * already agree. `movees` is the only set of rows a chord may ever move.
+ *
+ * THE SCHEDULE, and why it is this one. The obvious walk — "put target[i] into
+ * slot i, left to right" — is WRONG here, because target[i] is very often a row
+ * the caller never named: asking to move heading A down one slot produces a
+ * target whose first element is the BYSTANDER B. Moving B is not an option (it
+ * would break the untouched-siblings law the whole vector rests on), and the
+ * equally obvious repair — "push whichever movee sits at slot i down" — thrashes
+ * forever when two movees sit side by side, each pushing the other back.
+ *
+ * So the rule fixes the first mismatched slot `i` from the row's own side:
+ *
+ *  - target[i] IS a movee → it is necessarily BELOW slot i (everything above
+ *    already matches), so step it UP; from slot 0 the one-dispatch ⌘⌥↑ takes it
+ *    there directly.
+ *  - target[i] is a bystander `R` → every row between slot i and R's current
+ *    position is provably a movee (the non-movees keep their relative order, so
+ *    R is the first non-movee at or below i), and pushing the ONE movee directly
+ *    above R down past it moves R up by exactly one slot.
+ *
+ * Both branches strictly reduce a distance that cannot go below zero, so the
+ * schedule terminates, and every chord it emits moves a named heading by one
+ * slot. Two endpoint shortcuts run first, because they are the common single
+ * heading requests and each costs one dispatch instead of a walk: a movee whose
+ * target is the very top or the very bottom is sent there with ⌘⌥↑ / ⌘⌥↓.
+ */
+export function planChordStep(order, target, movees) {
+    const last = target.length - 1;
+    // Endpoint shortcuts, taken before the walk.
+    const top = target[0];
+    if (top !== undefined && movees.has(top) && order[0] !== top) {
+        return { uuid: top, chord: "to-top", landsAt: 0 };
+    }
+    const bottom = target[last];
+    if (bottom !== undefined && movees.has(bottom) && order[last] !== bottom) {
+        return { uuid: bottom, chord: "to-bottom", landsAt: last };
+    }
+    for (let i = 0; i <= last; i++) {
+        const want = target[i];
+        if (order[i] === want)
+            continue;
+        const at = order.indexOf(want);
+        if (at < 0)
+            return { error: `heading ${want} is no longer in the project` };
+        if (movees.has(want)) {
+            // Below slot i by construction — step it up one.
+            return { uuid: want, chord: "up-one", landsAt: at - 1 };
+        }
+        // A bystander has to rise: push the movee immediately above it down past it.
+        const pusher = order[at - 1];
+        if (pusher === undefined || !movees.has(pusher)) {
+            return {
+                error: `reaching the requested order would mean moving heading ${pusher ?? want}, which was ` +
+                    "not one of the headings named in the move",
+            };
+        }
+        return { uuid: pusher, chord: "down-one", landsAt: at };
+    }
+    return null;
+}
+/**
+ * Drive a project's headings into `spec.targetOrder`, one verified chord at a
+ * time (see {@link planChordStep} for the schedule). Nothing here trusts the
+ * plan it made a moment ago: every step is re-derived from a fresh database
+ * read, and the step is only counted once the database says it landed where it
+ * was aimed with nothing else touched.
+ */
+export async function driveHeadingChordReorder(spec, run, reader, selectScript, sleep = (ms) => new Promise((r) => setTimeout(r, ms))) {
+    if (reader === undefined) {
+        return {
+            ok: false,
+            chords: 0,
+            detail: "the heading-order driver has no database seam on this surface — this operation can " +
+                "only run through the full client",
+        };
+    }
+    const ctx = {
+        run,
+        state: () => reader(spec.projectUuid),
+        sleep,
+        selectScript,
+    };
+    const pre = ctx.state();
+    const target = spec.targetOrder;
+    // The order was computed from a read taken before the GUI was touched; if the
+    // project's heading SET has changed since (another client, or the app), the
+    // whole plan — including every positional row address in it — is stale. Refuse.
+    const preOrder = orderOf(pre);
+    if (preOrder.length !== target.length ||
+        !preOrder.every((u) => target.includes(u)) ||
+        !target.every((u) => preOrder.includes(u))) {
+        return {
+            ok: false,
+            chords: 0,
+            detail: `the project's headings changed between planning and driving (planned for ` +
+                `${target.length}, found ${preOrder.length}) — nothing was moved; re-read the project ` +
+                "and reissue the move",
+        };
+    }
+    if (sameOrder(preOrder, target)) {
+        return { ok: true, chords: 0, detail: "already in the requested order — no chord was sent" };
+    }
+    const moveeSet = new Set(spec.movees);
+    const cap = Math.min(MAX_CHORDS_CEILING, target.length * target.length + target.length);
+    let chords = 0;
+    /** Which heading the last select landed on — the selection FOLLOWS the row it moves. */
+    let selected = null;
+    for (;;) {
+        const before = ctx.state();
+        const plan = planChordStep(orderOf(before), target, moveeSet);
+        if (plan === null)
+            break;
+        if ("error" in plan) {
+            return {
+                ok: false,
+                chords,
+                detail: `${plan.error} — refusing to reorder a bystander`,
+            };
+        }
+        if (chords >= cap) {
+            return {
+                ok: false,
+                chords,
+                detail: `the move exceeded its chord budget (${cap}) without reaching the requested order`,
+            };
+        }
+        const want = plan.uuid;
+        const cur = positionOf(before, want);
+        // (1) Selection. The row a chord moves stays selected as it moves (HEADORD1
+        //     cell 1h5 fired ten chords on one selection), so a run of hops on the
+        //     same heading costs ONE positional walk — which is where essentially
+        //     all the wall time goes (~0.25s per row the walk probes).
+        if (selected !== want) {
+            const sel = await runCmd(ctx, chordSelectCommand(spec.tablePath, cur, ctx.selectScript(cur)));
+            if (!sel.ok || sel.stdout.trim() !== "OK") {
+                return {
+                    ok: false,
+                    chords,
+                    detail: `the project view exposed no selectable heading row at position ${cur + 1} ` +
+                        `(${sel.ok ? sel.stdout.trim() || "no match" : sel.stderr.trim() || "the selection step failed"})` +
+                        (chords > 0 ? ` — ${chords} chord(s) had already landed` : " — nothing was moved"),
+                };
+            }
+            selected = want;
+        }
+        // (2) Exactly one chord, chosen from the database, never fired blind.
+        const post = await runCmd(ctx, chordCommand(plan.chord));
+        chords += 1;
+        if (!post.ok) {
+            return {
+                ok: false,
+                chords,
+                detail: `posting ${chordGlyph(plan.chord)} to Things failed (${post.stderr.trim() || "no detail"})`,
+            };
+        }
+        // (3) The database is the oracle. STRICT progress: the heading must be at
+        //     the slot the chord was supposed to put it in.
+        const after = await pollState(ctx, (s) => positionOf(s, want) === plan.landsAt);
+        if (after === null) {
+            const now = ctx.state();
+            const stalled = indexOf(now, want) === indexOf(before, want);
+            return {
+                ok: false,
+                chords,
+                detail: stalled
+                    ? `${chordGlyph(plan.chord)} did not move the heading — it is at position ` +
+                        `${positionOf(now, want) + 1} of ${now.headings.length} and the app declined the ` +
+                        "chord (a heading at the top declines ⌘↑ and one at the bottom declines ⌘↓), or the " +
+                        "row selection was lost. The drive stopped rather than re-sending it" +
+                        (chords > 1 ? `; ${chords - 1} earlier chord(s) did land` : "")
+                    : `${chordGlyph(plan.chord)} moved the heading to position ` +
+                        `${positionOf(now, want) + 1}, not the expected ${plan.landsAt + 1} — the drive ` +
+                        "stopped rather than continue from a position it cannot vouch for",
+            };
+        }
+        // (4) The single-row-write law and the children law, per chord.
+        const violation = singleRowWriteViolation(before, after, want, plan.landsAt);
+        if (violation !== null) {
+            return {
+                ok: false,
+                chords,
+                detail: `${chordGlyph(plan.chord)} did not behave as a single-row move — ${violation}. The row ` +
+                    "that was selected may not be the row the plan addressed; the drive stopped",
+            };
+        }
+        if (after.childDigest !== before.childDigest) {
+            return {
+                ok: false,
+                chords,
+                detail: `${chordGlyph(plan.chord)} changed a to-do's heading or position (${before.childCount} ` +
+                    `child row(s) before, ${after.childCount} after) — a heading move must leave every ` +
+                    "child untouched behind its heading link. The drive stopped",
+            };
+        }
+    }
+    const finalOrder = orderOf(ctx.state());
+    if (!sameOrder(finalOrder, target)) {
+        return {
+            ok: false,
+            chords,
+            detail: `the drive ended in an order that is not the requested one (after ${chords} chord(s))`,
+        };
+    }
+    return {
+        ok: true,
+        chords,
+        detail: `${chords} chord(s) posted`,
+    };
+}
+//# sourceMappingURL=ui-chord.js.map

package/dist/write/vectors/ui-chord.js.map

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

package/dist/write/vectors/ui-drag.d.ts

@@ -1,4 +1,5 @@
 import type { DatabaseSync } from "node:sqlite";
+import { type HeadingOrderReader } from "./ui-chord.ts";
 import type { UiRunner } from "./ui.ts";
 export type SidebarPlacement = {
     kind: "before";
@@ -30,13 +31,16 @@ export interface AreaSidebarState {
     assignmentsDigest: string;
 }
 /**
- * Auxiliary seams the ui vector needs beyond osascript dispatch. The sidebar
- * drag driver asserts the database between hops; the client wires `areaState`
- * to the open connection. Absent (e.g. the capabilities surface, which never
- * executes), a drag op refuses cleanly.
+ * Auxiliary seams the ui vector needs beyond osascript dispatch. Both ordering
+ * drivers assert the database between gestures — the sidebar drag driver
+ * through `areaState`, the heading-chord driver through `headingOrder` — and
+ * the client wires each to the open connection. Absent (e.g. the capabilities
+ * surface, which never executes), those ops refuse cleanly.
  */
 export interface UiDriveAux {
     areaState?: () => AreaSidebarState;
+    /** Heading order + child containment for one project (the chord driver's oracle). */
+    headingOrder?: HeadingOrderReader;
 }
 /** The client-side default aux: reads area order + assignments from the DB. */
 export declare function createUiDriveAux(db: DatabaseSync): UiDriveAux;

package/dist/write/vectors/ui-drag.js

@@ -55,9 +55,11 @@
  *    RELATIVE positions, never index values.
  */
 import { createHash } from "node:crypto";
+import { createHeadingOrderReader } from "./ui-chord.js";
 /** The client-side default aux: reads area order + assignments from the DB. */
 export function createUiDriveAux(db) {
     return {
+        headingOrder: createHeadingOrderReader(db),
         areaState() {
             const areas = db
                 .prepare(`SELECT uuid, title, "index" AS idx FROM TMArea ORDER BY "index", uuid`)