import { executeOmniFocusScript } from '../../utils/scriptExecution.js';
export interface GetCustomPerspectiveTasksOptions {
perspectiveName?: string;
perspectiveId?: string;
hideCompleted?: boolean;
limit?: number;
showHierarchy?: boolean;
}
export async function getCustomPerspectiveTasks(options: GetCustomPerspectiveTasksOptions): Promise<string> {
const { perspectiveName, perspectiveId, hideCompleted = true, limit = 1000, showHierarchy = false } = options;
if (!perspectiveName && !perspectiveId) {
return "❌ **Error**: Must provide either perspectiveName or perspectiveId";
}
try {
// Execute the get custom perspective tasks script
const result = await executeOmniFocusScript('@getCustomPerspectiveTasks.js', {
perspectiveName: perspectiveName,
perspectiveId: perspectiveId
});
// Handle various return types
let data: any;
if (typeof result === 'string') {
try {
data = JSON.parse(result);
} catch (parseError) {
throw new Error(`Failed to parse string result: ${result}`);
}
} else if (typeof result === 'object' && result !== null) {
data = result;
} else {
throw new Error(`Script returned invalid result type: ${typeof result}, value: ${result}`);
}
// Check for errors
if (!data.success) {
throw new Error(data.error || 'Unknown error occurred');
}
// Get the actual perspective name from the result (OmniJS always returns it)
const actualPerspectiveName = data.perspectiveName || perspectiveName || 'Unknown Perspective';
// Process taskMap data (hierarchical structure)
const taskMap = data.taskMap || {};
const allTasks = Object.values(taskMap);
// Filter completed tasks if needed
let filteredTasks = allTasks;
if (hideCompleted) {
filteredTasks = allTasks.filter((task: any) => !task.completed);
}
if (filteredTasks.length === 0) {
return `**Perspective Tasks: ${actualPerspectiveName}**\n\nNo ${hideCompleted ? 'incomplete ' : ''}tasks.`;
}
// Choose output format based on hierarchy setting
if (showHierarchy) {
return formatHierarchicalTasks(actualPerspectiveName, taskMap, hideCompleted);
} else {
return formatFlatTasks(actualPerspectiveName, filteredTasks, limit, data.count);
}
} catch (error) {
console.error('Error in getCustomPerspectiveTasks:', error);
return `❌ **Error**: ${error instanceof Error ? error.message : String(error)}`;
}
}
// Format hierarchical task display
function formatHierarchicalTasks(perspectiveName: string, taskMap: any, hideCompleted: boolean): string {
const header = `**Perspective Tasks: ${perspectiveName}** (Hierarchical View)\n\n`;
// Find all root tasks (tasks with parent === null)
const rootTasks = Object.values(taskMap).filter((task: any) => task.parent === null);
// Filter completed tasks
const filteredRootTasks = hideCompleted
? rootTasks.filter((task: any) => !task.completed)
: rootTasks;
if (filteredRootTasks.length === 0) {
return header + `No ${hideCompleted ? 'incomplete ' : ''}root tasks.`;
}
// Recursively render task tree
const taskTreeLines: string[] = [];
filteredRootTasks.forEach((rootTask: any, index: number) => {
const isLast = index === filteredRootTasks.length - 1;
renderTaskTree(rootTask, taskMap, hideCompleted, '', isLast, taskTreeLines);
});
return header + taskTreeLines.join('\n');
}
// Recursively render task tree
function renderTaskTree(task: any, taskMap: any, hideCompleted: boolean, prefix: string, isLast: boolean, lines: string[]): void {
// Tree prefix for current task
const currentPrefix = prefix + (isLast ? '└─ ' : '├─ ');
// Render current task
let taskLine = currentPrefix + formatTaskName(task);
lines.push(taskLine);
// Add task details (indented)
const detailPrefix = prefix + (isLast ? ' ' : '│ ');
const taskDetails = formatTaskDetails(task);
if (taskDetails.length > 0) {
taskDetails.forEach(detail => {
lines.push(detailPrefix + detail);
});
}
// Process child tasks
if (task.children && task.children.length > 0) {
const childTasks = task.children
.map((childId: string) => taskMap[childId])
.filter((child: any) => child && (!hideCompleted || !child.completed));
childTasks.forEach((childTask: any, index: number) => {
const isLastChild = index === childTasks.length - 1;
const childPrefix = prefix + (isLast ? ' ' : '│ ');
renderTaskTree(childTask, taskMap, hideCompleted, childPrefix, isLastChild, lines);
});
}
}
// Format task name
function formatTaskName(task: any): string {
let name = `**${task.name}**`;
if (task.completed) {
name = `~~${name}~~ [Done]`;
} else if (task.flagged) {
name = `[Flagged] ${name}`;
}
return name;
}
// Format task details
function formatTaskDetails(task: any): string[] {
const details: string[] = [];
if (task.id) {
details.push(`ID: ${task.id}`);
}
if (task.project) {
details.push(`Project: ${task.project}`);
}
if (task.tags && task.tags.length > 0) {
details.push(`Tags: ${task.tags.join(', ')}`);
}
if (task.dueDate) {
const dueDate = new Date(task.dueDate).toLocaleDateString();
details.push(`Due: ${dueDate}`);
}
if (task.estimatedMinutes) {
const hours = Math.floor(task.estimatedMinutes / 60);
const minutes = task.estimatedMinutes % 60;
if (hours > 0) {
details.push(`Estimate: ${hours}h${minutes > 0 ? ` ${minutes}m` : ''}`);
} else {
details.push(`Estimate: ${minutes}m`);
}
}
if (task.note && task.note.trim()) {
const notePreview = task.note.trim().substring(0, 60);
details.push(`Note: ${notePreview}${task.note.length > 60 ? '...' : ''}`);
}
return details;
}
// Format flat task display
function formatFlatTasks(perspectiveName: string, tasks: any[], limit: number, totalCount: number): string {
// Limit task count
let displayTasks = tasks;
if (limit && limit > 0) {
displayTasks = tasks.slice(0, limit);
}
// Generate task list
const taskList = displayTasks.map((task: any, index: number) => {
let taskText = `${index + 1}. **${task.name}** [ID: ${task.id}]`;
if (task.project) {
taskText += `\n Project: ${task.project}`;
}
if (task.tags && task.tags.length > 0) {
taskText += `\n Tags: ${task.tags.join(', ')}`;
}
if (task.dueDate) {
const dueDate = new Date(task.dueDate).toLocaleDateString();
taskText += `\n Due: ${dueDate}`;
}
if (task.flagged) {
taskText += `\n [Flagged]`;
}
if (task.estimatedMinutes) {
const hours = Math.floor(task.estimatedMinutes / 60);
const minutes = task.estimatedMinutes % 60;
if (hours > 0) {
taskText += `\n Estimate: ${hours}h${minutes > 0 ? ` ${minutes}m` : ''}`;
} else {
taskText += `\n Estimate: ${minutes}m`;
}
}
if (task.note && task.note.trim()) {
const notePreview = task.note.trim().substring(0, 100);
taskText += `\n Note: ${notePreview}${task.note.length > 100 ? '...' : ''}`;
}
return taskText;
}).join('\n\n');
const header = `**Perspective Tasks: ${perspectiveName}** (${displayTasks.length} task${displayTasks.length === 1 ? '' : 's'})\n\n`;
const footer = totalCount > displayTasks.length ? `\n\nNote: Found ${totalCount} tasks, showing ${displayTasks.length}` : '';
return header + taskList + footer;
}
