@eddacraft/anvil-runtime 0.1.0

package/dist/cache/providers/null-cache.js

@@ -0,0 +1,50 @@
+/**
+ * Null cache provider (no-op)
+ * Used when caching is disabled via --no-cache flag
+ */
+import { createDebugger } from '@eddacraft/anvil-core';
+const debug = createDebugger('cache');
+/**
+ * Null cache provider - disables caching
+ *
+ * All operations are no-ops that return appropriate null/empty values.
+ * Used when:
+ * - --no-cache flag is passed
+ * - Caching is disabled in configuration
+ * - Testing scenarios where caching should be bypassed
+ */
+export class NullCacheProvider {
+    name = 'null';
+    stats = {
+        misses: 0,
+    };
+    async get(_key) {
+        debug(`null-cache get: key=${_key} (always miss)`);
+        this.stats.misses++;
+        return null;
+    }
+    async set(_key, _value, _options) {
+        debug(`null-cache set: key=${_key} (no-op)`);
+    }
+    async invalidate(_key) {
+        return false;
+    }
+    async invalidatePattern(_pattern) {
+        return 0;
+    }
+    async getStats() {
+        return {
+            hits: 0,
+            misses: this.stats.misses,
+            entries: 0,
+            size_bytes: 0,
+            hit_rate: 0,
+        };
+    }
+    async clear() {
+        this.stats.misses = 0;
+    }
+    async isAvailable() {
+        return true; // Null cache is always "available"
+    }
+}

package/dist/cache/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Cache types and interfaces for Anvil gate caching
+ */
+/**
+ * Cache entry with metadata
+ */
+export interface CacheEntry<T> {
+    /** The cached value */
+    value: T;
+    /** Timestamp when the entry was created */
+    created_at: number;
+    /** Timestamp when the entry expires (optional) */
+    expires_at?: number;
+    /** Cache key used to store this entry */
+    key: string;
+    /** Hash of the inputs that generated this cache entry */
+    input_hash: string;
+}
+/**
+ * Options for setting cache entries
+ */
+export interface CacheSetOptions {
+    /** Time-to-live in milliseconds (optional) */
+    ttl?: number;
+    /** Hash of the inputs that generated this value */
+    input_hash: string;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Total number of cache hits */
+    hits: number;
+    /** Total number of cache misses */
+    misses: number;
+    /** Total number of entries in cache */
+    entries: number;
+    /** Total size of cache in bytes (approximate) */
+    size_bytes: number;
+    /** Hit rate as a percentage (0-100) */
+    hit_rate: number;
+}
+/**
+ * Cache provider interface
+ * All cache implementations must implement this interface
+ */
+export interface CacheProvider {
+    /** Provider name for debugging */
+    readonly name: string;
+    /**
+     * Get a cached value by key
+     * @returns The cached entry or null if not found/expired
+     */
+    get<T>(key: string): Promise<CacheEntry<T> | null>;
+    /**
+     * Set a cached value
+     * @param key The cache key
+     * @param value The value to cache
+     * @param options Cache options including TTL and input hash
+     */
+    set<T>(key: string, value: T, options: CacheSetOptions): Promise<void>;
+    /**
+     * Invalidate a single cache entry
+     * @returns true if entry was found and removed
+     */
+    invalidate(key: string): Promise<boolean>;
+    /**
+     * Invalidate cache entries matching a pattern
+     * @param pattern Glob-like pattern (e.g., "gate:*", "check:eslint:*")
+     * @returns Number of entries invalidated
+     */
+    invalidatePattern(pattern: string): Promise<number>;
+    /**
+     * Get cache statistics
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if provider is available (e.g., directory exists for file cache)
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Cache key components for gate check results
+ */
+export interface GateCacheKeyInput {
+    /** Check name (e.g., "eslint", "coverage") */
+    check_name: string;
+    /** Plan hash */
+    plan_hash: string;
+    /** Check configuration hash */
+    config_hash: string;
+    /** Workspace root (normalised) */
+    workspace_root: string;
+    /** Optional extra discriminators */
+    extra?: Record<string, string>;
+}
+/**
+ * Result of a cached gate check lookup
+ */
+export interface CachedGateResult {
+    /** Whether the result was found in cache */
+    cached: boolean;
+    /** The gate result if cached */
+    result?: import('../types/gate.types.js').GateResult;
+    /** Cache entry metadata */
+    entry?: CacheEntry<import('../types/gate.types.js').GateResult>;
+    /** Time saved by cache hit (in ms) */
+    time_saved_ms?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,uBAAuB;IACvB,KAAK,EAAE,CAAC,CAAC;IACT,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,wBAAwB,EAAE,UAAU,CAAC;IACrD,2BAA2B;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,EAAE,UAAU,CAAC,CAAC;IAChE,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/cache/types.js

@@ -0,0 +1,4 @@
+/**
+ * Cache types and interfaces for Anvil gate caching
+ */
+export {};

package/dist/concurrency/agent.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agent Manager
+ *
+ * Handles agent identification, registration, and heartbeat management
+ * for multi-agent coordination in Anvil.
+ */
+import { type AgentInfo, type AgentRegistration, type AgentType, type ConcurrencyConfig } from './types.js';
+/**
+ * Detect agent type from environment
+ */
+export declare function detectAgentType(): AgentType;
+/**
+ * Get or generate agent ID
+ */
+export declare function getAgentId(): string;
+/**
+ * Get session ID if available
+ */
+export declare function getSessionId(): string | undefined;
+/**
+ * Get agent name from environment or generate one
+ */
+export declare function getAgentName(): string;
+/**
+ * Create agent info from environment
+ */
+export declare function createAgentInfo(overrides?: Partial<AgentInfo>): AgentInfo;
+/**
+ * Options for AgentManager
+ */
+export interface AgentManagerOptions {
+    /** Workspace root directory */
+    workspaceRoot: string;
+    /** Concurrency configuration */
+    config?: Partial<ConcurrencyConfig>;
+    /** Agent info (auto-detected if not provided) */
+    agentInfo?: AgentInfo;
+}
+/**
+ * Agent Manager
+ *
+ * Manages agent registration, heartbeat, and lifecycle in a multi-agent environment.
+ */
+export declare class AgentManager {
+    private readonly workspaceRoot;
+    private readonly config;
+    private readonly agent;
+    private readonly registryPath;
+    private heartbeatTimer;
+    private isRegistered;
+    constructor(options: AgentManagerOptions);
+    /**
+     * Check if agent is registered
+     */
+    get registered(): boolean;
+    /**
+     * Get the current agent info
+     */
+    getAgent(): AgentInfo;
+    /**
+     * Get the agent ID
+     */
+    getAgentId(): string;
+    /**
+     * Register this agent
+     */
+    register(operation?: string): Promise<void>;
+    /**
+     * Start heartbeat timer
+     */
+    startHeartbeat(): void;
+    /**
+     * Stop heartbeat timer
+     */
+    stopHeartbeat(): void;
+    /**
+     * Send a heartbeat
+     */
+    heartbeat(operation?: string): Promise<void>;
+    /**
+     * Update current operation
+     */
+    setOperation(operation: string | undefined): Promise<void>;
+    /**
+     * Unregister this agent
+     */
+    unregister(): Promise<void>;
+    /**
+     * Get all registered agents
+     */
+    getAllAgents(): Promise<AgentRegistration[]>;
+    /**
+     * Get active agents
+     */
+    getActiveAgents(): Promise<AgentRegistration[]>;
+    /**
+     * Cleanup stale agents
+     */
+    cleanupStaleAgents(): Promise<string[]>;
+    /**
+     * Check if an agent is stale
+     */
+    isAgentStale(agentId: string): Promise<boolean>;
+    /**
+     * Check if a process is still running
+     */
+    isProcessRunning(pid: number): boolean;
+    /**
+     * Get git user for commit trailers
+     */
+    getGitAgentTrailer(): string;
+    /**
+     * Load registry from file
+     */
+    private loadRegistry;
+    /**
+     * Save registry to file
+     */
+    private saveRegistry;
+    /**
+     * Ensure registry directory exists
+     */
+    private ensureDir;
+}
+/**
+ * Create an agent manager
+ */
+export declare function createAgentManager(options: AgentManagerOptions): AgentManager;
+/**
+ * Initialize global agent manager
+ */
+export declare function initializeGlobalAgent(options: AgentManagerOptions): AgentManager;
+/**
+ * Get global agent manager
+ */
+export declare function getGlobalAgent(): AgentManager | null;
+//# sourceMappingURL=agent.d.ts.map

package/dist/concurrency/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/concurrency/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AAuCpB;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAkD3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA4BnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAOjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CA6BrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CASzE;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IAEtB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEpC,iDAAiD;IACjD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,mBAAmB;IAUxC;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjD;;OAEG;IACH,cAAc,IAAI,IAAI;IAmBtB;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;OAEG;IACG,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlD;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKlD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYrD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAyB7C;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrD;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUtC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;YACW,YAAY;IAI1B;;OAEG;YACW,SAAS;CAIxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAE7E;AAOD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAGhF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAEpD"}