@mattheworiordan/remi 0.1.0

package/dist/core/sqlite.js

@@ -0,0 +1,175 @@
+/**
+ * SQLite access for Apple Reminders database.
+ *
+ * Uses better-sqlite3 for proper transactions and prepared statements.
+ * This is a key improvement over the predecessor which shelled out to /usr/bin/sqlite3
+ * for each statement, making the 3-step membership write non-atomic.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import Database from "better-sqlite3";
+import { ErrorCode, RemiCommandError } from "./errors.js";
+const STORES_DIR = join(homedir(), "Library/Group Containers/group.com.apple.reminders/Container_v1/Stores");
+let cachedDbPath = null;
+let cachedDb = null;
+/**
+ * Find the active Apple Reminders SQLite database.
+ * Scans all .sqlite files and returns the one with actual reminder data.
+ */
+export function findRemindersDbPath() {
+    if (cachedDbPath)
+        return cachedDbPath;
+    if (!existsSync(STORES_DIR)) {
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, `Reminders data directory not found at ${STORES_DIR}`, "Is Apple Reminders set up on this Mac?");
+    }
+    let dirContents;
+    try {
+        dirContents = readdirSync(STORES_DIR);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("EPERM") || msg.includes("operation not permitted")) {
+            throw new RemiCommandError(ErrorCode.PERMISSION_DENIED, "Cannot access Reminders database — permission denied", "Section features require filesystem access. Grant Full Disk Access to your terminal app in System Settings > Privacy & Security > Full Disk Access. Basic reminder operations (without sections) work with just Reminders access.");
+        }
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, `Cannot read Reminders data directory: ${msg}`);
+    }
+    const sqliteFiles = dirContents.filter((f) => f.endsWith(".sqlite") && !f.includes("-wal") && !f.includes("-shm"));
+    for (const file of sqliteFiles) {
+        const dbPath = join(STORES_DIR, file);
+        try {
+            const db = new Database(dbPath, { readonly: true });
+            const row = db.prepare("SELECT COUNT(*) as cnt FROM ZREMCDREMINDER").get();
+            db.close();
+            if (row.cnt > 0) {
+                cachedDbPath = dbPath;
+                return dbPath;
+            }
+        }
+        catch {
+            // Skip files that don't have the expected schema
+        }
+    }
+    throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, `No active Reminders database found in ${STORES_DIR}`, `Checked ${sqliteFiles.length} files. Ensure you have reminders in Apple Reminders.`);
+}
+/**
+ * Get a database connection. Caches the connection for reuse.
+ * Uses WAL mode and busy_timeout for safe concurrent access with remindd.
+ */
+export function getDb() {
+    if (cachedDb)
+        return cachedDb;
+    const dbPath = findRemindersDbPath();
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("busy_timeout = 5000");
+    cachedDb = db;
+    return db;
+}
+/**
+ * Close the cached database connection.
+ */
+export function closeDb() {
+    if (cachedDb) {
+        cachedDb.close();
+        cachedDb = null;
+    }
+}
+/**
+ * Find a list's Z_PK by name.
+ */
+export function findListPk(listName) {
+    const db = getDb();
+    const row = db
+        .prepare("SELECT Z_PK FROM ZREMCDBASELIST WHERE ZNAME = ? AND ZMARKEDFORDELETION = 0")
+        .get(listName);
+    if (!row) {
+        throw new RemiCommandError(ErrorCode.LIST_NOT_FOUND, `List "${listName}" not found in database`);
+    }
+    return row.Z_PK;
+}
+/**
+ * Find a reminder's identifier (hex UUID) by title and list name.
+ */
+export function findReminderIdentifier(title, listName) {
+    const db = getDb();
+    const row = db
+        .prepare(`SELECT r.Z_PK, hex(r.ZIDENTIFIER) as identifier
+       FROM ZREMCDREMINDER r
+       JOIN ZREMCDBASELIST l ON r.ZLIST = l.Z_PK
+       WHERE r.ZTITLE = ? AND l.ZNAME = ? AND r.ZCOMPLETED = 0 AND r.ZMARKEDFORDELETION = 0
+       ORDER BY r.ZCREATIONDATE DESC LIMIT 1`)
+        .get(title, listName);
+    if (!row) {
+        throw new RemiCommandError(ErrorCode.REMINDER_NOT_FOUND, `Reminder "${title}" not found in "${listName}"`);
+    }
+    return { pk: row.Z_PK, identifier: row.identifier };
+}
+/**
+ * Find a section's identifier (hex UUID) by name and list.
+ */
+export function findSectionIdentifier(sectionName, listName) {
+    const db = getDb();
+    const row = db
+        .prepare(`SELECT s.Z_PK, hex(s.ZIDENTIFIER) as identifier
+       FROM ZREMCDBASESECTION s
+       JOIN ZREMCDBASELIST l ON s.ZLIST = l.Z_PK
+       WHERE s.ZDISPLAYNAME = ? AND l.ZNAME = ? AND s.ZMARKEDFORDELETION = 0`)
+        .get(sectionName, listName);
+    if (!row) {
+        throw new RemiCommandError(ErrorCode.SECTION_NOT_FOUND, `Section "${sectionName}" not found in "${listName}"`);
+    }
+    return { pk: row.Z_PK, identifier: row.identifier };
+}
+/**
+ * Read the current membership data JSON from a list.
+ */
+export function readMembershipData(listPk) {
+    const db = getDb();
+    const row = db
+        .prepare("SELECT cast(ZMEMBERSHIPSOFREMINDERSINSECTIONSASDATA as text) as data FROM ZREMCDBASELIST WHERE Z_PK = ?")
+        .get(listPk);
+    return row?.data || null;
+}
+/**
+ * Read the resolution token map JSON from a list.
+ * The token map may be stored as a BLOB or TEXT — handle both.
+ */
+export function readTokenMap(listPk) {
+    const db = getDb();
+    const row = db
+        .prepare("SELECT cast(ZRESOLUTIONTOKENMAP_V3_JSONDATA as text) as data FROM ZREMCDBASELIST WHERE Z_PK = ?")
+        .get(listPk);
+    return row?.data || null;
+}
+/**
+ * Write membership data, checksum, and token map in a SINGLE ATOMIC TRANSACTION.
+ *
+ * This is the key improvement over the predecessor which used separate sqlite3 process
+ * calls for each statement. A partial write (data updated but checksum not) would cause
+ * remindd to detect data corruption.
+ */
+export function writeMembershipSync(listPk, membershipJson, checksumHex, tokenMapJson) {
+    const db = getDb();
+    const writeAll = db.transaction(() => {
+        db.prepare("UPDATE ZREMCDBASELIST SET ZMEMBERSHIPSOFREMINDERSINSECTIONSASDATA = ? WHERE Z_PK = ?").run(membershipJson, listPk);
+        db.prepare("UPDATE ZREMCDBASELIST SET ZMEMBERSHIPSOFREMINDERSINSECTIONSCHECKSUM = ? WHERE Z_PK = ?").run(checksumHex, listPk);
+        db.prepare("UPDATE ZREMCDBASELIST SET ZRESOLUTIONTOKENMAP_V3_JSONDATA = ? WHERE Z_PK = ?").run(tokenMapJson, listPk);
+    });
+    writeAll();
+}
+/**
+ * Convert a hex blob string (32 chars, no hyphens) to standard UUID format.
+ */
+export function hexToUuid(hex) {
+    const h = hex.toUpperCase();
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+}
+/**
+ * Convert a JS Date to Core Data timestamp (seconds since 2001-01-01 00:00:00 UTC).
+ */
+export function coreDataTimestamp(date) {
+    const d = date || new Date();
+    return d.getTime() / 1000 - 978307200;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/core/sqlite.js.map

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

package/dist/core/tokenmap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resolution token map manipulation.
+ *
+ * The token map is Apple's CRDT-style vector clock for field-level sync.
+ * Each syncable field has a counter and modificationTime. When a field changes
+ * locally, its counter must be incremented to tell remindd's sync engine
+ * "this field has a local change that needs to be pushed to CloudKit".
+ *
+ * These are pure functions — no side effects, easy to unit test.
+ */
+import type { TokenMap } from "../types.js";
+/**
+ * Parse a token map JSON string into a TokenMap object.
+ * Returns an empty map if the input is null/empty/invalid.
+ */
+export declare function parseTokenMap(json: string | null): TokenMap;
+/**
+ * Increment the membership field counter in the token map and set modificationTime.
+ * Returns a new TokenMap (does not mutate the input).
+ */
+export declare function incrementMembershipCounter(tokenMap: TokenMap, timestamp: number): TokenMap;
+/**
+ * Serialize a token map to a JSON string with sorted keys for consistency.
+ */
+export declare function serializeTokenMap(tokenMap: TokenMap): string;
+/**
+ * Get the current counter value for the membership field.
+ */
+export declare function getMembershipCounter(tokenMap: TokenMap): number;

package/dist/core/tokenmap.js

@@ -0,0 +1,52 @@
+/**
+ * Resolution token map manipulation.
+ *
+ * The token map is Apple's CRDT-style vector clock for field-level sync.
+ * Each syncable field has a counter and modificationTime. When a field changes
+ * locally, its counter must be incremented to tell remindd's sync engine
+ * "this field has a local change that needs to be pushed to CloudKit".
+ *
+ * These are pure functions — no side effects, easy to unit test.
+ */
+const MEMBERSHIP_FIELD = "membershipsOfRemindersInSectionsChecksum";
+/**
+ * Parse a token map JSON string into a TokenMap object.
+ * Returns an empty map if the input is null/empty/invalid.
+ */
+export function parseTokenMap(json) {
+    if (!json || json.trim() === "")
+        return {};
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Increment the membership field counter in the token map and set modificationTime.
+ * Returns a new TokenMap (does not mutate the input).
+ */
+export function incrementMembershipCounter(tokenMap, timestamp) {
+    const updated = { ...tokenMap };
+    const existing = updated[MEMBERSHIP_FIELD];
+    const currentCounter = existing?.counter ?? 0;
+    updated[MEMBERSHIP_FIELD] = {
+        counter: currentCounter + 1,
+        modificationTime: timestamp,
+    };
+    return updated;
+}
+/**
+ * Serialize a token map to a JSON string with sorted keys for consistency.
+ */
+export function serializeTokenMap(tokenMap) {
+    return JSON.stringify(tokenMap, Object.keys(tokenMap).sort());
+}
+/**
+ * Get the current counter value for the membership field.
+ */
+export function getMembershipCounter(tokenMap) {
+    return tokenMap[MEMBERSHIP_FIELD]?.counter ?? 0;
+}
+//# sourceMappingURL=tokenmap.js.map

package/dist/core/tokenmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenmap.js","sourceRoot":"","sources":["../../src/core/tokenmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,gBAAgB,GAAG,0CAA0C,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB;IAChD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3C,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAkB,EAAE,SAAiB;IAC/E,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,MAAM,cAAc,GAAG,QAAQ,EAAE,OAAO,IAAI,CAAC,CAAC;IAE9C,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAC3B,OAAO,EAAE,cAAc,GAAG,CAAC;QAC3B,gBAAgB,EAAE,SAAS;KAC3B,CAAC;IAEF,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACtD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+/** A reminder list (calendar) in Apple Reminders */
+export interface ReminderList {
+    id: string;
+    title: string;
+    reminderCount: number;
+    overdueCount: number;
+}
+/** Priority levels matching Apple Reminders */
+export type Priority = "none" | "low" | "medium" | "high";
+/** A single reminder item */
+export interface Reminder {
+    id: string;
+    title: string;
+    isCompleted: boolean;
+    listID: string;
+    listName: string;
+    priority: Priority;
+    dueDate?: string;
+    completionDate?: string;
+    notes?: string;
+    section?: string;
+    isRecurring?: boolean;
+    recurrence?: string;
+    flagged?: boolean;
+}
+/** A section within a reminder list */
+export interface Section {
+    id: string;
+    displayName: string;
+    listName: string;
+    sortOrder: number;
+}
+/** Structured result wrapper for all remi operations */
+export interface RemiResult<T> {
+    success: boolean;
+    data?: T;
+    error?: RemiError;
+}
+/** Structured error with machine-readable code and human-readable suggestion */
+export interface RemiError {
+    code: string;
+    message: string;
+    suggestion?: string;
+}
+/** Options for adding a reminder */
+export interface AddReminderOptions {
+    list: string;
+    title: string;
+    section?: string;
+    due?: string;
+    priority?: Priority;
+    notes?: string;
+}
+/** Options for updating a reminder */
+export interface UpdateReminderOptions {
+    list: string;
+    title: string;
+    newTitle?: string;
+    due?: string;
+    clearDue?: boolean;
+    priority?: Priority;
+    notes?: string;
+}
+/** Section membership entry in the SQLite database */
+export interface MembershipEntry {
+    reminderID: string;
+    sectionID: string;
+}
+/** Membership data structure stored in ZMEMBERSHIPSOFREMINDERSINSECTIONSASDATA */
+export interface MembershipData {
+    memberships: MembershipEntry[];
+}
+/** Token map entry for a single syncable field */
+export interface TokenMapEntry {
+    counter: number;
+    modificationTime: number;
+}
+/** Resolution token map (CRDT vector clocks for sync) */
+export interface TokenMap {
+    [fieldName: string]: TokenMapEntry;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@mattheworiordan/remi",
+  "version": "0.1.0",
+  "description": "Fast, reliable CLI for Apple Reminders with section support and iCloud sync",
+  "type": "module",
+  "bin": {
+    "remi": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:soak": "echo '\nSoak Test: Cross-device sync verification\n=========================================\nCopy the prompt from tests/soak/SOAK_TEST.md and paste it into\na Claude Code session with computer-use MCP connected.\n\nOr run: cat tests/soak/SOAK_TEST.md\n'",
+    "lint": "biome check src/ tests/",
+    "lint:fix": "biome check --write src/ tests/",
+    "build:swift": "bash src/swift/build.sh",
+    "prepublishOnly": "npm run build && npm run build:swift",
+    "postinstall": "npm run build:swift || echo 'Swift build skipped (non-macOS or missing Xcode tools)'"
+  },
+  "files": [
+    "dist/",
+    "src/swift/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "apple-reminders",
+    "reminders",
+    "cli",
+    "macos",
+    "icloud",
+    "sections",
+    "eventkit",
+    "mcp"
+  ],
+  "author": "Matthew O'Riordan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mattheworiordan/remi.git"
+  },
+  "engines": {
+    "node": ">=18",
+    "os": "darwin"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "chalk": "^5.4.1",
+    "chrono-node": "^2.9.0",
+    "commander": "^14.0.0",
+    "dayjs": "^1.11.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.15.3",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.3"
+  }
+}

package/src/swift/Info.plist

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleIdentifier</key>
+	<string>com.mattheworiordan.remi</string>
+	<key>CFBundleName</key>
+	<string>remi</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleIconFile</key>
+	<string>remi.icns</string>
+	<key>NSRemindersUsageDescription</key>
+	<string>remi needs access to Apple Reminders to create, read, update, and organize your reminders and sections.</string>
+</dict>
+</plist>

package/src/swift/build.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Build Swift helpers for remi
+# Compiles both helpers into binaries with embedded Info.plist
+# (provides NSRemindersUsageDescription for the permission dialog)
+# This requires macOS 13+ and Xcode Command Line Tools.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+OUTPUT_DIR="${SCRIPT_DIR}/../../dist"
+INFO_PLIST="$SCRIPT_DIR/Info.plist"
+
+mkdir -p "$OUTPUT_DIR"
+
+# -- reminders-helper (EventKit operations) --
+if [ ! -f "$OUTPUT_DIR/reminders-helper" ] || [ "$SCRIPT_DIR/reminders-helper.swift" -nt "$OUTPUT_DIR/reminders-helper" ]; then
+    echo "Compiling reminders-helper..."
+    swiftc \
+        -framework Foundation \
+        -framework EventKit \
+        -Xlinker -sectcreate -Xlinker __TEXT -Xlinker __info_plist -Xlinker "$INFO_PLIST" \
+        -O \
+        -o "$OUTPUT_DIR/reminders-helper" \
+        "$SCRIPT_DIR/reminders-helper.swift"
+    codesign -s - -f "$OUTPUT_DIR/reminders-helper" 2>/dev/null || true
+    echo "reminders-helper compiled successfully"
+else
+    echo "reminders-helper is up to date"
+fi
+
+# -- section-helper (ReminderKit + SQLite database access) --
+if [ ! -f "$OUTPUT_DIR/section-helper" ] || [ "$SCRIPT_DIR/section-helper.swift" -nt "$OUTPUT_DIR/section-helper" ]; then
+    echo "Compiling section-helper..."
+    swiftc \
+        -framework Foundation \
+        -framework EventKit \
+        -F /System/Library/PrivateFrameworks \
+        -framework ReminderKit \
+        -Xlinker -sectcreate -Xlinker __TEXT -Xlinker __info_plist -Xlinker "$INFO_PLIST" \
+        -O \
+        -o "$OUTPUT_DIR/section-helper" \
+        "$SCRIPT_DIR/section-helper.swift"
+    codesign -s - -f "$OUTPUT_DIR/section-helper" 2>/dev/null || true
+    echo "section-helper compiled successfully"
+else
+    echo "section-helper is up to date"
+fi