takt/src/features/tasks/execute/taskExecution.ts

303 lines
9.6 KiB
TypeScript

/**
* Task execution logic
*/
import { loadPieceByIdentifier, isPiecePath, loadConfig } from '../../../infra/config/index.js';
import { TaskRunner, type TaskInfo } from '../../../infra/task/index.js';
import {
header,
info,
error,
status,
blankLine,
} from '../../../shared/ui/index.js';
import { createLogger, getErrorMessage, getSlackWebhookUrl, notifyError, notifySuccess, sendSlackNotification } from '../../../shared/utils/index.js';
import { getLabel } from '../../../shared/i18n/index.js';
import { executePiece } from './pieceExecution.js';
import { DEFAULT_PIECE_NAME } from '../../../shared/constants.js';
import type { TaskExecutionOptions, ExecuteTaskOptions, PieceExecutionResult } from './types.js';
import { fetchIssue, checkGhCli } from '../../../infra/github/index.js';
import { runWithWorkerPool } from './parallelExecution.js';
import { resolveTaskExecution } from './resolveTask.js';
import { postExecutionFlow } from './postExecution.js';
import { buildTaskResult, persistTaskError, persistTaskResult } from './taskResultHandler.js';
export type { TaskExecutionOptions, ExecuteTaskOptions };
const log = createLogger('task');
/**
* Resolve a GitHub issue from task data's issue number.
* Returns issue array for buildPrBody, or undefined if no issue or gh CLI unavailable.
*/
function resolveTaskIssue(issueNumber: number | undefined): ReturnType<typeof fetchIssue>[] | undefined {
if (issueNumber === undefined) {
return undefined;
}
const ghStatus = checkGhCli();
if (!ghStatus.available) {
log.info('gh CLI unavailable, skipping issue resolution for PR body', { issueNumber });
return undefined;
}
try {
const issue = fetchIssue(issueNumber);
return [issue];
} catch (e) {
log.info('Failed to fetch issue for PR body, continuing without issue info', { issueNumber, error: getErrorMessage(e) });
return undefined;
}
}
async function executeTaskWithResult(options: ExecuteTaskOptions): Promise<PieceExecutionResult> {
const {
task,
cwd,
pieceIdentifier,
projectCwd,
agentOverrides,
interactiveUserInput,
interactiveMetadata,
startMovement,
retryNote,
reportDirName,
abortSignal,
taskPrefix,
taskColorIndex,
taskDisplayLabel,
} = options;
const pieceConfig = loadPieceByIdentifier(pieceIdentifier, projectCwd);
if (!pieceConfig) {
if (isPiecePath(pieceIdentifier)) {
error(`Piece file not found: ${pieceIdentifier}`);
return { success: false, reason: `Piece file not found: ${pieceIdentifier}` };
} else {
error(`Piece "${pieceIdentifier}" not found.`);
info('Available pieces are in ~/.takt/pieces/ or .takt/pieces/');
info('Use "takt switch" to select a piece.');
return { success: false, reason: `Piece "${pieceIdentifier}" not found.` };
}
}
log.debug('Running piece', {
name: pieceConfig.name,
movements: pieceConfig.movements.map((s: { name: string }) => s.name),
});
const config = loadConfig(projectCwd);
const globalConfig = config.global;
const projectConfig = config.project;
return await executePiece(pieceConfig, task, cwd, {
projectCwd,
language: globalConfig.language,
provider: agentOverrides?.provider,
projectProvider: projectConfig.provider,
globalProvider: globalConfig.provider,
model: agentOverrides?.model,
projectProviderOptions: projectConfig.providerOptions,
globalProviderOptions: globalConfig.providerOptions,
personaProviders: globalConfig.personaProviders,
projectProviderProfiles: projectConfig.providerProfiles,
globalProviderProfiles: globalConfig.providerProfiles,
interactiveUserInput,
interactiveMetadata,
startMovement,
retryNote,
reportDirName,
abortSignal,
taskPrefix,
taskColorIndex,
taskDisplayLabel,
});
}
/**
* Execute a single task with piece.
*/
export async function executeTask(options: ExecuteTaskOptions): Promise<boolean> {
const result = await executeTaskWithResult(options);
return result.success;
}
/**
* Execute a task: resolve clone → run piece → auto-commit+push → remove clone → record completion.
*
* Shared by runAllTasks() and watchTasks() to avoid duplicated
* resolve → execute → autoCommit → complete logic.
*
* @returns true if the task succeeded
*/
export async function executeAndCompleteTask(
task: TaskInfo,
taskRunner: TaskRunner,
cwd: string,
pieceName: string,
options?: TaskExecutionOptions,
parallelOptions?: { abortSignal?: AbortSignal; taskPrefix?: string; taskColorIndex?: number; taskDisplayLabel?: string },
): Promise<boolean> {
const startedAt = new Date().toISOString();
const taskAbortController = new AbortController();
const externalAbortSignal = parallelOptions?.abortSignal;
const taskAbortSignal = externalAbortSignal ? taskAbortController.signal : undefined;
const onExternalAbort = (): void => {
taskAbortController.abort();
};
if (externalAbortSignal) {
if (externalAbortSignal.aborted) {
taskAbortController.abort();
} else {
externalAbortSignal.addEventListener('abort', onExternalAbort, { once: true });
}
}
try {
const {
execCwd,
execPiece,
isWorktree,
taskPrompt,
reportDirName,
branch,
worktreePath,
baseBranch,
startMovement,
retryNote,
autoPr,
issueNumber,
} = await resolveTaskExecution(task, cwd, pieceName, taskAbortSignal);
// cwd is always the project root; pass it as projectCwd so reports/sessions go there
const taskRunResult = await executeTaskWithResult({
task: taskPrompt ?? task.content,
cwd: execCwd,
pieceIdentifier: execPiece,
projectCwd: cwd,
agentOverrides: options,
startMovement,
retryNote,
reportDirName,
abortSignal: taskAbortSignal,
taskPrefix: parallelOptions?.taskPrefix,
taskColorIndex: parallelOptions?.taskColorIndex,
taskDisplayLabel: parallelOptions?.taskDisplayLabel,
});
const taskSuccess = taskRunResult.success;
const completedAt = new Date().toISOString();
if (taskSuccess && isWorktree) {
const issues = resolveTaskIssue(issueNumber);
await postExecutionFlow({
execCwd,
projectCwd: cwd,
task: task.name,
branch,
baseBranch,
shouldCreatePr: autoPr,
pieceIdentifier: execPiece,
issues,
});
}
const taskResult = buildTaskResult({
task,
runResult: taskRunResult,
startedAt,
completedAt,
branch,
worktreePath,
});
persistTaskResult(taskRunner, taskResult);
return taskSuccess;
} catch (err) {
const completedAt = new Date().toISOString();
persistTaskError(taskRunner, task, startedAt, completedAt, err);
return false;
} finally {
if (externalAbortSignal) {
externalAbortSignal.removeEventListener('abort', onExternalAbort);
}
}
}
/**
* Run all pending tasks from .takt/tasks.yaml
*
* Uses a worker pool for both sequential (concurrency=1) and parallel
* (concurrency>1) execution through the same code path.
*/
export async function runAllTasks(
cwd: string,
pieceName: string = DEFAULT_PIECE_NAME,
options?: TaskExecutionOptions,
): Promise<void> {
const taskRunner = new TaskRunner(cwd);
const { global: globalConfig } = loadConfig(cwd);
const shouldNotifyRunComplete = globalConfig.notificationSound !== false
&& globalConfig.notificationSoundEvents?.runComplete !== false;
const shouldNotifyRunAbort = globalConfig.notificationSound !== false
&& globalConfig.notificationSoundEvents?.runAbort !== false;
const concurrency = globalConfig.concurrency;
const slackWebhookUrl = getSlackWebhookUrl();
const recovered = taskRunner.recoverInterruptedRunningTasks();
if (recovered > 0) {
info(`Recovered ${recovered} interrupted running task(s) to pending.`);
}
const initialTasks = taskRunner.claimNextTasks(concurrency);
if (initialTasks.length === 0) {
info('No pending tasks in .takt/tasks.yaml');
info('Use takt add to append tasks.');
return;
}
header('Running tasks');
if (concurrency > 1) {
info(`Concurrency: ${concurrency}`);
}
try {
const result = await runWithWorkerPool(taskRunner, initialTasks, concurrency, cwd, pieceName, options, globalConfig.taskPollIntervalMs);
const totalCount = result.success + result.fail;
blankLine();
header('Tasks Summary');
status('Total', String(totalCount));
status('Success', String(result.success), result.success === totalCount ? 'green' : undefined);
if (result.fail > 0) {
status('Failed', String(result.fail), 'red');
if (shouldNotifyRunAbort) {
notifyError('TAKT', getLabel('run.notifyAbort', undefined, { failed: String(result.fail) }));
}
if (slackWebhookUrl) {
await sendSlackNotification(slackWebhookUrl, `TAKT Run finished with errors: ${String(result.fail)} failed out of ${String(totalCount)} tasks`);
}
return;
}
if (shouldNotifyRunComplete) {
notifySuccess('TAKT', getLabel('run.notifyComplete', undefined, { total: String(totalCount) }));
}
if (slackWebhookUrl) {
await sendSlackNotification(slackWebhookUrl, `TAKT Run complete: ${String(totalCount)} tasks succeeded`);
}
} catch (e) {
if (shouldNotifyRunAbort) {
notifyError('TAKT', getLabel('run.notifyAbort', undefined, { failed: getErrorMessage(e) }));
}
if (slackWebhookUrl) {
await sendSlackNotification(slackWebhookUrl, `TAKT Run error: ${getErrorMessage(e)}`);
}
throw e;
}
}
// Re-export for backward compatibility with existing consumers
export { resolveTaskExecution } from './resolveTask.js';