@aitne/daemon 0.1.0

package/dist/observers/obsidian-watcher.js

@@ -0,0 +1,166 @@
+import * as chokidar from "chokidar";
+import { extname, relative, resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+import { recordObservation } from "../db/observations.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("obsidian-watcher");
+/** Truncate diff previews to this many characters before storage. */
+const DIFF_PREVIEW_CAP = 2000;
+/**
+ * Pure helper that records a single debounced file-change event as an
+ * observation row. Extracted from `ObsidianWatcher` so the watcher's
+ * wiring can be unit-tested without spinning up a real chokidar / FSEvents
+ * subscription — tests drive this function directly with a synthetic
+ * path, bypassing the watch loop entirely.
+ *
+ * Returns `"recorded"` when a row is written, `"skipped:agent"` when the
+ * change was pre-marked as an agent-originated write (no row — see
+ * `recordFileChange`'s contract note below), `"skipped:ext"` when the
+ * file extension falls outside `WATCH_EXTENSIONS`.
+ *
+ * **Agent-write suppression**: `AgentWriteTracker` pre-marks files the
+ * agent writes via `/api/context/*`. When a watcher fires for one of
+ * those, we silently drop the observation instead of recording it with
+ * `actor='agent'`. Downstream consumers (hourly-check skill) already
+ * filter by `actor='user'`, so an agent row has no consumer; leaving it
+ * out of the table entirely prevents unbounded growth from the agent's
+ * own write traffic.
+ */
+export async function recordFileChange(params) {
+    if (!ObsidianWatcher.WATCH_EXTENSIONS.has(extname(params.filePath))) {
+        return "skipped:ext";
+    }
+    const relativePath = relative(params.vaultPath, params.filePath);
+    const absolutePath = resolve(params.filePath);
+    let content = null;
+    let diffContent = "";
+    if (params.changeType !== "deleted") {
+        try {
+            content = await readFile(params.filePath, "utf-8");
+            diffContent = content.length <= DIFF_PREVIEW_CAP
+                ? content
+                : content.slice(0, DIFF_PREVIEW_CAP) + `\n\n--- (truncated, ${content.length} chars total) ---`;
+        }
+        catch {
+            diffContent = "(file read failed)";
+        }
+    }
+    if (params.writeTracker?.isMarked(absolutePath, content)) {
+        logger.debug({ file: relativePath, changeType: params.changeType, source: params.source }, "dropping agent-originated file event");
+        return "skipped:agent";
+    }
+    recordObservation(params.db, {
+        source: params.source,
+        ref: relativePath,
+        changeType: params.changeType,
+        actor: "user",
+        payload: {
+            filePath: relativePath,
+            diffPreview: diffContent,
+        },
+    });
+    logger.debug({ file: relativePath, changeType: params.changeType, source: params.source }, "file change observation recorded");
+    return "recorded";
+}
+/**
+ * ObsidianWatcher — monitors an Obsidian-style vault for Markdown file
+ * changes.
+ *
+ * Uses chokidar (FSEvents on macOS) for native filesystem events.
+ * Debounces rapid edits to avoid flooding the observations table during
+ * active editing.
+ *
+ * Two registered instances coexist at runtime:
+ *   - `obsidian:external` — the user's separate note vault,
+ *     `externalObsidianVaultPath`.
+ *   - `obsidian:primary`  — the agent's own primary management vault
+ *     when `vaultMode === "obsidian"` (see `PrimaryVaultWatcher`).
+ *
+ * Both tag their observations with a distinct `source` so the
+ * `(source, ref)` upsert constraint can never merge unrelated changes.
+ */
+export class ObsidianWatcher {
+    vaultPath;
+    db;
+    debounceSeconds;
+    writeTracker;
+    name;
+    source;
+    /** Directories to ignore inside the vault */
+    static IGNORE_PATTERNS = [
+        "**/.obsidian/**",
+        "**/.trash/**",
+        "**/.git/**",
+        "**/node_modules/**",
+    ];
+    /** Only watch these file extensions */
+    static WATCH_EXTENSIONS = new Set([".md"]);
+    watcher = null;
+    debounceTimers = new Map();
+    constructor(vaultPath, db, debounceSeconds = 5, writeTracker, options = {}) {
+        this.vaultPath = vaultPath;
+        this.db = db;
+        this.debounceSeconds = debounceSeconds;
+        this.writeTracker = writeTracker;
+        this.source = options.source ?? "obsidian:external";
+        this.name = options.name ?? this.source;
+    }
+    async start() {
+        this.watcher = chokidar.watch(this.vaultPath, {
+            ignored: ObsidianWatcher.IGNORE_PATTERNS,
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 500,
+                pollInterval: 100,
+            },
+        });
+        this.watcher
+            .on("add", (path) => this.handleChange(path, "created"))
+            .on("change", (path) => this.handleChange(path, "modified"))
+            .on("unlink", (path) => this.handleChange(path, "deleted"))
+            .on("error", (error) => {
+            logger.error({ error }, "Watcher error");
+        });
+        logger.info({ vaultPath: this.vaultPath, source: this.source, name: this.name }, "Obsidian watcher started");
+    }
+    async stop() {
+        // Clear all pending debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        logger.info({ name: this.name }, "Obsidian watcher stopped");
+    }
+    /**
+     * Debounced chokidar event handler. Public only so observer-level
+     * tests can drive the full wiring (debounce → recordFileChange)
+     * without bringing up chokidar; production code never calls this
+     * directly.
+     */
+    handleChange(filePath, changeType) {
+        // Filter by extension before arming the timer.
+        if (!ObsidianWatcher.WATCH_EXTENSIONS.has(extname(filePath)))
+            return;
+        // Debounce: reset timer for this file path
+        const existing = this.debounceTimers.get(filePath);
+        if (existing)
+            clearTimeout(existing);
+        this.debounceTimers.set(filePath, setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            void recordFileChange({
+                vaultPath: this.vaultPath,
+                filePath,
+                changeType,
+                source: this.source,
+                db: this.db,
+                writeTracker: this.writeTracker,
+            });
+        }, this.debounceSeconds * 1000));
+    }
+}
+//# sourceMappingURL=obsidian-watcher.js.map

package/dist/observers/obsidian-watcher.js.map

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

package/dist/observers/primary-vault-watcher.d.ts

@@ -0,0 +1,73 @@
+import type Database from "better-sqlite3";
+import type { AgentWriteTracker } from "../safety/agent-write-tracker.js";
+import type { Observer } from "./manager.js";
+/**
+ * Factory signature for the inner chokidar-backed watcher. Injectable
+ * so unit tests can assert the wiring (path changes → new inner
+ * watcher with the new path) without running chokidar/FSEvents.
+ */
+export type InnerWatcherFactory = (vaultPath: string, db: Database.Database, debounceSeconds: number, writeTracker: AgentWriteTracker | undefined, name: string) => Observer;
+export interface PrimaryVaultWatcherOptions {
+    /** Override the inner watcher factory. Production code never sets this. */
+    innerFactory?: InnerWatcherFactory;
+}
+/**
+ * Primary-vault watcher — observes user-originated edits to the agent's
+ * primary management vault when `vaultMode === "obsidian"`.
+ *
+ * Responsibilities:
+ *   - Hold the currently-targeted vault path.
+ *   - Start/stop an inner `ObsidianWatcher` tagged with
+ *     `source: "obsidian:primary"`.
+ *   - Re-target on path change via `setVaultPath` — called by
+ *     `/api/setup/migrate-context` after a successful vault migration.
+ *     The watcher restarts itself atomically only when it was running
+ *     at the time of the call; otherwise it just stores the new path
+ *     so the next `start()` picks it up.
+ *
+ * Design notes:
+ *   - The watcher does NOT peek at `AgentConfig` on its own. Previously
+ *     it captured the config reference and relied on `Object.assign`
+ *     mutation happening before `resumeAll()` — correct in practice
+ *     but fragile across refactors. Making the path update explicit
+ *     gives any current or future settings-mutation call site a single,
+ *     named plumbing point.
+ *   - `start()` and `stop()` remain idempotent and tolerant of being
+ *     called while the target path is null (plain mode); they become
+ *     no-ops in that branch.
+ */
+export declare class PrimaryVaultWatcher implements Observer {
+    private readonly db;
+    private readonly debounceSeconds;
+    private readonly writeTracker?;
+    readonly name = "obsidian:primary";
+    private vaultPath;
+    private inner;
+    private running;
+    private readonly innerFactory;
+    constructor(db: Database.Database, debounceSeconds: number, writeTracker?: AgentWriteTracker | undefined, options?: PrimaryVaultWatcherOptions);
+    /**
+     * Current targeted vault path, or `null` in plain mode / when the
+     * primary path is unset. Exposed for diagnostics (e.g. the health
+     * monitor can surface "watcher targeting foo/bar").
+     */
+    getVaultPath(): string | null;
+    /**
+     * Point the watcher at a new vault path. Callers MUST invoke this
+     * whenever `primaryVaultPath` changes — the migration endpoint wires
+     * it via its `onPrimaryVaultPathChange` callback, and the startup
+     * sequence calls it once with the config-loaded value.
+     *
+     * A value equal to the current path is a no-op; `null` detaches the
+     * watcher from any directory (plain mode). When the watcher is
+     * currently running, the inner chokidar instance is torn down and
+     * recreated with the new path atomically so no events are observed
+     * against a stale target.
+     */
+    setVaultPath(newPath: string | null): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private spinUpInnerIfTargeted;
+    private teardownInner;
+}
+//# sourceMappingURL=primary-vault-watcher.d.ts.map

package/dist/observers/primary-vault-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primary-vault-watcher.d.ts","sourceRoot":"","sources":["../../src/observers/primary-vault-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM7C;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,IAAI,EAAE,MAAM,KACT,QAAQ,CAAC;AAcd,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAQhD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAThC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAGhC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,iBAAiB,YAAA,EACjD,OAAO,GAAE,0BAA+B;IAK1C;;;;OAIG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,qBAAqB;YAmBrB,aAAa;CAU5B"}

package/dist/observers/primary-vault-watcher.js

@@ -0,0 +1,115 @@
+import { ObsidianWatcher } from "./obsidian-watcher.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("primary-vault-watcher");
+const defaultInnerFactory = (vaultPath, db, debounceSeconds, writeTracker, name) => new ObsidianWatcher(vaultPath, db, debounceSeconds, writeTracker, {
+    name,
+    source: "obsidian:primary",
+});
+/**
+ * Primary-vault watcher — observes user-originated edits to the agent's
+ * primary management vault when `vaultMode === "obsidian"`.
+ *
+ * Responsibilities:
+ *   - Hold the currently-targeted vault path.
+ *   - Start/stop an inner `ObsidianWatcher` tagged with
+ *     `source: "obsidian:primary"`.
+ *   - Re-target on path change via `setVaultPath` — called by
+ *     `/api/setup/migrate-context` after a successful vault migration.
+ *     The watcher restarts itself atomically only when it was running
+ *     at the time of the call; otherwise it just stores the new path
+ *     so the next `start()` picks it up.
+ *
+ * Design notes:
+ *   - The watcher does NOT peek at `AgentConfig` on its own. Previously
+ *     it captured the config reference and relied on `Object.assign`
+ *     mutation happening before `resumeAll()` — correct in practice
+ *     but fragile across refactors. Making the path update explicit
+ *     gives any current or future settings-mutation call site a single,
+ *     named plumbing point.
+ *   - `start()` and `stop()` remain idempotent and tolerant of being
+ *     called while the target path is null (plain mode); they become
+ *     no-ops in that branch.
+ */
+export class PrimaryVaultWatcher {
+    db;
+    debounceSeconds;
+    writeTracker;
+    name = "obsidian:primary";
+    vaultPath = null;
+    inner = null;
+    running = false;
+    innerFactory;
+    constructor(db, debounceSeconds, writeTracker, options = {}) {
+        this.db = db;
+        this.debounceSeconds = debounceSeconds;
+        this.writeTracker = writeTracker;
+        this.innerFactory = options.innerFactory ?? defaultInnerFactory;
+    }
+    /**
+     * Current targeted vault path, or `null` in plain mode / when the
+     * primary path is unset. Exposed for diagnostics (e.g. the health
+     * monitor can surface "watcher targeting foo/bar").
+     */
+    getVaultPath() {
+        return this.vaultPath;
+    }
+    /**
+     * Point the watcher at a new vault path. Callers MUST invoke this
+     * whenever `primaryVaultPath` changes — the migration endpoint wires
+     * it via its `onPrimaryVaultPathChange` callback, and the startup
+     * sequence calls it once with the config-loaded value.
+     *
+     * A value equal to the current path is a no-op; `null` detaches the
+     * watcher from any directory (plain mode). When the watcher is
+     * currently running, the inner chokidar instance is torn down and
+     * recreated with the new path atomically so no events are observed
+     * against a stale target.
+     */
+    async setVaultPath(newPath) {
+        const normalized = newPath && newPath.length > 0 ? newPath : null;
+        if (normalized === this.vaultPath)
+            return;
+        this.vaultPath = normalized;
+        if (!this.running) {
+            logger.debug({ vaultPath: normalized }, "primary vault path updated while stopped");
+            return;
+        }
+        await this.teardownInner();
+        await this.spinUpInnerIfTargeted();
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        await this.spinUpInnerIfTargeted();
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        await this.teardownInner();
+        logger.info("primary vault watcher stopped");
+    }
+    async spinUpInnerIfTargeted() {
+        if (!this.vaultPath) {
+            logger.debug("primary vault watcher dormant (no target path)");
+            return;
+        }
+        this.inner = this.innerFactory(this.vaultPath, this.db, this.debounceSeconds, this.writeTracker, this.name);
+        await this.inner.start();
+        logger.info({ path: this.vaultPath }, "primary vault watcher started");
+    }
+    async teardownInner() {
+        if (!this.inner)
+            return;
+        const inner = this.inner;
+        this.inner = null;
+        try {
+            await inner.stop();
+        }
+        catch (err) {
+            logger.error({ err }, "failed to stop inner watcher during teardown");
+        }
+    }
+}
+//# sourceMappingURL=primary-vault-watcher.js.map

package/dist/observers/primary-vault-watcher.js.map

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

package/dist/observers/repository-management-cron.d.ts

@@ -0,0 +1,70 @@
+import type Database from "better-sqlite3";
+import type { EventBus } from "../core/event-bus.js";
+import type { AgentWriteTracker } from "../safety/agent-write-tracker.js";
+import type { Observer } from "./manager.js";
+export declare const REPOSITORY_MANAGEMENT_CRON_OBSERVER_NAME = "repository-management-cron";
+export declare const REPOSITORY_MANAGEMENT_PROCESS_KEY = "git.project.update";
+export interface RepositoryManagementCronOptions {
+    db: Database.Database;
+    eventBus: EventBus;
+    /**
+     * Tick cadence for the cron itself (seconds). Defaults to 1 hour — the
+     * cron iterates the table on every tick and only fires for rows whose
+     * `last_scan_at` is more than `intervalMs` ago, so a tighter cron tick
+     * is harmless and ensures a row that flips to `enabled=1` mid-day is
+     * picked up reasonably quickly.
+     */
+    tickIntervalSeconds?: number;
+    /**
+     * Per-repo scan interval (ms). Default 24h matches design §4.5
+     * "1×/day per enabled row".
+     */
+    scanIntervalMs?: number;
+    now?: () => Date;
+    /**
+     * When provided, the cron writes the required markdown artifacts directly
+     * instead of relying on an autonomous backend session to do the write.
+     * Tests that exercise the legacy EventBus scheduling path omit this.
+     */
+    contextDir?: string | (() => string);
+    timezone?: string;
+    writeTracker?: AgentWriteTracker;
+    onIndexableContextChange?: (path: string) => void;
+}
+/**
+ * Daily-scan dispatcher for unified repositories whose
+ * `repository_management.enabled = 1`. See
+ * `docs/design/appendices/unified-repositories.md` §4.5.
+ *
+ * Iterates `repository_management` rows that:
+ *   1. are enabled,
+ *   2. have a non-null `local_path` on the parent repository,
+ *   3. were last scanned more than `scanIntervalMs` ago (or never).
+ *
+ * For each match, emits a `scheduled.task` event with the
+ * `git.project.update` process key. The dispatcher's task-flow + run
+ * endpoint owns the actual session spawn; this observer only schedules
+ * the work.
+ */
+export declare class RepositoryManagementCron implements Observer {
+    private readonly options;
+    readonly name = "repository-management-cron";
+    private timer;
+    private running;
+    private stopped;
+    private readonly tickIntervalSeconds;
+    private readonly scanIntervalMs;
+    private readonly now;
+    constructor(options: RepositoryManagementCronOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Run the iterator once. Returns the number of events emitted.
+     * Exposed for tests and the manual `POST .../management/scan` path.
+     */
+    tick(): Promise<number>;
+    private scheduleNext;
+    private resolveContextDir;
+    private buildEvent;
+}
+//# sourceMappingURL=repository-management-cron.d.ts.map

package/dist/observers/repository-management-cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-management-cron.d.ts","sourceRoot":"","sources":["../../src/observers/repository-management-cron.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,eAAO,MAAM,wCAAwC,+BACvB,CAAC;AAC/B,eAAO,MAAM,iCAAiC,uBAAuB,CAAC;AAKtE,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,YAAW,QAAQ;IAU3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,QAAQ,CAAC,IAAI,gCAA4C;IAEzD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAEJ,OAAO,EAAE,+BAA+B;IAS/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAgE7B,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;CAyCnB"}

package/dist/observers/repository-management-cron.js

@@ -0,0 +1,166 @@
+import { createEvent, EventPriority, } from "@aitne/shared";
+import { listManagementDueForScan, markManagementScanQueued, recordManagementScan, } from "../db/repositories-store.js";
+import { runRepositoryManagementScan, } from "../core/repository-management-docs.js";
+import { gitRepoJournalPath, gitRepoOverviewPath } from "../core/context-paths.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("repository-management-cron");
+export const REPOSITORY_MANAGEMENT_CRON_OBSERVER_NAME = "repository-management-cron";
+export const REPOSITORY_MANAGEMENT_PROCESS_KEY = "git.project.update";
+const DAY_MS = 24 * 60 * 60 * 1000;
+const MIN_TICK_INTERVAL_SECONDS = 60;
+/**
+ * Daily-scan dispatcher for unified repositories whose
+ * `repository_management.enabled = 1`. See
+ * `docs/design/appendices/unified-repositories.md` §4.5.
+ *
+ * Iterates `repository_management` rows that:
+ *   1. are enabled,
+ *   2. have a non-null `local_path` on the parent repository,
+ *   3. were last scanned more than `scanIntervalMs` ago (or never).
+ *
+ * For each match, emits a `scheduled.task` event with the
+ * `git.project.update` process key. The dispatcher's task-flow + run
+ * endpoint owns the actual session spawn; this observer only schedules
+ * the work.
+ */
+export class RepositoryManagementCron {
+    options;
+    name = REPOSITORY_MANAGEMENT_CRON_OBSERVER_NAME;
+    timer = null;
+    running = false;
+    stopped = false;
+    tickIntervalSeconds;
+    scanIntervalMs;
+    now;
+    constructor(options) {
+        this.options = options;
+        this.tickIntervalSeconds = Math.max(MIN_TICK_INTERVAL_SECONDS, Math.floor(options.tickIntervalSeconds ?? 3600));
+        this.scanIntervalMs = options.scanIntervalMs ?? DAY_MS;
+        this.now = options.now ?? (() => new Date());
+    }
+    async start() {
+        if (this.timer || this.stopped)
+            return;
+        this.scheduleNext(this.tickIntervalSeconds);
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Run the iterator once. Returns the number of events emitted.
+     * Exposed for tests and the manual `POST .../management/scan` path.
+     */
+    async tick() {
+        if (this.running || this.stopped)
+            return 0;
+        this.running = true;
+        try {
+            const due = listManagementDueForScan(this.options.db, this.scanIntervalMs, this.now().getTime());
+            let emitted = 0;
+            for (const row of due) {
+                try {
+                    // Optimistic pre-fire mark — prevents the next tick from
+                    // re-emitting the same scan if dispatch is slow or the
+                    // task-flow crashes silently. Dispatcher finalizer flips
+                    // `last_scan_status` on terminal completion.
+                    markManagementScanQueued(this.options.db, row.id, this.now().getTime());
+                    if (this.options.contextDir) {
+                        const result = await runRepositoryManagementScan({
+                            db: this.options.db,
+                            repo: row,
+                            contextDir: this.resolveContextDir(),
+                            now: this.now(),
+                            timezone: this.options.timezone,
+                            writeTracker: this.options.writeTracker,
+                            onIndexableContextChange: this.options.onIndexableContextChange,
+                        });
+                        recordManagementScan(this.options.db, row.id, result.status === "skipped_no_activity"
+                            ? "skipped_no_activity"
+                            : "ok", this.now().getTime());
+                    }
+                    else {
+                        const event = this.buildEvent(row);
+                        await this.options.eventBus.put(event);
+                    }
+                    emitted += 1;
+                }
+                catch (err) {
+                    recordManagementScan(this.options.db, row.id, "failed", this.now().getTime());
+                    logger.warn({ err, repositoryId: row.id }, "Failed to run repository management scan");
+                }
+            }
+            if (emitted > 0) {
+                logger.info({ emitted }, "Processed repository management scans");
+            }
+            return emitted;
+        }
+        catch (err) {
+            logger.warn({ err }, "Repository management cron tick failed");
+            return 0;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    scheduleNext(delaySeconds) {
+        if (this.stopped)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick().finally(() => this.scheduleNext(this.tickIntervalSeconds));
+        }, delaySeconds * 1000);
+        this.timer.unref?.();
+    }
+    resolveContextDir() {
+        const value = this.options.contextDir;
+        if (typeof value === "function")
+            return value();
+        if (typeof value === "string")
+            return value;
+        throw new Error("contextDir is required for direct repository management scans");
+    }
+    buildEvent(row) {
+        const now = this.now();
+        const base = createEvent({
+            type: "scheduled.task",
+            source: REPOSITORY_MANAGEMENT_CRON_OBSERVER_NAME,
+            priority: EventPriority.NORMAL,
+        });
+        return {
+            ...base,
+            task: `Run daily git management scan for ${row.slug}.`,
+            taskContext: {
+                triggerSource: "repository_management_cron",
+                processKey: REPOSITORY_MANAGEMENT_PROCESS_KEY,
+                repository: {
+                    id: row.id,
+                    slug: row.slug,
+                    localPath: row.localPath,
+                    githubRepo: row.githubOwner && row.githubRepo
+                        ? `${row.githubOwner}/${row.githubRepo}`
+                        : null,
+                    classification: row.classification,
+                    category: row.category,
+                    pollPriority: row.pollPriority,
+                },
+                repositoryId: row.id,
+                slug: row.slug,
+                localPath: row.localPath,
+                githubRepo: row.githubOwner && row.githubRepo
+                    ? `${row.githubOwner}/${row.githubRepo}`
+                    : null,
+                classification: row.classification,
+                category: row.category,
+                overviewPath: gitRepoOverviewPath(row.slug),
+                journalPath: gitRepoJournalPath(row.slug, now.toISOString().slice(0, 10)),
+                lookbackHours: 24,
+                firedAt: now.toISOString(),
+            },
+        };
+    }
+}
+//# sourceMappingURL=repository-management-cron.js.map

package/dist/observers/repository-management-cron.js.map

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

package/dist/observers/skill-curation-walker.d.ts

@@ -0,0 +1,33 @@
+import type Database from "better-sqlite3";
+import type { Observer } from "./manager.js";
+import { buildKnowledgeMap } from "../core/skill-curation/knowledge-map.js";
+import { type LoadedCurationDeclaration } from "../core/skill-curation/declarations.js";
+import { OverlayStore } from "../core/skill-curation/overlay-store.js";
+interface WalkerOptions {
+    intervalMs?: number;
+    /** Inject for tests. */
+    now?: () => number;
+}
+export declare class SkillCurationWalker implements Observer {
+    private readonly db;
+    private readonly contextDir;
+    private readonly skillsRoot;
+    private readonly dataDir;
+    readonly name = "skill-curation-walker";
+    private timer;
+    private readonly intervalMs;
+    private readonly now;
+    private running;
+    constructor(db: Database.Database, contextDir: string, skillsRoot: string, dataDir: string, options?: WalkerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Public for tests + ad-hoc /api/skill-curation/walker/run. */
+    runOnce(): Promise<{
+        inserted: number;
+        skills_walked: number;
+    }>;
+}
+/** Exported for unit tests. */
+export declare function diffSkill(db: Database.Database, decl: LoadedCurationDeclaration, snapshot: ReturnType<typeof buildKnowledgeMap>, overlay: OverlayStore, now: number): number;
+export {};
+//# sourceMappingURL=skill-curation-walker.d.ts.map