@ofocus/sdk 0.1.0 → 0.3.0

package/dist/commands/focus.d.ts

@@ -0,0 +1,26 @@
+import type { CliOutput } from "../types.js";
+/**
+ * Result from focus operations.
+ */
+export interface FocusResult {
+    focused: boolean;
+    targetId: string | null;
+    targetName: string | null;
+    targetType: "project" | "folder" | null;
+}
+/**
+ * Focus on a specific project or folder in OmniFocus.
+ * This matches the OmniFocus UI focus feature.
+ */
+export declare function focus(target: string, options?: {
+    byId?: boolean | undefined;
+}): Promise<CliOutput<FocusResult>>;
+/**
+ * Clear focus in OmniFocus (show all items).
+ */
+export declare function unfocus(): Promise<CliOutput<FocusResult>>;
+/**
+ * Get the current focus state in OmniFocus.
+ */
+export declare function getFocused(): Promise<CliOutput<FocusResult>>;
+//# sourceMappingURL=focus.d.ts.map

package/dist/commands/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/commands/focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;CACzC;AAsBD;;;GAGG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAC3C,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CA4FjC;AAED;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CA6B/D;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAkDlE"}

package/dist/commands/focus.js

@@ -0,0 +1,182 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateProjectName } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers } from "../applescript.js";
+/**
+ * Validate an ID for focus operations (can be project or folder).
+ */
+function validateFocusId(id) {
+    if (!id || id.trim() === "") {
+        return { code: "INVALID_ID_FORMAT", message: "ID cannot be empty" };
+    }
+    // IDs should be alphanumeric with possible dashes/underscores
+    const idPattern = /^[a-zA-Z0-9_-]+$/;
+    if (!idPattern.test(id)) {
+        return {
+            code: "INVALID_ID_FORMAT",
+            message: `Invalid ID format: ${id}`,
+        };
+    }
+    return null;
+}
+/**
+ * Focus on a specific project or folder in OmniFocus.
+ * This matches the OmniFocus UI focus feature.
+ */
+export async function focus(target, options = {}) {
+    // Validate input
+    if (options.byId) {
+        const error = validateFocusId(target);
+        if (error) {
+            return failure(createError(ErrorCode.INVALID_ID_FORMAT, error.message));
+        }
+    }
+    else {
+        const error = validateProjectName(target);
+        if (error)
+            return failure(error);
+    }
+    const escapedTarget = escapeAppleScript(target);
+    const findScript = options.byId
+        ? `
+      -- Try to find by ID (could be project or folder)
+      set targetItem to missing value
+      set targetType to ""
+
+      try
+        set targetItem to first flattened project whose id is "${escapedTarget}"
+        set targetType to "project"
+      end try
+
+      if targetItem is missing value then
+        try
+          set targetItem to first flattened folder whose id is "${escapedTarget}"
+          set targetType to "folder"
+        end try
+      end if
+
+      if targetItem is missing value then
+        error "Target not found with ID: ${escapedTarget}"
+      end if
+    `
+        : `
+      -- Try to find by name (project first, then folder)
+      set targetItem to missing value
+      set targetType to ""
+
+      try
+        set targetItem to first flattened project whose name is "${escapedTarget}"
+        set targetType to "project"
+      end try
+
+      if targetItem is missing value then
+        try
+          set targetItem to first flattened folder whose name is "${escapedTarget}"
+          set targetType to "folder"
+        end try
+      end if
+
+      if targetItem is missing value then
+        error "Target not found: ${escapedTarget}"
+      end if
+    `;
+    const script = `
+    ${findScript}
+
+    -- Set focus
+    set focused of document window 1 to {targetItem}
+
+    -- Return result
+    set targetId to id of targetItem
+    set targetName to name of targetItem
+
+    return "{" & ¬
+      "\\"focused\\": true," & ¬
+      "\\"targetId\\": \\"" & targetId & "\\"," & ¬
+      "\\"targetName\\": \\"" & (my escapeJson(targetName)) & "\\"," & ¬
+      "\\"targetType\\": \\"" & targetType & "\\"" & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to focus on target"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No result returned"));
+    }
+    return success(result.data);
+}
+/**
+ * Clear focus in OmniFocus (show all items).
+ */
+export async function unfocus() {
+    const script = `
+    -- Clear focus by setting to empty list
+    set focused of document window 1 to {}
+
+    return "{" & ¬
+      "\\"focused\\": false," & ¬
+      "\\"targetId\\": null," & ¬
+      "\\"targetName\\": null," & ¬
+      "\\"targetType\\": null" & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to clear focus"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No result returned"));
+    }
+    return success(result.data);
+}
+/**
+ * Get the current focus state in OmniFocus.
+ */
+export async function getFocused() {
+    const script = `
+    set focusedItems to focused of document window 1
+
+    if (count of focusedItems) is 0 then
+      return "{" & ¬
+        "\\"focused\\": false," & ¬
+        "\\"targetId\\": null," & ¬
+        "\\"targetName\\": null," & ¬
+        "\\"targetType\\": null" & ¬
+        "}"
+    end if
+
+    -- Get first focused item (typically only one)
+    set focusedItem to item 1 of focusedItems
+
+    set targetId to id of focusedItem
+    set targetName to name of focusedItem
+
+    -- Determine type
+    set targetType to "folder"
+    try
+      set testStatus to status of focusedItem
+      set targetType to "project"
+    end try
+
+    return "{" & ¬
+      "\\"focused\\": true," & ¬
+      "\\"targetId\\": \\"" & targetId & "\\"," & ¬
+      "\\"targetName\\": \\"" & (my escapeJson(targetName)) & "\\"," & ¬
+      "\\"targetType\\": \\"" & targetType & "\\"" & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to get focus state"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No result returned"));
+    }
+    return success(result.data);
+}
+//# sourceMappingURL=focus.js.map

package/dist/commands/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../src/commands/focus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAY/E;;GAEG;AACH,SAAS,eAAe,CAAC,EAAU;IACjC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IACtE,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GAAG,kBAAkB,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,sBAAsB,EAAE,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAc,EACd,UAA0C,EAAE;IAE5C,iBAAiB;IACjB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI;QAC7B,CAAC,CAAC;;;;;;iEAM2D,aAAa;;;;;;kEAMZ,aAAa;;;;;;2CAMpC,aAAa;;KAEnD;QACD,CAAC,CAAC;;;;;;mEAM6D,aAAa;;;;;;oEAMZ,aAAa;;;;;;mCAM9C,aAAa;;KAE3C,CAAC;IAEJ,MAAM,MAAM,GAAG;MACX,UAAU;;;;;;;;;;;;;;;GAeb,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK;YACV,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,2BAA2B,CAAC,CACpE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,MAAM,GAAG;;;;;;;;;;GAUd,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK;YACV,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+Bd,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK;YACV,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,2BAA2B,CAAC,CACpE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/commands/folders-crud.d.ts

@@ -0,0 +1,18 @@
+import type { CliOutput, OFFolder, UpdateFolderOptions } from "../types.js";
+/**
+ * Result from deleting a folder.
+ */
+export interface DeleteFolderResult {
+    folderId: string;
+    deleted: true;
+}
+/**
+ * Update an existing folder in OmniFocus.
+ */
+export declare function updateFolder(folderId: string, options: UpdateFolderOptions): Promise<CliOutput<OFFolder>>;
+/**
+ * Delete a folder permanently from OmniFocus.
+ * Note: This cannot be undone.
+ */
+export declare function deleteFolder(folderId: string): Promise<CliOutput<DeleteFolderResult>>;
+//# sourceMappingURL=folders-crud.d.ts.map

package/dist/commands/folders-crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders-crud.d.ts","sourceRoot":"","sources":["../../src/commands/folders-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAO5E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAiG9B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CA4BxC"}

package/dist/commands/folders-crud.js

@@ -0,0 +1,117 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateId, validateFolderName } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers } from "../applescript.js";
+/**
+ * Update an existing folder in OmniFocus.
+ */
+export async function updateFolder(folderId, options) {
+    // Validate folder ID
+    const idError = validateId(folderId, "folder");
+    if (idError)
+        return failure(idError);
+    // Validate optional inputs
+    if (options.name !== undefined) {
+        const nameError = validateFolderName(options.name);
+        if (nameError)
+            return failure(nameError);
+    }
+    if (options.parentFolderId !== undefined) {
+        const parentIdError = validateId(options.parentFolderId, "folder");
+        if (parentIdError)
+            return failure(parentIdError);
+    }
+    if (options.parentFolderName !== undefined) {
+        const parentNameError = validateFolderName(options.parentFolderName);
+        if (parentNameError)
+            return failure(parentNameError);
+    }
+    // Build the update statements
+    const updates = [];
+    if (options.name !== undefined) {
+        updates.push(`set name of theFolder to "${escapeAppleScript(options.name)}"`);
+    }
+    // Handle reparenting
+    let reparentScript = "";
+    if (options.parentFolderId !== undefined) {
+        reparentScript = `
+      set newParent to first flattened folder whose id is "${escapeAppleScript(options.parentFolderId)}"
+      move theFolder to end of folders of newParent
+    `;
+    }
+    else if (options.parentFolderName !== undefined) {
+        reparentScript = `
+      set newParent to first flattened folder whose name is "${escapeAppleScript(options.parentFolderName)}"
+      move theFolder to end of folders of newParent
+    `;
+    }
+    const updateScript = updates.join("\n    ");
+    const script = `
+    set theFolder to first flattened folder whose id is "${escapeAppleScript(folderId)}"
+
+    ${updateScript}
+    ${reparentScript}
+
+    -- Return updated folder info
+    set folderId to id of theFolder
+    set folderName to name of theFolder
+
+    set parentId to ""
+    set parentName to ""
+    try
+      set p to container of theFolder
+      if class of p is folder then
+        set parentId to id of p
+        set parentName to name of p
+      end if
+    end try
+
+    set projCount to count of projects of theFolder
+    set subFolderCount to count of folders of theFolder
+
+    return "{" & ¬
+      "\\"id\\": \\"" & folderId & "\\"," & ¬
+      "\\"name\\": \\"" & (my escapeJson(folderName)) & "\\"," & ¬
+      "\\"parentId\\": " & (my jsonString(parentId)) & "," & ¬
+      "\\"parentName\\": " & (my jsonString(parentName)) & "," & ¬
+      "\\"projectCount\\": " & projCount & "," & ¬
+      "\\"folderCount\\": " & subFolderCount & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to update folder"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No folder data returned"));
+    }
+    return success(result.data);
+}
+/**
+ * Delete a folder permanently from OmniFocus.
+ * Note: This cannot be undone.
+ */
+export async function deleteFolder(folderId) {
+    // Validate folder ID
+    const idError = validateId(folderId, "folder");
+    if (idError)
+        return failure(idError);
+    const script = `
+    set theFolder to first flattened folder whose id is "${escapeAppleScript(folderId)}"
+    delete theFolder
+
+    return "{\\"folderId\\": \\"${escapeAppleScript(folderId)}\\", \\"deleted\\": true}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to delete folder"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No result returned"));
+    }
+    return success(result.data);
+}
+//# sourceMappingURL=folders-crud.js.map

package/dist/commands/folders-crud.js.map

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

package/dist/commands/forecast.d.ts

@@ -0,0 +1,20 @@
+import type { CliOutput, OFTask } from "../types.js";
+/**
+ * Options for querying forecast tasks.
+ */
+export interface ForecastOptions {
+    /** Start date for the forecast range (defaults to today) */
+    start?: string | undefined;
+    /** End date for the forecast range */
+    end?: string | undefined;
+    /** Number of days from start to include (alternative to end) */
+    days?: number | undefined;
+    /** Include tasks with no due date but deferred to the range */
+    includeDeferred?: boolean | undefined;
+}
+/**
+ * Query tasks by date range, similar to OmniFocus Forecast view.
+ * Returns tasks that are due or deferred within the specified date range.
+ */
+export declare function queryForecast(options?: ForecastOptions): Promise<CliOutput<OFTask[]>>;
+//# sourceMappingURL=forecast.d.ts.map

package/dist/commands/forecast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../../src/commands/forecast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAqJ9B"}

package/dist/commands/forecast.js

@@ -0,0 +1,145 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateDateString } from "../validation.js";
+import { runAppleScript, omniFocusScriptWithHelpers } from "../applescript.js";
+/**
+ * Query tasks by date range, similar to OmniFocus Forecast view.
+ * Returns tasks that are due or deferred within the specified date range.
+ */
+export async function queryForecast(options = {}) {
+    // Validate date inputs
+    if (options.start !== undefined) {
+        const error = validateDateString(options.start);
+        if (error)
+            return failure(error);
+    }
+    if (options.end !== undefined) {
+        const error = validateDateString(options.end);
+        if (error)
+            return failure(error);
+    }
+    // Validate days option
+    if (options.days !== undefined &&
+        (options.days < 1 || !Number.isInteger(options.days))) {
+        return failure(createError(ErrorCode.VALIDATION_ERROR, "Days must be a positive integer"));
+    }
+    // Build date range logic in AppleScript
+    const startDate = options.start ?? "today";
+    const includeDeferred = options.includeDeferred === true;
+    // Calculate end date based on days or explicit end
+    let endDateLogic;
+    if (options.end !== undefined) {
+        endDateLogic = `set endDate to date "${options.end}"`;
+    }
+    else if (options.days !== undefined) {
+        endDateLogic = `set endDate to startDate + (${String(options.days)} * days)`;
+    }
+    else {
+        // Default to 7 days
+        endDateLogic = `set endDate to startDate + (7 * days)`;
+    }
+    const script = `
+    set startDate to date "${startDate}"
+    ${endDateLogic}
+
+    set output to "["
+    set isFirst to true
+
+    set allTasks to flattened tasks where completed is false and effectively dropped is false
+
+    repeat with t in allTasks
+      set shouldInclude to false
+
+      -- Check due date
+      try
+        set taskDue to due date of t
+        if taskDue >= startDate and taskDue <= endDate then
+          set shouldInclude to true
+        end if
+      end try
+
+      ${includeDeferred
+        ? `
+      -- Check defer date
+      if not shouldInclude then
+        try
+          set taskDefer to defer date of t
+          if taskDefer >= startDate and taskDefer <= endDate then
+            set shouldInclude to true
+          end if
+        end try
+      end if
+      `
+        : ""}
+
+      if shouldInclude then
+        if not isFirst then set output to output & ","
+        set isFirst to false
+
+        set taskId to id of t
+        set taskName to name of t
+        set taskNote to note of t
+        set taskFlagged to flagged of t
+        set taskCompleted to completed of t
+
+        set dueStr to ""
+        try
+          set dueStr to (due date of t) as string
+        end try
+
+        set deferStr to ""
+        try
+          set deferStr to (defer date of t) as string
+        end try
+
+        set completionStr to ""
+        try
+          set completionStr to (completion date of t) as string
+        end try
+
+        set projId to ""
+        set projName to ""
+        try
+          set proj to containing project of t
+          set projId to id of proj
+          set projName to name of proj
+        end try
+
+        set tagNames to {}
+        repeat with tg in tags of t
+          set end of tagNames to name of tg
+        end repeat
+
+        set estMinutes to 0
+        try
+          set estMinutes to estimated minutes of t
+          if estMinutes is missing value then set estMinutes to 0
+        end try
+
+        set output to output & "{" & ¬
+          "\\"id\\": \\"" & taskId & "\\"," & ¬
+          "\\"name\\": \\"" & (my escapeJson(taskName)) & "\\"," & ¬
+          "\\"note\\": " & (my jsonString(taskNote)) & "," & ¬
+          "\\"flagged\\": " & taskFlagged & "," & ¬
+          "\\"completed\\": " & taskCompleted & "," & ¬
+          "\\"dueDate\\": " & (my jsonString(dueStr)) & "," & ¬
+          "\\"deferDate\\": " & (my jsonString(deferStr)) & "," & ¬
+          "\\"completionDate\\": " & (my jsonString(completionStr)) & "," & ¬
+          "\\"projectId\\": " & (my jsonString(projId)) & "," & ¬
+          "\\"projectName\\": " & (my jsonString(projName)) & "," & ¬
+          "\\"tags\\": " & (my jsonArray(tagNames)) & "," & ¬
+          "\\"estimatedMinutes\\": " & estMinutes & ¬
+          "}"
+      end if
+    end repeat
+
+    return output & "]"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to query forecast"));
+    }
+    return success(result.data ?? []);
+}
+//# sourceMappingURL=forecast.js.map

package/dist/commands/forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.js","sourceRoot":"","sources":["../../src/commands/forecast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAgB/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA2B,EAAE;IAE7B,uBAAuB;IACvB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,KAAK;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,KAAK;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,uBAAuB;IACvB,IACE,OAAO,CAAC,IAAI,KAAK,SAAS;QAC1B,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EACrD,CAAC;QACD,OAAO,OAAO,CACZ,WAAW,CAAC,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC;IAC3C,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC;IAEzD,mDAAmD;IACnD,IAAI,YAAoB,CAAC;IACzB,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,YAAY,GAAG,wBAAwB,OAAO,CAAC,GAAG,GAAG,CAAC;IACxD,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,YAAY,GAAG,+BAA+B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,oBAAoB;QACpB,YAAY,GAAG,uCAAuC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG;6BACY,SAAS;MAChC,YAAY;;;;;;;;;;;;;;;;;;QAmBV,eAAe;QACb,CAAC,CAAC;;;;;;;;;;OAUL;QACG,CAAC,CAAC,EACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEH,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK;YACV,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,0BAA0B,CAAC,CACnE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/commands/open.d.ts

@@ -0,0 +1,17 @@
+import type { CliOutput } from "../types.js";
+/**
+ * Result from opening an item.
+ */
+export interface OpenResult {
+    id: string;
+    type: "task" | "project" | "folder" | "tag";
+    name: string;
+    opened: true;
+}
+/**
+ * Open an item in the OmniFocus UI.
+ * The item can be a task, project, folder, or tag.
+ * Auto-detects the item type based on the ID.
+ */
+export declare function openItem(id: string): Promise<CliOutput<OpenResult>>;
+//# sourceMappingURL=open.d.ts.map

package/dist/commands/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/commands/open.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAoFzE"}

package/dist/commands/open.js

@@ -0,0 +1,88 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateId } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers } from "../applescript.js";
+/**
+ * Open an item in the OmniFocus UI.
+ * The item can be a task, project, folder, or tag.
+ * Auto-detects the item type based on the ID.
+ */
+export async function openItem(id) {
+    // Validate ID
+    const idError = validateId(id, "item");
+    if (idError)
+        return failure(idError);
+    // Try to find the item and determine its type, then open it
+    const script = `
+    set itemId to "${escapeAppleScript(id)}"
+    set itemType to ""
+    set itemName to ""
+    set foundItem to missing value
+
+    -- Try to find as task first (most common)
+    try
+      set foundItem to first flattened task whose id is itemId
+      set itemType to "task"
+      set itemName to name of foundItem
+    end try
+
+    -- Try as project
+    if foundItem is missing value then
+      try
+        set foundItem to first flattened project whose id is itemId
+        set itemType to "project"
+        set itemName to name of foundItem
+      end try
+    end if
+
+    -- Try as folder
+    if foundItem is missing value then
+      try
+        set foundItem to first flattened folder whose id is itemId
+        set itemType to "folder"
+        set itemName to name of foundItem
+      end try
+    end if
+
+    -- Try as tag
+    if foundItem is missing value then
+      try
+        set foundItem to first flattened tag whose id is itemId
+        set itemType to "tag"
+        set itemName to name of foundItem
+      end try
+    end if
+
+    if foundItem is missing value then
+      error "Item not found with ID: " & itemId
+    end if
+
+    -- Activate OmniFocus and open the item using URL scheme
+    tell application "OmniFocus"
+      activate
+    end tell
+
+    -- Use URL scheme to navigate to the item
+    -- OmniFocus URL scheme: omnifocus:///task/ID, omnifocus:///project/ID, etc.
+    set theUrl to "omnifocus:///" & itemType & "/" & itemId
+    do shell script "open " & quoted form of theUrl
+
+    return "{" & ¬
+      "\\"id\\": \\"" & itemId & "\\"," & ¬
+      "\\"type\\": \\"" & itemType & "\\"," & ¬
+      "\\"name\\": \\"" & (my escapeJson(itemName)) & "\\"," & ¬
+      "\\"opened\\": true" & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to open item"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No result returned"));
+    }
+    return success(result.data);
+}
+//# sourceMappingURL=open.js.map

package/dist/commands/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/commands/open.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAY/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU;IACvC,cAAc;IACd,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,4DAA4D;IAC5D,MAAM,MAAM,GAAG;qBACI,iBAAiB,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DvC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,0BAA0B,CAAC,MAAM,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CACZ,MAAM,CAAC,KAAK;YACV,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}