@ttfw/envoi 1.0.0

package/dist/lib/schema.js

@@ -0,0 +1,91 @@
+/**
+ * JSON Schema validation utilities using Ajv.
+ *
+ * Provides functions to load and validate data against JSON schemas.
+ */
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import { readFile } from 'node:fs/promises';
+// Cache for compiled schemas
+const schemaCache = new Map();
+/**
+ * Loads and parses a JSON schema file.
+ *
+ * @param schemaPath - Path to the JSON schema file
+ * @returns Parsed schema object
+ * @throws Error if the schema file cannot be read or parsed
+ */
+export async function loadSchema(schemaPath) {
+    try {
+        const content = await readFile(schemaPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to load schema from ${schemaPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Validates data against a JSON schema using Ajv.
+ *
+ * Uses draft-2020-12 schema support and caches compiled schemas for performance.
+ *
+ * @param data - Data to validate
+ * @param schema - JSON schema object
+ * @returns ValidationResult with typed data or error messages
+ */
+export function validateWithSchema(data, schema) {
+    // Create Ajv instance with draft-2020-12 support
+    const ajv = new Ajv2020({
+        strict: true,
+        strictRequired: false, // Allow required in 'not' subschemas
+        allowUnionTypes: true, // Allow type: [...] union syntax
+        allErrors: true,
+        verbose: true,
+    });
+    // Use schema ID or stringified schema as cache key
+    const schemaId = schema.$id || JSON.stringify(schema);
+    let validate;
+    // Check cache first
+    if (schemaCache.has(schemaId)) {
+        validate = schemaCache.get(schemaId);
+    }
+    else {
+        // Compile and cache schema
+        validate = ajv.compile(schema);
+        schemaCache.set(schemaId, validate);
+    }
+    // Validate data
+    const valid = validate(data);
+    if (valid) {
+        return {
+            valid: true,
+            data: data,
+            errors: [],
+        };
+    }
+    // Collect error messages
+    const errors = [];
+    if (validate.errors) {
+        for (const error of validate.errors) {
+            const path = error.instancePath || error.schemaPath || '';
+            const message = error.message || 'Validation error';
+            errors.push(`${path ? `${path}: ` : ''}${message}`);
+        }
+    }
+    // Extract raw errors for diagnostics
+    const rawErrors = validate.errors
+        ? validate.errors.map((e) => ({
+            instancePath: e.instancePath || '',
+            schemaPath: e.schemaPath || '',
+            keyword: e.keyword || '',
+            params: e.params,
+            message: e.message,
+        }))
+        : [];
+    return {
+        valid: false,
+        data: null,
+        errors,
+        rawErrors,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/lib/schema.js.map

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

package/dist/lib/scope.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Scope enforcement utilities for validating file access against task scope.
+ *
+ * Provides functions to check if touched paths comply with task scope rules:
+ * - Forbidden glob patterns
+ * - Allowed glob patterns
+ * - New file creation restrictions
+ * - Lockfile change restrictions
+ */
+import type { TaskScope } from '../types/task.js';
+import type { EnvoiConfig } from '../types/config.js';
+/**
+ * Violation type identifiers.
+ */
+export declare const SCOPE_VIOLATION_FORBIDDEN = "SCOPE_VIOLATION_FORBIDDEN";
+export declare const SCOPE_VIOLATION_OUTSIDE_ALLOWED = "SCOPE_VIOLATION_OUTSIDE_ALLOWED";
+export declare const NEW_FILE_FORBIDDEN = "NEW_FILE_FORBIDDEN";
+export declare const LOCKFILE_CHANGE_FORBIDDEN = "LOCKFILE_CHANGE_FORBIDDEN";
+/**
+ * Represents a single scope violation.
+ */
+export interface ScopeViolation {
+    /** Violation type identifier */
+    type: string;
+    /** The path that violated scope */
+    path: string;
+    /** Human-readable explanation */
+    detail: string;
+}
+/**
+ * Result of scope checking operation.
+ */
+export interface ScopeCheckResult {
+    /** True if no violations found */
+    ok: boolean;
+    /** List of violations found */
+    violations: ScopeViolation[];
+    /** All paths that were checked */
+    touched_paths: string[];
+}
+/**
+ * Checks if a path matches any of the given glob patterns.
+ *
+ * @param path - The file path to check
+ * @param patterns - Array of glob patterns to match against
+ * @returns True if path matches any pattern, false otherwise
+ *
+ * @example
+ * ```typescript
+ * matchesGlob('src/utils.ts', ['src/**', '*.ts']); // true
+ * matchesGlob('test/file.js', ['src/**']); // false
+ * ```
+ */
+export declare function matchesGlob(path: string, patterns: string[]): boolean;
+/**
+ * Checks all touched paths against task scope rules and returns violations.
+ *
+ * Validates:
+ * - No paths match forbidden_globs
+ * - All paths match at least one allowed_globs pattern
+ * - No new files when allow_new_files=false
+ * - No lockfile changes when allow_lockfile_changes=false
+ *
+ * @param touchedPaths - All file paths that were touched (modified or created)
+ * @param untrackedPaths - Subset of touchedPaths that are new/untracked files
+ * @param taskScope - Scope configuration from the task
+ * @param config - Full Envoi configuration (for lockfiles list)
+ * @returns ScopeCheckResult with violations and status
+ *
+ * @example
+ * ```typescript
+ * const result = checkScopeViolations(
+ *   ['src/utils.ts', 'src/new.ts'],
+ *   ['src/new.ts'],
+ *   {
+ *     allowed_globs: ['src/**'],
+ *     forbidden_globs: ['*.key'],
+ *     allow_new_files: false,
+ *     allow_lockfile_changes: true
+ *   },
+ *   config
+ * );
+ * if (!result.ok) {
+ *   console.error('Scope violations:', result.violations);
+ * }
+ * ```
+ */
+export declare function checkScopeViolations(touchedPaths: string[], untrackedPaths: string[], taskScope: TaskScope, config: EnvoiConfig): ScopeCheckResult;
+//# sourceMappingURL=scope.d.ts.map

package/dist/lib/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/lib/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,+BAA+B,oCAAoC,CAAC;AACjF,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,+BAA+B;IAC/B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,kCAAkC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAKrE;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAgDlB"}

package/dist/lib/scope.js

@@ -0,0 +1,135 @@
+/**
+ * Scope enforcement utilities for validating file access against task scope.
+ *
+ * Provides functions to check if touched paths comply with task scope rules:
+ * - Forbidden glob patterns
+ * - Allowed glob patterns
+ * - New file creation restrictions
+ * - Lockfile change restrictions
+ */
+import micromatch from 'micromatch';
+/**
+ * Violation type identifiers.
+ */
+export const SCOPE_VIOLATION_FORBIDDEN = 'SCOPE_VIOLATION_FORBIDDEN';
+export const SCOPE_VIOLATION_OUTSIDE_ALLOWED = 'SCOPE_VIOLATION_OUTSIDE_ALLOWED';
+export const NEW_FILE_FORBIDDEN = 'NEW_FILE_FORBIDDEN';
+export const LOCKFILE_CHANGE_FORBIDDEN = 'LOCKFILE_CHANGE_FORBIDDEN';
+/**
+ * Checks if a path matches any of the given glob patterns.
+ *
+ * @param path - The file path to check
+ * @param patterns - Array of glob patterns to match against
+ * @returns True if path matches any pattern, false otherwise
+ *
+ * @example
+ * ```typescript
+ * matchesGlob('src/utils.ts', ['src/**', '*.ts']); // true
+ * matchesGlob('test/file.js', ['src/**']); // false
+ * ```
+ */
+export function matchesGlob(path, patterns) {
+    if (patterns.length === 0) {
+        return false;
+    }
+    return micromatch.isMatch(path, patterns);
+}
+/**
+ * Checks if a path is a lockfile based on config.scope.lockfiles list.
+ *
+ * @param path - The file path to check
+ * @param lockfiles - Array of lockfile names/patterns
+ * @returns True if path matches any lockfile pattern
+ */
+function isLockfile(path, lockfiles) {
+    if (lockfiles.length === 0) {
+        return false;
+    }
+    // Check if path ends with any lockfile name, or matches lockfile globs
+    return lockfiles.some((lockfile) => {
+        // If lockfile is a simple name (e.g., "package-lock.json"), check if path ends with it
+        if (!lockfile.includes('/') && !lockfile.includes('*')) {
+            return path.endsWith(lockfile);
+        }
+        // Otherwise, treat as glob pattern
+        return micromatch.isMatch(path, [lockfile]);
+    });
+}
+/**
+ * Checks all touched paths against task scope rules and returns violations.
+ *
+ * Validates:
+ * - No paths match forbidden_globs
+ * - All paths match at least one allowed_globs pattern
+ * - No new files when allow_new_files=false
+ * - No lockfile changes when allow_lockfile_changes=false
+ *
+ * @param touchedPaths - All file paths that were touched (modified or created)
+ * @param untrackedPaths - Subset of touchedPaths that are new/untracked files
+ * @param taskScope - Scope configuration from the task
+ * @param config - Full Envoi configuration (for lockfiles list)
+ * @returns ScopeCheckResult with violations and status
+ *
+ * @example
+ * ```typescript
+ * const result = checkScopeViolations(
+ *   ['src/utils.ts', 'src/new.ts'],
+ *   ['src/new.ts'],
+ *   {
+ *     allowed_globs: ['src/**'],
+ *     forbidden_globs: ['*.key'],
+ *     allow_new_files: false,
+ *     allow_lockfile_changes: true
+ *   },
+ *   config
+ * );
+ * if (!result.ok) {
+ *   console.error('Scope violations:', result.violations);
+ * }
+ * ```
+ */
+export function checkScopeViolations(touchedPaths, untrackedPaths, taskScope, config) {
+    const violations = [];
+    const untrackedSet = new Set(untrackedPaths);
+    for (const path of touchedPaths) {
+        // Check forbidden globs
+        if (matchesGlob(path, taskScope.forbidden_globs)) {
+            violations.push({
+                type: SCOPE_VIOLATION_FORBIDDEN,
+                path,
+                detail: `Path "${path}" matches forbidden glob pattern(s): ${taskScope.forbidden_globs.join(', ')}`,
+            });
+            continue; // Don't check other rules for forbidden paths
+        }
+        // Check allowed globs (path must match at least one)
+        if (taskScope.allowed_globs.length > 0 && !matchesGlob(path, taskScope.allowed_globs)) {
+            violations.push({
+                type: SCOPE_VIOLATION_OUTSIDE_ALLOWED,
+                path,
+                detail: `Path "${path}" does not match any allowed glob pattern(s): ${taskScope.allowed_globs.join(', ')}`,
+            });
+        }
+        // Check new file restrictions
+        if (!taskScope.allow_new_files && untrackedSet.has(path)) {
+            violations.push({
+                type: NEW_FILE_FORBIDDEN,
+                path,
+                detail: `New file "${path}" created but allow_new_files is false`,
+            });
+        }
+        // Check lockfile change restrictions
+        if (!taskScope.allow_lockfile_changes && isLockfile(path, config.scope.lockfiles)) {
+            violations.push({
+                type: LOCKFILE_CHANGE_FORBIDDEN,
+                path,
+                detail: `Lockfile "${path}" was modified but allow_lockfile_changes is false`,
+            });
+        }
+    }
+    return {
+        ok: violations.length === 0,
+        violations,
+        touched_paths: touchedPaths,
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/lib/scope.js.map

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

package/dist/lib/self_update.d.ts

@@ -0,0 +1,13 @@
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+export interface LinkedRefreshResult {
+    linkedRoot: string | null;
+    stale: boolean;
+    refreshed: boolean;
+    manager?: PackageManager;
+    error?: string;
+}
+export declare function detectLinkedInstallRoot(entrypointArg?: string): string | null;
+export declare function isLinkedInstallStale(linkedRoot: string): boolean;
+export declare function refreshLinkedInstallIfStale(): LinkedRefreshResult;
+export {};
+//# sourceMappingURL=self_update.d.ts.map

package/dist/lib/self_update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self_update.d.ts","sourceRoot":"","sources":["../../src/lib/self_update.ts"],"names":[],"mappings":"AAKA,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD,wBAAgB,uBAAuB,CAAC,aAAa,SAAkB,GAAG,MAAM,GAAG,IAAI,CAkBtF;AAyFD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,2BAA2B,IAAI,mBAAmB,CAgCjE"}

package/dist/lib/self_update.js

@@ -0,0 +1,172 @@
+import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { isKnownPackageName } from './branding.js';
+function isTestRuntime() {
+    return process.env.VITEST === 'true' || process.env.NODE_ENV === 'test';
+}
+function findNearestEnvoiPackageRoot(entrypointPath) {
+    let cursor = dirname(entrypointPath);
+    const root = resolve('/');
+    while (true) {
+        const packageJsonPath = join(cursor, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                if (isKnownPackageName(parsed.name)) {
+                    return cursor;
+                }
+            }
+            catch {
+                // Ignore parse failures and continue walking up.
+            }
+        }
+        if (cursor === root || cursor === dirname(cursor))
+            return null;
+        cursor = dirname(cursor);
+    }
+}
+export function detectLinkedInstallRoot(entrypointArg = process.argv[1]) {
+    if (isTestRuntime())
+        return null;
+    if (!entrypointArg)
+        return null;
+    let resolvedEntrypoint;
+    try {
+        resolvedEntrypoint = realpathSync(entrypointArg);
+    }
+    catch {
+        return null;
+    }
+    const packageRoot = findNearestEnvoiPackageRoot(resolvedEntrypoint);
+    if (!packageRoot)
+        return null;
+    const looksLinked = existsSync(join(packageRoot, '.git')) &&
+        existsSync(join(packageRoot, 'src', 'index.ts')) &&
+        existsSync(join(packageRoot, 'dist', 'index.js'));
+    return looksLinked ? packageRoot : null;
+}
+function newestMtimeInTree(root) {
+    if (!existsSync(root))
+        return 0;
+    let newest = 0;
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let stats;
+        try {
+            stats = statSync(current);
+        }
+        catch {
+            continue;
+        }
+        newest = Math.max(newest, stats.mtimeMs);
+        if (!stats.isDirectory())
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry === '.git' || entry === 'node_modules' || entry === 'dist')
+                continue;
+            stack.push(join(current, entry));
+        }
+    }
+    return newest;
+}
+function latestSourceMtime(linkedRoot) {
+    const candidates = [
+        join(linkedRoot, 'src'),
+        join(linkedRoot, 'relais'),
+        join(linkedRoot, 'README.md'),
+        join(linkedRoot, 'envoi.config.json'),
+        join(linkedRoot, 'relais.config.json'),
+        join(linkedRoot, 'package.json'),
+    ];
+    let newest = 0;
+    for (const candidate of candidates) {
+        newest = Math.max(newest, newestMtimeInTree(candidate));
+    }
+    return newest;
+}
+function distMtime(linkedRoot) {
+    const distEntry = join(linkedRoot, 'dist', 'index.js');
+    if (!existsSync(distEntry))
+        return 0;
+    try {
+        return statSync(distEntry).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+function detectManager(linkedRoot) {
+    const packageJsonPath = join(linkedRoot, 'package.json');
+    try {
+        const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        const value = parsed.packageManager ?? '';
+        if (value.startsWith('pnpm@'))
+            return 'pnpm';
+        if (value.startsWith('npm@'))
+            return 'npm';
+        if (value.startsWith('yarn@'))
+            return 'yarn';
+        if (value.startsWith('bun@'))
+            return 'bun';
+    }
+    catch {
+        // Fall through.
+    }
+    return 'pnpm';
+}
+function runBuild(linkedRoot, manager) {
+    const commandMap = {
+        pnpm: { cmd: 'pnpm', args: ['-C', linkedRoot, 'build'] },
+        npm: { cmd: 'npm', args: ['--prefix', linkedRoot, 'run', 'build'] },
+        yarn: { cmd: 'yarn', args: ['--cwd', linkedRoot, 'build'] },
+        bun: { cmd: 'bun', args: ['--cwd', linkedRoot, 'run', 'build'] },
+    };
+    const command = commandMap[manager];
+    const result = spawnSync(command.cmd, command.args, { stdio: 'inherit' });
+    if (result.status === 0)
+        return { ok: true };
+    return { ok: false, error: `Build command failed (${result.status ?? 'unknown'}): ${command.cmd} ${command.args.join(' ')}` };
+}
+export function isLinkedInstallStale(linkedRoot) {
+    return latestSourceMtime(linkedRoot) > distMtime(linkedRoot);
+}
+export function refreshLinkedInstallIfStale() {
+    if (isTestRuntime()) {
+        return { linkedRoot: null, stale: false, refreshed: false };
+    }
+    const linkedRoot = detectLinkedInstallRoot();
+    if (!linkedRoot) {
+        return { linkedRoot: null, stale: false, refreshed: false };
+    }
+    const stale = isLinkedInstallStale(linkedRoot);
+    if (!stale) {
+        return { linkedRoot, stale: false, refreshed: false };
+    }
+    const manager = detectManager(linkedRoot);
+    const build = runBuild(linkedRoot, manager);
+    if (!build.ok) {
+        return {
+            linkedRoot,
+            stale: true,
+            refreshed: false,
+            manager,
+            error: build.error,
+        };
+    }
+    return {
+        linkedRoot,
+        stale: true,
+        refreshed: true,
+        manager,
+    };
+}
+//# sourceMappingURL=self_update.js.map

package/dist/lib/self_update.js.map

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

package/dist/lib/state.d.ts

@@ -0,0 +1,143 @@
+/**
+ * State management utilities for tick execution.
+ *
+ * Provides functions to create and update tick state during execution.
+ */
+import type { EnvoiConfig } from '../types/config.js';
+import { TickPhase } from '../types/state.js';
+import type { TickState, StopHistoryEntry, VerifyHistoryEntry } from '../types/state.js';
+/**
+ * Generates a unique run ID for a tick.
+ *
+ * @returns A unique identifier string
+ */
+export declare function generateRunId(): string;
+/**
+ * Creates initial tick state.
+ *
+ * @param config - Envoi configuration
+ * @param baseCommit - Git HEAD commit SHA at start
+ * @returns Initial tick state
+ */
+export declare function createInitialState(config: EnvoiConfig, baseCommit: string): TickState;
+/**
+ * Transitions tick state to a new phase.
+ *
+ * @param state - Current tick state
+ * @param newPhase - Phase to transition to
+ * @returns Updated tick state
+ */
+export declare function transitionPhase(state: TickState, newPhase: TickPhase): TickState;
+/**
+ * Adds an error to the tick state.
+ *
+ * @param state - Current tick state
+ * @param error - Error message to add
+ * @returns Updated tick state
+ */
+export declare function addError(state: TickState, error: string): TickState;
+/**
+ * Updates task in tick state.
+ *
+ * @param state - Current tick state
+ * @param task - Task to set
+ * @returns Updated tick state
+ */
+export declare function setTask(state: TickState, task: TickState['task']): TickState;
+/**
+ * Updates builder result in tick state.
+ *
+ * @param state - Current tick state
+ * @param builderResult - Builder result to set
+ * @returns Updated tick state
+ */
+export declare function setBuilderResult(state: TickState, builderResult: TickState['builder_result']): TickState;
+/**
+ * Appends a stop history entry to guardrail state, capping at 50 entries.
+ *
+ * @param state - Current tick state
+ * @param entry - Stop history entry to add
+ * @returns Updated tick state
+ */
+export declare function appendStopHistory(state: TickState, entry: StopHistoryEntry): TickState;
+/**
+ * Clears force patch flag (sets force_patch_until_success to false).
+ *
+ * Called when a patch succeeds to reset escalation state.
+ *
+ * @param state - Current tick state
+ * @returns Updated tick state
+ */
+export declare function clearForcePatch(state: TickState): TickState;
+/**
+ * Sets force patch flag (sets force_patch_until_success to true).
+ *
+ * Called to enable escalation mode when guardrails trigger.
+ *
+ * @param state - Current tick state
+ * @returns Updated tick state
+ */
+export declare function setForcePatch(state: TickState): TickState;
+/**
+ * Updates the task fingerprint in tick state.
+ *
+ * @param state - Current tick state
+ * @param fingerprint - SHA256 fingerprint of the current task
+ * @returns Updated tick state
+ */
+export declare function updateTaskFingerprint(state: TickState, fingerprint: string): TickState;
+/**
+ * Updates failure tracking when a task fails.
+ *
+ * Increments failure_streak and updates last_failed_fingerprint.
+ *
+ * @param state - Current tick state
+ * @param fingerprint - SHA256 fingerprint of the failed task
+ * @returns Updated tick state
+ */
+export declare function recordTaskFailure(state: TickState, fingerprint: string): TickState;
+/**
+ * Resets failure streak when a task succeeds.
+ *
+ * @param state - Current tick state
+ * @returns Updated tick state
+ */
+export declare function resetFailureStreak(state: TickState): TickState;
+/**
+ * Appends a verify history entry, capping at 50 entries.
+ *
+ * @param state - Current tick state
+ * @param entry - Verify history entry to add
+ * @returns Updated tick state
+ */
+export declare function appendVerifyHistory(state: TickState, entry: VerifyHistoryEntry): TickState;
+/**
+ * Increments the retry count for transport stall recovery.
+ *
+ * @param state - Current tick state
+ * @returns Updated tick state with incremented retry_count
+ */
+export declare function incrementRetryCount(state: TickState): TickState;
+/**
+ * Records a transport stall error in state.
+ *
+ * Used to track the last error kind and request ID for debugging
+ * and retry policy decisions.
+ *
+ * @param state - Current tick state
+ * @param errorKind - Kind of error (e.g., 'transport_stalled')
+ * @param requestId - Request ID from the stall (for debugging)
+ * @returns Updated tick state
+ */
+export declare function recordTransportStall(state: TickState, errorKind: string, requestId: string | null): TickState;
+/**
+ * Resets retry state after a successful tick.
+ *
+ * Clears retry_count, last_error_kind, and last_request_id.
+ * Called when a tick completes successfully to reset recovery state.
+ *
+ * @param state - Current tick state
+ * @returns Updated tick state with cleared retry fields
+ */
+export declare function resetRetryState(state: TickState): TickState;
+//# sourceMappingURL=state.d.ts.map