@aitne/daemon 0.1.0

package/dist/core/trigger-evaluator.js

@@ -0,0 +1,243 @@
+/**
+ * Trigger evaluator — see `docs/design/appendices/unified-repositories.md` §4.4.
+ *
+ * Pure module. Inputs:
+ *   - a `RepositoryTriggerDTO[]` for a given `(repository_id, event_type)`,
+ *     filtered by the caller via `listEnabledTriggersForEvent`.
+ *   - the polled-event payload as a generic `Record<string, unknown>`.
+ *
+ * Output: the subset of triggers whose `filters_json` matches the payload.
+ *
+ * Filter language (v1):
+ *   - flat key/value equality against scalar event-payload fields
+ *     (`{"branch":"main"}`, `{"action":"opened"}`, …)
+ *   - `path_pattern` — special key whose value is a glob string OR
+ *     `string[]`. The minimatch-subset glob supports `**`, `*`, `?`,
+ *     `[abc]`, `{a,b}`. The matcher walks the path list extracted by an
+ *     event-type-specific extractor (see `EVENT_PATH_EXTRACTORS`).
+ *   - All filter keys AND together. Within `path_pattern[]`, OR.
+ *
+ * The actual dispatch to a backend session lives in the route handler
+ * (POST /api/repositories/:id/run); this module decides which triggers
+ * fire — nothing else.
+ */
+// ── Path globbing (minimatch subset) ──────────────────────────────────
+/**
+ * Compile a single glob pattern into a RegExp. Supports:
+ *   - `**` — any number of path segments (incl. zero)
+ *   - `*`  — any chars except `/`
+ *   - `?`  — single char except `/`
+ *   - `[abc]` / `[!abc]` — character class
+ *   - `{a,b}` — alternation
+ *
+ * Patterns are matched against the full path string (no implicit
+ * prefix); a leading `**` is required to match arbitrary depth from
+ * root.
+ */
+export function compileGlob(pattern) {
+    let i = 0;
+    const out = ["^"];
+    let braceDepth = 0;
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === "*") {
+            // Detect `**`.
+            if (pattern[i + 1] === "*") {
+                // `**/` consumes the slash too so `**/foo` matches both
+                // `foo` and `bar/foo`.
+                if (pattern[i + 2] === "/") {
+                    out.push("(?:.*/)?");
+                    i += 3;
+                    continue;
+                }
+                out.push(".*");
+                i += 2;
+                continue;
+            }
+            out.push("[^/]*");
+            i += 1;
+            continue;
+        }
+        if (ch === "?") {
+            out.push("[^/]");
+            i += 1;
+            continue;
+        }
+        if (ch === "[") {
+            // Character class. Find closing `]`.
+            const end = pattern.indexOf("]", i + 1);
+            if (end === -1) {
+                // Unmatched `[` → literal.
+                out.push("\\[");
+                i += 1;
+                continue;
+            }
+            let body = pattern.slice(i + 1, end);
+            const negate = body.startsWith("!") || body.startsWith("^");
+            if (negate)
+                body = body.slice(1);
+            out.push(`[${negate ? "^" : ""}${body}]`);
+            i = end + 1;
+            continue;
+        }
+        if (ch === "{") {
+            braceDepth++;
+            out.push("(?:");
+            i += 1;
+            continue;
+        }
+        if (ch === "}") {
+            if (braceDepth > 0) {
+                braceDepth--;
+                out.push(")");
+                i += 1;
+                continue;
+            }
+            out.push("\\}");
+            i += 1;
+            continue;
+        }
+        if (ch === "," && braceDepth > 0) {
+            out.push("|");
+            i += 1;
+            continue;
+        }
+        // Escape regex metacharacters.
+        if (/[.+^$()|\\]/.test(ch)) {
+            out.push("\\" + ch);
+            i += 1;
+            continue;
+        }
+        out.push(ch);
+        i += 1;
+    }
+    // Close any unterminated braces by treating them as literal.
+    while (braceDepth > 0) {
+        out.push(")");
+        braceDepth--;
+    }
+    out.push("$");
+    return new RegExp(out.join(""));
+}
+export function matchGlob(pattern, path) {
+    return compileGlob(pattern).test(path);
+}
+export function matchAnyGlob(patterns, paths) {
+    const patternList = Array.isArray(patterns) ? patterns : [patterns];
+    for (const pattern of patternList) {
+        const re = compileGlob(pattern);
+        for (const path of paths) {
+            if (re.test(path))
+                return true;
+        }
+    }
+    return false;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((v) => typeof v === "string");
+}
+function extractFromCommits(payload) {
+    const commits = Array.isArray(payload.commits)
+        ? payload.commits
+        : [];
+    const set = new Set();
+    for (const commit of commits) {
+        for (const file of asStringArray(commit.added))
+            set.add(file);
+        for (const file of asStringArray(commit.modified))
+            set.add(file);
+        for (const file of asStringArray(commit.removed))
+            set.add(file);
+    }
+    // Some classifiers / observers also stash the union under
+    // `changedFiles` — fall back to that when no per-commit detail.
+    if (set.size === 0) {
+        for (const file of asStringArray(payload.changedFiles))
+            set.add(file);
+    }
+    return [...set];
+}
+function extractFromMergeCommit(payload) {
+    // Merge events from git-watcher record the merged commit's file list
+    // under either `files` or `changedFiles` depending on classifier
+    // version. Tolerate both.
+    const files = asStringArray(payload.files);
+    if (files.length > 0)
+        return files;
+    return asStringArray(payload.changedFiles);
+}
+function extractFromPullRequest(payload) {
+    // Webhook-emitted PR events sometimes include a `files` array
+    // synthesized by the poller; absent that, the trigger evaluator
+    // returns null and the path_pattern filter is skipped (trigger
+    // does not fire). Up to the route handler to enrich payloads
+    // with PR file lists when the user wires path-pattern filters
+    // on PR events.
+    const files = asStringArray(payload.files);
+    return files.length > 0 ? files : null;
+}
+export const EVENT_PATH_EXTRACTORS = {
+    "git.push.detected": extractFromCommits,
+    "git.push.force_pushed": extractFromCommits,
+    "git.merge_to_default": extractFromMergeCommit,
+    "github.pull_request.opened": extractFromPullRequest,
+    "github.pull_request.synchronize": extractFromPullRequest,
+    "github.pull_request.review_requested": extractFromPullRequest,
+    "github.pull_request.closed": extractFromPullRequest,
+};
+// ── Match logic ──────────────────────────────────────────────────────
+function readScalar(payload, key) {
+    // Top-level shorthand. Triggers cannot reach into nested objects in
+    // v1; a richer DSL grows into a task-flow override.
+    return payload[key];
+}
+function scalarEquals(a, b) {
+    if (a === null || b === null)
+        return a === b;
+    if (typeof a === "number" && typeof b === "number")
+        return a === b;
+    return String(a) === String(b);
+}
+/**
+ * Decide whether a single trigger's filters match the given event
+ * payload.
+ */
+export function matchesFilters(filters, eventType, payload) {
+    for (const [key, expected] of Object.entries(filters)) {
+        if (key === "path_pattern") {
+            const extractor = EVENT_PATH_EXTRACTORS[eventType];
+            if (!extractor)
+                return false;
+            const paths = extractor(payload);
+            if (!paths)
+                return false;
+            if (paths.length === 0)
+                return false;
+            const patterns = expected;
+            if (!matchAnyGlob(patterns, paths))
+                return false;
+            continue;
+        }
+        const actual = readScalar(payload, key);
+        if (!scalarEquals(actual, expected))
+            return false;
+    }
+    return true;
+}
+/**
+ * Filter `triggers` to those whose filters match the event. Triggers
+ * are returned in the input order (caller controls the order via
+ * `listEnabledTriggersForEvent`'s `ORDER BY created_at`).
+ */
+export function evaluateTriggers(triggers, eventType, payload) {
+    return triggers.filter((trigger) => {
+        if (!trigger.enabled)
+            return false;
+        if (trigger.eventType !== eventType)
+            return false;
+        return matchesFilters(trigger.filters, eventType, payload);
+    });
+}
+//# sourceMappingURL=trigger-evaluator.js.map

package/dist/core/trigger-evaluator.js.map

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

package/dist/core/workdir.d.ts

@@ -0,0 +1,241 @@
+/**
+ * WorkdirManager — creates working directories for agent sessions.
+ *
+ * The Agent SDK reads `CLAUDE.md` and `.claude/skills/` from the `cwd` passed
+ * to `query()`, and stores session history per-cwd in `~/.claude/projects/`.
+ *
+ * Two directory strategies:
+ *
+ * 1. **Per-session persistent dirs** (for conversations that may resume):
+ *    Path: `<dataDir>/agent-sessions/<dbSessionId>/`
+ *    Created on first execute, reused on resume, cleaned up on session close.
+ *    The deterministic path ensures execute() and executeResume() share the
+ *    same cwd, so the SDK can find the session history.
+ *
+ * 2. **Disposable temp dirs** (for one-shot light-tier events):
+ *    Path: `/tmp/pa-<random>/`
+ *    Created per-call, deleted immediately after.
+ */
+import type { BackendId, IntegrationKey, IntegrationState, ProcessKey } from "@aitne/shared";
+export { getProfileForEvent, getSkillsForEvent } from "./skills-manifest.js";
+/**
+ * Reconcile the session workdir's user-authored skill set with the source
+ * at `userSkillsDir`.
+ *
+ * Idempotent and cheap — safe to call on every message. Uses a manifest
+ * file (`.user-skills.json`) inside the session's `.claude/skills/` dir to
+ * track which subdirectories this function manages, so built-ins copied by
+ * `ensureSessionWorkdir` (via SKILL_SETS) are never touched.
+ *
+ * Behaviour:
+ *   • A slug present in source but missing from manifest → copy it in,
+ *     unless a directory already exists there (which must be a built-in
+ *     with the same name — the API blocks this case but we defend anyway).
+ *   • A slug present in both source and manifest → overwrite from source
+ *     so mid-session PUTs propagate.
+ *   • A slug present in manifest but missing from source → delete from
+ *     dest (mid-session DELETEs propagate).
+ *
+ * Returns a summary for logging.
+ */
+export declare function syncUserSkills(sessionDir: string, userSkillsDir: string): {
+    added: number;
+    updated: number;
+    removed: number;
+};
+export declare function syncUserSkillDocs(sessionDir: string, userSkillsDir: string): {
+    added: number;
+    updated: number;
+    removed: number;
+};
+type SyncResult = {
+    added: number;
+    updated: number;
+    removed: number;
+};
+export declare function syncAllUserSkills(sessionDir: string, userSkillsDir: string): Record<string, SyncResult>;
+/**
+ * Create a disposable temp directory for one-shot events.
+ * Caller must call `cleanupSessionWorkdir()` after use.
+ *
+ * @param projectRoot - Workspace root containing `agent-assets/skills/`
+ * @param eventType - Selects SKILL_SET and agent profile
+ * @param userSkillsDir - Optional path to `{dataDir}/skills/`; if provided,
+ *   every user-authored skill is copied into the workdir
+ */
+export declare function createSessionWorkdir(projectRoot: string, eventType: string, userSkillsDir?: string, options?: {
+    backendId?: BackendId;
+    processKey?: ProcessKey;
+    configuredServices?: ReadonlySet<string>;
+    mailAccounts?: readonly import("../services/mail/provider.js").MailAccount[];
+    integrations?: Partial<Record<IntegrationKey, IntegrationState>>;
+    /** User-defined character / persona (design §15). Empty = no block. */
+    character?: string;
+    /** P22 — when set, SkillsCompiler runs the curation anchor splicer
+     *  during materialization so each skill's CURATION anchors resolve to
+     *  the active overlay (or seed) JSON. */
+    skillCurationDataDir?: string;
+}): string;
+export declare function ensureSessionWorkdir(projectRoot: string, dataDir: string, dbSessionId: number, eventType: string, options?: {
+    backendId?: BackendId;
+    processKey?: ProcessKey;
+    configuredServices?: ReadonlySet<string>;
+    mailAccounts?: readonly import("../services/mail/provider.js").MailAccount[];
+    integrations?: Partial<Record<IntegrationKey, IntegrationState>>;
+    /** User-defined character / persona (design §15). Empty = no block. */
+    character?: string;
+    /**
+     * Per-turn override used by custom messaging bang commands. Forces a
+     * full re-materialize of the workdir even when one already exists,
+     * because the prior turn's skill set / profile body may have been
+     * different (two `!cmd` turns with different configurations, or a
+     * regular DM following a `!cmd` turn).
+     *
+     * `null` for either field falls back to the manifest defaults for
+     * that field independently. Passing the override at all is what
+     * triggers re-materialization.
+     *
+     * Note: regular DM turns (no `override` set) also force a
+     * re-materialize when `BANG_COMMAND_STAMP` is present from a prior
+     * turn — this restores the workdir to manifest defaults so a `!cmd`
+     * configuration cannot leak into a subsequent natural DM.
+     */
+    override?: {
+        skillSlugs: readonly string[] | null;
+        profileBody: string | null;
+    };
+}): string;
+/**
+ * Get the deterministic path for a session workdir (without creating it).
+ */
+export declare function getSessionWorkdirPath(dataDir: string, dbSessionId: number): string;
+/**
+ * Remove a session working directory.
+ * Safe to call even if the directory doesn't exist.
+ */
+export declare function cleanupSessionWorkdir(sessionDir: string): void;
+/**
+ * Clean up all session workdirs for sessions that are no longer active.
+ * Called periodically (e.g., daily cleanup) or on daemon shutdown.
+ *
+ * @param dataDir - Data directory containing agent-sessions/
+ * @param activeSessionIds - Set of DB session IDs that are still active
+ */
+export declare function cleanupStaleWorkdirs(dataDir: string, activeSessionIds: Set<number>): number;
+/**
+ * Ensure a session workdir contains the instruction files for a specific
+ * backend. Called by BackendRouter before executing a fallback backend on
+ * a heavy-tier session dir that was originally materialized for a different
+ * (main) backend.
+ *
+ * Idempotent — if the files already exist for this backend, it overwrites
+ * with the latest content (which is cheap since the source hasn't changed).
+ */
+export declare function ensureBackendMaterialized(projectRoot: string, sessionDir: string, backendId: BackendId, eventType: string, processKey?: ProcessKey, configuredServices?: ReadonlySet<string>, mailAccounts?: readonly import("../services/mail/provider.js").MailAccount[], integrations?: Partial<Record<IntegrationKey, IntegrationState>>, character?: string): void;
+/**
+ * Validate that every delegated-mode skill AND task-flow variant required by
+ * the currently-stored integration state exists on disk. Returns the missing
+ * paths split by kind — both arrays empty means "all good."
+ *
+ * Called at daemon startup after integration state is loaded. Also used by
+ * the PATCH pre-commit check and by `/health.integrationModes.<key>` to
+ * surface the gap before the agent ever activates the missing variant.
+ */
+export declare function validateDelegatedStartup(projectRoot: string, integrations: Partial<Record<IntegrationKey, IntegrationState>>): {
+    skills: string[];
+    taskFlows: string[];
+};
+/**
+ * Resolve the ProcessKey that a DM conversation-session scope uses. Kept in
+ * sync with `Dispatcher.execute` — both dashboard_chat and owner_dm currently
+ * dispatch through ProcessKeys that map to the `message.received.dm` event
+ * type in the skills manifest. Returning the right key lets mid-session
+ * skill refreshes pick up the same bundle the next DM turn will use, instead
+ * of defaulting to the generic event type.
+ */
+export declare function processKeyForDmScope(scope: string): ProcessKey;
+export interface DmSessionRef {
+    id: number;
+    backend: BackendId | null;
+    scope: string;
+}
+export interface RefreshDmSessionWorkdirsParams {
+    projectRoot: string;
+    dataDir: string;
+    sessions: readonly DmSessionRef[];
+    configuredServices: ReadonlySet<string>;
+    mailAccounts: readonly import("../services/mail/provider.js").MailAccount[];
+    /**
+     * Current integration state, threaded through to the per-session
+     * `SkillsCompiler` so the rebaked skill bodies pick up the right
+     * `SKILL.delegated.<backend>.md` variant for non-proxied integrations
+     * AND so `applyAllDeniedToolsForSkill` re-emits the soft-deny prose for
+     * any deniedTools the user has configured. Required (not optional) so
+     * callers can't silently drop the field and re-introduce the latent
+     * staleness bug — passing an empty object is fine for callers that
+     * truly have no integration context, but the choice has to be explicit.
+     */
+    integrations: Partial<Record<IntegrationKey, IntegrationState>>;
+    /**
+     * User-defined character / persona (design §15). Threaded through so a
+     * re-materialized workdir keeps the Character block the owner had
+     * configured — without it, a mid-session refresh would wipe the block
+     * from every active DM session.
+     */
+    character: string;
+    /**
+     * Session ids to skip — intended for:
+     * - ids already marked stale (their workdir will be abandoned on the next
+     *   turn; refreshing it is pure waste),
+     * - future-proofing for in-flight ids if/when the dispatcher exposes them.
+     */
+    skip?: ReadonlySet<number>;
+}
+export interface RefreshDmSessionWorkdirsResult {
+    eligible: number;
+    refreshed: number;
+    skippedStale: number;
+    skippedMissing: number;
+    failed: number;
+}
+/**
+ * Re-materialize every active DM session workdir so the next turn picks up
+ * the current mail scope, integration state, and per-backend instruction
+ * file without tearing down its SDK session. Triggered by
+ * {@link MailAccountRegistry}'s `onScopeChanged` hook AND by
+ * `applyIntegrationModeChange` (DELEGATED-PROXY-API-DESIGN.md Phase F §4.8).
+ *
+ * Caveat: this overwrites `CLAUDE.md`/`AGENTS.md`/`GEMINI.md` and the
+ * backend-specific skill directories. If a DM turn is currently executing
+ * in the target workdir, the SDK is in the middle of reading these files —
+ * in the worst case the turn sees mixed pre/post content. We accept that
+ * race because (a) skill files are read at session init and lazy-loaded
+ * skills reload from disk each activation so the current turn rarely holds
+ * a long-running file handle, (b) the write is synchronous so half-states
+ * don't persist on disk, and (c) skipping in-flight turns would need
+ * intrusive dispatcher plumbing for a scenario that fires on a human-
+ * triggered dashboard toggle. If the race ever bites, thread an in-flight
+ * set into `skip`.
+ */
+export declare function refreshDmSessionWorkdirs(params: RefreshDmSessionWorkdirsParams): RefreshDmSessionWorkdirsResult;
+/**
+ * Build a set of configured service names.
+ * Used by SkillsCompiler to strip unconfigured service sections from
+ * external-services/SKILL.md at materialization time.
+ *
+ * Calendar availability is determined from ServiceRegistry (non-null means
+ * OAuth succeeded), NOT from `googleCalendarId` which defaults to "primary"
+ * and is always truthy. GitHub presence is sourced from the unified
+ * `repositories` table (rows with a github side) rather than the legacy
+ * `gitRepos` / `gitWatchedRepos` / `githubRepos` config arrays, which were
+ * removed at the unified-repositories cutover. Other services use config
+ * fields that default to null/empty when unconfigured.
+ */
+export declare function buildConfiguredServices(config: {
+    externalObsidianVaultPath?: string | null;
+    notionDatabaseIds?: Record<string, string>;
+}, serviceAvailability?: {
+    calendar?: unknown;
+    github?: unknown;
+}): Set<string>;
+//# sourceMappingURL=workdir.d.ts.map

package/dist/core/workdir.d.ts.map

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