@eddacraft/anvil-runtime 0.1.0

package/dist/gate/rules/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Category of command rule
+ */
+export type CommandCategory = 'git' | 'filesystem' | 'shell' | 'custom';
+/**
+ * Action to take when a rule matches
+ */
+export type CommandAction = 'block' | 'warn' | 'allow';
+/**
+ * Severity level for rule violations
+ */
+export type CommandSeverity = 'error' | 'warning' | 'info';
+/**
+ * Flag matching configuration for a rule
+ */
+export interface CommandFlagConfig {
+    /** Flags where ANY ONE must be present for the rule to match (OR logic) */
+    required?: string[];
+    /** Flags where ALL must be present for the rule to match (AND logic) */
+    requiredAll?: string[];
+    /** Flags that must NOT be present for the rule to match */
+    forbidden?: string[];
+    /** Flags that make the command dangerous when present */
+    dangerous?: string[];
+}
+/**
+ * Argument matching configuration for a rule
+ */
+export interface CommandArgConfig {
+    /** Regex pattern to match against arguments */
+    pattern?: RegExp;
+    /** Specific argument position to check (0-indexed) */
+    position?: number;
+}
+/**
+ * Conditions for when a rule applies
+ */
+export interface CommandConditions {
+    /** Only apply in strict mode */
+    strictModeOnly?: boolean;
+    /** Working directory restrictions */
+    workingDirectory?: 'home' | 'root' | 'any';
+}
+/**
+ * A command safety rule definition.
+ *
+ * Rules are matched by specificity: command + subcommand + flags + args.
+ * More specific rules take precedence over less specific ones.
+ */
+export interface CommandRule {
+    /** Unique identifier for the rule (e.g., 'git-reset-hard') */
+    id: string;
+    /** Category of the rule */
+    category: CommandCategory;
+    /** Base command to match (e.g., 'git', 'rm') */
+    command: string;
+    /** Optional subcommand to match (e.g., 'reset', 'push') */
+    subcommand?: string;
+    /** Flag matching configuration */
+    flags?: CommandFlagConfig;
+    /** Argument matching configuration */
+    args?: CommandArgConfig;
+    /** Action to take when the rule matches */
+    action: CommandAction;
+    /** Severity level for reporting */
+    severity: CommandSeverity;
+    /** Human-readable explanation of why this is blocked/warned */
+    reason: string;
+    /** Suggested safe alternative */
+    suggestion?: string;
+    /** Reference links for more information */
+    references?: string[];
+    /** Conditions for when the rule applies */
+    conditions?: CommandConditions;
+}
+/**
+ * A collection of command rules
+ */
+export interface CommandRuleset {
+    /** Ruleset version */
+    version: string;
+    /** Array of rules */
+    rules: CommandRule[];
+}
+/**
+ * A parsed shell command with extracted components.
+ *
+ * This is the output of the CommandParser.
+ */
+export interface ParsedCommand {
+    /** Original raw command string */
+    raw: string;
+    /** Base command (e.g., 'git', 'rm', 'bash') */
+    command: string;
+    /** Subcommand if applicable (e.g., 'reset', 'push') */
+    subcommand?: string;
+    /** Extracted flags (e.g., ['--hard', '-f', '-r']) */
+    flags: string[];
+    /** Extracted arguments (non-flag tokens) */
+    args: string[];
+    /** The unwrapped command after stripping wrappers */
+    unwrapped: string;
+    /** Chain of wrappers that were stripped (e.g., ['sudo', 'bash']) */
+    wrapperChain: string[];
+}
+/**
+ * Result of analysing a single command against the ruleset.
+ */
+export interface CommandAnalysisResult {
+    /** Original command string */
+    command: string;
+    /** Parsed command structure */
+    parsedCommand: ParsedCommand;
+    /** The rule that matched, if any */
+    matchedRule?: CommandRule;
+    /** Resolved action to take */
+    action: CommandAction;
+    /** Resolved severity level */
+    severity: CommandSeverity;
+    /** Reason for the action (from matched rule) */
+    reason?: string;
+    /** Suggested alternative (from matched rule) */
+    suggestion?: string;
+    /** Reference links (from matched rule) */
+    references?: string[];
+}
+/**
+ * Summary of command analysis results.
+ */
+export interface CommandAnalysisSummary {
+    /** Total commands analysed */
+    total: number;
+    /** Number of blocked commands */
+    blocked: number;
+    /** Number of warned commands */
+    warned: number;
+    /** Number of allowed commands */
+    allowed: number;
+}
+/**
+ * Override configuration for a specific rule.
+ */
+export interface CommandRuleOverride {
+    /** Rule ID to override */
+    id: string;
+    /** Override action (or 'disable' to completely disable) */
+    action?: CommandAction | 'disable';
+    /** Override severity */
+    severity?: CommandSeverity;
+}
+/**
+ * Rules configuration section.
+ */
+export interface CommandRulesConfig {
+    /** Override existing rules */
+    overrides?: CommandRuleOverride[];
+    /** Add custom rules */
+    custom?: CommandRule[];
+    /** Disable specific rules by ID */
+    disabled?: string[];
+}
+/**
+ * Working directory configuration.
+ */
+export interface WorkingDirectoryConfig {
+    /** Allow rm -rf in current working directory */
+    allowDeleteInCwd?: boolean;
+    /** Additional patterns to treat as temp directories */
+    tempDirPatterns?: string[];
+}
+/**
+ * Output configuration.
+ */
+export interface CommandSafetyOutputConfig {
+    /** Include full command in error messages */
+    verbose?: boolean;
+    /** Show safe alternative suggestions */
+    showSuggestions?: boolean;
+    /** Show reference links */
+    showReferences?: boolean;
+}
+/**
+ * Command safety check configuration.
+ *
+ * This is loaded from `.anvilrc` under the `commandSafety` key.
+ */
+export interface CommandSafetyConfig {
+    /** Enable/disable the check (default: true) */
+    enabled?: boolean;
+    /** Strict mode - block unparseable commands (default: false) */
+    strict?: boolean;
+    /** Rule customisation */
+    rules?: CommandRulesConfig;
+    /** Working directory restrictions */
+    workingDirectory?: WorkingDirectoryConfig;
+    /** Output customisation */
+    output?: CommandSafetyOutputConfig;
+}
+/**
+ * Resolved configuration with all defaults applied.
+ */
+export interface ResolvedCommandSafetyConfig {
+    enabled: boolean;
+    strict: boolean;
+    rules: CommandRule[];
+    workingDirectory: Required<WorkingDirectoryConfig>;
+    output: Required<CommandSafetyOutputConfig>;
+}
+/**
+ * Detailed information about a blocked or warned command.
+ */
+export interface CommandSafetyFinding {
+    /** The command that was flagged */
+    command: string;
+    /** The rule ID that matched */
+    ruleId: string;
+    /** Category of the rule */
+    category: CommandCategory;
+    /** Action taken (block or warn) */
+    action: Exclude<CommandAction, 'allow'>;
+    /** Severity level */
+    severity: CommandSeverity;
+    /** Human-readable reason */
+    reason: string;
+    /** Suggested safe alternative */
+    suggestion?: string;
+    /** Reference links */
+    references?: string[];
+    /** Source location if available (e.g., plan file path) */
+    source?: string;
+}
+/**
+ * Result details from the command safety check.
+ */
+export interface CommandSafetyDetails {
+    /** Commands that were blocked */
+    blocked: CommandSafetyFinding[];
+    /** Commands that triggered warnings */
+    warnings: CommandSafetyFinding[];
+    /** Summary statistics */
+    summary: CommandAnalysisSummary;
+    /** Configuration that was used */
+    config?: {
+        strict: boolean;
+        rulesCount: number;
+        customRulesCount: number;
+        disabledRulesCount: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/gate/rules/types.d.ts.map

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

package/dist/gate/rules/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @eddacraft/anvil-runtime
+ *
+ * Orchestration and I/O for the Anvil system.
+ * Contains gate runner, cache providers, file watcher, export utilities,
+ * and multi-agent concurrency coordination.
+ *
+ * This package handles all I/O operations that @eddacraft/anvil-core does not.
+ *
+ * @module @eddacraft/anvil-runtime
+ */
+export * from './gate/index.js';
+export * from './cache/index.js';
+export { WatchConfigSchema, WatchGitConfigSchema, parseWatchConfig, getDefaultWatchConfig, DEFAULT_WATCH_PATTERNS, DEFAULT_EXCLUDE_PATTERNS, GitStatusChecker, createGitStatusChecker, getChangedFiles, ChangeDebouncer, createDebouncer, FileWatcher, createFileWatcher, WatchOrchestrator, createWatchOrchestrator, } from './watch/index.js';
+export type { WatchConfig as DetailedWatchConfig, WatchGitConfig, GitFileStatus, WatchChangeEvent, DebouncedChanges, WatchStatusEvent, WatchStatusEventType, WatchActionResult, WatchOrchestratorOptions, GetChangedFilesOptions, DebouncerFlushCallback, FileWatcherOptions, FileWatcherEvents, ActionHandler, MultiAgentConfig, } from './watch/index.js';
+export * from './export/index.js';
+export { AgentTypeSchema, AgentInfoSchema, AgentRegistrationSchema, AgentRegistrySchema, LockTypeSchema, LockRecordSchema, LockFileSchema, QueueEntrySchema, QueueFileSchema, ConcurrencyConfigSchema, getDefaultConcurrencyConfig, AgentManager, createAgentManager, initializeGlobalAgent, getGlobalAgent, detectAgentType, getAgentId, getSessionId, getAgentName, createAgentInfo, LockManager, createLockManager, withLock, tryWithLock, QueueManager, createQueueManager, coordinatedExecution, withConcurrencyLimit, GIT_TRAILERS, parseCommitTrailers, extractAgentInfo, getCommitAgentInfo, getRecentCommitsAgentInfo, formatCommitWithAgent, prepareCommitMsgHook, getHookSetupCommand, getAgentContributions, getAiCommitPercentage, atomicWriteJson, atomicWriteText, readJsonSafe, readJsonWithRetry, acquireFileLock, tryAcquireFileLock, isLocked, forceReleaseLock, unlinkSafe, fileExists, getFileMtime, sleepWithJitter, createConcurrencyContext, createSimpleLockContext, } from './concurrency/index.js';
+export type { AgentType, AgentInfo, AgentRegistration, AgentRegistry, LockType, LockRecord, LockFile, LockAcquisitionResult, LockReleaseResult, QueueEntry, QueueFile, QueueJoinResult, QueueStatusResult, CoordinationEvent, CoordinationEventType, ConcurrencyConfig, AgentManagerOptions, LockManagerOptions, AcquireLockOptions, QueueManagerOptions, QueueJoinOptions, QueueWaitOptions, ConcurrencyContextOptions, ConcurrencyContext, ConcurrentGroupResult, CommitAgentInfo, FormatCommitOptions, AgentContributionSummary, AtomicWriteOptions, FileLockOptions, FileLockHandle, } from './concurrency/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,WAAW,IAAI,mBAAmB,EAClC,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAEL,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAE3B,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EAEf,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,WAAW,EAEX,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EAEpB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EAErB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EAEf,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAEV,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAEjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EAErB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EAExB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * @eddacraft/anvil-runtime
+ *
+ * Orchestration and I/O for the Anvil system.
+ * Contains gate runner, cache providers, file watcher, export utilities,
+ * and multi-agent concurrency coordination.
+ *
+ * This package handles all I/O operations that @eddacraft/anvil-core does not.
+ *
+ * @module @eddacraft/anvil-runtime
+ */
+// Gate runner and checks (includes types from @eddacraft/anvil-contracts)
+export * from './gate/index.js';
+// Cache providers
+export * from './cache/index.js';
+// File watching - export specific items to avoid WatchConfig conflict
+export { WatchConfigSchema, WatchGitConfigSchema, parseWatchConfig, getDefaultWatchConfig, DEFAULT_WATCH_PATTERNS, DEFAULT_EXCLUDE_PATTERNS, GitStatusChecker, createGitStatusChecker, getChangedFiles, ChangeDebouncer, createDebouncer, FileWatcher, createFileWatcher, WatchOrchestrator, createWatchOrchestrator, } from './watch/index.js';
+// Export utilities (llms.txt, MCP, etc.)
+export * from './export/index.js';
+// Multi-agent concurrency coordination
+export { 
+// Types and schemas
+AgentTypeSchema, AgentInfoSchema, AgentRegistrationSchema, AgentRegistrySchema, LockTypeSchema, LockRecordSchema, LockFileSchema, QueueEntrySchema, QueueFileSchema, ConcurrencyConfigSchema, getDefaultConcurrencyConfig, 
+// Agent management
+AgentManager, createAgentManager, initializeGlobalAgent, getGlobalAgent, detectAgentType, getAgentId, getSessionId, getAgentName, createAgentInfo, 
+// Lock management
+LockManager, createLockManager, withLock, tryWithLock, 
+// Queue management
+QueueManager, createQueueManager, coordinatedExecution, withConcurrencyLimit, 
+// Git agent identification
+GIT_TRAILERS, parseCommitTrailers, extractAgentInfo, getCommitAgentInfo, getRecentCommitsAgentInfo, formatCommitWithAgent, prepareCommitMsgHook, getHookSetupCommand, getAgentContributions, getAiCommitPercentage, 
+// Atomic operations
+atomicWriteJson, atomicWriteText, readJsonSafe, readJsonWithRetry, acquireFileLock, tryAcquireFileLock, isLocked, forceReleaseLock, unlinkSafe, fileExists, getFileMtime, sleepWithJitter, 
+// High-level context
+createConcurrencyContext, createSimpleLockContext, } from './concurrency/index.js';

package/dist/types/gate.types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Gate Types for @eddacraft/anvil-runtime
+ *
+ * Re-exports types from @eddacraft/anvil-contracts and provides runtime utility functions.
+ */
+import type { CheckContext, NormaliseFilesOptions } from '@eddacraft/anvil-core';
+export type { APSPlan, Change, ChangeType, Provenance, Validation, EvidenceEntry, Evidence, Approval, ExecutionResult, SchemaValidationResult, GateConfig, GateCheck, GateResult, GateResultDetails, GateRunResult, CheckContext, PlanData, WatchConfig, PolicyConfig, PolicyBundleConfig, PolicyVerificationConfig, SignatureAlgorithm, StackConfig, StackLayerConfig, StackValidationConfig, ArchitectureContextBase, NormaliseFilesOptions, } from '@eddacraft/anvil-core';
+export { APSPlanSchema, APS_SCHEMA_VERSION, ChangeTypeSchema, ChangeSchema, ProvenanceSchema, ValidationSchema, EvidenceEntrySchema, EvidenceSchema, ApprovalSchema, ExecutionResultSchema, validatePlan, createPlan, generateJSONSchema, getWarningsFromResult, hasBlockingWarnings, } from '@eddacraft/anvil-core';
+/**
+ * Normalise target files to absolute paths and filter non-existent files.
+ *
+ * This ensures consistent behaviour between plan-based and planless modes:
+ * - Converts workspace-relative paths to absolute paths
+ * - Filters out non-existent files (unless checkExists is false)
+ * - Applies optional filter function
+ *
+ * @param targetFiles - Array of file paths (relative or absolute)
+ * @param workspaceRoot - Workspace root directory
+ * @param options - Normalisation options
+ * @returns Array of absolute paths to existing files
+ */
+export declare function normaliseTargetFiles(targetFiles: string[], workspaceRoot: string, options?: NormaliseFilesOptions): string[];
+/**
+ * Get files from CheckContext, handling both plan-based and planless modes consistently.
+ *
+ * For planless mode (targetFiles provided):
+ * - Normalises paths to absolute
+ * - Filters non-existent files
+ * - Applies optional filter function
+ *
+ * For plan-based mode:
+ * - Extracts file paths from proposed_changes
+ * - Joins with workspace_root
+ * - Filters non-existent files (except for file_delete)
+ * - Applies optional filter function
+ *
+ * @param context - Check context
+ * @param options - Options including filter function
+ * @returns Array of absolute paths to files
+ */
+export declare function getFilesFromContext(context: CheckContext, options?: NormaliseFilesOptions): string[];
+//# sourceMappingURL=gate.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gate.types.d.ts","sourceRoot":"","sources":["../../src/types/gate.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,YAAY,EACV,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,qBAA0B,GAClC,MAAM,EAAE,CAsBV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,qBAA0B,GAClC,MAAM,EAAE,CAsCV"}

package/dist/types/gate.types.js

@@ -0,0 +1,94 @@
+/**
+ * Gate Types for @eddacraft/anvil-runtime
+ *
+ * Re-exports types from @eddacraft/anvil-contracts and provides runtime utility functions.
+ */
+import { existsSync } from 'node:fs';
+import { join, isAbsolute } from 'node:path';
+export { APSPlanSchema, APS_SCHEMA_VERSION, ChangeTypeSchema, ChangeSchema, ProvenanceSchema, ValidationSchema, EvidenceEntrySchema, EvidenceSchema, ApprovalSchema, ExecutionResultSchema, validatePlan, createPlan, generateJSONSchema, getWarningsFromResult, hasBlockingWarnings, } from '@eddacraft/anvil-core';
+// =============================================================================
+// Path Normalisation Helpers (runtime-specific with fs operations)
+// =============================================================================
+/**
+ * Normalise target files to absolute paths and filter non-existent files.
+ *
+ * This ensures consistent behaviour between plan-based and planless modes:
+ * - Converts workspace-relative paths to absolute paths
+ * - Filters out non-existent files (unless checkExists is false)
+ * - Applies optional filter function
+ *
+ * @param targetFiles - Array of file paths (relative or absolute)
+ * @param workspaceRoot - Workspace root directory
+ * @param options - Normalisation options
+ * @returns Array of absolute paths to existing files
+ */
+export function normaliseTargetFiles(targetFiles, workspaceRoot, options = {}) {
+    const { filter, checkExists = true } = options;
+    return targetFiles
+        .map((filePath) => {
+        // Convert to absolute path if relative
+        if (isAbsolute(filePath)) {
+            return filePath;
+        }
+        return join(workspaceRoot, filePath);
+    })
+        .filter((absolutePath) => {
+        // Check existence if required
+        if (checkExists && !existsSync(absolutePath)) {
+            return false;
+        }
+        // Apply custom filter if provided
+        if (filter && !filter(absolutePath)) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Get files from CheckContext, handling both plan-based and planless modes consistently.
+ *
+ * For planless mode (targetFiles provided):
+ * - Normalises paths to absolute
+ * - Filters non-existent files
+ * - Applies optional filter function
+ *
+ * For plan-based mode:
+ * - Extracts file paths from proposed_changes
+ * - Joins with workspace_root
+ * - Filters non-existent files (except for file_delete)
+ * - Applies optional filter function
+ *
+ * @param context - Check context
+ * @param options - Options including filter function
+ * @returns Array of absolute paths to files
+ */
+export function getFilesFromContext(context, options = {}) {
+    const { filter, checkExists = true } = options;
+    // Planless mode: use targetFiles
+    if (context.targetFiles && context.targetFiles.length > 0) {
+        return normaliseTargetFiles(context.targetFiles, context.workspace_root, options);
+    }
+    // Plan-based mode: extract from proposed_changes
+    const files = [];
+    if (context.plan) {
+        for (const change of context.plan.proposed_changes) {
+            const isFileChange = change.type === 'file_create' ||
+                change.type === 'file_update' ||
+                change.type === 'file_delete';
+            if (!isFileChange || !change.path) {
+                continue;
+            }
+            // Apply filter if provided
+            if (filter && !filter(change.path)) {
+                continue;
+            }
+            const fullPath = join(context.workspace_root, change.path);
+            // For file_delete, don't check existence
+            // For other changes, check existence if required
+            if (change.type === 'file_delete' || !checkExists || existsSync(fullPath)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}

package/dist/watch/debouncer.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Change Debouncer
+ *
+ * Coalesces rapid file changes into batches to prevent
+ * excessive action triggers during editor auto-save or
+ * multi-file operations.
+ */
+import type { DebouncedChanges } from './types.js';
+/**
+ * Callback type for debounced flush
+ */
+export type DebouncerFlushCallback = (changes: DebouncedChanges) => void;
+/**
+ * Debouncer for file changes
+ *
+ * Accumulates file paths and flushes them as a batch
+ * after a configurable delay.
+ */
+export declare class ChangeDebouncer {
+    private delayMs;
+    private onFlush;
+    private pendingFiles;
+    private timer;
+    /**
+     * Create a new debouncer
+     *
+     * @param delayMs - Debounce delay in milliseconds
+     * @param onFlush - Callback when changes are flushed
+     */
+    constructor(delayMs: number, onFlush: DebouncerFlushCallback);
+    /**
+     * Add a file to the pending changes
+     *
+     * Resets the debounce timer each time a file is added.
+     *
+     * @param filePath - Absolute file path
+     */
+    add(filePath: string): void;
+    /**
+     * Add multiple files to pending changes
+     *
+     * @param filePaths - Array of absolute file paths
+     */
+    addMany(filePaths: string[]): void;
+    /**
+     * Immediately flush pending changes
+     *
+     * Clears the timer and invokes the callback with all
+     * accumulated files.
+     */
+    flush(): void;
+    /**
+     * Cancel pending flush and clear accumulated files
+     */
+    cancel(): void;
+    /**
+     * Get count of pending files
+     */
+    get pendingCount(): number;
+    /**
+     * Check if there are pending changes
+     */
+    get hasPending(): boolean;
+    /**
+     * Get the current delay setting
+     */
+    get delay(): number;
+    /**
+     * Update the debounce delay
+     *
+     * Takes effect on next add() call.
+     */
+    setDelay(delayMs: number): void;
+    /**
+     * Reset the debounce timer
+     */
+    private resetTimer;
+    /**
+     * Clear the debounce timer
+     */
+    private clearTimer;
+}
+/**
+ * Create a change debouncer
+ *
+ * @param delayMs - Debounce delay in milliseconds (default: 300)
+ * @param onFlush - Callback when changes are flushed
+ */
+export declare function createDebouncer(delayMs: number, onFlush: DebouncerFlushCallback): ChangeDebouncer;
+//# sourceMappingURL=debouncer.d.ts.map

package/dist/watch/debouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.d.ts","sourceRoot":"","sources":["../../src/watch/debouncer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEzE;;;;;GAKG;AACH,qBAAa,eAAe;IAWxB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IAXjB,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,KAAK,CAA8C;IAE3D;;;;;OAKG;gBAEO,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB;IAGzC;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM3B;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAOlC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAkBb;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,UAAU;CAMnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEjG"}