@aitne/daemon 0.1.0

package/dist/core/context/default-schedules-reconciler.js.map

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

package/dist/core/context/default-schedules-runner.d.ts

@@ -0,0 +1,40 @@
+import type Database from "better-sqlite3";
+import type { PromptContextChangedCallback } from "../context-staleness.js";
+import type { AgentWriteTracker } from "../../safety/agent-write-tracker.js";
+import type { ReconcilerRunRecord, ReconcilerTrigger } from "./reconciler-runner.js";
+import { type DefaultScheduleSnapshotEntry } from "./default-schedules-reconciler.js";
+/** Runtime-state key for the default-schedules reconciler's last run. */
+export declare const DEFAULT_SCHEDULES_RECONCILER_LAST_RUN_KEY = "reconciler.default_schedules.last_run";
+/**
+ * SCHEDULED-DM-IMPLEMENTATION-PLAN §6.5 — drive one pass of the
+ * `## Default Schedules` reconciler:
+ *
+ *   1. Read the `recurring_schedules` table → build snapshots.
+ *   2. Render the desired section content.
+ *   3. Compare against the existing on-disk `## Default Schedules`
+ *      section; short-circuit on no-op.
+ *   4. Snapshot prior content to `md_file_snapshots`, write the
+ *      file, mark the agent-write tracker, notify the prompt-context
+ *      sink.
+ *   5. Persist a single `runtime_state` row regardless of outcome.
+ *
+ * Mirrors `policy-index-runner.ts` exactly. Runs under its own
+ * per-process mutex so concurrent calls serialise.
+ */
+export interface RunDefaultSchedulesReconcilerOptions {
+    db: Database.Database;
+    contextDir: string;
+    writeTracker?: AgentWriteTracker;
+    onPromptContextChanged?: PromptContextChangedCallback;
+    trigger: ReconcilerTrigger;
+    /** Injectable clock for deterministic test output. */
+    now?: () => Date;
+}
+export declare function runDefaultSchedulesReconciler(opts: RunDefaultSchedulesReconcilerOptions): Promise<ReconcilerRunRecord>;
+/**
+ * Build a snapshot of the `recurring_schedules` table for rendering.
+ * Exported so the setup wizard's save-rules handler can call it
+ * directly (in-place splice without going through the runner).
+ */
+export declare function buildDefaultSchedulesSnapshot(db: Database.Database): DefaultScheduleSnapshotEntry[];
+//# sourceMappingURL=default-schedules-runner.d.ts.map

package/dist/core/context/default-schedules-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-schedules-runner.d.ts","sourceRoot":"","sources":["../../../src/core/context/default-schedules-runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAIL,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAC;AAI3C,yEAAyE;AACzE,eAAO,MAAM,yCAAyC,0CACb,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oCAAoC;IACnD,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAID,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,oCAAoC,GACzC,OAAO,CAAC,mBAAmB,CAAC,CAY9B;AAiID;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,4BAA4B,EAAE,CA8BhC"}

package/dist/core/context/default-schedules-runner.js

@@ -0,0 +1,233 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { CONTEXT_RELATIVE_PATHS } from "../context-paths.js";
+import { validateContextFileFrontmatter } from "../context-frontmatter.js";
+import { writeRuntimeState, getDegradedMode } from "../../db/runtime-state.js";
+import { createLogger } from "../../logging.js";
+import { deriveDefaultScheduleLabel, renderDefaultSchedulesSection, upsertManagementRulesDefaultSchedules, } from "./default-schedules-reconciler.js";
+const logger = createLogger("default-schedules-reconciler");
+/** Runtime-state key for the default-schedules reconciler's last run. */
+export const DEFAULT_SCHEDULES_RECONCILER_LAST_RUN_KEY = "reconciler.default_schedules.last_run";
+let runnerMutex = Promise.resolve();
+export async function runDefaultSchedulesReconciler(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 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 entries = buildDefaultSchedulesSnapshot(opts.db);
+        const section = renderDefaultSchedulesSection(entries);
+        const managementPath = join(opts.contextDir, CONTEXT_RELATIVE_PATHS.rules.management);
+        const previousManagement = readIfExists(managementPath);
+        // We only write when management.md exists — first creation is the
+        // setup wizard's job (see setup.ts:save-rules), the reconciler
+        // only maintains. This mirrors policy-index-runner.ts's
+        // skeleton-seeder boundary.
+        if (previousManagement === null) {
+            const record = {
+                ...recordBase,
+                result: "noop",
+                error: null,
+            };
+            persistRunRecord(opts.db, record);
+            return record;
+        }
+        const desired = upsertManagementRulesDefaultSchedules(previousManagement, section);
+        if (desired === previousManagement) {
+            const record = {
+                ...recordBase,
+                result: "noop",
+                error: null,
+            };
+            persistRunRecord(opts.db, record);
+            return record;
+        }
+        // Re-validate frontmatter after the splice. The wizard's payload
+        // is already validated on save; we don't change frontmatter here,
+        // but the cheap re-check guards against future regressions in the
+        // splice algorithm.
+        const validation = validateContextFileFrontmatter(desired, CONTEXT_RELATIVE_PATHS.rules.management);
+        if (validation) {
+            const record = {
+                ...recordBase,
+                result: "error",
+                error: `self_validation_failed:${validation.code}`,
+            };
+            persistRunRecord(opts.db, record);
+            logger.error({ validation, trigger: opts.trigger }, "Default-schedules render failed self-validation — leaving file untouched");
+            return record;
+        }
+        writeWithSnapshot(opts, managementPath, desired, previousManagement);
+        opts.onPromptContextChanged?.(CONTEXT_RELATIVE_PATHS.rules.management, "default_schedules_reconciler", "quiet", { tierReason: "derived_default_schedules" });
+        const record = {
+            ...recordBase,
+            result: "applied",
+            error: null,
+            added: entries.filter((e) => e.enabled).length,
+            removed: entries.filter((e) => !e.enabled).length,
+            refreshedMtime: entries.length,
+        };
+        persistRunRecord(opts.db, record);
+        logger.info({
+            trigger: opts.trigger,
+            enabled: record.added,
+            disabled: record.removed,
+            total: entries.length,
+        }, "Default-schedules 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 }, "Default-schedules reconciler run failed");
+        return record;
+    }
+}
+/**
+ * Build a snapshot of the `recurring_schedules` table for rendering.
+ * Exported so the setup wizard's save-rules handler can call it
+ * directly (in-place splice without going through the runner).
+ */
+export function buildDefaultSchedulesSnapshot(db) {
+    // Guard: table may not exist when a test hand-crafts a partial
+    // schema. Mirrors `reconcileRecurringSchedules`'s tableExists check.
+    const tableExists = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='recurring_schedules'")
+        .get();
+    if (!tableExists)
+        return [];
+    const rows = db
+        .prepare("SELECT * FROM recurring_schedules ORDER BY id ASC")
+        .all();
+    return rows.map((row) => {
+        const ctx = safeJsonObject(row.task_context);
+        const subFlow = typeof ctx.sub_flow === "string" ? ctx.sub_flow : null;
+        const pinnedToQuietHours = ctx.pin_to_quiet_hours_end === true;
+        return {
+            id: row.id,
+            label: deriveDefaultScheduleLabel(subFlow, row.task_description ?? ""),
+            recurrenceRule: parseRecurrenceRule(row.recurrence_rule),
+            enabled: row.enabled === 1,
+            pinnedToQuietHours,
+            subFlow,
+        };
+    });
+}
+/**
+ * Parse a stored `recurrence_rule` JSON string into a RecurrenceRule.
+ * Hands back a coercion-friendly object: malformed JSON or a missing
+ * column yields a placeholder `daily —` rule that `formatRecurrenceLabel`
+ * still renders without throwing. The full input shape (incl. day
+ * arrays) is preserved so weekly/monthly cadences render correctly.
+ */
+function parseRecurrenceRule(raw) {
+    const obj = safeJsonObject(raw);
+    const frequency = obj.frequency === "weekly" || obj.frequency === "monthly"
+        ? obj.frequency
+        : "daily";
+    const time = typeof obj.time === "string" ? obj.time : "—";
+    const out = { frequency, time };
+    if (typeof obj.timezone === "string" && obj.timezone.length > 0) {
+        out.timezone = obj.timezone;
+    }
+    if (Array.isArray(obj.daysOfWeek)) {
+        const days = obj.daysOfWeek.filter((d) => typeof d === "number" && d >= 0 && d <= 6);
+        if (days.length > 0)
+            out.daysOfWeek = days;
+    }
+    if (Array.isArray(obj.daysOfMonth)) {
+        const days = obj.daysOfMonth.filter((d) => typeof d === "number" && d >= 1 && d <= 31);
+        if (days.length > 0)
+            out.daysOfMonth = days;
+    }
+    return out;
+}
+function safeJsonObject(value) {
+    if (!value)
+        return {};
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readIfExists(absolutePath) {
+    if (!existsSync(absolutePath))
+        return null;
+    try {
+        return readFileSync(absolutePath, "utf-8");
+    }
+    catch (err) {
+        logger.warn({ err, file: absolutePath }, "Reconciler could not read file");
+        return null;
+    }
+}
+function writeWithSnapshot(opts, absolutePath, content, previousContent) {
+    const directory = dirname(absolutePath);
+    mkdirSync(directory, { recursive: true });
+    if (previousContent !== null) {
+        try {
+            const relativePath = relativizeToContext(opts.contextDir, absolutePath);
+            opts.db
+                .prepare("INSERT INTO md_file_snapshots (file_path, content, trigger, session_id) VALUES (?, ?, ?, ?)")
+                .run(relativePath, previousContent, "default_schedules_reconciled", null);
+        }
+        catch (err) {
+            logger.warn({ err, file: absolutePath }, "Failed to snapshot prior content before default-schedules write");
+        }
+    }
+    writeFileSync(absolutePath, content, "utf-8");
+    opts.writeTracker?.markWriting(absolutePath, content);
+}
+function relativizeToContext(contextDir, absolutePath) {
+    if (absolutePath.startsWith(contextDir)) {
+        return absolutePath.slice(contextDir.length).replace(/^[\\/]+/, "");
+    }
+    return absolutePath;
+}
+function persistRunRecord(db, record) {
+    try {
+        writeRuntimeState(db, DEFAULT_SCHEDULES_RECONCILER_LAST_RUN_KEY, record);
+    }
+    catch (err) {
+        logger.warn({ err, record }, "Default-schedules reconciler run record persistence failed");
+    }
+}
+//# sourceMappingURL=default-schedules-runner.js.map

package/dist/core/context/default-schedules-runner.js.map

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

package/dist/core/context/domain-index-reconciler.d.ts

@@ -0,0 +1,81 @@
+import { type Domain, type EntityType } from "@aitne/shared";
+/**
+ * One entity row consumed by the domain-index renderer. Mirrors the
+ * `entities` table columns the renderer cares about. Lives here (not
+ * in `entities-store.ts`) because the renderer does not use the
+ * `EntityRecord` shape's parsed `sources` — it only renders the
+ * lex-sorted source-key list, which is cheaper to compute from the
+ * sidecar.
+ */
+export interface DomainIndexEntityInput {
+    path: string;
+    domain: Domain;
+    type: EntityType;
+    title: string;
+    status: string | null;
+    /** ISO date when present in frontmatter, else null. */
+    date: string | null;
+    /** ISO datetime — `last_synced_at`. Used as a fallback for "Last touched". */
+    lastSyncedAt: string | null;
+    /** Lex-sorted source keys (pre-aggregated from `entity_source_keys`). */
+    sourceKeys: string[];
+}
+export interface DomainIndexBuckets {
+    /** Domain → entities, sorted by display rules (see `bucketByDomain`). */
+    byDomain: Map<Domain, DomainIndexEntityInput[]>;
+}
+/**
+ * Group entities by their `domain` field. Within a bucket, rows are
+ * ordered by:
+ *   1. status precedence — `upcoming` and `active` first, `done` next,
+ *      `archived` last, anything else (or null) interleaves alphabetically
+ *      after `active`,
+ *   2. `lastTouched` descending — fresher rows on top within a status,
+ *   3. `path` ascending — final tiebreaker for determinism.
+ *
+ * Empty domains are still returned (with an empty array) so the runner
+ * can produce a placeholder index file when a domain has no entities
+ * yet (avoids a "missing index" warning on the dashboard).
+ */
+export declare function bucketByDomain(entities: readonly DomainIndexEntityInput[]): DomainIndexBuckets;
+/**
+ * Format the "Last touched" column. Prefers `date` (ISO-date) over
+ * `last_synced_at` (ISO-datetime, sliced to the YYYY-MM-DD prefix).
+ */
+export declare function formatLastTouched(entity: DomainIndexEntityInput): string;
+/**
+ * Format the source-keys column. Outputs `+`-joined keys for the
+ * §9.7 example (`calendar+zoom+docs`); empty list renders an em-dash.
+ */
+export declare function formatSources(sourceKeys: readonly string[]): string;
+/**
+ * Render the §9.7 file body for a single domain.
+ *
+ *   - frontmatter → `type: index`, `domain: <d>`, `auto_generated:
+ *     true`, `last_built: <updated>`,
+ *   - H1 with `<Capitalised Domain> — Index`,
+ *   - H2 "Active items" with the §9.7 table layout.
+ *
+ * The renderer never throws on empty input; an empty domain emits the
+ * frontmatter, the H1, the H2, and an em-dash placeholder row — so the
+ * file remains schema-valid for the prompt assembly path.
+ */
+export declare function renderDomainIndex(domain: Domain, entities: readonly DomainIndexEntityInput[], updated: string): string;
+/**
+ * Relative path to a domain's `_index.md`. Stable across releases — the
+ * runner uses this to resolve the absolute write target.
+ */
+export declare function relativeDomainIndexPath(domain: Domain): string;
+/**
+ * Validate a relative path looks like a domain index. Used by the
+ * runner's safety check before writing — defense-in-depth against a
+ * caller-supplied domain that was tampered with.
+ */
+export declare function isDomainIndexPath(relativePath: string): boolean;
+/**
+ * Map an L2 entity directory back to its parent domain. Returns `null`
+ * when the path is not a recognised entity directory (defense in depth
+ * for tests that exercise foreign paths).
+ */
+export declare function entityDirToDomain(relativeDir: string): Domain | null;
+//# sourceMappingURL=domain-index-reconciler.d.ts.map

package/dist/core/context/domain-index-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-index-reconciler.d.ts","sourceRoot":"","sources":["../../../src/core/context/domain-index-reconciler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AA0BvB;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yEAAyE;IACzE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAC1C,kBAAkB,CAcpB;AAoCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAIxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,OAAO,EAAE,MAAM,GACd,MAAM,CAqBR;AA4BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE"}

package/dist/core/context/domain-index-reconciler.js

@@ -0,0 +1,199 @@
+import { DOMAINS, pluralToType, } from "@aitne/shared";
+/**
+ * Domain-index reconciler — pure render + diff for
+ * `<contextDir>/<domain>/_index.md`
+ * (docs/design/21-management-registry-and-entities.md §7.2 / §9.7).
+ *
+ * Inputs come from the `entities` SQLite mirror (P5 entity-mirror
+ * reconciler). The pure layer here is responsible for:
+ *
+ *   - bucketing rows by `domain` (each domain renders one file),
+ *   - producing the §9.7 markdown body deterministically,
+ *   - exposing `renderActiveItemsTable` so tests can assert table-shape
+ *     invariants without round-tripping through file I/O.
+ *
+ * The driver layer (`domain-index-runner.ts`) walks the buckets, reads
+ * the existing on-disk file, compares output, and writes via the
+ * atomic-write helper when a diff is detected.
+ *
+ * Determinism contract: the renderer is a pure function of its inputs.
+ * For a given snapshot + `updated` value, the rendered string is byte-
+ * identical across calls and across releases of the same schema.
+ */
+const EM_DASH = "—";
+/**
+ * Group entities by their `domain` field. Within a bucket, rows are
+ * ordered by:
+ *   1. status precedence — `upcoming` and `active` first, `done` next,
+ *      `archived` last, anything else (or null) interleaves alphabetically
+ *      after `active`,
+ *   2. `lastTouched` descending — fresher rows on top within a status,
+ *   3. `path` ascending — final tiebreaker for determinism.
+ *
+ * Empty domains are still returned (with an empty array) so the runner
+ * can produce a placeholder index file when a domain has no entities
+ * yet (avoids a "missing index" warning on the dashboard).
+ */
+export function bucketByDomain(entities) {
+    const byDomain = new Map();
+    for (const domain of DOMAINS)
+        byDomain.set(domain, []);
+    for (const entity of entities) {
+        const bucket = byDomain.get(entity.domain);
+        /* c8 ignore next 4 — `entity.domain` is typed as `Domain`, so the
+           Map lookup is guaranteed to return a bucket; the branch exists
+           only as a defensive guard against an out-of-enum row leaking
+           past the type system. */
+        if (!bucket)
+            continue;
+        bucket.push(entity);
+    }
+    for (const bucket of byDomain.values())
+        bucket.sort(compareForRender);
+    return { byDomain };
+}
+const STATUS_ORDER = {
+    upcoming: 0,
+    active: 1,
+    done: 3,
+    archived: 4,
+};
+function statusRank(status) {
+    if (!status)
+        return 2;
+    return STATUS_ORDER[status] ?? 2;
+}
+function compareForRender(a, b) {
+    const sa = statusRank(a.status);
+    const sb = statusRank(b.status);
+    if (sa !== sb)
+        return sa - sb;
+    const ta = lastTouchedSortKey(a);
+    const tb = lastTouchedSortKey(b);
+    if (ta !== tb)
+        return tb.localeCompare(ta);
+    return a.path.localeCompare(b.path);
+}
+function lastTouchedSortKey(entity) {
+    // Prefer the structured `date` (a calendar anchor) for sort; fall
+    // back to `last_synced_at` (a sync stamp) when `date` is absent.
+    // Empty string sorts last under descending order, which is what we
+    // want for entities with neither — they go to the bottom of their
+    // status bucket.
+    return entity.date ?? entity.lastSyncedAt ?? "";
+}
+/**
+ * Format the "Last touched" column. Prefers `date` (ISO-date) over
+ * `last_synced_at` (ISO-datetime, sliced to the YYYY-MM-DD prefix).
+ */
+export function formatLastTouched(entity) {
+    if (entity.date)
+        return entity.date;
+    if (entity.lastSyncedAt)
+        return entity.lastSyncedAt.slice(0, 10);
+    return EM_DASH;
+}
+/**
+ * Format the source-keys column. Outputs `+`-joined keys for the
+ * §9.7 example (`calendar+zoom+docs`); empty list renders an em-dash.
+ */
+export function formatSources(sourceKeys) {
+    if (sourceKeys.length === 0)
+        return EM_DASH;
+    return sourceKeys.join("+");
+}
+/**
+ * Render the §9.7 file body for a single domain.
+ *
+ *   - frontmatter → `type: index`, `domain: <d>`, `auto_generated:
+ *     true`, `last_built: <updated>`,
+ *   - H1 with `<Capitalised Domain> — Index`,
+ *   - H2 "Active items" with the §9.7 table layout.
+ *
+ * The renderer never throws on empty input; an empty domain emits the
+ * frontmatter, the H1, the H2, and an em-dash placeholder row — so the
+ * file remains schema-valid for the prompt assembly path.
+ */
+export function renderDomainIndex(domain, entities, updated) {
+    const lines = [];
+    lines.push("---");
+    lines.push("type: index");
+    lines.push(`domain: ${domain}`);
+    lines.push("auto_generated: true");
+    lines.push(`last_built: ${updated}`);
+    lines.push("---");
+    lines.push(`# ${capitalize(domain)} — Index`);
+    lines.push("");
+    lines.push("## Active items");
+    lines.push("");
+    lines.push("| Title | Type | Sources | Status | Last touched |");
+    lines.push("|---|---|---|---|---|");
+    if (entities.length === 0) {
+        lines.push(`| ${EM_DASH} | ${EM_DASH} | ${EM_DASH} | ${EM_DASH} | ${EM_DASH} |`);
+    }
+    else {
+        for (const entity of entities)
+            lines.push(renderRow(entity));
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function renderRow(entity) {
+    return [
+        "|",
+        escapeCell(entity.title),
+        "|",
+        escapeCell(entity.type),
+        "|",
+        escapeCell(formatSources(entity.sourceKeys)),
+        "|",
+        escapeCell(entity.status ?? EM_DASH),
+        "|",
+        escapeCell(formatLastTouched(entity)),
+        "|",
+    ].join(" ");
+}
+function escapeCell(value) {
+    return value.replace(/\|/g, "\\|").replace(/\s+/g, " ").trim() || EM_DASH;
+}
+function capitalize(value) {
+    return value.slice(0, 1).toUpperCase() + value.slice(1);
+}
+// ── Path resolution ────────────────────────────────────────────────────────
+/**
+ * Relative path to a domain's `_index.md`. Stable across releases — the
+ * runner uses this to resolve the absolute write target.
+ */
+export function relativeDomainIndexPath(domain) {
+    return `${domain}/_index.md`;
+}
+/**
+ * Validate a relative path looks like a domain index. Used by the
+ * runner's safety check before writing — defense-in-depth against a
+ * caller-supplied domain that was tampered with.
+ */
+export function isDomainIndexPath(relativePath) {
+    const segments = relativePath.split("/");
+    if (segments.length !== 2)
+        return false;
+    if (segments[1] !== "_index.md")
+        return false;
+    return DOMAINS.includes(segments[0]);
+}
+/**
+ * Map an L2 entity directory back to its parent domain. Returns `null`
+ * when the path is not a recognised entity directory (defense in depth
+ * for tests that exercise foreign paths).
+ */
+export function entityDirToDomain(relativeDir) {
+    const segments = relativeDir.split("/");
+    if (segments.length !== 2)
+        return null;
+    const [domain, plural] = segments;
+    if (!DOMAINS.includes(domain))
+        return null;
+    if (pluralToType(plural) === null)
+        return null;
+    return domain;
+}
+//# sourceMappingURL=domain-index-reconciler.js.map

package/dist/core/context/domain-index-reconciler.js.map

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

package/dist/core/context/domain-index-runner.d.ts

@@ -0,0 +1,35 @@
+import type Database from "better-sqlite3";
+import type { AgentWriteTracker } from "../../safety/agent-write-tracker.js";
+import type { PromptContextChangedCallback } from "../context-staleness.js";
+import type { ReconcilerRunRecord, ReconcilerTrigger } from "./reconciler-runner.js";
+/** Runtime-state key for the domain-index reconciler's last run record. */
+export declare const DOMAIN_INDEX_RECONCILER_LAST_RUN_KEY = "reconciler.domain_index.last_run";
+export interface RunDomainIndexReconcilerOptions {
+    db: Database.Database;
+    contextDir: string;
+    writeTracker?: AgentWriteTracker;
+    onPromptContextChanged?: PromptContextChangedCallback;
+    timezone?: string;
+    trigger: ReconcilerTrigger;
+    /** Injectable clock for deterministic test output. */
+    now?: () => Date;
+}
+/**
+ * Drive one pass of the domain-index reconciler:
+ *
+ *   1. Early-exit when degraded mode is active.
+ *   2. Read the `entities` table + `entity_source_keys` sidecar to build
+ *      the per-domain bucket snapshot.
+ *   3. Render each domain's `_index.md` body deterministically.
+ *   4. Compare against on-disk content; skip the write when bytes match.
+ *   5. Atomic write + agent-write-tracker mark + snapshot the prior
+ *      contents into `md_file_snapshots`.
+ *   6. Persist a single `runtime_state` row regardless of outcome.
+ *
+ * The numeric slots in `ReconcilerRunRecord` are repurposed:
+ *   - `added`           → number of files the runner wrote this pass
+ *   - `removed`         → 0 (domain index files are never removed)
+ *   - `refreshedMtime`  → number of files that already matched on disk
+ */
+export declare function runDomainIndexReconciler(opts: RunDomainIndexReconcilerOptions): Promise<ReconcilerRunRecord>;
+//# sourceMappingURL=domain-index-runner.d.ts.map

package/dist/core/context/domain-index-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-index-runner.d.ts","sourceRoot":"","sources":["../../../src/core/context/domain-index-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAUhC,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,qCACb,CAAC;AAUrC,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAY9B"}