Merge pull request 'Release v26.04.27 — Journal replaces Briefing; RSS retired; Scribe rebrand' (#43) from dev into main

Routing changes:
- / now redirects to /journal (Journal becomes the home view)
- /knowledge becomes a real route pointing at KnowledgeView (was a redirect to /)
- /notes redirect target updated from / to /knowledge (the Knowledge surface,
  which is where the notes-related dashboard lives)

To revert (Knowledge as home): change the redirect target on the / route
back to "/knowledge". Knowledge stays a real route either way, so the swap
is a one-line edit.

Nav: Knowledge link in AppHeader now points to /knowledge. The "active" check
simplified to route.path === "/knowledge" since / is no longer Knowledge's
home. The brand logo link stays at "/" — clicks still go "home", which is
now Journal.

Keyboard shortcuts in App.vue (Escape, g h, g t) still navigate to "/" and
correctly land on Journal via the redirect — no change needed there.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

.forgejo/workflows/ci.yml

@@ -1,13 +1,27 @@
 # CI runs first; build only proceeds if all checks pass.
 #
-# Push to dev:       typecheck + lint + test → build :dev + :<sha>
-# Tag v* (release):  typecheck + lint + test → build :latest + :<sha> + :<version>
-# Pull request:      no CI run — code is validated on dev push before any PR is opened
+# Push to dev:       typecheck + lint + test + build :dev + :<sha>
+# Tag v* (release):  typecheck + lint + test + build :latest + :<sha> + :<version>
+#
+# main pushes are NOT gated here: a merge to main only happens after
+# dev has already passed CI, and the release tag is the sole trigger
+# for a production image. Re-running CI on the merge commit just burns
+# runner time without changing the outcome.
 #
 # To cut a release:
 #   Create a release via the Forgejo UI on main with a v* tag name.
 #   The tag push triggers this workflow; build job pushes :latest + :<version>.
 #
+# PRs aren't triggered on purpose — this is a solo dev→main flow, so
+# gating on branch push is already enough.
+#
+# NOTE on the `if:` guards below: Forgejo Actions does not consistently
+# honor `on.push.branches` as a filter — merge commits landing on main
+# still trigger the workflow, producing redundant runs on the same SHA
+# that was already gated on dev. Every job therefore repeats the ref
+# check so main pushes trigger the workflow but every job skips
+# immediately (no runner time, no duplicate work).
+#
 # Required secrets (repo → Settings → Secrets → Actions):
 #   REGISTRY_USER   — your Forgejo username
 #   REGISTRY_TOKEN  — Forgejo PAT with write:packages scope
@@ -28,25 +42,38 @@ on:
       - "assets/**"
       - "fable-mcp/**"
       - ".forgejo/workflows/ci.yml"
-  # pull_request trigger intentionally omitted — all changes go through dev
-  # first, where CI already runs on push. PR runs would be redundant duplication.
+
+# Cancel older runs on the same branch when a newer push lands. Tag runs
+# get their own group implicitly (refs/tags/v1.2.3 ≠ refs/heads/dev) and
+# are never cancelled, so a release build can't kill itself mid-flight.
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') }}
+
+# Least-privilege default. Jobs that need more (build pushes to the
+# registry) upgrade explicitly.
+permissions:
+  contents: read
 
 env:
   REGISTRY: git.fabledsword.com
-  IMAGE: git.fabledsword.com/bvandeusen/fabledassistant
+  IMAGE: git.fabledsword.com/bvandeusen/fabledscribe
 
 jobs:
   typecheck:
     name: TypeScript typecheck
-    runs-on: py3.12-node22
+    # Skip on main merge-commit pushes — see workflow header comment.
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
     steps:
       - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v6
+      - name: Cache npm download cache
+        uses: actions/cache@v4
         with:
-          node-version: "22"
-          cache: "npm"
-          cache-dependency-path: frontend/package-lock.json
+          path: ~/.npm
+          key: npm-cache-${{ hashFiles('frontend/package-lock.json') }}
+          restore-keys: npm-cache-
 
       - name: Install dependencies
         run: npm ci
@@ -58,52 +85,57 @@ jobs:
 
   lint:
     name: Python lint
-    runs-on: py3.12-node22
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install ruff
-        run: pip install --break-system-packages ruff
-
+      # ruff is pre-installed in the ci-runner base image — no install
+      # step needed, lint runs in ~2s.
       - name: Lint
         run: ruff check src/
 
   test:
     name: Python tests
-    runs-on: py3.12-node22
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
     steps:
       - uses: actions/checkout@v6
 
-      # Python 3.12 is pre-installed in the runner-base image (py3.12-node22).
-      - name: Cache pip wheels
-        uses: actions/cache@v3
+      - name: Cache uv packages
+        uses: actions/cache@v4
         with:
-          path: ~/.cache/pip
-          key: pip-${{ hashFiles('pyproject.toml') }}
-          restore-keys: pip-
+          path: ~/.cache/uv
+          key: uv-${{ hashFiles('pyproject.toml') }}
+          restore-keys: uv-
 
       - name: Create virtual environment
-        run: python3.12 -m venv /opt/venv
+        run: uv venv /opt/venv
 
       - name: Install package with dev deps
         run: |
-          /opt/venv/bin/pip install --upgrade pip setuptools wheel
-          /opt/venv/bin/pip install --no-build-isolation http-ece
-          /opt/venv/bin/pip install -e ".[dev]"
+          # http-ece doesn't declare setuptools as a build dep, and uv
+          # creates bare venvs without it. Install setuptools first so
+          # --no-build-isolation can find it.
+          uv pip install --python /opt/venv/bin/python setuptools wheel
+          uv pip install --python /opt/venv/bin/python --no-build-isolation http-ece
+          uv pip install --python /opt/venv/bin/python -e ".[dev]"
 
       - name: Run tests
-        run: /opt/venv/bin/python -m pytest tests/ -v
+        run: /opt/venv/bin/python -m pytest tests/ -q
 
   build:
     name: Build & push image
     needs: [typecheck, lint, test]
     # Build on dev branch pushes and version tag pushes only.
-    # main branch pushes run CI for safety but do not build —
-    # the release tag (v*) is the sole trigger for a production image.
-    if: |
-      github.event_name == 'push' &&
-      (github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/'))
-    runs-on: py3.12-node22
+    # Mirrors the ref guard on the gate jobs above — main merge-commit
+    # pushes skip here too, so no production image is ever built from a
+    # raw main push (only from the v* tag the release creates).
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
+    permissions:
+      contents: read
+      packages: write
     steps:
       - uses: actions/checkout@v6
 
@@ -122,11 +154,14 @@ jobs:
           echo "build_version=$BUILD_VERSION" >> $GITHUB_OUTPUT
 
       - name: Free disk space
+        # Self-hosted runner housekeeping. Two-step cleanup:
+        # 1. Prune dangling containers/images globally (stops the runner
+        #    from accumulating cruft from past failed builds).
+        # 2. Trim the BuildKit layer cache to a 5GB ceiling so the pip
+        #    mount cache survives but old intermediate layers don't
+        #    accumulate indefinitely.
         run: |
-          # Remove all unused images (including old :SHA tags) and containers.
           docker system prune -af || true
-          # Keep the local BuildKit cache bounded so pip mount cache survives
-          # but stale intermediate layers don't accumulate indefinitely.
           docker builder prune --keep-storage 5g -f || true
 
       - name: Set up Docker Buildx
@@ -147,3 +182,10 @@ jobs:
           provenance: false
           tags: ${{ steps.tags.outputs.value }}
           build-args: BUILD_VERSION=${{ steps.tags.outputs.build_version }}
+          # Registry-backed layer cache. Pull from :cache to prime
+          # BuildKit, push updated layers back to :cache so the next
+          # build starts warm even if the runner's local cache was
+          # pruned. `mode=max` exports all intermediate layers, not
+          # just the final image, which is what gives the ~80% speedup.
+          cache-from: type=registry,ref=${{ env.IMAGE }}:cache
+          cache-to: type=registry,ref=${{ env.IMAGE }}:cache,mode=max,ignore-error=true

README.md

@@ -1,4 +1,4 @@
-# Fabled Assistant
+# Fabled Scribe
 
 A self-hosted second brain and project management application with integrated LLM capabilities. Write, organise, and act on your notes and tasks with the help of a local AI assistant — all running on your own hardware.
 

alembic/versions/0038_add_rss_item_full_content.py

@@ -0,0 +1,34 @@
+"""Add content_full and context_prepared caches to rss_items.
+
+Revision ID: 0038
+Revises: 0037
+Create Date: 2026-04-13
+"""
+
+from __future__ import annotations
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0038"
+down_revision = "0037"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("rss_items", sa.Column("content_full", sa.Text(), nullable=True))
+    op.add_column(
+        "rss_items",
+        sa.Column("context_prepared", sa.Text(), nullable=True),
+    )
+    op.add_column(
+        "rss_items",
+        sa.Column("content_fetched_at", sa.DateTime(timezone=True), nullable=True),
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("rss_items", "content_fetched_at")
+    op.drop_column("rss_items", "context_prepared")
+    op.drop_column("rss_items", "content_full")

alembic/versions/0039_add_rss_item_discussion_note.py

@@ -0,0 +1,38 @@
+"""Link rss_items to their discussion-summary note.
+
+Revision ID: 0039
+Revises: 0038
+Create Date: 2026-04-14
+"""
+
+from __future__ import annotations
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0039"
+down_revision = "0038"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "rss_items",
+        sa.Column("discussion_note_id", sa.BigInteger(), nullable=True),
+    )
+    op.create_foreign_key(
+        "fk_rss_items_discussion_note_id",
+        "rss_items",
+        "notes",
+        ["discussion_note_id"],
+        ["id"],
+        ondelete="SET NULL",
+    )
+
+
+def downgrade() -> None:
+    op.drop_constraint(
+        "fk_rss_items_discussion_note_id", "rss_items", type_="foreignkey"
+    )
+    op.drop_column("rss_items", "discussion_note_id")

alembic/versions/0040_rename_briefing_date_drop_briefing_data.py

@@ -0,0 +1,26 @@
+"""rename briefing_date to day_date and drop existing briefing conversations
+
+Revision ID: 0040
+Revises: 0039
+Create Date: 2026-04-25
+
+This is a hard-cut migration accompanying the Journal feature. The user
+has accepted destruction of existing briefing data per the design spec.
+"""
+from alembic import op
+
+
+revision = "0040"
+down_revision = "0039"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.execute("DELETE FROM conversations WHERE conversation_type = 'briefing'")
+    op.alter_column("conversations", "briefing_date", new_column_name="day_date")
+    op.execute("DELETE FROM settings WHERE key = 'briefing_config'")
+
+
+def downgrade() -> None:
+    op.alter_column("conversations", "day_date", new_column_name="briefing_date")

alembic/versions/0041_add_moments.py

@@ -0,0 +1,128 @@
+"""add moments + junction tables + moment embeddings
+
+Revision ID: 0041
+Revises: 0040
+Create Date: 2026-04-25
+
+People, Places, Tasks, and Notes all live in the `notes` table (distinguished
+by note_type and is_task). The four junction tables FK to notes(id) but stay
+separate so per-link-kind queries don't require a discriminator filter.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import ARRAY, JSONB
+
+
+revision = "0041"
+down_revision = "0040"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "moments",
+        sa.Column("id", sa.Integer, primary_key=True),
+        sa.Column(
+            "user_id",
+            sa.Integer,
+            sa.ForeignKey("users.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "conversation_id",
+            sa.Integer,
+            sa.ForeignKey("conversations.id", ondelete="SET NULL"),
+            nullable=True,
+        ),
+        sa.Column(
+            "source_message_id",
+            sa.Integer,
+            sa.ForeignKey("messages.id", ondelete="SET NULL"),
+            nullable=True,
+        ),
+        sa.Column("day_date", sa.Date, nullable=False),
+        sa.Column("occurred_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column(
+            "recorded_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column("content", sa.Text, nullable=False),
+        sa.Column("raw_excerpt", sa.Text, nullable=True),
+        sa.Column(
+            "tags",
+            ARRAY(sa.Text),
+            nullable=False,
+            server_default=sa.text("'{}'::text[]"),
+        ),
+        sa.Column(
+            "pinned",
+            sa.Boolean,
+            nullable=False,
+            server_default=sa.text("false"),
+        ),
+    )
+    op.create_index("ix_moments_user_day", "moments", ["user_id", "day_date"])
+    op.create_index("ix_moments_user_occurred", "moments", ["user_id", "occurred_at"])
+
+    # Four junction tables, all FK to notes(id). Separate (vs. one merged
+    # table with a discriminator) so per-kind queries don't need a filter.
+    for table_name, fk_col in [
+        ("moment_people", "person_id"),
+        ("moment_places", "place_id"),
+        ("moment_tasks", "task_id"),
+        ("moment_notes", "note_id"),
+    ]:
+        op.create_table(
+            table_name,
+            sa.Column(
+                "moment_id",
+                sa.Integer,
+                sa.ForeignKey("moments.id", ondelete="CASCADE"),
+                primary_key=True,
+            ),
+            sa.Column(
+                fk_col,
+                sa.Integer,
+                sa.ForeignKey("notes.id", ondelete="CASCADE"),
+                primary_key=True,
+            ),
+        )
+        op.create_index(f"ix_{table_name}_{fk_col}", table_name, [fk_col])
+
+    op.create_table(
+        "moment_embeddings",
+        sa.Column(
+            "moment_id",
+            sa.Integer,
+            sa.ForeignKey("moments.id", ondelete="CASCADE"),
+            primary_key=True,
+        ),
+        sa.Column("user_id", sa.Integer, nullable=False),
+        sa.Column("embedding", JSONB, nullable=False),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+    )
+    op.create_index("ix_moment_embeddings_user", "moment_embeddings", ["user_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_moment_embeddings_user", table_name="moment_embeddings")
+    op.drop_table("moment_embeddings")
+    for table_name, fk_col in [
+        ("moment_notes", "note_id"),
+        ("moment_tasks", "task_id"),
+        ("moment_places", "place_id"),
+        ("moment_people", "person_id"),
+    ]:
+        op.drop_index(f"ix_{table_name}_{fk_col}", table_name=table_name)
+        op.drop_table(table_name)
+    op.drop_index("ix_moments_user_occurred", table_name="moments")
+    op.drop_index("ix_moments_user_day", table_name="moments")
+    op.drop_table("moments")

alembic/versions/0042_drop_rss.py

@@ -0,0 +1,36 @@
+"""drop RSS infrastructure (tables + leftover briefing settings)
+
+Revision ID: 0042
+Revises: 0041
+Create Date: 2026-04-26
+
+Hard-cut removal of the RSS feature. Drops rss_feeds, rss_items,
+rss_item_reactions, rss_item_embeddings, and clears the leftover
+briefing-era settings rows that referenced RSS topic preferences.
+"""
+from alembic import op
+
+
+revision = "0042"
+down_revision = "0041"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # Drop in dependency order — children first.
+    op.execute("DROP TABLE IF EXISTS rss_item_embeddings CASCADE")
+    op.execute("DROP TABLE IF EXISTS rss_item_reactions CASCADE")
+    op.execute("DROP TABLE IF EXISTS rss_items CASCADE")
+    op.execute("DROP TABLE IF EXISTS rss_feeds CASCADE")
+    op.execute(
+        "DELETE FROM settings WHERE key IN "
+        "('rss_enabled', 'briefing_include_topics', 'briefing_exclude_topics')"
+    )
+
+
+def downgrade() -> None:
+    # No downgrade — this is a destructive cleanup. The original RSS tables
+    # would have to be recreated by replaying migrations 0026, 0028, 0035,
+    # 0038, 0039 manually (and the data would not come back).
+    raise NotImplementedError("RSS feature is permanently removed in 0042")

docker-compose.quickstart.yml

@@ -1,4 +1,4 @@
-# Fabled Assistant — Quick Start
+# Fabled Scribe — Quick Start
 #
 # No build required. Pulls the latest pre-built image from the registry.
 #
@@ -13,7 +13,7 @@
 
 services:
   app:
-    image: git.fabledsword.com/bvandeusen/fabledassistant:latest
+    image: git.fabledsword.com/bvandeusen/fabledscribe:latest
     ports:
       - "5000:5000"
     environment:

docs/2026-04-10-agentic-briefing-design.md

@@ -0,0 +1,216 @@
+# Agentic Briefing — Design Spec
+
+**Date:** 2026-04-10
+**Status:** Proposed
+**Author:** bvandeusen + Claude
+
+---
+
+## Problem
+
+The current briefing pipeline hallucinates calendar events, tasks, and news items that do not exist in the user's actual data. Observed examples from production:
+
+- A morning briefing asserting "your dentist appointment is still in progress" when no such event existed
+- An 8am check-in mentioning "a quick meeting at 10:30 AM" with no backing calendar entry
+- A midday check-in inventing "a team huddle at 2:30 PM" and "the Q2 budget draft due by Friday"
+- The model calling `search_images` in response to a clarifying question about a fabricated meeting
+
+These are not bugs in data retrieval — the data gathering code (`_gather_internal`, `_gather_external`) returns correct values. They are a structural consequence of how the briefing context is assembled.
+
+## Root cause — the "no receipt" problem
+
+The current `run_compilation` pipeline does this:
+
+1. Python code gathers data (tasks, events, weather, news) from the database
+2. Python formats the data into a structured text blob as the user-role message: `TODAY'S EVENTS: ...`, `DUE TODAY: ...`, etc.
+3. The LLM is called **once** with `[system_prompt, user_prompt]` and produces prose
+4. Only the prose reply is written to the conversation. **The underlying data is never persisted in the conversation history.**
+
+When the user later chats in the briefing conversation, the chat endpoint loads the full conversation history — which contains the model's *prose* from earlier but not the data that prose was derived from. The model's own prior output becomes the only source of "truth" available for follow-up questions. If that prose asserted a fact (real or hallucinated), the model has no way to distinguish it from ground truth when generating the next reply, and it will double down.
+
+Compounding factors:
+
+- **Empty sections are silently omitted.** If `calendar_events` is empty, the user prompt contains no `TODAY'S EVENTS:` line at all. The model has no explicit "zero events" signal — combined with an imperative system prompt ("note calendar events and tasks"), it interprets the silence as "I should mention some" and fabricates.
+- **Scheduled slot injections append synthetic turns.** `run_slot_injection` writes a fake `[Midday briefing update]` user message and the assistant reply into the persistent conversation. By evening, the chat history contains three separate briefings, each potentially with errors, all treated as equal-weight context on follow-up.
+- **The `search_images` tool is available during briefing chat**, with a negative-instruction description ("Not for factual questions"). Small and mid-sized models frequently ignore negative guidance in tool descriptions and call the tool anyway.
+
+## Solution — agentic briefing (the receipt model)
+
+Replace the one-shot synthesis with a tool-call loop. The briefing is no longer "a text blob synthesized from pre-gathered data." It is **a scheduled agent run**: the LLM is given a system prompt, a curated set of read-only data tools, and a trigger ("generate the morning briefing"). The model must call tools to see what exists. Every tool call and tool result becomes part of the conversation history, where it lives as a permanent, structured receipt.
+
+### Why this fixes the hallucination
+
+When the model calls `list_events(today) → []`, that empty array is now a persistent message in the conversation. On a follow-up question like "what meeting?", the chat endpoint loads the conversation and the model sees its own tool result from the morning showing no events. Answering "you had a meeting at 10:30" would require the model to directly contradict a tool result sitting two messages back — something LLMs are much more reliable at avoiding than contradicting their own prior prose.
+
+In short: **the model cannot fabricate what has a visible receipt proving it does not exist.**
+
+### What the model sees — before vs after
+
+**Before** — the model sees one structured blob and produces prose. The blob is discarded.
+
+```
+[system] You are a personal assistant... weave together what matters...
+[user]   Date: 2026-04-10
+         WEATHER: Home — partly cloudy, 8–16°C
+         DUE TODAY: Fix briefing hallucinations
+         OVERDUE (2 tasks): ...
+[assistant] Morning! Looks like a quiet day with two overdue items...
+```
+
+**After** — the model is given tools and iterates to ground truth.
+
+```
+[system] You are the user's personal assistant giving their morning briefing.
+         Use tools to see what's relevant. Only mention things you learned from
+         tool calls. If a tool returns nothing, say so honestly.
+[user]   Generate the morning briefing.
+[assistant] tool_call: list_tasks(filter="due_today")
+[tool]   [{"id": 81, "title": "Fix briefing hallucinations", ...}]
+[assistant] tool_call: list_tasks(filter="overdue")
+[tool]   [{"id": 42, ...}, {"id": 43, ...}]
+[assistant] tool_call: list_events(today)
+[tool]   []
+[assistant] tool_call: get_weather(location="home")
+[tool]   {"description": "partly cloudy", "temp_min": 8, "temp_max": 16}
+[assistant] tool_call: get_rss_items(max=8)
+[tool]   [...]
+[assistant] Morning! Partly cloudy today, 8 to 16 — nothing on the calendar
+         so it's a clean run at the desk. Two things to keep in mind...
+```
+
+The conversation now contains verifiable receipts: `list_events(today)` returned `[]`, and that result sits in context forever (until pruned). Follow-up questions operate against those receipts.
+
+## Architecture
+
+### Existing infrastructure (reused, not rebuilt)
+
+The codebase already has the agentic primitives — they're used for regular chat:
+
+- **`llm.py::stream_chat_with_tools`** — the streaming tool-use loop that talks to Ollama with a `tools` parameter and yields tool-call chunks
+- **`generation_task.py::_stream_with_retry`** — wraps `stream_chat_with_tools` with retry-on-500 behavior for cold-model races
+- **`tools.py`** — defines 40+ tool schemas and an execution dispatcher
+
+The briefing bypasses all of this and calls a one-shot `_llm_synthesise` helper. The refactor is mainly "route briefings through the same pipeline regular chat already uses."
+
+### New modules
+
+**`briefing_tools.py`** — a small wrapper exposing a curated read-only subset of `tools.py` for briefing runs. This is an **explicit allowlist**, not a blocklist, so newly-added tools must be opted in:
+
+| Tool | Purpose |
+|---|---|
+| `list_tasks` (with filter args) | See what's actionable today, overdue, high priority |
+| `list_events` (today / upcoming) | Know what's on the calendar |
+| `get_weather` | Current/forecast weather |
+| `get_rss_items` | Pull news themes filtered by user preferences |
+| `list_projects` | Understand project context |
+| `search_projects` | Surface active project summaries |
+| `list_notes` (recent) | Capture follow-ups from yesterday |
+
+**Explicitly omitted** from the briefing tool set:
+
+- `search_images`, `search_web`, `research_topic`, `read_article` — external search is not a briefing concern, and `search_images` is the source of the "Peter Kyle Science Secretary" image-search bug
+- All `create_*`, `update_*`, `delete_*` — briefings are read-only; a scheduled background job must not decide to mutate the user's data on its own
+- `set_rag_scope`, `calculate` — not relevant to briefing content
+
+### New briefing function
+
+**`briefing_pipeline.py::run_agentic_briefing(user_id, slot, model, conversation_id)`** replaces `run_compilation`'s body (and eventually `run_slot_injection`). Internally:
+
+1. Build a slot-specific system prompt (see below)
+2. Load the curated briefing tools from `briefing_tools.py`
+3. Seed messages with `[system, user]` where the user message is a simple trigger like `"Generate the morning briefing."`
+4. Enter a tool-call loop (max 8 iterations):
+   - Call `stream_chat_with_tools`
+   - If the model returns `tool_calls`, execute them via the existing dispatcher, append tool results, continue
+   - If the model returns a final assistant message with no pending tool calls, break
+5. Return `(final_prose, full_message_list, metadata)`
+
+The full message list is important: it's written to the conversation along with the final prose, so the tool-call receipts become part of the persistent record.
+
+### Slot-specific system prompts
+
+Compilation (full morning briefing):
+
+```
+You are the user's personal assistant giving their full morning briefing.
+Use the tools available to see what's actually relevant today — tasks due,
+overdue items, events on the calendar, weather, news themes, project state
+— and weave it into a warm, natural-sounding summary.
+
+Rules:
+- Call tools to see the data. Never assert facts you didn't learn from a tool.
+- If a tool returns nothing (no events today, no overdue tasks), say so
+  honestly. Don't fabricate items to fill space.
+- Write flowing prose. No markdown, no headers, no bullet points.
+- Aim for 6–10 sentences. Skip topics that have nothing interesting.
+- Close on one or two concrete, actionable suggestions.
+
+User profile (for tone and preferences):
+{profile_body}
+```
+
+Check-ins (midday, afternoon):
+
+```
+You are the user's personal assistant giving a brief {slot} check-in.
+Use tools to see what's changed since this morning. Focus on progress
+and what's still unaddressed.
+
+Rules:
+- Call tools to see current state. Never assert facts without tool results.
+- If nothing meaningful has changed, say so briefly — don't invent progress.
+- 3–5 sentences, natural prose, no markdown.
+```
+
+### Conversation hygiene — removing the fake user messages
+
+The current scheduler appends two fake messages on every slot injection:
+
+```python
+await post_message(conv.id, "user", f"[{slot.title()} briefing update]")
+await post_message(conv.id, "assistant", text)
+```
+
+Under the agentic model, we drop the fake `"user"` message entirely. Slot updates become plain assistant messages tagged with `metadata.briefing_slot = "midday"`. The chat endpoint's message loader is updated to filter these when building the LLM context on follow-ups, so a user chatting in the briefing conversation doesn't see three earlier briefings smashed into their history. The UI continues to show them as visible timeline entries.
+
+(This is the Option A filter from the earlier discussion — a small, surgical change compared to migrating briefings to a separate sidecar table. Sidecar storage remains a possible future step.)
+
+### Ollama setup compatibility
+
+The existing Ollama deployment uses non-parallel mode across two GPUs, with a concern about context duplication between cards. This is the correct setup for agentic briefings:
+
+- Each tool-call iteration shares the same KV cache on the same GPU, so appending tool results is cheap
+- There is no race where a second iteration could land on a different card with a different cache state
+- The trade-off is serialization: a briefing in progress will block a concurrent user chat request until it finishes, but scheduled briefings are rare enough (4× per day) that this is acceptable
+
+If GPU contention becomes a problem later, the right lever is pinning specific models to specific GPUs (e.g., background tasks on GPU 1, interactive models on GPU 0) — not enabling parallelism.
+
+## Cost & trade-offs
+
+- **Latency:** a briefing now makes 5–7 inference calls (one per tool-call decision plus the final prose) instead of 1. On a local Ollama with a 7B model, expect 15–40s per briefing vs the current 5–10s. Acceptable for a background job; if it becomes painful at the user-facing check-in slots, investigate letting the model batch independent tool calls in a single turn (Ollama supports this).
+- **Model requirements:** the default model must be reliable at tool calling. `qwen2.5:7b`, `llama3.1:8b`, `mistral-small-3:24b`, and similar handle it well. Models in the ≤3B class typically fail — they either emit no tool calls and return empty prose, or hallucinate invalid tool arguments. If a user's `default_model` is too small, agentic mode should fall back to legacy mode with a log warning.
+- **Context growth:** tool results bloat the conversation. At 8 tool calls per compilation × 4 slots per day, a daily briefing conversation can reach 20-30 KB of JSON-heavy history. Fine for a day; aged briefings should be archived/rolled up after 7 days.
+- **Tool subset drift:** someone adds a new mutating tool to `tools.py` and forgets to update the briefing allowlist. Mitigated by the allowlist model — the default for new tools is "not exposed to briefings."
+- **Infinite loop safety:** a buggy model could tool-call forever. Hard cap at 8 iterations, log a warning if hit, return whatever prose was last produced (or a fallback message).
+
+## Migration path
+
+Ship incrementally, each step independently reversible:
+
+**PR 1 — Agentic compilation behind a feature flag.** Add `briefing_tools.py`, add `run_agentic_briefing`, add a per-user setting `briefing_mode: "legacy" | "agentic"` (default legacy). Route only the 4am compilation through the new path when the flag is set. Keep slot-injection on the legacy path. Enable the flag on the author's account first, validate output quality over several days, then flip the default for all users. No DB migration required — the setting lives in the existing `settings` table.
+
+**PR 2 — Agentic slot injections + conversation hygiene.** Migrate midday/afternoon check-ins to the same pipeline. Remove the fake `[Midday briefing update]` user-role message; slot updates become plain assistant messages tagged with `metadata.briefing_slot`. Add a chat-message-loader filter that excludes slot-tagged messages from the LLM context on follow-ups (they remain visible in the UI).
+
+**PR 3 — UI polish.** Collapsed tool-call status row in the briefing card ("✓ checked calendar · ✓ looked at tasks · ✓ pulled weather"), expanding to show tool results on click. Tool-result cards (weather, news, task list) rendered inline where useful.
+
+**PR 4 (optional) — Sidecar storage for briefing snapshots.** If the chat-filter approach in PR 2 feels too hacky, migrate briefings out of the conversations table and into a dedicated `briefing_snapshots` table. Frontend renders them as pinned timeline cards separate from chat. Larger refactor; defer until PR 1–3 prove the approach works.
+
+## Secondary win — tightening the main chat system prompt
+
+The regular chat is already agentic (it uses `stream_chat_with_tools`), but its system prompt does not explicitly require the model to ground factual claims in tool results. The prompt discipline introduced for briefings — *"Never assert facts you didn't learn from a tool. If a tool returns nothing, say so honestly."* — is worth applying to the main chat system prompt in a follow-up PR. The mechanism already works; only the framing needs tightening.
+
+## Out of scope
+
+- The Android Flutter client's failure to render `search_images` tool-result cards. This is a separate rendering gap in the mobile app and does not affect the server-side fix. Tracked separately.
+- Re-evaluating the Ollama parallelism setting. The current non-parallel config is correct for this work.
+- Replacing the background model for title/summary/observation extraction. That model's role is unrelated to briefings.

docs/architecture.md

@@ -212,8 +212,8 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi
 | `services/api_keys.py` | `generate_key()`, `create_api_key()`, `list_api_keys()`, `revoke_api_key()`, `lookup_key()` (SHA-256 hash lookup) |
 | `services/llm.py` | `build_context()`, RAG injection, history summarisation, `stream_chat_with_tools()`, URL fetching, SSRF guard |
 | `services/generation_task.py` | `run_generation()` — full chat pipeline: intent routing, tool loop, SSE fan-out, push notification; `run_assist_generation()` |
-| `services/intent.py` | `classify_intent()` — fast non-streaming LLM call; intent skip heuristic; `_PRIOR_WORK_REFS` fast-path |
-| `services/tools.py` | All LLM tool definitions + `execute_tool(user_id, tool_name, arguments, conv_id=None, workspace_project_id=None)` dispatcher; duplicate guards; `_resolve_project()` 4-step lookup; `search_projects` and `set_rag_scope` tools |
+| ~~`services/intent.py`~~ | Removed — intent routing eliminated; the main model handles all tool routing directly |
+| `services/tools/` | LLM tool package — decorator-based registry (`_registry.py`), shared helpers (`_helpers.py`), and one module per domain: `notes.py` (create/update/delete/search/list/read), `tasks.py` (list/log_work), `entities.py` (save_person/save_place/lists), `projects.py`, `calendar.py`, `web.py`, `rag.py`, `profile.py`, `rss.py`, `weather.py`, `utility.py` (calculate). `execute_tool()` and `get_tools_for_user()` are the public API. |
 | `services/projects.py` | Project CRUD + `generate_project_summary()` (Ollama, fire-and-forget) + `backfill_project_summaries()` (startup) |
 | `services/embeddings.py` | `upsert_note_embedding()`, `semantic_search_notes(orphan_only=False)` (pgvector cosine similarity) |
 | `services/generation_buffer.py` | In-memory SSE event buffer; `cancel_event`; 60s cleanup; supports both chat (int keys) and assist (string keys) |
@@ -231,7 +231,7 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi
 | `services/briefing_scheduler.py` | APScheduler `BackgroundScheduler`; slots with catch-up logic; async-safe via `asyncio.create_task` |
 | `services/briefing_conversations.py` | Briefing conversation persistence and history queries |
 | `services/briefing_profile.py` | Per-user profile note that the assistant updates over time |
-| `services/research.py` | SearXNG research pipeline: 5 sub-queries → parallel fetch → synthesis; `search_images` for image category |
+| `services/research.py` | SearXNG research pipeline: sub-queries → parallel fetch → outline → section synthesis → executive summary → index note with linked section notes |
 | `services/events.py` | Internal events CRUD: `list_events`, `create_event`, `update_event`, `delete_event`, `get_event`; source of truth for all event LLM tools |
 | `routes/events.py` | `/api/events` — event CRUD routes |
 | `services/caldav.py` | Optional CalDAV sync — user-configured external server; syncs to/from internal store via `caldav_uid` FK; `is_caldav_configured()` guards tool activation |
@@ -291,7 +291,7 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi
 | `services/access.py` | Permission resolution for all shared resources |
 | `services/llm.py` | `build_context()`, RAG injection, history summarisation |
 | `services/generation_task.py` | SSE streaming, tool-call loop, GenerationBuffer management |
-| `services/tools.py` | All LLM tool implementations (`create_note`, `search_notes`, `get_weather`, …) |
+| `services/tools/` | LLM tool implementations (38 tools across 11 modules); decorator-based registry |
 | `services/embeddings.py` | `upsert_note_embedding()`, `semantic_search_notes()` |
 | `services/briefing_pipeline.py` | Two-lane parallel gather → LLM synthesis → briefing output |
 | `services/briefing_scheduler.py` | APScheduler integration, catch-up logic for missed slots |
@@ -311,26 +311,22 @@ See [sso-oauth.md](sso-oauth.md) for provider-specific setup instructions.
 
 ## LLM Pipeline Internals
 
-### Intent Routing
+### Tool Routing
 
-Before the main model runs, a lightweight intent classifier (`services/intent.py`) runs concurrently with `build_context()`. It makes a fast non-streaming call using a smaller dedicated model (`OLLAMA_INTENT_MODEL`, default `qwen2.5:7b`) to determine if the message requires a tool call.
-
-**Skip heuristic** — Intent classification is skipped entirely for short messages (≤10 words) with no action/object keywords, saving 400–800ms on conversational replies.
-
-**Prior-work fast-path** — `_PRIOR_WORK_REFS` regex detects phrases like "research you did", "note you made", "using your research" and returns no-tool immediately, preventing `search_web` from firing when the user references existing notes.
-
-If a tool is detected, the intent's one-sentence `ack` field is streamed as the first chunk (TTFT), the tool executes, then the main model generates a follow-up with the tool result. For chat-only responses the main model streams directly.
+No separate intent router — the main model handles all tool routing directly via Ollama's structured tool-calling output. The model receives the full tool schema list and decides whether to call a tool or respond conversationally. Extended reasoning (`think=True`) is always on for qwen3-class models: content-based gating was tried but exposed tool-call template fragility on short tool-intent prompts.
 
 ### Tool Loop
 
-Multi-round tool loop (max 5 rounds). All implementations in `services/tools.py`; `execute_tool(user_id, tool_name, arguments, conv_id=None, workspace_project_id=None)` is the dispatcher. `conv_id` and `workspace_project_id` are threaded in from `run_generation()` so tools like `set_rag_scope` can write to the current conversation.
+Multi-round tool loop (max 5 rounds). All implementations in `services/tools/` (decorator-based registry); `execute_tool(user_id, tool_name, arguments, conv_id=None, workspace_project_id=None)` is the dispatcher. `conv_id` and `workspace_project_id` are threaded in from `run_generation()` so tools like `set_rag_scope` can write to the current conversation.
 
-**Duplicate protection on `create_note` / `create_task`:**
+**Unified `create_note` tool** — creates both notes and tasks. Setting `status` (e.g. `"todo"`) creates a task; omitting it creates a knowledge note. All task fields (due_date, priority, milestone, parent_task, recurrence_rule) are available on the single tool.
+
+**Duplicate protection on `create_note`:**
 1. Exact title match (case-insensitive) → hard block, redirect to `update_note`
 2. Fuzzy title match (SequenceMatcher ≥ 82%; punctuation stripped before candidate search) → hard block
-3. Semantic content similarity (threshold 0.90, body ≥ 200 chars) → soft block with `requires_confirmation: true`
+3. Semantic content similarity (threshold 0.90, body ≥ 80 chars) → soft block with `requires_confirmation: true`
 
-**Project resolution** (`_resolve_project`): 4-step lookup — (1) exact DB match, (2) `query in title` substring, (3) `title in query` reverse substring, (4) SequenceMatcher ≥ 0.55.
+**Project resolution** (`_helpers.resolve_project`): 4-step lookup — (1) exact DB match, (2) `query in title` substring, (3) `title in query` reverse substring, (4) SequenceMatcher ≥ 0.55.
 
 ### Context Window and Summarisation
 
@@ -344,8 +340,11 @@ History summarisation threshold: 30 messages. Keeps 8 recent messages. Summary m
 1. Intent model generates 5 focused sub-queries
 2. All 5 SearXNG queries run in parallel (200ms stagger to avoid rate limiter)
 3. Up to 15 unique URLs fetched in parallel
-4. Up to 12 sources passed to synthesis LLM
-5. Result saved as a note with `tags=["research"]`
+4. LLM generates an outline (2–8 sections with title + focus)
+5. Each section synthesised in parallel from relevant sources
+6. Executive summary generated from all section content
+7. Index note created with executive summary + links to section notes; section notes linked back via `parent_id`
+8. Falls back to single-note synthesis if outline generation fails
 
 SearXNG tip: add the app server IP to `botdetection.ip_lists.pass_ip` in SearXNG `settings.yml` to bypass the rate limiter for trusted backend requests.
 

docs/design-system.md

@@ -0,0 +1,534 @@
+# FabledSword Design System
+
+A house-style design system for the FabledSword family of self-hosted applications. FabledSword is the umbrella identity; individual apps share a common visual language but each carries its own signature accent color.
+
+## Brand model
+
+FabledSword is a **house style**, not a single brand. Apps share:
+
+- Typography
+- Surfaces and dark-mode foundation
+- Component shapes (pills, cards, buttons)
+- Spacing system
+- Semantic colors (success, warning, error, info)
+- Action button colors (moss primary, bronze secondary)
+- Voice and tone
+
+Each public app has its own **signature accent** used for: the wordmark, the app icon, active nav state, "you are here" indicators, cursor/selection color, and key brand moments. Accents do **not** appear on action buttons — those stay system-wide.
+
+## Aesthetic direction
+
+Modern mythic with heraldic restraint. Tech-forward execution, but the visual language borrows from manuscripts, heraldry, and forged objects rather than from gaming or fantasy iconography. Dark-mode-first because that's where these apps live.
+
+The reference points: a well-printed book, a well-kept armory, a steward's ledger. Not: a fantasy novel cover, a tabletop RPG character sheet, a Renaissance Faire poster.
+
+---
+
+## Color system
+
+### Universal surfaces (dark mode foundation)
+
+| Token | Hex | Usage |
+|---|---|---|
+| Obsidian | `#14171A` | Page background, deepest surface |
+| Iron | `#1E2228` | Card surfaces, raised elements |
+| Slate | `#2C313A` | Hovered surfaces, secondary elevation |
+| Pewter | `#3F4651` | Borders, dividers, ghost button outlines |
+
+### Universal text and parchment
+
+| Token | Hex | Usage |
+|---|---|---|
+| Parchment | `#E8E4D8` | Primary text on dark surfaces |
+| Vellum | `#C2BFB4` | Secondary text, captions |
+| Ash | `#9C9A92` | Tertiary text, hints, metadata |
+
+Parchment is intentionally not pure white — it's slightly warm to feel like aged paper. Pure white (#FFFFFF) is never used as text color.
+
+### Universal action colors
+
+| Token | Hex | Usage |
+|---|---|---|
+| Moss | `#4A5D3F` | Primary action buttons (Save, Submit, Confirm) |
+| Bronze | `#8B7355` | Secondary action buttons (Cancel-but-not-destructive, alternate paths) |
+| Pewter | `#3F4651` | Tertiary/ghost buttons |
+
+**Critical rule:** Action button colors are universal across all apps. A Save button in Scribe and a Save button in Minstrel look identical. Per-app accents do not appear on buttons.
+
+### Semantic colors
+
+| Token | Hex | Usage |
+|---|---|---|
+| Success | `#4A5D3F` | Success states (same as Moss — they're aligned by design) |
+| Warning | `#8B6F1E` | Warnings, caution states |
+| Error | `#C04A1F` | Error messages, validation failures |
+| Info | `#3D5A6E` | Informational callouts |
+| Destructive | `#6B2118` | Destructive action buttons (Delete, Remove, irreversible) |
+
+**Why error and destructive are different:** Error is the orange-red used in alerts and validation messages. Destructive (oxblood) is reserved for buttons that perform irreversible actions — it carries more weight precisely because it's used sparingly. Pair destructive buttons with an icon (trash, X) so color is reinforcement, not the only signal.
+
+### Per-app signature accents
+
+| App | Hex | Mood |
+|---|---|---|
+| Fabled Scribe | `#5B4A8A` | Dusty violet — ink, manuscripts |
+| Minstrel | `#4A6B5C` | Forest teal — music, performance |
+| Fabled Forge | `#8B5A2B` | Forge bronze — creation, craft |
+| Roundtable | `#4A5D7E` | Slate blue — stewardship, infrastructure |
+| FabledSword (umbrella) | `#6B2118` | Oxblood — house identity, ceremonial use only |
+
+**Accent usage rules:**
+- The accent appears on the app's wordmark and icon.
+- The accent indicates active/current state in nav (the selected page, the active tab).
+- The accent is the cursor color and text-selection color in long-form surfaces (Scribe notes, Forge story drafts).
+- The accent does NOT appear on primary or secondary action buttons.
+- The accent does NOT appear in body text or chrome.
+- One accent per app. Don't mix accents within a single app.
+
+### Color contrast
+
+All text-on-surface combinations meet WCAG AA at minimum. Parchment on Obsidian is the maximum-contrast pairing; Vellum on Iron is the lowest-contrast pairing still considered acceptable for body text. Ash is for hints only — never load-bearing information.
+
+---
+
+## Typography
+
+### Type families
+
+| Family | Role | Source |
+|---|---|---|
+| Fraunces | Display, headings, wordmarks | Google Fonts |
+| Inter | Body, UI, labels | Google Fonts |
+| JetBrains Mono | Code, terminal output, monospaced data | Google Fonts |
+
+### Why this pairing
+
+Fraunces is a contemporary serif with personality — it has the warmth and authority of a book serif without feeling like costume. It signals "this is considered" without signaling "this is a fantasy product." Inter is the workhorse — neutral, ubiquitous, designed for screens, doesn't compete with the serif. JetBrains Mono is the natural choice for any developer-adjacent product and supports ligatures.
+
+### Type scale
+
+| Token | Size | Weight | Family | Usage |
+|---|---|---|---|---|
+| Display | 40px | 500 | Fraunces | App wordmark, hero text |
+| H1 | 32px | 500 | Fraunces | Page titles |
+| H2 | 24px | 500 | Fraunces | Section headings |
+| H3 | 18px | 500 | Inter | Subsection headings, card titles |
+| Body | 15px | 400 | Inter | Paragraphs, default text |
+| Body small | 13px | 400 | Inter | Captions, metadata |
+| Label | 12px | 500 | Inter | Buttons, form labels, badges |
+| Code | 13px | 400 | JetBrains Mono | Inline code, code blocks |
+| Tiny | 11px | 500 | Inter | Micro-labels (`UPPERCASE LETTERSPACED`) |
+
+### Typography rules
+
+- **Sentence case everywhere.** Never Title Case for headings, never ALL CAPS except for the Tiny micro-label style.
+- **Two weights only:** 400 regular and 500 medium. Never 600 or 700 — they read heavy in dark mode.
+- **Fraunces only at 18px and above.** Below that it loses too much detail and feels fragile. For h3 and below, use Inter.
+- **Line height** 1.5 for body, 1.3 for headings, 1.7 for long-form reading surfaces (Scribe notes, Forge drafts).
+- **Letter-spacing** at default for everything except the Tiny micro-label, which gets `0.08em` letter-spacing and uppercase styling.
+
+---
+
+## Spacing and layout
+
+### Spacing scale (px)
+
+`4, 8, 12, 16, 20, 24, 32, 48, 64, 96`
+
+Use rem units for vertical rhythm in long-form content (paragraph spacing). Use px for component-internal spacing (padding, gaps).
+
+### Border radius
+
+| Token | Size | Usage |
+|---|---|---|
+| Small | 4px | Pills, tags, code spans |
+| Medium | 8px | Buttons, inputs, small cards |
+| Large | 12px | Cards, panels, modals |
+| Extra large | 16px | Hero containers, major surfaces |
+
+### Borders
+
+- Default border: `0.5px solid Pewter` (#3F4651)
+- Hovered/emphasized border: `0.5px solid Vellum` at 30% opacity
+- Featured/active border: `2px solid [accent]` (only for emphasizing a selected card or active tab)
+
+The 0.5px default is deliberate — it reads as a hairline at most pixel densities and avoids the heavy "boxed-in" feeling that 1px+ borders create on dark backgrounds.
+
+---
+
+## Components
+
+### Buttons
+
+| Variant | Background | Text | Border |
+|---|---|---|---|
+| Primary | Moss `#4A5D3F` | Parchment | None |
+| Secondary | Bronze `#8B7355` | Parchment | None |
+| Ghost | Transparent | Parchment | 0.5px Pewter |
+| Destructive | Oxblood `#6B2118` | Parchment | None — pair with icon |
+
+Padding: `8px 16px` for default, `6px 12px` for compact, `10px 20px` for prominent. Border-radius: 8px. Font: Inter 12px/500 with default letter-spacing.
+
+### Pills and tags
+
+Used for tags, hashtags, code spans, status badges. Background is the accent color at ~15% opacity, text is the accent at full strength. Border-radius 4px, padding `2px 8px`, Inter 11px/500.
+
+In Scribe specifically, hashtags and tags use the dusty violet accent. In Minstrel, they'd use forest teal. The pattern is shared; the color follows the app.
+
+### Cards
+
+- Background: Iron (#1E2228)
+- Border: 0.5px Pewter
+- Border-radius: 12px
+- Padding: 20px
+
+For featured/selected cards, swap to a 2px solid accent border. Don't change the background.
+
+### Inputs
+
+- Background: Obsidian (#14171A) — darker than the page surface to feel "inset"
+- Border: 0.5px Pewter
+- Border-radius: 8px
+- Padding: 8px 12px
+- Focus state: 2px solid accent ring (using `box-shadow: 0 0 0 2px [accent]` to avoid layout shift)
+
+### Code blocks
+
+- Background: Obsidian (#14171A)
+- Border: 0.5px Pewter
+- Border-radius: 8px
+- Padding: 12px 16px
+- Font: JetBrains Mono 13px/400
+- Inline code: same family, with 4px-radius pill background using the app accent at 15% opacity
+
+---
+
+## The FabledSword lockup
+
+A small, persistent FS mark appears in the navigation chrome of every app — the way an Apple logo persists across macOS apps. This is the only place oxblood appears in normal app usage.
+
+**Specification:**
+- 16-20px height in nav contexts
+- Oxblood (#6B2118) on dark surfaces
+- Positioned in the bottom-left of nav rails or top-left when there's no rail
+- Hover/click reveals a small menu: link to other apps in the family, link to FabledSword.com, version info
+
+The lockup itself is a small heraldic mark — a stylized FS monogram — *not* a literal sword icon. We're avoiding sword imagery in app chrome because it would clash with the restrained, modern-mythic aesthetic. The wordmark "FabledSword" appears only on the umbrella site and in About/Settings dialogs.
+
+---
+
+## Voice and tone
+
+The FabledSword voice is **understated mythic** — it borrows the register of stewardship, craft, and considered making, but never tips into roleplay or affectation.
+
+### Do
+
+- Use plain language for everything functional. ("Save", "Cancel", "Add note")
+- Reserve flavored language for moments where the user is *waiting* or *failing* — loading states, empty states, error pages, 404s.
+- Borrow vocabulary from craft and stewardship: "draft", "ledger", "kept", "set aside", "to come", "in progress", "abandoned".
+- Be brief. The mythic register is undermined by verbosity.
+
+### Don't
+
+- Don't use thee/thou/thy or pseudo-archaic spelling.
+- Don't address the user as "traveler", "wanderer", "adventurer", or any RPG-adjacent epithet.
+- Don't use sword/blade/forge metaphors in error messages. ("Your save was forged successfully" — no.)
+- Don't make the user feel like they're playing a game when they're just trying to use software.
+
+### Examples
+
+| Context | Plain | FabledSword voice |
+|---|---|---|
+| Empty list | "No items yet" | "Nothing kept here yet." |
+| 404 | "Page not found" | "This page is not in the ledger." |
+| Loading | "Loading..." | "Fetching..." (just keep it plain — the mythic note is reserved for moments with more space) |
+| Save success | "Saved!" | "Saved." (plain — success doesn't need flavor) |
+| Save error | "Error saving" | "Couldn't save. The change has been kept locally — try again in a moment." |
+| Delete confirm | "Delete this?" | "Remove this from the ledger? This can't be undone." |
+
+The pattern: action-adjacent language stays plain; absence/failure/waiting gets the flavor.
+
+---
+
+## Iconography
+
+### Style
+
+- Stroke-based, 1.5px stroke weight at 24px, 1px at 16px
+- Rounded line caps and joins
+- 24px or 16px grid
+- Outline style by default; filled style only for active/selected states
+
+Use **Lucide** (https://lucide.dev) as the base icon set — it matches this style exactly and is open-source. Only commission custom icons for app-specific concepts that Lucide doesn't cover.
+
+### Don't
+
+- No filled icons in default UI (reserve for active states)
+- No icon styles that mix stroke and fill chaotically
+- No literal medieval imagery (swords, scrolls with curls, banners) in functional UI
+- No emoji as icons
+
+---
+
+## Per-app application
+
+### Fabled Scribe (#5B4A8A — dusty violet)
+
+A second-brain notes and task management tool. The accent appears in: the wordmark, hashtags and tag pills, the active nav item, text selection color, and the cursor in the editor. Notes are presented on Iron-surfaced cards with generous reading line-height. The hashtag system uses Scribe's accent for visual continuity.
+
+### Minstrel (#4A6B5C — forest teal)
+
+Self-hosted music. The accent appears on: now-playing indicators, active track highlights, the wordmark, equalizer/visualization elements. Album art dominates visually, so the accent should appear in chrome and metadata, never overlapping cover imagery.
+
+### Fabled Forge (#8B5A2B — forge bronze)
+
+Story-building and worldbuilding tool. The accent appears on: the wordmark, character/location/object markers in story trees, the editor cursor, "kept/canon" indicators distinguishing finalized story elements from drafts. This app benefits from Fraunces being used more aggressively — for entity titles, chapter headings, etc.
+
+### Roundtable (#4A5D7E — slate blue)
+
+Home server management. The accent appears on: the wordmark, healthy/online status indicators, the active dashboard panel border. Status colors here are critical — green for healthy, amber for warning, red (the orange-red error tone, not oxblood) for failed. The accent itself indicates "this is the panel I'm currently looking at."
+
+**Naming note:** "Roundtable" leans the wrong direction — its connotation is *equal participants in discussion* rather than *one steward managing a domain*. Consider "Steward" or "Castellan" if you revisit naming. Castellan in particular is good — it specifically means "the officer in charge of a castle."
+
+---
+
+## Implementation notes
+
+### CSS custom properties
+
+```css
+:root {
+  /* Surfaces */
+  --fs-obsidian: #14171A;
+  --fs-iron: #1E2228;
+  --fs-slate: #2C313A;
+  --fs-pewter: #3F4651;
+
+  /* Text */
+  --fs-parchment: #E8E4D8;
+  --fs-vellum: #C2BFB4;
+  --fs-ash: #9C9A92;
+
+  /* Action */
+  --fs-moss: #4A5D3F;
+  --fs-bronze: #8B7355;
+
+  /* Semantic */
+  --fs-warning: #8B6F1E;
+  --fs-error: #C04A1F;
+  --fs-info: #3D5A6E;
+  --fs-oxblood: #6B2118;
+
+  /* Typography */
+  --fs-font-display: 'Fraunces', Georgia, serif;
+  --fs-font-body: 'Inter', system-ui, sans-serif;
+  --fs-font-mono: 'JetBrains Mono', ui-monospace, monospace;
+
+  /* Layout */
+  --fs-radius-sm: 4px;
+  --fs-radius-md: 8px;
+  --fs-radius-lg: 12px;
+  --fs-radius-xl: 16px;
+}
+
+/* Per-app accent — set ONE of these on the root for each app */
+[data-app="scribe"]    { --fs-accent: #5B4A8A; }
+[data-app="minstrel"]  { --fs-accent: #4A6B5C; }
+[data-app="forge"]     { --fs-accent: #8B5A2B; }
+[data-app="roundtable"]{ --fs-accent: #4A5D7E; }
+```
+
+### Tailwind integration
+
+If using Tailwind, extend the theme with these tokens rather than relying on default colors. The default Tailwind palette will fight this system — you'll get drift back toward bright defaults if you don't lock down the palette explicitly.
+
+---
+
+## What this kit deliberately does NOT include
+
+- **Logo files.** The lockup design is described conceptually but the actual mark needs to be drawn. Hire a designer or use Claude Design to iterate on a heraldic FS monogram.
+- **Marketing site design.** This kit is for application UI. The umbrella marketing site (FabledSword.com) can use this system but will need additional patterns (hero layouts, feature grids, etc.).
+- **Email templates.** Different constraints, different problem.
+- **Print collateral.** Not in scope.
+- **Mobile native app patterns.** This is web-first. iOS/Android conventions would override several choices here (button shapes, navigation patterns).
+
+---
+
+*Last updated: April 25, 2026. Iterate as the family of apps grows.*
+
+---
+
+# Scribe-specific decisions in progress
+
+> This section tracks decisions made while adapting the FabledSword baseline above for Scribe specifically. Items here are *in progress* — once they feel solid, they get folded into the main body of the document (either as Scribe-specific extensions in the per-app section, or as updates to the universal rules where Scribe's needs reveal a gap in the baseline).
+
+*Iteration started: 2026-04-26.*
+
+## Decisions made so far
+
+### Accent footprint — Hybrid rule (not Strict)
+
+The doc baseline says the per-app accent only appears on wordmark, active nav, cursor, and text selection — never on action buttons. Scribe currently uses indigo on essentially every interactive surface (CTAs, scrollbars, glows, borders, focus rings). Hard-cutting to the doc baseline would lose too much identity in one swing.
+
+**Hybrid rule:** the accent reserves a slightly larger footprint than the doc baseline, but still much smaller than today.
+
+- **Accent (dusty violet) lives on:** wordmark; active nav; cursor and text selection in editor surfaces; tags/pills/wikilinks; in-progress task badge; focus rings; **brand-moment CTAs** — chat Send, "Create note" empty-state CTA, journal Send, "Start journaling" empty-state.
+- **Moss (sage-green primary) lives on:** Save / Submit / Confirm in forms and modals; generic affirmative actions where the button just means "do this thing" with no brand pretense.
+- **Bronze (secondary):** Cancel-but-not-destructive, alternative paths.
+- **Oxblood (destructive):** Delete / Remove (paired with an icon).
+- **Pewter ghost:** tertiary actions, "later", "skip", "see also".
+
+**Rule of thumb:** if the user is engaging with a *Scribe-feature moment* (sending a chat, opening a fresh note, jumping into the journal), accent. If they're just *operating the software* (saving an edit, confirming a dialog), Moss.
+
+### Light mode — warm parchment, matched aesthetic
+
+The doc is dark-only. Scribe today supports both light and dark, and we keep both. The light mode is derived to *match* the dark mode aesthetic rather than defaulting to system white-and-ink.
+
+- Page background: in the `#F5F1E8` warm cream family (specific values TBD)
+- Cards: near-white but slightly tinted
+- Text: deep ink `#14171A` (mirroring Obsidian)
+- Accent: same dusty violet `#5B4A8A` (works on both themes)
+
+The metaphor stays consistent across themes: ink on aged paper (light) ↔ parchment text on graphite (dark). Light mode is *not* the system standard look.
+
+**Known downside:** warm parchment backgrounds can fight with embedded color content. Mitigation: code blocks get a slight cool wash in light mode specifically, to keep syntax highlighting readable.
+
+### Status and priority palette — extend the doc's semantic set
+
+The doc's semantic colors (Success / Warning / Error / Info / Destructive) are leaner than what Scribe needs for task management. Rather than running a parallel palette, Scribe extends the doc by mapping its status/priority tokens onto doc primitives where they fit and defining new app-level tokens for the rest.
+
+**Status (task lifecycle):**
+
+| Token | Color | Source | Logic |
+|---|---|---|---|
+| `status-todo` | Pewter `#3F4651` | doc | Neutral, "not started yet" |
+| `status-in-progress` | dusty violet `#5B4A8A` | accent | Active = brand moment per Hybrid |
+| `status-done` | Moss `#4A5D3F` | doc Success | Affirmative completion |
+| `status-cancelled` | Ash `#9C9A92` | doc | Faded, "let go" |
+| `status-paused` | Warning `#8B6F1E` | doc | Stalled, needs attention — replaces the old warm gold treatment |
+
+**Priority (loudness scale):**
+
+| Token | Color | Source | Logic |
+|---|---|---|---|
+| `priority-low` | Info `#3D5A6E` | doc | Cool, FYI — quietest end of the spectrum |
+| `priority-medium` | Warning `#8B6F1E` | doc | Golden, mid-attention |
+| `priority-high` | Error `#C04A1F` | doc | Terracotta, urgent |
+| `priority-none` | Vellum/Ash | doc | No signal |
+
+The priority row reads as a clean cool→warm gradient (slate blue → golden brown → terracotta), which matches the semantic loudness — coherence the current ad-hoc palette doesn't have.
+
+**Other functional tokens:**
+
+| Token | Color | Logic |
+|---|---|---|
+| `wikilink` | dusty violet | Editorial brand moment per Hybrid |
+| `overdue` | Error `#C04A1F` | Same as priority-high — overdue IS a priority signal |
+| `toast-success` | Moss | doc semantic |
+| `toast-error` | Error | doc semantic |
+| `toast-info` | Info | doc semantic |
+| `tag-bg` / `tag-text` | accent at 15% / accent | Per doc pill recipe |
+
+Each token gets a `*-bg` companion at low alpha (matching the existing pattern in `theme.css`).
+
+**Removed:** the warm gold accent (`--color-accent-warm: #b8860b`). Its two jobs split:
+
+- Dates and timestamps (knowledge cards, event details, chat) → use `text-secondary` instead. Dates are metadata, not a brand surface; muted is the correct register.
+- Paused project status → use the new `status-paused` (Warning `#8B6F1E`) row above. Same golden-brown family, semantically aligned.
+
+### Typography — adopt the doc's stack and scale
+
+Adopt the doc's type stack and scale verbatim, with one deferred verification (long-form line-height in practice).
+
+- **Body font: Inter.** Replaces Scribe's current system-stack body font. Doc-defined; no Scribe-specific divergence.
+- **Type scale:** as in the doc table — Display 40 / H1 32 / H2 24 / H3 18 / Body 15 / Body small 13 / Label 12 / Code 13 / Tiny 11.
+- **Two weights only:** 400 regular, 500 medium. No 600/700 (reads heavy in dark mode and against the muted palette).
+- **Family rules:** Fraunces at 18px+ only (Display, H1, H2). H3 and below = Inter. Code = JetBrains Mono.
+- **Line height:** 1.5 body, 1.3 headings, **1.7 for long-form reading surfaces** (notes, journal entries).
+- **Sentence case for everything**, except the Tiny micro-label style which gets uppercase + 0.08em letter-spacing.
+
+Mechanical rollout — value swaps in `theme.css` plus loading Inter and JetBrains Mono from Google Fonts (Fraunces is already loaded).
+
+### Light mode — concrete palette
+
+Fills in the warm-parchment direction picked earlier. Treat these as starting values; tune in practice.
+
+| Token | Hex | Role |
+|---|---|---|
+| Page bg | `#F5F1E8` | Warm cream — the "paper" |
+| Card bg | `#FBF8F0` | Near-white, slightly warm — raised surfaces |
+| Inset bg (inputs, code) | `#EFEAE0` | Slightly darker than page, "inset" feeling |
+| Text primary | `#14171A` | Deep ink — Obsidian inverted |
+| Text secondary | `#5A5852` | Warm mid-grey |
+| Text muted | `#9A9890` | Warm light grey for hints/metadata |
+| Border default | `#D9D6CE` | Warm light pewter, hairline weight |
+
+**Code-block exception:** in light mode specifically, code blocks use a slight cool wash (e.g. `#EBEDF0`) instead of the warm inset bg, so syntax highlighting reads cleanly. This is the mitigation for the "warm bg fights colored content" downside.
+
+The accent (`#5B4A8A` dusty violet), Moss, Bronze, Oxblood, and the semantic color set are **identical across themes** — only the surface and text palettes flip.
+
+### Chat-bubble codification — keep the Illuminated Transcript pattern
+
+The existing chat-bubble pattern (informally called "Illuminated Transcript") gets written into the design system as a documented chat component. Other apps in the family that add a chat surface inherit the pattern; Scribe's existing implementation continues to work with only color shifts.
+
+**User bubble (whisper):**
+- Background: transparent
+- Border: 0.5px Pewter (was: indigo-tinted)
+- Text color: secondary (Vellum dark / `#5A5852` light)
+- Right-aligned, rounded except bottom-right (subtle "from-me" tail)
+
+**Assistant bubble (lit):**
+- Background: card surface (Iron dark / `#FBF8F0` light)
+- Border: none on top/right/bottom; **2px solid accent (dusty violet) on left edge only**
+- Box-shadow: accent-tinted glow + standard depth shadow (formula: `0 4px 28px rgba(<accent>, 0.14), 0 2px 8px rgba(0,0,0,0.4)` in dark; lower alphas in light)
+- Text color: primary (Parchment dark / Obsidian-inverted light)
+- Left-aligned, rounded except bottom-left
+
+The 2px-accent left edge is the "illumination" — like an illuminated capital in a manuscript. The shadow is the lift. Together they make the assistant bubble read as the *primary* voice, while the user bubble is the *margin note*.
+
+**Inline tool-call cards (`ToolCallCard`)** rendered inside an assistant bubble do NOT get their own border (per the border philosophy — the bubble already contains them). They use a slight surface tint to differentiate.
+
+### Iconography — adopt Lucide, enforce a scale
+
+Scribe currently hand-inlines SVG paths in 16+ Vue files, with 5 different stroke weights and 8+ different sizes. The visual style is already outline + rounded caps + `currentColor` stroke (matches the doc's intent), but there's no shared source and no scale discipline.
+
+**Migration policy:**
+
+1. **Install `lucide-vue-next`** as the icon source. Replace hand-inlined SVGs with imported components. Single source of truth.
+2. **Strict size scale: 16px and 24px only.** Today's mix of 12/13/14/15/17/18/20 collapses to those two. 16 for inline-with-text and small affordances; 24 for nav and primary actions.
+3. **Stroke weight per the doc: 1.5 at 24px, 1 at 16px.** Lighter than the current default of 2 — reads more refined, matches the muted palette philosophy. Overrides Lucide's default.
+4. **Outline by default; filled only for active/selected state.** Introduces a new affordance Scribe doesn't currently use — bookmark/pin/star icons can switch outline → filled to indicate active state. Reserve filled style strictly for this.
+5. **No emoji in chrome.** Replace the 3 files' emoji usage in UI labels/buttons/badges/empty states with Lucide equivalents. Emoji remain fine in *user content* (note bodies, chat messages the user typed).
+
+Work cost: ~30-60 individual icon swaps across the 16 files. Mechanical; doesn't require redesign of any component.
+
+### Voice and tone — adopt principles, defer formal audit
+
+The doc's voice register applies to Scribe (understated mythic — plain for functional UI, flavored for empty/error/loading states). No formal sweep of every UI string yet.
+
+**Approach:** apply the voice opportunistically as components are touched in the polish pass — when redesigning a settings tab, an empty state, or an error toast, rewrite the copy at the same time using the doc's register and examples table as the guide. A standalone audit pass is deferred unless drift becomes visible.
+
+### Border philosophy — structural, not decorative
+
+The doc treats borders as *structural* (Pewter neutral hairlines that say "boundary"), not decorative (Scribe today uses indigo-tinted borders that say "branded edge"). That principle suggests removing borders in places where surface tint and spacing already communicate separation.
+
+**Borders to remove:**
+
+- List rows (NotesListView, TasksListView, conversation history) — surface contrast + spacing should separate rows; current border reads as "boxed-in"
+- Inline `ToolCallCard` inside chat bubbles — the bubble is already a container; an extra border feels like double-wrapping
+- Filter chips and search-bar pills with a background tint — background does the work
+- Empty-state callouts with dashed/bordered "nothing here yet" boxes — tinted background reads cleaner
+
+**Borders to keep (genuinely structural):**
+
+- Standalone card containers (Notes viewer, Task viewer, the new daily prep card)
+- Modal / dialog edges
+- Code blocks (separates content type, not just space)
+- Focus rings (accessibility)
+- Major section dividers within a panel
+
+Border weight is not load-bearing for Scribe — happy to use the doc's 0.5px hairline default; the *placement* discipline matters more than the weight.
+
+## Open threads (next iterations)
+
+*All initial-iteration threads resolved. Next phase is the polish pass — applying the system to existing UI, component by component. New threads will accumulate here as we discover gaps in the polish pass.*

docs/features.md

@@ -68,7 +68,7 @@ Full conversation history with SSE streaming. Features:
 
 ## Web Research
 
-The assistant can search the web (SearXNG) and fetch pages, synthesising findings into notes. A lightweight `search_web` tool answers quick questions inline without saving. Requires `SEARXNG_URL` to be configured.
+The assistant can search the web (SearXNG) and fetch pages, synthesising findings into a structured multi-note research output: an index note with an executive summary and links to focused section notes. Each section covers a distinct aspect of the topic with cited sources. Falls back to a single note when outline generation fails. A lightweight `search_web` tool answers quick questions inline without saving. Requires `SEARXNG_URL` to be configured.
 
 ## Calendar
 

docs/superpowers/plans/2026-04-17-unified-lookup-wikipedia.md

@@ -0,0 +1,782 @@
+# Unified Lookup Tool & Wikipedia Integration — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Replace `search_web` with a unified `lookup` tool (Wikipedia-first, SearXNG fallback) and add Wikipedia as a source in the research pipeline.
+
+**Architecture:** New `wikipedia.py` service with `wiki_summary` and `wiki_search`. `lookup` tool in `web.py` replaces `search_web`. Research pipeline in `research.py` gains Wikipedia sources alongside SearXNG. All `search_web` references across the codebase are updated.
+
+**Tech Stack:** Python 3.12, httpx, pytest, asyncio
+
+---
+
+### Task 1: Wikipedia Service Module
+
+**Files:**
+- Create: `src/fabledassistant/services/wikipedia.py`
+- Create: `tests/test_wikipedia.py`
+
+- [ ] **Step 1: Write failing tests for `wiki_summary`**
+
+```python
+# tests/test_wikipedia.py
+import pytest
+from unittest.mock import AsyncMock, patch, MagicMock
+import httpx
+
+
+@pytest.mark.asyncio
+async def test_wiki_summary_returns_extract():
+    from fabledassistant.services.wikipedia import wiki_summary
+
+    mock_response = MagicMock()
+    mock_response.status_code = 200
+    mock_response.json.return_value = {
+        "type": "standard",
+        "title": "Python (programming language)",
+        "extract": "Python is a high-level programming language.",
+        "content_urls": {
+            "desktop": {"page": "https://en.wikipedia.org/wiki/Python_(programming_language)"}
+        },
+    }
+    mock_response.raise_for_status = MagicMock()
+
+    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
+        mock_client = AsyncMock()
+        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+        mock_client.__aexit__ = AsyncMock(return_value=False)
+        mock_client.get = AsyncMock(return_value=mock_response)
+        mock_client_cls.return_value = mock_client
+
+        result = await wiki_summary("Python programming language")
+
+    assert result is not None
+    assert result["title"] == "Python (programming language)"
+    assert "high-level" in result["extract"]
+    assert "wikipedia.org" in result["url"]
+
+
+@pytest.mark.asyncio
+async def test_wiki_summary_returns_none_on_404():
+    from fabledassistant.services.wikipedia import wiki_summary
+
+    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
+        mock_client = AsyncMock()
+        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+        mock_client.__aexit__ = AsyncMock(return_value=False)
+        mock_client.get = AsyncMock(side_effect=httpx.HTTPStatusError(
+            "Not Found", request=MagicMock(), response=MagicMock(status_code=404)
+        ))
+        mock_client_cls.return_value = mock_client
+
+        result = await wiki_summary("xyznonexistenttopic123")
+
+    assert result is None
+
+
+@pytest.mark.asyncio
+async def test_wiki_summary_returns_none_on_disambiguation():
+    from fabledassistant.services.wikipedia import wiki_summary
+
+    mock_response = MagicMock()
+    mock_response.status_code = 200
+    mock_response.json.return_value = {
+        "type": "disambiguation",
+        "title": "Python",
+        "extract": "Python may refer to...",
+    }
+    mock_response.raise_for_status = MagicMock()
+
+    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
+        mock_client = AsyncMock()
+        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+        mock_client.__aexit__ = AsyncMock(return_value=False)
+        mock_client.get = AsyncMock(return_value=mock_response)
+        mock_client_cls.return_value = mock_client
+
+        result = await wiki_summary("Python")
+
+    assert result is None
+```
+
+- [ ] **Step 2: Run tests to verify they fail**
+
+Run: `uv run pytest tests/test_wikipedia.py -v`
+Expected: FAIL with `ModuleNotFoundError: No module named 'fabledassistant.services.wikipedia'`
+
+- [ ] **Step 3: Implement `wiki_summary`**
+
+```python
+# src/fabledassistant/services/wikipedia.py
+"""Wikipedia API: lightweight topic lookups and article search."""
+
+import logging
+from urllib.parse import quote as url_quote
+
+import httpx
+
+logger = logging.getLogger(__name__)
+
+_SUMMARY_URL = "https://en.wikipedia.org/api/rest_v1/page/summary"
+_SEARCH_URL = "https://en.wikipedia.org/w/api.php"
+_TIMEOUT = 5.0
+_USER_AGENT = "FabledAssistant/1.0 (https://fabledsword.com)"
+
+
+async def wiki_summary(query: str) -> dict | None:
+    """Look up a topic by title via the Wikipedia REST summary endpoint.
+
+    Returns {"title", "extract", "url"} on hit, None on miss.
+    """
+    encoded = url_quote(query.replace(" ", "_"), safe="")
+    try:
+        async with httpx.AsyncClient(
+            timeout=_TIMEOUT, headers={"User-Agent": _USER_AGENT}
+        ) as client:
+            resp = await client.get(f"{_SUMMARY_URL}/{encoded}", follow_redirects=True)
+            resp.raise_for_status()
+            data = resp.json()
+    except Exception:
+        logger.debug("Wikipedia summary lookup failed for %r", query, exc_info=True)
+        return None
+
+    if data.get("type") == "disambiguation":
+        return None
+
+    extract = data.get("extract", "").strip()
+    if not extract:
+        return None
+
+    url = (
+        data.get("content_urls", {}).get("desktop", {}).get("page")
+        or f"https://en.wikipedia.org/wiki/{encoded}"
+    )
+    return {"title": data.get("title", query), "extract": extract, "url": url}
+```
+
+- [ ] **Step 4: Run tests to verify they pass**
+
+Run: `uv run pytest tests/test_wikipedia.py -v`
+Expected: 3 passed
+
+- [ ] **Step 5: Write failing tests for `wiki_search`**
+
+Add to `tests/test_wikipedia.py`:
+
+```python
+@pytest.mark.asyncio
+async def test_wiki_search_returns_results():
+    from fabledassistant.services.wikipedia import wiki_search
+
+    search_response = MagicMock()
+    search_response.status_code = 200
+    search_response.json.return_value = {
+        "query": {
+            "search": [
+                {"title": "QUIC"},
+                {"title": "HTTP/3"},
+            ]
+        }
+    }
+    search_response.raise_for_status = MagicMock()
+
+    summary_response = MagicMock()
+    summary_response.status_code = 200
+    summary_response.json.return_value = {
+        "type": "standard",
+        "title": "QUIC",
+        "extract": "QUIC is a transport layer protocol.",
+        "content_urls": {"desktop": {"page": "https://en.wikipedia.org/wiki/QUIC"}},
+    }
+    summary_response.raise_for_status = MagicMock()
+
+    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
+        mock_client = AsyncMock()
+        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+        mock_client.__aexit__ = AsyncMock(return_value=False)
+        mock_client.get = AsyncMock(side_effect=[search_response, summary_response, summary_response])
+        mock_client_cls.return_value = mock_client
+
+        results = await wiki_search("QUIC protocol", limit=2)
+
+    assert len(results) >= 1
+    assert results[0]["title"] == "QUIC"
+    assert "transport" in results[0]["extract"]
+
+
+@pytest.mark.asyncio
+async def test_wiki_search_returns_empty_on_failure():
+    from fabledassistant.services.wikipedia import wiki_search
+
+    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
+        mock_client = AsyncMock()
+        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+        mock_client.__aexit__ = AsyncMock(return_value=False)
+        mock_client.get = AsyncMock(side_effect=httpx.ConnectError("connection failed"))
+        mock_client_cls.return_value = mock_client
+
+        results = await wiki_search("anything")
+
+    assert results == []
+```
+
+- [ ] **Step 6: Implement `wiki_search`**
+
+Add to `src/fabledassistant/services/wikipedia.py`:
+
+```python
+async def wiki_search(query: str, limit: int = 3) -> list[dict]:
+    """Search Wikipedia for articles matching a query.
+
+    Returns [{"title", "extract", "url"}, ...] (may be empty).
+    """
+    try:
+        async with httpx.AsyncClient(
+            timeout=_TIMEOUT, headers={"User-Agent": _USER_AGENT}
+        ) as client:
+            resp = await client.get(_SEARCH_URL, params={
+                "action": "query",
+                "list": "search",
+                "srsearch": query,
+                "srlimit": str(limit),
+                "format": "json",
+            })
+            resp.raise_for_status()
+            hits = resp.json().get("query", {}).get("search", [])
+            if not hits:
+                return []
+
+            results: list[dict] = []
+            for hit in hits:
+                title = hit.get("title", "")
+                if not title:
+                    continue
+                encoded = url_quote(title.replace(" ", "_"), safe="")
+                try:
+                    summary_resp = await client.get(
+                        f"{_SUMMARY_URL}/{encoded}", follow_redirects=True,
+                    )
+                    summary_resp.raise_for_status()
+                    data = summary_resp.json()
+                except Exception:
+                    continue
+                if data.get("type") == "disambiguation":
+                    continue
+                extract = data.get("extract", "").strip()
+                if not extract:
+                    continue
+                url = (
+                    data.get("content_urls", {}).get("desktop", {}).get("page")
+                    or f"https://en.wikipedia.org/wiki/{encoded}"
+                )
+                results.append({"title": data.get("title", title), "extract": extract, "url": url})
+            return results
+    except Exception:
+        logger.debug("Wikipedia search failed for %r", query, exc_info=True)
+        return []
+```
+
+- [ ] **Step 7: Run all wikipedia tests**
+
+Run: `uv run pytest tests/test_wikipedia.py -v`
+Expected: 5 passed
+
+- [ ] **Step 8: Commit**
+
+```bash
+git add src/fabledassistant/services/wikipedia.py tests/test_wikipedia.py
+git commit -m "feat: add wikipedia service with summary lookup and search"
+```
+
+---
+
+### Task 2: Lookup Tool (replaces search_web)
+
+**Files:**
+- Modify: `src/fabledassistant/services/tools/web.py`
+- Create: `tests/test_lookup_tool.py`
+
+- [ ] **Step 1: Write failing tests for `lookup`**
+
+```python
+# tests/test_lookup_tool.py
+import pytest
+from unittest.mock import AsyncMock, patch, MagicMock
+
+
+@pytest.mark.asyncio
+async def test_lookup_wikipedia_hit():
+    """lookup returns wikipedia source when wiki_summary succeeds."""
+    wiki_data = {
+        "title": "QUIC",
+        "extract": "QUIC is a transport layer protocol.",
+        "url": "https://en.wikipedia.org/wiki/QUIC",
+    }
+
+    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=wiki_data):
+        from fabledassistant.services.tools.web import lookup_tool
+        result = await lookup_tool(user_id=1, arguments={"query": "QUIC"})
+
+    assert result["success"] is True
+    assert result["type"] == "lookup"
+    assert result["source"] == "wikipedia"
+    assert result["data"]["title"] == "QUIC"
+    assert "transport" in result["data"]["extract"]
+
+
+@pytest.mark.asyncio
+async def test_lookup_wikipedia_miss_searxng_fallback():
+    """lookup falls back to SearXNG + article fetch when Wikipedia misses."""
+    searxng_results = [
+        {"url": "https://example.com/quic", "title": "QUIC Explained", "snippet": "An overview..."},
+    ]
+
+    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=None), \
+         patch("fabledassistant.services.tools.web.Config") as mock_config, \
+         patch("fabledassistant.services.tools.web._search_searxng", new_callable=AsyncMock, return_value=searxng_results), \
+         patch("fabledassistant.services.tools.web._fetch_full_article", new_callable=AsyncMock, return_value="Full article about QUIC..."):
+        mock_config.searxng_enabled.return_value = True
+        from fabledassistant.services.tools.web import lookup_tool
+        result = await lookup_tool(user_id=1, arguments={"query": "QUIC"})
+
+    assert result["success"] is True
+    assert result["type"] == "lookup"
+    assert result["source"] == "web"
+    assert result["data"]["results"]
+
+
+@pytest.mark.asyncio
+async def test_lookup_wikipedia_miss_no_searxng():
+    """lookup returns no-results when Wikipedia misses and SearXNG is not configured."""
+    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=None), \
+         patch("fabledassistant.services.tools.web.Config") as mock_config:
+        mock_config.searxng_enabled.return_value = False
+        from fabledassistant.services.tools.web import lookup_tool
+        result = await lookup_tool(user_id=1, arguments={"query": "xyznonexistent"})
+
+    assert result["success"] is True
+    assert result["source"] == "none"
+
+
+@pytest.mark.asyncio
+async def test_lookup_always_available():
+    """lookup tool must appear in get_tools_for_user regardless of SearXNG config."""
+    with patch("fabledassistant.services.tools._registry.is_caldav_configured", new_callable=AsyncMock, return_value=False), \
+         patch("fabledassistant.services.settings.get_setting", new_callable=AsyncMock, return_value="false"):
+        from fabledassistant.services.tools import get_tools_for_user
+        tools = await get_tools_for_user(user_id=1)
+        tool_names = {t["function"]["name"] for t in tools}
+        assert "lookup" in tool_names
+```
+
+- [ ] **Step 2: Run tests to verify they fail**
+
+Run: `uv run pytest tests/test_lookup_tool.py -v`
+Expected: FAIL (no `lookup_tool` function)
+
+- [ ] **Step 3: Replace `search_web` with `lookup` in `web.py`**
+
+Replace the `search_web_tool` function (lines 12–36 of `src/fabledassistant/services/tools/web.py`) with:
+
+```python
+@tool(
+    name="lookup",
+    description=(
+        "Look up a topic, concept, or factual question. Returns a concise answer from "
+        "Wikipedia or web sources. Use for definitions, explanations, 'what is X', "
+        "'how does Y work', current events, or version numbers. No note is saved. "
+        "For comprehensive written reports saved as notes, use research_topic instead."
+    ),
+    parameters={
+        "query": {"type": "string", "description": "The topic or question to look up"},
+    },
+    required=["query"],
+)
+async def lookup_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.config import Config
+    from fabledassistant.services.wikipedia import wiki_summary
+
+    query = arguments.get("query", "")
+
+    # 1. Try Wikipedia first
+    wiki = await wiki_summary(query)
+    if wiki:
+        return {
+            "success": True,
+            "type": "lookup",
+            "source": "wikipedia",
+            "data": wiki,
+        }
+
+    # 2. Fall back to SearXNG + article fetch
+    if Config.searxng_enabled():
+        from fabledassistant.services.research import _search_searxng
+        from fabledassistant.services.rss import _fetch_full_article
+
+        results = await _search_searxng(query)
+        if results:
+            articles: list[dict] = []
+            for r in results[:2]:
+                url = r.get("url", "")
+                if not url:
+                    continue
+                content = await _fetch_full_article(url)
+                articles.append({
+                    "url": url,
+                    "title": r.get("title", url),
+                    "snippet": r.get("snippet", ""),
+                    "content": (content or "")[:4000],
+                })
+            if articles:
+                return {
+                    "success": True,
+                    "type": "lookup",
+                    "source": "web",
+                    "data": {"query": query, "results": articles},
+                }
+
+    # 3. No sources available
+    return {
+        "success": True,
+        "type": "lookup",
+        "source": "none",
+        "data": {
+            "query": query,
+            "message": "No results found. You can answer from your own knowledge.",
+        },
+    }
+```
+
+- [ ] **Step 4: Run lookup tests to verify they pass**
+
+Run: `uv run pytest tests/test_lookup_tool.py -v`
+Expected: 4 passed
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/fabledassistant/services/tools/web.py tests/test_lookup_tool.py
+git commit -m "feat: replace search_web with unified lookup tool (Wikipedia + SearXNG fallback)"
+```
+
+---
+
+### Task 3: Update All `search_web` References
+
+**Files:**
+- Modify: `src/fabledassistant/services/tools/web.py:45` (research_topic description)
+- Modify: `src/fabledassistant/services/tools/web.py:67` (search_images description)
+- Modify: `src/fabledassistant/services/tools/rss.py:75` (read_article description)
+- Modify: `src/fabledassistant/services/generation_task.py:133` (status label map)
+- Modify: `src/fabledassistant/services/llm.py:608` (action list)
+
+- [ ] **Step 1: Update `research_topic` description**
+
+In `src/fabledassistant/services/tools/web.py`, change the `research_topic` description from:
+
+```python
+        "For a quick factual answer without saving a note, use search_web."
+```
+
+to:
+
+```python
+        "For a quick factual answer without saving a note, use lookup."
+```
+
+- [ ] **Step 2: Update `search_images` description**
+
+In `src/fabledassistant/services/tools/web.py`, change the `search_images` description from:
+
+```python
+    description="Search and display images inline. Use ONLY when the user explicitly asks to see, show, or find an image or photo. Not for factual questions — use search_web for those.",
+```
+
+to:
+
+```python
+    description="Search and display images inline. Use ONLY when the user explicitly asks to see, show, or find an image or photo. Not for factual questions — use lookup for those.",
+```
+
+- [ ] **Step 3: Update `read_article` description**
+
+In `src/fabledassistant/services/tools/rss.py`, change:
+
+```python
+        "Do NOT use search_web for URLs — use this tool instead."
+```
+
+to:
+
+```python
+        "Do NOT use lookup for URLs — use this tool instead."
+```
+
+- [ ] **Step 4: Update status label map in `generation_task.py`**
+
+In `src/fabledassistant/services/generation_task.py`, line 133, change:
+
+```python
+    "search_web": "Searching the web",
+```
+
+to:
+
+```python
+    "lookup": "Looking up information",
+```
+
+- [ ] **Step 5: Update action list in `llm.py`**
+
+In `src/fabledassistant/services/llm.py`, line 608, change:
+
+```python
+        actions.extend(["search_web", "research_topic", "search_images"])
+```
+
+to:
+
+```python
+        actions.extend(["lookup", "research_topic", "search_images"])
+```
+
+- [ ] **Step 6: Run full test suite to check for regressions**
+
+Run: `uv run pytest tests/ -v`
+Expected: All tests pass (no test references `search_web` by name in assertions)
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add src/fabledassistant/services/tools/web.py src/fabledassistant/services/tools/rss.py src/fabledassistant/services/generation_task.py src/fabledassistant/services/llm.py
+git commit -m "refactor: update all search_web references to lookup"
+```
+
+---
+
+### Task 4: Add Wikipedia Sources to Research Pipeline
+
+**Files:**
+- Modify: `src/fabledassistant/services/research.py`
+- Modify: `tests/test_research_pipeline.py`
+
+- [ ] **Step 1: Write failing test for Wikipedia in research pipeline**
+
+Add to `tests/test_research_pipeline.py`:
+
+```python
+@pytest.mark.asyncio
+async def test_pipeline_includes_wikipedia_sources():
+    """run_research_pipeline should merge Wikipedia results into the source pool."""
+    from unittest.mock import MagicMock
+
+    wiki_results = [{"title": "Wiki Article", "extract": "Wikipedia content about the topic.", "url": "https://en.wikipedia.org/wiki/Topic"}]
+
+    outline = [
+        {"title": "Section A", "focus": "Focus A"},
+        {"title": "Section B", "focus": "Focus B"},
+    ]
+
+    note_id_counter = iter(range(30, 40))
+
+    def _make_note(user_id, title, body, tags, project_id=None, parent_id=None):
+        n = MagicMock()
+        n.id = next(note_id_counter)
+        n.title = title
+        return n
+
+    with patch("fabledassistant.services.research._generate_sub_queries", new_callable=AsyncMock, return_value=["q1"]), \
+         patch("fabledassistant.services.research._search_searxng", new_callable=AsyncMock, return_value=[{"url": "http://x.com", "title": "X", "snippet": "s"}]), \
+         patch("fabledassistant.services.research.wiki_search", new_callable=AsyncMock, return_value=wiki_results), \
+         patch("fabledassistant.services.research.fetch_url_content", new_callable=AsyncMock, return_value="content"), \
+         patch("fabledassistant.services.research._generate_outline", new_callable=AsyncMock, return_value=outline) as mock_outline, \
+         patch("fabledassistant.services.research._synthesize_section", new_callable=AsyncMock, side_effect=lambda t, f, s, m: (t, f"Body for {t}")), \
+         patch("fabledassistant.services.research._generate_executive_summary", new_callable=AsyncMock, return_value="Summary."), \
+         patch("fabledassistant.services.research.create_note", new_callable=AsyncMock, side_effect=_make_note), \
+         patch("fabledassistant.services.research.update_note", new_callable=AsyncMock):
+
+        from fabledassistant.services.research import run_research_pipeline
+        await run_research_pipeline("test topic", user_id=1, model="test-model")
+
+    # The sources passed to _generate_outline should include the Wikipedia article
+    sources_arg = mock_outline.call_args[0][1]  # second positional arg
+    source_urls = [s["url"] for s in sources_arg]
+    assert "https://en.wikipedia.org/wiki/Topic" in source_urls
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `uv run pytest tests/test_research_pipeline.py::test_pipeline_includes_wikipedia_sources -v`
+Expected: FAIL (no `wiki_search` import in research.py)
+
+- [ ] **Step 3: Add Wikipedia sources to the research pipeline**
+
+In `src/fabledassistant/services/research.py`, add the import at the top (after existing imports):
+
+```python
+from fabledassistant.services.wikipedia import wiki_search
+```
+
+Then modify Step 2 (the parallel search section, around lines 208–246). Replace:
+
+```python
+    # Step 2: Search all queries in parallel (200 ms stagger to avoid hammering SearXNG)
+    async def _search_with_stagger(i: int, query: str) -> tuple[str, list[dict]]:
+        if i > 0:
+            await asyncio.sleep(0.2 * i)
+        _status(f"Searching: {query}...")
+        results = await _search_searxng(query)
+        logger.info("Research: query '%s' → %d results", query, len(results))
+        return query, results
+
+    search_results = await asyncio.gather(
+        *[_search_with_stagger(i, q) for i, q in enumerate(queries)]
+    )
+
+    # Deduplicate URLs across all queries
+    seen_urls: set[str] = set()
+    url_tasks: list[tuple[str, dict, str]] = []  # (url, result_dict, query)
+    for query, results in search_results:
+        for result in results[:PAGES_PER_QUERY]:
+            url = result.get("url", "")
+            if url and url not in seen_urls:
+                seen_urls.add(url)
+                url_tasks.append((url, result, query))
+
+    # Fetch all unique URLs in parallel
+    async def _fetch_source(url: str, result: dict, query: str) -> dict:
+        title = result.get("title", url)
+        _status(f"Reading: {title[:60]}...")
+        content = await fetch_url_content(url)
+        return {
+            "url": url,
+            "title": title,
+            "query": query,
+            "snippet": result.get("snippet", ""),
+            "content": content,
+        }
+
+    all_sources: list[dict] = list(await asyncio.gather(
+        *[_fetch_source(url, result, query) for url, result, query in url_tasks]
+    ))
+```
+
+with:
+
+```python
+    # Step 2: Search all queries in parallel (SearXNG + Wikipedia)
+    async def _search_with_stagger(i: int, query: str) -> tuple[str, list[dict]]:
+        if i > 0:
+            await asyncio.sleep(0.2 * i)
+        _status(f"Searching: {query}...")
+        results = await _search_searxng(query)
+        logger.info("Research: query '%s' → %d results", query, len(results))
+        return query, results
+
+    async def _wiki_for_query(query: str) -> list[dict]:
+        return await wiki_search(query, limit=1)
+
+    searxng_task = asyncio.gather(
+        *[_search_with_stagger(i, q) for i, q in enumerate(queries)]
+    )
+    wiki_task = asyncio.gather(
+        *[_wiki_for_query(q) for q in queries]
+    )
+    search_results, wiki_results = await asyncio.gather(searxng_task, wiki_task)
+
+    # Deduplicate URLs across all queries
+    seen_urls: set[str] = set()
+    url_tasks: list[tuple[str, dict, str]] = []  # (url, result_dict, query)
+    wiki_sources: list[dict] = []  # Wikipedia articles (already have content)
+
+    for query, results in search_results:
+        for result in results[:PAGES_PER_QUERY]:
+            url = result.get("url", "")
+            if url and url not in seen_urls:
+                seen_urls.add(url)
+                url_tasks.append((url, result, query))
+
+    # Add Wikipedia results (they already have content via extract)
+    for query, wiki_hits in zip(queries, wiki_results):
+        for hit in wiki_hits:
+            url = hit.get("url", "")
+            if url and url not in seen_urls:
+                seen_urls.add(url)
+                wiki_sources.append({
+                    "url": url,
+                    "title": hit["title"],
+                    "query": query,
+                    "snippet": hit["extract"][:200],
+                    "content": hit["extract"],
+                })
+
+    # Fetch all unique SearXNG URLs in parallel
+    async def _fetch_source(url: str, result: dict, query: str) -> dict:
+        title = result.get("title", url)
+        _status(f"Reading: {title[:60]}...")
+        content = await fetch_url_content(url)
+        return {
+            "url": url,
+            "title": title,
+            "query": query,
+            "snippet": result.get("snippet", ""),
+            "content": content,
+        }
+
+    fetched_sources: list[dict] = list(await asyncio.gather(
+        *[_fetch_source(url, result, query) for url, result, query in url_tasks]
+    ))
+
+    all_sources = wiki_sources + fetched_sources
+```
+
+- [ ] **Step 4: Run the new test to verify it passes**
+
+Run: `uv run pytest tests/test_research_pipeline.py::test_pipeline_includes_wikipedia_sources -v`
+Expected: PASS
+
+- [ ] **Step 5: Run the full research test suite for regressions**
+
+Run: `uv run pytest tests/test_research_pipeline.py -v`
+Expected: All tests pass
+
+- [ ] **Step 6: Run full test suite**
+
+Run: `uv run pytest tests/ -v`
+Expected: All tests pass
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add src/fabledassistant/services/research.py tests/test_research_pipeline.py
+git commit -m "feat: add Wikipedia as research pipeline source alongside SearXNG"
+```
+
+---
+
+### Task 5: Lint, Typecheck, Final Verification
+
+**Files:**
+- All modified files
+
+- [ ] **Step 1: Run ruff lint**
+
+Run: `uv run ruff check src/fabledassistant/services/wikipedia.py src/fabledassistant/services/tools/web.py src/fabledassistant/services/research.py tests/test_wikipedia.py tests/test_lookup_tool.py`
+Expected: All checks passed (fix any issues if not)
+
+- [ ] **Step 2: Run typecheck**
+
+Run: `cd frontend && npx vue-tsc --noEmit` (frontend unchanged, but verify nothing broke)
+Expected: Clean
+
+- [ ] **Step 3: Run full test suite one last time**
+
+Run: `uv run pytest tests/ -v`
+Expected: All tests pass
+
+- [ ] **Step 4: Commit any lint fixes if needed**
+
+```bash
+git add -u
+git commit -m "fix: lint cleanup for lookup/wikipedia changes"
+```

docs/superpowers/specs/2026-04-17-unified-lookup-wikipedia-design.md

@@ -0,0 +1,119 @@
+# Unified Lookup Tool & Wikipedia Integration
+
+## Goal
+
+Replace the fragmented `search_web` tool with a single `lookup` tool that checks Wikipedia first and falls back to SearXNG web search. Add Wikipedia as an additional source in the research pipeline. Result: one lightweight tool for factual questions (always available, no config required), and richer research output.
+
+## Architecture
+
+Two changes to the search/knowledge stack:
+
+1. **New `lookup` tool** replaces `search_web`. Tries Wikipedia REST API summary endpoint first (~200ms, reliable, no config). Falls back to SearXNG + trafilatura article fetch when Wikipedia misses and SearXNG is configured. Always available (no `requires` field).
+
+2. **Wikipedia sources in research pipeline.** During sub-query execution, `wiki_search` runs alongside `_search_searxng`. Wikipedia articles merge into the source pool and get deduplicated by URL.
+
+Shared Wikipedia logic lives in a new `wikipedia.py` service module.
+
+## Components
+
+### `src/fabledassistant/services/wikipedia.py` (new)
+
+Two async functions:
+
+**`wiki_summary(query: str) -> dict | None`**
+- Direct title lookup via `https://en.wikipedia.org/api/rest_v1/page/summary/{title}`
+- Returns `{"title": str, "extract": str, "url": str}` on hit
+- Returns `None` on 404, disambiguation pages (`"type": "disambiguation"`), network errors, or empty extracts
+- 5-second timeout
+- User-Agent: `"FabledAssistant/1.0 (https://fabledsword.com)"`
+
+**`wiki_search(query: str, limit: int = 3) -> list[dict]`**
+- Search via `https://en.wikipedia.org/w/api.php?action=query&list=search&srsearch={query}&srlimit={limit}&format=json`
+- For each search result, fetch its summary via the summary endpoint to get the extract
+- Returns `[{"title": str, "extract": str, "url": str}, ...]`
+- Returns `[]` on any failure
+- Same timeout and User-Agent as above
+
+### `src/fabledassistant/services/tools/web.py` (modified)
+
+**Remove:** `search_web_tool`
+
+**Add:** `lookup_tool`
+
+```
+@tool(
+    name="lookup",
+    description="Look up a topic, concept, or factual question. Returns a concise
+                 answer from Wikipedia or web sources. Use for definitions,
+                 explanations, 'what is X', 'how does Y work'. For comprehensive
+                 written reports saved as notes, use research_topic instead.",
+    parameters={
+        "query": {"type": "string", "description": "The topic or question to look up"},
+    },
+    required=["query"],
+)
+```
+
+No `requires` field — always available.
+
+**Logic:**
+1. Call `wiki_summary(query)`
+2. If Wikipedia returns a result: return `{"success": True, "type": "lookup", "source": "wikipedia", "data": {"title": ..., "extract": ..., "url": ...}}`
+3. If Wikipedia misses and `Config.searxng_enabled()`:
+   - Call `_search_searxng(query)` to get search results
+   - Fetch top 1-2 result URLs via `_fetch_full_article` (from `rss.py`, trafilatura-based)
+   - Return `{"success": True, "type": "lookup", "source": "web", "data": {"query": ..., "results": [...], "content": ...}}`
+4. If Wikipedia misses and no SearXNG: return `{"success": True, "type": "lookup", "source": "none", "data": {"query": ..., "message": "No results found. You can answer from your own knowledge."}}`
+
+### `src/fabledassistant/services/research.py` (modified)
+
+**In Step 2 (parallel search):**
+- For each sub-query, run `wiki_search(query, limit=1)` concurrently with `_search_searxng(query)`
+- Merge Wikipedia results into the per-query result list
+
+**In Step 3 (deduplication):**
+- When deduplicating URLs, Wikipedia URLs (`wikipedia.org`) are checked against SearXNG results
+- If a Wikipedia article URL already appears in SearXNG results, skip the duplicate
+
+**Wikipedia article content for synthesis:**
+- The `extract` from `wiki_search` is used as the source content (no additional fetch needed, unlike SearXNG URLs which require `fetch_url_content`)
+- This means Wikipedia sources are available immediately without an HTTP fetch step
+
+## Error Handling
+
+- All Wikipedia API failures (network, timeout, malformed JSON) return `None`/`[]` silently
+- `lookup` never raises — always returns a response the model can work with
+- In the research pipeline, Wikipedia is purely additive; its failure never degrades existing SearXNG-based research
+- Disambiguation pages are detected via `"type": "disambiguation"` in the summary response and treated as a miss
+
+## Testing
+
+### `tests/test_wikipedia.py` (new)
+
+- `test_wiki_summary_returns_extract` — mock successful summary response, verify return shape
+- `test_wiki_summary_returns_none_on_404` — mock 404, verify `None`
+- `test_wiki_summary_returns_none_on_disambiguation` — mock disambiguation response, verify `None`
+- `test_wiki_search_returns_results` — mock search API + summary fetches, verify list
+- `test_wiki_search_returns_empty_on_failure` — mock network error, verify `[]`
+
+### `tests/test_lookup_tool.py` (new)
+
+- `test_lookup_wikipedia_hit` — mock `wiki_summary` returning data, verify tool returns wikipedia source
+- `test_lookup_wikipedia_miss_searxng_fallback` — mock `wiki_summary` returning None, SearXNG returning results + article fetch, verify web source
+- `test_lookup_wikipedia_miss_no_searxng` — mock both missing, verify graceful "no results" response
+- `test_lookup_always_available` — verify the tool appears in `get_tools_for_user` regardless of SearXNG config
+
+### `tests/test_research_pipeline.py` (add to existing)
+
+- `test_research_includes_wikipedia_sources` — mock `wiki_search` alongside SearXNG, verify Wikipedia results appear in source pool
+
+All tests mock HTTP calls — no live API hits.
+
+## What Doesn't Change
+
+- `read_article` tool — stays as-is (explicit URL fetch, different purpose)
+- `research_topic` tool definition — stays as-is (same name, description, parameters)
+- `generation_task.py` research interception — stays as-is
+- `search_images` tool — stays as-is
+- `_search_searxng` and `_search_searxng_images` — stay as-is
+- `_fetch_full_article` in `rss.py` — stays as-is, reused by `lookup` for SearXNG fallback

fable-mcp/fable_mcp/server.py

@@ -1,16 +1,16 @@
-"""Fable MCP server — exposes Fable Assistant as MCP tools via stdio transport."""
+"""Fable MCP server — exposes Fable Scribe as MCP tools via stdio transport."""
 from __future__ import annotations
 
 from mcp.server.fastmcp import FastMCP
 from dotenv import load_dotenv
 
 from fable_mcp.client import FableClient
-from fable_mcp.tools import notes, tasks, projects, milestones, search, chat, admin, briefing
+from fable_mcp.tools import notes, tasks, projects, milestones, search, chat, admin, journal
 
 load_dotenv()
 
 _INSTRUCTIONS = """
-Fable Assistant is a self-hosted second-brain and project management system with LLM integration.
+Fabled Scribe is a self-hosted second-brain and project management system with LLM integration.
 
 ## Data model
 
@@ -27,7 +27,7 @@ The hierarchy is: Project → Milestone → Task/Note.
 
 - **Tasks** belong to a project and optionally a milestone. They support sub-tasks via `parent_id`.
   - Status values: `todo`, `in_progress`, `done`, `cancelled`
-  - Priority values: `low`, `normal`, `high`
+  - Priority values: `none` (default), `low`, `medium`, `high`
 
 - **Notes** are free-form markdown documents. They can belong to a project or be standalone
   (orphan notes). Orphan notes are included in the default RAG scope for chat conversations.
@@ -68,10 +68,19 @@ Use the direct CRUD tools when:
 Use `fable_add_task_log` to append time-stamped progress notes to a task without overwriting
 its main body. Suitable for recording work sessions, decisions, or status updates over time.
 
-## RSS / Briefing
+## Journal
 
-Fable runs a daily briefing that summarises tasks, calendar events, and RSS feed items.
-Use `fable_add_rss_feed` / `fable_remove_rss_feed` to manage the feeds included in that briefing.
+Fable Scribe runs a per-day Journal — a conversational surface where the user narrates
+their day. Each day has its own conversation. The first assistant message in a day's
+conversation is the **daily prep**: an LLM-generated briefing covering today's tasks,
+calendar events, weather, active projects, and recent journal context. Subsequent turns
+are user/assistant journaling exchanges; the LLM may emit **Moments** (small structured
+extractions) via the `record_moment` tool during the conversation.
+
+Use `fable_get_today_journal` to inspect today's prep + conversation. Use
+`fable_get_journal_day` for past days. Use `fable_list_moments` to query the structured
+journal extractions across days. Use `fable_trigger_journal_prep` to force-regenerate
+today's prep prose.
 
 ## Admin logs
 
@@ -241,7 +250,7 @@ async def fable_create_task(
         title: Task title (required).
         body: Markdown description / notes for the task.
         status: Initial status — one of: todo (default), in_progress, done, cancelled.
-        priority: One of: low, normal, high. Omit for no priority.
+        priority: One of: low, medium, high. Omit for no priority (defaults to "none").
         project_id: Associate with a project (0 = no project).
         milestone_id: Place within a project milestone (0 = no milestone).
         parent_id: Make this a sub-task of another task (0 = top-level).
@@ -280,7 +289,7 @@ async def fable_update_task(
         title: New title, or omit to leave unchanged.
         body: New markdown body, or omit to leave unchanged.
         status: New status — one of: todo, in_progress, done, cancelled.
-        priority: New priority — one of: low, normal, high.
+        priority: New priority — one of: none, low, medium, high.
         project_id: New project (0 = remove from project). Omit to leave unchanged.
         milestone_id: New milestone (0 = remove from milestone). Omit to leave unchanged.
     """
@@ -582,50 +591,155 @@ async def fable_get_app_logs(
 
 
 # ---------------------------------------------------------------------------
-# Briefing / RSS
+# Journal — daily prep, day payloads, moments
 # ---------------------------------------------------------------------------
 
 
 @mcp.tool()
-async def fable_list_rss_feeds() -> dict:
-    """List all RSS/Atom feeds configured in Fable for the current user.
+async def fable_get_today_journal() -> dict:
+    """Fetch today's Journal day payload.
 
-    Returns id, title, url, category, and last_fetched_at for each feed.
-    These feeds are summarised in the user's daily briefing.
+    Creates today's journal conversation and generates the daily prep
+    message if neither exists yet. Returns:
+        {
+          "day_date": "YYYY-MM-DD",
+          "conversation": { id, title, conversation_type, day_date, ... },
+          "messages": [ ... ordered list of messages ... ]
+        }
+
+    The first assistant message is the daily prep — a conversational
+    opener generated by the LLM from gathered tasks/events/weather/
+    projects/recent moments/open threads. Its ``msg_metadata.sections``
+    carries the underlying structured data for inspection.
     """
     async with FableClient() as client:
-        return await briefing.list_rss_feeds(client)
+        return await journal.get_today_journal(client)
 
 
 @mcp.tool()
-async def fable_add_rss_feed(
-    url: str,
-    title: str = "",
-    category: str = "",
-) -> dict:
-    """Add an RSS or Atom feed to Fable's daily briefing.
+async def fable_get_journal_day(iso_date: str) -> dict:
+    """Fetch a specific day's Journal payload by ISO date.
 
     Args:
-        url: The RSS/Atom feed URL (required).
-        title: Optional display name. If omitted, auto-populated from feed metadata.
-        category: Optional category label to group feeds (e.g. "news", "tech", "finance").
+        iso_date: YYYY-MM-DD format date.
 
-    Returns the created feed object including its assigned id.
+    Returns the same shape as fable_get_today_journal. If no journal
+    exists for that day, ``conversation`` and ``messages`` will be
+    null/empty respectively.
     """
     async with FableClient() as client:
-        return await briefing.add_rss_feed(
-            client,
-            url=url,
-            title=title or None,
-            category=category or None,
+        return await journal.get_journal_day(client, iso_date=iso_date)
+
+
+@mcp.tool()
+async def fable_list_journal_days() -> dict:
+    """List dates that have journal content for the current user, newest first.
+
+    Returns ``{"days": ["YYYY-MM-DD", ...]}``. Use these dates to query
+    specific days via ``fable_get_journal_day``.
+    """
+    async with FableClient() as client:
+        return await journal.list_journal_days(client)
+
+
+@mcp.tool()
+async def fable_trigger_journal_prep(iso_date: str = "") -> dict:
+    """Force-regenerate the daily prep prose for today (or a specific day).
+
+    The prep is the first assistant message in a day's journal — a
+    conversational LLM-generated briefing built from tasks/events/weather/
+    projects/recent moments/open threads. Use this to iterate on the prep
+    prompt or refresh after data changes.
+
+    Args:
+        iso_date: Optional YYYY-MM-DD. If empty, regenerates today.
+
+    Returns ``{"ok": true, "message_id": ...}``.
+    """
+    async with FableClient() as client:
+        return await journal.trigger_journal_prep(
+            client, iso_date=iso_date or None,
         )
 
 
 @mcp.tool()
-async def fable_remove_rss_feed(feed_id: int) -> dict:
-    """Remove an RSS feed from Fable by its ID."""
+async def fable_get_journal_config() -> dict:
+    """Fetch the user's journal config.
+
+    Includes prep schedule (prep_enabled / prep_hour / prep_minute),
+    day rollover hour, phase boundaries, and any locations / temp_unit
+    used for the prep's weather section.
+    """
     async with FableClient() as client:
-        return await briefing.remove_rss_feed(client, feed_id=feed_id)
+        return await journal.get_journal_config(client)
+
+
+@mcp.tool()
+async def fable_list_moments(
+    query: str = "",
+    person_id: int = 0,
+    place_id: int = 0,
+    tag: str = "",
+    date_from: str = "",
+    date_to: str = "",
+    pinned_only: bool = False,
+    limit: int = 50,
+) -> dict:
+    """Search/list journal Moments — small structured extractions the LLM emits during journaling.
+
+    All filters are optional and combinable. Without a query, returns
+    moments ordered by occurred_at DESC. With a query, returns
+    semantically-ranked moments above the similarity threshold.
+
+    Args:
+        query: Optional semantic query string.
+        person_id: Filter to moments mentioning this person (0 = no filter).
+        place_id: Filter to moments mentioning this place (0 = no filter).
+        tag: Filter to moments with this tag.
+        date_from: ISO YYYY-MM-DD lower bound (inclusive).
+        date_to: ISO YYYY-MM-DD upper bound (inclusive).
+        pinned_only: If True, only return pinned moments.
+        limit: Max results, default 50.
+
+    Returns ``{"moments": [...]}`` where each moment has id, day_date,
+    occurred_at, content, raw_excerpt, tags, people, places, task_ids,
+    note_ids, pinned, and (when query set) score.
+    """
+    async with FableClient() as client:
+        return await journal.list_moments(
+            client,
+            query=query or None,
+            person_id=person_id if person_id else None,
+            place_id=place_id if place_id else None,
+            tag=tag or None,
+            date_from=date_from or None,
+            date_to=date_to or None,
+            pinned_only=pinned_only,
+            limit=limit,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Generic conversation access
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_get_conversation(conversation_id: int) -> dict:
+    """Fetch any conversation (chat or journal) with its full message list.
+
+    Returns conversation metadata plus an ordered ``messages`` array.
+    Each message includes role, content, tool_calls (with results),
+    context_note_id, and msg_metadata. Tool calls are in the stored
+    flat format: ``[{"function": name, "arguments": {...}, "result": {...}}]``.
+
+    Useful for inspecting journal preps, chat history, or verifying
+    that a tool actually ran with the expected arguments.
+    """
+    async with FableClient() as client:
+        return await journal.get_conversation(
+            client, conversation_id=conversation_id,
+        )
 
 
 # ---------------------------------------------------------------------------

fable-mcp/fable_mcp/tools/briefing.py

@@ -1,32 +0,0 @@
-"""MCP tools for Fable RSS feed management."""
-from __future__ import annotations
-
-from typing import Any
-
-from fable_mcp.client import FableClient
-
-
-async def list_rss_feeds(client: FableClient) -> dict[str, Any]:
-    """List the user's RSS feeds."""
-    return await client.get("/api/briefing/feeds")
-
-
-async def add_rss_feed(
-    client: FableClient,
-    *,
-    url: str,
-    title: str | None = None,
-    category: str | None = None,
-) -> dict[str, Any]:
-    """Add a new RSS feed. Title is optional — auto-populated from feed metadata."""
-    payload: dict[str, Any] = {"url": url}
-    if title:
-        payload["title"] = title
-    if category:
-        payload["category"] = category
-    return await client.post("/api/briefing/feeds", json=payload)
-
-
-async def remove_rss_feed(client: FableClient, *, feed_id: int) -> dict[str, Any]:
-    """Remove an RSS feed by ID."""
-    return await client.delete(f"/api/briefing/feeds/{feed_id}")

fable-mcp/fable_mcp/tools/journal.py

@@ -0,0 +1,96 @@
+"""MCP tools for inspecting and controlling the Fable Scribe Journal."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+# ── Day payloads ─────────────────────────────────────────────────────────────
+
+
+async def get_today_journal(client: FableClient) -> dict[str, Any]:
+    """Fetch today's journal day payload (creates today's conversation + prep if needed)."""
+    return await client.get("/api/journal/today")
+
+
+async def get_journal_day(client: FableClient, *, iso_date: str) -> dict[str, Any]:
+    """Fetch a specific day's journal payload by ISO date (YYYY-MM-DD)."""
+    return await client.get(f"/api/journal/day/{iso_date}")
+
+
+async def list_journal_days(client: FableClient) -> dict[str, Any]:
+    """List dates that have journal content for the current user."""
+    return await client.get("/api/journal/days")
+
+
+# ── Daily prep ───────────────────────────────────────────────────────────────
+
+
+async def trigger_journal_prep(
+    client: FableClient,
+    *,
+    iso_date: str | None = None,
+) -> dict[str, Any]:
+    """Force-regenerate the daily prep for today (or a specific day)."""
+    payload: dict[str, Any] = {}
+    if iso_date:
+        payload["date"] = iso_date
+    return await client.post("/api/journal/trigger-prep", json=payload)
+
+
+# ── Config ───────────────────────────────────────────────────────────────────
+
+
+async def get_journal_config(client: FableClient) -> dict[str, Any]:
+    """Fetch the user's journal config (prep schedule, day rollover, locations, etc.)."""
+    return await client.get("/api/journal/config")
+
+
+# ── Moments ──────────────────────────────────────────────────────────────────
+
+
+async def list_moments(
+    client: FableClient,
+    *,
+    query: str | None = None,
+    person_id: int | None = None,
+    place_id: int | None = None,
+    tag: str | None = None,
+    date_from: str | None = None,
+    date_to: str | None = None,
+    pinned_only: bool = False,
+    limit: int = 50,
+) -> dict[str, Any]:
+    """List/search journal moments with optional filters.
+
+    All params are optional. Returns a dict with a ``moments`` array.
+    """
+    params: dict[str, str] = {"limit": str(limit)}
+    if query:
+        params["query"] = query
+    if person_id is not None:
+        params["person_id"] = str(person_id)
+    if place_id is not None:
+        params["place_id"] = str(place_id)
+    if tag:
+        params["tag"] = tag
+    if date_from:
+        params["date_from"] = date_from
+    if date_to:
+        params["date_to"] = date_to
+    if pinned_only:
+        params["pinned_only"] = "true"
+    return await client.get("/api/journal/moments", params=params)
+
+
+# ── Generic conversation access (still works for journal conversations) ───────
+
+
+async def get_conversation(
+    client: FableClient,
+    *,
+    conversation_id: int,
+) -> dict[str, Any]:
+    """Fetch any conversation (chat or journal) with its full message list."""
+    return await client.get(f"/api/chat/conversations/{conversation_id}")

fable-mcp/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fable-mcp"
-version = "0.2.4"
-description = "MCP server for Fabled Assistant"
+version = "0.2.6"
+description = "MCP server for Fabled Scribe"
 requires-python = ">=3.12"
 dependencies = [
   "mcp[cli]>=1.0",

fable-mcp/uv.lock

@@ -0,0 +1,771 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz", hash = "sha256:fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4", size = 7288, upload-time = "2025-11-10T22:07:42.062Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/d3/26bf1008eb3d2daa8ef4cacc7f3bfdc11818d111f7e2d0201bc6e3b49d45/annotated_doc-0.0.4-py3-none-any.whl", hash = "sha256:571ac1dc6991c450b25a9c2d84a3705e2ae7a53467b5d111c24fa8baabbed320", size = 5303, upload-time = "2025-11-10T22:07:40.673Z" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+
+[[package]]
+name = "attrs"
+version = "26.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9a/8e/82a0fe20a541c03148528be8cac2408564a6c9a0cc7e9171802bc1d26985/attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32", size = 952055, upload-time = "2026-03-19T14:22:25.026Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/64/b4/17d4b0b2a2dc85a6df63d1157e028ed19f90d4cd97c36717afef2bc2f395/attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309", size = 67548, upload-time = "2026-03-19T14:22:23.645Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.2.25"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/af/2d/7bf41579a8986e348fa033a31cdd0e4121114f6bce2457e8876010b092dd/certifi-2026.2.25.tar.gz", hash = "sha256:e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7", size = 155029, upload-time = "2026-02-25T02:54:17.342Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/3c/c17fb3ca2d9c3acff52e30b309f538586f9f5b9c9cf454f3845fc9af4881/certifi-2026.2.25-py3-none-any.whl", hash = "sha256:027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa", size = 153684, upload-time = "2026-02-25T02:54:15.766Z" },
+]
+
+[[package]]
+name = "cffi"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pycparser", marker = "implementation_name != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" },
+    { url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" },
+    { url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" },
+    { url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" },
+    { url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" },
+    { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" },
+    { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" },
+    { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" },
+    { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" },
+    { url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" },
+    { url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" },
+    { url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" },
+    { url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" },
+    { url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.3.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/57/75/31212c6bf2503fdf920d87fee5d7a86a2e3bcf444984126f13d8e4016804/click-8.3.2.tar.gz", hash = "sha256:14162b8b3b3550a7d479eafa77dfd3c38d9dc8951f6f69c78913a8f9a7540fd5", size = 302856, upload-time = "2026-04-03T19:14:45.118Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e4/20/71885d8b97d4f3dde17b1fdb92dbd4908b00541c5a3379787137285f602e/click-8.3.2-py3-none-any.whl", hash = "sha256:1924d2c27c5653561cd2cae4548d1406039cb79b858b747cfea24924bbc1616d", size = 108379, upload-time = "2026-04-03T19:14:43.505Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "cryptography"
+version = "46.0.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/47/93/ac8f3d5ff04d54bc814e961a43ae5b0b146154c89c61b47bb07557679b18/cryptography-46.0.7.tar.gz", hash = "sha256:e4cfd68c5f3e0bfdad0d38e023239b96a2fe84146481852dffbcca442c245aa5", size = 750652, upload-time = "2026-04-08T01:57:54.692Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/5d/4a8f770695d73be252331e60e526291e3df0c9b27556a90a6b47bccca4c2/cryptography-46.0.7-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:ea42cbe97209df307fdc3b155f1b6fa2577c0defa8f1f7d3be7d31d189108ad4", size = 7179869, upload-time = "2026-04-08T01:56:17.157Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/45/6d80dc379b0bbc1f9d1e429f42e4cb9e1d319c7a8201beffd967c516ea01/cryptography-46.0.7-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b36a4695e29fe69215d75960b22577197aca3f7a25b9cf9d165dcfe9d80bc325", size = 4275492, upload-time = "2026-04-08T01:56:19.36Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/9a/1765afe9f572e239c3469f2cb429f3ba7b31878c893b246b4b2994ffe2fe/cryptography-46.0.7-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5ad9ef796328c5e3c4ceed237a183f5d41d21150f972455a9d926593a1dcb308", size = 4426670, upload-time = "2026-04-08T01:56:21.415Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/3e/af9246aaf23cd4ee060699adab1e47ced3f5f7e7a8ffdd339f817b446462/cryptography-46.0.7-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:73510b83623e080a2c35c62c15298096e2a5dc8d51c3b4e1740211839d0dea77", size = 4280275, upload-time = "2026-04-08T01:56:23.539Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/54/6bbbfc5efe86f9d71041827b793c24811a017c6ac0fd12883e4caa86b8ed/cryptography-46.0.7-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cbd5fb06b62bd0721e1170273d3f4d5a277044c47ca27ee257025146c34cbdd1", size = 4928402, upload-time = "2026-04-08T01:56:25.624Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/cf/054b9d8220f81509939599c8bdbc0c408dbd2bdd41688616a20731371fe0/cryptography-46.0.7-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:420b1e4109cc95f0e5700eed79908cef9268265c773d3a66f7af1eef53d409ef", size = 4459985, upload-time = "2026-04-08T01:56:27.309Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/46/4e4e9c6040fb01c7467d47217d2f882daddeb8828f7df800cb806d8a2288/cryptography-46.0.7-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:24402210aa54baae71d99441d15bb5a1919c195398a87b563df84468160a65de", size = 3990652, upload-time = "2026-04-08T01:56:29.095Z" },
+    { url = "https://files.pythonhosted.org/packages/36/5f/313586c3be5a2fbe87e4c9a254207b860155a8e1f3cca99f9910008e7d08/cryptography-46.0.7-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:8a469028a86f12eb7d2fe97162d0634026d92a21f3ae0ac87ed1c4a447886c83", size = 4279805, upload-time = "2026-04-08T01:56:30.928Z" },
+    { url = "https://files.pythonhosted.org/packages/69/33/60dfc4595f334a2082749673386a4d05e4f0cf4df8248e63b2c3437585f2/cryptography-46.0.7-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:9694078c5d44c157ef3162e3bf3946510b857df5a3955458381d1c7cfc143ddb", size = 4892883, upload-time = "2026-04-08T01:56:32.614Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/0b/333ddab4270c4f5b972f980adef4faa66951a4aaf646ca067af597f15563/cryptography-46.0.7-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:42a1e5f98abb6391717978baf9f90dc28a743b7d9be7f0751a6f56a75d14065b", size = 4459756, upload-time = "2026-04-08T01:56:34.306Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/14/633913398b43b75f1234834170947957c6b623d1701ffc7a9600da907e89/cryptography-46.0.7-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:91bbcb08347344f810cbe49065914fe048949648f6bd5c2519f34619142bbe85", size = 4410244, upload-time = "2026-04-08T01:56:35.977Z" },
+    { url = "https://files.pythonhosted.org/packages/10/f2/19ceb3b3dc14009373432af0c13f46aa08e3ce334ec6eff13492e1812ccd/cryptography-46.0.7-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:5d1c02a14ceb9148cc7816249f64f623fbfee39e8c03b3650d842ad3f34d637e", size = 4674868, upload-time = "2026-04-08T01:56:38.034Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/bb/a5c213c19ee94b15dfccc48f363738633a493812687f5567addbcbba9f6f/cryptography-46.0.7-cp311-abi3-win32.whl", hash = "sha256:d23c8ca48e44ee015cd0a54aeccdf9f09004eba9fc96f38c911011d9ff1bd457", size = 3026504, upload-time = "2026-04-08T01:56:39.666Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/02/7788f9fefa1d060ca68717c3901ae7fffa21ee087a90b7f23c7a603c32ae/cryptography-46.0.7-cp311-abi3-win_amd64.whl", hash = "sha256:397655da831414d165029da9bc483bed2fe0e75dde6a1523ec2fe63f3c46046b", size = 3488363, upload-time = "2026-04-08T01:56:41.893Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/56/15619b210e689c5403bb0540e4cb7dbf11a6bf42e483b7644e471a2812b3/cryptography-46.0.7-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:d151173275e1728cf7839aaa80c34fe550c04ddb27b34f48c232193df8db5842", size = 7119671, upload-time = "2026-04-08T01:56:44Z" },
+    { url = "https://files.pythonhosted.org/packages/74/66/e3ce040721b0b5599e175ba91ab08884c75928fbeb74597dd10ef13505d2/cryptography-46.0.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:db0f493b9181c7820c8134437eb8b0b4792085d37dbb24da050476ccb664e59c", size = 4268551, upload-time = "2026-04-08T01:56:46.071Z" },
+    { url = "https://files.pythonhosted.org/packages/03/11/5e395f961d6868269835dee1bafec6a1ac176505a167f68b7d8818431068/cryptography-46.0.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ebd6daf519b9f189f85c479427bbd6e9c9037862cf8fe89ee35503bd209ed902", size = 4408887, upload-time = "2026-04-08T01:56:47.718Z" },
+    { url = "https://files.pythonhosted.org/packages/40/53/8ed1cf4c3b9c8e611e7122fb56f1c32d09e1fff0f1d77e78d9ff7c82653e/cryptography-46.0.7-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:b7b412817be92117ec5ed95f880defe9cf18a832e8cafacf0a22337dc1981b4d", size = 4271354, upload-time = "2026-04-08T01:56:49.312Z" },
+    { url = "https://files.pythonhosted.org/packages/50/46/cf71e26025c2e767c5609162c866a78e8a2915bbcfa408b7ca495c6140c4/cryptography-46.0.7-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:fbfd0e5f273877695cb93baf14b185f4878128b250cc9f8e617ea0c025dfb022", size = 4905845, upload-time = "2026-04-08T01:56:50.916Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/ea/01276740375bac6249d0a971ebdf6b4dc9ead0ee0a34ef3b5a88c1a9b0d4/cryptography-46.0.7-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:ffca7aa1d00cf7d6469b988c581598f2259e46215e0140af408966a24cf086ce", size = 4444641, upload-time = "2026-04-08T01:56:52.882Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/4c/7d258f169ae71230f25d9f3d06caabcff8c3baf0978e2b7d65e0acac3827/cryptography-46.0.7-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:60627cf07e0d9274338521205899337c5d18249db56865f943cbe753aa96f40f", size = 3967749, upload-time = "2026-04-08T01:56:54.597Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/2a/2ea0767cad19e71b3530e4cad9605d0b5e338b6a1e72c37c9c1ceb86c333/cryptography-46.0.7-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:80406c3065e2c55d7f49a9550fe0c49b3f12e5bfff5dedb727e319e1afb9bf99", size = 4270942, upload-time = "2026-04-08T01:56:56.416Z" },
+    { url = "https://files.pythonhosted.org/packages/41/3d/fe14df95a83319af25717677e956567a105bb6ab25641acaa093db79975d/cryptography-46.0.7-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:c5b1ccd1239f48b7151a65bc6dd54bcfcc15e028c8ac126d3fada09db0e07ef1", size = 4871079, upload-time = "2026-04-08T01:56:58.31Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/4a479e0f36f8f378d397f4eab4c850b4ffb79a2f0d58704b8fa0703ddc11/cryptography-46.0.7-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:d5f7520159cd9c2154eb61eb67548ca05c5774d39e9c2c4339fd793fe7d097b2", size = 4443999, upload-time = "2026-04-08T01:57:00.508Z" },
+    { url = "https://files.pythonhosted.org/packages/28/17/b59a741645822ec6d04732b43c5d35e4ef58be7bfa84a81e5ae6f05a1d33/cryptography-46.0.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fcd8eac50d9138c1d7fc53a653ba60a2bee81a505f9f8850b6b2888555a45d0e", size = 4399191, upload-time = "2026-04-08T01:57:02.654Z" },
+    { url = "https://files.pythonhosted.org/packages/59/6a/bb2e166d6d0e0955f1e9ff70f10ec4b2824c9cfcdb4da772c7dd69cc7d80/cryptography-46.0.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:65814c60f8cc400c63131584e3e1fad01235edba2614b61fbfbfa954082db0ee", size = 4655782, upload-time = "2026-04-08T01:57:04.592Z" },
+    { url = "https://files.pythonhosted.org/packages/95/b6/3da51d48415bcb63b00dc17c2eff3a651b7c4fed484308d0f19b30e8cb2c/cryptography-46.0.7-cp314-cp314t-win32.whl", hash = "sha256:fdd1736fed309b4300346f88f74cd120c27c56852c3838cab416e7a166f67298", size = 3002227, upload-time = "2026-04-08T01:57:06.91Z" },
+    { url = "https://files.pythonhosted.org/packages/32/a8/9f0e4ed57ec9cebe506e58db11ae472972ecb0c659e4d52bbaee80ca340a/cryptography-46.0.7-cp314-cp314t-win_amd64.whl", hash = "sha256:e06acf3c99be55aa3b516397fe42f5855597f430add9c17fa46bf2e0fb34c9bb", size = 3475332, upload-time = "2026-04-08T01:57:08.807Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/7f/cd42fc3614386bc0c12f0cb3c4ae1fc2bbca5c9662dfed031514911d513d/cryptography-46.0.7-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:462ad5cb1c148a22b2e3bcc5ad52504dff325d17daf5df8d88c17dda1f75f2a4", size = 7165618, upload-time = "2026-04-08T01:57:10.645Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/d0/36a49f0262d2319139d2829f773f1b97ef8aef7f97e6e5bd21455e5a8fb5/cryptography-46.0.7-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:84d4cced91f0f159a7ddacad249cc077e63195c36aac40b4150e7a57e84fffe7", size = 4270628, upload-time = "2026-04-08T01:57:12.885Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/6c/1a42450f464dda6ffbe578a911f773e54dd48c10f9895a23a7e88b3e7db5/cryptography-46.0.7-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:128c5edfe5e5938b86b03941e94fac9ee793a94452ad1365c9fc3f4f62216832", size = 4415405, upload-time = "2026-04-08T01:57:14.923Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/92/4ed714dbe93a066dc1f4b4581a464d2d7dbec9046f7c8b7016f5286329e2/cryptography-46.0.7-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:5e51be372b26ef4ba3de3c167cd3d1022934bc838ae9eaad7e644986d2a3d163", size = 4272715, upload-time = "2026-04-08T01:57:16.638Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/e6/a26b84096eddd51494bba19111f8fffe976f6a09f132706f8f1bf03f51f7/cryptography-46.0.7-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cdf1a610ef82abb396451862739e3fc93b071c844399e15b90726ef7470eeaf2", size = 4918400, upload-time = "2026-04-08T01:57:19.021Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/08/ffd537b605568a148543ac3c2b239708ae0bd635064bab41359252ef88ed/cryptography-46.0.7-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1d25aee46d0c6f1a501adcddb2d2fee4b979381346a78558ed13e50aa8a59067", size = 4450634, upload-time = "2026-04-08T01:57:21.185Z" },
+    { url = "https://files.pythonhosted.org/packages/16/01/0cd51dd86ab5b9befe0d031e276510491976c3a80e9f6e31810cce46c4ad/cryptography-46.0.7-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:cdfbe22376065ffcf8be74dc9a909f032df19bc58a699456a21712d6e5eabfd0", size = 3985233, upload-time = "2026-04-08T01:57:22.862Z" },
+    { url = "https://files.pythonhosted.org/packages/92/49/819d6ed3a7d9349c2939f81b500a738cb733ab62fbecdbc1e38e83d45e12/cryptography-46.0.7-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:abad9dac36cbf55de6eb49badd4016806b3165d396f64925bf2999bcb67837ba", size = 4271955, upload-time = "2026-04-08T01:57:24.814Z" },
+    { url = "https://files.pythonhosted.org/packages/80/07/ad9b3c56ebb95ed2473d46df0847357e01583f4c52a85754d1a55e29e4d0/cryptography-46.0.7-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:935ce7e3cfdb53e3536119a542b839bb94ec1ad081013e9ab9b7cfd478b05006", size = 4879888, upload-time = "2026-04-08T01:57:26.88Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/c7/201d3d58f30c4c2bdbe9b03844c291feb77c20511cc3586daf7edc12a47b/cryptography-46.0.7-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:35719dc79d4730d30f1c2b6474bd6acda36ae2dfae1e3c16f2051f215df33ce0", size = 4449961, upload-time = "2026-04-08T01:57:29.068Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/ef/649750cbf96f3033c3c976e112265c33906f8e462291a33d77f90356548c/cryptography-46.0.7-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7bbc6ccf49d05ac8f7d7b5e2e2c33830d4fe2061def88210a126d130d7f71a85", size = 4401696, upload-time = "2026-04-08T01:57:31.029Z" },
+    { url = "https://files.pythonhosted.org/packages/41/52/a8908dcb1a389a459a29008c29966c1d552588d4ae6d43f3a1a4512e0ebe/cryptography-46.0.7-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a1529d614f44b863a7b480c6d000fe93b59acee9c82ffa027cfadc77521a9f5e", size = 4664256, upload-time = "2026-04-08T01:57:33.144Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/fa/f0ab06238e899cc3fb332623f337a7364f36f4bb3f2534c2bb95a35b132c/cryptography-46.0.7-cp38-abi3-win32.whl", hash = "sha256:f247c8c1a1fb45e12586afbb436ef21ff1e80670b2861a90353d9b025583d246", size = 3013001, upload-time = "2026-04-08T01:57:34.933Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/f1/00ce3bde3ca542d1acd8f8cfa38e446840945aa6363f9b74746394b14127/cryptography-46.0.7-cp38-abi3-win_amd64.whl", hash = "sha256:506c4ff91eff4f82bdac7633318a526b1d1309fc07ca76a3ad182cb5b686d6d3", size = 3472985, upload-time = "2026-04-08T01:57:36.714Z" },
+]
+
+[[package]]
+name = "fable-mcp"
+version = "0.2.6"
+source = { editable = "." }
+dependencies = [
+    { name = "httpx" },
+    { name = "mcp", extra = ["cli"] },
+    { name = "python-dotenv" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+    { name = "respx" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "httpx", specifier = ">=0.27" },
+    { name = "mcp", extras = ["cli"], specifier = ">=1.0" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0" },
+    { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23" },
+    { name = "python-dotenv", specifier = ">=1.0" },
+    { name = "respx", marker = "extra == 'dev'", specifier = ">=0.21" },
+]
+provides-extras = ["dev"]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "httpx-sse"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mcp"
+version = "1.27.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "httpx" },
+    { name = "httpx-sse" },
+    { name = "jsonschema" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "pyjwt", extra = ["crypto"] },
+    { name = "python-multipart" },
+    { name = "pywin32", marker = "sys_platform == 'win32'" },
+    { name = "sse-starlette" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+    { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8b/eb/c0cfc62075dc6e1ec1c64d352ae09ac051d9334311ed226f1f425312848a/mcp-1.27.0.tar.gz", hash = "sha256:d3dc35a7eec0d458c1da4976a48f982097ddaab87e278c5511d5a4a56e852b83", size = 607509, upload-time = "2026-04-02T14:48:08.88Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9c/46/f6b4ad632c67ef35209a66127e4bddc95759649dd595f71f13fba11bdf9a/mcp-1.27.0-py3-none-any.whl", hash = "sha256:5ce1fa81614958e267b21fb2aa34e0aea8e2c6ede60d52aba45fd47246b4d741", size = 215967, upload-time = "2026-04-02T14:48:07.24Z" },
+]
+
+[package.optional-dependencies]
+cli = [
+    { name = "python-dotenv" },
+    { name = "typer" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pycparser"
+version = "3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1b/7d/92392ff7815c21062bea51aa7b87d45576f649f16458d78b7cf94b9ab2e6/pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29", size = 103492, upload-time = "2026-01-21T14:26:51.89Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992", size = 48172, upload-time = "2026-01-21T14:26:50.693Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
+    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
+    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
+    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
+    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
+    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
+    { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
+    { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
+    { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
+    { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
+    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.13.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/52/6d/fffca34caecc4a3f97bda81b2098da5e8ab7efc9a66e819074a11955d87e/pydantic_settings-2.13.1.tar.gz", hash = "sha256:b4c11847b15237fb0171e1462bf540e294affb9b86db4d9aa5c01730bdbe4025", size = 223826, upload-time = "2026-02-19T13:45:08.055Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/00/4b/ccc026168948fec4f7555b9164c724cf4125eac006e176541483d2c959be/pydantic_settings-2.13.1-py3-none-any.whl", hash = "sha256:d56fd801823dbeae7f0975e1f8c8e25c258eb75d278ea7abb5d9cebb01b56237", size = 58929, upload-time = "2026-02-19T13:45:06.034Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "pyjwt"
+version = "2.12.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c2/27/a3b6e5bf6ff856d2509292e95c8f57f0df7017cf5394921fc4e4ef40308a/pyjwt-2.12.1.tar.gz", hash = "sha256:c74a7a2adf861c04d002db713dd85f84beb242228e671280bf709d765b03672b", size = 102564, upload-time = "2026-03-13T19:27:37.25Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/7a/8dd906bd22e79e47397a61742927f6747fe93242ef86645ee9092e610244/pyjwt-2.12.1-py3-none-any.whl", hash = "sha256:28ca37c070cad8ba8cd9790cd940535d40274d22f80ab87f3ac6a713e6e8454c", size = 29726, upload-time = "2026-03-13T19:27:35.677Z" },
+]
+
+[package.optional-dependencies]
+crypto = [
+    { name = "cryptography" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/90/2c/8af215c0f776415f3590cac4f9086ccefd6fd463befeae41cd4d3f193e5a/pytest_asyncio-1.3.0.tar.gz", hash = "sha256:d7f52f36d231b80ee124cd216ffb19369aa168fc10095013c6b014a34d3ee9e5", size = 50087, upload-time = "2025-11-10T16:07:47.256Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45.537Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/ed/0301aeeac3e5353ef3d94b6ec08bbcabd04a72018415dcb29e588514bba8/python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3", size = 50135, upload-time = "2026-03-01T16:00:26.196Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
+]
+
+[[package]]
+name = "python-multipart"
+version = "0.0.26"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/71/b145a380824a960ebd60e1014256dbb7d2253f2316ff2d73dfd8928ec2c3/python_multipart-0.0.26.tar.gz", hash = "sha256:08fadc45918cd615e26846437f50c5d6d23304da32c341f289a617127b081f17", size = 43501, upload-time = "2026-04-10T14:09:59.473Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/22/f1925cdda983ab66fc8ec6ec8014b959262747e58bdca26a4e3d1da29d56/python_multipart-0.0.26-py3-none-any.whl", hash = "sha256:c0b169f8c4484c13b0dcf2ef0ec3a4adb255c4b7d18d8e420477d2b1dd03f185", size = 28847, upload-time = "2026-04-10T14:09:58.131Z" },
+]
+
+[[package]]
+name = "pywin32"
+version = "311"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/ab/01ea1943d4eba0f850c3c61e78e8dd59757ff815ff3ccd0a84de5f541f42/pywin32-311-cp312-cp312-win32.whl", hash = "sha256:750ec6e621af2b948540032557b10a2d43b0cee2ae9758c54154d711cc852d31", size = 8706543, upload-time = "2025-07-14T20:13:20.765Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/a8/a0e8d07d4d051ec7502cd58b291ec98dcc0c3fff027caad0470b72cfcc2f/pywin32-311-cp312-cp312-win_amd64.whl", hash = "sha256:b8c095edad5c211ff31c05223658e71bf7116daa0ecf3ad85f3201ea3190d067", size = 9495040, upload-time = "2025-07-14T20:13:22.543Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/3a/2ae996277b4b50f17d61f0603efd8253cb2d79cc7ae159468007b586396d/pywin32-311-cp312-cp312-win_arm64.whl", hash = "sha256:e286f46a9a39c4a18b319c28f59b61de793654af2f395c102b4f819e584b5852", size = 8710102, upload-time = "2025-07-14T20:13:24.682Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/be/3fd5de0979fcb3994bfee0d65ed8ca9506a8a1260651b86174f6a86f52b3/pywin32-311-cp313-cp313-win32.whl", hash = "sha256:f95ba5a847cba10dd8c4d8fefa9f2a6cf283b8b88ed6178fa8a6c1ab16054d0d", size = 8705700, upload-time = "2025-07-14T20:13:26.471Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/28/e0a1909523c6890208295a29e05c2adb2126364e289826c0a8bc7297bd5c/pywin32-311-cp313-cp313-win_amd64.whl", hash = "sha256:718a38f7e5b058e76aee1c56ddd06908116d35147e133427e59a3983f703a20d", size = 9494700, upload-time = "2025-07-14T20:13:28.243Z" },
+    { url = "https://files.pythonhosted.org/packages/04/bf/90339ac0f55726dce7d794e6d79a18a91265bdf3aa70b6b9ca52f35e022a/pywin32-311-cp313-cp313-win_arm64.whl", hash = "sha256:7b4075d959648406202d92a2310cb990fea19b535c7f4a78d3f5e10b926eeb8a", size = 8709318, upload-time = "2025-07-14T20:13:30.348Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/31/097f2e132c4f16d99a22bfb777e0fd88bd8e1c634304e102f313af69ace5/pywin32-311-cp314-cp314-win32.whl", hash = "sha256:b7a2c10b93f8986666d0c803ee19b5990885872a7de910fc460f9b0c2fbf92ee", size = 8840714, upload-time = "2025-07-14T20:13:32.449Z" },
+    { url = "https://files.pythonhosted.org/packages/90/4b/07c77d8ba0e01349358082713400435347df8426208171ce297da32c313d/pywin32-311-cp314-cp314-win_amd64.whl", hash = "sha256:3aca44c046bd2ed8c90de9cb8427f581c479e594e99b5c0bb19b29c10fd6cb87", size = 9656800, upload-time = "2025-07-14T20:13:34.312Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" },
+]
+
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
+[[package]]
+name = "respx"
+version = "0.23.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "httpx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/98/4e55c9c486404ec12373708d015ebce157966965a5ebe7f28ff2c784d41b/respx-0.23.1.tar.gz", hash = "sha256:242dcc6ce6b5b9bf621f5870c82a63997e8e82bc7c947f9ffe272b8f3dd5a780", size = 29243, upload-time = "2026-04-08T14:37:16.008Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1d/4a/221da6ca167db45693d8d26c7dc79ccfc978a440251bf6721c9aaf251ac0/respx-0.23.1-py2.py3-none-any.whl", hash = "sha256:b18004b029935384bccfa6d7d9d74b4ec9af73a081cc28600fffc0447f4b8c1a", size = 25557, upload-time = "2026-04-08T14:37:14.613Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.3.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/c6/f3b320c27991c46f43ee9d856302c70dc2d0fb2dba4842ff739d5f46b393/rich-14.3.3.tar.gz", hash = "sha256:b8daa0b9e4eef54dd8cf7c86c03713f53241884e814f4e2f5fb342fe520f639b", size = 230582, upload-time = "2026-02-19T17:23:12.474Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/25/b208c5683343959b670dc001595f2f3737e051da617f66c31f7c4fa93abc/rich-14.3.3-py3-none-any.whl", hash = "sha256:793431c1f8619afa7d3b52b2cdec859562b950ea0d4b6b505397612db8d5362d", size = 310458, upload-time = "2026-02-19T17:23:13.732Z" },
+]
+
+[[package]]
+name = "rpds-py"
+version = "0.30.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/03/e7/98a2f4ac921d82f33e03f3835f5bf3a4a40aa1bfdc57975e74a97b2b4bdd/rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad", size = 375086, upload-time = "2025-11-30T20:22:17.93Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a1/bca7fd3d452b272e13335db8d6b0b3ecde0f90ad6f16f3328c6fb150c889/rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05", size = 359053, upload-time = "2025-11-30T20:22:19.297Z" },
+    { url = "https://files.pythonhosted.org/packages/65/1c/ae157e83a6357eceff62ba7e52113e3ec4834a84cfe07fa4b0757a7d105f/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28", size = 390763, upload-time = "2025-11-30T20:22:21.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/36/eb2eb8515e2ad24c0bd43c3ee9cd74c33f7ca6430755ccdb240fd3144c44/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd", size = 408951, upload-time = "2025-11-30T20:22:23.408Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/65/ad8dc1784a331fabbd740ef6f71ce2198c7ed0890dab595adb9ea2d775a1/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f", size = 514622, upload-time = "2025-11-30T20:22:25.16Z" },
+    { url = "https://files.pythonhosted.org/packages/63/8e/0cfa7ae158e15e143fe03993b5bcd743a59f541f5952e1546b1ac1b5fd45/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1", size = 414492, upload-time = "2025-11-30T20:22:26.505Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1b/6f8f29f3f995c7ffdde46a626ddccd7c63aefc0efae881dc13b6e5d5bb16/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23", size = 394080, upload-time = "2025-11-30T20:22:27.934Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/d5/a266341051a7a3ca2f4b750a3aa4abc986378431fc2da508c5034d081b70/rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6", size = 408680, upload-time = "2025-11-30T20:22:29.341Z" },
+    { url = "https://files.pythonhosted.org/packages/10/3b/71b725851df9ab7a7a4e33cf36d241933da66040d195a84781f49c50490c/rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51", size = 423589, upload-time = "2025-11-30T20:22:31.469Z" },
+    { url = "https://files.pythonhosted.org/packages/00/2b/e59e58c544dc9bd8bd8384ecdb8ea91f6727f0e37a7131baeff8d6f51661/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5", size = 573289, upload-time = "2025-11-30T20:22:32.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/3e/a18e6f5b460893172a7d6a680e86d3b6bc87a54c1f0b03446a3c8c7b588f/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e", size = 599737, upload-time = "2025-11-30T20:22:34.419Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e2/714694e4b87b85a18e2c243614974413c60aa107fd815b8cbc42b873d1d7/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394", size = 563120, upload-time = "2025-11-30T20:22:35.903Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
+    { url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
+    { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
+    { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
+    { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
+    { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
+    { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
+    { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
+    { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
+    { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
+    { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
+    { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
+    { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
+    { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
+    { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
+    { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
+    { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
+    { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
+    { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
+    { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
+    { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
+    { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "sse-starlette"
+version = "3.3.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "starlette" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/26/8c/f9290339ef6d79badbc010f067cd769d6601ec11a57d78569c683fb4dd87/sse_starlette-3.3.4.tar.gz", hash = "sha256:aaf92fc067af8a5427192895ac028e947b484ac01edbc3caf00e7e7137c7bef1", size = 32427, upload-time = "2026-03-29T09:00:23.307Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f8/7f/3de5402f39890ac5660b86bcf5c03f9d855dad5c4ed764866d7b592b46fd/sse_starlette-3.3.4-py3-none-any.whl", hash = "sha256:84bb06e58939a8b38d8341f1bc9792f06c2b53f48c608dd207582b664fc8f3c1", size = 14330, upload-time = "2026-03-29T09:00:21.846Z" },
+]
+
+[[package]]
+name = "starlette"
+version = "1.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/81/69/17425771797c36cded50b7fe44e850315d039f28b15901ab44839e70b593/starlette-1.0.0.tar.gz", hash = "sha256:6a4beaf1f81bb472fd19ea9b918b50dc3a77a6f2e190a12954b25e6ed5eea149", size = 2655289, upload-time = "2026-03-22T18:29:46.779Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/c9/584bc9651441b4ba60cc4d557d8a547b5aff901af35bda3a4ee30c819b82/starlette-1.0.0-py3-none-any.whl", hash = "sha256:d3ec55e0bb321692d275455ddfd3df75fff145d009685eb40dc91fc66b03d38b", size = 72651, upload-time = "2026-03-22T18:29:45.111Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.24.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "click" },
+    { name = "rich" },
+    { name = "shellingham" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/24/cb09efec5cc954f7f9b930bf8279447d24618bb6758d4f6adf2574c41780/typer-0.24.1.tar.gz", hash = "sha256:e39b4732d65fbdcde189ae76cf7cd48aeae72919dea1fdfc16593be016256b45", size = 118613, upload-time = "2026-02-21T16:54:40.609Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4a/91/48db081e7a63bb37284f9fbcefda7c44c277b18b0e13fbc36ea2335b71e6/typer-0.24.1-py3-none-any.whl", hash = "sha256:112c1f0ce578bfb4cab9ffdabc68f031416ebcc216536611ba21f04e9aa84c9e", size = 56085, upload-time = "2026-02-21T16:54:41.616Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "uvicorn"
+version = "0.44.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5e/da/6eee1ff8b6cbeed47eeb5229749168e81eb4b7b999a1a15a7176e51410c9/uvicorn-0.44.0.tar.gz", hash = "sha256:6c942071b68f07e178264b9152f1f16dfac5da85880c4ce06366a96d70d4f31e", size = 86947, upload-time = "2026-04-06T09:23:22.826Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/23/a5bbd9600dd607411fa644c06ff4951bec3a4d82c4b852374024359c19c0/uvicorn-0.44.0-py3-none-any.whl", hash = "sha256:ce937c99a2cc70279556967274414c087888e8cec9f9c94644dfca11bd3ced89", size = 69425, upload-time = "2026-04-06T09:23:21.524Z" },
+]

frontend/index.html

@@ -9,8 +9,8 @@
     <meta name="mobile-web-app-capable" content="yes">
     <meta name="apple-mobile-web-app-capable" content="yes">
     <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
-    <meta name="apple-mobile-web-app-title" content="Fabled">
-    <title>Fabled Assistant</title>
+    <meta name="apple-mobile-web-app-title" content="Scribe">
+    <title>Fabled Scribe</title>
   </head>
   <body>
     <div id="app"></div>

frontend/package.json

@@ -14,6 +14,7 @@
     "@fullcalendar/interaction": "^6.1.20",
     "@fullcalendar/timegrid": "^6.1.20",
     "@fullcalendar/vue3": "^6.1.20",
+    "@ricky0123/vad-web": "^0.0.30",
     "@tiptap/core": "^3.0.0",
     "@tiptap/extension-link": "^3.0.0",
     "@tiptap/extension-list": "^3.0.0",
@@ -35,6 +36,7 @@
     "@vitejs/plugin-vue": "^6.0.0",
     "typescript": "~5.9.0",
     "vite": "^7.0.0",
+    "vite-plugin-static-copy": "^4.0.1",
     "vue-tsc": "^3.0.0"
   }
 }

frontend/public/manifest.json

@@ -1,6 +1,6 @@
 {
-  "name": "Fabled Assistant",
-  "short_name": "Fabled",
+  "name": "Fabled Scribe",
+  "short_name": "Scribe",
   "description": "Your self-hosted second brain with AI assistance",
   "start_url": "/",
   "display": "standalone",

frontend/public/sw.js

@@ -12,7 +12,7 @@ self.addEventListener('push', event => {
           return;
         }
       }
-      return self.registration.showNotification(data.title || 'Fabled Assistant', {
+      return self.registration.showNotification(data.title || 'Scribe', {
         body: data.body || '',
         icon: '/favicon.ico',
         badge: '/favicon.ico',

frontend/src/App.vue

@@ -5,6 +5,7 @@ import AppHeader from "@/components/AppHeader.vue";
 import ToastNotification from "@/components/ToastNotification.vue";
 import { useTheme } from "@/composables/useTheme";
 import { useShortcuts } from "@/composables/useShortcuts";
+import { useOnnxPreloader } from "@/composables/useOnnxPreloader";
 import { useAuthStore } from "@/stores/auth";
 import { useChatStore } from "@/stores/chat";
 import { useSettingsStore } from "@/stores/settings";
@@ -12,6 +13,9 @@ import { apiGet, apiPut } from "@/api/client";
 
 useTheme();
 
+const { schedulePreload: scheduleVadPreload } = useOnnxPreloader();
+scheduleVadPreload();
+
 const router = useRouter();
 const appVersion = ref("dev");
 const authStore = useAuthStore();

frontend/src/api/client.ts

@@ -300,139 +300,124 @@ export function apiSSEStream(
 }
 
 // ---------------------------------------------------------------------------
-// Briefing
+// Journal
 // ---------------------------------------------------------------------------
 
-export interface BriefingLocation {
+export interface JournalLocation {
   label: string;
   address: string;
   lat?: number;
   lon?: number;
 }
 
-export interface BriefingSlots {
-  compilation: boolean;
-  morning: boolean;
-  midday: boolean;
-  afternoon: boolean;
+export interface JournalConfig {
+  prep_enabled: boolean;
+  prep_hour: number;
+  prep_minute: number;
+  day_rollover_hour: number;
+  morning_end_hour?: number;
+  midday_end_hour?: number;
+  // Ambient-context fields (carried forward from the briefing config schema)
+  locations?: { home?: JournalLocation; work?: JournalLocation };
+  temp_unit?: 'C' | 'F';
+  use_caldav_event_locations?: boolean;
+  enabled?: boolean;
+  [key: string]: unknown;
 }
 
-export interface BriefingConfig {
-  enabled: boolean;
-  locations: {
-    home?: BriefingLocation;
-    work?: BriefingLocation;
-  };
-  use_caldav_event_locations: boolean;
-  work_days: number[];
-  slots: BriefingSlots;
-  notifications: boolean;
-  temp_unit: 'C' | 'F';
-}
 
-export interface BriefingFeed {
+export interface JournalConversation {
   id: number;
   title: string;
-  url: string;
-  category: string | null;
-  last_fetched_at: string | null;
-}
-
-export interface BriefingConversation {
-  id: number;
-  title: string;
-  briefing_date: string | null;
+  model: string;
+  conversation_type: string;
+  day_date: string | null;
+  rag_project_id: number | null;
   message_count: number;
   created_at: string;
+  updated_at: string;
 }
 
-export interface BriefingMessage {
+export interface JournalMessage {
   id: number;
+  conversation_id: number;
   role: 'user' | 'assistant' | 'system';
   content: string;
+  status: string;
+  context_note_id: number | null;
+  tool_calls: unknown[] | null;
+  metadata: Record<string, unknown> | null;
   created_at: string;
-  metadata?: Record<string, unknown> | null;
 }
 
-const DEFAULT_BRIEFING_CONFIG: BriefingConfig = {
-  enabled: false,
-  locations: {},
-  use_caldav_event_locations: false,
-  work_days: [1, 2, 3, 4, 5],
-  slots: { compilation: true, morning: true, midday: false, afternoon: false },
-  notifications: true,
-  temp_unit: 'C',
-};
-
-export async function getBriefingConfig(): Promise<BriefingConfig> {
-  try {
-    const data = await apiGet<BriefingConfig>('/api/briefing/config');
-    return { ...DEFAULT_BRIEFING_CONFIG, ...data };
-  } catch {
-    return { ...DEFAULT_BRIEFING_CONFIG };
-  }
+export interface JournalDayPayload {
+  day_date: string;
+  conversation: JournalConversation | null;
+  messages: JournalMessage[];
 }
 
-export async function saveBriefingConfig(config: BriefingConfig): Promise<void> {
-  await apiPut('/api/briefing/config', config);
+export interface JournalMoment {
+  id: number;
+  user_id: number;
+  conversation_id: number | null;
+  source_message_id: number | null;
+  day_date: string;
+  occurred_at: string;
+  recorded_at: string;
+  content: string;
+  raw_excerpt: string | null;
+  tags: string[];
+  pinned: boolean;
+  people: { id: number; title: string }[];
+  places: { id: number; title: string }[];
+  task_ids: number[];
+  note_ids: number[];
+  score?: number;
 }
 
-export async function getBriefingFeeds(): Promise<BriefingFeed[]> {
-  const data = await apiGet<BriefingFeed[]>('/api/briefing/feeds');
-  return data;
+export async function getJournalConfig(): Promise<JournalConfig> {
+  return apiGet<JournalConfig>('/api/journal/config');
 }
 
-export async function createBriefingFeed(url: string, category?: string): Promise<BriefingFeed> {
-  const body: Record<string, string> = { url };
-  if (category?.trim()) body.category = category.trim();
-  const data = await apiPost<{ id: number; url: string; title: string; category: string | null }>('/api/briefing/feeds', body);
-  return { ...data, last_fetched_at: null };
+export async function saveJournalConfig(config: JournalConfig): Promise<void> {
+  await apiPut('/api/journal/config', config);
 }
 
-export async function refreshBriefingFeeds(): Promise<{ feeds_refreshed: number; new_items: number }> {
-  return apiPost('/api/briefing/feeds/refresh', {});
+export async function getJournalToday(): Promise<JournalDayPayload> {
+  return apiGet<JournalDayPayload>('/api/journal/today');
 }
 
-export async function deleteBriefingFeed(id: number): Promise<void> {
-  await apiDelete(`/api/briefing/feeds/${id}`);
+export async function getJournalDay(isoDate: string): Promise<JournalDayPayload> {
+  return apiGet<JournalDayPayload>(`/api/journal/day/${isoDate}`);
 }
 
-export async function getBriefingConversations(): Promise<BriefingConversation[]> {
-  const data = await apiGet<{ conversations: BriefingConversation[] }>('/api/briefing/conversations');
-  return data.conversations;
+export async function getJournalDays(): Promise<string[]> {
+  const data = await apiGet<{ days: string[] }>('/api/journal/days');
+  return data.days;
 }
 
-export async function getBriefingToday(): Promise<{ id: number; title: string; messages: BriefingMessage[] }> {
-  return apiGet('/api/briefing/conversations/today');
+export async function triggerJournalPrep(date?: string): Promise<{ ok: boolean; message_id: number }> {
+  return apiPost('/api/journal/trigger-prep', date ? { date } : {});
 }
 
-export async function getBriefingConvMessages(id: number): Promise<BriefingMessage[]> {
-  const data = await apiGet<{ messages: BriefingMessage[] }>(`/api/briefing/conversations/${id}/messages`);
-  return data.messages;
+export async function listJournalMoments(params: Record<string, string | number | boolean> = {}): Promise<JournalMoment[]> {
+  const qs = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) qs.set(k, String(v));
+  const data = await apiGet<{ moments: JournalMoment[] }>(`/api/journal/moments?${qs}`);
+  return data.moments;
 }
 
-export async function triggerBriefingSlot(slot: string): Promise<void> {
-  await apiPost('/api/briefing/trigger', { slot });
+export async function updateJournalMoment(id: number, patch: Partial<JournalMoment>): Promise<JournalMoment> {
+  return apiPatch<JournalMoment>(`/api/journal/moments/${id}`, patch);
 }
 
-export async function postRssReaction(
-  rssItemId: number,
-  reaction: 'up' | 'down'
-): Promise<{ ok: boolean; action: string }> {
-  return apiPost('/api/briefing/rss-reactions', { rss_item_id: rssItemId, reaction });
-}
-
-export async function deleteRssReaction(rssItemId: number): Promise<void> {
-  return apiDelete(`/api/briefing/rss-reactions/${rssItemId}`);
-}
-
-export async function openArticleInChat(itemId: number): Promise<{ conversation_id: number }> {
-  return apiPost(`/api/chat/from-article/${itemId}`, {});
+export async function deleteJournalMoment(id: number): Promise<void> {
+  await apiDelete(`/api/journal/moments/${id}`);
 }
 
 export async function geocodeAddress(address: string): Promise<{ lat: number; lon: number; display_name: string } | null> {
   try {
-    const r = await apiPost<{ lat: number; lon: number; label: string }>('/api/briefing/weather/geocode', { query: address });
+    const r = await apiPost<{ lat: number; lon: number; label: string }>('/api/journal/weather/geocode', { query: address });
     return { lat: r.lat, lon: r.lon, display_name: r.label };
   } catch {
     return null;

frontend/src/assets/theme.css

@@ -54,6 +54,8 @@
   --page-max-width: 1200px;
   --page-padding-x: 1rem;
   --sidebar-width: 260px;
+  --chat-reading-width: min(1200px, 100%);
+  --chat-context-sidebar-width: 220px;
   --color-accent-warm: #b8860b;
   --color-accent-warm-light: #d4a017;
   --color-primary-solid: #7c3aed;

frontend/src/components/AppHeader.vue

@@ -16,7 +16,7 @@ const router = useRouter();
 const route = useRoute();
 
 const isChatActive = computed(() => route.path.startsWith("/chat"))
-const isKnowledgeActive = computed(() => route.path === "/" || route.path === "/knowledge");
+const isKnowledgeActive = computed(() => route.path === "/knowledge");
 
 const mobileMenuOpen = ref(false);
 
@@ -74,11 +74,10 @@ router.afterEach(() => {
       <!-- Center: primary navigation (desktop) -->
       <div class="nav-center">
         <div class="nav-pill-bar">
-          <router-link to="/" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
+          <router-link to="/knowledge" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
           <router-link to="/chat" :class="['nav-link', { 'router-link-active': isChatActive }]">Chat</router-link>
-          <router-link to="/briefing" class="nav-link">Briefing</router-link>
+          <router-link to="/journal" class="nav-link">Journal</router-link>
           <router-link to="/calendar" class="nav-link">Calendar</router-link>
-          <router-link to="/news" class="nav-link">News</router-link>
           <router-link to="/projects" class="nav-link">Projects</router-link>
         </div>
       </div>
@@ -123,12 +122,11 @@ router.afterEach(() => {
 
     <!-- Mobile dropdown -->
     <div v-if="mobileMenuOpen" class="mobile-menu">
-      <router-link to="/" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
+      <router-link to="/knowledge" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
       <router-link to="/chat" :class="['nav-link', { 'router-link-active': isChatActive }]">Chat</router-link>
-      <router-link to="/briefing" class="nav-link">Briefing</router-link>
+      <router-link to="/journal" class="nav-link">Journal</router-link>
       <router-link to="/calendar" class="nav-link">Calendar</router-link>
       <router-link to="/projects" class="nav-link">Projects</router-link>
-      <router-link to="/news" class="nav-link">News</router-link>
       <router-link to="/shared" class="nav-link">Shared</router-link>
       <div class="mobile-divider"></div>
       <router-link to="/settings" class="nav-link">Settings</router-link>

frontend/src/components/BriefingSetupWizard.vue

@@ -1,413 +0,0 @@
-<script setup lang="ts">
-import { ref, reactive } from 'vue'
-import {
-  saveBriefingConfig,
-  geocodeAddress,
-  createBriefingFeed,
-  type BriefingConfig,
-} from '@/api/client'
-
-const emit = defineEmits<{ done: [] }>()
-
-const step = ref(1)
-const TOTAL_STEPS = 4
-
-const config = reactive<BriefingConfig>({
-  enabled: true,
-  locations: {},
-  use_caldav_event_locations: false,
-  work_days: [1, 2, 3, 4, 5],
-  slots: { compilation: true, morning: true, midday: false, afternoon: false },
-  notifications: true,
-  temp_unit: 'C',
-})
-
-// Step 2 — locations
-const homeAddress = ref('')
-const workAddress = ref('')
-const geocodingHome = ref(false)
-const geocodingWork = ref(false)
-const homeConfirmed = ref<string | null>(null)
-const workConfirmed = ref<string | null>(null)
-const homeError = ref('')
-const workError = ref('')
-
-async function lookupHome() {
-  if (!homeAddress.value.trim()) return
-  geocodingHome.value = true
-  homeError.value = ''
-  try {
-    const r = await geocodeAddress(homeAddress.value.trim())
-    if (r) {
-      config.locations.home = { label: 'Home', address: homeAddress.value.trim(), lat: r.lat, lon: r.lon }
-      homeConfirmed.value = r.display_name
-    } else {
-      homeError.value = 'Location not found'
-    }
-  } finally {
-    geocodingHome.value = false
-  }
-}
-
-async function lookupWork() {
-  if (!workAddress.value.trim()) return
-  geocodingWork.value = true
-  workError.value = ''
-  try {
-    const r = await geocodeAddress(workAddress.value.trim())
-    if (r) {
-      config.locations.work = { label: 'Work', address: workAddress.value.trim(), lat: r.lat, lon: r.lon }
-      workConfirmed.value = r.display_name
-    } else {
-      workError.value = 'Location not found'
-    }
-  } finally {
-    geocodingWork.value = false
-  }
-}
-
-// Step 3 — work days
-function toggleDay(d: number) {
-  const idx = config.work_days.indexOf(d)
-  if (idx === -1) config.work_days.push(d)
-  else config.work_days.splice(idx, 1)
-  config.work_days.sort()
-}
-
-// Step 4 — RSS feeds
-const newFeedUrl = ref('')
-const pendingFeeds = ref<Array<{ url: string }>>([])
-
-function addPendingFeed() {
-  if (!newFeedUrl.value.trim()) return
-  pendingFeeds.value.push({ url: newFeedUrl.value.trim() })
-  newFeedUrl.value = ''
-}
-function removePendingFeed(i: number) { pendingFeeds.value.splice(i, 1) }
-
-// Finish
-const finishing = ref(false)
-async function finish() {
-  finishing.value = true
-  try {
-    await saveBriefingConfig(config)
-    for (const f of pendingFeeds.value) {
-      try { await createBriefingFeed(f.url) } catch { /* best-effort */ }
-    }
-    emit('done')
-  } finally {
-    finishing.value = false
-  }
-}
-</script>
-
-<template>
-  <Teleport to="body">
-    <div class="wizard-overlay">
-      <div class="wizard-card" role="dialog" aria-label="Briefing Setup">
-        <!-- Progress bar -->
-        <div class="wizard-progress">
-          <div class="wizard-progress-fill" :style="{ width: `${(step / TOTAL_STEPS) * 100}%` }"></div>
-        </div>
-        <div class="wizard-step-label">Step {{ step }} of {{ TOTAL_STEPS }}</div>
-
-        <!-- Step 1: Welcome -->
-        <div v-if="step === 1" class="wizard-body">
-          <h2 class="wizard-title">Good morning.</h2>
-          <p class="wizard-text">
-            The Briefing is a daily conversation that summarises your day — tasks, calendar,
-            weather, and news — and checks in a few times throughout the day.
-          </p>
-          <p class="wizard-text">
-            It learns from your responses over time and adapts to your schedule.
-            Let's take a minute to set it up.
-          </p>
-          <div class="wizard-actions">
-            <button class="btn-wizard-primary" @click="step = 2">Get started</button>
-          </div>
-        </div>
-
-        <!-- Step 2: Locations -->
-        <div v-else-if="step === 2" class="wizard-body">
-          <h2 class="wizard-title">Where are you?</h2>
-          <p class="wizard-text">
-            Enter your home and work addresses. The briefing uses these to fetch weather
-            for the right places. You can skip either one.
-          </p>
-
-          <div class="wizard-field">
-            <label class="wizard-label">Home address</label>
-            <div class="wizard-input-row">
-              <input v-model="homeAddress" class="wizard-input" placeholder="e.g. 123 Main St, Springfield" @keydown.enter="lookupHome" />
-              <button class="btn-wizard-secondary" @click="lookupHome" :disabled="geocodingHome">
-                {{ geocodingHome ? '…' : 'Look up' }}
-              </button>
-            </div>
-            <div v-if="homeConfirmed" class="wizard-confirmed">✓ {{ homeConfirmed }}</div>
-            <div v-if="homeError" class="wizard-error">{{ homeError }}</div>
-          </div>
-
-          <div class="wizard-field">
-            <label class="wizard-label">Work address</label>
-            <div class="wizard-input-row">
-              <input v-model="workAddress" class="wizard-input" placeholder="e.g. 456 Office Ave, Portland" @keydown.enter="lookupWork" />
-              <button class="btn-wizard-secondary" @click="lookupWork" :disabled="geocodingWork">
-                {{ geocodingWork ? '…' : 'Look up' }}
-              </button>
-            </div>
-            <div v-if="workConfirmed" class="wizard-confirmed">✓ {{ workConfirmed }}</div>
-            <div v-if="workError" class="wizard-error">{{ workError }}</div>
-          </div>
-
-          <div class="wizard-actions">
-            <button class="btn-wizard-ghost" @click="step = 1">Back</button>
-            <button class="btn-wizard-primary" @click="step = 3">Continue</button>
-          </div>
-        </div>
-
-        <!-- Step 3: Work schedule -->
-        <div v-else-if="step === 3" class="wizard-body">
-          <h2 class="wizard-title">When do you go to the office?</h2>
-          <p class="wizard-text">
-            The 8am slot is labelled "you're at the office" on days you have marked as office days.
-            Toggle any days you typically commute.
-          </p>
-
-          <div class="wizard-days">
-            <button
-              v-for="(day, idx) in ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']"
-              :key="idx"
-              :class="['wizard-day-btn', { active: config.work_days.includes(idx) }]"
-              @click="toggleDay(idx)"
-              type="button"
-            >{{ day }}</button>
-          </div>
-
-          <div class="wizard-actions">
-            <button class="btn-wizard-ghost" @click="step = 2">Back</button>
-            <button class="btn-wizard-primary" @click="step = 4">Continue</button>
-          </div>
-        </div>
-
-        <!-- Step 4: RSS feeds -->
-        <div v-else-if="step === 4" class="wizard-body">
-          <h2 class="wizard-title">What do you follow?</h2>
-          <p class="wizard-text">
-            Add RSS or Atom feeds and the briefing will summarise recent items each morning.
-            You can add or remove feeds any time in Settings.
-          </p>
-
-          <div v-if="pendingFeeds.length" class="wizard-feeds-list">
-            <div v-for="(f, i) in pendingFeeds" :key="i" class="wizard-feed-row">
-              <span class="wizard-feed-url">{{ f.url }}</span>
-              <button class="btn-wizard-remove" @click="removePendingFeed(i)">✕</button>
-            </div>
-          </div>
-
-          <div class="wizard-add-feed">
-            <input v-model="newFeedUrl" class="wizard-input" placeholder="https://…/feed.xml" style="flex: 1" />
-            <button class="btn-wizard-secondary" @click="addPendingFeed" :disabled="!newFeedUrl.trim()">Add</button>
-          </div>
-
-          <div class="wizard-actions" style="margin-top: 1.5rem">
-            <button class="btn-wizard-ghost" @click="step = 3">Back</button>
-            <button class="btn-wizard-ghost" @click="finish" :disabled="finishing">Skip</button>
-            <button class="btn-wizard-primary" @click="finish" :disabled="finishing">
-              {{ finishing ? 'Setting up…' : 'Enable Briefing' }}
-            </button>
-          </div>
-        </div>
-      </div>
-    </div>
-  </Teleport>
-</template>
-
-<style scoped>
-.wizard-overlay {
-  position: fixed;
-  inset: 0;
-  background: rgba(0, 0, 0, 0.6);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  z-index: 2000;
-}
-.wizard-card {
-  background: var(--color-bg-card);
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-lg, 18px);
-  width: 520px;
-  max-width: 94vw;
-  box-shadow: 0 24px 64px rgba(0, 0, 0, 0.4);
-  overflow: hidden;
-}
-.wizard-progress {
-  height: 3px;
-  background: var(--color-border);
-}
-.wizard-progress-fill {
-  height: 100%;
-  background: var(--gradient-cta);
-  transition: width 0.3s ease;
-}
-.wizard-step-label {
-  font-size: 0.72rem;
-  color: var(--color-text-muted);
-  text-align: right;
-  padding: 0.5rem 1.5rem 0;
-}
-.wizard-body {
-  padding: 1.5rem 2rem 2rem;
-}
-.wizard-title {
-  font-family: 'Fraunces', Georgia, serif;
-  font-size: 1.4rem;
-  font-weight: 700;
-  margin: 0 0 0.75rem;
-  color: var(--color-text);
-}
-.wizard-text {
-  font-size: 0.9rem;
-  color: var(--color-text-muted);
-  line-height: 1.6;
-  margin: 0 0 0.75rem;
-}
-.wizard-field {
-  margin-bottom: 1rem;
-}
-.wizard-label {
-  font-size: 0.82rem;
-  font-weight: 600;
-  color: var(--color-text-muted);
-  display: block;
-  margin-bottom: 0.3rem;
-}
-.wizard-input-row {
-  display: flex;
-  gap: 0.5rem;
-}
-.wizard-input {
-  flex: 1;
-  padding: 0.5rem 0.7rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text);
-  font-size: 0.9rem;
-  outline: none;
-  font-family: inherit;
-}
-.wizard-input:focus { border-color: var(--color-primary); }
-.wizard-confirmed {
-  font-size: 0.78rem;
-  color: var(--color-success, #22c55e);
-  margin-top: 0.25rem;
-}
-.wizard-error {
-  font-size: 0.78rem;
-  color: var(--color-danger, #ef4444);
-  margin-top: 0.25rem;
-}
-.wizard-days {
-  display: flex;
-  gap: 0.4rem;
-  flex-wrap: wrap;
-  margin: 1rem 0 1.5rem;
-}
-.wizard-day-btn {
-  padding: 0.4rem 0.8rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text-muted);
-  font-size: 0.85rem;
-  cursor: pointer;
-  transition: all 0.15s;
-  font-family: inherit;
-}
-.wizard-day-btn.active {
-  background: var(--color-primary);
-  border-color: var(--color-primary);
-  color: #fff;
-}
-.wizard-feeds-list {
-  margin-bottom: 0.75rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.3rem;
-}
-.wizard-feed-row {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  padding: 0.35rem 0.6rem;
-  background: var(--color-bg-secondary);
-  border-radius: 6px;
-}
-.wizard-feed-url {
-  flex: 1;
-  font-size: 0.82rem;
-  color: var(--color-text-muted);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.btn-wizard-remove {
-  background: none;
-  border: none;
-  color: var(--color-text-muted);
-  cursor: pointer;
-  font-size: 0.8rem;
-  padding: 0.15rem 0.3rem;
-  border-radius: 4px;
-}
-.btn-wizard-remove:hover { color: var(--color-danger, #ef4444); }
-.wizard-add-feed {
-  display: flex;
-  gap: 0.5rem;
-  flex-wrap: wrap;
-}
-.wizard-actions {
-  display: flex;
-  gap: 0.5rem;
-  justify-content: flex-end;
-  margin-top: 1.5rem;
-}
-.btn-wizard-primary {
-  padding: 0.5rem 1.25rem;
-  background: var(--gradient-cta);
-  color: #fff;
-  border: none;
-  border-radius: 8px;
-  font-size: 0.9rem;
-  font-weight: 600;
-  cursor: pointer;
-  transition: opacity 0.15s;
-  font-family: inherit;
-}
-.btn-wizard-primary:disabled { opacity: 0.5; cursor: not-allowed; }
-.btn-wizard-secondary {
-  padding: 0.5rem 0.9rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text);
-  font-size: 0.85rem;
-  cursor: pointer;
-  white-space: nowrap;
-  font-family: inherit;
-}
-.btn-wizard-secondary:disabled { opacity: 0.5; cursor: not-allowed; }
-.btn-wizard-ghost {
-  padding: 0.5rem 1rem;
-  border: none;
-  background: none;
-  color: var(--color-text-muted);
-  font-size: 0.85rem;
-  cursor: pointer;
-  border-radius: 6px;
-  font-family: inherit;
-}
-.btn-wizard-ghost:hover { background: var(--color-bg-secondary); }
-.btn-wizard-ghost:disabled { opacity: 0.5; cursor: not-allowed; }
-</style>

frontend/src/components/ChatInputBar.vue

@@ -1,8 +1,11 @@
 <script setup lang="ts">
-import { ref, computed, nextTick } from 'vue'
+import { ref, computed, nextTick, onMounted, onUnmounted, watch } from 'vue'
 import { apiGet, transcribeAudio } from '@/api/client'
 import { useVoiceRecorder } from '@/composables/useVoiceRecorder'
-import { useSilenceDetector } from '@/composables/useSilenceDetector'
+import { useVad } from '@/composables/useVad'
+import { useStreamingTts } from '@/composables/useStreamingTts'
+import { useVoiceAudio, setVoiceVolume } from '@/composables/useVoiceAudio'
+import { useListenMode } from '@/composables/useListenMode'
 import { useChatStore } from '@/stores/chat'
 import { useSettingsStore } from '@/stores/settings'
 import { useToastStore } from '@/stores/toast'
@@ -29,6 +32,32 @@ const emit = defineEmits<{
 const store = useChatStore()
 const settingsStore = useSettingsStore()
 const voiceEnabled = computed(() => settingsStore.voiceSttReady)
+const voiceTtsEnabled = computed(() => settingsStore.voiceTtsReady)
+
+// ── Streaming TTS (listen mode) ───────────────────────────────────────────────
+const listenMode = useListenMode()
+const audio = useVoiceAudio()
+const speakerPopoverOpen = ref(false)
+
+const tts = useStreamingTts({
+  streamingContent: computed(() => store.streamingContent),
+  streaming: computed(() => store.streaming),
+  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
+})
+
+function lastAssistantContent(): string {
+  const msgs = store.currentConversation?.messages ?? []
+  return [...msgs].reverse().find((m) => m.role === 'assistant')?.content ?? ''
+}
+
+function toggleListen() {
+  listenMode.value = !listenMode.value
+  if (listenMode.value) {
+    tts.speak(lastAssistantContent())
+  } else {
+    tts.stop()
+  }
+}
 
 // ── Core input ────────────────────────────────────────────────────────────────
 const messageInput = ref('')
@@ -109,15 +138,50 @@ function removeAttachedNote() {
   attachedNote.value = null
 }
 
-// ── Voice (click-to-toggle + silence detection) ─────────────────────────────
+// ── Voice (click-to-toggle + VAD speech detection) ─────────────────────────
 const transcribingVoice = ref(false)
 const recorder = useVoiceRecorder()
-const silenceDetector = useSilenceDetector()
+// Tracks whether VAD detected speech during the current recording session.
+// Used to skip the Whisper round-trip when the user manually stops without
+// ever speaking — the recording is ambient noise and will transcribe to "".
+const vadSawSpeech = ref(false)
+
+const vad = useVad({
+  onSpeechEnd: () => {
+    // VAD auto-stop: speech was detected and the user has paused. Proceed
+    // to transcribe the MediaRecorder output.
+    void stopRecording(false)
+  },
+  onNoSpeech: () => {
+    useToastStore().show('No speech detected', 'warning')
+  },
+  onVadError: (msg) => {
+    useToastStore().show(`VAD failed: ${msg}`, 'error')
+  },
+})
+
+// Live mic halo. A solid red disc sits behind the mic button and scales
+// with `vad.amplitude` (0..1 RMS, already amplified for visibility).
+const micGlowStyle = computed(() => {
+  if (!recorder.recording.value) return { display: 'none' }
+  const pulse = 0.2 + Math.min(vad.amplitude.value, 1) * 0.8
+  return {
+    transform: `translate(-50%, -50%) scale(${1 + pulse * 1.6})`,
+    opacity: String(0.45 + pulse * 0.4),
+  }
+})
+
+// vad.speaking flips true on speech-start. Watch it once per session to
+// capture that speech was detected at some point, without clearing when
+// speech ends. This drives the no-speech guard in stopRecording.
+watch(() => vad.speaking.value, (on) => {
+  if (on) vadSawSpeech.value = true
+})
 
 async function toggleVoice() {
   if (transcribingVoice.value) return
   if (recorder.recording.value) {
-    await stopRecording()
+    await stopRecording(true)
   } else {
     await startRecording()
   }
@@ -129,22 +193,32 @@ async function startRecording() {
     useToastStore().show('Microphone requires HTTPS or localhost', 'error')
     return
   }
+  vadSawSpeech.value = false
   await recorder.startRecording()
   if (recorder.error.value) {
     useToastStore().show(recorder.error.value, 'error')
     return
   }
   if (recorder.stream.value) {
-    silenceDetector.start(recorder.stream.value, () => stopRecording())
+    await vad.start(recorder.stream.value)
   }
 }
 
-async function stopRecording() {
-  silenceDetector.stop()
+async function stopRecording(manual: boolean) {
+  if (manual) {
+    await vad.stopAndCheck()
+  } else {
+    await vad.stop()
+  }
   if (!recorder.recording.value) return
   transcribingVoice.value = true
   try {
     const blob = await recorder.stopRecording()
+    // No-speech guard: user manually stopped without VAD seeing speech.
+    // Skip Whisper — the toast was already shown by onNoSpeech.
+    if (manual && !vadSawSpeech.value) {
+      return
+    }
     // Pass last assistant message as context to reduce STT mishearings
     const msgs = store.currentConversation?.messages ?? []
     const lastAssistant = [...msgs].reverse().find(m => m.role === 'assistant')?.content
@@ -159,6 +233,15 @@ async function stopRecording() {
   finally { transcribingVoice.value = false }
 }
 
+// ── Click-outside to dismiss speaker popover ──────────────────────────────────
+function onDocumentMousedown(e: MouseEvent) {
+  if (!speakerPopoverOpen.value) return
+  const target = e.target as HTMLElement | null
+  if (!target?.closest('.speaker-wrapper')) speakerPopoverOpen.value = false
+}
+onMounted(() => document.addEventListener('mousedown', onDocumentMousedown))
+onUnmounted(() => document.removeEventListener('mousedown', onDocumentMousedown))
+
 // ── Exposed interface ─────────────────────────────────────────────────────────
 function focus() {
   inputEl.value?.focus()
@@ -230,23 +313,72 @@ defineExpose({ focus, prefill })
         class="input-textarea"
       ></textarea>
 
-      <!-- PTT mic -->
-      <button
-        v-if="voiceEnabled"
-        class="btn-icon btn-mic"
-        :class="{ 'mic-recording': recorder.recording.value, 'mic-transcribing': transcribingVoice }"
-        @click.prevent="toggleVoice"
-        :disabled="transcribingVoice || !store.chatReady"
-        :title="recorder.recording.value ? 'Click to stop (or wait for silence)' : 'Click to speak'"
-        :aria-label="recorder.recording.value ? 'Stop recording' : 'Start recording'"
-      >
+      <!-- Speaker / listen-mode popover -->
+      <div v-if="voiceTtsEnabled" class="speaker-wrapper">
+        <button
+          class="btn-icon btn-speaker"
+          :class="{ 'speaker-active': listenMode, 'speaker-busy': tts.speaking.value }"
+          @click="speakerPopoverOpen = !speakerPopoverOpen"
+          :title="listenMode ? 'Listen mode on' : 'Listen / volume'"
+          aria-label="Listen and volume settings"
+        >
+          <svg v-if="!tts.speaking.value" width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
+            <path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.85-5 6.71v2.06c4.01-.91 7-4.49 7-8.77s-2.99-7.86-7-8.77z"/>
+          </svg>
+          <svg v-else width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
+            <path d="M18 12c0-1.77-1.02-3.29-2.5-4.03v2.21l2.45 2.45c.03-.2.05-.41.05-.63zm2.5 0c0 .94-.2 1.82-.54 2.64l1.51 1.51C21.8 14.82 22 13.43 22 12c0-4.28-2.99-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71zM4.27 3L3 4.27 7.73 9H3v6h4l5 5v-6.73l4.25 4.25c-.67.52-1.42.93-2.25 1.18v2.06c1.38-.31 2.63-.95 3.69-1.81L19.73 21 21 19.73l-9-9L4.27 3zM12 4L9.91 6.09 12 8.18V4z"/>
+          </svg>
+        </button>
+        <div v-if="speakerPopoverOpen" class="speaker-popover">
+          <button
+            class="speaker-row speaker-row--toggle"
+            :class="{ 'speaker-row--active': listenMode }"
+            @click="toggleListen"
+          >
+            <span class="speaker-row-label">{{ listenMode ? 'Listening' : 'Read aloud' }}</span>
+            <span class="speaker-switch" :class="{ on: listenMode }"></span>
+          </button>
+          <div class="speaker-row">
+            <span class="speaker-row-label">Volume</span>
+            <input
+              type="range" min="0" max="1" step="0.05"
+              :value="audio.volume.value"
+              @input="setVoiceVolume(+($event.target as HTMLInputElement).value)"
+              class="speaker-volume-range"
+              aria-label="Volume"
+            />
+            <span class="speaker-volume-pct">{{ Math.round(audio.volume.value * 100) }}%</span>
+          </div>
+          <button
+            v-if="tts.speaking.value"
+            class="speaker-row speaker-row--stop"
+            @click="tts.stop()"
+          >
+            <svg width="12" height="12" viewBox="0 0 14 14" fill="currentColor"><rect width="14" height="14" rx="2"/></svg>
+            <span>Stop playback</span>
+          </button>
+        </div>
+      </div>
+
+      <!-- PTT mic (with live amplitude halo behind) -->
+      <div v-if="voiceEnabled" class="mic-wrapper">
+        <div class="mic-glow" :style="micGlowStyle" aria-hidden="true"></div>
+        <button
+          class="btn-icon btn-mic"
+          :class="{ 'mic-recording': recorder.recording.value, 'mic-transcribing': transcribingVoice }"
+          @click.prevent="toggleVoice"
+          :disabled="transcribingVoice || !store.chatReady"
+          :title="recorder.recording.value ? 'Click to stop (or wait for silence)' : 'Click to speak'"
+          :aria-label="recorder.recording.value ? 'Stop recording' : 'Start recording'"
+        >
         <svg v-if="!transcribingVoice" width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
           <path d="M12 14c1.66 0 3-1.34 3-3V5c0-1.66-1.34-3-3-3S9 3.34 9 5v6c0 1.66 1.34 3 3 3zm-1-9c0-.55.45-1 1-1s1 .45 1 1v6c0 .55-.45 1-1 1s-1-.45-1-1V5zm6 6c0 2.76-2.24 5-5 5s-5-2.24-5-5H5c0 3.53 2.61 6.43 6 6.92V21h2v-3.08c3.39-.49 6-3.39 6-6.92h-2z"/>
         </svg>
         <svg v-else width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
           <circle cx="12" cy="12" r="8" opacity="0.35"/><circle cx="12" cy="12" r="4"/>
         </svg>
-      </button>
+        </button>
+      </div>
 
       <!-- Abort (streaming) or Send -->
       <button
@@ -343,9 +475,50 @@ defineExpose({ focus, prefill })
 .btn-icon:hover { opacity: 1; }
 .btn-icon:disabled { opacity: 0.3; cursor: default; }
 
-.btn-mic.mic-recording { opacity: 1; color: #ef4444; }
+.btn-mic.mic-recording {
+  opacity: 1;
+  /* White icon sits on top of the red halo so it stays legible at any
+     pulse size. */
+  color: #fff;
+  position: relative;
+  z-index: 1;
+}
 .btn-mic.mic-transcribing { opacity: 0.5; }
 
+/* Mic wrapper + live amplitude halo. The glow is a filled red disc
+   absolutely positioned behind the button, scaled/faded by the
+   computed `micGlowStyle` so the user gets unmistakable feedback
+   that their voice is being picked up while the mic icon itself
+   stays put and readable on top. */
+.mic-wrapper {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+.mic-glow {
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  width: 28px;
+  height: 28px;
+  border-radius: 50%;
+  background: radial-gradient(
+    circle,
+    rgba(239, 68, 68, 0.9) 0%,
+    rgba(239, 68, 68, 0.6) 55%,
+    rgba(239, 68, 68, 0) 100%
+  );
+  transform: translate(-50%, -50%) scale(1);
+  transform-origin: center;
+  pointer-events: none;
+  /* Smooth between amplitude samples (~100ms) so the pulse feels continuous
+     rather than stepping. */
+  transition: transform 0.12s ease-out, opacity 0.12s ease-out;
+  z-index: 0;
+}
+
 .note-picker-wrapper { position: relative; }
 .note-picker-dropdown {
   position: absolute;
@@ -418,4 +591,77 @@ defineExpose({ focus, prefill })
   flex-shrink: 0;
 }
 .btn-abort-inline:hover { border-color: #ef4444; color: #ef4444; }
+
+/* Speaker / listen-mode popover */
+.speaker-wrapper { position: relative; display: inline-flex; flex-shrink: 0; }
+.btn-speaker.speaker-active { opacity: 1; color: var(--color-primary); }
+.btn-speaker.speaker-busy { opacity: 1; color: #f59e0b; }
+.speaker-popover {
+  position: absolute;
+  bottom: calc(100% + 8px);
+  right: 0;
+  min-width: 220px;
+  background: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  box-shadow: 0 4px 16px var(--color-shadow);
+  padding: 0.35rem;
+  z-index: 30;
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+}
+.speaker-row {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  padding: 0.45rem 0.6rem;
+  background: none;
+  border: none;
+  border-radius: var(--radius-sm);
+  color: var(--color-text);
+  font-size: 0.85rem;
+  cursor: default;
+  text-align: left;
+  width: 100%;
+}
+.speaker-row--toggle { cursor: pointer; }
+.speaker-row--toggle:hover { background: var(--color-bg-secondary); }
+.speaker-row--active { color: var(--color-primary); }
+.speaker-row--stop {
+  cursor: pointer;
+  color: var(--color-text-muted);
+  justify-content: flex-start;
+}
+.speaker-row--stop:hover { color: #ef4444; background: var(--color-bg-secondary); }
+.speaker-row-label { flex: 1; }
+.speaker-volume-range { flex: 1; min-width: 0; }
+.speaker-volume-pct {
+  font-size: 0.75rem;
+  color: var(--color-text-muted);
+  min-width: 2.5rem;
+  text-align: right;
+}
+.speaker-switch {
+  position: relative;
+  width: 28px;
+  height: 16px;
+  border-radius: 9999px;
+  background: var(--color-border);
+  transition: background 0.15s;
+  flex-shrink: 0;
+}
+.speaker-switch::after {
+  content: '';
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  width: 12px;
+  height: 12px;
+  border-radius: 50%;
+  background: var(--color-bg-card);
+  transition: transform 0.15s;
+}
+.speaker-switch.on { background: var(--color-primary); }
+.speaker-switch.on::after { transform: translateX(12px); }
 </style>

frontend/src/components/ChatMessage.vue

@@ -41,6 +41,16 @@ function formatMs(ms: number | null | undefined): string {
   return `${(ms / 1000).toFixed(1)}s`;
 }
 
+const metadata = computed(() => (props.message.metadata ?? {}) as Record<string, unknown>);
+
+// Hide LEGACY system-role daily_prep messages from earlier versions. The
+// current journal prep is a normal assistant message (renders with proper
+// bubble styling). Old system-role rows lurking in existing conversations
+// would render as a flat unstyled block — filter them.
+const hideMessage = computed(() =>
+  props.message.role === "system" && metadata.value.kind === "daily_prep"
+);
+
 const timingParts = computed((): string[] => {
   const t = props.message.timing;
   if (!t) return [];
@@ -57,7 +67,7 @@ const timingParts = computed((): string[] => {
 </script>
 
 <template>
-  <div class="chat-message" :class="`role-${message.role}`">
+  <div v-if="!hideMessage" class="chat-message" :class="`role-${message.role}`">
     <div class="message-group">
       <div class="message-bubble">
         <div class="message-header">
@@ -281,4 +291,5 @@ details[open] .thinking-summary::before {
   margin-right: 0.2rem;
   opacity: 0.5;
 }
+
 </style>

frontend/src/components/ChatPanel.vue

@@ -1,11 +1,6 @@
 <script setup lang="ts">
-import { ref, computed, watch, nextTick, onMounted } from 'vue'
+import { ref, computed, watch, nextTick, onMounted, onUnmounted } from 'vue'
 import { useChatStore } from '@/stores/chat'
-import { useSettingsStore } from '@/stores/settings'
-import { useStreamingTts } from '@/composables/useStreamingTts'
-import { useVoiceAudio, setVoiceVolume } from '@/composables/useVoiceAudio'
-import { useListenMode } from '@/composables/useListenMode'
-import { apiGet } from '@/api/client'
 import ChatMessage from '@/components/ChatMessage.vue'
 import ChatStreamingBubble from '@/components/ChatStreamingBubble.vue'
 import ChatInputBar from '@/components/ChatInputBar.vue'
@@ -34,33 +29,6 @@ const emit = defineEmits<{
 }>()
 
 const store = useChatStore()
-const settingsStore = useSettingsStore()
-
-// ── Voice / TTS ───────────────────────────────────────────────────────────────
-const voiceTtsEnabled = computed(() => settingsStore.voiceTtsReady)
-const listenMode = useListenMode()
-const audio = useVoiceAudio()
-const showVolumeSlider = ref(false)
-
-const tts = useStreamingTts({
-  streamingContent: computed(() => store.streamingContent),
-  streaming: computed(() => store.streaming),
-  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
-})
-
-function lastAssistantContent(): string {
-  const msgs = store.currentConversation?.messages ?? []
-  return [...msgs].reverse().find((m) => m.role === 'assistant')?.content ?? ''
-}
-
-function toggleListen() {
-  listenMode.value = !listenMode.value
-  if (listenMode.value) {
-    tts.speak(lastAssistantContent())
-  } else {
-    tts.stop()
-  }
-}
 
 // ── Scroll ────────────────────────────────────────────────────────────────────
 const messagesEl = ref<HTMLElement | null>(null)
@@ -89,47 +57,6 @@ watch(() => store.streamingToolCalls, (calls) => {
 }, { deep: true })
 watch(() => store.streaming, (s) => { if (!s) _seenCalendarToolIdx.clear() })
 
-// ── RAG scope chip (full, non-briefing, non-workspace) ────────────────────────
-const projects = ref<{ id: number; title: string }[]>([])
-const scopeDropdownOpen = ref(false)
-const scopePulse = ref(false)
-
-const showScopeChip = computed(
-  () => props.variant === 'full' && !props.briefingMode && !props.projectId
-)
-
-const scopeLabel = computed(() => {
-  const id = store.ragProjectId
-  if (id === -1) return 'All notes'
-  if (id === null) return 'Orphan notes'
-  return projects.value.find((p) => p.id === id)?.title ?? `Project ${id}`
-})
-
-async function loadProjects() {
-  try {
-    const data = await apiGet<{ projects: { id: number; title: string }[] }>('/api/projects?status=active')
-    projects.value = data.projects ?? []
-  } catch {
-    projects.value = []
-  }
-}
-
-async function onScopeSelect(value: number | null) {
-  scopeDropdownOpen.value = false
-  const convId = store.currentConversation?.id
-  if (!convId) return
-  await store.updateRagScope(convId, value)
-  scopePulse.value = true
-  setTimeout(() => { scopePulse.value = false }, 600)
-}
-
-// Pulse when model-driven scope change fires
-watch(() => store.ragProjectId, () => {
-  if (!showScopeChip.value) return
-  scopePulse.value = true
-  setTimeout(() => { scopePulse.value = false }, 600)
-})
-
 // ── Note context (full variant — included / suggested / auto-injected notes) ──
 const includedNoteIds = ref<Set<number>>(new Set())
 const includedNotes = ref<{ id: number; title: string }[]>([])
@@ -190,11 +117,92 @@ function removeIncludedNote(noteId: number) {
   }
 }
 
-const hasContextSidebar = computed(
-  () => props.variant === 'full' && !props.briefingMode && !props.projectId &&
-    (autoInjectedNotes.value.length > 0 || includedNotes.value.length > 0 || suggestedNotes.value.length > 0)
+const contextCount = computed(
+  () => autoInjectedNotes.value.length + suggestedNotes.value.length + includedNotes.value.length
 )
 
+const hasContextData = computed(
+  () => props.variant === 'full' && !props.briefingMode && !props.projectId && contextCount.value > 0
+)
+
+// ── Narrow-viewport sidebar toggle ────────────────────────────────────────────
+const NARROW_BREAKPOINT = 1200
+const isNarrow = ref(typeof window !== 'undefined' && window.innerWidth < NARROW_BREAKPOINT)
+const sidebarOpen = ref(false)
+
+function onResize() {
+  isNarrow.value = window.innerWidth < NARROW_BREAKPOINT
+}
+onMounted(() => window.addEventListener('resize', onResize))
+onUnmounted(() => window.removeEventListener('resize', onResize))
+
+function toggleContextSidebar() {
+  sidebarOpen.value = !sidebarOpen.value
+}
+
+const hasContextSidebar = computed(() => hasContextData.value && sidebarOpen.value)
+
+// ── Collapsible sections (per-conversation, localStorage) ─────────────────────
+type SectionKey = 'auto' | 'suggested' | 'included'
+const collapsedSections = ref<Set<SectionKey>>(new Set())
+
+function storageKey(): string | null {
+  const id = store.currentConversation?.id
+  return id ? `fa_chat_ctx_collapsed_${id}` : null
+}
+
+function loadCollapsed() {
+  const key = storageKey()
+  if (!key) { collapsedSections.value = new Set(); return }
+  try {
+    const raw = localStorage.getItem(key)
+    if (!raw) { collapsedSections.value = new Set(); return }
+    const arr = JSON.parse(raw) as SectionKey[]
+    collapsedSections.value = new Set(arr)
+  } catch {
+    collapsedSections.value = new Set()
+  }
+}
+
+function saveCollapsed() {
+  const key = storageKey()
+  if (!key) return
+  try {
+    localStorage.setItem(key, JSON.stringify([...collapsedSections.value]))
+  } catch { /* ignore */ }
+}
+
+function toggleSection(key: SectionKey) {
+  const next = new Set(collapsedSections.value)
+  if (next.has(key)) next.delete(key)
+  else next.add(key)
+  collapsedSections.value = next
+  saveCollapsed()
+}
+
+watch(() => store.currentConversation?.id, () => loadCollapsed(), { immediate: true })
+
+// ── Empty-state (full variant, fresh/empty conversation) ─────────────────────
+const showEmptyState = computed(
+  () =>
+    props.variant === 'full'
+    && !props.briefingMode
+    && !props.projectId
+    && !store.streaming
+    && (store.currentConversation?.messages.length ?? 0) === 0
+)
+
+const recentConversations = computed(() => {
+  const currentId = store.currentConversation?.id
+  return store.conversations
+    .filter((c) => c.id !== currentId && c.message_count > 0)
+    .slice(0, 5)
+})
+
+function startVoiceMode() {
+  window.dispatchEvent(new CustomEvent('voice:ptt-toggle'))
+}
+
 // ── Send ──────────────────────────────────────────────────────────────────────
 const inputBarRef = ref<InstanceType<typeof ChatInputBar> | null>(null)
 
@@ -208,7 +216,7 @@ async function onSubmit(payload: { content: string; contextNoteId?: number }) {
     payload.content,
     payload.contextNoteId,
     includedNoteIds.value.size ? [...includedNoteIds.value] : undefined,
-    true,
+    false,
     undefined,
     excludedNoteIds.value.length ? excludedNoteIds.value : undefined,
     props.projectId ?? store.ragProjectId,
@@ -249,7 +257,7 @@ async function widgetSend(payload: { content: string; contextNoteId?: number })
   widgetConvId.value = conv.id
   emit('conversation-started', conv.id)
 
-  await store.sendMessage(payload.content, payload.contextNoteId, undefined, true)
+  await store.sendMessage(payload.content, payload.contextNoteId, undefined, false)
 
   const msgs = store.currentConversation?.messages ?? []
   const lastAssistant = [...msgs].reverse().find((m: Message) => m.role === 'assistant')
@@ -271,8 +279,7 @@ async function handleSaveAsNote(messageId: number) {
 }
 
 // ── Lifecycle ─────────────────────────────────────────────────────────────────
-onMounted(async () => {
-  if (showScopeChip.value) await loadProjects()
+onMounted(() => {
   if (props.autoFocus) nextTick(() => inputBarRef.value?.focus())
 })
 
@@ -289,13 +296,30 @@ async function send(text: string) {
   await onSubmit({ content: text })
 }
 
-defineExpose({ focus, prefill, send })
+// ── Briefing slot separator helper ────────────────────────────────────────────
+function hasEarlierBriefingSlot(index: number): boolean {
+  const msgs = store.currentConversation?.messages ?? []
+  for (let i = 0; i < index; i++) {
+    const m = msgs[i]
+    const meta = m?.metadata as Record<string, unknown> | null | undefined
+    if (
+      m?.role === 'assistant' &&
+      meta?.briefing_slot != null &&
+      !meta?.briefing_intermediate
+    ) {
+      return true
+    }
+  }
+  return false
+}
+
+defineExpose({ focus, prefill, send, contextCount, sidebarOpen, toggleContextSidebar, hasContextData })
 </script>
 
 <template>
   <!-- ═══════════════════════════════ FULL VARIANT ══════════════════════════════ -->
   <template v-if="variant === 'full'">
-    <div class="chat-body" :class="{ 'chat-body--has-sidebar': hasContextSidebar }">
+    <div class="chat-full">
       <!-- Message list -->
       <div ref="messagesEl" class="messages-container">
         <div class="messages-inner">
@@ -303,13 +327,11 @@ defineExpose({ focus, prefill, send })
             v-for="(msg, index) in store.currentConversation?.messages ?? []"
             :key="msg.id"
           >
-            <!-- Briefing slot separator: shown before a 2nd+ briefing slot message -->
+            <!-- Briefing slot separator: before any non-first slot message (skip intermediate tool-call rows) -->
             <div
-              v-if="briefingMode && index > 0 && msg.role === 'assistant' && msg.metadata?.rss_item_ids"
+              v-if="briefingMode && msg.role === 'assistant' && msg.metadata?.briefing_slot && !msg.metadata?.briefing_intermediate && hasEarlierBriefingSlot(index)"
               class="briefing-slot-separator"
-            >
-              <span>New Briefing Update</span>
-            </div>
+            ></div>
             <ChatMessage
               :message="msg"
               @save-as-note="handleSaveAsNote"
@@ -335,8 +357,27 @@ defineExpose({ focus, prefill, send })
               </button>
             </div>
           </template>
+          <div v-if="showEmptyState" class="chat-empty-state">
+            <h2 class="empty-greeting">What's on your mind?</h2>
+            <div v-if="recentConversations.length" class="empty-recent">
+              <div class="empty-section-label">Jump back in</div>
+              <router-link
+                v-for="conv in recentConversations"
+                :key="conv.id"
+                :to="`/chat/${conv.id}`"
+                class="empty-recent-item"
+              >
+                <span class="empty-recent-title">{{ conv.title || 'Untitled conversation' }}</span>
+                <span class="empty-recent-count">{{ conv.message_count }} msg</span>
+              </router-link>
+            </div>
+            <button class="empty-voice-btn" @click="startVoiceMode" title="Start in voice mode">
+              <span class="voice-icon">🎤</span>
+              <span>Start in voice mode</span>
+            </button>
+          </div>
           <p
-            v-if="!store.currentConversation?.messages.length && !store.streaming"
+            v-else-if="!store.currentConversation?.messages.length && !store.streaming"
             class="empty-msg"
           >Start a conversation.</p>
         </div>
@@ -345,114 +386,71 @@ defineExpose({ focus, prefill, send })
       <!-- Context sidebar (full, non-briefing, non-workspace) -->
       <aside v-if="hasContextSidebar" class="context-sidebar">
         <template v-if="autoInjectedNotes.length">
-          <div class="context-sidebar-header">Auto-included</div>
-          <div v-for="note in autoInjectedNotes" :key="note.id" class="context-note context-note-auto">
-            <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
-            <span
-              v-if="note.score != null"
-              class="context-note-score"
-              :class="{ 'score-high': note.score >= 0.75, 'score-medium': note.score >= 0.60 && note.score < 0.75, 'score-low': note.score < 0.60 }"
-            >{{ Math.round(note.score * 100) }}%</span>
-            <button class="context-note-remove" @click="excludeAutoNote(note.id)">&times;</button>
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('auto') }"
+            @click="toggleSection('auto')"
+          >
+            <svg class="chev" width="10" height="10" viewBox="0 0 10 10" fill="currentColor"><path d="M2 3l3 4 3-4z"/></svg>
+            <span>Auto-included</span>
+            <span class="section-count">{{ autoInjectedNotes.length }}</span>
+          </button>
+          <div v-show="!collapsedSections.has('auto')">
+            <div v-for="note in autoInjectedNotes" :key="note.id" class="context-note context-note-auto">
+              <span class="auto-pill" title="Auto-included by relevance">AUTO</span>
+              <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
+              <span
+                v-if="note.score != null"
+                class="context-note-score"
+                :class="{ 'score-high': note.score >= 0.75, 'score-medium': note.score >= 0.60 && note.score < 0.75, 'score-low': note.score < 0.60 }"
+              >{{ Math.round(note.score * 100) }}%</span>
+              <button class="context-note-remove" @click="excludeAutoNote(note.id)" title="Remove from context">&times;</button>
+            </div>
           </div>
         </template>
         <template v-if="suggestedNotes.length">
-          <div class="context-sidebar-header" :class="{ 'context-sidebar-header-gap': autoInjectedNotes.length }">Suggested</div>
-          <div v-for="note in suggestedNotes" :key="note.id" class="context-note context-note-suggested">
-            <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
-            <span
-              v-if="note.score != null"
-              class="context-note-score"
-              :class="{ 'score-high': note.score >= 0.75, 'score-medium': note.score >= 0.60 && note.score < 0.75, 'score-low': note.score < 0.60 }"
-            >{{ Math.round(note.score * 100) }}%</span>
-            <button class="context-note-add" @click="includeNote(note)" title="Add to context">+</button>
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('suggested'), 'context-sidebar-header-gap': autoInjectedNotes.length }"
+            @click="toggleSection('suggested')"
+          >
+            <svg class="chev" width="10" height="10" viewBox="0 0 10 10" fill="currentColor"><path d="M2 3l3 4 3-4z"/></svg>
+            <span>Suggested</span>
+            <span class="section-count">{{ suggestedNotes.length }}</span>
+          </button>
+          <div v-show="!collapsedSections.has('suggested')">
+            <div v-for="note in suggestedNotes" :key="note.id" class="context-note context-note-suggested">
+              <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
+              <span
+                v-if="note.score != null"
+                class="context-note-score"
+                :class="{ 'score-high': note.score >= 0.75, 'score-medium': note.score >= 0.60 && note.score < 0.75, 'score-low': note.score < 0.60 }"
+              >{{ Math.round(note.score * 100) }}%</span>
+              <button class="context-note-add" @click="includeNote(note)" title="Add to context">+</button>
+            </div>
           </div>
         </template>
         <template v-if="includedNotes.length">
-          <div class="context-sidebar-header" :class="{ 'context-sidebar-header-gap': autoInjectedNotes.length || suggestedNotes.length }">In Context</div>
-          <div v-for="note in includedNotes" :key="note.id" class="context-note context-note-included">
-            <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
-            <button class="context-note-remove" @click="removeIncludedNote(note.id)">&times;</button>
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('included'), 'context-sidebar-header-gap': autoInjectedNotes.length || suggestedNotes.length }"
+            @click="toggleSection('included')"
+          >
+            <svg class="chev" width="10" height="10" viewBox="0 0 10 10" fill="currentColor"><path d="M2 3l3 4 3-4z"/></svg>
+            <span>In Context</span>
+            <span class="section-count">{{ includedNotes.length }}</span>
+          </button>
+          <div v-show="!collapsedSections.has('included')">
+            <div v-for="note in includedNotes" :key="note.id" class="context-note context-note-included">
+              <router-link :to="`/notes/${note.id}`" class="context-note-name">{{ note.title }}</router-link>
+              <button class="context-note-remove" @click="removeIncludedNote(note.id)" title="Remove from context">&times;</button>
+            </div>
           </div>
         </template>
       </aside>
-    </div>
-
-    <!-- Input area (hidden when readOnly) -->
-    <div v-if="!readOnly" class="input-wrapper">
-      <!-- Scope chip -->
-      <div v-if="showScopeChip" class="scope-chip-row">
-        <div class="scope-chip-wrapper">
-          <button
-            class="scope-chip"
-            :class="{ pulse: scopePulse }"
-            @click="scopeDropdownOpen = !scopeDropdownOpen"
-            title="Change RAG scope"
-          >
-            <span class="scope-dot">⊙</span> {{ scopeLabel }}
-          </button>
-          <div v-if="scopeDropdownOpen" class="scope-dropdown">
-            <button class="scope-option" :class="{ active: store.ragProjectId === null }" @click="onScopeSelect(null)">Orphan notes only</button>
-            <button
-              v-for="p in projects"
-              :key="p.id"
-              class="scope-option"
-              :class="{ active: store.ragProjectId === p.id }"
-              @click="onScopeSelect(p.id)"
-            >{{ p.title }}</button>
-            <button class="scope-option" :class="{ active: store.ragProjectId === -1 }" @click="onScopeSelect(-1)">All notes</button>
-          </div>
-        </div>
-      </div>
-
-      <!-- Listen / volume controls -->
-      <div v-if="voiceTtsEnabled" class="voice-controls">
-        <div class="volume-wrapper">
-          <button
-            class="btn-voice"
-            :class="{ 'btn-voice--active': listenMode, 'btn-voice--busy': tts.speaking.value }"
-            @click="toggleListen"
-            :title="listenMode ? 'Stop auto-read' : 'Read responses aloud'"
-            aria-label="Toggle listen mode"
-          >
-            <svg v-if="!tts.speaking.value" width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
-              <path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.85-5 6.71v2.06c4.01-.91 7-4.49 7-8.77s-2.99-7.86-7-8.77z"/>
-            </svg>
-            <svg v-else width="17" height="17" viewBox="0 0 24 24" fill="currentColor">
-              <path d="M18 12c0-1.77-1.02-3.29-2.5-4.03v2.21l2.45 2.45c.03-.2.05-.41.05-.63zm2.5 0c0 .94-.2 1.82-.54 2.64l1.51 1.51C21.8 14.82 22 13.43 22 12c0-4.28-2.99-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71zM4.27 3L3 4.27 7.73 9H3v6h4l5 5v-6.73l4.25 4.25c-.67.52-1.42.93-2.25 1.18v2.06c1.38-.31 2.63-.95 3.69-1.81L19.73 21 21 19.73l-9-9L4.27 3zM12 4L9.91 6.09 12 8.18V4z"/>
-            </svg>
-          </button>
-          <button
-            class="btn-voice btn-volume-icon"
-            @click="showVolumeSlider = !showVolumeSlider"
-            :title="`Volume: ${Math.round(audio.volume.value * 100)}%`"
-            aria-label="Volume"
-          >
-            <svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor">
-              <path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02z"/>
-            </svg>
-          </button>
-          <div v-if="showVolumeSlider" class="volume-popup">
-            <input
-              type="range" min="0" max="1" step="0.05"
-              :value="audio.volume.value"
-              @input="setVoiceVolume(+($event.target as HTMLInputElement).value)"
-              class="volume-range"
-              aria-label="Volume"
-            />
-            <span class="volume-pct">{{ Math.round(audio.volume.value * 100) }}%</span>
-          </div>
-        </div>
-        <button
-          v-if="tts.speaking.value"
-          class="btn-voice"
-          @click="tts.stop()"
-          title="Stop playback"
-        >
-          <svg width="13" height="13" viewBox="0 0 14 14" fill="currentColor"><rect width="14" height="14" rx="2"/></svg>
-        </button>
-      </div>
 
+      <!-- Input area (hidden when readOnly) -->
+      <div v-if="!readOnly" class="input-wrapper">
       <!-- Unified input bar -->
       <ChatInputBar
         ref="inputBarRef"
@@ -461,6 +459,7 @@ defineExpose({ focus, prefill, send })
         @submit="onSubmit"
         @abort="store.cancelGeneration()"
       />
+      </div>
     </div>
   </template>
 
@@ -513,18 +512,31 @@ defineExpose({ focus, prefill, send })
 </template>
 
 <style scoped>
-/* ── Full variant layout ── */
-.chat-body {
+/* ── Full variant layout ──
+ * Single grid owns the reading column + context sidebar + input bar so
+ * messages and input bar share one centered reading track while the
+ * context sidebar spans the full height from header to bottom of view.
+ * Reading column is always centered (3-column grid: 1fr | content | 1fr).
+ * The context sidebar overlays the right gutter so it never shifts layout.
+ */
+.chat-full {
+  position: relative;
   flex: 1;
-  display: flex;
   min-height: 0;
+  display: grid;
+  grid-template-columns:
+    1fr
+    minmax(0, var(--chat-reading-width))
+    1fr;
+  grid-template-rows: minmax(0, 1fr) auto;
   overflow: hidden;
 }
 
 .messages-container {
-  flex: 1;
+  grid-column: 2;
+  grid-row: 1;
   overflow-y: auto;
-  padding: 1rem;
+  padding: 1rem 1rem 0.75rem;
   mask-image: linear-gradient(to bottom, transparent, black 20px, black calc(100% - 20px), transparent);
   -webkit-mask-image: linear-gradient(to bottom, transparent, black 20px, black calc(100% - 20px), transparent);
 }
@@ -537,51 +549,85 @@ defineExpose({ focus, prefill, send })
 
 /* Briefing slot separator */
 .briefing-slot-separator {
-  display: flex;
-  align-items: center;
-  gap: 0.75rem;
-  margin: 1.25rem 0 0.5rem;
-  color: var(--color-text-muted, #888);
-  font-size: 0.7rem;
-  font-weight: 600;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  opacity: 0.7;
-}
-.briefing-slot-separator::before,
-.briefing-slot-separator::after {
-  content: '';
-  flex: 1;
   height: 1px;
+  margin: 1.25rem 0 0.75rem;
   background: var(--color-border, #333);
-  opacity: 0.5;
+  opacity: 0.35;
 }
 
-/* Context sidebar */
+/* Context sidebar — overlays right gutter, never shifts reading column */
 .context-sidebar {
-  width: 200px;
-  min-width: 160px;
-  max-width: 220px;
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  width: var(--chat-context-sidebar-width);
   border-left: 1px solid var(--color-border);
   padding: 0.75rem 0.5rem;
   overflow-y: auto;
   background: var(--color-bg-secondary);
   font-size: 0.78rem;
+  z-index: 2;
 }
 .context-sidebar-header {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  width: 100%;
+  background: none;
+  border: none;
+  padding: 0.15rem 0.1rem;
+  font-family: inherit;
   font-size: 0.65rem;
   font-weight: 700;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   color: var(--color-text-muted);
   margin-bottom: 0.35rem;
+  cursor: pointer;
+  text-align: left;
+}
+.context-sidebar-header:hover { color: var(--color-text); }
+.context-sidebar-header .chev {
+  transition: transform 0.15s ease;
+}
+.context-sidebar-header.collapsed .chev {
+  transform: rotate(-90deg);
+}
+.context-sidebar-header .section-count {
+  margin-left: auto;
+  color: var(--color-text-muted);
+  font-weight: 600;
+  background: var(--color-bg);
+  padding: 0.05rem 0.3rem;
+  border-radius: 8px;
 }
 .context-sidebar-header-gap { margin-top: 0.75rem; }
 .context-note {
   display: flex;
   align-items: center;
-  gap: 0.2rem;
+  gap: 0.25rem;
   margin-bottom: 0.25rem;
+  padding: 0.2rem 0.35rem;
+  border-radius: var(--radius-sm);
+}
+.context-note-auto {
+  background: color-mix(in srgb, var(--color-text-muted) 8%, transparent);
+  opacity: 0.85;
+}
+.context-note-included {
+  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
+  border-left: 2px solid var(--color-primary);
+}
+.auto-pill {
+  font-size: 0.55rem;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  padding: 0.05rem 0.3rem;
+  border-radius: 4px;
+  background: var(--color-bg);
+  color: var(--color-text-muted);
+  flex-shrink: 0;
 }
 .context-note-name {
   flex: 1;
@@ -615,103 +661,16 @@ defineExpose({ focus, prefill, send })
 .context-note-remove:hover { color: #ef4444; }
 .context-note-add:hover { color: var(--color-primary); }
 
-/* Input wrapper */
+/* Input wrapper — lives in the same reading column as messages */
 .input-wrapper {
-  border-top: 1px solid var(--color-border);
+  grid-column: 2;
+  grid-row: 2;
   padding: 0.5rem 1rem 0.75rem;
   display: flex;
   flex-direction: column;
   gap: 0.4rem;
 }
 
-/* Scope chip */
-.scope-chip-row { display: flex; }
-.scope-chip-wrapper { position: relative; }
-.scope-chip {
-  display: flex;
-  align-items: center;
-  gap: 0.3rem;
-  background: none;
-  border: 1px solid var(--color-border);
-  border-radius: 20px;
-  padding: 0.2rem 0.65rem;
-  font-size: 0.75rem;
-  color: var(--color-text-muted);
-  cursor: pointer;
-  transition: border-color 0.15s, color 0.15s;
-}
-.scope-chip:hover { border-color: var(--color-primary); color: var(--color-primary); }
-.scope-chip.pulse { animation: pulse-chip 0.6s ease; }
-@keyframes pulse-chip {
-  0%, 100% { border-color: var(--color-border); }
-  50% { border-color: var(--color-primary); color: var(--color-primary); box-shadow: 0 0 6px rgba(99,102,241,0.4); }
-}
-.scope-dot { font-size: 0.6rem; }
-.scope-dropdown {
-  position: absolute;
-  top: calc(100% + 4px);
-  left: 0;
-  min-width: 180px;
-  background: var(--color-bg-card);
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-md);
-  box-shadow: 0 4px 16px var(--color-shadow);
-  z-index: 20;
-  overflow: hidden;
-}
-.scope-option {
-  display: block;
-  width: 100%;
-  padding: 0.45rem 0.75rem;
-  text-align: left;
-  background: none;
-  border: none;
-  font-size: 0.85rem;
-  color: var(--color-text);
-  cursor: pointer;
-}
-.scope-option:hover { background: var(--color-bg-secondary); }
-.scope-option.active { color: var(--color-primary); font-weight: 600; }
-
-/* Voice controls */
-.voice-controls {
-  display: flex;
-  align-items: center;
-  gap: 0.2rem;
-}
-.volume-wrapper { position: relative; display: flex; align-items: center; gap: 0.1rem; }
-.btn-voice {
-  background: none;
-  border: none;
-  cursor: pointer;
-  color: var(--color-text-muted);
-  opacity: 0.65;
-  padding: 0.2rem;
-  display: flex;
-  align-items: center;
-  border-radius: var(--radius-sm);
-  transition: opacity 0.15s, color 0.15s;
-}
-.btn-voice:hover { opacity: 1; }
-.btn-voice--active { opacity: 1; color: var(--color-primary); }
-.btn-voice--busy { opacity: 1; color: #f59e0b; }
-.volume-popup {
-  position: absolute;
-  bottom: calc(100% + 8px);
-  left: 0;
-  background: var(--color-bg-card);
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-md);
-  padding: 0.5rem 0.75rem;
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  z-index: 20;
-  box-shadow: 0 4px 16px var(--color-shadow);
-}
-.volume-range { width: 80px; }
-.volume-pct { font-size: 0.75rem; color: var(--color-text-muted); white-space: nowrap; }
-
 /* Queued messages */
 .queued-message { opacity: 0.45; }
 .queued-bubble {
@@ -753,6 +712,108 @@ defineExpose({ focus, prefill, send })
   color: var(--color-accent-warm, #d4a017);
 }
 
+.chat-empty-state {
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 1.5rem;
+  padding: 3rem 1rem 2rem;
+  max-width: 520px;
+  margin: 0 auto;
+}
+
+.empty-greeting {
+  font-family: 'Fraunces', Georgia, serif;
+  font-style: italic;
+  font-weight: 400;
+  font-size: 1.75rem;
+  color: var(--color-accent-warm, #d4a017);
+  text-align: center;
+  margin: 0;
+}
+
+.empty-section-label {
+  font-size: 0.7rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--color-text-muted);
+  margin-bottom: 0.5rem;
+  padding-left: 0.25rem;
+}
+
+.empty-recent {
+  display: flex;
+  flex-direction: column;
+}
+
+.empty-recent-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  padding: 0.75rem 0.9rem;
+  border-radius: var(--radius-md, 10px);
+  border: 1px solid var(--color-border);
+  background: var(--color-bg-elevated, rgba(255, 255, 255, 0.02));
+  color: var(--color-text);
+  text-decoration: none;
+  font-size: 0.9rem;
+  transition: border-color 0.15s ease, background 0.15s ease, transform 0.15s ease;
+}
+
+.empty-recent-item + .empty-recent-item {
+  margin-top: 0.4rem;
+}
+
+.empty-recent-item:hover {
+  border-color: var(--color-primary);
+  background: rgba(99, 102, 241, 0.05);
+  transform: translateX(2px);
+}
+
+.empty-recent-title {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  flex: 1;
+  min-width: 0;
+}
+
+.empty-recent-count {
+  font-size: 0.7rem;
+  color: var(--color-text-muted);
+  font-variant-numeric: tabular-nums;
+  flex-shrink: 0;
+}
+
+.empty-voice-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.6rem;
+  padding: 0.75rem 1.2rem;
+  border-radius: 999px;
+  border: 1px solid var(--color-border);
+  background: transparent;
+  color: var(--color-text);
+  font-size: 0.9rem;
+  cursor: pointer;
+  align-self: center;
+  transition: border-color 0.15s ease, background 0.15s ease, color 0.15s ease;
+}
+
+.empty-voice-btn:hover {
+  border-color: var(--color-primary);
+  background: linear-gradient(135deg, #6366f1, #4f46e5);
+  color: #fff;
+  box-shadow: 0 4px 16px rgba(99, 102, 241, 0.35);
+}
+
+.empty-voice-btn .voice-icon {
+  font-size: 1.05rem;
+}
+
 /* ── Widget variant ── */
 .widget-response {
   margin-top: 0.75rem;

frontend/src/components/ToolCallCard.vue

@@ -218,7 +218,7 @@ async function confirmDuplicate() {
   if (confirmState.value !== "idle") return;
   confirmState.value = "creating";
   const args = props.toolCall.arguments as Record<string, unknown>;
-  const isTask = props.toolCall.function === "create_task";
+  const isTask = !!(args.status);
   const endpoint = isTask ? "/api/tasks" : "/api/notes";
   const payload: Record<string, unknown> = {
     title: args.title,

frontend/src/components/WeatherCard.vue

@@ -9,6 +9,8 @@ interface ForecastDay {
   precip_probability: number | null
   precip_mm: number | null
   windspeed_max: number
+  precip_summary?: string
+  precip_peak_hour?: string
 }
 
 interface WeatherData {
@@ -21,6 +23,7 @@ interface WeatherData {
   yesterday_high: number | null
   yesterday_low: number | null
   wind_unit?: string
+  precip_summary?: string | null
   forecast: ForecastDay[]
 }
 
@@ -68,6 +71,11 @@ const fetchedAtLabel = computed(() => {
     return ''
   }
 })
+
+function hasPrecip(day: ForecastDay): boolean {
+  return (day.precip_probability != null && day.precip_probability > 0) ||
+         (day.precip_mm != null && day.precip_mm > 0)
+}
 </script>
 
 <template>
@@ -85,22 +93,39 @@ const fetchedAtLabel = computed(() => {
       Today: {{ weather.today_high }}° / {{ weather.today_low }}°
       <span v-if="tempDelta" class="weather-delta"> · {{ tempDelta }}</span>
     </div>
-    <div class="weather-forecast" v-if="weather.forecast.length">
-      <div v-for="day in weather.forecast" :key="day.day" class="weather-forecast-day">
-        <span class="forecast-day-name">{{ day.day }}</span>
-        <span class="forecast-icon">{{ weatherIcon(day.condition) }}</span>
-        <span class="forecast-condition">{{ day.condition }}</span>
-        <span class="forecast-temps">{{ day.high }}° / {{ day.low }}°</span>
-        <span v-if="day.precip_probability != null && day.precip_probability > 0" class="forecast-precip">
-          💧 {{ day.precip_probability }}%
-        </span>
-        <span v-else-if="day.precip_mm != null && day.precip_mm > 0" class="forecast-precip">
-          💧 {{ day.precip_mm.toFixed(1) }}mm
-        </span>
-        <span v-else class="forecast-precip forecast-precip--dry">💧 —</span>
-        <span class="forecast-wind">💨 {{ day.windspeed_max }} {{ weather.wind_unit ?? 'km/h' }}</span>
-      </div>
+    <div v-if="weather.precip_summary" class="weather-precip-summary">
+      💧 {{ weather.precip_summary }}
     </div>
+    <table class="weather-forecast" v-if="weather.forecast.length">
+      <thead>
+        <tr>
+          <th></th>
+          <th></th>
+          <th>Hi / Lo</th>
+          <th>💧</th>
+          <th>💨 {{ weather.wind_unit ?? 'km/h' }}</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr v-for="day in weather.forecast" :key="day.day">
+          <td class="forecast-day-name">{{ day.day }}</td>
+          <td class="forecast-icon">{{ weatherIcon(day.condition) }}</td>
+          <td class="forecast-temps">{{ day.high }}° / {{ day.low }}°</td>
+          <td class="forecast-precip" :class="{ 'forecast-precip--dry': !hasPrecip(day) }">
+            <template v-if="day.precip_summary">
+              <span class="precip-detail" :title="day.precip_summary">
+                {{ day.precip_probability }}%
+                <span v-if="day.precip_peak_hour" class="precip-peak">{{ day.precip_peak_hour }}</span>
+              </span>
+            </template>
+            <template v-else-if="day.precip_probability != null && day.precip_probability > 0">{{ day.precip_probability }}%</template>
+            <template v-else-if="day.precip_mm != null && day.precip_mm > 0">{{ day.precip_mm.toFixed(1) }}mm</template>
+            <template v-else>&mdash;</template>
+          </td>
+          <td class="forecast-wind">{{ day.windspeed_max }}</td>
+        </tr>
+      </tbody>
+    </table>
   </div>
   <div v-else class="weather-card weather-unavailable">
     Weather data unavailable — will retry at next slot.
@@ -115,6 +140,7 @@ const fetchedAtLabel = computed(() => {
   padding: 1rem 1.25rem;
   margin-bottom: 1rem;
   font-size: 0.9rem;
+  container-type: inline-size;
 }
 
 .weather-header {
@@ -142,12 +168,12 @@ const fetchedAtLabel = computed(() => {
 }
 
 .weather-icon {
-  font-size: 2rem;
+  font-size: clamp(1.5rem, 5cqi, 2.5rem);
   line-height: 1;
 }
 
 .weather-temp {
-  font-size: 2rem;
+  font-size: clamp(1.5rem, 5cqi, 2.5rem);
   font-weight: 700;
   line-height: 1;
 }
@@ -159,7 +185,7 @@ const fetchedAtLabel = computed(() => {
 
 .weather-today {
   color: var(--color-text-secondary);
-  margin-bottom: 0.75rem;
+  margin-bottom: 0.25rem;
   font-size: 0.85rem;
 }
 
@@ -168,48 +194,59 @@ const fetchedAtLabel = computed(() => {
   font-size: 0.82rem;
 }
 
-.weather-forecast {
-  display: flex;
-  gap: 0.75rem;
-  overflow-x: auto;
-  padding-top: 0.75rem;
-  border-top: 1px solid var(--color-border);
+.weather-precip-summary {
+  color: var(--color-text-secondary);
+  font-size: 0.83rem;
+  margin-bottom: 0.75rem;
+  padding: 0.35rem 0.5rem;
+  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
+  border-radius: var(--radius-sm, 6px);
+  border-left: 2px solid color-mix(in srgb, var(--color-primary) 40%, transparent);
 }
 
-.weather-forecast-day {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 0.25rem;
-  min-width: 4.5rem;
+.weather-forecast {
+  width: 100%;
+  border-collapse: collapse;
+  margin-top: 0.75rem;
+  border-top: 1px solid var(--color-border);
   font-size: 0.8rem;
 }
 
+.weather-forecast thead th {
+  font-size: 0.68rem;
+  font-weight: 600;
+  color: var(--color-text-muted);
+  text-align: right;
+  padding: 0.5rem 0.4rem 0.25rem;
+  white-space: nowrap;
+}
+
+.weather-forecast thead th:first-child,
+.weather-forecast thead th:nth-child(2) {
+  text-align: left;
+}
+
+.weather-forecast tbody td {
+  padding: 0.3rem 0.4rem;
+  white-space: nowrap;
+  vertical-align: middle;
+}
+
 .forecast-day-name {
   font-weight: 600;
 }
 
 .forecast-icon {
-  font-size: 1.2rem;
+  font-size: clamp(0.9rem, 3cqi, 1.3rem);
   line-height: 1;
 }
 
-.forecast-condition {
-  font-size: 0.7rem;
-  color: var(--color-text-muted);
-  text-align: center;
-  line-height: 1.2;
-  word-break: break-word;
-}
-
 .forecast-temps {
-  white-space: nowrap;
+  text-align: right;
 }
 
-.forecast-precip,
-.forecast-wind {
-  font-size: 0.72rem;
-  white-space: nowrap;
+.forecast-precip {
+  text-align: right;
   color: var(--color-text-muted);
 }
 
@@ -217,6 +254,23 @@ const fetchedAtLabel = computed(() => {
   opacity: 0.35;
 }
 
+.precip-detail {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 0.3em;
+}
+
+.precip-peak {
+  font-size: 0.7rem;
+  color: var(--color-text-muted);
+  opacity: 0.8;
+}
+
+.forecast-wind {
+  text-align: right;
+  color: var(--color-text-muted);
+}
+
 .weather-unavailable {
   color: var(--color-text-muted);
   font-style: italic;

frontend/src/components/WorkspaceChatWidget.vue

@@ -0,0 +1,390 @@
+<script setup lang="ts">
+import { ref, computed, nextTick, onMounted, onUnmounted, watch } from 'vue';
+import { useChatStore } from '@/stores/chat';
+import ChatPanel from '@/components/ChatPanel.vue';
+import ChatInputBar from '@/components/ChatInputBar.vue';
+
+const props = defineProps<{ projectId: number }>();
+
+const emit = defineEmits<{
+  'note-changed': [noteId: number];
+  'task-changed': [];
+}>();
+
+const chatStore = useChatStore();
+
+// SSE watcher — emit refresh events when tool calls succeed during streaming
+const processedCount = ref(0);
+
+watch(
+  () => chatStore.streamingToolCalls,
+  (calls) => {
+    for (let i = processedCount.value; i < calls.length; i++) {
+      const tc = calls[i];
+      if (tc.status !== 'success') continue;
+
+      // Note-editor refresh: any successful create_note/update_note
+      if (['create_note', 'update_note'].includes(tc.function) && tc.result?.data?.id) {
+        emit('note-changed', tc.result.data.id as number);
+      }
+
+      // Task-panel refresh: milestone changes, or note changes where the note is a task (has status)
+      const isTaskNoteChange =
+        ['create_note', 'update_note'].includes(tc.function) &&
+        tc.result?.data?.status !== undefined;
+      const isMilestoneChange = ['create_milestone', 'update_milestone'].includes(tc.function);
+      if (isTaskNoteChange || isMilestoneChange) {
+        emit('task-changed');
+      }
+    }
+    processedCount.value = calls.length;
+  },
+  { deep: true }
+);
+
+watch(
+  () => chatStore.streaming,
+  (s) => {
+    if (!s) processedCount.value = 0;
+  }
+);
+
+type WidgetState = 'collapsed' | 'expanded';
+const widgetState = ref<WidgetState>('collapsed');
+
+const chatPanelRef = ref<InstanceType<typeof ChatPanel> | null>(null);
+const inputBarRef = ref<InstanceType<typeof ChatInputBar> | null>(null);
+
+const workspaceConvId = ref<number | null>(null);
+let isNewConv = false;
+
+const historyOpen = ref(false);
+
+const projectConversations = computed(() =>
+  chatStore.conversations
+    .filter((c) => c.rag_project_id === props.projectId)
+    .slice()
+    .sort((a, b) => (b.updated_at || '').localeCompare(a.updated_at || ''))
+);
+
+async function pickConversation(convId: number) {
+  historyOpen.value = false;
+  if (convId === workspaceConvId.value) return;
+  await chatStore.fetchConversation(convId);
+  workspaceConvId.value = convId;
+  // The picked conversation already exists on the server; not ours to clean up.
+  isNewConv = false;
+  localStorage.setItem(_storageKey(props.projectId), String(convId));
+}
+
+function toggleHistory() {
+  historyOpen.value = !historyOpen.value;
+}
+
+function conversationLabel(c: { id: number; title?: string | null }): string {
+  return (c.title && c.title.trim()) || `Conversation #${c.id}`;
+}
+
+function _storageKey(pid: number) {
+  return `workspace_conv_${pid}`;
+}
+
+function expand() {
+  widgetState.value = 'expanded';
+  nextTick(() => chatPanelRef.value?.focus());
+}
+function collapse() {
+  widgetState.value = 'collapsed';
+  nextTick(() => inputBarRef.value?.focus());
+}
+
+async function restart() {
+  const conv = await chatStore.createConversation();
+  workspaceConvId.value = conv.id;
+  isNewConv = true;
+  localStorage.setItem(_storageKey(props.projectId), String(conv.id));
+  await chatStore.fetchConversation(conv.id);
+}
+
+/** Auto-expand and send — used when user submits from collapsed input. */
+async function onCollapsedSubmit(payload: { content: string; contextNoteId?: number }) {
+  widgetState.value = 'expanded';
+  await chatStore.sendMessage(payload.content, payload.contextNoteId, undefined, false);
+}
+
+function prefill(text: string) {
+  if (widgetState.value === 'expanded') {
+    chatPanelRef.value?.prefill(text);
+  } else {
+    inputBarRef.value?.prefill(text);
+  }
+}
+
+onMounted(async () => {
+  if (chatStore.conversations.length === 0) {
+    await chatStore.fetchConversations();
+  }
+
+  const key = _storageKey(props.projectId);
+  const storedId = localStorage.getItem(key);
+
+  if (storedId) {
+    const existingId = Number(storedId);
+    try {
+      await chatStore.fetchConversation(existingId);
+      workspaceConvId.value = existingId;
+      isNewConv = false;
+      chatStore.reconnectIfGenerating(existingId);
+    } catch {
+      localStorage.removeItem(key);
+    }
+  }
+
+  if (workspaceConvId.value === null) {
+    const conv = await chatStore.createConversation();
+    workspaceConvId.value = conv.id;
+    isNewConv = true;
+    await chatStore.fetchConversation(conv.id);
+    localStorage.setItem(key, String(conv.id));
+  }
+});
+
+onUnmounted(async () => {
+  if (workspaceConvId.value !== null && isNewConv) {
+    const id = workspaceConvId.value;
+    const conv = chatStore.conversations.find((c) => c.id === id);
+    if (conv && conv.message_count === 0) {
+      await chatStore.deleteConversation(id);
+      localStorage.removeItem(_storageKey(props.projectId));
+    }
+  }
+});
+
+defineExpose({ prefill });
+</script>
+
+<template>
+  <!-- Bottom-anchored chat dock: collapsed (input only) or expanded (full panel) -->
+  <div
+    class="ws-chat-widget"
+    :class="{ 'ws-chat-widget--expanded': widgetState === 'expanded' }"
+  >
+    <!-- Header (expanded only) -->
+    <div v-if="widgetState === 'expanded'" class="ws-chat-header">
+      <span class="ws-chat-title">Project chat</span>
+      <div class="ws-chat-header-actions">
+        <div class="ws-chat-history-wrap">
+          <button
+            class="btn-icon-sm"
+            :class="{ active: historyOpen }"
+            title="History"
+            @click="toggleHistory"
+          >▾</button>
+          <div v-if="historyOpen" class="ws-chat-history-menu">
+            <div v-if="projectConversations.length === 0" class="ws-chat-history-empty">
+              No past conversations
+            </div>
+            <button
+              v-for="c in projectConversations"
+              :key="c.id"
+              class="ws-chat-history-item"
+              :class="{ current: c.id === workspaceConvId }"
+              @click="pickConversation(c.id)"
+            >
+              <span class="ws-chat-history-title">{{ conversationLabel(c) }}</span>
+            </button>
+          </div>
+        </div>
+        <button class="btn-icon-sm" title="Restart conversation" @click="restart">↻</button>
+        <button class="btn-icon-sm" title="Collapse" @click="collapse">
+          <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+            <polyline points="6 9 12 15 18 9"/>
+          </svg>
+        </button>
+      </div>
+    </div>
+
+    <!-- Expanded body: full ChatPanel (includes its own input bar) -->
+    <div v-if="widgetState === 'expanded'" class="ws-chat-body">
+      <ChatPanel
+        ref="chatPanelRef"
+        variant="full"
+        :projectId="projectId"
+        placeholder="Message the agent…"
+      />
+    </div>
+
+    <!-- Collapsed: standalone input bar with expand affordance -->
+    <div v-else class="ws-chat-collapsed">
+      <button class="ws-chat-expand-btn" title="Expand chat" @click="expand">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5">
+          <polyline points="18 15 12 9 6 15"/>
+        </svg>
+      </button>
+      <div class="ws-chat-input-row">
+        <ChatInputBar
+          ref="inputBarRef"
+          placeholder="Message the agent…"
+          @submit="onCollapsedSubmit"
+          @abort="chatStore.cancelGeneration()"
+        />
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.ws-chat-widget {
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  max-width: var(--page-max-width);
+  margin-inline: auto;
+  z-index: 20;
+  display: flex;
+  flex-direction: column;
+  background: var(--color-bg-secondary);
+  border-radius: 16px 16px 0 0;
+  box-shadow: 0 -8px 32px rgba(0, 0, 0, 0.35), 0 -1px 0 rgba(255, 255, 255, 0.05);
+  overflow: hidden;
+  transition: height 0.2s ease;
+}
+.ws-chat-widget--expanded {
+  height: 500px;
+}
+
+.ws-chat-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 14px;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+  flex-shrink: 0;
+}
+.ws-chat-title {
+  font-size: 0.78rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: var(--color-text-muted);
+}
+.ws-chat-header-actions {
+  display: flex;
+  gap: 4px;
+  align-items: center;
+}
+.btn-icon-sm {
+  background: none;
+  border: none;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  padding: 2px 6px;
+  font-size: 0.9rem;
+  line-height: 1;
+  border-radius: 4px;
+}
+.btn-icon-sm:hover:not(:disabled) {
+  color: var(--color-text);
+  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
+}
+.btn-icon-sm:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+.btn-icon-sm.active {
+  color: var(--color-primary);
+  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
+}
+
+.ws-chat-history-wrap {
+  position: relative;
+}
+.ws-chat-history-menu {
+  position: absolute;
+  top: 100%;
+  right: 0;
+  margin-top: 4px;
+  min-width: 220px;
+  max-height: 260px;
+  overflow-y: auto;
+  background: var(--color-surface);
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+  z-index: 30;
+  padding: 4px;
+}
+.ws-chat-history-empty {
+  padding: 10px 12px;
+  font-size: 0.82rem;
+  color: var(--color-text-muted);
+  text-align: center;
+}
+.ws-chat-history-item {
+  display: block;
+  width: 100%;
+  text-align: left;
+  background: none;
+  border: none;
+  padding: 8px 10px;
+  border-radius: 6px;
+  color: var(--color-text);
+  font-size: 0.85rem;
+  cursor: pointer;
+  font-family: inherit;
+}
+.ws-chat-history-item:hover {
+  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
+}
+.ws-chat-history-item.current {
+  color: var(--color-primary);
+  font-weight: 600;
+}
+.ws-chat-history-title {
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.ws-chat-body {
+  flex: 1;
+  min-height: 0;
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+}
+.ws-chat-body :deep(.chat-body) {
+  flex: 1;
+  min-height: 0;
+}
+
+.ws-chat-collapsed {
+  display: flex;
+  align-items: stretch;
+}
+.ws-chat-expand-btn {
+  flex-shrink: 0;
+  padding: 0 10px;
+  background: none;
+  border: none;
+  border-right: 1px solid var(--color-border);
+  color: var(--color-text-muted);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.ws-chat-expand-btn:hover {
+  color: var(--color-primary);
+  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
+}
+
+.ws-chat-input-row {
+  flex: 1;
+  min-width: 0;
+  padding: 10px 12px;
+  flex-shrink: 0;
+}
+</style>

frontend/src/components/WorkspaceNoteEditor.vue

@@ -457,12 +457,12 @@ defineExpose({ reload: loadProjectNotes });
 
 /* ── Left rail ── */
 .note-rail {
-  width: 155px;
+  width: 200px;
   flex-shrink: 0;
   display: flex;
   flex-direction: column;
   overflow: hidden;
-  border-right: 1px solid var(--color-border);
+  background: var(--color-bg-card, var(--color-bg-secondary));
 }
 
 .rail-header {
@@ -551,13 +551,13 @@ defineExpose({ reload: loadProjectNotes });
   border-bottom: 1px solid color-mix(in srgb, var(--color-border) 60%, transparent);
   cursor: pointer;
   gap: 0.15rem;
-  border-left: 2px solid transparent;
+  border-right: 2px solid transparent;
   transition: background 0.12s;
 }
 .note-row:hover { background: color-mix(in srgb, var(--color-primary) 5%, var(--color-surface)); }
 .note-row.active {
   background: color-mix(in srgb, var(--color-primary) 8%, var(--color-surface));
-  border-left-color: var(--color-primary);
+  border-right-color: var(--color-primary);
 }
 
 .note-row-main {
@@ -715,7 +715,6 @@ defineExpose({ reload: loadProjectNotes });
   display: flex;
   align-items: center;
   padding: 0.5rem 0.75rem;
-  border-bottom: 1px solid var(--color-border);
   flex-shrink: 0;
   gap: 0.5rem;
 }
@@ -742,8 +741,7 @@ defineExpose({ reload: loadProjectNotes });
 .btn-save:disabled { opacity: 0.4; cursor: default; }
 
 .note-title-row {
-  padding: 0.5rem 0.75rem;
-  border-bottom: 1px solid var(--color-border);
+  padding: 0.9rem 1.1rem 0.5rem;
   flex-shrink: 0;
 }
 
@@ -751,19 +749,25 @@ defineExpose({ reload: loadProjectNotes });
   width: 100%;
   background: transparent;
   border: none;
-  font-size: 1rem;
+  font-size: 1.4rem;
   font-weight: 600;
+  line-height: 1.25;
   color: var(--color-text);
   padding: 0;
+  font-family: 'Fraunces', serif;
+  letter-spacing: -0.01em;
 }
 .note-title-input:focus { outline: none; }
+.note-title-input::placeholder {
+  color: var(--color-text-muted);
+  font-style: italic;
+}
 
 .tag-row {
   display: flex;
   align-items: flex-start;
   gap: 0.4rem;
   padding: 0.4rem 0.6rem;
-  border-bottom: 1px solid var(--color-border);
   flex-shrink: 0;
 }
 .tag-row > :first-child { flex: 1; min-width: 0; }
@@ -789,7 +793,6 @@ defineExpose({ reload: loadProjectNotes });
   align-items: center;
   gap: 0.3rem;
   padding: 0.35rem 0.6rem;
-  border-bottom: 1px solid var(--color-border);
   background: color-mix(in srgb, var(--color-primary) 5%, var(--color-surface));
   flex-shrink: 0;
 }
@@ -824,7 +827,6 @@ defineExpose({ reload: loadProjectNotes });
 
 .toolbar-row {
   padding: 0.3rem 0.6rem;
-  border-bottom: 1px solid var(--color-border);
   flex-shrink: 0;
 }
 
@@ -834,7 +836,6 @@ defineExpose({ reload: loadProjectNotes });
   flex-wrap: wrap;
   gap: 0.25rem;
   padding: 0.3rem 0.6rem;
-  border-bottom: 1px solid var(--color-border);
   background: color-mix(in srgb, var(--color-primary) 5%, var(--color-surface));
   flex-shrink: 0;
 }

frontend/src/composables/useOnnxPreloader.ts

@@ -0,0 +1,43 @@
+import { ref, readonly } from 'vue'
+
+/**
+ * Idle-preload the Silero VAD ONNX model and its companion assets.
+ *
+ * `@ricky0123/vad-web` pulls ~2MB of ONNX model + ~5MB of onnxruntime-web
+ * WASM the first time `MicVAD.new()` runs. Calling `defaultModelFetcher`
+ * during page idle warms the browser cache so the first mic click feels
+ * instant. If the preload fails, VAD simply loads lazily on first click.
+ */
+const ready = ref(false)
+let loading = false
+
+export function useOnnxPreloader() {
+  async function preload() {
+    if (ready.value || loading) return
+    loading = true
+    try {
+      const { defaultModelFetcher } = await import('@ricky0123/vad-web')
+      // Asset lives at site root because vite-plugin-static-copy drops it
+      // there. Match whatever path MicVAD will use at call time (see useVad).
+      await defaultModelFetcher('/silero_vad_v5.onnx')
+      ready.value = true
+    } catch {
+      // Non-fatal — MicVAD will load the model itself on first use.
+    } finally {
+      loading = false
+    }
+  }
+
+  function schedulePreload() {
+    if (ready.value) return
+    if (typeof window === 'undefined') return
+    if ('requestIdleCallback' in window) {
+      (window as Window & { requestIdleCallback: (cb: () => void, opts: { timeout: number }) => void })
+        .requestIdleCallback(() => void preload(), { timeout: 5000 })
+    } else {
+      setTimeout(() => void preload(), 5000)
+    }
+  }
+
+  return { ready: readonly(ready), schedulePreload }
+}

frontend/src/composables/useSilenceDetector.ts

@@ -1,69 +0,0 @@
-import { ref, readonly } from 'vue'
-
-export interface SilenceDetectorOptions {
-  thresholdDb?: number       // default -40
-  silenceDurationMs?: number // default 1500
-  minRecordingMs?: number    // default 500
-}
-
-export function useSilenceDetector(options: SilenceDetectorOptions = {}) {
-  const {
-    thresholdDb = -40,
-    silenceDurationMs = 1500,
-    minRecordingMs = 500,
-  } = options
-
-  const amplitude = ref(0)
-  let audioCtx: AudioContext | null = null
-  let intervalId: ReturnType<typeof setInterval> | null = null
-  let silenceMs = 0
-  let startedAt = 0
-
-  function start(stream: MediaStream, onSilence: () => void): void {
-    stop()
-    audioCtx = new AudioContext()
-    // Some browsers start AudioContext in "suspended" state — resume so
-    // getByteFrequencyData returns real values instead of all zeros.
-    audioCtx.resume().catch(() => {})
-    const source = audioCtx.createMediaStreamSource(stream)
-    const analyser = audioCtx.createAnalyser()
-    analyser.fftSize = 256
-    source.connect(analyser)
-
-    const data = new Uint8Array(analyser.frequencyBinCount)
-    silenceMs = 0
-    startedAt = Date.now()
-
-    intervalId = setInterval(() => {
-      analyser.getByteFrequencyData(data)
-      const rms = Math.sqrt(data.reduce((s, v) => s + v * v, 0) / data.length) / 255
-      amplitude.value = rms
-
-      const db = rms > 0 ? 20 * Math.log10(rms) : -100
-      if (db < thresholdDb) {
-        silenceMs += 100
-        if (silenceMs >= silenceDurationMs && Date.now() - startedAt >= minRecordingMs) {
-          stop()
-          onSilence()
-        }
-      } else {
-        silenceMs = 0
-      }
-    }, 100)
-  }
-
-  function stop(): void {
-    if (intervalId !== null) {
-      clearInterval(intervalId)
-      intervalId = null
-    }
-    if (audioCtx) {
-      audioCtx.close().catch(() => {})
-      audioCtx = null
-    }
-    amplitude.value = 0
-    silenceMs = 0
-  }
-
-  return { amplitude: readonly(amplitude), start, stop }
-}

frontend/src/composables/useVad.ts

@@ -0,0 +1,154 @@
+import { ref, readonly } from 'vue'
+import type { MicVAD } from '@ricky0123/vad-web'
+
+export interface UseVadOptions {
+  onSpeechEnd: () => void
+  onNoSpeech: () => void
+  onVadError?: (message: string) => void
+  graceMs?: number
+  minRecordingMs?: number
+}
+
+/**
+ * Silero VAD-based speech detector.
+ *
+ * Replaces amplitude-based silence detection. Uses the Silero VAD v5 ONNX
+ * model via `@ricky0123/vad-web`. The package ships the model + audio
+ * worklet, and depends on `onnxruntime-web`'s WASM. Vite is configured
+ * (see `vite.config.ts`) to serve these assets from the site root, which
+ * is why we pass `baseAssetPath: "/"` and `onnxWASMBasePath: "/"`.
+ *
+ * `amplitude` is computed separately from a Web Audio API analyser node
+ * on the same stream — it drives the mic pulse animation and is not part
+ * of the stop decision. VAD's `onSpeechEnd` is the stop trigger.
+ *
+ * If VAD never detects speech during a session, calling `stopAndCheck()`
+ * fires `onNoSpeech` instead of treating the recording as transcribable.
+ */
+export function useVad(options: UseVadOptions) {
+  const {
+    onSpeechEnd,
+    onNoSpeech,
+    graceMs = 1500,
+    minRecordingMs = 500,
+  } = options
+
+  const speaking = ref(false)
+  const amplitude = ref(0)
+  const loaded = ref(false)
+
+  let micVad: MicVAD | null = null
+  let audioCtx: AudioContext | null = null
+  let analyserInterval: ReturnType<typeof setInterval> | null = null
+  let speechDetected = false
+  let speechStartedAt = 0
+  let recordingStartedAt = 0
+  let stopped = false
+
+  async function start(stream: MediaStream): Promise<void> {
+    await stop()
+    stopped = false
+    speechDetected = false
+    speechStartedAt = 0
+    recordingStartedAt = Date.now()
+
+    // Visual-only amplitude signal. This does NOT drive the stop decision.
+    audioCtx = new AudioContext()
+    await audioCtx.resume().catch(() => {})
+    const source = audioCtx.createMediaStreamSource(stream)
+    const analyser = audioCtx.createAnalyser()
+    analyser.fftSize = 1024
+    source.connect(analyser)
+    const samples = new Float32Array(analyser.fftSize)
+
+    analyserInterval = setInterval(() => {
+      analyser.getFloatTimeDomainData(samples)
+      let sumSq = 0
+      for (let i = 0; i < samples.length; i++) sumSq += samples[i] * samples[i]
+      const rms = Math.sqrt(sumSq / samples.length)
+      amplitude.value = Math.min(rms * 5, 1)
+    }, 100)
+
+    try {
+      const { MicVAD } = await import('@ricky0123/vad-web')
+      micVad = await MicVAD.new({
+        model: 'v5',
+        baseAssetPath: '/',
+        onnxWASMBasePath: '/',
+        // MicVAD manages its own audio graph, so we hand it the same stream
+        // the MediaRecorder is using. It won't consume or alter the stream.
+        getStream: async () => stream,
+        onSpeechStart: () => {
+          speaking.value = true
+          if (!speechDetected) {
+            speechDetected = true
+            speechStartedAt = Date.now()
+          }
+        },
+        onSpeechEnd: () => {
+          speaking.value = false
+          if (stopped) return
+          const now = Date.now()
+          const totalElapsed = now - recordingStartedAt
+          const sinceSpeechStart = speechStartedAt > 0 ? now - speechStartedAt : 0
+          if (totalElapsed >= minRecordingMs && sinceSpeechStart >= graceMs) {
+            stopped = true
+            onSpeechEnd()
+          }
+        },
+        onVADMisfire: () => {
+          // Speech-like blip that was too short to count. Reset the local flag
+          // so a true "no speech" session still hits onNoSpeech.
+          speaking.value = false
+        },
+      })
+      await micVad.start()
+      loaded.value = true
+    } catch (e) {
+      console.error('VAD init failed:', e)
+      options.onVadError?.(e instanceof Error ? e.message : String(e))
+    }
+  }
+
+  async function stop(): Promise<{ hadSpeech: boolean }> {
+    const had = speechDetected
+    stopped = true
+    speaking.value = false
+    amplitude.value = 0
+
+    if (analyserInterval !== null) {
+      clearInterval(analyserInterval)
+      analyserInterval = null
+    }
+    if (audioCtx) {
+      await audioCtx.close().catch(() => {})
+      audioCtx = null
+    }
+    if (micVad) {
+      try {
+        await micVad.pause()
+        await micVad.destroy()
+      } catch {
+        // Already destroyed or failed — nothing to clean up further.
+      }
+      micVad = null
+    }
+    return { hadSpeech: had }
+  }
+
+  async function stopAndCheck(): Promise<void> {
+    const { hadSpeech } = await stop()
+    if (!hadSpeech) {
+      onNoSpeech()
+    }
+  }
+
+  return {
+    speaking: readonly(speaking),
+    amplitude: readonly(amplitude),
+    loaded: readonly(loaded),
+    start,
+    stop,
+    stopAndCheck,
+  }
+}

frontend/src/router/index.ts

@@ -5,13 +5,16 @@ const router = createRouter({
   history: createWebHistory(),
   routes: [
     {
+      // Root lands on the journal. To revert to Knowledge as home, change
+      // the redirect target below to "/knowledge" (Knowledge stays a real
+      // route at /knowledge, so the swap is a one-line edit).
       path: "/",
-      name: "knowledge",
-      component: () => import("@/views/KnowledgeView.vue"),
+      redirect: "/journal",
     },
     {
       path: "/knowledge",
-      redirect: "/",
+      name: "knowledge",
+      component: () => import("@/views/KnowledgeView.vue"),
     },
     {
       path: "/login",
@@ -45,7 +48,7 @@ const router = createRouter({
     },
     {
       path: "/notes",
-      redirect: "/",
+      redirect: "/knowledge",
     },
     {
       path: "/notes/new",
@@ -117,14 +120,9 @@ const router = createRouter({
       component: () => import("@/views/CalendarView.vue"),
     },
     {
-      path: "/briefing",
-      name: "briefing",
-      component: () => import("@/views/BriefingView.vue"),
-    },
-    {
-      path: "/news",
-      name: "news",
-      component: () => import("@/views/NewsView.vue"),
+      path: "/journal",
+      name: "journal",
+      component: () => import("@/views/JournalView.vue"),
     },
     {
       path: "/settings",

frontend/src/views/BriefingView.vue

@@ -1,609 +0,0 @@
-<script setup lang="ts">
-import { ref, computed, onMounted, onUnmounted, watch, nextTick } from 'vue'
-import { useBackgroundRefresh } from '@/composables/useBackgroundRefresh'
-import { useChatStore } from '@/stores/chat'
-import ChatPanel from '@/components/ChatPanel.vue'
-import WeatherCard from '@/components/WeatherCard.vue'
-import BriefingSetupWizard from '@/components/BriefingSetupWizard.vue'
-import {
-  apiGet,
-  apiPost,
-  getBriefingConfig,
-  getBriefingConversations,
-  getBriefingToday,
-  triggerBriefingSlot,
-  postRssReaction,
-  deleteRssReaction,
-  getNewsItems,
-  type BriefingConversation,
-} from '@/api/client'
-import type { NewsItem } from '@/types/news'
-
-interface WeatherData {
-  location: string
-  fetched_at: string
-  current_temp: number
-  condition: string
-  today_high: number | null
-  today_low: number | null
-  yesterday_high: number | null
-  yesterday_low: number | null
-  wind_unit?: string
-  forecast: { day: string; condition: string; high: number; low: number; precip_probability: number | null; precip_mm: number | null; windspeed_max: number }[]
-}
-
-const chatStore = useChatStore()
-
-// Setup wizard
-const showWizard = ref(false)
-const wizardChecked = ref(false)
-
-async function checkSetup() {
-  const config = await getBriefingConfig()
-  if (!config.enabled) showWizard.value = true
-  wizardChecked.value = true
-}
-
-async function onWizardDone() {
-  showWizard.value = false
-  await loadAll()
-}
-
-// Conversations list for the dropdown
-const conversations = ref<BriefingConversation[]>([])
-const selectedConvId = ref<number | null>(null)
-const todayConvId = ref<number | null>(null)
-
-const isToday = computed(() => selectedConvId.value === todayConvId.value)
-
-// Weather panel (left column)
-const weatherData = ref<WeatherData[]>([])
-const tempUnit = ref<string>('C')
-
-interface CurrentConditions {
-  temperature: number | null;
-  windspeed: number | null;
-  description: string;
-  precip_next_3h: number[];
-  temp_unit: string;
-  location: string;
-}
-const currentConditions = ref<CurrentConditions | null>(null)
-let currentWeatherTimer: ReturnType<typeof setInterval> | null = null
-
-async function loadCurrentConditions() {
-  try {
-    currentConditions.value = await apiGet<CurrentConditions>('/api/briefing/weather/current')
-    // Patch the live temperature into the WeatherCard so it stays fresh
-    if (currentConditions.value?.temperature != null && weatherData.value.length > 0) {
-      weatherData.value[0] = { ...weatherData.value[0], current_temp: currentConditions.value.temperature }
-    }
-  } catch { /* silent — endpoint may not have locations configured */ }
-}
-
-async function loadWeather() {
-  try {
-    const data = await apiGet<{ locations: WeatherData[]; temp_unit: string }>('/api/briefing/weather')
-    weatherData.value = data.locations ?? []
-    tempUnit.value = data.temp_unit ?? 'C'
-  } catch { /* silent */ }
-}
-
-// News panel (right column)
-const newsItems = ref<NewsItem[]>([])
-
-async function loadNews() {
-  try {
-    const data = await getNewsItems({ days: 2, limit: 40 })
-    newsItems.value = data.items
-    // Seed reactions from API response
-    for (const item of data.items) {
-      if (reactions.value[item.id] === undefined) {
-        reactions.value[item.id] = item.reaction
-      }
-    }
-  } catch { /* silent */ }
-}
-
-async function loadAll() {
-  const [convList, today] = await Promise.all([
-    getBriefingConversations(),
-    getBriefingToday().catch(() => null),
-    loadWeather(),
-    loadNews(),
-    loadCurrentConditions(),
-  ])
-  conversations.value = convList
-  if (today) {
-    todayConvId.value = today.id
-    if (!convList.find((c) => c.id === today.id)) {
-      conversations.value = [
-        { id: today.id, title: today.title ?? 'Today', briefing_date: null, message_count: 0, created_at: new Date().toISOString() },
-        ...convList,
-      ]
-    }
-    selectedConvId.value = today.id
-    await chatStore.fetchConversation(today.id)
-  }
-}
-
-watch(selectedConvId, async (id) => {
-  if (!id) return
-  try {
-    await chatStore.fetchConversation(id)
-  } catch {
-    // Historical conversation unavailable — do nothing
-  }
-})
-
-async function discussArticle(item: NewsItem) {
-  if (!todayConvId.value || chatStore.streaming) return
-  if (!isToday.value) selectedConvId.value = todayConvId.value
-  await nextTick(() => {
-    document.querySelector('.briefing-center')?.scrollIntoView({ behavior: 'smooth', block: 'nearest' })
-  })
-  try {
-    await apiPost<{ assistant_message_id: number }>(`/api/briefing/articles/${item.id}/discuss`, { conv_id: todayConvId.value })
-  } catch {
-    return
-  }
-  await chatStore.fetchConversation(todayConvId.value)
-  await chatStore.reconnectIfGenerating(todayConvId.value)
-}
-
-// RSS reactions: map of rss_item_id -> 'up' | 'down' | null
-const reactions = ref<Record<number, 'up' | 'down' | null>>({})
-
-async function handleReaction(itemId: number, reaction: 'up' | 'down') {
-  const current = reactions.value[itemId]
-  reactions.value[itemId] = current === reaction ? null : reaction
-  try {
-    if (current === reaction) {
-      await deleteRssReaction(itemId)
-    } else {
-      await postRssReaction(itemId, reaction)
-    }
-  } catch {
-    reactions.value[itemId] = current ?? null
-  }
-}
-
-function formatRelativeDate(iso: string | null): string {
-  if (!iso) return ''
-  const d = new Date(iso)
-  const now = new Date()
-  const diffH = (now.getTime() - d.getTime()) / 3_600_000
-  if (diffH < 24) return `${Math.round(diffH)}h ago`
-  if (diffH < 48) return 'Yesterday'
-  return d.toLocaleDateString(undefined, { month: 'short', day: 'numeric' })
-}
-
-// Manual trigger
-const triggering = ref(false)
-async function triggerNow() {
-  triggering.value = true
-  try {
-    await triggerBriefingSlot('compilation')
-    // Guard: user may have navigated away during the long compilation
-    if (_mounted) await loadAll()
-  } finally {
-    if (_mounted) triggering.value = false
-  }
-}
-
-// Dropdown label
-function convLabel(c: BriefingConversation): string {
-  if (c.id === todayConvId.value) return 'Today'
-  if (c.briefing_date) {
-    const d = new Date(c.briefing_date)
-    return d.toLocaleDateString(undefined, { weekday: 'short', month: 'short', day: 'numeric' })
-  }
-  return c.title || 'Briefing'
-}
-
-// ─── Background refresh (no-flicker) ─────────────────────────────────────────
-async function _backgroundRefreshMessages() {
-  try {
-    const today = await getBriefingToday()
-    if (!today) return
-    if (_mounted && isToday.value && chatStore.currentConversation?.id === todayConvId.value) {
-      await chatStore.fetchConversation(today.id)
-    }
-    await loadNews()
-  } catch { /* silent — don't disturb the UI on network hiccup */ }
-}
-
-useBackgroundRefresh(
-  _backgroundRefreshMessages,
-  60_000,
-  () => !chatStore.streaming && isToday.value && !!todayConvId.value,
-)
-
-let _mounted = true
-onUnmounted(() => {
-  _mounted = false
-  if (currentWeatherTimer) clearInterval(currentWeatherTimer)
-})
-
-onMounted(async () => {
-  await checkSetup()
-  if (!showWizard.value) {
-    await loadAll()
-    // Poll current conditions every 30 minutes
-    currentWeatherTimer = setInterval(loadCurrentConditions, 30 * 60 * 1000)
-  }
-})
-</script>
-
-<template>
-  <div class="briefing-root">
-    <!-- Setup wizard overlay -->
-    <BriefingSetupWizard v-if="wizardChecked && showWizard" @done="onWizardDone" />
-
-    <!-- Main view -->
-    <div class="briefing-shell" v-if="wizardChecked && !showWizard">
-      <!-- Header spans all columns -->
-      <header class="briefing-header">
-        <div class="briefing-header-left">
-          <h1 class="briefing-title">Briefing</h1>
-          <span class="briefing-today-badge">{{ new Date().toLocaleDateString(undefined, { weekday: 'long', month: 'long', day: 'numeric' }) }}</span>
-        </div>
-        <div class="briefing-header-right">
-          <select v-if="conversations.length" v-model="selectedConvId" class="briefing-conv-select">
-            <option v-for="c in conversations" :key="c.id" :value="c.id">{{ convLabel(c) }}</option>
-          </select>
-          <button
-            class="btn-trigger"
-            @click="triggerNow"
-            :disabled="triggering"
-            title="Manually trigger morning briefing now"
-          >{{ triggering ? '…' : 'Refresh' }}</button>
-        </div>
-      </header>
-
-      <!-- Left column: Weather -->
-      <div class="briefing-left">
-        <div class="panel-label">Weather</div>
-        <!-- Forecast card -->
-        <template v-if="weatherData.length">
-          <WeatherCard
-            v-for="loc in weatherData"
-            :key="(loc as WeatherData).location"
-            :weather="loc"
-            :temp-unit="tempUnit"
-          />
-        </template>
-        <div v-else class="panel-empty">No weather configured</div>
-      </div>
-
-      <!-- Center column: Chat -->
-      <div class="briefing-center">
-        <ChatPanel
-          variant="full"
-          briefingMode
-          :readOnly="!isToday"
-          placeholder="Reply to your briefing…"
-          class="briefing-chat-panel"
-        />
-      </div>
-
-      <!-- Right column: News -->
-      <div class="briefing-right">
-        <div class="panel-label-row">
-          <div class="panel-label">Today's News</div>
-          <span v-if="newsItems.length" class="news-count">{{ newsItems.length }} items</span>
-        </div>
-        <div v-if="!newsItems.length" class="panel-empty">No articles in the last 2 days</div>
-        <div
-          v-for="item in newsItems"
-          :key="item.id"
-          class="news-card"
-        >
-          <div class="news-card-meta">
-            <span class="news-source">{{ item.source }}</span>
-            <span v-if="item.published_at" class="news-date">{{ formatRelativeDate(item.published_at) }}</span>
-          </div>
-          <a
-            v-if="item.url"
-            :href="item.url"
-            target="_blank"
-            rel="noopener noreferrer"
-            class="news-title"
-          >{{ item.title }}</a>
-          <p v-else class="news-title news-title--plain">{{ item.title }}</p>
-          <p v-if="item.snippet" class="news-snippet">{{ item.snippet }}</p>
-          <div class="news-reactions">
-            <button
-              class="reaction-btn"
-              :class="{ active: reactions[item.id] === 'up' }"
-              @click="handleReaction(item.id, 'up')"
-              title="Interested"
-            >👍</button>
-            <button
-              class="reaction-btn"
-              :class="{ active: reactions[item.id] === 'down' }"
-              @click="handleReaction(item.id, 'down')"
-              title="Not interested"
-            >👎</button>
-            <button
-              v-if="isToday && todayConvId"
-              class="reaction-btn discuss-btn"
-              @click="discussArticle(item)"
-              title="Discuss in briefing chat"
-            >💬</button>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-.briefing-root {
-  display: flex;
-  flex-direction: column;
-  height: 100%;
-  min-height: 0;
-}
-
-.briefing-shell {
-  display: grid;
-  grid-template-columns: 1fr 2fr 1fr;
-  grid-template-rows: auto 1fr;
-  height: 100%;
-  min-height: 0;
-}
-
-.briefing-header {
-  grid-column: 1 / -1;
-  grid-row: 1;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 1.25rem 1rem 1rem;
-  border-bottom: 1px solid var(--color-border);
-  flex-shrink: 0;
-  gap: 1rem;
-  flex-wrap: wrap;
-}
-
-.briefing-header-left {
-  display: flex;
-  align-items: baseline;
-  gap: 0.75rem;
-}
-
-.briefing-title {
-  font-family: 'Fraunces', Georgia, serif;
-  font-size: 1.3rem;
-  font-weight: 700;
-  margin: 0;
-  color: var(--color-text);
-}
-
-.briefing-today-badge {
-  font-size: 0.82rem;
-  color: var(--color-text-muted);
-}
-
-.briefing-header-right {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
-.briefing-conv-select {
-  padding: 0.35rem 0.6rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text);
-  font-size: 0.82rem;
-  cursor: pointer;
-  font-family: inherit;
-}
-
-.btn-trigger {
-  padding: 0.35rem 0.8rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text-muted);
-  font-size: 0.8rem;
-  cursor: pointer;
-  white-space: nowrap;
-  transition: all 0.15s;
-  font-family: inherit;
-}
-.btn-trigger:hover:not(:disabled) {
-  border-color: var(--color-primary);
-  color: var(--color-primary);
-}
-.btn-trigger:disabled { opacity: 0.5; cursor: not-allowed; }
-
-/* ─── Left column (Weather) ──────────────────────────────────────────────── */
-
-.briefing-left {
-  grid-column: 1;
-  grid-row: 2;
-  border-right: 1px solid var(--color-border);
-  overflow-y: auto;
-  padding: 1rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-}
-
-.briefing-left :deep(.weather-card) {
-  margin-bottom: 0;
-}
-
-/* ─── Center column (Chat) ───────────────────────────────────────────────── */
-
-.briefing-center {
-  grid-column: 2;
-  grid-row: 2;
-  display: flex;
-  flex-direction: column;
-  min-height: 0;
-}
-
-.briefing-chat-panel {
-  flex: 1;
-  min-height: 0;
-}
-
-/* ─── Right column (News) ────────────────────────────────────────────────── */
-
-.briefing-right {
-  grid-column: 3;
-  grid-row: 2;
-  border-left: 1px solid var(--color-border);
-  overflow-y: auto;
-  padding: 1rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.5rem;
-}
-
-.panel-label {
-  font-size: 0.72rem;
-  font-weight: 700;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-  color: var(--color-primary);
-  flex-shrink: 0;
-}
-
-.panel-label-row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  flex-shrink: 0;
-}
-
-.news-count {
-  font-size: 0.72rem;
-  color: var(--color-text-muted);
-}
-
-/* ── Current conditions (live) ─────────────────────────── */
-
-.panel-empty {
-  font-size: 0.82rem;
-  color: var(--color-text-muted);
-  padding: 0.5rem 0;
-}
-
-.news-card {
-  background: var(--color-bg-card);
-  border: 1px solid var(--color-border);
-  border-radius: 10px;
-  padding: 0.65rem 0.85rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.25rem;
-  flex-shrink: 0;
-}
-
-.news-card-meta {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
-.news-source {
-  font-size: 0.72rem;
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 0.04em;
-  color: var(--color-primary);
-}
-
-.news-date {
-  font-size: 0.72rem;
-  color: var(--color-text-muted);
-}
-
-.news-title {
-  font-size: 0.88rem;
-  font-weight: 600;
-  color: var(--color-text);
-  line-height: 1.35;
-  text-decoration: none;
-  margin: 0;
-}
-
-a.news-title:hover { text-decoration: underline; color: var(--color-primary); }
-
-.news-snippet {
-  font-size: 0.78rem;
-  color: var(--color-text-muted);
-  line-height: 1.45;
-  margin: 0;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-
-.news-reactions {
-  display: flex;
-  gap: 0.3rem;
-  margin-top: 0.15rem;
-}
-
-.reaction-btn {
-  background: none;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  padding: 0.1rem 0.35rem;
-  cursor: pointer;
-  font-size: 0.82rem;
-  line-height: 1.4;
-  opacity: 0.55;
-  transition: opacity 0.15s, border-color 0.15s;
-}
-
-.reaction-btn:hover {
-  opacity: 1;
-  border-color: var(--color-primary);
-}
-
-.reaction-btn.active {
-  opacity: 1;
-  border-color: var(--color-primary);
-  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
-}
-
-/* ─── Responsive ─────────────────────────────────────────────────────────── */
-
-@media (max-width: 900px) {
-  .briefing-shell {
-    grid-template-columns: 1fr;
-    grid-template-rows: auto auto 1fr auto;
-  }
-  .briefing-header {
-    grid-column: 1;
-    grid-row: 1;
-  }
-  .briefing-left {
-    grid-column: 1;
-    grid-row: 2;
-    border-right: none;
-    border-bottom: 1px solid var(--color-border);
-    max-height: 220px;
-  }
-  .briefing-center {
-    grid-column: 1;
-    grid-row: 3;
-  }
-  .briefing-right {
-    grid-column: 1;
-    grid-row: 4;
-    border-left: none;
-    border-top: 1px solid var(--color-border);
-    max-height: 260px;
-  }
-}
-</style>

frontend/src/views/ChatView.vue

@@ -2,6 +2,7 @@
 import { onMounted, onUnmounted, ref, computed, watch, nextTick } from "vue";
 import { useRoute, useRouter } from "vue-router";
 import { useChatStore } from "@/stores/chat";
+import { apiGet } from "@/api/client";
 import ChatPanel from "@/components/ChatPanel.vue";
 
 const route = useRoute();
@@ -10,6 +11,49 @@ const store = useChatStore();
 
 const summarizing = ref(false);
 const sidebarOpen = ref(false);
+const convSearchQuery = ref("");
+const headerKebabOpen = ref(false);
+const sidebarKebabOpen = ref(false);
+
+// ── RAG scope chip ────────────────────────────────────────────────────────────
+const projects = ref<{ id: number; title: string }[]>([]);
+const scopeDropdownOpen = ref(false);
+const scopePulse = ref(false);
+
+const scopeLabel = computed(() => {
+  const id = store.ragProjectId;
+  if (id === -1) return "All notes";
+  if (id === null) return "Orphan notes";
+  return projects.value.find((p) => p.id === id)?.title ?? `Project ${id}`;
+});
+
+async function loadProjects() {
+  try {
+    const data = await apiGet<{ projects: { id: number; title: string }[] }>(
+      "/api/projects?status=active"
+    );
+    projects.value = data.projects ?? [];
+  } catch {
+    projects.value = [];
+  }
+}
+
+async function onScopeSelect(value: number | null) {
+  scopeDropdownOpen.value = false;
+  const id = store.currentConversation?.id;
+  if (!id) return;
+  await store.updateRagScope(id, value);
+  scopePulse.value = true;
+  setTimeout(() => { scopePulse.value = false; }, 600);
+}
+
+watch(
+  () => store.ragProjectId,
+  () => {
+    scopePulse.value = true;
+    setTimeout(() => { scopePulse.value = false; }, 600);
+  }
+);
 
 let prevConvId: number | null = null;
 
@@ -46,7 +90,12 @@ const groupedConversations = computed((): ConvGroup[] => {
   const buckets: Record<string, typeof store.conversations> = {};
   const order: string[] = [];
 
-  for (const conv of store.conversations) {
+  const q = convSearchQuery.value.trim().toLowerCase();
+  const filtered = q
+    ? store.conversations.filter((c) => (c.title || "").toLowerCase().includes(q))
+    : store.conversations;
+
+  for (const conv of filtered) {
     const d = new Date(conv.updated_at);
     let key: string;
     if (d >= startOfToday) {
@@ -69,6 +118,8 @@ const groupedConversations = computed((): ConvGroup[] => {
 
 onMounted(async () => {
   document.addEventListener("keydown", onGlobalKeydown);
+  document.addEventListener("mousedown", onDocumentMousedown);
+  loadProjects();
   await store.fetchConversations();
   if (convId.value) {
     if (store.currentConversation?.id !== convId.value) {
@@ -187,36 +238,35 @@ async function handleSummarize() {
   }
 }
 
-// ── Research modal ────────────────────────────────────────────────────────────
-const showResearchModal = ref(false);
-const researchTopic = ref("");
 const chatPanelRef = ref<InstanceType<typeof ChatPanel> | null>(null);
 
-function toggleResearchModal() {
-  showResearchModal.value = !showResearchModal.value;
-  if (showResearchModal.value) {
-    researchTopic.value = "";
-    nextTick(() => {
-      const el = document.querySelector(".research-topic-input") as HTMLInputElement;
-      el?.focus();
-    });
-  }
+const contextCount = computed(() => chatPanelRef.value?.contextCount ?? 0);
+const contextSidebarOpen = computed(() => chatPanelRef.value?.sidebarOpen ?? false);
+function toggleContextSidebar() {
+  chatPanelRef.value?.toggleContextSidebar();
 }
 
-function submitResearch() {
-  const topic = researchTopic.value.trim();
-  if (!topic) return;
-  showResearchModal.value = false;
-  researchTopic.value = "";
-  // Prefill sends via ChatPanel — user sees it in the input, then it auto-submits
-  chatPanelRef.value?.send(`Research: ${topic}`);
+// ── Kebab dismissal ───────────────────────────────────────────────────────────
+function onDocumentMousedown(e: MouseEvent) {
+  const target = e.target as HTMLElement | null;
+  if (headerKebabOpen.value && !target?.closest(".header-kebab-wrapper")) {
+    headerKebabOpen.value = false;
+  }
+  if (sidebarKebabOpen.value && !target?.closest(".sidebar-kebab-wrapper")) {
+    sidebarKebabOpen.value = false;
+  }
+  if (scopeDropdownOpen.value && !target?.closest(".scope-chip-wrapper")) {
+    scopeDropdownOpen.value = false;
+  }
 }
 
 // ── Keyboard ──────────────────────────────────────────────────────────────────
 function onGlobalKeydown(e: KeyboardEvent) {
   if (e.key !== "Escape") return;
-  if (showResearchModal.value) {
-    showResearchModal.value = false;
+  if (headerKebabOpen.value || sidebarKebabOpen.value || scopeDropdownOpen.value) {
+    headerKebabOpen.value = false;
+    sidebarKebabOpen.value = false;
+    scopeDropdownOpen.value = false;
     return;
   }
   if (sidebarOpen.value) {
@@ -228,6 +278,7 @@ function onGlobalKeydown(e: KeyboardEvent) {
 
 onUnmounted(() => {
   document.removeEventListener("keydown", onGlobalKeydown);
+  document.removeEventListener("mousedown", onDocumentMousedown);
   if (prevConvId) {
     const conv = store.conversations.find((c) => c.id === prevConvId);
     if (conv && conv.message_count === 0) {
@@ -246,13 +297,35 @@ onUnmounted(() => {
     ></div>
     <aside class="chat-sidebar" :class="{ open: sidebarOpen }">
       <div class="sidebar-top-bar">
-        <button class="btn-new-conv" @click="newConversation">+ New Chat</button>
-        <button
-          class="btn-select-mode"
-          :class="{ active: selectMode }"
-          @click="toggleSelectMode"
-          title="Select conversations"
-        >Select</button>
+        <button class="btn-new-conv btn-new-conv--full" @click="newConversation">+ New Chat</button>
+        <div class="sidebar-search-row">
+          <input
+            v-model="convSearchQuery"
+            class="conv-search-input"
+            type="search"
+            placeholder="Search conversations…"
+            aria-label="Search conversations"
+          />
+          <div class="sidebar-kebab-wrapper">
+            <button
+              class="btn-kebab"
+              :class="{ active: sidebarKebabOpen }"
+              @click="sidebarKebabOpen = !sidebarKebabOpen"
+              aria-label="List actions"
+              title="List actions"
+            >
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor">
+                <circle cx="12" cy="5" r="1.75"/><circle cx="12" cy="12" r="1.75"/><circle cx="12" cy="19" r="1.75"/>
+              </svg>
+            </button>
+            <div v-if="sidebarKebabOpen" class="kebab-menu">
+              <button
+                class="kebab-item"
+                @click="sidebarKebabOpen = false; toggleSelectMode()"
+              >{{ selectMode ? "Exit select mode" : "Select conversations" }}</button>
+            </div>
+          </div>
+        </div>
       </div>
 
       <div v-if="selectMode" class="bulk-bar">
@@ -304,6 +377,10 @@ onUnmounted(() => {
         <p v-if="!store.conversations.length" class="empty-msg">
           No conversations yet
         </p>
+        <p
+          v-else-if="convSearchQuery && !groupedConversations.length"
+          class="empty-msg"
+        >No matches for “{{ convSearchQuery }}”</p>
       </div>
     </aside>
 
@@ -319,40 +396,68 @@ onUnmounted(() => {
           </button>
           <h2>{{ store.currentConversation.title || "New Chat" }}</h2>
 
-          <!-- Research modal trigger -->
-          <div class="research-wrapper">
+          <div class="scope-chip-wrapper">
             <button
-              class="btn-attach"
-              @click="toggleResearchModal"
-              :disabled="store.streaming || !store.chatReady"
-              title="Research a topic"
+              class="scope-chip"
+              :class="{ pulse: scopePulse }"
+              @click="scopeDropdownOpen = !scopeDropdownOpen"
+              title="Change RAG scope"
             >
-              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                <circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/>
-              </svg>
+              <span class="scope-dot">⊙</span> {{ scopeLabel }}
             </button>
-            <div v-if="showResearchModal" class="research-modal">
-              <div class="research-modal-header">Research topic</div>
-              <input
-                class="research-topic-input"
-                v-model="researchTopic"
-                placeholder="e.g. quantum computing"
-                @keydown.enter="submitResearch"
-                @keydown.escape="showResearchModal = false"
-              />
-              <div class="research-modal-actions">
-                <button class="btn-research-cancel" @click="showResearchModal = false">Cancel</button>
-                <button class="btn-research-go" @click="submitResearch" :disabled="!researchTopic.trim()">Go</button>
-              </div>
+            <div v-if="scopeDropdownOpen" class="scope-dropdown">
+              <button
+                class="scope-option"
+                :class="{ active: store.ragProjectId === null }"
+                @click="onScopeSelect(null)"
+              >Orphan notes only</button>
+              <button
+                v-for="p in projects"
+                :key="p.id"
+                class="scope-option"
+                :class="{ active: store.ragProjectId === p.id }"
+                @click="onScopeSelect(p.id)"
+              >{{ p.title }}</button>
+              <button
+                class="scope-option"
+                :class="{ active: store.ragProjectId === -1 }"
+                @click="onScopeSelect(-1)"
+              >All notes</button>
             </div>
           </div>
 
           <button
-            v-if="store.currentConversation.messages.length"
-            class="btn-summarize"
-            @click="handleSummarize"
-            :disabled="summarizing || store.streaming"
-          >{{ summarizing ? "Summarizing..." : "Summarize as Note" }}</button>
+            v-if="contextCount > 0"
+            class="btn-context-toggle"
+            :class="{ active: contextSidebarOpen }"
+            @click="toggleContextSidebar"
+            :title="contextSidebarOpen ? 'Hide context panel' : 'Show context panel'"
+          >
+            <span class="context-icon">📎</span>
+            <span class="context-label">Context</span>
+            <span class="context-count-badge">{{ contextCount }}</span>
+          </button>
+
+          <div class="header-kebab-wrapper">
+            <button
+              class="btn-kebab"
+              :class="{ active: headerKebabOpen }"
+              @click="headerKebabOpen = !headerKebabOpen"
+              aria-label="Conversation actions"
+              title="Conversation actions"
+            >
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor">
+                <circle cx="12" cy="5" r="1.75"/><circle cx="12" cy="12" r="1.75"/><circle cx="12" cy="19" r="1.75"/>
+              </svg>
+            </button>
+            <div v-if="headerKebabOpen" class="kebab-menu kebab-menu--right">
+              <button
+                class="kebab-item"
+                :disabled="!store.currentConversation.messages.length || summarizing || store.streaming"
+                @click="headerKebabOpen = false; handleSummarize()"
+              >{{ summarizing ? "Summarizing…" : "Summarize as Note" }}</button>
+            </div>
+          </div>
         </div>
 
         <ChatPanel
@@ -397,12 +502,12 @@ onUnmounted(() => {
 
 .sidebar-top-bar {
   display: flex;
+  flex-direction: column;
   gap: 0.5rem;
   padding: 0.75rem;
 }
 
 .btn-new-conv {
-  flex: 1;
   padding: 0.5rem;
   background: var(--color-primary);
   color: #fff;
@@ -412,23 +517,31 @@ onUnmounted(() => {
   font-size: 0.9rem;
   transition: box-shadow 0.15s, opacity 0.15s;
 }
+.btn-new-conv--full { width: 100%; }
 .btn-new-conv:hover {
   opacity: 0.9;
   box-shadow: 0 0 14px rgba(129, 140, 248, 0.35);
 }
 
-.btn-select-mode {
-  background: none;
+.sidebar-search-row {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+}
+.conv-search-input {
+  flex: 1;
+  min-width: 0;
+  padding: 0.4rem 0.6rem;
   border: 1px solid var(--color-border);
   border-radius: var(--radius-sm);
-  color: var(--color-text-muted);
-  font-size: 0.82rem;
-  padding: 0.4rem 0.6rem;
-  cursor: pointer;
-  white-space: nowrap;
+  background: var(--color-bg);
+  color: var(--color-text);
+  font-size: 0.85rem;
+  outline: none;
+  font-family: inherit;
 }
-.btn-select-mode:hover,
-.btn-select-mode.active { border-color: var(--color-primary); color: var(--color-primary); }
+.conv-search-input:focus { border-color: var(--color-primary); }
+.conv-search-input::placeholder { color: var(--color-text-muted); }
 
 .bulk-bar {
   display: flex;
@@ -522,12 +635,12 @@ onUnmounted(() => {
   overflow: hidden;
 }
 
-/* ChatPanel fills the remaining space in chat-main */
+/* ChatPanel fills the remaining space in chat-main. Layout (grid vs
+ * flex) is owned by ChatPanel's own .chat-full root — don't force a
+ * display here or it overrides the grid. */
 .chat-panel-fill {
   flex: 1;
   min-height: 0;
-  display: flex;
-  flex-direction: column;
 }
 
 .chat-header {
@@ -548,87 +661,138 @@ onUnmounted(() => {
   min-width: 0;
 }
 
-.btn-summarize {
-  padding: 0.3rem 0.75rem;
-  background: var(--color-bg-secondary);
-  color: var(--color-text);
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-sm);
-  cursor: pointer;
-  font-size: 0.85rem;
-  white-space: nowrap;
-}
-.btn-summarize:hover:not(:disabled) {
-  background: var(--color-primary); color: #fff; border-color: var(--color-primary);
-}
-.btn-summarize:disabled { opacity: 0.6; cursor: default; }
-
-.btn-attach {
+/* Kebab button + dropdown menu — shared by header and sidebar */
+.btn-kebab {
   background: none;
   border: none;
   cursor: pointer;
   color: var(--color-text-muted);
-  opacity: 0.6;
-  padding: 0.2rem;
+  padding: 0.25rem;
   display: flex;
   align-items: center;
+  justify-content: center;
+  border-radius: var(--radius-sm);
+  flex-shrink: 0;
 }
-.btn-attach:hover { opacity: 1; }
-.btn-attach:disabled { opacity: 0.25; cursor: default; }
+.btn-kebab:hover { color: var(--color-text); background: var(--color-bg-secondary); }
+.btn-kebab.active { color: var(--color-primary); }
 
-.research-wrapper { position: relative; }
-.research-modal {
+.header-kebab-wrapper,
+.sidebar-kebab-wrapper {
+  position: relative;
+}
+
+/* RAG scope chip (header) */
+.scope-chip-wrapper { position: relative; flex-shrink: 0; }
+.scope-chip {
+  display: flex;
+  align-items: center;
+  gap: 0.3rem;
+  background: none;
+  border: 1px solid var(--color-border);
+  border-radius: 20px;
+  padding: 0.2rem 0.65rem;
+  font-size: 0.75rem;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  transition: border-color 0.15s, color 0.15s;
+}
+.scope-chip:hover { border-color: var(--color-primary); color: var(--color-primary); }
+.scope-chip.pulse { animation: pulse-chip 0.6s ease; }
+@keyframes pulse-chip {
+  0%, 100% { border-color: var(--color-border); }
+  50% {
+    border-color: var(--color-primary);
+    color: var(--color-primary);
+    box-shadow: 0 0 6px rgba(99, 102, 241, 0.4);
+  }
+}
+.scope-dot { font-size: 0.6rem; }
+.scope-dropdown {
   position: absolute;
-  top: calc(100% + 8px);
+  top: calc(100% + 4px);
   right: 0;
+  min-width: 200px;
+  background: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  box-shadow: 0 4px 16px var(--color-shadow);
+  z-index: 20;
+  overflow: hidden;
+}
+.scope-option {
+  display: block;
+  width: 100%;
+  padding: 0.45rem 0.75rem;
+  text-align: left;
+  background: none;
+  border: none;
+  font-size: 0.85rem;
+  color: var(--color-text);
+  cursor: pointer;
+}
+.scope-option:hover { background: var(--color-bg-secondary); }
+.scope-option.active { color: var(--color-primary); font-weight: 600; }
+
+/* Context toggle button (header) */
+.btn-context-toggle {
+  display: flex;
+  align-items: center;
+  gap: 0.3rem;
+  background: none;
+  border: 1px solid var(--color-border);
+  border-radius: 20px;
+  padding: 0.2rem 0.55rem;
+  font-size: 0.75rem;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  flex-shrink: 0;
+  transition: border-color 0.15s, color 0.15s, background 0.15s;
+  font-family: inherit;
+}
+.btn-context-toggle:hover { border-color: var(--color-primary); color: var(--color-primary); }
+.btn-context-toggle.active {
+  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
+  border-color: var(--color-primary);
+  color: var(--color-primary);
+}
+.context-icon { font-size: 0.85rem; line-height: 1; }
+.context-count-badge {
+  font-size: 0.65rem;
+  font-weight: 700;
+  background: var(--color-bg);
+  padding: 0.05rem 0.35rem;
+  border-radius: 8px;
+  color: var(--color-text);
+}
+
+.kebab-menu {
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  min-width: 180px;
   background: var(--color-bg-card);
   border: 1px solid var(--color-border);
   border-radius: var(--radius-md);
   box-shadow: 0 4px 20px var(--color-shadow);
-  padding: 0.75rem;
-  min-width: 280px;
+  padding: 0.25rem;
   z-index: 20;
 }
-.research-modal-header {
-  font-size: 0.8rem;
-  font-weight: 600;
-  color: var(--color-text-muted);
-  margin-bottom: 0.5rem;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-}
-.research-topic-input {
+.kebab-menu--right { left: auto; right: 0; }
+.kebab-item {
+  display: block;
   width: 100%;
-  padding: 0.45rem 0.65rem;
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-sm);
-  background: var(--color-bg);
+  text-align: left;
+  background: none;
+  border: none;
   color: var(--color-text);
-  font-size: 0.9rem;
-  outline: none;
-  font-family: inherit;
-  box-sizing: border-box;
+  font-size: 0.85rem;
+  padding: 0.45rem 0.65rem;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
 }
-.research-topic-input:focus { border-color: var(--color-primary); }
-.research-modal-actions {
-  display: flex;
-  gap: 0.5rem;
-  margin-top: 0.5rem;
-  justify-content: flex-end;
-}
-.btn-research-cancel {
-  background: none; border: 1px solid var(--color-border);
-  border-radius: var(--radius-sm); padding: 0.3rem 0.65rem;
-  font-size: 0.85rem; cursor: pointer; color: var(--color-text-muted);
-}
-.btn-research-cancel:hover { border-color: var(--color-text-muted); }
-.btn-research-go {
-  background: var(--color-primary); color: #fff; border: none;
-  border-radius: var(--radius-sm); padding: 0.3rem 0.75rem;
-  font-size: 0.85rem; cursor: pointer; font-weight: 600;
-}
-.btn-research-go:disabled { opacity: 0.4; cursor: default; }
-.btn-research-go:not(:disabled):hover { opacity: 0.9; }
+.kebab-item:hover:not(:disabled) { background: var(--color-bg-secondary); color: var(--color-primary); }
+.kebab-item:disabled { opacity: 0.4; cursor: default; }
 
 .no-conversation {
   flex: 1;
@@ -639,6 +803,9 @@ onUnmounted(() => {
   gap: 1rem;
   color: var(--color-text-muted);
 }
+.no-conversation .btn-new-conv {
+  flex: none;
+}
 
 .empty-msg {
   color: var(--color-text-muted);

frontend/src/views/JournalView.vue

@@ -0,0 +1,535 @@
+<script setup lang="ts">
+import { ref, computed, onMounted, onUnmounted, watch } from 'vue'
+import { useBackgroundRefresh } from '@/composables/useBackgroundRefresh'
+import { useChatStore } from '@/stores/chat'
+import ChatPanel from '@/components/ChatPanel.vue'
+import WeatherCard from '@/components/WeatherCard.vue'
+import {
+  apiGet,
+  apiPost,
+  getJournalToday,
+  getJournalDay,
+  getJournalDays,
+  triggerJournalPrep,
+  listEvents,
+  type EventEntry,
+} from '@/api/client'
+
+interface WeatherDay {
+  day: string
+  condition: string
+  high: number
+  low: number
+  precip_probability: number | null
+  precip_mm: number | null
+  windspeed_max: number
+}
+interface WeatherData {
+  location: string
+  fetched_at: string
+  current_temp: number
+  condition: string
+  today_high: number | null
+  today_low: number | null
+  yesterday_high: number | null
+  yesterday_low: number | null
+  wind_unit?: string
+  forecast: WeatherDay[]
+}
+interface CurrentConditions {
+  temperature: number | null
+  windspeed: number | null
+  description: string
+  precip_next_3h: number[]
+  temp_unit: string
+  location: string
+}
+
+const chatStore = useChatStore()
+
+// ── Day picker + conversation state ──────────────────────────────────────────
+const days = ref<string[]>([])
+const todayDate = ref<string | null>(null)
+const selectedDay = ref<string | null>(null)
+const dayConvId = ref<number | null>(null)
+const isToday = computed(() => selectedDay.value !== null && selectedDay.value === todayDate.value)
+
+// ── Weather panel ────────────────────────────────────────────────────────────
+const weatherData = ref<WeatherData[]>([])
+const selectedWeatherIdx = ref(0)
+const tempUnit = ref<string>('C')
+const currentConditions = ref<CurrentConditions | null>(null)
+let currentWeatherTimer: ReturnType<typeof setInterval> | null = null
+
+async function loadCurrentConditions() {
+  try {
+    currentConditions.value = await apiGet<CurrentConditions>('/api/journal/weather/current')
+    if (currentConditions.value?.temperature != null && weatherData.value.length > 0) {
+      weatherData.value[0] = { ...weatherData.value[0], current_temp: currentConditions.value.temperature }
+    }
+  } catch { /* silent */ }
+}
+
+async function loadWeather() {
+  try {
+    const data = await apiGet<{ locations: WeatherData[]; temp_unit: string }>('/api/journal/weather')
+    weatherData.value = data.locations ?? []
+    tempUnit.value = data.temp_unit ?? 'C'
+  } catch { /* silent */ }
+}
+
+const refreshingWeather = ref(false)
+async function refreshWeather() {
+  refreshingWeather.value = true
+  try {
+    const data = await apiPost<{ locations: WeatherData[]; temp_unit: string }>('/api/journal/weather/refresh', {})
+    weatherData.value = data.locations ?? []
+    tempUnit.value = data.temp_unit ?? 'C'
+  } catch { /* silent */ }
+  finally { refreshingWeather.value = false }
+}
+
+// ── Upcoming events ──────────────────────────────────────────────────────────
+const upcomingEvents = ref<EventEntry[]>([])
+
+interface GroupedDay {
+  label: string
+  dateKey: string
+  events: EventEntry[]
+}
+
+const groupedEvents = computed<GroupedDay[]>(() => {
+  const groups = new Map<string, EventEntry[]>()
+  const today = new Date()
+  today.setHours(0, 0, 0, 0)
+  for (const ev of upcomingEvents.value) {
+    const d = new Date(ev.start_dt)
+    const key = d.toISOString().slice(0, 10)
+    if (!groups.has(key)) groups.set(key, [])
+    groups.get(key)!.push(ev)
+  }
+  const result: GroupedDay[] = []
+  for (const [key, events] of groups) {
+    const d = new Date(key + 'T00:00:00')
+    const diff = Math.round((d.getTime() - today.getTime()) / 86_400_000)
+    let label: string
+    if (diff === 0) label = 'Today'
+    else if (diff === 1) label = 'Tomorrow'
+    else label = d.toLocaleDateString(undefined, { weekday: 'short', month: 'short', day: 'numeric' })
+    result.push({ label, dateKey: key, events })
+  }
+  return result
+})
+
+function formatEventTime(ev: EventEntry): string {
+  if (ev.all_day) return 'All day'
+  const d = new Date(ev.start_dt)
+  return d.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })
+}
+
+async function loadEvents() {
+  try {
+    const now = new Date()
+    const end = new Date(now)
+    end.setDate(end.getDate() + 14)
+    upcomingEvents.value = await listEvents(now.toISOString(), end.toISOString())
+  } catch { /* silent */ }
+}
+
+// ── Day load + switch ────────────────────────────────────────────────────────
+async function loadDay(iso: string) {
+  const payload = iso === todayDate.value ? await getJournalToday() : await getJournalDay(iso)
+  if (payload.conversation) {
+    dayConvId.value = payload.conversation.id
+    await chatStore.fetchConversation(payload.conversation.id)
+  } else {
+    dayConvId.value = null
+  }
+}
+
+async function loadAll() {
+  try {
+    const today = await getJournalToday()
+    todayDate.value = today.day_date
+    selectedDay.value = today.day_date
+    if (today.conversation) {
+      dayConvId.value = today.conversation.id
+      await chatStore.fetchConversation(today.conversation.id)
+    }
+  } catch { /* silent */ }
+
+  try {
+    days.value = await getJournalDays()
+    if (todayDate.value && !days.value.includes(todayDate.value)) {
+      days.value = [todayDate.value, ...days.value]
+    }
+  } catch { /* silent */ }
+
+  await Promise.all([loadWeather(), loadCurrentConditions(), loadEvents()])
+}
+
+watch(selectedDay, async (iso) => {
+  if (!iso || iso === todayDate.value) return
+  try { await loadDay(iso) } catch { /* silent */ }
+})
+
+// ── Manual prep regeneration ─────────────────────────────────────────────────
+const triggering = ref(false)
+async function triggerPrep() {
+  if (triggering.value) return
+  triggering.value = true
+  try {
+    await triggerJournalPrep()
+    if (_mounted) await loadAll()
+  } finally {
+    if (_mounted) triggering.value = false
+  }
+}
+
+function dayLabel(iso: string): string {
+  if (iso === todayDate.value) return 'Today'
+  const d = new Date(iso + 'T00:00:00')
+  return d.toLocaleDateString(undefined, { weekday: 'short', month: 'short', day: 'numeric' })
+}
+
+const todayBadge = computed(() => {
+  return new Date().toLocaleDateString(undefined, { weekday: 'long', month: 'long', day: 'numeric' })
+})
+
+// ── Background refresh ───────────────────────────────────────────────────────
+async function _backgroundRefreshMessages() {
+  try {
+    if (!_mounted || !isToday.value || !dayConvId.value) return
+    await chatStore.fetchConversation(dayConvId.value)
+  } catch { /* silent */ }
+}
+
+useBackgroundRefresh(
+  _backgroundRefreshMessages,
+  60_000,
+  () => !chatStore.streaming && isToday.value && !!dayConvId.value,
+)
+
+let _mounted = true
+onUnmounted(() => {
+  _mounted = false
+  if (currentWeatherTimer) clearInterval(currentWeatherTimer)
+})
+
+onMounted(async () => {
+  await loadAll()
+  currentWeatherTimer = setInterval(loadCurrentConditions, 30 * 60 * 1000)
+})
+</script>
+
+<template>
+  <div class="journal-root">
+    <div class="journal-shell">
+      <header class="journal-header">
+        <div class="journal-header-left">
+          <h1 class="journal-title">Journal</h1>
+          <span class="journal-today-badge">{{ todayBadge }}</span>
+        </div>
+        <div class="journal-header-right">
+          <select v-if="days.length" v-model="selectedDay" class="journal-day-select">
+            <option v-for="d in days" :key="d" :value="d">{{ dayLabel(d) }}</option>
+          </select>
+          <button
+            class="btn-trigger"
+            @click="triggerPrep"
+            :disabled="triggering || !isToday"
+            title="Regenerate today's daily prep"
+          >{{ triggering ? '…' : 'Refresh prep' }}</button>
+        </div>
+      </header>
+
+      <!-- Center: chat (prep is the first assistant message inside) -->
+      <div class="journal-center">
+        <ChatPanel
+          variant="full"
+          briefingMode
+          :readOnly="!isToday"
+          placeholder="Tell your journal…"
+          class="journal-chat-panel"
+        />
+      </div>
+
+      <!-- Right: Weather + Events + News -->
+      <div class="journal-right">
+        <div class="weather-section" v-if="weatherData.length">
+          <div class="weather-section-header">
+            <div class="weather-tabs" v-if="weatherData.length > 1">
+              <button
+                v-for="(loc, i) in weatherData"
+                :key="(loc as WeatherData).location"
+                class="weather-tab"
+                :class="{ active: selectedWeatherIdx === i }"
+                @click="selectedWeatherIdx = i"
+              >{{ (loc as WeatherData).location }}</button>
+            </div>
+            <button
+              class="weather-refresh-btn"
+              :class="{ spinning: refreshingWeather }"
+              :disabled="refreshingWeather"
+              @click="refreshWeather"
+              title="Refresh weather"
+            >↻</button>
+          </div>
+          <WeatherCard
+            :weather="weatherData[selectedWeatherIdx]"
+            :temp-unit="tempUnit"
+          />
+        </div>
+
+        <div class="events-section" v-if="groupedEvents.length">
+          <div class="panel-label-row">
+            <div class="panel-label">Upcoming</div>
+            <router-link to="/calendar" class="events-cal-link">Calendar →</router-link>
+          </div>
+          <div class="events-list">
+            <div v-for="group in groupedEvents" :key="group.dateKey" class="events-day-group">
+              <div class="events-day-label">{{ group.label }}</div>
+              <div v-for="ev in group.events" :key="ev.id" class="event-row">
+                <span class="event-dot" :style="ev.color ? { background: ev.color } : {}"></span>
+                <span class="event-body">
+                  <span class="event-title">{{ ev.title }}</span>
+                  <span class="event-time">{{ formatEventTime(ev) }}</span>
+                  <span v-if="ev.location" class="event-loc">{{ ev.location }}</span>
+                </span>
+              </div>
+            </div>
+          </div>
+        </div>
+
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.journal-root {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  min-height: 0;
+}
+
+.journal-shell {
+  display: grid;
+  grid-template-columns: 1fr minmax(320px, 35%);
+  grid-template-rows: auto 1fr;
+  height: 100%;
+  min-height: 0;
+}
+
+.journal-header {
+  grid-column: 1 / -1;
+  grid-row: 1;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1.25rem 1rem 1rem;
+  border-bottom: 1px solid var(--color-border);
+  flex-shrink: 0;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+.journal-header-left { display: flex; align-items: baseline; gap: 0.75rem; }
+.journal-title {
+  font-family: 'Fraunces', Georgia, serif;
+  font-size: 1.3rem;
+  font-weight: 700;
+  margin: 0;
+  color: var(--color-text);
+}
+.journal-today-badge { font-size: 0.82rem; color: var(--color-text-muted); }
+.journal-header-right { display: flex; align-items: center; gap: 0.5rem; }
+
+.journal-day-select {
+  padding: 0.35rem 0.6rem;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  background: var(--color-bg-card);
+  color: var(--color-text);
+  font-size: 0.82rem;
+  cursor: pointer;
+  font-family: inherit;
+}
+
+.btn-trigger {
+  padding: 0.35rem 0.8rem;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  background: var(--color-bg-card);
+  color: var(--color-text-muted);
+  font-size: 0.8rem;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: all 0.15s;
+  font-family: inherit;
+}
+.btn-trigger:hover:not(:disabled) { border-color: var(--color-primary); color: var(--color-primary); }
+.btn-trigger:disabled { opacity: 0.5; cursor: not-allowed; }
+
+/* ── Center column: prep card + chat ──────────────────────────────────────── */
+.journal-center {
+  grid-column: 1;
+  grid-row: 2;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+
+.journal-chat-panel { flex: 1; min-height: 0; }
+
+/* ── Right column ─────────────────────────────────────────────────────────── */
+.journal-right {
+  grid-column: 2;
+  grid-row: 2;
+  border-left: 1px solid var(--color-border);
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+
+.weather-section { flex-shrink: 0; padding: 1rem 1rem 0.5rem; }
+.weather-section :deep(.weather-card) { margin-bottom: 0; }
+.weather-section-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 0.5rem;
+}
+
+.weather-refresh-btn {
+  background: none;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  color: var(--color-text-muted);
+  font-size: 1rem;
+  cursor: pointer;
+  padding: 0.2rem 0.45rem;
+  line-height: 1;
+  transition: all 0.15s;
+}
+.weather-refresh-btn:hover { border-color: var(--color-primary); color: var(--color-primary); }
+.weather-refresh-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+.weather-refresh-btn.spinning { animation: spin 0.8s linear infinite; }
+@keyframes spin { to { transform: rotate(360deg); } }
+
+.weather-tabs { display: flex; gap: 0.25rem; }
+.weather-tab {
+  padding: 0.3rem 0.7rem;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  background: none;
+  color: var(--color-text-muted);
+  font-size: 0.78rem;
+  font-family: inherit;
+  cursor: pointer;
+  transition: all 0.15s;
+}
+.weather-tab:hover { border-color: var(--color-primary); color: var(--color-primary); }
+.weather-tab.active {
+  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
+  border-color: var(--color-primary);
+  color: var(--color-primary);
+  font-weight: 600;
+}
+
+.events-section { padding: 0.75rem 1rem; border-top: 1px solid var(--color-border); }
+.events-cal-link { font-size: 0.75rem; color: var(--color-text-muted); text-decoration: none; }
+.events-cal-link:hover { color: var(--color-primary); }
+.events-list { display: flex; flex-direction: column; gap: 0.6rem; }
+.events-day-group { display: flex; flex-direction: column; gap: 0.2rem; }
+.events-day-label {
+  font-size: 0.72rem;
+  font-weight: 700;
+  color: var(--color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+.event-row { display: flex; align-items: flex-start; gap: 0.4rem; padding: 0.25rem 0.4rem; border-radius: 6px; }
+.event-row:hover { background: color-mix(in srgb, var(--color-primary) 6%, transparent); }
+.event-dot {
+  width: 7px; height: 7px; border-radius: 50%;
+  background: var(--color-primary);
+  flex-shrink: 0; margin-top: 5px;
+}
+.event-body { display: flex; flex-direction: column; gap: 0.05rem; min-width: 0; }
+.event-title { font-size: 0.82rem; font-weight: 600; color: var(--color-text); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.event-time { font-size: 0.72rem; color: var(--color-text-muted); }
+.event-loc { font-size: 0.7rem; color: var(--color-text-muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+
+.news-section {
+  flex: 1;
+  overflow-y: auto;
+  padding: 0.75rem 1rem 1rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.panel-label {
+  font-size: 0.72rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: var(--color-primary);
+  flex-shrink: 0;
+}
+.panel-label-row { display: flex; align-items: center; justify-content: space-between; flex-shrink: 0; }
+.news-count { font-size: 0.72rem; color: var(--color-text-muted); }
+.panel-empty { font-size: 0.82rem; color: var(--color-text-muted); padding: 0.5rem 0; }
+
+.news-card {
+  background: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  border-radius: 10px;
+  padding: 0.65rem 0.85rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  flex-shrink: 0;
+}
+.news-card-meta { display: flex; align-items: center; gap: 0.5rem; }
+.news-source { font-size: 0.72rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.04em; color: var(--color-primary); }
+.news-date { font-size: 0.72rem; color: var(--color-text-muted); }
+.news-title { font-size: 0.88rem; font-weight: 600; color: var(--color-text); line-height: 1.35; text-decoration: none; margin: 0; }
+a.news-title:hover { text-decoration: underline; color: var(--color-primary); }
+.news-snippet {
+  font-size: 0.78rem;
+  color: var(--color-text-muted);
+  line-height: 1.45;
+  margin: 0;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+.news-reactions { display: flex; gap: 0.3rem; margin-top: 0.15rem; }
+.reaction-btn {
+  background: none;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  padding: 0.1rem 0.35rem;
+  cursor: pointer;
+  font-size: 0.82rem;
+  line-height: 1.4;
+  opacity: 0.55;
+  transition: opacity 0.15s, border-color 0.15s;
+}
+.reaction-btn:hover { opacity: 1; border-color: var(--color-primary); }
+.reaction-btn.active { opacity: 1; border-color: var(--color-primary); background: color-mix(in srgb, var(--color-primary) 12%, transparent); }
+
+@media (max-width: 900px) {
+  .journal-shell { grid-template-columns: 1fr; grid-template-rows: auto 1fr auto; }
+  .journal-center { grid-column: 1; grid-row: 2; }
+  .journal-right {
+    grid-column: 1; grid-row: 3;
+    border-left: none;
+    border-top: 1px solid var(--color-border);
+    max-height: 300px;
+  }
+}
+</style>

frontend/src/views/KnowledgeView.vue

@@ -247,7 +247,7 @@ const chatCollapsed = ref(false);
 const chatConvId = ref<number | null>(null);
 async function onMinichatSubmit(payload: { content: string; contextNoteId?: number }) {
   if (!chatConvId.value) {
-    const conv = await chatStore.createConversation("Knowledge chat");
+    const conv = await chatStore.createConversation();
     chatConvId.value = conv.id;
     await chatStore.fetchConversation(conv.id);
   } else if (chatStore.currentConversation?.id !== chatConvId.value) {
@@ -255,7 +255,7 @@ async function onMinichatSubmit(payload: { content: string; contextNoteId?: numb
   }
   chatOpen.value = true;
   chatCollapsed.value = false;
-  await chatStore.sendMessage(payload.content, payload.contextNoteId, undefined, true);
+  await chatStore.sendMessage(payload.content, payload.contextNoteId, undefined, false);
 }
 
 // ─── Auto-refresh cards when chat creates/edits notes or tasks ───────────────
@@ -410,7 +410,6 @@ onUnmounted(() => {
         <router-link v-if="overdueCount > 0" to="/tasks" class="overdue-badge">
           {{ overdueCount }} overdue
         </router-link>
-        <router-link to="/briefing" class="today-link">Briefing</router-link>
         <router-link to="/chat" class="today-link">Chat</router-link>
       </div>
     </div>
@@ -539,6 +538,7 @@ onUnmounted(() => {
               <span v-if="item.note_type === 'note'">Note</span>
               <span v-else-if="item.note_type === 'person'">Person</span>
               <span v-else-if="item.note_type === 'place'">Place</span>
+              <span v-else-if="item.note_type === 'task'">Task</span>
               <span v-else>List</span>
             </span>
 
@@ -1025,8 +1025,8 @@ onUnmounted(() => {
   background: linear-gradient(90deg, #7c3aed, #a78bfa);
 }
 .k-card--task::before {
-  width: 50%;
-  background: linear-gradient(90deg, #d4a017, transparent);
+  right: 0;
+  background: linear-gradient(90deg, #d4a017, #fbbf24);
 }
 .k-card--list::before {
   right: 0;
@@ -1064,7 +1064,7 @@ onUnmounted(() => {
 .badge--person { background: rgba(16,185,129,0.15); color: #34d399; }
 .badge--place  { background: rgba(245,158,11,0.15); color: #fbbf24; }
 .badge--list   { background: rgba(56,189,248,0.15); color: #7dd3fc; }
-.badge--task   { background: rgba(167,139,250,0.15); color: #a78bfa; }
+.badge--task   { background: rgba(212,160,23,0.15); color: #fbbf24; }
 
 .k-card-body { flex: 1; padding-right: 40px; }
 .k-card-title {

frontend/src/views/NewsView.vue

@@ -1,406 +0,0 @@
-<script setup lang="ts">
-import { ref, onMounted } from 'vue'
-import { useRouter } from 'vue-router'
-import {
-  getBriefingFeeds,
-  postRssReaction,
-  deleteRssReaction,
-  getNewsItems,
-  openArticleInChat,
-  type BriefingFeed,
-} from '@/api/client'
-import type { NewsItem } from '@/types/news'
-
-const router = useRouter()
-
-const LIMIT = 40
-
-const items = ref<NewsItem[]>([])
-const offset = ref(0)
-const hasMore = ref(true)
-const loading = ref(false)
-const feeds = ref<BriefingFeed[]>([])
-const selectedFeedId = ref<number | null>(null)
-
-// Reactions map: item id → current reaction
-const reactions = ref<Record<number, 'up' | 'down' | null>>({})
-// Track which items are currently being opened in chat
-const openingChat = ref<Set<number>>(new Set())
-
-async function loadMore() {
-  if (loading.value || !hasMore.value) return
-  loading.value = true
-  try {
-    const data = await getNewsItems({
-      days: 90,
-      limit: LIMIT,
-      offset: offset.value,
-      feed_id: selectedFeedId.value,
-    })
-    for (const item of data.items) {
-      if (reactions.value[item.id] === undefined) {
-        reactions.value[item.id] = item.reaction
-      }
-    }
-    items.value = [...items.value, ...data.items]
-    offset.value += data.items.length
-    hasMore.value = data.items.length === LIMIT
-  } finally {
-    loading.value = false
-  }
-}
-
-function onFeedChange() {
-  items.value = []
-  offset.value = 0
-  hasMore.value = true
-  reactions.value = {}
-  loadMore()
-}
-
-async function handleReaction(itemId: number, reaction: 'up' | 'down') {
-  const current = reactions.value[itemId]
-  reactions.value[itemId] = current === reaction ? null : reaction
-  try {
-    if (current === reaction) {
-      await deleteRssReaction(itemId)
-    } else {
-      await postRssReaction(itemId, reaction)
-    }
-  } catch {
-    reactions.value[itemId] = current ?? null
-  }
-}
-
-function formatRelativeDate(iso: string | null): string {
-  if (!iso) return ''
-  const d = new Date(iso)
-  const now = new Date()
-  const diffH = (now.getTime() - d.getTime()) / 3_600_000
-  if (diffH < 1) return 'Just now'
-  if (diffH < 24) return `${Math.round(diffH)}h ago`
-  if (diffH < 48) return 'Yesterday'
-  const days = Math.floor(diffH / 24)
-  if (days < 7) return `${days}d ago`
-  return d.toLocaleDateString(undefined, { month: 'short', day: 'numeric' })
-}
-
-async function openInChat(itemId: number) {
-  if (openingChat.value.has(itemId)) return
-  openingChat.value.add(itemId)
-  try {
-    const result = await openArticleInChat(itemId)
-    router.push(`/chat/${result.conversation_id}`)
-  } catch {
-    // silently fail — button returns to enabled state
-  } finally {
-    openingChat.value.delete(itemId)
-  }
-}
-
-onMounted(async () => {
-  feeds.value = await getBriefingFeeds().catch(() => [])
-  await loadMore()
-})
-</script>
-
-<template>
-  <div class="news-root">
-    <div class="news-header">
-      <div class="news-header-left">
-        <h1 class="news-title">News</h1>
-        <span class="news-subtitle">Last 90 days</span>
-      </div>
-      <div class="news-header-right">
-        <select
-          v-model="selectedFeedId"
-          class="feed-select"
-          @change="onFeedChange"
-        >
-          <option :value="null">All feeds</option>
-          <option v-for="feed in feeds" :key="feed.id" :value="feed.id">
-            {{ feed.title }}
-          </option>
-        </select>
-      </div>
-    </div>
-
-    <div class="news-list">
-      <div v-if="!items.length && !loading" class="news-empty">
-        No articles found for the selected feed.
-      </div>
-
-      <div
-        v-for="item in items"
-        :key="item.id"
-        class="news-card"
-      >
-        <div class="news-card-meta">
-          <span class="news-source">{{ item.source }}</span>
-          <span v-if="item.published_at" class="news-date">{{ formatRelativeDate(item.published_at) }}</span>
-        </div>
-        <a
-          v-if="item.url"
-          :href="item.url"
-          target="_blank"
-          rel="noopener noreferrer"
-          class="news-card-title"
-        >{{ item.title }}</a>
-        <p v-else class="news-card-title news-card-title--plain">{{ item.title }}</p>
-        <p v-if="item.snippet" class="news-snippet">{{ item.snippet }}</p>
-        <div v-if="item.topics?.length" class="news-topics">
-          <span v-for="topic in item.topics" :key="topic" class="news-topic">{{ topic }}</span>
-        </div>
-        <div class="news-reactions">
-          <button
-            class="reaction-btn"
-            :class="{ active: reactions[item.id] === 'up' }"
-            @click="handleReaction(item.id, 'up')"
-            title="Interested"
-          >👍</button>
-          <button
-            class="reaction-btn"
-            :class="{ active: reactions[item.id] === 'down' }"
-            @click="handleReaction(item.id, 'down')"
-            title="Not interested"
-          >👎</button>
-          <button
-            class="reaction-btn open-chat-btn"
-            :class="{ busy: openingChat.has(item.id) }"
-            :disabled="openingChat.has(item.id)"
-            @click="openInChat(item.id)"
-            title="Discuss in chat"
-          >{{ openingChat.has(item.id) ? '…' : '💬' }}</button>
-        </div>
-      </div>
-
-      <div class="news-footer">
-        <button
-          v-if="hasMore"
-          class="btn-load-more"
-          @click="loadMore"
-          :disabled="loading"
-        >{{ loading ? 'Loading…' : 'Load more' }}</button>
-        <div v-if="loading && !items.length" class="news-loading">Loading…</div>
-        <p v-if="!hasMore && items.length" class="news-end">All articles loaded</p>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-.news-root {
-  display: flex;
-  flex-direction: column;
-  height: 100%;
-  min-height: 0;
-  overflow-y: auto;
-}
-
-.news-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 1.25rem 1.5rem 1rem;
-  border-bottom: 1px solid var(--color-border);
-  flex-shrink: 0;
-  flex-wrap: wrap;
-  gap: 0.75rem;
-}
-
-.news-header-left {
-  display: flex;
-  align-items: baseline;
-  gap: 0.75rem;
-}
-
-.news-title {
-  font-family: 'Fraunces', Georgia, serif;
-  font-size: 1.3rem;
-  font-weight: 700;
-  margin: 0;
-  color: var(--color-text);
-}
-
-.news-subtitle {
-  font-size: 0.82rem;
-  color: var(--color-text-muted);
-}
-
-.news-header-right {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
-.feed-select {
-  padding: 0.35rem 0.6rem;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  background: var(--color-bg-card);
-  color: var(--color-text);
-  font-size: 0.82rem;
-  cursor: pointer;
-  font-family: inherit;
-}
-
-.news-list {
-  padding: 1rem 1.5rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.75rem;
-  max-width: 860px;
-  width: 100%;
-  margin: 0 auto;
-}
-
-.news-empty,
-.news-loading {
-  text-align: center;
-  padding: 3rem 1rem;
-  color: var(--color-text-muted);
-  font-size: 0.9rem;
-}
-
-.news-card {
-  background: var(--color-bg-card);
-  border: 1px solid var(--color-border);
-  border-radius: 10px;
-  padding: 0.85rem 1rem;
-  display: flex;
-  flex-direction: column;
-  gap: 0.3rem;
-}
-
-.news-card-meta {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
-.news-source {
-  font-size: 0.72rem;
-  font-weight: 600;
-  text-transform: uppercase;
-  letter-spacing: 0.04em;
-  color: var(--color-primary);
-}
-
-.news-date {
-  font-size: 0.72rem;
-  color: var(--color-text-muted);
-}
-
-.news-card-title {
-  font-size: 0.95rem;
-  font-weight: 600;
-  color: var(--color-text);
-  line-height: 1.4;
-  text-decoration: none;
-  margin: 0;
-}
-
-a.news-card-title:hover {
-  text-decoration: underline;
-  color: var(--color-primary);
-}
-
-.news-snippet {
-  font-size: 0.82rem;
-  color: var(--color-text-muted);
-  line-height: 1.5;
-  margin: 0;
-  display: -webkit-box;
-  -webkit-line-clamp: 3;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-
-.news-topics {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.25rem;
-  margin-top: 0.1rem;
-}
-
-.news-topic {
-  font-size: 0.68rem;
-  padding: 0.15rem 0.5rem;
-  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
-  color: var(--color-primary);
-  border-radius: 99px;
-  font-weight: 500;
-}
-
-.news-reactions {
-  display: flex;
-  gap: 0.3rem;
-  margin-top: 0.2rem;
-}
-
-.reaction-btn {
-  background: none;
-  border: 1px solid var(--color-border);
-  border-radius: 6px;
-  padding: 0.1rem 0.4rem;
-  cursor: pointer;
-  font-size: 0.82rem;
-  line-height: 1.4;
-  opacity: 0.55;
-  transition: opacity 0.15s, border-color 0.15s;
-}
-
-.reaction-btn:hover {
-  opacity: 1;
-  border-color: var(--color-primary);
-}
-
-.reaction-btn.active {
-  opacity: 1;
-  border-color: var(--color-primary);
-  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
-}
-
-.open-chat-btn {
-  margin-left: auto;
-}
-
-.open-chat-btn.busy {
-  opacity: 0.4;
-  cursor: wait;
-}
-
-.news-footer {
-  display: flex;
-  justify-content: center;
-  padding: 1rem 0 0.5rem;
-}
-
-.btn-load-more {
-  padding: 0.5rem 1.5rem;
-  border: 1px solid var(--color-border);
-  border-radius: 8px;
-  background: var(--color-bg-card);
-  color: var(--color-text-muted);
-  font-size: 0.85rem;
-  cursor: pointer;
-  font-family: inherit;
-  transition: all 0.15s;
-}
-
-.btn-load-more:hover:not(:disabled) {
-  border-color: var(--color-primary);
-  color: var(--color-primary);
-}
-
-.btn-load-more:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
-
-.news-end {
-  font-size: 0.8rem;
-  color: var(--color-text-muted);
-  margin: 0;
-}
-</style>

frontend/src/views/SettingsView.vue

@@ -1,9 +1,9 @@
 <script setup lang="ts">
-import { ref, watch, onMounted } from "vue";
+import { ref, computed, watch, onMounted } from "vue";
 import { useSettingsStore } from "@/stores/settings";
 import { useAuthStore } from "@/stores/auth";
 import { useToastStore } from "@/stores/toast";
-import { apiGet, apiPost, apiPut, apiDelete, listGroups, createGroup, deleteGroup, listGroupMembers, addGroupMember, removeGroupMember, searchUsers, getBriefingConfig, saveBriefingConfig, getBriefingFeeds, createBriefingFeed, deleteBriefingFeed, refreshBriefingFeeds, geocodeAddress, getFableMcpInfo, listApiKeys, createApiKey as apiCreateApiKey, revokeApiKey as apiRevokeApiKey, getVoiceStatus, getVoiceList, synthesiseSpeech, getProfile, updateProfile, consolidateProfile, clearProfileObservations, type ApiKeyEntry, type GroupEntry, type GroupMember, type UserSearchResult, type BriefingConfig, type BriefingFeed, type VoiceStatusResult, type VoiceEntry, type VoiceBlendEntry, type UserProfile } from "@/api/client";
+import { apiGet, apiPost, apiPut, apiDelete, listGroups, createGroup, deleteGroup, listGroupMembers, addGroupMember, removeGroupMember, searchUsers, getFableMcpInfo, listApiKeys, createApiKey as apiCreateApiKey, revokeApiKey as apiRevokeApiKey, getVoiceStatus, getVoiceList, synthesiseSpeech, getProfile, updateProfile, consolidateProfile, clearProfileObservations, type ApiKeyEntry, type GroupEntry, type GroupMember, type UserSearchResult, type VoiceStatusResult, type VoiceEntry, type VoiceBlendEntry, type UserProfile } from "@/api/client";
 import { usePushStore } from "@/stores/push";
 import type { User } from "@/types/auth";
 import PaginationBar from "@/components/PaginationBar.vue";
@@ -62,7 +62,7 @@ const appVersion = ref('dev');
 const restoreFileInput = ref<HTMLInputElement | null>(null);
 
 // Migrate stored "admin" → "config"; unknown tabs fall back to "general"
-const VALID_TABS = new Set(["general", "account", "profile", "notifications", "integrations", "data", "briefing", "voice", "apikeys", "config", "users", "logs", "groups"]);
+const VALID_TABS = new Set(["general", "account", "profile", "notifications", "integrations", "data", "voice", "apikeys", "config", "users", "logs", "groups"]);
 const _stored = localStorage.getItem("settings_tab") ?? "general";
 const activeTab = ref(VALID_TABS.has(_stored) ? (_stored === "admin" ? "config" : _stored) : "general");
 
@@ -72,7 +72,6 @@ function _loadTabContent(tab: string) {
     else if (tab === "logs") loadLogsPanel();
     else if (tab === "groups") loadGroupsPanel();
   }
-  if (tab === "briefing") loadBriefingTab();
   if (tab === "voice") loadVoiceTab();
   if (tab === "apikeys") { fetchApiKeys(); loadMcpInfo(); }
 }
@@ -94,17 +93,54 @@ const mcpInfo = ref<{ available: boolean; filename: string | null } | null>(null
 const mcpInfoLoading = ref(false);
 
 const origin = window.location.origin;
-const mcpConfigSnippet = JSON.stringify({
+const mcpClientTab = ref<'claude-code' | 'claude-desktop' | 'other'>('claude-code');
+const copiedSnippetKey = ref<string | null>(null);
+
+const effectiveApiKey = computed(() => newKeyValue.value || '<your-api-key>');
+
+const claudeCodeCommand = computed(() => {
+  return `claude mcp add --transport stdio --scope user fable \\
+  --env FABLE_URL=${origin} \\
+  --env FABLE_API_KEY=${effectiveApiKey.value} \\
+  -- fable-mcp`;
+});
+
+const mcpConfigSnippet = computed(() => JSON.stringify({
   mcpServers: {
     fable: {
       command: "fable-mcp",
       env: {
-        FABLE_URL: window.location.origin,
-        FABLE_API_KEY: "<your-api-key>",
+        FABLE_URL: origin,
+        FABLE_API_KEY: effectiveApiKey.value,
       },
     },
   },
-}, null, 2);
+}, null, 2));
+
+async function copyToClipboard(text: string) {
+  try {
+    await navigator.clipboard.writeText(text);
+  } catch {
+    // Fallback for http (non-secure) contexts where clipboard API is unavailable
+    const ta = document.createElement('textarea');
+    ta.value = text;
+    ta.style.position = 'fixed';
+    ta.style.opacity = '0';
+    document.body.appendChild(ta);
+    ta.focus();
+    ta.select();
+    document.execCommand('copy');
+    document.body.removeChild(ta);
+  }
+}
+
+async function copySnippet(text: string, key: string) {
+  await copyToClipboard(text);
+  copiedSnippetKey.value = key;
+  setTimeout(() => {
+    if (copiedSnippetKey.value === key) copiedSnippetKey.value = null;
+  }, 2000);
+}
 
 async function loadMcpInfo() {
   if (mcpInfo.value !== null) return;
@@ -142,20 +178,7 @@ async function revokeApiKey(id: number) {
 }
 
 async function copyApiKey() {
-  try {
-    await navigator.clipboard.writeText(newKeyValue.value);
-  } catch {
-    // Fallback for http (non-secure) contexts where clipboard API is unavailable
-    const ta = document.createElement('textarea');
-    ta.value = newKeyValue.value;
-    ta.style.position = 'fixed';
-    ta.style.opacity = '0';
-    document.body.appendChild(ta);
-    ta.focus();
-    ta.select();
-    document.execCommand('copy');
-    document.body.removeChild(ta);
-  }
+  await copyToClipboard(newKeyValue.value);
   apiKeyCopied.value = true;
   setTimeout(() => { apiKeyCopied.value = false; }, 2000);
 }
@@ -267,147 +290,6 @@ async function removeMemberFromGroup(groupId: number, userId: number) {
   await loadGroupsPanel();
 }
 
-// Briefing settings
-const briefingConfig = ref<BriefingConfig>({
-  enabled: false,
-  locations: {},
-  use_caldav_event_locations: false,
-  work_days: [1, 2, 3, 4, 5],
-  slots: { compilation: true, morning: true, midday: false, afternoon: false },
-  notifications: true,
-  temp_unit: 'C',
-});
-const briefingFeeds = ref<BriefingFeed[]>([]);
-const briefingSaving = ref(false);
-const briefingSaved = ref(false);
-const briefingGeocoding = ref<Record<string, boolean>>({});
-const briefingGeoError = ref<Record<string, string>>({});
-const newFeedUrl = ref('');
-const newFeedCategory = ref('');
-const addingFeed = ref(false);
-const refreshingFeeds = ref(false);
-const briefingIncludeTopics = ref<string[]>([]);
-const briefingExcludeTopics = ref<string[]>([]);
-
-function _parseTopics(raw: unknown): string[] {
-  try {
-    const val = typeof raw === 'string' ? JSON.parse(raw) : raw;
-    return Array.isArray(val) ? val.map(String) : [];
-  } catch {
-    return [];
-  }
-}
-
-async function loadBriefingTab() {
-  briefingConfig.value = await getBriefingConfig();
-  briefingFeeds.value = await getBriefingFeeds();
-  const allSettings = await apiGet<Record<string, string>>('/api/settings').catch(() => ({} as Record<string, string>));
-  briefingIncludeTopics.value = _parseTopics(allSettings['briefing_include_topics'] ?? '[]');
-  briefingExcludeTopics.value = _parseTopics(allSettings['briefing_exclude_topics'] ?? '[]');
-}
-
-async function saveIncludeTopics(topics: string[]) {
-  briefingIncludeTopics.value = topics;
-  await apiPut('/api/settings', { briefing_include_topics: JSON.stringify(topics) });
-}
-
-async function saveExcludeTopics(topics: string[]) {
-  briefingExcludeTopics.value = topics;
-  await apiPut('/api/settings', { briefing_exclude_topics: JSON.stringify(topics) });
-}
-
-const _STANDARD_TOPICS = ['technology', 'science', 'politics', 'business', 'health', 'environment', 'local', 'entertainment', 'sports', 'other'];
-async function fetchTopicSuggestions(q: string): Promise<string[]> {
-  if (!q) return _STANDARD_TOPICS;
-  return _STANDARD_TOPICS.filter((t) => t.startsWith(q.toLowerCase()));
-}
-
-async function geocodeLocation(key: 'home' | 'work') {
-  const loc = briefingConfig.value.locations[key];
-  if (!loc?.address?.trim()) return;
-  briefingGeocoding.value[key] = true;
-  briefingGeoError.value[key] = '';
-  try {
-    const result = await geocodeAddress(loc.address.trim());
-    if (result) {
-      briefingConfig.value.locations[key] = {
-        ...loc,
-        lat: result.lat,
-        lon: result.lon,
-        label: key.charAt(0).toUpperCase() + key.slice(1),
-      };
-      briefingGeoError.value[key] = '';
-    } else {
-      briefingGeoError.value[key] = 'Location not found — check the address';
-    }
-  } catch {
-    briefingGeoError.value[key] = 'Geocoding failed';
-  } finally {
-    briefingGeocoding.value[key] = false;
-  }
-}
-
-
-
-async function saveBriefingSettings() {
-  briefingSaving.value = true;
-  briefingSaved.value = false;
-  try {
-    await saveBriefingConfig(briefingConfig.value);
-    briefingSaved.value = true;
-    setTimeout(() => (briefingSaved.value = false), 2000);
-  } catch {
-    toastStore.show('Failed to save briefing settings', 'error');
-  } finally {
-    briefingSaving.value = false;
-  }
-}
-
-async function addFeed() {
-  if (!newFeedUrl.value.trim() || addingFeed.value) return;
-  addingFeed.value = true;
-  try {
-    const feed = await createBriefingFeed(newFeedUrl.value.trim(), newFeedCategory.value.trim() || undefined);
-    briefingFeeds.value.push(feed);
-    newFeedUrl.value = '';
-    newFeedCategory.value = '';
-  } catch (err: any) {
-    toastStore.show(err?.message === 'Feed already added' ? 'That feed is already in your list' : 'Failed to add feed', 'error');
-  } finally {
-    addingFeed.value = false;
-  }
-}
-
-async function removeFeed(id: number) {
-  await deleteBriefingFeed(id);
-  briefingFeeds.value = briefingFeeds.value.filter((f) => f.id !== id);
-}
-
-async function refreshFeeds() {
-  if (refreshingFeeds.value) return;
-  refreshingFeeds.value = true;
-  try {
-    const result = await refreshBriefingFeeds();
-    // Reload feed list so last_fetched_at updates
-    briefingFeeds.value = await getBriefingFeeds();
-    toastStore.show(`Refreshed ${result.feeds_refreshed} feed${result.feeds_refreshed !== 1 ? 's' : ''} — ${result.new_items} new item${result.new_items !== 1 ? 's' : ''}`);
-  } catch {
-    toastStore.show('Failed to refresh feeds', 'error');
-  } finally {
-    refreshingFeeds.value = false;
-  }
-}
-
-function feedAge(isoStr: string | null): string {
-  if (!isoStr) return 'never fetched';
-  const diff = Date.now() - new Date(isoStr).getTime();
-  const m = Math.floor(diff / 60000);
-  if (m < 1) return 'just now';
-  if (m < 60) return `${m}m ago`;
-  const h = Math.floor(m / 60);
-  if (h < 24) return `${h}h ago`;
-  return `${Math.floor(h / 24)}d ago`;
-}
 
 // Chat retention
 const chatRetentionDays = ref(90);
@@ -469,7 +351,7 @@ const smtp = ref({
   smtp_username: "",
   smtp_password: "",
   smtp_from_address: "",
-  smtp_from_name: "Fabled Assistant",
+  smtp_from_name: "Fabled Scribe",
   smtp_use_tls: "true",
 });
 const savingSmtp = ref(false);
@@ -1433,7 +1315,7 @@ function formatUserDate(iso: string): string {
       <div class="sidebar-group">
         <div class="sidebar-group-label">User</div>
         <button
-          v-for="tab in ['general', 'account', 'profile', 'notifications', 'integrations', 'data', 'briefing', 'voice', 'apikeys']"
+          v-for="tab in ['general', 'account', 'profile', 'notifications', 'integrations', 'data', 'voice', 'apikeys']"
           :key="tab"
           :class="['sidebar-item', { active: activeTab === tab }]"
           @click="activeTab = tab"
@@ -1486,7 +1368,7 @@ function formatUserDate(iso: string): string {
               <option v-for="m in installedModels" :key="m" :value="m">{{ m }}</option>
             </select>
             <p class="field-hint">
-              Model used for background tasks: title generation, tag suggestions, project summaries, and RSS classification.
+              Model used for background tasks: title generation, tag suggestions, and project summaries.
               Using a small dedicated model (e.g. qwen2.5:0.5b) keeps the chat model's KV cache warm between messages, significantly reducing response time.
               <span v-if="backgroundModel && backgroundModel === (defaultModel || defaultChatModel)" class="field-hint-warn">
                 ⚠ Setting this to the same model as Chat Model will wipe the KV cache after every background task, increasing response latency.
@@ -1949,7 +1831,7 @@ function formatUserDate(iso: string): string {
 
       <section class="settings-section full-width">
         <h2>About</h2>
-        <p class="version-line">Fabled Assistant <span class="version-badge">{{ appVersion }}</span></p>
+        <p class="version-line">Fabled Scribe <span class="version-badge">{{ appVersion }}</span></p>
       </section>
 
     </div>
@@ -2083,207 +1965,6 @@ function formatUserDate(iso: string): string {
 
     </div>
 
-    <!-- ── Briefing ── -->
-    <div v-show="activeTab === 'briefing'" class="settings-grid">
-
-      <section class="settings-section full-width">
-        <h2>Daily Briefing</h2>
-        <p class="section-desc">
-          Configure your daily briefing — a conversation that summarises your day,
-          weather, and RSS feeds on a schedule.
-        </p>
-
-        <!-- Enable -->
-        <div class="checkbox-field">
-          <label>
-            <input type="checkbox" v-model="briefingConfig.enabled" />
-            Enable Daily Briefing
-          </label>
-          <p class="field-hint">Start daily briefings at the configured slots.</p>
-        </div>
-      </section>
-
-      <!-- Locations -->
-      <section class="settings-section full-width">
-        <h2>Locations</h2>
-        <p class="section-desc">Enter addresses for weather lookup. Click "Look up" to geocode.</p>
-
-        <div v-for="key in (['home', 'work'] as const)" :key="key" class="briefing-location-row">
-          <label class="field-label">{{ key.charAt(0).toUpperCase() + key.slice(1) }}</label>
-          <div class="briefing-input-group">
-            <input
-              type="text"
-              class="input"
-              :placeholder="key === 'home' ? 'e.g. 123 Main St, Springfield' : 'e.g. 456 Office Ave, Portland'"
-              :value="briefingConfig.locations[key]?.address ?? ''"
-              @input="(e) => {
-                if (!briefingConfig.locations[key]) briefingConfig.locations[key] = { label: key, address: '' };
-                briefingConfig.locations[key]!.address = (e.target as HTMLInputElement).value;
-              }"
-            />
-            <button class="btn-secondary" @click="geocodeLocation(key)" :disabled="briefingGeocoding[key]">
-              {{ briefingGeocoding[key] ? 'Looking up…' : 'Look up' }}
-            </button>
-          </div>
-          <div v-if="briefingConfig.locations[key]?.lat" class="briefing-geo-confirmed">
-            ✓ {{ briefingConfig.locations[key]!.lat?.toFixed(4) }}, {{ briefingConfig.locations[key]!.lon?.toFixed(4) }}
-          </div>
-          <div v-if="briefingGeoError[key]" class="briefing-geo-error">{{ briefingGeoError[key] }}</div>
-        </div>
-
-        <div class="checkbox-field" style="margin-top: 0.75rem">
-          <label>
-            <input type="checkbox" v-model="briefingConfig.use_caldav_event_locations" />
-            Also check CalDAV event locations
-          </label>
-          <p class="field-hint">Look up weather for locations in today's calendar events.</p>
-        </div>
-
-        <div class="field" style="margin-top: 1rem">
-          <label class="field-label">Temperature unit</label>
-          <div class="briefing-unit-toggle">
-            <button
-              type="button"
-              :class="['briefing-unit-btn', { active: briefingConfig.temp_unit === 'C' }]"
-              @click="briefingConfig.temp_unit = 'C'"
-            >°C</button>
-            <button
-              type="button"
-              :class="['briefing-unit-btn', { active: briefingConfig.temp_unit === 'F' }]"
-              @click="briefingConfig.temp_unit = 'F'"
-            >°F</button>
-          </div>
-        </div>
-      </section>
-
-      <!-- Slots -->
-      <section class="settings-section full-width">
-        <h2>Scheduled Slots</h2>
-        <p class="section-desc">Each active slot posts an update into your briefing conversation at the listed local time.</p>
-        <div class="briefing-slot-list">
-          <div
-            v-for="[key, label, localTime] in ([
-              ['compilation', 'Morning briefing', '4:00 am'],
-              ['morning', 'Office check-in', '8:00 am'],
-              ['midday', 'Midday update', '12:00 pm'],
-              ['afternoon', 'End of day', '4:00 pm'],
-            ] as const)"
-            :key="key"
-            class="briefing-slot-row"
-          >
-            <div class="briefing-slot-info">
-              <span class="briefing-slot-label">{{ label }}</span>
-              <span class="briefing-slot-time">{{ localTime }}</span>
-            </div>
-            <label>
-              <input type="checkbox" v-model="briefingConfig.slots[key]" />
-            </label>
-          </div>
-        </div>
-        <p class="field-hint" style="margin-top: 0.5rem">
-          Firing in timezone: <strong>{{ userTimezone || 'UTC (not configured — set in General settings)' }}</strong>
-        </p>
-      </section>
-
-      <!-- RSS Feeds -->
-      <section class="settings-section full-width">
-        <div class="briefing-feeds-header">
-          <div>
-            <h2>RSS Feeds</h2>
-            <p class="section-desc">Add RSS or Atom feeds to be summarised in your morning briefing.</p>
-          </div>
-          <button
-            v-if="briefingFeeds.length"
-            class="btn-secondary briefing-refresh-btn"
-            @click="refreshFeeds"
-            :disabled="refreshingFeeds"
-            title="Fetch latest items from all feeds"
-          >{{ refreshingFeeds ? 'Refreshing…' : 'Refresh all' }}</button>
-        </div>
-
-        <div class="briefing-feeds-list" v-if="briefingFeeds.length">
-          <div class="briefing-feed-row" v-for="feed in briefingFeeds" :key="feed.id">
-            <div class="briefing-feed-info">
-              <div class="briefing-feed-title-row">
-                <span class="briefing-feed-title">{{ feed.title || feed.url }}</span>
-                <span v-if="feed.category" class="briefing-feed-cat">{{ feed.category }}</span>
-              </div>
-              <span v-if="feed.title" class="briefing-feed-url">{{ feed.url }}</span>
-              <span class="briefing-feed-age">{{ feedAge(feed.last_fetched_at) }}</span>
-            </div>
-            <button class="briefing-btn-remove" @click="removeFeed(feed.id)" aria-label="Remove feed">✕</button>
-          </div>
-        </div>
-        <p v-else class="field-hint">No feeds yet. Try adding Reuters, BBC World, or Hacker News.</p>
-
-        <div class="briefing-add-feed-form">
-          <div class="briefing-add-feed-inputs">
-            <input v-model="newFeedUrl" class="input" placeholder="https://example.com/feed.xml" @keydown.enter="addFeed" />
-            <input v-model="newFeedCategory" class="input briefing-cat-input" placeholder="Category (optional)" @keydown.enter="addFeed" />
-          </div>
-          <button class="btn-secondary" @click="addFeed" :disabled="addingFeed || !newFeedUrl.trim()">
-            {{ addingFeed ? 'Adding…' : 'Add Feed' }}
-          </button>
-        </div>
-      </section>
-
-      <!-- News Preferences -->
-      <section class="settings-section full-width">
-        <h2>News Preferences</h2>
-        <p class="section-desc">
-          Tell the briefing what topics you care about. Topics are matched against
-          classified RSS items before each briefing runs.
-        </p>
-        <div class="settings-field">
-          <label class="field-label">Interested in</label>
-          <TagInput
-            :model-value="briefingIncludeTopics"
-            placeholder="e.g. technology, science, local"
-            :fetch-tags="fetchTopicSuggestions"
-            @update:model-value="saveIncludeTopics"
-          />
-        </div>
-        <div class="settings-field" style="margin-top: 0.75rem">
-          <label class="field-label">Not interested in</label>
-          <TagInput
-            :model-value="briefingExcludeTopics"
-            placeholder="e.g. sports, celebrity"
-            :fetch-tags="fetchTopicSuggestions"
-            @update:model-value="saveExcludeTopics"
-          />
-        </div>
-        <details class="topic-vocab-hint" style="margin-top: 0.75rem">
-          <summary style="cursor: pointer; color: var(--color-text-muted); font-size: 0.82rem">Standard topic vocabulary</summary>
-          <p class="field-hint" style="margin-top: 0.35rem">
-            technology · science · politics · business · health · environment ·
-            local · entertainment · sports · other
-          </p>
-          <p class="field-hint">Custom terms are also accepted.</p>
-        </details>
-      </section>
-
-      <!-- Notifications -->
-      <section class="settings-section full-width">
-        <h2>Notifications</h2>
-        <div class="checkbox-field">
-          <label>
-            <input type="checkbox" v-model="briefingConfig.notifications" />
-            Push notification when each briefing slot is ready
-          </label>
-        </div>
-      </section>
-
-      <section class="settings-section full-width">
-        <div class="actions">
-          <button class="btn-save" @click="saveBriefingSettings" :disabled="briefingSaving">
-            {{ briefingSaved ? 'Saved ✓' : briefingSaving ? 'Saving…' : 'Save Briefing Settings' }}
-          </button>
-        </div>
-      </section>
-
-    </div>
-
-    <!-- ── Voice ── -->
     <div v-show="activeTab === 'voice'" class="settings-grid">
 
       <section class="settings-section full-width">
@@ -2529,21 +2210,113 @@ function formatUserDate(iso: string): string {
 
             <div class="mcp-install-steps">
               <h3>Installation</h3>
-              <ol>
+
+              <div class="mcp-client-tabs" role="tablist">
+                <button
+                  type="button"
+                  role="tab"
+                  :aria-selected="mcpClientTab === 'claude-code'"
+                  :class="['mcp-client-tab', { active: mcpClientTab === 'claude-code' }]"
+                  @click="mcpClientTab = 'claude-code'"
+                >Claude Code</button>
+                <button
+                  type="button"
+                  role="tab"
+                  :aria-selected="mcpClientTab === 'claude-desktop'"
+                  :class="['mcp-client-tab', { active: mcpClientTab === 'claude-desktop' }]"
+                  @click="mcpClientTab = 'claude-desktop'"
+                >Claude Desktop</button>
+                <button
+                  type="button"
+                  role="tab"
+                  :aria-selected="mcpClientTab === 'other'"
+                  :class="['mcp-client-tab', { active: mcpClientTab === 'other' }]"
+                  @click="mcpClientTab = 'other'"
+                >Other</button>
+              </div>
+
+              <!-- Claude Code tab -->
+              <ol v-if="mcpClientTab === 'claude-code'">
                 <li>
-                  Download the wheel above and install it:
-                  <pre class="mcp-code">pip install {{ mcpInfo.filename }}</pre>
+                  Download the wheel above and install it with <a href="https://docs.astral.sh/uv/" target="_blank" rel="noopener">uv</a> or <a href="https://pipx.pypa.io/" target="_blank" rel="noopener">pipx</a> — either one works:
+                  <div class="mcp-code-row">
+                    <pre class="mcp-code">uv tool install ./{{ mcpInfo.filename }}</pre>
+                    <button class="btn btn-secondary btn-sm" @click="copySnippet(`uv tool install ./${mcpInfo.filename}`, 'cc-install-uv')">
+                      {{ copiedSnippetKey === 'cc-install-uv' ? 'Copied' : 'Copy' }}
+                    </button>
+                  </div>
+                  <div class="mcp-code-row">
+                    <pre class="mcp-code">pipx install ./{{ mcpInfo.filename }}</pre>
+                    <button class="btn btn-secondary btn-sm" @click="copySnippet(`pipx install ./${mcpInfo.filename}`, 'cc-install-pipx')">
+                      {{ copiedSnippetKey === 'cc-install-pipx' ? 'Copied' : 'Copy' }}
+                    </button>
+                  </div>
+                  <p class="mcp-hint">This puts <code>fable-mcp</code> on your PATH so Claude Code can launch it.</p>
                 </li>
                 <li>
-                  Create a <code>.env</code> file (or set environment variables):
-                  <pre class="mcp-code">FABLE_URL={{ origin }}
-FABLE_API_KEY=&lt;your-api-key&gt;</pre>
+                  Register the server with Claude Code:
+                  <div class="mcp-code-row">
+                    <pre class="mcp-code">{{ claudeCodeCommand }}</pre>
+                    <button class="btn btn-secondary btn-sm" @click="copySnippet(claudeCodeCommand, 'cc-add')">
+                      {{ copiedSnippetKey === 'cc-add' ? 'Copied' : 'Copy' }}
+                    </button>
+                  </div>
+                  <p class="mcp-hint">
+                    <code>--scope user</code> makes <code>fable</code> available across all your projects. Use <code>--scope project</code> to write it into the current repo's <code>.mcp.json</code> instead, or <code>--scope local</code> for this machine and repo only.
+                    <span v-if="!newKeyValue"> Generate an API key above to pre-fill the command.</span>
+                  </p>
                 </li>
                 <li>
-                  Add to your Claude MCP config (<code>~/.claude.json</code> or the Claude Desktop config):
-                  <pre class="mcp-code">{{ mcpConfigSnippet }}</pre>
+                  Verify the connection by running <code>/mcp</code> inside Claude Code — <code>fable</code> should appear as connected.
                 </li>
               </ol>
+
+              <!-- Claude Desktop tab -->
+              <ol v-else-if="mcpClientTab === 'claude-desktop'">
+                <li>
+                  Download the wheel above and install it with uv or pipx:
+                  <div class="mcp-code-row">
+                    <pre class="mcp-code">uv tool install ./{{ mcpInfo.filename }}</pre>
+                    <button class="btn btn-secondary btn-sm" @click="copySnippet(`uv tool install ./${mcpInfo.filename}`, 'cd-install')">
+                      {{ copiedSnippetKey === 'cd-install' ? 'Copied' : 'Copy' }}
+                    </button>
+                  </div>
+                </li>
+                <li>
+                  Add this block to your Claude Desktop MCP config file (<code>~/Library/Application Support/Claude/claude_desktop_config.json</code> on macOS, <code>%APPDATA%\Claude\claude_desktop_config.json</code> on Windows):
+                  <div class="mcp-code-row">
+                    <pre class="mcp-code">{{ mcpConfigSnippet }}</pre>
+                    <button class="btn btn-secondary btn-sm" @click="copySnippet(mcpConfigSnippet, 'cd-config')">
+                      {{ copiedSnippetKey === 'cd-config' ? 'Copied' : 'Copy' }}
+                    </button>
+                  </div>
+                </li>
+                <li>
+                  Restart Claude Desktop. The Fable tools should appear in the available tools list.
+                </li>
+              </ol>
+
+              <!-- Other tab -->
+              <div v-else class="mcp-other">
+                <p>
+                  Any MCP-compatible client can launch <code>fable-mcp</code> over stdio. The exact setup depends on the client, but in general you'll need:
+                </p>
+                <ul class="mcp-plain-list">
+                  <li>Install the wheel: <code>uv tool install ./{{ mcpInfo.filename }}</code> or <code>pipx install ./{{ mcpInfo.filename }}</code></li>
+                  <li>Command: <code>fable-mcp</code></li>
+                  <li>Transport: <code>stdio</code></li>
+                  <li>Environment variables:
+                    <div class="mcp-code-row">
+                      <pre class="mcp-code">FABLE_URL={{ origin }}
+FABLE_API_KEY={{ effectiveApiKey }}</pre>
+                      <button class="btn btn-secondary btn-sm" @click="copySnippet(`FABLE_URL=${origin}\nFABLE_API_KEY=${effectiveApiKey}`, 'other-env')">
+                        {{ copiedSnippetKey === 'other-env' ? 'Copied' : 'Copy' }}
+                      </button>
+                    </div>
+                  </li>
+                </ul>
+                <p class="mcp-hint">Consult your MCP client's documentation for how to register a stdio server. These instructions have only been tested with Claude Code.</p>
+              </div>
             </div>
           </div>
           <div v-else class="mcp-unavailable">
@@ -2605,7 +2378,7 @@ FABLE_API_KEY=&lt;your-api-key&gt;</pre>
           </div>
           <div class="field">
             <label for="smtp-from-name">From Name</label>
-            <input id="smtp-from-name" v-model="smtp.smtp_from_name" type="text" placeholder="Fabled Assistant" class="input" />
+            <input id="smtp-from-name" v-model="smtp.smtp_from_name" type="text" placeholder="Fabled Scribe" class="input" />
           </div>
         </div>
         <div class="checkbox-field">
@@ -4215,6 +3988,54 @@ FABLE_API_KEY=&lt;your-api-key&gt;</pre>
   white-space: pre-wrap;
   word-break: break-all;
   overflow-x: auto;
+  flex: 1;
+}
+.mcp-client-tabs {
+  display: flex;
+  gap: 0.25rem;
+  margin-bottom: 1rem;
+  border-bottom: 1px solid var(--color-border);
+}
+.mcp-client-tab {
+  background: transparent;
+  border: none;
+  padding: 0.5rem 0.9rem;
+  font-size: 0.85rem;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  border-bottom: 2px solid transparent;
+  margin-bottom: -1px;
+  transition: color 0.15s, border-color 0.15s;
+}
+.mcp-client-tab:hover { color: var(--color-text); }
+.mcp-client-tab.active {
+  color: var(--color-primary);
+  border-bottom-color: var(--color-primary);
+  font-weight: 600;
+}
+.mcp-code-row {
+  display: flex;
+  align-items: stretch;
+  gap: 0.4rem;
+  margin-top: 0.4rem;
+}
+.mcp-code-row .mcp-code { margin-top: 0; }
+.mcp-code-row .btn-sm { white-space: nowrap; }
+.mcp-hint {
+  margin-top: 0.5rem;
+  font-size: 0.8rem;
+  opacity: 0.7;
+  line-height: 1.5;
+}
+.mcp-other p { font-size: 0.9rem; line-height: 1.6; }
+.mcp-plain-list {
+  list-style: disc;
+  padding-left: 1.25rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  font-size: 0.9rem;
+  line-height: 1.6;
 }
 
 /* Voice tab */

frontend/src/views/WorkspaceView.vue

@@ -1,15 +1,13 @@
 <script setup lang="ts">
-import { ref, computed, onMounted, onUnmounted, watch, nextTick } from "vue";
+import { ref, computed, onMounted } from "vue";
 import { useRoute } from "vue-router";
 import { apiGet } from "@/api/client";
-import { useChatStore } from "@/stores/chat";
 import { useToastStore } from "@/stores/toast";
-import ChatPanel from "@/components/ChatPanel.vue";
 import WorkspaceTaskPanel from "@/components/WorkspaceTaskPanel.vue";
 import WorkspaceNoteEditor from "@/components/WorkspaceNoteEditor.vue";
+import WorkspaceChatWidget from "@/components/WorkspaceChatWidget.vue";
 
 const route = useRoute();
-const chatStore = useChatStore();
 const toast = useToastStore();
 
 const projectId = computed(() => Number(route.params.projectId));
@@ -21,140 +19,62 @@ interface Project {
 }
 
 const project = ref<Project | null>(null);
-const chatPanelRef = ref<InstanceType<typeof ChatPanel> | null>(null);
 const taskPanelRef = ref<InstanceType<typeof WorkspaceTaskPanel> | null>(null);
 const noteEditorRef = ref<InstanceType<typeof WorkspaceNoteEditor> | null>(null);
 const activeNoteId = ref<number | null>(null);
-let workspaceConvId: number | null = null;
-let isNewConv = false;
 
-function _storageKey(pid: number) {
-  return `workspace_conv_${pid}`;
-}
-
-// Panel collapse state — persisted per project
+// Panel collapse state — persisted per project (tasks + notes only; chat is now a widget)
 function _panelKey(pid: number) { return `workspace_panels_${pid}`; }
 
 function _loadPanelState(pid: number) {
   try {
     const raw = localStorage.getItem(_panelKey(pid));
     if (raw) {
-      const saved = JSON.parse(raw);
-      // Ensure at least one panel is open after restore
-      if (!saved.tasks && !saved.chat && !saved.notes) saved.chat = true;
-      return saved as { tasks: boolean; chat: boolean; notes: boolean };
+      const saved = JSON.parse(raw) as Partial<{ tasks: boolean; notes: boolean }>;
+      const tasks = saved.tasks ?? true;
+      const notes = saved.notes ?? true;
+      // Guard: at least one panel must be open
+      if (!tasks && !notes) return { tasks: true, notes: true };
+      return { tasks, notes };
     }
   } catch { /* ignore */ }
-  return { tasks: true, chat: true, notes: true };
+  return { tasks: true, notes: true };
 }
 
-const panelOpen = ref({ tasks: true, chat: true, notes: true });
+const panelOpen = ref<{ tasks: boolean; notes: boolean }>({ tasks: true, notes: true });
 
 const gridColumns = computed(() => {
   return [
-    panelOpen.value.tasks ? "minmax(0, 0.8fr)" : "0px",
-    panelOpen.value.chat  ? "minmax(0, 1.1fr)" : "0px",
-    panelOpen.value.notes ? "minmax(0, 1.1fr)" : "0px",
+    panelOpen.value.tasks ? "minmax(0, 0.85fr)" : "0px",
+    panelOpen.value.notes ? "minmax(0, 2.15fr)" : "0px",
   ].join(" ");
 });
 
-// SSE watcher — auto-load notes/tasks when tool calls succeed
-const processedCount = ref(0);
-
-watch(
-  () => chatStore.streamingToolCalls,
-  (calls) => {
-    for (let i = processedCount.value; i < calls.length; i++) {
-      const tc = calls[i];
-      if (
-        ["create_note", "update_note"].includes(tc.function) &&
-        tc.status === "success" &&
-        tc.result?.data?.id
-      ) {
-        activeNoteId.value = tc.result.data.id as number;
-        noteEditorRef.value?.reload();
-      }
-      if (
-        ["create_task", "update_task", "create_milestone", "update_milestone"].includes(tc.function) &&
-        tc.status === "success"
-      ) {
-        taskPanelRef.value?.reload();
-      }
-    }
-    processedCount.value = calls.length;
-  },
-  { deep: true }
-);
-
-watch(
-  () => chatStore.streaming,
-  (s) => {
-    if (!s) processedCount.value = 0;
-  }
-);
-
 function togglePanel(panel: keyof typeof panelOpen.value) {
   const open = panelOpen.value;
-  const openCount = [open.tasks, open.chat, open.notes].filter(Boolean).length;
+  const openCount = [open.tasks, open.notes].filter(Boolean).length;
   if (open[panel] && openCount <= 1) return;
   panelOpen.value[panel] = !panelOpen.value[panel];
   localStorage.setItem(_panelKey(projectId.value), JSON.stringify(panelOpen.value));
 }
 
-function prefill(text: string) {
-  chatPanelRef.value?.prefill(text);
+function onNoteChanged(noteId: number) {
+  activeNoteId.value = noteId;
+  noteEditorRef.value?.reload();
+}
+
+function onTaskChanged() {
+  taskPanelRef.value?.reload();
 }
 
 onMounted(async () => {
-  // Restore panel state
   panelOpen.value = _loadPanelState(projectId.value);
 
-  // Load project info
   try {
     project.value = await apiGet<Project>(`/api/projects/${projectId.value}`);
   } catch {
     toast.show("Failed to load project", "error");
   }
-
-  const key = _storageKey(projectId.value);
-  const storedId = localStorage.getItem(key);
-
-  if (storedId) {
-    // Try to reuse the existing workspace conversation
-    const existingId = Number(storedId);
-    try {
-      await chatStore.fetchConversation(existingId);
-      workspaceConvId = existingId;
-      isNewConv = false;
-      chatStore.reconnectIfGenerating(existingId);
-    } catch {
-      // Conversation was deleted — create a fresh one
-      localStorage.removeItem(key);
-    }
-  }
-
-  if (workspaceConvId === null) {
-    // Create a new workspace conversation and persist its ID
-    const title = project.value ? `${project.value.title} — Workspace` : "Workspace";
-    const conv = await chatStore.createConversation(title);
-    workspaceConvId = conv.id;
-    isNewConv = true;
-    await chatStore.fetchConversation(conv.id);
-    localStorage.setItem(key, String(conv.id));
-  }
-
-  nextTick(() => chatPanelRef.value?.focus());
-});
-
-onUnmounted(async () => {
-  // Only delete if we created a brand-new conversation this session and it's still empty
-  if (workspaceConvId !== null && isNewConv) {
-    const conv = chatStore.conversations.find((c) => c.id === workspaceConvId);
-    if (conv && conv.message_count === 0) {
-      await chatStore.deleteConversation(workspaceConvId);
-      localStorage.removeItem(_storageKey(projectId.value));
-    }
-  }
 });
 </script>
 
@@ -174,13 +94,6 @@ onUnmounted(async () => {
         >
           Tasks
         </button>
-        <button
-          :class="['panel-toggle', { active: panelOpen.chat }]"
-          title="Toggle Chat panel"
-          @click="togglePanel('chat')"
-        >
-          Chat
-        </button>
         <button
           :class="['panel-toggle', { active: panelOpen.notes }]"
           title="Toggle Notes panel"
@@ -191,9 +104,8 @@ onUnmounted(async () => {
       </div>
     </header>
 
-    <!-- Three-panel body -->
+    <!-- Two-panel body -->
     <div class="ws-body" :style="{ gridTemplateColumns: gridColumns }">
-
       <!-- Left: Tasks -->
       <div v-show="panelOpen.tasks" class="ws-panel">
         <Transition name="panel-fade">
@@ -207,35 +119,8 @@ onUnmounted(async () => {
         </Transition>
       </div>
 
-      <!-- Center: Chat -->
-      <div v-show="panelOpen.chat" class="ws-panel ws-panel-chat">
-        <Transition name="panel-fade">
-          <div v-if="panelOpen.chat" class="panel-inner panel-inner-chat">
-            <!-- Quick chips (shown when conversation is empty) -->
-            <div
-              v-if="chatStore.currentConversation && !chatStore.currentConversation.messages.length && !chatStore.streaming"
-              class="empty-chat-prompt"
-            >
-              <p class="empty-hint">What would you like to work on?</p>
-              <div class="quick-chips">
-                <button class="quick-chip" @click="prefill('Summarize the current status of this project')">📊 Project status</button>
-                <button class="quick-chip" @click="prefill('Create a note about ')">📝 New note</button>
-                <button class="quick-chip" @click="prefill('Add tasks for ')">✓ Add tasks</button>
-              </div>
-            </div>
-            <ChatPanel
-              ref="chatPanelRef"
-              variant="full"
-              :projectId="projectId"
-              placeholder="Message the agent… (Enter to send)"
-              class="ws-chat-panel"
-            />
-          </div>
-        </Transition>
-      </div>
-
       <!-- Right: Note Editor -->
-      <div v-show="panelOpen.notes" class="ws-panel">
+      <div v-show="panelOpen.notes" class="ws-panel ws-panel-notes">
         <Transition name="panel-fade">
           <div v-if="panelOpen.notes" class="panel-inner">
             <WorkspaceNoteEditor
@@ -247,13 +132,21 @@ onUnmounted(async () => {
           </div>
         </Transition>
       </div>
-
     </div>
+
+    <!-- Floating chat widget -->
+    <WorkspaceChatWidget
+      v-if="project"
+      :project-id="projectId"
+      @note-changed="onNoteChanged"
+      @task-changed="onTaskChanged"
+    />
   </div>
 </template>
 
 <style scoped>
 .workspace-root {
+  position: relative;
   display: flex;
   flex-direction: column;
   height: 100%;
@@ -261,7 +154,6 @@ onUnmounted(async () => {
   background: var(--color-bg);
 }
 
-/* Header */
 .ws-header {
   display: flex;
   align-items: center;
@@ -316,7 +208,6 @@ onUnmounted(async () => {
   color: var(--color-primary);
 }
 
-/* Three-panel layout */
 .ws-body {
   display: grid;
   flex: 1;
@@ -329,6 +220,10 @@ onUnmounted(async () => {
   min-width: 0;
 }
 
+.ws-panel-notes {
+  border-left: 1px solid var(--color-border);
+}
+
 .panel-inner {
   height: 100%;
   display: flex;
@@ -343,60 +238,4 @@ onUnmounted(async () => {
 .panel-fade-leave-to {
   opacity: 0;
 }
-
-/* Chat panel */
-.ws-panel-chat {
-  border-left: 1px solid var(--color-border);
-  border-right: 1px solid var(--color-border);
-  display: flex;
-  flex-direction: column;
-}
-
-.panel-inner-chat {
-  position: relative;
-}
-
-.ws-chat-panel {
-  flex: 1;
-  min-height: 0;
-}
-
-.empty-chat-prompt {
-  position: absolute;
-  top: 50%;
-  left: 50%;
-  transform: translate(-50%, -50%);
-  text-align: center;
-  padding: 2rem 1rem;
-  pointer-events: none;
-  z-index: 1;
-}
-.empty-hint {
-  margin: 0 0 1rem;
-  color: var(--color-text-secondary);
-  font-size: 0.9rem;
-}
-.quick-chips {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem;
-  justify-content: center;
-  pointer-events: auto;
-}
-.quick-chip {
-  background: var(--color-surface);
-  border: 1px solid var(--color-border);
-  border-radius: 20px;
-  padding: 0.4rem 0.85rem;
-  font-size: 0.82rem;
-  color: var(--color-text-secondary);
-  cursor: pointer;
-  transition: border-color 0.15s, color 0.15s, background 0.15s;
-  font-family: inherit;
-}
-.quick-chip:hover {
-  border-color: var(--color-primary);
-  color: var(--color-primary);
-  background: color-mix(in srgb, var(--color-primary) 5%, var(--color-surface));
-}
 </style>

frontend/vite.config.ts

@@ -1,9 +1,39 @@
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
+import { viteStaticCopy } from "vite-plugin-static-copy";
 import { resolve } from "path";
 
 export default defineConfig({
-  plugins: [vue()],
+  plugins: [
+    vue(),
+    // @ricky0123/vad-web ships ONNX + audio-worklet assets and depends on
+    // onnxruntime-web's WASM binaries. Copy them into the served root so
+    // MicVAD can load them at runtime via `baseAssetPath: "/"`.
+    viteStaticCopy({
+      targets: [
+        {
+          src: "node_modules/@ricky0123/vad-web/dist/*.onnx",
+          dest: "",
+          rename: { stripBase: true },
+        },
+        {
+          src: "node_modules/@ricky0123/vad-web/dist/vad.worklet.bundle.min.js",
+          dest: "",
+          rename: { stripBase: true },
+        },
+        {
+          src: "node_modules/onnxruntime-web/dist/*.wasm",
+          dest: "",
+          rename: { stripBase: true },
+        },
+        {
+          src: "node_modules/onnxruntime-web/dist/*.mjs",
+          dest: "",
+          rename: { stripBase: true },
+        },
+      ],
+    }),
+  ],
   resolve: {
     alias: {
       "@": resolve(__dirname, "src"),

infra/Dockerfile.runner-base

@@ -1,26 +1,28 @@
 # Runner base image for Forgejo act_runner job containers.
-# Pre-installs Python 3.12 and Node 20 so the test job skips the
-# ~3-4 minute deadsnakes PPA install on every run.
+# Pre-installs Python 3.12, Node 22, uv, and ruff so workflows skip
+# lengthy runtime installs on every run.
 #
-# Build and push (one-time setup, re-run if this file changes):
+# Build and push (re-run when this file changes):
 #   docker build -f infra/Dockerfile.runner-base \
-#     -t git.fabledsword.com/bvandeusen/runner-base:py3.12-node22 .
-#   docker push git.fabledsword.com/bvandeusen/runner-base:py3.12-node22
+#     -t git.fabledsword.com/bvandeusen/runner-base:ci-runner .
+#   docker push git.fabledsword.com/bvandeusen/runner-base:ci-runner
 #
-# Then redeploy the act_runner stack in Portainer to pick up the new label.
+# Then redeploy the act_runner stack in Portainer to pick up the new image.
 
 FROM ubuntu:24.04
 
 ENV DEBIAN_FRONTEND=noninteractive
+ENV TZ=UTC
 
-# Split into separate RUN steps so each pushed layer is smaller.
-# One combined layer would be ~280MB and exceeds the nginx upload timeout.
+# Split into separate RUN steps so each pushed layer is smaller — one
+# combined layer exceeds the nginx upload timeout on the self-hosted
+# Forgejo registry.
 
-# Python 3.12 ships in Ubuntu 24.04 main repos — no PPA needed.
+# Python 3.12 (ships in Ubuntu 24.04 main repos) + core tools
 RUN apt-get update -qq && \
     apt-get install -y -qq \
-      python3.12 python3.12-dev python3.12-venv python3-pip \
-      git curl ca-certificates gnupg && \
+      python3.12 python3.12-dev python3.12-venv \
+      git curl ca-certificates gnupg jq tzdata && \
     apt-get clean && rm -rf /var/lib/apt/lists/*
 
 # Node 22 LTS via NodeSource
@@ -33,3 +35,14 @@ RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - && \
 RUN apt-get update -qq && \
     apt-get install -y -qq docker.io && \
     apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# uv — fast Python package installer/resolver (~10x faster than pip).
+# Used by test jobs instead of pip for venv creation + dep installs.
+RUN curl -LsSf https://astral.sh/uv/install.sh | env INSTALLER_NO_MODIFY_PATH=1 sh && \
+    mv /root/.local/bin/uv /usr/local/bin/ && \
+    mv /root/.local/bin/uvx /usr/local/bin/
+
+# ruff — Python linter. Baked in so the lint job is just
+# `ruff check src/` with zero install overhead.
+RUN curl -LsSf https://astral.sh/ruff/install.sh | env INSTALLER_NO_MODIFY_PATH=1 sh && \
+    mv /root/.local/bin/ruff /usr/local/bin/

scripts/pre_commit_fable_mcp.sh

@@ -8,7 +8,7 @@
 
 set -euo pipefail
 
-REPO_ROOT="/home/bvandeusen/Nextcloud/Projects/fabledassistant"
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 
 input=$(cat)
 command=$(echo "$input" | python3 -c "

src/fabledassistant/app.py

@@ -11,8 +11,8 @@ from fabledassistant.config import Config
 from fabledassistant.routes.admin import admin_bp
 from fabledassistant.routes.api import api
 from fabledassistant.routes.auth import auth_bp
-from fabledassistant.routes.briefing import briefing_bp
 from fabledassistant.routes.chat import chat_bp
+from fabledassistant.routes.journal import journal_bp
 from fabledassistant.routes.export import export_bp
 from fabledassistant.routes.notes import notes_bp
 from fabledassistant.routes.images import images_bp
@@ -75,8 +75,8 @@ def create_app() -> Quart:
     app.register_blueprint(admin_bp)
     app.register_blueprint(api)
     app.register_blueprint(auth_bp)
-    app.register_blueprint(briefing_bp)
     app.register_blueprint(chat_bp)
+    app.register_blueprint(journal_bp)
     app.register_blueprint(export_bp)
     app.register_blueprint(images_bp)
     app.register_blueprint(milestones_bp)
@@ -143,10 +143,14 @@ def create_app() -> Quart:
         response.headers.setdefault("Referrer-Policy", "strict-origin-when-cross-origin")
         response.headers.setdefault(
             "Content-Security-Policy",
-            "default-src 'self'; script-src 'self' 'unsafe-inline'; "
-            "style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; "
-            "connect-src 'self'; font-src 'self' data:; object-src 'none'; "
-            "base-uri 'self'; worker-src 'self';"
+            "default-src 'self'; "
+            "script-src 'self' 'unsafe-inline' 'wasm-unsafe-eval'; "
+            "style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; "
+            "img-src 'self' data: blob:; "
+            "connect-src 'self'; "
+            "font-src 'self' data: https://fonts.gstatic.com; "
+            "object-src 'none'; "
+            "base-uri 'self'; worker-src 'self' blob:;"
         )
 
         return response
@@ -169,11 +173,12 @@ def create_app() -> Quart:
 
         async def _warm_model(model: str) -> None:
             """Warm an already-installed model into VRAM (no pull)."""
+            from fabledassistant.services.llm import keep_alive_for
             try:
                 async with httpx.AsyncClient(timeout=300.0) as client:
                     await client.post(
                         f"{Config.OLLAMA_URL}/api/generate",
-                        json={"model": model, "prompt": "", "keep_alive": "2h"},
+                        json={"model": model, "prompt": "", "keep_alive": keep_alive_for(model)},
                     )
                 logger.info("Warmed model '%s' into VRAM", model)
             except Exception:
@@ -187,14 +192,17 @@ def create_app() -> Quart:
             The num_ctx must match what real requests will use so Ollama doesn't reload.
             """
             try:
-                from fabledassistant.services.llm import build_context, pick_num_ctx
+                from fabledassistant.services.llm import build_context, keep_alive_for, pick_num_ctx
+                from fabledassistant.services.tools import get_tools_for_user
                 messages, _ = await build_context(
                     user_id=user_id,
                     history=[],
                     current_note_id=None,
                     user_message=" ",
                 )
-                num_ctx = pick_num_ctx(messages)
+                # Include tool schemas so num_ctx matches real chat requests.
+                tools = await get_tools_for_user(user_id)
+                num_ctx = pick_num_ctx(messages, tools=tools)
                 async with httpx.AsyncClient(timeout=120.0) as client:
                     await client.post(
                         f"{Config.OLLAMA_URL}/api/chat",
@@ -203,7 +211,7 @@ def create_app() -> Quart:
                             "messages": messages,
                             "stream": False,
                             "options": {"num_predict": 1, "num_ctx": num_ctx},
-                            "keep_alive": "2h",
+                            "keep_alive": keep_alive_for(model),
                         },
                     )
                 logger.info("Primed KV cache for user %d with model '%s' (num_ctx=%d)", user_id, model, num_ctx)
@@ -312,22 +320,12 @@ def create_app() -> Quart:
                 await backfill_project_summaries()
             except Exception:
                 logger.warning("Project summary backfill failed", exc_info=True)
-            try:
-                from fabledassistant.services.embeddings import backfill_rss_item_embeddings
-                await backfill_rss_item_embeddings()
-            except Exception:
-                logger.warning("RSS embedding backfill failed", exc_info=True)
-            try:
-                from fabledassistant.services.embeddings import backfill_rss_article_content
-                await backfill_rss_article_content()
-            except Exception:
-                logger.warning("RSS article content backfill failed", exc_info=True)
 
         asyncio.create_task(_delayed_backfill())
 
-        # Start briefing scheduler
-        from fabledassistant.services.briefing_scheduler import start_briefing_scheduler
-        await start_briefing_scheduler(asyncio.get_running_loop())
+        # Start journal scheduler (per-user daily prep generation)
+        from fabledassistant.services.journal_scheduler import start_journal_scheduler
+        start_journal_scheduler(asyncio.get_running_loop())
 
         # Start event scheduler (reminders + CalDAV pull sync)
         from fabledassistant.services.event_scheduler import start_event_scheduler
@@ -341,8 +339,8 @@ def create_app() -> Quart:
 
     @app.after_serving
     async def shutdown():
-        from fabledassistant.services.briefing_scheduler import stop_briefing_scheduler
-        stop_briefing_scheduler()
+        from fabledassistant.services.journal_scheduler import stop_journal_scheduler
+        stop_journal_scheduler()
         from fabledassistant.services.event_scheduler import stop_event_scheduler
         stop_event_scheduler()
 

src/fabledassistant/config.py

@@ -25,9 +25,15 @@ class Config:
     OLLAMA_URL: str = os.environ.get("OLLAMA_URL", "http://localhost:11434")
     OLLAMA_MODEL: str = os.environ.get("OLLAMA_MODEL", "qwen3:latest")
     # Lightweight model for background tasks (title generation, tag suggestions,
-    # project summaries, RSS classification). Using a separate model keeps the
+    # project summaries). Using a separate model keeps the
     # main model's KV cache intact between user messages, enabling prefix cache hits.
-    OLLAMA_BACKGROUND_MODEL: str = os.environ.get("OLLAMA_BACKGROUND_MODEL", "qwen2.5:3b")
+    OLLAMA_BACKGROUND_MODEL: str = os.environ.get("OLLAMA_BACKGROUND_MODEL", "gemma3:4b")
+    # Ollama keep_alive — how long a model stays resident in VRAM after its last
+    # request. Main model gets a longer window since it's used interactively;
+    # the background model is called sporadically and doesn't need to camp VRAM.
+    # Format matches Ollama's duration strings: "30m", "10m", "1h", "0s", "-1" (forever).
+    OLLAMA_KEEP_ALIVE_MAIN: str = os.environ.get("OLLAMA_KEEP_ALIVE_MAIN", "30m")
+    OLLAMA_KEEP_ALIVE_BACKGROUND: str = os.environ.get("OLLAMA_KEEP_ALIVE_BACKGROUND", "10m")
     # KV cache context window for generation. Keep this as small as practical —
     # a larger context forces more KV cache into CPU RAM, drastically slowing prefill.
     # 16384 covers ~30+ message conversations with our system prompt comfortably.
@@ -46,7 +52,7 @@ class Config:
     SMTP_USERNAME: str = os.environ.get("SMTP_USERNAME", "")
     SMTP_PASSWORD: str = _read_secret("SMTP_PASSWORD", "SMTP_PASSWORD_FILE", "")
     SMTP_FROM_ADDRESS: str = os.environ.get("SMTP_FROM_ADDRESS", "")
-    SMTP_FROM_NAME: str = os.environ.get("SMTP_FROM_NAME", "Fabled Assistant")
+    SMTP_FROM_NAME: str = os.environ.get("SMTP_FROM_NAME", "Fabled Scribe")
     SMTP_USE_TLS: bool = os.environ.get("SMTP_USE_TLS", "true").lower() in ("1", "true", "yes")
     BASE_URL: str = os.environ.get("BASE_URL", "http://localhost:5000").rstrip("/")
     TRUST_PROXY_HEADERS: bool = os.environ.get("TRUST_PROXY_HEADERS", "").lower() in ("1", "true", "yes")

src/fabledassistant/models/__init__.py

@@ -38,8 +38,14 @@ from fabledassistant.models.note_version import NoteVersion  # noqa: E402, F401
 from fabledassistant.models.group import Group, GroupMembership  # noqa: E402, F401
 from fabledassistant.models.share import NoteShare, ProjectShare  # noqa: E402, F401
 from fabledassistant.models.notification import Notification  # noqa: E402, F401
-from fabledassistant.models.rss_feed import RssFeed, RssItem  # noqa: E402, F401
 from fabledassistant.models.weather_cache import WeatherCache  # noqa: E402, F401
 from fabledassistant.models.api_key import ApiKey  # noqa: E402, F401
 from fabledassistant.models.user_profile import UserProfile  # noqa: E402, F401
-from fabledassistant.models.rss_item_embedding import RssItemEmbedding  # noqa: E402, F401
+from fabledassistant.models.moment import (  # noqa: E402, F401
+    Moment,
+    MomentEmbedding,
+    moment_people,
+    moment_places,
+    moment_tasks,
+    moment_notes,
+)

src/fabledassistant/models/conversation.py

@@ -18,11 +18,11 @@ class Conversation(Base, TimestampMixin):
     )
     title: Mapped[str] = mapped_column(Text, default="")
     model: Mapped[str] = mapped_column(Text, default="")
-    # 'chat' (default) or 'briefing'. Briefing conversations are hidden from
-    # the main chat view and managed by the briefing pipeline.
+    # 'chat' (default) or 'journal'. Journal conversations are day-anchored
+    # and rendered by the /journal view; they are hidden from the main chat list.
     conversation_type: Mapped[str] = mapped_column(Text, default="chat", server_default="chat")
-    # For briefing conversations only: the calendar date this briefing covers.
-    briefing_date: Mapped[datetime.date | None] = mapped_column(Date, nullable=True)
+    # For journal conversations only: the calendar date this conversation covers.
+    day_date: Mapped[datetime.date | None] = mapped_column(Date, nullable=True)
     # NULL = orphan notes only; -1 = all notes; positive int = specific project
     rag_project_id: Mapped[int | None] = mapped_column(Integer, nullable=True, default=None)
 
@@ -48,7 +48,7 @@ class Conversation(Base, TimestampMixin):
             "title": self.title,
             "model": self.model,
             "conversation_type": self.conversation_type,
-            "briefing_date": self.briefing_date.isoformat() if self.briefing_date else None,
+            "day_date": self.day_date.isoformat() if self.day_date else None,
             "rag_project_id": self.rag_project_id,
             "message_count": msg_count,
             "created_at": self.created_at.isoformat(),

src/fabledassistant/models/moment.py

@@ -0,0 +1,130 @@
+import datetime
+
+from sqlalchemy import Boolean, Column, Date, DateTime, ForeignKey, Index, Integer, Table, Text
+from sqlalchemy.dialects.postgresql import ARRAY, JSONB
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from fabledassistant.models import Base
+
+
+# Junction tables. People, Places, Tasks, and (regular) Notes all live in
+# the `notes` table — the four junctions are kept separate (rather than one
+# merged table with a discriminator) so per-kind queries don't require a
+# filter, and so the schema is explicit about which links are which.
+moment_people = Table(
+    "moment_people",
+    Base.metadata,
+    Column("moment_id", Integer, ForeignKey("moments.id", ondelete="CASCADE"), primary_key=True),
+    Column("person_id", Integer, ForeignKey("notes.id", ondelete="CASCADE"), primary_key=True),
+)
+
+moment_places = Table(
+    "moment_places",
+    Base.metadata,
+    Column("moment_id", Integer, ForeignKey("moments.id", ondelete="CASCADE"), primary_key=True),
+    Column("place_id", Integer, ForeignKey("notes.id", ondelete="CASCADE"), primary_key=True),
+)
+
+moment_tasks = Table(
+    "moment_tasks",
+    Base.metadata,
+    Column("moment_id", Integer, ForeignKey("moments.id", ondelete="CASCADE"), primary_key=True),
+    Column("task_id", Integer, ForeignKey("notes.id", ondelete="CASCADE"), primary_key=True),
+)
+
+moment_notes = Table(
+    "moment_notes",
+    Base.metadata,
+    Column("moment_id", Integer, ForeignKey("moments.id", ondelete="CASCADE"), primary_key=True),
+    Column("note_id", Integer, ForeignKey("notes.id", ondelete="CASCADE"), primary_key=True),
+)
+
+
+class Moment(Base):
+    """A small structured extraction from a journal conversation.
+
+    Many per day. Emitted by the LLM via the `record_moment` tool when it
+    notices a meaningful beat. Stored separately from Notes — they are
+    different in kind: Notes are curated artifacts; Moments are ambient
+    trace data with their own embedding index, so notes-RAG and journal-RAG
+    cannot cross-contaminate.
+    """
+
+    __tablename__ = "moments"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    user_id: Mapped[int] = mapped_column(
+        Integer, ForeignKey("users.id", ondelete="CASCADE"), nullable=False
+    )
+    conversation_id: Mapped[int | None] = mapped_column(
+        Integer, ForeignKey("conversations.id", ondelete="SET NULL"), nullable=True
+    )
+    source_message_id: Mapped[int | None] = mapped_column(
+        Integer, ForeignKey("messages.id", ondelete="SET NULL"), nullable=True
+    )
+    day_date: Mapped[datetime.date] = mapped_column(Date, nullable=False)
+    occurred_at: Mapped[datetime.datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False
+    )
+    recorded_at: Mapped[datetime.datetime] = mapped_column(
+        DateTime(timezone=True),
+        nullable=False,
+        default=lambda: datetime.datetime.now(datetime.timezone.utc),
+    )
+    content: Mapped[str] = mapped_column(Text, nullable=False)
+    raw_excerpt: Mapped[str | None] = mapped_column(Text, nullable=True)
+    tags: Mapped[list[str]] = mapped_column(ARRAY(Text), nullable=False, default=list)
+    pinned: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
+
+    people = relationship("Note", secondary=moment_people, lazy="selectin", viewonly=True)
+    places = relationship("Note", secondary=moment_places, lazy="selectin", viewonly=True)
+    tasks = relationship("Note", secondary=moment_tasks, lazy="selectin", viewonly=True)
+    notes = relationship("Note", secondary=moment_notes, lazy="selectin", viewonly=True)
+
+    __table_args__ = (
+        Index("ix_moments_user_day", "user_id", "day_date"),
+        Index("ix_moments_user_occurred", "user_id", "occurred_at"),
+    )
+
+    def to_dict(self, *, include_links: bool = True) -> dict:
+        result: dict = {
+            "id": self.id,
+            "user_id": self.user_id,
+            "conversation_id": self.conversation_id,
+            "source_message_id": self.source_message_id,
+            "day_date": self.day_date.isoformat(),
+            "occurred_at": self.occurred_at.isoformat(),
+            "recorded_at": self.recorded_at.isoformat(),
+            "content": self.content,
+            "raw_excerpt": self.raw_excerpt,
+            "tags": list(self.tags or []),
+            "pinned": self.pinned,
+        }
+        if include_links:
+            result["people"] = [{"id": p.id, "title": p.title} for p in (self.people or [])]
+            result["places"] = [{"id": p.id, "title": p.title} for p in (self.places or [])]
+            result["task_ids"] = [t.id for t in (self.tasks or [])]
+            result["note_ids"] = [n.id for n in (self.notes or [])]
+        return result
+
+
+class MomentEmbedding(Base):
+    """Embedding vector for a Moment — used by `search_journal` semantic mode.
+
+    Stored separately from `note_embeddings` so notes-RAG and journal-RAG
+    cannot cross-contaminate. This is a hard invariant of the journal design.
+    """
+
+    __tablename__ = "moment_embeddings"
+
+    moment_id: Mapped[int] = mapped_column(
+        Integer,
+        ForeignKey("moments.id", ondelete="CASCADE"),
+        primary_key=True,
+    )
+    user_id: Mapped[int] = mapped_column(Integer, nullable=False, index=True)
+    embedding: Mapped[list] = mapped_column(JSONB, nullable=False)
+    updated_at: Mapped[datetime.datetime] = mapped_column(
+        DateTime(timezone=True),
+        default=lambda: datetime.datetime.now(datetime.timezone.utc),
+    )

src/fabledassistant/models/rss_feed.py

@@ -1,78 +0,0 @@
-from datetime import datetime, timezone
-
-from sqlalchemy import ARRAY, DateTime, ForeignKey, Index, Integer, Text, UniqueConstraint
-from sqlalchemy.orm import Mapped, mapped_column, relationship
-
-from fabledassistant.models import Base
-
-
-class RssFeed(Base):
-    __tablename__ = "rss_feeds"
-
-    id: Mapped[int] = mapped_column(primary_key=True)
-    user_id: Mapped[int] = mapped_column(Integer, ForeignKey("users.id", ondelete="CASCADE"))
-    url: Mapped[str] = mapped_column(Text)
-    title: Mapped[str] = mapped_column(Text, default="")
-    category: Mapped[str | None] = mapped_column(Text, nullable=True)
-    last_fetched_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
-
-    items: Mapped[list["RssItem"]] = relationship(
-        back_populates="feed", cascade="all, delete-orphan"
-    )
-
-    __table_args__ = (
-        UniqueConstraint("user_id", "url", name="uq_rss_feeds_user_url"),
-        Index("ix_rss_feeds_user_id", "user_id"),
-    )
-
-    def to_dict(self) -> dict:
-        return {
-            "id": self.id,
-            "url": self.url,
-            "title": self.title,
-            "category": self.category,
-            "last_fetched_at": self.last_fetched_at.isoformat() if self.last_fetched_at else None,
-        }
-
-
-class RssItem(Base):
-    __tablename__ = "rss_items"
-
-    id: Mapped[int] = mapped_column(primary_key=True)
-    feed_id: Mapped[int] = mapped_column(Integer, ForeignKey("rss_feeds.id", ondelete="CASCADE"))
-    guid: Mapped[str] = mapped_column(Text)
-    title: Mapped[str] = mapped_column(Text, default="")
-    url: Mapped[str] = mapped_column(Text, default="")
-    published_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
-    # Truncated to 2000 chars to keep DB size reasonable
-    content: Mapped[str] = mapped_column(Text, default="")
-    fetched_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)
-    )
-    topics: Mapped[list[str]] = mapped_column(
-        ARRAY(Text), nullable=False, default=list, server_default="{}"
-    )
-    classified_at: Mapped[datetime | None] = mapped_column(
-        DateTime(timezone=True), nullable=True
-    )
-
-    feed: Mapped["RssFeed"] = relationship(back_populates="items")
-
-    __table_args__ = (
-        UniqueConstraint("feed_id", "guid", name="uq_rss_items_feed_guid"),
-        Index("ix_rss_items_feed_id", "feed_id"),
-        Index("ix_rss_items_published_at", "published_at"),
-    )
-
-    def to_dict(self) -> dict:
-        return {
-            "id": self.id,
-            "feed_id": self.feed_id,
-            "guid": self.guid,
-            "title": self.title,
-            "url": self.url,
-            "published_at": self.published_at.isoformat() if self.published_at else None,
-            "content": self.content,
-            "topics": self.topics or [],
-            "classified_at": self.classified_at.isoformat() if self.classified_at else None,
-        }

src/fabledassistant/models/rss_item_embedding.py

@@ -1,25 +0,0 @@
-from datetime import datetime, timezone
-
-from sqlalchemy import DateTime, ForeignKey, Integer
-from sqlalchemy.dialects.postgresql import JSONB
-from sqlalchemy.orm import Mapped, mapped_column
-
-from fabledassistant.models import Base
-
-
-class RssItemEmbedding(Base):
-    """Stores the embedding vector for an RSS item, used for semantic news search."""
-
-    __tablename__ = "rss_item_embeddings"
-
-    rss_item_id: Mapped[int] = mapped_column(
-        Integer,
-        ForeignKey("rss_items.id", ondelete="CASCADE"),
-        primary_key=True,
-    )
-    user_id: Mapped[int] = mapped_column(Integer, nullable=False, index=True)
-    embedding: Mapped[list] = mapped_column(JSONB, nullable=False)
-    updated_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True),
-        default=lambda: datetime.now(timezone.utc),
-    )

src/fabledassistant/routes/briefing.py

@@ -1,649 +0,0 @@
-"""Briefing API: RSS feeds, weather, and briefing configuration."""
-
-import asyncio
-import json
-import logging
-
-from quart import Blueprint, g, jsonify, request
-from sqlalchemy import select
-
-from fabledassistant.auth import login_required
-from fabledassistant.models import async_session
-from fabledassistant.models.conversation import Conversation, Message
-from fabledassistant.models.rss_feed import RssFeed, RssItem
-from fabledassistant.services import rss as rss_svc
-from fabledassistant.services import weather as weather_svc
-from fabledassistant.services.briefing_conversations import (
-    get_or_create_today_conversation,
-    list_briefing_conversations,
-    post_message,
-)
-from fabledassistant.services.chat import add_message, get_conversation
-from fabledassistant.services.generation_buffer import create_buffer, get_buffer
-from fabledassistant.services.generation_task import run_generation
-from fabledassistant.services.settings import get_setting, set_settings_batch
-
-logger = logging.getLogger(__name__)
-briefing_bp = Blueprint("briefing", __name__, url_prefix="/api/briefing")
-
-_REQUIRE = login_required
-
-
-# ── Config ────────────────────────────────────────────────────────────────────
-
-@briefing_bp.route("/config", methods=["GET"])
-@_REQUIRE
-async def get_config():
-    raw = await get_setting(g.user.id, "briefing_config", "{}")
-    try:
-        config = json.loads(raw) if isinstance(raw, str) else (raw or {})
-    except Exception:
-        config = {}
-    return jsonify(config)
-
-
-@briefing_bp.route("/config", methods=["PUT"])
-@_REQUIRE
-async def put_config():
-    data = await request.get_json()
-    await set_settings_batch(g.user.id, {"briefing_config": json.dumps(data)})
-    # Live-patch the scheduler using the stored user_timezone.
-    from fabledassistant.services.briefing_scheduler import update_user_schedule
-    tz_override = await get_setting(g.user.id, "user_timezone") or None
-    update_user_schedule(g.user.id, data, tz_override=tz_override)
-    return jsonify({"ok": True})
-
-
-# ── RSS Feeds ─────────────────────────────────────────────────────────────────
-
-@briefing_bp.route("/feeds", methods=["GET"])
-@_REQUIRE
-async def list_feeds():
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssFeed).where(RssFeed.user_id == g.user.id).order_by(RssFeed.id)
-        )
-        feeds = list(result.scalars().all())
-    return jsonify([f.to_dict() for f in feeds])
-
-
-@briefing_bp.route("/feeds", methods=["POST"])
-@_REQUIRE
-async def add_feed():
-    data = await request.get_json()
-    url = (data.get("url") or "").strip()
-    if not url:
-        return jsonify({"error": "url required"}), 400
-    scheme = url.split("://")[0].lower() if "://" in url else ""
-    if scheme not in ("http", "https"):
-        return jsonify({"error": "Feed URL must use http or https"}), 400
-    from fabledassistant.services.llm import _is_private_url
-    if _is_private_url(url):
-        return jsonify({"error": "Feed URL must not point to an internal address"}), 400
-    category = data.get("category") or None
-
-    async with async_session() as session:
-        # Prevent duplicates
-        existing = await session.execute(
-            select(RssFeed).where(RssFeed.user_id == g.user.id, RssFeed.url == url)
-        )
-        if existing.scalars().first():
-            return jsonify({"error": "Feed already added"}), 409
-
-        feed = RssFeed(user_id=g.user.id, url=url, title="", category=category)
-        session.add(feed)
-        await session.commit()
-        await session.refresh(feed)
-        feed_id = feed.id
-
-    # Fetch in background to auto-populate title and get initial items
-    asyncio.create_task(rss_svc.fetch_and_cache_feed(feed_id, url))
-
-    return jsonify({"id": feed_id, "url": url, "title": "", "category": category}), 201
-
-
-@briefing_bp.route("/feeds/<int:feed_id>", methods=["DELETE"])
-@_REQUIRE
-async def delete_feed(feed_id: int):
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssFeed).where(RssFeed.id == feed_id, RssFeed.user_id == g.user.id)
-        )
-        feed = result.scalars().first()
-        if not feed:
-            return jsonify({"error": "Not found"}), 404
-        await session.delete(feed)
-        await session.commit()
-    return jsonify({"ok": True})
-
-
-@briefing_bp.route("/feeds/refresh", methods=["POST"])
-@_REQUIRE
-async def refresh_feeds():
-    results = await rss_svc.refresh_all_feeds(g.user.id)
-    total_new = sum(results.values())
-    return jsonify({"feeds_refreshed": len(results), "new_items": total_new})
-
-
-@briefing_bp.route("/feeds/recent", methods=["GET"])
-@_REQUIRE
-async def recent_items():
-    limit = min(int(request.args.get("limit", 20)), 100)
-    items = await rss_svc.get_recent_items(g.user.id, limit=limit)
-    return jsonify({"items": items})
-
-
-# ── Weather ───────────────────────────────────────────────────────────────────
-
-@briefing_bp.route("/weather", methods=["GET"])
-@_REQUIRE
-async def get_weather():
-    rows = await weather_svc.get_cached_weather_rows(g.user.id)
-    import json as _json
-    raw = await get_setting(g.user.id, "briefing_config", "{}")
-    try:
-        _cfg = _json.loads(raw) if isinstance(raw, str) else (raw or {})
-        temp_unit = _cfg.get("temp_unit", "C")
-        if temp_unit not in ("C", "F"):
-            temp_unit = "C"
-    except Exception:
-        temp_unit = "C"
-    cards = [
-        card for row in rows
-        if (card := weather_svc.parse_weather_card_data(row, temp_unit)) is not None
-    ]
-    return jsonify({"locations": cards, "temp_unit": temp_unit})
-
-
-@briefing_bp.route("/weather/current", methods=["GET"])
-@_REQUIRE
-async def get_current_weather():
-    """Return current temperature, conditions, and precipitation for the user's primary location.
-
-    Lightweight — fetches live from Open-Meteo, no caching. Intended for periodic frontend polling.
-    """
-    raw = await get_setting(g.user.id, "briefing_config", "{}")
-    try:
-        config = json.loads(raw) if isinstance(raw, str) else (raw or {})
-        temp_unit = config.get("temp_unit", "C")
-        if temp_unit not in ("C", "F"):
-            temp_unit = "C"
-        locations = config.get("locations", {})
-    except Exception:
-        return jsonify({"error": "No briefing config"}), 404
-
-    # Use home location, fall back to work
-    loc = locations.get("home") or locations.get("work")
-    if not loc or not loc.get("lat") or not loc.get("lon"):
-        return jsonify({"error": "No location configured"}), 404
-
-    from fabledassistant.services.weather import fetch_current_conditions
-    current = await fetch_current_conditions(loc["lat"], loc["lon"])
-    if current is None:
-        return jsonify({"error": "Failed to fetch current conditions"}), 502
-
-    # Convert temperature if needed
-    temp = current["temperature"]
-    if temp is not None and temp_unit == "F":
-        temp = temp * 9 / 5 + 32
-    current["temperature"] = round(temp) if temp is not None else None
-    current["temp_unit"] = temp_unit
-    current["location"] = loc.get("label") or "Home"
-
-    return jsonify(current)
-
-
-@briefing_bp.route("/weather/geocode", methods=["POST"])
-@_REQUIRE
-async def geocode_location():
-    data = await request.get_json()
-    query = (data.get("query") or "").strip()
-    if not query:
-        return jsonify({"error": "query required"}), 400
-    try:
-        lat, lon, label = await weather_svc.geocode(query)
-        return jsonify({"lat": lat, "lon": lon, "label": label})
-    except ValueError as e:
-        return jsonify({"error": str(e)}), 404
-
-
-@briefing_bp.route("/weather/refresh", methods=["POST"])
-@_REQUIRE
-async def refresh_weather():
-    raw = await get_setting(g.user.id, "briefing_config", "{}")
-    try:
-        config = json.loads(raw) if isinstance(raw, str) else {}
-    except Exception:
-        config = {}
-
-    locations = config.get("locations", {})
-    refreshed = []
-    for key, loc in locations.items():
-        if not loc.get("lat") or not loc.get("lon"):
-            continue
-        try:
-            await weather_svc.refresh_location_cache(
-                user_id=g.user.id,
-                location_key=key,
-                location_label=loc.get("label", key),
-                lat=loc["lat"],
-                lon=loc["lon"],
-            )
-            refreshed.append(key)
-        except Exception:
-            logger.warning("Failed to refresh weather for %s", key, exc_info=True)
-
-    return jsonify({"refreshed": refreshed})
-
-
-# ── Briefing Conversations ─────────────────────────────────────────────────────
-
-@briefing_bp.route("/conversations", methods=["GET"])
-@_REQUIRE
-async def get_conversations():
-    convs = await list_briefing_conversations(g.user.id)
-    return jsonify({"conversations": convs})
-
-
-@briefing_bp.route("/conversations/today", methods=["GET"])
-@_REQUIRE
-async def get_today_conversation():
-    model = await get_setting(g.user.id, "default_model", "")
-    conv = await get_or_create_today_conversation(g.user.id, model)
-    # Load messages
-    async with async_session() as session:
-        result = await session.execute(
-            select(Message)
-            .where(Message.conversation_id == conv.id)
-            .order_by(Message.created_at)
-        )
-        messages = [m.to_dict() for m in result.scalars().all()]
-    data = conv.to_dict()
-    data["messages"] = messages
-    return jsonify(data)
-
-
-@briefing_bp.route("/conversations/<int:conv_id>/messages", methods=["GET"])
-@_REQUIRE
-async def get_conversation_messages(conv_id: int):
-    # Verify ownership
-    async with async_session() as session:
-        conv = await session.get(Conversation, conv_id)
-        if not conv or conv.user_id != g.user.id or conv.conversation_type != "briefing":
-            return jsonify({"error": "Not found"}), 404
-        result = await session.execute(
-            select(Message)
-            .where(Message.conversation_id == conv_id)
-            .order_by(Message.created_at)
-        )
-        messages = [m.to_dict() for m in result.scalars().all()]
-    return jsonify({"messages": messages})
-
-
-@briefing_bp.route("/trigger", methods=["POST"])
-@_REQUIRE
-async def manual_trigger():
-    """Manually trigger a briefing compilation, including a fresh data refresh."""
-    data = await request.get_json() or {}
-    slot = data.get("slot", "compilation")
-    if slot not in ("compilation", "morning", "midday", "afternoon"):
-        return jsonify({"error": "invalid slot"}), 400
-
-    # Refresh external data first (mirrors what the scheduler does)
-    try:
-        from fabledassistant.services.rss import refresh_all_feeds
-        config_raw = await get_setting(g.user.id, "briefing_config", "{}")
-        config = json.loads(config_raw) if isinstance(config_raw, str) else {}
-        await refresh_all_feeds(g.user.id)
-        for key, loc in config.get("locations", {}).items():
-            if loc.get("lat") and loc.get("lon"):
-                await weather_svc.refresh_location_cache(
-                    user_id=g.user.id,
-                    location_key=key,
-                    location_label=loc.get("label", key),
-                    lat=loc["lat"],
-                    lon=loc["lon"],
-                )
-    except Exception:
-        logger.warning("Pre-trigger refresh failed for user %d", g.user.id, exc_info=True)
-
-    from fabledassistant.services.briefing_pipeline import run_compilation
-
-    model = await get_setting(g.user.id, "default_model", "")
-    conv = await get_or_create_today_conversation(g.user.id, model)
-    text, metadata = await run_compilation(g.user.id, slot, model)
-    msg = await post_message(conv.id, "assistant", text, metadata=metadata)
-    return jsonify({"conversation_id": conv.id, "message_id": msg.id, "slot": slot})
-
-
-# ── RSS Reactions ──────────────────────────────────────────────────────────────
-
-@briefing_bp.route("/rss-reactions", methods=["POST"])
-@_REQUIRE
-async def upsert_rss_reaction():
-    """Upsert a 👍/👎 reaction on an RSS item. Same reaction toggles off; opposite flips."""
-    data = await request.get_json()
-    rss_item_id = data.get("rss_item_id")
-    reaction = data.get("reaction")
-
-    if not rss_item_id or reaction not in ("up", "down"):
-        return jsonify({"error": "rss_item_id and reaction ('up'|'down') required"}), 400
-
-    from sqlalchemy import text as _text
-
-    async with async_session() as session:
-        # Ownership check: verify item belongs to a feed owned by this user
-        result = await session.execute(
-            _text("""
-                SELECT i.id FROM rss_items i
-                JOIN rss_feeds f ON f.id = i.feed_id
-                WHERE i.id = :item_id AND f.user_id = :uid
-            """).bindparams(item_id=rss_item_id, uid=g.user.id)
-        )
-        if result.first() is None:
-            return jsonify({"error": "Not found"}), 404
-
-        # Check existing reaction
-        existing = await session.execute(
-            _text("""
-                SELECT id, reaction FROM rss_item_reactions
-                WHERE user_id = :uid AND rss_item_id = :item_id
-            """).bindparams(uid=g.user.id, item_id=rss_item_id)
-        )
-        row = existing.first()
-
-        if row is None:
-            await session.execute(
-                _text("""
-                    INSERT INTO rss_item_reactions (user_id, rss_item_id, reaction)
-                    VALUES (:uid, :item_id, :reaction)
-                """).bindparams(uid=g.user.id, item_id=rss_item_id, reaction=reaction)
-            )
-            action = "created"
-        elif row.reaction == reaction:
-            # Toggle off (same reaction clicked again)
-            await session.execute(
-                _text("""
-                    DELETE FROM rss_item_reactions
-                    WHERE user_id = :uid AND rss_item_id = :item_id
-                """).bindparams(uid=g.user.id, item_id=rss_item_id)
-            )
-            action = "removed"
-        else:
-            # Flip to opposite reaction
-            await session.execute(
-                _text("""
-                    UPDATE rss_item_reactions SET reaction = :reaction
-                    WHERE user_id = :uid AND rss_item_id = :item_id
-                """).bindparams(reaction=reaction, uid=g.user.id, item_id=rss_item_id)
-            )
-            action = "updated"
-
-        await session.commit()
-
-    return jsonify({"ok": True, "action": action})
-
-
-@briefing_bp.route("/rss-reactions/<int:item_id>", methods=["DELETE"])
-@_REQUIRE
-async def delete_rss_reaction(item_id: int):
-    """Explicitly remove a reaction (useful for MCP/external API callers)."""
-    from sqlalchemy import text as _text
-
-    async with async_session() as session:
-        await session.execute(
-            _text("""
-                DELETE FROM rss_item_reactions
-                WHERE user_id = :uid AND rss_item_id = :item_id
-            """).bindparams(uid=g.user.id, item_id=item_id)
-        )
-        await session.commit()
-
-    return jsonify({"ok": True})
-
-
-@briefing_bp.route("/news", methods=["GET"])
-@_REQUIRE
-async def list_news():
-    """Return recent RSS articles with optional feed filter and pagination.
-
-    Query params:
-      days    — lookback window (default 2, max 90)
-      limit   — items per page (default 40, max 100)
-      offset  — pagination offset (default 0)
-      feed_id — optional integer filter by feed
-    """
-    from sqlalchemy import text as _text
-
-    days = min(int(request.args.get("days", 2)), 90)
-    limit = min(int(request.args.get("limit", 40)), 100)
-    offset = max(int(request.args.get("offset", 0)), 0)
-    feed_id = request.args.get("feed_id", type=int)
-
-    async with async_session() as session:
-        result = await session.execute(
-            _text("""
-                SELECT
-                    i.id, i.title, i.url, i.content, i.published_at,
-                    i.topics, f.title AS feed_title,
-                    r.reaction
-                FROM rss_items i
-                JOIN rss_feeds f ON f.id = i.feed_id
-                LEFT JOIN rss_item_reactions r
-                    ON r.rss_item_id = i.id AND r.user_id = :uid
-                WHERE f.user_id = :uid
-                  AND (CAST(:feed_id AS integer) IS NULL OR f.id = CAST(:feed_id AS integer))
-                  AND COALESCE(i.published_at, i.fetched_at) >= NOW() - make_interval(days => :days)
-                ORDER BY COALESCE(i.published_at, i.fetched_at) DESC
-                LIMIT :limit OFFSET :offset
-            """).bindparams(uid=g.user.id, days=days, limit=limit,
-                            offset=offset, feed_id=feed_id)
-        )
-        rows = result.mappings().all()
-
-    items = [
-        {
-            "id": r["id"],
-            "title": r["title"],
-            "url": r["url"],
-            "snippet": (r["content"] or "")[:300],
-            "content": r["content"] or "",
-            "published_at": r["published_at"].isoformat() if r["published_at"] else None,
-            "topics": r["topics"] or [],
-            "source": r["feed_title"],
-            "reaction": r["reaction"],
-        }
-        for r in rows
-    ]
-    return jsonify({"items": items, "offset": offset, "limit": limit})
-
-
-# ── Article Discuss ────────────────────────────────────────────────────────────
-
-@briefing_bp.route("/articles/<int:item_id>/discuss", methods=["POST"])
-@_REQUIRE
-async def discuss_article(item_id: int):
-    """Inject article content as a synthetic tool exchange and trigger generation."""
-    data = await request.get_json() or {}
-    conv_id = data.get("conv_id")
-    if not conv_id:
-        return jsonify({"error": "conv_id required"}), 400
-
-    uid = g.user.id
-
-    # Verify item belongs to user via feed ownership
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssItem)
-            .join(RssFeed, RssFeed.id == RssItem.feed_id)
-            .where(RssItem.id == item_id, RssFeed.user_id == uid)
-        )
-        item = result.scalars().first()
-    if item is None:
-        return jsonify({"error": "Not found"}), 404
-
-    # Verify conversation belongs to user
-    conv = await get_conversation(uid, conv_id)
-    if conv is None:
-        return jsonify({"error": "Conversation not found"}), 404
-
-    # Reject if generation already running
-    if get_buffer(conv_id) is not None:
-        return jsonify({"error": "Generation already in progress"}), 409
-
-    from fabledassistant.services.rss import _fetch_full_article
-    article_content = await _fetch_full_article(item.url) or item.content or ""
-
-    # Store synthetic assistant message with read_article tool result
-    synthetic_tool_calls = [{
-        "function": "read_article",
-        "arguments": {"url": item.url},
-        "result": {
-            "success": True,
-            "type": "article_content",
-            "url": item.url,
-            "content": article_content,
-            "truncated": False,
-        },
-    }]
-    await add_message(conv_id, "assistant", "", status="complete", tool_calls=synthetic_tool_calls)
-
-    # Store user message
-    await add_message(conv_id, "user", "Please summarize and discuss this article.")
-
-    # Reload conversation with fresh messages to build history
-    conv = await get_conversation(uid, conv_id)
-    assert conv is not None
-
-    history = []
-    for msg in conv.messages:
-        if msg.role == "system":
-            continue
-        msg_dict = {"role": msg.role, "content": msg.content or ""}
-        if msg.tool_calls:
-            msg_dict["tool_calls"] = [
-                {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-                for tc in msg.tool_calls
-            ]
-            history.append(msg_dict)
-            for tc in msg.tool_calls:
-                history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-        else:
-            history.append(msg_dict)
-
-    model = await get_setting(uid, "default_model", "") or ""
-
-    assistant_msg = await add_message(conv_id, "assistant", "", status="generating")
-    buf = create_buffer(conv_id, assistant_msg.id)
-
-    asyncio.create_task(run_generation(
-        buf, history, model,
-        uid, conv_id, conv.title or "",
-        "Please summarize and discuss this article.",
-        think=True,
-    ))
-
-    return jsonify({"assistant_message_id": assistant_msg.id, "status": "generating"}), 202
-
-
-@briefing_bp.route("/topics/<topic>/discuss", methods=["POST"])
-@_REQUIRE
-async def discuss_topic(topic: str):
-    """Discuss all recent articles in a topic cluster — multi-article deep analysis."""
-    data = await request.get_json() or {}
-    conv_id = data.get("conv_id")
-    if not conv_id:
-        return jsonify({"error": "conv_id required"}), 400
-
-    uid = g.user.id
-
-    # Verify conversation belongs to user
-    conv = await get_conversation(uid, conv_id)
-    if conv is None:
-        return jsonify({"error": "Conversation not found"}), 404
-
-    if get_buffer(conv_id) is not None:
-        return jsonify({"error": "Generation already in progress"}), 409
-
-    # Find recent articles with this topic (last 2 days)
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssItem)
-            .join(RssFeed, RssFeed.id == RssItem.feed_id)
-            .where(RssFeed.user_id == uid)
-            .where(RssItem.topics.contains([topic]))
-            .order_by(RssItem.published_at.desc().nullslast())
-            .limit(5)
-        )
-        items = list(result.scalars().all())
-
-    if not items:
-        return jsonify({"error": f"No articles found for topic '{topic}'"}), 404
-
-    # Fetch full content for each article
-    from fabledassistant.services.rss import _fetch_full_article
-
-    synthetic_tool_calls = []
-    for item in items:
-        content = await _fetch_full_article(item.url) if item.url else None
-        content = content or item.content or ""
-        synthetic_tool_calls.append({
-            "function": "read_article",
-            "arguments": {"url": item.url or ""},
-            "result": {
-                "success": True,
-                "type": "article_content",
-                "url": item.url or "",
-                "title": item.title or "",
-                "source": "",
-                "content": content[:8000],  # cap per article to stay within context
-                "truncated": len(content) > 8000,
-            },
-        })
-
-    await add_message(conv_id, "assistant", "", status="complete", tool_calls=synthetic_tool_calls)
-
-    user_prompt = (
-        f"I'd like to discuss the {len(items)} articles about '{topic}'. "
-        "Don't just summarize each one — draw connections between the sources, "
-        "highlight where they agree or disagree, and share your analysis of what "
-        "this means. Let's have a real discussion about this topic."
-    )
-    await add_message(conv_id, "user", user_prompt)
-
-    conv = await get_conversation(uid, conv_id)
-    assert conv is not None
-
-    history = []
-    for msg in conv.messages:
-        if msg.role == "system":
-            continue
-        msg_dict = {"role": msg.role, "content": msg.content or ""}
-        if msg.tool_calls:
-            msg_dict["tool_calls"] = [
-                {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-                for tc in msg.tool_calls
-            ]
-            history.append(msg_dict)
-            for tc in msg.tool_calls:
-                history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-        else:
-            history.append(msg_dict)
-
-    model = await get_setting(uid, "default_model", "") or ""
-
-    assistant_msg = await add_message(conv_id, "assistant", "", status="generating")
-    buf = create_buffer(conv_id, assistant_msg.id)
-
-    asyncio.create_task(run_generation(
-        buf, history, model,
-        uid, conv_id, conv.title or "",
-        user_prompt,
-        think=True,
-    ))
-
-    return jsonify({
-        "assistant_message_id": assistant_msg.id,
-        "status": "generating",
-        "article_count": len(items),
-    }), 202

src/fabledassistant/routes/chat.py

@@ -350,11 +350,12 @@ async def warm_model_route():
         return jsonify({"error": "model is required"}), 400
 
     async def _warm():
+        from fabledassistant.services.llm import keep_alive_for
         try:
             async with httpx.AsyncClient(timeout=300.0) as client:
                 await client.post(
                     f"{Config.OLLAMA_URL}/api/generate",
-                    json={"model": model, "prompt": "", "keep_alive": "30m"},
+                    json={"model": model, "prompt": "", "keep_alive": keep_alive_for(model)},
                 )
             logger.info("Warmed model %s", model)
         except Exception as e:
@@ -506,50 +507,3 @@ async def delete_model_route():
         return jsonify({"error": str(e)}), 500
 
 
-@chat_bp.route("/from-article/<int:item_id>", methods=["POST"])
-@login_required
-async def create_conversation_from_article(item_id: int):
-    """Create a chat conversation seeded with an RSS article's content."""
-    from sqlalchemy import select as _select
-    from fabledassistant.models import async_session as _async_session
-    from fabledassistant.models.conversation import Message
-    from fabledassistant.models.rss_feed import RssItem, RssFeed
-
-    uid = get_current_user_id()
-
-    async with _async_session() as session:
-        result = await session.execute(
-            _select(RssItem, RssFeed.title.label("feed_title"))
-            .join(RssFeed, RssItem.feed_id == RssFeed.id)
-            .where(RssItem.id == item_id, RssFeed.user_id == uid)
-        )
-        row = result.first()
-
-    if row is None:
-        return jsonify({"error": "Article not found"}), 404
-
-    item, feed_title = row
-
-    conv_title = (item.title or "Article discussion")[:80]
-    conv = await create_conversation(uid, title=conv_title, conversation_type="chat")
-
-    from fabledassistant.services.rss import _fetch_full_article
-    source = feed_title or "News"
-    content_body = (await _fetch_full_article(item.url) if item.url else None) or (item.content or "").strip()
-    seeded_text = f"**{source}**\n\n**{item.title}**"
-    if content_body:
-        seeded_text += f"\n\n{content_body}"
-    if item.url:
-        seeded_text += f"\n\nSource: {item.url}"
-
-    async with _async_session() as session:
-        msg = Message(
-            conversation_id=conv.id,
-            role="assistant",
-            content=seeded_text,
-            msg_metadata={"rss_item_ids": [item_id]},
-        )
-        session.add(msg)
-        await session.commit()
-
-    return jsonify({"conversation_id": conv.id}), 201

src/fabledassistant/routes/journal.py

@@ -0,0 +1,329 @@
+"""HTTP endpoints for the Journal feature.
+
+Includes the conversational journal endpoints (config / today / day / days /
+trigger-prep / moments) plus the ambient-context surface lifted from the
+old Briefing routes (RSS feeds, weather, news, RSS reactions, article-discuss).
+The ambient endpoints read locations + temp_unit + topic preferences from the
+``journal_config`` user setting.
+"""
+from __future__ import annotations
+
+import datetime
+import json
+import logging
+from zoneinfo import ZoneInfo
+
+from quart import Blueprint, jsonify, request
+from sqlalchemy import select
+
+from fabledassistant.auth import get_current_user_id, login_required
+from fabledassistant.models import Conversation, Message, async_session
+from fabledassistant.services import weather as weather_svc
+from fabledassistant.services.journal_prep import ensure_daily_prep_message
+from fabledassistant.services.journal_scheduler import (
+    DEFAULT_CONFIG as DEFAULT_JOURNAL_CONFIG,
+    update_user_schedule,
+)
+from fabledassistant.services.journal_search import search_journal
+from fabledassistant.services.moments import delete_moment, update_moment
+from fabledassistant.services.settings import get_setting, set_setting
+
+logger = logging.getLogger(__name__)
+
+journal_bp = Blueprint("journal", __name__, url_prefix="/api/journal")
+
+
+def _resolve_tz(tz_str: str) -> ZoneInfo:
+    try:
+        return ZoneInfo(tz_str)
+    except Exception:
+        return ZoneInfo("UTC")
+
+
+def _today_in_tz(tz_str: str, *, day_rollover_hour: int) -> datetime.date:
+    tz = _resolve_tz(tz_str)
+    now = datetime.datetime.now(tz)
+    if now.hour < day_rollover_hour:
+        return (now - datetime.timedelta(days=1)).date()
+    return now.date()
+
+
+async def _user_timezone(user_id: int) -> str:
+    return await get_setting(user_id, "user_timezone", "UTC") or "UTC"
+
+
+async def _resolve_config(user_id: int) -> dict:
+    raw = await get_setting(user_id, "journal_config", "")
+    config: dict = {}
+    if raw:
+        try:
+            parsed = json.loads(raw) if isinstance(raw, str) else raw
+            if isinstance(parsed, dict):
+                config = parsed
+        except Exception:
+            logger.warning("Invalid journal_config for user %d", user_id)
+    return {**DEFAULT_JOURNAL_CONFIG, **config}
+
+
+@journal_bp.get("/config")
+@login_required
+async def get_config():
+    user_id = get_current_user_id()
+    return jsonify(await _resolve_config(user_id))
+
+
+@journal_bp.put("/config")
+@login_required
+async def put_config():
+    user_id = get_current_user_id()
+    body = await request.get_json()
+    if not isinstance(body, dict):
+        return jsonify({"error": "config must be an object"}), 400
+    await set_setting(user_id, "journal_config", json.dumps(body))
+    await update_user_schedule(user_id)
+    return jsonify({"ok": True})
+
+
+@journal_bp.get("/today")
+@login_required
+async def get_today():
+    user_id = get_current_user_id()
+    config = await _resolve_config(user_id)
+    tz_str = await _user_timezone(user_id)
+    today = _today_in_tz(tz_str, day_rollover_hour=int(config.get("day_rollover_hour", 4)))
+
+    await ensure_daily_prep_message(
+        user_id=user_id, day_date=today, user_timezone=tz_str
+    )
+    return await _day_payload(user_id=user_id, day_date=today)
+
+
+@journal_bp.get("/day/<iso_date>")
+@login_required
+async def get_day(iso_date: str):
+    user_id = get_current_user_id()
+    try:
+        day = datetime.date.fromisoformat(iso_date)
+    except ValueError:
+        return jsonify({"error": "invalid date"}), 400
+    return await _day_payload(user_id=user_id, day_date=day)
+
+
+@journal_bp.get("/days")
+@login_required
+async def list_days():
+    user_id = get_current_user_id()
+    async with async_session() as session:
+        stmt = (
+            select(Conversation.day_date)
+            .where(
+                Conversation.user_id == user_id,
+                Conversation.conversation_type == "journal",
+                Conversation.day_date.is_not(None),
+            )
+            .order_by(Conversation.day_date.desc())
+        )
+        rows = (await session.execute(stmt)).scalars().all()
+    return jsonify({"days": [d.isoformat() for d in rows]})
+
+
+@journal_bp.post("/trigger-prep")
+@login_required
+async def trigger_prep():
+    user_id = get_current_user_id()
+    body = await request.get_json(silent=True) or {}
+    iso_date = body.get("date")
+    config = await _resolve_config(user_id)
+    tz_str = await _user_timezone(user_id)
+    day = (
+        datetime.date.fromisoformat(iso_date)
+        if iso_date
+        else _today_in_tz(tz_str, day_rollover_hour=int(config.get("day_rollover_hour", 4)))
+    )
+    msg = await ensure_daily_prep_message(
+        user_id=user_id, day_date=day, user_timezone=tz_str, force=True
+    )
+    return jsonify({"ok": True, "message_id": msg.id})
+
+
+@journal_bp.get("/moments")
+@login_required
+async def list_moments():
+    user_id = get_current_user_id()
+    args = request.args
+    df = args.get("date_from")
+    dt = args.get("date_to")
+    person_id = args.get("person_id", type=int)
+    place_id = args.get("place_id", type=int)
+    tag = args.get("tag")
+    query = args.get("query")
+    pinned_only = args.get("pinned_only", "false").lower() == "true"
+    limit = args.get("limit", default=50, type=int)
+
+    results = await search_journal(
+        user_id=user_id,
+        query=query,
+        person_id=person_id,
+        place_id=place_id,
+        tag=tag,
+        date_from=datetime.date.fromisoformat(df) if df else None,
+        date_to=datetime.date.fromisoformat(dt) if dt else None,
+        limit=limit,
+    )
+    if pinned_only:
+        results = [r for r in results if r.get("pinned")]
+    return jsonify({"moments": results})
+
+
+@journal_bp.patch("/moments/<int:moment_id>")
+@login_required
+async def patch_moment(moment_id: int):
+    user_id = get_current_user_id()
+    body = await request.get_json()
+    if not isinstance(body, dict):
+        return jsonify({"error": "body must be an object"}), 400
+    moment = await update_moment(
+        user_id=user_id,
+        moment_id=moment_id,
+        content=body.get("content"),
+        tags=body.get("tags"),
+        pinned=body.get("pinned"),
+        person_ids=body.get("person_ids"),
+        place_ids=body.get("place_ids"),
+        task_ids=body.get("task_ids"),
+        note_ids=body.get("note_ids"),
+    )
+    if moment is None:
+        return jsonify({"error": "not found"}), 404
+    return jsonify(moment.to_dict())
+
+
+@journal_bp.delete("/moments/<int:moment_id>")
+@login_required
+async def remove_moment(moment_id: int):
+    user_id = get_current_user_id()
+    deleted = await delete_moment(user_id=user_id, moment_id=moment_id)
+    if not deleted:
+        return jsonify({"error": "not found"}), 404
+    return jsonify({"ok": True})
+
+
+# ───────────────────────────────────────────────────────────────────────────────
+# Ambient endpoints (lifted from the old briefing surface).
+# ───────────────────────────────────────────────────────────────────────────────
+
+
+async def _journal_temp_unit(user_id: int) -> str:
+    cfg = await _resolve_config(user_id)
+    unit = cfg.get("temp_unit", "C")
+    return unit if unit in ("C", "F") else "C"
+
+
+# ── Weather ───────────────────────────────────────────────────────────────────
+
+
+@journal_bp.get("/weather")
+@login_required
+async def get_weather():
+    user_id = get_current_user_id()
+    rows = await weather_svc.get_cached_weather_rows(user_id)
+    temp_unit = await _journal_temp_unit(user_id)
+    cards = [
+        card for row in rows
+        if (card := weather_svc.parse_weather_card_data(row, temp_unit)) is not None
+    ]
+    return jsonify({"locations": cards, "temp_unit": temp_unit})
+
+
+@journal_bp.get("/weather/current")
+@login_required
+async def get_current_weather():
+    """Live current temperature + conditions for the user's primary location."""
+    user_id = get_current_user_id()
+    cfg = await _resolve_config(user_id)
+    temp_unit = await _journal_temp_unit(user_id)
+    locations = cfg.get("locations") or {}
+    loc = locations.get("home") or locations.get("work")
+    if not loc or not loc.get("lat") or not loc.get("lon"):
+        return jsonify({"error": "No location configured"}), 404
+
+    current = await weather_svc.fetch_current_conditions(loc["lat"], loc["lon"])
+    if current is None:
+        return jsonify({"error": "Failed to fetch current conditions"}), 502
+
+    temp = current["temperature"]
+    if temp is not None and temp_unit == "F":
+        temp = temp * 9 / 5 + 32
+    current["temperature"] = round(temp) if temp is not None else None
+    current["temp_unit"] = temp_unit
+    current["location"] = loc.get("label") or "Home"
+    return jsonify(current)
+
+
+@journal_bp.post("/weather/refresh")
+@login_required
+async def refresh_weather():
+    user_id = get_current_user_id()
+    cfg = await _resolve_config(user_id)
+    temp_unit = await _journal_temp_unit(user_id)
+    for key, loc in (cfg.get("locations") or {}).items():
+        if not loc.get("lat") or not loc.get("lon"):
+            continue
+        try:
+            await weather_svc.refresh_location_cache(
+                user_id=user_id,
+                location_key=key,
+                location_label=loc.get("label", key),
+                lat=loc["lat"],
+                lon=loc["lon"],
+            )
+        except Exception:
+            logger.warning("Failed to refresh weather for %s", key, exc_info=True)
+    rows = await weather_svc.get_cached_weather_rows(user_id)
+    cards = [
+        card for row in rows
+        if (card := weather_svc.parse_weather_card_data(row, temp_unit)) is not None
+    ]
+    return jsonify({"locations": cards, "temp_unit": temp_unit})
+
+
+@journal_bp.post("/weather/geocode")
+@login_required
+async def geocode_location():
+    data = await request.get_json()
+    query = (data.get("query") or "").strip()
+    if not query:
+        return jsonify({"error": "query required"}), 400
+    try:
+        lat, lon, label = await weather_svc.geocode(query)
+        return jsonify({"lat": lat, "lon": lon, "label": label})
+    except ValueError as e:
+        return jsonify({"error": str(e)}), 404
+
+
+async def _day_payload(*, user_id: int, day_date: datetime.date):
+    async with async_session() as session:
+        conv_stmt = select(Conversation).where(
+            Conversation.user_id == user_id,
+            Conversation.conversation_type == "journal",
+            Conversation.day_date == day_date,
+        )
+        conv = (await session.execute(conv_stmt)).scalar_one_or_none()
+        if conv is None:
+            return jsonify({
+                "day_date": day_date.isoformat(),
+                "conversation": None,
+                "messages": [],
+            })
+
+        msgs_stmt = (
+            select(Message)
+            .where(Message.conversation_id == conv.id)
+            .order_by(Message.created_at)
+        )
+        messages = (await session.execute(msgs_stmt)).scalars().all()
+        return jsonify({
+            "day_date": day_date.isoformat(),
+            "conversation": conv.to_dict(),
+            "messages": [m.to_dict() for m in messages],
+        })

src/fabledassistant/routes/quick_capture.py

@@ -11,7 +11,6 @@ from quart import Blueprint, jsonify, request
 
 from fabledassistant.auth import get_current_user_id, login_required
 from fabledassistant.config import Config
-from fabledassistant.services.generation_task import _should_think
 from fabledassistant.services.llm import stream_chat_with_tools
 from fabledassistant.services.tools import execute_tool, get_tools_for_user
 
@@ -21,7 +20,7 @@ quick_capture_bp = Blueprint("quick_capture", __name__, url_prefix="/api/quick-c
 
 # Tools offered to the quick-capture endpoint. Excludes destructive ops,
 # read-only queries, and conversational-only tools.
-_CAPTURE_TOOL_NAMES = {"create_note", "create_task", "create_event", "update_note", "research_topic"}
+_CAPTURE_TOOL_NAMES = {"create_note", "create_event", "update_note", "research_topic"}
 
 _SYSTEM_PROMPT = """\
 Today is {today}. You are a quick-capture assistant. The user has sent a short \
@@ -53,11 +52,10 @@ async def quick_capture_route():
         {"role": "user", "content": text},
     ]
 
-    think = _should_think(text, think_requested=True)
-
+    # Quick capture is a fast classification path — never think.
     tool_calls: list[dict] = []
     try:
-        async for chunk in stream_chat_with_tools(messages, model, tools=capture_tools, think=think, num_ctx=4096):
+        async for chunk in stream_chat_with_tools(messages, model, tools=capture_tools, think=False, num_ctx=4096):
             if chunk.type == "tool_calls" and chunk.tool_calls:
                 tool_calls = chunk.tool_calls
     except Exception:

src/fabledassistant/routes/settings.py

@@ -16,6 +16,7 @@ async def _prime_kv_cache_bg(user_id: int, model: str) -> None:
     """Fire-and-forget: prime Ollama's KV cache with the user's system prompt."""
     import httpx
     from fabledassistant.services.llm import build_context, pick_num_ctx
+    from fabledassistant.services.tools import get_tools_for_user
     try:
         messages, _ = await build_context(
             user_id=user_id,
@@ -23,7 +24,12 @@ async def _prime_kv_cache_bg(user_id: int, model: str) -> None:
             current_note_id=None,
             user_message=" ",
         )
-        num_ctx = pick_num_ctx(messages)
+        # Size the prime to match what real chat requests will use, including
+        # tool schemas — otherwise Ollama reloads the model on the first real
+        # request and throws away the cache we just built.
+        tools = await get_tools_for_user(user_id)
+        num_ctx = pick_num_ctx(messages, tools=tools)
+        from fabledassistant.services.llm import keep_alive_for
         async with httpx.AsyncClient(timeout=120.0) as client:
             await client.post(
                 f"{Config.OLLAMA_URL}/api/chat",
@@ -32,7 +38,7 @@ async def _prime_kv_cache_bg(user_id: int, model: str) -> None:
                     "messages": messages,
                     "stream": False,
                     "options": {"num_predict": 1, "num_ctx": num_ctx},
-                    "keep_alive": "2h",
+                    "keep_alive": keep_alive_for(model),
                 },
             )
         logger.info("Primed KV cache for user %d with model '%s' (num_ctx=%d)", user_id, model, num_ctx)
@@ -58,6 +64,15 @@ async def update_settings_route():
     if not isinstance(data, dict):
         return jsonify({"error": "Expected a JSON object"}), 400
 
+    # Normalize model names to lowercase before validation. Ollama's /api/tags
+    # preserves whatever casing was used at pull time, but /api/chat rejects
+    # mixed-case tags — lowercasing here keeps the two paths consistent and
+    # means the stored setting is always in a form Ollama will actually accept.
+    _MODEL_KEYS = frozenset({"default_model", "background_model"})
+    for _key in _MODEL_KEYS:
+        if _key in data and data[_key]:
+            data[_key] = str(data[_key]).lower()
+
     if "default_model" in data:
         installed = await get_installed_models()
         if data["default_model"]:
@@ -68,7 +83,6 @@ async def update_settings_route():
     # Empty string for model keys means "reset to system default".
     # Delete the DB row so get_setting() falls back to Config defaults
     # rather than returning "" and breaking model resolution everywhere.
-    _MODEL_KEYS = frozenset({"default_model", "background_model"})
     to_save = {}
     for k, v in data.items():
         str_v = str(v)
@@ -80,17 +94,10 @@ async def update_settings_route():
     if to_save:
         await set_settings_batch(uid, to_save)
 
-    # When timezone changes, live-patch the briefing scheduler immediately
+    # Live-reschedule the journal daily-prep job when the timezone changes.
     if "user_timezone" in to_save:
-        import json as _json
-        from fabledassistant.services.briefing_scheduler import update_user_schedule
-        config_raw = await get_setting(uid, "briefing_config", "{}")
-        try:
-            config = _json.loads(config_raw) if isinstance(config_raw, str) else {}
-        except Exception:
-            config = {}
-        if config.get("enabled"):
-            update_user_schedule(uid, config, tz_override=to_save["user_timezone"] or None)
+        from fabledassistant.services.journal_scheduler import update_user_schedule as _update_journal_schedule
+        await _update_journal_schedule(uid)
 
     if "default_model" in to_save and to_save["default_model"]:
         asyncio.create_task(_prime_kv_cache_bg(uid, to_save["default_model"]))

src/fabledassistant/services/article_fetcher.py

@@ -0,0 +1,53 @@
+"""Generic article-text fetcher.
+
+Fetches a URL and extracts its main body via trafilatura. The single source
+of truth for article-content extraction across the codebase — used by the
+``read_article`` LLM tool and the ``lookup`` tool's web-result enrichment.
+
+Trafilatura/lxml is NOT safe to call concurrently — running it via
+``run_in_executor`` from multiple coroutines can trip a libxml2 double-free.
+Callers must serialize their fetches (await one before starting the next).
+"""
+from __future__ import annotations
+
+import asyncio
+import logging
+
+import httpx
+
+logger = logging.getLogger(__name__)
+
+
+async def fetch_article_text(url: str) -> str | None:
+    """Return the clean article body for *url*, or None on failure.
+
+    Returns None when the HTTP fetch fails or trafilatura yields nothing
+    useful. Callers should treat None as "no article content available."
+    """
+    try:
+        async with httpx.AsyncClient(timeout=15.0, follow_redirects=True, headers={
+            "User-Agent": "Mozilla/5.0 (compatible; FabledScribe/1.0; +https://fabledsword.com)",
+        }) as client:
+            resp = await client.get(url)
+            resp.raise_for_status()
+            raw_html = resp.text
+    except Exception:
+        logger.debug("Failed to fetch article URL %s", url)
+        return None
+
+    loop = asyncio.get_event_loop()
+    try:
+        import trafilatura
+        text = await loop.run_in_executor(
+            None,
+            lambda: trafilatura.extract(
+                raw_html,
+                include_comments=False,
+                include_tables=True,
+                favor_recall=True,
+            ),
+        )
+        return text or None
+    except Exception:
+        logger.debug("trafilatura extraction failed for %s", url, exc_info=True)
+        return None

src/fabledassistant/services/briefing_conversations.py

@@ -1,80 +0,0 @@
-"""Create and manage briefing conversations."""
-
-import logging
-from datetime import date, datetime, timezone
-
-from sqlalchemy import select
-
-from fabledassistant.models import async_session
-from fabledassistant.models.conversation import Conversation, Message
-
-logger = logging.getLogger(__name__)
-
-
-async def get_or_create_today_conversation(user_id: int, model: str) -> Conversation:
-    """
-    Return today's briefing conversation, creating it if it doesn't exist.
-    """
-    today = date.today()
-    async with async_session() as session:
-        result = await session.execute(
-            select(Conversation).where(
-                Conversation.user_id == user_id,
-                Conversation.conversation_type == "briefing",
-                Conversation.briefing_date == today,
-            )
-        )
-        conv = result.scalars().first()
-        if conv is not None:
-            return conv
-
-        conv = Conversation(
-            user_id=user_id,
-            title=f"Briefing — {today.isoformat()}",
-            model=model,
-            conversation_type="briefing",
-            briefing_date=today,
-        )
-        session.add(conv)
-        await session.commit()
-        await session.refresh(conv)
-        return conv
-
-
-async def post_message(
-    conversation_id: int,
-    role: str,
-    content: str,
-    metadata: dict | None = None,
-) -> Message:
-    """Append a message to a briefing conversation."""
-    async with async_session() as session:
-        msg = Message(
-            conversation_id=conversation_id,
-            role=role,
-            content=content,
-            status="complete",
-            msg_metadata=metadata,
-        )
-        session.add(msg)
-        # Bump conversation updated_at
-        conv = await session.get(Conversation, conversation_id)
-        if conv:
-            conv.updated_at = datetime.now(timezone.utc)
-        await session.commit()
-        await session.refresh(msg)
-        return msg
-
-
-async def list_briefing_conversations(user_id: int) -> list[dict]:
-    """Return briefing conversations newest first."""
-    async with async_session() as session:
-        result = await session.execute(
-            select(Conversation).where(
-                Conversation.user_id == user_id,
-                Conversation.conversation_type == "briefing",
-            ).order_by(Conversation.briefing_date.desc().nullslast())
-            .limit(30)
-        )
-        convs = list(result.scalars().all())
-    return [c.to_dict() for c in convs]

src/fabledassistant/services/briefing_pipeline.py

@@ -1,857 +0,0 @@
-"""
-Briefing pipeline: parallel data gather + two-lane LLM synthesis.
-
-Slot names: 'compilation' (4am), 'morning' (8am), 'midday' (12pm), 'afternoon' (4pm)
-"""
-
-import asyncio
-import hashlib
-import logging
-from datetime import datetime, timezone
-from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
-
-import httpx
-
-from fabledassistant.models import async_session
-
-from fabledassistant.config import Config
-from fabledassistant.services.settings import get_setting
-
-logger = logging.getLogger(__name__)
-
-SLOT_NAMES = ("compilation", "morning", "midday", "afternoon")
-
-
-
-def format_task(task: dict, today: str | None = None) -> str:
-    parts = [task.get("title", "Untitled")]
-    if task.get("status"):
-        parts.append(f"[{task['status'].replace('_', ' ').title()}]")
-    if task.get("due_date"):
-        parts.append(f"due {task['due_date']}")
-        if today and task["due_date"] < today and task.get("status") not in ("done", "cancelled"):
-            from datetime import date
-            try:
-                due = date.fromisoformat(task["due_date"])
-                td = date.fromisoformat(today)
-                days = (td - due).days
-                parts.append(f"({days} day{'s' if days != 1 else ''} overdue)")
-            except ValueError:
-                pass
-    if task.get("priority") and task["priority"] not in ("none", ""):
-        parts.append(f"priority: {task['priority']}")
-    if task.get("project_title"):
-        parts.append(f"project: {task['project_title']}")
-    return " — ".join(parts)
-
-
-def compute_task_hash(task: dict) -> str:
-    """Stable SHA-256 of the task's key change-detectable fields."""
-    key = "|".join([
-        str(task.get("status") or ""),
-        str(task.get("priority") or ""),
-        str(task.get("due_date") or ""),
-        str(task.get("title") or ""),
-    ])
-    return hashlib.sha256(key.encode()).hexdigest()
-
-
-async def split_changed_tasks(
-    user_id: int,
-    tasks: list[dict],
-) -> tuple[list[dict], int]:
-    """
-    Compare tasks against the briefing_task_snapshot table.
-    Returns (changed_tasks, unchanged_count).
-    changed_tasks includes new tasks (no snapshot row) and tasks whose hash differs.
-    """
-    from sqlalchemy import text
-
-    if not tasks:
-        return [], 0
-
-    task_ids = [t["task_id"] for t in tasks if t.get("task_id")]
-
-    async with async_session() as session:
-        result = await session.execute(
-            text("""
-                SELECT task_id, snapshot_hash
-                FROM briefing_task_snapshot
-                WHERE user_id = :uid AND task_id = ANY(:ids)
-            """).bindparams(uid=user_id, ids=task_ids)
-        )
-        snapshots = {row.task_id: row.snapshot_hash for row in result}
-
-    changed = []
-    unchanged_count = 0
-    for task in tasks:
-        current_hash = compute_task_hash(task)
-        stored_hash = snapshots.get(task.get("task_id"))
-        if stored_hash is None or stored_hash != current_hash:
-            changed.append(task)
-        else:
-            unchanged_count += 1
-
-    return changed, unchanged_count
-
-
-async def upsert_task_snapshots(user_id: int, tasks: list[dict]) -> None:
-    """Upsert snapshot hashes for all tasks included in this briefing."""
-    from sqlalchemy import text
-
-    if not tasks:
-        return
-
-    now = datetime.now(timezone.utc)
-    async with async_session() as session:
-        for task in tasks:
-            task_id = task.get("task_id")
-            if not task_id:
-                continue
-            await session.execute(
-                text("""
-                    INSERT INTO briefing_task_snapshot (user_id, task_id, snapshot_hash, last_briefed)
-                    VALUES (:uid, :tid, :hash, :now)
-                    ON CONFLICT (user_id, task_id)
-                    DO UPDATE SET snapshot_hash = EXCLUDED.snapshot_hash,
-                                  last_briefed = EXCLUDED.last_briefed
-                """).bindparams(
-                    uid=user_id,
-                    tid=task_id,
-                    hash=compute_task_hash(task),
-                    now=now,
-                )
-            )
-        await session.commit()
-
-
-# ── Internal data gather ──────────────────────────────────────────────────────
-
-async def _gather_internal(user_id: int) -> dict:
-    """Collect tasks, calendar events, and project data."""
-    from fabledassistant.services.notes import list_notes
-    from fabledassistant.services.projects import list_projects
-    from fabledassistant.services.caldav import is_caldav_configured, list_events
-
-    tz_name = await get_setting(user_id, "user_timezone") or "UTC"
-    try:
-        user_tz = ZoneInfo(tz_name)
-    except ZoneInfoNotFoundError:
-        user_tz = ZoneInfo("UTC")
-
-    today = datetime.now(user_tz).date().isoformat()
-
-    # Tasks: overdue, due today, high priority in-progress
-    all_tasks: list[dict] = []
-    try:
-        all_task_objs, _total = await list_notes(user_id, is_task=True, limit=100)
-        # Build project title lookup for enrichment
-        project_titles: dict[int, str] = {}
-        try:
-            for p in await list_projects(user_id):
-                project_titles[p.id] = p.title or "Untitled"
-        except Exception:
-            pass
-        all_tasks = [
-            {
-                "task_id": t.id,
-                "title": t.title,
-                "status": t.status,
-                "due_date": t.due_date.isoformat() if t.due_date else None,
-                "priority": t.priority,
-                "project_title": project_titles.get(t.project_id) if t.project_id else None,
-            }
-            for t in all_task_objs
-        ]
-        overdue = [
-            format_task(t, today) for t in all_tasks
-            if t.get("due_date") and t["due_date"] < today and t.get("status") not in ("done", "cancelled")
-        ]
-        due_today = [
-            format_task(t, today) for t in all_tasks
-            if t.get("due_date") == today and t.get("status") not in ("done", "cancelled")
-        ]
-        high_priority = [
-            format_task(t, today) for t in all_tasks
-            if t.get("priority") == "high" and t.get("status") not in ("done", "cancelled") and
-               format_task(t, today) not in overdue and format_task(t, today) not in due_today
-        ][:5]
-    except Exception:
-        logger.warning("Failed to gather tasks for briefing", exc_info=True)
-        overdue, due_today, high_priority = [], [], []
-
-    # Calendar events today — internal store
-    calendar_events: list[str] = []
-    internal_events: list[dict] = []
-    try:
-        from fabledassistant.services.events import list_events as list_internal_events
-        today_date = datetime.now(user_tz).date()
-        day_start = datetime(today_date.year, today_date.month, today_date.day, 0, 0, 0, tzinfo=user_tz)
-        day_end = datetime(today_date.year, today_date.month, today_date.day, 23, 59, 59, tzinfo=user_tz)
-        internal_events = await list_internal_events(
-            user_id=user_id, date_from=day_start, date_to=day_end
-        )
-        for e in internal_events:
-            if e.get("all_day"):
-                time_str = "all day"
-            elif e.get("start_dt"):
-                from datetime import datetime as _dt
-                start = e["start_dt"]
-                if isinstance(start, str):
-                    start = _dt.fromisoformat(start)
-                local_dt = start.astimezone(user_tz) if start.tzinfo else start.replace(tzinfo=timezone.utc).astimezone(user_tz)
-                time_str = local_dt.strftime("%-I:%M %p")
-            else:
-                time_str = "unknown time"
-            calendar_events.append(f"{e.get('title', 'Event')} at {time_str}")
-    except Exception:
-        logger.warning("Failed to gather internal calendar events for briefing", exc_info=True)
-    # Also pull CalDAV events (deduped)
-    try:
-        if await is_caldav_configured(user_id):
-            caldav_evs = await list_events(user_id, start=today, end=today)
-            for e in (caldav_evs or []):
-                summary = f"{e.get('summary', 'Event')} at {e.get('dtstart', 'unknown time')}"
-                if summary not in calendar_events:
-                    calendar_events.append(summary)
-    except Exception:
-        logger.warning("Failed to gather CalDAV calendar events for briefing", exc_info=True)
-
-    # Weather × calendar cross-reference
-    weather_warnings: list[str] = []
-    outdoor_keywords = {"park", "field", "patio", "garden", "outdoor", "trail", "beach",
-                        "pool", "stadium", "yard", "lawn", "hike", "walk", "run", "bike",
-                        "soccer", "baseball", "football", "tennis", "golf", "playground"}
-    try:
-        import json as _json
-        raw_config = await get_setting(user_id, "briefing_config", "{}")
-        config = _json.loads(raw_config) if isinstance(raw_config, str) else (raw_config or {})
-        locations = config.get("locations", {})
-        loc = locations.get("home") or locations.get("work")
-        if loc and loc.get("lat") and loc.get("lon") and internal_events:
-            from fabledassistant.services.weather import fetch_hourly_precip
-            hourly_precip = await fetch_hourly_precip(loc["lat"], loc["lon"])
-            if hourly_precip:
-                for e in internal_events:
-                    if e.get("all_day"):
-                        continue
-                    # Check if event title or location contains outdoor keywords
-                    event_text = f"{e.get('title', '')} {e.get('location', '')}".lower()
-                    if not any(kw in event_text for kw in outdoor_keywords):
-                        continue
-                    # Get the event's start hour
-                    start = e.get("start_dt")
-                    if not start:
-                        continue
-                    from datetime import datetime as _dt
-                    if isinstance(start, str):
-                        start = _dt.fromisoformat(start)
-                    local_start = start.astimezone(user_tz) if start.tzinfo else start.replace(tzinfo=timezone.utc).astimezone(user_tz)
-                    # Check precip probability around the event time (hour before through event)
-                    hour_key = local_start.strftime("%Y-%m-%dT%H:00")
-                    precip = hourly_precip.get(hour_key, 0)
-                    if precip >= 30:
-                        time_str = local_start.strftime("%-I:%M %p")
-                        weather_warnings.append(
-                            f"Rain likely ({precip}%) around {time_str} when '{e.get('title', 'Event')}' "
-                            f"is scheduled — consider an umbrella or backup plan"
-                        )
-    except Exception:
-        logger.debug("Weather cross-reference failed", exc_info=True)
-
-    # Recent activity — what was the user working on yesterday?
-    recent_activity: list[str] = []
-    stale_projects: list[str] = []
-    try:
-        from sqlalchemy import select as _sel, func as _func
-        from fabledassistant.models.note import Note
-        from fabledassistant.models.project import Project
-
-        yesterday = datetime.now(user_tz) - __import__('datetime').timedelta(days=1)
-        async with async_session() as session:
-            # Notes/tasks updated in last 24h, grouped by project
-            result = await session.execute(
-                _sel(Project.title, _func.count(Note.id))
-                .join(Note, Note.project_id == Project.id)
-                .where(Note.user_id == user_id)
-                .where(Note.updated_at >= yesterday)
-                .group_by(Project.title)
-                .order_by(_func.count(Note.id).desc())
-                .limit(3)
-            )
-            for proj_title, count in result.all():
-                recent_activity.append(f"{proj_title}: {count} item{'s' if count != 1 else ''} updated")
-
-            # Stale projects — active projects with no note/task activity in 7+ days
-            week_ago = datetime.now(user_tz) - __import__('datetime').timedelta(days=7)
-            active_projects_q = await session.execute(
-                _sel(Project).where(Project.user_id == user_id, Project.status == "active")
-            )
-            for p in active_projects_q.scalars().all():
-                latest = await session.execute(
-                    _sel(_func.max(Note.updated_at))
-                    .where(Note.project_id == p.id, Note.user_id == user_id)
-                )
-                last_activity = latest.scalar()
-                if last_activity is None or last_activity < week_ago:
-                    stale_projects.append(p.title or "Untitled")
-    except Exception:
-        logger.debug("Failed to gather recent activity for briefing", exc_info=True)
-
-    # Projects: active projects
-    projects_summary = []
-    try:
-        projects = await list_projects(user_id)
-        for p in projects[:5]:
-            projects_summary.append(p.title or "Untitled project")
-    except Exception:
-        logger.warning("Failed to gather projects for briefing", exc_info=True)
-
-    # Build prioritized "Your Day" focus list
-    # Priority: overdue > due today > high priority in-progress > other in-progress
-    focus_tasks: list[str] = []
-    seen_titles: set[str] = set()
-    for t in sorted(all_tasks, key=lambda x: (
-        0 if (x.get("due_date") and x["due_date"] < today and x.get("status") not in ("done", "cancelled")) else
-        1 if (x.get("due_date") == today and x.get("status") not in ("done", "cancelled")) else
-        2 if (x.get("priority") == "high" and x.get("status") not in ("done", "cancelled")) else
-        3 if (x.get("status") == "in_progress") else 4
-    )):
-        if t.get("status") in ("done", "cancelled"):
-            continue
-        formatted = format_task(t, today)
-        if formatted not in seen_titles:
-            seen_titles.add(formatted)
-            focus_tasks.append(formatted)
-        if len(focus_tasks) >= 5:
-            break
-
-    # Calendar gap analysis — extract event times for LLM
-    event_time_blocks: list[str] = []
-    for e in internal_events:
-        try:
-            if e.get("all_day"):
-                continue
-            start = e.get("start_dt")
-            end = e.get("end_dt")
-            if not start:
-                continue
-            from datetime import datetime as _dt
-            if isinstance(start, str):
-                start = _dt.fromisoformat(start)
-            if isinstance(end, str):
-                end = _dt.fromisoformat(end)
-            s_local = start.astimezone(user_tz) if start.tzinfo else start.replace(tzinfo=timezone.utc).astimezone(user_tz)
-            s_str = s_local.strftime("%-I:%M %p")
-            if end:
-                e_local = end.astimezone(user_tz) if end.tzinfo else end.replace(tzinfo=timezone.utc).astimezone(user_tz)
-                e_str = e_local.strftime("%-I:%M %p")
-                event_time_blocks.append(f"{e.get('title', 'Event')}: {s_str}–{e_str}")
-            else:
-                event_time_blocks.append(f"{e.get('title', 'Event')}: {s_str}–?")
-        except Exception:
-            pass
-
-    return {
-        "date": today,
-        "overdue_tasks": overdue,
-        "due_today": due_today,
-        "high_priority": high_priority,
-        "calendar_events": calendar_events,
-        "active_projects": projects_summary,
-        "all_tasks_raw": all_tasks,
-        "focus_tasks": focus_tasks,
-        "event_time_blocks": event_time_blocks,
-        "weather_warnings": weather_warnings,
-        "recent_activity": recent_activity,
-        "stale_projects": stale_projects,
-    }
-
-
-async def _gather_weekly_review(user_id: int) -> dict:
-    """Collect 7-day activity summary for the weekly review."""
-    from fabledassistant.services.notes import list_notes
-    from fabledassistant.services.projects import list_projects
-    from fabledassistant.services.events import list_events as list_internal_events
-
-    tz_name = await get_setting(user_id, "user_timezone") or "UTC"
-    try:
-        user_tz = ZoneInfo(tz_name)
-    except ZoneInfoNotFoundError:
-        user_tz = ZoneInfo("UTC")
-
-    now = datetime.now(user_tz)
-    week_ago = now - __import__('datetime').timedelta(days=7)
-    next_week = now + __import__('datetime').timedelta(days=7)
-
-    # Tasks completed this week
-    completed_tasks = []
-    overdue_tasks = []
-    try:
-        all_task_objs, _ = await list_notes(user_id, is_task=True, limit=200)
-        for t in all_task_objs:
-            if t.status == "done" and t.completed_at and t.completed_at >= week_ago:
-                completed_tasks.append(t.title or "Untitled")
-            elif t.due_date and t.due_date.isoformat() < now.date().isoformat() and t.status not in ("done", "cancelled"):
-                overdue_tasks.append(t.title or "Untitled")
-    except Exception:
-        logger.debug("Weekly review: failed to gather tasks", exc_info=True)
-
-    # Notes created this week
-    notes_created = 0
-    try:
-        all_notes, _ = await list_notes(user_id, is_task=False, limit=200)
-        notes_created = sum(1 for n in all_notes if n.created_at and n.created_at >= week_ago)
-    except Exception:
-        logger.debug("Weekly review: failed to count notes", exc_info=True)
-
-    # Project activity
-    active_projects = []
-    try:
-        projects = await list_projects(user_id)
-        active_projects = [p.title for p in projects if p.status == "active"][:5]
-    except Exception:
-        pass
-
-    # Events next week
-    upcoming_events = []
-    try:
-        next_events = await list_internal_events(
-            user_id=user_id,
-            date_from=now,
-            date_to=next_week,
-        )
-        for e in next_events[:8]:
-            upcoming_events.append(f"{e.get('title', 'Event')} — {e.get('start_dt', '')[:10]}")
-    except Exception:
-        pass
-
-    return {
-        "completed_count": len(completed_tasks),
-        "completed_highlights": completed_tasks[:5],
-        "overdue_count": len(overdue_tasks),
-        "overdue_items": overdue_tasks[:5],
-        "notes_created": notes_created,
-        "active_projects": active_projects,
-        "upcoming_events": upcoming_events,
-    }
-
-
-# ── External data gather ──────────────────────────────────────────────────────
-
-async def _gather_external(user_id: int) -> dict:
-    """Collect RSS items and weather."""
-    from fabledassistant.services.rss import get_recent_items
-    from fabledassistant.services.weather import get_cached_weather
-
-    rss_items, weather = await asyncio.gather(
-        get_recent_items(user_id, limit=20),
-        get_cached_weather(user_id),
-        return_exceptions=True,
-    )
-    return {
-        "rss_items": rss_items if not isinstance(rss_items, Exception) else [],
-        "weather": weather if not isinstance(weather, Exception) else [],
-    }
-
-
-# ── LLM synthesis ─────────────────────────────────────────────────────────────
-
-async def _llm_synthesise(system_prompt: str, user_prompt: str, model: str, num_ctx: int = 4096) -> str:
-    """Single non-streaming LLM call. Returns the assistant's response text."""
-    payload = {
-        "model": model,
-        "messages": [
-            {"role": "system", "content": system_prompt},
-            {"role": "user", "content": user_prompt},
-        ],
-        "stream": False,
-        "options": {"num_ctx": num_ctx, "temperature": 0.4},
-    }
-    try:
-        async with httpx.AsyncClient(timeout=120.0) as client:
-            resp = await client.post(f"{Config.OLLAMA_URL}/api/chat", json=payload)
-            resp.raise_for_status()
-            data = resp.json()
-            return data.get("message", {}).get("content", "").strip()
-    except Exception:
-        logger.warning("LLM synthesis failed", exc_info=True)
-        return ""
-
-
-def _unified_system_prompt(profile_body: str, slot: str = "compilation") -> str:
-    base = (
-        "You are a personal assistant. "
-        "Speak naturally and conversationally — as if talking to the user, not writing a report. "
-        "Use no markdown: no headers, no bullet points, no bold, no lists. Write in flowing prose. "
-        "Be warm, concise, and human. "
-        "The user can reply to act on your suggestions via tool calls.\n\n"
-    )
-
-    if slot == "compilation":
-        base += (
-            "This is the MORNING BRIEFING — the full daily overview. "
-            "Weave together what matters today: mention the weather, note calendar events and tasks, "
-            "briefly reference one or two noteworthy news themes, and suggest a daily focus. "
-            "Be actionable: for overdue or due-today tasks, suggest a concrete next step. "
-            "Aim for 4 to 8 sentences.\n\n"
-        )
-    elif slot in ("morning", "midday"):
-        base += (
-            "This is a MIDDAY CHECK-IN — brief progress nudge, not a full briefing. "
-            "Focus on what's been done and what hasn't been touched yet today. "
-            "If weather conditions have changed, mention it briefly. "
-            "Keep it to 2-3 sentences. Don't repeat news or the full task list.\n\n"
-        )
-    elif slot == "afternoon":
-        base += (
-            "This is the AFTERNOON WRAP-UP — help the user close out the day. "
-            "Summarize what was accomplished today. Flag anything still overdue. "
-            "Ask if there's anything to capture before tomorrow — notes, thoughts, follow-ups. "
-            "Keep it to 2-4 sentences. Reflective and encouraging tone.\n\n"
-        )
-    elif slot == "weekly_review":
-        base += (
-            "This is the WEEKLY REVIEW — a reflective recap of the past 7 days. "
-            "Summarize accomplishments, flag lingering overdue items, note how many notes were created, "
-            "and preview the upcoming week's key events. "
-            "Be reflective and encouraging — celebrate progress, gently flag what's stuck. "
-            "Aim for 5 to 8 sentences. This wraps up a chapter.\n\n"
-        )
-
-    if profile_body:
-        base += f"User profile:\n{profile_body}\n"
-    return base
-
-
-def _unified_user_prompt(internal_data: dict, external_data: dict, slot: str, temp_unit: str = "C") -> str:
-    lines = [f"Date: {internal_data['date']}", f"Slot: {slot}", ""]
-
-    # Weekly review — separate data path
-    if slot == "weekly_review":
-        weekly = internal_data.get("weekly_review") or {}
-        lines.append(f"COMPLETED THIS WEEK: {weekly.get('completed_count', 0)} tasks")
-        if weekly.get("completed_highlights"):
-            lines.extend(f"  - {t}" for t in weekly["completed_highlights"])
-        lines.append("")
-        if weekly.get("overdue_count", 0) > 0:
-            lines.append(f"STILL OVERDUE: {weekly['overdue_count']} task(s)")
-            lines.extend(f"  - {t}" for t in weekly.get("overdue_items", []))
-            lines.append("")
-        lines.append(f"NOTES CREATED: {weekly.get('notes_created', 0)}")
-        lines.append("")
-        if weekly.get("active_projects"):
-            lines.append(f"ACTIVE PROJECTS: {', '.join(weekly['active_projects'])}")
-            lines.append("")
-        if weekly.get("upcoming_events"):
-            lines.append("UPCOMING WEEK:")
-            lines.extend(f"  - {e}" for e in weekly["upcoming_events"])
-            lines.append("")
-        return "\n".join(lines)
-
-    # For check-in slots, build a slimmer prompt
-    if slot in ("morning", "midday"):
-        # Just tasks status + any weather changes
-        if internal_data.get("due_today"):
-            lines.append("TASKS DUE TODAY (note which are still untouched):")
-            lines.extend(f"  - {t}" for t in internal_data["due_today"])
-            lines.append("")
-        if internal_data.get("overdue_tasks"):
-            lines.append(f"STILL OVERDUE: {len(internal_data['overdue_tasks'])} task(s)")
-            lines.append("")
-        if internal_data.get("calendar_events"):
-            lines.append("REMAINING EVENTS TODAY:")
-            lines.extend(f"  - {e}" for e in internal_data["calendar_events"])
-            lines.append("")
-        return "\n".join(lines)
-
-    if slot == "afternoon":
-        if internal_data.get("due_today"):
-            lines.append("TASKS THAT WERE DUE TODAY:")
-            lines.extend(f"  - {t}" for t in internal_data["due_today"])
-            lines.append("")
-        if internal_data.get("overdue_tasks"):
-            overdue = internal_data["overdue_tasks"]
-            lines.append(f"OVERDUE ({len(overdue)} remaining):")
-            lines.extend(f"  - {t}" for t in overdue[:3])
-            lines.append("")
-        lines.append("Ask the user if there's anything to capture before tomorrow — a note, a thought, a follow-up task.")
-        return "\n".join(lines)
-
-    # ── Full compilation prompt below ──────────────────────────────────────────
-
-    # Weather (brief — card handles detail)
-    weather = external_data.get("weather") or []
-    if weather:
-        loc = weather[0]
-        days = loc.get("days") or []
-        if days:
-            d = days[0]
-            t_min = _format_temp(d["temp_min"], temp_unit)
-            t_max = _format_temp(d["temp_max"], temp_unit)
-            unit_sym = f"°{temp_unit}"
-            lines.append(
-                f"WEATHER: {loc['location_label']} — {d['description']}, "
-                f"{t_min}–{t_max}{unit_sym}"
-            )
-            lines.append("")
-
-    # Today's calendar events
-    if internal_data.get("calendar_events"):
-        lines.append("TODAY'S EVENTS:")
-        lines.extend(f"  - {e}" for e in internal_data["calendar_events"])
-        lines.append("")
-
-    # Weather warnings for outdoor events
-    if internal_data.get("weather_warnings"):
-        lines.append("WEATHER ALERTS (mention these naturally when discussing affected events):")
-        lines.extend(f"  ⚠ {w}" for w in internal_data["weather_warnings"])
-        lines.append("")
-
-    # Tasks due today
-    if internal_data.get("due_today"):
-        lines.append("DUE TODAY (suggest next steps — offer to mark in progress or help prioritize):")
-        lines.extend(f"  - {t}" for t in internal_data["due_today"])
-        lines.append("")
-
-    # Overdue tasks
-    if internal_data.get("overdue_tasks"):
-        overdue = internal_data["overdue_tasks"]
-        lines.append(f"OVERDUE ({len(overdue)} task{'s' if len(overdue) != 1 else ''}) — suggest rescheduling or breaking down:")
-        lines.extend(f"  - {t}" for t in overdue[:5])
-        if len(overdue) > 5:
-            lines.append(f"  (and {len(overdue) - 5} more)")
-        lines.append("")
-
-    # High priority in-progress
-    if internal_data.get("high_priority"):
-        lines.append("HIGH PRIORITY:")
-        lines.extend(f"  - {t}" for t in internal_data["high_priority"])
-        lines.append("")
-
-    # Your Day — prioritized focus + calendar gaps (compilation slot only)
-    if internal_data.get("focus_tasks") and slot == "compilation":
-        lines.append("YOUR DAY — top tasks to focus on (mention these as a suggested plan):")
-        for i, t in enumerate(internal_data["focus_tasks"], 1):
-            lines.append(f"  {i}. {t}")
-        if internal_data.get("event_time_blocks"):
-            lines.append("")
-            lines.append("  Scheduled time blocks:")
-            lines.extend(f"    {b}" for b in internal_data["event_time_blocks"])
-            lines.append("  (Identify free blocks between events for focused work.)")
-        lines.append("")
-
-    # Project continuity — what was the user working on?
-    if internal_data.get("recent_activity") and slot == "compilation":
-        lines.append("YESTERDAY'S ACTIVITY (mention what the user was working on to help them pick up):")
-        lines.extend(f"  - {a}" for a in internal_data["recent_activity"])
-        lines.append("")
-
-    if internal_data.get("stale_projects") and slot == "compilation":
-        lines.append("STALE PROJECTS (no activity in 7+ days — gently flag):")
-        lines.extend(f"  - {p}" for p in internal_data["stale_projects"])
-        lines.append("")
-
-    # News — clustered by topic, ranked by preference score
-    rss = external_data.get("rss_items") or []
-    topic_scores = external_data.get("topic_scores") or {}
-    if rss:
-        # Group articles by their primary topic
-        clusters: dict[str, list[dict]] = {}
-        uncategorized: list[dict] = []
-        for item in rss:
-            topics = item.get("topics") or []
-            if topics:
-                primary = topics[0]
-                clusters.setdefault(primary, []).append(item)
-            else:
-                uncategorized.append(item)
-
-        # Score each cluster by aggregate preference (positive = user likes this topic)
-        def cluster_score(topic: str, items: list[dict]) -> float:
-            pref = topic_scores.get(topic, 0.0)
-            return pref * 2.0 + len(items)  # preference-weighted, size as tiebreak
-
-        # Filter out clusters where the user has a strongly negative preference
-        filtered_clusters = [
-            (topic, items) for topic, items in clusters.items()
-            if topic_scores.get(topic, 0.0) >= -2.0
-        ]
-
-        # Sort by preference-weighted score
-        sorted_clusters = sorted(filtered_clusters, key=lambda x: cluster_score(x[0], x[1]), reverse=True)
-
-        lines.append("NEWS THEMES (synthesize 1-2 themes into your briefing; mention article count per theme):")
-        for i, (topic, items) in enumerate(sorted_clusters[:4]):
-            count = len(items)
-            titles = [it.get("title", "") for it in items[:3]]
-            sources = list({it.get("feed_title") or it.get("source") or "News" for it in items})
-            pref_indicator = ""
-            pref = topic_scores.get(topic, 0.0)
-            if pref >= 2.0:
-                pref_indicator = " ★"  # user's preferred topic
-            lines.append(f"  [{topic.title()}]{pref_indicator} ({count} article{'s' if count != 1 else ''} from {', '.join(sources[:2])})")
-            for t in titles:
-                lines.append(f"    • {t}")
-            # Include excerpt for preferred clusters or the top cluster
-            if pref >= 1.0 or i == 0:
-                excerpt = (items[0].get("content") or items[0].get("snippet") or "")[:400].strip()
-                if excerpt:
-                    lines.append(f"    > {excerpt}")
-        if uncategorized:
-            lines.append(f"  [Other] ({len(uncategorized)} uncategorized article{'s' if len(uncategorized) != 1 else ''})")
-        lines.append("")
-
-    return "\n".join(lines)
-
-
-def _format_temp(value: float, unit: str) -> str:
-    """Convert Celsius to the requested unit and format as an integer string."""
-    if unit == "F":
-        return f"{value * 9 / 5 + 32:.0f}"
-    return f"{value:.0f}"
-
-
-
-
-# ── Main entry point ───────────────────────────────────────────────────────────
-
-async def _get_temp_unit(user_id: int) -> str:
-    """Read the user's preferred temperature unit from briefing_config ('C' or 'F')."""
-    import json
-    raw = await get_setting(user_id, "briefing_config", "{}")
-    try:
-        config = json.loads(raw) if isinstance(raw, str) else (raw or {})
-        unit = config.get("temp_unit", "C")
-        return unit if unit in ("C", "F") else "C"
-    except Exception:
-        return "C"
-
-
-async def run_compilation(
-    user_id: int,
-    slot: str,
-    model: str | None = None,
-) -> tuple[str, dict]:
-    """
-    Run the full two-lane briefing pipeline for a user and slot.
-    Returns (briefing_text, metadata_dict) where metadata contains
-    weather card data and rss_item_ids for frontend rendering.
-    """
-    if model is None:
-        model = await get_setting(user_id, "default_model", Config.OLLAMA_MODEL)
-
-    from fabledassistant.services.user_profile import build_profile_context
-    from fabledassistant.services.briefing_preferences import (
-        load_topic_preferences,
-        load_topic_reaction_scores,
-        score_and_filter_items,
-    )
-    from fabledassistant.services.weather import parse_weather_card_data, get_cached_weather_rows
-
-    profile_context, temp_unit = await asyncio.gather(
-        build_profile_context(user_id),
-        _get_temp_unit(user_id),
-    )
-
-    # ── Pre-processing ──────────────────────────────────────────────────────────
-    include_topics, exclude_topics = await load_topic_preferences(user_id)
-    topic_scores = await load_topic_reaction_scores(user_id)
-
-    # Parallel raw gather — weather rows fetched in same gather to avoid extra DB round-trip
-    internal_data, external_data, weather_rows = await asyncio.gather(
-        _gather_internal(user_id),
-        _gather_external(user_id),
-        get_cached_weather_rows(user_id),
-    )
-
-    # Weekly review: gather 7-day summary data
-    if slot == "weekly_review":
-        internal_data["weekly_review"] = await _gather_weekly_review(user_id)
-
-    # Task change detection
-    all_tasks = internal_data.get("all_tasks_raw", [])
-    changed_tasks, unchanged_count = await split_changed_tasks(user_id, all_tasks)
-
-    # RSS filtering
-    raw_rss = external_data.get("rss_items") or []
-    filtered_rss = score_and_filter_items(
-        raw_rss,
-        include_topics=include_topics,
-        exclude_topics=exclude_topics,
-        topic_scores=topic_scores,
-        max_items=10,
-    )
-    rss_item_ids = [item["id"] for item in filtered_rss if item.get("id")]
-    rss_items_meta = [
-        {
-            "id": item["id"],
-            "title": item.get("title", ""),
-            "url": item.get("url", ""),
-            "source": item.get("feed_title", ""),
-            "snippet": (item.get("content") or "")[:300],
-            "published_at": item.get("published_at"),
-        }
-        for item in filtered_rss
-        if item.get("id")
-    ]
-
-    # Weather staleness gate — returns None if data is >24h old
-    weather_card = parse_weather_card_data(weather_rows[0], temp_unit) if weather_rows else None
-
-    # ── LLM Synthesis ──────────────────────────────────────────────────────────
-    # Build filtered internal data with only changed tasks
-    internal_data_filtered = dict(internal_data)
-    internal_data_filtered["unchanged_task_count"] = unchanged_count
-    internal_data_filtered["changed_tasks"] = [format_task(t) for t in changed_tasks]
-
-    # Build filtered external data (suppress weather prose — card handles it)
-    external_data_filtered = {
-        "rss_items": filtered_rss,
-        "weather": [],
-        "topic_scores": topic_scores,
-    }
-
-    briefing_text = await _llm_synthesise(
-        _unified_system_prompt(profile_context, slot),
-        _unified_user_prompt(internal_data_filtered, external_data_filtered, slot, temp_unit),
-        model,
-        num_ctx=8192,
-    )
-
-    # ── Post-processing ─────────────────────────────────────────────────────────
-    await upsert_task_snapshots(user_id, all_tasks)
-
-    metadata: dict = {"rss_item_ids": rss_item_ids, "rss_items": rss_items_meta, "weather": weather_card}
-
-    if not briefing_text:
-        logger.warning("Briefing compilation produced no content for user %d slot %s", user_id, slot)
-        return "", metadata
-
-    return briefing_text, metadata
-
-
-async def run_slot_injection(user_id: int, slot: str, model: str | None = None) -> str:
-    """
-    Lighter update for 8am/12pm/4pm — gathers fresh data and produces a slot-specific
-    update prompt. Returns the text to inject as a new user→assistant exchange.
-    """
-    if model is None:
-        model = await get_setting(user_id, "default_model", Config.OLLAMA_MODEL)
-
-    internal_data, external_data, temp_unit = await asyncio.gather(
-        _gather_internal(user_id),
-        _gather_external(user_id),
-        _get_temp_unit(user_id),
-    )
-
-    system = (
-        f"You are a personal assistant giving a brief {slot} check-in. "
-        "The user already had their morning briefing — focus only on what's changed or newly relevant. "
-        "Speak naturally in 2-3 sentences, no markdown formatting, no headers or bullet points."
-    )
-    return await _llm_synthesise(
-        system,
-        _unified_user_prompt(internal_data, external_data, slot, temp_unit),
-        model,
-    )

src/fabledassistant/services/briefing_preferences.py

@@ -1,110 +0,0 @@
-"""
-Briefing preferences: load topic settings, aggregate reaction scores,
-filter and rank RSS items for briefing inclusion.
-"""
-
-import json
-import logging
-from datetime import datetime, timezone
-
-from fabledassistant.models import async_session
-
-logger = logging.getLogger(__name__)
-
-
-async def load_topic_preferences(user_id: int) -> tuple[list[str], list[str]]:
-    """
-    Return (include_topics, exclude_topics) from user settings.
-    """
-    from fabledassistant.services.settings import get_setting
-
-    raw_include = await get_setting(user_id, "briefing_include_topics", "[]")
-    raw_exclude = await get_setting(user_id, "briefing_exclude_topics", "[]")
-
-    def _parse(raw) -> list[str]:
-        try:
-            val = json.loads(raw) if isinstance(raw, str) else raw
-            return [str(t) for t in val] if isinstance(val, list) else []
-        except Exception:
-            return []
-
-    return _parse(raw_include), _parse(raw_exclude)
-
-
-async def load_topic_reaction_scores(user_id: int) -> dict[str, float]:
-    """
-    Aggregate per-topic reaction scores from the last 30 days.
-    Returns a dict of topic -> net_score (positive = liked, negative = disliked).
-    Uses rss_item_reactions joined to rss_items.topics.
-    """
-    try:
-        from sqlalchemy import text as _text
-
-        async with async_session() as session:
-            result = await session.execute(
-                _text("""
-                    SELECT unnest(i.topics) AS topic,
-                           SUM(CASE r.reaction WHEN 'up' THEN 1 ELSE -1 END) AS score
-                    FROM rss_item_reactions r
-                    JOIN rss_items i ON i.id = r.rss_item_id
-                    WHERE r.user_id = :uid
-                      AND r.created_at > NOW() - INTERVAL '30 days'
-                    GROUP BY topic
-                """).bindparams(uid=user_id)
-            )
-            return {row.topic: float(row.score) for row in result}
-    except Exception:
-        logger.warning("Failed to load topic reaction scores", exc_info=True)
-        return {}
-
-
-def score_and_filter_items(
-    items: list[dict],
-    include_topics: list[str],
-    exclude_topics: list[str],
-    topic_scores: dict[str, float],
-    max_items: int = 10,
-) -> list[dict]:
-    """
-    Score, filter, and rank RSS items for briefing inclusion.
-
-    Scoring:
-    - Hard-exclude: any item tagged with an excluded topic is removed.
-    - Base score: 0.0
-    - +2.0 per topic that appears in include_topics
-    - +1.0 / -1.0 per topic based on reaction score (clamped per topic)
-    - Tiebreak: newer published_at wins
-
-    Returns up to max_items items, highest score first.
-    Items with classified_at=None (unclassified) pass through with score=0.
-    """
-    include_set = set(include_topics)
-    exclude_set = set(exclude_topics)
-    scored = []
-
-    for item in items:
-        item_topics = item.get("topics") or []
-
-        # Hard exclude
-        if exclude_set and any(t in exclude_set for t in item_topics):
-            continue
-
-        score = 0.0
-        for topic in item_topics:
-            if topic in include_set:
-                score += 2.0
-            if topic in topic_scores:
-                score += max(-1.0, min(1.0, topic_scores[topic]))
-
-        # Parse published_at for tiebreak
-        pub_str = item.get("published_at") or ""
-        try:
-            pub_ts = datetime.fromisoformat(pub_str).timestamp() if pub_str else 0.0
-        except ValueError:
-            pub_ts = 0.0
-
-        scored.append((score, pub_ts, item))
-
-    # Sort: highest score first, then newest first
-    scored.sort(key=lambda x: (x[0], x[1]), reverse=True)
-    return [item for _, _, item in scored[:max_items]]

src/fabledassistant/services/briefing_profile.py

@@ -1,80 +0,0 @@
-"""Briefing profile note: stores learned user preferences for the briefing assistant."""
-
-import logging
-
-from fabledassistant.services.notes import create_note, list_notes, update_note
-
-logger = logging.getLogger(__name__)
-
-PROFILE_TAG = "briefing-profile"
-PROFILE_TITLE = "Briefing Profile"
-
-
-async def _find_profile_note(user_id: int) -> dict | None:
-    """Find the user's briefing profile note by tag."""
-    notes, _total = await list_notes(user_id, tags=[PROFILE_TAG], limit=1)
-    if not notes:
-        return None
-    note = notes[0]
-    return {
-        "id": note.id,
-        "body": note.body or "",
-        "title": note.title,
-    }
-
-
-async def get_profile_body(user_id: int) -> str:
-    """Return the body of the briefing profile note, or '' if none exists."""
-    note = await _find_profile_note(user_id)
-    return note["body"] if note else ""
-
-
-async def get_profile_note_id(user_id: int) -> int | None:
-    note = await _find_profile_note(user_id)
-    return note["id"] if note else None
-
-
-async def ensure_profile_note(user_id: int) -> int:
-    """
-    Get or create the briefing profile note.
-    Returns the note id.
-    """
-    note = await _find_profile_note(user_id)
-    if note:
-        return note["id"]
-    created = await create_note(
-        user_id=user_id,
-        title=PROFILE_TITLE,
-        body=(
-            "# Briefing Profile\n\n"
-            "This note is maintained by the briefing assistant. "
-            "It stores your preferences, patterns, and work schedule.\n\n"
-            "## Work Schedule\n\n"
-            "Office days: (not yet configured)\n\n"
-            "## Locations\n\n"
-            "(configured via Settings → Briefing)\n\n"
-            "## Preferences\n\n"
-            "(the assistant will add observations here over time)\n"
-        ),
-        tags=[PROFILE_TAG],
-    )
-    return created.id
-
-
-async def append_observations(user_id: int, observations: str) -> None:
-    """
-    Append the assistant's end-of-day observations to the profile note.
-    Creates the note if it doesn't exist.
-    """
-    if not observations.strip():
-        return
-    note_id = await ensure_profile_note(user_id)
-    note = await _find_profile_note(user_id)
-    if not note:
-        return
-    current_body = note.get("body", "")
-    from datetime import date
-    date_str = date.today().isoformat()
-    new_body = current_body.rstrip() + f"\n\n## Observations — {date_str}\n\n{observations.strip()}\n"
-    await update_note(user_id, note_id, body=new_body)
-    logger.info("Briefing profile updated for user %d", user_id)

src/fabledassistant/services/briefing_scheduler.py

@@ -1,461 +0,0 @@
-"""
-APScheduler-based briefing scheduler — per-user, timezone-aware.
-
-Each enabled user gets 4 individual CronTrigger jobs keyed to their IANA
-timezone (stored in briefing_config.timezone).  Changing the config via the
-settings UI calls update_user_schedule() which live-patches the scheduler
-without a restart.
-
-Uses a background thread scheduler (not async) because APScheduler 3.x's
-AsyncIOScheduler has known issues with Quart/hypercorn.  Jobs are async
-functions wrapped with asyncio.run_coroutine_threadsafe().
-"""
-
-import asyncio
-import logging
-from datetime import date, datetime, time, timedelta, timezone
-from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
-
-from apscheduler.schedulers.background import BackgroundScheduler
-from apscheduler.triggers.cron import CronTrigger
-from sqlalchemy import select
-
-from fabledassistant.models import async_session
-from fabledassistant.models.setting import Setting
-
-logger = logging.getLogger(__name__)
-
-_scheduler: BackgroundScheduler | None = None
-_loop: asyncio.AbstractEventLoop | None = None
-
-# Slot definitions: (name, hour, minute) — local time in the user's timezone
-SLOTS = [
-    ("compilation", 4, 0),
-    ("morning", 8, 0),
-    ("midday", 12, 0),
-    ("afternoon", 16, 0),
-]
-
-# Weekly review runs Sunday at 6pm by default
-WEEKLY_REVIEW_DAY = "sun"   # APScheduler day_of_week format
-WEEKLY_REVIEW_HOUR = 18
-WEEKLY_REVIEW_MINUTE = 0
-
-
-# ── Helpers ───────────────────────────────────────────────────────────────────
-
-def _resolve_timezone(tz_str: str) -> str:
-    """Validate and return an IANA timezone string, falling back to UTC."""
-    if not tz_str:
-        return "UTC"
-    try:
-        ZoneInfo(tz_str)
-        return tz_str
-    except (ZoneInfoNotFoundError, KeyError):
-        logger.warning("Invalid timezone %r in briefing config, falling back to UTC", tz_str)
-        return "UTC"
-
-
-async def _get_briefing_enabled_users() -> list[tuple[int, str, dict]]:
-    """Return [(user_id, iana_timezone, config)] for all users with briefing enabled."""
-    import json
-    async with async_session() as session:
-        result = await session.execute(
-            select(Setting).where(Setting.key.in_(["briefing_config", "user_timezone"]))
-        )
-        rows = list(result.scalars().all())
-
-    by_user: dict[int, dict[str, str]] = {}
-    for row in rows:
-        by_user.setdefault(row.user_id, {})[row.key] = row.value or ""
-
-    enabled = []
-    for user_id, settings in by_user.items():
-        try:
-            config = json.loads(settings.get("briefing_config", "{}") or "{}")
-            if config.get("enabled"):
-                tz_str = settings.get("user_timezone") or config.get("timezone", "UTC")
-                tz = _resolve_timezone(tz_str)
-                enabled.append((user_id, tz, config))
-        except Exception:
-            pass
-    return enabled
-
-
-def _job_id(user_id: int, slot: str) -> str:
-    return f"briefing_{slot}_user_{user_id}"
-
-
-def _add_user_jobs(user_id: int, tz: str, config: dict | None = None) -> None:
-    """Add (or replace) slot jobs for a user, skipping disabled slots."""
-    if _scheduler is None or _loop is None:
-        return
-    enabled_slots = (config or {}).get("slots", {})
-    for slot_name, hour, minute in SLOTS:
-        jid = _job_id(user_id, slot_name)
-        # compilation always runs; other slots default to True if not in config
-        slot_on = enabled_slots.get(slot_name, True)
-        if not slot_on:
-            if _scheduler.get_job(jid):
-                _scheduler.remove_job(jid)
-            continue
-        _scheduler.add_job(
-            _run_user_slot_sync,
-            CronTrigger(hour=hour, minute=minute, timezone=tz),
-            args=[user_id, slot_name],
-            id=jid,
-            replace_existing=True,
-            misfire_grace_time=3600,
-        )
-    # Weekly review job — runs once per week
-    weekly_jid = _job_id(user_id, "weekly_review")
-    weekly_on = enabled_slots.get("weekly_review", True)
-    if weekly_on:
-        _scheduler.add_job(
-            _run_user_slot_sync,
-            CronTrigger(
-                day_of_week=WEEKLY_REVIEW_DAY,
-                hour=WEEKLY_REVIEW_HOUR,
-                minute=WEEKLY_REVIEW_MINUTE,
-                timezone=tz,
-            ),
-            args=[user_id, "weekly_review"],
-            id=weekly_jid,
-            replace_existing=True,
-            misfire_grace_time=7200,
-        )
-    elif _scheduler.get_job(weekly_jid):
-        _scheduler.remove_job(weekly_jid)
-
-    logger.info("Scheduled briefing jobs for user %d in timezone %s", user_id, tz)
-
-
-def _remove_user_jobs(user_id: int) -> None:
-    """Remove all slot jobs for a user."""
-    if _scheduler is None:
-        return
-    for slot_name, _, _ in SLOTS:
-        jid = _job_id(user_id, slot_name)
-        if _scheduler.get_job(jid):
-            _scheduler.remove_job(jid)
-    weekly_jid = _job_id(user_id, "weekly_review")
-    if _scheduler.get_job(weekly_jid):
-        _scheduler.remove_job(weekly_jid)
-    logger.info("Removed briefing jobs for user %d", user_id)
-
-
-# ── Public API ────────────────────────────────────────────────────────────────
-
-def update_user_schedule(user_id: int, config: dict, tz_override: str | None = None) -> None:
-    """
-    Called when a user saves their briefing config via the settings UI.
-    Live-patches the scheduler — no restart required.
-    tz_override takes priority over any timezone in config.
-    """
-    if config.get("enabled"):
-        tz_str = tz_override or config.get("timezone", "UTC")
-        tz = _resolve_timezone(tz_str)
-        _add_user_jobs(user_id, tz, config)
-    else:
-        _remove_user_jobs(user_id)
-
-
-# ── Job execution ─────────────────────────────────────────────────────────────
-
-async def _auto_pause_stale_projects(user_id: int) -> list[str]:
-    """Pause active projects with no note/task activity in 14+ days. Returns paused project titles."""
-    from sqlalchemy import select as _sel, func as _func
-    from fabledassistant.models.project import Project
-    from fabledassistant.models.note import Note
-    from fabledassistant.models import async_session as _session
-
-    paused: list[str] = []
-    threshold = datetime.now(timezone.utc) - timedelta(days=14)
-    try:
-        async with _session() as session:
-            projects = (await session.execute(
-                _sel(Project).where(Project.user_id == user_id, Project.status == "active")
-            )).scalars().all()
-            for p in projects:
-                latest = (await session.execute(
-                    _sel(_func.max(Note.updated_at)).where(Note.project_id == p.id)
-                )).scalar()
-                if latest is None or latest < threshold:
-                    p.status = "paused"
-                    paused.append(p.title or "Untitled")
-            if paused:
-                await session.commit()
-                logger.info("Auto-paused %d stale projects for user %d: %s", len(paused), user_id, paused)
-    except Exception:
-        logger.debug("Auto-pause check failed for user %d", user_id, exc_info=True)
-    return paused
-
-
-async def _run_slot_for_user(user_id: int, slot: str) -> None:
-    """Execute one slot job for one user."""
-    from fabledassistant.services.briefing_conversations import (
-        get_or_create_today_conversation, post_message
-    )
-    from fabledassistant.services.briefing_pipeline import run_compilation, run_slot_injection
-    from fabledassistant.services.settings import get_setting
-    from fabledassistant.config import Config
-
-    # Morning slot: skip if today is not a configured work day
-    if slot == "morning":
-        from fabledassistant.services.user_profile import get_profile
-        tz_str = await get_setting(user_id, "user_timezone") or "UTC"
-        try:
-            user_tz = ZoneInfo(tz_str)
-        except Exception:
-            user_tz = ZoneInfo("UTC")
-        today_abbr = datetime.now(user_tz).strftime("%a")  # 'Mon', 'Tue', …
-        profile = await get_profile(user_id)
-        work_days = (profile.work_schedule or {}).get("days", ["Mon", "Tue", "Wed", "Thu", "Fri"])
-        if today_abbr not in work_days:
-            logger.info(
-                "Skipping morning slot for user %d — %s not a configured work day",
-                user_id, today_abbr,
-            )
-            return
-
-    model = await get_setting(user_id, "default_model", Config.OLLAMA_MODEL)
-
-    if slot == "compilation":
-        # Auto-pause stale projects before compiling the briefing
-        await _auto_pause_stale_projects(user_id)
-
-        # Refresh external data first
-        try:
-            import json
-            from fabledassistant.services.rss import refresh_all_feeds
-            config_raw = await get_setting(user_id, "briefing_config", "{}")
-            config = json.loads(config_raw) if isinstance(config_raw, str) else {}
-            await refresh_all_feeds(user_id)
-            from fabledassistant.services import weather as wx
-            for key, loc in config.get("locations", {}).items():
-                if loc.get("lat") and loc.get("lon"):
-                    await wx.refresh_location_cache(
-                        user_id=user_id,
-                        location_key=key,
-                        location_label=loc.get("label", key),
-                        lat=loc["lat"],
-                        lon=loc["lon"],
-                    )
-        except Exception:
-            logger.warning("Pre-compilation refresh failed for user %d", user_id, exc_info=True)
-
-        await _run_profile_closeout(user_id, model)
-        conv = await get_or_create_today_conversation(user_id, model)
-        text, metadata = await run_compilation(user_id, slot, model)
-        if text:
-            await post_message(conv.id, "assistant", text, metadata=metadata)
-
-    else:
-        conv = await get_or_create_today_conversation(user_id, model)
-        text = await run_slot_injection(user_id, slot, model)
-        if text:
-            await post_message(conv.id, "user", f"[{slot.title()} briefing update]")
-            await post_message(conv.id, "assistant", text)
-
-    try:
-        from fabledassistant.services.push import send_push_notification
-        slot_labels = {
-            "compilation": "Morning briefing ready",
-            "morning": "Office briefing ready",
-            "midday": "Midday check-in",
-            "afternoon": "End of day wrap-up",
-        }
-        await send_push_notification(
-            user_id=user_id,
-            title="Briefing",
-            body=slot_labels.get(slot, "Briefing update"),
-            url="/briefing",
-        )
-    except Exception:
-        logger.debug("Push notification failed for briefing slot %s", slot, exc_info=True)
-
-    logger.info("Briefing slot '%s' completed for user %d", slot, user_id)
-
-
-def _run_user_slot_sync(user_id: int, slot: str) -> None:
-    """Synchronous wrapper called by APScheduler's background thread."""
-    if _loop is None:
-        logger.error("No event loop available for briefing slot %s user %d", slot, user_id)
-        return
-    future = asyncio.run_coroutine_threadsafe(_run_slot_for_user(user_id, slot), _loop)
-    try:
-        future.result(timeout=600)
-    except Exception:
-        logger.exception("Briefing slot '%s' failed for user %d", slot, user_id)
-
-
-async def _run_profile_closeout(user_id: int, model: str) -> None:
-    """
-    Read yesterday's briefing conversation, extract preference observations,
-    and append them to the briefing profile note.
-    """
-    from fabledassistant.services.user_profile import append_observations
-    from fabledassistant.services.briefing_pipeline import _llm_synthesise
-    from fabledassistant.models.conversation import Conversation, Message
-
-    yesterday = (date.today() - timedelta(days=1))
-    async with async_session() as session:
-        result = await session.execute(
-            select(Conversation).where(
-                Conversation.user_id == user_id,
-                Conversation.conversation_type == "briefing",
-                Conversation.briefing_date == yesterday,
-            )
-        )
-        conv = result.scalars().first()
-        if not conv:
-            return
-        msgs_result = await session.execute(
-            select(Message).where(Message.conversation_id == conv.id).order_by(Message.created_at)
-        )
-        messages = list(msgs_result.scalars().all())
-
-    if len(messages) < 2:
-        return
-
-    transcript = "\n".join(
-        f"{m.role.upper()}: {m.content[:500]}" for m in messages[-20:]
-    )
-    system = (
-        "You are reviewing a day's briefing conversation to extract preference observations. "
-        "Identify any patterns, preferences, or schedule facts the user revealed. "
-        "Write 2-5 short bullet points. Be specific and factual. "
-        "Example: '- User skipped news about finance', '- Prefers weather for home location first'. "
-        "If nothing notable, output only: (nothing to note)"
-    )
-    observations = await _llm_synthesise(system, transcript, model)
-    if observations and "(nothing to note)" not in observations.lower():
-        await append_observations(user_id, observations)
-
-
-# ── Startup / catchup ─────────────────────────────────────────────────────────
-
-async def _catchup_missed_slots(loop: asyncio.AbstractEventLoop) -> None:
-    """
-    On startup, fire any slot that was missed in the last 24 hours
-    (one catch-up per slot per user, evaluated in the user's local timezone).
-    """
-    users = await _get_briefing_enabled_users()
-    for user_id, tz, _config in users:
-        user_tz = ZoneInfo(tz)
-        now_local = datetime.now(user_tz)
-        today_local = now_local.date()
-
-        for slot_name, hour, minute in SLOTS:
-            slot_local = datetime.combine(today_local, time(hour, minute), tzinfo=user_tz)
-            if slot_local > now_local:
-                continue  # Not yet due
-            age = (now_local - slot_local).total_seconds()
-            if age > 86400:
-                continue  # More than 24h ago — skip
-
-            # Check if today's conversation already has a message from after slot time
-            async with async_session() as session:
-                from fabledassistant.models.conversation import Conversation, Message
-                result = await session.execute(
-                    select(Conversation).where(
-                        Conversation.user_id == user_id,
-                        Conversation.conversation_type == "briefing",
-                        Conversation.briefing_date == today_local,
-                    )
-                )
-                conv = result.scalars().first()
-                if conv:
-                    # Convert slot_local to UTC for DB comparison (stored as UTC)
-                    slot_utc = slot_local.astimezone(ZoneInfo("UTC"))
-                    msgs = await session.execute(
-                        select(Message).where(
-                            Message.conversation_id == conv.id,
-                            Message.created_at >= slot_utc,
-                        ).limit(1)
-                    )
-                    if msgs.scalars().first():
-                        continue  # Already covered
-
-            logger.info(
-                "Catching up missed briefing slot '%s' for user %d (tz: %s)",
-                slot_name, user_id, tz,
-            )
-            try:
-                await _run_slot_for_user(user_id, slot_name)
-            except Exception:
-                logger.exception(
-                    "Catch-up for slot '%s' user %d failed", slot_name, user_id
-                )
-
-
-async def start_briefing_scheduler(loop: asyncio.AbstractEventLoop) -> None:
-    """
-    Start the APScheduler background scheduler with per-user timezone-aware jobs.
-    Must be awaited from the app's before_serving hook (async context).
-    """
-    global _scheduler, _loop
-    if _scheduler is not None:
-        return
-
-    _loop = loop
-    _scheduler = BackgroundScheduler(timezone="UTC")
-
-    # Await directly — we're already on the event loop, so run_coroutine_threadsafe
-    # would deadlock (it blocks the calling thread, which IS the event loop thread).
-    try:
-        users = await _get_briefing_enabled_users()
-    except Exception:
-        logger.exception("Failed to load briefing users at startup")
-        users = []
-
-    for user_id, tz, config in users:
-        _add_user_jobs(user_id, tz, config)
-
-    from fabledassistant.services.recurrence import spawn_recurring_tasks as _spawn_recurring
-
-    def _run_recurrence_spawn() -> None:
-        future = asyncio.run_coroutine_threadsafe(_spawn_recurring(), _loop)
-        try:
-            count = future.result(timeout=300)
-            logger.info("Recurrence spawn: %d task(s) created", count)
-        except Exception as exc:
-            logger.error("Recurrence spawn failed: %s", exc)
-
-    _scheduler.add_job(
-        _run_recurrence_spawn,
-        CronTrigger(hour=0, minute=0, timezone="UTC"),
-        id="recurrence_daily",
-        replace_existing=True,
-    )
-
-    def _run_kokoro_update_check() -> None:
-        from fabledassistant.services.tts import check_for_kokoro_updates
-        future = asyncio.run_coroutine_threadsafe(check_for_kokoro_updates(), _loop)
-        try:
-            future.result(timeout=300)
-        except Exception as exc:
-            logger.error("Kokoro update check failed: %s", exc)
-
-    _scheduler.add_job(
-        _run_kokoro_update_check,
-        CronTrigger(hour=3, minute=0, timezone="UTC"),
-        id="kokoro_update_check_daily",
-        replace_existing=True,
-    )
-
-    _scheduler.start()
-    logger.info(
-        "Briefing scheduler started with %d user(s) across %d job(s)",
-        len(users), len(users) * len(SLOTS),
-    )
-
-    asyncio.create_task(_catchup_missed_slots(loop))
-
-
-def stop_briefing_scheduler() -> None:
-    global _scheduler, _loop
-    if _scheduler:
-        _scheduler.shutdown(wait=False)
-        _scheduler = None
-    _loop = None

src/fabledassistant/services/calendar_sync.py

@@ -66,7 +66,7 @@ async def setup_user_calendar(user_id: int) -> bool:
   <set>
     <prop>
       <resourcetype><collection/><C:calendar/></resourcetype>
-      <displayname>Fabled Assistant</displayname>
+      <displayname>Fabled Scribe</displayname>
     </prop>
   </set>
 </mkcol>""",

src/fabledassistant/services/chat.py

@@ -80,7 +80,7 @@ async def list_conversations(
                 "title": conv.title,
                 "model": conv.model,
                 "conversation_type": conv.conversation_type,
-                "briefing_date": conv.briefing_date.isoformat() if conv.briefing_date else None,
+                "day_date": conv.day_date.isoformat() if conv.day_date else None,
                 "rag_project_id": conv.rag_project_id,
                 "message_count": row[1],
                 "created_at": conv.created_at.isoformat(),
@@ -187,6 +187,7 @@ async def add_message(
     context_note_id: int | None = None,
     status: str | None = None,
     tool_calls: list | None = None,
+    msg_metadata: dict | None = None,
 ) -> Message:
     async with async_session() as session:
         kwargs: dict = dict(
@@ -199,6 +200,8 @@ async def add_message(
             kwargs["status"] = status
         if tool_calls is not None:
             kwargs["tool_calls"] = tool_calls
+        if msg_metadata is not None:
+            kwargs["msg_metadata"] = msg_metadata
         msg = Message(**kwargs)
         session.add(msg)
         # Touch conversation updated_at

src/fabledassistant/services/email.py

@@ -38,7 +38,7 @@ _EMAIL_LOGO_SVG = (
 
 
 def _email_html(title: str, body: str) -> str:
-    """Wrap email body content in the standard Fabled Assistant template."""
+    """Wrap email body content in the standard Fabled Scribe template."""
     return f"""<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -56,7 +56,7 @@ def _email_html(title: str, body: str) -> str:
         <!-- Header -->
         <div style="background:linear-gradient(135deg,#7c3aed 0%,#6d28d9 100%);padding:24px 28px;text-align:center;">
           <div style="margin-bottom:8px;">
-            {_EMAIL_LOGO_SVG}<span style="display:inline-block;vertical-align:middle;color:#ffffff;font-size:18px;font-weight:700;letter-spacing:0.01em;">Fabled Assistant</span>
+            {_EMAIL_LOGO_SVG}<span style="display:inline-block;vertical-align:middle;color:#ffffff;font-size:18px;font-weight:700;letter-spacing:0.01em;">Fabled Scribe</span>
           </div>
           <p style="margin:0;color:#ede9fe;font-size:13px;letter-spacing:0.03em;">{title}</p>
         </div>
@@ -68,7 +68,7 @@ def _email_html(title: str, body: str) -> str:
 
         <!-- Footer -->
         <div style="border-top:1px solid #ede9fe;padding:16px 28px;text-align:center;background:#faf5ff;">
-          <p style="margin:0;color:#a78bfa;font-size:12px;">Sent by your Fabled Assistant instance.</p>
+          <p style="margin:0;color:#a78bfa;font-size:12px;">Sent by your Fabled Scribe instance.</p>
         </div>
 
       </div>
@@ -146,7 +146,7 @@ async def send_email(to: str, subject: str, html_body: str) -> None:
     username = config.get("smtp_username", "")
     password = config.get("smtp_password", "")
     from_address = config.get("smtp_from_address", "")
-    from_name = config.get("smtp_from_name", "Fabled Assistant")
+    from_name = config.get("smtp_from_name", "Fabled Scribe")
     use_tls = config.get("smtp_use_tls", "true") == "true"
 
     msg = EmailMessage()
@@ -176,6 +176,6 @@ async def send_test_email(to: str) -> None:
     """Send a branded test email."""
     body = """
         <p style="margin:0 0 12px;color:#1e1b4b;font-size:15px;font-weight:600;">SMTP is configured correctly</p>
-        <p style="margin:0;color:#6b7280;font-size:14px;">Your Fabled Assistant instance can send email notifications.</p>
+        <p style="margin:0;color:#6b7280;font-size:14px;">Your Fabled Scribe instance can send email notifications.</p>
     """
-    await send_email(to, "Fabled Assistant - Test Email", _email_html("Test Email", body))
+    await send_email(to, "Fabled Scribe - Test Email", _email_html("Test Email", body))

src/fabledassistant/services/embeddings.py

@@ -1,7 +1,6 @@
 """Semantic note search via Ollama embedding model (nomic-embed-text).
 
 Embeddings are stored in the note_embeddings table (one row per note).
-RSS item embeddings are stored in rss_item_embeddings (one row per item).
 All search operations degrade gracefully — if the embedding model is
 unavailable the callers fall back to keyword search.
 """
@@ -9,7 +8,6 @@ unavailable the callers fall back to keyword search.
 import asyncio
 import logging
 import math
-from datetime import datetime, timedelta, timezone
 
 import httpx
 from sqlalchemy import delete, select
@@ -18,8 +16,6 @@ from fabledassistant.config import Config
 from fabledassistant.models import async_session
 from fabledassistant.models.embedding import NoteEmbedding
 from fabledassistant.models.note import Note
-from fabledassistant.models.rss_feed import RssItem
-from fabledassistant.models.rss_item_embedding import RssItemEmbedding
 
 logger = logging.getLogger(__name__)
 
@@ -28,10 +24,6 @@ logger = logging.getLogger(__name__)
 # 0.45 keeps only genuinely relevant notes; lower values like 0.30 let in
 # loosely-related results that pad the sidebar without adding real value.
 _SIMILARITY_THRESHOLD = 0.45
-_RSS_SIMILARITY_THRESHOLD = 0.55
-_RSS_SEARCH_LIMIT = 3
-_RSS_SEARCH_DAYS = 30
-_RSS_SNIPPET_CHARS = 500
 
 
 async def get_embedding(text: str, model: str | None = None) -> list[float]:
@@ -186,174 +178,3 @@ async def backfill_note_embeddings() -> None:
     logger.info("Embedding backfill complete: %d/%d notes embedded", success, len(notes_to_embed))
 
 
-# ── RSS item embeddings ───────────────────────────────────────────────────────
-
-async def upsert_rss_item_embedding(item_id: int, user_id: int, title: str, content: str) -> None:
-    """Generate and persist an embedding for an RSS item. Safe to fire-and-forget."""
-    text = f"{title}\n{content}".strip()
-    if not text:
-        return
-    try:
-        embedding = await get_embedding(text)
-    except Exception:
-        logger.debug("Skipping embedding for RSS item %d — model unavailable", item_id)
-        return
-
-    try:
-        async with async_session() as session:
-            await session.execute(
-                delete(RssItemEmbedding).where(RssItemEmbedding.rss_item_id == item_id)
-            )
-            session.add(RssItemEmbedding(rss_item_id=item_id, user_id=user_id, embedding=embedding))
-            await session.commit()
-        logger.debug("Upserted embedding for RSS item %d", item_id)
-    except Exception:
-        logger.warning("Failed to persist embedding for RSS item %d", item_id, exc_info=True)
-
-
-async def semantic_search_rss_items(
-    user_id: int,
-    query_vector: list[float],
-    limit: int = _RSS_SEARCH_LIMIT,
-    days: int = _RSS_SEARCH_DAYS,
-) -> list[tuple[float, RssItem]]:
-    """Return up to *limit* (score, RssItem) pairs most relevant to *query_vector*.
-
-    Only considers items fetched within the last *days* days.
-    Returns an empty list on any error.
-    """
-    since = datetime.now(timezone.utc) - timedelta(days=days)
-    try:
-        async with async_session() as session:
-            stmt = (
-                select(RssItemEmbedding, RssItem)
-                .join(RssItem, RssItemEmbedding.rss_item_id == RssItem.id)
-                .where(
-                    RssItemEmbedding.user_id == user_id,
-                    RssItem.fetched_at >= since,
-                )
-            )
-            rows = list((await session.execute(stmt)).all())
-    except Exception:
-        logger.warning("Failed to query RSS item embeddings", exc_info=True)
-        return []
-
-    if not rows:
-        return []
-
-    scored: list[tuple[float, RssItem]] = []
-    for rie, item in rows:
-        try:
-            sim = _cosine_similarity(query_vector, rie.embedding)
-        except Exception:
-            continue
-        if sim >= _RSS_SIMILARITY_THRESHOLD:
-            scored.append((sim, item))
-
-    scored.sort(key=lambda x: x[0], reverse=True)
-    return scored[:limit]
-
-
-async def backfill_rss_item_embeddings() -> None:
-    """Generate embeddings for all RSS items that don't have one yet.
-
-    Runs as a background task at startup. Adds a small sleep between items
-    to avoid overwhelming Ollama.
-    """
-    try:
-        async with async_session() as session:
-            existing = {
-                row[0]
-                for row in (
-                    await session.execute(select(RssItemEmbedding.rss_item_id))
-                ).fetchall()
-            }
-            result = await session.execute(
-                select(RssItem.id, RssItem.feed_id, RssItem.title, RssItem.content)
-            )
-            items_to_embed = [row for row in result.fetchall() if row[0] not in existing]
-    except Exception:
-        logger.warning("RSS embedding backfill: failed to query items", exc_info=True)
-        return
-
-    if not items_to_embed:
-        logger.info("RSS embedding backfill: all items already have embeddings")
-        return
-
-    # Resolve user_id per feed_id
-    try:
-        from fabledassistant.models.rss_feed import RssFeed
-        async with async_session() as session:
-            result = await session.execute(select(RssFeed.id, RssFeed.user_id))
-            feed_user_map = {fid: uid for fid, uid in result.fetchall()}
-    except Exception:
-        logger.warning("RSS embedding backfill: failed to load feed user map", exc_info=True)
-        return
-
-    logger.info("RSS embedding backfill: generating embeddings for %d items", len(items_to_embed))
-    success = 0
-    for item_id, feed_id, title, content in items_to_embed:
-        user_id = feed_user_map.get(feed_id)
-        if user_id is None:
-            continue
-        await upsert_rss_item_embedding(item_id, user_id, title or "", content or "")
-        success += 1
-        await asyncio.sleep(0.05)
-
-    logger.info("RSS embedding backfill complete: %d/%d items embedded", success, len(items_to_embed))
-
-
-async def backfill_rss_article_content() -> None:
-    """Fetch full article text for RSS items that only have short feed-provided content.
-
-    An item is considered unenriched if its content is shorter than 1000 chars —
-    typical of feed summaries/teasers rather than full articles.
-    Runs at startup after the embedding backfill.
-    """
-    from fabledassistant.services.rss import _fetch_full_article
-    from fabledassistant.models.rss_feed import RssFeed
-
-    SHORT_THRESHOLD = 1000
-
-    try:
-        async with async_session() as session:
-            feed_result = await session.execute(select(RssFeed.id, RssFeed.user_id))
-            feed_user_map = {fid: uid for fid, uid in feed_result.fetchall()}
-
-            item_result = await session.execute(
-                select(RssItem.id, RssItem.feed_id, RssItem.url, RssItem.title, RssItem.content)
-                .where(RssItem.url != "")
-            )
-            candidates = [
-                row for row in item_result.fetchall()
-                if len(row[4] or "") < SHORT_THRESHOLD
-            ]
-    except Exception:
-        logger.warning("Article content backfill: failed to query items", exc_info=True)
-        return
-
-    if not candidates:
-        logger.info("Article content backfill: no unenriched items found")
-        return
-
-    logger.info("Article content backfill: enriching %d items", len(candidates))
-    enriched = 0
-    for item_id, feed_id, url, title, _ in candidates:
-        user_id = feed_user_map.get(feed_id)
-        if user_id is None:
-            continue
-        full_text = await _fetch_full_article(url)
-        if full_text and len(full_text) > SHORT_THRESHOLD:
-            try:
-                async with async_session() as session:
-                    item = await session.get(RssItem, item_id)
-                    if item:
-                        item.content = full_text
-                        await session.commit()
-                await upsert_rss_item_embedding(item_id, user_id, title or "", full_text)
-                enriched += 1
-            except Exception:
-                logger.debug("Failed to store enriched content for item %d", item_id, exc_info=True)
-        await asyncio.sleep(0.5)
-
-    logger.info("Article content backfill complete: %d/%d items enriched", enriched, len(candidates))

src/fabledassistant/services/events.py

@@ -7,7 +7,7 @@ import uuid
 from datetime import datetime, timedelta, timezone
 
 from dateutil.rrule import rrulestr
-from sqlalchemy import or_, select
+from sqlalchemy import and_, or_, select
 
 from fabledassistant.models import async_session
 from fabledassistant.models.event import Event
@@ -85,19 +85,30 @@ async def list_events(
     dicts (same shape as Event.to_dict()).
     """
     async with async_session() as session:
+        # Match strategy:
+        #   - Recurring events: fetch all, expand via rrule below.
+        #   - Non-recurring with an end_dt: standard overlap — starts before
+        #     date_to and ends after date_from.
+        #   - Non-recurring with no end_dt: treat as a point event at
+        #     start_dt, include only if start_dt falls within the window.
+        #     (Previously this branch matched any event with a null end_dt,
+        #     returning all past events as "happening today".)
         result = await session.execute(
             select(Event).where(
                 Event.user_id == user_id,
-                # Base window: non-recurring events must overlap range;
-                # recurring events always need to be fetched so they can be expanded.
                 or_(
                     Event.recurrence.isnot(None),
-                    Event.start_dt <= date_to,
-                ),
-                or_(
-                    Event.end_dt.is_(None),
-                    Event.end_dt >= date_from,
-                    Event.recurrence.isnot(None),
+                    and_(
+                        Event.recurrence.is_(None),
+                        Event.start_dt <= date_to,
+                        or_(
+                            Event.end_dt >= date_from,
+                            and_(
+                                Event.end_dt.is_(None),
+                                Event.start_dt >= date_from,
+                            ),
+                        ),
+                    ),
                 ),
             ).order_by(Event.start_dt)
         )

src/fabledassistant/services/generation_task.py

@@ -36,73 +36,13 @@ _TOOL_CALL_MARKER = re.compile(r"^\s*\[TOOL_CALLS\]\s*", re.IGNORECASE)
 
 DB_FLUSH_INTERVAL = 5.0  # seconds between partial DB flushes
 
-# ---------------------------------------------------------------------------
-# Conditional thinking classifier
-# ---------------------------------------------------------------------------
-
-# Patterns that force think=True even on short messages
-_THINK_FORCE = re.compile(
-    r"\b("
-    r"analyz|compar|explain\s+why|help\s+me\s+(think|plan|understand|figure\s+out)|"
-    r"step[- ]by[- ]step|debug|troubleshoot|diagnos|"
-    r"pros\s+and\s+cons|trade[- ]?off|"
-    r"architect|design\s+(a|the|my|this)|"
-    r"write\s+a\s+(detailed|long|comprehensive|full)|"
-    r"brainstorm|outline\s+(a|the|my)|"
-    r"what\s+(are|is)\s+the\s+(best|difference|relationship|impact|implication)|"
-    r"how\s+(do|does|should|would|can)\s+.{0,40}\s+work|"
-    r"why\s+(is|are|does|do|did|would|should)\b"
-    r")",
-    re.IGNORECASE,
-)
-
-# Patterns that force think=False regardless of message length
-_THINK_SKIP = re.compile(
-    r"^(hi|hey|hello|thanks|thank\s+you|ok|okay|got\s+it|sounds\s+good|"
-    r"great|perfect|sure|yes|no|yep|nope|nice|cool|awesome|"
-    r"what('s| is) \d|what time|how many|remind me|add (a |an )?(task|note|reminder)|"
-    r"create (a |an )?(task|note)|delete|update|mark .{0,30} (done|complete))\b",
-    re.IGNORECASE,
-)
-
-_WORD_COUNT_THRESHOLD = 60  # messages over this word count always use think=True
-_SHORT_MESSAGE_THRESHOLD = 12  # messages under this always use think=False
-
-
-def _should_think(user_content: str, think_requested: bool) -> bool:
-    """Return whether extended thinking should be used for this request.
-
-    If the caller didn't request thinking, we never enable it. If they did,
-    we check whether the message is complex enough to warrant the overhead.
-    """
-    if not think_requested:
-        return False
-
-    text = user_content.strip()
-    word_count = len(text.split())
-
-    if word_count <= _SHORT_MESSAGE_THRESHOLD:
-        return False
-    if _THINK_SKIP.match(text):
-        return False
-    if word_count >= _WORD_COUNT_THRESHOLD:
-        return True
-    if "```" in text:
-        return True
-    if _THINK_FORCE.search(text):
-        return True
-
-    return False
-
 
 # Human-readable labels for each tool, shown in the status indicator
 _TOOL_LABELS: dict[str, str] = {
-    "create_task": "Creating task",
-    "create_note": "Creating note",
-    "update_note": "Updating note",
-    "delete_note": "Deleting note",
-    "delete_task": "Deleting task",
-    "get_note": "Reading note",
+    "create_note": "Creating note/task",
+    "update_note": "Updating note/task",
+    "delete_note": "Deleting note/task",
+    "read_note": "Reading note",
     "list_notes": "Listing notes",
     "list_tasks": "Searching tasks",
     "search_notes": "Searching notes (semantic)",
@@ -112,7 +52,7 @@ _TOOL_LABELS: dict[str, str] = {
     "update_event": "Updating calendar event",
     "delete_event": "Removing calendar event",
     "list_calendars": "Listing calendars",
-    "search_web": "Searching the web",
+    "lookup": "Looking up information",
     "research_topic": "Researching topic",
 }
 
@@ -236,8 +176,15 @@ async def run_generation(
 
     buf.append_event("status", {"status": "Building context..."})
 
-    # Phase 1: Resolve the tools list for this user.
-    tools = await get_tools_for_user(user_id)
+    # Phase 1: Resolve the tools list for this user, scoped to conversation type.
+    from fabledassistant.models import async_session as _async_session
+    from fabledassistant.models.conversation import Conversation as _Conversation
+    async with _async_session() as _sess:
+        _conv = await _sess.get(_Conversation, conv_id)
+    _conversation_type = (
+        _conv.conversation_type if _conv and _conv.conversation_type else "chat"
+    )
+    tools = await get_tools_for_user(user_id, conversation_type=_conversation_type)
 
     logger.info(
         "Starting generation for conv %d: model=%s, tools=%d",
@@ -275,25 +222,33 @@ async def run_generation(
         voice_speech_style=voice_speech_style,
     )
 
-    # Pick the smallest context tier that fits the current messages.
+    # Pick the smallest context tier that fits the current messages AND the
+    # tool schemas (which can be 6-10K tokens on their own with ~40 tools).
     # Using the minimum needed tier reduces KV cache size and speeds up prefill.
-    num_ctx = pick_num_ctx(messages)
+    num_ctx = pick_num_ctx(messages, tools=tools)
     logger.debug("Adaptive num_ctx=%d for conv %d", num_ctx, conv_id)
 
     # Emit context event
     buf.append_event("context", {"context": context_meta})
 
-    # Apply thinking classifier — downgrade think=True for simple/conversational messages
-    think = _should_think(user_content, think)
+    # Always think on qwen3-class models: reasoning mode is the only reliable
+    # path for the tool-call template. Content-based gating was tried in 87fcaa6
+    # but exposed silent-generation failures on short tool-intent prompts, since
+    # the classifier had no way to tell that "create a task" needs a tool call.
+    think_requested = think
+    think = True
 
     t_start = time.monotonic()
     timing: dict = {
+        "think_requested": think_requested,
         "think": think,
         "num_ctx": num_ctx,
         "tools": [],
         "rounds": 0,
         "prompt_tokens": None,
         "output_tokens": None,
+        "first_token_ms": None,
+        "thinking_ms": None,
         "ttft_ms": None,
         "generation_ms": None,
         "total_ms": None,
@@ -319,17 +274,35 @@ async def run_generation(
             buf.append_event("status", {"status": "Generating response..." if _round == 0 else "Composing response..."})
             t_stream = time.monotonic()
 
+            approx_msg_chars = sum(len(str(m.get("content", ""))) for m in messages)
+            round_content_start = len(buf.content_so_far)
+            round_output_tokens_start = timing.get("output_tokens") or 0
+            round_prompt_tokens_start = timing.get("prompt_tokens") or 0
+            logger.info(
+                "CTX_DIAG round_start conv=%d round=%d num_ctx=%d msgs=%d approx_chars=%d think=%s",
+                conv_id, _round, num_ctx, len(messages), approx_msg_chars, think,
+            )
             async for chunk in _stream_with_retry(messages, model, tools, think, num_ctx=num_ctx):
                 if buf.cancel_event.is_set():
                     cancelled = True
                     break
 
                 if chunk.type == "thinking":
+                    if timing["first_token_ms"] is None:
+                        timing["first_token_ms"] = int((time.monotonic() - t_start) * 1000)
                     buf.append_event("thinking_chunk", {"chunk": chunk.content})
 
                 elif chunk.type == "content":
                     if timing["ttft_ms"] is None:
-                        timing["ttft_ms"] = int((time.monotonic() - t_start) * 1000)
+                        now_ms = int((time.monotonic() - t_start) * 1000)
+                        timing["ttft_ms"] = now_ms
+                        if timing["first_token_ms"] is None:
+                            # No thinking phase occurred — first token IS content.
+                            timing["first_token_ms"] = now_ms
+                        else:
+                            # Thinking phase duration = gap between first thinking
+                            # token and first content token.
+                            timing["thinking_ms"] = now_ms - timing["first_token_ms"]
                     buf.content_so_far += chunk.content
                     clean = _TOOL_CALL_MARKER.sub("", chunk.content)
                     if clean:
@@ -376,8 +349,9 @@ async def run_generation(
                                 buf.content_so_far += done_text
                             except Exception as e:
                                 logger.exception("Research pipeline failed for topic: %s", topic)
-                                result = {"success": False, "error": str(e)}
-                                err_text = f"\nResearch failed: {e}"
+                                err_msg = str(e) or f"{type(e).__name__}: unexpected error"
+                                result = {"success": False, "error": err_msg}
+                                err_text = f"\nResearch failed: {err_msg}"
                                 buf.append_event("chunk", {"chunk": err_text})
                                 buf.content_so_far += err_text
                             research_completed = True
@@ -406,6 +380,21 @@ async def run_generation(
                         all_tool_calls.append(tool_record)
                         buf.append_event("tool_call", {"tool_call": tool_record})
 
+            round_content_added = len(buf.content_so_far) - round_content_start
+            round_output_tokens_added = (timing.get("output_tokens") or 0) - round_output_tokens_start
+            round_prompt_tokens = (timing.get("prompt_tokens") or 0) - round_prompt_tokens_start
+            headroom = num_ctx - round_prompt_tokens if round_prompt_tokens else None
+            is_silent = (
+                not round_tool_calls
+                and round_content_added == 0
+                and round_output_tokens_added > 0
+            )
+            logger.info(
+                "CTX_DIAG round_end conv=%d round=%d think=%s prompt_tokens=%d output_tokens=%d headroom=%s content_added=%d tool_calls=%d silent=%s",
+                conv_id, _round, think, round_prompt_tokens, round_output_tokens_added,
+                headroom, round_content_added, len(round_tool_calls), is_silent,
+            )
+
             timing["generation_ms"] = int((time.monotonic() - t_stream) * 1000)
 
             if cancelled:
@@ -440,6 +429,29 @@ async def run_generation(
         # Strip model artifacts from final content
         buf.content_so_far = _TOOL_CALL_MARKER.sub("", buf.content_so_far)
 
+        # Silent-generation safety net: the model burned output tokens but
+        # nothing landed in content or tool_calls (seen with qwen3:14b when
+        # its tool-call emission doesn't parse). Show a visible fallback so
+        # the user isn't staring at an empty bubble.
+        if (
+            not cancelled
+            and not buf.content_so_far.strip()
+            and not all_tool_calls
+            and (timing.get("output_tokens") or 0) > 0
+        ):
+            logger.warning(
+                "Silent generation for conv %d: output_tokens=%s but empty content "
+                "and no tool calls (model=%s)",
+                conv_id, timing.get("output_tokens"), model,
+            )
+            fallback = (
+                "I wasn't able to produce a usable response — the model generated "
+                "tokens that couldn't be parsed as content or a tool call. "
+                "Please try rephrasing, or try again."
+            )
+            buf.content_so_far = fallback
+            buf.append_event("chunk", {"chunk": fallback})
+
         # Final save
         logger.info("Generation complete for conv %d: content_length=%d, tool_calls=%d",
                      conv_id, len(buf.content_so_far), len(all_tool_calls))
@@ -452,9 +464,13 @@ async def run_generation(
 
         timing["total_ms"] = int((time.monotonic() - t_start) * 1000)
         logger.info(
-            "Generation timing for conv %d: total=%dms ttft=%s tools=%s generation=%s",
-            conv_id, timing["total_ms"], timing["ttft_ms"],
-            [(t["name"], t["ms"]) for t in timing["tools"]], timing["generation_ms"],
+            "Generation timing for conv %d: total=%dms think=%s(req=%s) first_token=%s "
+            "thinking=%s ttft=%s generation=%s tools=%s",
+            conv_id, timing["total_ms"],
+            timing["think"], timing["think_requested"],
+            timing["first_token_ms"], timing["thinking_ms"], timing["ttft_ms"],
+            timing["generation_ms"],
+            [(t["name"], t["ms"]) for t in timing["tools"]],
         )
         try:
             await log_generation(user_id, conv_id, model, timing)
@@ -500,9 +516,22 @@ async def run_generation(
         should_gen_title = not conv_title or (msg_count > 0 and msg_count % 10 == 0)
 
         if should_gen_title:
-            title_messages = messages + [
-                {"role": "assistant", "content": buf.content_so_far}
+            # Feed the title model the *raw* conversation turns only — never
+            # the post-build_context ``messages`` list. ``build_context``
+            # prepends RAG snippets and URL content INTO the user message
+            # string itself, so filtering by role="user" downstream still
+            # surfaces that noise as the "user's message". That pollution
+            # caused wildly-wrong titles (bug #109) — the small background
+            # model was staring at article excerpts instead of what the user
+            # actually typed. Pass the original history + the raw user_content
+            # + the assistant reply.
+            title_messages: list[dict] = [
+                {"role": m["role"], "content": m.get("content") or ""}
+                for m in history
+                if m.get("role") in ("user", "assistant")
             ]
+            title_messages.append({"role": "user", "content": user_content})
+            title_messages.append({"role": "assistant", "content": buf.content_so_far})
 
             async def _bg_title() -> None:
                 try:

src/fabledassistant/services/journal_pipeline.py

@@ -0,0 +1,174 @@
+"""System prompt + ambient context injection for journal conversations.
+
+Distinct from the chat pipeline (services/llm.py) in three ways:
+1. New persona: warm, curious listener; not a task manager.
+2. Calibration rules: ask before structural changes; record_moment freely.
+3. Auto-injects last ~48h of moments for ambient continuity (no notes-RAG).
+
+Notes-RAG auto-injection MUST be disabled for journal sessions — the
+journal's ambient context replaces it. Failing to disable would let notes
+leak into journal sessions, violating the design's isolation invariant.
+"""
+from __future__ import annotations
+
+import datetime
+
+from fabledassistant.services.journal_search import search_journal
+from fabledassistant.services.user_profile import build_profile_context
+
+JOURNAL_PERSONA = (
+    "You are the user's assistant. They've opened their journal — a day-anchored "
+    "conversation surface where they record their day. Behave like the rest of "
+    "the app's chat: respond conversationally, ask follow-up questions about what "
+    "they just said, verify details from earlier in the conversation when "
+    "relevant, and use tools naturally to act on their behalf when it makes sense. "
+    "The day's prep message at the top of the conversation is your context — "
+    "build on it, don't restate it."
+)
+
+JOURNAL_CALIBRATION = """\
+JOURNAL-SPECIFIC TOOL GUIDANCE:
+
+PEOPLE / PLACES — ask before creating new entries.
+- If the user mentions a name you don't already know about, ASK them in plain
+  language ("Who's Sarah to you?") and WAIT for the reply before calling
+  save_person or save_place.
+- For ambiguous references (multiple matches in their existing people/places),
+  ask which one. Never guess.
+- For unambiguous references to people they've already established, no need
+  to ask — proceed normally.
+
+MOMENTS — recording them is your primary job, not a "nice to have."
+
+After every substantive user message, BEFORE you compose your reply,
+check: did the user describe ANY of these?
+  - An event that happened ("I went grocery shopping")
+  - An encounter with a person ("had coffee with Sarah")
+  - A decision ("I'm going to switch jobs")
+  - An observation about themselves or the world ("the new place is loud")
+  - A plan or commitment ("watching a show with Victoria tonight")
+  - A feeling or state ("I'm tired", "feeling decompressed")
+  - A small accomplishment or change they made ("installed the new AP")
+
+If the answer is YES to ANY of those — CALL record_moment FIRST, before
+composing your reply. This is not optional. The journal exists to capture
+these beats; if you skip the call, the beat is lost.
+
+Multiple distinct beats in one message → multiple record_moment calls,
+one per beat.
+
+WHEN LINKING ENTITIES: use the *_names parameters (person_names,
+place_names, task_titles, note_titles). Server resolves them to IDs by
+lookup. Do NOT pass *_ids unless you have an exact ID returned from
+another tool call in this same turn. Never invent IDs.
+
+The ONLY messages where you skip record_moment are purely meta-conversational
+ones — about the journal itself or about a prior tool result ("thanks",
+"no priority needed", "can you also add X to that one", "I meant tasks not
+notes"). Those aren't journal beats; they're chat about the chat.
+
+STATE-CHANGING TOOLS — use the confirmation flow.
+- update_task / update_note that change state (status, completion, deletion)
+  follow the standard confirmation pattern: pass `confirmed=false` first; the
+  frontend shows a confirm UI; call again with `confirmed=true` after the
+  user confirms.
+- Pure-read tools (list_tasks, search_notes, search_journal, get_weather, etc.)
+  don't need confirmation.
+
+OTHER:
+- Do NOT call set_rag_scope. The journal scope is implicit.
+- Notes are not auto-retrieved here. If you need to reference a note, call
+  search_notes explicitly.
+
+RESPONSE STYLE:
+- Don't apologize for the user's feelings ("I'm sorry you're feeling…"). Engage
+  with what they said directly.
+- Don't produce multi-option menus ("1. Show your calendar 2. List your tasks
+  3. ..."). They feel like a help-desk bot. Ask one specific follow-up or take
+  one specific action.
+- Don't repeat a prior reply verbatim. If the user circles back on a theme,
+  pick a specific concrete detail from the new message to react to.
+- Match the user's length. Short message → short reply. Don't pad.
+"""
+
+PHASE_GREETINGS = {
+    "morning": "Morning. What's the day looking like for you?",
+    "midday": "How's it going so far?",
+    "evening": "Wrapping up — how'd the day shake out?",
+}
+
+
+def determine_phase(
+    *,
+    now_local: datetime.datetime,
+    day_rollover_hour: int = 4,
+    morning_end_hour: int = 12,
+    midday_end_hour: int = 18,
+) -> str:
+    """Return 'morning' | 'midday' | 'evening' for a local datetime."""
+    h = now_local.hour
+    if h < day_rollover_hour:
+        return "evening"
+    if h < morning_end_hour:
+        return "morning"
+    if h < midday_end_hour:
+        return "midday"
+    return "evening"
+
+
+def phase_greeting(phase: str) -> str:
+    return PHASE_GREETINGS.get(phase, PHASE_GREETINGS["morning"])
+
+
+async def build_journal_system_prompt(
+    *,
+    user_id: int,
+    day_date: datetime.date,
+    user_timezone: str,
+) -> str:
+    """Static-then-dynamic system prompt.
+
+    Static prefix (persona + calibration) is identical on every request,
+    preserving Ollama KV cache. Dynamic suffix changes per-day.
+    """
+    static_block = f"{JOURNAL_PERSONA}\n\n{JOURNAL_CALIBRATION}"
+
+    today_iso = day_date.isoformat()
+    tz_block = f"Today is {today_iso} ({user_timezone})."
+
+    profile_context = await build_profile_context(user_id)
+    profile_section = f"\n\n{profile_context}" if profile_context else ""
+
+    ambient = await _ambient_moments_block(user_id=user_id, day_date=day_date)
+    ambient_section = (
+        f"\n\nRECENT JOURNAL CONTEXT (last 48h):\n{ambient}" if ambient else ""
+    )
+
+    return f"{static_block}\n\n{tz_block}{profile_section}{ambient_section}"
+
+
+async def _ambient_moments_block(
+    *, user_id: int, day_date: datetime.date
+) -> str:
+    """Render last 48h of moments as a compact text block.
+
+    Capped at 20 moments / 1500 chars total. Distinct from RAG retrieval.
+    """
+    moments = await search_journal(
+        user_id=user_id,
+        date_from=day_date - datetime.timedelta(days=2),
+        date_to=day_date,
+        limit=20,
+    )
+    if not moments:
+        return ""
+
+    lines: list[str] = []
+    total_chars = 0
+    for m in moments:
+        line = f"- [{m['occurred_at']}] {m['content']}"
+        if total_chars + len(line) > 1500:
+            break
+        lines.append(line)
+        total_chars += len(line)
+    return "\n".join(lines)

src/fabledassistant/services/journal_prep.py

@@ -0,0 +1,385 @@
+"""Daily prep generator for the Journal.
+
+Runs once per day per user (scheduled, or lazy on first journal-open of a
+new day). Two phases:
+
+1. Gather structured data (tasks/events/weather/projects/recent moments/
+   open threads) — deterministic, no LLM call.
+2. Hand the structured data to the LLM and ask it for a direct, informative
+   conversational opener — flowing prose, briefing-style. Result is persisted
+   as the first *assistant* message in today's journal Conversation, so it
+   renders with the standard Illuminated Transcript bubble styling alongside
+   the rest of the conversation.
+
+The structured data is preserved on ``Message.msg_metadata.sections`` for
+provenance and future tooling.
+
+Message shape:
+    role: 'assistant'
+    content: <prose opener>
+    msg_metadata: { kind: 'daily_prep', sections: { ...raw data... } }
+"""
+from __future__ import annotations
+
+import datetime
+import logging
+
+from sqlalchemy import select
+
+from fabledassistant.config import Config
+from fabledassistant.models import Conversation, Message, async_session
+from fabledassistant.services.events import list_events
+from fabledassistant.services.journal_search import search_journal
+from fabledassistant.services.notes import list_notes
+from fabledassistant.services.projects import list_projects
+from fabledassistant.services.settings import get_setting
+from fabledassistant.services.weather import get_cached_weather_rows
+
+logger = logging.getLogger(__name__)
+
+
+async def gather_daily_sections(
+    *,
+    user_id: int,
+    day_date: datetime.date,
+    user_timezone: str,
+) -> dict:
+    """Gather all daily-prep sections and return them as a dict.
+
+    Pure data fetching — no LLM call. Each section degrades to an empty
+    list/dict on failure so the caller always gets a complete shape.
+    """
+    sections: dict = {}
+
+    try:
+        tasks_today, _ = await list_notes(
+            user_id=user_id,
+            is_task=True,
+            status=["todo", "in_progress"],
+            due_before=day_date,
+            limit=20,
+            sort="due_date",
+            order="asc",
+        )
+        sections["tasks"] = [
+            {
+                "id": t.id,
+                "title": t.title,
+                "status": t.status,
+                "priority": t.priority,
+                "due_date": t.due_date.isoformat() if t.due_date else None,
+            }
+            for t in tasks_today
+        ]
+    except Exception:
+        logger.exception("daily_prep tasks section failed for user %d", user_id)
+        sections["tasks"] = []
+
+    try:
+        day_start = datetime.datetime.combine(day_date, datetime.time.min)
+        day_end = datetime.datetime.combine(day_date, datetime.time.max)
+        sections["events"] = await list_events(
+            user_id=user_id,
+            date_from=day_start,
+            date_to=day_end,
+        )
+    except Exception:
+        logger.exception("daily_prep events section failed for user %d", user_id)
+        sections["events"] = []
+
+    try:
+        weather_rows = await get_cached_weather_rows(user_id)
+        sections["weather"] = [w.to_dict() for w in weather_rows]
+    except Exception:
+        logger.exception("daily_prep weather section failed for user %d", user_id)
+        sections["weather"] = []
+
+    try:
+        projects = await list_projects(user_id=user_id, status="active")
+        sections["projects"] = [
+            {
+                "id": p.id,
+                "title": p.title,
+                "auto_summary": p.auto_summary,
+            }
+            for p in projects[:5]
+        ]
+    except Exception:
+        logger.exception("daily_prep projects section failed for user %d", user_id)
+        sections["projects"] = []
+
+    try:
+        sections["recent_moments"] = await search_journal(
+            user_id=user_id,
+            date_from=day_date - datetime.timedelta(days=3),
+            date_to=day_date - datetime.timedelta(days=1),
+            limit=10,
+        )
+    except Exception:
+        logger.exception("daily_prep recent_moments section failed for user %d", user_id)
+        sections["recent_moments"] = []
+
+    try:
+        sections["open_threads"] = await _open_threads(user_id=user_id, day_date=day_date)
+    except Exception:
+        logger.exception("daily_prep open_threads section failed for user %d", user_id)
+        sections["open_threads"] = []
+
+    return sections
+
+
+async def _open_threads(*, user_id: int, day_date: datetime.date) -> list[dict]:
+    """Heuristic: moments from the last 7 days that look unresolved.
+
+    Treated as 'unresolved' when they have no linked tasks/notes and aren't
+    pinned. Starting heuristic — refine empirically.
+    """
+    candidates = await search_journal(
+        user_id=user_id,
+        date_from=day_date - datetime.timedelta(days=7),
+        date_to=day_date - datetime.timedelta(days=1),
+        limit=50,
+    )
+    return [
+        m for m in candidates
+        if not m.get("task_ids")
+        and not m.get("note_ids")
+        and not m.get("pinned")
+    ]
+
+
+def _render_sections_for_prompt(sections: dict) -> str:
+    """Render the gathered sections as a structured plain-text block for the LLM."""
+    lines: list[str] = []
+
+    tasks = sections.get("tasks") or []
+    if tasks:
+        lines.append("TASKS (todo or in-progress):")
+        for t in tasks[:12]:
+            line = f"  - {t.get('title', '?')}"
+            if t.get("due_date"):
+                line += f" (due {t['due_date']})"
+            if t.get("priority") and t["priority"] not in (None, "none"):
+                line += f" [{t['priority']} priority]"
+            if t.get("status") == "in_progress":
+                line += " [in progress]"
+            lines.append(line)
+        lines.append("")
+
+    events = sections.get("events") or []
+    if events:
+        lines.append("CALENDAR EVENTS TODAY:")
+        for e in events[:8]:
+            title = e.get("title", "Untitled")
+            when = e.get("start_dt", "?")
+            location = e.get("location") or ""
+            line = f"  - {title} at {when}"
+            if location:
+                line += f" ({location})"
+            lines.append(line)
+        lines.append("")
+
+    weather = sections.get("weather") or []
+    if weather:
+        lines.append("WEATHER:")
+        for w in weather:
+            label = w.get("location_label") or w.get("location_key") or "Location"
+            forecast_json = w.get("forecast_json") or {}
+            daily = forecast_json.get("daily") or {}
+            today_max = (daily.get("temperature_2m_max") or [None])[0]
+            today_min = (daily.get("temperature_2m_min") or [None])[0]
+            precip = (daily.get("precipitation_probability_max") or [None])[0]
+            bits = [label]
+            if today_max is not None and today_min is not None:
+                bits.append(f"high {today_max}° / low {today_min}°")
+            if precip is not None:
+                bits.append(f"{precip}% chance of precipitation")
+            lines.append("  - " + ", ".join(bits))
+        lines.append("")
+
+    projects = sections.get("projects") or []
+    if projects:
+        lines.append("ACTIVE PROJECTS:")
+        for p in projects[:5]:
+            line = f"  - {p.get('title', '?')}"
+            if p.get("auto_summary"):
+                summary = p["auto_summary"][:160]
+                line += f" — {summary}"
+            lines.append(line)
+        lines.append("")
+
+    recent_moments = sections.get("recent_moments") or []
+    if recent_moments:
+        lines.append("RECENT JOURNAL MOMENTS (last few days):")
+        for m in recent_moments[:8]:
+            day = m.get("day_date", "?")
+            content = (m.get("content") or "").strip()
+            lines.append(f"  - [{day}] {content}")
+        lines.append("")
+
+    open_threads = sections.get("open_threads") or []
+    if open_threads:
+        lines.append("OPEN THREADS (mentioned recently but not resolved):")
+        for m in open_threads[:5]:
+            day = m.get("day_date", "?")
+            content = (m.get("content") or "").strip()
+            lines.append(f"  - [{day}] {content}")
+        lines.append("")
+
+    if not lines:
+        return "(No data for today — quiet morning.)"
+    return "\n".join(lines).rstrip()
+
+
+_PREP_SYSTEM_PROMPT = (
+    "You are briefing the user on their day. Direct and informative — tell them what's "
+    "actually on their plate so they can step into the day with a clear picture.\n\n"
+    "Rules:\n"
+    "- LEAD with the practical data: tasks due today, calendar events, weather.\n"
+    "- Be specific and concrete. Use real task titles, event times, temperatures, "
+    "precipitation chances. Don't paraphrase data into vague summaries.\n"
+    "- Write in flowing sentences — no markdown, no bullet points, no headers — but "
+    "keep the prose factual and useful, not sentimental.\n"
+    "- 4 to 7 sentences total. Tight. No padding, no flowery openings, no \"Good morning\" "
+    "greetings unless the actual content warrants two clauses' worth.\n"
+    "- If RECENT JOURNAL MOMENTS or OPEN THREADS are present, mention one or two BRIEFLY "
+    "at the end as context — not as the lead. Skip them if nothing notable.\n"
+    "- Close with one short invitation to journal: \"What's on your mind?\", "
+    "\"Anything to set down?\", \"How's the morning shaping up?\" — pick one, keep it under 8 words.\n"
+    "- Don't fabricate. Skip categories with no data; don't acknowledge their absence.\n"
+    "- Voice is competent assistant briefing the user. Not a friend writing a letter."
+)
+
+
+def _fallback_prep_text(day_date: datetime.date) -> str:
+    """If the LLM call fails, return a minimal greeting so the user still sees something."""
+    weekday = day_date.strftime("%A")
+    return f"{weekday}, {day_date.isoformat()}. What's on your mind?"
+
+
+async def _generate_prep_prose(
+    *,
+    sections: dict,
+    day_date: datetime.date,
+    user_id: int,
+) -> str:
+    """Ask the LLM for a direct conversational journal opener built from the sections."""
+    from fabledassistant.services.llm import generate_completion
+
+    model = (await get_setting(user_id, "default_model", "")) or Config.OLLAMA_MODEL
+    if not model:
+        logger.warning("No LLM model configured for daily prep — using fallback text")
+        return _fallback_prep_text(day_date)
+
+    rendered = _render_sections_for_prompt(sections)
+    user_trigger = (
+        f"Today is {day_date.strftime('%A, %B %-d, %Y')} ({day_date.isoformat()}).\n\n"
+        f"Here is what I gathered for you:\n\n{rendered}\n\n"
+        f"Write the opener for today's journal."
+    )
+
+    messages = [
+        {"role": "system", "content": _PREP_SYSTEM_PROMPT},
+        {"role": "user", "content": user_trigger},
+    ]
+
+    try:
+        prose = await generate_completion(
+            messages=messages,
+            model=model,
+            max_tokens=400,
+        )
+    except Exception:
+        logger.exception("Daily prep prose generation failed for day %s", day_date)
+        return _fallback_prep_text(day_date)
+
+    prose = (prose or "").strip()
+    if not prose:
+        logger.warning("LLM returned empty prep prose for day %s — using fallback", day_date)
+        return _fallback_prep_text(day_date)
+    return prose
+
+
+async def ensure_daily_prep_message(
+    *,
+    user_id: int,
+    day_date: datetime.date,
+    user_timezone: str,
+    force: bool = False,
+) -> Message:
+    """Get or create today's journal Conversation, then ensure the prep message exists.
+
+    The prep message is an *assistant* role message containing the prose opener,
+    with the structured sections preserved on ``msg_metadata``. If a legacy
+    system-role prep exists from an earlier version, it gets upgraded in place
+    on the next call.
+
+    With ``force=True`` the prose is regenerated even when a prep already exists.
+    Used by the manual /api/journal/trigger-prep endpoint.
+    """
+    async with async_session() as session:
+        result = await session.execute(
+            select(Conversation).where(
+                Conversation.user_id == user_id,
+                Conversation.conversation_type == "journal",
+                Conversation.day_date == day_date,
+            )
+        )
+        conv = result.scalar_one_or_none()
+        if conv is None:
+            conv = Conversation(
+                user_id=user_id,
+                conversation_type="journal",
+                day_date=day_date,
+                title=day_date.isoformat(),
+            )
+            session.add(conv)
+            await session.flush()
+
+        # Find any existing prep (system or assistant role from any version).
+        prep_stmt = select(Message).where(Message.conversation_id == conv.id)
+        existing_prep = None
+        for msg in (await session.execute(prep_stmt)).scalars():
+            if msg.msg_metadata and msg.msg_metadata.get("kind") == "daily_prep":
+                existing_prep = msg
+                break
+
+        # If we already have an assistant-role prep with prose content and the
+        # caller didn't ask to force regeneration, we're done.
+        if (
+            existing_prep
+            and not force
+            and existing_prep.role == "assistant"
+            and (existing_prep.content or "").strip()
+        ):
+            return existing_prep
+
+        sections = await gather_daily_sections(
+            user_id=user_id, day_date=day_date, user_timezone=user_timezone
+        )
+        prose = await _generate_prep_prose(
+            sections=sections, day_date=day_date, user_id=user_id
+        )
+        new_metadata = {"kind": "daily_prep", "sections": sections}
+
+        if existing_prep:
+            # Upgrade in place: bump role, replace content + metadata.
+            existing_prep.role = "assistant"
+            existing_prep.content = prose
+            existing_prep.msg_metadata = new_metadata
+            await session.commit()
+            return existing_prep
+
+        prep_msg = Message(
+            conversation_id=conv.id,
+            role="assistant",
+            content=prose,
+            msg_metadata=new_metadata,
+        )
+        session.add(prep_msg)
+        await session.commit()
+        return prep_msg
+
+
+# Backwards-compat alias — older imports may use the old name.
+generate_daily_prep = gather_daily_sections

src/fabledassistant/services/journal_scheduler.py

@@ -0,0 +1,140 @@
+"""APScheduler instance for the Journal — daily prep generation.
+
+One per-user cron job: generate today's daily prep at the configured
+prep_time in the user's local timezone. Replaces briefing_scheduler.
+
+Mirrors the BackgroundScheduler + threadsafe-async-call pattern used by
+event_scheduler.py.
+"""
+from __future__ import annotations
+
+import asyncio
+import datetime
+import json
+import logging
+from zoneinfo import ZoneInfo
+
+from apscheduler.schedulers.background import BackgroundScheduler
+from apscheduler.triggers.cron import CronTrigger
+from sqlalchemy import select
+
+from fabledassistant.models import User, async_session
+from fabledassistant.services.journal_prep import ensure_daily_prep_message
+from fabledassistant.services.settings import get_setting
+
+logger = logging.getLogger(__name__)
+
+_scheduler: BackgroundScheduler | None = None
+_loop: asyncio.AbstractEventLoop | None = None
+
+
+DEFAULT_CONFIG = {
+    "prep_enabled": True,
+    "prep_hour": 5,
+    "prep_minute": 0,
+    "day_rollover_hour": 4,
+    "morning_end_hour": 12,
+    "midday_end_hour": 18,
+}
+
+
+async def get_journal_config(user_id: int) -> dict:
+    """Load a user's journal_config (JSON in settings) merged with defaults."""
+    raw = await get_setting(user_id, "journal_config", "")
+    config: dict = {}
+    if raw:
+        try:
+            parsed = json.loads(raw) if isinstance(raw, str) else raw
+            if isinstance(parsed, dict):
+                config = parsed
+        except Exception:
+            logger.warning("Invalid journal_config for user %d; using defaults", user_id)
+    return {**DEFAULT_CONFIG, **config}
+
+
+async def get_user_timezone(user_id: int) -> str:
+    return await get_setting(user_id, "user_timezone", "UTC") or "UTC"
+
+
+def _resolve_tz(tz_str: str) -> ZoneInfo:
+    try:
+        return ZoneInfo(tz_str)
+    except Exception:
+        return ZoneInfo("UTC")
+
+
+async def _do_daily_prep(user_id: int) -> None:
+    try:
+        tz_str = await get_user_timezone(user_id)
+        tz = _resolve_tz(tz_str)
+        config = await get_journal_config(user_id)
+        rollover = int(config.get("day_rollover_hour", 4))
+        now = datetime.datetime.now(tz)
+        # Today is the day after the most recent rollover.
+        if now.hour < rollover:
+            today = (now - datetime.timedelta(days=1)).date()
+        else:
+            today = now.date()
+        await ensure_daily_prep_message(
+            user_id=user_id, day_date=today, user_timezone=tz_str
+        )
+    except Exception:
+        logger.exception("Daily prep failed for user %d", user_id)
+
+
+def _run_daily_prep_threadsafe(user_id: int) -> None:
+    if _loop is None:
+        return
+    asyncio.run_coroutine_threadsafe(_do_daily_prep(user_id), _loop)
+
+
+async def update_user_schedule(user_id: int) -> None:
+    """Add or replace this user's daily-prep job using their current config."""
+    if _scheduler is None:
+        return
+    job_id = f"journal_prep_{user_id}"
+    if _scheduler.get_job(job_id):
+        _scheduler.remove_job(job_id)
+
+    config = await get_journal_config(user_id)
+    if not config.get("prep_enabled", True):
+        return
+
+    tz_str = await get_user_timezone(user_id)
+    tz = _resolve_tz(tz_str)
+    prep_hour = int(config.get("prep_hour", 5))
+    prep_minute = int(config.get("prep_minute", 0))
+
+    _scheduler.add_job(
+        _run_daily_prep_threadsafe,
+        trigger=CronTrigger(hour=prep_hour, minute=prep_minute, timezone=tz),
+        args=[user_id],
+        id=job_id,
+        replace_existing=True,
+    )
+
+
+async def _register_all_user_jobs() -> None:
+    async with async_session() as session:
+        users = (await session.execute(select(User))).scalars().all()
+    for user in users:
+        await update_user_schedule(user.id)
+
+
+def start_journal_scheduler(loop: asyncio.AbstractEventLoop) -> None:
+    global _scheduler, _loop
+    if _scheduler is not None:
+        return
+    _loop = loop
+    _scheduler = BackgroundScheduler()
+    _scheduler.start()
+    asyncio.run_coroutine_threadsafe(_register_all_user_jobs(), loop)
+    logger.info("Journal scheduler started")
+
+
+def stop_journal_scheduler() -> None:
+    global _scheduler
+    if _scheduler is not None:
+        _scheduler.shutdown(wait=False)
+        _scheduler = None
+        logger.info("Journal scheduler stopped")

src/fabledassistant/services/journal_search.py

@@ -0,0 +1,204 @@
+"""Search across Moments and (optionally) journal transcripts.
+
+Three modes, expressed through one tool surface:
+1. Pure temporal: no query, just date range -> ordered by occurred_at DESC.
+2. Pure entity: person_id or place_id filter -> junction lookup.
+3. Semantic: query string -> embedding similarity, optionally constrained.
+
+This module ONLY queries Moments and (optionally) journal-conversation
+messages. It MUST NOT touch notes or note_embeddings. The notes-RAG and
+journal-RAG isolation is a hard invariant of the journal design.
+"""
+from __future__ import annotations
+
+import datetime
+import math
+from typing import Sequence
+
+from sqlalchemy import select
+
+from fabledassistant.models import (
+    Conversation,
+    Message,
+    Moment,
+    MomentEmbedding,
+    async_session,
+    moment_people,
+    moment_places,
+)
+from fabledassistant.services.embeddings import get_embedding
+
+DEFAULT_LIMIT = 10
+DEFAULT_THRESHOLD = 0.55
+
+
+def _cosine(a: Sequence[float], b: Sequence[float]) -> float:
+    if not a or not b:
+        return 0.0
+    dot = sum(x * y for x, y in zip(a, b))
+    norm_a = math.sqrt(sum(x * x for x in a))
+    norm_b = math.sqrt(sum(y * y for y in b))
+    if norm_a == 0 or norm_b == 0:
+        return 0.0
+    return dot / (norm_a * norm_b)
+
+
+async def search_journal(
+    *,
+    user_id: int,
+    query: str | None = None,
+    person_id: int | None = None,
+    place_id: int | None = None,
+    tag: str | None = None,
+    date_from: datetime.date | None = None,
+    date_to: datetime.date | None = None,
+    include_transcripts: bool = False,
+    limit: int = DEFAULT_LIMIT,
+    threshold: float = DEFAULT_THRESHOLD,
+) -> list[dict]:
+    """Return Moments (and optional transcript snippets) matching the filters.
+
+    Result rows: dicts from Moment.to_dict() plus an optional `score` when
+    `query` is set. Transcript snippets carry `kind='transcript'` and `id=None`
+    to distinguish them.
+    """
+    moment_rows = await _search_moments(
+        user_id=user_id,
+        query=query,
+        person_id=person_id,
+        place_id=place_id,
+        tag=tag,
+        date_from=date_from,
+        date_to=date_to,
+        limit=limit,
+        threshold=threshold,
+    )
+
+    if not include_transcripts:
+        return moment_rows
+
+    transcript_rows = await _search_transcripts(
+        user_id=user_id,
+        query=query,
+        date_from=date_from,
+        date_to=date_to,
+        limit=limit,
+    )
+    return moment_rows + transcript_rows
+
+
+async def _search_moments(
+    *,
+    user_id: int,
+    query: str | None,
+    person_id: int | None,
+    place_id: int | None,
+    tag: str | None,
+    date_from: datetime.date | None,
+    date_to: datetime.date | None,
+    limit: int,
+    threshold: float,
+) -> list[dict]:
+    async with async_session() as session:
+        stmt = select(Moment).where(Moment.user_id == user_id)
+
+        if person_id is not None:
+            stmt = stmt.join(moment_people, moment_people.c.moment_id == Moment.id).where(
+                moment_people.c.person_id == person_id
+            )
+        if place_id is not None:
+            stmt = stmt.join(moment_places, moment_places.c.moment_id == Moment.id).where(
+                moment_places.c.place_id == place_id
+            )
+        if tag is not None:
+            stmt = stmt.where(Moment.tags.any(tag))
+        if date_from is not None:
+            stmt = stmt.where(Moment.day_date >= date_from)
+        if date_to is not None:
+            stmt = stmt.where(Moment.day_date <= date_to)
+
+        if query is None:
+            stmt = stmt.order_by(Moment.occurred_at.desc()).limit(limit)
+            moments = (await session.execute(stmt)).scalars().all()
+            return [m.to_dict() for m in moments]
+
+        # Semantic mode. Pull a wider candidate set, then rank in Python.
+        candidate_stmt = stmt.order_by(Moment.occurred_at.desc()).limit(limit * 5)
+        candidates = (await session.execute(candidate_stmt)).scalars().all()
+        if not candidates:
+            return []
+
+        candidate_ids = [m.id for m in candidates]
+        emb_stmt = select(MomentEmbedding).where(
+            MomentEmbedding.moment_id.in_(candidate_ids)
+        )
+        embeddings = {
+            e.moment_id: e.embedding
+            for e in (await session.execute(emb_stmt)).scalars()
+        }
+
+        query_vec = await get_embedding(query)
+        scored = []
+        for m in candidates:
+            vec = embeddings.get(m.id)
+            if vec is None:
+                continue
+            score = _cosine(query_vec, vec)
+            if score >= threshold:
+                row = m.to_dict()
+                row["score"] = score
+                scored.append(row)
+
+        scored.sort(key=lambda r: r["score"], reverse=True)
+        return scored[:limit]
+
+
+async def _search_transcripts(
+    *,
+    user_id: int,
+    query: str | None,
+    date_from: datetime.date | None,
+    date_to: datetime.date | None,
+    limit: int,
+) -> list[dict]:
+    """Fallback substring search over raw journal Messages.
+
+    Substring is intentional: transcripts catch what the LLM didn't extract
+    as Moments. Semantic search over messages would require a third embedding
+    index, which we deliberately don't maintain.
+    """
+    if query is None:
+        return []
+    async with async_session() as session:
+        stmt = (
+            select(Message, Conversation.day_date)
+            .join(Conversation, Message.conversation_id == Conversation.id)
+            .where(
+                Conversation.user_id == user_id,
+                Conversation.conversation_type == "journal",
+                Message.content.ilike(f"%{query}%"),
+            )
+            .order_by(Message.created_at.desc())
+            .limit(limit)
+        )
+        if date_from is not None:
+            stmt = stmt.where(Conversation.day_date >= date_from)
+        if date_to is not None:
+            stmt = stmt.where(Conversation.day_date <= date_to)
+        rows = (await session.execute(stmt)).all()
+        return [
+            {
+                "id": None,
+                "kind": "transcript",
+                "message_id": msg.id,
+                "conversation_id": msg.conversation_id,
+                "day_date": day_date.isoformat() if day_date else None,
+                "occurred_at": msg.created_at.isoformat(),
+                "content": msg.content[:400],
+                "raw_excerpt": None,
+                "tags": [],
+                "people": [],
+                "places": [],
+            }
+            for msg, day_date in rows
+        ]

src/fabledassistant/services/llm.py

@@ -26,12 +26,32 @@ logger = logging.getLogger(__name__)
 _CTX_TIERS = (8192, 16384, 32768)
 
 
-def pick_num_ctx(messages: list[dict]) -> int:
-    """Return the smallest context tier that fits *messages* with 25% headroom.
+def keep_alive_for(model: str) -> str:
+    """Return the Ollama keep_alive duration for *model*.
+
+    Background models get a shorter window because they're called
+    sporadically; the main interactive model gets a longer one so it
+    stays warm between user messages.
+    """
+    if model == Config.OLLAMA_BACKGROUND_MODEL:
+        return Config.OLLAMA_KEEP_ALIVE_BACKGROUND
+    return Config.OLLAMA_KEEP_ALIVE_MAIN
+
+
+def pick_num_ctx(messages: list[dict], tools: list[dict] | None = None) -> int:
+    """Return the smallest context tier that fits *messages* + *tools* with 25% headroom.
+
+    The ``tools`` JSON schemas are a large, often-overlooked chunk of the prompt.
+    With ~40 tools in the registry the schemas alone can be 6-10K tokens — enough
+    that omitting them from the estimate causes silent prompt truncation.
 
     Stays at or below Config.OLLAMA_NUM_CTX (the configured ceiling).
     """
     total_chars = sum(len(m.get("content") or "") for m in messages)
+    if tools:
+        # Serialize the same way Ollama will see them. json.dumps gives us a
+        # faithful char count for the schema payload without any guesswork.
+        total_chars += len(json.dumps(tools))
     estimated_tokens = int(total_chars / 3.5)
     needed = int(estimated_tokens * 1.25) + 256  # 25% headroom + output buffer
     cap = Config.OLLAMA_NUM_CTX
@@ -58,7 +78,14 @@ RAG_AUTO_SNIPPET = 4000
 
 
 async def get_installed_models() -> set[str]:
-    """Return set of installed Ollama model names (with and without :latest)."""
+    """Return set of installed Ollama model names (with and without :latest).
+
+    Tags are normalized to lowercase. Ollama stores whatever casing was used at
+    pull time (``ollama pull gemma3:12B`` keeps the ``B``), but inference calls
+    against the capitalized tag can 400 — the two code paths are inconsistent.
+    Lowercasing on read avoids exposing that mixed-case name in the UI and
+    keeps the validation check below from accepting a form Ollama will reject.
+    """
     try:
         async with httpx.AsyncClient(timeout=10.0) as client:
             resp = await client.get(f"{Config.OLLAMA_URL}/api/tags")
@@ -66,7 +93,7 @@ async def get_installed_models() -> set[str]:
             data = resp.json()
             names: set[str] = set()
             for m in data.get("models", []):
-                name = m["name"]
+                name = m["name"].lower()
                 names.add(name)
                 if name.endswith(":latest"):
                     names.add(name.removesuffix(":latest"))
@@ -78,6 +105,9 @@ async def get_installed_models() -> set[str]:
 
 async def ensure_model(model: str) -> None:
     """Check if model exists in Ollama, pull if missing."""
+    # Match the lowercase normalization in get_installed_models so a legacy
+    # mixed-case setting doesn't force a spurious re-pull at startup.
+    model = model.lower()
     try:
         installed = await get_installed_models()
         if model in installed or f"{model}:latest" in installed:
@@ -129,6 +159,24 @@ async def wait_for_model_loaded(model: str, timeout: float = 90.0) -> bool:
         await asyncio.sleep(min(2.0, remaining))
 
 
+async def _raise_ollama_error(resp: httpx.Response, model: str) -> None:
+    """On a non-2xx Ollama response, log its body before raising.
+
+    ``resp.raise_for_status()`` alone throws away Ollama's error body, which
+    carries the actual reason (e.g. ``"model does not support tools"``,
+    ``"context length exceeded"``). Reading the body first means failures
+    surface a usable message instead of a bare HTTPStatusError.
+    """
+    if resp.status_code < 400:
+        return
+    body = (await resp.aread()).decode("utf-8", errors="replace").strip()
+    logger.error(
+        "Ollama /api/chat %d for model=%s: %s",
+        resp.status_code, model, body[:500],
+    )
+    resp.raise_for_status()
+
+
 async def stream_chat(
     messages: list[dict],
     model: str,
@@ -145,7 +193,7 @@ async def stream_chat(
     merged_options = {"num_ctx": num_ctx or Config.OLLAMA_NUM_CTX}
     if options:
         merged_options.update(options)
-    payload: dict = {"model": model, "messages": messages, "stream": True, "options": merged_options, "think": think, "keep_alive": "2h"}
+    payload: dict = {"model": model, "messages": messages, "stream": True, "options": merged_options, "think": think, "keep_alive": keep_alive_for(model)}
     # read=None: no per-chunk timeout — Ollama may pause for any duration while
     # processing a large input context before the first token arrives.
     async with httpx.AsyncClient(timeout=httpx.Timeout(connect=30.0, read=None, write=None, pool=30.0)) as client:
@@ -154,7 +202,7 @@ async def stream_chat(
             f"{Config.OLLAMA_URL}/api/chat",
             json=payload,
         ) as resp:
-            resp.raise_for_status()
+            await _raise_ollama_error(resp, model)
             async for line in resp.aiter_lines():
                 if not line.strip():
                     continue
@@ -204,7 +252,7 @@ async def stream_chat_with_tools(
         "stream": True,
         "options": options,
         "think": think,
-        "keep_alive": "2h",
+        "keep_alive": keep_alive_for(model),
     }
     if tools:
         payload["tools"] = tools
@@ -215,22 +263,33 @@ async def stream_chat_with_tools(
             f"{Config.OLLAMA_URL}/api/chat",
             json=payload,
         ) as resp:
-            resp.raise_for_status()
+            await _raise_ollama_error(resp, model)
             accumulated_tool_calls: list[dict] = []
+            # Silent-generation diagnostic: if Ollama reports non-zero eval_count
+            # but we never yielded any thinking/content/tool_calls, something
+            # in the frames isn't landing in a field we read. Capture the last
+            # few frames so we can see what Ollama actually sent.
+            yielded_anything = False
+            recent_frames: list[str] = []
             async for line in resp.aiter_lines():
                 if not line.strip():
                     continue
+                if len(recent_frames) >= 5:
+                    recent_frames.pop(0)
+                recent_frames.append(line[:500])
                 data = json.loads(line)
                 msg = data.get("message", {})
 
                 # Thinking chunks (qwen3 chain-of-thought, only when think=True)
                 thinking = msg.get("thinking", "")
                 if thinking:
+                    yielded_anything = True
                     yield ChatChunk(type="thinking", content=thinking)
 
                 # Content chunks
                 chunk = msg.get("content", "")
                 if chunk:
+                    yielded_anything = True
                     yield ChatChunk(type="content", content=chunk)
 
                 # Collect tool calls from any message (some models
@@ -246,13 +305,21 @@ async def stream_chat_with_tools(
                             len(accumulated_tool_calls),
                             json.dumps(accumulated_tool_calls)[:500],
                         )
+                        yielded_anything = True
                         yield ChatChunk(type="tool_calls", tool_calls=accumulated_tool_calls)
                     else:
                         logger.debug("Ollama done with no tool calls")
+                    eval_count = data.get("eval_count") or 0
+                    if not yielded_anything and eval_count > 0:
+                        logger.warning(
+                            "Ollama silent generation: model=%s eval_count=%d but no "
+                            "thinking/content/tool_calls were yielded. Last frames: %s",
+                            model, eval_count, recent_frames,
+                        )
                     yield ChatChunk(
                         type="done",
                         prompt_tokens=data.get("prompt_eval_count"),
-                        output_tokens=data.get("eval_count"),
+                        output_tokens=eval_count,
                     )
                     break
 
@@ -269,9 +336,17 @@ async def generate_completion(
     num_ctx overrides the model's context window for this call only.
     """
     last_exc: Exception | None = None
-    options: dict = {"num_predict": max_tokens}
-    if num_ctx is not None:
-        options["num_ctx"] = num_ctx
+    # Default num_ctx to Config.OLLAMA_NUM_CTX (matching stream_chat /
+    # stream_chat_with_tools). Without this, Ollama silently uses the model's
+    # default window (~4k on qwen3) and truncates anything longer. That is
+    # how the research pipeline's outline step kept falling back to a single
+    # monolith note: its 12-source prompt is ~6k tokens and was being chopped
+    # before the model ever saw it. Non-streaming callers must not inherit
+    # that footgun — if you truly want the model default, pass num_ctx=0.
+    options: dict = {
+        "num_predict": max_tokens,
+        "num_ctx": num_ctx if num_ctx is not None else Config.OLLAMA_NUM_CTX,
+    }
     for attempt in range(3):
         if attempt > 0:
             delay = 3.0 * attempt
@@ -289,7 +364,7 @@ async def generate_completion(
                         "stream": False,
                         "think": False,
                         "options": options,
-                        "keep_alive": "2h",
+                        "keep_alive": keep_alive_for(model),
                     },
                 )
                 resp.raise_for_status()
@@ -498,6 +573,34 @@ async def build_context(
     """
     exclude_set = set(exclude_note_ids or [])
     from datetime import date as date_type
+
+    # --- Journal short-circuit ---
+    # Journal conversations get a different persona, calibration, and an
+    # ambient-moments context block. CRUCIALLY, no notes-RAG injection here
+    # (preserves the notes/journal isolation invariant).
+    if conv_id is not None:
+        from fabledassistant.models import async_session as _async_session
+        from fabledassistant.models.conversation import Conversation as _Conversation
+        async with _async_session() as _sess:
+            _conv = await _sess.get(_Conversation, conv_id)
+        if _conv and getattr(_conv, "conversation_type", None) == "journal":
+            from fabledassistant.services.journal_pipeline import build_journal_system_prompt
+            day_date = _conv.day_date or date_type.today()
+            system_content = await build_journal_system_prompt(
+                user_id=user_id,
+                day_date=day_date,
+                user_timezone=user_timezone or "UTC",
+            )
+            messages_out: list[dict] = [{"role": "system", "content": system_content}]
+            messages_out.extend(history)
+            messages_out.append({"role": "user", "content": user_message})
+            return messages_out, {
+                "context_note_id": None,
+                "context_note_title": None,
+                "auto_notes": [],
+                "auto_injected_notes": [],
+            }
+
     assistant_name = await get_setting(user_id, "assistant_name", "Fable")
     today = date_type.today().isoformat()
     has_caldav = await is_caldav_configured(user_id)
@@ -510,18 +613,29 @@ async def build_context(
     tool_lines = [
         "You have access to tool functions. You MUST use them when the user asks you to create, add, find, schedule, or search for anything.",
         "CRITICAL: Call the tool functions directly. NEVER write out function calls as text or code. NEVER describe what you would do — just do it.",
-        "Available actions: create_task, create_note, update_note, delete_note, delete_task, get_note, list_notes, list_tasks, search_notes.",
+        "GROUNDING: When the user asks about their own data — tasks, notes, events, projects, news, anything stored in this system — call the relevant tool to see what actually exists before answering. Never assert facts about the user's data from memory, prior context, or assumption. If you are unsure whether something exists, check with a tool.",
+        "HONESTY WHEN EMPTY: If a tool returns empty results (no matching tasks, no events in the date range, no search hits, no notes found), tell the user plainly that nothing matched. Do not fabricate example items, do not invent plausible-sounding meetings or deadlines to fill the response, and do not hedge with generic suggestions dressed up as real data. A direct 'you don't have anything on your calendar today' is always better than an invented event.",
+    ]
+    actions = [
+        "create_note (also creates tasks — set status='todo')", "update_note", "delete_note",
+        "read_note", "list_notes", "list_tasks", "log_work", "search_notes",
+        "create_project", "list_projects", "get_project", "update_project",
+        "search_projects", "create_milestone", "update_milestone", "list_milestones",
+        "save_person", "save_place", "create_list", "add_to_list", "clear_checked_items",
+        "set_rag_scope", "get_profile", "update_profile", "get_weather", "calculate",
+        "read_article",
     ]
     if has_caldav:
-        tool_lines[-1] = (
-            "Available actions: create_task, create_note, update_note, delete_note, delete_task, get_note, list_notes, list_tasks, search_notes, "
-            "create_event, list_events, search_events, update_event, delete_event, list_calendars."
-        )
+        actions.extend(["create_event", "list_events", "search_events", "update_event", "delete_event", "list_calendars"])
         tool_lines.append(
             "For calendar events, use ISO 8601 datetime format with the user's timezone offset (stated in context below). "
             "Always include the UTC offset in datetime strings (e.g. 2026-09-30T14:00:00+01:00)."
         )
         tool_lines.append("When the user says 'remind me' with a time before an event, use the reminder_minutes parameter.")
+    actions.append("lookup")
+    if Config.searxng_enabled():
+        actions.extend(["research_topic", "search_images"])
+    tool_lines.append(f"Available actions: {', '.join(actions)}.")
     tool_lines.append(
         "For relative dates like 'Friday' or 'next week', resolve them to YYYY-MM-DD format. "
         "Always include the UTC offset when creating events (user's timezone is stated in context below)."
@@ -546,7 +660,7 @@ async def build_context(
     tool_guidance = "\n".join(tool_lines)
 
     static_block = (
-        f"You are a helpful assistant named {assistant_name}, integrated into a note-taking and task-tracking app called Fabled Assistant. "
+        f"You are a helpful assistant named {assistant_name}, integrated into a note-taking and task-tracking app called Fabled Scribe. "
         "Help users with their notes, tasks, and general questions. "
         "When note context is provided, use it to give relevant answers.\n\n"
         f"{tool_guidance}"
@@ -569,8 +683,8 @@ async def build_context(
     # --- System message: stable content only ---
     # Workspace context and history summary stay here because they carry
     # behavioural instructions / conversational state, not retrieved content.
-    # Everything retrieval-based (RAG notes, RSS, URL content, current note,
-    # briefing articles) goes into the user turn below so the system message
+    # Everything retrieval-based (RAG notes, URL content, current note)
+    # goes into the user turn below so the system message
     # prefix stays byte-for-byte identical across requests, enabling Ollama's
     # KV prefix cache to fire reliably.
 
@@ -600,7 +714,7 @@ async def build_context(
                     f"\n\n--- Active Workspace ---\n"
                     f"You are in the \"{wp.title}\" project workspace.\n"
                     f"All notes and tasks you create or update MUST belong to this project.\n"
-                    f"Always pass project=\"{wp.title}\" when calling create_note or create_task.\n"
+                    f"Always pass project=\"{wp.title}\" when calling create_note.\n"
                     f"--- End Active Workspace ---"
                 )
         except Exception:
@@ -612,25 +726,6 @@ async def build_context(
             f"\n\n--- Earlier Conversation ---\n{history_summary}\n--- End Earlier Conversation ---"
         )
 
-    # Detect briefing conversation — used for both system prompt instruction and article injection
-    _is_briefing_conv = False
-    if conv_id is not None:
-        from fabledassistant.models import async_session as _async_session
-        from fabledassistant.models.conversation import Conversation as _Conversation
-        async with _async_session() as _sess:
-            _conv = await _sess.get(_Conversation, conv_id)
-        if _conv and getattr(_conv, "conversation_type", None) == "briefing":
-            _is_briefing_conv = True
-
-    if _is_briefing_conv:
-        system_content += (
-            "\n\nYou are in a briefing conversation. "
-            "The conversation history contains today's briefing — news stories, weather, and tasks. "
-            "When the user asks about a topic, person, or event from the briefing, answer directly "
-            "from the conversation history and the article context that follows. "
-            "Do NOT search the web for information that is already present in the briefing."
-        )
-
     context_meta: dict = {
         "context_note_id": None,
         "context_note_title": None,
@@ -716,6 +811,8 @@ async def build_context(
                 "score": round(score, 2),
             })
         user_context_parts.append(
+            "[The following are reference excerpts from the user's personal notes, "
+            "not part of their message. Use them only if relevant to answering.]\n"
             "--- Relevant Notes ---\n"
             + "\n\n".join(snippets)
             + "\n--- End Relevant Notes ---"
@@ -756,33 +853,6 @@ async def build_context(
                 + "\n--- End Included Notes ---"
             )
 
-    # Semantically relevant RSS news items
-    try:
-        from fabledassistant.services.embeddings import get_embedding, semantic_search_rss_items
-        news_query_vec = await get_embedding(user_message)
-        news_hits = await semantic_search_rss_items(user_id, news_query_vec)
-        if news_hits:
-            news_snippets = []
-            for score, rss_item in news_hits:
-                feed_title = getattr(rss_item, "feed_title", "") or ""
-                excerpt = (rss_item.content or "")[:500].strip()
-                news_snippets.append(
-                    f"[{feed_title or 'News'}] {rss_item.title} (relevance: {round(score * 100)}%)\n"
-                    + (f"{excerpt}\n" if excerpt else "")
-                    + f"URL: {rss_item.url}"
-                )
-            user_context_parts.append(
-                "--- Recent News You've Seen ---\n"
-                + "\n\n".join(news_snippets)
-                + "\n--- End Recent News ---"
-            )
-            context_meta["rss_news"] = [
-                {"id": item.id, "title": item.title, "score": round(score, 2)}
-                for score, item in news_hits
-            ]
-    except Exception:
-        logger.debug("RSS semantic search skipped", exc_info=True)
-
     # URL content fetched from links in the user message
     urls = _find_urls(user_message)
     for url in urls[:2]:
@@ -792,12 +862,6 @@ async def build_context(
                 f"--- Content from {url} ---\n{content}\n--- End URL Content ---"
             )
 
-    # Briefing article context for follow-up Q&A
-    if _is_briefing_conv:
-        article_context = await _build_briefing_article_context(conv_id)  # type: ignore[arg-type]
-        if article_context:
-            user_context_parts.append(article_context.strip())
-
     # Build final user message — context prefix (if any) followed by the actual message
     if user_context_parts:
         user_turn = "\n\n".join(user_context_parts) + "\n\n" + user_message
@@ -808,72 +872,3 @@ async def build_context(
     messages.extend(history)
     messages.append({"role": "user", "content": user_turn})
     return messages, context_meta
-
-
-async def _build_briefing_article_context(conv_id: int) -> str:
-    """Fetch article content from today's briefing message and return a
-    formatted context block for injection into the system prompt.
-
-    Looks at the most recent assistant briefing messages for rss_item_ids
-    in their metadata, then loads those items from the DB.
-    Capped at 10 articles × 500 chars to keep token use reasonable.
-    """
-    import json as _json
-
-    from sqlalchemy import select, text as _text
-
-    from fabledassistant.models import async_session as _async_session
-    from fabledassistant.models.conversation import Message
-
-    async with _async_session() as session:
-        result = await session.execute(
-            select(Message)
-            .where(
-                Message.conversation_id == conv_id,
-                Message.role == "assistant",
-            )
-            .order_by(Message.created_at.desc())
-            .limit(10)
-        )
-        messages = result.scalars().all()
-
-    rss_item_ids: list[int] = []
-    for msg in messages:
-        meta = msg.msg_metadata or {}
-        if isinstance(meta, str):
-            try:
-                meta = _json.loads(meta)
-            except Exception:
-                continue
-        ids = meta.get("rss_item_ids") or []
-        if ids:
-            rss_item_ids = ids
-            break
-
-    if not rss_item_ids:
-        return ""
-
-    async with _async_session() as session:
-        result = await session.execute(
-            _text("""
-                SELECT i.title, i.url, i.content, f.title AS feed_title
-                FROM rss_items i
-                JOIN rss_feeds f ON f.id = i.feed_id
-                WHERE i.id = ANY(:ids)
-                ORDER BY i.published_at DESC NULLS LAST
-                LIMIT 10
-            """).bindparams(ids=rss_item_ids[:10])
-        )
-        rows = result.mappings().all()
-
-    if not rows:
-        return ""
-
-    lines = ["\n\nARTICLE CONTEXT (source articles from today's briefing):"]
-    for row in rows:
-        lines.append(f"\n[{row['feed_title']}] {row['title']}")
-        if row["url"]:
-            lines.append(f"URL: {row['url']}")
-        if row["content"]:
-            lines.append(row["content"][:500])
-    return "\n".join(lines)

src/fabledassistant/services/moments.py

@@ -0,0 +1,185 @@
+"""Moment CRUD, entity linking, and embedding sync.
+
+Moments are small structured extractions from journal conversations.
+Stored separately from Notes — they have their own embedding index and
+the isolation between notes-RAG and journal-RAG is enforced at the API
+boundary, not just the schema.
+"""
+from __future__ import annotations
+
+import datetime
+from typing import Sequence
+
+from sqlalchemy import delete, select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from fabledassistant.models import (
+    Moment,
+    MomentEmbedding,
+    async_session,
+    moment_notes,
+    moment_people,
+    moment_places,
+    moment_tasks,
+)
+from fabledassistant.services.embeddings import get_embedding
+
+
+async def create_moment(
+    *,
+    user_id: int,
+    content: str,
+    occurred_at: datetime.datetime,
+    day_date: datetime.date,
+    conversation_id: int | None = None,
+    source_message_id: int | None = None,
+    raw_excerpt: str | None = None,
+    tags: Sequence[str] = (),
+    person_ids: Sequence[int] = (),
+    place_ids: Sequence[int] = (),
+    task_ids: Sequence[int] = (),
+    note_ids: Sequence[int] = (),
+) -> Moment:
+    """Insert a Moment, write its embedding, create junction rows."""
+    async with async_session() as session:
+        moment = Moment(
+            user_id=user_id,
+            conversation_id=conversation_id,
+            source_message_id=source_message_id,
+            day_date=day_date,
+            occurred_at=occurred_at,
+            content=content,
+            raw_excerpt=raw_excerpt,
+            tags=list(tags),
+        )
+        session.add(moment)
+        await session.flush()
+
+        await _set_links(
+            session,
+            moment_id=moment.id,
+            person_ids=person_ids,
+            place_ids=place_ids,
+            task_ids=task_ids,
+            note_ids=note_ids,
+        )
+
+        embedding_vector = await get_embedding(content)
+        session.add(
+            MomentEmbedding(
+                moment_id=moment.id,
+                user_id=user_id,
+                embedding=embedding_vector,
+            )
+        )
+
+        await session.commit()
+        await session.refresh(moment, ["people", "places", "tasks", "notes"])
+        return moment
+
+
+async def get_moment(*, user_id: int, moment_id: int) -> Moment | None:
+    async with async_session() as session:
+        result = await session.execute(
+            select(Moment).where(Moment.id == moment_id, Moment.user_id == user_id)
+        )
+        return result.scalar_one_or_none()
+
+
+async def update_moment(
+    *,
+    user_id: int,
+    moment_id: int,
+    content: str | None = None,
+    tags: Sequence[str] | None = None,
+    pinned: bool | None = None,
+    person_ids: Sequence[int] | None = None,
+    place_ids: Sequence[int] | None = None,
+    task_ids: Sequence[int] | None = None,
+    note_ids: Sequence[int] | None = None,
+) -> Moment | None:
+    """Update fields and (optionally) replace junction sets.
+
+    None for a junction parameter ⇒ leave unchanged. Empty sequence ⇒ clear.
+    Mirrors the Notes update convention.
+    """
+    async with async_session() as session:
+        result = await session.execute(
+            select(Moment).where(Moment.id == moment_id, Moment.user_id == user_id)
+        )
+        moment = result.scalar_one_or_none()
+        if moment is None:
+            return None
+
+        if content is not None:
+            moment.content = content
+            embedding_vector = await get_embedding(content)
+            await session.execute(
+                delete(MomentEmbedding).where(MomentEmbedding.moment_id == moment_id)
+            )
+            session.add(
+                MomentEmbedding(
+                    moment_id=moment_id,
+                    user_id=user_id,
+                    embedding=embedding_vector,
+                )
+            )
+        if tags is not None:
+            moment.tags = list(tags)
+        if pinned is not None:
+            moment.pinned = pinned
+
+        await _set_links(
+            session,
+            moment_id=moment_id,
+            person_ids=person_ids,
+            place_ids=place_ids,
+            task_ids=task_ids,
+            note_ids=note_ids,
+        )
+
+        await session.commit()
+        await session.refresh(moment, ["people", "places", "tasks", "notes"])
+        return moment
+
+
+async def delete_moment(*, user_id: int, moment_id: int) -> bool:
+    async with async_session() as session:
+        result = await session.execute(
+            select(Moment).where(Moment.id == moment_id, Moment.user_id == user_id)
+        )
+        moment = result.scalar_one_or_none()
+        if moment is None:
+            return False
+        await session.delete(moment)
+        await session.commit()
+        return True
+
+
+async def _set_links(
+    session: AsyncSession,
+    *,
+    moment_id: int,
+    person_ids: Sequence[int] | None,
+    place_ids: Sequence[int] | None,
+    task_ids: Sequence[int] | None,
+    note_ids: Sequence[int] | None,
+) -> None:
+    """Replace junction-table rows.
+
+    None ⇒ leave existing rows alone. Empty sequence ⇒ clear all rows.
+    """
+    for ids, table, fk_col in [
+        (person_ids, moment_people, "person_id"),
+        (place_ids, moment_places, "place_id"),
+        (task_ids, moment_tasks, "task_id"),
+        (note_ids, moment_notes, "note_id"),
+    ]:
+        if ids is None:
+            continue
+        await session.execute(delete(table).where(table.c.moment_id == moment_id))
+        if ids:
+            await session.execute(
+                table.insert(),
+                [{"moment_id": moment_id, fk_col: i} for i in ids],
+            )

src/fabledassistant/services/notes.py

@@ -136,6 +136,7 @@ async def list_notes(
     milestone_ids: list[int] | None = None,
     parent_id: int | None = None,
     no_project: bool = False,
+    exclude_paused_projects: bool = False,
     sort: str = "updated_at",
     order: str = "desc",
     limit: int = 50,
@@ -211,6 +212,17 @@ async def list_notes(
             query = query.where(Note.project_id.is_(None))
             count_query = count_query.where(Note.project_id.is_(None))
 
+        if exclude_paused_projects:
+            from fabledassistant.models.project import Project
+            paused_ids = (
+                select(Project.id)
+                .where(Project.user_id == user_id, Project.status == "paused")
+                .scalar_subquery()
+            )
+            paused_filter = or_(Note.project_id.is_(None), Note.project_id.not_in(paused_ids))
+            query = query.where(paused_filter)
+            count_query = count_query.where(paused_filter)
+
         sort_col = getattr(Note, sort, Note.updated_at)
         if order == "asc":
             query = query.order_by(sort_col.asc())

src/fabledassistant/services/notifications.py

@@ -91,7 +91,7 @@ async def notify_security_event(
             </table>
             <p style="margin:16px 0 0;color:#9ca3af;font-size:12px;">If this wasn't you, change your password immediately.</p>
         """
-        await send_email(email, f"Fabled Assistant - {label}", _email_html("Security Alert", body))
+        await send_email(email, f"Fabled Scribe - {label}", _email_html("Security Alert", body))
     except Exception:
         logger.exception("Failed to send security notification for user %d", user_id)
 
@@ -113,7 +113,7 @@ async def send_password_reset_email(email: str, reset_url: str) -> None:
         <p style="margin:0;color:#9ca3af;font-size:12px;">If the button doesn't work, copy and paste this link:</p>
         <p style="margin:4px 0 0;color:#9ca3af;font-size:12px;word-break:break-all;">{reset_url}</p>
     """
-    await send_email(email, "Fabled Assistant - Password Reset", _email_html("Password Reset", body))
+    await send_email(email, "Fabled Scribe - Password Reset", _email_html("Password Reset", body))
 
 
 async def send_password_reset_success_email(email: str) -> None:
@@ -125,14 +125,14 @@ async def send_password_reset_success_email(email: str) -> None:
         </p>
         <p style="margin:0;color:#6b7280;font-size:13px;">If you didn't make this change, please contact your administrator immediately.</p>
     """
-    await send_email(email, "Fabled Assistant - Password Changed", _email_html("Password Changed", body))
+    await send_email(email, "Fabled Scribe - Password Changed", _email_html("Password Changed", body))
 
 
 async def send_invitation_email(email: str, invite_url: str, invited_by_username: str) -> None:
     """Send a branded invitation email with a registration link."""
     body = f"""
         <p style="margin:0 0 16px;color:#374151;font-size:15px;">
-            <strong>{invited_by_username}</strong> has invited you to join Fabled Assistant.
+            <strong>{invited_by_username}</strong> has invited you to join Fabled Scribe.
             Click the button below to create your account.
         </p>
         <div style="text-align:center;margin:24px 0;">
@@ -146,7 +146,7 @@ async def send_invitation_email(email: str, invite_url: str, invited_by_username
         <p style="margin:0;color:#9ca3af;font-size:12px;">If the button doesn't work, copy and paste this link:</p>
         <p style="margin:4px 0 0;color:#9ca3af;font-size:12px;word-break:break-all;">{invite_url}</p>
     """
-    await send_email(email, "Fabled Assistant - You're Invited!", _email_html("You're Invited!", body))
+    await send_email(email, "Fabled Scribe - You're Invited!", _email_html("You're Invited!", body))
 
 
 async def check_due_tasks() -> None:
@@ -225,7 +225,7 @@ async def check_due_tasks() -> None:
                         {task_rows}
                     </table>
                 """
-                await send_email(email, f"Fabled Assistant - {len(user_tasks)} Task(s) Due", _email_html("Task Reminders", body))
+                await send_email(email, f"Fabled Scribe - {len(user_tasks)} Task(s) Due", _email_html("Task Reminders", body))
                 await log_audit(
                     "task_reminder",
                     user_id=user_id,

src/fabledassistant/services/projects.py

@@ -141,13 +141,30 @@ async def generate_project_summary(user_id: int, project_id: int) -> None:
         logger.debug("Failed to generate summary for project %d", project_id, exc_info=True)
 
 
+# Cutoff: summaries older than this were generated by qwen2.5:3b, which
+# produced broken output (token repetition, hallucinated topics, misspellings).
+# Anything stamped before the switch to gemma3:4b on 2026-04-12 gets
+# regenerated at startup so the whole project list ends up on the better model.
+_BACKGROUND_MODEL_CUTOVER = datetime(2026, 4, 12, tzinfo=timezone.utc)
+
+
 async def backfill_project_summaries() -> None:
-    """Generate summaries for all projects missing auto_summary. Fire-and-forget."""
+    """Generate summaries for projects missing or predating the gemma3:4b cutover.
+
+    Fire-and-forget: each summary runs as its own background task.
+    """
     import asyncio
+    from sqlalchemy import or_
     try:
         async with async_session() as session:
             rows = (await session.execute(
-                select(Project.id, Project.user_id).where(Project.auto_summary.is_(None))
+                select(Project.id, Project.user_id).where(
+                    or_(
+                        Project.auto_summary.is_(None),
+                        Project.summary_updated_at.is_(None),
+                        Project.summary_updated_at < _BACKGROUND_MODEL_CUTOVER,
+                    )
+                )
             )).all()
         for row in rows:
             asyncio.create_task(generate_project_summary(row.user_id, row.id))

src/fabledassistant/services/research.py

@@ -9,7 +9,8 @@ import httpx
 
 from fabledassistant.config import Config
 from fabledassistant.services.llm import fetch_url_content, generate_completion, stream_chat
-from fabledassistant.services.notes import create_note
+from fabledassistant.services.notes import create_note, update_note
+from fabledassistant.services.wikipedia import wiki_search
 from fabledassistant.models.note import Note
 
 logger = logging.getLogger(__name__)
@@ -35,8 +36,8 @@ def _build_sources_block(sources: list[dict]) -> str:
 async def _generate_outline(topic: str, sources: list[dict], model: str) -> list[dict]:
     """Generate a topic outline from fetched research sources.
 
-    Returns a list of {"title": str, "focus": str} dicts (3–8 entries).
-    Returns [] on failure — callers must fall back to single-note synthesis.
+    Returns a list of {"title": str, "focus": str} dicts (2–8 entries).
+    Retries once on failure before returning [] (callers fall back to single-note).
     """
     import json as _json
 
@@ -61,23 +62,37 @@ async def _generate_outline(topic: str, sources: list[dict], model: str) -> list
             "content": f"Topic: {topic}\n\nSources:\n{sources_block}",
         },
     ]
-    try:
-        raw = await generate_completion(messages, model, max_tokens=400)
-        raw = raw.strip()
-        raw = re.sub(r"^```(?:json)?\s*", "", raw)
-        raw = re.sub(r"\s*```$", "", raw)
-        idx = raw.find("[")
-        if idx >= 0:
-            parsed, _ = _json.JSONDecoder().raw_decode(raw[idx:])
-            if isinstance(parsed, list):
-                sections = [
-                    s for s in parsed
-                    if isinstance(s, dict) and s.get("title") and s.get("focus")
-                ]
-                if len(sections) >= 3:
-                    return sections[:8]
-    except Exception:
-        logger.warning("Outline generation failed for topic '%s'", topic, exc_info=True)
+    for attempt in range(2):
+        try:
+            # Pin num_ctx explicitly. The prompt carries up to 12 sources at
+            # 2000 chars each (~6k tokens of source material alone) plus the
+            # system prompt — well over Ollama's default model window on
+            # qwen3. Without this, Ollama silently truncates the prompt, the
+            # model can't see most of the sources, JSON parsing fails twice,
+            # and the pipeline falls back to a single monolith note
+            # (`research.py:251`). Do not remove even if `generate_completion`
+            # appears to default this — see the comment there.
+            raw = await generate_completion(
+                messages, model, max_tokens=400, num_ctx=16384
+            )
+            raw = raw.strip()
+            raw = re.sub(r"^```(?:json)?\s*", "", raw)
+            raw = re.sub(r"\s*```$", "", raw)
+            idx = raw.find("[")
+            if idx >= 0:
+                parsed, _ = _json.JSONDecoder().raw_decode(raw[idx:])
+                if isinstance(parsed, list):
+                    sections = [
+                        s for s in parsed
+                        if isinstance(s, dict) and s.get("title") and s.get("focus")
+                    ]
+                    if len(sections) >= 2:
+                        return sections[:8]
+        except Exception:
+            logger.warning(
+                "Outline generation attempt %d failed for topic '%s'",
+                attempt + 1, topic, exc_info=True,
+            )
     return []
 
 
@@ -121,6 +136,55 @@ async def _synthesize_section(
     return section_title, raw.strip()
 
 
+async def _generate_executive_summary(
+    topic: str,
+    section_bodies: list[tuple[str, str]],
+    model: str,
+) -> str:
+    """Generate a 2-3 paragraph executive summary from completed section notes.
+
+    Args:
+        section_bodies: list of (title, body) pairs from the section notes.
+
+    Returns summary markdown (no heading — caller adds structure).
+    """
+    sections_block = "\n\n".join(
+        f"### {title}\n{body[:1500]}" for title, body in section_bodies
+    )
+    messages = [
+        {
+            "role": "system",
+            "content": (
+                "You are a research summarizer. Given several completed research sections on a topic, "
+                "write a concise executive summary.\n\n"
+                "Requirements:\n"
+                "- 2–3 paragraphs of substantive prose (150–300 words total)\n"
+                "- Cover the key findings and insights across all sections\n"
+                "- Highlight the most important or surprising takeaways\n"
+                "- Write so someone can decide which sections to read in detail\n"
+                "- Do NOT include headings, bullet points, or source citations\n"
+                "- Do NOT start with 'This research' or 'This document' — jump straight into the content"
+            ),
+        },
+        {
+            "role": "user",
+            "content": f"Topic: {topic}\n\nSections:\n{sections_block}",
+        },
+    ]
+    try:
+        # Pin num_ctx explicitly — see `_generate_outline` comment for the
+        # rationale. This prompt carries N sections × 1500 chars of section
+        # prose, which can easily exceed the default model window. Don't
+        # trust the `generate_completion` default to stick.
+        raw = await generate_completion(
+            messages, model, max_tokens=600, num_ctx=16384
+        )
+        return raw.strip()
+    except Exception:
+        logger.warning("Executive summary generation failed for '%s'", topic, exc_info=True)
+        return ""
+
+
 async def run_research_pipeline(
     topic: str,
     user_id: int,
@@ -142,7 +206,7 @@ async def run_research_pipeline(
     queries = await _generate_sub_queries(topic, model)
     logger.info("Research: generated %d sub-queries for topic '%s'", len(queries), topic)
 
-    # Step 2: Search all queries in parallel (200 ms stagger to avoid hammering SearXNG)
+    # Step 2: Search all queries in parallel (SearXNG + Wikipedia)
     async def _search_with_stagger(i: int, query: str) -> tuple[str, list[dict]]:
         if i > 0:
             await asyncio.sleep(0.2 * i)
@@ -151,13 +215,22 @@ async def run_research_pipeline(
         logger.info("Research: query '%s' → %d results", query, len(results))
         return query, results
 
-    search_results = await asyncio.gather(
+    async def _wiki_for_query(query: str) -> list[dict]:
+        return await wiki_search(query, limit=1)
+
+    searxng_task = asyncio.gather(
         *[_search_with_stagger(i, q) for i, q in enumerate(queries)]
     )
+    wiki_task = asyncio.gather(
+        *[_wiki_for_query(q) for q in queries]
+    )
+    search_results, wiki_results = await asyncio.gather(searxng_task, wiki_task)
 
     # Deduplicate URLs across all queries
     seen_urls: set[str] = set()
     url_tasks: list[tuple[str, dict, str]] = []  # (url, result_dict, query)
+    wiki_sources: list[dict] = []  # Wikipedia articles (already have content)
+
     for query, results in search_results:
         for result in results[:PAGES_PER_QUERY]:
             url = result.get("url", "")
@@ -165,7 +238,21 @@ async def run_research_pipeline(
                 seen_urls.add(url)
                 url_tasks.append((url, result, query))
 
-    # Fetch all unique URLs in parallel
+    # Add Wikipedia results (they already have content via extract)
+    for query, wiki_hits in zip(queries, wiki_results):
+        for hit in wiki_hits:
+            url = hit.get("url", "")
+            if url and url not in seen_urls:
+                seen_urls.add(url)
+                wiki_sources.append({
+                    "url": url,
+                    "title": hit["title"],
+                    "query": query,
+                    "snippet": hit["extract"][:200],
+                    "content": hit["extract"],
+                })
+
+    # Fetch all unique SearXNG URLs in parallel
     async def _fetch_source(url: str, result: dict, query: str) -> dict:
         title = result.get("title", url)
         _status(f"Reading: {title[:60]}...")
@@ -178,10 +265,12 @@ async def run_research_pipeline(
             "content": content,
         }
 
-    all_sources: list[dict] = list(await asyncio.gather(
+    fetched_sources: list[dict] = list(await asyncio.gather(
         *[_fetch_source(url, result, query) for url, result, query in url_tasks]
     ))
 
+    all_sources = wiki_sources + fetched_sources
+
     if not all_sources:
         raise ValueError(f"No results found for '{topic}'")
 
@@ -220,28 +309,17 @@ async def run_research_pipeline(
         return_exceptions=True,
     )
 
-    # Step 5: Create section notes sequentially
-    _status(f"Saving {len(outline)} notes...")
-    section_note_pairs: list[tuple[dict, Note]] = []
+    # Collect successful results for index + summary generation
+    section_results: list[tuple[dict, str, str]] = []  # (outline_entry, title, body)
     for section, result in zip(outline, raw_results):
         if isinstance(result, Exception):
             logger.warning("Section synthesis failed for '%s': %s", section["title"], result)
             continue
         sec_title, sec_body = result
-        try:
-            note = await create_note(
-                user_id=user_id,
-                title=sec_title,
-                body=sec_body,
-                tags=["research"],
-                project_id=project_id,
-            )
-            section_note_pairs.append((section, note))
-        except Exception:
-            logger.warning("Failed to save section note '%s'", sec_title, exc_info=True)
+        section_results.append((section, sec_title, sec_body))
 
     # All sections failed — fall back to single note
-    if not section_note_pairs:
+    if not section_results:
         logger.warning("All section syntheses failed, falling back to single note for '%s'", topic)
         _status("Synthesizing report (fallback)...")
         title, body = await _synthesize_note(topic, synthesis_sources, model, buf=None)
@@ -250,20 +328,24 @@ async def run_research_pipeline(
         )
         return note
 
-    # Step 6: Create index note
+    # Step 5: Generate executive summary from section content
+    _status("Writing summary...")
+    executive_summary = await _generate_executive_summary(
+        topic, [(t, b) for _, t, b in section_results], model,
+    )
+
+    # Step 6: Create index note first (so section notes can reference it via parent_id)
     from datetime import date as _date
     index_lines = [
         f"Research overview for **{topic}** — {_date.today().isoformat()}",
         "",
-        f"Generated from {len(synthesis_sources)} web sources across {len(section_note_pairs)} sections.",
-        "",
-        "## Sections",
+        f"Generated from {len(synthesis_sources)} web sources across {len(section_results)} sections.",
         "",
     ]
-    for section, note in section_note_pairs:
-        index_lines.append(f"- **{note.title}** — {section['focus']}")
-    index_lines += ["", "*Search for any section title to read it.*"]
-
+    if executive_summary:
+        index_lines += ["## Summary", "", executive_summary, ""]
+    index_lines += ["## Sections", ""]
+    # Placeholder — will be updated with real links after section notes are created
     index_note = await create_note(
         user_id=user_id,
         title=f"Research: {topic}",
@@ -271,6 +353,34 @@ async def run_research_pipeline(
         tags=["research", "research-index"],
         project_id=project_id,
     )
+
+    # Step 7: Create section notes with parent_id pointing to index
+    _status(f"Saving {len(section_results)} notes...")
+    section_note_pairs: list[tuple[dict, Note]] = []
+    for section, sec_title, sec_body in section_results:
+        try:
+            note = await create_note(
+                user_id=user_id,
+                title=sec_title,
+                body=sec_body,
+                tags=["research"],
+                project_id=project_id,
+                parent_id=index_note.id,
+            )
+            section_note_pairs.append((section, note))
+        except Exception:
+            logger.warning("Failed to save section note '%s'", sec_title, exc_info=True)
+
+    # Step 8: Update index note body with real links to section notes
+    for section, note in section_note_pairs:
+        index_lines.append(f"- [{note.title}](/notes/{note.id}) — {section['focus']}")
+
+    await update_note(
+        user_id=user_id,
+        note_id=index_note.id,
+        body="\n".join(index_lines),
+    )
+
     logger.info(
         "Research: created %d section notes + index id=%d for topic '%s'",
         len(section_note_pairs), index_note.id, topic,

src/fabledassistant/services/rss.py

@@ -1,284 +0,0 @@
-"""RSS feed service: fetch, parse with feedparser, and cache items to DB."""
-
-import asyncio
-import logging
-from datetime import datetime, timezone
-
-import feedparser
-import html2text
-import httpx
-from sqlalchemy import select, text
-
-from fabledassistant.models import async_session
-from fabledassistant.models.rss_feed import RssFeed, RssItem
-
-logger = logging.getLogger(__name__)
-
-# Keep only items from the last N days to avoid unbounded growth
-ITEM_MAX_AGE_DAYS = 90
-
-_h2t = html2text.HTML2Text()
-_h2t.ignore_links = True
-_h2t.ignore_images = True
-_h2t.ignore_emphasis = False
-_h2t.body_width = 0  # No line-wrapping
-
-
-def _html_to_text(html: str) -> str:
-    """Convert HTML to clean plain text via html2text."""
-    if not html or "<" not in html:
-        return html
-    try:
-        return _h2t.handle(html).strip()
-    except Exception:
-        return html
-
-
-async def _fetch_full_article(url: str) -> str | None:
-    """Fetch a URL and extract its main article text via trafilatura.
-
-    Returns clean plain text, or None if extraction fails or yields nothing useful.
-    Runs trafilatura in a thread executor since it does synchronous HTML parsing.
-    """
-    try:
-        async with httpx.AsyncClient(timeout=15.0, follow_redirects=True, headers={
-            "User-Agent": "Mozilla/5.0 (compatible; FabledAssistant/1.0; +https://fabledsword.com)",
-        }) as client:
-            resp = await client.get(url)
-            resp.raise_for_status()
-            raw_html = resp.text
-    except Exception:
-        logger.debug("Failed to fetch article URL %s", url)
-        return None
-
-    loop = asyncio.get_event_loop()
-    try:
-        import trafilatura
-        text = await loop.run_in_executor(
-            None,
-            lambda: trafilatura.extract(
-                raw_html,
-                include_comments=False,
-                include_tables=True,
-                favor_recall=True,
-            ),
-        )
-        return text or None
-    except Exception:
-        logger.debug("trafilatura extraction failed for %s", url, exc_info=True)
-        return None
-
-
-def extract_item(entry) -> dict:
-    """Extract a clean item dict from a feedparser entry object."""
-    # Prefer full content over summary (feedparser uses a list of Content objects)
-    content = ""
-    raw_content = getattr(entry, "content", None)
-    if isinstance(raw_content, list) and raw_content:
-        content = raw_content[0].value
-    else:
-        content = entry.get("summary", "")
-    content = _html_to_text(content)
-
-    pub = None
-    if entry.published_parsed:
-        try:
-            pub = datetime(*entry.published_parsed[:6], tzinfo=timezone.utc)
-        except Exception:
-            pass
-
-    return {
-        "guid": entry.get("id", entry.get("link", "")),
-        "title": entry.get("title", ""),
-        "url": entry.get("link", ""),
-        "content": content,
-        "published_at": pub,
-    }
-
-
-async def _parse_feed(url: str) -> feedparser.FeedParserDict:
-    """Run feedparser in a thread executor so we don't block the event loop."""
-    loop = asyncio.get_event_loop()
-    return await loop.run_in_executor(None, feedparser.parse, url)
-
-
-async def fetch_and_cache_feed(feed_id: int, url: str) -> int:
-    """
-    Fetch a feed URL, parse it, and upsert new items into rss_items.
-    Returns the number of new items stored.
-    """
-    scheme = url.split("://")[0].lower() if "://" in url else ""
-    if scheme not in ("http", "https"):
-        logger.warning("Blocked RSS fetch with non-http(s) scheme: %s", url[:80])
-        return 0
-    try:
-        parsed = await _parse_feed(url)
-    except Exception:
-        logger.warning("Failed to fetch RSS feed %s", url, exc_info=True)
-        return 0
-
-    if parsed.bozo and not parsed.entries:
-        logger.warning("Malformed RSS feed %s: %s", url, parsed.bozo_exception)
-        return 0
-
-    new_count = 0
-    feed_user_id: int | None = None
-
-    async with async_session() as session:
-        for entry in parsed.entries:
-            item_data = extract_item(entry)
-            if not item_data["guid"]:
-                continue
-            # Check if already stored
-            existing = await session.execute(
-                select(RssItem).where(
-                    RssItem.feed_id == feed_id,
-                    RssItem.guid == item_data["guid"],
-                )
-            )
-            if existing.scalars().first() is not None:
-                continue
-            item = RssItem(
-                feed_id=feed_id,
-                **item_data,
-            )
-            session.add(item)
-            new_count += 1
-
-        # Update last_fetched_at on the feed
-        feed_row = await session.get(RssFeed, feed_id)
-        if feed_row:
-            feed_row.last_fetched_at = datetime.now(timezone.utc)
-            feed_user_id = feed_row.user_id
-            # Auto-populate title from feed metadata if blank
-            if not feed_row.title and parsed.feed.get("title"):
-                feed_row.title = parsed.feed.title[:200]
-
-        await session.commit()
-
-        # Collect IDs of unclassified items after commit.
-        # We query classified_at IS NULL (not just the items inserted above) because
-        # classification is best-effort and may have failed on previous fetches.
-        # Re-queuing all unclassified items for this feed on each fetch is intentional:
-        # it provides automatic retry without a separate retry loop. The classifier
-        # only writes to items it successfully classifies, so already-classified items
-        # are not re-processed (they have classified_at set).
-        unclassified_ids: list[int] = []
-        new_item_data: list[tuple[int, str, str]] = []  # (id, title, content) for embedding
-        if new_count > 0:
-            result = await session.execute(
-                select(RssItem.id, RssItem.title, RssItem.content, RssItem.classified_at).where(
-                    RssItem.feed_id == feed_id,
-                )
-            )
-            for row in result.fetchall():
-                item_id, title, content, classified_at = row
-                if classified_at is None:
-                    unclassified_ids.append(item_id)
-                new_item_data.append((item_id, title or "", content or ""))
-
-    # Prune old items to keep DB tidy
-    await _prune_old_items(feed_id)
-
-    # Fire-and-forget classification for unclassified items
-    if unclassified_ids and feed_user_id is not None:
-        from fabledassistant.services.rss_classifier import classify_and_store
-        asyncio.create_task(classify_and_store(unclassified_ids, feed_user_id))
-
-    # Collect (id, url) for newly inserted items to enrich with full article text
-    new_items_for_enrichment: list[tuple[int, str]] = []
-    if new_count > 0:
-        async with async_session() as session:
-            result = await session.execute(
-                select(RssItem.id, RssItem.url).where(
-                    RssItem.feed_id == feed_id,
-                    RssItem.url != "",
-                ).order_by(RssItem.fetched_at.desc()).limit(new_count)
-            )
-            new_items_for_enrichment = list(result.fetchall())
-
-    # Fire-and-forget: fetch full article text, then re-embed with richer content
-    if new_items_for_enrichment and feed_user_id is not None:
-        from fabledassistant.services.embeddings import upsert_rss_item_embedding
-
-        async def _enrich_and_embed() -> None:
-            for item_id, article_url in new_items_for_enrichment:
-                full_text = await _fetch_full_article(article_url)
-                if full_text and len(full_text) > 200:
-                    async with async_session() as session:
-                        item = await session.get(RssItem, item_id)
-                        if item:
-                            item.content = full_text
-                            await session.commit()
-                            await upsert_rss_item_embedding(
-                                item_id, feed_user_id, item.title or "", item.content
-                            )
-                else:
-                    # Enrich failed — still embed with RSS-provided content
-                    async with async_session() as session:
-                        item = await session.get(RssItem, item_id)
-                    if item:
-                        await upsert_rss_item_embedding(
-                            item_id, feed_user_id, item.title or "", item.content or ""
-                        )
-                await asyncio.sleep(0.5)  # Polite pacing between article fetches
-
-        asyncio.create_task(_enrich_and_embed())
-    elif new_item_data and feed_user_id is not None:
-        # No URLs to enrich — embed with RSS content only
-        from fabledassistant.services.embeddings import upsert_rss_item_embedding
-
-        async def _embed_only() -> None:
-            for item_id, title, content in new_item_data:
-                await upsert_rss_item_embedding(item_id, feed_user_id, title, content)
-                await asyncio.sleep(0.05)
-
-        asyncio.create_task(_embed_only())
-
-    return new_count
-
-
-async def _prune_old_items(feed_id: int) -> None:
-    """Delete items older than ITEM_MAX_AGE_DAYS from a feed."""
-    async with async_session() as session:
-        await session.execute(
-            text("""
-                DELETE FROM rss_items
-                WHERE feed_id = :feed_id
-                  AND published_at < NOW() - INTERVAL '90 days'
-            """).bindparams(feed_id=feed_id)
-        )
-        await session.commit()
-
-
-async def get_recent_items(user_id: int, limit: int = 20) -> list[dict]:
-    """Return the most recent RSS items across all of a user's feeds."""
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssItem, RssFeed.title.label("feed_title"))
-            .join(RssFeed, RssItem.feed_id == RssFeed.id)
-            .where(RssFeed.user_id == user_id)
-            .order_by(RssItem.published_at.desc().nullslast())
-            .limit(limit)
-        )
-        rows = result.all()
-
-    return [
-        {**item.to_dict(), "feed_title": feed_title}
-        for item, feed_title in rows
-    ]
-
-
-async def refresh_all_feeds(user_id: int) -> dict[int, int]:
-    """Fetch all feeds for a user. Returns {feed_id: new_items_count}."""
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssFeed).where(RssFeed.user_id == user_id)
-        )
-        feeds = list(result.scalars().all())
-
-    results = {}
-    for feed in feeds:
-        count = await fetch_and_cache_feed(feed.id, feed.url)
-        results[feed.id] = count
-    return results

src/fabledassistant/services/rss_classifier.py

@@ -1,152 +0,0 @@
-"""
-RSS item topic classifier.
-
-Classifies RSS items into topic tags using a fast non-streaming LLM call.
-Called from rss.py after new items are stored — fire-and-forget.
-"""
-
-import json
-import logging
-import re
-from datetime import datetime, timezone
-
-import httpx
-
-from fabledassistant.config import Config
-
-logger = logging.getLogger(__name__)
-
-STANDARD_TOPICS = [
-    "technology", "science", "politics", "business",
-    "health", "environment", "local", "entertainment", "sports", "other",
-]
-
-_CLASSIFY_PROMPT = """\
-Classify each news item into 1-3 topics. Use only topics from this list: {vocab}.
-Return ONLY a JSON object mapping item_id (as string) to a list of topics.
-Example: {{"1": ["technology", "ai"], "2": ["politics"]}}
-
-Items:
-{items_block}"""
-
-
-async def _llm_classify(prompt: str, model: str) -> str:
-    """Make a fast non-streaming LLM call and return the raw text response."""
-    payload = {
-        "model": model,
-        "messages": [{"role": "user", "content": prompt}],
-        "stream": False,
-        "options": {"num_ctx": 2048, "temperature": 0.0},
-    }
-    async with httpx.AsyncClient(timeout=120.0) as client:
-        resp = await client.post(f"{Config.OLLAMA_URL}/api/chat", json=payload)
-        resp.raise_for_status()
-        return resp.json().get("message", {}).get("content", "")
-
-
-async def classify_items_batch(
-    items: list[dict],
-    user_include_topics: list[str],
-    model: str | None = None,
-) -> dict[int, list[str]]:
-    """
-    Classify a batch of RSS items into topic tags.
-
-    Args:
-        items: list of dicts with 'id', 'title', 'content'
-        user_include_topics: extra topics from user preferences to add to vocabulary
-        model: Ollama model name; defaults to Config.OLLAMA_MODEL
-
-    Returns:
-        dict mapping item_id (int) -> list of topic strings.
-        Items not returned had classification fail; callers should leave classified_at=NULL.
-    """
-    if not items:
-        return {}
-
-    if model is None:
-        model = Config.OLLAMA_BACKGROUND_MODEL
-
-    vocab = STANDARD_TOPICS + [t for t in user_include_topics if t not in STANDARD_TOPICS]
-    items_block = "\n".join(
-        f"[{item['id']}] {item['title']} — {item.get('content', '')[:300]}"
-        for item in items
-    )
-    prompt = _CLASSIFY_PROMPT.format(vocab=", ".join(vocab), items_block=items_block)
-
-    try:
-        raw = await _llm_classify(prompt, model)
-        # Strip <think>...</think> blocks emitted by reasoning models (e.g. qwen3)
-        raw = re.sub(r"<think>.*?</think>", "", raw, flags=re.DOTALL)
-        # Extract JSON from response (LLM may wrap it in markdown)
-        raw = raw.strip()
-        if raw.startswith("```"):
-            raw = raw.split("```")[1]
-            if raw.startswith("json"):
-                raw = raw[4:]
-        raw = raw.strip()
-        # Allow control characters that may appear in LLM-generated JSON strings
-        parsed = json.loads(raw, strict=False)
-        return {int(k): v for k, v in parsed.items() if isinstance(v, list)}
-    except Exception:
-        logger.warning("RSS classification failed", exc_info=True)
-        return {}
-
-
-async def classify_and_store(
-    item_ids: list[int],
-    user_id: int,
-) -> None:
-    """
-    Classify unclassified RSS items and write results to DB.
-    Called as a fire-and-forget task from rss.py.
-    """
-    from sqlalchemy import select
-
-    from fabledassistant.models import async_session
-    from fabledassistant.models.rss_feed import RssItem
-    from fabledassistant.services.settings import get_setting
-
-    if not item_ids:
-        return
-
-    # Load the items
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssItem).where(RssItem.id.in_(item_ids))
-        )
-        items = list(result.scalars().all())
-
-    if not items:
-        return
-
-    # Get user's include topics to extend vocabulary
-    raw_include = await get_setting(user_id, "briefing_include_topics", "[]")
-    try:
-        include_topics = json.loads(raw_include) if isinstance(raw_include, str) else []
-    except Exception:
-        include_topics = []
-
-    model = await get_setting(user_id, "background_model", Config.OLLAMA_BACKGROUND_MODEL)
-
-    # Classify in batches of 10
-    batch_size = 10
-    all_results: dict[int, list[str]] = {}
-    for i in range(0, len(items), batch_size):
-        batch = items[i: i + batch_size]
-        batch_dicts = [{"id": it.id, "title": it.title, "content": it.content} for it in batch]
-        results = await classify_items_batch(batch_dicts, include_topics, model=model)
-        all_results.update(results)
-
-    # Write back to DB
-    now = datetime.now(timezone.utc)
-    async with async_session() as session:
-        for item in items:
-            item_db = await session.get(RssItem, item.id)
-            if item_db is None:
-                continue
-            topics = all_results.get(item.id)
-            if topics is not None:
-                item_db.topics = topics
-                item_db.classified_at = now
-        await session.commit()

src/fabledassistant/services/tools/__init__.py

@@ -0,0 +1,32 @@
+"""Tool registry package.
+
+Importing this package loads all tool modules (triggering ``@tool``
+decorator registration) and re-exports the public API that the rest
+of the app depends on.
+"""
+
+# Import every tool module so their @tool decorators run at import time.
+# Order does not matter — registration is additive.
+from fabledassistant.services.tools import (  # noqa: F401
+    article,
+    calendar,
+    entities,
+    journal,
+    notes,
+    profile,
+    projects,
+    rag,
+    tasks,
+    utility,
+    weather,
+    web,
+)
+from fabledassistant.services.tools._registry import (
+    execute_tool,
+    get_tools_for_user,
+)
+
+__all__ = [
+    "execute_tool",
+    "get_tools_for_user",
+]

src/fabledassistant/services/tools/_helpers.py

@@ -0,0 +1,124 @@
+"""Shared utilities used across tool modules."""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+import re
+from datetime import date, datetime
+from difflib import SequenceMatcher
+
+logger = logging.getLogger(__name__)
+
+_PUNCT_RE = re.compile(r"[^\w\s]")
+
+
+def schedule_embedding(note_id: int, user_id: int, title: str, body: str) -> None:
+    """Fire-and-forget: update the embedding for a note after it's created/modified."""
+    from fabledassistant.services.embeddings import upsert_note_embedding
+
+    text = f"{title}\n{body}".strip() if body else (title or "")
+    if text:
+        asyncio.create_task(upsert_note_embedding(note_id, user_id, text))
+
+
+async def resolve_project(user_id: int, project_name: str):
+    """Exact-then-fuzzy project lookup. Returns the Project or None.
+
+    Resolution order:
+    1. Exact title match (case-insensitive via DB)
+    2. project_name is a substring of an existing title
+    3. Existing title is a substring of project_name
+    4. SequenceMatcher ratio >= 0.55
+    """
+    from fabledassistant.services.projects import get_project_by_title, list_projects
+
+    proj = await get_project_by_title(user_id, project_name)
+    if proj is not None:
+        return proj
+    needle = project_name.lower().strip()
+    all_p = await list_projects(user_id)
+    for p in all_p:
+        haystack = p.title.lower().strip()
+        if needle in haystack or haystack in needle:
+            return p
+    best, best_r = None, 0.0
+    for p in all_p:
+        r = SequenceMatcher(None, needle, p.title.lower().strip()).ratio()
+        if r >= 0.55 and r > best_r:
+            best, best_r = p, r
+    return best
+
+
+def parse_due_date(value: str | None) -> date | None:
+    """Parse a due date string, returning None on failure."""
+    if not value:
+        return None
+    try:
+        return datetime.strptime(value, "%Y-%m-%d").date()
+    except (ValueError, TypeError):
+        logger.warning("Invalid due_date format: %s", value)
+        return None
+
+
+def fuzzy_title_match(title: str, candidates, threshold: float = 0.82):
+    """Return (best_match, ratio) if any candidate's title is similar enough.
+
+    Uses SequenceMatcher ratio. Threshold 0.82 catches near-duplicates like
+    "Game Premise" / "Game Premise Notes" while leaving clearly different
+    titles alone. Returns (None, 0.0) when no candidate meets the threshold.
+    """
+    needle = title.lower().strip()
+    best, best_r = None, 0.0
+    for c in candidates:
+        r = SequenceMatcher(None, needle, c.title.lower().strip()).ratio()
+        if r >= threshold and r > best_r:
+            best, best_r = c, r
+    return best, best_r
+
+
+async def check_duplicate(
+    user_id: int,
+    title: str,
+    body: str,
+    is_task: bool,
+    confirmed: bool,
+) -> dict | None:
+    """Check for exact, fuzzy, and semantic duplicates. Returns error dict or None."""
+    from fabledassistant.services.notes import list_notes
+
+    item_label = "task" if is_task else "note"
+
+    existing, _ = await list_notes(user_id=user_id, q=title, is_task=is_task, limit=1)
+    exact = next((n for n in existing if n.title.lower() == title.lower()), None)
+    if exact is not None:
+        return {
+            "success": False,
+            "error": f"A {item_label} titled '{title}' already exists (id: {exact.id}). Use update_note to modify it instead of creating a duplicate.",
+        }
+
+    clean_q = _PUNCT_RE.sub(" ", title).strip()
+    candidates, _ = await list_notes(user_id=user_id, q=clean_q, is_task=is_task, limit=20)
+    near, ratio = fuzzy_title_match(title, candidates)
+    if near is not None:
+        return {
+            "success": False,
+            "requires_confirmation": True,
+            "similar_note": {"id": near.id, "title": near.title},
+            "error": f"A {item_label} with a very similar title '{near.title}' already exists (similarity: {ratio:.0%}). Ask the user to confirm before creating a separate entry.",
+        }
+
+    if not confirmed and len(body.strip()) >= 80:
+        from fabledassistant.services.embeddings import semantic_search_notes as _ssn
+        sem_query = f"{title}\n{body}".strip()
+        sem_hits = await _ssn(user_id, sem_query, limit=3, threshold=0.90, is_task=is_task)
+        if sem_hits:
+            best_score, best_note = sem_hits[0]
+            return {
+                "success": False,
+                "requires_confirmation": True,
+                "similar_note": {"id": best_note.id, "title": best_note.title},
+                "error": f"A {item_label} with very similar content exists: '{best_note.title}' (semantic similarity: {best_score:.0%}). Ask the user to confirm before creating a separate entry.",
+            }
+
+    return None

src/fabledassistant/services/tools/_registry.py

@@ -0,0 +1,138 @@
+"""Decorator-based tool registry.
+
+Each tool is registered via ``@tool(...)`` which captures the OpenAI-style
+function schema and handler in one place.  ``get_tools_for_user`` and
+``execute_tool`` are the public API consumed by the rest of the app.
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass, field
+from typing import Any, Callable, Coroutine
+
+from fabledassistant.config import Config
+from fabledassistant.services.caldav import is_caldav_configured
+
+logger = logging.getLogger(__name__)
+
+type ToolHandler = Callable[..., Coroutine[Any, Any, dict]]
+
+
+@dataclass(frozen=True, slots=True)
+class ToolDef:
+    name: str
+    description: str
+    parameters: dict
+    handler: ToolHandler
+    read_only: bool = False
+    briefing: bool = False
+    journal: bool = False
+    requires: str | None = None
+    required_params: list[str] = field(default_factory=list)
+
+    def schema(self) -> dict:
+        """Return the OpenAI function-calling schema dict."""
+        return {
+            "type": "function",
+            "function": {
+                "name": self.name,
+                "description": self.description,
+                "parameters": {
+                    "type": "object",
+                    "properties": self.parameters,
+                    **({"required": self.required_params} if self.required_params else {}),
+                },
+            },
+        }
+
+
+_REGISTRY: dict[str, ToolDef] = {}
+
+
+def tool(
+    *,
+    name: str,
+    description: str,
+    parameters: dict | None = None,
+    required: list[str] | None = None,
+    read_only: bool = False,
+    briefing: bool = False,
+    journal: bool = False,
+    requires: str | None = None,
+) -> Callable[[ToolHandler], ToolHandler]:
+    """Register an async tool handler with its schema metadata."""
+
+    def decorator(fn: ToolHandler) -> ToolHandler:
+        if name in _REGISTRY:
+            raise ValueError(f"Duplicate tool registration: {name}")
+        _REGISTRY[name] = ToolDef(
+            name=name,
+            description=description,
+            parameters=parameters or {},
+            handler=fn,
+            read_only=read_only,
+            briefing=briefing,
+            journal=journal,
+            requires=requires,
+            required_params=required or [],
+        )
+        return fn
+
+    return decorator
+
+
+async def _check_requires(user_id: int, requires: str) -> bool:
+    if requires == "caldav":
+        return await is_caldav_configured(user_id)
+    if requires == "searxng":
+        return Config.searxng_enabled()
+    return True
+
+
+async def get_tools_for_user(
+    user_id: int, *, conversation_type: str = "chat"
+) -> list[dict]:
+    """Build the tool schema list for a user, scoped by conversation type.
+
+    - 'chat': all tools except those marked journal-only.
+    - 'journal': all tools except set_rag_scope (scope is implicit in journal).
+    """
+    tools: list[dict] = []
+    for td in _REGISTRY.values():
+        if td.requires and not await _check_requires(user_id, td.requires):
+            continue
+        if conversation_type == "journal":
+            if td.name == "set_rag_scope":
+                continue
+        else:
+            if td.journal:
+                continue
+        tools.append(td.schema())
+    logger.debug(
+        "User %d / %s: %d tools available", user_id, conversation_type, len(tools)
+    )
+    return tools
+
+
+async def execute_tool(
+    user_id: int,
+    tool_name: str,
+    arguments: dict,
+    conv_id: int | None = None,
+    workspace_project_id: int | None = None,
+) -> dict:
+    """Execute a tool call and return the result."""
+    td = _REGISTRY.get(tool_name)
+    if td is None:
+        return {"success": False, "error": f"Unknown tool: {tool_name}"}
+    try:
+        return await td.handler(
+            user_id=user_id,
+            arguments=arguments,
+            conv_id=conv_id,
+            workspace_project_id=workspace_project_id,
+        )
+    except Exception as e:
+        logger.exception("Tool execution failed: %s", tool_name)
+        return {"success": False, "error": str(e)}

src/fabledassistant/services/tools/article.py

@@ -0,0 +1,35 @@
+"""Generic article-reading LLM tool.
+
+The ``read_article`` tool fetches any URL and returns its main body text via
+trafilatura. URL-generic — not coupled to any feed system.
+"""
+from __future__ import annotations
+
+from fabledassistant.services.article_fetcher import fetch_article_text
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="read_article",
+    description=(
+        "Fetch the main body text of an article at a URL. Use when the user asks "
+        "to read, summarize, or discuss a specific article they've linked. "
+        "Returns the cleaned article text or an empty result if extraction fails."
+    ),
+    parameters={
+        "url": {
+            "type": "string",
+            "description": "The article URL to fetch.",
+        },
+    },
+    required=["url"],
+    read_only=True,
+)
+async def read_article_tool(*, user_id, arguments, **_ctx):
+    url = (arguments.get("url") or "").strip()
+    if not url:
+        return {"success": False, "error": "url is required"}
+    content = await fetch_article_text(url)
+    if not content:
+        return {"success": True, "type": "article", "data": {"url": url, "content": None, "note": "no content extracted"}}
+    return {"success": True, "type": "article", "data": {"url": url, "content": content[:6000]}}

src/fabledassistant/services/tools/calendar.py

@@ -0,0 +1,250 @@
+"""Calendar and event tools."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from fabledassistant.services.events import (
+    create_event as events_create_event,
+    delete_event as events_delete_event,
+    find_events_by_query,
+    list_events as events_list_events,
+    search_events as events_search_events,
+    update_event as events_update_event,
+)
+from fabledassistant.services.tools._helpers import resolve_project
+from fabledassistant.services.tools._registry import tool
+from fabledassistant.services.tz import get_user_tz
+
+
+async def _parse_datetime_in_user_tz(
+    user_id: int, value: str
+) -> tuple[datetime, bool]:
+    """Parse a date/datetime string from the model into a UTC-aware datetime.
+
+    Naive inputs are interpreted in the **user's local timezone** and then
+    converted to UTC for storage. Never default to UTC for naive inputs —
+    that's how all-day events landed on the wrong day for non-UTC users.
+
+    Returns ``(utc_datetime, was_date_only)``.
+    """
+    was_date_only = "T" not in value and " " not in value
+    if was_date_only:
+        value = f"{value}T00:00:00"
+    dt = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    if dt.tzinfo is None:
+        user_tz = await get_user_tz(user_id)
+        dt = dt.replace(tzinfo=user_tz)
+    return dt.astimezone(timezone.utc), was_date_only
+
+
+@tool(
+    name="create_event",
+    description="Create a calendar event for the user. Use this when the user asks to schedule, add, or create a meeting, appointment, or event. Pass dates and datetimes in the user's local time — a bare date like '2026-09-30' is interpreted as that day in the user's configured timezone.",
+    parameters={
+        "title": {"type": "string", "description": "A descriptive event title"},
+        "start": {"type": "string", "description": "Start date (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM) in the user's local time. Include a timezone offset only if the user explicitly mentions one."},
+        "end": {"type": "string", "description": "Optional end date or datetime in the user's local time"},
+        "duration": {"type": "integer", "description": "Optional duration in minutes (default 60, ignored if end is set or all_day is true)"},
+        "description": {"type": "string", "description": "Optional event description"},
+        "location": {"type": "string", "description": "Optional event location"},
+        "color": {"type": "string", "description": "Optional hex color for the event (e.g. '#6366f1')"},
+        "all_day": {"type": "boolean", "description": "True for all-day events (birthdays, holidays, deadlines)"},
+        "recurrence": {"type": "string", "description": "Optional iCalendar RRULE (e.g. 'FREQ=YEARLY' for annual, 'FREQ=WEEKLY' for weekly, 'FREQ=MONTHLY' for monthly)"},
+        "reminder_minutes": {"type": "integer", "description": "Optional reminder N minutes before the event (e.g. 30 for 30 minutes before)"},
+        "attendees": {"type": "array", "items": {"type": "string"}, "description": "Optional list of attendee email addresses"},
+        "calendar_name": {"type": "string", "description": "Optional calendar name to create the event in. Falls back to default calendar."},
+        "project": {"type": "string", "description": "Optional project name to associate this event with"},
+    },
+    required=["title", "start"],
+)
+async def create_event_tool(*, user_id, arguments, **_ctx):
+    start_str = arguments["start"]
+    end_str = arguments.get("end")
+    all_day = arguments.get("all_day", False)
+    try:
+        # Naive dates/datetimes are interpreted in the user's local
+        # timezone, not UTC. Storing UTC for naive inputs caused all-day
+        # events to land on the previous day for negative-offset users.
+        start_dt, start_was_date_only = await _parse_datetime_in_user_tz(
+            user_id, start_str
+        )
+    except (ValueError, TypeError):
+        return {"success": False, "error": f"Invalid start datetime: {start_str!r}"}
+    if start_was_date_only:
+        all_day = True
+    end_dt = None
+    if end_str:
+        try:
+            end_dt, _ = await _parse_datetime_in_user_tz(user_id, end_str)
+        except (ValueError, TypeError):
+            return {"success": False, "error": f"Invalid end datetime: {end_str!r}"}
+    project_id = None
+    project_name = arguments.get("project")
+    if project_name:
+        proj = await resolve_project(user_id, project_name)
+        if proj:
+            project_id = proj.id
+    event = await events_create_event(
+        user_id=user_id,
+        title=arguments.get("title", "Untitled Event"),
+        start_dt=start_dt,
+        end_dt=end_dt,
+        all_day=all_day,
+        description=arguments.get("description") or "",
+        location=arguments.get("location") or "",
+        color=arguments.get("color") or "",
+        recurrence=arguments.get("recurrence"),
+        project_id=project_id,
+        duration=arguments.get("duration"),
+        reminder_minutes=arguments.get("reminder_minutes"),
+        attendees=arguments.get("attendees"),
+        calendar_name=arguments.get("calendar_name"),
+    )
+    return {"success": True, "type": "event", "data": event.to_dict()}
+
+
+@tool(
+    name="list_events",
+    description="List calendar events in a date range. Use this when the user asks what events or meetings they have. Pass plain local dates (YYYY-MM-DD) — the server interprets them in the user's timezone and expands to a full local day.",
+    parameters={
+        "date_from": {"type": "string", "description": "Start of range as a local date (YYYY-MM-DD) or local datetime. Interpreted in the user's timezone."},
+        "date_to": {"type": "string", "description": "End of range as a local date (YYYY-MM-DD) or local datetime. A bare date is expanded to 23:59:59 local."},
+    },
+    required=["date_from", "date_to"],
+    read_only=True,
+    briefing=True,
+)
+async def list_events_tool(*, user_id, arguments, **_ctx):
+    # Bare local dates are expanded to a full local day in the user's TZ:
+    # date_from → 00:00 local, date_to → 23:59:59 local, both converted to
+    # UTC before the DB query. Previously the tool description told the
+    # model to pass UTC ranges, which missed events for non-UTC users.
+    try:
+        date_from, _ = await _parse_datetime_in_user_tz(
+            user_id, arguments["date_from"]
+        )
+        date_to_str = arguments["date_to"]
+        if "T" not in date_to_str and " " not in date_to_str:
+            date_to_str = f"{date_to_str}T23:59:59"
+        date_to, _ = await _parse_datetime_in_user_tz(user_id, date_to_str)
+    except (ValueError, TypeError, KeyError) as exc:
+        return {"success": False, "error": f"Invalid date range: {exc}"}
+    events = await events_list_events(user_id=user_id, date_from=date_from, date_to=date_to)
+    return {
+        "success": True,
+        "type": "events",
+        "data": {"count": len(events), "events": events},
+    }
+
+
+@tool(
+    name="search_events",
+    description="Search calendar events by keyword. Use this when the user asks to find a specific event or meeting.",
+    parameters={
+        "query": {"type": "string", "description": "Search keyword to match against event titles, locations, and descriptions"},
+        "include_past": {"type": "boolean", "description": "Set to true to include past events in results (default: future events only)"},
+    },
+    required=["query"],
+    read_only=True,
+    briefing=True,
+)
+async def search_events_tool(*, user_id, arguments, **_ctx):
+    events = await events_search_events(
+        user_id=user_id,
+        query=arguments.get("query", ""),
+        include_past=arguments.get("include_past", False),
+    )
+    return {
+        "success": True,
+        "type": "events",
+        "data": {
+            "query": arguments.get("query", ""),
+            "count": len(events),
+            "events": [e.to_dict() for e in events],
+        },
+    }
+
+
+@tool(
+    name="update_event",
+    description="Update an existing calendar event. Use this when the user asks to change, move, reschedule, or modify an event.",
+    parameters={
+        "query": {"type": "string", "description": "Search term to find the event to update (matches against title)"},
+        "title": {"type": "string", "description": "New title for the event"},
+        "start": {"type": "string", "description": "New start datetime in ISO 8601 format"},
+        "end": {"type": "string", "description": "New end datetime in ISO 8601 format"},
+        "all_day": {"type": "boolean", "description": "Whether the event is all-day"},
+        "description": {"type": "string", "description": "New event description"},
+        "location": {"type": "string", "description": "New event location"},
+        "color": {"type": "string", "description": "New hex color for the event (e.g. '#6366f1')"},
+        "recurrence": {"type": "string", "description": "New iCalendar RRULE"},
+        "reminder_minutes": {"type": "integer", "description": "Reminder N minutes before the event. Pass 0 to remove an existing reminder."},
+    },
+    required=["query"],
+)
+async def update_event_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    matches = await find_events_by_query(user_id=user_id, query=query)
+    if not matches:
+        return {"success": False, "error": f"No event found matching '{query}'."}
+    event_to_update = matches[0]
+    fields: dict = {}
+    for str_field in ("title", "description", "location", "color", "recurrence"):
+        if arguments.get(str_field) is not None:
+            fields[str_field] = arguments[str_field]
+    if arguments.get("all_day") is not None:
+        fields["all_day"] = arguments["all_day"]
+    if "reminder_minutes" in arguments:
+        rm = arguments["reminder_minutes"]
+        fields["reminder_minutes"] = None if rm == 0 else rm
+    for dt_field, key in (("start_dt", "start"), ("end_dt", "end")):
+        val = arguments.get(key)
+        if val:
+            try:
+                # Naive datetimes are user-local, not UTC — see
+                # ``_parse_datetime_in_user_tz`` docstring.
+                dt, _ = await _parse_datetime_in_user_tz(user_id, val)
+                fields[dt_field] = dt
+            except (ValueError, TypeError):
+                return {"success": False, "error": f"Invalid datetime for {key}: {val!r}"}
+    updated = await events_update_event(user_id=user_id, event_id=event_to_update.id, **fields)
+    if updated is None:
+        return {"success": False, "error": "Event not found or update failed."}
+    return {"success": True, "type": "event_updated", "data": updated.to_dict()}
+
+
+@tool(
+    name="delete_event",
+    description="Delete a calendar event. Use this when the user asks to cancel, remove, or delete an event.",
+    parameters={
+        "query": {"type": "string", "description": "Search term to find the event to delete (matches against title)"},
+    },
+    required=["query"],
+)
+async def delete_event_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    matches = await find_events_by_query(user_id=user_id, query=query)
+    if not matches:
+        return {"success": False, "error": f"No event found matching '{query}'."}
+    event_to_delete = matches[0]
+    await events_delete_event(user_id=user_id, event_id=event_to_delete.id)
+    return {"success": True, "type": "event_deleted", "data": {"id": event_to_delete.id, "title": event_to_delete.title}}
+
+
+@tool(
+    name="list_calendars",
+    description="List all available calendars. Use this when the user asks which calendars they have.",
+    parameters={},
+    read_only=True,
+    requires="caldav",
+)
+async def list_calendars_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.caldav import list_calendars
+
+    calendars = await list_calendars(user_id=user_id)
+    return {
+        "success": True,
+        "type": "calendars",
+        "data": {"count": len(calendars), "calendars": calendars},
+    }

src/fabledassistant/services/tools/entities.py

@@ -0,0 +1,231 @@
+"""Entity tools: people, places, and lists."""
+
+from __future__ import annotations
+
+from fabledassistant.services.notes import create_note, list_notes, update_note
+from fabledassistant.services.tools._helpers import schedule_embedding
+from fabledassistant.services.tools._registry import tool
+
+
+def _build_person_body(meta: dict, extra_notes: str | None = None) -> str:
+    """Build markdown body from person metadata."""
+    lines = []
+    for key, label in (("relationship", "Relationship"), ("phone", "Phone"), ("email", "Email"), ("birthday", "Birthday"), ("address", "Address")):
+        if meta.get(key):
+            lines.append(f"**{label}:** {meta[key]}")
+    if extra_notes:
+        lines.append(f"\n{extra_notes}")
+    return "\n".join(lines)
+
+
+def _build_place_body(meta: dict, extra_notes: str | None = None) -> str:
+    """Build markdown body from place metadata."""
+    lines = []
+    for key, label in (("address", "Address"), ("phone", "Phone"), ("hours", "Hours"), ("url", "Website")):
+        if meta.get(key):
+            lines.append(f"**{label}:** {meta[key]}")
+    if extra_notes:
+        lines.append(f"\n{extra_notes}")
+    return "\n".join(lines)
+
+
+_PERSON_FIELDS = ("relationship", "phone", "email", "birthday", "address")
+_PLACE_FIELDS = ("address", "phone", "hours", "url")
+
+
+@tool(
+    name="save_person",
+    description=(
+        "Save or update a person in the user's knowledge base. Creates a new entry if the "
+        "person doesn't exist, or updates an existing one. Use when the user introduces "
+        "someone by name or adds/corrects details about a known person."
+    ),
+    parameters={
+        "name": {"type": "string", "description": "Full name of the person (used to find existing entry or as new entry title)"},
+        "relationship": {"type": "string", "description": "Relationship to the user (e.g. daughter, dentist, colleague)"},
+        "phone": {"type": "string", "description": "Phone number"},
+        "email": {"type": "string", "description": "Email address"},
+        "birthday": {"type": "string", "description": "Birthday in YYYY-MM-DD format"},
+        "address": {"type": "string", "description": "Home or mailing address"},
+        "notes": {"type": "string", "description": "Any additional free-form notes about this person"},
+    },
+    required=["name"],
+)
+async def save_person_tool(*, user_id, arguments, **_ctx):
+    name = str(arguments.get("name", "")).strip()
+    if not name:
+        return {"success": False, "error": "name is required"}
+
+    existing, _ = await list_notes(user_id=user_id, q=name, is_task=False, limit=10)
+    target = next((n for n in existing if n.note_type == "person"), None)
+
+    if target is not None:
+        meta = dict(target.entity_meta or {})
+        for field in _PERSON_FIELDS:
+            val = arguments.get(field)
+            if val is not None:
+                meta[field] = str(val)
+        extra_notes = arguments.get("notes")
+        body = _build_person_body(meta, extra_notes)
+        updated = await update_note(user_id=user_id, note_id=target.id, body=body, entity_meta=meta)
+        if updated is None:
+            return {"success": False, "error": "Failed to update person."}
+        schedule_embedding(target.id, user_id, target.title, body)
+        return {"success": True, "type": "person_updated", "data": {"id": target.id, "name": target.title}}
+
+    meta = {}
+    for field in _PERSON_FIELDS:
+        val = arguments.get(field)
+        if val:
+            meta[field] = str(val)
+    body = _build_person_body(meta, arguments.get("notes", ""))
+    note = await create_note(
+        user_id=user_id, title=name, body=body,
+        tags=["person"], note_type="person", entity_meta=meta,
+    )
+    schedule_embedding(note.id, user_id, name, note.body)
+    return {"success": True, "type": "person", "data": {"id": note.id, "name": name}}
+
+
+@tool(
+    name="save_place",
+    description=(
+        "Save or update a named location in the user's knowledge base. Creates a new entry "
+        "if the place doesn't exist, or updates an existing one. Use when the user wants to "
+        "remember or correct details about a place (business, venue, address)."
+    ),
+    parameters={
+        "name": {"type": "string", "description": "Name of the place (e.g. 'Dr. Smith Dental', 'Costco')"},
+        "address": {"type": "string", "description": "Street address"},
+        "phone": {"type": "string", "description": "Phone number"},
+        "hours": {"type": "string", "description": "Opening hours (e.g. 'Mon-Fri 9am-5pm')"},
+        "url": {"type": "string", "description": "Website URL"},
+        "notes": {"type": "string", "description": "Any additional free-form notes about this place"},
+    },
+    required=["name"],
+)
+async def save_place_tool(*, user_id, arguments, **_ctx):
+    name = str(arguments.get("name", "")).strip()
+    if not name:
+        return {"success": False, "error": "name is required"}
+
+    existing, _ = await list_notes(user_id=user_id, q=name, is_task=False, limit=10)
+    target = next((n for n in existing if n.note_type == "place"), None)
+
+    if target is not None:
+        meta = dict(target.entity_meta or {})
+        for field in _PLACE_FIELDS:
+            val = arguments.get(field)
+            if val is not None:
+                meta[field] = str(val)
+        extra_notes = arguments.get("notes")
+        body = _build_place_body(meta, extra_notes)
+        updated = await update_note(user_id=user_id, note_id=target.id, body=body, entity_meta=meta)
+        if updated is None:
+            return {"success": False, "error": "Failed to update place."}
+        schedule_embedding(target.id, user_id, target.title, body)
+        return {"success": True, "type": "place_updated", "data": {"id": target.id, "name": target.title}}
+
+    meta = {}
+    for field in _PLACE_FIELDS:
+        val = arguments.get(field)
+        if val:
+            meta[field] = str(val)
+    body = _build_place_body(meta, arguments.get("notes", ""))
+    note = await create_note(
+        user_id=user_id, title=name, body=body,
+        tags=["place"], note_type="place", entity_meta=meta,
+    )
+    schedule_embedding(note.id, user_id, name, note.body)
+    return {"success": True, "type": "place", "data": {"id": note.id, "name": name}}
+
+
+@tool(
+    name="create_list",
+    description="Create a named list (shopping list, to-do list, packing list, etc.). Items are stored as a markdown task list. Use add_to_list to add items to an existing list.",
+    parameters={
+        "name": {"type": "string", "description": "List name (e.g. 'Grocery List', 'Hardware Store')"},
+        "items": {"type": "array", "items": {"type": "string"}, "description": "Initial list items (unchecked)"},
+        "store": {"type": "string", "description": "Optional associated store or place name"},
+        "tags": {"type": "array", "items": {"type": "string"}, "description": "Tags for the list"},
+    },
+    required=["name"],
+)
+async def create_list_tool(*, user_id, arguments, **_ctx):
+    name = str(arguments.get("name", "")).strip()
+    if not name:
+        return {"success": False, "error": "name is required"}
+    items = arguments.get("items") or []
+    if not isinstance(items, list):
+        items = []
+    body = "\n".join(f"- [ ] {item}" for item in items if str(item).strip())
+    meta = {}
+    store = arguments.get("store")
+    if store:
+        meta["store"] = str(store)
+    tags = arguments.get("tags") or []
+    if not isinstance(tags, list):
+        tags = []
+    note = await create_note(
+        user_id=user_id, title=name, body=body,
+        tags=tags, note_type="list", entity_meta=meta,
+    )
+    schedule_embedding(note.id, user_id, name, body)
+    return {"success": True, "type": "list", "data": {"id": note.id, "name": name, "item_count": len(items)}}
+
+
+@tool(
+    name="add_to_list",
+    description="Add one or more items to an existing list. Items are appended as unchecked entries.",
+    parameters={
+        "list_name": {"type": "string", "description": "Name of the list to add items to"},
+        "items": {"type": "array", "items": {"type": "string"}, "description": "Items to add"},
+    },
+    required=["list_name", "items"],
+)
+async def add_to_list_tool(*, user_id, arguments, **_ctx):
+    list_name = str(arguments.get("list_name", "")).strip()
+    items = arguments.get("items") or []
+    if not list_name:
+        return {"success": False, "error": "list_name is required"}
+    if not isinstance(items, list) or not items:
+        return {"success": False, "error": "items must be a non-empty array"}
+    existing, _ = await list_notes(user_id=user_id, q=list_name, is_task=False, limit=10)
+    target = next((n for n in existing if n.note_type == "list" and n.title.lower() == list_name.lower()), None)
+    if target is None:
+        target = next((n for n in existing if n.note_type == "list"), None)
+    if target is None:
+        return {"success": False, "error": f"No list named '{list_name}' found. Use create_list to create it first."}
+    new_lines = "\n".join(f"- [ ] {item}" for item in items if str(item).strip())
+    existing_body = (target.body or "").rstrip()
+    new_body = f"{existing_body}\n{new_lines}".lstrip()
+    await update_note(user_id=user_id, note_id=target.id, body=new_body)
+    schedule_embedding(target.id, user_id, target.title, new_body)
+    return {"success": True, "type": "list_updated", "data": {"id": target.id, "name": target.title, "added": len(items)}}
+
+
+@tool(
+    name="clear_checked_items",
+    description="Remove all checked/completed items from a list, keeping only unchecked items.",
+    parameters={
+        "list_name": {"type": "string", "description": "Name of the list to clear"},
+    },
+    required=["list_name"],
+)
+async def clear_checked_items_tool(*, user_id, arguments, **_ctx):
+    import re as _re
+
+    list_name = str(arguments.get("list_name", "")).strip()
+    if not list_name:
+        return {"success": False, "error": "list_name is required"}
+    existing, _ = await list_notes(user_id=user_id, q=list_name, is_task=False, limit=10)
+    target = next((n for n in existing if n.note_type == "list" and n.title.lower() == list_name.lower()), None)
+    if target is None:
+        target = next((n for n in existing if n.note_type == "list"), None)
+    if target is None:
+        return {"success": False, "error": f"No list named '{list_name}' found."}
+    body = target.body or ""
+    cleaned = _re.sub(r"^- \[[xX]\] .+\n?", "", body, flags=_re.MULTILINE).strip()
+    await update_note(user_id=user_id, note_id=target.id, body=cleaned)
+    schedule_embedding(target.id, user_id, target.title, cleaned)
+    return {"success": True, "type": "list_cleared", "data": {"id": target.id, "name": target.title}}

src/fabledassistant/services/tools/journal.py

@@ -0,0 +1,264 @@
+"""LLM tools for journal conversations: record_moment and search_journal."""
+from __future__ import annotations
+
+import datetime
+import logging
+from typing import Any
+
+from sqlalchemy import func, select
+
+from fabledassistant.models import Note, async_session
+from fabledassistant.services.journal_search import search_journal as svc_search_journal
+from fabledassistant.services.moments import create_moment
+from fabledassistant.services.tools._registry import tool
+
+logger = logging.getLogger(__name__)
+
+
+async def _resolve_entity_ids_by_name(
+    *,
+    user_id: int,
+    names: list[str],
+    note_type: str | None = None,
+    is_task_only: bool | None = None,
+) -> list[int]:
+    """Case-insensitive title lookup → note IDs.
+
+    Names with no match are silently dropped (logged at debug). Used by
+    record_moment to resolve user-mentioned names without forcing the
+    LLM to track tool-return IDs across calls.
+    """
+    if not names:
+        return []
+    cleaned = [n.strip() for n in names if n and n.strip()]
+    if not cleaned:
+        return []
+    lowered = [n.lower() for n in cleaned]
+    async with async_session() as session:
+        stmt = select(Note.id, func.lower(Note.title).label("ltitle")).where(
+            Note.user_id == user_id,
+            func.lower(Note.title).in_(lowered),
+        )
+        if note_type is not None:
+            stmt = stmt.where(Note.note_type == note_type)
+        if is_task_only is True:
+            stmt = stmt.where(Note.status.isnot(None))
+        elif is_task_only is False:
+            stmt = stmt.where(Note.status.is_(None))
+        rows = (await session.execute(stmt)).all()
+    # Pick first match per name; preserve input order.
+    by_lower: dict[str, int] = {}
+    for note_id, ltitle in rows:
+        if ltitle not in by_lower:
+            by_lower[ltitle] = note_id
+    resolved: list[int] = []
+    for low, original in zip(lowered, cleaned):
+        if low in by_lower:
+            resolved.append(by_lower[low])
+        else:
+            logger.debug(
+                "record_moment: no entity match for %r (note_type=%s, task_only=%s)",
+                original, note_type, is_task_only,
+            )
+    return resolved
+
+
+@tool(
+    name="record_moment",
+    description=(
+        "Record a meaningful beat from the conversation as a structured Moment. "
+        "Use freely (no confirmation) for anything significant the user mentions: "
+        "events, encounters, decisions, observations, feelings worth remembering. "
+        "Each Moment is one or two sentences distilling the beat — not a full transcript. "
+        "STRONGLY PREFER the *_names parameters when linking entities — the server "
+        "resolves names to IDs by lookup, so you cannot accidentally invent or "
+        "re-use the wrong ID. Use *_ids only when you have an exact ID returned "
+        "from another tool call in this same turn."
+    ),
+    parameters={
+        "content": {
+            "type": "string",
+            "description": "1-2 sentence distillation of the moment in the user's voice or third-person.",
+        },
+        "occurred_at": {
+            "type": "string",
+            "description": "ISO 8601 datetime when the moment happened. Pass 'now' for the present moment; the handler resolves it.",
+        },
+        "raw_excerpt": {
+            "type": "string",
+            "description": "Optional: literal user phrase the moment summarizes. Useful for trust UI.",
+        },
+        "tags": {
+            "type": "array",
+            "items": {"type": "string"},
+            "description": "Optional tags (no # prefix).",
+        },
+        "person_names": {
+            "type": "array",
+            "items": {"type": "string"},
+            "description": "PREFERRED. Names of people mentioned (e.g. ['Victoria', 'Mom']). Server resolves to existing person notes by case-insensitive title match. Names with no match are silently skipped.",
+        },
+        "place_names": {
+            "type": "array",
+            "items": {"type": "string"},
+            "description": "PREFERRED. Names of places mentioned (e.g. ['the new ramen place']). Server resolves to existing place notes by title.",
+        },
+        "task_titles": {
+            "type": "array",
+            "items": {"type": "string"},
+            "description": "Titles of tasks this moment references. Server resolves to task IDs by title match.",
+        },
+        "note_titles": {
+            "type": "array",
+            "items": {"type": "string"},
+            "description": "Titles of notes this moment references. Server resolves to note IDs by title match.",
+        },
+        "person_ids": {
+            "type": "array",
+            "items": {"type": "integer"},
+            "description": "DISCOURAGED — use person_names instead. Only valid if you obtained the ID from a tool result in this same turn. Never invent IDs.",
+        },
+        "place_ids": {
+            "type": "array",
+            "items": {"type": "integer"},
+            "description": "DISCOURAGED — use place_names instead. Same caveat as person_ids.",
+        },
+        "task_ids": {
+            "type": "array",
+            "items": {"type": "integer"},
+            "description": "DISCOURAGED — use task_titles instead. Same caveat as person_ids.",
+        },
+        "note_ids": {
+            "type": "array",
+            "items": {"type": "integer"},
+            "description": "DISCOURAGED — use note_titles instead. Same caveat as person_ids.",
+        },
+    },
+    required=["content"],
+    read_only=False,
+    journal=True,
+)
+async def record_moment_tool(*, user_id, arguments, conv_id=None, **_ctx):
+    content = arguments.get("content", "").strip()
+    if not content:
+        return {"success": False, "error": "content is required"}
+
+    occurred_raw = arguments.get("occurred_at")
+    now = datetime.datetime.now(datetime.timezone.utc)
+    if occurred_raw and occurred_raw != "now":
+        try:
+            occurred_dt = datetime.datetime.fromisoformat(occurred_raw)
+            if occurred_dt.tzinfo is None:
+                occurred_dt = occurred_dt.replace(tzinfo=datetime.timezone.utc)
+        except ValueError:
+            occurred_dt = now
+    else:
+        occurred_dt = now
+
+    # Start with any explicit IDs the LLM provided.
+    person_ids = list(arguments.get("person_ids") or [])
+    place_ids = list(arguments.get("place_ids") or [])
+    task_ids = list(arguments.get("task_ids") or [])
+    note_ids = list(arguments.get("note_ids") or [])
+
+    # Resolve names → IDs and merge. Names are the preferred path because the
+    # LLM is unreliable at tracking IDs across tool calls (see prior bug:
+    # hallucinated person_ids=[1,2] referencing test-data notes).
+    person_ids.extend(
+        await _resolve_entity_ids_by_name(
+            user_id=user_id,
+            names=arguments.get("person_names") or [],
+            note_type="person",
+        )
+    )
+    place_ids.extend(
+        await _resolve_entity_ids_by_name(
+            user_id=user_id,
+            names=arguments.get("place_names") or [],
+            note_type="place",
+        )
+    )
+    task_ids.extend(
+        await _resolve_entity_ids_by_name(
+            user_id=user_id,
+            names=arguments.get("task_titles") or [],
+            is_task_only=True,
+        )
+    )
+    note_ids.extend(
+        await _resolve_entity_ids_by_name(
+            user_id=user_id,
+            names=arguments.get("note_titles") or [],
+            is_task_only=False,
+        )
+    )
+
+    # Dedupe while preserving order.
+    person_ids = list(dict.fromkeys(person_ids))
+    place_ids = list(dict.fromkeys(place_ids))
+    task_ids = list(dict.fromkeys(task_ids))
+    note_ids = list(dict.fromkeys(note_ids))
+
+    moment = await create_moment(
+        user_id=user_id,
+        content=content,
+        occurred_at=occurred_dt,
+        day_date=occurred_dt.date(),
+        conversation_id=conv_id,
+        raw_excerpt=arguments.get("raw_excerpt"),
+        tags=arguments.get("tags") or [],
+        person_ids=person_ids,
+        place_ids=place_ids,
+        task_ids=task_ids,
+        note_ids=note_ids,
+    )
+    return {
+        "success": True,
+        "type": "moment_recorded",
+        "moment": moment.to_dict(),
+    }
+
+
+@tool(
+    name="search_journal",
+    description=(
+        "Search the user's journal: past Moments and (optionally) raw transcripts. "
+        "Use to recall things mentioned in prior days. Three modes: "
+        "(a) date filter only -> recent moments in that range; "
+        "(b) person_id/place_id filter -> moments mentioning that entity; "
+        "(c) query string -> semantic search, optionally constrained by date/entity."
+    ),
+    parameters={
+        "query": {"type": "string", "description": "Optional semantic query."},
+        "person_id": {"type": "integer", "description": "Filter to this person."},
+        "place_id": {"type": "integer", "description": "Filter to this place."},
+        "tag": {"type": "string", "description": "Filter to moments with this tag."},
+        "date_from": {"type": "string", "description": "ISO date lower bound (inclusive)."},
+        "date_to": {"type": "string", "description": "ISO date upper bound (inclusive)."},
+        "include_transcripts": {
+            "type": "boolean",
+            "description": "If true, also return matching raw transcript excerpts when query is set. Default false.",
+        },
+        "limit": {"type": "integer", "description": "Max results, default 10."},
+    },
+    required=[],
+    read_only=True,
+    journal=True,
+)
+async def search_journal_tool(*, user_id, arguments, **_ctx) -> dict[str, Any]:
+    df_raw = arguments.get("date_from")
+    dt_raw = arguments.get("date_to")
+    df = datetime.date.fromisoformat(df_raw) if df_raw else None
+    dt = datetime.date.fromisoformat(dt_raw) if dt_raw else None
+    results = await svc_search_journal(
+        user_id=user_id,
+        query=arguments.get("query"),
+        person_id=arguments.get("person_id"),
+        place_id=arguments.get("place_id"),
+        tag=arguments.get("tag"),
+        date_from=df,
+        date_to=dt,
+        include_transcripts=bool(arguments.get("include_transcripts", False)),
+        limit=int(arguments.get("limit", 10)),
+    )
+    return {"success": True, "type": "journal_search_results", "count": len(results), "results": results}

src/fabledassistant/services/tools/notes.py

@@ -0,0 +1,420 @@
+"""Note tools: create, update, get, list, delete, search."""
+
+from __future__ import annotations
+
+import logging
+
+from fabledassistant.services.notes import create_note, delete_note, get_note_by_title, list_notes, update_note
+from fabledassistant.services.tag_suggestions import suggest_tags
+from fabledassistant.services.tools._helpers import (
+    check_duplicate,
+    parse_due_date,
+    resolve_project,
+    schedule_embedding,
+)
+from fabledassistant.services.tools._registry import tool
+
+logger = logging.getLogger(__name__)
+
+
+@tool(
+    name="create_note",
+    description=(
+        "Create a new note or task. "
+        "For a knowledge note, omit the status field. "
+        "For an actionable task (todo, reminder, action item), set status to 'todo'. "
+        "Use this whenever the user asks to write down, save, record, or add a task/todo."
+    ),
+    parameters={
+        "title": {"type": "string", "description": "The title"},
+        "body": {"type": "string", "description": "Content in markdown"},
+        "tags": {"type": "array", "items": {"type": "string"}, "description": 'Tags (without # prefix, hyphens for multi-word: ["science-fiction", "story/idea"]). Do NOT embed #tags in the body.'},
+        "project": {"type": "string", "description": "Optional project name. Only set this if the user explicitly named a project. Do NOT infer a project from the content or context."},
+        "status": {"type": "string", "enum": ["todo", "in_progress", "done", "cancelled"], "description": "Set to 'todo' to create a task. Omit entirely for a knowledge note."},
+        "due_date": {"type": "string", "description": "Due date in YYYY-MM-DD format (tasks only)"},
+        "priority": {"type": "string", "enum": ["none", "low", "medium", "high"], "description": "Priority level (tasks only, default: none)"},
+        "parent_task": {"type": "string", "description": "Title of a parent task to make this a sub-task of"},
+        "milestone": {"type": "string", "description": "Milestone title within the project to assign to"},
+        "recurrence_rule": {"type": "object", "description": 'Recurrence rule (tasks only). Interval form: {"type":"interval","every":3,"unit":"month"} (units: day/week/month/year). Calendar form: {"type":"calendar","unit":"month","day_of_month":1}. Annual: add "month":6.'},
+        "confirmed": {"type": "boolean", "description": "Set to true only when the user has explicitly confirmed creation after being warned about a similar existing item."},
+    },
+    required=["title"],
+)
+async def create_note_tool(*, user_id, arguments, **_ctx):
+    title = arguments.get("title", "Untitled")
+    body = arguments.get("body", "")
+    tags = arguments.get("tags", [])
+    if not isinstance(title, str):
+        return {"success": False, "error": "title must be a string. Call create_note once per item."}
+    if not isinstance(body, str):
+        body = ""
+    if not isinstance(tags, list):
+        tags = []
+
+    is_task = "status" in arguments and arguments["status"] is not None
+    status = arguments.get("status", "todo") if is_task else None
+
+    project_name = arguments.get("project")
+    milestone_name = arguments.get("milestone")
+    parent_task_name = arguments.get("parent_task")
+    project_id = None
+    milestone_id = None
+
+    if project_name:
+        proj = await resolve_project(user_id, project_name)
+        if proj is None:
+            return {"success": False, "error": f"Project '{project_name}' not found. Use list_projects to find the correct project name and retry with the exact name."}
+        project_id = proj.id
+        if milestone_name:
+            from fabledassistant.services.milestones import get_milestone_by_title as _gmbt
+            ms = await _gmbt(user_id, proj.id, milestone_name)
+            if ms is None:
+                return {"success": False, "error": f"Milestone '{milestone_name}' not found in project '{proj.title}'. Use list_milestones to see available milestones."}
+            milestone_id = ms.id
+
+    dup = await check_duplicate(user_id, title, body, is_task=is_task, confirmed=bool(arguments.get("confirmed")))
+    if dup is not None:
+        return dup
+
+    note = await create_note(
+        user_id=user_id,
+        title=title,
+        body=body,
+        tags=tags,
+        status=status,
+        priority=arguments.get("priority", "none") if is_task else None,
+        due_date=parse_due_date(arguments.get("due_date")) if is_task else None,
+        recurrence_rule=arguments.get("recurrence_rule") if is_task else None,
+        project_id=project_id,
+        milestone_id=milestone_id,
+    )
+
+    if parent_task_name:
+        parent_notes, _ = await list_notes(user_id=user_id, q=parent_task_name, is_task=True, limit=1)
+        if parent_notes:
+            note = await update_note(user_id, note.id, parent_id=parent_notes[0].id)
+
+    suggested = await suggest_tags(user_id, title, body)
+    schedule_embedding(note.id, user_id, title, body)
+
+    if is_task:
+        return {
+            "success": True,
+            "type": "task",
+            "data": {
+                "id": note.id,
+                "title": note.title,
+                "status": note.status,
+                "priority": note.priority,
+                "due_date": str(note.due_date) if note.due_date else None,
+                "project_id": note.project_id,
+                "milestone_id": note.milestone_id,
+                "parent_id": note.parent_id,
+            },
+            "suggested_tags": suggested,
+        }
+    return {
+        "success": True,
+        "type": "note",
+        "data": {"id": note.id, "title": note.title, "project_id": note.project_id},
+        "suggested_tags": suggested,
+    }
+
+
+@tool(
+    name="update_note",
+    description="Update an existing note or task — content, title, status, priority, or due date. Use for edits, marking tasks done, changing priority. Never use create_note for existing notes.",
+    parameters={
+        "query": {"type": "string", "description": "Title or keyword to find the note or task to update"},
+        "body": {"type": "string", "description": "New note content in markdown (omit if only updating task fields)"},
+        "title": {"type": "string", "description": "Optional new title"},
+        "mode": {"type": "string", "enum": ["replace", "append"], "description": "How to apply the new body: 'replace' overwrites existing content (default), 'append' adds after existing content"},
+        "status": {"type": "string", "enum": ["todo", "in_progress", "done", "cancelled"], "description": "New task status. Use to mark a task done, start it, cancel it, etc."},
+        "priority": {"type": "string", "enum": ["none", "low", "medium", "high"], "description": "New task priority"},
+        "due_date": {"type": "string", "description": "New due date in YYYY-MM-DD format"},
+        "tags": {"type": "array", "items": {"type": "string"}, "description": "Tags to apply (see tag_mode for how they're applied)"},
+        "tag_mode": {"type": "string", "enum": ["add", "remove", "replace"], "description": "'add' appends tags without duplicates (default), 'remove' removes listed tags, 'replace' sets tags to exactly this list (destructive — avoid unless explicitly requested)"},
+        "project": {"type": "string", "description": "Optional project name to assign this note/task to (set to empty string to remove project)"},
+        "milestone": {"type": "string", "description": "Optional milestone title within the project to assign this task to (set to empty string to remove milestone)"},
+        "recurrence_rule": {"type": "object", "description": 'Set or update recurrence. Interval form: {"type":"interval","every":3,"unit":"month"}. Calendar form: {"type":"calendar","unit":"month","day_of_month":1}. Pass null to remove.'},
+    },
+    required=["query"],
+)
+async def update_note_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    new_body = arguments.get("body", "")
+    new_title = arguments.get("title")
+    mode = arguments.get("mode", "replace")
+
+    note = await get_note_by_title(user_id, query)
+    if note is None:
+        notes, _ = await list_notes(user_id=user_id, q=query, limit=5)
+        note_only = [n for n in notes if n.status is None]
+        candidates = note_only or notes
+        if not candidates:
+            return {"success": False, "error": f"No note found matching '{query}'."}
+        note = candidates[0]
+
+    update_fields: dict = {}
+    if new_title:
+        update_fields["title"] = new_title
+    if new_body:
+        if mode == "append" and note.body:
+            update_fields["body"] = note.body + "\n\n" + new_body
+        else:
+            update_fields["body"] = new_body
+    if "status" in arguments:
+        update_fields["status"] = arguments["status"]
+    if "priority" in arguments:
+        update_fields["priority"] = arguments["priority"]
+    if "due_date" in arguments:
+        update_fields["due_date"] = parse_due_date(arguments["due_date"])
+    if "tags" in arguments:
+        new_tags = arguments["tags"]
+        if isinstance(new_tags, list):
+            tag_mode = arguments.get("tag_mode", "add")
+            if tag_mode == "add":
+                existing = list(note.tags or [])
+                for t in new_tags:
+                    if t not in existing:
+                        existing.append(t)
+                update_fields["tags"] = existing
+            elif tag_mode == "remove":
+                existing = list(note.tags or [])
+                update_fields["tags"] = [t for t in existing if t not in new_tags]
+            else:
+                update_fields["tags"] = new_tags
+
+    if "project" in arguments:
+        project_name = arguments["project"]
+        if project_name:
+            proj = await resolve_project(user_id, project_name)
+            if proj is None:
+                return {"success": False, "error": f"Project '{project_name}' not found. Use list_projects to see available projects."}
+            update_fields["project_id"] = proj.id
+        else:
+            update_fields["project_id"] = None
+            update_fields["milestone_id"] = None
+
+    if "milestone" in arguments:
+        milestone_name = arguments["milestone"]
+        if milestone_name:
+            ref_project_id = update_fields.get("project_id") or note.project_id
+            if ref_project_id is None:
+                return {"success": False, "error": "Cannot assign a milestone without a project. Set project first."}
+            from fabledassistant.services.milestones import get_milestone_by_title as _gmbt_upd
+            ms = await _gmbt_upd(user_id, ref_project_id, milestone_name)
+            if ms is None:
+                return {"success": False, "error": f"Milestone '{milestone_name}' not found. Use list_milestones to see available milestones."}
+            update_fields["milestone_id"] = ms.id
+        else:
+            update_fields["milestone_id"] = None
+
+    updated = await update_note(user_id, note.id, **update_fields)
+    if updated is None:
+        return {"success": False, "error": "Failed to update note."}
+
+    suggested = await suggest_tags(user_id, updated.title, updated.body or "")
+    schedule_embedding(updated.id, user_id, updated.title, updated.body or "")
+    item_type = "task" if updated.status is not None else "note"
+    return {
+        "success": True,
+        "type": "note_updated",
+        "updated": f"{item_type} '{updated.title}' (id: {updated.id})",
+        "data": {
+            "id": updated.id,
+            "title": updated.title,
+            "item_type": item_type,
+            "status": updated.status,
+            "tags": updated.tags or [],
+            "project_id": updated.project_id,
+        },
+        "suggested_tags": suggested,
+    }
+
+
+@tool(
+    name="search_notes",
+    description="Find notes or tasks by meaning. Returns a ranked list of matches with short previews. Use this when looking for items on a topic but you don't know the exact title. For the full body of a known item, use read_note instead.",
+    parameters={
+        "query": {"type": "string", "description": "A natural-language description of what you're looking for — concepts, themes, topics, or keywords"},
+        "type": {"type": "string", "enum": ["note", "task"], "description": "Restrict results to only notes or only tasks. Omit to search both."},
+        "project": {"type": "string", "description": "Optional project name to restrict search to notes in that project"},
+    },
+    required=["query"],
+    read_only=True,
+    briefing=True,
+)
+async def search_notes_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    type_filter = arguments.get("type")
+    project_name = arguments.get("project")
+
+    is_task: bool | None = None
+    if type_filter == "note":
+        is_task = False
+    elif type_filter == "task":
+        is_task = True
+
+    search_project_id: int | None = None
+    if project_name:
+        proj = await resolve_project(user_id, project_name)
+        if proj:
+            search_project_id = proj.id
+
+    results_map: dict[int, dict] = {}
+
+    try:
+        from fabledassistant.services.embeddings import semantic_search_notes as _ssn
+        sem_results = await _ssn(
+            user_id, query, limit=8, threshold=0.40,
+            project_id=search_project_id,
+        )
+        for score, n in sem_results:
+            n_is_task = n.status is not None
+            if is_task is True and not n_is_task:
+                continue
+            if is_task is False and n_is_task:
+                continue
+            results_map[n.id] = {
+                "id": n.id,
+                "title": n.title,
+                "type": "task" if n_is_task else "note",
+                "status": n.status,
+                "relevance": f"{round(score * 100)}%",
+                "preview": (n.body[:300] + "\u2026") if n.body and len(n.body) > 300 else (n.body or ""),
+            }
+        logger.debug("search_notes semantic: %d results for %r", len(results_map), query)
+    except Exception:
+        logger.debug("Semantic search unavailable in search_notes, using keyword only", exc_info=True)
+
+    try:
+        kw_notes, _ = await list_notes(
+            user_id=user_id, q=query, is_task=is_task,
+            project_id=search_project_id, limit=8,
+        )
+        for n in kw_notes:
+            if n.id not in results_map:
+                results_map[n.id] = {
+                    "id": n.id,
+                    "title": n.title,
+                    "type": "task" if n.status is not None else "note",
+                    "status": n.status,
+                    "relevance": "keyword",
+                    "preview": (n.body[:300] + "\u2026") if n.body and len(n.body) > 300 else (n.body or ""),
+                }
+    except Exception:
+        logger.warning("Keyword fallback in search_notes failed", exc_info=True)
+
+    results = list(results_map.values())[:8]
+    return {
+        "success": True,
+        "type": "search",
+        "data": {"query": query, "count": len(results), "results": results},
+    }
+
+
+@tool(
+    name="read_note",
+    description="Read the full content of one specific note or task. Use when you know which item you want and need its complete body text. For discovering items by topic, use search_notes instead.",
+    parameters={
+        "query": {"type": "string", "description": "Title or keyword to identify the note or task"},
+    },
+    required=["query"],
+    read_only=True,
+    briefing=True,
+)
+async def get_note_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    note = await get_note_by_title(user_id, query)
+    if note is None:
+        notes, _ = await list_notes(user_id=user_id, q=query, limit=3)
+        if not notes:
+            return {"success": False, "error": f"No note found matching '{query}'."}
+        note = notes[0]
+    return {
+        "success": True,
+        "type": "note_content",
+        "data": {"id": note.id, "title": note.title, "body": note.body or "", "tags": note.tags or []},
+    }
+
+
+@tool(
+    name="list_notes",
+    description="Browse recent notes (not tasks) with optional filters. Returns titles and short previews. Use when the user asks 'show my notes' or wants to browse by tag, project, or recency. For tasks use list_tasks; for topic search use search_notes.",
+    parameters={
+        "q": {"type": "string", "description": "Optional keyword filter"},
+        "tags": {"type": "array", "items": {"type": "string"}, "description": "Filter notes that have ALL of these tags"},
+        "project": {"type": "string", "description": "Filter notes by project name"},
+        "sort": {"type": "string", "enum": ["updated_at", "created_at", "title"], "description": "Sort field (default: updated_at)"},
+        "limit": {"type": "integer", "description": "Maximum number of notes to return (default 10)"},
+    },
+    read_only=True,
+    briefing=True,
+)
+async def list_notes_tool(*, user_id, arguments, **_ctx):
+    tags_raw = arguments.get("tags")
+    tags = tags_raw if isinstance(tags_raw, list) else None
+    project_id = None
+    project_name = arguments.get("project")
+    if project_name:
+        proj = await resolve_project(user_id, project_name)
+        if proj is None:
+            return {"success": False, "error": f"Project '{project_name}' not found."}
+        project_id = proj.id
+    notes, total = await list_notes(
+        user_id=user_id,
+        q=arguments.get("q") or arguments.get("query"),
+        tags=tags,
+        is_task=False,
+        project_id=project_id,
+        sort=arguments.get("sort", "updated_at"),
+        order="desc",
+        limit=int(arguments.get("limit", 10)),
+    )
+    results = [
+        {
+            "id": n.id,
+            "title": n.title,
+            "tags": n.tags or [],
+            "updated_at": n.updated_at.isoformat(),
+            "preview": (n.body[:200] + "...") if n.body and len(n.body) > 200 else (n.body or ""),
+        }
+        for n in notes
+    ]
+    return {
+        "success": True,
+        "type": "notes_list",
+        "data": {"total": total, "count": len(results), "results": results},
+    }
+
+
+@tool(
+    name="delete_note",
+    description="Delete any item from the user's knowledge base permanently — notes, tasks, persons (created via save_person), places (created via save_place), and lists (created via create_list) are all stored as notes and use this single delete tool. Use ONLY when the user explicitly asks to delete or remove an item. Always confirm with the user first — this cannot be undone.",
+    parameters={
+        "query": {"type": "string", "description": "Title or keyword to find the item to delete (works for notes, tasks, persons, places, and lists)"},
+        "confirmed": {"type": "boolean", "description": "Must be true — only set after the user has explicitly confirmed they want this item deleted."},
+    },
+    required=["query"],
+)
+async def delete_note_tool(*, user_id, arguments, **_ctx):
+    query = arguments.get("query", "")
+    note = await get_note_by_title(user_id, query)
+    if note is None:
+        notes, _ = await list_notes(user_id=user_id, q=query, limit=3)
+        if not notes:
+            return {"success": False, "error": f"No note or task found matching '{query}'."}
+        note = notes[0]
+    if not arguments.get("confirmed"):
+        item_type = "task" if note.status is not None else "note"
+        return {
+            "success": False,
+            "requires_confirmation": True,
+            "error": f"Deleting {item_type} '{note.title}' is permanent. Ask the user to confirm, then retry with confirmed=true.",
+        }
+    deleted = await delete_note(user_id, note.id)
+    if not deleted:
+        return {"success": False, "error": "Failed to delete."}
+    item_type = "task" if note.status is not None else "note"
+    return {"success": True, "type": f"{item_type}_deleted", "data": {"id": note.id, "title": note.title}}

src/fabledassistant/services/tools/profile.py

@@ -0,0 +1,77 @@
+"""User profile tools."""
+
+from __future__ import annotations
+
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="get_profile",
+    description=(
+        "Retrieve the user's stored profile: name, job title, industry, expertise level, "
+        "preferred response style, tone, and interests. Use this when you need to personalise "
+        "a response and the user's profile hasn't already been injected into context."
+    ),
+    parameters={},
+    read_only=True,
+)
+async def get_profile_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.user_profile import get_profile as _get_profile
+
+    profile = await _get_profile(user_id)
+    return {
+        "success": True,
+        "type": "profile",
+        "data": {
+            "display_name": profile.display_name or "",
+            "job_title": profile.job_title or "",
+            "industry": profile.industry or "",
+            "expertise_level": profile.expertise_level or "intermediate",
+            "response_style": profile.response_style or "balanced",
+            "tone": profile.tone or "casual",
+            "interests": profile.interests or [],
+        },
+    }
+
+
+@tool(
+    name="update_profile",
+    description=(
+        "Update the user's stored profile when they share personal information: their name, "
+        "job, industry, expertise, preferred response style, tone, or interests. "
+        "Only set fields the user has explicitly mentioned."
+    ),
+    parameters={
+        "display_name": {"type": "string", "description": "User's preferred display name"},
+        "job_title": {"type": "string", "description": "Job title (e.g. 'Software Engineer')"},
+        "industry": {"type": "string", "description": "Industry (e.g. 'Healthcare', 'Finance')"},
+        "expertise_level": {"type": "string", "enum": ["novice", "intermediate", "expert"], "description": "User's general expertise level"},
+        "response_style": {"type": "string", "enum": ["concise", "balanced", "detailed"], "description": "Preferred response length/depth"},
+        "tone": {"type": "string", "enum": ["casual", "professional", "technical"], "description": "Preferred communication tone"},
+        "interests": {"type": "array", "items": {"type": "string"}, "description": "List of topics or hobbies the user is interested in"},
+    },
+)
+async def update_profile_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.user_profile import VALID_EXPERTISE, VALID_STYLES, VALID_TONES, update_profile as _update_profile
+
+    data: dict = {}
+    for field in ("display_name", "job_title", "industry"):
+        val = arguments.get(field)
+        if val is not None:
+            data[field] = str(val)
+    expertise = arguments.get("expertise_level")
+    if expertise in VALID_EXPERTISE:
+        data["expertise_level"] = expertise
+    style = arguments.get("response_style")
+    if style in VALID_STYLES:
+        data["response_style"] = style
+    tone = arguments.get("tone")
+    if tone in VALID_TONES:
+        data["tone"] = tone
+    interests = arguments.get("interests")
+    if isinstance(interests, list):
+        data["interests"] = [str(i) for i in interests if str(i).strip()]
+    if not data:
+        return {"success": False, "error": "No valid fields provided to update."}
+    await _update_profile(user_id, data)
+    return {"success": True, "type": "profile_updated", "data": {"fields_updated": list(data.keys())}}

src/fabledassistant/services/tools/projects.py

@@ -0,0 +1,258 @@
+"""Project and milestone tools."""
+
+from __future__ import annotations
+
+from fabledassistant.services.tools._helpers import fuzzy_title_match, resolve_project
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="create_project",
+    description="Create a new project. Use list_projects first to check for duplicates. Only call after user has explicitly confirmed.",
+    parameters={
+        "title": {"type": "string", "description": "Project title"},
+        "description": {"type": "string", "description": "Brief description"},
+        "goal": {"type": "string", "description": "The goal or desired outcome"},
+        "color": {"type": "string", "description": "Optional hex color for the project (e.g. '#6366f1')"},
+        "confirmed": {"type": "boolean", "description": "Must be true — only set after the user has explicitly confirmed they want this project created."},
+    },
+    required=["title", "confirmed"],
+)
+async def create_project_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.projects import create_project as _create_project, get_project_by_title as _gpbt, list_projects as _lp
+
+    proj_title = arguments.get("title", "New Project")
+    existing_proj = await _gpbt(user_id, proj_title)
+    if existing_proj is not None:
+        return {"success": False, "error": f"A project titled '{existing_proj.title}' already exists (id: {existing_proj.id}). Use that project instead of creating a duplicate."}
+    all_projects = await _lp(user_id)
+    near_proj, ratio = fuzzy_title_match(proj_title, all_projects, threshold=0.55)
+    if near_proj is not None:
+        return {"success": False, "requires_confirmation": True, "error": f"A project with a similar name '{near_proj.title}' already exists (id: {near_proj.id}, similarity: {ratio:.0%}). This is likely the project you meant — use that project's name instead. Only call create_project again if you are certain this should be a completely new, separate project with a different confirmed=true."}
+    if not arguments.get("confirmed"):
+        return {"success": False, "requires_confirmation": True, "error": f"Project creation requires explicit user confirmation. Ask the user: 'Shall I create a new project titled \"{proj_title}\"?' Then retry with confirmed=true if they agree."}
+    project = await _create_project(
+        user_id,
+        title=proj_title,
+        description=arguments.get("description", ""),
+        goal=arguments.get("goal", ""),
+        color=arguments.get("color") or None,
+    )
+    return {"success": True, "type": "project", "data": project.to_dict()}
+
+
+@tool(
+    name="list_projects",
+    description="List the user's projects. Use when asked about projects, initiatives, or campaigns.",
+    parameters={
+        "status": {"type": "string", "enum": ["active", "completed", "archived"], "description": "Filter by status (omit for all)"},
+    },
+    read_only=True,
+    briefing=True,
+)
+async def list_projects_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.projects import list_projects as _list_projects
+
+    projects = await _list_projects(user_id, status=arguments.get("status"))
+    return {
+        "success": True,
+        "type": "projects_list",
+        "data": {"count": len(projects), "projects": [p.to_dict() for p in projects]},
+    }
+
+
+@tool(
+    name="get_project",
+    description="Get details and summary of a specific project.",
+    parameters={
+        "query": {"type": "string", "description": "Project name or keyword to find it"},
+    },
+    required=["query"],
+    read_only=True,
+    briefing=True,
+)
+async def get_project_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.projects import get_project_by_title as _gpbt, get_project_summary as _gps, list_projects as _lp
+
+    query = arguments.get("query", "")
+    project = await _gpbt(user_id, query)
+    if project is None:
+        all_projects = await _lp(user_id)
+        matches = [p for p in all_projects if query.lower() in p.title.lower()]
+        if matches:
+            project = matches[0]
+    if project is None:
+        return {"success": False, "error": f"No project found matching '{query}'"}
+    summary = await _gps(user_id, project.id)
+    data = project.to_dict()
+    data["summary"] = summary
+    return {"success": True, "type": "project_detail", "data": data}
+
+
+@tool(
+    name="update_project",
+    description="Update a project's title, status, description, goal, or color.",
+    parameters={
+        "query": {"type": "string", "description": "Project name to find"},
+        "title": {"type": "string", "description": "New project title"},
+        "status": {"type": "string", "enum": ["active", "completed", "archived"]},
+        "description": {"type": "string"},
+        "goal": {"type": "string"},
+        "color": {"type": "string", "description": "Hex color (e.g. '#6366f1'), or empty string to clear"},
+    },
+    required=["query"],
+)
+async def update_project_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.projects import get_project_by_title as _gpbt, update_project as _up, list_projects as _lp
+
+    query = arguments.get("query", "")
+    project = await _gpbt(user_id, query)
+    if project is None:
+        all_projects = await _lp(user_id)
+        matches = [p for p in all_projects if query.lower() in p.title.lower()]
+        if matches:
+            project = matches[0]
+    if project is None:
+        return {"success": False, "error": f"No project found matching '{query}'"}
+    fields = {}
+    for k in ("title", "status", "description", "goal"):
+        if k in arguments:
+            fields[k] = arguments[k]
+    if "color" in arguments:
+        fields["color"] = arguments["color"] or None
+    updated = await _up(user_id, project.id, **fields)
+    return {"success": True, "type": "project_updated", "data": updated.to_dict()}
+
+
+@tool(
+    name="search_projects",
+    description="Search for projects by name, description, or theme. Use this to find which project a user is referring to and get its ID for set_rag_scope.",
+    parameters={
+        "query": {"type": "string", "description": "Search query — project name, topic, or theme"},
+    },
+    required=["query"],
+    read_only=True,
+    briefing=True,
+)
+async def search_projects_tool(*, user_id, arguments, **_ctx):
+    from difflib import SequenceMatcher
+
+    from fabledassistant.services.projects import list_projects
+
+    query = str(arguments.get("query", "")).lower()
+    projects = await list_projects(user_id)
+    scored: list[tuple[float, object]] = []
+    for p in projects:
+        combined = f"{p.title} {p.description or ''} {p.auto_summary or ''}".lower()
+        base_score = SequenceMatcher(None, query, combined).ratio()
+        query_words = set(query.split())
+        overlap = sum(1 for w in query_words if w in combined)
+        score = base_score + overlap * 0.05
+        scored.append((score, p))
+    scored.sort(key=lambda x: x[0], reverse=True)
+    results = []
+    for score, p in scored[:5]:
+        results.append({
+            "id": p.id,
+            "title": p.title,
+            "summary_snippet": (p.auto_summary or p.description or "")[:200],
+            "score": round(score, 3),
+        })
+    return {"type": "projects_list", "data": {"projects": results}}
+
+
+@tool(
+    name="create_milestone",
+    description="Create a milestone inside a project. Confirm name and project with user before calling.",
+    parameters={
+        "project": {"type": "string", "description": "Project title"},
+        "title": {"type": "string", "description": "Milestone title"},
+        "description": {"type": "string", "description": "Optional description"},
+        "confirmed": {"type": "boolean", "description": "Must be true — only set after the user has explicitly confirmed they want this milestone created."},
+    },
+    required=["project", "title", "confirmed"],
+)
+async def create_milestone_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.milestones import create_milestone as _cm, get_milestone_by_title as _gmbt2, list_milestones as _lms
+
+    project_name = arguments.get("project", "")
+    ms_title = arguments.get("title", "Untitled Milestone")
+    if not project_name:
+        return {"success": False, "error": "project is required"}
+    if not arguments.get("confirmed"):
+        return {"success": False, "requires_confirmation": True, "error": f"Milestone creation requires explicit user confirmation. Ask the user: 'Shall I create a milestone titled \"{ms_title}\" in project \"{project_name}\"?' Then retry with confirmed=true if they agree."}
+    proj = await resolve_project(user_id, project_name)
+    if proj is None:
+        return {"success": False, "error": f"Project '{project_name}' not found. Use list_projects to find the correct project name and retry with the exact name."}
+    existing_ms = await _gmbt2(user_id, proj.id, ms_title)
+    if existing_ms is not None:
+        return {"success": False, "error": f"A milestone titled '{existing_ms.title}' already exists in '{proj.title}' (id: {existing_ms.id}). Use update_milestone to modify it instead."}
+    all_ms = await _lms(user_id, proj.id)
+    near_ms, ratio = fuzzy_title_match(ms_title, all_ms)
+    if near_ms is not None:
+        return {"success": False, "error": f"A milestone with a very similar title '{near_ms.title}' already exists in '{proj.title}' (id: {near_ms.id}, similarity: {ratio:.0%}). Use update_milestone to modify it instead."}
+    ms = await _cm(user_id, proj.id, title=ms_title, description=arguments.get("description"))
+    return {"success": True, "type": "milestone", "data": ms.to_dict()}
+
+
+@tool(
+    name="update_milestone",
+    description="Update the title, description, or status of an existing milestone.",
+    parameters={
+        "project": {"type": "string", "description": "Project title the milestone belongs to"},
+        "milestone": {"type": "string", "description": "Current milestone title to look up"},
+        "title": {"type": "string", "description": "New title (omit to keep current)"},
+        "description": {"type": "string", "description": "New description (omit to keep current)"},
+        "status": {"type": "string", "enum": ["active", "done"], "description": "New status: 'active' (in progress) or 'done' (completed)"},
+    },
+    required=["project", "milestone"],
+)
+async def update_milestone_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.milestones import get_milestone_by_title as _gmbt, update_milestone as _um
+
+    project_name = arguments.get("project", "")
+    milestone_name = arguments.get("milestone", "")
+    if not project_name or not milestone_name:
+        return {"success": False, "error": "Both project and milestone are required"}
+    proj = await resolve_project(user_id, project_name)
+    if proj is None:
+        return {"success": False, "error": f"Project '{project_name}' not found"}
+    ms = await _gmbt(user_id, proj.id, milestone_name)
+    if ms is None:
+        return {"success": False, "error": f"Milestone '{milestone_name}' not found in project '{proj.title}'. Use list_milestones to see available milestones."}
+    fields: dict[str, object] = {}
+    if "title" in arguments:
+        fields["title"] = arguments["title"]
+    if "description" in arguments:
+        fields["description"] = arguments["description"]
+    if "status" in arguments:
+        fields["status"] = arguments["status"]
+    if not fields:
+        return {"success": False, "error": "No fields to update — provide at least one of: title, description, status"}
+    updated = await _um(user_id, ms.id, **fields)
+    return {"success": True, "type": "milestone", "data": updated.to_dict()}
+
+
+@tool(
+    name="list_milestones",
+    description="List milestones for a project with their progress percentages.",
+    parameters={
+        "project": {"type": "string", "description": "Project name to look up"},
+    },
+    required=["project"],
+    read_only=True,
+    briefing=True,
+)
+async def list_milestones_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.milestones import get_project_milestone_summary
+
+    project_name = arguments.get("project", "")
+    proj = await resolve_project(user_id, project_name)
+    if proj is None:
+        return {"success": False, "error": f"No project found matching '{project_name}'"}
+    summary = await get_project_milestone_summary(user_id, proj.id)
+    return {
+        "success": True,
+        "type": "milestones_list",
+        "data": {"project": proj.title, "count": len(summary), "milestones": summary},
+    }

src/fabledassistant/services/tools/rag.py

@@ -0,0 +1,34 @@
+"""RAG scope tool."""
+
+from __future__ import annotations
+
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="set_rag_scope",
+    description="Change the RAG scope for this conversation. Use project_id=<int> to scope to a project, project_id=null to scope to orphan notes only, project_id=-1 for all notes.",
+    parameters={
+        "project_id": {"type": ["integer", "null"], "description": "Project ID to scope to, null for orphan-only, -1 for all notes"},
+    },
+    required=["project_id"],
+)
+async def set_rag_scope_tool(*, user_id, arguments, conv_id=None, workspace_project_id=None, **_ctx):
+    if workspace_project_id is not None:
+        return {"success": False, "error": "Cannot change RAG scope in workspace view"}
+    if conv_id is None:
+        return {"success": False, "error": "No conversation context available"}
+    project_id = arguments.get("project_id")
+    if project_id is not None and project_id != -1:
+        from fabledassistant.services.projects import get_project
+        proj = await get_project(user_id, int(project_id))
+        if proj is None:
+            return {"success": False, "error": "Project not found"}
+        scope_label = proj.title
+    elif project_id == -1:
+        scope_label = "All notes"
+    else:
+        scope_label = "Orphan notes only"
+    from fabledassistant.services.chat import update_conversation
+    await update_conversation(user_id, conv_id, rag_project_id=project_id)
+    return {"success": True, "type": "rag_scope_set", "scope_label": scope_label}

src/fabledassistant/services/tools/tasks.py

@@ -0,0 +1,116 @@
+"""Task tools: list, log work."""
+
+from __future__ import annotations
+
+from fabledassistant.services.notes import get_note_by_title, list_notes
+from fabledassistant.services.tools._helpers import (
+    parse_due_date,
+    resolve_project,
+)
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="list_tasks",
+    description="List tasks with optional filters. For overdue tasks, set due_before to today's date.",
+    parameters={
+        "q": {"type": "string", "description": "Optional keyword filter — searches title and body"},
+        "status": {"type": "array", "items": {"type": "string", "enum": ["todo", "in_progress", "done", "cancelled"]}, "description": "Filter by one or more statuses. Omit for all."},
+        "priority": {"type": "string", "enum": ["none", "low", "medium", "high"], "description": "Filter by priority level"},
+        "due_before": {"type": "string", "description": "Return tasks due before this date (YYYY-MM-DD). Use today's date to find overdue tasks."},
+        "due_after": {"type": "string", "description": "Return tasks due on or after this date (YYYY-MM-DD)"},
+        "project": {"type": "string", "description": "Filter tasks by project name"},
+        "milestone": {"type": "string", "description": "Filter tasks by milestone name within a project"},
+        "limit": {"type": "integer", "description": "Maximum number of tasks to return (default 10)"},
+    },
+    read_only=True,
+    briefing=True,
+)
+async def list_tasks_tool(*, user_id, arguments, **_ctx):
+    project_id = None
+    milestone_id = None
+    project_name = arguments.get("project")
+    milestone_name = arguments.get("milestone")
+    if project_name:
+        proj = await resolve_project(user_id, project_name)
+        if proj:
+            project_id = proj.id
+            if milestone_name:
+                from fabledassistant.services.milestones import get_milestone_by_title
+                ms = await get_milestone_by_title(user_id, proj.id, milestone_name)
+                if ms:
+                    milestone_id = ms.id
+    elif milestone_name:
+        from fabledassistant.services.milestones import find_milestone_by_title
+        ms = await find_milestone_by_title(user_id, milestone_name)
+        if ms:
+            milestone_id = ms.id
+    notes, total = await list_notes(
+        user_id=user_id,
+        q=arguments.get("q") or None,
+        is_task=True,
+        status=arguments.get("status"),
+        priority=arguments.get("priority"),
+        due_before=parse_due_date(arguments.get("due_before")),
+        due_after=parse_due_date(arguments.get("due_after")),
+        project_id=project_id,
+        milestone_id=milestone_id,
+        exclude_paused_projects=project_id is None,
+        limit=int(arguments.get("limit", 10)),
+        sort="due_date",
+        order="asc",
+    )
+    results = []
+    for n in notes:
+        results.append({
+            "id": n.id,
+            "title": n.title,
+            "status": n.status,
+            "priority": n.priority,
+            "due_date": str(n.due_date) if n.due_date else None,
+            "project_id": n.project_id,
+            "preview": (n.body[:120] + "...") if n.body and len(n.body) > 120 else (n.body or ""),
+        })
+    return {
+        "success": True,
+        "type": "tasks",
+        "data": {"total": total, "count": len(results), "results": results},
+    }
+
+
+@tool(
+    name="log_work",
+    description="Add a work log entry to a task to record progress, work done, or time spent. Use this when the user says they worked on, completed, or spent time on a task.",
+    parameters={
+        "task": {"type": "string", "description": "Title or keyword identifying the task (required)"},
+        "content": {"type": "string", "description": "Description of the work done (required)"},
+        "duration_minutes": {"type": "integer", "description": "Optional time spent in minutes"},
+    },
+    required=["task", "content"],
+)
+async def log_work_tool(*, user_id, arguments, **_ctx):
+    from fabledassistant.services.task_logs import create_log as _create_log
+
+    task_query = arguments.get("task", "")
+    content = arguments.get("content", "").strip()
+    if not task_query:
+        return {"success": False, "error": "task is required"}
+    if not content:
+        return {"success": False, "error": "content is required"}
+    duration_minutes = arguments.get("duration_minutes")
+    if duration_minutes is not None:
+        try:
+            duration_minutes = int(duration_minutes)
+        except (TypeError, ValueError):
+            duration_minutes = None
+    note = await get_note_by_title(user_id, task_query)
+    if note is None or note.status is None:
+        notes, _ = await list_notes(user_id=user_id, q=task_query, is_task=True, limit=5)
+        note = notes[0] if notes else None
+    if note is None:
+        return {"success": False, "error": f"No task found matching '{task_query}'."}
+    try:
+        log = await _create_log(user_id, note.id, content, duration_minutes)
+    except ValueError as e:
+        return {"success": False, "error": str(e)}
+    return {"success": True, "log": log.to_dict(), "task": note.title}

src/fabledassistant/services/tools/utility.py

@@ -0,0 +1,34 @@
+"""General-purpose utility tools."""
+
+from __future__ import annotations
+
+from fabledassistant.services.tools._registry import tool
+
+
+@tool(
+    name="calculate",
+    description=(
+        "Evaluate a mathematical expression and return the exact result. Use this for any "
+        "arithmetic, percentages, unit conversions, or multi-step calculations where precision "
+        "matters. Supports standard math operators (+, -, *, /, **, %) and all Python math "
+        "module functions (sqrt, log, sin, cos, floor, ceil, etc.)."
+    ),
+    parameters={
+        "expression": {"type": "string", "description": "A valid Python math expression (e.g. '(450 * 1.13) / 12', 'sqrt(144)', 'log(1000, 10)')"},
+    },
+    required=["expression"],
+)
+async def calculate_tool(*, user_id, arguments, **_ctx):
+    import math as _math
+
+    expr = str(arguments.get("expression", "")).strip()
+    if not expr:
+        return {"success": False, "error": "expression is required"}
+    allowed_names = {k: v for k, v in vars(_math).items() if not k.startswith("_")}
+    allowed_names["abs"] = abs
+    allowed_names["round"] = round
+    try:
+        result = eval(expr, {"__builtins__": {}}, allowed_names)  # noqa: S307
+    except Exception as calc_err:
+        return {"success": False, "error": f"Could not evaluate expression: {calc_err}"}
+    return {"success": True, "type": "calculation", "data": {"expression": expr, "result": result}}