@aitne/daemon 0.1.0

package/dist/core/context/activity-sources.js

@@ -0,0 +1,69 @@
+import { normalizeAppLabel } from "@aitne/shared";
+export function enumerateActivitySources(db, cutoffDate) {
+    // Active set first — those rows win the label slot when an
+    // entity-only or audit-only entry would later try to claim the same
+    // normalized form (managed_tasks.app is the canonical user-typed
+    // label for the active path).
+    const activeRows = db
+        .prepare(`SELECT app, app_normalized FROM managed_tasks`)
+        .all();
+    const activeSet = new Set(activeRows.map((r) => r.app_normalized));
+    const labels = new Map();
+    for (const row of activeRows) {
+        if (!labels.has(row.app_normalized)) {
+            labels.set(row.app_normalized, row.app);
+        }
+    }
+    // Entity-source-keys with an entity that lands inside the 90-day
+    // window. The COALESCE order matches `buildActivitySnapshot` so a
+    // source is only enumerated when at least one entity will actually
+    // surface in its rendered file.
+    const entityRows = db
+        .prepare(`SELECT DISTINCT k.source_key
+         FROM entity_source_keys k
+         JOIN entities e ON e.path = k.path
+        WHERE COALESCE(e.date, e.last_synced_at, '0000-00-00') >= ?`)
+        .all(cutoffDate);
+    for (const row of entityRows) {
+        const normalized = normalizeAppLabel(row.source_key);
+        if (!labels.has(normalized))
+            labels.set(normalized, row.source_key);
+    }
+    // Audit rows. UNION two SELECTs so a `management_task.app_renamed`
+    // contributes both the new label (via `$.app_normalized`) AND the
+    // old label (via `$.old_app_normalized`).
+    const auditRows = db
+        .prepare(`SELECT DISTINCT app_normalized, app FROM (
+         SELECT json_extract(detail, '$.app_normalized') AS app_normalized,
+                json_extract(detail, '$.app')            AS app
+           FROM agent_actions
+          WHERE action_type LIKE 'management_task.%'
+            AND date(started_at) >= ?
+            AND json_extract(detail, '$.app_normalized') IS NOT NULL
+         UNION
+         SELECT json_extract(detail, '$.old_app_normalized') AS app_normalized,
+                json_extract(detail, '$.old_app')            AS app
+           FROM agent_actions
+          WHERE action_type = 'management_task.app_renamed'
+            AND date(started_at) >= ?
+            AND json_extract(detail, '$.old_app_normalized') IS NOT NULL
+       )`)
+        .all(cutoffDate, cutoffDate);
+    for (const row of auditRows) {
+        if (!row.app_normalized)
+            continue;
+        if (!labels.has(row.app_normalized)) {
+            labels.set(row.app_normalized, row.app ?? row.app_normalized);
+        }
+    }
+    return Array.from(labels.entries())
+        .map(([normalized, label]) => ({
+        normalized,
+        label,
+        status: activeSet.has(normalized)
+            ? "active"
+            : "stopped",
+    }))
+        .sort((a, b) => a.normalized.localeCompare(b.normalized));
+}
+//# sourceMappingURL=activity-sources.js.map

package/dist/core/context/activity-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-sources.js","sourceRoot":"","sources":["../../../src/core/context/activity-sources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAsClD,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,UAAkB;IAElB,2DAA2D;IAC3D,oEAAoE;IACpE,iEAAiE;IACjE,8BAA8B;IAC9B,MAAM,UAAU,GAAG,EAAE;SAClB,OAAO,CAAC,+CAA+C,CAAC;SACxD,GAAG,EAA+C,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,kEAAkE;IAClE,mEAAmE;IACnE,gCAAgC;IAChC,MAAM,UAAU,GAAG,EAAE;SAClB,OAAO,CACN;;;oEAG8D,CAC/D;SACA,GAAG,CAAC,UAAU,CAA6B,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,mEAAmE;IACnE,kEAAkE;IAClE,0CAA0C;IAC1C,MAAM,SAAS,GAAG,EAAE;SACjB,OAAO,CACN;;;;;;;;;;;;;;SAcG,CACJ;SACA,GAAG,CAAC,UAAU,EAAE,UAAU,CAGxB,CAAC;IACN,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,cAAc;YAAE,SAAS;QAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,UAAU;QACV,KAAK;QACL,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAC/B,CAAC,CAAE,QAAkB;YACrB,CAAC,CAAE,SAAmB;KACzB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/core/context/activity-view-reconciler.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Window for the "Recently changed" + per-day sections. The §7.6 spec
+ * fixes this at 90 days; bump only with a schema_version bump because
+ * the rendered frontmatter `window_days` is what consumers (the query
+ * skill) read.
+ */
+export declare const ACTIVITY_VIEW_WINDOW_DAYS = 90;
+/**
+ * One active managed-task row pinned to the source (§9.6 "Active
+ * managed tasks" section). The render only needs the bits the user
+ * sees in the file; the upstream driver query in
+ * `activity-view-runner.ts` joins `managed_tasks.app_normalized` to
+ * the source label and selects only these columns.
+ */
+export interface ActiveManagedTaskInput {
+    mtId: string;
+    cadence: string;
+    /** ISO-8601 — `null` until the first successful run. */
+    lastRunAt: string | null;
+    /** Free text — `null` when never run, or em-dash when caller passes it. */
+    lastResult: string | null;
+}
+/**
+ * Audit row from `agent_actions WHERE action_type LIKE 'management_task.%'
+ * AND date(started_at) >= now-90d`. The §9.6 example renders these as
+ * `<date> mt_<n> stopped by user`; the renderer formats per
+ * `action_type`.
+ */
+export interface RecentlyChangedInput {
+    /** ISO date (YYYY-MM-DD). */
+    date: string;
+    mtId: string | null;
+    actionType: string;
+    /** Optional human-readable detail, e.g. the prior cadence on a modify. */
+    note: string | null;
+}
+/**
+ * Per-entity row pinned to the source (the §9.6 chronological
+ * section). The renderer expects rows pre-sorted by `date` descending
+ * so the most-recent days appear at the top of each `## YYYY-MM-DD`.
+ *
+ * `mtId` is the managed task that fetched / refreshed the entity, when
+ * one is known. The runner derives this by walking the entity's
+ * `sources.<source>.fetched_by` field (when the skill recorded one);
+ * unknowns render as em-dash.
+ */
+export interface EntityActivityInput {
+    /** ISO date — primary sort key. */
+    date: string;
+    /** Optional time range like "14:00–15:00"; rendered when present. */
+    timeRange: string | null;
+    title: string;
+    /** Forward-slashed relative path from the activity file's dir. */
+    entityRelativePath: string;
+    /** Free-form per-entity descriptors — rendered comma-separated. */
+    details: string[];
+    /** Managed-task id that fetched this entity, if known. */
+    mtId: string | null;
+    /** When the fetch happened, if known (ISO datetime). */
+    fetchedAt: string | null;
+}
+export interface ActivitySnapshot {
+    /** User-typed app label (the `App` column). */
+    source: string;
+    /** Lower-cased dedup form, used as the file slug + frontmatter key. */
+    sourceNormalized: string;
+    activeTasks: ActiveManagedTaskInput[];
+    recentlyChanged: RecentlyChangedInput[];
+    entities: EntityActivityInput[];
+}
+/**
+ * Map a user-typed source label to the activity-file slug. Two visually-
+ * different inputs that map to the same normalised form share one
+ * activity file (the same dedup behaviour as `managed_tasks.app_normalized`).
+ *
+ * The slug is sanitised so it makes a valid filename: spaces collapse
+ * to `-`, characters outside `[a-z0-9-]` are stripped. An empty result
+ * after sanitising returns `null` so the runner can skip the file.
+ */
+export declare function activityFileSlugFor(source: string): string | null;
+/**
+ * Relative path under `<contextDir>` for the activity file. Matches
+ * the §9.6 layout `_activity/<source>.md`. The leading underscore is
+ * the convention for auto-generated views (same as `_index.md`).
+ */
+export declare function relativeActivityPath(slug: string): string;
+/**
+ * Render the full §9.6 file body. `lastBuilt` populates the frontmatter
+ * `last_built:` field (ISO-8601). `windowDays` is constant in v3 (= 90).
+ */
+export declare function renderActivityView(snapshot: ActivitySnapshot, lastBuilt: string): string;
+/**
+ * Sort entity-activity rows in render order: date descending, then
+ * `timeRange` ascending so within a day the earliest event renders
+ * first. `null` time ranges sort after any string time so they appear
+ * at the end of their day's bucket.
+ */
+export declare function sortEntityActivityRows(rows: readonly EntityActivityInput[]): EntityActivityInput[];
+/**
+ * Sort recently-changed rows: date descending, then mt_id ascending so
+ * a single day's entries are grouped consistently.
+ */
+export declare function sortRecentlyChangedRows(rows: readonly RecentlyChangedInput[]): RecentlyChangedInput[];
+/**
+ * Compute the windowed cutoff (`now - windowDays`) as ISO-`YYYY-MM-DD`.
+ * Used by the runner's SQL queries. Pure so tests can pin the cutoff
+ * deterministically.
+ */
+export declare function windowCutoffDate(now: Date, windowDays: number): string;
+//# sourceMappingURL=activity-view-reconciler.d.ts.map

package/dist/core/context/activity-view-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-view-reconciler.d.ts","sourceRoot":"","sources":["../../../src/core/context/activity-view-reconciler.ts"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAI5C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,CAwCR;AAuGD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GACnC,mBAAmB,EAAE,CAkBvB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,oBAAoB,EAAE,GACpC,oBAAoB,EAAE,CAOxB;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/core/context/activity-view-reconciler.js

@@ -0,0 +1,252 @@
+import { normalizeAppLabel } from "@aitne/shared";
+/**
+ * Activity-view reconciler — pure render + snapshot helpers for
+ * `<contextDir>/_activity/<source>.md`
+ * (docs/design/21-management-registry-and-entities.md §7.2 / §9.6).
+ *
+ * Inputs:
+ *   - L1 — active managed-task rows (one source = one rendered file).
+ *   - L2 — entity rows joined via `entity_source_keys` to the source.
+ *   - L4 — `agent_actions` history (`management_task.*`) for the
+ *     "Recently changed" section.
+ *
+ * Output is a chronological per-source view; the LLM's query path
+ * (§7.5) reads `_activity/<source>.md` for the date, then follows the
+ * link into the entity file. The activity file is short on details
+ * (entity title + per-entity source metadata + a managed-task tag) so
+ * the prompt-injection budget stays modest even with hundreds of
+ * entries (§NFR-5: ≤2 s rebuild for a 90-day window).
+ *
+ * Determinism contract: same snapshot + same `last_built` → byte-
+ * identical render. The driver layer compares the rendered output to
+ * the on-disk file and skips the write on noop.
+ */
+const EM_DASH = "—";
+/**
+ * Window for the "Recently changed" + per-day sections. The §7.6 spec
+ * fixes this at 90 days; bump only with a schema_version bump because
+ * the rendered frontmatter `window_days` is what consumers (the query
+ * skill) read.
+ */
+export const ACTIVITY_VIEW_WINDOW_DAYS = 90;
+// ── Source helpers ────────────────────────────────────────────────────────
+/**
+ * Map a user-typed source label to the activity-file slug. Two visually-
+ * different inputs that map to the same normalised form share one
+ * activity file (the same dedup behaviour as `managed_tasks.app_normalized`).
+ *
+ * The slug is sanitised so it makes a valid filename: spaces collapse
+ * to `-`, characters outside `[a-z0-9-]` are stripped. An empty result
+ * after sanitising returns `null` so the runner can skip the file.
+ */
+export function activityFileSlugFor(source) {
+    const normalised = normalizeAppLabel(source);
+    const slug = normalised
+        .replace(/\s+/g, "-")
+        .replace(/[^a-z0-9-]/g, "")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return slug.length > 0 ? slug : null;
+}
+/**
+ * Relative path under `<contextDir>` for the activity file. Matches
+ * the §9.6 layout `_activity/<source>.md`. The leading underscore is
+ * the convention for auto-generated views (same as `_index.md`).
+ */
+export function relativeActivityPath(slug) {
+    return `_activity/${slug}.md`;
+}
+// ── Render ────────────────────────────────────────────────────────────────
+/**
+ * Render the full §9.6 file body. `lastBuilt` populates the frontmatter
+ * `last_built:` field (ISO-8601). `windowDays` is constant in v3 (= 90).
+ */
+export function renderActivityView(snapshot, lastBuilt) {
+    const lines = [];
+    lines.push("---");
+    lines.push("type: activity-log");
+    lines.push(`source: ${snapshot.sourceNormalized}`);
+    lines.push("auto_generated: true");
+    lines.push(`window_days: ${ACTIVITY_VIEW_WINDOW_DAYS}`);
+    lines.push(`last_built: ${lastBuilt}`);
+    lines.push("---");
+    lines.push(`# ${capitalize(snapshot.source)} — Activity (last ${ACTIVITY_VIEW_WINDOW_DAYS} days)`);
+    lines.push("");
+    lines.push("## Active managed tasks");
+    lines.push("");
+    if (snapshot.activeTasks.length === 0) {
+        lines.push("_No active managed tasks for this source._");
+    }
+    else {
+        for (const task of snapshot.activeTasks) {
+            lines.push(`- ${formatActiveTask(task)}`);
+        }
+    }
+    lines.push("");
+    lines.push(`## Recently changed (${ACTIVITY_VIEW_WINDOW_DAYS}d)`);
+    lines.push("");
+    if (snapshot.recentlyChanged.length === 0) {
+        lines.push("_No recent changes._");
+    }
+    else {
+        for (const row of snapshot.recentlyChanged) {
+            lines.push(`- ${formatRecentlyChanged(row)}`);
+        }
+    }
+    lines.push("");
+    if (snapshot.entities.length === 0) {
+        lines.push("## Entries");
+        lines.push("");
+        lines.push("_No entries yet — the next scheduled run will populate this section._");
+    }
+    else {
+        appendEntityDays(lines, snapshot.entities);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function appendEntityDays(lines, entities) {
+    // Group by date; entities are pre-sorted by date desc so we can rely
+    // on the input ordering inside each day.
+    const days = new Map();
+    const order = [];
+    for (const entity of entities) {
+        if (!days.has(entity.date)) {
+            days.set(entity.date, []);
+            order.push(entity.date);
+        }
+        const bucket = days.get(entity.date);
+        /* c8 ignore start — `days.has(entity.date)` is true at this point
+           (we just set it above), so the lookup never returns undefined.
+           Defensive guard for the type narrowing only. */
+        if (!bucket)
+            continue;
+        /* c8 ignore stop */
+        bucket.push(entity);
+    }
+    for (const date of order) {
+        lines.push(`## ${date}`);
+        lines.push("");
+        const bucket = days.get(date);
+        /* c8 ignore start — `order` is built from `days.set` keys above; the
+           lookup is guaranteed to succeed. Defensive only. */
+        if (!bucket)
+            continue;
+        /* c8 ignore stop */
+        for (const entity of bucket) {
+            lines.push(`- ${formatEntity(entity)}`);
+        }
+        lines.push("");
+    }
+}
+function formatActiveTask(task) {
+    const last = task.lastRunAt
+        ? `last ${task.lastRunAt} ${task.lastResult ?? "ok"}`
+        : "never run";
+    return `${task.mtId} ${task.cadence} — ${last}`;
+}
+const ACTION_VERBS = {
+    "management_task.created": "registered",
+    "management_task.modified": "modified",
+    "management_task.deleted": "stopped by user",
+    "management_task.app_renamed": "app renamed",
+    "management_task.run_now": "run on demand",
+};
+function formatRecentlyChanged(row) {
+    const verb = ACTION_VERBS[row.actionType] ?? row.actionType;
+    const id = row.mtId ?? EM_DASH;
+    const note = row.note ? ` (${row.note})` : "";
+    return `${row.date} ${id} ${verb}${note}`;
+}
+function formatEntity(entity) {
+    const head = entity.timeRange ? `${entity.timeRange} ` : "";
+    // The activity file lives at `_activity/<slug>.md`; entity files
+    // live at `<domain>/<type-plural>/<slug>.md`. From the activity
+    // file's perspective an entity at `work/meetings/foo.md` is at
+    // `../work/meetings/foo.md`.
+    const link = `../${entity.entityRelativePath}`;
+    const title = `[${escapeMd(entity.title)}](${link})`;
+    const tail = formatEntityTail(entity);
+    return `${head}${title}${tail}`;
+}
+function formatEntityTail(entity) {
+    const parts = [];
+    if (entity.details.length > 0) {
+        parts.push(entity.details.map(escapeMd).join(" · "));
+    }
+    if (entity.mtId) {
+        const stamp = entity.fetchedAt ? ` @ ${entity.fetchedAt}` : "";
+        parts.push(`fetched by ${entity.mtId}${stamp}`);
+    }
+    if (parts.length === 0)
+        return "";
+    return `\n  ${parts.join(" · ")}`;
+}
+function escapeMd(value) {
+    // Caller paths only ever pass non-empty strings. The trim()/replace
+    // pair preserves single-line content; multi-whitespace inputs are
+    // exercised by the renderer tests via the entity-detail formatting.
+    return value.replace(/\s+/g, " ").trim();
+}
+function capitalize(value) {
+    // Caller paths always pass a non-empty source label because
+    // `activityFileSlugFor` returns null for empty input and the runner
+    // skips the render in that case.
+    /* c8 ignore next */
+    if (value.length === 0)
+        return value;
+    return value.slice(0, 1).toUpperCase() + value.slice(1);
+}
+// ── Snapshot bucketing (helper for the runner) ────────────────────────────
+/**
+ * Sort entity-activity rows in render order: date descending, then
+ * `timeRange` ascending so within a day the earliest event renders
+ * first. `null` time ranges sort after any string time so they appear
+ * at the end of their day's bucket.
+ */
+export function sortEntityActivityRows(rows) {
+    return [...rows].sort((a, b) => {
+        if (a.date !== b.date)
+            return b.date.localeCompare(a.date);
+        // Null `timeRange` always sorts after any string time. Using a
+        // sentinel character is brittle: "10:00–11:00" embeds the en-dash
+        // (U+2013, codepoint 8211), which compares ABOVE both `~` (U+007E)
+        // and `￿` under `localeCompare` for some Unicode collations.
+        // An explicit null check is cheaper and free of locale surprises.
+        if (a.timeRange === null && b.timeRange === null) {
+            return a.title.localeCompare(b.title);
+        }
+        if (a.timeRange === null)
+            return 1;
+        if (b.timeRange === null)
+            return -1;
+        if (a.timeRange !== b.timeRange) {
+            return a.timeRange.localeCompare(b.timeRange);
+        }
+        return a.title.localeCompare(b.title);
+    });
+}
+/**
+ * Sort recently-changed rows: date descending, then mt_id ascending so
+ * a single day's entries are grouped consistently.
+ */
+export function sortRecentlyChangedRows(rows) {
+    return [...rows].sort((a, b) => {
+        if (a.date !== b.date)
+            return b.date.localeCompare(a.date);
+        const aId = a.mtId === null ? "" : a.mtId;
+        const bId = b.mtId === null ? "" : b.mtId;
+        return aId.localeCompare(bId);
+    });
+}
+// ── Entry-point helper for the runner ────────────────────────────────────
+/**
+ * Compute the windowed cutoff (`now - windowDays`) as ISO-`YYYY-MM-DD`.
+ * Used by the runner's SQL queries. Pure so tests can pin the cutoff
+ * deterministically.
+ */
+export function windowCutoffDate(now, windowDays) {
+    const cutoff = new Date(now.getTime() - windowDays * 86400_000);
+    return cutoff.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=activity-view-reconciler.js.map

package/dist/core/context/activity-view-reconciler.js.map

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

package/dist/core/context/activity-view-runner.d.ts

@@ -0,0 +1,38 @@
+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 activity-view reconciler's last run record. */
+export declare const ACTIVITY_VIEW_RECONCILER_LAST_RUN_KEY = "reconciler.activity_view.last_run";
+export interface RunActivityViewReconcilerOptions {
+    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 activity-view reconciler:
+ *
+ *   1. Early-exit when degraded mode is active.
+ *   2. Enumerate the active source set:
+ *        ∪ `managed_tasks.app_normalized`
+ *        ∪ `entity_source_keys.source_key` (within window)
+ *        ∪ `agent_actions.detail->>app_normalized` (within window).
+ *   3. For each source, build the §9.6 snapshot and render the file.
+ *   4. Compare to on-disk content; skip on no-op.
+ *   5. Atomic write + write-tracker mark + snapshot prior contents.
+ *   6. Garbage-collect activity files for sources that no longer
+ *      appear in the active set (the §9.6 file would otherwise stay
+ *      stale forever after a stop+rename cycle).
+ *
+ * Slot mapping in `ReconcilerRunRecord`:
+ *   - `added`           → number of files written
+ *   - `removed`         → number of stale files deleted
+ *   - `refreshedMtime`  → number of files that already matched on disk
+ */
+export declare function runActivityViewReconciler(opts: RunActivityViewReconcilerOptions): Promise<ReconcilerRunRecord>;
+//# sourceMappingURL=activity-view-runner.d.ts.map

package/dist/core/context/activity-view-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-view-runner.d.ts","sourceRoot":"","sources":["../../../src/core/context/activity-view-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAO5E,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAiBhC,4EAA4E;AAC5E,eAAO,MAAM,qCAAqC,sCACb,CAAC;AAMtC,MAAM,WAAW,gCAAgC;IAC/C,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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAY9B"}