things-api 0.5.0

package/dist/db/fingerprint.js

@@ -0,0 +1,82 @@
+/**
+ * Schema fingerprinting for drift detection.
+ *
+ * The fingerprint is SHA-256 over a canonical JSON structure derived from
+ * PRAGMA table_info for exactly the tables/columns in the dependency
+ * manifest (src/db/schema.ts). Extra columns are recorded (warn-only);
+ * missing tables/columns change the hash (drift → writes blocked).
+ * Enum domains are runtime probes, not part of the hash.
+ */
+import { createHash } from "node:crypto";
+import { DEPENDED_TABLES, q, TABLE_NAMES } from "./schema.js";
+export function observeSchema(db) {
+    const tables = TABLE_NAMES.map((table) => {
+        const rows = db.prepare(`PRAGMA table_info(${q(table)})`).all();
+        const byName = new Map(rows.map((r) => [r.name, r]));
+        const declared = DEPENDED_TABLES[table];
+        const columns = declared.map((name) => {
+            const row = byName.get(name);
+            if (!row)
+                return null;
+            return {
+                name: row.name,
+                declaredType: row.type.toUpperCase(),
+                notnull: row.notnull ? 1 : 0,
+                pk: row.pk,
+            };
+        });
+        const declaredSet = new Set(declared);
+        const extraColumns = rows
+            .map((r) => r.name)
+            .filter((name) => !declaredSet.has(name))
+            .sort();
+        return { table, present: rows.length > 0, columns, extraColumns };
+    });
+    const canonical = tables.map((t) => ({
+        table: t.table,
+        present: t.present,
+        columns: t.columns,
+        // extraColumns intentionally excluded from the hash: additions warn, not block
+    }));
+    const fingerprint = `sha256:${createHash("sha256")
+        .update(JSON.stringify(canonical))
+        .digest("hex")}`;
+    return { databaseVersion: readDatabaseVersion(db), tables, fingerprint };
+}
+/** Meta.databaseVersion is a plist blob/text wrapping an <integer>. */
+export function readDatabaseVersion(db) {
+    try {
+        const row = db.prepare(`SELECT value FROM Meta WHERE key = 'databaseVersion'`).get();
+        if (!row || row.value == null)
+            return null;
+        const text = typeof row.value === "string" ? row.value : new TextDecoder().decode(row.value);
+        const match = /<integer>(\d+)<\/integer>/.exec(text);
+        if (match?.[1])
+            return Number(match[1]);
+        const bare = /^\s*(\d+)\s*$/.exec(text);
+        return bare?.[1] ? Number(bare[1]) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function compareToBaseline(observation, baselines) {
+    const baseline = baselines.find((b) => b.databaseVersion === observation.databaseVersion);
+    if (!baseline)
+        return { kind: "unknown-version", observation };
+    if (baseline.fingerprint === observation.fingerprint)
+        return { kind: "ok", observation };
+    const detail = observation.tables.flatMap((t) => {
+        if (!t.present)
+            return [`table missing: ${t.table}`];
+        const declared = DEPENDED_TABLES[t.table];
+        const lines = [];
+        t.columns.forEach((c, i) => {
+            if (c === null)
+                lines.push(`column missing: ${t.table}.${declared[i] ?? `#${i}`}`);
+        });
+        return lines;
+    });
+    return { kind: "drift", observation, expected: baseline.fingerprint, detail };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/db/fingerprint.js.map

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

package/dist/db/locate.d.ts

@@ -0,0 +1,13 @@
+export interface LocateResult {
+    path: string;
+    source: "option" | "env" | "container";
+    /** Additional candidate paths that also matched (warn when >1). */
+    otherCandidates: string[];
+}
+export declare class ThingsDbNotFoundError extends Error {
+    constructor(searched: string);
+}
+export declare function locateThingsDb(options?: {
+    dbPath?: string;
+    home?: string;
+}): LocateResult;

package/dist/db/locate.js

@@ -0,0 +1,44 @@
+/**
+ * Locate the Things database. Precedence:
+ *   1. explicit dbPath option
+ *   2. THINGS_DB environment variable
+ *   3. glob under the Things group container (most recently modified wins)
+ */
+import { globSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CONTAINER_GLOB = join("Library/Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac", "ThingsData-*/Things Database.thingsdatabase/main.sqlite");
+export class ThingsDbNotFoundError extends Error {
+    constructor(searched) {
+        super(`Things database not found (searched ${searched}). ` +
+            `Is Things installed and has it been launched at least once? ` +
+            `Override with THINGS_DB or openThings({ dbPath }).`);
+        this.name = "ThingsDbNotFoundError";
+    }
+}
+export function locateThingsDb(options) {
+    if (options?.dbPath) {
+        return { path: options.dbPath, source: "option", otherCandidates: [] };
+    }
+    const envPath = process.env["THINGS_DB"];
+    if (envPath) {
+        return { path: envPath, source: "env", otherCandidates: [] };
+    }
+    const home = options?.home ?? homedir();
+    const matches = globSync(CONTAINER_GLOB, { cwd: home }).map((rel) => join(home, rel));
+    if (matches.length === 0) {
+        throw new ThingsDbNotFoundError(join(home, CONTAINER_GLOB));
+    }
+    const byMtime = matches
+        .map((path) => ({ path, mtime: statSync(path).mtimeMs }))
+        .sort((a, b) => b.mtime - a.mtime);
+    const first = byMtime[0];
+    if (!first)
+        throw new ThingsDbNotFoundError(join(home, CONTAINER_GLOB));
+    return {
+        path: first.path,
+        source: "container",
+        otherCandidates: byMtime.slice(1).map((entry) => entry.path),
+    };
+}
+//# sourceMappingURL=locate.js.map

package/dist/db/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/db/locate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,cAAc,GAAG,IAAI,CACzB,gEAAgE,EAChE,yDAAyD,CAC1D,CAAC;AASF,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,QAAgB;QAC1B,KAAK,CACH,uCAAuC,QAAQ,KAAK;YAClD,8DAA8D;YAC9D,oDAAoD,CACvD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,OAA4C;IACzE,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,OAAO,GAAG,OAAO;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACxE,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,WAAW;QACnB,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/db/schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SINGLE SOURCE OF TRUTH for every table and column things-api depends on.
+ *
+ * - Read queries name columns exclusively from this manifest (loud failure
+ *   when a column disappears).
+ * - The schema fingerprint (./fingerprint.ts) hashes exactly this structure
+ *   as observed via PRAGMA table_info.
+ * - docs/atlas/schema-v26.md documents the semantics of every entry.
+ */
+export declare const DEPENDED_TABLES: {
+    readonly TMTask: readonly ["uuid", "type", "status", "stopDate", "trashed", "title", "notes", "creationDate", "userModificationDate", "start", "startDate", "startBucket", "reminderTime", "deadline", "deadlineSuppressionDate", "index", "todayIndex", "todayIndexReferenceDate", "area", "project", "heading", "untrashedLeafActionsCount", "openUntrashedLeafActionsCount", "checklistItemsCount", "openChecklistItemsCount", "rt1_repeatingTemplate", "rt1_recurrenceRule", "rt1_nextInstanceStartDate", "rt1_instanceCreationPaused", "repeater"];
+    readonly TMArea: readonly ["uuid", "title", "visible", "index"];
+    readonly TMTag: readonly ["uuid", "title", "shortcut", "usedDate", "parent", "index"];
+    readonly TMTaskTag: readonly ["tasks", "tags"];
+    readonly TMAreaTag: readonly ["areas", "tags"];
+    readonly TMChecklistItem: readonly ["uuid", "title", "status", "stopDate", "index", "task", "creationDate", "userModificationDate"];
+    readonly TMSettings: readonly ["uuid", "uriSchemeAuthenticationToken", "groupTodayByParent"];
+    readonly Meta: readonly ["key", "value"];
+};
+export type DependedTable = keyof typeof DEPENDED_TABLES;
+export declare const TABLE_NAMES: DependedTable[];
+/**
+ * Enum domains checked as runtime probes (not part of the structural hash;
+ * out-of-domain values raise drift warnings). Verified live 2026-07-02.
+ */
+export declare const ENUM_DOMAINS: {
+    readonly "TMTask.type": readonly [0, 1, 2];
+    readonly "TMTask.status": readonly [0, 2, 3];
+    readonly "TMTask.start": readonly [0, 1, 2];
+    readonly "TMTask.startBucket": readonly [0, 1];
+    readonly "TMTask.trashed": readonly [0, 1];
+    readonly "TMChecklistItem.status": readonly [0, 2, 3];
+};
+/** Quote an identifier for SQL ("index" is a keyword and a real column name). */
+export declare function q(identifier: string): string;
+/** Explicit select list for a depended table (never `SELECT *`). */
+export declare function selectList(table: DependedTable): string;

package/dist/db/schema.js

@@ -0,0 +1,81 @@
+/**
+ * SINGLE SOURCE OF TRUTH for every table and column things-api depends on.
+ *
+ * - Read queries name columns exclusively from this manifest (loud failure
+ *   when a column disappears).
+ * - The schema fingerprint (./fingerprint.ts) hashes exactly this structure
+ *   as observed via PRAGMA table_info.
+ * - docs/atlas/schema-v26.md documents the semantics of every entry.
+ */
+export const DEPENDED_TABLES = {
+    TMTask: [
+        "uuid",
+        "type",
+        "status",
+        "stopDate",
+        "trashed",
+        "title",
+        "notes",
+        "creationDate",
+        "userModificationDate",
+        "start",
+        "startDate",
+        "startBucket",
+        "reminderTime",
+        "deadline",
+        "deadlineSuppressionDate",
+        "index",
+        "todayIndex",
+        "todayIndexReferenceDate",
+        "area",
+        "project",
+        "heading",
+        "untrashedLeafActionsCount",
+        "openUntrashedLeafActionsCount",
+        "checklistItemsCount",
+        "openChecklistItemsCount",
+        "rt1_repeatingTemplate",
+        "rt1_recurrenceRule",
+        "rt1_nextInstanceStartDate",
+        "rt1_instanceCreationPaused",
+        "repeater",
+    ],
+    TMArea: ["uuid", "title", "visible", "index"],
+    TMTag: ["uuid", "title", "shortcut", "usedDate", "parent", "index"],
+    TMTaskTag: ["tasks", "tags"],
+    TMAreaTag: ["areas", "tags"],
+    TMChecklistItem: [
+        "uuid",
+        "title",
+        "status",
+        "stopDate",
+        "index",
+        "task",
+        "creationDate",
+        "userModificationDate",
+    ],
+    TMSettings: ["uuid", "uriSchemeAuthenticationToken", "groupTodayByParent"],
+    Meta: ["key", "value"],
+};
+export const TABLE_NAMES = Object.keys(DEPENDED_TABLES);
+/**
+ * Enum domains checked as runtime probes (not part of the structural hash;
+ * out-of-domain values raise drift warnings). Verified live 2026-07-02.
+ */
+export const ENUM_DOMAINS = {
+    "TMTask.type": [0, 1, 2], // to-do | project | heading
+    "TMTask.status": [0, 2, 3], // open | canceled | completed
+    "TMTask.start": [0, 1, 2], // inbox | active | someday
+    "TMTask.startBucket": [0, 1], // today | evening
+    "TMTask.trashed": [0, 1],
+    "TMChecklistItem.status": [0, 2, 3],
+};
+/** Quote an identifier for SQL ("index" is a keyword and a real column name). */
+export function q(identifier) {
+    return `"${identifier.replaceAll('"', '""')}"`;
+}
+/** Explicit select list for a depended table (never `SELECT *`). */
+export function selectList(table) {
+    return DEPENDED_TABLES[table].map(q).join(", ");
+}
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE;QACN,MAAM;QACN,MAAM;QACN,QAAQ;QACR,UAAU;QACV,SAAS;QACT,OAAO;QACP,OAAO;QACP,cAAc;QACd,sBAAsB;QACtB,OAAO;QACP,WAAW;QACX,aAAa;QACb,cAAc;QACd,UAAU;QACV,yBAAyB;QACzB,OAAO;QACP,YAAY;QACZ,yBAAyB;QACzB,MAAM;QACN,SAAS;QACT,SAAS;QACT,2BAA2B;QAC3B,+BAA+B;QAC/B,qBAAqB;QACrB,yBAAyB;QACzB,uBAAuB;QACvB,oBAAoB;QACpB,2BAA2B;QAC3B,4BAA4B;QAC5B,UAAU;KACX;IACD,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;IAC7C,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;IACnE,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE;QACf,MAAM;QACN,OAAO;QACP,QAAQ;QACR,UAAU;QACV,OAAO;QACP,MAAM;QACN,cAAc;QACd,sBAAsB;KACvB;IACD,UAAU,EAAE,CAAC,MAAM,EAAE,8BAA8B,EAAE,oBAAoB,CAAC;IAC1E,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;CACd,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAoB,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B;IACtD,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,8BAA8B;IAC1D,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,2BAA2B;IACtD,oBAAoB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB;IAChD,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxB,wBAAwB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CAC3B,CAAC;AAEX,iFAAiF;AACjF,MAAM,UAAU,CAAC,CAAC,UAAkB;IAClC,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/diagnose.d.ts

@@ -0,0 +1,67 @@
+import { type AutomationProbeDeps, type AutomationProbeStatus } from "./write/automation-probe.ts";
+import { type EnvironmentChange, type EnvironmentTracker, type EnvironmentTuple } from "./write/environment.ts";
+import { ExitCode, type EnvelopeMeta } from "./contracts.ts";
+export interface DiagnoseReport {
+    db: {
+        path: string;
+        source: "option" | "env" | "container";
+        otherCandidates: string[];
+        databaseVersion: number | null;
+    };
+    fingerprint: {
+        status: "ok" | "drift" | "user-accepted" | "unknown-version";
+        value: string;
+        expected: string | null;
+        detail: string[];
+        extraColumns: Record<string, string[]>;
+    };
+    app: {
+        installed: boolean;
+    };
+    writes: {
+        enabled: boolean;
+        reason: string;
+    };
+    experimental: {
+        /** config allowExperimental (opt-in for private-surface capabilities). */
+        enabled: boolean;
+        /** sdef canary: the private reorder command is still declared. */
+        sdefDeclaresReorder: boolean;
+        reason: string;
+    };
+    environment: {
+        /** The identity tuple macOS consent grants key on (docs/setup.md, hardening). */
+        current: EnvironmentTuple;
+        /** Tuple recorded at the last verified mutation; null before the first one. */
+        lastVerifiedWrite: EnvironmentTuple | null;
+        /** Non-empty = re-consent risk: something changed since the last verified write. */
+        changes: EnvironmentChange[];
+    };
+    automation: {
+        status: AutomationProbeStatus | "not-probed";
+        detail: string;
+    };
+}
+export interface DiagnoseOptions {
+    /**
+     * Actively test Automation consent by querying Things once. Opt-in: on an
+     * unauthorized machine the probe makes macOS show the consent prompt
+     * (useful during onboarding, unwanted headless). Skipped when Things is
+     * not running so a diagnostic never launches the app.
+     */
+    probeAutomation?: boolean;
+    /** Test seams. */
+    probeDeps?: AutomationProbeDeps;
+    environment?: EnvironmentTracker;
+}
+export interface DiagnoseResult {
+    report: DiagnoseReport | null;
+    error: {
+        code: string;
+        message: string;
+        remediation?: string;
+    } | null;
+    exitCode: ExitCode;
+    meta: Pick<EnvelopeMeta, "dbVersion" | "fingerprint">;
+}
+export declare function diagnose(dbPath?: string, options?: DiagnoseOptions): DiagnoseResult;

package/dist/diagnose.js

@@ -0,0 +1,143 @@
+/**
+ * Environment/database/fingerprint health report — the library function
+ * behind `things doctor` and the MCP doctor tool. Read-only: opens the DB,
+ * observes the schema, checks the app bundle and the experimental canary.
+ */
+import { existsSync } from "node:fs";
+import { loadConfig } from "./config.js";
+import { BASELINES } from "./db/baselines/index.js";
+import { openConnection, ThingsDbOpenError } from "./db/connection.js";
+import { compareToBaseline, observeSchema } from "./db/fingerprint.js";
+import { locateThingsDb, ThingsDbNotFoundError } from "./db/locate.js";
+import { probeAutomation, } from "./write/automation-probe.js";
+import { createEnvironmentTracker, diffEnvironment, } from "./write/environment.js";
+import { sdefDeclaresPrivateReorder } from "./write/experimental.js";
+import { ExitCode, PKG_VERSION } from "./contracts.js";
+const THINGS_APP = "/Applications/Things3.app";
+export function diagnose(dbPath, options = {}) {
+    let located;
+    try {
+        located = locateThingsDb(dbPath ? { dbPath } : undefined);
+    }
+    catch (err) {
+        if (err instanceof ThingsDbNotFoundError) {
+            return {
+                report: null,
+                error: {
+                    code: "environment",
+                    message: err.message,
+                    remediation: "Install Things 3 and launch it once, or set THINGS_DB.",
+                },
+                exitCode: ExitCode.Environment,
+                meta: { dbVersion: null, fingerprint: "unknown" },
+            };
+        }
+        throw err;
+    }
+    let conn;
+    try {
+        conn = openConnection(located.path);
+    }
+    catch (err) {
+        if (err instanceof ThingsDbOpenError) {
+            return {
+                report: null,
+                error: {
+                    code: "environment",
+                    message: err.message,
+                    remediation: "Launch Things once so the WAL sidecars exist, then retry.",
+                },
+                exitCode: ExitCode.Environment,
+                meta: { dbVersion: null, fingerprint: "unknown" },
+            };
+        }
+        throw err;
+    }
+    try {
+        const observation = observeSchema(conn.db);
+        const status = compareToBaseline(observation, BASELINES);
+        // The pipeline honors a user-accepted drifted fingerprint (loud escape
+        // hatch, design §6) — doctor must report what will actually happen.
+        const config = loadConfig();
+        const accepted = status.kind === "drift" && config.acceptedFingerprint === observation.fingerprint;
+        const fingerprintStatus = accepted
+            ? "user-accepted"
+            : status.kind === "ok"
+                ? "ok"
+                : status.kind === "drift"
+                    ? "drift"
+                    : "unknown-version";
+        const writesEnabled = status.kind === "ok" || accepted;
+        const sdefCanary = sdefDeclaresPrivateReorder();
+        const tracker = options.environment ?? createEnvironmentTracker(PKG_VERSION);
+        const currentEnv = tracker.capture();
+        const recordedEnv = tracker.load();
+        const extraColumns = {};
+        for (const t of observation.tables) {
+            if (t.extraColumns.length > 0)
+                extraColumns[t.table] = t.extraColumns;
+        }
+        const report = {
+            db: {
+                path: located.path,
+                source: located.source,
+                otherCandidates: located.otherCandidates,
+                databaseVersion: observation.databaseVersion,
+            },
+            fingerprint: {
+                status: fingerprintStatus,
+                value: observation.fingerprint,
+                expected: status.kind === "drift" ? status.expected : null,
+                detail: status.kind === "drift" ? status.detail : [],
+                extraColumns,
+            },
+            app: { installed: existsSync(THINGS_APP) },
+            writes: {
+                enabled: writesEnabled,
+                reason: accepted
+                    ? "DRIFTED fingerprint accepted by user config (accepted-fingerprint) — writes " +
+                        "enabled AT YOUR OWN RISK; every audit record carries fingerprint:user-accepted"
+                    : writesEnabled
+                        ? "schema fingerprint matches shipped baseline"
+                        : status.kind === "drift"
+                            ? "schema fingerprint deviates from baseline — writes disabled until revalidated"
+                            : "unknown databaseVersion — update things-api or revalidate",
+            },
+            experimental: {
+                enabled: config.allowExperimental,
+                sdefDeclaresReorder: sdefCanary,
+                reason: !config.allowExperimental
+                    ? "off — native reorder disabled (`things config set allow-experimental true` to opt in)"
+                    : sdefCanary
+                        ? "on — private reorder command still declared in the app sdef"
+                        : "on BUT the app sdef no longer declares the private reorder command (removed by " +
+                            "an update?) — native reorder is blocked by the canary",
+            },
+            environment: {
+                current: currentEnv,
+                lastVerifiedWrite: recordedEnv,
+                changes: diffEnvironment(recordedEnv, currentEnv),
+            },
+            automation: options.probeAutomation === true
+                ? probeAutomation(options.probeDeps)
+                : {
+                    status: "not-probed",
+                    detail: "opt-in: pass --probe-automation to actively test Automation consent (may " +
+                        "show a one-time macOS prompt; skipped when Things is not running)",
+                },
+        };
+        return {
+            report,
+            error: null,
+            exitCode: writesEnabled ? ExitCode.Ok : ExitCode.DriftBlocked,
+            meta: {
+                dbVersion: observation.databaseVersion,
+                fingerprint: fingerprintStatus === "unknown-version" ? "unknown" : fingerprintStatus,
+            },
+        };
+    }
+    finally {
+        conn.close();
+    }
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/diagnose.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * things-api — typed library for programmatic interaction with Things 3.
+ *
+ * Reads via direct SQLite; writes via the verified mutation pipeline over
+ * official app surfaces (URL scheme + AppleScript, both lab-validated).
+ * See docs/design/architecture.md.
+ */
+export { openThings } from "./client.ts";
+export type { OpenOptions, ThingsClient } from "./client.ts";
+export { diagnose } from "./diagnose.ts";
+export type { DiagnoseOptions, DiagnoseReport, DiagnoseResult } from "./diagnose.ts";
+export { probeAutomation } from "./write/automation-probe.ts";
+export type { AutomationProbeDeps, AutomationProbeResult, AutomationProbeStatus, } from "./write/automation-probe.ts";
+export { createEnvironmentTracker, describeEnvironmentChanges, diffEnvironment, } from "./write/environment.ts";
+export type { EnvironmentChange, EnvironmentTracker, EnvironmentTuple, } from "./write/environment.ts";
+export type { FailureHint, LikelyCause } from "./write/failure-hints.ts";
+export { capabilitiesTable } from "./write/capabilities.ts";
+export type { CapabilityEntry } from "./write/capabilities.ts";
+export { saveConfigKey } from "./config.ts";
+export { createThingsMcpServer } from "./mcp/server.ts";
+export type { McpServerOptions } from "./mcp/server.ts";
+export type { UndoItemResult, UndoOptions, UndoPlan, UndoStep } from "./write/undo.ts";
+export type { BatchItemResult, BatchOp, BatchOptions } from "./write/batch.ts";
+export type { ReorderResult } from "./write/reorder.ts";
+export type { SearchOptions, SomedayFilter, UpcomingFilter, ViewFilter, ChangedItem, } from "./read/views.ts";
+export type { Acknowledgements, AreaAddParams, ContainerRef, OperationKind, OperationParamsMap, ProjectAddParams, ProjectCompleteParams, ProjectMoveParams, ProjectUpdateParams, ReorderParams, ReorderScope, ReorderStrategy, TagAddParams, TagUpdateParams, AreaUpdateParams, TodoAddParams, TodoMoveParams, TodoUpdateParams, WhenValue, } from "./write/operations.ts";
+export { OPERATION_KINDS } from "./write/operations.ts";
+export type { MutationPlan, MutationResult, WriteOptions } from "./write/pipeline.ts";
+export type { HazardId } from "./write/guards.ts";
+export { HAZARD_IDS } from "./write/guards.ts";
+export type { CompiledInvocation, VectorId, VectorMatrix, VectorSupport, WriteVector, } from "./write/vectors/types.ts";
+export { APPLESCRIPT_MATRIX } from "./write/vectors/applescript.ts";
+export { URL_SCHEME_MATRIX } from "./write/vectors/url-scheme.ts";
+export type { DeltaSpec, FieldAssertion } from "./write/verify/delta.ts";
+export type { AuditRecord } from "./audit/schema.ts";
+export type { DisruptionTier, Profile, ThingsApiConfig } from "./config.ts";
+export type { AnyTask, Area, ChecklistItem, Heading, IsoDateGroup, Project, Ref, RepeatingInfo, StartState, Tag, TaskStatus, TaskType, Todo, TodaySection, } from "./model/entities.ts";
+export type { IsoDate } from "./model/dates.ts";
+export type { ListItem, SidebarSection, TodayView } from "./read/views.ts";
+export type { ProjectView } from "./read/project-view.ts";
+export { ProjectNotFoundError } from "./read/project-view.ts";
+export { ThingsDbNotFoundError } from "./db/locate.ts";
+export { ThingsDbOpenError } from "./db/connection.ts";
+export type { Baseline, FingerprintStatus, SchemaObservation } from "./db/fingerprint.ts";
+export { API_VERSION, ExitCode, PKG_VERSION } from "./contracts.ts";
+export type { Envelope, EnvelopeMeta, ErrorEnvelope, OkEnvelope } from "./contracts.ts";

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * things-api — typed library for programmatic interaction with Things 3.
+ *
+ * Reads via direct SQLite; writes via the verified mutation pipeline over
+ * official app surfaces (URL scheme + AppleScript, both lab-validated).
+ * See docs/design/architecture.md.
+ */
+export { openThings } from "./client.js";
+export { diagnose } from "./diagnose.js";
+export { probeAutomation } from "./write/automation-probe.js";
+export { createEnvironmentTracker, describeEnvironmentChanges, diffEnvironment, } from "./write/environment.js";
+export { capabilitiesTable } from "./write/capabilities.js";
+export { saveConfigKey } from "./config.js";
+export { createThingsMcpServer } from "./mcp/server.js";
+export { OPERATION_KINDS } from "./write/operations.js";
+export { HAZARD_IDS } from "./write/guards.js";
+export { APPLESCRIPT_MATRIX } from "./write/vectors/applescript.js";
+export { URL_SCHEME_MATRIX } from "./write/vectors/url-scheme.js";
+export { ProjectNotFoundError } from "./read/project-view.js";
+export { ThingsDbNotFoundError } from "./db/locate.js";
+export { ThingsDbOpenError } from "./db/connection.js";
+export { API_VERSION, ExitCode, PKG_VERSION } from "./contracts.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAM9D,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkCxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAwBlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type OpenOptions } from "../client.ts";
+export interface McpServerOptions {
+    dbPath?: string;
+    /** Test seam: forwarded to openThings (fake vectors, pinned clock, env). */
+    openOptions?: OpenOptions;
+}
+export declare function createThingsMcpServer(options?: McpServerOptions): McpServer;