@fitlab-ai/agent-infra 0.9.4 → 0.9.5

package/dist/lib/task/create-service.js

@@ -0,0 +1,137 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { syncPlatformComment } from '../platform/issue-comments.js';
+import { createPlatformIssue, syncPlatformIssue } from '../platform/issues.js';
+import { VERSION } from '../version.js';
+import { applyWorkflowWarningIntent } from './workflow-warning-intents.js';
+import { createLocalTask } from './create.js';
+import { verifyTaskEvent } from './verification.js';
+const DEFAULT_DEPENDENCIES = {
+    createIssue: createPlatformIssue,
+    syncIssue: syncPlatformIssue,
+    syncComment: syncPlatformComment,
+    addWarning: applyWorkflowWarningIntent
+};
+function verifyCreatedTask(repoRoot, taskId) {
+    const verification = verifyTaskEvent({ taskRef: taskId, event: 'create-task.completed' }, { repoRoot });
+    if (verification.status === 'pass') {
+        return { operation: { name: 'task:verify', status: 'pass', reasonCode: null }, error: null };
+    }
+    const blocked = verification.status === 'blocked';
+    return {
+        operation: {
+            name: 'task:verify', status: verification.status,
+            reasonCode: verification.error?.code ?? 'TASK_CREATE_VERIFICATION_FAILED'
+        },
+        error: {
+            code: verification.error?.code ?? 'TASK_CREATE_VERIFICATION_FAILED',
+            message: `Created task did not pass the ${verification.event} gate`,
+            retryable: blocked
+        }
+    };
+}
+function platformOperations(prefix, operations) {
+    return operations.map((operation) => ({
+        name: `${prefix}:${operation.name}`,
+        status: operation.status,
+        reasonCode: operation.reasonCode ?? null
+    }));
+}
+function issueFromTask(repoRoot, taskId) {
+    const content = fs.readFileSync(path.join(repoRoot, '.agents', 'workspace', 'active', taskId, 'task.md'), 'utf8');
+    const match = /^issue_number:\s*(\d+)\s*$/m.exec(content);
+    return match ? { number: Number(match[1]), url: '' } : null;
+}
+function createTask(value, options) {
+    const dependencies = { ...DEFAULT_DEPENDENCIES, ...options.dependencies };
+    let candidate;
+    let local;
+    try {
+        candidate = value;
+        local = createLocalTask(candidate, {
+            repoRoot: options.repoRoot,
+            agentInfraVersion: options.agentInfraVersion ?? VERSION
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const code = /^([A-Z][A-Z0-9_]+)/.exec(message)?.[1] ?? 'TASK_CREATE_FAILED';
+        return {
+            status: 'failed', changed: false, task: { id: null, shortId: null }, issue: null,
+            operations: [], warnings: [], error: { code, message, retryable: code === 'TASK_CREATE_LOCK_TIMEOUT' }
+        };
+    }
+    const operations = [{
+            name: 'task:local', status: local.status, reasonCode: null
+        }];
+    let issue = issueFromTask(options.repoRoot, local.task.id);
+    const created = dependencies.createIssue(local.task.id, { cwd: options.repoRoot, agent: candidate.agent });
+    operations.push(...platformOperations('platform-create', created.operations));
+    if (created.issue)
+        issue = { number: created.issue.number, url: created.issue.url };
+    let platformFailure = created.status === 'failed' || created.status === 'blocked' ? created : null;
+    if (!platformFailure && (created.task.issueNumber || issue)) {
+        const synced = dependencies.syncIssue(local.task.id, {
+            cwd: options.repoRoot,
+            agent: candidate.agent,
+            status: 'waiting-for-triage',
+            assignees: 'current',
+            milestone: 'initial',
+            issueType: true,
+            fields: true
+        });
+        operations.push(...platformOperations('platform-sync', synced.operations));
+        if (synced.issue)
+            issue = { number: synced.issue.number, url: synced.issue.url };
+        if (synced.status === 'failed' || synced.status === 'blocked')
+            platformFailure = synced;
+        if (!platformFailure) {
+            const commented = dependencies.syncComment(local.task.id, { cwd: options.repoRoot, kind: 'task', agent: candidate.agent });
+            operations.push(...platformOperations('platform-comment', commented.operations));
+            if (commented.status === 'failed' || commented.status === 'blocked')
+                platformFailure = commented;
+        }
+    }
+    if (platformFailure) {
+        const error = platformFailure.error ?? { code: 'ISSUE_CREATE_FAILED', message: 'Platform operation failed', retryable: false };
+        dependencies.addWarning({
+            kind: 'add', taskRef: local.task.id, step: 'create-task', severity: 'ACTION_REQUIRED',
+            code: 'ISSUE_CREATE_FAILED', target: 'issue', message: `${error.code}: ${error.message}`,
+            action: 'Fix platform authentication or connectivity, then retry Issue creation for this task.'
+        }, { repoRoot: options.repoRoot });
+        const verified = verifyCreatedTask(options.repoRoot, local.task.id);
+        operations.push(verified.operation);
+        if (verified.error)
+            return {
+                status: verified.error.retryable ? 'blocked' : 'failed', changed: local.changed,
+                task: local.task, issue, operations, warnings: [], error: verified.error
+            };
+        return {
+            status: platformFailure.status === 'blocked' ? 'blocked' : 'degraded',
+            changed: local.changed,
+            task: local.task,
+            issue,
+            operations,
+            warnings: [{ code: 'ISSUE_CREATE_FAILED', severity: 'ACTION_REQUIRED', action: 'Retry Issue creation after fixing the platform failure.' }],
+            error
+        };
+    }
+    const verified = verifyCreatedTask(options.repoRoot, local.task.id);
+    operations.push(verified.operation);
+    if (verified.error)
+        return {
+            status: verified.error.retryable ? 'blocked' : 'failed', changed: local.changed,
+            task: local.task, issue, operations, warnings: [], error: verified.error
+        };
+    return {
+        status: local.status,
+        changed: local.changed,
+        task: local.task,
+        issue,
+        operations,
+        warnings: [],
+        error: null
+    };
+}
+export { createTask };
+//# sourceMappingURL=create-service.js.map

package/dist/lib/task/create.js

@@ -0,0 +1,333 @@
+import { createHash, randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadShortIdByTaskId, mutateShortIdRegistry } from './short-id.js';
+import { TaskExecutionLockError, withTaskExecutionLock } from './task-execution-lock.js';
+const AGENTS = ['claude', 'codex', 'antigravity', 'opencode', 'cursor'];
+const TYPES = ['feature', 'bugfix', 'refactor', 'docs', 'chore'];
+const PRIORITIES = ['Urgent', 'High', 'Medium', 'Low'];
+const EFFORTS = ['High', 'Medium', 'Low'];
+const TASK_INPUT_KEYS = [
+    'sources', 'facts', 'constraints', 'decisions', 'alternatives',
+    'acceptanceCriteria', 'openQuestions'
+];
+function payloadError(message) {
+    throw new Error(`TASK_CREATE_PAYLOAD_INVALID: ${message}`);
+}
+function exactKeys(value, expected, label) {
+    const actual = Object.keys(value).sort();
+    const wanted = [...expected].sort();
+    if (actual.length !== wanted.length || actual.some((key, index) => key !== wanted[index])) {
+        payloadError(`${label} has unknown or missing fields`);
+    }
+}
+function cleanString(value, label, maxBytes, oneLine = false) {
+    if (typeof value !== 'string' || value.length === 0 || Buffer.byteLength(value, 'utf8') > maxBytes) {
+        payloadError(`${label} must be a non-empty string within ${maxBytes} bytes`);
+    }
+    if (/\0|[\u0001-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(value) || (oneLine && /[\r\n]/u.test(value))) {
+        payloadError(`${label} contains unsupported control characters`);
+    }
+    return value;
+}
+function enumValue(value, allowed, label) {
+    if (typeof value !== 'string' || !allowed.includes(value))
+        payloadError(`${label} is invalid`);
+    return value;
+}
+function validateTaskCreateCandidate(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        payloadError('candidate must be an object');
+    const candidate = value;
+    exactKeys(candidate, [
+        'version', 'idempotencyKey', 'agent', 'title', 'type', 'branchSlug',
+        'priority', 'effort', 'description', 'taskInput'
+    ], 'candidate');
+    if (candidate.version !== 1)
+        payloadError('version must be 1');
+    const idempotencyKey = cleanString(candidate.idempotencyKey, 'idempotencyKey', 64, true);
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(idempotencyKey)) {
+        payloadError('idempotencyKey must be a UUID v4');
+    }
+    const title = cleanString(candidate.title, 'title', 400, true);
+    if ([...title].length > 100)
+        payloadError('title exceeds 100 Unicode code points');
+    const branchSlug = cleanString(candidate.branchSlug, 'branchSlug', 64, true);
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)+$/.test(branchSlug) || branchSlug.length < 3) {
+        payloadError('branchSlug must be lowercase ASCII kebab-case with length 3-64');
+    }
+    const description = cleanString(candidate.description, 'description', 8 * 1024);
+    if (!candidate.taskInput || typeof candidate.taskInput !== 'object' || Array.isArray(candidate.taskInput)) {
+        payloadError('taskInput must be an object');
+    }
+    const rawInput = candidate.taskInput;
+    exactKeys(rawInput, TASK_INPUT_KEYS, 'taskInput');
+    const taskInput = Object.fromEntries(TASK_INPUT_KEYS.map((key) => {
+        const list = rawInput[key];
+        if (!Array.isArray(list) || list.length > 50)
+            payloadError(`taskInput.${key} must contain at most 50 items`);
+        return [key, list.map((item, index) => cleanString(item, `taskInput.${key}[${index}]`, 2 * 1024, true))];
+    }));
+    return {
+        version: 1,
+        idempotencyKey,
+        agent: enumValue(candidate.agent, AGENTS, 'agent'),
+        title,
+        type: enumValue(candidate.type, TYPES, 'type'),
+        branchSlug,
+        priority: enumValue(candidate.priority, PRIORITIES, 'priority'),
+        effort: enumValue(candidate.effort, EFFORTS, 'effort'),
+        description,
+        taskInput
+    };
+}
+function canonicalTaskCreateCandidate(candidate) {
+    const valid = validateTaskCreateCandidate(candidate);
+    return JSON.stringify({
+        version: valid.version,
+        idempotencyKey: valid.idempotencyKey,
+        agent: valid.agent,
+        title: valid.title,
+        type: valid.type,
+        branchSlug: valid.branchSlug,
+        priority: valid.priority,
+        effort: valid.effort,
+        description: valid.description,
+        taskInput: Object.fromEntries(TASK_INPUT_KEYS.map((key) => [key, valid.taskInput[key]]))
+    });
+}
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function formatTimestamp(date) {
+    const pad = (value) => String(value).padStart(2, '0');
+    const offsetMinutes = -date.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? '+' : '-';
+    const offset = Math.abs(offsetMinutes);
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}${sign}${pad(Math.floor(offset / 60))}:${pad(offset % 60)}`;
+}
+function taskIdFor(date) {
+    const pad = (value) => String(value).padStart(2, '0');
+    return `TASK-${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`;
+}
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+function markdownBlock(value) {
+    return value.split(/\r?\n/).map((line) => /^(?:#{1,6}\s|```)/.test(line) ? `\\${line}` : line).join('\n');
+}
+function renderList(items) {
+    return items.map((item) => `- ${item}`).join('\n');
+}
+function replaceEmptySubsection(content, heading, items) {
+    if (items.length === 0)
+        return content;
+    return content.replace(`${heading}\n`, `${heading}\n\n${renderList(items)}\n`);
+}
+function renderTask(params) {
+    const { candidate } = params;
+    const workflow = candidate.type === 'bugfix' ? 'bug-fix' : candidate.type === 'refactor' ? 'refactoring' : 'feature-development';
+    const branch = `${params.project}-${candidate.type}-${candidate.branchSlug}`;
+    const frontmatter = [
+        '---',
+        `id: ${params.taskId}`,
+        `type: ${candidate.type}`,
+        `branch: ${branch}`,
+        `workflow: ${workflow}`,
+        'status: active',
+        `created_at: ${params.timestamp}`,
+        `updated_at: ${params.timestamp}`,
+        `agent_infra_version: ${params.agentInfraVersion}`,
+        `priority: ${candidate.priority}`,
+        `effort: ${candidate.effort}`,
+        'start_date:',
+        'target_date:',
+        'current_step: requirement-analysis',
+        `assigned_to: ${candidate.agent}`,
+        'pr_status: pending',
+        `task_create_key_digest: ${params.keyDigest}`,
+        `task_create_candidate_digest: ${params.candidateDigest}`,
+        '---'
+    ].join('\n');
+    let content = params.template.replace(/^---\n[\s\S]*?\n---/, frontmatter);
+    content = content.replace('# 任务：[标题]', `# 任务：${candidate.title}`);
+    content = content.replace('[清晰简洁地描述任务。]', markdownBlock(candidate.description));
+    const sections = [
+        ['### 来源', 'sources'], ['### 已确认事实与证据', 'facts'], ['### 约束', 'constraints'],
+        ['### 已确认决策', 'decisions'], ['### 候选与否决方案', 'alternatives'],
+        ['### 验收标准', 'acceptanceCriteria'], ['### 未决事项', 'openQuestions']
+    ];
+    for (const [heading, key] of sections)
+        content = replaceEmptySubsection(content, heading, candidate.taskInput[key]);
+    content = content.replace('- **关联 Issue**：#XXX', '- **关联 Issue**：N/A');
+    content = content.replace('- **关联 PR**：#XXX', '- **关联 PR**：N/A');
+    content = content.replace('- **分支**：`feature/xxx`', `- **分支**：\`${branch}\``);
+    const log = [
+        `- ${params.timestamp} — **Create Task [started]** by ${candidate.agent} — started`,
+        `- ${params.timestamp} — **Create Task** by ${candidate.agent} — Task created from structured candidate`
+    ].join('\n');
+    content = content.replace('\n## 完成检查清单', `\n${log}\n\n## 完成检查清单`);
+    return `${content.trimEnd()}\n`;
+}
+function readProject(repoRoot) {
+    const config = JSON.parse(fs.readFileSync(path.join(repoRoot, '.agents', '.airc.json'), 'utf8'));
+    if (typeof config.project !== 'string' || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(config.project)) {
+        throw new Error('TASK_CREATE_CONFIG_INVALID: project is missing or invalid');
+    }
+    return config.project;
+}
+function assertRealDirectory(directory, code) {
+    const stat = fs.lstatSync(directory);
+    if (!stat.isDirectory() || stat.isSymbolicLink())
+        throw new Error(code);
+}
+function withCreateLock(repoRoot, workspaceRoot, operation) {
+    const lockRoot = path.join(workspaceRoot, '.task-create.lock');
+    fs.mkdirSync(lockRoot, { recursive: true, mode: 0o700 });
+    assertRealDirectory(lockRoot, 'TASK_CREATE_LOCK_FAILED');
+    let callbackError;
+    try {
+        return withTaskExecutionLock(repoRoot, 'task-create', 'task-create', () => {
+            try {
+                return operation();
+            }
+            catch (error) {
+                callbackError = error;
+                throw error;
+            }
+        }, { lockRoot });
+    }
+    catch (error) {
+        if (callbackError !== undefined)
+            throw callbackError;
+        if (error instanceof TaskExecutionLockError && error.code === 'ORCHESTRATION_LOCK_BUSY') {
+            throw new Error('TASK_CREATE_LOCK_TIMEOUT');
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`TASK_CREATE_LOCK_FAILED: ${message}`);
+    }
+}
+function writeReceipt(receiptPath, value) {
+    const temporary = `${receiptPath}.tmp.${process.pid}.${randomUUID()}`;
+    fs.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { flag: 'wx', mode: 0o600 });
+    try {
+        fs.renameSync(temporary, receiptPath);
+    }
+    catch (error) {
+        try {
+            fs.unlinkSync(temporary);
+        }
+        catch { /* best effort */ }
+        throw error;
+    }
+}
+function recoverPublishedTask(activeRoot, repoRoot, keyDigest, candidateDigest) {
+    for (const name of fs.readdirSync(activeRoot)) {
+        if (!/^TASK-\d{8}-\d{6}$/.test(name))
+            continue;
+        const taskDir = path.join(activeRoot, name);
+        const stat = fs.lstatSync(taskDir);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            continue;
+        const taskMd = path.join(taskDir, 'task.md');
+        if (!fs.existsSync(taskMd))
+            continue;
+        const taskStat = fs.lstatSync(taskMd);
+        if (!taskStat.isFile() || taskStat.isSymbolicLink())
+            continue;
+        const content = fs.readFileSync(taskMd, 'utf8');
+        if (!content.includes(`task_create_key_digest: ${keyDigest}`))
+            continue;
+        if (!content.includes(`task_create_candidate_digest: ${candidateDigest}`)) {
+            throw new Error('TASK_CREATE_IDEMPOTENCY_CONFLICT');
+        }
+        const shortId = loadShortIdByTaskId(repoRoot).get(name)
+            ?? mutateShortIdRegistry(repoRoot, name, 'alloc').shortId;
+        if (!shortId)
+            throw new Error('TASK_CREATE_RECEIPT_INVALID');
+        return { taskId: name, shortId };
+    }
+    return null;
+}
+function createLocalTask(value, options) {
+    const candidate = validateTaskCreateCandidate(value);
+    const repoRoot = fs.realpathSync.native(options.repoRoot);
+    const workspaceRoot = path.join(repoRoot, '.agents', 'workspace');
+    const activeRoot = path.join(workspaceRoot, 'active');
+    assertRealDirectory(workspaceRoot, 'TASK_CREATE_WORKSPACE_INVALID');
+    assertRealDirectory(activeRoot, 'TASK_CREATE_WORKSPACE_INVALID');
+    const project = readProject(repoRoot);
+    const canonical = canonicalTaskCreateCandidate(candidate);
+    const candidateDigest = sha256(canonical);
+    const keyDigest = sha256(candidate.idempotencyKey);
+    const receipts = path.join(workspaceRoot, '.task-create');
+    return withCreateLock(repoRoot, workspaceRoot, () => {
+        if (fs.existsSync(receipts))
+            assertRealDirectory(receipts, 'TASK_CREATE_RECEIPT_INVALID');
+        else
+            fs.mkdirSync(receipts, { mode: 0o700 });
+        const receiptPath = path.join(receipts, `${keyDigest}.json`);
+        if (fs.existsSync(receiptPath)) {
+            const stat = fs.lstatSync(receiptPath);
+            if (!stat.isFile() || stat.isSymbolicLink())
+                throw new Error('TASK_CREATE_RECEIPT_INVALID');
+            const receipt = JSON.parse(fs.readFileSync(receiptPath, 'utf8'));
+            if (receipt.candidateDigest !== candidateDigest)
+                throw new Error('TASK_CREATE_IDEMPOTENCY_CONFLICT');
+            if (!receipt.taskId || !receipt.shortId || !fs.existsSync(path.join(activeRoot, receipt.taskId, 'task.md'))) {
+                throw new Error('TASK_CREATE_RECEIPT_INVALID');
+            }
+            return { status: 'no-op', changed: false, task: { id: receipt.taskId, shortId: receipt.shortId } };
+        }
+        const recovered = recoverPublishedTask(activeRoot, repoRoot, keyDigest, candidateDigest);
+        if (recovered) {
+            writeReceipt(receiptPath, {
+                version: 1, candidateDigest, taskId: recovered.taskId, shortId: recovered.shortId, status: 'recovered'
+            });
+            return { status: 'no-op', changed: false, task: { id: recovered.taskId, shortId: recovered.shortId } };
+        }
+        const base = options.now?.() ?? new Date();
+        let taskDate = new Date(base.getTime());
+        let taskId = taskIdFor(taskDate);
+        while (fs.existsSync(path.join(activeRoot, taskId))) {
+            taskDate = new Date(taskDate.getTime() + 1_000);
+            taskId = taskIdFor(taskDate);
+        }
+        const timestamp = formatTimestamp(base);
+        const templatePath = path.join(repoRoot, '.agents', 'templates', 'task.md');
+        const templateStat = fs.lstatSync(templatePath);
+        if (!templateStat.isFile() || templateStat.isSymbolicLink())
+            throw new Error('TASK_CREATE_TEMPLATE_INVALID');
+        const rendered = renderTask({
+            template: fs.readFileSync(templatePath, 'utf8'), candidate, taskId, project, timestamp,
+            agentInfraVersion: options.agentInfraVersion ?? 'unknown', keyDigest, candidateDigest
+        });
+        const temporary = path.join(workspaceRoot, `.task-create.tmp.${process.pid}.${randomUUID()}`);
+        fs.mkdirSync(temporary, { mode: 0o700 });
+        fs.writeFileSync(path.join(temporary, 'task.md'), rendered, { flag: 'wx', mode: 0o600 });
+        const destination = path.join(activeRoot, taskId);
+        fs.renameSync(temporary, destination);
+        let shortId;
+        try {
+            const allocated = mutateShortIdRegistry(repoRoot, taskId, 'alloc');
+            if (!allocated.shortId)
+                throw new Error('TASK_CREATE_SHORT_ID_FAILED');
+            shortId = allocated.shortId;
+        }
+        catch (error) {
+            fs.rmSync(destination, { recursive: true, force: true });
+            throw error;
+        }
+        try {
+            writeReceipt(receiptPath, { version: 1, candidateDigest, taskId, shortId, status: 'created' });
+        }
+        catch (error) {
+            mutateShortIdRegistry(repoRoot, taskId, 'release');
+            fs.rmSync(destination, { recursive: true, force: true });
+            throw error;
+        }
+        return { status: 'applied', changed: true, task: { id: taskId, shortId } };
+    });
+}
+export { canonicalTaskCreateCandidate, createLocalTask, validateTaskCreateCandidate };
+//# sourceMappingURL=create.js.map