@aitne/daemon 0.1.0

package/dist/core/template-versions.d.ts

@@ -0,0 +1,95 @@
+import type Database from "better-sqlite3";
+/**
+ * Template versioning infrastructure — future-proofing for format changes.
+ *
+ * Each shipped template in `agent-assets/templates/` carries a
+ * `template_version: N` field in its YAML frontmatter. When the template
+ * format changes in a future release, bump `template_version` AND the
+ * matching entry in `_manifest.json`.
+ *
+ * User-side files copied from a template retain the version field on
+ * disk. At startup, the daemon compares each user file's version against
+ * the shipped manifest and flags paths where the manifest is newer. The
+ * result lands in `runtime_state.templates.pending` and is surfaced via
+ * `/api/health`.
+ *
+ * Phase 0 (this module) ships the detection + surfacing layer only. An
+ * "apply upgrade" path — diff review in the dashboard, merge strategy
+ * for user-edited files, audit trail — is deferred to a later phase.
+ * Treat "pending upgrade" as an observability signal, not an automatic
+ * action.
+ *
+ * Scope:
+ *  - Skip: `today.md`, `roadmap.md`, `projects/_active.base`, and any
+ *    future file without YAML frontmatter (no place to carry the version
+ *    marker).
+ *  - Skip: files whose user-side copy is missing (user deleted it).
+ *  - Skip: files whose user-side version is >= manifest version (up to
+ *    date OR user ahead; both fine).
+ *  - Report: files whose user-side version is < manifest version.
+ *  - Treat "user file has NO template_version field" as unknown — do not
+ *    report as pending (user has likely rewritten the file; we have no
+ *    evidence they want an upgrade).
+ */
+export declare const PENDING_UPGRADES_KEY = "templates.pending";
+export interface TemplateManifestEntry {
+    version: number;
+}
+export interface TemplateManifest {
+    manifestVersion: number;
+    generatedAt?: string;
+    notes?: string;
+    templates: Record<string, TemplateManifestEntry>;
+}
+export interface PendingTemplateUpgrade {
+    path: string;
+    from: number;
+    to: number;
+}
+export interface PendingTemplateUpgradesRecord {
+    checkedAt: string;
+    pending: PendingTemplateUpgrade[];
+}
+/**
+ * Read and validate `agent-assets/templates/_manifest.json`. Returns
+ * `null` if the file is missing or malformed; callers treat that as
+ * "no manifest available, skip the upgrade check" (degraded deployments
+ * that ship without assets).
+ */
+export declare function readTemplateManifest(templatesRoot: string): TemplateManifest | null;
+/**
+ * Parse the `template_version:` field from a file's YAML frontmatter.
+ * Returns `null` if the file is missing, has no frontmatter, or the
+ * field is absent / malformed. Bounded read (64 KB header) to keep the
+ * boot check fast and tolerant of unusually large files.
+ */
+export declare function readFileTemplateVersion(absPath: string): number | null;
+/**
+ * Compare the shipped manifest to the user's on-disk files and return
+ * the list of paths whose user-side version is older than the shipped
+ * version. Files without a user-side version marker are treated as
+ * unknown and NOT reported (see module doc above).
+ */
+export declare function findPendingTemplateUpgrades(manifest: TemplateManifest, contextDir: string): PendingTemplateUpgrade[];
+/**
+ * Persist the latest pending-upgrade snapshot to `runtime_state`. A
+ * previous snapshot with a longer list is overwritten — callers always
+ * pass the full current set, so stale entries disappear naturally once
+ * an upgrade is applied.
+ */
+export declare function writePendingTemplateUpgrades(db: Database.Database, pending: PendingTemplateUpgrade[]): void;
+/**
+ * Read the last persisted pending-upgrade snapshot. Returns `null` when
+ * no check has ever run or the row is malformed. Consumers (e.g. the
+ * `/api/health` handler) can treat `null` identically to "no pending"
+ * for display purposes.
+ */
+export declare function readPendingTemplateUpgrades(db: Database.Database): PendingTemplateUpgradesRecord | null;
+/**
+ * End-to-end helper: read the manifest, diff against the user's context
+ * directory, persist the pending list. Returns the pending list for
+ * callers that want to log or surface it immediately. Missing manifest
+ * yields an empty list (no action) — see `readTemplateManifest`.
+ */
+export declare function checkTemplateUpgrades(db: Database.Database, templatesRoot: string | null, contextDir: string): PendingTemplateUpgrade[];
+//# sourceMappingURL=template-versions.d.ts.map

package/dist/core/template-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-versions.d.ts","sourceRoot":"","sources":["../../src/core/template-versions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAGxD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,GACpB,gBAAgB,GAAG,IAAI,CA0BzB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBtE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,MAAM,GACjB,sBAAsB,EAAE,CAiB1B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,sBAAsB,EAAE,GAChC,IAAI,CAMN;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,6BAA6B,GAAG,IAAI,CAKtC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,UAAU,EAAE,MAAM,GACjB,sBAAsB,EAAE,CAgB1B"}

package/dist/core/template-versions.js

@@ -0,0 +1,175 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { readRuntimeState, writeRuntimeState, } from "../db/runtime-state.js";
+/**
+ * Template versioning infrastructure — future-proofing for format changes.
+ *
+ * Each shipped template in `agent-assets/templates/` carries a
+ * `template_version: N` field in its YAML frontmatter. When the template
+ * format changes in a future release, bump `template_version` AND the
+ * matching entry in `_manifest.json`.
+ *
+ * User-side files copied from a template retain the version field on
+ * disk. At startup, the daemon compares each user file's version against
+ * the shipped manifest and flags paths where the manifest is newer. The
+ * result lands in `runtime_state.templates.pending` and is surfaced via
+ * `/api/health`.
+ *
+ * Phase 0 (this module) ships the detection + surfacing layer only. An
+ * "apply upgrade" path — diff review in the dashboard, merge strategy
+ * for user-edited files, audit trail — is deferred to a later phase.
+ * Treat "pending upgrade" as an observability signal, not an automatic
+ * action.
+ *
+ * Scope:
+ *  - Skip: `today.md`, `roadmap.md`, `projects/_active.base`, and any
+ *    future file without YAML frontmatter (no place to carry the version
+ *    marker).
+ *  - Skip: files whose user-side copy is missing (user deleted it).
+ *  - Skip: files whose user-side version is >= manifest version (up to
+ *    date OR user ahead; both fine).
+ *  - Report: files whose user-side version is < manifest version.
+ *  - Treat "user file has NO template_version field" as unknown — do not
+ *    report as pending (user has likely rewritten the file; we have no
+ *    evidence they want an upgrade).
+ */
+export const PENDING_UPGRADES_KEY = "templates.pending";
+const MANIFEST_FILENAME = "_manifest.json";
+/**
+ * Read and validate `agent-assets/templates/_manifest.json`. Returns
+ * `null` if the file is missing or malformed; callers treat that as
+ * "no manifest available, skip the upgrade check" (degraded deployments
+ * that ship without assets).
+ */
+export function readTemplateManifest(templatesRoot) {
+    const manifestPath = join(templatesRoot, MANIFEST_FILENAME);
+    if (!existsSync(manifestPath))
+        return null;
+    try {
+        const raw = readFileSync(manifestPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.manifestVersion !== "number"
+            || typeof parsed.templates !== "object"
+            || parsed.templates === null) {
+            return null;
+        }
+        // Validate each entry has a numeric `version`.
+        for (const [path, entry] of Object.entries(parsed.templates)) {
+            if (typeof entry !== "object" || entry === null)
+                return null;
+            if (typeof entry.version !== "number") {
+                return null;
+            }
+            // Reject path traversal.
+            if (path.includes(".."))
+                return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse the `template_version:` field from a file's YAML frontmatter.
+ * Returns `null` if the file is missing, has no frontmatter, or the
+ * field is absent / malformed. Bounded read (64 KB header) to keep the
+ * boot check fast and tolerant of unusually large files.
+ */
+export function readFileTemplateVersion(absPath) {
+    if (!existsSync(absPath))
+        return null;
+    let head;
+    try {
+        const full = readFileSync(absPath, "utf-8");
+        head = full.length > 65_536 ? full.slice(0, 65_536) : full;
+    }
+    catch {
+        return null;
+    }
+    const lines = head.split(/\r?\n/);
+    if (lines.length === 0 || lines[0] !== "---")
+        return null;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === "---")
+            return null; // closing delimiter before match
+        const m = lines[i].match(/^template_version:\s*(\d+)\s*$/);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            /* c8 ignore next — `\d+` regex guarantees finite int; defensive only. */
+            return Number.isFinite(n) ? n : null;
+        }
+    }
+    return null;
+}
+/**
+ * Compare the shipped manifest to the user's on-disk files and return
+ * the list of paths whose user-side version is older than the shipped
+ * version. Files without a user-side version marker are treated as
+ * unknown and NOT reported (see module doc above).
+ */
+export function findPendingTemplateUpgrades(manifest, contextDir) {
+    const pending = [];
+    for (const [relPath, entry] of Object.entries(manifest.templates)) {
+        const userPath = join(contextDir, relPath);
+        const userVersion = readFileTemplateVersion(userPath);
+        if (userVersion === null)
+            continue;
+        if (userVersion < entry.version) {
+            pending.push({
+                path: relPath,
+                from: userVersion,
+                to: entry.version,
+            });
+        }
+    }
+    // Deterministic order simplifies tests and dashboard rendering.
+    pending.sort((a, b) => a.path.localeCompare(b.path));
+    return pending;
+}
+/**
+ * Persist the latest pending-upgrade snapshot to `runtime_state`. A
+ * previous snapshot with a longer list is overwritten — callers always
+ * pass the full current set, so stale entries disappear naturally once
+ * an upgrade is applied.
+ */
+export function writePendingTemplateUpgrades(db, pending) {
+    const record = {
+        checkedAt: new Date().toISOString(),
+        pending,
+    };
+    writeRuntimeState(db, PENDING_UPGRADES_KEY, record);
+}
+/**
+ * Read the last persisted pending-upgrade snapshot. Returns `null` when
+ * no check has ever run or the row is malformed. Consumers (e.g. the
+ * `/api/health` handler) can treat `null` identically to "no pending"
+ * for display purposes.
+ */
+export function readPendingTemplateUpgrades(db) {
+    return readRuntimeState(db, PENDING_UPGRADES_KEY);
+}
+/**
+ * End-to-end helper: read the manifest, diff against the user's context
+ * directory, persist the pending list. Returns the pending list for
+ * callers that want to log or surface it immediately. Missing manifest
+ * yields an empty list (no action) — see `readTemplateManifest`.
+ */
+export function checkTemplateUpgrades(db, templatesRoot, contextDir) {
+    if (templatesRoot === null) {
+        // No assets available (tarball deployment without agent-assets);
+        // we cannot compare versions. Still write an empty snapshot so
+        // `/api/health` returns a well-formed field.
+        writePendingTemplateUpgrades(db, []);
+        return [];
+    }
+    const manifest = readTemplateManifest(templatesRoot);
+    if (manifest === null) {
+        writePendingTemplateUpgrades(db, []);
+        return [];
+    }
+    const pending = findPendingTemplateUpgrades(manifest, contextDir);
+    writePendingTemplateUpgrades(db, pending);
+    return pending;
+}
+//# sourceMappingURL=template-versions.js.map

package/dist/core/template-versions.js.map

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

package/dist/core/today-agent-plan.d.ts

@@ -0,0 +1,33 @@
+export type TodayAgentPlanCategory = "work" | "study" | "personal" | "home";
+export type TodayAgentPlanTrigger = "DM" | "notify" | "check-in" | "wake";
+export interface TodayAgentPlanRow {
+    line: number;
+    raw: string;
+    checked: boolean;
+    time: string;
+    action: string;
+    category: TodayAgentPlanCategory;
+    trigger: TodayAgentPlanTrigger;
+}
+export interface TodayAgentPlanMetadata {
+    date: string;
+    ref: string;
+    fingerprint: string;
+    time: string;
+    action: string;
+    category: TodayAgentPlanCategory;
+    trigger: TodayAgentPlanTrigger;
+}
+export declare function extractTodayDate(content: string): string | null;
+export declare function extractTodayAgentPlanRows(content: string): {
+    rows: TodayAgentPlanRow[];
+    invalidRows: Array<{
+        line: number;
+        raw: string;
+    }>;
+};
+export declare function normalizeAgentPlanAction(action: string): string;
+export declare function getTodayAgentPlanFingerprint(date: string, row: Pick<TodayAgentPlanRow, "time" | "action" | "category" | "trigger">): string;
+export declare function buildTodayAgentPlanMetadata(date: string, row: Pick<TodayAgentPlanRow, "time" | "action" | "category" | "trigger">): TodayAgentPlanMetadata;
+export declare function readTodayAgentPlanMetadata(taskContext: Record<string, unknown>): TodayAgentPlanMetadata | null;
+//# sourceMappingURL=today-agent-plan.d.ts.map

package/dist/core/today-agent-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"today-agent-plan.d.ts","sourceRoot":"","sources":["../../src/core/today-agent-plan.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAC5E,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAC1D,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,CA2BA;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,GACvE,MAAM,CASR;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,GACvE,sBAAsB,CAWxB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,sBAAsB,GAAG,IAAI,CAuB/B"}

package/dist/core/today-agent-plan.js

@@ -0,0 +1,120 @@
+import { createHash } from "node:crypto";
+const TODAY_H1_DATE_RE = /^# (\d{4}-\d{2}-\d{2})(?: \([^)]+\))?$/;
+const TODAY_AGENT_PLAN_ROW_RE = /^- \[([ xX])\] ((?:[01]\d|2[0-3]):[0-5]\d) (.+?) \[(work|study|personal|home)\] \u2192\s*(DM|notify|check-in|wake)(?:\s+.*)?$/;
+export function extractTodayDate(content) {
+    const newlineIndex = content.search(/\r?\n/);
+    const firstLine = newlineIndex < 0 ? content : content.slice(0, newlineIndex);
+    return TODAY_H1_DATE_RE.exec(firstLine.trim())?.[1] ?? null;
+}
+export function extractTodayAgentPlanRows(content) {
+    const lines = content.split(/\r?\n/);
+    const section = findMarkdownSectionByName(lines, "Agent Plan");
+    if (!section)
+        return { rows: [], invalidRows: [] };
+    const rows = [];
+    const invalidRows = [];
+    for (let index = section.bodyStart; index < section.bodyEnd; index++) {
+        const raw = lines[index].trim();
+        if (!raw || raw === "- (none)" || !raw.startsWith("- "))
+            continue;
+        const match = TODAY_AGENT_PLAN_ROW_RE.exec(raw);
+        if (!match) {
+            invalidRows.push({ line: index + 1, raw });
+            continue;
+        }
+        rows.push({
+            line: index + 1,
+            raw,
+            checked: match[1].toLowerCase() === "x",
+            time: match[2],
+            action: match[3],
+            category: match[4],
+            trigger: match[5],
+        });
+    }
+    return { rows, invalidRows };
+}
+export function normalizeAgentPlanAction(action) {
+    return action.trim().replace(/\s+/g, " ").toLowerCase();
+}
+export function getTodayAgentPlanFingerprint(date, row) {
+    const canonical = [
+        date,
+        row.time,
+        normalizeAgentPlanAction(row.action),
+        row.category,
+        row.trigger,
+    ].join("|");
+    return createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+}
+export function buildTodayAgentPlanMetadata(date, row) {
+    const fingerprint = getTodayAgentPlanFingerprint(date, row);
+    return {
+        date,
+        ref: `agent-plan:${date}:${fingerprint}`,
+        fingerprint,
+        time: row.time,
+        action: row.action,
+        category: row.category,
+        trigger: row.trigger,
+    };
+}
+export function readTodayAgentPlanMetadata(taskContext) {
+    const raw = taskContext.agentPlan;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const data = raw;
+    const date = stringValue(data.date);
+    const ref = stringValue(data.ref);
+    const fingerprint = stringValue(data.fingerprint);
+    const time = stringValue(data.time);
+    const action = stringValue(data.action);
+    const category = stringValue(data.category);
+    const trigger = stringValue(data.trigger);
+    if (!date ||
+        !ref ||
+        !fingerprint ||
+        !time ||
+        !action ||
+        !isTodayAgentPlanCategory(category) ||
+        !isTodayAgentPlanTrigger(trigger)) {
+        return null;
+    }
+    return { date, ref, fingerprint, time, action, category, trigger };
+}
+function findMarkdownSectionByName(lines, sectionName) {
+    const normalized = normalizeSection(sectionName);
+    const headerIndex = lines.findIndex((line) => line.startsWith("## ") && normalizeSection(line.trim()) === normalized);
+    if (headerIndex < 0)
+        return null;
+    let bodyEnd = lines.length;
+    for (let index = headerIndex + 1; index < lines.length; index++) {
+        if (lines[index].startsWith("## ")) {
+            bodyEnd = index;
+            break;
+        }
+    }
+    return { bodyStart: headerIndex + 1, bodyEnd };
+}
+function normalizeSection(name) {
+    return name
+        .replace(/^#+\s*/, "")
+        .toLowerCase()
+        .replace(/\s+/g, "_");
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value : null;
+}
+function isTodayAgentPlanCategory(value) {
+    return (value === "work" ||
+        value === "study" ||
+        value === "personal" ||
+        value === "home");
+}
+function isTodayAgentPlanTrigger(value) {
+    return (value === "DM" ||
+        value === "notify" ||
+        value === "check-in" ||
+        value === "wake");
+}
+//# sourceMappingURL=today-agent-plan.js.map

package/dist/core/today-agent-plan.js.map

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

package/dist/core/today-direct-writer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Daemon-direct writer that appends a single bullet to today.md
+ * `## Agent Log` without going through the agent at all. Used by the
+ * three-stage hourly_check gate (cost-reduction-structural §B) on the
+ * stage0_silent / stage2_log_only paths so a "no-op" cron tick still
+ * leaves an audit trail in today.md without paying for an LLM session.
+ *
+ * Why this lives in the daemon (not /api/context/* via curl):
+ *   - These paths run *before* the agent is spawned. There is no
+ *     subprocess to issue the curl call from.
+ *   - The write must use the **'quiet'** staleness tier (see
+ *     `context-staleness.ts`) — the same tier the PATCH route already
+ *     classifies for `## Agent Log` appends. Bypassing the route is
+ *     fine because we never touch the prompt-context-changed hook here.
+ *   - The today-write-lock invariant is preserved: we acquire it before
+ *     mutating the file, so morning_routine and direct writes never
+ *     interleave.
+ *
+ * Failure mode: when today.md is missing, malformed, or lacks the
+ * `## Agent Log` heading, the writer logs a warning and returns false
+ * rather than synthesizing the structure — that is the morning routine's
+ * job. The gate caller treats false as "log not appended; consume
+ * observations regardless".
+ */
+import type { TodayWriteLockManager } from "./today-write-lock.js";
+export interface AppendAgentLogLineInput {
+    contextDir: string;
+    /**
+     * Bullet text to append, **without** the leading `- ` prefix and
+     * without a trailing newline. The writer normalizes both.
+     * Example: `"12:00 [hourly_check] Quiet — 0 obs"`.
+     */
+    message: string;
+    todayWriteLock: TodayWriteLockManager;
+    /** Wall-clock anchor — injectable for tests. */
+    now?: Date;
+    /**
+     * Local timezone string passed to `toLocaleTimeString` so the HH:MM
+     * timestamp respects the agent's configured timezone. When omitted,
+     * uses the runtime default.
+     */
+    timezone?: string;
+}
+export interface AppendAgentLogLineResult {
+    appended: boolean;
+    reason?: "lock_unavailable" | "today_missing" | "agent_log_section_missing" | "io_error";
+}
+/**
+ * Append a single bullet line to today.md `## Agent Log`. Idempotent
+ * shape — repeated calls each add a new bullet (the gate guarantees at
+ * most one call per cron tick anyway).
+ */
+export declare function appendAgentLogLine(input: AppendAgentLogLineInput): AppendAgentLogLineResult;
+/**
+ * Splice a new bullet line into the `## Agent Log` section, immediately
+ * before the next `## ` heading or end-of-file. Returns null when the
+ * section is missing — caller decides how to handle that.
+ *
+ * Exported for unit tests; the writer above is the production entry.
+ */
+export declare function appendBulletToAgentLog(content: string, bullet: string): string | null;
+//# sourceMappingURL=today-direct-writer.d.ts.map

package/dist/core/today-direct-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"today-direct-writer.d.ts","sourceRoot":"","sources":["../../src/core/today-direct-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,qBAAqB,CAAC;IACtC,gDAAgD;IAChD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EACH,kBAAkB,GAClB,eAAe,GACf,2BAA2B,GAC3B,UAAU,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,wBAAwB,CA4C1B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAmBf"}

package/dist/core/today-direct-writer.js

@@ -0,0 +1,132 @@
+/**
+ * Daemon-direct writer that appends a single bullet to today.md
+ * `## Agent Log` without going through the agent at all. Used by the
+ * three-stage hourly_check gate (cost-reduction-structural §B) on the
+ * stage0_silent / stage2_log_only paths so a "no-op" cron tick still
+ * leaves an audit trail in today.md without paying for an LLM session.
+ *
+ * Why this lives in the daemon (not /api/context/* via curl):
+ *   - These paths run *before* the agent is spawned. There is no
+ *     subprocess to issue the curl call from.
+ *   - The write must use the **'quiet'** staleness tier (see
+ *     `context-staleness.ts`) — the same tier the PATCH route already
+ *     classifies for `## Agent Log` appends. Bypassing the route is
+ *     fine because we never touch the prompt-context-changed hook here.
+ *   - The today-write-lock invariant is preserved: we acquire it before
+ *     mutating the file, so morning_routine and direct writes never
+ *     interleave.
+ *
+ * Failure mode: when today.md is missing, malformed, or lacks the
+ * `## Agent Log` heading, the writer logs a warning and returns false
+ * rather than synthesizing the structure — that is the morning routine's
+ * job. The gate caller treats false as "log not appended; consume
+ * observations regardless".
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { writeFileAtomically } from "./atomic-write.js";
+import { fullPath, CONTEXT_RELATIVE_PATHS } from "./context-paths.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("today-direct-writer");
+const AGENT_LOG_HEADER = "## Agent Log";
+/**
+ * Append a single bullet line to today.md `## Agent Log`. Idempotent
+ * shape — repeated calls each add a new bullet (the gate guarantees at
+ * most one call per cron tick anyway).
+ */
+export function appendAgentLogLine(input) {
+    const lock = input.todayWriteLock.acquire();
+    if (!lock.ok) {
+        logger.info({ holder: lock.holder }, "Skipping daemon-direct Agent Log append — today-write-lock held");
+        return { appended: false, reason: "lock_unavailable" };
+    }
+    try {
+        const path = fullPath(input.contextDir, CONTEXT_RELATIVE_PATHS.today);
+        if (!existsSync(path)) {
+            logger.warn({ path }, "Daemon-direct Agent Log append skipped — today.md missing");
+            return { appended: false, reason: "today_missing" };
+        }
+        let content;
+        try {
+            content = readFileSync(path, "utf-8");
+        }
+        catch (err) {
+            logger.error({ err, path }, "Failed to read today.md for Agent Log append");
+            return { appended: false, reason: "io_error" };
+        }
+        const updated = appendBulletToAgentLog(content, formatBullet(input));
+        if (updated === null) {
+            logger.warn({ path }, "Daemon-direct Agent Log append skipped — `## Agent Log` heading missing");
+            return { appended: false, reason: "agent_log_section_missing" };
+        }
+        try {
+            writeFileAtomically(path, updated);
+            return { appended: true };
+        }
+        catch (err) {
+            logger.error({ err, path }, "Failed to write today.md for Agent Log append");
+            return { appended: false, reason: "io_error" };
+        }
+    }
+    finally {
+        input.todayWriteLock.release(lock.lockId);
+    }
+}
+/**
+ * Splice a new bullet line into the `## Agent Log` section, immediately
+ * before the next `## ` heading or end-of-file. Returns null when the
+ * section is missing — caller decides how to handle that.
+ *
+ * Exported for unit tests; the writer above is the production entry.
+ */
+export function appendBulletToAgentLog(content, bullet) {
+    // Match "\n## Agent Log\n" or "## Agent Log\n" at file start. Use the
+    // same anchored regex shape as truncateAgentLog in context-builder.ts
+    // so the two stay aligned on what counts as "the heading".
+    const headingIdx = findAgentLogHeading(content);
+    if (headingIdx < 0)
+        return null;
+    const afterHeader = headingIdx + AGENT_LOG_HEADER.length;
+    const nextSection = content.indexOf("\n## ", afterHeader);
+    const sectionEnd = nextSection >= 0 ? nextSection : content.length;
+    const sectionBody = content.slice(afterHeader, sectionEnd);
+    // Always insert as the LAST bullet of the section. Preserve any
+    // trailing blank line that exists between the section and the next
+    // heading by inserting before it.
+    const trimmedTrailing = sectionBody.replace(/\s+$/, "");
+    const trailingWhitespace = sectionBody.slice(trimmedTrailing.length);
+    const newBody = `${trimmedTrailing}\n${bullet}\n${trailingWhitespace.replace(/^\n*/, "")}`;
+    return content.slice(0, afterHeader) + newBody + content.slice(sectionEnd);
+}
+function findAgentLogHeading(content) {
+    if (content.startsWith(`${AGENT_LOG_HEADER}\n`))
+        return 0;
+    const idx = content.indexOf(`\n${AGENT_LOG_HEADER}\n`);
+    return idx < 0 ? -1 : idx + 1;
+}
+function formatBullet(input) {
+    const sanitized = input.message.replace(/[\r\n]+/g, " ").trim();
+    if (sanitized.startsWith("- "))
+        return sanitized;
+    if (/^\d{1,2}:\d{2}\b/.test(sanitized))
+        return `- ${sanitized}`;
+    const time = formatLocalHHMM(input.now ?? new Date(), input.timezone);
+    return `- ${time} ${sanitized}`;
+}
+function formatLocalHHMM(now, timezone) {
+    try {
+        const formatter = new Intl.DateTimeFormat("en-GB", {
+            hour: "2-digit",
+            minute: "2-digit",
+            hour12: false,
+            ...(timezone ? { timeZone: timezone } : {}),
+        });
+        return formatter.format(now);
+    }
+    catch {
+        return `${pad2(now.getHours())}:${pad2(now.getMinutes())}`;
+    }
+}
+function pad2(n) {
+    return n.toString().padStart(2, "0");
+}
+//# sourceMappingURL=today-direct-writer.js.map

package/dist/core/today-direct-writer.js.map

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