@aitne/daemon 0.1.0

package/dist/api/routes/observations.js

@@ -0,0 +1,177 @@
+import { Hono } from "hono";
+import { consumeObservations, getNoveltyDistribution, getObservationStats, getPendingObservations, getSummaryStatusCounts, recordObservation, } from "../../db/observations.js";
+import { createLogger } from "../../logging.js";
+import { readJsonBody } from "../json-body.js";
+const logger = createLogger("observations-api");
+function parseBoolean(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    return value === "true" || value === "1";
+}
+function parseNumber(value, defaultValue) {
+    const num = Number(value);
+    return Number.isFinite(num) ? num : defaultValue;
+}
+function parsePayload(payload) {
+    if (!payload)
+        return null;
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        return payload;
+    }
+}
+/**
+ * cost-reduction-structural §A "Failure modes" — the summary may be
+ * outdated when the worker lags far behind the observation moment (e.g.
+ * laptop-sleep backlog reclaimed at startup, where the summarizer has
+ * caught up by the time hourly_check runs but the underlying source
+ * may have shifted in between). Surface a `summaryStale` flag the
+ * consumer skill can branch on, rather than asking the LLM to do
+ * timestamp arithmetic.
+ *
+ * Threshold: summary_at older than observed_at + STALE_HOURS hours.
+ * 6 hours mirrors the design doc's bounded-validity window.
+ */
+const SUMMARY_STALE_AFTER_HOURS = 6;
+function isSummaryStale(observedAt, summaryAt) {
+    if (!summaryAt)
+        return false;
+    const observedMs = parseSqliteTimestampMs(observedAt);
+    const summaryMs = parseSqliteTimestampMs(summaryAt);
+    if (observedMs === null || summaryMs === null)
+        return false;
+    return summaryMs > observedMs + SUMMARY_STALE_AFTER_HOURS * 3600 * 1000;
+}
+function parseSqliteTimestampMs(raw) {
+    // Accept both SQLite's CURRENT_TIMESTAMP shape ("YYYY-MM-DD HH:MM:SS",
+    // assumed UTC) and the ISO-8601 string the worker writes via
+    // `new Date().toISOString()`.
+    if (raw.includes("T")) {
+        const ms = Date.parse(raw);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    const ms = Date.parse(`${raw.replace(" ", "T")}Z`);
+    return Number.isFinite(ms) ? ms : null;
+}
+export function createObservationRoutes(deps) {
+    const app = new Hono();
+    const { db } = deps;
+    app.get("/observations", (c) => {
+        const pending = parseBoolean(c.req.query("pending"), true);
+        const limit = Math.min(Math.max(parseNumber(c.req.query("limit"), 20), 1), 100);
+        const offset = Math.max(parseNumber(c.req.query("offset"), 0), 0);
+        const source = c.req.query("source");
+        const actor = c.req.query("actor");
+        const since = c.req.query("since");
+        if (actor && !["user", "agent", "system", "unknown"].includes(actor)) {
+            return c.json({ error: "invalid_actor" }, 400);
+        }
+        const observations = getPendingObservations(db, {
+            pending,
+            limit,
+            offset,
+            sourceFilter: source,
+            actorFilter: actor,
+            since,
+        }).map((row) => ({
+            id: row.id,
+            source: row.source,
+            ref: row.ref,
+            changeType: row.change_type,
+            actor: row.actor,
+            observedAt: row.observed_at,
+            payload: parsePayload(row.payload),
+            consumedAt: row.consumed_at,
+            consumedBy: row.consumed_by,
+            // cost-reduction-structural §A — summarizer-populated fields. Null
+            // when the summarizer has not yet caught up; the consumer must
+            // fall back to legacy fetch-on-doubt in that case. `summaryStale`
+            // is the §A "Failure modes" 6h gate, computed daemon-side so the
+            // consumer skill never reasons about timestamps.
+            summaryText: row.summary_text,
+            noveltyScore: row.novelty_score,
+            summaryStatus: row.summary_status,
+            summaryAt: row.summary_at,
+            summaryBackend: row.summary_backend,
+            summaryStale: isSummaryStale(row.observed_at, row.summary_at),
+        }));
+        return c.json({ observations, limit, offset, pending });
+    });
+    /**
+     * POST /observations — record an agent-originated observation.
+     *
+     * Used by `routine.hourly_check` to queue `roadmap_candidate` signals
+     * (long-horizon intents too weak to write to roadmap.md directly;
+     * ROADMAP-REDESIGN §3.4 RFC-C). The DB layer UPSERTs on
+     * `(source, ref)` where `consumed_at IS NULL`, so re-posting the same
+     * candidate across hourly ticks coalesces instead of duplicating.
+     *
+     * Actor defaults to `agent` here — the user and system channels have
+     * their own writers (vault watchers, mail poller, etc.). Permitting
+     * only `agent` / `system` guards against prompt-injection attempts to
+     * forge user-authored observations.
+     */
+    app.post("/observations", async (c) => {
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const body = parsedBody.body;
+        if (!body ||
+            typeof body.source !== "string" ||
+            typeof body.ref !== "string" ||
+            (typeof body.changeType !== "string" &&
+                body.changeType !== undefined)) {
+            return c.json({ error: "validation_error" }, 400);
+        }
+        const changeType = typeof body.changeType === "string" ? body.changeType : "created";
+        if (!["created", "modified", "deleted"].includes(changeType)) {
+            return c.json({ error: "invalid_change_type" }, 400);
+        }
+        const actor = typeof body.actor === "string" ? body.actor : "agent";
+        if (!["agent", "system"].includes(actor)) {
+            return c.json({ error: "invalid_actor" }, 400);
+        }
+        recordObservation(db, {
+            source: body.source,
+            ref: body.ref,
+            changeType: changeType,
+            actor: actor,
+            payload: body.payload,
+        });
+        logger.info({ source: body.source, ref: body.ref, actor }, "Observation recorded via API");
+        return c.json({ ok: true });
+    });
+    app.post("/observations/consume", async (c) => {
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const body = parsedBody.body;
+        if (!body || !Array.isArray(body.ids) || typeof body.correlationId !== "string") {
+            return c.json({ error: "validation_error" }, 400);
+        }
+        const ids = body.ids.filter((id) => typeof id === "number" && Number.isInteger(id));
+        if (ids.length !== body.ids.length) {
+            return c.json({ error: "validation_error" }, 400);
+        }
+        const result = consumeObservations(db, ids, body.correlationId);
+        logger.info({ consumed: result.consumed, correlationId: body.correlationId }, "Observations consumed");
+        return c.json(result);
+    });
+    app.get("/observations/stats", (c) => {
+        const stats = getObservationStats(db);
+        // cost-reduction-structural §A telemetry — surface summarizer health
+        // alongside the legacy stats so the dashboard observability card has
+        // a single fetch path.
+        const summaryStatusCounts = getSummaryStatusCounts(db);
+        const noveltyDistribution = getNoveltyDistribution(db);
+        return c.json({
+            ...stats,
+            summaryStatusCounts,
+            noveltyDistribution,
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=observations.js.map

package/dist/api/routes/observations.js.map

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

package/dist/api/routes/obsidian.d.ts

@@ -0,0 +1,16 @@
+import { Hono } from "hono";
+import type { ObsidianService } from "../../services/obsidian.js";
+import type { AgentWriteTracker } from "../../safety/agent-write-tracker.js";
+export interface ObsidianRouteDependencies {
+    obsidianService: ObsidianService | null;
+    /**
+     * Optional shared tracker. When present, every write endpoint pre-marks
+     * the target vault file so the obsidian-watcher attributes the resulting
+     * chokidar event to `actor='agent'` (and hourly_check's `?actor=user`
+     * filter excludes it). Without this the agent can observe its own
+     * Obsidian writes and loop.
+     */
+    writeTracker?: AgentWriteTracker;
+}
+export declare function createObsidianRoutes(deps: ObsidianRouteDependencies): Hono;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/api/routes/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../../src/api/routes/obsidian.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAM7E,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AA6BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CA6T1E"}

package/dist/api/routes/obsidian.js

@@ -0,0 +1,321 @@
+import { Hono } from "hono";
+import { existsSync } from "node:fs";
+import { createLogger, toSafeErrorMessage } from "../../logging.js";
+import { readJsonBody } from "../json-body.js";
+const logger = createLogger("obsidian-api");
+/**
+ * Obsidian API routes — proxies to the Obsidian CLI via ObsidianService.
+ *
+ * These routes target the **external** Obsidian vault the user maintains
+ * alongside this app (configured via `externalObsidianVaultPath`/`Name`),
+ * NOT the agent's primary management store. Primary-store reads and
+ * writes live under `/api/context/*` and must never be routed here.
+ *
+ * GET    /obsidian/status       — external vault availability
+ * GET    /obsidian/search       — search external vault
+ * GET    /obsidian/notes/:path  — read a note from the external vault
+ * POST   /obsidian/notes        — create a note (fails if it exists)
+ * PUT    /obsidian/notes/:path  — create or overwrite a note (idempotent edit)
+ * PATCH  /obsidian/notes        — append to a note
+ * DELETE /obsidian/notes/:path  — delete a note (trash by default)
+ * PATCH  /obsidian/daily        — append to the daily note
+ */
+/** Validate note name/file path: reject traversal and unsafe characters */
+function isValidNotePath(p) {
+    if (!p || p.length > 500)
+        return false;
+    // Reject path traversal and absolute paths
+    if (/\.\./.test(p) || /^[/\\]/.test(p))
+        return false;
+    // Allow word chars, spaces, hyphens, dots, forward slashes (for subdirs), CJK
+    if (!/^[\w\s\-./\u3000-\u9FFF\uF900-\uFAFF]+$/.test(p))
+        return false;
+    return true;
+}
+export function createObsidianRoutes(deps) {
+    const app = new Hono();
+    const { obsidianService, writeTracker } = deps;
+    /**
+     * Per-route write mutex. Every Obsidian write (POST/PUT/PATCH/DELETE)
+     * runs through this lock so two concurrent requests to the same (or
+     * different) note serialize at the daemon boundary. The Obsidian CLI
+     * itself has no documented concurrency guarantees, and simultaneous
+     * `create … overwrite` calls could race with a user edit in the
+     * Obsidian UI. Serializing here also keeps `markAgentWrite` →
+     * `service.xxx` ordered so the write tracker's TTL window covers the
+     * actual file system event.
+     */
+    let writeLock = Promise.resolve();
+    function withWriteLock(fn) {
+        const prev = writeLock;
+        let release;
+        writeLock = new Promise((r) => {
+            release = r;
+        });
+        return prev.then(async () => {
+            try {
+                return await fn();
+                /* v8 ignore next */
+            }
+            finally {
+                release();
+            }
+        });
+    }
+    /**
+     * Mark a vault note as an agent-originated write so the obsidian-watcher
+     * observer attributes the resulting chokidar event to `actor='agent'`.
+     * Uses path-only marking (no content hash) because append-style writes
+     * don't let the route handler pre-compute the full post-write content.
+     */
+    function markAgentWrite(noteName) {
+        if (!writeTracker || !obsidianService)
+            return;
+        const absolute = obsidianService.resolveNotePath(noteName);
+        if (absolute)
+            writeTracker.markWriting(absolute);
+    }
+    // GET /obsidian/status — check if the external Obsidian vault is available.
+    // `vaultType: "external"` is an additive marker so consumers can tell this
+    // apart from the agent's primary management vault at a glance. `statusLabel`
+    // is a human-readable phrasing matching the Management Mode redesign plan
+    // ("external Obsidian vault: configured/not configured"). Existing clients
+    // that only read `available` / `vaultName` / `obsidianRunning` keep working
+    // unchanged.
+    app.get("/obsidian/status", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({
+                available: false,
+                vaultName: null,
+                obsidianRunning: false,
+                vaultType: "external",
+                statusLabel: "external Obsidian vault: not configured",
+            });
+        }
+        const running = await obsidianService.isRunning();
+        return c.json({
+            available: true,
+            vaultName: obsidianService.vault,
+            obsidianRunning: running,
+            vaultType: "external",
+            statusLabel: "external Obsidian vault: configured",
+        });
+    });
+    // GET /obsidian/notes/* — read a specific note's content
+    app.get("/obsidian/notes/*", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        // Extract path after /obsidian/notes/
+        const filePath = c.req.path.replace(/^.*\/obsidian\/notes\//, "");
+        if (!filePath || !isValidNotePath(filePath)) {
+            return c.json({ error: "invalid file path" }, 400);
+        }
+        try {
+            const running = await obsidianService.isRunning();
+            if (!running) {
+                return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+            }
+            const content = await obsidianService.readNote(filePath);
+            return c.json({ content, path: filePath });
+        }
+        catch (err) {
+            // Obsidian CLI doesn't distinguish "not found" from other read failures,
+            // so we collapse all errors to 404 but log for observability.
+            logger.warn({ err, path: filePath }, "Obsidian note read failed");
+            return c.json({ error: "not_found", message: toSafeErrorMessage(err) }, 404);
+        }
+    });
+    // GET /obsidian/search — search notes
+    app.get("/obsidian/search", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const q = c.req.query("q");
+        if (!q) {
+            return c.json({ error: "query parameter 'q' is required" }, 400);
+        }
+        const limit = Math.min(Number(c.req.query("limit") ?? "10"), 50);
+        try {
+            const running = await obsidianService.isRunning();
+            if (!running) {
+                return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+            }
+            const results = await obsidianService.search(q, limit);
+            return c.json({ results });
+        }
+        catch (err) {
+            logger.error({ err }, "Obsidian search failed");
+            return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+        }
+    });
+    // POST /obsidian/notes — create a new note
+    app.post("/obsidian/notes", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const { name, content } = parsedBody.body;
+        if (!name || !content) {
+            return c.json({ error: "name and content are required" }, 400);
+        }
+        if (!isValidNotePath(name)) {
+            return c.json({ error: "invalid note name" }, 400);
+        }
+        return withWriteLock(async () => {
+            try {
+                const running = await obsidianService.isRunning();
+                if (!running) {
+                    return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+                }
+                markAgentWrite(name);
+                await obsidianService.createNote(name, content);
+                return c.json({ status: "created", name });
+            }
+            catch (err) {
+                logger.error({ err }, "Obsidian create note failed");
+                return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+            }
+        });
+    });
+    // PUT /obsidian/notes/* — create or overwrite a note (idempotent edit)
+    app.put("/obsidian/notes/*", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const filePath = c.req.path.replace(/^.*\/obsidian\/notes\//, "");
+        if (!filePath || !isValidNotePath(filePath)) {
+            return c.json({ error: "invalid file path" }, 400);
+        }
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const { content } = parsedBody.body;
+        if (typeof content !== "string") {
+            return c.json({ error: "content is required" }, 400);
+        }
+        return withWriteLock(async () => {
+            try {
+                const running = await obsidianService.isRunning();
+                if (!running) {
+                    return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+                }
+                markAgentWrite(filePath);
+                await obsidianService.updateNote(filePath, content);
+                return c.json({ status: "updated", path: filePath });
+            }
+            catch (err) {
+                logger.error({ err }, "Obsidian update note failed");
+                return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+            }
+        });
+    });
+    // DELETE /obsidian/notes/* — delete a note (trash by default)
+    app.delete("/obsidian/notes/*", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const filePath = c.req.path.replace(/^.*\/obsidian\/notes\//, "");
+        if (!filePath || !isValidNotePath(filePath)) {
+            return c.json({ error: "invalid file path" }, 400);
+        }
+        // Default to trash (recoverable). Opt in to permanent deletion via
+        // ?permanent=true — irreversible, so require an explicit query flag.
+        const permanent = c.req.query("permanent") === "true";
+        return withWriteLock(async () => {
+            try {
+                const running = await obsidianService.isRunning();
+                if (!running) {
+                    return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+                }
+                // Pre-check existence on disk so we can return an idempotent 404
+                // rather than propagating an opaque CLI error as 502. The
+                // Obsidian CLI doesn't surface a distinguishable "not found"
+                // signal, so checking the resolved absolute path is the
+                // cleanest way to honor REST DELETE semantics. `resolveNotePath`
+                // returns `null` only when the vault path is unconfigured — in
+                // which case we already bailed at the `available` check above.
+                const absolute = obsidianService.resolveNotePath(filePath);
+                if (absolute && !existsSync(absolute)) {
+                    return c.json({ error: "not_found", path: filePath }, 404);
+                }
+                markAgentWrite(filePath);
+                await obsidianService.deleteNote(filePath, permanent);
+                return c.json({ status: "deleted", path: filePath, permanent });
+            }
+            catch (err) {
+                logger.error({ err }, "Obsidian delete note failed");
+                return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+            }
+        });
+    });
+    // PATCH /obsidian/notes — append to an existing note
+    app.patch("/obsidian/notes", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const { file, content } = parsedBody.body;
+        if (!file || !content) {
+            return c.json({ error: "file and content are required" }, 400);
+        }
+        if (!isValidNotePath(file)) {
+            return c.json({ error: "invalid file path" }, 400);
+        }
+        return withWriteLock(async () => {
+            try {
+                const running = await obsidianService.isRunning();
+                if (!running) {
+                    return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+                }
+                markAgentWrite(file);
+                await obsidianService.appendToNote(file, content);
+                return c.json({ status: "appended" });
+            }
+            catch (err) {
+                logger.error({ err }, "Obsidian append failed");
+                return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+            }
+        });
+    });
+    // PATCH /obsidian/daily — append to daily note
+    app.patch("/obsidian/daily", async (c) => {
+        if (!obsidianService?.available) {
+            return c.json({ error: "obsidian_not_configured" }, 503);
+        }
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const { content } = parsedBody.body;
+        if (!content) {
+            return c.json({ error: "content is required" }, 400);
+        }
+        return withWriteLock(async () => {
+            try {
+                const running = await obsidianService.isRunning();
+                if (!running) {
+                    return c.json({ error: "obsidian_not_running", message: "Obsidian app is not running" }, 503);
+                }
+                // Daily note attribution: Obsidian's daily note convention is typically
+                // `YYYY-MM-DD.md`, but the actual folder depends on per-vault settings.
+                // We mark the common-case root path as a best-effort hint; if the user
+                // customized the daily folder the observer will record actor='user'
+                // for this one append. Acceptable trade-off.
+                const today = new Date().toISOString().slice(0, 10);
+                markAgentWrite(today);
+                await obsidianService.appendToDaily(content);
+                return c.json({ status: "appended" });
+            }
+            catch (err) {
+                logger.error({ err }, "Obsidian daily append failed");
+                return c.json({ error: "obsidian_error", message: toSafeErrorMessage(err) }, 502);
+            }
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/api/routes/obsidian.js.map

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

package/dist/api/routes/profile-questions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Profile-interview queue HTTP surface.
+ *
+ * Read-only helper that wraps the canonical `isSlotFilled` rule
+ * (`packages/daemon/src/core/profile-questions/slot-filled.ts`) for
+ * agent prose to call. Centralising the rule here prevents the heuristic
+ * from drifting between TS (`skeleton.ts` Layer 1) and prose (Layers 2,
+ * 3, 5).
+ *
+ * Risk tier: Autonomous. The endpoint is read-only and operates on
+ * paths inside the context vault; no secrets or auth-sensitive data
+ * traverse this surface. See `safety/risk-classifier.ts`.
+ */
+import { Hono } from "hono";
+import type { ApiDependencies } from "../server.js";
+export declare function createProfileQuestionsRoutes(deps: ApiDependencies): Hono;
+//# sourceMappingURL=profile-questions.d.ts.map

package/dist/api/routes/profile-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-questions.d.ts","sourceRoot":"","sources":["../../../src/api/routes/profile-questions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAuExE"}