@aitne/daemon 0.1.0

package/dist/core/context/reconciler-runner.js

@@ -0,0 +1,273 @@
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, mkdirSync, openSync, readSync, closeSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { localDateStr } from "@aitne/shared";
+import { CONTEXT_RELATIVE_PATHS, CONTEXT_FILE_EXTENSIONS, } from "../context-paths.js";
+import { parseContextIndexRows, } from "../review-context.js";
+import { validateContextFileFrontmatter } from "../context-frontmatter.js";
+import { POLICY_FILE_MAX_BYTES } from "../policy-files.js";
+import { writeRuntimeState, getDegradedMode, } from "../../db/runtime-state.js";
+import { createLogger } from "../../logging.js";
+import { applyRollingRetention, reconcileContextIndex, renderContextIndex, shouldIndexPath, } from "./index-reconciler.js";
+const logger = createLogger("context-index-reconciler");
+/** Runtime-state key for the minimum-viable run record — §5.6. */
+export const RECONCILER_LAST_RUN_KEY = "reconciler.context_index.last_run";
+/** First N lines of a file are scanned for an H1 title. */
+const H1_SCAN_LINE_LIMIT = 20;
+/**
+ * Per-process mutex. The design doc (§4.5) originally proposed sharing
+ * `withWriteLock` from `context.ts`, but that helper is closure-local to
+ * `createContextRoutes` and extracting it would ripple through the route
+ * file. No agent task flow writes to `context-index.md` via the API
+ * today — the file is reconciler-owned — so a process-scoped mutex is
+ * sufficient. If a future flow starts writing to the index via
+ * `PUT /api/context/context-index`, promote this to a shared mutex.
+ */
+let runnerMutex = Promise.resolve();
+/**
+ * Drive one reconciler pass end-to-end:
+ *  1. Early-exit when degraded mode is active (vault unreachable).
+ *  2. Walk `contextDir`, build the snapshot with retention caps applied.
+ *  3. Read the current `context-index.md`, parse rows. If the file is
+ *     missing, start from an empty row list (§4.5 missing-file recovery).
+ *  4. Compute the diff and short-circuit on no-op.
+ *  5. Render + self-validate via `validateContextFileFrontmatter`.
+ *  6. Write under the per-process mutex, update the write tracker,
+ *     snapshot the previous contents, and notify prompt listeners.
+ *  7. Persist a single `runtime_state` row regardless of outcome so the
+ *     Phase 2b gate (§2.2) can query the last run deterministically.
+ */
+export async function runReconciler(opts) {
+    const prev = runnerMutex;
+    let releaseMutex;
+    runnerMutex = new Promise((resolve) => {
+        releaseMutex = resolve;
+    });
+    try {
+        await prev;
+        return await runOnce(opts);
+    }
+    finally {
+        releaseMutex();
+    }
+}
+async function runOnce(opts) {
+    const now = opts.now ? opts.now() : new Date();
+    const today = localDateStr(now, opts.timezone || undefined);
+    const recordBase = {
+        at: now.toISOString(),
+        trigger: opts.trigger,
+        added: 0,
+        removed: 0,
+        refreshedMtime: 0,
+    };
+    const degraded = getDegradedMode(opts.db);
+    if (degraded) {
+        const record = {
+            ...recordBase,
+            result: "noop",
+            error: `degraded_mode:${degraded.reason}`,
+        };
+        persistRunRecord(opts.db, record);
+        return record;
+    }
+    try {
+        const snapshot = applyRollingRetention(buildSnapshot(opts.contextDir, opts.timezone));
+        const currentRows = readCurrentRows(opts.contextDir);
+        const diff = reconcileContextIndex(snapshot, currentRows);
+        if (diff.noOp) {
+            const record = {
+                ...recordBase,
+                result: "noop",
+                error: null,
+            };
+            persistRunRecord(opts.db, record);
+            return record;
+        }
+        const output = renderContextIndex(diff.rows, today);
+        const validationError = validateContextFileFrontmatter(output, CONTEXT_RELATIVE_PATHS.contextIndex);
+        if (validationError) {
+            const record = {
+                ...recordBase,
+                result: "error",
+                error: `self_validation_failed:${validationError.code}`,
+                added: diff.added.length,
+                removed: diff.removed.length,
+                refreshedMtime: diff.refreshedMtime.length,
+            };
+            persistRunRecord(opts.db, record);
+            logger.error({
+                added: diff.added.length,
+                removed: diff.removed.length,
+                refreshedMtime: diff.refreshedMtime.length,
+                validation: validationError,
+            }, "Reconciler output failed frontmatter validation — leaving file untouched");
+            return record;
+        }
+        writeIndex(opts, output);
+        const record = {
+            ...recordBase,
+            result: "applied",
+            error: null,
+            added: diff.added.length,
+            removed: diff.removed.length,
+            refreshedMtime: diff.refreshedMtime.length,
+        };
+        persistRunRecord(opts.db, record);
+        logger.info({
+            trigger: opts.trigger,
+            added: diff.added.length,
+            removed: diff.removed.length,
+            refreshedMtime: diff.refreshedMtime.length,
+        }, "Reconciler applied");
+        return record;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const record = {
+            ...recordBase,
+            result: "error",
+            error: message.slice(0, 200),
+        };
+        persistRunRecord(opts.db, record);
+        logger.error({ err, trigger: opts.trigger }, "Reconciler run failed");
+        return record;
+    }
+}
+function buildSnapshot(contextDir, timezone) {
+    if (!existsSync(contextDir))
+        return [];
+    const out = [];
+    walkDirectory(contextDir, "", (relativePath) => {
+        if (!shouldIndexPath(relativePath))
+            return;
+        const absolute = join(contextDir, relativePath);
+        try {
+            const stat = statSync(absolute);
+            const mtimeDate = localDateStr(stat.mtime, timezone || undefined);
+            const h1Title = extractH1(absolute);
+            out.push({ path: relativePath, mtimeDate, h1Title });
+        }
+        catch (err) {
+            logger.debug({ err, path: relativePath }, "Skipping unreadable file in reconciler snapshot");
+        }
+    });
+    return out;
+}
+function walkDirectory(root, relativePrefix, visit) {
+    const absolute = join(root, relativePrefix);
+    let entries;
+    try {
+        entries = readdirSync(absolute, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name === ".git" ||
+            entry.name === ".obsidian" ||
+            entry.name === ".DS_Store") {
+            continue;
+        }
+        const rel = relativePrefix ? `${relativePrefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            walkDirectory(root, rel, visit);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const hasTrackedExtension = CONTEXT_FILE_EXTENSIONS.some((ext) => entry.name.endsWith(ext));
+        if (!hasTrackedExtension)
+            continue;
+        visit(rel);
+    }
+}
+function extractH1(absolute) {
+    // Bounded read (§4.4): scan at most `POLICY_FILE_MAX_BYTES` from the
+    // start of the file. The H1 we care about lives in the first ~20 lines,
+    // which fits comfortably within 32 KB for any reasonable file; larger
+    // reads would make the reconciler O(vault bytes) instead of O(files).
+    let fd;
+    try {
+        fd = openSync(absolute, "r");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buf = Buffer.alloc(POLICY_FILE_MAX_BYTES);
+        const bytes = readSync(fd, buf, 0, POLICY_FILE_MAX_BYTES, 0);
+        const content = buf.slice(0, bytes).toString("utf-8");
+        const lines = content.split(/\r?\n/).slice(0, H1_SCAN_LINE_LIMIT);
+        let inFrontmatter = false;
+        for (const rawLine of lines) {
+            const line = rawLine.trim();
+            if (!inFrontmatter && line === "---") {
+                inFrontmatter = true;
+                continue;
+            }
+            if (inFrontmatter) {
+                if (line === "---") {
+                    inFrontmatter = false;
+                }
+                continue;
+            }
+            const match = /^#\s+(.+?)\s*$/.exec(line);
+            if (match)
+                return match[1];
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            closeSync(fd);
+        }
+        catch {
+            // best-effort close
+        }
+    }
+}
+function readCurrentRows(contextDir) {
+    const absolute = join(contextDir, CONTEXT_RELATIVE_PATHS.contextIndex);
+    if (!existsSync(absolute))
+        return [];
+    try {
+        const content = readFileSync(absolute, "utf-8");
+        return parseContextIndexRows(content);
+    }
+    catch (err) {
+        logger.warn({ err }, "Reconciler could not read existing context-index.md — treating as empty");
+        return [];
+    }
+}
+function writeIndex(opts, content) {
+    const absolute = join(opts.contextDir, CONTEXT_RELATIVE_PATHS.contextIndex);
+    const directory = dirname(absolute);
+    mkdirSync(directory, { recursive: true });
+    if (existsSync(absolute)) {
+        try {
+            const previous = readFileSync(absolute, "utf-8");
+            saveSnapshot(opts.db, CONTEXT_RELATIVE_PATHS.contextIndex, previous);
+        }
+        catch (err) {
+            logger.warn({ err }, "Reconciler failed to snapshot previous context-index.md");
+        }
+    }
+    writeFileSync(absolute, content, "utf-8");
+    opts.writeTracker?.markWriting(absolute, content);
+    opts.onPromptContextChanged?.(CONTEXT_RELATIVE_PATHS.contextIndex, "reconciler", "quiet", { tierReason: "derived_context_index" });
+}
+function saveSnapshot(db, filePath, content) {
+    db.prepare("INSERT INTO md_file_snapshots (file_path, content, trigger, session_id) VALUES (?, ?, ?, ?)").run(filePath, content, "reconciler_write", null);
+}
+function persistRunRecord(db, record) {
+    try {
+        writeRuntimeState(db, RECONCILER_LAST_RUN_KEY, record);
+    }
+    catch (err) {
+        logger.warn({ err, record }, "Reconciler run record persistence failed");
+    }
+}
+//# sourceMappingURL=reconciler-runner.js.map

package/dist/core/context/reconciler-runner.js.map

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

package/dist/core/context-builder.d.ts

@@ -0,0 +1,115 @@
+import type Database from "better-sqlite3";
+import type { Event } from "@aitne/shared";
+import type { AgentConfig } from "../config.js";
+import type { IContextBuilder } from "./dispatcher.js";
+import type { ServiceRegistry } from "../services/service-registry.js";
+export declare class ContextBuilder implements IContextBuilder {
+    private readonly config;
+    private readonly db;
+    private readonly services;
+    constructor(config: AgentConfig, db: Database.Database, services: ServiceRegistry);
+    /**
+     * Resolve the readable primary-vault location for prompt construction.
+     *
+     * During degraded mode we intentionally return `null` instead of the
+     * fallback `<dataDir>/context`: reactive sessions may still run so the
+     * user can fix the vault, but they must not see stale context data from
+     * a legacy location.
+     */
+    private get readableContextDir();
+    build(event: Event): Promise<string>;
+    /**
+     * Compute the calendar lookahead window anchored at the user-timezone
+     * midnight boundary. Shared by direct-mode fetches and the delegated-mode
+     * MCP-fetch directive so both paths describe exactly the same range.
+     */
+    private computeCalendarWindow;
+    /**
+     * Build a `<calendar_events_…>` context block, honouring Google Calendar
+     * integration mode:
+     *
+     * - **direct + service available** → embed the formatted event list (prior
+     *   behaviour).
+     * - **delegated** → the daemon has no local CalendarService to call. Emit
+     *   a structured directive telling the task-flow agent to fetch the same
+     *   window itself via its backend's Google Calendar MCP tool and treat the
+     *   response as the contents of this block.
+     * - **direct but service broken / disabled** → emit the legacy
+     *   `<calendar_status>` unavailable line so the flow degrades gracefully.
+     *
+     * All callers funnel through this method so the three surfaces
+     * (morning / evening / weekly+monthly and the agent-task path) stay in
+     * lock-step when delegated-mode handling changes.
+     */
+    private buildCalendarBlock;
+    /**
+     * Fetch calendar events for the next N days and format as markdown.
+     * Groups events by date with day-of-week and Today/Tomorrow labels.
+     * Returns null if CalendarService is not available.
+     */
+    private fetchCalendarEvents;
+    /** Format calendar events grouped by date */
+    private formatCalendarEvents;
+    /** Format event time range as "HH:MM–HH:MM" or "All day" */
+    private formatTimeRange;
+    private formatLocalTime;
+    /**
+     * SCHEDULED-DM-IMPLEMENTATION-PLAN §5.7 — return inbound owner-DM
+     * messages received in the last `windowMinutes` across BOTH
+     * owner-facing scopes (`owner_dm` for messaging-app DMs and
+     * `dashboard_chat` for the dashboard chat panel), formatted one per
+     * line oldest first. Returns null when there are no messages so the
+     * caller can omit the block entirely.
+     *
+     * The two-scope query mirrors §3.6's gate set: the briefing
+     * serializes behind both surfaces, so the LLM must see both
+     * surfaces when classifying conversation state. A single-scope read
+     * here would mis-classify state as `asleep` whenever the user is
+     * mid-conversation on the OTHER surface — exactly the
+     * voice-mismatch failure the design exists to fix.
+     *
+     * `docs_qa` is intentionally excluded — that surface is research
+     * lookups, not conversation; gating against it would freeze
+     * briefings during long doc-searches.
+     */
+    private buildRecentDmActivityBlock;
+    /**
+     * SCHEDULED-DM-IMPLEMENTATION-PLAN §5.7 — return the last `limit`
+     * owner-facing messages across BOTH `owner_dm` and `dashboard_chat`
+     * scopes (interleaved by timestamp), formatted with role tags. Used
+     * by `<recent_dm_conversation>` for topic awareness in the bridge
+     * phrasing of Variant B briefings.
+     *
+     * Two-scope read — same reasoning as `buildRecentDmActivityBlock`:
+     * the briefing must reconstruct topic context from whichever surface
+     * the user has been using, not just the messaging-app one.
+     */
+    private buildOwnerDmConversationHistory;
+    private getConversationHistory;
+    private buildRecentOtherSurfaceBlock;
+    private logProactiveForwardInjected;
+    private readFile;
+    private buildActiveProjectsSection;
+    /**
+     * Render a rolling 7-day (or N-day) window of DM conversation-log
+     * summaries for roadmap_refresh. Unlike `buildYesterdaySqliteContext`,
+     * which is anchored to the previous agent-day for journal synthesis,
+     * this window is calendar-rolling — refreshes can trigger at any
+     * time, and the prompt needs whatever recent DM context exists.
+     *
+     * Returns a formatted markdown block; falls back to a "(none)" stub
+     * so the prompt can always cite the tag unconditionally.
+     */
+    private buildRecentDmConversationLog;
+    private buildYesterdaySqliteContext;
+    /**
+     * Current-agent-day variant of `buildYesterdaySqliteContext` for the
+     * user-profile sweep (§Phase 2). Resolves the day bounds to the
+     * CURRENT agent-day — at 03:50 that window is ~04:00 yesterday →
+     * 03:50 today (the agent-day about to close), and at 17:50 it is
+     * ~04:00 today → 17:50 today. The sweep reads DM traffic + rolling
+     * summaries but not agent_actions (not needed for fact extraction).
+     */
+    private buildAgentDayDmContext;
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/core/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,KAAK,EAEN,MAAM,eAAe,CAAC;AAiBvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAYhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAiBvE,qBAAa,cAAe,YAAW,eAAe;IAElD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,eAAe;IAG5C;;;;;;;OAOG;IACH,OAAO,KAAK,kBAAkB,GAK7B;IAEK,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAsa1C;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;;;;;;;;;;;;;OAgBG;YACW,kBAAkB;IAkDhC;;;;OAIG;YACW,mBAAmB;IAsBjC,6CAA6C;IAC7C,OAAO,CAAC,oBAAoB;IAwD5B,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;IAKvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,+BAA+B;IAsCvC,OAAO,CAAC,sBAAsB;IAkH9B,OAAO,CAAC,4BAA4B;IAmGpC,OAAO,CAAC,2BAA2B;YAuCrB,QAAQ;YAYR,0BAA0B;IAmDxC;;;;;;;;;OASG;IACH,OAAO,CAAC,4BAA4B;YAsDtB,2BAA2B;IA+GzC;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;CA8E/B"}