@aitne/daemon 0.1.6 → 0.1.8

package/dist/core/morning/journal-skeleton-builder.js.map

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

package/dist/core/morning/orchestrator.d.ts

@@ -0,0 +1,312 @@
+/**
+ * `MorningRoutinePipelineOrchestrator` — Phase 5 of
+ * `docs/design/appendices/morning-routine-optimization.md`. Replaces the
+ * single monolithic medium-tier session that today's
+ * `MorningRoutineRunner.executeMorningRoutine` runs with a daemon-
+ * orchestrated pipeline:
+ *
+ *     ① rotateDayFiles                          (owned by MorningRoutineRunner)
+ *     ② HandoffParser                           (this module)
+ *     ③ JournalSkeletonBuilder                  (this module)
+ *     ④ Pre-pass fan-out                        (owned by MorningRoutineRunner)
+ *     ⑤A Stage A: today.md synthesis  [medium]  (this module)  ─┐ Promise.all
+ *     ⑤B Stage B: daily journal author [lite]   (this module)  ─┘
+ *     ⑥  AgentJournalAppender                   (Phase 6 — left to MorningRoutineRunner)
+ *     ⑥b parent audit row emit                  (this module)
+ *     ⑦  diagnoseTodayMdState                   (owned by MorningRoutineRunner)
+ *     ⑧  Post-morning catchups + roadmap_refresh (owned by MorningRoutineRunner)
+ *
+ * The orchestrator owns only ②③⑤A∥⑤B⑥b. ① and ④ are upstream of `run()`;
+ * ⑥, ⑦, ⑧ stay with the runner so the existing today.md health check /
+ * retry chain / catchups continue to work unchanged on both legacy and
+ * V2 paths.
+ *
+ * Stage event design:
+ *   - Stage A event.type = `routine.morning_routine_today` so its
+ *     `agent_actions` row lands with `action_type='routine.morning_routine_today'`
+ *     (the audit logger derives action_type from `event.type`). Stage A's
+ *     `routine` field stays `"morning_routine"` so ContextBuilder's
+ *     existing heavy-context branch fires (yesterday.md / roadmap.md /
+ *     active_projects / calendar_events_7d).
+ *   - Stage B event.type = `routine.morning_routine_journal`. Stage B's
+ *     `routine` field is `"morning_routine_journal"` so ContextBuilder
+ *     fires the minimal Stage-B branch added in Phase 5 (calendar_events_7d
+ *     for wikilink resolution; no yesterday / roadmap / projects).
+ *   - Both stage events share `correlationId` with the parent
+ *     `routine.morning_routine` envelope — `loadMorningRoutineActionRows`
+ *     and `emitMorningRoutineParentAuditRow` use that as `event_id` to
+ *     correlate.
+ *
+ * Today.md write-lock: Stage A inherits the lockId set on the parent
+ * event by `MorningRoutineRunner` (the lock is acquired before this
+ * runs and released after); Stage B does not write to today.md and
+ * does not receive the lockId.
+ *
+ * Retry semantics (rev2 — `morning-routine-optimization.md`
+ * §"Pipeline-level invariants"):
+ *   - The retry chain is gated on today.md health; only Stage A regen
+ *     is what fixes a missing / wrong-date today.md. On retry,
+ *     `inputs.isRetry` is true and Stage B is NOT re-fired. Phase 5
+ *     simplification: if Stage B succeeded on attempt 1, its
+ *     `daily/<yesterday>.md` is already on disk and re-firing would
+ *     hit the 200/PATCH-Agent-revision path, producing a second
+ *     journal entry on every retry; if Stage B failed on attempt 1,
+ *     re-firing would still risk that duplication once the next
+ *     scheduled write succeeds. The trade-off is documented in design
+ *     §"Retry semantics" — Phase 6 may revisit if structured Stage B
+ *     result tracking justifies the work.
+ *
+ * Pre-pass skip on retry: not enforced here because `MorningRoutineRunner`
+ * already short-circuits the pre-pass when `isRetry === true`. The
+ * pre-pass result lives on the parent event's `event.data.fetchReportBlock`
+ * and is forwarded into the Stage A event unchanged (Stage B does not
+ * consume it).
+ */
+import type Database from "better-sqlite3";
+import { type AgentResult, type BackendId, type Event, type ProcessKey } from "@aitne/shared";
+import type { AgentConfig } from "../../config.js";
+import type { IAuditLogger, IContextBuilder } from "../dispatcher-types.js";
+import type { PromptAssembler } from "../dispatcher-prompt.js";
+import type { IAgentRouter } from "../backends/backend-router.js";
+import type { DispatcherErrorRouter } from "../dispatcher-error-handling.js";
+import type { ResultProcessor } from "../dispatcher-result-processor.js";
+import type { AgentWriteTracker } from "../../safety/agent-write-tracker.js";
+import { type ParentAuditEmitResult, type TodayMdHealth } from "./parent-audit-emitter.js";
+import { type AgentJournalAppenderResult } from "./agent-journal-appender.js";
+declare const STAGE_A_PROCESS_KEY: ProcessKey;
+declare const STAGE_B_PROCESS_KEY: ProcessKey;
+/**
+ * The `routine` slug carried on each stage's RoutineEvent. Stage A reuses
+ * the legacy `"morning_routine"` value so the heavy ContextBuilder branch
+ * (yesterday.md / roadmap.md / active_projects / calendar_events_7d)
+ * continues to fire unchanged — the Phase 5 split is about dispatch
+ * shape, not Stage A's context inputs. Stage B's
+ * `"morning_routine_journal"` slug routes into the minimal branch added
+ * to ContextBuilder for Phase 5.
+ */
+declare const STAGE_A_ROUTINE_SLUG = "morning_routine";
+declare const STAGE_B_ROUTINE_SLUG = "morning_routine_journal";
+export interface MorningPipelineOrchestratorDeps {
+    db: Database.Database;
+    config: AgentConfig;
+    contextBuilder: IContextBuilder;
+    agentRouter: IAgentRouter;
+    prompt: PromptAssembler;
+    errorRouter: DispatcherErrorRouter;
+    resultProcessor: ResultProcessor;
+    /**
+     * morning-routine-optimization.md Phase 6 — pre-insert an
+     * `agent_actions(result='in_progress', action_type='routine.morning_routine_today')`
+     * row before Stage A spawns so the agent's
+     * `PATCH /api/agent-actions/self` can resolve and write its structured
+     * metadata side-channel. Optional so Phase 5 tests that don't exercise
+     * the metadata pathway can construct the orchestrator without an
+     * `IAuditLogger` mock. Production wiring always supplies it.
+     */
+    audit?: IAuditLogger;
+    /**
+     * morning-routine-optimization.md Phase 6 — ⑥ AgentJournalAppender
+     * needs the safety write-tracker so the journal's atomic write does
+     * not get tagged as a user-actor change by the obsidian / git
+     * observers (which would re-trigger the hourly check on the agent's
+     * own output). The context-index reconciler is intentionally NOT
+     * threaded here: `agent/journal.md` is not in the indexable set, so
+     * the chokidar fallback path covers it without an explicit hint.
+     */
+    writeTracker?: AgentWriteTracker;
+}
+export interface MorningPipelineRunInputs {
+    /**
+     * The parent `routine.morning_routine` event. Its `correlationId` is
+     * the link parent-audit-emitter uses to find both stages' agent_actions
+     * rows; `data.fetchReportBlock` (pre-pass output) and
+     * `data.todayWriteLockId` (today.md lock from the runner) are
+     * forwarded to Stage A verbatim.
+     */
+    parentEvent: Event;
+    /**
+     * Mirrors `MorningRoutineRunner`'s `isRetry` derivation. When true,
+     * Stage B is skipped (see §"Retry semantics" in the module JSDoc).
+     */
+    isRetry: boolean;
+    /**
+     * When set, both stages' `resolveBinding` calls receive this as
+     * `requestedTier`. `MorningRoutineRunner` forces `"medium"` on retry;
+     * the orchestrator forwards verbatim so Stage A's cost-cap-fix
+     * downgrade behaviour is preserved. Stage B ignores the override —
+     * it always runs on lite per `routine.morning_routine_journal`'s
+     * process-key default. (Forcing Stage B to medium on retry would
+     * defeat the whole point of the split, and the journal author has
+     * no failure mode that medium would fix.)
+     */
+    requestedTier?: "lite" | "medium" | "high";
+}
+export interface MorningPipelineRunResult {
+    /**
+     * Stage A's `AgentResult`. `MorningRoutineRunner.processResult` is
+     * invoked on this so today.md health checks / drift / cost telemetry
+     * follow the same path as the legacy monolithic session.
+     */
+    stageAResult: AgentResult;
+    /**
+     * Stage B's `AgentResult`, or `null` when Stage B was skipped (retry
+     * path) or its session threw before producing a result. Stage B
+     * failure does not block the pipeline — the journal author is
+     * independent of today.md health, so its absence surfaces only in
+     * the parent audit row's `detail.stageB` field.
+     */
+    stageBResult: AgentResult | null;
+    /**
+     * Snapshot of `Date.now()` taken when `run()` is first invoked. Used
+     * by `MorningRoutineRunner` as the parent audit row's `started_at`
+     * when it later calls `emitParentAuditRow`.
+     */
+    startedAt: Date;
+}
+export declare class MorningRoutinePipelineOrchestrator {
+    private readonly deps;
+    constructor(deps: MorningPipelineOrchestratorDeps);
+    /**
+     * Drive ②③⑤A∥⑤B. The caller (`MorningRoutineRunner`) is responsible
+     * for invoking ⑦ (today.md health diagnose) and ⑥b (parent audit
+     * emit, via `emitParentAuditRow`) afterwards.
+     *
+     * Errors:
+     *   - Stage A throw → re-thrown so the runner's outer try/finally
+     *     (lock release + flag reset) still fires, and the runner's
+     *     `diagnoseTodayMdState` post-check catches the missing today.md
+     *     and schedules a retry the same way legacy failures do.
+     *   - Stage B throw → logged + folded into `stageBResult=null`. Does
+     *     NOT propagate; Stage B failure is independent of today.md
+     *     health (the day still opens, the journal is best-effort).
+     */
+    run(inputs: MorningPipelineRunInputs): Promise<MorningPipelineRunResult>;
+    /**
+     * Write per-stage `agent_actions` rows via `processResult`. Each stage
+     * is processed against its OWN `RoutineEvent` (carrying the stage's
+     * process-key event type), so the row's `action_type` lands as
+     * `routine.morning_routine_today` / `routine.morning_routine_journal`
+     * — exactly what `parent-audit-emitter.readStageSummaries` and the
+     * Phase 6 `agent-journal-appender` will read.
+     *
+     * Failures inside `processResult` (e.g. a notify hook misbehaving) do
+     * NOT propagate — losing audit rows is bad, but blocking the entire
+     * morning routine on a downstream telemetry hiccup is worse. In
+     * practice `audit.logAction` already swallows its own DB errors with
+     * an internal logger.error, so the catch here is a defence-in-depth
+     * guard against non-audit hooks (notify side effects we don't expect
+     * for routine events but might land later).
+     *
+     * Tail-risk acknowledgement: if a stage row truly fails to land
+     * (audit's internal try/catch swallowed a real SQLite error AND
+     * `processResult`'s notification path threw too), the parent-audit
+     * emitter will return `stage_a_row_missing` and the pre-routine gate
+     * stays unfired for the day — that day's hourly_check / evening_review
+     * are skipped with `morning_routine_pending_for_today`, but
+     * `MAX_RETRIES`-bounded `scheduleMorningRetry` does NOT loop on this
+     * shape because today.md health is independent. The day's automation
+     * degrades silently for that day; it does not infinite-loop.
+     */
+    private persistStageAuditRows;
+    /**
+     * ⑥b parent audit emit — the row keyed `action_type='routine.morning_routine'`
+     * that `morningRoutineRanToday` in `schedule-helpers.ts` SELECTs on.
+     * Called by `MorningRoutineRunner` AFTER its `diagnoseTodayMdState`
+     * verdict so the today.md health gate is enforced; gated also on
+     * Stage A success (Stage B success is recorded in `detail` but does
+     * NOT block — the day still "opened" if today.md is good).
+     *
+     * Reads agent_actions rows by correlationId to get authoritative
+     * `cost_usd` / `num_turns` / `result` for each stage — handles the
+     * case where one stage's `AgentResult` is in memory and the other
+     * is null (Stage B was skipped on retry) without an
+     * impedance-mismatch shim.
+     */
+    emitParentAuditRow(args: {
+        correlationId: string;
+        startedAt: Date;
+        todayMdHealth: TodayMdHealth;
+        backend?: BackendId;
+    }): ParentAuditEmitResult;
+    /**
+     * morning-routine-optimization.md Phase 6 — ⑥ AgentJournalAppender.
+     * Assembles the one-paragraph English audit-trail entry for
+     * `agent/journal.md` from `agent_actions` rows (stage results +
+     * the metadata column Stage A wrote via `PATCH /api/agent-actions/self`)
+     * plus `daily/<yesterday>.md` frontmatter. No LLM final-text parsing.
+     *
+     * Called by `MorningRoutineRunner` AFTER both stage rows have settled
+     * (so `loadMorningRoutineActionRows` sees terminal `result` + the
+     * agent-supplied metadata) and BEFORE `emitParentAuditRow` so the
+     * journal block is on disk by the time the pre-routine gate fires.
+     *
+     * Returns the appender's structured outcome so the runner can log the
+     * skip reason (e.g. `stage_a_row_missing` when the Stage A audit row
+     * never landed) without grepping the file. Returns `null` when the
+     * orchestrator was constructed without the deps the appender needs
+     * (Phase 5-only test fixtures) — caller treats `null` as a no-op.
+     */
+    appendAgentJournalEntry(args: {
+        correlationId: string;
+    }): AgentJournalAppenderResult | null;
+    private preInsertStageAInProgressRow;
+    private buildHandoffParsedBlock;
+    private buildStageBInputs;
+    private readYesterdayCalendarEvents;
+    private composeStageAEvent;
+    /**
+     * Compose the `<roadmap_skeleton>` block injected into Stage A's
+     * prompt on the **first-run** (no-yesterday) branch. Returns `null`
+     * on the recurring branch (yesterday.md present); the recurring
+     * branch reads the live truncated `<roadmap>` ContextBuilder
+     * already injects.
+     *
+     * Why gate on `yesterday.md`: the first-run signal lines up with
+     * the variant collapse documented in §5 ("variant collapse") — the
+     * setup wizard produces a placeholder roadmap.md and rotateDayFiles
+     * has not yet emitted yesterday.md. Both gates fire from the same
+     * fs predicate so Stage A's first-run branch never sees a mismatch.
+     *
+     * Errors are swallowed: a malformed projects file or a missing
+     * travel_bookings table degrades to "Stage A sees an empty
+     * section" rather than failing the whole stage. The variant
+     * collapse depends on Stage A still landing roadmap.md in this
+     * case (it can fall back to reading `<management_rules>` and
+     * `<active_projects>` inline); shipping a broken skeleton block
+     * would be worse than no skeleton block at all.
+     */
+    private buildRoadmapSkeletonBlock;
+    /**
+     * Read forward-looking calendar events from the observations table
+     * for the next 7 days (matching the design's "Annual Goals from
+     * management rules, Quarterly Focus from active projects +
+     * calendar, Preparation Timeline from travel_bookings + calendar"
+     * window).
+     *
+     * Filtering note (pre-Phase-7-rev2 bug fix): the SQL filter does
+     * NOT use `observed_at` as a window bound. `observed_at` is the
+     * recording timestamp (CURRENT_TIMESTAMP at INSERT) — for a
+     * forward-looking window every relevant row was inserted BEFORE
+     * `now` (the just-completed pre-pass, an observer poll yesterday,
+     * etc.), so an `observed_at >= now` predicate would exclude every
+     * row. Instead we pull pending calendar observations and let JS
+     * filter on the parsed event start time extracted from
+     * `payload.raw.start`. The `consumed_at IS NULL` predicate scopes
+     * the read to rows the next Stage A turn has not yet consumed —
+     * exactly the set the pre-pass just landed for this morning's run.
+     * The `LIMIT 500` clamp guards against an unexpectedly large
+     * pending backlog blowing up Stage A's prompt budget; 500 is well
+     * above any realistic seven-day window the routine
+     * `cal_morning_7d` pre-pass would emit.
+     *
+     * Returns `[]` when no provider has pushed observations yet — the
+     * skeleton renders an explicit placeholder line.
+     */
+    private readForwardCalendarEvents;
+    private runStageA;
+    private composeStageBEvent;
+    private runStageB;
+    private readStageSummaries;
+}
+export { STAGE_A_PROCESS_KEY, STAGE_B_PROCESS_KEY, STAGE_A_ROUTINE_SLUG, STAGE_B_ROUTINE_SLUG, };
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/morning/orchestrator.d.ts.map

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