/**
 * Internalization Task Guards (PRI-62)
 *
 * Pure Boolean guard functions that validate individual conditions
 * for the Internalization Engine state machine.
 *
 * Key constraints (ADR-0003 Section 3.9):
 *   - Terminal task states: succeeded and failed only
 *   - resultRef is immutable only after status transitions to succeeded
 *   - lastError can be updated during retry_wait and failed transitions
 *   - dependencyTaskIds gating must fail closed
 *
 * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
 */
import type { PDTaskStatus, TaskRecord } from '../task-status.js';
import type { PITaskRecord, PIArtifact } from './peer-runner-contracts.js';
/**
 * Backoff predicate (single authority, shared by canRetryNow and non-PI
 * callers such as the PainSignalBridge pending-diagnosis path, PRI-624).
 *
 * When a task enters retry_wait, recovery-sweep sets leaseExpiresAt to
 * now + backoffMs (the "retry-after" deadline). The task should NOT be
 * re-leased until that deadline has passed. For non-retry_wait statuses the
 * answer is always true (no backoff gating applies).
 */
export declare function isRetryWaitBackoffElapsed(status: PDTaskStatus, leaseExpiresAt: string | null | undefined, nowMs?: number): boolean;
export declare function canRetryNow(task: PITaskRecord, nowMs?: number): boolean;
/**
 * Returns true if the task status allows acquiring a lease.
 *
 * Only `pending` and `retry_wait` can be leased:
 *   - pending: task is waiting for a runner to pick it up
 *   - retry_wait: task is recovering after a transient failure
 *
 * Terminal states (succeeded/failed) are not leaseable.
 * `leased` tasks already have an active lease and cannot be re-leased.
 *
 * Note: This does NOT check backoff timing. Use canRetryNow() to gate
 * retry_wait tasks whose backoff period has not yet expired.
 */
export declare function canAcquireLease(task: PITaskRecord): boolean;
/**
 * Returns true if ALL dependency tasks have reached succeeded state.
 *
 * Fail-closed: if ANY dependency is not found in the dependencies array,
 * or is not in succeeded state, returns false.
 *
 * Empty dependencyTaskIds means no gating — returns true.
 */
export declare function areDependenciesMet(task: PITaskRecord, dependencies: readonly TaskRecord[]): boolean;
/**
 * Returns true if a PDTaskStatus transition is valid per ADR-0003 Section 3.8
 * (+ revision/review 扩展, MVP_CORE_LOOP_CONTRACT INV-02/03/07)。
 *
 * Valid transitions:
 *   pending     → leased
 *   leased      → succeeded
 *   leased      → retry_wait
 *   leased      → failed
 *   leased      → pending   (lease release / force-expire — e.g. LeaseManager.releaseLease)
 *   leased      → needs_human_review  (repair/revision budget exhausted — runner fail-loud)
 *   retry_wait  → pending   (recovery sweep resets)
 *   succeeded   → pending   (revision reopen ONLY: orchestrator.reopenTaskForRevision
 *                            — evaluator repair rounds, rollout revision routing,
 *                            upstream revision cascade. Not a general-purpose edge.)
 *   needs_human_review → pending (owner-initiated retry: pd runtime internalization
 *                            retry — INV-03 出边)
 *
 * Terminal states (failed) cannot transition to any other state.
 */
export declare function canTransitionTo(currentStatus: PDTaskStatus, newStatus: PDTaskStatus): boolean;
/**
 * Returns true if resultRef is now immutable (task reached succeeded).
 *
 * Per ADR-0003: resultRef becomes immutable after task enters succeeded state.
 * Before succeeded, resultRef may still be set or updated.
 */
export declare function isResultRefImmutable(task: PITaskRecord): boolean;
/**
 * Returns true if lastError can be updated for this task.
 *
 * lastError can be updated during retry_wait and failed transitions.
 * It is NOT updated during pending (no error yet) or succeeded (terminal).
 */
export declare function canUpdateLastError(task: PITaskRecord): boolean;
/**
 * Returns true if the artifact has been rejected by the evaluator.
 *
 * Per ADR-0003 Section 3.7: rejected artifacts trigger a corrective feedback
 * loop but do NOT directly set the source task to failed.
 */
export declare function isArtifactRejected(artifact: PIArtifact): boolean;
export declare const DEFAULT_UNRESOLVABLE_THRESHOLD = 3;
export declare function isUnresolvable(task: PITaskRecord, threshold?: number): boolean;
export declare function recordRejection(task: PITaskRecord): PITaskRecord;
/**
 * Default maximum time a task may remain in `retry_wait` before being
 * considered stale. 24 hours — conservative threshold; if a task has been
 * in retry_wait this long without recovery, something is likely wrong
 * (e.g. recovery sweep not running, persistent transient failure).
 */
export declare const DEFAULT_RETRY_WAIT_STALE_TTL_MS: number;
//# sourceMappingURL=internalization-task-guards.d.ts.map