@ofocus/sdk 0.1.0

package/dist/commands/folders.js

@@ -0,0 +1,150 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateFolderName, validateId } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers, } from "../applescript.js";
+/**
+ * Create a new folder in OmniFocus.
+ */
+export async function createFolder(name, options = {}) {
+    // Validate folder name (required for create)
+    if (!name || name.trim() === "") {
+        return failure(createError(ErrorCode.VALIDATION_ERROR, "Folder name cannot be empty"));
+    }
+    const nameError = validateFolderName(name);
+    if (nameError)
+        return failure(nameError);
+    // Validate optional inputs
+    if (options.parentFolderId !== undefined) {
+        const parentIdError = validateId(options.parentFolderId, "project");
+        if (parentIdError)
+            return failure(parentIdError);
+    }
+    const parentNameError = validateFolderName(options.parentFolderName);
+    if (parentNameError)
+        return failure(parentNameError);
+    // Build script based on whether we're placing in a parent folder
+    let findParent = "";
+    let makeFolder = "";
+    if (options.parentFolderId) {
+        findParent = `set parentFolder to first flattened folder whose id is "${escapeAppleScript(options.parentFolderId)}"`;
+        makeFolder = `set newFolder to make new folder at end of folders of parentFolder with properties {name:"${escapeAppleScript(name)}"}`;
+    }
+    else if (options.parentFolderName) {
+        findParent = `set parentFolder to first flattened folder whose name is "${escapeAppleScript(options.parentFolderName)}"`;
+        makeFolder = `set newFolder to make new folder at end of folders of parentFolder with properties {name:"${escapeAppleScript(name)}"}`;
+    }
+    else {
+        findParent = "";
+        makeFolder = `set newFolder to make new folder with properties {name:"${escapeAppleScript(name)}"}`;
+    }
+    const script = `
+    ${findParent}
+    ${makeFolder}
+
+    -- Return the created folder info
+    set folderId to id of newFolder
+    set folderName to name of newFolder
+
+    set parentId to ""
+    set parentName to ""
+    try
+      set p to container of newFolder
+      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 newFolder
+    set subFolderCount to count of folders of newFolder
+
+    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 create folder"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No folder data returned"));
+    }
+    return success(result.data);
+}
+/**
+ * Query folders from OmniFocus with optional filters.
+ */
+export async function queryFolders(options = {}) {
+    // Validate parent filter
+    const parentError = validateFolderName(options.parent);
+    if (parentError)
+        return failure(parentError);
+    const script = `
+    set output to "["
+    set isFirst to true
+
+    set allFolders to flattened folders
+
+    repeat with f in allFolders
+      set shouldInclude to true
+
+      ${options.parent ? `-- Filter by parent folder` : ""}
+      ${options.parent ? `try` : ""}
+      ${options.parent ? `  set c to container of f` : ""}
+      ${options.parent ? `  if class of c is folder then` : ""}
+      ${options.parent ? `    if name of c is not "${escapeAppleScript(options.parent)}" then set shouldInclude to false` : ""}
+      ${options.parent ? `  else` : ""}
+      ${options.parent ? `    set shouldInclude to false` : ""}
+      ${options.parent ? `  end if` : ""}
+      ${options.parent ? `on error` : ""}
+      ${options.parent ? `  set shouldInclude to false` : ""}
+      ${options.parent ? `end try` : ""}
+
+      if shouldInclude then
+        if not isFirst then set output to output & ","
+        set isFirst to false
+
+        set folderId to id of f
+        set folderName to name of f
+
+        set parentId to ""
+        set parentName to ""
+        try
+          set p to container of f
+          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 f
+        set subFolderCount to count of folders of f
+
+        set output to output & "{" & ¬
+          "\\"id\\": \\"" & folderId & "\\"," & ¬
+          "\\"name\\": \\"" & (my escapeJson(folderName)) & "\\"," & ¬
+          "\\"parentId\\": " & (my jsonString(parentId)) & "," & ¬
+          "\\"parentName\\": " & (my jsonString(parentName)) & "," & ¬
+          "\\"projectCount\\": " & projCount & "," & ¬
+          "\\"folderCount\\": " & subFolderCount & ¬
+          "}"
+      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 folders"));
+    }
+    return success(result.data ?? []);
+}
+//# sourceMappingURL=folders.js.map

package/dist/commands/folders.js.map

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

package/dist/commands/inbox.d.ts

@@ -0,0 +1,6 @@
+import type { CliOutput, InboxOptions, OFTask } from "../types.js";
+/**
+ * Add a task to the OmniFocus inbox.
+ */
+export declare function addToInbox(title: string, options?: InboxOptions): Promise<CliOutput<OFTask>>;
+//# sourceMappingURL=inbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../src/commands/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgBnE;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAmI5B"}

package/dist/commands/inbox.js

@@ -0,0 +1,124 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateDateString, validateTags, validateEstimatedMinutes, validateRepetitionRule, } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers, } from "../applescript.js";
+import { buildRepetitionRuleScript } from "./repetition.js";
+/**
+ * Add a task to the OmniFocus inbox.
+ */
+export async function addToInbox(title, options = {}) {
+    // Validate inputs
+    if (options.due !== undefined) {
+        const dueError = validateDateString(options.due);
+        if (dueError)
+            return failure(dueError);
+    }
+    if (options.defer !== undefined) {
+        const deferError = validateDateString(options.defer);
+        if (deferError)
+            return failure(deferError);
+    }
+    const tagsError = validateTags(options.tags);
+    if (tagsError)
+        return failure(tagsError);
+    const estimateError = validateEstimatedMinutes(options.estimatedMinutes);
+    if (estimateError)
+        return failure(estimateError);
+    const repeatError = validateRepetitionRule(options.repeat);
+    if (repeatError)
+        return failure(repeatError);
+    const properties = [`name:"${escapeAppleScript(title)}"`];
+    if (options.note !== undefined) {
+        properties.push(`note:"${escapeAppleScript(options.note)}"`);
+    }
+    if (options.flag === true) {
+        properties.push("flagged:true");
+    }
+    if (options.due !== undefined) {
+        properties.push(`due date:date "${options.due}"`);
+    }
+    if (options.defer !== undefined) {
+        properties.push(`defer date:date "${options.defer}"`);
+    }
+    if (options.estimatedMinutes !== undefined) {
+        properties.push(`estimated minutes:${String(options.estimatedMinutes)}`);
+    }
+    // Build repetition rule script if provided
+    const repetitionScript = options.repeat
+        ? buildRepetitionRuleScript("newTask", options.repeat)
+        : "";
+    // Build the AppleScript
+    let script = `
+    set newTask to make new inbox task with properties {${properties.join(", ")}}
+  `;
+    // Handle tags separately (requires looking them up)
+    if (options.tags && options.tags.length > 0) {
+        for (const tagName of options.tags) {
+            script += `
+    try
+      set theTag to first flattened tag whose name is "${escapeAppleScript(tagName)}"
+      add theTag to tags of newTask
+    end try
+      `;
+        }
+    }
+    // Add repetition rule if provided
+    if (repetitionScript) {
+        script += repetitionScript;
+    }
+    // Return the created task info
+    script += `
+    set taskId to id of newTask
+    set taskName to name of newTask
+    set taskNote to note of newTask
+    set taskFlagged to flagged of newTask
+    set taskCompleted to completed of newTask
+
+    set dueStr to ""
+    try
+      set dueStr to (due date of newTask) as string
+    end try
+
+    set deferStr to ""
+    try
+      set deferStr to (defer date of newTask) as string
+    end try
+
+    set tagNames to {}
+    repeat with t in tags of newTask
+      set end of tagNames to name of t
+    end repeat
+
+    set estMinutes to 0
+    try
+      set estMinutes to estimated minutes of newTask
+      if estMinutes is missing value then set estMinutes to 0
+    end try
+
+    return "{" & ¬
+      "\\"id\\": \\"" & taskId & "\\"," & ¬
+      "\\"name\\": \\"" & taskName & "\\"," & ¬
+      "\\"note\\": " & (my jsonString(taskNote)) & "," & ¬
+      "\\"flagged\\": " & taskFlagged & "," & ¬
+      "\\"completed\\": " & taskCompleted & "," & ¬
+      "\\"dueDate\\": " & (my jsonString(dueStr)) & "," & ¬
+      "\\"deferDate\\": " & (my jsonString(deferStr)) & "," & ¬
+      "\\"completionDate\\": null," & ¬
+      "\\"projectId\\": null," & ¬
+      "\\"projectName\\": null," & ¬
+      "\\"tags\\": " & (my jsonArray(tagNames)) & "," & ¬
+      "\\"estimatedMinutes\\": " & estMinutes & ¬
+      "}"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to add task to inbox"));
+    }
+    if (result.data === undefined) {
+        return failure(createError(ErrorCode.UNKNOWN_ERROR, "No task data returned"));
+    }
+    return success(result.data);
+}
+//# sourceMappingURL=inbox.js.map

package/dist/commands/inbox.js.map

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

package/dist/commands/perspectives.d.ts

@@ -0,0 +1,20 @@
+import type { CliOutput, OFPerspective, OFTask } from "../types.js";
+/**
+ * Options for querying a perspective.
+ */
+export interface PerspectiveQueryOptions {
+    limit?: number | undefined;
+}
+/**
+ * List all perspectives in OmniFocus.
+ */
+export declare function listPerspectives(): Promise<CliOutput<OFPerspective[]>>;
+/**
+ * Query tasks from a specific perspective in OmniFocus.
+ *
+ * Note: This function retrieves tasks based on the perspective's filtering rules.
+ * Some perspectives may require UI interaction in OmniFocus to be properly evaluated.
+ * Built-in perspectives like "Flagged", "Forecast", and "Projects" work best.
+ */
+export declare function queryPerspective(name: string, options?: PerspectiveQueryOptions): Promise<CliOutput<OFTask[]>>;
+//# sourceMappingURL=perspectives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"perspectives.d.ts","sourceRoot":"","sources":["../../src/commands/perspectives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAmC5E;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAwI9B"}

package/dist/commands/perspectives.js

@@ -0,0 +1,166 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { validateSearchQuery } from "../validation.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers, } from "../applescript.js";
+/**
+ * List all perspectives in OmniFocus.
+ */
+export async function listPerspectives() {
+    const script = `
+    set output to "["
+    set isFirst to true
+
+    set allPerspectives to perspectives
+
+    repeat with p in allPerspectives
+      if not isFirst then set output to output & ","
+      set isFirst to false
+
+      set perspId to id of p
+      set perspName to name of p
+
+      set output to output & "{" & ¬
+        "\\"id\\": \\"" & perspId & "\\"," & ¬
+        "\\"name\\": \\"" & (my escapeJson(perspName)) & "\\"" & ¬
+        "}"
+    end repeat
+
+    return output & "]"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to list perspectives"));
+    }
+    return success(result.data ?? []);
+}
+/**
+ * Query tasks from a specific perspective in OmniFocus.
+ *
+ * Note: This function retrieves tasks based on the perspective's filtering rules.
+ * Some perspectives may require UI interaction in OmniFocus to be properly evaluated.
+ * Built-in perspectives like "Flagged", "Forecast", and "Projects" work best.
+ */
+export async function queryPerspective(name, options = {}) {
+    // Validate perspective name
+    const nameError = validateSearchQuery(name);
+    if (nameError) {
+        return failure(createError(ErrorCode.VALIDATION_ERROR, "Perspective name cannot be empty"));
+    }
+    const limit = options.limit ?? 100;
+    // Note: OmniFocus's AppleScript support for perspectives is limited.
+    // We can check if a perspective exists but getting its filtered tasks
+    // programmatically is difficult. We'll get all tasks and note that
+    // this is a limitation.
+    //
+    // For built-in perspectives, we can implement specific logic:
+    // - Flagged: flagged tasks
+    // - Inbox: inbox tasks
+    // - Projects: all project tasks
+    // - Forecast: tasks with due dates
+    const escapedName = escapeAppleScript(name);
+    const script = `
+    -- First verify the perspective exists
+    set perspExists to false
+    try
+      set thePerspective to perspective "${escapedName}"
+      set perspExists to true
+    end try
+
+    if not perspExists then
+      error "Perspective not found: ${escapedName}"
+    end if
+
+    -- Handle known built-in perspectives
+    set perspNameLower to "${escapedName.toLowerCase()}"
+    set output to "["
+    set isFirst to true
+    set matchCount to 0
+    set maxResults to ${String(limit)}
+
+    if perspNameLower is "flagged" then
+      set taskList to (flattened tasks where flagged is true and completed is false)
+    else if perspNameLower is "inbox" then
+      set taskList to inbox tasks
+    else if perspNameLower is "forecast" then
+      set taskList to (flattened tasks where due date is not missing value and completed is false)
+    else
+      -- For custom perspectives, return all available tasks as a fallback
+      -- This is a limitation of OmniFocus's AppleScript API
+      set taskList to (flattened tasks where completed is false)
+    end if
+
+    repeat with t in taskList
+      if matchCount >= maxResults then exit repeat
+      set matchCount to matchCount + 1
+
+      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 repeat
+
+    return output & "]"
+  `;
+    const result = await runAppleScript(omniFocusScriptWithHelpers(script));
+    if (!result.success) {
+        return failure(result.error ??
+            createError(ErrorCode.UNKNOWN_ERROR, "Failed to query perspective"));
+    }
+    return success(result.data ?? []);
+}
+//# sourceMappingURL=perspectives.js.map

package/dist/commands/perspectives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perspectives.js","sourceRoot":"","sources":["../../src/commands/perspectives.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,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAS3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;GAoBd,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,6BAA6B,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,UAAmC,EAAE;IAErC,4BAA4B;IAC5B,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,OAAO,CACZ,WAAW,CACT,SAAS,CAAC,gBAAgB,EAC1B,kCAAkC,CACnC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IAEnC,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,wBAAwB;IACxB,EAAE;IACF,8DAA8D;IAC9D,2BAA2B;IAC3B,uBAAuB;IACvB,gCAAgC;IAChC,mCAAmC;IAEnC,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG;;;;2CAI0B,WAAW;;;;;sCAKhB,WAAW;;;;6BAIpB,WAAW,CAAC,WAAW,EAAE;;;;wBAI9B,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8ElC,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,6BAA6B,CAAC,CACtE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/commands/projects.d.ts

@@ -0,0 +1,6 @@
+import type { CliOutput, ProjectQueryOptions, OFProject } from "../types.js";
+/**
+ * Query projects from OmniFocus with optional filters.
+ */
+export declare function queryProjects(options?: ProjectQueryOptions): Promise<CliOutput<OFProject[]>>;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/commands/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,SAAS,EACV,MAAM,aAAa,CAAC;AASrB;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAmHjC"}

package/dist/commands/projects.js

@@ -0,0 +1,113 @@
+import { success, failure } from "../result.js";
+import { ErrorCode, createError } from "../errors.js";
+import { escapeAppleScript } from "../escape.js";
+import { runAppleScript, omniFocusScriptWithHelpers, } from "../applescript.js";
+/**
+ * Query projects from OmniFocus with optional filters.
+ */
+export async function queryProjects(options = {}) {
+    // Build filter conditions for properties that work in where clauses
+    const conditions = [];
+    if (options.sequential === true) {
+        conditions.push("sequential is true");
+    }
+    else if (options.sequential === false) {
+        conditions.push("sequential is false");
+    }
+    const whereClause = conditions.length > 0 ? `where ${conditions.join(" and ")}` : "";
+    // Map status option to AppleScript status value
+    let statusFilter = "";
+    if (options.status !== undefined) {
+        switch (options.status) {
+            case "active":
+                statusFilter = "active status";
+                break;
+            case "on-hold":
+                statusFilter = "on hold";
+                break;
+            case "completed":
+                statusFilter = "done";
+                break;
+            case "dropped":
+                statusFilter = "dropped";
+                break;
+        }
+    }
+    const script = `
+    set output to "["
+    set isFirst to true
+
+    set allProjects to flattened projects ${whereClause}
+
+    repeat with p in allProjects
+      set shouldInclude to true
+
+      -- Safely determine project status (OmniFocus has issues with direct status comparisons)
+      set projStatus to "active"
+      try
+        set theStatus to status of p
+        if theStatus is on hold then
+          set projStatus to "on-hold"
+        else if theStatus is done then
+          set projStatus to "completed"
+        else if theStatus is dropped then
+          set projStatus to "dropped"
+        end if
+      end try
+
+      ${statusFilter === "active status" ? `if projStatus is not "active" then set shouldInclude to false` : ""}
+      ${statusFilter === "on hold" ? `if projStatus is not "on-hold" then set shouldInclude to false` : ""}
+      ${statusFilter === "done" ? `if projStatus is not "completed" then set shouldInclude to false` : ""}
+      ${statusFilter === "dropped" ? `if projStatus is not "dropped" then set shouldInclude to false` : ""}
+
+      ${options.folder ? `-- Filter by folder` : ""}
+      ${options.folder ? `try` : ""}
+      ${options.folder ? `  if name of folder of p is not "${escapeAppleScript(options.folder)}" then set shouldInclude to false` : ""}
+      ${options.folder ? `on error` : ""}
+      ${options.folder ? `  set shouldInclude to false` : ""}
+      ${options.folder ? `end try` : ""}
+
+      if shouldInclude then
+        if not isFirst then set output to output & ","
+        set isFirst to false
+
+        set projId to id of p
+        set projName to name of p
+        set projNote to note of p
+        set projSeq to sequential of p
+
+        set folderId to ""
+        set folderName to ""
+        try
+          set f to folder of p
+          set folderId to id of f
+          set folderName to name of f
+        end try
+
+        set taskCount to count of tasks of p
+        set remainingCount to count of (tasks of p where completed is false)
+
+        set output to output & "{" & ¬
+          "\\"id\\": \\"" & projId & "\\"," & ¬
+          "\\"name\\": \\"" & (my escapeJson(projName)) & "\\"," & ¬
+          "\\"note\\": " & (my jsonString(projNote)) & "," & ¬
+          "\\"status\\": \\"" & projStatus & "\\"," & ¬
+          "\\"sequential\\": " & projSeq & "," & ¬
+          "\\"folderId\\": " & (my jsonString(folderId)) & "," & ¬
+          "\\"folderName\\": " & (my jsonString(folderName)) & "," & ¬
+          "\\"taskCount\\": " & taskCount & "," & ¬
+          "\\"remainingTaskCount\\": " & remainingCount & ¬
+          "}"
+      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 projects"));
+    }
+    return success(result.data ?? []);
+}
+//# sourceMappingURL=projects.js.map

package/dist/commands/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/commands/projects.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA+B,EAAE;IAEjC,oEAAoE;IACpE,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QACxC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,GACf,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,gDAAgD;IAChD,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,QAAQ;gBACX,YAAY,GAAG,eAAe,CAAC;gBAC/B,MAAM;YACR,KAAK,SAAS;gBACZ,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM;YACR,KAAK,WAAW;gBACd,YAAY,GAAG,MAAM,CAAC;gBACtB,MAAM;YACR,KAAK,SAAS;gBACZ,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG;;;;4CAI2B,WAAW;;;;;;;;;;;;;;;;;;QAkB/C,YAAY,KAAK,eAAe,CAAC,CAAC,CAAC,+DAA+D,CAAC,CAAC,CAAC,EAAE;QACvG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,gEAAgE,CAAC,CAAC,CAAC,EAAE;QAClG,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC,CAAC,EAAE;QACjG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,gEAAgE,CAAC,CAAC,CAAC,EAAE;;QAElG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE;QAC3C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,oCAAoC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE;QAC9H,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;QAChC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE;QACpD,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCpC,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/repetition.d.ts

@@ -0,0 +1,17 @@
+import type { RepetitionRule } from "../types.js";
+/**
+ * Build iCalendar RRULE string from a RepetitionRule.
+ */
+export declare function buildRRule(rule: RepetitionRule): string;
+/**
+ * Build AppleScript to set a repetition rule on a task.
+ * @param taskVar - The AppleScript variable name for the task
+ * @param rule - The repetition rule to apply
+ */
+export declare function buildRepetitionRuleScript(taskVar: string, rule: RepetitionRule): string;
+/**
+ * Build AppleScript to clear a repetition rule from a task.
+ * @param taskVar - The AppleScript variable name for the task
+ */
+export declare function buildClearRepetitionScript(taskVar: string): string;
+//# sourceMappingURL=repetition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repetition.d.ts","sourceRoot":"","sources":["../../src/commands/repetition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAsCvD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACnB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlE"}