import type { TaskEntity, NextActionSuggestion } from "./types.js";
/** Workspace kit phase pointers for ordering the ready queue and suggested next. */
export type WorkspacePhaseFocus = {
    currentKitPhase: string | null;
    nextKitPhase: string | null;
};
/**
 * Lower rank = sooner in the ready queue. Current phase, then next phase, then later phases, then past/unphased.
 */
export declare function workspacePhaseFocusRank(task: Pick<TaskEntity, "phaseKey" | "phase">, focus: WorkspacePhaseFocus | undefined): number;
export declare function isImprovementLikeTask(t: TaskEntity): boolean;
/** Canonical queue partition for filtered next-actions (`metadata.queueNamespace`); missing → `"default"`. */
export declare function getTaskQueueNamespace(task: TaskEntity): string;
export declare function filterTasksByQueueNamespace(tasks: TaskEntity[], queueNamespace?: string): TaskEntity[];
export type GetNextActionsOptions = {
    /** When set, only tasks in this namespace participate (see `getTaskQueueNamespace`). */
    queueNamespace?: string;
    /** When set, ready ordering and `suggestedNext` prefer current kit phase, then next, then later phases. */
    workspacePhaseFocus?: WorkspacePhaseFocus;
};
export declare function getNextActions(tasks: TaskEntity[], options?: GetNextActionsOptions): NextActionSuggestion;
