@eddacraft/anvil-runtime 0.1.0

package/dist/watch/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Watch Mode Types and Schemas
+ *
+ * Defines configuration and event types for file watching functionality.
+ */
+import { z } from 'zod';
+/**
+ * Git filter configuration
+ */
+export declare const WatchGitConfigSchema: z.ZodObject<{
+    unstagedOnly: z.ZodDefault<z.ZodBoolean>;
+    includeUntracked: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type WatchGitConfig = z.infer<typeof WatchGitConfigSchema>;
+/**
+ * Watch configuration schema for .anvilrc
+ */
+export declare const WatchConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    patterns: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    action: z.ZodDefault<z.ZodEnum<{
+        gate: "gate";
+        check: "check";
+        validate: "validate";
+    }>>;
+    debounceMs: z.ZodDefault<z.ZodNumber>;
+    git: z.ZodDefault<z.ZodObject<{
+        unstagedOnly: z.ZodDefault<z.ZodBoolean>;
+        includeUntracked: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    gateProfile: z.ZodOptional<z.ZodEnum<{
+        ci: "ci";
+        dev: "dev";
+        production: "production";
+    }>>;
+}, z.core.$strip>;
+export type WatchConfig = z.infer<typeof WatchConfigSchema>;
+/**
+ * Git file status from git status --porcelain
+ */
+export interface GitFileStatus {
+    /** File path relative to workspace root */
+    path: string;
+    /** Whether file is tracked by git */
+    isTracked: boolean;
+    /** Whether file has staged changes */
+    isStaged: boolean;
+    /** Whether file has unstaged changes */
+    isUnstaged: boolean;
+    /** Whether file is untracked */
+    isUntracked: boolean;
+    /** Raw status code from git (e.g., ' M', 'M ', '??') */
+    statusCode: string;
+}
+/**
+ * File change event from watcher
+ */
+export interface WatchChangeEvent {
+    /** Event type */
+    type: 'add' | 'change' | 'unlink';
+    /** Absolute file path */
+    path: string;
+    /** Timestamp of change */
+    timestamp: Date;
+}
+/**
+ * Debounced batch of changes
+ */
+export interface DebouncedChanges {
+    /** Files that changed */
+    files: string[];
+    /** Timestamp when batch was flushed */
+    timestamp: Date;
+}
+/**
+ * Watch status event types
+ */
+export type WatchStatusEventType = 'ready' | 'change' | 'action:start' | 'action:complete' | 'action:error' | 'action:queued' | 'lock:acquired' | 'lock:waiting' | 'lock:denied' | 'stopped';
+/**
+ * Action result from validate, gate, or check
+ */
+export interface WatchActionResult {
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Action type that was run */
+    action: 'validate' | 'gate' | 'check';
+    /** Files that were processed */
+    files: string[];
+    /** Execution time in ms */
+    executionTimeMs: number;
+    /** Detailed results (validation errors, gate results, warnings, etc.) */
+    details?: unknown;
+    /** Error message if action failed */
+    error?: string;
+}
+/**
+ * Status events emitted by watch orchestrator
+ */
+export type WatchStatusEvent = {
+    type: 'ready';
+    patterns: string[];
+    gitFilter: boolean;
+    agentId?: string;
+} | {
+    type: 'change';
+    files: string[];
+    filtered: string[];
+} | {
+    type: 'action:start';
+    action: 'validate' | 'gate' | 'check';
+    files: string[];
+} | {
+    type: 'action:complete';
+    result: WatchActionResult;
+} | {
+    type: 'action:error';
+    error: Error;
+    files: string[];
+} | {
+    type: 'action:queued';
+    action: 'validate' | 'gate' | 'check';
+    position: number;
+    files: string[];
+} | {
+    type: 'lock:acquired';
+    resource: string;
+    agentId: string;
+} | {
+    type: 'lock:waiting';
+    resource: string;
+    heldBy: string;
+    queuePosition?: number;
+} | {
+    type: 'lock:denied';
+    resource: string;
+    heldBy: string;
+    reason: string;
+} | {
+    type: 'stopped';
+};
+/**
+ * Multi-agent mode configuration
+ */
+export interface MultiAgentConfig {
+    /** Enable multi-agent coordination (default: true) */
+    enabled?: boolean;
+    /** Acquire exclusive watch lock (only one watcher per workspace) */
+    exclusiveWatch?: boolean;
+    /** Use coordinated action execution (queue + lock) */
+    coordinatedActions?: boolean;
+    /** Agent ID (auto-detected if not provided) */
+    agentId?: string;
+    /** Wait for watch lock instead of failing */
+    waitForLock?: boolean;
+    /** Lock wait timeout in ms (default: 30000) */
+    lockWaitTimeoutMs?: number;
+}
+/**
+ * Watch orchestrator options
+ */
+export interface WatchOrchestratorOptions {
+    /** Workspace root directory */
+    workspaceRoot: string;
+    /** Watch configuration */
+    config: WatchConfig;
+    /** Status event callback */
+    onEvent?: (event: WatchStatusEvent) => void;
+    /** Verbose logging */
+    verbose?: boolean;
+    /** Multi-agent coordination options */
+    multiAgent?: MultiAgentConfig;
+}
+/**
+ * Default watch patterns (reused from file-discovery)
+ */
+export declare const DEFAULT_WATCH_PATTERNS: string[];
+/**
+ * Default exclude patterns
+ */
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+/**
+ * Parse and validate watch config from raw object
+ */
+export declare function parseWatchConfig(raw: unknown): WatchConfig;
+/**
+ * Get default watch config
+ */
+export declare function getDefaultWatchConfig(): WatchConfig;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/watch/types.js

@@ -0,0 +1,76 @@
+/**
+ * Watch Mode Types and Schemas
+ *
+ * Defines configuration and event types for file watching functionality.
+ */
+import { z } from 'zod';
+/**
+ * Git filter configuration
+ */
+export const WatchGitConfigSchema = z.object({
+    /** Only watch files with unstaged changes (default: true) */
+    unstagedOnly: z.boolean().default(true),
+    /** Include untracked files in watch (default: true) */
+    includeUntracked: z.boolean().default(true),
+});
+/**
+ * Watch configuration schema for .anvilrc
+ */
+export const WatchConfigSchema = z.object({
+    /** Enable watch mode in config (default: false) */
+    enabled: z.boolean().default(false),
+    /** Glob patterns to watch (default: planning document patterns) */
+    patterns: z.array(z.string()).default(['**/*.md']),
+    /** Glob patterns to exclude */
+    exclude: z
+        .array(z.string())
+        .default(['node_modules/**', 'dist/**', 'build/**', '.git/**', 'coverage/**']),
+    /** Action to run on change: validate, gate, or check */
+    action: z.enum(['validate', 'gate', 'check']).default('validate'),
+    /** Debounce interval in milliseconds (default: 300) */
+    debounceMs: z.number().min(50).max(5000).default(300),
+    /** Git filter configuration */
+    git: WatchGitConfigSchema.default({ unstagedOnly: true, includeUntracked: true }),
+    /** Gate profile to use when action is 'gate' */
+    gateProfile: z.enum(['dev', 'ci', 'production']).optional(),
+});
+/**
+ * Default watch patterns (reused from file-discovery)
+ */
+export const DEFAULT_WATCH_PATTERNS = [
+    '**/*.md',
+    '**/prd.*',
+    '**/plan.*',
+    '**/todo.*',
+    '**/spec.*',
+    '**/requirements.*',
+    '**/rfc-*',
+    '**/adr-*',
+];
+/**
+ * Default exclude patterns
+ */
+export const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules/**',
+    'dist/**',
+    'build/**',
+    '.git/**',
+    'coverage/**',
+    '.next/**',
+    '.nuxt/**',
+    'out/**',
+    'target/**',
+    'vendor/**',
+];
+/**
+ * Parse and validate watch config from raw object
+ */
+export function parseWatchConfig(raw) {
+    return WatchConfigSchema.parse(raw);
+}
+/**
+ * Get default watch config
+ */
+export function getDefaultWatchConfig() {
+    return WatchConfigSchema.parse({});
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@eddacraft/anvil-runtime",
+  "version": "0.1.0",
+  "description": "Runtime orchestration layer for Anvil — gate runner, file watching, caching, exports",
+  "license": "PROPRIETARY",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./gate": {
+      "types": "./dist/gate/index.d.ts",
+      "import": "./dist/gate/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
+    },
+    "./watch": {
+      "types": "./dist/watch/index.d.ts",
+      "import": "./dist/watch/index.js"
+    },
+    "./export": {
+      "types": "./dist/export/index.d.ts",
+      "import": "./dist/export/index.js"
+    }
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "eslint": "^9.39.2",
+    "glob": "13.0.0",
+    "minimatch": "^10.2.0",
+    "shell-quote": "^1.8.3",
+    "zod": "^4.3.6",
+    "@eddacraft/anvil-core": "0.1.0",
+    "@eddacraft/anvil-policy": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/shell-quote": "^1.7.5",
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "anvil",
+    "runtime",
+    "orchestration"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}