daily

/daily -- Generate or Update Today's Daily Note

Execute the complete daily note lifecycle defined canonically in PKB template tpl_daily.

1. Dynamic Template Ingestion

Fetch the canonical template from the knowledge base using MCP:

• Call pkb_get_document with id: "tpl_daily", detail: "full", and max_bytes: 50000.
• Assert truncated: false. If truncated or unavailable, halt immediately per fail-fast.

2. Step Execution Contract

A daily note run executes change-only steps defined canonically in PKB template tpl_daily since the last run's cursor timestamp. When Step 0 detects no delta, the run halts immediately with a zero-delta ledger. Where anything here and tpl_daily differ, tpl_daily governs.

Execution Invariants

• Change-Only Execution: Process only changes occurring since the last completed run cursor; exit immediately when nothing changed.
• Single-Flight Concurrency: Never start a run while another daily note run is in progress.
• Graceful Degradation: When external services (GitHub, Email, Calendar) are unreachable, attempt all available tool channels before recording quiet single-line status in-place.
• Trace Receipts Only: Record step completion receipts in internal execution traces and telemetry. Never append run execution logs, hourly heartbeats, cron timestamps, or raw reconcile mutation dumps to the daily note body.
• No Local Transcript or Hook Log Scraping: Sweeps and subagents must never read or scrape local .system_generated/logs/transcript*.jsonl or /tmp/aops_debug_hooks_*.jsonl files. Prompt and trace recoveries query Arize Phoenix via ida:session-trace.
• Subagent Routing Boundaries: Sweeps dispatch to ida:james (execution sweeps) and Step 4 dispatches to ida:pauli (PKB graph and targeted gh queries only). Pauli operates strictly via PKB tools and targeted GitHub CLI queries, never reading local repository source files or shell output files on disk.

3. Conversational Handover

When invoked via interactive or chat channels (such as Telegram), reply with the note's top layer, readable in under a minute:

1. The note's ## Start here item: what to do first, its first step and what is ready.
2. Today's fixed times and anything overdue owed to other people, from ## Today.
3. How many decisions wait in ## With you, naming the top one, with /decide offered for the rest.