/**
 * Task service interface for skill scripts.
 * Provides a clean API for task CRUD operations.
 *
 * This is the "rich" task interface used by CLI scripts,
 * with operations like external linking (GitHub, Jira, Linear).
 *
 * Note: Group IDs are no longer used - the git repo itself provides scoping
 * via git-mem (git notes in refs/notes/mem).
 */
/**
 * Backend mode for task operations.
 */
export type TaskMode = 'git-mem';
/**
 * External system link source types.
 */
export type ExternalLinkSource = 'github' | 'jira' | 'linear';
/**
 * Link to an external task management system.
 */
export interface ITaskExternalLink {
    source: ExternalLinkSource;
    id: string;
    url: string;
    syncedAt?: string;
}
/**
 * A task item.
 */
export interface ISkillTask {
    title: string;
    status: string;
    repo: string;
    assignee: string;
    notes?: string;
    tag?: string | null;
    uuid: string;
    created_at: string;
    externalLink?: ITaskExternalLink;
}
/**
 * Result of a task list operation.
 */
export interface ITaskListResult {
    status: 'ok';
    action: 'list';
    tasks: ISkillTask[];
    mode: TaskMode;
}
/**
 * Result of a task add/update operation.
 */
export interface ITaskWriteResult {
    status: 'ok';
    action: 'add' | 'update';
    task: {
        type: 'task';
        title: string;
        status: string;
        repo: string;
        assignee: string;
        notes?: string;
        tag?: string | null;
        externalLink?: ITaskExternalLink;
    };
    result?: unknown;
    message_uuid?: string;
    mode: TaskMode;
}
/**
 * Options for adding or updating a task.
 */
export interface ITaskWriteOptions {
    status?: string;
    repo?: string;
    assignee?: string;
    notes?: string;
    tag?: string | null;
    externalLink?: ITaskExternalLink | null;
}
/**
 * Options for loading tasks with date filtering.
 */
export interface ITaskLoadOptions {
    since?: Date;
    until?: Date;
}
/**
 * Result of a task link operation.
 */
export interface ITaskLinkResult {
    status: 'ok';
    action: 'link' | 'unlink';
    task: {
        title: string;
        uuid: string;
        externalLink?: ITaskExternalLink;
    };
    mode: TaskMode;
}
/**
 * Task service interface for skill scripts.
 *
 * This is the "rich" interface with full CLI capabilities
 * including external system linking.
 *
 * Note: Group IDs are no longer used - the git repo provides scoping.
 */
export interface ISkillTaskService {
    /**
     * List tasks from storage.
     *
     * @param limit - Maximum number of tasks to return
     * @param defaultRepo - Default repo name for tasks without one
     * @param defaultAssignee - Default assignee for tasks without one
     * @param options - Optional date filtering options
     */
    list(limit: number, defaultRepo: string, defaultAssignee: string, options?: ITaskLoadOptions): Promise<ITaskListResult>;
    /**
     * Add a new task.
     *
     * @param title - Task title/description
     * @param options - Additional task options
     */
    add(title: string, options: ITaskWriteOptions): Promise<ITaskWriteResult>;
    /**
     * Update an existing task (creates a new version).
     *
     * @param title - Task title/description
     * @param options - Updated task options
     */
    update(title: string, options: ITaskWriteOptions): Promise<ITaskWriteResult>;
    /**
     * Link a task to an external system (GitHub, Jira, etc.).
     *
     * @param taskUuid - UUID of the task to link
     * @param externalLink - External link details
     */
    link(taskUuid: string, externalLink: ITaskExternalLink): Promise<ITaskLinkResult>;
    /**
     * Unlink a task from its external system.
     *
     * @param taskUuid - UUID of the task to unlink
     */
    unlink(taskUuid: string): Promise<ITaskLinkResult>;
    /**
     * List tasks filtered by external link source.
     *
     * @param source - External link source to filter by (optional, returns all linked if omitted)
     * @param limit - Maximum number of tasks to return
     * @param defaultRepo - Default repo name for tasks without one
     * @param defaultAssignee - Default assignee for tasks without one
     */
    listLinked(source: ExternalLinkSource | undefined, limit: number, defaultRepo: string, defaultAssignee: string): Promise<ITaskListResult>;
}
//# sourceMappingURL=ISkillTaskService.d.ts.map