@pimzino/agentic-tools-mcp/dist/features/task-management/storage/storage.d.ts

A comprehensive MCP server for task management and agent memories with JSON file storage

import { Project } from '../models/project.js';
import { Task, TaskHierarchy } from '../models/task.js';
import { Subtask } from '../models/subtask.js';
/**
 * Storage interface for the task management system
 * Version 2.0: Updated for unified task model with migration support
 */
export interface Storage {
    getProjects(): Promise<Project[]>;
    getProject(id: string): Promise<Project | null>;
    createProject(project: Project): Promise<Project>;
    updateProject(id: string, updates: Partial<Project>): Promise<Project | null>;
    deleteProject(id: string): Promise<boolean>;
    getTasks(projectId?: string, parentId?: string): Promise<Task[]>;
    getTask(id: string): Promise<Task | null>;
    createTask(task: Task): Promise<Task>;
    updateTask(id: string, updates: Partial<Task>): Promise<Task | null>;
    deleteTask(id: string): Promise<boolean>;
    deleteTasksByProject(projectId: string): Promise<number>;
    deleteTasksByParent(parentId: string): Promise<number>;
    getTaskHierarchy(projectId?: string, parentId?: string): Promise<TaskHierarchy[]>;
    getTaskChildren(taskId: string): Promise<Task[]>;
    getTaskAncestors(taskId: string): Promise<Task[]>;
    moveTask(taskId: string, newParentId?: string): Promise<Task | null>;
    /** @deprecated Use getTasks with parentId instead */
    getSubtasks(taskId?: string, projectId?: string): Promise<Subtask[]>;
    /** @deprecated Use getTask instead */
    getSubtask(id: string): Promise<Subtask | null>;
    /** @deprecated Use createTask instead */
    createSubtask(subtask: Subtask): Promise<Subtask>;
    /** @deprecated Use updateTask instead */
    updateSubtask(id: string, updates: Partial<Subtask>): Promise<Subtask | null>;
    /** @deprecated Use deleteTask instead */
    deleteSubtask(id: string): Promise<boolean>;
    /** @deprecated Use deleteTasksByParent instead */
    deleteSubtasksByTask(taskId: string): Promise<number>;
    /** @deprecated Use deleteTasksByProject instead */
    deleteSubtasksByProject(projectId: string): Promise<number>;
    migrateToUnifiedModel(): Promise<{
        migratedSubtasks: number;
        errors: string[];
    }>;
    getMigrationStatus(): Promise<{
        needsMigration: boolean;
        subtaskCount: number;
        version: string;
    }>;
}
/**
 * Data structure for the storage file
 * Version 2.0: Supports both legacy and unified models during migration
 */
export interface StorageData {
    projects: Project[];
    tasks: Task[];
    /** @deprecated Legacy subtasks, will be migrated to tasks */
    subtasks?: Subtask[];
    /** Migration metadata */
    migration?: {
        version: string;
        migratedAt?: string;
        subtasksMigrated?: number;
    };
}