@crewx/workflow 0.3.22-rc.14 → 0.3.22-rc.140

package/dist/src/failure.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStableCauseMessage = getStableCauseMessage;
+exports.createWorkflowFailureError = createWorkflowFailureError;
+exports.getWorkflowFailureCode = getWorkflowFailureCode;
+exports.classifyWorkflowFailure = classifyWorkflowFailure;
+exports.buildNodeFailure = buildNodeFailure;
+exports.buildEvidencePreview = buildEvidencePreview;
+exports.sanitizeLocalRunError = sanitizeLocalRunError;
+exports.readNodeAttempt = readNodeAttempt;
+const sdk_1 = require("@crewx/sdk");
+const STABLE_CAUSE_MESSAGES = {
+    CLI_UNRESOLVABLE: 'CrewX CLI executable could not be resolved.',
+    SPAWN_FAILED: 'The node process could not be started.',
+    NODE_TIMEOUT: 'The node execution exceeded its timeout.',
+    NODE_EXIT_NONZERO: 'The node process exited with a non-zero status.',
+    OUTPUT_INVALID: 'The node output did not match the required format.',
+    CONFIG_INVALID: 'The workflow node configuration is invalid.',
+    INTERRUPTED: 'The node execution was interrupted.',
+    CANCELLED: 'The workflow run was cancelled.',
+    UNKNOWN: 'The node execution failed.',
+};
+const PERSISTED_FAILURE_CODES = new Set(Object.keys(STABLE_CAUSE_MESSAGES));
+function getStableCauseMessage(code) {
+    return STABLE_CAUSE_MESSAGES[code];
+}
+function createWorkflowFailureError(code, message) {
+    const error = new Error(message);
+    error.code = code;
+    return error;
+}
+function getWorkflowFailureCode(error) {
+    if (!error || typeof error !== 'object')
+        return undefined;
+    const code = error.code;
+    return typeof code === 'string' && PERSISTED_FAILURE_CODES.has(code)
+        ? code
+        : undefined;
+}
+function classifyWorkflowFailure(input) {
+    const typedCode = input.errorCode;
+    if (typedCode === 'CLI_UNRESOLVABLE')
+        return 'CLI_UNRESOLVABLE';
+    if (typedCode === 'CONFIG_INVALID')
+        return 'CONFIG_INVALID';
+    if (typedCode === 'OUTPUT_INVALID')
+        return 'OUTPUT_INVALID';
+    if (typedCode === 'CANCELLED')
+        return 'CANCELLED';
+    if (typedCode === 'INTERRUPTED')
+        return 'INTERRUPTED';
+    if (typedCode === 'UNKNOWN')
+        return 'UNKNOWN';
+    const processResult = input.process;
+    if (!processResult)
+        return 'UNKNOWN';
+    if (processResult.errorOrigin === 'spawn')
+        return 'SPAWN_FAILED';
+    if (processResult.timedOut)
+        return 'NODE_TIMEOUT';
+    if (processResult.signal !== null)
+        return 'INTERRUPTED';
+    if (processResult.errorOrigin === 'post_spawn' || processResult.errorOrigin === 'stdin') {
+        return 'UNKNOWN';
+    }
+    if (typeof processResult.status === 'number' && processResult.status !== 0) {
+        return 'NODE_EXIT_NONZERO';
+    }
+    return 'UNKNOWN';
+}
+function buildNodeFailure(input) {
+    const exitCode = input.causeCode === 'NODE_EXIT_NONZERO' && typeof input.exitCode === 'number'
+        ? input.exitCode
+        : null;
+    const signal = input.causeCode === 'INTERRUPTED' ? input.signal : null;
+    return {
+        failedNode: input.failedNode,
+        attempt: input.attempt,
+        causeCode: input.causeCode,
+        causeMessage: getStableCauseMessage(input.causeCode),
+        exitCode,
+        evidencePreview: buildEvidencePreview({
+            causeCode: input.causeCode,
+            exitCode,
+            signal,
+            errorOrigin: input.errorOrigin,
+            timedOut: input.timedOut ?? false,
+        }),
+        occurredAt: input.occurredAt ?? new Date().toISOString(),
+    };
+}
+function buildEvidencePreview(input) {
+    switch (input.causeCode) {
+        case 'NODE_EXIT_NONZERO':
+            return typeof input.exitCode === 'number' ? `exit code: ${input.exitCode}` : null;
+        case 'NODE_TIMEOUT':
+            return input.timedOut ? 'timeout' : null;
+        case 'SPAWN_FAILED':
+            return input.errorOrigin === 'spawn' ? 'origin: spawn' : null;
+        case 'INTERRUPTED':
+            return input.signal === null ? null : `signal: ${input.signal}`;
+        case 'UNKNOWN':
+            return input.errorOrigin === 'post_spawn' || input.errorOrigin === 'stdin'
+                ? `origin: ${input.errorOrigin}`
+                : null;
+        default:
+            return null;
+    }
+}
+function sanitizeLocalRunError(raw, fallback) {
+    try {
+        return (0, sdk_1.redactTechnicalMessage)(raw) ?? fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+function readNodeAttempt(run, nodeId) {
+    const attempt = run.node_attempts?.[nodeId];
+    return typeof attempt === 'number' && Number.isInteger(attempt) && attempt > 0 ? attempt : 1;
+}
+//# sourceMappingURL=failure.js.map

package/dist/src/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../../src/failure.ts"],"names":[],"mappings":"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"}

package/dist/src/mermaid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/mermaid.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAA0B,MAAM,SAAS,CAAC;AAQpE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASpD;AAkFD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA0EpD"}
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../src/mermaid.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAA0B,MAAM,SAAS,CAAC;AAQpE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASpD;AAoFD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CA0EpD"}

package/dist/src/mermaid.js

@@ -22,6 +22,8 @@ function escapeMermaidLabel(s) {
 function buildLabel(nodeId, node) {
     if (node.type === 'end')
         return 'END';
+    if (node.type === 'error')
+        return 'ERROR';
     let subtitle = '';
     if (node.agent) {
         subtitle = `@${escapeMermaidLabel(node.agent)}`;
@@ -44,7 +46,7 @@ function buildLabel(nodeId, node) {
 }
 function wrapShape(nodeId, label, type) {
     const safe = safeNodeId(nodeId);
-    if (type === 'end') {
+    if (type === 'end' || type === 'error') {
         return `${safe}(("${label}"))`;
     }
     const q = `"\`${label}\`"`;
@@ -68,6 +70,7 @@ function wrapShape(nodeId, label, type) {
 const NODE_STYLES = {
     approval: 'fill:#e0f2fe,stroke:#93c5fd,color:#1e3a5f',
     expression: 'fill:#fef3c7,stroke:#f59e0b,color:#78350f',
+    error: 'fill:#fee2e2,stroke:#f87171,color:#7f1d1d',
 };
 function toMermaid(spec) {
     const lines = ['flowchart TD'];
@@ -84,7 +87,7 @@ function toMermaid(spec) {
         }
         if (node.type === 'branch' && node.branches && !Array.isArray(node.branches)) {
             for (const [condLabel, target] of Object.entries(node.branches)) {
-                const edgeLabel = escapeMermaidLabel(condLabel === 'true' ? '통과' : condLabel === 'false' ? '반려' : condLabel);
+                const edgeLabel = escapeMermaidLabel(condLabel === 'true' ? 'Approve' : condLabel === 'false' ? 'Reject' : condLabel);
                 lines.push(`  ${src} -->|${edgeLabel}| ${safeNodeId(target)}`);
             }
         }
@@ -103,10 +106,10 @@ function toMermaid(spec) {
         }
         if (node.type === 'approval') {
             if (node.on_approve) {
-                lines.push(`  ${src} -->|${escapeMermaidLabel('승인')}| ${safeNodeId(node.on_approve)}`);
+                lines.push(`  ${src} -->|${escapeMermaidLabel('Approve')}| ${safeNodeId(node.on_approve)}`);
             }
             if (node.on_reject) {
-                lines.push(`  ${src} -->|${escapeMermaidLabel('반려')}| ${safeNodeId(node.on_reject)}`);
+                lines.push(`  ${src} -->|${escapeMermaidLabel('Reject')}| ${safeNodeId(node.on_reject)}`);
             }
         }
     }

package/dist/src/mermaid.js.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/mermaid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/mermaid.ts"],"names":[],"mappings":"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"}

package/dist/src/parent-task-sync.d.ts

@@ -0,0 +1,120 @@
+import type { RunExecution } from './types.js';
+export type WorkflowParentTaskStatus = 'pending' | 'running' | 'success' | 'failed';
+export type WorkflowParentTaskKind = 'workflow_card' | 'workflow_ui_instance';
+export interface WorkflowParentTaskLookup {
+    workspaceId: string;
+    workflowRunId: string;
+    kind: WorkflowParentTaskKind;
+}
+export interface WorkflowParentLifecycle {
+    status: WorkflowParentTaskStatus;
+    error: string | null;
+    completedAt: string | null;
+    durationMs: number | null;
+}
+export interface WorkflowParentLifecycleSnapshot {
+    status: string;
+    error: string | null;
+    completedAt: string | null;
+    durationMs: number | null;
+}
+export interface WorkflowParentLifecycleChange {
+    id: string;
+    kind: WorkflowParentTaskKind;
+    before: WorkflowParentLifecycleSnapshot;
+    after: WorkflowParentLifecycle;
+    reason: string;
+}
+export interface WorkflowParentTaskRow {
+    id: string;
+    agent_id: string;
+    thread_id: string | null;
+    workspace_id: string | null;
+    platform: string | null;
+    status: string;
+    error: string | null;
+    completed_at: string | null;
+    duration_ms: number | null;
+    started_at: string;
+    metadata: string | null;
+}
+export interface WorkflowParentTaskRepository {
+    findRunningWorkflowParentTasks(): WorkflowParentTaskRow[];
+    updateTaskLifecycle(opts: {
+        id: string;
+        status: WorkflowParentTaskStatus;
+        error: string | null;
+        completedAt: string | null;
+        durationMs: number | null;
+        workspaceId: string;
+    }): void;
+}
+export interface WorkflowParentPersistTaskRepository {
+    findWorkflowParentTask(opts: WorkflowParentTaskLookup): WorkflowParentTaskRow | undefined;
+    updateTaskLifecycle: WorkflowParentTaskRepository['updateTaskLifecycle'];
+}
+export interface SyncWorkflowParentTaskLifecycleOptions {
+    taskRepo: Pick<WorkflowParentPersistTaskRepository, 'updateTaskLifecycle'>;
+    row: WorkflowParentTaskRow;
+    run: RunExecution;
+    workspaceId: string;
+    kind: WorkflowParentTaskKind;
+    snapshotUpdatedAt?: string | null;
+}
+export interface WorkflowParentPersistSinkOptions {
+    taskRepo: WorkflowParentPersistTaskRepository;
+    workspaceId: string;
+    parentKinds?: readonly WorkflowParentTaskKind[];
+}
+export interface WorkflowParentPersistResult {
+    changedParentTaskIds: string[];
+    linkedAuditInstanceIds: string[];
+}
+export interface DeriveWorkflowParentLifecycleChangeOptions {
+    row: WorkflowParentTaskRow;
+    run: RunExecution;
+    workspaceId: string;
+    kind: WorkflowParentTaskKind;
+    snapshotUpdatedAt?: string | null;
+}
+export type WorkflowParentLifecycleDecisionStatus = 'ineligible' | 'unchanged' | 'stale-suppressed' | 'changed';
+export interface WorkflowParentLifecycleDecision {
+    status: WorkflowParentLifecycleDecisionStatus;
+    change: WorkflowParentLifecycleChange | null;
+    linkedAuditInstanceId: string | null;
+}
+export interface PreviewWorkflowParentRepairOptions {
+    taskRepo: Pick<WorkflowParentPersistTaskRepository, 'findWorkflowParentTask'>;
+    run: RunExecution;
+    workspaceId: string;
+    parentKinds?: readonly WorkflowParentTaskKind[];
+}
+export interface WorkflowParentRepairPreview {
+    runId: string;
+    runStatus: NonNullable<RunExecution['status']>;
+    changes: WorkflowParentLifecycleChange[];
+    linkedAuditInstanceIds: string[];
+}
+export interface ReconcileWorkflowParentTasksOptions {
+    taskRepo: WorkflowParentTaskRepository;
+    resolveWorkspacePath: (workspaceId: string) => string | undefined;
+    loadRun: (workspacePath: string, workflowRunId: string) => RunExecution | null;
+    orphanGraceMs?: number;
+    nowMs?: number;
+}
+export interface WorkflowParentReconciliationResult {
+    aligned: number;
+    orphaned: number;
+    skipped: number;
+}
+export declare const WORKFLOW_PARENT_ORPHAN_GRACE_MS: number;
+export declare const WORKFLOW_PARENT_ORPHAN_ERROR = "Workflow run file missing after grace period (orphaned workflow task)";
+export declare const WORKFLOW_PARENT_TASK_KINDS: readonly WorkflowParentTaskKind[];
+export declare function deriveWorkflowParentLifecycle(run: RunExecution): WorkflowParentLifecycle | null;
+export declare function deriveWorkflowParentLifecycleDecision(options: DeriveWorkflowParentLifecycleChangeOptions): WorkflowParentLifecycleDecision;
+export declare function deriveWorkflowParentLifecycleChange(options: DeriveWorkflowParentLifecycleChangeOptions): WorkflowParentLifecycleChange | null;
+export declare function syncWorkflowParentTaskLifecycle(options: SyncWorkflowParentTaskLifecycleOptions): boolean;
+export declare function previewWorkflowParentRepair(options: PreviewWorkflowParentRepairOptions): WorkflowParentRepairPreview;
+export declare function createWorkflowParentPersistSink(options: WorkflowParentPersistSinkOptions): (run: RunExecution) => WorkflowParentPersistResult;
+export declare function reconcileWorkflowParentTasks(options: ReconcileWorkflowParentTasksOptions): WorkflowParentReconciliationResult;
+//# sourceMappingURL=parent-task-sync.d.ts.map

package/dist/src/parent-task-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-task-sync.d.ts","sourceRoot":"","sources":["../../src/parent-task-sync.ts"],"names":[],"mappings":"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"}

package/dist/src/parent-task-sync.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_PARENT_TASK_KINDS = exports.WORKFLOW_PARENT_ORPHAN_ERROR = exports.WORKFLOW_PARENT_ORPHAN_GRACE_MS = void 0;
+exports.deriveWorkflowParentLifecycle = deriveWorkflowParentLifecycle;
+exports.deriveWorkflowParentLifecycleDecision = deriveWorkflowParentLifecycleDecision;
+exports.deriveWorkflowParentLifecycleChange = deriveWorkflowParentLifecycleChange;
+exports.syncWorkflowParentTaskLifecycle = syncWorkflowParentTaskLifecycle;
+exports.previewWorkflowParentRepair = previewWorkflowParentRepair;
+exports.createWorkflowParentPersistSink = createWorkflowParentPersistSink;
+exports.reconcileWorkflowParentTasks = reconcileWorkflowParentTasks;
+exports.WORKFLOW_PARENT_ORPHAN_GRACE_MS = 10 * 60 * 1000;
+exports.WORKFLOW_PARENT_ORPHAN_ERROR = 'Workflow run file missing after grace period (orphaned workflow task)';
+exports.WORKFLOW_PARENT_TASK_KINDS = [
+    'workflow_card',
+    'workflow_ui_instance',
+];
+function latestAuditEndedAt(run) {
+    let latest;
+    for (const entry of run.audit ?? []) {
+        const timestamp = Date.parse(entry.ended_at);
+        if (!Number.isFinite(timestamp))
+            continue;
+        if (!latest || timestamp >= latest.timestamp) {
+            latest = { value: entry.ended_at, timestamp };
+        }
+    }
+    return latest?.value ?? null;
+}
+function deriveWorkflowParentLifecycle(run) {
+    if (run.status === 'completed' || run.status === 'failed' || run.status === 'cancelled') {
+        const completedAt = latestAuditEndedAt(run) ?? run.updated_at;
+        const createdAtMs = Date.parse(run.created_at);
+        const completedAtMs = Date.parse(completedAt);
+        const durationMs = Number.isFinite(createdAtMs) && Number.isFinite(completedAtMs)
+            ? Math.max(0, completedAtMs - createdAtMs)
+            : null;
+        if (run.status === 'completed') {
+            return { status: 'success', error: null, completedAt, durationMs };
+        }
+        return {
+            status: 'failed',
+            error: run.error ?? (run.status === 'cancelled' ? 'Workflow run cancelled' : 'Workflow run failed'),
+            completedAt,
+            durationMs,
+        };
+    }
+    if (run.status === 'running' || run.status === 'retrying') {
+        return { status: 'running', error: null, completedAt: null, durationMs: null };
+    }
+    if (run.status === 'pending' || run.status === undefined) {
+        return { status: 'pending', error: null, completedAt: null, durationMs: null };
+    }
+    return null;
+}
+function parseWorkflowParentMarker(metadata) {
+    if (!metadata)
+        return null;
+    try {
+        const parsed = JSON.parse(metadata);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        const record = parsed;
+        return (record.kind === 'workflow_card' || record.kind === 'workflow_ui_instance') && typeof record.workflowRunId === 'string'
+            ? {
+                kind: record.kind,
+                workflowRunId: record.workflowRunId,
+                ...(typeof record.uiInstanceId === 'string' && record.uiInstanceId.trim()
+                    ? { uiInstanceId: record.uiInstanceId.trim() }
+                    : {}),
+            }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function lifecycleMatches(row, lifecycle) {
+    return row.status === lifecycle.status
+        && row.error === lifecycle.error
+        && row.completed_at === lifecycle.completedAt
+        && row.duration_ms === lifecycle.durationMs;
+}
+function isTerminalParentStatus(status) {
+    return status === 'success'
+        || status === 'completed'
+        || status === 'failed'
+        || status === 'cancelled'
+        || status === 'error';
+}
+function protectsNewerTerminalParent(row, run, snapshotUpdatedAt) {
+    if (!isTerminalParentStatus(row.status))
+        return false;
+    if (!row.completed_at)
+        return false;
+    const taskCompletedAt = Date.parse(row.completed_at);
+    const runUpdatedAt = Date.parse(snapshotUpdatedAt ?? run.updated_at);
+    if (!Number.isFinite(taskCompletedAt) || !Number.isFinite(runUpdatedAt))
+        return true;
+    return taskCompletedAt >= runUpdatedAt;
+}
+function deriveWorkflowParentLifecycleDecision(options) {
+    const ineligible = () => ({
+        status: 'ineligible',
+        change: null,
+        linkedAuditInstanceId: null,
+    });
+    if (options.row.platform !== 'workflow' || options.row.workspace_id !== options.workspaceId) {
+        return ineligible();
+    }
+    const marker = parseWorkflowParentMarker(options.row.metadata);
+    if (!marker || marker.kind !== options.kind || marker.workflowRunId !== options.run.id) {
+        return ineligible();
+    }
+    const lifecycle = deriveWorkflowParentLifecycle(options.run);
+    if (!lifecycle)
+        return ineligible();
+    const linkedAuditInstanceId = marker.kind === 'workflow_ui_instance'
+        ? marker.uiInstanceId ?? null
+        : null;
+    if (lifecycleMatches(options.row, lifecycle)) {
+        return { status: 'unchanged', change: null, linkedAuditInstanceId };
+    }
+    if ((lifecycle.status === 'running' || lifecycle.status === 'pending')
+        && protectsNewerTerminalParent(options.row, options.run, options.snapshotUpdatedAt)) {
+        return { status: 'stale-suppressed', change: null, linkedAuditInstanceId: null };
+    }
+    const runStatus = options.run.status ?? 'pending';
+    const reason = runStatus === 'pending'
+        ? 'Persisted run is pending (or legacy statusless); no execution outcome is inferred.'
+        : `Persisted run status "${runStatus}" is projected to the parent lifecycle.`;
+    return {
+        status: 'changed',
+        linkedAuditInstanceId,
+        change: {
+            id: options.row.id,
+            kind: options.kind,
+            before: {
+                status: options.row.status,
+                error: options.row.error,
+                completedAt: options.row.completed_at,
+                durationMs: options.row.duration_ms,
+            },
+            after: lifecycle,
+            reason,
+        },
+    };
+}
+function deriveWorkflowParentLifecycleChange(options) {
+    return deriveWorkflowParentLifecycleDecision(options).change;
+}
+function applyWorkflowParentLifecycleChange(options, change) {
+    options.taskRepo.updateTaskLifecycle({
+        id: options.row.id,
+        status: change.after.status,
+        error: change.after.error,
+        completedAt: change.after.completedAt,
+        durationMs: change.after.durationMs,
+        workspaceId: options.workspaceId,
+    });
+}
+function syncWorkflowParentTaskLifecycle(options) {
+    const change = deriveWorkflowParentLifecycleDecision(options).change;
+    if (!change)
+        return false;
+    applyWorkflowParentLifecycleChange(options, change);
+    return true;
+}
+function previewWorkflowParentRepair(options) {
+    const parentKinds = options.parentKinds ?? exports.WORKFLOW_PARENT_TASK_KINDS;
+    const changes = [];
+    const linkedAuditInstanceIds = new Set();
+    for (const kind of parentKinds) {
+        const row = options.taskRepo.findWorkflowParentTask({
+            workspaceId: options.workspaceId,
+            workflowRunId: options.run.id,
+            kind,
+        });
+        if (!row)
+            continue;
+        const decision = deriveWorkflowParentLifecycleDecision({
+            row,
+            run: options.run,
+            workspaceId: options.workspaceId,
+            kind,
+            snapshotUpdatedAt: latestAuditEndedAt(options.run),
+        });
+        if (decision.linkedAuditInstanceId) {
+            linkedAuditInstanceIds.add(decision.linkedAuditInstanceId);
+        }
+        if (decision.change)
+            changes.push(decision.change);
+    }
+    return {
+        runId: options.run.id,
+        runStatus: options.run.status ?? 'pending',
+        changes,
+        linkedAuditInstanceIds: [...linkedAuditInstanceIds],
+    };
+}
+function createWorkflowParentPersistSink(options) {
+    const parentKinds = options.parentKinds ?? exports.WORKFLOW_PARENT_TASK_KINDS;
+    return (run) => {
+        const changedParentTaskIds = [];
+        const linkedAuditInstanceIds = new Set();
+        if (!deriveWorkflowParentLifecycle(run)) {
+            return { changedParentTaskIds, linkedAuditInstanceIds: [] };
+        }
+        for (const kind of parentKinds) {
+            const row = options.taskRepo.findWorkflowParentTask({
+                workspaceId: options.workspaceId,
+                workflowRunId: run.id,
+                kind,
+            });
+            if (!row)
+                continue;
+            const lifecycleOptions = {
+                taskRepo: options.taskRepo,
+                row,
+                run,
+                workspaceId: options.workspaceId,
+                kind,
+                snapshotUpdatedAt: latestAuditEndedAt(run),
+            };
+            const decision = deriveWorkflowParentLifecycleDecision(lifecycleOptions);
+            if (decision.linkedAuditInstanceId) {
+                linkedAuditInstanceIds.add(decision.linkedAuditInstanceId);
+            }
+            if (decision.change) {
+                applyWorkflowParentLifecycleChange(lifecycleOptions, decision.change);
+                changedParentTaskIds.push(row.id);
+            }
+        }
+        return { changedParentTaskIds, linkedAuditInstanceIds: [...linkedAuditInstanceIds] };
+    };
+}
+function isStale(startedAt, nowMs, graceMs) {
+    const startedAtMs = Date.parse(startedAt);
+    return Number.isFinite(startedAtMs) && nowMs - startedAtMs >= graceMs;
+}
+function reconcileWorkflowParentTasks(options) {
+    const graceMs = options.orphanGraceMs ?? exports.WORKFLOW_PARENT_ORPHAN_GRACE_MS;
+    const nowMs = options.nowMs ?? Date.now();
+    const result = { aligned: 0, orphaned: 0, skipped: 0 };
+    for (const row of options.taskRepo.findRunningWorkflowParentTasks()) {
+        const marker = parseWorkflowParentMarker(row.metadata);
+        if (row.platform !== 'workflow' || !marker) {
+            result.skipped += 1;
+            continue;
+        }
+        const workspaceId = row.workspace_id;
+        if (!workspaceId) {
+            result.skipped += 1;
+            continue;
+        }
+        const workspacePath = options.resolveWorkspacePath(workspaceId);
+        if (!workspacePath) {
+            result.skipped += 1;
+            continue;
+        }
+        const workflowRunId = marker.workflowRunId;
+        let run = null;
+        try {
+            run = options.loadRun(workspacePath, workflowRunId);
+        }
+        catch {
+        }
+        if (!run) {
+            if (row.status !== 'running' || !isStale(row.started_at, nowMs, graceMs)) {
+                result.skipped += 1;
+                continue;
+            }
+            const completedAt = row.completed_at ?? new Date(nowMs).toISOString();
+            const durationMs = row.duration_ms ?? Math.max(0, nowMs - Date.parse(row.started_at));
+            options.taskRepo.updateTaskLifecycle({
+                id: row.id,
+                status: 'failed',
+                error: exports.WORKFLOW_PARENT_ORPHAN_ERROR,
+                completedAt,
+                durationMs: Number.isFinite(durationMs) ? durationMs : null,
+                workspaceId,
+            });
+            result.orphaned += 1;
+            continue;
+        }
+        const lifecycle = deriveWorkflowParentLifecycle(run);
+        if (!lifecycle) {
+            result.skipped += 1;
+            continue;
+        }
+        if (lifecycleMatches(row, lifecycle))
+            continue;
+        if (syncWorkflowParentTaskLifecycle({
+            taskRepo: options.taskRepo,
+            row,
+            run,
+            workspaceId,
+            kind: marker.kind,
+        })) {
+            result.aligned += 1;
+        }
+        else {
+            result.skipped += 1;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=parent-task-sync.js.map