@a5c-ai/agent-runtime 5.0.1-staging.04ca6ab00d21

package/dist/daemon/automationExecutor.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Shared automation-rule execution path for daemon timer and webhook triggers.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeAutomationTrigger = executeAutomationTrigger;
+const node_fs_1 = require("node:fs");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const DEFAULT_BACKLOG_FILE_PATH = process.env.KANBAN_BACKLOG_FILE
+    ?? node_path_1.default.join(node_os_1.default.homedir(), ".a5c", "kanban-backlog.json");
+function cloneRecord(value) {
+    return value ? { ...value } : undefined;
+}
+async function readAutomationStorage(backlogFilePath) {
+    try {
+        const raw = await node_fs_1.promises.readFile(backlogFilePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const errno = error;
+        if (errno.code === "ENOENT") {
+            return {};
+        }
+        throw error;
+    }
+}
+async function writeAutomationStorage(backlogFilePath, payload) {
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(backlogFilePath), { recursive: true });
+    await node_fs_1.promises.writeFile(backlogFilePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+}
+function createTriggerMetadata(rule) {
+    if (rule.trigger.type === "timer") {
+        return {
+            triggerType: "timer",
+            cron: rule.trigger.cron,
+            timezone: rule.trigger.timezone,
+        };
+    }
+    return {
+        triggerType: "webhook",
+        port: rule.trigger.port,
+        path: rule.trigger.path ?? "/trigger",
+        method: rule.trigger.method ?? "POST",
+        sourceEvent: rule.trigger.sourceEvent,
+    };
+}
+function nextIssueNumber(project, issues) {
+    const prefix = `${project.key}-AUTO-`;
+    return issues.reduce((max, issue) => {
+        if (!issue.key.startsWith(prefix)) {
+            return max;
+        }
+        const rawNumber = issue.key.slice(prefix.length);
+        const parsed = Number.parseInt(rawNumber, 10);
+        return Number.isFinite(parsed) ? Math.max(max, parsed) : max;
+    }, 0) + 1;
+}
+function resolveProjectCollections(project, template) {
+    const labelsById = new Map(project.labels.map((label) => [label.id, label]));
+    const assigneesById = new Map(project.assignees.map((assignee) => [assignee.id, assignee]));
+    return {
+        labels: (template.labelIds ?? [])
+            .map((labelId) => labelsById.get(labelId))
+            .filter((label) => Boolean(label)),
+        assignees: (template.assigneeIds ?? [])
+            .map((assigneeId) => assigneesById.get(assigneeId))
+            .filter((assignee) => Boolean(assignee)),
+    };
+}
+function resolveIssueSource(rule) {
+    if (rule.template.issueSource) {
+        return { ...rule.template.issueSource };
+    }
+    if (rule.source.kind === "config-file") {
+        return {
+            kind: "file",
+            path: rule.source.path,
+            externalId: rule.source.externalId ?? rule.id,
+        };
+    }
+    return {
+        kind: "run-derived",
+        externalId: rule.source.externalId ?? rule.id,
+    };
+}
+function createAcceptanceCriteria(issueId, criteria) {
+    return (criteria ?? []).map((title, index) => ({
+        id: `${issueId}-ac-${index + 1}`,
+        title,
+        satisfied: false,
+    }));
+}
+function createDecomposition(issueId, items) {
+    return (items ?? []).map((item, index) => ({
+        id: `${issueId}-decomp-${index + 1}`,
+        title: item.title,
+        kind: item.kind,
+        status: item.status,
+        issueId: undefined,
+    }));
+}
+function createAutomationIssue(rule, project, issues, now) {
+    const sequence = nextIssueNumber(project, issues);
+    const issueKey = `${project.key}-AUTO-${String(sequence).padStart(3, "0")}`;
+    const issueId = issueKey;
+    const { labels, assignees } = resolveProjectCollections(project, rule.template);
+    return {
+        id: issueId,
+        key: issueKey,
+        projectId: rule.target.projectId,
+        title: rule.template.title,
+        summary: rule.template.summary,
+        description: rule.template.description,
+        status: rule.template.status ?? "backlog",
+        priority: rule.template.priority ?? "medium",
+        labels,
+        assignees,
+        dependencies: [],
+        acceptanceCriteria: createAcceptanceCriteria(issueId, rule.template.acceptanceCriteria),
+        decomposition: createDecomposition(issueId, rule.template.decomposition),
+        childIssueIds: [],
+        createdAt: now,
+        updatedAt: now,
+        source: resolveIssueSource(rule),
+    };
+}
+function createExecutionRecord(rule, event, now, overrides) {
+    return {
+        id: `automation-exec-${(0, node_crypto_1.randomUUID)().toLowerCase()}`,
+        ruleId: rule.id,
+        ruleName: rule.name,
+        triggerType: rule.trigger.type,
+        status: overrides.status,
+        triggeredAt: now,
+        triggeredBy: `daemon-${rule.trigger.type}`,
+        source: {
+            ...rule.source,
+            metadata: cloneRecord(rule.source.metadata),
+        },
+        projectId: rule.target.projectId,
+        boardProjectId: rule.target.boardProjectId,
+        issueId: overrides.issue?.id,
+        issueKey: overrides.issue?.key,
+        issueSource: overrides.issue?.source,
+        stateAtExecution: rule.state,
+        skipReason: overrides.skipReason,
+        inputs: event.inputs ? { ...event.inputs } : undefined,
+        metadata: createTriggerMetadata(rule),
+    };
+}
+async function executeAutomationTrigger(event, options = {}) {
+    const backlogFilePath = options.backlogFilePath ?? DEFAULT_BACKLOG_FILE_PATH;
+    const now = options.now?.() ?? new Date().toISOString();
+    const storage = await readAutomationStorage(backlogFilePath);
+    const rules = [...(storage.automationRules ?? [])];
+    const rule = rules.find((candidate) => candidate.id === event.rule.id) ?? event.rule;
+    if (rule.state !== "active") {
+        const execution = createExecutionRecord(rule, event, now, {
+            status: "skipped",
+            skipReason: `Rule ${rule.id} is ${rule.state}.`,
+        });
+        await writeAutomationStorage(backlogFilePath, {
+            ...storage,
+            automationExecutions: [...(storage.automationExecutions ?? []), execution],
+        });
+        return execution;
+    }
+    const projects = [...(storage.projects ?? [])];
+    const issueProject = projects.find((candidate) => candidate.id === rule.target.projectId);
+    const boardProject = projects.find((candidate) => candidate.id === rule.target.boardProjectId);
+    if (!issueProject || !boardProject) {
+        const missingTarget = !issueProject
+            ? `Project ${rule.target.projectId}`
+            : `Board project ${rule.target.boardProjectId}`;
+        const execution = createExecutionRecord(rule, event, now, {
+            status: "skipped",
+            skipReason: `${missingTarget} not found.`,
+        });
+        await writeAutomationStorage(backlogFilePath, {
+            ...storage,
+            automationExecutions: [...(storage.automationExecutions ?? []), execution],
+        });
+        return execution;
+    }
+    const issues = [...(storage.issues ?? [])];
+    const issue = createAutomationIssue(rule, issueProject, issues, now);
+    const execution = createExecutionRecord(rule, event, now, {
+        status: "created",
+        issue,
+    });
+    const nextRules = rules.length > 0
+        ? rules.map((candidate) => (candidate.id === rule.id
+            ? {
+                ...candidate,
+                audit: {
+                    ...candidate.audit,
+                    lastTriggeredAt: now,
+                    lastTriggeredBy: execution.triggeredBy,
+                },
+            }
+            : candidate))
+        : storage.automationRules;
+    const nextProjects = projects.map((candidate) => (candidate.id === issueProject.id || candidate.id === boardProject.id
+        ? {
+            ...candidate,
+            issueIds: Array.from(new Set([...candidate.issueIds, issue.id])),
+        }
+        : candidate));
+    await writeAutomationStorage(backlogFilePath, {
+        ...storage,
+        projects: nextProjects,
+        issues: [...issues, issue],
+        automationRules: nextRules,
+        automationExecutions: [...(storage.automationExecutions ?? []), execution],
+    });
+    return execution;
+}

package/dist/daemon/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GAP-REMOTE-001: Daemon Config — load/validate/write daemon configuration.
+ */
+import type { ApiResult } from "../apiResult";
+import type { DaemonConfig } from "./types";
+export declare function loadDaemonConfig(configPath: string): Promise<ApiResult<DaemonConfig>>;
+export declare function writeDaemonConfig(config: DaemonConfig, configPath: string): Promise<ApiResult<void>>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/daemon/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkJ5C,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CA0BlC;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAgB1B"}

package/dist/daemon/config.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: Daemon Config — load/validate/write daemon configuration.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDaemonConfig = loadDaemonConfig;
+exports.writeDaemonConfig = writeDaemonConfig;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const apiResult_1 = require("../apiResult");
+const VALID_TRIGGER_TYPES = new Set(["file", "webhook", "timer"]);
+const VALID_AUTOMATION_STATES = new Set(["draft", "active", "paused", "disabled", "archived"]);
+const DEFAULT_MAX_CONCURRENT_RUNS = 4;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownArray(value) {
+    return Array.isArray(value);
+}
+function validateFileTrigger(raw, index) {
+    if (!isRecord(raw)) {
+        return `Trigger at index ${index} must be an object`;
+    }
+    if (raw.type !== "file") {
+        return `Invalid trigger type at index ${index}: ${String(raw.type)}. Must be one of: file, webhook, timer`;
+    }
+    if (typeof raw.processId !== "string" || !raw.processId) {
+        return `Missing processId at trigger index ${index}`;
+    }
+    if (typeof raw.entrypoint !== "string" || !raw.entrypoint) {
+        return `Missing entrypoint at trigger index ${index}`;
+    }
+    if (typeof raw.pattern !== "string" || !raw.pattern) {
+        return `Missing pattern at trigger index ${index}`;
+    }
+    return null;
+}
+function validateAutomationRule(raw, index) {
+    if (!isRecord(raw)) {
+        return `Trigger at index ${index} must be an object`;
+    }
+    if (typeof raw.id !== "string" || !raw.id) {
+        return `Missing automation rule id at trigger index ${index}`;
+    }
+    if (typeof raw.name !== "string" || !raw.name) {
+        return `Missing automation rule name at trigger index ${index}`;
+    }
+    if (typeof raw.state !== "string" || !VALID_AUTOMATION_STATES.has(raw.state)) {
+        return `Invalid automation state at trigger index ${index}: ${String(raw.state)}`;
+    }
+    const trigger = raw.trigger;
+    if (!isRecord(trigger) || typeof trigger.type !== "string" || !VALID_TRIGGER_TYPES.has(trigger.type)) {
+        return `Invalid automation trigger type at index ${index}: ${String(isRecord(trigger) ? trigger.type : trigger)}`;
+    }
+    if (trigger.type === "file") {
+        return `Automation rules do not support file triggers at index ${index}`;
+    }
+    if (trigger.type === "timer" && (typeof trigger.cron !== "string" || !trigger.cron)) {
+        return `Missing cron for timer automation at trigger index ${index}`;
+    }
+    if (trigger.type === "webhook") {
+        if (typeof trigger.port !== "number" || trigger.port <= 0) {
+            return `Missing port for webhook automation at trigger index ${index}`;
+        }
+        if (trigger.path !== undefined && (typeof trigger.path !== "string" || !trigger.path)) {
+            return `Invalid webhook path at trigger index ${index}`;
+        }
+    }
+    const target = raw.target;
+    if (!isRecord(target) || typeof target.projectId !== "string" || !target.projectId) {
+        return `Missing target.projectId at trigger index ${index}`;
+    }
+    if (typeof target.boardProjectId !== "string" || !target.boardProjectId) {
+        return `Missing target.boardProjectId at trigger index ${index}`;
+    }
+    const template = raw.template;
+    if (!isRecord(template) || typeof template.title !== "string" || !template.title) {
+        return `Missing template.title at trigger index ${index}`;
+    }
+    const routing = raw.routing;
+    if (!isRecord(routing)) {
+        return `Missing routing block at trigger index ${index}`;
+    }
+    if (!isRecord(routing.issue) || routing.issue.action !== "canonical-issue-create") {
+        return `Invalid routing.issue action at trigger index ${index}`;
+    }
+    if (!isRecord(routing.board) || routing.board.action !== "shared-board-derive") {
+        return `Invalid routing.board action at trigger index ${index}`;
+    }
+    if (routing.mutateBoardDirectly !== false) {
+        return `Automation routing must disable direct board mutation at trigger index ${index}`;
+    }
+    const source = raw.source;
+    if (!isRecord(source) || typeof source.kind !== "string" || !source.kind) {
+        return `Missing source.kind at trigger index ${index}`;
+    }
+    const audit = raw.audit;
+    if (!isRecord(audit) || typeof audit.createdAt !== "string" || !audit.createdAt) {
+        return `Missing audit.createdAt at trigger index ${index}`;
+    }
+    return null;
+}
+function validateConfig(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return { valid: false, error: "Config must be a JSON object" };
+    }
+    const obj = raw;
+    if (typeof obj.workspace !== "string" || !obj.workspace) {
+        return { valid: false, error: "Missing required field: workspace" };
+    }
+    if (!isUnknownArray(obj.triggers)) {
+        return { valid: false, error: "Missing required field: triggers (must be an array)" };
+    }
+    for (let i = 0; i < obj.triggers.length; i++) {
+        const trigger = obj.triggers[i];
+        const error = isRecord(trigger) && trigger.type === "file"
+            ? validateFileTrigger(trigger, i)
+            : validateAutomationRule(trigger, i);
+        if (error) {
+            return { valid: false, error };
+        }
+    }
+    const maxConcurrent = typeof obj.maxConcurrentRuns === "number"
+        ? obj.maxConcurrentRuns
+        : DEFAULT_MAX_CONCURRENT_RUNS;
+    return {
+        valid: true,
+        config: {
+            workspace: obj.workspace,
+            triggers: obj.triggers,
+            maxConcurrentRuns: maxConcurrent,
+        },
+    };
+}
+async function loadDaemonConfig(configPath) {
+    try {
+        let raw;
+        try {
+            raw = await node_fs_1.promises.readFile(configPath, "utf-8");
+        }
+        catch {
+            return (0, apiResult_1.fail)("CONFIG_NOT_FOUND", `Config file not found: ${configPath}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return (0, apiResult_1.fail)("INVALID_CONFIG", `Failed to parse config as JSON: ${configPath}`);
+        }
+        const result = validateConfig(parsed);
+        if (!result.valid) {
+            return (0, apiResult_1.fail)("INVALID_CONFIG", result.error);
+        }
+        return (0, apiResult_1.ok)(result.config);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function writeDaemonConfig(config, configPath) {
+    try {
+        const dir = path.dirname(configPath);
+        await node_fs_1.promises.mkdir(dir, { recursive: true });
+        const content = JSON.stringify(config, null, 2);
+        const tmpPath = `${configPath}.tmp-${process.pid}-${Date.now()}`;
+        await node_fs_1.promises.writeFile(tmpPath, content, "utf-8");
+        await node_fs_1.promises.rename(tmpPath, configPath);
+        return (0, apiResult_1.ok)(undefined);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}

package/dist/daemon/daemonLog.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GAP-REMOTE-001: Daemon JSONL logging.
+ *
+ * Appends structured JSON lines to a daemon activation log file.
+ */
+export interface DaemonLogEntry {
+    timestamp: string;
+    event: string;
+    data?: Record<string, unknown>;
+}
+export declare function appendDaemonLog(logDir: string, entry: DaemonLogEntry): Promise<void>;
+export declare function readDaemonLog(logDir: string): Promise<DaemonLogEntry[]>;
+//# sourceMappingURL=daemonLog.d.ts.map

package/dist/daemon/daemonLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonLog.d.ts","sourceRoot":"","sources":["../../src/daemon/daemonLog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC,CAY3B"}

package/dist/daemon/daemonLog.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: Daemon JSONL logging.
+ *
+ * Appends structured JSON lines to a daemon activation log file.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendDaemonLog = appendDaemonLog;
+exports.readDaemonLog = readDaemonLog;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+async function appendDaemonLog(logDir, entry) {
+    await node_fs_1.promises.mkdir(logDir, { recursive: true });
+    const logPath = path.join(logDir, "daemon.jsonl");
+    const line = JSON.stringify(entry) + "\n";
+    await node_fs_1.promises.appendFile(logPath, line, "utf-8");
+}
+async function readDaemonLog(logDir) {
+    const logPath = path.join(logDir, "daemon.jsonl");
+    try {
+        const content = await node_fs_1.promises.readFile(logPath, "utf-8");
+        return content
+            .trim()
+            .split("\n")
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/daemon/fileWatcher.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GAP-REMOTE-001: File Watcher — debounced fs.watch trigger.
+ *
+ * Watches directories for file changes matching glob patterns,
+ * firing trigger callbacks with configurable debounce.
+ */
+import type { FileTriggerConfig, FileWatcherHandle, TriggerCallback } from "./types";
+export declare function createFileWatcher(triggers: FileTriggerConfig[], onTrigger: TriggerCallback): FileWatcherHandle;
+//# sourceMappingURL=fileWatcher.d.ts.map

package/dist/daemon/fileWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.d.ts","sourceRoot":"","sources":["../../src/daemon/fileWatcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmDrF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,SAAS,EAAE,eAAe,GACzB,iBAAiB,CA6DnB"}

package/dist/daemon/fileWatcher.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: File Watcher — debounced fs.watch trigger.
+ *
+ * Watches directories for file changes matching glob patterns,
+ * firing trigger callbacks with configurable debounce.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFileWatcher = createFileWatcher;
+const fsSync = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const DEFAULT_DEBOUNCE_MS = 500;
+/**
+ * Extract the extension pattern from a glob (e.g., "**\/*.ts" -> ".ts").
+ * Returns null if no extension can be extracted.
+ */
+function extractExtension(pattern) {
+    const normalized = pattern.replace(/\\/g, "/");
+    // Match patterns like **/*.ts, **/*.test.ts, *.js
+    const match = normalized.match(/\*(\.[a-zA-Z0-9.]+)$/);
+    return match ? match[1] : null;
+}
+/**
+ * Check if a filename matches the pattern's file extension filter.
+ * This is a simplified matcher that works with common glob patterns like:
+ * - path/to/**\/*.ts  -> matches any .ts file under path/to/
+ * - path/to/**\/*.test.ts -> matches any .test.ts file under path/to/
+ */
+function matchesExtension(filename, pattern) {
+    const ext = extractExtension(pattern);
+    if (!ext)
+        return true; // No extension filter = match all
+    return filename.endsWith(ext);
+}
+/**
+ * Extract the base directory from a glob pattern (everything before the first glob segment).
+ */
+function getWatchDir(pattern) {
+    const normalized = pattern.replace(/\\/g, "/");
+    const parts = normalized.split("/");
+    const dirParts = [];
+    for (const part of parts) {
+        if (part.includes("*") || part.includes("?") || part.includes("{")) {
+            break;
+        }
+        dirParts.push(part);
+    }
+    return dirParts.join(path.sep) || ".";
+}
+function createFileWatcher(triggers, onTrigger) {
+    const entries = [];
+    let disposed = false;
+    for (const trigger of triggers) {
+        const watchDir = getWatchDir(trigger.pattern);
+        const debounceMs = trigger.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        const entry = {
+            trigger,
+            watcher: null,
+            debounceTimer: null,
+        };
+        try {
+            entry.watcher = fsSync.watch(watchDir, { recursive: true }, (_eventType, filename) => {
+                if (disposed || !filename)
+                    return;
+                if (!matchesExtension(filename, trigger.pattern))
+                    return;
+                // Debounce: clear previous timer and set a new one
+                if (entry.debounceTimer) {
+                    clearTimeout(entry.debounceTimer);
+                }
+                entry.debounceTimer = setTimeout(() => {
+                    if (disposed)
+                        return;
+                    void onTrigger({
+                        type: "file",
+                        processId: trigger.processId,
+                        entrypoint: trigger.entrypoint,
+                    });
+                }, debounceMs);
+            });
+            entry.watcher.on("error", () => {
+                if (entry.watcher) {
+                    entry.watcher.close();
+                    entry.watcher = null;
+                }
+            });
+        }
+        catch {
+            // Watch dir doesn't exist yet — skip
+        }
+        entries.push(entry);
+    }
+    return {
+        dispose() {
+            disposed = true;
+            for (const entry of entries) {
+                if (entry.debounceTimer) {
+                    clearTimeout(entry.debounceTimer);
+                    entry.debounceTimer = null;
+                }
+                if (entry.watcher) {
+                    entry.watcher.close();
+                    entry.watcher = null;
+                }
+            }
+        },
+    };
+}