@ttfw/envoi 1.0.0

package/dist/types/config.d.ts

@@ -0,0 +1,384 @@
+/**
+ * TypeScript interfaces for envoi.config.json configuration.
+ *
+ * These types define the complete structure of the Envoi configuration file.
+ */
+/**
+ * Crash cleanup settings for recovering from interrupted operations.
+ */
+export interface CrashCleanupConfig {
+    /** Glob pattern for temporary files to delete on crash recovery */
+    delete_tmp_glob: string;
+    /** Whether to validate runner-owned JSON files on startup */
+    validate_runner_json_files: boolean;
+}
+/**
+ * Configuration for rendering REPORT.md from REPORT.json.
+ */
+export interface RenderReportMdConfig {
+    /** Whether to generate REPORT.md */
+    enabled: boolean;
+    /** Maximum characters to include in the report */
+    max_chars: number;
+}
+/**
+ * Runtime autonomy profile for balancing speed vs approvals.
+ */
+export interface RunnerAutonomyConfig {
+    /** Profile selector controlling default permission behavior */
+    profile: 'strict' | 'balanced' | 'fast';
+    /** Optional trusted command prefixes for operator documentation */
+    command_trust?: string[];
+    /** Optional file-system policy label for operator documentation */
+    fs_policy?: 'workspace_write' | 'read_only';
+    /** Optional network policy label for operator documentation */
+    network_policy?: 'deny' | 'allow';
+}
+/**
+ * Runner configuration for the orchestration loop.
+ */
+export interface RunnerConfig {
+    /** Whether git is required for operations */
+    require_git: boolean;
+    /** Maximum seconds per tick before timeout */
+    max_tick_seconds: number;
+    /** Default loop mode used when `envoi loop` is invoked without --mode (optional) */
+    default_loop_mode?: 'task' | 'milestone' | 'autonomous';
+    /** Path to the lockfile for preventing concurrent runs */
+    lockfile: string;
+    /** Glob patterns for files owned by the runner (not modifiable by builder) */
+    runner_owned_globs: string[];
+    /** Crash cleanup settings */
+    crash_cleanup: CrashCleanupConfig;
+    /** Report rendering settings */
+    render_report_md: RenderReportMdConfig;
+    /** Optional autonomy profile and policy hints */
+    autonomy?: RunnerAutonomyConfig;
+}
+/**
+ * Configuration for invoking Claude Code CLI.
+ */
+export interface ClaudeCodeCliConfig {
+    /** Command to invoke Claude Code */
+    command: string;
+    /** Output format (typically 'json') */
+    output_format: string;
+    /** Whether to disable session persistence */
+    no_session_persistence: boolean;
+}
+/**
+ * Model configuration for different agent roles.
+ */
+export interface ModelsConfig {
+    /** Primary model for orchestrator */
+    orchestrator_model: string;
+    /** Fallback model for orchestrator */
+    orchestrator_fallback_model: string;
+    /** Primary model for builder */
+    builder_model: string;
+    /** Fallback model for builder */
+    builder_fallback_model: string;
+}
+/**
+ * Orchestrator agent configuration.
+ */
+export interface OrchestratorConfig {
+    /** Maximum conversation turns */
+    max_turns: number;
+    /** Permission mode for Claude Code (e.g., 'plan') */
+    permission_mode: string;
+    /** Allowed tools (empty string for default) */
+    allowed_tools: string;
+    /** Path to system prompt file */
+    system_prompt_file: string;
+    /** Path to user prompt file */
+    user_prompt_file: string;
+    /** Path to task JSON schema file */
+    task_schema_file: string;
+    /** Maximum parse retries per tick */
+    max_parse_retries_per_tick: number;
+    /** Maximum budget in USD per orchestrator call */
+    max_budget_usd: number;
+    /** Timeout in seconds for orchestrator invocation (optional, falls back to runner.max_tick_seconds) */
+    timeout_seconds?: number;
+}
+/**
+ * Claude Code builder mode configuration.
+ */
+export interface ClaudeCodeBuilderConfig {
+    /** Maximum conversation turns */
+    max_turns: number;
+    /** Permission mode (e.g., 'bypassPermissions') */
+    permission_mode: string;
+    /** Comma-separated list of allowed tools */
+    allowed_tools: string;
+    /** Path to system prompt file */
+    system_prompt_file: string;
+    /** Path to user prompt file */
+    user_prompt_file: string;
+    /** Path to builder result JSON schema file */
+    builder_result_schema_file: string;
+    /** Maximum budget in USD per builder call */
+    max_budget_usd: number;
+    /** Whether to enforce strict JSON output */
+    strict_builder_json: boolean;
+}
+/**
+ * Patch-based builder mode configuration.
+ */
+export interface PatchBuilderConfig {
+    /** Maximum patch attempts per milestone */
+    max_patch_attempts_per_milestone: number;
+}
+/**
+ * External builder driver ("cursor mode") configuration.
+ * Works with any headless script: Cursor wrapper, llm CLI, etc.
+ */
+export interface CursorBuilderConfig {
+    /**
+     * Driver kind:
+     * - 'external' (default): an arbitrary driver that reads TASK.json and writes output_file
+     * - 'cursor_agent': invoke `cursor agent` and pass a generated prompt to execute TASK.json
+     */
+    driver_kind?: 'external' | 'cursor_agent';
+    /** Command to invoke the external driver */
+    command: string;
+    /** Arguments to pass (argv-only, no shell string) */
+    args: string[];
+    /** Timeout in seconds before killing the process */
+    timeout_seconds: number;
+    /** Output file path where driver writes result (e.g., 'envoi/BUILDER_RESULT.json') */
+    output_file: string;
+}
+/**
+ * Builder agent configuration.
+ */
+export interface BuilderConfig {
+    /** Default builder mode ('claude_code' or 'patch' or 'cursor') */
+    default_mode: 'claude_code' | 'patch' | 'cursor';
+    /** Whether patch mode is allowed */
+    allow_patch_mode: boolean;
+    /** Claude Code builder settings */
+    claude_code: ClaudeCodeBuilderConfig;
+    /** Patch builder settings */
+    patch: PatchBuilderConfig;
+    /** Cursor (external driver) settings */
+    cursor?: CursorBuilderConfig;
+}
+/**
+ * Default scope rules for file access.
+ */
+export interface ScopeConfig {
+    /** Default glob patterns for allowed file access */
+    default_allowed_globs: string[];
+    /** Default glob patterns for forbidden file access */
+    default_forbidden_globs: string[];
+    /** Whether new file creation is allowed by default */
+    default_allow_new_files: boolean;
+    /** Whether lockfile changes are allowed by default */
+    default_allow_lockfile_changes: boolean;
+    /** List of recognized lockfile names */
+    lockfiles: string[];
+}
+/**
+ * Limits on diff size per task.
+ */
+export interface DiffLimitsConfig {
+    /** Maximum number of files that can be touched per task */
+    default_max_files_touched: number;
+    /** Maximum number of lines that can be changed per task */
+    default_max_lines_changed: number;
+}
+/**
+ * Parameter definition for verification template.
+ */
+export interface VerificationParam {
+    /** Parameter type */
+    kind: 'string_token';
+}
+/**
+ * Verification command template.
+ */
+export interface VerificationTemplate {
+    /** Unique identifier for this template */
+    id: string;
+    /** Command to execute */
+    cmd: string;
+    /** Command arguments (may contain {{param}} placeholders) */
+    args: string[];
+    /** Optional parameter definitions */
+    params?: Record<string, VerificationParam>;
+}
+/**
+ * Verification command execution configuration.
+ */
+export interface VerificationConfig {
+    /** Execution mode (argv_no_shell for security) */
+    execution_mode: 'argv_no_shell';
+    /** Maximum parameter length */
+    max_param_len: number;
+    /** Whether to reject whitespace in parameters */
+    reject_whitespace_in_params: boolean;
+    /** Whether to reject '..' in paths */
+    reject_dotdot: boolean;
+    /** Regex pattern for rejected shell metacharacters */
+    reject_metachars_regex: string;
+    /** Timeout for fast verification commands (seconds) */
+    timeout_fast_seconds: number;
+    /** Timeout for slow verification commands (seconds) */
+    timeout_slow_seconds: number;
+    /** Available verification command templates */
+    templates: VerificationTemplate[];
+}
+/**
+ * Per-milestone budget limits.
+ */
+export interface PerMilestoneBudgets {
+    /** Maximum ticks per milestone */
+    max_ticks: number;
+    /** Maximum orchestrator calls per milestone */
+    max_orchestrator_calls: number;
+    /** Maximum builder calls per milestone */
+    max_builder_calls: number;
+    /** Maximum verification runs per milestone */
+    max_verify_runs: number;
+    /** Maximum estimated cost in USD per milestone */
+    max_estimated_cost_usd: number;
+}
+/**
+ * Budget configuration for cost and resource limits.
+ */
+export interface BudgetsConfig {
+    /** Per-milestone limits */
+    per_milestone: PerMilestoneBudgets;
+    /** Fraction of budget at which to emit warnings */
+    warn_at_fraction: number;
+}
+/**
+ * History tracking configuration.
+ */
+export interface HistoryConfig {
+    /** Whether history tracking is enabled */
+    enabled: boolean;
+    /** Directory to store history files */
+    dir: string;
+    /** Maximum history size in megabytes */
+    max_mb: number;
+    /** Whether to include diff patches in history */
+    include_diff_patch: boolean;
+    /** Whether to include verification logs in history */
+    include_verify_log: boolean;
+}
+/**
+ * Authentication configuration for the reviewer agent.
+ */
+export interface ReviewerAuthConfig {
+    /** Authentication mode ('auto', 'api_key', or 'login') */
+    mode: 'auto' | 'api_key' | 'login';
+    /** Whether CI environments require an API key */
+    ci_requires_api_key: boolean;
+    /** Environment variable name for the API key */
+    api_key_env: string;
+}
+/**
+ * Trigger configuration for when the reviewer should be invoked.
+ */
+export interface ReviewerTriggerConfig {
+    /** Whether to trigger reviewer on verification failures */
+    on_verify_fail: boolean;
+    /** Whether to trigger reviewer on repeated stops */
+    on_repeated_stop: boolean;
+    /** Time window in ticks for tracking repeated stops */
+    stop_window_ticks: number;
+    /** Maximum number of stops allowed within the window */
+    max_stops_in_window: number;
+    /** Whether to trigger reviewer on high-risk file paths */
+    on_high_risk_paths: boolean;
+    /** Glob patterns for files considered high-risk */
+    high_risk_globs: string[];
+    /** Fraction of diff that must match high-risk patterns to trigger */
+    diff_fraction_threshold: number;
+}
+/**
+ * Reviewer agent configuration for Codex CLI integration.
+ *
+ * The reviewer acts as a 'Second Brain' that triggers on risky situations
+ * to provide additional review and validation.
+ */
+export interface ReviewerConfig {
+    /** Whether the reviewer feature is enabled */
+    enabled: boolean;
+    /** Engine to use for reviewer (e.g., 'claude_code') */
+    engine: string;
+    /** Command to invoke the reviewer engine */
+    command: string;
+    /** Model to use for reviewer */
+    model: string;
+    /** Maximum conversation turns */
+    max_turns: number;
+    /** Maximum budget in USD per reviewer call */
+    max_budget_usd: number;
+    /** Authentication settings */
+    auth: ReviewerAuthConfig;
+    /** Trigger conditions for reviewer invocation */
+    trigger: ReviewerTriggerConfig;
+    /** Path to JSON schema file */
+    schema_file: string;
+    /** Path to system prompt file */
+    system_prompt_file: string;
+    /** Path to user prompt file */
+    user_prompt_file: string;
+}
+/**
+ * Git branching configuration for runner-owned branch management.
+ */
+export interface GitBranchingConfig {
+    /** Branching mode: 'off' (disabled), 'per_tick' (create branch per tick), 'per_n_tasks' (create branch per N tasks), 'per_milestone' (create branch per milestone) */
+    mode: 'off' | 'per_tick' | 'per_n_tasks' | 'per_milestone';
+    /** Number of tasks per branch (only used when mode='per_n_tasks') */
+    n_tasks?: number;
+    /** Base ref (commit/branch) to create new branches from. Default: 'HEAD' */
+    base_ref?: string;
+    /** Branch name template. Supports placeholders: {{task_id}}, {{milestone_id}}, {{run_id}}, {{tick_count}}, {{YYYYMMDD}}, {{seq}} (or {{batch_index}}). Also supports {task_id}, {milestone_id} style. Default: 'envoi/{{task_id}}' */
+    name_template?: string;
+}
+/**
+ * Main Envoi configuration interface.
+ *
+ * This matches the structure of envoi.config.json.
+ */
+export interface EnvoiConfig {
+    /** Configuration version */
+    version: string;
+    /** Product name */
+    product_name: string;
+    /** Directory for envoi workspace files */
+    workspace_dir: string;
+    /** Runner settings */
+    runner: RunnerConfig;
+    /** Claude Code CLI settings */
+    claude_code_cli: ClaudeCodeCliConfig;
+    /** Model configuration */
+    models: ModelsConfig;
+    /** Orchestrator settings */
+    orchestrator: OrchestratorConfig;
+    /** Builder settings */
+    builder: BuilderConfig;
+    /** Default scope rules */
+    scope: ScopeConfig;
+    /** Diff size limits */
+    diff_limits: DiffLimitsConfig;
+    /** Verification command settings */
+    verification: VerificationConfig;
+    /** Budget limits */
+    budgets: BudgetsConfig;
+    /** History settings */
+    history: HistoryConfig;
+    /** Reviewer agent settings (optional, feature can be disabled) */
+    reviewer?: ReviewerConfig;
+    /** Git branching settings (optional, defaults to mode='off') */
+    git?: {
+        branching?: GitBranchingConfig;
+    };
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -0,0 +1,7 @@
+/**
+ * TypeScript interfaces for envoi.config.json configuration.
+ *
+ * These types define the complete structure of the Envoi configuration file.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Envoi type definitions.
+ *
+ * This module exports all public types for the Envoi project.
+ */
+export type { EnvoiConfig, RunnerConfig, CrashCleanupConfig, RenderReportMdConfig, ClaudeCodeCliConfig, ModelsConfig, OrchestratorConfig, ClaudeCodeBuilderConfig, PatchBuilderConfig, BuilderConfig, ScopeConfig, DiffLimitsConfig, VerificationParam, VerificationTemplate, VerificationConfig, PerMilestoneBudgets, BudgetsConfig, HistoryConfig, ReviewerAuthConfig, ReviewerTriggerConfig, ReviewerConfig, } from './config.js';
+export type { LockInfo } from './lock.js';
+export type { BlockedCode, PreflightResult, TransportStallStage, TransportStallError, } from './preflight.js';
+export type { BlockedData } from './blocked.js';
+export { TickPhase, } from './state.js';
+export type { TickState, TickContext, StopHistoryEntry, GuardrailState, VerifyHistoryEntry, EscalationState, } from './state.js';
+export type { BuilderResult } from './builder.js';
+export type { Task, TaskKind, Question, TaskScope, DiffLimits as TaskDiffLimits, TaskVerification, TaskBuilder, } from './task.js';
+export type { Verdict, ReportCode, BlastRadius, ScopeResult, DiffInfo, VerificationRun, VerificationResult, BudgetInfo, TaskSummary, ReportPointers, ReportData, } from './report.js';
+export type { ClaudeInvocation, ClaudeResponse, } from './claude.js';
+export { ClaudeError } from './claude.js';
+export type { ReviewerInvocationConfig, ReviewerContext, ReviewerInvocationResult, ReviewerResult, ReviewerError, } from './reviewer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,YAAY,EACV,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,IAAI,cAAc,EAC5B,gBAAgB,EAChB,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Envoi type definitions.
+ *
+ * This module exports all public types for the Envoi project.
+ */
+export { TickPhase, } from './state.js';
+export { ClaudeError } from './claude.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,OAAO,EACL,SAAS,GACV,MAAM,YAAY,CAAC;AA0CpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/lock.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Lock mechanism type definitions.
+ *
+ * These types support the lock acquisition/release system that prevents
+ * concurrent envoi runs and enables safe lock reclaim after crashes.
+ */
+/**
+ * Information stored in the lock file.
+ *
+ * This structure enables crash-safe lock reclaim by storing enough
+ * information to determine if the lock holder is still running.
+ */
+export interface LockInfo {
+    /** Process ID that holds the lock */
+    pid: number;
+    /** ISO timestamp when lock was acquired */
+    started_at: string;
+    /** Unique identifier for the current boot session */
+    boot_id: string;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/types/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/lock.js

@@ -0,0 +1,8 @@
+/**
+ * Lock mechanism type definitions.
+ *
+ * These types support the lock acquisition/release system that prevents
+ * concurrent envoi runs and enables safe lock reclaim after crashes.
+ */
+export {};
+//# sourceMappingURL=lock.js.map

package/dist/types/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/preflight.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Preflight check types for determining if a tick can safely start.
+ *
+ * Preflight checks produce BLOCKED verdicts if conditions are not met,
+ * preventing the runner from executing a tick.
+ */
+/**
+ * Codes indicating why a preflight check blocked execution.
+ */
+export type BlockedCode = 'BLOCKED_MISSING_CONFIG' | 'BLOCKED_DIRTY_WORKTREE' | 'BLOCKED_LOCK_HELD' | 'BLOCKED_CRASH_RECOVERY_REQUIRED' | 'BLOCKED_HISTORY_CAP_CLEANUP_REQUIRED' | 'BLOCKED_BUDGET_EXHAUSTED' | 'BLOCKED_BUDGET_CAP' | 'BLOCKED_TRANSPORT_STALLED';
+/**
+ * Stage where a transport stall occurred.
+ */
+export type TransportStallStage = 'ORCHESTRATE' | 'BUILD';
+/**
+ * Structured error for transport stalls (Cursor/CLI hang, Connection stalled).
+ *
+ * Used when the builder or orchestrator invocation stalls or throws
+ * connection-related errors that prevent completion.
+ */
+export interface TransportStallError {
+    /** Error classification */
+    kind: 'transport_stalled';
+    /** Stage where the stall occurred */
+    stage: TransportStallStage;
+    /** Request ID if parsable from error output */
+    request_id: string | null;
+    /** Raw error message (trimmed to reasonable length) */
+    raw_error: string;
+}
+/**
+ * Result of running preflight checks.
+ *
+ * If ok is true, the tick can proceed. If ok is false, blocked_code and
+ * blocked_reason explain why execution is blocked.
+ */
+export interface PreflightResult {
+    /** Whether all preflight checks passed */
+    ok: boolean;
+    /** The specific reason for blocking, if any */
+    blocked_code: BlockedCode | null;
+    /** Human-readable explanation of why execution is blocked */
+    blocked_reason: string | null;
+    /** Non-fatal warnings discovered during preflight */
+    warnings: string[];
+    /** The current HEAD commit SHA if git checks passed */
+    base_commit: string | null;
+}
+//# sourceMappingURL=preflight.d.ts.map

package/dist/types/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/types/preflight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,mBAAmB,GACnB,iCAAiC,GACjC,sCAAsC,GACtC,0BAA0B,GAC1B,oBAAoB,GACpB,2BAA2B,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/types/preflight.js

@@ -0,0 +1,8 @@
+/**
+ * Preflight check types for determining if a tick can safely start.
+ *
+ * Preflight checks produce BLOCKED verdicts if conditions are not met,
+ * preventing the runner from executing a tick.
+ */
+export {};
+//# sourceMappingURL=preflight.js.map

package/dist/types/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/types/preflight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}