Release v26.04.29.3 — Event-store data integrity + EventSlideOver redesign

.env.example

@@ -1,4 +1,4 @@
 POSTGRES_USER=fabled
 POSTGRES_PASSWORD=fabled
-POSTGRES_DB=scribe
+POSTGRES_DB=fabledassistant
 SECRET_KEY=dev-secret-change-me

.forgejo/workflows/ci.yml

@@ -1,19 +1,12 @@
 # CI runs first; build only proceeds if all checks pass.
 #
-# Push to dev:        typecheck + lint + test + build :dev + :<sha>
-# Push to main:       typecheck + lint + test + build :latest + :<sha>
-# Tag v* (release):   typecheck + lint + test + build :latest + :<version> + :<sha>
+# Push to dev:       typecheck + lint + test + build :dev + :<sha>
+# Tag v* (release):  typecheck + lint + test + build :latest + :<sha> + :<version>
 #
-# Both dev and main are gated AND built. dev pushes move :dev; main pushes move
-# :latest — main IS the production line, so :latest tracks main's tip and there
-# is no separate :main tag. Every push also gets an immutable :<sha> (the
-# rollback point). A v* release tag additionally publishes the dated :<version>;
-# since main already moved :latest, the release tag's distinct job is that
-# :<version> marker (it refreshes :latest too, harmlessly).
-#
-# Successive pushes to the SAME ref supersede each other (see concurrency
-# below), so rapid pushes don't stack identical work; dev and main runs are
-# independent refs and never cancel one another.
+# 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.
@@ -23,8 +16,11 @@
 # 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, so every job repeats the ref check
-# explicitly — permitting dev, main, and v* tags, rejecting anything else.
+# 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
@@ -33,7 +29,7 @@ name: CI & Build
 
 on:
   push:
-    branches: [dev, main]
+    branches: [dev]
     tags: ["v*"]
     paths:
       - "src/**"
@@ -46,11 +42,6 @@ on:
       - "assets/**"
       - "fable-mcp/**"
       - ".forgejo/workflows/ci.yml"
-  # Manual trigger from the Forgejo Actions UI. Useful when an image has
-  # been built but the deployment didn't pick it up, or when re-running
-  # against the same source produces different upstream behaviour
-  # (e.g. a transient HF download flake during the voice-bundle step).
-  workflow_dispatch: {}
 
 # 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
@@ -71,11 +62,9 @@ env:
 jobs:
   typecheck:
     name: TypeScript typecheck
-    # Gate dev, main, and v* tags; reject any other ref (see header note).
-    if: github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: python-ci
-    container:
-      image: git.fabledsword.com/bvandeusen/ci-python:3.14
+    # 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
 
@@ -96,24 +85,20 @@ jobs:
 
   lint:
     name: Python lint
-    if: github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: python-ci
-    container:
-      image: git.fabledsword.com/bvandeusen/ci-python:3.14
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
     steps:
       - uses: actions/checkout@v6
 
-      # ruff is pre-installed in the ci-python image — no install
+      # 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
-    if: github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: python-ci
-    container:
-      image: git.fabledsword.com/bvandeusen/ci-python:3.14
+    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ci-runner
     steps:
       - uses: actions/checkout@v6
 
@@ -142,12 +127,12 @@ jobs:
   build:
     name: Build & push image
     needs: [typecheck, lint, test]
-    # Build on dev, main, and v* tag pushes. dev → :dev, main → :latest,
-    # tag → :latest + :<version>; every build also gets an immutable :<sha>.
-    if: github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: python-ci
-    container:
-      image: git.fabledsword.com/bvandeusen/ci-python:3.14
+    # Build on dev branch pushes and version tag pushes only.
+    # 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
@@ -156,31 +141,15 @@ jobs:
 
       - name: Generate image tags and version
         id: tags
-        # POSIX `case` instead of bash `[[ ]]` because act_runner invokes
-        # `sh -e` (dash on the ci-python:3.14 image, which has no bash on
-        # the default PATH for /bin/sh). Previous `[[ ]]` form failed
-        # silently — only the SHA tag got appended, so :dev / :latest
-        # never updated in the registry and the deployed stack kept
-        # pulling stale images. Verified via `[[: not found` lines in
-        # the runner log on commit 2a374d9.
         run: |
           TAGS="${{ env.IMAGE }}:${{ github.sha }}"
           BUILD_VERSION="dev"
-          case "${{ github.ref }}" in
-            refs/heads/dev)
-              TAGS="$TAGS,${{ env.IMAGE }}:dev"
-              ;;
-            refs/heads/main)
-              # main IS the production line: publish :latest (plus the :<sha>
-              # set above). No separate :main tag.
-              TAGS="$TAGS,${{ env.IMAGE }}:latest"
-              BUILD_VERSION="main"
-              ;;
-            refs/tags/*)
-              TAGS="$TAGS,${{ env.IMAGE }}:latest,${{ env.IMAGE }}:${{ github.ref_name }}"
-              BUILD_VERSION="${{ github.ref_name }}"
-              ;;
-          esac
+          if [[ "${{ github.ref }}" == "refs/heads/dev" ]]; then
+            TAGS="$TAGS,${{ env.IMAGE }}:dev"
+          elif [[ "${{ github.ref }}" == refs/tags/* ]]; then
+            TAGS="$TAGS,${{ env.IMAGE }}:latest,${{ env.IMAGE }}:${{ github.ref_name }}"
+            BUILD_VERSION="${{ github.ref_name }}"
+          fi
           echo "value=$TAGS" >> $GITHUB_OUTPUT
           echo "build_version=$BUILD_VERSION" >> $GITHUB_OUTPUT
 

.remember/tmp/save-session.pid

@@ -1 +1 @@
-1425947
+2298268

Dockerfile

@@ -8,16 +8,29 @@ COPY frontend/ .
 RUN npm run build
 
 # Stage 2: Python runtime
-# Tracks CI image (ci-python:3.14) so test results stay representative.
-FROM python:3.14-slim AS runtime
+FROM python:3.12-slim AS runtime
 WORKDIR /app
 
 COPY pyproject.toml .
 COPY src/ src/
 RUN --mount=type=cache,target=/root/.cache/pip \
     pip install .
+# Voice dependencies (faster-whisper, Kokoro TTS, soundfile) — activated at runtime via VOICE_ENABLED
+# Install CPU-only torch first so pip doesn't pull full CUDA wheels (~2 GB) for kokoro/transformers.
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install torch --index-url https://download.pytorch.org/whl/cpu \
+    && pip install faster-whisper kokoro soundfile \
+    && python -m spacy download en_core_web_sm
 
-COPY --from=build-frontend /build/dist/ src/scribe/static/
+# Build the fable-mcp wheel so it can be served for download
+COPY fable-mcp/ fable-mcp/
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install build hatchling \
+    && python -m build --wheel ./fable-mcp --outdir /app/dist/ \
+    && pip uninstall -y build \
+    && rm -rf fable-mcp/
+
+COPY --from=build-frontend /build/dist/ src/fabledassistant/static/
 COPY alembic.ini .
 COPY alembic/ alembic/
 
@@ -30,4 +43,4 @@ ARG BUILD_VERSION=dev
 ENV APP_VERSION=$BUILD_VERSION
 
 EXPOSE 5000
-CMD ["sh", "-c", "alembic upgrade head && hypercorn 'scribe.app:create_app()' --bind 0.0.0.0:5000 --keep-alive 600"]
+CMD ["sh", "-c", "alembic upgrade head && hypercorn 'fabledassistant.app:create_app()' --bind 0.0.0.0:5000 --keep-alive 600"]

README.md

@@ -4,7 +4,7 @@ A self-hosted second brain and project management application with integrated LL
 
 ## Features
 
-Notes and tasks with a Markdown editor, sub-tasks, milestones, and kanban project workspaces. AI chat with streaming responses, RAG over your notes, and tool use (web search, calendar, weather). A daily briefing that digests your tasks, RSS feeds, and weather on a schedule. Knowledge graph, per-user/group sharing, PWA with push notifications, and an MCP server for external AI clients.
+Notes and tasks with a Markdown editor, sub-tasks, milestones, and kanban project workspaces. AI chat with streaming responses, RAG over your notes, and tool use (web search, calendar, weather). A daily briefing that digests your tasks, RSS feeds, and weather on a schedule. Knowledge graph, per-user/group sharing, PWA with push notifications, an MCP server for external AI clients, and an Android companion app.
 
 ## Quick Start
 
@@ -36,6 +36,7 @@ Open `http://localhost:5000`. The first user to register becomes admin. Go to **
 | [API Keys & MCP](docs/api-keys-and-mcp.md) | API key management and Fable MCP install guide |
 | [SSO / OAuth](docs/sso-oauth.md) | OIDC setup for Authentik, Keycloak, and other providers |
 | [API Reference](docs/api-reference.md) | All REST API endpoints |
+| [Android App](docs/android-app.md) | Flutter companion app architecture and feature status |
 
 ## License
 

alembic/env.py

@@ -4,8 +4,8 @@ from logging.config import fileConfig
 from alembic import context
 from sqlalchemy.ext.asyncio import create_async_engine
 
-from scribe.config import Config
-from scribe.models import Base
+from fabledassistant.config import Config
+from fabledassistant.models import Base
 
 config = context.config
 if config.config_file_name is not None:

alembic/versions/0044_add_note_description_and_consolidated_at.py

@@ -1,48 +0,0 @@
-"""add note.description and note.consolidated_at
-
-Revision ID: 0044
-Revises: 0043
-Create Date: 2026-05-13
-
-Adds two columns to the ``notes`` table to support the task-as-durable-record
-design (spec 2026-05-13):
-
-- ``description``: user-stated goal / initial context. Meaningful when
-  ``is_task=true``; left NULL on knowledge notes.
-- ``consolidated_at``: timestamp of the most recent auto-summary pass. NULL
-  until the first consolidation runs.
-
-Backfill: for existing tasks we copy ``body`` into ``description`` so the
-user's original goal text is preserved when ``body`` is later overwritten by
-the auto-summary pipeline. The brief duplication window between
-``body`` and ``description`` is harmless and resolves on the first
-consolidation pass.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0044"
-down_revision = "0043"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column("notes", sa.Column("description", sa.Text(), nullable=True))
-    op.add_column(
-        "notes",
-        sa.Column("consolidated_at", sa.DateTime(timezone=True), nullable=True),
-    )
-    # is_task is a Python property (status IS NOT NULL); there's no DB column
-    # of that name. Backfill description from body for everything that
-    # qualifies as a task at the model layer.
-    op.execute(
-        "UPDATE notes SET description = body "
-        "WHERE status IS NOT NULL AND body IS NOT NULL"
-    )
-
-
-def downgrade() -> None:
-    op.drop_column("notes", "consolidated_at")
-    op.drop_column("notes", "description")

alembic/versions/0045_add_note_version_pin_columns.py

@@ -1,35 +0,0 @@
-"""add pin_kind and pin_label to note_versions
-
-Revision ID: 0045
-Revises: 0044
-Create Date: 2026-05-13
-
-Two additive columns on note_versions to support tiered retention:
-
-- pin_kind: NULL (rolling autosave), 'auto' (system-declared via stability
-  scan), 'manual' (user-declared with optional commit-note label).
-- pin_label: NULL for rolling. Auto-generated for 'auto'; user-supplied
-  for 'manual' (may be NULL).
-
-No backfill — every existing row stays rolling. The auto-pin scan
-(services/version_pinning_scheduler.py, daily 03:00 UTC) will catch up on
-the first scheduled run after deploy.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0045"
-down_revision = "0044"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column("note_versions", sa.Column("pin_kind", sa.Text(), nullable=True))
-    op.add_column("note_versions", sa.Column("pin_label", sa.Text(), nullable=True))
-
-
-def downgrade() -> None:
-    op.drop_column("note_versions", "pin_label")
-    op.drop_column("note_versions", "pin_kind")

alembic/versions/0046_add_generation_tool_log.py

@@ -1,103 +0,0 @@
-"""generation_tool_log: per-turn tool-call telemetry
-
-Revision ID: 0046
-Revises: 0045
-Create Date: 2026-05-21
-
-Captures one row per assistant turn, recording which tools the model
-could have used, which it attempted, which fired successfully, and
-which failed (with error details). The empirical surface for
-evaluating model swaps and answering "does model X actually fire
-record_moment when it should?" without relying on anecdote.
-"""
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects.postgresql import ARRAY, JSONB
-
-
-revision = "0046"
-down_revision = "0045"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "generation_tool_log",
-        sa.Column("id", sa.Integer, primary_key=True),
-        sa.Column(
-            "user_id",
-            sa.Integer,
-            sa.ForeignKey("users.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column(
-            "conv_id",
-            sa.Integer,
-            sa.ForeignKey("conversations.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        # SET NULL (not CASCADE) so the telemetry row survives if the
-        # underlying assistant message is later deleted — we want to keep
-        # the per-turn outcome record for retrospective analysis.
-        sa.Column(
-            "assistant_message_id",
-            sa.Integer,
-            sa.ForeignKey("messages.id", ondelete="SET NULL"),
-            nullable=True,
-        ),
-        sa.Column("model", sa.Text, nullable=False),
-        sa.Column("think_enabled", sa.Boolean, nullable=False),
-        sa.Column(
-            "tools_available",
-            ARRAY(sa.Text),
-            nullable=False,
-            server_default=sa.text("'{}'::text[]"),
-        ),
-        sa.Column(
-            "tools_attempted",
-            ARRAY(sa.Text),
-            nullable=False,
-            server_default=sa.text("'{}'::text[]"),
-        ),
-        sa.Column(
-            "tools_succeeded",
-            ARRAY(sa.Text),
-            nullable=False,
-            server_default=sa.text("'{}'::text[]"),
-        ),
-        # JSONB array of {name, error} objects so failed-tool details are
-        # queryable without a separate failure table.
-        sa.Column(
-            "tools_failed",
-            JSONB,
-            nullable=False,
-            server_default=sa.text("'[]'::jsonb"),
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-    )
-    # Common query: "recent tool outcomes for this user, filterable by model."
-    op.create_index(
-        "ix_generation_tool_log_user_created",
-        "generation_tool_log",
-        ["user_id", sa.text("created_at DESC")],
-    )
-    # Per-conversation lookup for the journal page's own retrospection.
-    op.create_index(
-        "ix_generation_tool_log_conv",
-        "generation_tool_log",
-        ["conv_id"],
-    )
-
-
-def downgrade() -> None:
-    op.drop_index("ix_generation_tool_log_conv", table_name="generation_tool_log")
-    op.drop_index(
-        "ix_generation_tool_log_user_created", table_name="generation_tool_log"
-    )
-    op.drop_table("generation_tool_log")

alembic/versions/0047_reset_voice_tts_settings.py

@@ -1,38 +0,0 @@
-"""reset voice_tts_voice and voice_tts_blend settings for piper migration
-
-Revision ID: 0047
-Revises: 0046
-Create Date: 2026-05-22
-
-The TTS backend swapped from kokoro to piper. Kokoro voice IDs
-(`af_heart`, `am_adam`, etc.) don't map to piper voice files
-(`en_US-amy-medium`, etc.) and there's no sensible auto-translation.
-Clear the stored voice selection so every user falls back to the piper
-default the next time they synthesize.
-
-`voice_tts_blend` goes away entirely — piper has no voice-blending
-equivalent. The TTS service accepts the field for backward compat but
-ignores it; clearing the rows makes the DB match reality.
-
-Both settings re-default cleanly on read, so this migration just deletes
-the rows without backfilling anything.
-"""
-from alembic import op
-
-
-revision = "0047"
-down_revision = "0046"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.execute(
-        "DELETE FROM settings WHERE key IN ('voice_tts_voice', 'voice_tts_blend')"
-    )
-
-
-def downgrade() -> None:
-    # No-op. The deleted settings just re-default on read; restoring the
-    # kokoro IDs wouldn't help anyway since kokoro is gone.
-    pass

alembic/versions/0048_conversation_last_curator_run.py

@@ -1,47 +0,0 @@
-"""conversations.last_curator_run_at — tracks scheduler progress per-conversation
-
-Revision ID: 0048
-Revises: 0047
-Create Date: 2026-05-22
-
-Phase 2 of the conversation+curator architecture (Fable #172). The
-scheduler runs every 15 minutes and processes any journal conversation
-with messages newer than its `last_curator_run_at` timestamp. NULL
-means "never run; process all of today on first sweep."
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0048"
-down_revision = "0047"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column(
-        "conversations",
-        sa.Column(
-            "last_curator_run_at",
-            sa.DateTime(timezone=True),
-            nullable=True,
-        ),
-    )
-    # Indexed because the scheduler's selection query is
-    # WHERE conversation_type='journal' AND (last_curator_run_at IS NULL OR ...)
-    # which benefits from a partial index narrowed to journal rows.
-    op.create_index(
-        "ix_conversations_journal_last_curator",
-        "conversations",
-        ["last_curator_run_at"],
-        postgresql_where=sa.text("conversation_type = 'journal'"),
-    )
-
-
-def downgrade() -> None:
-    op.drop_index(
-        "ix_conversations_journal_last_curator",
-        table_name="conversations",
-    )
-    op.drop_column("conversations", "last_curator_run_at")

alembic/versions/0049_conversation_curator_summary.py

@@ -1,36 +0,0 @@
-"""conversations.curator_summary — feeds curator output back to the chat model
-
-Revision ID: 0049
-Revises: 0048
-Create Date: 2026-05-22
-
-Phase 3 of the conversation+curator architecture (Fable #172). The
-curator's final summary line (≤ 240 chars) is persisted here so the
-NEXT chat turn can include it in the system prompt. This is the
-feedback loop that closes the architecture — without it, the chat
-model has no awareness of what the curator extracted, and conversations
-risk circling back to topics already captured.
-
-NULL means "no curator pass has produced a summary yet." The chat
-pipeline reads this column when building the journal system prompt;
-missing column = no injection, no failure.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0049"
-down_revision = "0048"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column(
-        "conversations",
-        sa.Column("curator_summary", sa.Text, nullable=True),
-    )
-
-
-def downgrade() -> None:
-    op.drop_column("conversations", "curator_summary")

alembic/versions/0050_drop_think_enabled_setting.py

@@ -1,27 +0,0 @@
-"""drop stored think_enabled rows — setting was removed
-
-Revision ID: 0050
-Revises: 0049
-Create Date: 2026-05-23
-
-The `think_enabled` user setting was retired with the chat+curator
-architecture: chat has tools=[] and curator hardcodes think=False, so
-the toggle was dead weight. Any rows already in `settings` for that
-key are now unread by the app; this migration clears them.
-"""
-from alembic import op
-
-
-revision = "0050"
-down_revision = "0049"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.execute("DELETE FROM settings WHERE key = 'think_enabled'")
-
-
-def downgrade() -> None:
-    # No-op. The setting is dead; restoring NULL rows wouldn't help.
-    pass

alembic/versions/0051_pending_curator_actions.py

@@ -1,98 +0,0 @@
-"""pending_curator_actions — curator-proposed mutations awaiting user approval
-
-Revision ID: 0051
-Revises: 0050
-Create Date: 2026-05-23
-
-Architecture: the curator runs unattended and can be confidently wrong.
-Additive operations (create_*, record_moment, log_work, save_person)
-land directly because adds are easily undone. Mutating operations
-(update_*, delete_*) are proposed to this table instead — the user
-sees them in a "Needs Review" panel and approves or rejects each one.
-
-A proposed action stores:
-  - The action type (`update_task`, `delete_note`, etc.) — drives which
-    handler gets re-executed on approval.
-  - The target id + type for display ("update task 42", "delete note 17").
-  - The proposed arguments (`payload`) — what the curator wanted to do.
-  - A snapshot of the target's state at proposal time (`current_snapshot`)
-    — so the review UI can render a real before/after diff even if other
-    work modified the entity since.
-  - The status (`pending` / `approved` / `rejected`) and review timestamp.
-
-Approval replays the original tool call via execute_tool with
-authority="user" so the request bypasses the curator interceptor and
-just runs.
-"""
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects.postgresql import JSONB
-
-
-revision = "0051"
-down_revision = "0050"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "pending_curator_actions",
-        sa.Column("id", sa.Integer, primary_key=True),
-        sa.Column(
-            "user_id",
-            sa.Integer,
-            sa.ForeignKey("users.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column(
-            "conv_id",
-            sa.Integer,
-            sa.ForeignKey("conversations.id", ondelete="SET NULL"),
-            nullable=True,
-        ),
-        sa.Column("action_type", sa.Text, nullable=False),
-        sa.Column("target_type", sa.Text, nullable=True),
-        sa.Column("target_id", sa.Integer, nullable=True),
-        sa.Column("target_label", sa.Text, nullable=True),
-        sa.Column("payload", JSONB, nullable=False, server_default=sa.text("'{}'::jsonb")),
-        sa.Column(
-            "current_snapshot",
-            JSONB,
-            nullable=False,
-            server_default=sa.text("'{}'::jsonb"),
-        ),
-        sa.Column(
-            "status",
-            sa.Text,
-            nullable=False,
-            server_default=sa.text("'pending'"),
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.Column("reviewed_at", sa.DateTime(timezone=True), nullable=True),
-        sa.CheckConstraint(
-            "status IN ('pending', 'approved', 'rejected')",
-            name="pending_curator_actions_status_check",
-        ),
-    )
-    # Pending-only index — the Needs Review panel fetches "user's pending"
-    # constantly, history rows just accumulate.
-    op.create_index(
-        "ix_pending_curator_actions_user_pending",
-        "pending_curator_actions",
-        ["user_id", sa.text("created_at DESC")],
-        postgresql_where=sa.text("status = 'pending'"),
-    )
-
-
-def downgrade() -> None:
-    op.drop_index(
-        "ix_pending_curator_actions_user_pending",
-        table_name="pending_curator_actions",
-    )
-    op.drop_table("pending_curator_actions")

alembic/versions/0052_clear_note_embeddings_for_fastembed.py

@@ -1,33 +0,0 @@
-"""clear note_embeddings for fastembed swap
-
-Revision ID: 0052
-Revises: 0051
-Create Date: 2026-05-26
-
-Embeddings stored in `note_embeddings.embedding` (JSONB) were generated by
-Ollama's nomic-embed-text model (768-dim). The fastembed swap uses
-BAAI/bge-small-en-v1.5 (384-dim). Mixed-dim vectors would break the
-Python-side cosine similarity (length mismatch), so we wipe the table.
-
-The startup hook `services.embeddings.backfill_note_embeddings` regenerates
-everything at the new dimension on next boot. There's no column-type change
-because the column is JSONB — dimensionless on the storage side.
-
-Downgrade is the same operation: a fresh deployment of the prior code would
-backfill with the old model. No data is lost that the next boot won't restore.
-"""
-from alembic import op
-
-
-revision = "0052"
-down_revision = "0051"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.execute("DELETE FROM note_embeddings")
-
-
-def downgrade() -> None:
-    op.execute("DELETE FROM note_embeddings")

alembic/versions/0053_drop_chat_journal_push_curator_tables.py

@@ -1,82 +0,0 @@
-"""drop chat / journal / push / curator / weather tables
-
-Revision ID: 0053
-Revises: 0052
-Create Date: 2026-05-27
-
-Phase 9 of the MCP-first pivot. The Python models for these tables were
-deleted in Phase 8 (commit 91bafb6); this migration drops the orphan
-SQL tables and cleans up dead per-user setting rows.
-
-Hard-cutover: existing rows in these tables are discarded. The
-accompanying spec at docs/superpowers/specs/2026-05-26-mcp-first-pivot-design.md
-explicitly accepted this loss.
-"""
-from alembic import op
-
-
-revision = "0053"
-down_revision = "0052"
-branch_labels = None
-depends_on = None
-
-
-# Order: junction tables first so the parent tables don't trip FK drops
-# even with CASCADE — keeps the migration readable.
-_DEAD_TABLES = [
-    # Moments + junction tables (journal entity links)
-    "moment_notes",
-    "moment_tasks",
-    "moment_places",
-    "moment_people",
-    "moment_embeddings",
-    "moments",
-    # Chat / generation telemetry
-    "generation_tool_log",
-    "messages",
-    "conversations",
-    # Curator approval queue
-    "pending_curator_actions",
-    # Push notifications
-    "push_subscriptions",
-    # Weather cache (journal-prep background fetcher)
-    "weather_cache",
-    # Legacy RSS-item embeddings (pre-MCP pivot, briefly experimented with)
-    "rss_item_embeddings",
-]
-
-
-# Specific setting keys to drop. Anything matching the LIKE patterns in
-# upgrade() is also nuked; the explicit list catches one-off keys that
-# don't fit the namespaced patterns.
-_DEAD_SETTING_KEYS = [
-    "default_model",
-    "background_model",
-    "assistant_name",
-    "auto_consolidate_tasks",
-    "chat_retention_days",
-    "think_enabled",
-    "rag_default_scope",
-]
-
-
-def upgrade() -> None:
-    for table in _DEAD_TABLES:
-        op.execute(f"DROP TABLE IF EXISTS {table} CASCADE")
-
-    keys_csv = ",".join(f"'{k}'" for k in _DEAD_SETTING_KEYS)
-    op.execute(
-        "DELETE FROM settings WHERE "
-        "key LIKE 'voice_%' OR "
-        "key LIKE 'journal_%' OR "
-        "key LIKE 'briefing_%' OR "
-        "key LIKE 'curator_%' OR "
-        f"key IN ({keys_csv})"
-    )
-
-
-def downgrade() -> None:
-    raise NotImplementedError(
-        "No downgrade — hard cutover per the MCP-first pivot spec. "
-        "Rolling back is not supported at the database layer."
-    )

alembic/versions/0054_drop_image_cache.py

@@ -1,26 +0,0 @@
-"""drop image_cache table
-
-Revision ID: 0054
-Revises: 0053
-Create Date: 2026-05-27
-
-The image cache was wired into the LLM image-search tool (removed in Phase 8).
-With no producer or consumer left, the table is dropped here.
-"""
-from alembic import op
-
-
-revision = "0054"
-down_revision = "0053"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.execute("DROP TABLE IF EXISTS image_cache CASCADE")
-
-
-def downgrade() -> None:
-    raise NotImplementedError(
-        "No downgrade — hard cutover per the MCP-first pivot spec."
-    )

alembic/versions/0055_rulebook_tables.py

@@ -1,153 +0,0 @@
-"""rulebook tables: rulebooks, rulebook_topics, rules, project_rulebook_subscriptions
-
-Revision ID: 0055
-Revises: 0054
-Create Date: 2026-05-27
-
-Adds the Scribe Rulebook hierarchy as a fourth top-level entity, sibling
-to Project. Rules carry a structural (statement, why, how_to_apply)
-triple. Projects subscribe to Rulebooks (many-to-many). See the design
-doc at docs/superpowers/specs/2026-05-27-scribe-rulebook-design.md.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0055"
-down_revision = "0054"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "rulebooks",
-        sa.Column("id", sa.BigInteger, primary_key=True),
-        sa.Column(
-            "owner_user_id",
-            sa.BigInteger,
-            sa.ForeignKey("users.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column("title", sa.Text, nullable=False),
-        sa.Column("description", sa.Text),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.Column(
-            "updated_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-    )
-    op.create_index("ix_rulebooks_owner", "rulebooks", ["owner_user_id"])
-
-    op.create_table(
-        "rulebook_topics",
-        sa.Column("id", sa.BigInteger, primary_key=True),
-        sa.Column(
-            "rulebook_id",
-            sa.BigInteger,
-            sa.ForeignKey("rulebooks.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column("title", sa.Text, nullable=False),
-        sa.Column("description", sa.Text),
-        sa.Column(
-            "order_index", sa.Integer, nullable=False, server_default="0",
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.Column(
-            "updated_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.UniqueConstraint("rulebook_id", "title", name="uq_topic_per_rulebook"),
-    )
-    op.create_index(
-        "ix_rulebook_topics_rulebook", "rulebook_topics", ["rulebook_id"],
-    )
-
-    op.create_table(
-        "rules",
-        sa.Column("id", sa.BigInteger, primary_key=True),
-        sa.Column(
-            "topic_id",
-            sa.BigInteger,
-            sa.ForeignKey("rulebook_topics.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column("title", sa.Text, nullable=False),
-        sa.Column("statement", sa.Text, nullable=False),
-        sa.Column("why", sa.Text),
-        sa.Column("how_to_apply", sa.Text),
-        sa.Column(
-            "order_index", sa.Integer, nullable=False, server_default="0",
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.Column(
-            "updated_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.UniqueConstraint("topic_id", "title", name="uq_rule_per_topic"),
-    )
-    op.create_index("ix_rules_topic", "rules", ["topic_id"])
-
-    op.create_table(
-        "project_rulebook_subscriptions",
-        sa.Column(
-            "project_id",
-            sa.BigInteger,
-            sa.ForeignKey("projects.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column(
-            "rulebook_id",
-            sa.BigInteger,
-            sa.ForeignKey("rulebooks.id", ondelete="CASCADE"),
-            nullable=False,
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            nullable=False,
-            server_default=sa.text("now()"),
-        ),
-        sa.PrimaryKeyConstraint("project_id", "rulebook_id"),
-    )
-    op.create_index(
-        "ix_project_rulebook_subs_rulebook",
-        "project_rulebook_subscriptions",
-        ["rulebook_id"],
-    )
-
-
-def downgrade() -> None:
-    op.drop_index(
-        "ix_project_rulebook_subs_rulebook",
-        table_name="project_rulebook_subscriptions",
-    )
-    op.drop_table("project_rulebook_subscriptions")
-    op.drop_index("ix_rules_topic", table_name="rules")
-    op.drop_table("rules")
-    op.drop_index("ix_rulebook_topics_rulebook", table_name="rulebook_topics")
-    op.drop_table("rulebook_topics")
-    op.drop_index("ix_rulebooks_owner", table_name="rulebooks")
-    op.drop_table("rulebooks")

alembic/versions/0056_task_kind.py

@@ -1,35 +0,0 @@
-"""task_kind column on notes: distinguishes plan-tasks from work-tasks
-
-Revision ID: 0056
-Revises: 0055
-Create Date: 2026-05-28
-
-A plan is a Task (a note with non-null status) marked task_kind='plan'.
-The CHECK constraint lands in the same migration as the value set, per the
-'new CHECK-enum values need a same-change migration' rule.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0056"
-down_revision = "0055"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column(
-        "notes",
-        sa.Column(
-            "task_kind", sa.Text(), nullable=False, server_default="work",
-        ),
-    )
-    op.create_check_constraint(
-        "notes_task_kind_check", "notes", "task_kind IN ('work','plan')",
-    )
-
-
-def downgrade() -> None:
-    op.drop_constraint("notes_task_kind_check", "notes", type_="check")
-    op.drop_column("notes", "task_kind")

alembic/versions/0057_soft_delete.py

@@ -1,38 +0,0 @@
-"""soft-delete: deleted_at + deleted_batch_id on 7 tables
-
-Revision ID: 0057
-Revises: 0056
-Create Date: 2026-05-28
-
-Recoverable deletes: each soft-deletable table gains a nullable deleted_at
-timestamp (NULL = live) and a deleted_batch_id (text UUID) stamped per delete
-operation so a cascaded delete restores as a unit. A daily cron purges rows
-past the retention window.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0057"
-down_revision = "0056"
-branch_labels = None
-depends_on = None
-
-_TABLES = (
-    "notes", "events", "projects", "milestones",
-    "rulebooks", "rulebook_topics", "rules",
-)
-
-
-def upgrade() -> None:
-    for t in _TABLES:
-        op.add_column(t, sa.Column("deleted_at", sa.DateTime(timezone=True), nullable=True))
-        op.add_column(t, sa.Column("deleted_batch_id", sa.Text(), nullable=True))
-        op.create_index(f"ix_{t}_deleted_at", t, ["deleted_at"])
-
-
-def downgrade() -> None:
-    for t in reversed(_TABLES):
-        op.drop_index(f"ix_{t}_deleted_at", table_name=t)
-        op.drop_column(t, "deleted_batch_id")
-        op.drop_column(t, "deleted_at")

alembic/versions/0058_rulebook_always_on.py

@@ -1,39 +0,0 @@
-"""rulebook always_on flag
-
-Revision ID: 0058
-Revises: 0057
-Create Date: 2026-06-01
-
-Adds a boolean `always_on` to the `rulebooks` table. Rules from rulebooks
-flagged always_on are loaded at session start by the new
-`list_always_on_rules` MCP tool — they apply regardless of which project
-(if any) is in scope. Seeds the FabledSword family rulebook to always_on
-because that's the cross-project standards rulebook by design.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0058"
-down_revision = "0057"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column(
-        "rulebooks",
-        sa.Column(
-            "always_on",
-            sa.Boolean(),
-            nullable=False,
-            server_default=sa.text("false"),
-        ),
-    )
-    op.execute(
-        "UPDATE rulebooks SET always_on = TRUE WHERE title = 'FabledSword family'"
-    )
-
-
-def downgrade() -> None:
-    op.drop_column("rulebooks", "always_on")

alembic/versions/0059_rule_project_scope.py

@@ -1,49 +0,0 @@
-"""project-scoped rules
-
-Revision ID: 0059
-Revises: 0058
-Create Date: 2026-06-01
-
-Rules can now belong to either a rulebook topic (cross-project standard) or
-a single project (project-scoped). Adds `rules.project_id`, makes `topic_id`
-nullable, and adds a CHECK constraint enforcing exactly-one. The previous
-unique constraint on (topic_id, title) still applies because PostgreSQL
-treats NULL as distinct — two project-scoped rules with the same title and
-NULL topic_id remain unique.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0059"
-down_revision = "0058"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.add_column(
-        "rules",
-        sa.Column(
-            "project_id",
-            sa.BigInteger(),
-            sa.ForeignKey("projects.id", ondelete="CASCADE"),
-            nullable=True,
-        ),
-    )
-    op.alter_column("rules", "topic_id", nullable=True)
-    op.create_index("ix_rules_project_id", "rules", ["project_id"])
-    op.create_check_constraint(
-        "ck_rule_topic_xor_project",
-        "rules",
-        "(topic_id IS NULL) <> (project_id IS NULL)",
-    )
-
-
-def downgrade() -> None:
-    op.drop_constraint("ck_rule_topic_xor_project", "rules", type_="check")
-    op.drop_index("ix_rules_project_id", table_name="rules")
-    # Any rule with NULL topic_id will block re-tightening. Operator must
-    # migrate or delete project-scoped rules before downgrading.
-    op.alter_column("rules", "topic_id", nullable=False)
-    op.drop_column("rules", "project_id")

alembic/versions/0060_project_rule_suppressions.py

@@ -1,73 +0,0 @@
-"""project rule + topic suppressions
-
-Revision ID: 0060
-Revises: 0059
-Create Date: 2026-06-01
-
-Lets a project mute specific rules or whole topics from rulebooks it
-subscribes to, without unsubscribing the rulebook. Two pure many-to-many
-association tables; FKs CASCADE so removing a project / rule / topic
-cleans the suppression rows automatically.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0060"
-down_revision = "0059"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "project_rule_suppressions",
-        sa.Column(
-            "project_id",
-            sa.BigInteger(),
-            sa.ForeignKey("projects.id", ondelete="CASCADE"),
-            primary_key=True,
-            nullable=False,
-        ),
-        sa.Column(
-            "rule_id",
-            sa.BigInteger(),
-            sa.ForeignKey("rules.id", ondelete="CASCADE"),
-            primary_key=True,
-            nullable=False,
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            server_default=sa.text("now()"),
-            nullable=False,
-        ),
-    )
-    op.create_table(
-        "project_topic_suppressions",
-        sa.Column(
-            "project_id",
-            sa.BigInteger(),
-            sa.ForeignKey("projects.id", ondelete="CASCADE"),
-            primary_key=True,
-            nullable=False,
-        ),
-        sa.Column(
-            "topic_id",
-            sa.BigInteger(),
-            sa.ForeignKey("rulebook_topics.id", ondelete="CASCADE"),
-            primary_key=True,
-            nullable=False,
-        ),
-        sa.Column(
-            "created_at",
-            sa.DateTime(timezone=True),
-            server_default=sa.text("now()"),
-            nullable=False,
-        ),
-    )
-
-
-def downgrade() -> None:
-    op.drop_table("project_topic_suppressions")
-    op.drop_table("project_rule_suppressions")

alembic/versions/0061_partial_unique_topic_rule_titles.py

@@ -1,49 +0,0 @@
-"""partial-unique topic/rule titles (ignore soft-deleted rows)
-
-Revision ID: 0061
-Revises: 0060
-Create Date: 2026-06-02
-
-Topics and rules are soft-deleted (SoftDeleteMixin), but uq_topic_per_rulebook
-and uq_rule_per_topic were plain UNIQUE constraints. Trashing a topic/rule
-named "X" then creating a new "X" — or restoring into a reused title slot —
-collided with the dead row and raised an unhandled 500. Replace the full
-UNIQUE constraints with partial unique indexes that only consider live
-(deleted_at IS NULL) rows.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0061"
-down_revision = "0060"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.drop_constraint("uq_topic_per_rulebook", "rulebook_topics", type_="unique")
-    op.create_index(
-        "uq_topic_per_rulebook",
-        "rulebook_topics",
-        ["rulebook_id", "title"],
-        unique=True,
-        postgresql_where=sa.text("deleted_at IS NULL"),
-    )
-    op.drop_constraint("uq_rule_per_topic", "rules", type_="unique")
-    op.create_index(
-        "uq_rule_per_topic",
-        "rules",
-        ["topic_id", "title"],
-        unique=True,
-        postgresql_where=sa.text("deleted_at IS NULL"),
-    )
-
-
-def downgrade() -> None:
-    op.drop_index("uq_rule_per_topic", table_name="rules")
-    op.create_unique_constraint("uq_rule_per_topic", "rules", ["topic_id", "title"])
-    op.drop_index("uq_topic_per_rulebook", table_name="rulebook_topics")
-    op.create_unique_constraint(
-        "uq_topic_per_rulebook", "rulebook_topics", ["rulebook_id", "title"]
-    )

alembic/versions/0062_drop_userprofile_curator_columns.py

@@ -1,41 +0,0 @@
-"""drop dead UserProfile curator columns
-
-Revision ID: 0062
-Revises: 0061
-Create Date: 2026-06-02
-
-learned_summary, observations_raw, and observations_updated_at were written by
-the curator/LLM-profile machinery removed in the Phase-8 MCP pivot. Nothing has
-populated them since; the profile API returned permanently-empty fields. Drop
-the columns.
-"""
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects import postgresql
-
-
-revision = "0062"
-down_revision = "0061"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.drop_column("user_profiles", "learned_summary")
-    op.drop_column("user_profiles", "observations_raw")
-    op.drop_column("user_profiles", "observations_updated_at")
-
-
-def downgrade() -> None:
-    op.add_column(
-        "user_profiles",
-        sa.Column("observations_updated_at", sa.DateTime(timezone=True), nullable=True),
-    )
-    op.add_column(
-        "user_profiles",
-        sa.Column("observations_raw", postgresql.JSONB(), nullable=True),
-    )
-    op.add_column(
-        "user_profiles",
-        sa.Column("learned_summary", sa.Text(), nullable=True),
-    )

alembic/versions/0063_drop_project_auto_summary.py

@@ -1,34 +0,0 @@
-"""drop dead Project.auto_summary columns
-
-Revision ID: 0063
-Revises: 0062
-Create Date: 2026-06-03
-
-auto_summary + summary_updated_at were written by generate_project_summary
-(Ollama), removed in the MCP pivot. Nothing has populated them since; the
-field was stale-or-NULL. Drop the columns.
-"""
-from alembic import op
-import sqlalchemy as sa
-
-
-revision = "0063"
-down_revision = "0062"
-branch_labels = None
-depends_on = None
-
-
-def upgrade() -> None:
-    op.drop_column("projects", "auto_summary")
-    op.drop_column("projects", "summary_updated_at")
-
-
-def downgrade() -> None:
-    op.add_column(
-        "projects",
-        sa.Column("summary_updated_at", sa.DateTime(timezone=True), nullable=True),
-    )
-    op.add_column(
-        "projects",
-        sa.Column("auto_summary", sa.Text(), nullable=True),
-    )

ci-requirements.md

@@ -1,49 +0,0 @@
-# CI Requirements — FabledScribe
-
-> Spec lives in [`docs/process.md`](https://git.fabledsword.com/bvandeusen/CI-runner/src/branch/main/docs/process.md)
-> in the CI-Runner repo.
-
-## Runtime image
-
-```
-git.fabledsword.com/bvandeusen/ci-python:3.14
-```
-
-Used by all four jobs in `.forgejo/workflows/ci.yml`: typecheck (Vue/TS),
-lint (ruff), test (pytest), build (docker buildx).
-
-## Image deps used
-
-- python 3.14
-- node 24 (used for `npm ci` + `vue-tsc` in the typecheck job, and as the
-  frontend builder stage inside the production `Dockerfile`)
-- ruff (lint job runs `ruff check src/` with zero install overhead)
-- docker CLI + buildx (build job pushes the production image to the
-  Forgejo registry)
-
-## Per-job tool installs
-
-Anything CI installs at job time that isn't in the image. Promotion
-candidates if more than one project needs them.
-
-- `uv` — installed inline in the test job (`curl -LsSf
-  https://astral.sh/uv/install.sh | sh`). **Temporary**: belongs in the
-  ci-python image so every consumer doesn't re-install on cold start.
-  Tracked at [CI-Runner](https://git.fabledsword.com/bvandeusen/CI-runner).
-- `http-ece` is `--no-build-isolation`-installed before the editable
-  package install because http-ece doesn't declare `setuptools` as a
-  build dep and uv creates bare venvs without it. Not promotion-worthy
-  (one project, one wheel).
-
-## Notes
-
-- Production runtime image (`Dockerfile`) also tracks Python 3.14 — the
-  CI image and runtime image stay aligned by design so test results are
-  representative.
-- Build wall time: dominated by `pytest` (full async test suite). Cold
-  ci-python pulls add ~30s; not a blocker.
-- Registry-backed BuildKit layer cache (`type=registry,ref=…:cache,mode=max`)
-  gives ~80% speedup on warm builds — see the build job comment.
-- `pyproject.toml` pins `requires-python = ">=3.14"` to match the CI +
-  runtime target; lockfile (`uv.lock`) is committed and resolves against
-  Python 3.14.

docker-compose.prod.yml

@@ -1,14 +1,16 @@
 services:
   app:
-    image: git.fabledsword.com/bvandeusen/fabledscribe:latest
+    image: git.fabledsword.com/bvandeusen/fabledassistant:latest
     environment:
-      DATABASE_URL: "postgresql+asyncpg://scribe:${DB_PASSWORD}@db:5432/scribe"
+      DATABASE_URL: "postgresql+asyncpg://fabled:${DB_PASSWORD}@db:5432/fabledassistant"
       SECRET_KEY: "${SECRET_KEY}"
+      OLLAMA_URL: "http://ollama:11434"
+      OLLAMA_MODEL: "${OLLAMA_MODEL:-llama3.1}"
       LOG_LEVEL: "${LOG_LEVEL:-INFO}"
       TRUST_PROXY_HEADERS: "true"
       SECURE_COOKIES: "true"
     networks:
-      - scribe_backend
+      - fabledassistant_backend
     healthcheck:
       test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/api/health')"]
       interval: 30s
@@ -22,34 +24,58 @@ services:
 
   db:
     image: postgres:16-alpine
-    stop_grace_period: 120s
     volumes:
       - pgdata:/var/lib/postgresql/data
     environment:
-      POSTGRES_USER: scribe
+      POSTGRES_USER: fabled
       POSTGRES_PASSWORD: "${DB_PASSWORD}"
-      POSTGRES_DB: scribe
+      POSTGRES_DB: fabledassistant
     networks:
-      - scribe_backend
-    # Lenient by design: a transient host exec/healthcheck stall (incident:
-    # runc setns failures -> "unhealthy" -> SIGKILL -> crash loop) must never
-    # escalate to killing the DB. Health here only gates app startup order.
+      - fabledassistant_backend
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U scribe"]
-      interval: 30s
-      timeout: 10s
-      retries: 10
-      start_period: 180s
+      test: ["CMD-SHELL", "pg_isready -U fabled"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
     deploy:
       restart_policy:
         condition: on-failure
-        delay: 10s
-        max_attempts: 0
-        window: 120s
+        max_attempts: 5
+
+  ollama:
+    image: ollama/ollama
+    volumes:
+      - ollama_models:/root/.ollama
+    networks:
+      - fabledassistant_backend
+    environment:
+      OLLAMA_MAX_LOADED_MODELS: "2"
+      OLLAMA_KEEP_ALIVE: "30m"
+      OLLAMA_FLASH_ATTENTION: "1"
+    healthcheck:
+      test: ["CMD-SHELL", "ollama list || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 30s
+    deploy:
+      placement:
+        constraints:
+          - node.role == worker
+      resources:
+        reservations:
+          devices:
+            - driver: nvidia
+              count: all
+              capabilities: [gpu]
+      restart_policy:
+        condition: on-failure
+        max_attempts: 5
 
 volumes:
   pgdata:
+  ollama_models:
 
 networks:
-  scribe_backend:
+  fabledassistant_backend:
     driver: overlay

docker-compose.quickstart.yml

@@ -6,8 +6,7 @@
 #   1. Download this file
 #   2. docker compose -f docker-compose.quickstart.yml up -d
 #   3. Open http://localhost:5000 — the first account registered becomes admin
-#   4. Go to Settings → MCP Access and connect Claude (Code or Desktop) via the
-#      bearer-token URL shown there.
+#   4. Go to Settings → General to pull an LLM model (qwen3:8b or llama3.1:8b are good starting points)
 #
 # Set SECRET_KEY via environment variable or a .env file alongside this file:
 #   SECRET_KEY=your-random-secret-here
@@ -18,14 +17,18 @@ services:
     ports:
       - "5000:5000"
     environment:
-      DATABASE_URL: "postgresql+asyncpg://scribe:scribe@db:5432/scribe"
+      DATABASE_URL: "postgresql+asyncpg://fabled:fabled@db:5432/fabledassistant"
       SECRET_KEY: "${SECRET_KEY:-change-me-in-production}"
+      OLLAMA_URL: "http://ollama:11434"
+      OLLAMA_MODEL: "${OLLAMA_MODEL:-llama3.1:8b}"
       LOG_LEVEL: "${LOG_LEVEL:-INFO}"
     volumes:
       - app_data:/data
     depends_on:
       db:
         condition: service_healthy
+      ollama:
+        condition: service_healthy
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/api/health')"]
@@ -36,23 +39,44 @@ services:
 
   db:
     image: postgres:16-alpine
-    stop_grace_period: 120s
     volumes:
       - pgdata:/var/lib/postgresql/data
     environment:
-      POSTGRES_USER: scribe
-      POSTGRES_PASSWORD: scribe
-      POSTGRES_DB: scribe
-    # Lenient by design: a transient host exec/healthcheck stall must never
-    # escalate to killing the DB. Health here only gates app startup order.
+      POSTGRES_USER: fabled
+      POSTGRES_PASSWORD: fabled
+      POSTGRES_DB: fabledassistant
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U scribe"]
+      test: ["CMD-SHELL", "pg_isready -U fabled"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+  ollama:
+    image: ollama/ollama
+    volumes:
+      - ollama_models:/root/.ollama
+    environment:
+      OLLAMA_MAX_LOADED_MODELS: "2"
+      OLLAMA_KEEP_ALIVE: "30m"
+      OLLAMA_FLASH_ATTENTION: "1"
+    healthcheck:
+      test: ["CMD-SHELL", "ollama list > /dev/null 2>&1"]
       interval: 30s
       timeout: 10s
-      retries: 10
-      start_period: 180s
+      retries: 5
+      start_period: 15s
     restart: unless-stopped
+    # Uncomment to enable NVIDIA GPU passthrough (requires nvidia-container-toolkit):
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: nvidia
+    #           count: all
+    #           capabilities: [gpu]
 
 volumes:
   app_data:
   pgdata:
+  ollama_models:

docker-compose.yml

@@ -6,16 +6,25 @@ services:
     depends_on:
       db:
         condition: service_healthy
+      ollama:
+        condition: service_started
     volumes:
       - app_data:/data
       # To use a bind mount instead (gives direct host access to all app data):
       # - ./data:/data
     environment:
-      DATABASE_URL: "postgresql+asyncpg://${POSTGRES_USER:-scribe}:${POSTGRES_PASSWORD:-scribe}@db:5432/${POSTGRES_DB:-scribe}"
+      DATABASE_URL: "postgresql+asyncpg://${POSTGRES_USER:-fabled}:${POSTGRES_PASSWORD:-fabled}@db:5432/${POSTGRES_DB:-fabledassistant}"
+      OLLAMA_URL: "http://ollama:11434"
+      OLLAMA_MODEL: "${OLLAMA_MODEL:-qwen3:8B}"
       SECRET_KEY: "${SECRET_KEY:-dev-secret-change-me}"
-      # Uncomment if you have a SearXNG instance you want to surface in the
-      # Integrations tab as a configured web-search backend:
+      # Uncomment and set to enable web research and image search via SearXNG:
       # SEARXNG_URL: "http://searxng:8080"
+      # IMAGE_CACHE_DIR: /data/images  # default, change if using a different mount path
+      # IMAGE_MAX_BYTES: "5242880"     # 5 MB per image, adjust if needed
+      # Push notifications (VAPID keys - generate with: python -c "from py_vapid import Vapid01; v=Vapid01(); v.generate_keys(); print(v.private_key, v.public_key)")
+      VAPID_PRIVATE_KEY: "${VAPID_PRIVATE_KEY:-}"
+      VAPID_PUBLIC_KEY: "${VAPID_PUBLIC_KEY:-}"
+      VAPID_CLAIMS_SUB: "${VAPID_CLAIMS_SUB:-mailto:admin@fabledassistant.local}"
     healthcheck:
       test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/api/health')"]
       interval: 10s
@@ -25,23 +34,37 @@ services:
 
   db:
     image: postgres:16-alpine
-    stop_grace_period: 120s
-    restart: unless-stopped
     volumes:
       - pgdata:/var/lib/postgresql/data
     environment:
-      POSTGRES_USER: ${POSTGRES_USER:-scribe}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-scribe}
-      POSTGRES_DB: ${POSTGRES_DB:-scribe}
-    # Lenient by design: a transient host exec/healthcheck stall must never
-    # escalate to killing the DB. Health here only gates app startup order.
+      POSTGRES_USER: ${POSTGRES_USER:-fabled}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-fabled}
+      POSTGRES_DB: ${POSTGRES_DB:-fabledassistant}
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-scribe}"]
-      interval: 30s
-      timeout: 10s
-      retries: 10
-      start_period: 180s
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-fabled}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  ollama:
+    image: ollama/ollama
+    volumes:
+      - ollama_models:/root/.ollama
+    environment:
+      OLLAMA_MAX_LOADED_MODELS: "2"
+      OLLAMA_NUM_PARALLEL: "2"
+      OLLAMA_KEEP_ALIVE: "30m"
+      OLLAMA_FLASH_ATTENTION: "1"
+    # GPU reservation commented out — no nvidia-container-toolkit on this host
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: nvidia
+    #           count: all
+    #           capabilities: [gpu]
 
 volumes:
   pgdata:
+  ollama_models:
   app_data:

docs/2026-03-23-fable-mcp-design.md

@@ -12,7 +12,7 @@ A Python MCP (Model Context Protocol) server that lets Claude directly interface
 
 The work is split into two sub-projects:
 
-1. **Fable API Key Feature** — additions to the main `scribe` project to support bearer token authentication
+1. **Fable API Key Feature** — additions to the main `fabledassistant` project to support bearer token authentication
 2. **Fable MCP Server** — a new standalone Python package at `fable-mcp/` in the same repo root
 
 A third sub-project (Forgejo MCP for CI/CD automation) is planned as a follow-on after the Fable MCP is working.
@@ -134,7 +134,7 @@ The MCP tool reads tokens until it receives `type: "done"`, then returns `respon
 
 ### Location
 
-`fable-mcp/` at the repository root, alongside `src/`, `frontend/`, `alembic/`. It is **not** part of the main Docker build and has no import relationship with `scribe`. It will be extracted to its own Forgejo repo once stable.
+`fable-mcp/` at the repository root, alongside `src/`, `frontend/`, `alembic/`. It is **not** part of the main Docker build and has no import relationship with `fabledassistant`. It will be extracted to its own Forgejo repo once stable.
 
 ### Package Structure
 
@@ -256,7 +256,7 @@ Claude Code spawns the process over stdio automatically. No Docker, no daemon.
 
 ## Build & Repo Plan
 
-1. Implement and test within `scribe/fable-mcp/`
+1. Implement and test within `fabledassistant/fable-mcp/`
 2. Once stable, extract to a new Forgejo repo (`bvandeusen/fable-mcp`)
 3. Forgejo MCP (Gitea MCP) added as a second MCP server to automate build/push/config workflows — separate spec when ready
 

docs/2026-03-23-fable-mcp-plan.md

@@ -6,7 +6,7 @@
 
 **Architecture:** Phase 1 adds bearer token auth to the existing Quart app (new `api_keys` table, updated `_check_auth`, settings UI tab). Phase 2 is a standalone `fable-mcp/` Python package using the `mcp[cli]` SDK that calls the Fable HTTP API via `httpx`. The two phases are sequential — Phase 2 can be built/tested independently using a write-scoped API key once Phase 1 is done.
 
-**Deployment decision:** `fable-mcp/` stays permanently inside the `scribe` repo. It will always be versioned alongside the backend it targets. Future Task A will serve the package from the running Fable Docker image so users can install it directly from their instance.
+**Deployment decision:** `fable-mcp/` stays permanently inside the `fabledassistant` repo. It will always be versioned alongside the backend it targets. Future Task A will serve the package from the running Fable Docker image so users can install it directly from their instance.
 
 **Tech Stack:** Python 3.12, Quart (Phase 1); `mcp[cli]`, `httpx`, `python-dotenv` (Phase 2); Vue 3 + TypeScript (Settings UI); pytest for both.
 
@@ -23,16 +23,16 @@
 | Action | File | Purpose |
 |--------|------|---------|
 | Create | `alembic/versions/0027_add_api_keys.py` | DB migration for `api_keys` table |
-| Create | `src/scribe/models/api_key.py` | `ApiKey` SQLAlchemy model |
-| Modify | `src/scribe/models/__init__.py` | Export `ApiKey` |
-| Create | `src/scribe/services/api_keys.py` | create/list/revoke/lookup service functions |
-| Modify | `src/scribe/auth.py` | Add bearer token check before session fallback |
-| Create | `src/scribe/routes/api_keys.py` | GET/POST/DELETE `/api/api-keys` blueprint |
-| Modify | `src/scribe/app.py` | Register `api_keys_bp` and `search_bp` |
-| Modify | `src/scribe/services/chat.py:17-30` | Add `conversation_type` param to `create_conversation` |
-| Modify | `src/scribe/services/chat.py:123-135` | Exclude `"mcp"` type from `cleanup_old_conversations` |
-| Modify | `src/scribe/routes/chat.py:73-79` | Pass `conversation_type` from POST body |
-| Create | `src/scribe/routes/search.py` | `GET /api/search` semantic search endpoint |
+| Create | `src/fabledassistant/models/api_key.py` | `ApiKey` SQLAlchemy model |
+| Modify | `src/fabledassistant/models/__init__.py` | Export `ApiKey` |
+| Create | `src/fabledassistant/services/api_keys.py` | create/list/revoke/lookup service functions |
+| Modify | `src/fabledassistant/auth.py` | Add bearer token check before session fallback |
+| Create | `src/fabledassistant/routes/api_keys.py` | GET/POST/DELETE `/api/api-keys` blueprint |
+| Modify | `src/fabledassistant/app.py` | Register `api_keys_bp` and `search_bp` |
+| Modify | `src/fabledassistant/services/chat.py:17-30` | Add `conversation_type` param to `create_conversation` |
+| Modify | `src/fabledassistant/services/chat.py:123-135` | Exclude `"mcp"` type from `cleanup_old_conversations` |
+| Modify | `src/fabledassistant/routes/chat.py:73-79` | Pass `conversation_type` from POST body |
+| Create | `src/fabledassistant/routes/search.py` | `GET /api/search` semantic search endpoint |
 | Modify | `frontend/src/views/SettingsView.vue` | Add "API Keys" tab |
 | Create | `tests/test_api_keys.py` | Unit tests for service + auth |
 | Create | `tests/test_search_route.py` | Unit test for search endpoint |
@@ -42,13 +42,13 @@
 ### Task 1: ApiKey model + migration
 
 **Files:**
-- Create: `src/scribe/models/api_key.py`
+- Create: `src/fabledassistant/models/api_key.py`
 - Create: `alembic/versions/0027_add_api_keys.py`
-- Modify: `src/scribe/models/__init__.py`
+- Modify: `src/fabledassistant/models/__init__.py`
 
 - [ ] **Step 1: Write the model**
 
-Create `src/scribe/models/api_key.py`:
+Create `src/fabledassistant/models/api_key.py`:
 
 ```python
 from datetime import datetime, timezone
@@ -56,8 +56,8 @@ from datetime import datetime, timezone
 from sqlalchemy import DateTime, ForeignKey, Index, Integer, Text
 from sqlalchemy.orm import Mapped, mapped_column
 
-from scribe.models import Base
-from scribe.models.base import CreatedAtMixin
+from fabledassistant.models import Base
+from fabledassistant.models.base import CreatedAtMixin
 
 
 class ApiKey(Base, CreatedAtMixin):
@@ -97,10 +97,10 @@ class ApiKey(Base, CreatedAtMixin):
 
 - [ ] **Step 2: Export from models __init__**
 
-In `src/scribe/models/__init__.py`, add after the last import line:
+In `src/fabledassistant/models/__init__.py`, add after the last import line:
 
 ```python
-from scribe.models.api_key import ApiKey  # noqa: E402, F401
+from fabledassistant.models.api_key import ApiKey  # noqa: E402, F401
 ```
 
 - [ ] **Step 3: Write the migration**
@@ -155,8 +155,8 @@ Expected: `Running upgrade 0026 -> 0027, add api_keys table`
 - [ ] **Step 5: Commit**
 
 ```bash
-git add src/scribe/models/api_key.py \
-        src/scribe/models/__init__.py \
+git add src/fabledassistant/models/api_key.py \
+        src/fabledassistant/models/__init__.py \
         alembic/versions/0027_add_api_keys.py
 git commit -m "feat: add ApiKey model and migration 0027"
 ```
@@ -166,7 +166,7 @@ git commit -m "feat: add ApiKey model and migration 0027"
 ### Task 2: ApiKey service
 
 **Files:**
-- Create: `src/scribe/services/api_keys.py`
+- Create: `src/fabledassistant/services/api_keys.py`
 - Create: `tests/test_api_keys.py` (service tests)
 
 - [ ] **Step 1: Write the failing tests**
@@ -181,7 +181,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
 
 import pytest
 
-from scribe.services.api_keys import (
+from fabledassistant.services.api_keys import (
     _hash_key,
     generate_key,
     create_api_key,
@@ -212,7 +212,7 @@ def test_hash_key_is_sha256():
 def test_generate_key_prefix():
     key = "fmcp_abcdefghijklmnop"
     # prefix is first 12 chars of the full key
-    from scribe.services.api_keys import _key_prefix
+    from fabledassistant.services.api_keys import _key_prefix
     assert _key_prefix(key) == "fmcp_abcdefg"  # first 12 chars
 
 
@@ -222,7 +222,7 @@ async def test_create_api_key_returns_full_key():
     mock_key_obj.id = 1
     mock_key_obj.to_dict.return_value = {"id": 1, "name": "test", "scope": "read", "key_prefix": "fmcp_xxx"}
 
-    with patch("scribe.services.api_keys.async_session") as mock_session_ctx:
+    with patch("fabledassistant.services.api_keys.async_session") as mock_session_ctx:
         mock_session = AsyncMock()
         mock_session.__aenter__ = AsyncMock(return_value=mock_session)
         mock_session.__aexit__ = AsyncMock(return_value=False)
@@ -238,7 +238,7 @@ async def test_create_api_key_returns_full_key():
 
 @pytest.mark.asyncio
 async def test_lookup_key_returns_none_for_unknown():
-    with patch("scribe.services.api_keys.async_session") as mock_session_ctx:
+    with patch("fabledassistant.services.api_keys.async_session") as mock_session_ctx:
         mock_session = AsyncMock()
         mock_session.__aenter__ = AsyncMock(return_value=mock_session)
         mock_session.__aexit__ = AsyncMock(return_value=False)
@@ -262,7 +262,7 @@ Expected: `ImportError` or `ModuleNotFoundError` (service doesn't exist yet)
 
 - [ ] **Step 3: Write the service**
 
-Create `src/scribe/services/api_keys.py`:
+Create `src/fabledassistant/services/api_keys.py`:
 
 ```python
 import hashlib
@@ -271,8 +271,8 @@ from datetime import datetime, timezone
 
 from sqlalchemy import select
 
-from scribe.models import async_session
-from scribe.models.api_key import ApiKey
+from fabledassistant.models import async_session
+from fabledassistant.models.api_key import ApiKey
 
 
 def generate_key() -> str:
@@ -365,7 +365,7 @@ Expected: all tests pass
 - [ ] **Step 5: Commit**
 
 ```bash
-git add src/scribe/services/api_keys.py tests/test_api_keys.py
+git add src/fabledassistant/services/api_keys.py tests/test_api_keys.py
 git commit -m "feat: add ApiKey service with create/list/revoke/lookup"
 ```
 
@@ -374,7 +374,7 @@ git commit -m "feat: add ApiKey service with create/list/revoke/lookup"
 ### Task 3: Auth middleware — bearer token support
 
 **Files:**
-- Modify: `src/scribe/auth.py`
+- Modify: `src/fabledassistant/auth.py`
 - Modify: `tests/test_api_keys.py` (add auth middleware tests)
 
 - [ ] **Step 1: Add auth middleware tests**
@@ -400,7 +400,7 @@ def test_scope_validation():
 async def test_bearer_token_path_sets_g_user(monkeypatch):
     """Valid bearer token authenticates and sets g.user and g.api_key."""
     from unittest.mock import AsyncMock, MagicMock
-    from scribe.auth import _check_auth
+    from fabledassistant.auth import _check_auth
 
     # Mock ApiKey object
     fake_key = MagicMock()
@@ -411,8 +411,8 @@ async def test_bearer_token_path_sets_g_user(monkeypatch):
     fake_user = MagicMock()
     fake_user.role = "user"
 
-    monkeypatch.setattr("scribe.auth.lookup_key", AsyncMock(return_value=fake_key))
-    monkeypatch.setattr("scribe.auth.get_user_by_id", AsyncMock(return_value=fake_user))
+    monkeypatch.setattr("fabledassistant.auth.lookup_key", AsyncMock(return_value=fake_key))
+    monkeypatch.setattr("fabledassistant.auth.get_user_by_id", AsyncMock(return_value=fake_user))
 
     called_with_user = {}
 
@@ -434,7 +434,7 @@ async def test_bearer_token_path_sets_g_user(monkeypatch):
     async with app.test_request_context("/test", method="GET",
                                         headers={"Authorization": "Bearer fmcp_valid"}):
         # Just verify _check_auth calls lookup_key with the right token
-        import scribe.auth as auth_module
+        import fabledassistant.auth as auth_module
         auth_module.lookup_key.assert_called_with  # callable
 
 
@@ -442,7 +442,7 @@ async def test_bearer_token_path_sets_g_user(monkeypatch):
 async def test_read_only_key_blocked_on_post():
     """Read-only API key returns 403 on non-GET requests."""
     from unittest.mock import AsyncMock, MagicMock
-    from scribe.auth import _check_auth
+    from fabledassistant.auth import _check_auth
     from quart import Quart
 
     fake_key = MagicMock()
@@ -459,8 +459,8 @@ async def test_read_only_key_blocked_on_post():
                                  headers={"Authorization": "Bearer fmcp_readonly"}),
     ):
         from unittest.mock import patch
-        with patch("scribe.auth.lookup_key", AsyncMock(return_value=fake_key)), \
-             patch("scribe.auth.get_user_by_id", AsyncMock(return_value=fake_user)):
+        with patch("fabledassistant.auth.lookup_key", AsyncMock(return_value=fake_key)), \
+             patch("fabledassistant.auth.get_user_by_id", AsyncMock(return_value=fake_user)):
 
             async def dummy():
                 return "ok"
@@ -481,15 +481,15 @@ docker compose run --rm app pytest tests/test_api_keys.py -v
 
 - [ ] **Step 3: Update auth.py**
 
-Replace `src/scribe/auth.py` with:
+Replace `src/fabledassistant/auth.py` with:
 
 ```python
 import functools
 
 from quart import g, jsonify, request, session
 
-from scribe.services.auth import get_user_by_id
-from scribe.services.api_keys import lookup_key
+from fabledassistant.services.auth import get_user_by_id
+from fabledassistant.services.api_keys import lookup_key
 
 
 def _check_auth(f, required_role: str | None = None):
@@ -556,7 +556,7 @@ Expected: all existing tests still pass
 - [ ] **Step 5: Commit**
 
 ```bash
-git add src/scribe/auth.py tests/test_api_keys.py
+git add src/fabledassistant/auth.py tests/test_api_keys.py
 git commit -m "feat: add bearer token auth to _check_auth, falls back to session"
 ```
 
@@ -565,18 +565,18 @@ git commit -m "feat: add bearer token auth to _check_auth, falls back to session
 ### Task 4: API key routes + app registration
 
 **Files:**
-- Create: `src/scribe/routes/api_keys.py`
-- Modify: `src/scribe/app.py`
+- Create: `src/fabledassistant/routes/api_keys.py`
+- Modify: `src/fabledassistant/app.py`
 
 - [ ] **Step 1: Write the routes**
 
-Create `src/scribe/routes/api_keys.py`:
+Create `src/fabledassistant/routes/api_keys.py`:
 
 ```python
 from quart import Blueprint, jsonify, request
 
-from scribe.auth import login_required, get_current_user_id
-from scribe.services.api_keys import create_api_key, list_api_keys, revoke_api_key
+from fabledassistant.auth import login_required, get_current_user_id
+from fabledassistant.services.api_keys import create_api_key, list_api_keys, revoke_api_key
 
 api_keys_bp = Blueprint("api_keys", __name__, url_prefix="/api/api-keys")
 
@@ -619,10 +619,10 @@ async def revoke_key_route(key_id: int):
 
 - [ ] **Step 2: Register in app.py**
 
-In `src/scribe/app.py`, add the import alongside the other route imports:
+In `src/fabledassistant/app.py`, add the import alongside the other route imports:
 
 ```python
-from scribe.routes.api_keys import api_keys_bp
+from fabledassistant.routes.api_keys import api_keys_bp
 ```
 
 And add the registration line after `app.register_blueprint(users_bp)`:
@@ -651,7 +651,7 @@ curl -s http://localhost:8080/api/auth/me \
 - [ ] **Step 4: Commit**
 
 ```bash
-git add src/scribe/routes/api_keys.py src/scribe/app.py
+git add src/fabledassistant/routes/api_keys.py src/fabledassistant/app.py
 git commit -m "feat: add API key CRUD routes and register blueprint"
 ```
 
@@ -660,14 +660,14 @@ git commit -m "feat: add API key CRUD routes and register blueprint"
 ### Task 5: Conversation type wiring
 
 **Files:**
-- Modify: `src/scribe/services/chat.py` (lines 17-30 and 123-135)
-- Modify: `src/scribe/routes/chat.py` (lines 73-79)
+- Modify: `src/fabledassistant/services/chat.py` (lines 17-30 and 123-135)
+- Modify: `src/fabledassistant/routes/chat.py` (lines 73-79)
 
 Note: `Conversation.conversation_type` already exists in the model. `list_conversations` already filters by `conv_type`. This task only wires up creation and retention exclusion.
 
 - [ ] **Step 1: Update `create_conversation` service**
 
-In `src/scribe/services/chat.py`, change the function signature at line 17:
+In `src/fabledassistant/services/chat.py`, change the function signature at line 17:
 
 ```python
 async def create_conversation(
@@ -692,7 +692,7 @@ async def create_conversation(
 
 - [ ] **Step 2: Update `cleanup_old_conversations` to exclude "mcp"**
 
-In `src/scribe/services/chat.py`, update the WHERE clause at line 130:
+In `src/fabledassistant/services/chat.py`, update the WHERE clause at line 130:
 
 ```python
 result = await session.execute(
@@ -708,7 +708,7 @@ result = await session.execute(
 
 - [ ] **Step 3: Update the POST route to accept conversation_type**
 
-In `src/scribe/routes/chat.py`, update `create_conversation_route` (around line 73):
+In `src/fabledassistant/routes/chat.py`, update `create_conversation_route` (around line 73):
 
 ```python
 @chat_bp.route("/conversations", methods=["POST"])
@@ -737,7 +737,7 @@ Expected: all tests pass
 - [ ] **Step 5: Commit**
 
 ```bash
-git add src/scribe/services/chat.py src/scribe/routes/chat.py
+git add src/fabledassistant/services/chat.py src/fabledassistant/routes/chat.py
 git commit -m "feat: wire conversation_type through create_conversation, exclude mcp from retention sweep"
 ```
 
@@ -746,8 +746,8 @@ git commit -m "feat: wire conversation_type through create_conversation, exclude
 ### Task 6: Semantic search endpoint
 
 **Files:**
-- Create: `src/scribe/routes/search.py`
-- Modify: `src/scribe/app.py`
+- Create: `src/fabledassistant/routes/search.py`
+- Modify: `src/fabledassistant/app.py`
 - Create: `tests/test_search_route.py`
 
 - [ ] **Step 1: Write the failing test**
@@ -762,7 +762,7 @@ from unittest.mock import patch, AsyncMock
 
 def test_content_type_mapping():
     """Verify content_type string maps to correct is_task value."""
-    from scribe.routes.search import _content_type_to_is_task
+    from fabledassistant.routes.search import _content_type_to_is_task
     assert _content_type_to_is_task("note") is False
     assert _content_type_to_is_task("task") is True
     assert _content_type_to_is_task("all") is None
@@ -779,13 +779,13 @@ Expected: `ImportError` (module doesn't exist yet)
 
 - [ ] **Step 3: Write the route**
 
-Create `src/scribe/routes/search.py`:
+Create `src/fabledassistant/routes/search.py`:
 
 ```python
 from quart import Blueprint, jsonify, request
 
-from scribe.auth import login_required, get_current_user_id
-from scribe.services.embeddings import semantic_search_notes
+from fabledassistant.auth import login_required, get_current_user_id
+from fabledassistant.services.embeddings import semantic_search_notes
 
 search_bp = Blueprint("search", __name__, url_prefix="/api/search")
 
@@ -834,9 +834,9 @@ Note: check `services/embeddings.py` to confirm the return type of `semantic_sea
 
 - [ ] **Step 4: Register in app.py**
 
-Add to imports in `src/scribe/app.py`:
+Add to imports in `src/fabledassistant/app.py`:
 ```python
-from scribe.routes.search import search_bp
+from fabledassistant.routes.search import search_bp
 ```
 
 Add registration:
@@ -855,8 +855,8 @@ Expected: all tests pass
 - [ ] **Step 6: Commit**
 
 ```bash
-git add src/scribe/routes/search.py \
-        src/scribe/app.py \
+git add src/fabledassistant/routes/search.py \
+        src/fabledassistant/app.py \
         tests/test_search_route.py
 git commit -m "feat: add GET /api/search semantic search endpoint"
 ```
@@ -1905,7 +1905,7 @@ async def send_message(
         return f"Error: {e}"
 ```
 
-Note: verify the Fable message POST endpoint path by checking `src/scribe/routes/chat.py` — search for the route that accepts a user message and triggers generation. Adjust `/api/chat/conversations/{conv_id}/messages` if the actual path differs.
+Note: verify the Fable message POST endpoint path by checking `src/fabledassistant/routes/chat.py` — search for the route that accepts a user message and triggers generation. Adjust `/api/chat/conversations/{conv_id}/messages` if the actual path differs.
 
 - [ ] **Step 4: Run tests**
 

docs/2026-03-29-voice-s2s-design.md

@@ -39,20 +39,20 @@
 
 ## New Backend Files
 
-### `src/scribe/services/stt.py`
+### `src/fabledassistant/services/stt.py`
 Lazy singleton `WhisperModel` loader. Public API:
 - `load_stt_model()` — called at startup via `asyncio.create_task`
 - `transcribe(audio_bytes, mime_type) -> str` — runs in `run_in_executor`; writes bytes to `NamedTemporaryFile`, returns concatenated segment text
 - `stt_available() -> bool`
 
-### `src/scribe/services/tts.py`
+### `src/fabledassistant/services/tts.py`
 Lazy singleton `KPipeline` loader. Public API:
 - `load_tts_model()` — called at startup
 - `synthesise(text, voice, speed) -> bytes` — runs in `run_in_executor`; returns WAV bytes (24kHz, 16-bit mono)
 - `list_voices() -> list[dict]` — returns static list of known Kokoro voice IDs + labels
 - `tts_available() -> bool`
 
-### `src/scribe/routes/voice.py`
+### `src/fabledassistant/routes/voice.py`
 Blueprint at `/api/voice`, all routes `@login_required`.
 
 | Endpoint | Method | Description |
@@ -66,27 +66,27 @@ Blueprint at `/api/voice`, all routes `@login_required`.
 
 ## Modified Backend Files
 
-### `src/scribe/app.py`
+### `src/fabledassistant/app.py`
 - Register `voice_bp` blueprint
 - In `startup()`: `asyncio.create_task(load_stt_model())` + `asyncio.create_task(load_tts_model())` when `VOICE_ENABLED`
 
-### `src/scribe/config.py`
+### `src/fabledassistant/config.py`
 - Add 4 new env var attributes
 - Add validation in `validate()`
 
-### `src/scribe/services/llm.py`
+### `src/fabledassistant/services/llm.py`
 - Add `voice_mode: bool = False` and `voice_speech_style: str = "conversational"` to `build_context()`
 - When `voice_mode=True`, prepend: *"Respond naturally as if speaking aloud. No markdown, bullet points, headers, or code blocks. Complete sentences only."*
 - Append style modifier based on `voice_speech_style`
 
-### `src/scribe/services/generation_task.py`
+### `src/fabledassistant/services/generation_task.py`
 - Add `voice_mode: bool = False` to `run_generation()`
 - Read `voice_speech_style` from settings when voice_mode; pass both to `build_context()`
 
-### `src/scribe/routes/chat.py`
+### `src/fabledassistant/routes/chat.py`
 - Allow `"voice"` in `conversation_type` whitelist
 
-### `src/scribe/services/chat.py`
+### `src/fabledassistant/services/chat.py`
 - Exclude `conversation_type == "voice"` from auto-cleanup retention
 
 ---

docs/android-app.md

@@ -0,0 +1,73 @@
+# Android Companion App
+
+The Android companion app lives in a separate repository at `/home/bvandeusen/Nextcloud/Projects/fabled_app`.
+
+## Stack
+
+- Flutter + Dart
+- Riverpod (state management)
+- GoRouter (navigation)
+- Dio (HTTP client)
+- PersistCookieJar (session persistence)
+- SSE streaming via `fetch` + `ReadableStream` bridge
+
+## Architecture
+
+```
+lib/
+  app.dart                          # GoRouter + _Shell + _QuickCaptureBar
+  core/constants.dart               # Routes.*
+  data/
+    models/                         # note.dart, task.dart, project.dart
+    api/                            # notes_api.dart, tasks_api.dart, projects_api.dart
+    repositories/                   # notes, tasks, projects repositories
+  providers/
+    api_client_provider.dart        # all API + repository providers
+    notes_provider.dart             # NotesNotifier
+    tasks_provider.dart             # TasksNotifier
+    projects_provider.dart          # ProjectsNotifier
+  screens/
+    notes/note_edit_screen.dart     # chip tag input + ProjectSelector
+    tasks/task_edit_screen.dart     # ProjectSelector
+    projects/project_list_screen.dart
+  widgets/
+    project_selector.dart           # reusable DropdownButtonFormField
+```
+
+## Navigation
+
+4-tab shell (Notes · Tasks · Projects · Chat):
+- Phone: bottom `NavigationBar`
+- Tablet/landscape: `NavigationRail`
+
+Quick Capture bar persists across all tabs. Settings accessible from top-right icon.
+
+## Feature Status
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Notes CRUD | ✅ | Tags chip input; project selector in editor |
+| Tasks CRUD | ✅ | Project selector in editor |
+| Projects list | ✅ | Active/archived sections; long-press status change; create dialog |
+| Chat + SSE | ✅ | Full streaming |
+| Quick Capture | ✅ | Offline queue with retry |
+| Tags | ✅ | Chip input in NoteEditScreen; typed as `List<String>` |
+| Project assignment | ✅ | `ProjectSelector` dropdown in Note + Task editors |
+| Milestones | ❌ deferred | Too granular for mobile; web UI handles it |
+| Push notifications | ❌ incompatible | Backend uses browser VAPID; Flutter needs FCM/APNs — separate implementation required |
+| CalDAV settings | ❌ intentional | Server-side config only; not exposed in mobile app |
+
+## API Compatibility Notes
+
+- `GET /api/projects/:id` returns a flat JSON object (not `{project: ...}` wrapper); includes `summary` field.
+- `POST /api/projects` returns the project dict directly (201).
+- `PATCH /api/projects/:id` returns the updated project dict.
+- Task body field is `body` (not `description`) — the app maps `description` → `body` on serialize.
+
+## Self-Update
+
+The app supports self-update via the Forgejo release API (`update_provider.dart`). It checks the latest release tag and prompts the user to download and install a new APK when one is available.
+
+## CI
+
+Builds are triggered from the Forgejo Actions pipeline in the `fabled_app` repository. The APK is attached to the release as a downloadable artifact.

docs/architecture.md

@@ -20,7 +20,7 @@
 │              Docker Compose                  │
 │                                              │
 │  ┌──────────────────────┐   ┌────────────┐  │
-│  │  scribe     │   │  ollama    │  │
+│  │  fabledassistant     │   │  ollama    │  │
 │  │  ┌────────────────┐  │   │            │  │
 │  │  │  Quart Server  │  │   │  LLM API   │  │
 │  │  │  ┌──────────┐  │  │   │            │  │
@@ -43,7 +43,7 @@
 ## Project Structure
 
 ```
-scribe/
+fabledassistant/
 ├── docker-compose.yml           # Development stack
 ├── docker-compose.prod.yml      # Production stack (Docker Swarm)
 ├── Dockerfile                   # Multi-stage build (Node → Python)
@@ -54,7 +54,7 @@ scribe/
 │       ├── server.py            # FastMCP tool registrations
 │       ├── client.py            # FableClient (httpx wrapper)
 │       └── tools/               # Tool modules (notes, tasks, projects, …)
-├── src/scribe/
+├── src/fabledassistant/
 │   ├── app.py                   # Quart app factory + blueprint registration
 │   ├── config.py                # Config class (reads env vars)
 │   ├── auth.py                  # login_required decorator, session checks
@@ -169,7 +169,7 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi
 
 ## Detailed File Reference
 
-### Backend (`src/scribe/`)
+### Backend (`src/fabledassistant/`)
 
 | File | Responsibility |
 |------|---------------|

docs/configuration.md

@@ -8,7 +8,7 @@ Configuration is via environment variables. The `docker-compose.yml` file sets d
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `DATABASE_URL` | `postgresql+asyncpg://fabled:fabled@db/scribe` | PostgreSQL async connection string |
+| `DATABASE_URL` | `postgresql+asyncpg://fabled:fabled@db/fabledassistant` | PostgreSQL async connection string |
 | `SECRET_KEY` | `dev-secret-change-me` | Session signing key — **change this in production** |
 | `SECRET_KEY_FILE` | — | Path to a Docker secret file containing the key (alternative to `SECRET_KEY`) |
 | `LOG_LEVEL` | `INFO` | Logging verbosity (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
@@ -91,7 +91,7 @@ The production compose file adds:
 ```bash
 # Create Docker secrets
 echo "$(python3 -c 'import secrets; print(secrets.token_hex(32))')" | docker secret create fabled_secret_key -
-echo "postgresql+asyncpg://fabled:strongpassword@db/scribe" | docker secret create fabled_db_url -
+echo "postgresql+asyncpg://fabled:strongpassword@db/fabledassistant" | docker secret create fabled_db_url -
 
 # Deploy
 docker stack deploy -c docker-compose.prod.yml fabled

docs/design-system.md

@@ -568,6 +568,17 @@ Items deliberately not addressed in this round; revisit when a real need surface
 - Standalone voice/tone audit across every UI string — opportunistic-only; full sweep deferred unless drift becomes visible.
 - A handful of editor utility buttons (`.btn-suggest-tags`, `.btn-link-all`, AI assist generate/proofread/accept/reject set, etc.) — currently ghost-styled and visually compliant; revisited only if they read off in practice.
 
+### Flutter app port — shipped 2026-04-28
+
+The companion mobile app (`fabled_app` / FabledApp repo) tracks the same design system. Two commits:
+
+- **Foundation port** — `0f05f47`. `lib/core/theme.dart` rewritten with the Obsidian/Iron/Pewter dark palette, warm parchment light palette, dusty violet `#5B4A8A` primary. Inter loaded for body, JetBrains Mono available at call sites, Fraunces for headlines ≥18px. New `ActionColors` ThemeExtension exposes Moss/Bronze/Oxblood/Pewter outside the `ColorScheme` (Material's primary/secondary/tertiary slots all carry brand accent, so action tokens need their own home). `GradientButton` recolored to dusty-violet gradient.
+- **Surface phase** — `b9e68e3`. `lucide_icons ^0.257.0` installed; 107 `Icons.*` references across 21 files swapped to `LucideIcons.*`. Input border radius 24 → 8 in both themes. ChatMessageBubble Illuminated Transcript fixes — neutral border on user bubbles, `surface`/Iron bg on assistant bubbles, asymmetric corner restoration (only bottom-left clipped, not both left corners), accent-tinted glow shadow added. 5 destructive confirm buttons across notes / tasks / chat / calendar wired to `ActionColors.destructive`. Calendar event Save wired to `ActionColors.primary` as the reference Moss site. 4 hardcoded indigo Color literals → dusty-violet equivalents.
+
+The Flutter port doesn't decompose into 7 PRs the way web did because Flutter's centralized `theme.dart` means most palette/font work happens in one file. Per-screen Save / Cancel reclassification beyond the calendar event Save is opportunistic — the wiring pattern (`Theme.of(context).extension<ActionColors>()!.primary`) is established and applied incrementally as files are touched.
+
+Pattern reference for downstream screens: see `lib/screens/calendar/event_form_sheet.dart` for `ActionColors.primary` usage on Save buttons; see the dialog spots in `note_edit_screen.dart` / `task_edit_screen.dart` / `note_detail_screen.dart` / `conversations_tab_screen.dart` for `ActionColors.destructive` on confirm-Delete buttons.
+
 ### Open threads
 
 *New threads will accumulate here as gaps surface in real use.*

docs/development.md

@@ -57,9 +57,7 @@ Migration conventions:
 
 ### Pipeline
 
-CI runs on Forgejo Actions, consuming the shared
-[`ci-python:3.14`](https://git.fabledsword.com/bvandeusen/CI-runner) image
-via `container.image` (Python 3.14 + Node 24 + ruff + uv + Docker CLI):
+CI runs on Forgejo Actions with a custom runner base image (`py3.12-node22`):
 
 | Trigger | Jobs | Docker tags pushed |
 |---------|------|--------------------|
@@ -79,21 +77,17 @@ via `container.image` (Python 3.14 + Node 24 + ruff + uv + Docker CLI):
    git checkout dev && git merge main && git push origin dev
    ```
 
-### Runner
+### Custom Runner
 
-CI jobs schedule against the `python-ci` runner label and run inside the
-shared `git.fabledsword.com/bvandeusen/ci-python:3.14` image (see
-`ci-requirements.md` for what this project relies on from the image).
-The runner deployment lives outside this repo; image bumps happen in
-[CI-Runner](https://git.fabledsword.com/bvandeusen/CI-runner) via Renovate.
+Runner base image: `infra/Dockerfile.runner-base` (Ubuntu 24.04 + Python 3.12 + Node 22 LTS).
+Runner config: `infra/act-runner-config.yml` (label: `py3.12-node22`).
+Runner compose: `infra/runner-compose.yml`.
 
-`infra/runner-compose.yml` + `infra/act-runner-config.yml` document the
-runner-host deployment shape; the source of truth is the deployed
-config on the runner host.
+To activate a new runner registration, copy `infra/act-runner-config.yml` to the runner's config directory, delete the `.runner` registration file in the runner container, and restart the stack.
 
 ### Docker Registry
 
-Images pushed to: `git.fabledsword.com/bvandeusen/scribe`
+Images pushed to: `git.fabledsword.com/bvandeusen/fabledassistant`
 Cache tag: `:cache` (reduces build time ~80%)
 
 Required secrets (repo → Settings → Secrets → Actions):
@@ -140,8 +134,8 @@ Current migration sequence (all idempotent raw SQL):
 
 ### Backend
 
-- Services: `async with async_session() as session:` — import from `scribe.models`
-- No `scribe.database` module
+- Services: `async with async_session() as session:` — import from `fabledassistant.models`
+- No `fabledassistant.database` module
 - Blueprint per resource: `routes/notes.py`, `routes/tasks.py`, etc.
 - All business logic in `services/`; routes are thin wrappers
 - Permission checks via `services/access.py` — never inline ownership checks in routes

docs/features.md

@@ -132,6 +132,8 @@ Settings are tabbed:
 
 - Email integration (read/send via IMAP/SMTP tools in chat)
 - Session invalidation on user deletion
+- Flutter push notifications (requires FCM/APNs — separate from web VAPID)
+- Flutter milestone support in project view
 
 ## Keyboard Shortcuts
 

fable-mcp/.env.example

@@ -0,0 +1,2 @@
+FABLE_URL=http://localhost:5000
+FABLE_API_KEY=fmcp_your_key_here

fable-mcp/fable_mcp/client.py

@@ -0,0 +1,126 @@
+"""Async HTTP client for the Fable Assistant API."""
+from __future__ import annotations
+
+import os
+from typing import Any, AsyncIterator
+
+import httpx
+
+
+class FableAPIError(Exception):
+    """Raised when the Fable API returns a non-2xx response."""
+
+    def __init__(self, status_code: int, message: str) -> None:
+        self.status_code = status_code
+        super().__init__(f"Fable API error {status_code}: {message}")
+
+
+class FableClient:
+    """Async wrapper around httpx for the Fable REST API."""
+
+    def __init__(self) -> None:
+        url = os.environ.get("FABLE_URL", "").rstrip("/")
+        key = os.environ.get("FABLE_API_KEY", "")
+        if not url:
+            raise ValueError("FABLE_URL environment variable is required")
+        if not key:
+            raise ValueError("FABLE_API_KEY environment variable is required")
+        self.base_url = url
+        self._headers = {
+            "Authorization": f"Bearer {key}",
+            "Content-Type": "application/json",
+        }
+        self._client: httpx.AsyncClient | None = None
+
+    async def __aenter__(self) -> "FableClient":
+        self._client = httpx.AsyncClient(
+            base_url=self.base_url,
+            headers=self._headers,
+            timeout=httpx.Timeout(connect=10.0, read=300.0, write=30.0, pool=10.0),
+        )
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        if self._client:
+            await self._client.aclose()
+            self._client = None
+
+    def _http(self) -> httpx.AsyncClient:
+        if self._client is None:
+            raise RuntimeError("FableClient must be used as an async context manager")
+        return self._client
+
+    @staticmethod
+    def _raise_for_status(response: httpx.Response) -> None:
+        if response.is_error:
+            try:
+                message = response.json().get("error", response.text)
+            except Exception:
+                message = response.text
+            raise FableAPIError(response.status_code, message)
+
+    async def get(self, path: str, **kwargs: Any) -> Any:
+        response = await self._http().get(path, **kwargs)
+        self._raise_for_status(response)
+        return response.json()
+
+    async def post(self, path: str, **kwargs: Any) -> Any:
+        response = await self._http().post(path, **kwargs)
+        self._raise_for_status(response)
+        return response.json()
+
+    async def patch(self, path: str, **kwargs: Any) -> Any:
+        response = await self._http().patch(path, **kwargs)
+        self._raise_for_status(response)
+        return response.json()
+
+    async def put(self, path: str, **kwargs: Any) -> Any:
+        response = await self._http().put(path, **kwargs)
+        self._raise_for_status(response)
+        return response.json()
+
+    async def delete(self, path: str, **kwargs: Any) -> Any:
+        response = await self._http().delete(path, **kwargs)
+        if response.status_code == 204:
+            return None
+        self._raise_for_status(response)
+        if response.content:
+            return response.json()
+        return None
+
+    async def stream_get(self, path: str, **kwargs: Any) -> AsyncIterator[str]:
+        """Yield non-empty lines from a streaming GET response (SSE)."""
+        async with self._http().stream("GET", path, **kwargs) as response:
+            if response.is_error:
+                await response.aread()
+                self._raise_for_status(response)
+            async for line in response.aiter_lines():
+                if line:
+                    yield line
+
+
+# ---------------------------------------------------------------------------
+# Module-level singleton
+# ---------------------------------------------------------------------------
+
+_client: FableClient | None = None
+
+
+def init_client() -> FableClient:
+    """Initialise the module-level FableClient singleton (reads env vars)."""
+    global _client
+    _client = FableClient()
+    return _client
+
+
+def get_client() -> FableClient:
+    """Return the singleton client; raises RuntimeError if not initialised."""
+    if _client is None:
+        raise RuntimeError("Call init_client() before get_client()")
+    return _client
+
+
+def _reset_client() -> None:
+    """Reset the singleton — used by tests only."""
+    global _client
+    _client = None

fable-mcp/fable_mcp/server.py

@@ -0,0 +1,757 @@
+"""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, journal
+
+load_dotenv()
+
+_INSTRUCTIONS = """
+Fabled Scribe is a self-hosted second-brain and project management system with LLM integration.
+
+## Data model
+
+The hierarchy is: Project → Milestone → Task/Note.
+
+- **Notes** and **Tasks** share the same underlying model. Tasks are notes with `is_task=True`.
+  The note tools (fable_*_note) operate on notes; the task tools (fable_*_task) operate on tasks.
+  Do not use note tools to manipulate tasks or vice versa.
+
+- **Projects** group related work. A project has a title, description, goal, status, and an
+  auto-generated summary used for semantic search. Status values: `active`, `archived`.
+
+- **Milestones** belong to a project and group tasks within it. Status values: `active`, `done`.
+
+- **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: `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.
+
+## Tags
+
+Tags are plain strings — do NOT include a `#` prefix. Example: `["python", "architecture"]`.
+Tags are stored as an array on the note/task. Passing `tags=[]` clears all tags; omitting `tags`
+leaves existing tags unchanged on updates.
+
+## Integer-or-none fields
+
+Due to MCP type constraints, optional integer fields (project_id, milestone_id, parent_id)
+use `0` to mean "not set / no association". Pass `0` to leave the field unset.
+
+## Search
+
+`fable_search` performs semantic (embedding-based) search over notes and tasks. Use it to find
+relevant content by meaning rather than exact keywords. Returns results ranked by cosine
+similarity with id, title, a body snippet, and tags.
+
+## Chat / LLM delegation
+
+`fable_send_message` sends a natural-language message to Fable's built-in LLM (Ollama). Fable
+handles its own tool use, RAG context injection, and conversation history internally.
+
+Use `fable_send_message` when:
+- The request is conversational or requires Fable's internal reasoning across many records
+- You want Fable's RAG to surface relevant notes automatically
+
+Use the direct CRUD tools when:
+- You know exactly what to create/read/update/delete
+- You need structured data back (IDs, field values) for further processing
+- You are populating Fable programmatically from another system
+
+## Task logs
+
+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.
+
+## Journal
+
+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
+
+`fable_get_app_logs` requires an admin-scoped API key. Regular user keys will be rejected.
+"""
+
+mcp = FastMCP("fable", instructions=_INSTRUCTIONS)
+
+
+# ---------------------------------------------------------------------------
+# Notes
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_list_notes(
+    limit: int = 20,
+    offset: int = 0,
+    tag: str = "",
+    search_text: str = "",
+) -> dict:
+    """List notes (non-task documents) stored in Fable.
+
+    Optionally filter by a single tag (plain string, no # prefix) or a keyword search
+    against title and body. Results are ordered by last-updated descending.
+
+    Use fable_search for semantic/meaning-based lookup instead of exact keyword search.
+    """
+    async with FableClient() as client:
+        return await notes.list_notes(
+            client,
+            limit=limit,
+            offset=offset,
+            tag=tag or None,
+            search=search_text or None,
+        )
+
+
+@mcp.tool()
+async def fable_get_note(note_id: int) -> dict:
+    """Fetch the full content of a single Fable note by its ID.
+
+    Returns id, title, body (markdown), tags, project_id, created_at, updated_at.
+    """
+    async with FableClient() as client:
+        return await notes.get_note(client, note_id=note_id)
+
+
+@mcp.tool()
+async def fable_create_note(
+    title: str,
+    body: str = "",
+    tags: list[str] | None = None,
+    project_id: int = 0,
+) -> dict:
+    """Create a new note in Fable.
+
+    Args:
+        title: Note title (required).
+        body: Markdown content. Supports [[wikilinks]] to other notes by title.
+        tags: List of plain-string tags without # prefix, e.g. ["python", "ideas"].
+        project_id: Associate with a project (use 0 for no project / orphan note).
+
+    Returns the created note object including its assigned id.
+    """
+    async with FableClient() as client:
+        return await notes.create_note(
+            client,
+            title=title,
+            body=body,
+            tags=tags,
+            project_id=project_id or None,
+        )
+
+
+@mcp.tool()
+async def fable_update_note(
+    note_id: int,
+    title: str = "",
+    body: str = "",
+    tags: list[str] | None = None,
+    project_id: int = 0,
+) -> dict:
+    """Update an existing Fable note. Only explicitly provided fields are changed.
+
+    Args:
+        note_id: ID of the note to update.
+        title: New title, or omit to leave unchanged.
+        body: New markdown body, or omit to leave unchanged.
+        tags: Replaces the full tag list. Pass [] to clear all tags. Omit to leave unchanged.
+        project_id: New project association (0 = remove from project). Omit to leave unchanged.
+    """
+    async with FableClient() as client:
+        return await notes.update_note(
+            client,
+            note_id=note_id,
+            title=title or None,
+            body=body or None,
+            tags=tags,
+            project_id=project_id or None,
+        )
+
+
+@mcp.tool()
+async def fable_delete_note(note_id: int) -> str:
+    """Permanently delete a Fable note by ID. This cannot be undone."""
+    async with FableClient() as client:
+        await notes.delete_note(client, note_id=note_id)
+    return f"Note {note_id} deleted."
+
+
+# ---------------------------------------------------------------------------
+# Tasks
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_list_tasks(
+    limit: int = 20,
+    offset: int = 0,
+    status: str = "",
+    project_id: int = 0,
+) -> dict:
+    """List tasks in Fable.
+
+    Args:
+        status: Filter by status — one of: todo, in_progress, done, cancelled. Omit for all.
+        project_id: Filter to a specific project. Use 0 for no filter.
+
+    Results are ordered by last-updated descending.
+    """
+    async with FableClient() as client:
+        return await tasks.list_tasks(
+            client,
+            limit=limit,
+            offset=offset,
+            status=status or None,
+            project_id=project_id or None,
+        )
+
+
+@mcp.tool()
+async def fable_get_task(task_id: int) -> dict:
+    """Fetch a single Fable task by ID.
+
+    Returns id, title, body, status, priority, tags, project_id, milestone_id,
+    parent_id, parent_title, due_date, created_at, updated_at.
+    """
+    async with FableClient() as client:
+        return await tasks.get_task(client, task_id=task_id)
+
+
+@mcp.tool()
+async def fable_create_task(
+    title: str,
+    body: str = "",
+    status: str = "todo",
+    priority: str = "",
+    project_id: int = 0,
+    milestone_id: int = 0,
+    parent_id: int = 0,
+    tags: list[str] | None = None,
+) -> dict:
+    """Create a new task in Fable.
+
+    Args:
+        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, 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).
+        tags: List of plain-string tags without # prefix.
+
+    Returns the created task object including its assigned id.
+    """
+    async with FableClient() as client:
+        return await tasks.create_task(
+            client,
+            title=title,
+            body=body,
+            status=status,
+            priority=priority or None,
+            project_id=project_id or None,
+            milestone_id=milestone_id or None,
+            parent_id=parent_id or None,
+            tags=tags,
+        )
+
+
+@mcp.tool()
+async def fable_update_task(
+    task_id: int,
+    title: str = "",
+    body: str = "",
+    status: str = "",
+    priority: str = "",
+    project_id: int = 0,
+    milestone_id: int = 0,
+) -> dict:
+    """Update an existing Fable task. Only explicitly provided fields are changed.
+
+    Args:
+        task_id: ID of the task to update.
+        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: 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.
+    """
+    async with FableClient() as client:
+        return await tasks.update_task(
+            client,
+            task_id=task_id,
+            title=title or None,
+            body=body or None,
+            status=status or None,
+            priority=priority or None,
+            project_id=project_id or None,
+            milestone_id=milestone_id or None,
+        )
+
+
+@mcp.tool()
+async def fable_add_task_log(task_id: int, content: str) -> dict:
+    """Append a timestamped progress log entry to a Fable task.
+
+    Use this to record work sessions, decisions, or status updates over time without
+    overwriting the task's main body. Each entry is stored separately and shown
+    chronologically in the task view.
+    """
+    async with FableClient() as client:
+        return await tasks.add_task_log(client, task_id=task_id, content=content)
+
+
+# ---------------------------------------------------------------------------
+# Projects
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_list_projects() -> dict:
+    """List all Fable projects for the current user.
+
+    Returns id, title, description, goal, status (active/archived), color,
+    and a short auto-generated summary for each project.
+    """
+    async with FableClient() as client:
+        return await projects.list_projects(client)
+
+
+@mcp.tool()
+async def fable_get_project(project_id: int) -> dict:
+    """Fetch a Fable project by ID, including its milestone summary.
+
+    Returns full project fields plus a milestone_summary list with each milestone's
+    id, title, status, and task counts.
+    """
+    async with FableClient() as client:
+        return await projects.get_project(client, project_id=project_id)
+
+
+@mcp.tool()
+async def fable_create_project(
+    title: str,
+    description: str = "",
+    goal: str = "",
+    status: str = "active",
+    color: str = "",
+) -> dict:
+    """Create a new project in Fable.
+
+    Args:
+        title: Project name (required).
+        description: Short summary of what the project is.
+        goal: The desired outcome or definition of done for the project.
+        status: active (default) or archived.
+        color: Optional hex colour for the project card (e.g. "#6366f1").
+
+    Returns the created project object including its assigned id.
+    """
+    async with FableClient() as client:
+        return await projects.create_project(
+            client,
+            title=title,
+            description=description,
+            goal=goal or None,
+            status=status,
+            color=color or None,
+        )
+
+
+@mcp.tool()
+async def fable_update_project(
+    project_id: int,
+    title: str = "",
+    description: str = "",
+    goal: str = "",
+    status: str = "",
+    color: str = "",
+) -> dict:
+    """Update an existing Fable project. Only explicitly provided fields are changed.
+
+    Args:
+        project_id: ID of the project to update.
+        title: New title, or omit to leave unchanged.
+        description: New description, or omit to leave unchanged.
+        goal: New goal/definition-of-done, or omit to leave unchanged.
+        status: New status — active or archived.
+        color: New hex colour, or omit to leave unchanged.
+    """
+    async with FableClient() as client:
+        return await projects.update_project(
+            client,
+            project_id=project_id,
+            title=title or None,
+            description=description or None,
+            goal=goal or None,
+            status=status or None,
+            color=color or None,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Milestones
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_list_milestones(project_id: int) -> dict:
+    """List milestones for a Fable project, ordered by order_index.
+
+    Returns id, title, description, status (active/done), order_index, and task counts.
+    """
+    async with FableClient() as client:
+        return await milestones.list_milestones(client, project_id=project_id)
+
+
+@mcp.tool()
+async def fable_create_milestone(
+    project_id: int,
+    title: str,
+    description: str = "",
+    status: str = "active",
+) -> dict:
+    """Create a milestone within a Fable project.
+
+    Args:
+        project_id: The project this milestone belongs to (required).
+        title: Milestone name (required).
+        description: Optional description of what this milestone covers.
+        status: active (default) or done.
+
+    Returns the created milestone including its assigned id.
+    """
+    async with FableClient() as client:
+        return await milestones.create_milestone(
+            client,
+            project_id=project_id,
+            title=title,
+            description=description,
+            status=status,
+        )
+
+
+@mcp.tool()
+async def fable_update_milestone(
+    project_id: int,
+    milestone_id: int,
+    title: str = "",
+    description: str = "",
+    status: str = "",
+    order_index: int = -1,
+) -> dict:
+    """Update a Fable milestone. Only explicitly provided fields are changed.
+
+    Args:
+        project_id: Project the milestone belongs to.
+        milestone_id: ID of the milestone to update.
+        title: New title, or omit to leave unchanged.
+        description: New description, or omit to leave unchanged.
+        status: New status — active or done.
+        order_index: New display position (0-based). Use -1 to leave unchanged.
+    """
+    async with FableClient() as client:
+        return await milestones.update_milestone(
+            client,
+            project_id=project_id,
+            milestone_id=milestone_id,
+            title=title or None,
+            description=description or None,
+            status=status or None,
+            order_index=order_index if order_index >= 0 else None,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Search
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_search(
+    q: str,
+    content_type: str = "all",
+    limit: int = 10,
+) -> dict:
+    """Semantic search over Fable notes and tasks using embedding similarity.
+
+    Finds content by meaning rather than exact keywords. Use this to discover
+    relevant records when you don't know the exact title or tags.
+
+    Args:
+        q: Natural-language query string.
+        content_type: "note", "task", or "all" (default).
+        limit: Maximum number of results (default 10).
+
+    Returns results ordered by cosine similarity, each with id, title, body snippet, and tags.
+    """
+    async with FableClient() as client:
+        return await search.search(client, q=q, content_type=content_type, limit=limit)
+
+
+# ---------------------------------------------------------------------------
+# Chat
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_list_conversations(limit: int = 20, offset: int = 0) -> dict:
+    """List chat conversations stored in Fable, ordered by last activity.
+
+    Returns id, title, message_count, created_at, updated_at for each conversation.
+    Use the id with fable_send_message to continue a specific conversation.
+    """
+    async with FableClient() as client:
+        return await chat.list_conversations(client, limit=limit, offset=offset)
+
+
+@mcp.tool()
+async def fable_send_message(
+    message: str,
+    conversation_id: str = "",
+    think: bool = False,
+) -> dict:
+    """Send a natural-language message to Fable's built-in LLM and receive the full response.
+
+    Fable handles tool use, RAG context injection, and conversation history internally.
+    The LLM can create/update notes and tasks, search, manage projects, and more — all
+    driven by natural language without you needing to call individual tools.
+
+    Use this when:
+    - The request is conversational or exploratory
+    - You want Fable's RAG to automatically surface relevant notes as context
+    - The task is complex enough to benefit from Fable's internal reasoning
+
+    Use the direct CRUD tools (fable_create_note, etc.) instead when you need
+    structured data back or are performing bulk/programmatic operations.
+
+    Args:
+        message: The user message to send.
+        conversation_id: Continue an existing conversation by passing its id.
+                         Omit to start a new conversation.
+        think: Enable extended reasoning mode for complex multi-step requests.
+
+    Returns conversation_id (for follow-up messages), the assistant response text,
+    and a list of any tool_call events that fired during generation.
+    """
+    async with FableClient() as client:
+        return await chat.send_message(
+            client,
+            message=message,
+            conversation_id=conversation_id or None,
+            think=think,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Admin / observability
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_get_app_logs(
+    category: str = "error",
+    limit: int = 20,
+    search: str = "",
+) -> dict:
+    """Fetch Fable application logs. Requires an admin-scoped API key.
+
+    Args:
+        category: Log category — "error" (default), "audit", "usage", or "generation".
+        limit: Maximum number of log entries to return.
+        search: Optional keyword filter matched against action, endpoint, username, details.
+
+    Returns a list of log entries ordered by most recent first.
+    Regular user API keys will receive a 403 — only admin keys are accepted.
+    """
+    async with FableClient() as client:
+        return await admin.get_app_logs(
+            client,
+            category=category,
+            limit=limit,
+            search=search or None,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Journal — daily prep, day payloads, moments
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def fable_get_today_journal() -> dict:
+    """Fetch today's Journal day payload.
+
+    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 journal.get_today_journal(client)
+
+
+@mcp.tool()
+async def fable_get_journal_day(iso_date: str) -> dict:
+    """Fetch a specific day's Journal payload by ISO date.
+
+    Args:
+        iso_date: YYYY-MM-DD format date.
+
+    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 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_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 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,
+        )
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+
+def main() -> None:
+    # Validate env vars at startup — raises ValueError with a clear message if missing.
+    FableClient()
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

fable-mcp/fable_mcp/tools/admin.py

@@ -0,0 +1,20 @@
+"""Admin tools: application log access (requires admin API key)."""
+from __future__ import annotations
+
+from fable_mcp.client import FableClient
+
+
+async def get_app_logs(
+    client: FableClient,
+    category: str = "error",
+    limit: int = 20,
+    search: str | None = None,
+) -> dict:
+    """Fetch application logs from Fable. Requires an admin-scoped API key.
+
+    category: "error" | "audit" | "usage" | "generation" (default: "error")
+    """
+    params: dict = {"category": category, "limit": limit}
+    if search:
+        params["search"] = search
+    return await client.get("/api/admin/logs", params=params)

fable-mcp/fable_mcp/tools/chat.py

@@ -0,0 +1,95 @@
+"""MCP tools for Fable chat — create conversations and stream responses."""
+from __future__ import annotations
+
+import asyncio
+import json
+from typing import Any
+
+from fable_mcp.client import FableClient, FableAPIError
+
+
+async def list_conversations(
+    client: FableClient,
+    *,
+    limit: int = 20,
+    offset: int = 0,
+) -> dict[str, Any]:
+    """List MCP chat conversations."""
+    params: dict[str, Any] = {"limit": limit, "offset": offset, "type": "mcp"}
+    return await client.get("/api/chat/conversations", params=params)
+
+
+async def send_message(
+    client: FableClient,
+    *,
+    message: str,
+    conversation_id: str | None = None,
+    think: bool = False,
+) -> dict[str, Any]:
+    """Send a message to Fable and return the full assistant response.
+
+    Creates a new MCP conversation if conversation_id is None.
+    Posts the user message to start generation, then streams the SSE buffer.
+
+    SSE event format:
+        id: <N>
+        event: <type>        # chunk | done | tool_call | status | ...
+        data: <json>
+
+    Returns:
+        Dict with:
+          - "conversation_id": str
+          - "response": str (full assistant message)
+          - "tool_calls": list of any tool_call events observed
+    """
+    if conversation_id is None:
+        conv = await client.post(
+            "/api/chat/conversations",
+            json={"conversation_type": "mcp"},
+        )
+        conversation_id = str(conv["id"])
+
+    # Start generation
+    await client.post(
+        f"/api/chat/conversations/{conversation_id}/messages",
+        json={"content": message, "think": think},
+    )
+
+    tokens: list[str] = []
+    tool_calls: list[Any] = []
+
+    stream_path = f"/api/chat/conversations/{conversation_id}/generation/stream"
+
+    # Retry connecting to the stream briefly — the background task may not have
+    # created the generation buffer by the time we issue the GET.
+    for attempt in range(10):
+        try:
+            event_type: str | None = None
+            async for raw_line in client.stream_get(stream_path):
+                if raw_line.startswith("event: "):
+                    event_type = raw_line[len("event: "):].strip()
+                elif raw_line.startswith("data: "):
+                    payload_str = raw_line[len("data: "):]
+                    try:
+                        data = json.loads(payload_str)
+                    except json.JSONDecodeError:
+                        continue
+                    if event_type == "chunk":
+                        tokens.append(data.get("chunk", ""))
+                    elif event_type == "tool_call":
+                        tool_calls.append(data.get("tool_call", data))
+                    elif event_type == "done":
+                        break
+                    event_type = None  # reset after consuming data line
+            break  # stream completed successfully
+        except FableAPIError as exc:
+            if exc.status_code == 404 and attempt < 9:
+                await asyncio.sleep(0.3)
+                continue
+            raise
+
+    return {
+        "conversation_id": conversation_id,
+        "response": "".join(tokens),
+        "tool_calls": tool_calls,
+    }

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/fable_mcp/tools/milestones.py

@@ -0,0 +1,53 @@
+"""MCP tools for Fable milestones."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+async def list_milestones(client: FableClient, *, project_id: int) -> dict[str, Any]:
+    """List milestones for a project."""
+    return await client.get(f"/api/projects/{project_id}/milestones")
+
+
+async def create_milestone(
+    client: FableClient,
+    *,
+    project_id: int,
+    title: str,
+    description: str = "",
+    status: str = "active",
+) -> dict[str, Any]:
+    """Create a milestone within a project."""
+    payload: dict[str, Any] = {
+        "title": title,
+        "description": description,
+        "status": status,
+    }
+    return await client.post(f"/api/projects/{project_id}/milestones", json=payload)
+
+
+async def update_milestone(
+    client: FableClient,
+    *,
+    project_id: int,
+    milestone_id: int,
+    title: str | None = None,
+    description: str | None = None,
+    status: str | None = None,
+    order_index: int | None = None,
+) -> dict[str, Any]:
+    """Update an existing milestone."""
+    payload: dict[str, Any] = {}
+    if title is not None:
+        payload["title"] = title
+    if description is not None:
+        payload["description"] = description
+    if status is not None:
+        payload["status"] = status
+    if order_index is not None:
+        payload["order_index"] = order_index
+    return await client.patch(
+        f"/api/projects/{project_id}/milestones/{milestone_id}", json=payload
+    )

fable-mcp/fable_mcp/tools/notes.py

@@ -0,0 +1,72 @@
+"""MCP tools for Fable notes."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+async def list_notes(
+    client: FableClient,
+    *,
+    limit: int = 20,
+    offset: int = 0,
+    tag: str | None = None,
+    search: str | None = None,
+) -> dict[str, Any]:
+    """List notes with optional filtering."""
+    params: dict[str, Any] = {"limit": limit, "offset": offset}
+    if tag:
+        params["tag"] = tag
+    if search:
+        params["search"] = search
+    return await client.get("/api/notes", params=params)
+
+
+async def get_note(client: FableClient, *, note_id: int) -> dict[str, Any]:
+    """Fetch a single note by ID."""
+    return await client.get(f"/api/notes/{note_id}")
+
+
+async def create_note(
+    client: FableClient,
+    *,
+    title: str,
+    body: str = "",
+    tags: list[str] | None = None,
+    project_id: int | None = None,
+) -> dict[str, Any]:
+    """Create a new note."""
+    payload: dict[str, Any] = {"title": title, "body": body}
+    if tags is not None:
+        payload["tags"] = tags
+    if project_id is not None:
+        payload["project_id"] = project_id
+    return await client.post("/api/notes", json=payload)
+
+
+async def update_note(
+    client: FableClient,
+    *,
+    note_id: int,
+    title: str | None = None,
+    body: str | None = None,
+    tags: list[str] | None = None,
+    project_id: int | None = None,
+) -> dict[str, Any]:
+    """Update an existing note."""
+    payload: dict[str, Any] = {}
+    if title is not None:
+        payload["title"] = title
+    if body is not None:
+        payload["body"] = body
+    if tags is not None:
+        payload["tags"] = tags
+    if project_id is not None:
+        payload["project_id"] = project_id
+    return await client.patch(f"/api/notes/{note_id}", json=payload)
+
+
+async def delete_note(client: FableClient, *, note_id: int) -> None:
+    """Delete a note by ID."""
+    await client.delete(f"/api/notes/{note_id}")

fable-mcp/fable_mcp/tools/projects.py

@@ -0,0 +1,59 @@
+"""MCP tools for Fable projects."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+async def list_projects(client: FableClient) -> dict[str, Any]:
+    """List all projects for the authenticated user."""
+    return await client.get("/api/projects")
+
+
+async def get_project(client: FableClient, *, project_id: int) -> dict[str, Any]:
+    """Fetch a project by ID (includes milestone summary)."""
+    return await client.get(f"/api/projects/{project_id}")
+
+
+async def create_project(
+    client: FableClient,
+    *,
+    title: str,
+    description: str = "",
+    goal: str | None = None,
+    status: str = "active",
+    color: str | None = None,
+) -> dict[str, Any]:
+    """Create a new project."""
+    payload: dict[str, Any] = {"title": title, "description": description, "status": status}
+    if goal is not None:
+        payload["goal"] = goal
+    if color is not None:
+        payload["color"] = color
+    return await client.post("/api/projects", json=payload)
+
+
+async def update_project(
+    client: FableClient,
+    *,
+    project_id: int,
+    title: str | None = None,
+    description: str | None = None,
+    goal: str | None = None,
+    status: str | None = None,
+    color: str | None = None,
+) -> dict[str, Any]:
+    """Update an existing project."""
+    payload: dict[str, Any] = {}
+    if title is not None:
+        payload["title"] = title
+    if description is not None:
+        payload["description"] = description
+    if goal is not None:
+        payload["goal"] = goal
+    if status is not None:
+        payload["status"] = status
+    if color is not None:
+        payload["color"] = color
+    return await client.patch(f"/api/projects/{project_id}", json=payload)

fable-mcp/fable_mcp/tools/search.py

@@ -0,0 +1,30 @@
+"""MCP tool for semantic search across Fable notes and tasks."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+async def search(
+    client: FableClient,
+    *,
+    q: str,
+    content_type: str = "all",
+    limit: int = 10,
+) -> dict[str, Any]:
+    """Semantic search over notes and/or tasks.
+
+    Args:
+        q: Search query string.
+        content_type: One of "note", "task", or "all" (default).
+        limit: Maximum number of results to return.
+
+    Returns:
+        Dict with "results" list and "total" count.
+        Each result has: id, title, body, is_task, tags, similarity.
+    """
+    params: dict[str, Any] = {"q": q, "limit": limit}
+    if content_type != "all":
+        params["content_type"] = content_type
+    return await client.get("/api/search", params=params)

fable-mcp/fable_mcp/tools/tasks.py

@@ -0,0 +1,93 @@
+"""MCP tools for Fable tasks."""
+from __future__ import annotations
+
+from typing import Any
+
+from fable_mcp.client import FableClient
+
+
+async def list_tasks(
+    client: FableClient,
+    *,
+    limit: int = 20,
+    offset: int = 0,
+    status: str | None = None,
+    project_id: int | None = None,
+) -> dict[str, Any]:
+    """List tasks with optional filtering."""
+    params: dict[str, Any] = {"limit": limit, "offset": offset}
+    if status:
+        params["status"] = status
+    if project_id is not None:
+        params["project_id"] = project_id
+    return await client.get("/api/tasks", params=params)
+
+
+async def get_task(client: FableClient, *, task_id: int) -> dict[str, Any]:
+    """Fetch a single task by ID (includes parent_title)."""
+    return await client.get(f"/api/tasks/{task_id}")
+
+
+async def create_task(
+    client: FableClient,
+    *,
+    title: str,
+    body: str = "",
+    status: str = "todo",
+    priority: str | None = None,
+    project_id: int | None = None,
+    milestone_id: int | None = None,
+    parent_id: int | None = None,
+    tags: list[str] | None = None,
+) -> dict[str, Any]:
+    """Create a new task."""
+    payload: dict[str, Any] = {"title": title, "body": body, "status": status}
+    if priority is not None:
+        payload["priority"] = priority
+    if project_id is not None:
+        payload["project_id"] = project_id
+    if milestone_id is not None:
+        payload["milestone_id"] = milestone_id
+    if parent_id is not None:
+        payload["parent_id"] = parent_id
+    if tags is not None:
+        payload["tags"] = tags
+    return await client.post("/api/tasks", json=payload)
+
+
+async def update_task(
+    client: FableClient,
+    *,
+    task_id: int,
+    title: str | None = None,
+    body: str | None = None,
+    status: str | None = None,
+    priority: str | None = None,
+    project_id: int | None = None,
+    milestone_id: int | None = None,
+) -> dict[str, Any]:
+    """Update an existing task."""
+    payload: dict[str, Any] = {}
+    if title is not None:
+        payload["title"] = title
+    if body is not None:
+        payload["body"] = body
+    if status is not None:
+        payload["status"] = status
+    if priority is not None:
+        payload["priority"] = priority
+    if project_id is not None:
+        payload["project_id"] = project_id
+    if milestone_id is not None:
+        payload["milestone_id"] = milestone_id
+    return await client.patch(f"/api/tasks/{task_id}", json=payload)
+
+
+async def add_task_log(
+    client: FableClient,
+    *,
+    task_id: int,
+    content: str,
+) -> dict[str, Any]:
+    """Append a log entry to a task."""
+    return await client.post(f"/api/tasks/{task_id}/logs", json={"content": content})

fable-mcp/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fable-mcp"
+version = "0.3.0"
+description = "MCP server for Fabled Scribe"
+requires-python = ">=3.12"
+dependencies = [
+  "mcp[cli]>=1.0",
+  "httpx>=0.27",
+  "python-dotenv>=1.0",
+]
+
+[project.scripts]
+fable-mcp = "fable_mcp.server:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "respx>=0.21"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

fable-mcp/tests/conftest.py

@@ -0,0 +1,12 @@
+"""Shared pytest fixtures for fable-mcp tests."""
+from unittest.mock import AsyncMock, MagicMock
+import pytest
+
+
+@pytest.fixture
+def mock_client():
+    """A mock FableClient that returns empty responses by default."""
+    client = AsyncMock()
+    client.__aenter__ = AsyncMock(return_value=client)
+    client.__aexit__ = AsyncMock(return_value=False)
+    return client

fable-mcp/tests/test_client.py

@@ -0,0 +1,142 @@
+"""Tests for FableClient."""
+import os
+import pytest
+import respx
+import httpx
+from unittest.mock import patch
+
+from fable_mcp.client import FableClient, FableAPIError, get_client, init_client, _reset_client
+
+
+@pytest.fixture(autouse=True)
+def reset_singleton():
+    """Reset the module-level client singleton between tests."""
+    _reset_client()
+    yield
+    _reset_client()
+
+
+@pytest.fixture
+def base_env(monkeypatch):
+    monkeypatch.setenv("FABLE_URL", "http://fable.test")
+    monkeypatch.setenv("FABLE_API_KEY", "fmcp_testkey")
+
+
+class TestFableClientInit:
+    def test_missing_fable_url_raises(self, monkeypatch):
+        monkeypatch.delenv("FABLE_URL", raising=False)
+        monkeypatch.setenv("FABLE_API_KEY", "fmcp_testkey")
+        with pytest.raises(ValueError, match="FABLE_URL"):
+            FableClient()
+
+    def test_missing_api_key_raises(self, monkeypatch):
+        monkeypatch.setenv("FABLE_URL", "http://fable.test")
+        monkeypatch.delenv("FABLE_API_KEY", raising=False)
+        with pytest.raises(ValueError, match="FABLE_API_KEY"):
+            FableClient()
+
+    def test_trailing_slash_stripped(self, base_env):
+        with patch.dict(os.environ, {"FABLE_URL": "http://fable.test/"}):
+            client = FableClient()
+            assert client.base_url == "http://fable.test"
+
+    def test_auth_header_set(self, base_env):
+        client = FableClient()
+        assert client._headers["Authorization"] == "Bearer fmcp_testkey"
+
+
+class TestFableClientHTTP:
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_get_returns_json(self, base_env):
+        respx.get("http://fable.test/api/notes").mock(
+            return_value=httpx.Response(200, json={"notes": []})
+        )
+        async with FableClient() as client:
+            data = await client.get("/api/notes")
+        assert data == {"notes": []}
+
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_non_2xx_raises_fable_api_error(self, base_env):
+        respx.get("http://fable.test/api/notes").mock(
+            return_value=httpx.Response(401, json={"error": "Unauthorized"})
+        )
+        async with FableClient() as client:
+            with pytest.raises(FableAPIError) as exc_info:
+                await client.get("/api/notes")
+        assert exc_info.value.status_code == 401
+
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_post_sends_json(self, base_env):
+        respx.post("http://fable.test/api/notes").mock(
+            return_value=httpx.Response(201, json={"id": 1, "title": "Test"})
+        )
+        async with FableClient() as client:
+            data = await client.post("/api/notes", json={"title": "Test"})
+        assert data["id"] == 1
+
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_patch_sends_json(self, base_env):
+        respx.patch("http://fable.test/api/notes/1").mock(
+            return_value=httpx.Response(200, json={"id": 1, "title": "Updated"})
+        )
+        async with FableClient() as client:
+            data = await client.patch("/api/notes/1", json={"title": "Updated"})
+        assert data["title"] == "Updated"
+
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_delete_returns_none_on_204(self, base_env):
+        respx.delete("http://fable.test/api/notes/1").mock(
+            return_value=httpx.Response(204)
+        )
+        async with FableClient() as client:
+            result = await client.delete("/api/notes/1")
+        assert result is None
+
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_fable_api_error_includes_message(self, base_env):
+        respx.get("http://fable.test/api/notes").mock(
+            return_value=httpx.Response(404, json={"error": "Not found"})
+        )
+        async with FableClient() as client:
+            with pytest.raises(FableAPIError) as exc_info:
+                await client.get("/api/notes")
+        assert "Not found" in str(exc_info.value)
+        assert exc_info.value.status_code == 404
+
+
+class TestSingleton:
+    def test_get_client_before_init_raises(self):
+        with pytest.raises(RuntimeError, match="init_client"):
+            get_client()
+
+    def test_init_client_returns_instance(self, base_env):
+        client = init_client()
+        assert isinstance(client, FableClient)
+
+    def test_get_client_after_init_returns_same(self, base_env):
+        init_client()
+        c1 = get_client()
+        c2 = get_client()
+        assert c1 is c2
+
+
+class TestStreamGet:
+    @respx.mock
+    @pytest.mark.asyncio
+    async def test_stream_get_yields_lines(self, base_env):
+        sse_body = b"data: line1\n\ndata: line2\n\n"
+        respx.get("http://fable.test/api/stream").mock(
+            return_value=httpx.Response(200, content=sse_body)
+        )
+        lines = []
+        async with FableClient() as client:
+            async for line in client.stream_get("/api/stream"):
+                lines.append(line)
+        assert "data: line1" in lines
+        assert "data: line2" in lines

fable-mcp/tests/test_tools_chat.py

@@ -0,0 +1,58 @@
+"""Tests for chat MCP tools."""
+import json
+import pytest
+from unittest.mock import AsyncMock, MagicMock, patch
+
+
+@pytest.fixture
+def client(mock_client):
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_send_message_creates_conversation_and_streams(client):
+    from fable_mcp.tools.chat import send_message
+
+    client.post = AsyncMock(return_value={"id": "conv-1"})
+
+    async def fake_stream(path, **kwargs):
+        for line in [
+            'data: {"type": "token", "content": "Hello"}',
+            'data: {"type": "token", "content": " world"}',
+            'data: {"type": "done"}',
+        ]:
+            yield line
+
+    client.stream_get = fake_stream
+
+    result = await send_message(client, message="Hi", conversation_id=None)
+    assert result["conversation_id"] == "conv-1"
+    assert "Hello world" in result["response"]
+
+
+@pytest.mark.asyncio
+async def test_send_message_reuses_existing_conversation(client):
+    from fable_mcp.tools.chat import send_message
+
+    async def fake_stream(path, **kwargs):
+        for line in [
+            'data: {"type": "token", "content": "Reply"}',
+            'data: {"type": "done"}',
+        ]:
+            yield line
+
+    client.stream_get = fake_stream
+
+    result = await send_message(client, message="Hi", conversation_id="existing-conv")
+    # Should not call post to create a conversation
+    client.post.assert_not_called()
+    assert result["conversation_id"] == "existing-conv"
+
+
+@pytest.mark.asyncio
+async def test_list_conversations_calls_get(client):
+    from fable_mcp.tools.chat import list_conversations
+    client.get = AsyncMock(return_value={"conversations": []})
+    await list_conversations(client)
+    client.get.assert_called_once()
+    assert "/api/chat/conversations" in client.get.call_args[0][0]

fable-mcp/tests/test_tools_milestones.py

@@ -0,0 +1,35 @@
+"""Tests for milestones MCP tools."""
+import pytest
+from unittest.mock import AsyncMock
+
+
+@pytest.fixture
+def client(mock_client):
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_list_milestones_calls_correct_endpoint(client):
+    from fable_mcp.tools.milestones import list_milestones
+    client.get = AsyncMock(return_value={"milestones": []})
+    await list_milestones(client, project_id=3)
+    client.get.assert_called_once_with("/api/projects/3/milestones")
+
+
+@pytest.mark.asyncio
+async def test_create_milestone_posts_to_project_endpoint(client):
+    from fable_mcp.tools.milestones import create_milestone
+    client.post = AsyncMock(return_value={"id": 10, "title": "M1"})
+    await create_milestone(client, project_id=3, title="M1")
+    path = client.post.call_args[0][0]
+    assert path == "/api/projects/3/milestones"
+    assert client.post.call_args[1]["json"]["title"] == "M1"
+
+
+@pytest.mark.asyncio
+async def test_update_milestone_patches(client):
+    from fable_mcp.tools.milestones import update_milestone
+    client.patch = AsyncMock(return_value={"id": 10, "status": "completed"})
+    await update_milestone(client, project_id=3, milestone_id=10, status="completed")
+    path = client.patch.call_args[0][0]
+    assert "/api/projects/3/milestones/10" in path

fable-mcp/tests/test_tools_notes.py

@@ -0,0 +1,56 @@
+"""Tests for notes MCP tools."""
+import pytest
+from unittest.mock import AsyncMock
+
+
+@pytest.fixture
+def client(mock_client):
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_list_notes_calls_get(client):
+    from fable_mcp.tools.notes import list_notes
+    client.get = AsyncMock(return_value={"notes": [], "total": 0})
+    result = await list_notes(client, limit=10)
+    client.get.assert_called_once()
+    call_args = client.get.call_args
+    assert "/api/notes" in call_args[0][0]
+
+
+@pytest.mark.asyncio
+async def test_get_note_calls_correct_endpoint(client):
+    from fable_mcp.tools.notes import get_note
+    client.get = AsyncMock(return_value={"id": 42, "title": "Hello"})
+    result = await get_note(client, note_id=42)
+    client.get.assert_called_once_with("/api/notes/42")
+    assert result["id"] == 42
+
+
+@pytest.mark.asyncio
+async def test_create_note_posts_payload(client):
+    from fable_mcp.tools.notes import create_note
+    client.post = AsyncMock(return_value={"id": 1, "title": "My Note"})
+    result = await create_note(client, title="My Note", body="Content")
+    client.post.assert_called_once()
+    call_kwargs = client.post.call_args[1]
+    assert call_kwargs["json"]["title"] == "My Note"
+    assert call_kwargs["json"]["body"] == "Content"
+
+
+@pytest.mark.asyncio
+async def test_update_note_patches_payload(client):
+    from fable_mcp.tools.notes import update_note
+    client.patch = AsyncMock(return_value={"id": 1, "title": "Updated"})
+    result = await update_note(client, note_id=1, title="Updated")
+    client.patch.assert_called_once()
+    path = client.patch.call_args[0][0]
+    assert "/api/notes/1" in path
+
+
+@pytest.mark.asyncio
+async def test_delete_note_calls_delete(client):
+    from fable_mcp.tools.notes import delete_note
+    client.delete = AsyncMock(return_value=None)
+    await delete_note(client, note_id=5)
+    client.delete.assert_called_once_with("/api/notes/5")

fable-mcp/tests/test_tools_projects.py

@@ -0,0 +1,42 @@
+"""Tests for projects MCP tools."""
+import pytest
+from unittest.mock import AsyncMock
+
+
+@pytest.fixture
+def client(mock_client):
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_list_projects_calls_get(client):
+    from fable_mcp.tools.projects import list_projects
+    client.get = AsyncMock(return_value={"projects": []})
+    await list_projects(client)
+    client.get.assert_called_once_with("/api/projects")
+
+
+@pytest.mark.asyncio
+async def test_get_project_calls_correct_endpoint(client):
+    from fable_mcp.tools.projects import get_project
+    client.get = AsyncMock(return_value={"id": 2, "title": "Proj"})
+    result = await get_project(client, project_id=2)
+    client.get.assert_called_once_with("/api/projects/2")
+
+
+@pytest.mark.asyncio
+async def test_create_project_posts_payload(client):
+    from fable_mcp.tools.projects import create_project
+    client.post = AsyncMock(return_value={"id": 4, "title": "New"})
+    await create_project(client, title="New", description="Desc")
+    call_kwargs = client.post.call_args[1]
+    assert call_kwargs["json"]["title"] == "New"
+    assert call_kwargs["json"]["description"] == "Desc"
+
+
+@pytest.mark.asyncio
+async def test_update_project_patches(client):
+    from fable_mcp.tools.projects import update_project
+    client.patch = AsyncMock(return_value={"id": 4, "status": "active"})
+    await update_project(client, project_id=4, status="active")
+    assert "/api/projects/4" in client.patch.call_args[0][0]

fable-mcp/tests/test_tools_tasks.py

@@ -0,0 +1,54 @@
+"""Tests for tasks MCP tools."""
+import pytest
+from unittest.mock import AsyncMock
+
+
+@pytest.fixture
+def client(mock_client):
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_list_tasks_calls_get(client):
+    from fable_mcp.tools.tasks import list_tasks
+    client.get = AsyncMock(return_value={"tasks": [], "total": 0})
+    await list_tasks(client)
+    client.get.assert_called_once()
+    assert "/api/tasks" in client.get.call_args[0][0]
+
+
+@pytest.mark.asyncio
+async def test_get_task_calls_correct_endpoint(client):
+    from fable_mcp.tools.tasks import get_task
+    client.get = AsyncMock(return_value={"id": 7, "title": "Fix bug"})
+    result = await get_task(client, task_id=7)
+    client.get.assert_called_once_with("/api/tasks/7")
+
+
+@pytest.mark.asyncio
+async def test_create_task_posts_payload(client):
+    from fable_mcp.tools.tasks import create_task
+    client.post = AsyncMock(return_value={"id": 3, "title": "New task"})
+    await create_task(client, title="New task")
+    call_kwargs = client.post.call_args[1]
+    assert call_kwargs["json"]["title"] == "New task"
+
+
+@pytest.mark.asyncio
+async def test_update_task_patches(client):
+    from fable_mcp.tools.tasks import update_task
+    client.patch = AsyncMock(return_value={"id": 3, "status": "done"})
+    await update_task(client, task_id=3, status="done")
+    client.patch.assert_called_once()
+    assert "/api/tasks/3" in client.patch.call_args[0][0]
+
+
+@pytest.mark.asyncio
+async def test_add_task_log_posts_to_logs_endpoint(client):
+    from fable_mcp.tools.tasks import add_task_log
+    client.post = AsyncMock(return_value={"id": 1, "content": "progress"})
+    await add_task_log(client, task_id=9, content="progress")
+    client.post.assert_called_once()
+    path = client.post.call_args[0][0]
+    assert path == "/api/tasks/9/logs"
+    assert client.post.call_args[1]["json"]["content"] == "progress"

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/package-lock.json

@@ -1,11 +1,11 @@
 {
-  "name": "scribe-frontend",
+  "name": "fabledassistant-frontend",
   "version": "0.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
-      "name": "scribe-frontend",
+      "name": "fabledassistant-frontend",
       "version": "0.1.0",
       "dependencies": {
         "@fullcalendar/core": "^6.1.20",

frontend/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "scribe-frontend",
+  "name": "fabledassistant-frontend",
   "private": true,
   "version": "0.1.0",
   "type": "module",

frontend/public/sw.js

@@ -1,11 +1,45 @@
-// Service Worker — PWA installability shell only.
-//
-// The push and notificationclick listeners were removed alongside the chat
-// generation pipeline (they only fired when the internal LLM finished a
-// response). The empty fetch handler is preserved as the installability
-// surface required for "Add to Home Screen" in some browsers; offline
-// caching is intentionally not implemented yet.
+// Service Worker for push notifications and PWA support
+self.addEventListener('push', event => {
+  if (!event.data) return;
+  const data = event.data.json();
+  const notifUrl = data.url || '/';
 
-self.addEventListener('fetch', () => {
+  event.waitUntil(
+    clients.matchAll({ type: 'window', includeUncontrolled: true }).then(clientList => {
+      // Suppress notification if the user already has the relevant page focused
+      for (const client of clientList) {
+        if (client.visibilityState === 'visible' && client.url.includes(notifUrl)) {
+          return;
+        }
+      }
+      return self.registration.showNotification(data.title || 'Scribe', {
+        body: data.body || '',
+        icon: '/favicon.ico',
+        badge: '/favicon.ico',
+        data: { url: notifUrl },
+      });
+    })
+  );
+});
+
+self.addEventListener('notificationclick', event => {
+  event.notification.close();
+  event.waitUntil(
+    clients.matchAll({ type: 'window', includeUncontrolled: true }).then(clientList => {
+      const url = event.notification.data.url;
+      for (const client of clientList) {
+        if (client.url.includes(url) && 'focus' in client) {
+          return client.focus();
+        }
+      }
+      if (clients.openWindow) {
+        return clients.openWindow(url);
+      }
+    })
+  );
+});
+
+// PWA: serve cached assets for offline support (minimal)
+self.addEventListener('fetch', event => {
   // Pass-through — no offline caching in v1
 });

frontend/src/App.vue

@@ -5,26 +5,43 @@ 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";
 import { apiGet, apiPut } from "@/api/client";
 
 useTheme();
 
+const { schedulePreload: scheduleVadPreload } = useOnnxPreloader();
+scheduleVadPreload();
+
 const router = useRouter();
 const appVersion = ref("dev");
 const authStore = useAuthStore();
+const chatStore = useChatStore();
 const settingsStore = useSettingsStore();
 const { showShortcuts, toggleShortcuts, closeShortcuts } = useShortcuts();
 
 function startAppServices() {
+  chatStore.startStatusPolling();
   settingsStore.fetchSettings();
+  settingsStore.checkVoiceStatus();
   // Sync browser timezone to the server on every login/page load.
   apiPut("/api/settings", { user_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone }).catch(() => {});
+  // Re-check voice status when the tab becomes visible again (model may
+  // have finished loading while the user was away).
+  document.addEventListener("visibilitychange", onVisibilityChange);
+}
+
+function onVisibilityChange() {
+  if (document.visibilityState === "visible" && authStore.isAuthenticated) {
+    settingsStore.checkVoiceStatus();
+  }
 }
 
 function stopAppServices() {
-  // no-op for now; kept as a hook for future per-session teardown
+  chatStore.stopStatusPolling();
 }
 
 function isInputActive(): boolean {
@@ -79,10 +96,9 @@ function onGlobalKeydown(e: KeyboardEvent) {
       case "n": router.push("/notes"); break;
       case "t": router.push("/"); break;
       case "p": router.push("/projects"); break;
-      case "r": router.push("/rules"); break;
+      case "c": router.push("/chat"); break;
       case "g": router.push("/graph"); break;
       case "l": router.push("/calendar"); break;
-      case "x": router.push("/trash"); break;
     }
     return;
   }
@@ -110,6 +126,13 @@ function onGlobalKeydown(e: KeyboardEvent) {
       e.preventDefault();
       document.dispatchEvent(new CustomEvent("shortcut:focus-search"));
       break;
+    case "c":
+      if (router.currentRoute.value.name === "home") {
+        document.dispatchEvent(new CustomEvent("shortcut:focus-chat"));
+      } else {
+        router.push("/chat");
+      }
+      break;
   }
 }
 
@@ -140,6 +163,7 @@ watch(
 
 onUnmounted(() => {
   document.removeEventListener("keydown", onGlobalKeydown);
+  document.removeEventListener("visibilitychange", onVisibilityChange);
   stopAppServices();
 });
 </script>
@@ -193,14 +217,14 @@ onUnmounted(() => {
               <div class="shortcut-row">
                 <kbd class="shortcut-key">g</kbd>
                 <span class="shortcut-key-sep">+</span>
-                <kbd class="shortcut-key">l</kbd>
-                <span class="shortcut-desc">Calendar</span>
+                <kbd class="shortcut-key">c</kbd>
+                <span class="shortcut-desc">Chat</span>
               </div>
               <div class="shortcut-row">
                 <kbd class="shortcut-key">g</kbd>
                 <span class="shortcut-key-sep">+</span>
-                <kbd class="shortcut-key">x</kbd>
-                <span class="shortcut-desc">Trash</span>
+                <kbd class="shortcut-key">l</kbd>
+                <span class="shortcut-desc">Calendar</span>
               </div>
               <div class="shortcut-row">
                 <kbd class="shortcut-key">Esc</kbd>
@@ -243,6 +267,23 @@ onUnmounted(() => {
                 <span class="shortcut-desc">Edit current item (viewer)</span>
               </div>
             </div>
+            <div class="shortcuts-section">
+              <div class="shortcuts-section-title">Chat</div>
+              <div class="shortcut-row">
+                <kbd class="shortcut-key">c</kbd>
+                <span class="shortcut-desc">Focus chat (home) / go to chat</span>
+              </div>
+              <div class="shortcut-row">
+                <kbd class="shortcut-key">Enter</kbd>
+                <span class="shortcut-desc">Send message</span>
+              </div>
+              <div class="shortcut-row">
+                <kbd class="shortcut-key">Shift</kbd>
+                <span class="shortcut-key-sep">+</span>
+                <kbd class="shortcut-key">Enter</kbd>
+                <span class="shortcut-desc">New line</span>
+              </div>
+            </div>
           </div>
         </div>
       </div>
@@ -287,6 +328,8 @@ onUnmounted(() => {
   min-height: 0;
   overflow-y: auto;
 }
+.app-content:has(.workspace-root),
+.app-content:has(.chat-page),
 .app-content:has(.knowledge-root) {
   overflow: hidden;
 }

frontend/src/api/client.ts

@@ -299,6 +299,135 @@ export function apiSSEStream(
   return { close: () => controller.abort(), done };
 }
 
+// ---------------------------------------------------------------------------
+// Journal
+// ---------------------------------------------------------------------------
+
+export interface JournalLocation {
+  label: string;
+  address: string;
+  lat?: number;
+  lon?: number;
+}
+
+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 JournalConversation {
+  id: number;
+  title: string;
+  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 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;
+}
+
+export interface JournalDayPayload {
+  day_date: string;
+  conversation: JournalConversation | null;
+  messages: JournalMessage[];
+}
+
+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 getJournalConfig(): Promise<JournalConfig> {
+  return apiGet<JournalConfig>('/api/journal/config');
+}
+
+export async function saveJournalConfig(config: JournalConfig): Promise<void> {
+  await apiPut('/api/journal/config', config);
+}
+
+export async function getJournalToday(): Promise<JournalDayPayload> {
+  return apiGet<JournalDayPayload>('/api/journal/today');
+}
+
+export async function getJournalDay(isoDate: string): Promise<JournalDayPayload> {
+  return apiGet<JournalDayPayload>(`/api/journal/day/${isoDate}`);
+}
+
+export async function getJournalDays(): Promise<string[]> {
+  const data = await apiGet<{ days: string[] }>('/api/journal/days');
+  return data.days;
+}
+
+export async function triggerJournalPrep(date?: string): Promise<{ ok: boolean; message_id: number }> {
+  return apiPost('/api/journal/trigger-prep', date ? { date } : {});
+}
+
+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 updateJournalMoment(id: number, patch: Partial<JournalMoment>): Promise<JournalMoment> {
+  return apiPatch<JournalMoment>(`/api/journal/moments/${id}`, patch);
+}
+
+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/journal/weather/geocode', { query: address });
+    return { lat: r.lat, lon: r.lon, display_name: r.label };
+  } catch {
+    return null;
+  }
+}
+
+export async function getFableMcpInfo(): Promise<{ available: boolean; filename: string | null }> {
+  return apiGet('/api/fable-mcp/info');
+}
+
 export async function apiStreamPost(
   path: string,
   body: unknown,
@@ -416,7 +545,7 @@ export interface EventUpdatePayload {
   description?: string;
   location?: string;
   color?: string;
-  recurrence?: string | null;
+  recurrence?: string;
   project_id?: number;
 }
 
@@ -458,6 +587,93 @@ export const createApiKey = (name: string, scope: 'read' | 'write') =>
 
 export const revokeApiKey = (id: number) => apiDelete(`/api/api-keys/${id}`)
 
+// ─── News ─────────────────────────────────────────────────────────────────────
+
+import type { NewsItem } from '@/types/news'
+
+export interface GetNewsItemsParams {
+  days?: number
+  limit?: number
+  offset?: number
+  feed_id?: number | null
+}
+
+export function getNewsItems(params: GetNewsItemsParams = {}) {
+  const p = new URLSearchParams()
+  if (params.days != null) p.set('days', String(params.days))
+  if (params.limit != null) p.set('limit', String(params.limit))
+  if (params.offset != null) p.set('offset', String(params.offset))
+  if (params.feed_id != null) p.set('feed_id', String(params.feed_id))
+  return apiGet<{ items: NewsItem[]; offset: number; limit: number }>(
+    `/api/briefing/news?${p}`
+  )
+}
+
+// ─── Voice ────────────────────────────────────────────────────────────────────
+
+export interface VoiceStatusResult {
+  enabled: boolean
+  stt: boolean
+  tts: boolean
+  stt_model?: string
+  tts_backend?: string
+}
+
+export interface VoiceEntry {
+  id: string
+  label: string
+}
+
+export interface VoiceBlendEntry {
+  voice: string
+  weight: number
+}
+
+export const getVoiceStatus = () => apiGet<VoiceStatusResult>('/api/voice/status')
+
+export const getVoiceList = () =>
+  apiGet<{ voices: VoiceEntry[] }>('/api/voice/voices').then(r => r.voices)
+
+export async function transcribeAudio(blob: Blob, context?: string): Promise<{ transcript: string; duration_ms: number }> {
+  const form = new FormData()
+  form.append('audio', blob, 'audio.webm')
+  if (context) form.append('context', context)
+  const res = await fetch('/api/voice/transcribe', { method: 'POST', body: form })
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }))
+    throw new ApiError(res.status, err)
+  }
+  return res.json()
+}
+
+export async function synthesiseSpeech(
+  text: string,
+  voice?: string,
+  speed?: number,
+  voiceBlend?: VoiceBlendEntry[]
+): Promise<Blob> {
+  // Only send voice/speed/blend when explicitly provided — omitting them lets
+  // the server auto-load the user's saved voice settings (voice, speed, blend).
+  const body: Record<string, unknown> = { text }
+  if (voiceBlend && voiceBlend.length >= 2) {
+    body.voice_blend = voiceBlend
+    if (speed !== undefined) body.speed = speed
+  } else if (voice !== undefined || speed !== undefined) {
+    body.voice = voice ?? 'af_heart'
+    body.speed = speed ?? 1.0
+  }
+  const res = await fetch('/api/voice/synthesise', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  })
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }))
+    throw new ApiError(res.status, err)
+  }
+  return res.blob()
+}
+
 // ── User Profile ─────────────────────────────────────────────────────────────
 
 export interface UserProfile {
@@ -469,26 +685,14 @@ export interface UserProfile {
   tone: 'casual' | 'professional' | 'technical'
   interests: string[]
   work_schedule: { days?: string[]; start?: string; end?: string }
+  learned_summary: string
+  observations_count: number
+  observations_updated_at: string | null
 }
 
 export const getProfile = () => apiGet<UserProfile>('/api/profile')
 export const updateProfile = (data: Partial<UserProfile>) =>
   apiPut<UserProfile>('/api/profile', data)
-
-
-// ── Note Versions (pinning) ──────────────────────────────────────────────────
-
-import type { NoteVersion } from '../types/task'
-
-/** Mark a note version as manually pinned, optionally with a commit-note
- *  label. Re-calling with a different label updates the label. */
-export const pinNoteVersion = (noteId: number, versionId: number, label?: string | null) =>
-  apiPost<NoteVersion>(
-    `/api/notes/${noteId}/versions/${versionId}/pin`,
-    { label: label ?? null },
-  )
-
-/** Downgrade a manually-pinned version back to rolling. Does NOT delete
- *  the row — older rows may be FIFO-pruned by the next autosave. */
-export const unpinNoteVersion = (noteId: number, versionId: number) =>
-  apiDelete(`/api/notes/${noteId}/versions/${versionId}/pin`)
+export const consolidateProfile = () =>
+  apiPost<{ status: string; learned_summary: string }>('/api/profile/consolidate', {})
+export const clearProfileObservations = () => apiDelete('/api/profile/observations')

frontend/src/api/rulebooks.ts

@@ -1,183 +0,0 @@
-import { apiGet, apiPost, apiPatch, apiDelete } from "@/api/client";
-
-export interface Rulebook {
-  id: number;
-  owner_user_id: number;
-  title: string;
-  description: string;
-  always_on: boolean;
-  created_at: string | null;
-  updated_at: string | null;
-}
-
-export interface RulebookTopic {
-  id: number;
-  rulebook_id: number;
-  title: string;
-  description: string;
-  order_index: number;
-  created_at: string | null;
-  updated_at: string | null;
-}
-
-export interface Rule {
-  id: number;
-  topic_id: number | null;
-  project_id: number | null;
-  title: string;
-  statement: string;
-  why: string;
-  how_to_apply: string;
-  order_index: number;
-  created_at: string | null;
-  updated_at: string | null;
-}
-
-export interface RuleHeader {
-  id: number;
-  title: string;
-  statement: string;
-  topic_id: number | null;
-}
-
-export interface ApplicableRules {
-  rules: {
-    id: number;
-    title: string;
-    statement: string;
-    topic_id: number;
-    topic_title: string;
-    rulebook_id: number;
-    rulebook_title: string;
-  }[];
-  project_rules: {
-    id: number;
-    title: string;
-    statement: string;
-  }[];
-  suppressed_rules: {
-    id: number;
-    title: string;
-    topic_id: number;
-    topic_title: string;
-    rulebook_id: number;
-    rulebook_title: string;
-  }[];
-  suppressed_topics: {
-    id: number;
-    title: string;
-    rulebook_id: number;
-    rulebook_title: string;
-  }[];
-  truncated: boolean;
-  subscribed_rulebooks: { id: number; title: string }[];
-}
-
-// ── Rulebooks ───────────────────────────────────────────────────────
-
-export async function listRulebooks(): Promise<Rulebook[]> {
-  const data = await apiGet<{ rulebooks: Rulebook[] }>("/api/rulebooks");
-  return data.rulebooks;
-}
-
-export async function getRulebook(id: number): Promise<Rulebook & { topics: RulebookTopic[] }> {
-  return apiGet(`/api/rulebooks/${id}`);
-}
-
-export async function createRulebook(data: { title: string; description?: string }): Promise<Rulebook> {
-  return apiPost("/api/rulebooks", data);
-}
-
-export async function updateRulebook(id: number, data: Partial<{ title: string; description: string; always_on: boolean }>): Promise<Rulebook> {
-  return apiPatch(`/api/rulebooks/${id}`, data);
-}
-
-export async function deleteRulebook(id: number): Promise<void> {
-  return apiDelete(`/api/rulebooks/${id}`);
-}
-
-// ── Topics ─────────────────────────────────────────────────────────
-
-export async function listTopics(rulebookId: number): Promise<RulebookTopic[]> {
-  const data = await apiGet<{ topics: RulebookTopic[] }>(`/api/rulebooks/${rulebookId}/topics`);
-  return data.topics;
-}
-
-export async function createTopic(rulebookId: number, data: { title: string; description?: string; order_index?: number }): Promise<RulebookTopic> {
-  return apiPost(`/api/rulebooks/${rulebookId}/topics`, data);
-}
-
-export async function updateTopic(id: number, data: Partial<{ title: string; description: string; order_index: number }>): Promise<RulebookTopic> {
-  return apiPatch(`/api/rulebook-topics/${id}`, data);
-}
-
-export async function deleteTopic(id: number): Promise<void> {
-  return apiDelete(`/api/rulebook-topics/${id}`);
-}
-
-// ── Rules ──────────────────────────────────────────────────────────
-
-export async function listRules(filters: { rulebook_id?: number; topic_id?: number; project_id?: number } = {}): Promise<Rule[]> {
-  const params = new URLSearchParams();
-  if (filters.rulebook_id) params.set("rulebook_id", String(filters.rulebook_id));
-  if (filters.topic_id) params.set("topic_id", String(filters.topic_id));
-  if (filters.project_id) params.set("project_id", String(filters.project_id));
-  const qs = params.toString();
-  const data = await apiGet<{ rules: Rule[] }>(`/api/rules${qs ? `?${qs}` : ""}`);
-  return data.rules;
-}
-
-export async function getRule(id: number): Promise<Rule> {
-  return apiGet(`/api/rules/${id}`);
-}
-
-export async function createRule(topicId: number, data: { title: string; statement: string; why?: string; how_to_apply?: string; order_index?: number }): Promise<Rule> {
-  return apiPost(`/api/rulebook-topics/${topicId}/rules`, data);
-}
-
-export async function updateRule(id: number, data: Partial<{ title: string; statement: string; why: string; how_to_apply: string; order_index: number }>): Promise<Rule> {
-  return apiPatch(`/api/rules/${id}`, data);
-}
-
-export async function deleteRule(id: number): Promise<void> {
-  return apiDelete(`/api/rules/${id}`);
-}
-
-// ── Subscriptions ──────────────────────────────────────────────────
-
-export async function subscribeProject(projectId: number, rulebookId: number): Promise<void> {
-  await apiPost(`/api/projects/${projectId}/rulebook-subscriptions`, { rulebook_id: rulebookId });
-}
-
-export async function unsubscribeProject(projectId: number, rulebookId: number): Promise<void> {
-  return apiDelete(`/api/projects/${projectId}/rulebook-subscriptions/${rulebookId}`);
-}
-
-export async function getProjectApplicableRules(projectId: number): Promise<ApplicableRules> {
-  return apiGet(`/api/projects/${projectId}/rules`);
-}
-
-export async function createProjectRule(
-  projectId: number,
-  data: { statement: string; title?: string; why?: string; how_to_apply?: string },
-): Promise<Rule> {
-  return apiPost(`/api/projects/${projectId}/rules`, data);
-}
-
-// ── Suppressions ───────────────────────────────────────────────────
-
-export async function suppressRuleForProject(projectId: number, ruleId: number): Promise<void> {
-  await apiPost(`/api/projects/${projectId}/suppressions/rules/${ruleId}`, {});
-}
-
-export async function unsuppressRuleForProject(projectId: number, ruleId: number): Promise<void> {
-  return apiDelete(`/api/projects/${projectId}/suppressions/rules/${ruleId}`);
-}
-
-export async function suppressTopicForProject(projectId: number, topicId: number): Promise<void> {
-  await apiPost(`/api/projects/${projectId}/suppressions/topics/${topicId}`, {});
-}
-
-export async function unsuppressTopicForProject(projectId: number, topicId: number): Promise<void> {
-  return apiDelete(`/api/projects/${projectId}/suppressions/topics/${topicId}`);
-}

frontend/src/api/trash.ts

@@ -1,28 +0,0 @@
-import { apiGet, apiPost, apiDelete } from "@/api/client";
-
-export interface TrashItem {
-  type: string;
-  id: number;
-  title: string;
-}
-
-export interface TrashBatch {
-  batch_id: string;
-  deleted_at: string | null;
-  summary: string;
-  count: number;
-  items: TrashItem[];
-}
-
-export async function listTrash(): Promise<TrashBatch[]> {
-  const data = await apiGet<{ batches: TrashBatch[] }>("/api/trash");
-  return data.batches;
-}
-
-export async function restoreBatch(batchId: string): Promise<void> {
-  await apiPost(`/api/trash/${batchId}/restore`, {});
-}
-
-export async function purgeBatch(batchId: string): Promise<void> {
-  return apiDelete(`/api/trash/${batchId}`);
-}

frontend/src/components/AppHeader.vue

@@ -4,20 +4,50 @@ import { useRouter, useRoute } from "vue-router";
 import { useTheme } from "@/composables/useTheme";
 import { useShortcuts } from "@/composables/useShortcuts";
 import { useAuthStore } from "@/stores/auth";
+import { useChatStore } from "@/stores/chat";
 import AppLogo from "@/components/AppLogo.vue";
 import NotificationBell from "@/components/NotificationBell.vue";
-import { Sun, Moon, Settings, Trash2 } from "lucide-vue-next";
+import { Sun, Moon, Settings } from "lucide-vue-next";
 
 const { theme, toggleTheme } = useTheme();
 const { toggleShortcuts } = useShortcuts();
 const authStore = useAuthStore();
+const chatStore = useChatStore();
 const router = useRouter();
 const route = useRoute();
 
+const isChatActive = computed(() => route.path.startsWith("/chat"))
 const isKnowledgeActive = computed(() => route.path === "/knowledge");
 
 const mobileMenuOpen = ref(false);
 
+const statusShortLabel = computed(() => {
+  if (chatStore.ollamaStatus === "unavailable") return "Offline";
+  if (chatStore.ollamaStatus === "checking") return "Checking";
+  if (chatStore.modelStatus === "not_found") return "No model";
+  if (chatStore.modelStatus === "cold") return "Cold";
+  if (chatStore.modelStatus === "loaded") return "Ready";
+  return "Checking";
+});
+
+const statusLabel = computed(() => {
+  if (chatStore.ollamaStatus === "unavailable") return "Ollama unavailable";
+  if (chatStore.ollamaStatus === "checking") return "Checking...";
+  if (chatStore.modelStatus === "not_found") return "Model not installed";
+  if (chatStore.modelStatus === "cold") return "Model cold — first response may be slow";
+  if (chatStore.modelStatus === "loaded") return "Model loaded · ready";
+  return "Checking...";
+});
+
+const statusClass = computed(() => {
+  if (chatStore.ollamaStatus === "unavailable") return "status-red";
+  if (chatStore.ollamaStatus === "checking") return "status-gray";
+  if (chatStore.modelStatus === "not_found") return "status-orange";
+  if (chatStore.modelStatus === "cold") return "status-yellow";
+  if (chatStore.modelStatus === "loaded") return "status-green";
+  return "status-gray";
+});
+
 function toggleMobileMenu() {
   mobileMenuOpen.value = !mobileMenuOpen.value;
 }
@@ -39,22 +69,27 @@ router.afterEach(() => {
       <!-- Left: brand -->
       <router-link to="/" class="nav-brand">
         <AppLogo :size="34" />
-        <span class="brand-text">Scribe</span>
+        <span class="brand-text">Fabled</span>
       </router-link>
 
       <!-- Center: primary navigation (desktop) -->
       <div class="nav-center">
         <div class="nav-pill-bar">
-          <router-link to="/dashboard" class="nav-link">Dashboard</router-link>
-          <router-link to="/knowledge" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Browse</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="/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="/rules" class="nav-link">Rulebooks</router-link>
         </div>
       </div>
 
-      <!-- Right: utilities + gear + user -->
+      <!-- Right: status + utilities + gear + user -->
       <div class="nav-right">
+        <span class="status-indicator" :class="statusClass" :title="statusLabel">
+          <span class="status-dot"></span>
+          <span class="status-text">{{ statusShortLabel }}</span>
+        </span>
+
         <NotificationBell />
 
         <button class="btn-icon" @click="toggleShortcuts" title="Keyboard shortcuts (?)">?</button>
@@ -64,11 +99,6 @@ router.afterEach(() => {
           <Moon v-else :size="16" />
         </button>
 
-        <!-- Trash link -->
-        <router-link to="/trash" class="btn-icon" aria-label="Trash" title="Trash">
-          <Trash2 :size="16" />
-        </router-link>
-
         <!-- Settings link -->
         <router-link to="/settings" class="btn-icon" aria-label="Settings" title="Settings">
           <Settings :size="16" />
@@ -91,17 +121,20 @@ router.afterEach(() => {
 
     <!-- Mobile dropdown -->
     <div v-if="mobileMenuOpen" class="mobile-menu">
-      <router-link to="/dashboard" class="nav-link">Dashboard</router-link>
-      <router-link to="/knowledge" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Browse</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="/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="/rules" class="nav-link">Rulebooks</router-link>
       <router-link to="/shared" class="nav-link">Shared</router-link>
       <div class="mobile-divider"></div>
-      <router-link to="/trash" class="nav-link">Trash</router-link>
       <router-link to="/settings" class="nav-link">Settings</router-link>
       <div class="mobile-divider"></div>
       <div class="mobile-actions">
+        <span class="status-indicator" :class="statusClass" :title="statusLabel">
+          <span class="status-dot"></span>
+          <span class="status-text">{{ statusShortLabel }}</span>
+        </span>
         <button class="btn-icon" @click="toggleShortcuts">?</button>
         <button class="btn-icon" @click="toggleTheme"><Sun v-if="theme === 'dark'" :size="16" />
           <Moon v-else :size="16" /></button>

frontend/src/components/ChatInputBar.vue

@@ -0,0 +1,668 @@
+<script setup lang="ts">
+import { ref, computed, nextTick, onMounted, onUnmounted, watch } from 'vue'
+import { apiGet, transcribeAudio } from '@/api/client'
+import { useVoiceRecorder } from '@/composables/useVoiceRecorder'
+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'
+import type { Note } from '@/types/note'
+import {
+  Paperclip,
+  Volume2,
+  VolumeX,
+  Square,
+  Mic,
+  Loader2,
+  ArrowUp,
+} from 'lucide-vue-next'
+
+const props = withDefaults(defineProps<{
+  /** Textarea placeholder */
+  placeholder?: string
+  /** When true, hides the note picker (briefing mode) */
+  briefingMode?: boolean
+  /** Pill shape — compact rounded style for widget */
+  pill?: boolean
+}>(), {
+  placeholder: 'Type a message… (Enter to send, Shift+Enter for new line)',
+  briefingMode: false,
+  pill: false,
+})
+
+const emit = defineEmits<{
+  submit: [payload: { content: string; contextNoteId?: number }]
+  abort: []
+}>()
+
+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('')
+const inputEl = ref<HTMLTextAreaElement | null>(null)
+const wrapperEl = ref<HTMLElement | null>(null)
+
+function autoResize() {
+  const el = inputEl.value
+  if (!el) return
+  el.style.height = 'auto'
+  el.style.height = Math.min(el.scrollHeight, 150) + 'px'
+}
+
+function resetTextareaHeight() {
+  const el = inputEl.value
+  if (!el) return
+  el.style.height = 'auto'
+}
+
+function onInputKeydown(e: KeyboardEvent) {
+  if (e.key === 'Enter' && !e.shiftKey) {
+    e.preventDefault()
+    onSubmit()
+  }
+}
+
+function onSubmit() {
+  const content = messageInput.value.trim()
+  if (!content) return
+  emit('submit', { content, contextNoteId: attachedNote.value?.id })
+  messageInput.value = ''
+  attachedNote.value = null
+  resetTextareaHeight()
+}
+
+// ── Note picker ───────────────────────────────────────────────────────────────
+const attachedNote = ref<{ id: number; title: string } | null>(null)
+const showNotePicker = ref(false)
+const noteSearchQuery = ref('')
+const noteSearchResults = ref<{ id: number; title: string }[]>([])
+const noteSearchLoading = ref(false)
+let noteSearchTimer: ReturnType<typeof setTimeout> | null = null
+
+function toggleNotePicker() {
+  showNotePicker.value = !showNotePicker.value
+  if (showNotePicker.value) {
+    noteSearchQuery.value = ''
+    noteSearchResults.value = []
+    nextTick(() => {
+      (wrapperEl.value?.querySelector('.note-picker-search') as HTMLInputElement)?.focus()
+    })
+  }
+}
+
+function onNoteSearchInput() {
+  if (noteSearchTimer) clearTimeout(noteSearchTimer)
+  noteSearchTimer = setTimeout(async () => {
+    const q = noteSearchQuery.value.trim()
+    if (!q) { noteSearchResults.value = []; return }
+    noteSearchLoading.value = true
+    try {
+      const data = await apiGet<{ notes: Note[] }>(`/api/notes?q=${encodeURIComponent(q)}&all=true&limit=5`)
+      noteSearchResults.value = data.notes.map((n) => ({ id: n.id, title: n.title }))
+    } catch {
+      noteSearchResults.value = []
+    } finally {
+      noteSearchLoading.value = false
+    }
+  }, 250)
+}
+
+function selectNote(note: { id: number; title: string }) {
+  attachedNote.value = note
+  showNotePicker.value = false
+}
+
+function removeAttachedNote() {
+  attachedNote.value = null
+}
+
+// ── Voice (click-to-toggle + VAD speech detection) ─────────────────────────
+const transcribingVoice = ref(false)
+const recorder = useVoiceRecorder()
+// 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(true)
+  } else {
+    await startRecording()
+  }
+}
+
+async function startRecording() {
+  if (!voiceEnabled.value || recorder.recording.value) return
+  if (!recorder.isSupported) {
+    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) {
+    await vad.start(recorder.stream.value)
+  }
+}
+
+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
+    const { transcript } = await transcribeAudio(blob, lastAssistant)
+    if (transcript.trim()) {
+      messageInput.value = transcript.trim()
+      await nextTick()
+      autoResize()
+      onSubmit()
+    }
+  } catch { /* transcription failed silently */ }
+  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()
+}
+
+function prefill(text: string) {
+  messageInput.value = text
+  nextTick(() => {
+    autoResize()
+    inputEl.value?.focus()
+  })
+}
+
+defineExpose({ focus, prefill })
+</script>
+
+<template>
+  <div ref="wrapperEl" class="chat-input-bar" :class="{ 'chat-input-bar--pill': pill }">
+    <!-- Attached note pill -->
+    <div v-if="attachedNote" class="attached-note">
+      <span class="attached-note-pill">
+        {{ attachedNote.title }}
+        <button class="attached-note-remove" aria-label="Remove" @click="removeAttachedNote">&times;</button>
+      </span>
+    </div>
+
+    <div class="input-row">
+      <!-- Note picker -->
+      <div class="note-picker-wrapper">
+        <button
+          class="btn-icon"
+          @click="toggleNotePicker"
+          :disabled="!store.chatReady"
+          title="Attach a note"
+        >
+          <Paperclip :size="16" />
+        </button>
+        <div v-if="showNotePicker" class="note-picker-dropdown">
+          <input
+            class="note-picker-search"
+            v-model="noteSearchQuery"
+            @input="onNoteSearchInput"
+            placeholder="Search notes..."
+          />
+          <div class="note-picker-results">
+            <div
+              v-for="note in noteSearchResults"
+              :key="note.id"
+              class="note-picker-item"
+              @click="selectNote(note)"
+            >{{ note.title || 'Untitled' }}</div>
+            <div v-if="noteSearchLoading" class="note-picker-empty">Searching...</div>
+            <div v-else-if="noteSearchQuery && !noteSearchResults.length" class="note-picker-empty">No notes found</div>
+          </div>
+        </div>
+      </div>
+
+      <!-- Textarea -->
+      <textarea
+        ref="inputEl"
+        v-model="messageInput"
+        @keydown="onInputKeydown"
+        @input="autoResize"
+        :placeholder="!store.chatReady ? 'Chat unavailable' : store.streaming ? 'Type to queue… (Enter to queue)' : placeholder"
+        :disabled="!store.chatReady"
+        rows="1"
+        class="input-textarea"
+      ></textarea>
+
+      <!-- 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"
+        >
+          <Volume2 v-if="!tts.speaking.value" :size="16" />
+          <VolumeX v-else :size="16" />
+        </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()"
+          >
+            <Square :size="16" fill="currentColor" />
+            <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'"
+        >
+        <Mic v-if="!transcribingVoice" :size="16" />
+        <Loader2 v-else :size="16" class="mic-loader" />
+        </button>
+      </div>
+
+      <!-- Abort (streaming) or Send -->
+      <button
+        v-if="store.streaming"
+        class="btn-abort-inline"
+        @click="emit('abort')"
+        title="Stop generation"
+      >
+        <Square :size="16" fill="currentColor" />
+      </button>
+      <button
+        v-else
+        class="btn-send"
+        @click="onSubmit"
+        :disabled="!messageInput.trim() || !store.chatReady"
+      ><ArrowUp :size="16" /></button>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.chat-input-bar {
+  width: 100%;
+}
+
+.attached-note {
+  padding: 0.25rem 0.5rem;
+}
+.attached-note-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.2rem;
+  background: var(--color-primary);
+  color: #fff;
+  border-radius: 10px;
+  padding: 0.15rem 0.4rem;
+  font-size: 0.75rem;
+}
+.attached-note-remove {
+  background: none;
+  border: none;
+  color: rgba(255, 255, 255, 0.7);
+  cursor: pointer;
+  font-size: 0.9rem;
+  line-height: 1;
+  padding: 0 0.1rem;
+}
+.attached-note-remove:hover { color: #fff; }
+
+.input-row {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.5rem 0.5rem 0.5rem 0.75rem;
+  background: var(--color-input-bar-bg);
+  border-radius: 12px;
+  box-shadow: 0 2px 8px var(--color-shadow);
+}
+
+.chat-input-bar--pill .input-row {
+  border-radius: 24px;
+  padding: 0.6rem 0.6rem 0.6rem 1rem;
+}
+
+.input-textarea {
+  flex: 1;
+  resize: none;
+  padding: 0.35rem 0.5rem;
+  border: none;
+  background: transparent;
+  color: var(--color-input-bar-text);
+  outline: none;
+  font-family: inherit;
+  font-size: 0.9rem;
+  max-height: 150px;
+  overflow-y: auto;
+}
+.input-textarea::placeholder { color: var(--color-input-bar-placeholder); }
+.input-textarea:disabled { opacity: 0.5; }
+
+.btn-icon {
+  background: none;
+  border: none;
+  cursor: pointer;
+  color: var(--color-input-bar-text);
+  opacity: 0.6;
+  padding: 0.2rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: var(--radius-sm);
+  flex-shrink: 0;
+}
+.btn-icon:hover { opacity: 1; }
+.btn-icon:disabled { opacity: 0.3; cursor: default; }
+
+.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-loader { animation: mic-spin 1s linear infinite; }
+@keyframes mic-spin { to { transform: rotate(360deg); } }
+
+/* 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;
+  bottom: calc(100% + 8px);
+  left: 0;
+  width: 260px;
+  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;
+}
+.note-picker-search {
+  width: 100%;
+  padding: 0.45rem 0.65rem;
+  border: none;
+  border-bottom: 1px solid var(--color-border);
+  background: transparent;
+  color: var(--color-text);
+  font-size: 0.85rem;
+  outline: none;
+  font-family: inherit;
+  box-sizing: border-box;
+}
+.note-picker-results { max-height: 180px; overflow-y: auto; }
+.note-picker-item {
+  padding: 0.4rem 0.65rem;
+  cursor: pointer;
+  font-size: 0.85rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.note-picker-item:hover { background: var(--color-bg-secondary); }
+.note-picker-empty { padding: 0.4rem 0.65rem; color: var(--color-text-muted); font-size: 0.8rem; }
+
+.btn-send {
+  width: 30px;
+  min-width: 30px;
+  height: 30px;
+  padding: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--gradient-cta);
+  color: #fff;
+  border: none;
+  border-radius: 50%;
+  cursor: pointer;
+  font-size: 1rem;
+  flex-shrink: 0;
+  transition: box-shadow 0.15s;
+}
+.btn-send:hover { box-shadow: 0 0 16px rgba(91, 74, 138, 0.35); }
+.btn-send:disabled { opacity: 0.35; cursor: default; box-shadow: none; }
+
+.btn-abort-inline {
+  width: 28px;
+  min-width: 28px;
+  height: 28px;
+  padding: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--color-bg-secondary);
+  border: 1px solid var(--color-border);
+  border-radius: 50%;
+  cursor: pointer;
+  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

@@ -0,0 +1,300 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import { renderMarkdown } from "@/utils/markdown";
+import { useSettingsStore } from "@/stores/settings";
+import ToolCallCard from "@/components/ToolCallCard.vue";
+import type { Message } from "@/types/chat";
+
+const settingsStore = useSettingsStore();
+
+const props = defineProps<{
+  message: Message;
+  isStreaming?: boolean;
+}>();
+
+const emit = defineEmits<{
+  saveAsNote: [messageId: number];
+}>();
+
+const rendered = computed(() => renderMarkdown(props.message.content));
+
+const formattedTime = computed(() => {
+  if (!props.message.created_at) return "";
+  const date = new Date(props.message.created_at);
+  return date.toLocaleTimeString([], { hour: "numeric", minute: "2-digit" });
+});
+
+const roleLabel = computed(() => {
+  switch (props.message.role) {
+    case "user":
+      return "You";
+    case "assistant":
+      return settingsStore.assistantName;
+    default:
+      return props.message.role;
+  }
+});
+
+function formatMs(ms: number | null | undefined): string {
+  if (ms == null) return "";
+  if (ms < 1000) return `${ms}ms`;
+  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 [];
+  const parts: string[] = [];
+  if (t.total_ms != null) parts.push(`${formatMs(t.total_ms)} total`);
+  if (t.ttft_ms != null) parts.push(`first token ${formatMs(t.ttft_ms)}`);
+  if (t.intent_ms != null) parts.push(`analyzed ${formatMs(t.intent_ms)}`);
+  for (const tool of t.tools ?? []) {
+    parts.push(`${tool.name.replace(/_/g, " ")} ${formatMs(tool.ms)}`);
+  }
+  if (t.generation_ms != null) parts.push(`generated ${formatMs(t.generation_ms)}`);
+  return parts;
+});
+</script>
+
+<template>
+  <div v-if="!hideMessage" class="chat-message" :class="`role-${message.role}`">
+    <div class="message-group">
+      <div class="message-bubble">
+        <div class="message-header">
+          <span class="role-label">{{ roleLabel }}</span>
+          <div class="message-actions" v-if="message.role === 'assistant' && !isStreaming">
+            <button class="btn-save" @click="emit('saveAsNote', message.id)" title="Save as note">
+              Save as Note
+            </button>
+          </div>
+        </div>
+        <details v-if="message.thinking" class="thinking-block">
+          <summary class="thinking-summary">Reasoning</summary>
+          <pre class="thinking-text">{{ message.thinking }}</pre>
+        </details>
+        <div class="message-content prose" v-html="rendered"></div>
+        <div v-if="message.tool_calls?.length" class="tool-calls">
+          <ToolCallCard
+            v-for="(tc, i) in message.tool_calls"
+            :key="i"
+            :tool-call="tc"
+          />
+        </div>
+        <div
+          v-if="message.context_note_id"
+          class="context-badge"
+        >
+          <router-link :to="`/notes/${message.context_note_id}`">
+            {{ message.context_note_title || `Note #${message.context_note_id}` }}
+          </router-link>
+        </div>
+      </div>
+      <span v-if="formattedTime" class="message-timestamp">{{ formattedTime }}</span>
+      <div v-if="timingParts.length" class="message-timing">
+        <span class="timing-icon">⏱</span>
+        <span v-for="(part, i) in timingParts" :key="i" class="timing-part">
+          <span v-if="i > 0" class="timing-sep">·</span>{{ part }}
+        </span>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.chat-message {
+  display: flex;
+  margin-bottom: 0.75rem;
+}
+.role-user {
+  justify-content: flex-end;
+}
+.role-assistant {
+  justify-content: flex-start;
+}
+
+.message-group {
+  max-width: 80%;
+}
+
+.message-bubble {
+  padding: 0.75rem 1rem;
+  border-radius: 18px;
+}
+
+/* User prompts: recessed, muted — margin notes */
+.role-user .message-bubble {
+  background: var(--color-bubble-user-bg);
+  border: 1px solid var(--color-bubble-user-border);
+  color: var(--color-bubble-user-text);
+  border-bottom-right-radius: 4px;
+}
+
+/* Assistant responses: elevated, lit — the primary text */
+.role-assistant .message-bubble {
+  background: var(--color-bg-card);
+  border-left: 2px solid var(--color-primary);
+  box-shadow: var(--color-bubble-asst-shadow);
+  border-bottom-left-radius: 4px;
+}
+
+.message-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 0.25rem;
+}
+.role-label {
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+.role-user .role-label {
+  color: var(--color-text-muted);
+  opacity: 0.6;
+}
+.role-assistant .role-label {
+  color: var(--color-primary);
+  font-family: 'Fraunces', Georgia, serif;
+  font-optical-sizing: auto;
+  font-size: 0.8rem;
+  text-transform: none;
+  letter-spacing: 0;
+}
+
+.thinking-block {
+  margin-bottom: 0.5rem;
+  border-left: 2px solid rgba(91, 74, 138, 0.35);
+  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+  overflow: hidden;
+}
+.thinking-summary {
+  padding: 0.25rem 0.5rem;
+  font-size: 0.72rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  user-select: none;
+  list-style: none;
+  display: flex;
+  align-items: center;
+  gap: 0.3rem;
+  background: var(--color-bg-secondary);
+}
+.thinking-summary::-webkit-details-marker { display: none; }
+.thinking-summary::before {
+  content: "▶";
+  font-size: 0.6rem;
+  transition: transform 0.15s;
+}
+details[open] .thinking-summary::before {
+  transform: rotate(90deg);
+}
+.thinking-text {
+  margin: 0;
+  padding: 0.5rem;
+  font-size: 0.8rem;
+  line-height: 1.5;
+  color: var(--color-text-secondary);
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 300px;
+  overflow-y: auto;
+  background: var(--color-bg-secondary);
+}
+/* Long-form line-height (1.7) on assistant bubbles per the design system —
+   chat is a reading surface, not a snippet stream. User bubbles stay tighter. */
+.role-assistant .message-content {
+  line-height: 1.7;
+}
+
+.message-content {
+  font-size: 0.95rem;
+  line-height: 1.55;
+  word-break: break-word;
+}
+.message-content :deep(p:last-child) {
+  margin-bottom: 0;
+}
+
+
+.message-actions {
+  display: flex;
+  gap: 0.5rem;
+}
+.btn-save {
+  font-size: 0.7rem;
+  padding: 0.1rem 0.4rem;
+  background: transparent;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-sm);
+  color: var(--color-text-secondary);
+  cursor: pointer;
+}
+.btn-save:hover {
+  background: var(--color-primary);
+  color: #fff;
+  border-color: var(--color-primary);
+}
+.tool-calls {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.3rem;
+  margin-top: 0.4rem;
+}
+.context-badge {
+  margin-top: 0.4rem;
+  font-size: 0.75rem;
+}
+.context-badge a {
+  color: var(--color-primary);
+  text-decoration: none;
+}
+.role-user .context-badge a {
+  color: rgba(255, 255, 255, 0.8);
+}
+.context-badge a:hover {
+  text-decoration: underline;
+}
+
+.message-timestamp {
+  display: block;
+  font-size: 0.7rem;
+  color: var(--color-text-muted);
+  margin-top: 0.15rem;
+  padding: 0 0.5rem;
+}
+.message-timing {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.2rem;
+  padding: 0.1rem 0.5rem 0;
+  font-size: 0.68rem;
+  color: var(--color-text-muted);
+  opacity: 0.7;
+}
+.timing-icon {
+  font-size: 0.65rem;
+}
+.timing-part {
+  white-space: nowrap;
+}
+.timing-sep {
+  margin-right: 0.2rem;
+  opacity: 0.5;
+}
+
+</style>

frontend/src/components/ChatPanel.vue

@@ -0,0 +1,952 @@
+<script setup lang="ts">
+import { ref, computed, watch, nextTick, onMounted, onUnmounted } from 'vue'
+import { useChatStore } from '@/stores/chat'
+import ChatMessage from '@/components/ChatMessage.vue'
+import ChatStreamingBubble from '@/components/ChatStreamingBubble.vue'
+import ChatInputBar from '@/components/ChatInputBar.vue'
+import ToolCallCard from '@/components/ToolCallCard.vue'
+import type { Message, ToolCallRecord } from '@/types/chat'
+import { Mic, ChevronDown, X } from 'lucide-vue-next'
+
+const props = withDefaults(defineProps<{
+  variant: 'full' | 'widget'
+  /** Workspace: pins RAG scope and workspace_project_id */
+  projectId?: number
+  /** Briefing: hides scope chip, hides note picker */
+  briefingMode?: boolean
+  /** Hides input bar — for read-only historical views */
+  readOnly?: boolean
+  placeholder?: string
+  autoFocus?: boolean
+}>(), {
+  briefingMode: false,
+  readOnly: false,
+  autoFocus: false,
+})
+
+const emit = defineEmits<{
+  /** Widget only: emitted when a new conversation is created */
+  'conversation-started': [convId: number]
+}>()
+
+const store = useChatStore()
+
+// ── Scroll ────────────────────────────────────────────────────────────────────
+const messagesEl = ref<HTMLElement | null>(null)
+
+function scrollToBottom() {
+  nextTick(() => {
+    if (messagesEl.value) {
+      messagesEl.value.scrollTop = messagesEl.value.scrollHeight
+    }
+  })
+}
+
+watch(() => store.streamingContent, () => scrollToBottom())
+watch(() => store.currentConversation?.messages.length, () => scrollToBottom())
+
+// Notify CalendarView when an event is created/updated/deleted via tool
+const _calendarToolNames = new Set(['create_event', 'update_event', 'delete_event'])
+const _seenCalendarToolIdx = new Set<number>()
+watch(() => store.streamingToolCalls, (calls) => {
+  calls.forEach((tc, i) => {
+    if (!_seenCalendarToolIdx.has(i) && _calendarToolNames.has(tc.function) && tc.status === 'success') {
+      _seenCalendarToolIdx.add(i)
+      document.dispatchEvent(new CustomEvent('fable:calendar-changed'))
+    }
+  })
+}, { deep: true })
+watch(() => store.streaming, (s) => { if (!s) _seenCalendarToolIdx.clear() })
+
+// ── Note context (full variant — included / suggested / auto-injected notes) ──
+const includedNoteIds = ref<Set<number>>(new Set())
+const includedNotes = ref<{ id: number; title: string }[]>([])
+const suggestedNotes = ref<{ id: number; title: string; score?: number | null }[]>([])
+const autoInjectedNotes = ref<{ id: number; title: string; score?: number | null }[]>([])
+const excludedNoteIds = ref<number[]>([])
+
+watch(
+  () => store.lastContextMeta,
+  (meta) => {
+    if (!meta || props.variant !== 'full') return
+    const alreadyIncluded = includedNoteIds.value
+    const alreadyAutoInjected = new Set(autoInjectedNotes.value.map((n) => n.id))
+    const alreadySuggested = new Set(suggestedNotes.value.map((n) => n.id))
+
+    for (const note of meta.auto_injected_notes ?? []) {
+      if (!alreadyAutoInjected.has(note.id) && !alreadyIncluded.has(note.id)) {
+        autoInjectedNotes.value.push(note)
+        alreadyAutoInjected.add(note.id)
+      }
+    }
+    for (const note of meta.auto_notes ?? []) {
+      if (note.auto_injected) {
+        if (!alreadyAutoInjected.has(note.id) && !alreadyIncluded.has(note.id)) {
+          autoInjectedNotes.value.push(note)
+          alreadyAutoInjected.add(note.id)
+        }
+      } else {
+        if (!alreadyIncluded.has(note.id) && !alreadySuggested.has(note.id) && !alreadyAutoInjected.has(note.id)) {
+          suggestedNotes.value.push(note)
+        }
+      }
+    }
+  }
+)
+
+function includeNote(note: { id: number; title: string }) {
+  if (includedNoteIds.value.has(note.id)) return
+  includedNoteIds.value = new Set([...includedNoteIds.value, note.id])
+  includedNotes.value.push(note)
+  suggestedNotes.value = suggestedNotes.value.filter((n) => n.id !== note.id)
+  autoInjectedNotes.value = autoInjectedNotes.value.filter((n) => n.id !== note.id)
+}
+
+function excludeAutoNote(noteId: number) {
+  autoInjectedNotes.value = autoInjectedNotes.value.filter((n) => n.id !== noteId)
+  if (!excludedNoteIds.value.includes(noteId)) {
+    excludedNoteIds.value = [...excludedNoteIds.value, noteId]
+  }
+}
+
+function removeIncludedNote(noteId: number) {
+  includedNoteIds.value = new Set([...includedNoteIds.value].filter((id) => id !== noteId))
+  const removed = includedNotes.value.find((n) => n.id === noteId)
+  includedNotes.value = includedNotes.value.filter((n) => n.id !== noteId)
+  if (removed && !suggestedNotes.value.some((n) => n.id === noteId)) {
+    suggestedNotes.value.push(removed)
+  }
+}
+
+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)
+
+async function onSubmit(payload: { content: string; contextNoteId?: number }) {
+  if (props.variant === 'widget') {
+    await widgetSend(payload)
+    return
+  }
+  if (!store.currentConversation) return
+  await store.sendMessage(
+    payload.content,
+    payload.contextNoteId,
+    includedNoteIds.value.size ? [...includedNoteIds.value] : undefined,
+    false,
+    undefined,
+    excludedNoteIds.value.length ? excludedNoteIds.value : undefined,
+    props.projectId ?? store.ragProjectId,
+    props.projectId ?? undefined,
+  )
+  scrollToBottom()
+  nextTick(() => inputBarRef.value?.focus())
+}
+
+// ── Widget state ──────────────────────────────────────────────────────────────
+const widgetConvId = ref<number | null>(null)
+const widgetQuery = ref('')
+const widgetDone = ref(false)
+const widgetFinalContent = ref('')
+const widgetFinalToolCalls = ref<ToolCallRecord[]>([])
+
+const isConversational = computed(
+  () => widgetDone.value && widgetFinalToolCalls.value.length === 0
+)
+
+function clearWidget() {
+  widgetConvId.value = null
+  widgetDone.value = false
+  widgetQuery.value = ''
+  widgetFinalContent.value = ''
+  widgetFinalToolCalls.value = []
+}
+
+async function widgetSend(payload: { content: string; contextNoteId?: number }) {
+  widgetConvId.value = null
+  widgetDone.value = false
+  widgetFinalContent.value = ''
+  widgetFinalToolCalls.value = []
+  widgetQuery.value = payload.content
+
+  const conv = await store.createConversation()
+  await store.fetchConversation(conv.id)
+  widgetConvId.value = conv.id
+  emit('conversation-started', conv.id)
+
+  await store.sendMessage(payload.content, payload.contextNoteId, undefined, false)
+
+  const msgs = store.currentConversation?.messages ?? []
+  const lastAssistant = [...msgs].reverse().find((m: Message) => m.role === 'assistant')
+  widgetFinalContent.value = lastAssistant?.content ?? ''
+  widgetFinalToolCalls.value = (lastAssistant?.tool_calls ?? []) as ToolCallRecord[]
+  widgetDone.value = true
+}
+
+// ── Save as note ──────────────────────────────────────────────────────────────
+async function handleSaveAsNote(messageId: number) {
+  try {
+    await store.saveMessageAsNote(messageId)
+    const { useToastStore } = await import('@/stores/toast')
+    useToastStore().show('Saved as note')
+  } catch {
+    const { useToastStore } = await import('@/stores/toast')
+    useToastStore().show('Failed to save as note', 'error')
+  }
+}
+
+// ── Lifecycle ─────────────────────────────────────────────────────────────────
+onMounted(() => {
+  if (props.autoFocus) nextTick(() => inputBarRef.value?.focus())
+})
+
+// ── Exposed ───────────────────────────────────────────────────────────────────
+function focus() {
+  inputBarRef.value?.focus()
+}
+
+function prefill(text: string) {
+  inputBarRef.value?.prefill(text)
+}
+
+async function send(text: string) {
+  await onSubmit({ content: text })
+}
+
+// ── 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-full">
+      <!-- Message list -->
+      <div ref="messagesEl" class="messages-container">
+        <div class="messages-inner">
+          <template
+            v-for="(msg, index) in store.currentConversation?.messages ?? []"
+            :key="msg.id"
+          >
+            <!-- Briefing slot separator: before any non-first slot message (skip intermediate tool-call rows) -->
+            <div
+              v-if="briefingMode && msg.role === 'assistant' && msg.metadata?.briefing_slot && !msg.metadata?.briefing_intermediate && hasEarlierBriefingSlot(index)"
+              class="briefing-slot-separator"
+            ></div>
+            <ChatMessage
+              :message="msg"
+              @save-as-note="handleSaveAsNote"
+            />
+          </template>
+          <!-- Streaming bubble -->
+          <ChatStreamingBubble v-if="store.streaming" />
+          <!-- Queued messages -->
+          <template v-if="store.queuedMessages.length">
+            <div
+              v-for="(q, i) in store.queuedMessages"
+              :key="`queued-${i}`"
+              class="chat-message role-user queued-message"
+            >
+              <div class="message-bubble queued-bubble">
+                <div class="queued-badge">Queued</div>
+                <div class="message-content">{{ q.content }}</div>
+              </div>
+            </div>
+            <div class="queued-clear-row">
+              <button class="queued-clear-btn" @click="store.clearQueue()">
+                Cancel {{ store.queuedMessages.length }} queued
+              </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">
+              <Mic class="voice-icon" :size="16" />
+              <span>Start in voice mode</span>
+            </button>
+          </div>
+          <p
+            v-else-if="!store.currentConversation?.messages.length && !store.streaming"
+            class="empty-msg"
+          >Start a conversation.</p>
+        </div>
+      </div>
+
+      <!-- Context sidebar (full, non-briefing, non-workspace) -->
+      <aside v-if="hasContextSidebar" class="context-sidebar">
+        <template v-if="autoInjectedNotes.length">
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('auto') }"
+            @click="toggleSection('auto')"
+          >
+            <ChevronDown class="chev" :size="16" />
+            <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"><X :size="16" /></button>
+            </div>
+          </div>
+        </template>
+        <template v-if="suggestedNotes.length">
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('suggested'), 'context-sidebar-header-gap': autoInjectedNotes.length }"
+            @click="toggleSection('suggested')"
+          >
+            <ChevronDown class="chev" :size="16" />
+            <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">
+          <button
+            class="context-sidebar-header"
+            :class="{ collapsed: collapsedSections.has('included'), 'context-sidebar-header-gap': autoInjectedNotes.length || suggestedNotes.length }"
+            @click="toggleSection('included')"
+          >
+            <ChevronDown class="chev" :size="16" />
+            <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"><X :size="16" /></button>
+            </div>
+          </div>
+        </template>
+      </aside>
+
+      <!-- Input area (hidden when readOnly) -->
+      <div v-if="!readOnly" class="input-wrapper">
+      <!-- Unified input bar -->
+      <ChatInputBar
+        ref="inputBarRef"
+        :placeholder="placeholder"
+        :briefing-mode="briefingMode"
+        @submit="onSubmit"
+        @abort="store.cancelGeneration()"
+      />
+      </div>
+    </div>
+  </template>
+
+  <!-- ══════════════════════════════ WIDGET VARIANT ══════════════════════════════ -->
+  <template v-else>
+    <ChatInputBar
+      ref="inputBarRef"
+      pill
+      :placeholder="placeholder ?? 'Start a new chat… (Enter to send)'"
+      :briefing-mode="false"
+      @submit="onSubmit"
+      @abort="store.cancelGeneration()"
+    />
+
+    <!-- Inline response area -->
+    <div v-if="widgetConvId" class="widget-response">
+      <div class="widget-query">{{ widgetQuery }}</div>
+
+      <!-- Tool calls -->
+      <div v-if="store.streaming && store.streamingToolCalls.length" class="widget-tool-calls">
+        <ToolCallCard v-for="(tc, i) in store.streamingToolCalls" :key="i" :tool-call="tc" />
+      </div>
+      <div v-else-if="widgetDone && widgetFinalToolCalls.length" class="widget-tool-calls">
+        <ToolCallCard v-for="(tc, i) in widgetFinalToolCalls" :key="i" :tool-call="tc" />
+      </div>
+
+      <!-- Streaming / final text -->
+      <div v-if="store.streaming" class="widget-text streaming">
+        <div v-if="store.streamingStatus && !store.streamingContent" class="widget-status">
+          <span class="widget-status-dot"></span>{{ store.streamingStatus }}
+        </div>
+        <span v-else-if="store.streamingContent">{{ store.streamingContent }}</span>
+        <span v-else class="thinking-dots">...</span>
+      </div>
+      <div v-else-if="widgetDone && widgetFinalContent" class="widget-text">
+        {{ widgetFinalContent }}
+      </div>
+
+      <!-- Actions -->
+      <div class="widget-actions" :class="{ conversational: isConversational }">
+        <router-link
+          :to="`/chat/${widgetConvId}`"
+          class="btn-open-chat"
+          :class="{ prominent: isConversational }"
+        >{{ isConversational ? 'Continue the conversation →' : 'Think it through in Chat →' }}</router-link>
+        <button class="btn-clear-response" @click="clearWidget">Clear</button>
+      </div>
+    </div>
+  </template>
+</template>
+
+<style scoped>
+/* ── 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;
+  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 {
+  grid-column: 2;
+  grid-row: 1;
+  overflow-y: auto;
+  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);
+}
+.messages-inner {
+  display: flex;
+  flex-direction: column;
+  min-height: 100%;
+  justify-content: flex-end;
+}
+
+/* Briefing slot separator */
+.briefing-slot-separator {
+  height: 1px;
+  margin: 1.25rem 0 0.75rem;
+  background: var(--color-border, #333);
+  opacity: 0.35;
+}
+
+/* Context sidebar — overlays right gutter, never shifts reading column */
+.context-sidebar {
+  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: 500;
+  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: 500;
+  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.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: 500;
+  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;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--color-text);
+  text-decoration: none;
+  font-size: 0.78rem;
+}
+.context-note-name:hover { color: var(--color-primary); }
+.context-note-score {
+  font-size: 0.65rem;
+  padding: 0.05rem 0.25rem;
+  border-radius: 4px;
+  background: var(--color-bg);
+}
+.score-high { color: #22c55e; }
+.score-medium { color: #f59e0b; }
+.score-low { color: var(--color-text-muted); }
+.context-note-remove, .context-note-add {
+  background: none;
+  border: none;
+  cursor: pointer;
+  color: var(--color-text-muted);
+  font-size: 0.9rem;
+  line-height: 1;
+  padding: 0 0.1rem;
+  flex-shrink: 0;
+}
+.context-note-remove:hover { color: #ef4444; }
+.context-note-add:hover { color: var(--color-primary); }
+
+/* Input wrapper — lives in the same reading column as messages */
+.input-wrapper {
+  grid-column: 2;
+  grid-row: 2;
+  padding: 0.5rem 1rem 0.75rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.4rem;
+}
+
+/* Queued messages */
+.queued-message { opacity: 0.45; }
+.queued-bubble {
+  background: var(--color-bg-secondary);
+  border: 1px dashed var(--color-border);
+  border-radius: var(--radius-md);
+  padding: 0.5rem 0.75rem;
+  font-size: 0.85rem;
+}
+.queued-badge {
+  font-size: 0.65rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--color-text-muted);
+  font-weight: 500;
+  margin-bottom: 0.2rem;
+}
+.queued-clear-row {
+  display: flex;
+  justify-content: center;
+  padding: 0.25rem 0;
+}
+.queued-clear-btn {
+  background: none;
+  border: none;
+  font-size: 0.75rem;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  text-decoration: underline;
+}
+
+.empty-msg {
+  color: var(--color-text-secondary);
+  font-size: 0.9rem;
+  text-align: center;
+  padding: 2rem 1rem;
+  font-family: 'Fraunces', Georgia, serif;
+}
+
+.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-weight: 400;
+  font-size: 1.75rem;
+  color: var(--color-text-secondary);
+  text-align: center;
+  margin: 0;
+}
+
+.empty-section-label {
+  font-size: 0.7rem;
+  font-weight: 500;
+  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(91, 74, 138, 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, #5B4A8A, #3F3560);
+  color: #fff;
+  box-shadow: 0 4px 16px rgba(91, 74, 138, 0.35);
+}
+
+.empty-voice-btn .voice-icon {
+  font-size: 1.05rem;
+}
+
+/* ── Widget variant ── */
+.widget-response {
+  margin-top: 0.75rem;
+  background: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-lg);
+  padding: 0.75rem 1rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+.widget-query {
+  font-size: 0.8rem;
+  color: var(--color-text-muted);
+}
+.widget-text {
+  font-size: 0.9rem;
+  line-height: 1.55;
+  color: var(--color-text);
+}
+.widget-text.streaming { color: var(--color-text-muted); }
+.thinking-dots { color: var(--color-text-muted); letter-spacing: 0.2em; }
+.widget-status {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  font-size: 0.8rem;
+  color: var(--color-text-muted);
+}
+.widget-status-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  animation: blink 1s infinite;
+  flex-shrink: 0;
+}
+@keyframes blink { 0%, 100% { opacity: 0.3; } 50% { opacity: 1; } }
+.widget-tool-calls { display: flex; flex-direction: column; gap: 0.25rem; }
+.widget-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding-top: 0.25rem;
+  border-top: 1px solid var(--color-border);
+  flex-wrap: wrap;
+}
+.btn-open-chat {
+  font-size: 0.8rem;
+  color: var(--color-text-muted);
+  text-decoration: none;
+}
+.btn-open-chat:hover { color: var(--color-primary); }
+.btn-open-chat.prominent {
+  font-size: 0.9rem;
+  color: var(--color-primary);
+  font-weight: 500;
+}
+.btn-clear-response {
+  background: none;
+  border: none;
+  font-size: 0.75rem;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  margin-left: auto;
+}
+.btn-clear-response:hover { color: var(--color-text); }
+
+/* Streaming bubble styles — applied via :deep to ChatStreamingBubble children */
+:deep(.streaming-bubble) {
+  max-width: 85%;
+  padding: 0.75rem 1rem;
+  border-radius: 16px 16px 16px 4px;
+  background: var(--color-bg-card);
+  border-left: 2px solid var(--color-primary);
+  box-shadow: 0 1px 4px var(--color-shadow);
+}
+:deep(.streaming-tool-calls) { margin-bottom: 0.5rem; }
+:deep(.streaming-status-line) {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  font-size: 0.8rem;
+  color: var(--color-text-muted);
+  margin-bottom: 0.25rem;
+}
+:deep(.streaming-status-dot) {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  animation: blink 1s infinite;
+  flex-shrink: 0;
+}
+:deep(.thinking-block) {
+  margin-bottom: 0.5rem;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-sm);
+  overflow: hidden;
+}
+:deep(.thinking-summary) {
+  padding: 0.25rem 0.5rem;
+  font-size: 0.72rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  list-style: none;
+  background: var(--color-bg-secondary);
+  display: flex;
+  align-items: center;
+  gap: 0.3rem;
+}
+:deep(.thinking-summary::-webkit-details-marker) { display: none; }
+:deep(.thinking-text) {
+  margin: 0;
+  padding: 0.5rem;
+  font-size: 0.8rem;
+  color: var(--color-text-secondary);
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 300px;
+  overflow-y: auto;
+  background: var(--color-bg-secondary);
+  border-top: 1px solid var(--color-border);
+}
+:deep(.typing-indicator) {
+  display: inline-block;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  animation: blink 1s infinite;
+  margin-left: 4px;
+  vertical-align: middle;
+}
+</style>

frontend/src/components/ChatStreamingBubble.vue

@@ -0,0 +1,56 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useChatStore } from '@/stores/chat'
+import { useSettingsStore } from '@/stores/settings'
+import { renderMarkdown } from '@/utils/markdown'
+import ToolCallCard from '@/components/ToolCallCard.vue'
+import ToolConfirmCard from '@/components/ToolConfirmCard.vue'
+
+const store = useChatStore()
+const settingsStore = useSettingsStore()
+
+const streamingRendered = computed(() => {
+  if (!store.streamingContent) return ''
+  return renderMarkdown(store.streamingContent)
+})
+</script>
+
+<template>
+  <div class="chat-message role-assistant">
+    <div class="message-bubble streaming-bubble">
+      <div class="message-header">
+        <span class="role-label">{{ settingsStore.assistantName }}</span>
+      </div>
+      <div v-if="store.streamingToolCalls.length" class="streaming-tool-calls">
+        <ToolCallCard
+          v-for="(tc, i) in store.streamingToolCalls"
+          :key="i"
+          :tool-call="tc"
+        />
+      </div>
+      <ToolConfirmCard
+        v-if="store.streamingPendingTool"
+        :pending-tool="store.streamingPendingTool"
+        @accept="store.confirmTool(true)"
+        @decline="store.confirmTool(false)"
+      />
+      <div v-if="store.streamingStatus" class="streaming-status-line">
+        <span class="streaming-status-dot"></span>
+        {{ store.streamingStatus }}
+      </div>
+      <details
+        v-if="store.streamingThinking"
+        class="thinking-block"
+        :open="!store.streamingContent"
+      >
+        <summary class="thinking-summary">Reasoning</summary>
+        <pre class="thinking-text">{{ store.streamingThinking }}</pre>
+      </details>
+      <div class="message-content prose" v-html="streamingRendered"></div>
+      <span
+        v-if="!store.streamingStatus && !store.streamingThinking && !store.streamingContent"
+        class="typing-indicator"
+      ></span>
+    </div>
+  </div>
+</template>

frontend/src/components/EventSlideOver.vue

@@ -37,36 +37,6 @@ const description = ref("");
 const location = ref("");
 const color = ref("");
 const projectId = ref<number | null>(null);
-const recurrence = ref<string>("");
-
-// Preset RRULE strings. The select binds to `recurrencePreset`, which writes
-// through to `recurrence`. CalDAV-imported rules with extra parts
-// (e.g. `FREQ=WEEKLY;BYDAY=MO,WE,FR`) fall through to "custom" and the raw
-// string is shown read-only below the select.
-const RECURRENCE_PRESETS: Record<string, string> = {
-  none: "",
-  daily: "FREQ=DAILY",
-  weekly: "FREQ=WEEKLY",
-  monthly: "FREQ=MONTHLY",
-  yearly: "FREQ=YEARLY",
-};
-
-const recurrencePreset = computed<string>({
-  get() {
-    const r = (recurrence.value || "").trim();
-    if (!r) return "none";
-    for (const [key, val] of Object.entries(RECURRENCE_PRESETS)) {
-      if (val && val === r) return key;
-    }
-    return "custom";
-  },
-  set(key: string) {
-    if (key === "custom") return; // no-op; can't pick custom from dropdown
-    recurrence.value = RECURRENCE_PRESETS[key] ?? "";
-  },
-});
-
-const isCustomRecurrence = computed(() => recurrencePreset.value === "custom");
 
 function dateFromIso(iso: string): string {
   const d = new Date(iso);
@@ -145,7 +115,6 @@ function resetForm() {
     location.value = props.event.location || "";
     color.value = props.event.color || "";
     projectId.value = props.event.project_id;
-    recurrence.value = props.event.recurrence || "";
     _lastDurationMin = !allDay.value && startTime.value && endTime.value ? durationMin(startTime.value, endTime.value) : 60;
     if (_lastDurationMin <= 0) _lastDurationMin = 60;
   } else {
@@ -161,7 +130,6 @@ function resetForm() {
     location.value = "";
     color.value = "";
     projectId.value = null;
-    recurrence.value = "";
     _lastDurationMin = 60;
   }
   deleteConfirm.value = false;
@@ -289,7 +257,6 @@ async function save() {
         location: location.value,
         color: color.value,
         project_id: projectId.value ?? undefined,
-        recurrence: recurrence.value || null,
       };
       const updated = await updateEvent(props.event.id, payload);
       emit("updated", updated);
@@ -303,7 +270,6 @@ async function save() {
         location: location.value,
         color: color.value,
         project_id: projectId.value ?? undefined,
-        recurrence: recurrence.value || undefined,
       };
       const created = await createEvent(payload);
       emit("created", created);
@@ -408,24 +374,6 @@ async function doDelete() {
             </div>
           </div>
 
-          <!-- Recurrence -->
-          <div class="form-field">
-            <label class="form-label">Repeat</label>
-            <select v-model="recurrencePreset" class="form-input">
-              <option value="none">Does not repeat</option>
-              <option value="daily">Daily</option>
-              <option value="weekly">Weekly</option>
-              <option value="monthly">Monthly</option>
-              <option value="yearly">Yearly</option>
-              <option v-if="isCustomRecurrence" value="custom" disabled>Custom</option>
-            </select>
-            <p v-if="isCustomRecurrence" class="recurrence-custom-hint">
-              Custom rule: <code>{{ recurrence }}</code>
-              <br />
-              <span class="form-hint">Picking a preset will replace this rule.</span>
-            </p>
-          </div>
-
           <!-- Location -->
           <div class="form-field">
             <label class="form-label">Location <span class="form-hint">(optional)</span></label>
@@ -591,22 +539,6 @@ async function doDelete() {
   color: var(--color-text-secondary);
 }
 
-.recurrence-custom-hint {
-  margin: 4px 0 0;
-  font-size: 0.75rem;
-  color: var(--color-text-secondary);
-  line-height: 1.4;
-}
-.recurrence-custom-hint code {
-  background: var(--color-input-bg, #111113);
-  border: 1px solid var(--color-border, #2a2b30);
-  border-radius: 4px;
-  padding: 1px 5px;
-  font-family: var(--font-mono, ui-monospace, monospace);
-  font-size: 0.72rem;
-  color: var(--color-text, #e8e9f0);
-}
-
 .toggle-btn {
   background: var(--color-input-bg, #111113);
   border: 1px solid var(--color-border, #2a2b30);

frontend/src/components/HistoryPanel.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { ref, computed, onMounted } from "vue";
-import { apiGet, pinNoteVersion, unpinNoteVersion } from "@/api/client";
+import { apiGet } from "@/api/client";
 import DiffView from "@/components/DiffView.vue";
 import type { DiffLine } from "@/composables/useAssist";
 
@@ -10,8 +10,6 @@ interface NoteVersion {
   title: string;
   tags: string[];
   body?: string;
-  pin_kind: "auto" | "manual" | null;
-  pin_label: string | null;
   created_at: string;
 }
 
@@ -107,69 +105,6 @@ function restore() {
   emit('restore', selectedVersion.value.body, selectedVersion.value.tags ?? []);
 }
 
-// ── Pin / unpin / edit-label state ──────────────────────────────────────────
-
-const editingLabel = ref(false);
-const draftLabel = ref("");
-const pinSaving = ref(false);
-
-function startEditLabel() {
-  if (!selectedVersion.value) return;
-  draftLabel.value = selectedVersion.value.pin_label ?? "";
-  editingLabel.value = true;
-}
-
-function cancelEditLabel() {
-  editingLabel.value = false;
-  draftLabel.value = "";
-}
-
-async function savePin() {
-  if (!selectedVersion.value || pinSaving.value) return;
-  pinSaving.value = true;
-  try {
-    const updated = await pinNoteVersion(
-      props.noteId, selectedVersion.value.id, draftLabel.value || null,
-    );
-    // Reflect server state in the local list + selected version.
-    const idx = versions.value.findIndex(v => v.id === updated.id);
-    if (idx >= 0) {
-      versions.value[idx].pin_kind = updated.pin_kind;
-      versions.value[idx].pin_label = updated.pin_label;
-    }
-    if (selectedVersion.value) {
-      selectedVersion.value.pin_kind = updated.pin_kind;
-      selectedVersion.value.pin_label = updated.pin_label;
-    }
-    editingLabel.value = false;
-  } catch {
-    // silent — leaving the form open lets the user retry
-  } finally {
-    pinSaving.value = false;
-  }
-}
-
-async function unpinSelected() {
-  if (!selectedVersion.value || pinSaving.value) return;
-  pinSaving.value = true;
-  try {
-    await unpinNoteVersion(props.noteId, selectedVersion.value.id);
-    const idx = versions.value.findIndex(v => v.id === selectedVersion.value!.id);
-    if (idx >= 0) {
-      versions.value[idx].pin_kind = null;
-      versions.value[idx].pin_label = null;
-    }
-    if (selectedVersion.value) {
-      selectedVersion.value.pin_kind = null;
-      selectedVersion.value.pin_label = null;
-    }
-  } catch {
-    // silent
-  } finally {
-    pinSaving.value = false;
-  }
-}
-
 onMounted(loadVersions);
 </script>
 
@@ -193,25 +128,7 @@ onMounted(loadVersions);
               :class="['history-item', { selected: selectedVersion?.id === v.id }]"
               @click="selectVersionItem(v)"
             >
-              <div class="history-item-title">
-                <span
-                  v-if="v.pin_kind === 'manual'"
-                  class="pin-badge pin-badge-manual"
-                  :title="v.pin_label || 'Pinned'"
-                  aria-label="manually pinned"
-                >●</span>
-                <span
-                  v-else-if="v.pin_kind === 'auto'"
-                  class="pin-badge pin-badge-auto"
-                  :title="v.pin_label || 'Auto-pinned (stable)'"
-                  aria-label="auto-pinned"
-                >◐</span>
-                {{ v.title || 'Untitled' }}
-              </div>
-              <div
-                v-if="v.pin_kind === 'manual' && v.pin_label"
-                class="history-item-label"
-              >{{ v.pin_label }}</div>
+              <div class="history-item-title">{{ v.title || 'Untitled' }}</div>
               <div class="history-item-date">{{ formatDate(v.created_at) }}</div>
             </div>
           </div>
@@ -220,62 +137,7 @@ onMounted(loadVersions);
           <div class="history-diff">
             <div v-if="loadingDetail" class="history-empty">Loading version...</div>
             <div v-else-if="!selectedVersion" class="history-empty">Select a version to compare.</div>
-            <template v-else>
-              <div class="version-pin-controls">
-                <!-- Label editor -->
-                <div v-if="editingLabel" class="pin-label-form">
-                  <input
-                    v-model="draftLabel"
-                    maxlength="500"
-                    type="text"
-                    class="pin-label-input"
-                    placeholder="Optional label (e.g. 'post-network-refresh runbook')"
-                  />
-                  <button class="btn-pin-save" :disabled="pinSaving" @click="savePin">
-                    {{ pinSaving ? "Saving…" : "Save" }}
-                  </button>
-                  <button class="btn-pin-cancel" @click="cancelEditLabel">Cancel</button>
-                </div>
-
-                <!-- Default: kind-aware action row -->
-                <div v-else class="pin-actions">
-                  <span v-if="selectedVersion.pin_kind === 'manual'" class="pin-state">
-                    <span class="pin-badge pin-badge-manual">●</span>
-                    Manually pinned{{ selectedVersion.pin_label ? `: ${selectedVersion.pin_label}` : '' }}
-                  </span>
-                  <span v-else-if="selectedVersion.pin_kind === 'auto'" class="pin-state">
-                    <span class="pin-badge pin-badge-auto">◐</span>
-                    Auto-pinned{{ selectedVersion.pin_label ? `: ${selectedVersion.pin_label}` : '' }}
-                  </span>
-
-                  <button
-                    v-if="selectedVersion.pin_kind === null"
-                    class="btn-pin"
-                    :disabled="pinSaving"
-                    @click="startEditLabel"
-                  >Pin version</button>
-                  <button
-                    v-else-if="selectedVersion.pin_kind === 'manual'"
-                    class="btn-pin-edit"
-                    :disabled="pinSaving"
-                    @click="startEditLabel"
-                  >Edit label</button>
-                  <button
-                    v-else
-                    class="btn-pin"
-                    :disabled="pinSaving"
-                    @click="startEditLabel"
-                  >Pin permanently</button>
-                  <button
-                    v-if="selectedVersion.pin_kind === 'manual'"
-                    class="btn-unpin"
-                    :disabled="pinSaving"
-                    @click="unpinSelected"
-                  >Unpin</button>
-                </div>
-              </div>
-              <DiffView :diff="diff" />
-            </template>
+            <DiffView v-else :diff="diff" />
           </div>
         </div>
 
@@ -406,101 +268,4 @@ onMounted(loadVersions);
   opacity: 0.5;
   cursor: default;
 }
-
-/* ── Pin badges + label rendering ───────────────────────────────────────── */
-.pin-badge {
-  display: inline-block;
-  width: 0.7rem;
-  text-align: center;
-  margin-right: 0.35rem;
-  font-size: 0.85em;
-  line-height: 1;
-}
-.pin-badge-manual { color: var(--color-primary, #6366f1); }
-.pin-badge-auto { color: var(--color-text-muted, rgba(255, 255, 255, 0.5)); }
-
-.history-item-label {
-  font-size: 0.72rem;
-  color: var(--color-primary, #6366f1);
-  font-style: italic;
-  margin-top: 0.15rem;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-/* ── Pin controls above the diff ────────────────────────────────────────── */
-.version-pin-controls {
-  padding: 0.4rem 0.5rem 0.5rem;
-  border-bottom: 1px solid var(--color-border);
-  font-size: 0.82rem;
-}
-.pin-actions {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  flex-wrap: wrap;
-}
-.pin-state {
-  font-style: italic;
-  color: var(--color-text-muted, rgba(255, 255, 255, 0.6));
-  flex: 1;
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.btn-pin, .btn-pin-edit, .btn-unpin {
-  padding: 0.25rem 0.7rem;
-  font-size: 0.78rem;
-  background: transparent;
-  color: inherit;
-  border: 1px solid var(--color-border, rgba(255, 255, 255, 0.12));
-  border-radius: 999px;
-  cursor: pointer;
-}
-.btn-pin:hover:not(:disabled), .btn-pin-edit:hover:not(:disabled) {
-  background: rgba(99, 102, 241, 0.12);
-  border-color: var(--color-primary, #6366f1);
-}
-.btn-unpin:hover:not(:disabled) {
-  background: rgba(239, 68, 68, 0.10);
-  border-color: rgba(239, 68, 68, 0.5);
-}
-.pin-label-form {
-  display: flex;
-  gap: 0.4rem;
-  align-items: center;
-}
-.pin-label-input {
-  flex: 1;
-  padding: 0.3rem 0.5rem;
-  font-size: 0.85rem;
-  background: var(--color-input-bg, rgba(255, 255, 255, 0.03));
-  border: 1px solid var(--color-border, rgba(255, 255, 255, 0.12));
-  border-radius: var(--radius-sm, 4px);
-  color: inherit;
-}
-.pin-label-input:focus {
-  outline: none;
-  border-color: var(--color-primary, #6366f1);
-}
-.btn-pin-save, .btn-pin-cancel {
-  padding: 0.3rem 0.7rem;
-  font-size: 0.78rem;
-  background: transparent;
-  color: inherit;
-  border: 1px solid var(--color-border, rgba(255, 255, 255, 0.12));
-  border-radius: var(--radius-sm, 4px);
-  cursor: pointer;
-}
-.btn-pin-save:hover:not(:disabled) {
-  background: rgba(99, 102, 241, 0.12);
-  border-color: var(--color-primary, #6366f1);
-}
-.btn-pin-save:disabled, .btn-pin-cancel:disabled,
-.btn-pin:disabled, .btn-pin-edit:disabled, .btn-unpin:disabled {
-  opacity: 0.5;
-  cursor: progress;
-}
 </style>

frontend/src/components/NotificationsPanel.vue

@@ -13,23 +13,6 @@ const typeIcon: Record<string, string> = {
   project_shared: '📁',
   note_shared: '📝',
   group_added: '👥',
-  event_reminder: '⏰',
-}
-
-function notifMessage(n: { type: string; payload: Record<string, unknown> }): string {
-  const p = n.payload
-  switch (n.type) {
-    case 'project_shared':
-      return ` shared "${p.project_title}" with you as ${p.permission}`
-    case 'note_shared':
-      return ` shared "${p.note_title}" with you as ${p.permission}`
-    case 'group_added':
-      return ` added you to "${p.group_name}" as ${p.role}`
-    case 'event_reminder':
-      return `Reminder: "${p.title}" is coming up`
-    default:
-      return ''
-  }
 }
 
 async function handleClick(notif: { id: number; payload: Record<string, unknown> }) {
@@ -66,7 +49,11 @@ onMounted(() => store.fetchAll())
         <div class="notif-body">
           <p class="notif-msg">
             <strong v-if="n.payload.invited_by">{{ n.payload.invited_by }}</strong>
-            {{ notifMessage(n) }}
+            {{ n.type === 'project_shared'
+                ? ` shared "${n.payload.project_title}" with you as ${n.payload.permission}`
+                : n.type === 'note_shared'
+                  ? ` shared "${n.payload.note_title}" with you as ${n.payload.permission}`
+                  : ` added you to "${n.payload.group_name}" as ${n.payload.role}` }}
           </p>
           <span class="notif-time">{{ relativeTime(n.created_at) }}</span>
         </div>

frontend/src/components/ToolCallCard.vue

@@ -0,0 +1,814 @@
+<script setup lang="ts">
+import { computed, ref, watch } from "vue";
+import { apiPost, getEvent } from "@/api/client";
+import type { EventEntry } from "@/api/client";
+import type { ToolCallRecord } from "@/types/chat";
+import EventSlideOver from "@/components/EventSlideOver.vue";
+
+const props = defineProps<{
+  toolCall: ToolCallRecord;
+}>();
+
+const appliedTags = ref<Set<string>>(new Set());
+const applyingTag = ref<string | null>(null);
+const confirmState = ref<"idle" | "creating" | "created" | "denied">("idle");
+
+const label = computed(() => {
+  if (props.toolCall.status === "declined") return "Declined";
+  if (props.toolCall.result.requires_confirmation) return "Similar content found";
+  if (!props.toolCall.result.success) return "Error";
+  switch (props.toolCall.result.type) {
+    case "task":        return "Created task";
+    case "note":        return "Created note";
+    case "note_updated": return "Updated note";
+    case "note_deleted": return "Deleted note";
+    case "task_deleted": return "Deleted task";
+    case "note_content": return "Note";
+    case "notes_list":   return "Notes";
+    case "tasks":        return "Tasks";
+    case "todo_updated": return "Updated todo";
+    case "search":       return "Searched notes";
+    case "event":        return "Created event";
+    case "events":       return "Found events";
+    case "event_updated": return "Updated event";
+    case "event_deleted": return "Deleted event";
+    case "calendars":    return "Calendars";
+    case "todo":         return "Created todo";
+    case "todos":        return "Calendar todos";
+    case "todo_completed": return "Completed todo";
+    case "todo_deleted": return "Deleted todo";
+    case "web_search":   return "Web search";
+    case "research_pending": return "Research started";
+    case "research_note":    return "Research note";
+    case "image_search": return "Image search";
+    default:             return "Tool call";
+  }
+});
+
+const title = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data) return null;
+  if (typeof data.title === "string") return data.title;
+  return null;
+});
+
+const linkTo = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || typeof data.id !== "number") return null;
+  return `/notes/${data.id}`;
+});
+
+const noteId = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || typeof data.id !== "number") return null;
+  return data.id;
+});
+
+const suggestedTags = computed(() => props.toolCall.result.suggested_tags ?? []);
+
+const eventData = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "event") return null;
+  return data as { id?: number; title: string; start_dt?: string; end_dt?: string; location?: string; color?: string };
+});
+
+const updatedEvent = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "event_updated") return null;
+  return data as { id?: number; title: string; start_dt?: string; end_dt?: string; location?: string; color?: string };
+});
+
+const deletedEvent = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "event_deleted") return null;
+  return data as { id?: number; title: string };
+});
+
+const calendarList = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "calendars") return null;
+  const calendars = data.calendars as Array<{ name: string }> | undefined;
+  return calendars?.map((c) => c.name) ?? [];
+});
+
+const todoData = computed(() => {
+  const data = props.toolCall.result.data;
+  const type = props.toolCall.result.type;
+  if (!data || (type !== "todo" && type !== "todo_completed" && type !== "todo_deleted" && type !== "todo_updated")) return null;
+  return data as { summary: string; due?: string; status?: string };
+});
+
+const todoList = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "todos") return null;
+  return (data.todos as Array<{ summary: string; due?: string; status?: string }> | undefined) ?? [];
+});
+
+const todoCount = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "todos") return 0;
+  return (data.count as number) ?? 0;
+});
+
+const eventList = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "events") return null;
+  return (data.events as Array<{ id?: number; title: string; start_dt?: string; end_dt?: string; location?: string; color?: string }> | undefined) ?? [];
+});
+
+const eventCount = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "events") return 0;
+  return (data.count as number) ?? 0;
+});
+
+function formatEventTime(iso: string): string {
+  if (!iso) return "";
+  try {
+    return new Date(iso).toLocaleString(undefined, {
+      weekday: "short", month: "short", day: "numeric",
+      hour: "numeric", minute: "2-digit",
+    });
+  } catch { return iso; }
+}
+
+const taskList = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "tasks") return null;
+  return (data.results as Array<{ id: number; title: string; status: string; priority: string; due_date?: string }> | undefined) ?? [];
+});
+
+const taskCount = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "tasks") return 0;
+  return (data.total as number) ?? 0;
+});
+
+const webSearch = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "web_search") return null;
+  return data as { query: string; results: { url: string; title: string; snippet: string }[]; count: number };
+});
+
+const searchResults = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "search") return null;
+  const results = data.results as Array<{ id: number; title: string; type: string }> | undefined;
+  return results && results.length > 0 ? results : null;
+});
+
+const deletedNote = computed(() => {
+  const data = props.toolCall.result.data;
+  const type = props.toolCall.result.type;
+  if (!data || (type !== "note_deleted" && type !== "task_deleted")) return null;
+  return data as { id: number; title: string };
+});
+
+const noteContent = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "note_content") return null;
+  return data as { id: number; title: string; body: string; tags: string[] };
+});
+
+const noteList = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "notes_list") return null;
+  return (data.results as Array<{ id: number; title: string; tags: string[]; preview: string }> | undefined) ?? [];
+});
+
+const noteListCount = computed(() => {
+  const data = props.toolCall.result.data;
+  if (!data || props.toolCall.result.type !== "notes_list") return 0;
+  return (data.total as number) ?? 0;
+});
+
+// ── Collapse logic ───────────────────────────────────────────────────────────
+
+// Cards with rich expandable content
+const hasDetail = computed(() => {
+  if (props.toolCall.status === "running") return false;
+  return (
+    (noteContent.value !== null && noteContent.value.tags.length > 0) ||
+    (noteList.value !== null && noteList.value.length > 0) ||
+    searchResults.value !== null ||
+    (taskList.value !== null && taskList.value.length > 0) ||
+    (eventList.value !== null && eventList.value.length > 0) ||
+    (todoList.value !== null && todoList.value.length > 0) ||
+    webSearch.value !== null ||
+    (calendarList.value !== null && calendarList.value.length > 0) ||
+    suggestedTags.value.length > 0
+  );
+});
+
+// Collapsed by default for completed calls; errors and running stay open
+const collapsed = ref(
+  props.toolCall.status === "success" || props.toolCall.status === "declined"
+);
+
+// Auto-collapse when a running tool call completes
+watch(() => props.toolCall.status, (s) => {
+  if (s === "success") collapsed.value = true;
+});
+
+function toggle() {
+  if (hasDetail.value) collapsed.value = !collapsed.value;
+}
+
+async function confirmDuplicate() {
+  if (confirmState.value !== "idle") return;
+  confirmState.value = "creating";
+  const args = props.toolCall.arguments as Record<string, unknown>;
+  const isTask = !!(args.status);
+  const endpoint = isTask ? "/api/tasks" : "/api/notes";
+  const payload: Record<string, unknown> = {
+    title: args.title,
+    body: args.body ?? "",
+    tags: args.tags ?? [],
+    ...(args.due_date ? { due_date: args.due_date } : {}),
+    ...(args.priority ? { priority: args.priority } : {}),
+    ...(args.project ? { project: args.project } : {}),
+    ...(isTask ? { status: args.status ?? "todo" } : {}),
+  };
+  try {
+    await apiPost(endpoint, payload);
+    confirmState.value = "created";
+  } catch {
+    confirmState.value = "idle";
+  }
+}
+
+function denyDuplicate() {
+  confirmState.value = "denied";
+}
+
+async function applyTag(tag: string) {
+  if (!noteId.value || appliedTags.value.has(tag) || applyingTag.value) return;
+  applyingTag.value = tag;
+  try {
+    await apiPost(`/api/notes/${noteId.value}/append-tag`, { tag });
+    appliedTags.value.add(tag);
+  } catch {
+    // silently fail
+  } finally {
+    applyingTag.value = null;
+  }
+}
+
+// ── Event slide-over ─────────────────────────────────────────────────────────
+
+const eventSlideOverOpen = ref(false);
+const eventSlideOverEntry = ref<EventEntry | null>(null);
+
+async function openEventSlideOver(id: number | undefined) {
+  if (!id) return;
+  try {
+    const entry = await getEvent(id);
+    eventSlideOverEntry.value = entry;
+    eventSlideOverOpen.value = true;
+  } catch {
+    // silently fail — event may have been deleted
+  }
+}
+
+function closeEventSlideOver(changed = false) {
+  eventSlideOverOpen.value = false;
+  if (changed) {
+    document.dispatchEvent(new Event("fable:calendar-changed"));
+  }
+}
+</script>
+
+<template>
+  <div
+    class="tool-call-card"
+    :class="{
+      error: toolCall.status === 'error' && !toolCall.result.requires_confirmation,
+      'requires-confirm': toolCall.result.requires_confirmation,
+      declined: toolCall.status === 'declined',
+      running: toolCall.status === 'running',
+      collapsible: hasDetail,
+    }"
+  >
+    <!-- ── Header row (always visible) ─────────────────────────── -->
+    <div class="tool-card-header" :class="{ clickable: hasDetail }" @click="toggle">
+      <span class="tool-label">{{ label }}</span>
+
+      <!-- Inline summary content -->
+      <template v-if="toolCall.status === 'declined'">
+        <span class="tool-declined-name">
+          {{ toolCall.arguments.title ?? toolCall.arguments.summary ?? toolCall.arguments.query ?? toolCall.function }}
+        </span>
+      </template>
+      <template v-else-if="toolCall.result.requires_confirmation">
+        <router-link
+          v-if="toolCall.result.similar_note"
+          :to="`/notes/${toolCall.result.similar_note.id}`"
+          class="tool-link"
+          @click.stop
+        >{{ toolCall.result.similar_note.title }}</router-link>
+        <span v-else class="tool-error">{{ toolCall.result.error }}</span>
+        <template v-if="confirmState === 'created'">
+          <span class="confirm-created">✓ Created</span>
+        </template>
+        <template v-else-if="confirmState === 'denied'">
+          <span class="confirm-denied">Skipped</span>
+        </template>
+        <template v-else-if="confirmState !== 'creating'">
+          <button class="btn-confirm-duplicate" @click.stop="confirmDuplicate">Create anyway</button>
+          <button class="btn-deny-duplicate" @click.stop="denyDuplicate">Skip</button>
+        </template>
+        <template v-else>
+          <span class="tool-summary-count">Creating…</span>
+        </template>
+      </template>
+      <template v-else-if="toolCall.status === 'error'">
+        <span class="tool-error">{{ toolCall.result.error }}</span>
+      </template>
+      <template v-else-if="deletedNote">
+        <span class="tool-deleted">{{ deletedNote.title || "Untitled" }}</span>
+      </template>
+      <template v-else-if="noteContent">
+        <router-link :to="`/notes/${noteContent.id}`" class="tool-link" @click.stop>
+          {{ noteContent.title || "Untitled" }}
+        </router-link>
+      </template>
+      <template v-else-if="noteList !== null">
+        <span class="tool-summary-count">{{ noteListCount }} found</span>
+      </template>
+      <template v-else-if="searchResults">
+        <span class="tool-summary-count">
+          {{ (toolCall.result.data?.count as number) ?? (toolCall.result.data?.total as number) ?? 0 }} found
+        </span>
+      </template>
+      <template v-else-if="eventData">
+        <button v-if="eventData.id" class="tool-event-btn" @click.stop="openEventSlideOver(eventData.id)">
+          <span class="tool-event-dot" v-if="eventData.color" :style="{ background: eventData.color }"></span>
+          <span class="tool-event-title">{{ eventData.title }}</span>
+          <span v-if="eventData.start_dt" class="tool-event-time">{{ formatEventTime(eventData.start_dt) }}</span>
+        </button>
+        <template v-else>
+          <span class="tool-event-title">{{ eventData.title }}</span>
+          <span v-if="eventData.start_dt" class="tool-event-time">{{ formatEventTime(eventData.start_dt) }}</span>
+        </template>
+      </template>
+      <template v-else-if="updatedEvent">
+        <button v-if="updatedEvent.id" class="tool-event-btn" @click.stop="openEventSlideOver(updatedEvent.id)">
+          <span class="tool-event-dot" v-if="updatedEvent.color" :style="{ background: updatedEvent.color }"></span>
+          <span class="tool-event-title">{{ updatedEvent.title }}</span>
+          <span v-if="updatedEvent.start_dt" class="tool-event-time">{{ formatEventTime(updatedEvent.start_dt) }}</span>
+        </button>
+        <template v-else>
+          <span class="tool-event-title">{{ updatedEvent.title }}</span>
+          <span v-if="updatedEvent.start_dt" class="tool-event-time">{{ formatEventTime(updatedEvent.start_dt) }}</span>
+        </template>
+      </template>
+      <template v-else-if="deletedEvent">
+        <span class="tool-deleted">{{ deletedEvent.title }}</span>
+      </template>
+      <template v-else-if="calendarList !== null">
+        <span class="tool-summary-count">{{ calendarList.length }} calendar{{ calendarList.length !== 1 ? "s" : "" }}</span>
+      </template>
+      <template v-else-if="todoData">
+        <span :class="{ 'tool-deleted': toolCall.result.type === 'todo_deleted', 'tool-completed': toolCall.result.type === 'todo_completed' }">
+          {{ todoData.summary }}
+        </span>
+        <span v-if="todoData.due" class="tool-event-time">{{ formatEventTime(todoData.due) }}</span>
+      </template>
+      <template v-else-if="todoList !== null">
+        <span class="tool-summary-count">{{ todoCount }} found</span>
+      </template>
+      <template v-else-if="taskList !== null">
+        <span class="tool-summary-count">{{ taskCount }} found</span>
+      </template>
+      <template v-else-if="eventList !== null">
+        <span class="tool-summary-count">{{ eventCount }} found</span>
+      </template>
+      <template v-else-if="webSearch">
+        <span class="tool-summary-count">
+          {{ webSearch.count }} result{{ webSearch.count !== 1 ? "s" : "" }}
+        </span>
+      </template>
+      <template v-else-if="linkTo">
+        <router-link :to="linkTo" class="tool-link" @click.stop>{{ title }}</router-link>
+      </template>
+
+      <!-- Chevron toggle -->
+      <span v-if="hasDetail" class="tool-chevron" :class="{ open: !collapsed }">▶</span>
+    </div>
+
+    <!-- ── Detail section (expandable) ─────────────────────────── -->
+    <div v-if="hasDetail" v-show="!collapsed" class="tool-card-detail">
+      <template v-if="noteContent && noteContent.tags.length">
+        <span class="tool-note-tags">
+          <span v-for="tag in noteContent.tags" :key="tag" class="tool-note-tag">#{{ tag }}</span>
+        </span>
+      </template>
+
+      <template v-else-if="noteList !== null && noteList.length > 0">
+        <div class="tool-search-results">
+          <router-link
+            v-for="n in noteList.slice(0, 8)"
+            :key="n.id"
+            :to="`/notes/${n.id}`"
+            class="tool-search-item"
+          >{{ n.title || "Untitled" }}</router-link>
+          <span v-if="noteList.length > 8" class="tool-event-more">+{{ noteList.length - 8 }} more</span>
+        </div>
+      </template>
+
+      <template v-else-if="searchResults">
+        <div class="tool-search-results">
+          <router-link
+            v-for="r in searchResults"
+            :key="r.id"
+            :to="`/notes/${r.id}`"
+            class="tool-search-item"
+          >{{ r.title || "Untitled" }}</router-link>
+        </div>
+      </template>
+
+      <template v-else-if="todoList !== null && todoList.length > 0">
+        <div class="tool-event-list">
+          <div v-for="(t, i) in todoList.slice(0, 5)" :key="i" class="tool-event-item">
+            <span class="tool-event-item-title">{{ t.summary }}</span>
+            <span v-if="t.due" class="tool-event-item-time">{{ formatEventTime(t.due) }}</span>
+          </div>
+          <div v-if="todoList.length > 5" class="tool-event-more">+{{ todoList.length - 5 }} more</div>
+        </div>
+      </template>
+
+      <template v-else-if="taskList !== null && taskList.length > 0">
+        <div class="tool-event-list">
+          <div v-for="(t, i) in taskList.slice(0, 5)" :key="i" class="tool-event-item">
+            <router-link :to="`/tasks/${t.id}`" class="tool-event-item-title">{{ t.title }}</router-link>
+            <span v-if="t.due_date" class="tool-event-item-time">{{ t.due_date }}</span>
+            <span v-if="t.priority && t.priority !== 'none'" class="tool-task-priority" :class="`priority-${t.priority}`">{{ t.priority }}</span>
+          </div>
+          <div v-if="taskList.length > 5" class="tool-event-more">+{{ taskList.length - 5 }} more</div>
+        </div>
+      </template>
+
+      <template v-else-if="eventList !== null && eventList.length > 0">
+        <div class="tool-event-cards">
+          <button
+            v-for="(ev, i) in eventList.slice(0, 5)"
+            :key="i"
+            class="tool-event-card"
+            :class="{ clickable: !!ev.id }"
+            @click="openEventSlideOver(ev.id)"
+          >
+            <span class="tool-event-card-dot" :style="ev.color ? { background: ev.color } : {}"></span>
+            <span class="tool-event-card-body">
+              <span class="tool-event-card-title">{{ ev.title }}</span>
+              <span v-if="ev.start_dt" class="tool-event-card-time">{{ formatEventTime(ev.start_dt) }}</span>
+              <span v-if="ev.location" class="tool-event-card-loc">{{ ev.location }}</span>
+            </span>
+          </button>
+          <div v-if="eventList.length > 5" class="tool-event-more">+{{ eventList.length - 5 }} more</div>
+        </div>
+      </template>
+
+      <template v-else-if="calendarList !== null">
+        <div class="tool-calendar-list">
+          <span v-for="name in calendarList" :key="name" class="tool-calendar-name">{{ name }}</span>
+        </div>
+      </template>
+
+      <template v-else-if="webSearch">
+        <div class="tool-search-results web-search-results">
+          <a
+            v-for="(r, i) in webSearch.results"
+            :key="i"
+            :href="r.url"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="tool-search-item"
+          >{{ r.title || r.url }}</a>
+        </div>
+      </template>
+
+      <!-- Suggested tags always at the bottom of detail -->
+      <div v-if="suggestedTags.length > 0" class="tag-suggestions">
+        <span class="tag-suggestions-label">Suggested tags:</span>
+        <button
+          v-for="tag in suggestedTags"
+          :key="tag"
+          :class="['tag-pill', { applied: appliedTags.has(tag) }]"
+          :disabled="appliedTags.has(tag) || applyingTag === tag"
+          @click="applyTag(tag)"
+        >
+          #{{ tag }}
+          <span v-if="appliedTags.has(tag)" class="tag-check">&#10003;</span>
+        </button>
+      </div>
+    </div>
+
+    <!-- Suggested tags for non-detail cards (note/task created etc.) -->
+    <div v-if="!hasDetail && suggestedTags.length > 0" class="tag-suggestions">
+      <span class="tag-suggestions-label">Suggested tags:</span>
+      <button
+        v-for="tag in suggestedTags"
+        :key="tag"
+        :class="['tag-pill', { applied: appliedTags.has(tag) }]"
+        :disabled="appliedTags.has(tag) || applyingTag === tag"
+        @click="applyTag(tag)"
+      >
+        #{{ tag }}
+        <span v-if="appliedTags.has(tag)" class="tag-check">&#10003;</span>
+      </button>
+    </div>
+  </div>
+
+  <!-- Event slide-over (portal-like, fixed positioned) -->
+  <EventSlideOver
+    v-if="eventSlideOverOpen"
+    :event="eventSlideOverEntry"
+    initial-date=""
+    @close="closeEventSlideOver"
+    @created="() => closeEventSlideOver(true)"
+    @updated="() => closeEventSlideOver(true)"
+    @deleted="() => closeEventSlideOver(true)"
+  />
+</template>
+
+<style scoped>
+/* Inline ToolCallCard renders inside an assistant bubble — the bubble
+   already contains it, so no outer border per the structural-not-decorative
+   rule. Background tint differentiates it; error state gets a left-edge
+   accent the way the assistant bubble itself uses one. */
+.tool-call-card {
+  display: inline-block;
+  background: var(--color-bg-secondary);
+  border-radius: 10px;
+  font-size: 0.8rem;
+  margin-top: 0.4rem;
+  overflow: hidden;
+  vertical-align: top;
+}
+.tool-call-card.error {
+  border-left: 3px solid var(--color-danger);
+}
+.tool-call-card.declined {
+  opacity: 0.55;
+}
+
+/* ── Header ── */
+.tool-card-header {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 0.35rem;
+  padding: 0.3rem 0.6rem;
+}
+.tool-card-header.clickable {
+  cursor: pointer;
+  user-select: none;
+}
+.tool-card-header.clickable:hover {
+  background: color-mix(in srgb, var(--color-primary) 6%, transparent);
+}
+
+.tool-label {
+  font-weight: 500;
+  color: var(--color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+  font-size: 0.7rem;
+  flex-shrink: 0;
+}
+
+.tool-chevron {
+  font-size: 0.55rem;
+  color: var(--color-text-muted);
+  margin-left: auto;
+  padding-left: 0.4rem;
+  transition: transform 0.15s ease;
+  flex-shrink: 0;
+}
+.tool-chevron.open {
+  transform: rotate(90deg);
+}
+
+.tool-summary-count {
+  color: var(--color-text-muted);
+  font-size: 0.8rem;
+}
+
+/* ── Detail ── */
+.tool-card-detail {
+  padding: 0.3rem 0.6rem 0.45rem;
+  border-top: 1px solid var(--color-border);
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+/* ── Shared content styles ── */
+.tool-link {
+  color: var(--color-primary);
+  text-decoration: none;
+}
+.tool-link:hover { text-decoration: underline; }
+
+.tool-error { color: var(--color-danger, #e74c3c); }
+
+.tool-declined-name {
+  text-decoration: line-through;
+  color: var(--color-text-muted);
+}
+
+.tool-search-results {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.25rem;
+}
+.tool-search-item {
+  color: var(--color-primary);
+  text-decoration: none;
+  font-size: 0.8rem;
+}
+.tool-search-item:hover { text-decoration: underline; }
+.tool-search-item:not(:last-child)::after {
+  content: ",";
+  color: var(--color-text-muted);
+  margin-right: 0.1rem;
+}
+.web-search-results {
+  flex-direction: column;
+  flex-wrap: nowrap;
+}
+.web-search-results .tool-search-item::after { content: none; }
+
+.tool-event-title { font-weight: 500; color: var(--color-text); }
+.tool-event-time { color: var(--color-text-muted); font-size: 0.75rem; }
+
+.tool-event-list { display: flex; flex-direction: column; gap: 0.2rem; }
+.tool-event-item { display: flex; justify-content: space-between; align-items: baseline; gap: 0.5rem; }
+.tool-event-item-title { color: var(--color-text); font-size: 0.8rem; }
+.tool-event-item-time { color: var(--color-text-muted); font-size: 0.75rem; white-space: nowrap; }
+.tool-event-more { color: var(--color-text-muted); font-size: 0.75rem; }
+
+.tool-deleted { text-decoration: line-through; opacity: 0.7; }
+.tool-completed { text-decoration: line-through; color: var(--color-success, #2ecc71); }
+
+.tool-note-tags { display: flex; flex-wrap: wrap; gap: 0.2rem; }
+.tool-note-tag { font-size: 0.72rem; color: var(--color-text-muted); }
+
+.tool-task-priority {
+  font-size: 0.7rem; font-weight: 500; text-transform: uppercase;
+  letter-spacing: 0.04em; padding: 0.1rem 0.3rem; border-radius: 3px;
+}
+.priority-high { color: var(--color-danger, #e74c3c); }
+.priority-medium { color: var(--color-warning, #f59e0b); }
+.priority-low { color: var(--color-text-muted); }
+
+.tool-calendar-list { display: flex; flex-wrap: wrap; gap: 0.3rem; }
+.tool-calendar-name {
+  display: inline-block; padding: 0.1rem 0.5rem;
+  border-radius: 999px; background: var(--color-bg-secondary);
+  border: 1px solid var(--color-border); font-size: 0.75rem; color: var(--color-text);
+}
+
+/* ── Tag suggestions ── */
+.tag-suggestions {
+  display: flex; flex-wrap: wrap; align-items: center; gap: 0.3rem;
+  padding: 0.3rem 0.6rem; border-top: 1px solid var(--color-border);
+}
+.tool-call-card:not(:has(.tool-card-detail)) .tag-suggestions {
+  /* When outside detail, no top border needed if it's the only extra content */
+}
+.tag-suggestions-label { font-size: 0.7rem; color: var(--color-text-muted); font-weight: 500; }
+
+.tag-pill {
+  display: inline-flex; align-items: center; gap: 0.2rem;
+  padding: 0.15rem 0.5rem; border: 1px solid var(--color-primary);
+  border-radius: 999px; background: transparent; color: var(--color-primary);
+  font-size: 0.75rem; cursor: pointer; transition: background 0.15s, color 0.15s;
+}
+.tag-pill:hover:not(:disabled) { background: var(--color-primary); color: #fff; }
+.tag-pill.applied {
+  background: var(--color-success, #2ecc71); border-color: var(--color-success, #2ecc71);
+  color: #fff; cursor: default;
+}
+.tag-pill:disabled:not(.applied) { opacity: 0.6; cursor: wait; }
+.tag-check { font-size: 0.65rem; }
+
+/* Duplicate confirmation */
+.tool-call-card.requires-confirm {
+  border-color: color-mix(in srgb, var(--color-warning, #f59e0b) 60%, transparent);
+}
+.confirm-created {
+  color: var(--color-success, #2ecc71);
+  font-size: 0.78rem;
+  font-weight: 500;
+}
+.confirm-denied {
+  color: var(--color-text-muted);
+  font-size: 0.78rem;
+}
+.btn-confirm-duplicate {
+  padding: 0.15rem 0.5rem;
+  background: var(--color-primary);
+  color: #fff;
+  border: none;
+  border-radius: var(--radius-sm, 6px);
+  cursor: pointer;
+  font-size: 0.72rem;
+  font-family: inherit;
+  white-space: nowrap;
+}
+.btn-confirm-duplicate:hover { opacity: 0.9; }
+.btn-deny-duplicate {
+  padding: 0.15rem 0.5rem;
+  background: none;
+  color: var(--color-text-muted);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-sm, 6px);
+  cursor: pointer;
+  font-size: 0.72rem;
+  font-family: inherit;
+  white-space: nowrap;
+}
+.btn-deny-duplicate:hover {
+  color: var(--color-danger, #e74c3c);
+  border-color: var(--color-danger, #e74c3c);
+}
+
+/* ── Event header click button ── */
+.tool-event-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.3rem;
+  background: none;
+  border: none;
+  padding: 0;
+  cursor: pointer;
+  font-family: inherit;
+}
+.tool-event-btn:hover .tool-event-title {
+  text-decoration: underline;
+  color: var(--color-primary);
+}
+.tool-event-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  flex-shrink: 0;
+}
+
+/* ── Event cards (list) ── */
+.tool-event-cards { display: flex; flex-direction: column; gap: 0.25rem; }
+.tool-event-card {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.45rem;
+  padding: 0.3rem 0.45rem;
+  border-radius: 6px;
+  border: 1px solid var(--color-border);
+  background: var(--color-bg-card, #16161a);
+  text-align: left;
+  font-family: inherit;
+  cursor: default;
+  transition: border-color 0.15s, background 0.15s;
+  width: 100%;
+}
+.tool-event-card.clickable { cursor: pointer; }
+.tool-event-card.clickable:hover {
+  border-color: var(--color-primary);
+  background: color-mix(in srgb, var(--color-primary) 6%, var(--color-bg-card, #16161a));
+}
+.tool-event-card-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  flex-shrink: 0;
+  margin-top: 3px;
+}
+.tool-event-card-body {
+  display: flex;
+  flex-direction: column;
+  gap: 0.1rem;
+  min-width: 0;
+}
+.tool-event-card-title {
+  font-size: 0.8rem;
+  font-weight: 500;
+  color: var(--color-text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.tool-event-card-time {
+  font-size: 0.72rem;
+  color: var(--color-text-muted);
+}
+.tool-event-card-loc {
+  font-size: 0.7rem;
+  color: var(--color-text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+</style>

frontend/src/components/ToolConfirmCard.vue

@@ -0,0 +1,108 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import type { ToolPendingRecord } from "@/types/chat";
+
+const props = defineProps<{
+  pendingTool: ToolPendingRecord;
+}>();
+
+const emit = defineEmits<{
+  (e: "accept"): void;
+  (e: "decline"): void;
+}>();
+
+const label = computed(() => props.pendingTool.label ?? props.pendingTool.function);
+
+const detail = computed(() => {
+  const args = props.pendingTool.arguments;
+  const name =
+    (args.title as string | undefined) ??
+    (args.summary as string | undefined) ??
+    (args.query as string | undefined) ??
+    "";
+  return name ? `"${name}"` : "";
+});
+</script>
+
+<template>
+  <div class="tool-confirm-card">
+    <div class="tool-confirm-info">
+      <span class="tool-confirm-label">{{ label }}</span>
+      <span v-if="detail" class="tool-confirm-detail">{{ detail }}</span>
+    </div>
+    <div class="tool-confirm-actions">
+      <button class="btn-accept" @click="emit('accept')">Accept</button>
+      <button class="btn-decline" @click="emit('decline')">Decline</button>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.tool-confirm-card {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  background: var(--color-bg-secondary);
+  border: 1px solid var(--color-warning, #f59e0b);
+  border-radius: 12px;
+  padding: 0.45rem 0.75rem;
+  font-size: 0.85rem;
+  margin-top: 0.4rem;
+  width: 100%;
+  box-sizing: border-box;
+}
+.tool-confirm-info {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  min-width: 0;
+  flex: 1;
+}
+.tool-confirm-label {
+  font-weight: 600;
+  color: var(--color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+  font-size: 0.7rem;
+  white-space: nowrap;
+}
+.tool-confirm-detail {
+  color: var(--color-text);
+  font-size: 0.8rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.tool-confirm-actions {
+  display: flex;
+  gap: 0.4rem;
+  flex-shrink: 0;
+}
+.btn-accept,
+.btn-decline {
+  padding: 0.25rem 0.65rem;
+  border: none;
+  border-radius: 8px;
+  font-size: 0.8rem;
+  font-weight: 600;
+  cursor: pointer;
+  transition: opacity 0.15s;
+}
+.btn-accept {
+  background: var(--color-success, #2ecc71);
+  color: #fff;
+}
+.btn-decline {
+  background: var(--color-bg-card);
+  border: 1px solid var(--color-border);
+  color: var(--color-text-muted);
+}
+.btn-accept:hover {
+  opacity: 0.85;
+}
+.btn-decline:hover {
+  color: var(--color-danger, #e74c3c);
+  border-color: var(--color-danger, #e74c3c);
+}
+</style>

frontend/src/components/WorkspaceChatWidget.vue

@@ -0,0 +1,391 @@
+<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';
+import { RotateCcw, ChevronDown, ChevronUp } from 'lucide-vue-next';
+
+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"
+          >
+            <ChevronDown :size="16" />
+          </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">
+          <RotateCcw :size="16" />
+        </button>
+        <button class="btn-icon-sm" title="Collapse" @click="collapse">
+          <ChevronDown :size="16" />
+        </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">
+        <ChevronUp :size="16" />
+      </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: 500;
+  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: 500;
+}
+.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/rules/PlanRulesPanel.vue

@@ -1,67 +0,0 @@
-<script setup lang="ts">
-import { ref, onMounted, watch } from "vue";
-import { getProjectApplicableRules } from "@/api/rulebooks";
-import type { ApplicableRules } from "@/api/rulebooks";
-
-const props = defineProps<{ projectId: number }>();
-const data = ref<ApplicableRules | null>(null);
-
-function grouped(rules: ApplicableRules["rules"]) {
-  const g: Record<string, Record<string, ApplicableRules["rules"]>> = {};
-  for (const r of rules) {
-    (g[r.rulebook_title] ??= {});
-    (g[r.rulebook_title][r.topic_title] ??= []).push(r);
-  }
-  return g;
-}
-
-async function load() {
-  data.value = await getProjectApplicableRules(props.projectId);
-}
-
-onMounted(load);
-watch(() => props.projectId, load);
-</script>
-
-<template>
-  <section class="plan-rules" v-if="data && data.rules.length">
-    <h3>Applicable rules</h3>
-    <div v-for="(topics, rb) in grouped(data.rules)" :key="rb" class="rb">
-      <h4>{{ rb }}</h4>
-      <div v-for="(rules, topic) in topics" :key="topic">
-        <h5>{{ topic }}</h5>
-        <ul>
-          <li v-for="r in rules" :key="r.id">
-            <strong>{{ r.title }}</strong> — {{ r.statement }}
-          </li>
-        </ul>
-      </div>
-    </div>
-    <p v-if="data.truncated" class="truncated">
-      Truncated at 50 rules — more apply.
-    </p>
-  </section>
-</template>
-
-<style scoped>
-.plan-rules {
-  margin-top: 1.5rem;
-  border-top: 1px solid var(--color-border, #2a2a2e);
-  padding-top: 1rem;
-}
-.plan-rules h3 {
-  font-size: 0.9em; opacity: 0.7;
-  text-transform: uppercase; letter-spacing: 0.05em;
-}
-.rb h4 { font-family: Fraunces, serif; font-style: italic; margin-bottom: 0.25rem; }
-.rb h5 {
-  font-size: 0.8em; opacity: 0.7;
-  text-transform: uppercase; margin-top: 0.5rem;
-}
-.plan-rules ul {
-  list-style: none; padding-left: 0.75rem; margin: 0.25rem 0;
-  border-left: 2px solid var(--color-primary, #6366f1);
-}
-.plan-rules li { margin: 0.35rem 0; font-size: 0.92em; }
-.truncated { opacity: 0.7; font-style: italic; font-size: 0.85em; }
-</style>

frontend/src/components/rules/ProjectRulesTab.vue

@@ -1,438 +0,0 @@
-<script setup lang="ts">
-import { ref, onMounted, watch } from "vue";
-import { useRouter } from "vue-router";
-import {
-  getProjectApplicableRules, subscribeProject, unsubscribeProject,
-  listRulebooks, getRule, createProjectRule, deleteRule,
-  suppressRuleForProject, unsuppressRuleForProject,
-  suppressTopicForProject, unsuppressTopicForProject,
-} from "@/api/rulebooks";
-import type { ApplicableRules, Rulebook } from "@/api/rulebooks";
-
-const props = defineProps<{ projectId: number }>();
-const router = useRouter();
-const applicable = ref<ApplicableRules | null>(null);
-const allRulebooks = ref<Rulebook[]>([]);
-const showPicker = ref(false);
-const expandedRuleIds = ref<Set<number>>(new Set());
-
-const ruleDetails = ref<Record<number, { why: string; how_to_apply: string }>>({});
-
-const showProjectRuleForm = ref(false);
-const newProjectRule = ref({ title: "", statement: "", why: "", how_to_apply: "" });
-
-async function load() {
-  applicable.value = await getProjectApplicableRules(props.projectId);
-}
-
-async function loadAllRulebooks() {
-  allRulebooks.value = await listRulebooks();
-}
-
-async function subscribe(rulebookId: number) {
-  await subscribeProject(props.projectId, rulebookId);
-  showPicker.value = false;
-  await load();
-}
-
-async function unsubscribe(rulebookId: number) {
-  if (!confirm("Unsubscribe from this rulebook for this project?")) return;
-  await unsubscribeProject(props.projectId, rulebookId);
-  await load();
-}
-
-async function toggleRuleExpand(ruleId: number) {
-  if (expandedRuleIds.value.has(ruleId)) {
-    expandedRuleIds.value.delete(ruleId);
-  } else {
-    expandedRuleIds.value.add(ruleId);
-    if (!ruleDetails.value[ruleId]) {
-      const rule = await getRule(ruleId);
-      ruleDetails.value[ruleId] = {
-        why: rule.why || "",
-        how_to_apply: rule.how_to_apply || "",
-      };
-    }
-  }
-  // trigger reactivity on Set mutation
-  expandedRuleIds.value = new Set(expandedRuleIds.value);
-}
-
-function openInRulesView(rulebookId: number, ruleId?: number) {
-  const query: Record<string, string> = { rb: String(rulebookId) };
-  if (ruleId) query.rule = String(ruleId);
-  router.push({ path: "/rules", query });
-}
-
-interface TopicGroup {
-  topic_id: number;
-  topic_title: string;
-  rules: ApplicableRules["rules"];
-}
-interface RulebookGroup {
-  rulebook_id: number;
-  rulebook_title: string;
-  topics: TopicGroup[];
-}
-function groupByRulebookAndTopic(rules: ApplicableRules["rules"]): RulebookGroup[] {
-  const byRulebook = new Map<number, RulebookGroup>();
-  for (const r of rules) {
-    let rb = byRulebook.get(r.rulebook_id);
-    if (!rb) {
-      rb = { rulebook_id: r.rulebook_id, rulebook_title: r.rulebook_title, topics: [] };
-      byRulebook.set(r.rulebook_id, rb);
-    }
-    let topic = rb.topics.find((t) => t.topic_id === r.topic_id);
-    if (!topic) {
-      topic = { topic_id: r.topic_id, topic_title: r.topic_title, rules: [] };
-      rb.topics.push(topic);
-    }
-    topic.rules.push(r);
-  }
-  return Array.from(byRulebook.values());
-}
-
-async function submitProjectRule() {
-  const statement = newProjectRule.value.statement.trim();
-  if (!statement) return;
-  await createProjectRule(props.projectId, {
-    statement,
-    title: newProjectRule.value.title.trim() || undefined,
-    why: newProjectRule.value.why.trim() || undefined,
-    how_to_apply: newProjectRule.value.how_to_apply.trim() || undefined,
-  });
-  newProjectRule.value = { title: "", statement: "", why: "", how_to_apply: "" };
-  showProjectRuleForm.value = false;
-  await load();
-}
-
-async function removeProjectRule(ruleId: number) {
-  if (!confirm("Delete this project rule? It will move to the trash.")) return;
-  await deleteRule(ruleId);
-  await load();
-}
-
-const showSuppressed = ref(false);
-
-async function suppressRule(ruleId: number) {
-  await suppressRuleForProject(props.projectId, ruleId);
-  await load();
-}
-
-async function unsuppressRule(ruleId: number) {
-  await unsuppressRuleForProject(props.projectId, ruleId);
-  await load();
-}
-
-async function suppressTopic(topicId: number) {
-  await suppressTopicForProject(props.projectId, topicId);
-  await load();
-}
-
-async function unsuppressTopic(topicId: number) {
-  await unsuppressTopicForProject(props.projectId, topicId);
-  await load();
-}
-
-onMounted(async () => {
-  await load();
-  await loadAllRulebooks();
-});
-
-watch(() => props.projectId, load);
-</script>
-
-<template>
-  <div class="rules-tab" v-if="applicable">
-    <section class="subscribed">
-      <h3>Subscribed rulebooks</h3>
-      <div class="chips">
-        <span
-          v-for="rb in applicable.subscribed_rulebooks"
-          :key="rb.id"
-          class="chip"
-        >
-          <a @click="openInRulesView(rb.id)">{{ rb.title }}</a>
-          <button class="chip-remove" @click="unsubscribe(rb.id)" aria-label="Unsubscribe">×</button>
-        </span>
-        <button v-if="!showPicker" class="add" @click="showPicker = true">+ Subscribe</button>
-        <select
-          v-else
-          @change="subscribe(Number(($event.target as HTMLSelectElement).value))"
-        >
-          <option value="">Choose a rulebook…</option>
-          <option
-            v-for="rb in allRulebooks.filter((rb) => !applicable!.subscribed_rulebooks.some((s) => s.id === rb.id))"
-            :key="rb.id"
-            :value="rb.id"
-          >
-            {{ rb.title }}
-          </option>
-        </select>
-      </div>
-    </section>
-
-    <section class="project-rules">
-      <div class="section-head">
-        <h3>Project rules</h3>
-        <button
-          v-if="!showProjectRuleForm"
-          class="add"
-          @click="showProjectRuleForm = true"
-        >
-          + New project rule
-        </button>
-      </div>
-      <form v-if="showProjectRuleForm" class="new-rule-form" @submit.prevent="submitProjectRule">
-        <input
-          v-model="newProjectRule.title"
-          placeholder="Title (optional — derived from statement if blank)"
-        />
-        <textarea
-          v-model="newProjectRule.statement"
-          required
-          autofocus
-          placeholder="Statement (required) — the actionable instruction, 1-2 sentences"
-          rows="2"
-        ></textarea>
-        <textarea
-          v-model="newProjectRule.why"
-          placeholder="Why (optional) — the rationale"
-          rows="2"
-        ></textarea>
-        <textarea
-          v-model="newProjectRule.how_to_apply"
-          placeholder="How to apply (optional) — when / where it kicks in"
-          rows="2"
-        ></textarea>
-        <div class="form-buttons">
-          <button type="submit">Create</button>
-          <button type="button" @click="showProjectRuleForm = false">Cancel</button>
-        </div>
-      </form>
-      <ul v-if="applicable.project_rules && applicable.project_rules.length > 0" class="rule-list">
-        <li v-for="r in applicable.project_rules" :key="r.id" class="rule">
-          <div class="rule-head" @click="toggleRuleExpand(r.id)">
-            <span class="rule-title">{{ r.title }}</span>
-            <span class="rule-statement">{{ r.statement }}</span>
-          </div>
-          <div v-if="expandedRuleIds.has(r.id) && ruleDetails[r.id]" class="rule-detail">
-            <div v-if="ruleDetails[r.id].why">
-              <strong>Why:</strong> {{ ruleDetails[r.id].why }}
-            </div>
-            <div v-if="ruleDetails[r.id].how_to_apply">
-              <strong>How to apply:</strong> {{ ruleDetails[r.id].how_to_apply }}
-            </div>
-            <button class="delete-link" @click="removeProjectRule(r.id)">Delete</button>
-          </div>
-        </li>
-      </ul>
-      <p
-        v-else-if="!showProjectRuleForm"
-        class="empty"
-      >
-        No project-only rules yet.
-      </p>
-    </section>
-
-    <section class="applicable">
-      <h3>Applicable rules</h3>
-      <p v-if="applicable.rules.length === 0" class="empty">
-        No rules yet — subscribe to a rulebook above, or create one at
-        <a @click="router.push('/rules')">Rulebooks</a>.
-      </p>
-      <div
-        v-for="rb in groupByRulebookAndTopic(applicable.rules)"
-        :key="rb.rulebook_id"
-        class="rb-group"
-      >
-        <h4>{{ rb.rulebook_title }}</h4>
-        <div v-for="topic in rb.topics" :key="topic.topic_id" class="topic-group">
-          <h5>
-            <span>{{ topic.topic_title }}</span>
-            <button
-              class="skip-btn"
-              :title="`Skip the entire ${topic.topic_title} topic for this project`"
-              @click="suppressTopic(topic.topic_id)"
-            >× skip topic</button>
-          </h5>
-          <ul>
-            <li v-for="r in topic.rules" :key="r.id" class="rule">
-              <div class="rule-head">
-                <div class="rule-head-text" @click="toggleRuleExpand(r.id)">
-                  <span class="rule-title">{{ r.title }}</span>
-                  <span class="rule-statement">{{ r.statement }}</span>
-                </div>
-                <button
-                  class="skip-btn"
-                  title="Skip this rule for this project"
-                  @click.stop="suppressRule(r.id)"
-                >× skip</button>
-              </div>
-              <div v-if="expandedRuleIds.has(r.id) && ruleDetails[r.id]" class="rule-detail">
-                <div v-if="ruleDetails[r.id].why">
-                  <strong>Why:</strong> {{ ruleDetails[r.id].why }}
-                </div>
-                <div v-if="ruleDetails[r.id].how_to_apply">
-                  <strong>How to apply:</strong> {{ ruleDetails[r.id].how_to_apply }}
-                </div>
-                <button
-                  class="edit-link"
-                  @click="openInRulesView(r.rulebook_id, r.id)"
-                >
-                  Edit in Rulebook →
-                </button>
-              </div>
-            </li>
-          </ul>
-        </div>
-      </div>
-      <p v-if="applicable.truncated" class="truncated">
-        Truncated at 50 rules — there are more applicable rules.
-      </p>
-    </section>
-
-    <section
-      v-if="applicable.suppressed_rules.length + applicable.suppressed_topics.length > 0"
-      class="suppressed"
-    >
-      <button class="suppressed-toggle" @click="showSuppressed = !showSuppressed">
-        <span>Suppressed ({{ applicable.suppressed_rules.length + applicable.suppressed_topics.length }})</span>
-        <span class="caret">{{ showSuppressed ? "▾" : "▸" }}</span>
-      </button>
-      <div v-if="showSuppressed" class="suppressed-body">
-        <ul v-if="applicable.suppressed_topics.length > 0" class="suppressed-list">
-          <li v-for="t in applicable.suppressed_topics" :key="`topic-${t.id}`">
-            <span class="suppressed-kind">topic</span>
-            <span class="suppressed-path">{{ t.rulebook_title }} → {{ t.title }}</span>
-            <button class="reenable-btn" @click="unsuppressTopic(t.id)">↻ re-enable</button>
-          </li>
-        </ul>
-        <ul v-if="applicable.suppressed_rules.length > 0" class="suppressed-list">
-          <li v-for="r in applicable.suppressed_rules" :key="`rule-${r.id}`">
-            <span class="suppressed-kind">rule</span>
-            <span class="suppressed-path">{{ r.rulebook_title }} → {{ r.topic_title }} → {{ r.title }}</span>
-            <button class="reenable-btn" @click="unsuppressRule(r.id)">↻ re-enable</button>
-          </li>
-        </ul>
-      </div>
-    </section>
-  </div>
-</template>
-
-<style scoped>
-.rules-tab { padding: 1rem; }
-h3 {
-  font-size: 0.9em; opacity: 0.7; text-transform: uppercase; letter-spacing: 0.05em;
-  margin-top: 0;
-}
-.chips { display: flex; gap: 0.5rem; flex-wrap: wrap; align-items: center; }
-.chip {
-  display: inline-flex; align-items: center; gap: 0.25rem;
-  background: var(--color-primary-bg, rgba(99,102,241,0.15));
-  padding: 0.25rem 0.5rem; border-radius: 999px;
-}
-.chip a { cursor: pointer; }
-.chip-remove { background: none; border: none; cursor: pointer; opacity: 0.5; font-size: 1.1em; }
-.chip-remove:hover { opacity: 1; }
-.add {
-  background: none;
-  border: 1px dashed var(--color-border, #2a2a2e);
-  padding: 0.25rem 0.75rem; border-radius: 999px; cursor: pointer;
-  color: inherit;
-}
-select {
-  background: var(--color-bg, #111113); color: inherit;
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-  padding: 0.25rem 0.5rem;
-}
-.applicable { margin-top: 2rem; }
-.rb-group { margin-bottom: 1.5rem; }
-.rb-group h4 { font-family: Fraunces, serif; font-style: italic; margin-bottom: 0.5rem; }
-.topic-group h5 {
-  font-size: 0.85em; opacity: 0.7; text-transform: uppercase; letter-spacing: 0.05em;
-  margin-top: 0.75rem;
-}
-ul { list-style: none; padding: 0; margin: 0; }
-.rule {
-  border-left: 2px solid var(--color-primary, #6366f1);
-  padding-left: 0.75rem; margin: 0.5rem 0;
-}
-.rule-head { cursor: pointer; }
-.rule-title { font-weight: 500; }
-.rule-statement { display: block; opacity: 0.85; margin-top: 0.25rem; }
-.rule-detail {
-  margin-top: 0.5rem; padding: 0.5rem;
-  background: var(--color-bg, #111113); border-radius: 6px;
-}
-.rule-detail > div { margin-bottom: 0.5rem; }
-.edit-link {
-  background: none; border: none; cursor: pointer;
-  color: var(--color-primary, #6366f1); padding: 0.5rem 0 0 0;
-}
-.empty, .truncated { opacity: 0.7; font-style: italic; }
-.empty a { cursor: pointer; text-decoration: underline; }
-.project-rules { margin-top: 1.5rem; }
-.section-head { display: flex; justify-content: space-between; align-items: center; }
-.new-rule-form {
-  display: flex; flex-direction: column; gap: 0.5rem;
-  padding: 0.75rem; margin: 0.5rem 0;
-  background: var(--color-bg, #111113);
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-}
-.new-rule-form input, .new-rule-form textarea {
-  background: var(--color-surface, #18181b); color: inherit;
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-  padding: 0.5rem; font: inherit; resize: vertical;
-}
-.rule-list { margin-top: 0.5rem; }
-.delete-link {
-  background: none; border: none; cursor: pointer;
-  color: var(--color-destructive, #b85a4a); padding: 0.5rem 0 0 0;
-}
-/* Per-rule / per-topic suppress affordance — quiet by default, reveal on hover */
-.topic-group h5 {
-  display: flex; justify-content: space-between; align-items: center; gap: 0.5rem;
-}
-.rule-head {
-  display: flex; justify-content: space-between; align-items: flex-start; gap: 0.5rem;
-}
-.rule-head-text { flex: 1; cursor: pointer; }
-.skip-btn {
-  background: none; border: none; cursor: pointer;
-  color: var(--color-muted, #888); font-size: 0.75rem;
-  padding: 0.1rem 0.4rem; opacity: 0; transition: opacity 0.15s;
-  white-space: nowrap;
-}
-.topic-group h5:hover .skip-btn,
-.rule:hover .skip-btn,
-.skip-btn:focus { opacity: 1; }
-.skip-btn:hover { color: var(--color-destructive, #b85a4a); }
-/* Suppressed section */
-.suppressed { margin-top: 1.5rem; }
-.suppressed-toggle {
-  display: flex; align-items: center; gap: 0.4rem;
-  background: none; border: none; cursor: pointer;
-  font-size: 0.85rem; opacity: 0.7; padding: 0.25rem 0; color: inherit;
-}
-.suppressed-toggle:hover { opacity: 1; }
-.suppressed-toggle .caret { font-size: 0.7em; }
-.suppressed-body { margin-top: 0.5rem; }
-.suppressed-list { padding-left: 0; }
-.suppressed-list li {
-  display: flex; align-items: center; gap: 0.5rem;
-  padding: 0.25rem 0; opacity: 0.75;
-}
-.suppressed-kind {
-  font-size: 0.7em; text-transform: uppercase; letter-spacing: 0.05em;
-  padding: 0.1rem 0.4rem; border-radius: 3px;
-  background: var(--color-bg, #111113);
-  border: 1px solid var(--color-border, #2a2a2e);
-}
-.suppressed-path { flex: 1; }
-.reenable-btn {
-  background: none; border: none; cursor: pointer;
-  color: var(--color-primary, #6366f1); font-size: 0.85em;
-}
-.reenable-btn:hover { text-decoration: underline; }
-</style>

frontend/src/components/rules/RuleEditorSlideOver.vue

@@ -1,123 +0,0 @@
-<script setup lang="ts">
-import { ref, watch, onMounted } from "vue";
-import { useRulebooksStore } from "@/stores/rulebooks";
-
-const props = defineProps<{ ruleId: number | null; topicId: number | null }>();
-const emit = defineEmits<{ close: [] }>();
-
-const store = useRulebooksStore();
-const title = ref("");
-const statement = ref("");
-const why = ref("");
-const howToApply = ref("");
-
-const isCreating = ref(props.ruleId === null);
-
-async function load() {
-  if (props.ruleId !== null) {
-    await store.fetchRule(props.ruleId);
-    const r = store.currentRule;
-    if (r) {
-      title.value = r.title;
-      statement.value = r.statement;
-      why.value = r.why || "";
-      howToApply.value = r.how_to_apply || "";
-    }
-  } else {
-    title.value = "";
-    statement.value = "";
-    why.value = "";
-    howToApply.value = "";
-  }
-}
-
-async function save() {
-  if (!title.value.trim() || !statement.value.trim()) {
-    emit("close");
-    return;
-  }
-  if (isCreating.value && props.topicId !== null) {
-    await store.createRule(props.topicId, {
-      title: title.value, statement: statement.value,
-      why: why.value, how_to_apply: howToApply.value,
-    });
-  } else if (props.ruleId !== null) {
-    await store.updateRule(props.ruleId, {
-      title: title.value, statement: statement.value,
-      why: why.value, how_to_apply: howToApply.value,
-    });
-  }
-  emit("close");
-}
-
-async function remove() {
-  if (props.ruleId === null) return;
-  if (!confirm("Delete this rule? This cannot be undone.")) return;
-  await store.deleteRule(props.ruleId);
-  emit("close");
-}
-
-onMounted(load);
-watch(() => props.ruleId, load);
-</script>
-
-<template>
-  <div class="backdrop" @click="save">
-    <aside class="slide-over" @click.stop>
-      <header>
-        <h2>{{ isCreating ? "New rule" : "Edit rule" }}</h2>
-        <button v-if="!isCreating" class="trash" @click="remove" aria-label="Delete">🗑</button>
-        <button class="close" @click="save" aria-label="Close">×</button>
-      </header>
-      <label>
-        Title
-        <input v-model="title" placeholder="e.g. dev is home" />
-      </label>
-      <label>
-        Statement <span class="required">*</span>
-        <textarea v-model="statement" rows="3" placeholder="The actionable instruction (1-2 sentences)." />
-      </label>
-      <label>
-        Why
-        <textarea v-model="why" rows="4" placeholder="Rationale — the reason this rule exists." />
-      </label>
-      <label>
-        How to apply
-        <textarea v-model="howToApply" rows="4" placeholder="When / where this kicks in." />
-      </label>
-    </aside>
-  </div>
-</template>
-
-<style scoped>
-.backdrop {
-  position: fixed; inset: 0;
-  background: rgba(0, 0, 0, 0.4);
-  z-index: 100;
-}
-.slide-over {
-  position: fixed; top: 0; right: 0; bottom: 0;
-  width: min(520px, 90vw);
-  background: var(--color-surface, #18181b);
-  border-left: 2px solid var(--color-primary, #6366f1);
-  padding: 1.5rem;
-  overflow-y: auto;
-  box-shadow: -8px 0 32px rgba(0, 0, 0, 0.3);
-}
-header { display: flex; gap: 0.5rem; align-items: center; margin-bottom: 1rem; }
-header h2 {
-  flex: 1; margin: 0;
-  font-family: Fraunces, serif; font-style: italic;
-}
-label { display: block; margin-bottom: 1rem; }
-.required { color: var(--color-primary, #6366f1); }
-input, textarea {
-  width: 100%; margin-top: 0.25rem;
-  background: var(--color-bg, #111113); color: inherit;
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-  padding: 0.5rem; font: inherit;
-  font-family: inherit;
-}
-.trash, .close { background: none; border: none; cursor: pointer; opacity: 0.6; font-size: 1.25em; }
-.trash:hover, .close:hover { opacity: 1; }
-</style>

frontend/src/components/rules/RuleListPane.vue

@@ -1,40 +0,0 @@
-<script setup lang="ts">
-import type { RuleHeader } from "@/api/rulebooks";
-
-defineProps<{ topicId: number; rules: RuleHeader[] }>();
-const emit = defineEmits<{
-  "open-rule": [id: number];
-  "create-rule": [topicId: number];
-}>();
-</script>
-
-<template>
-  <section class="pane">
-    <header><h2>Rules</h2></header>
-    <ul>
-      <li v-for="r in rules" :key="r.id" @click="emit('open-rule', r.id)">
-        <div class="title">{{ r.title }}</div>
-        <div class="statement">{{ r.statement }}</div>
-      </li>
-    </ul>
-    <button class="new-rule" @click="emit('create-rule', topicId)">+ New rule</button>
-  </section>
-</template>
-
-<style scoped>
-.pane { background: var(--color-surface, #18181b); padding: 1rem; overflow-y: auto; }
-header h2 { font-family: Fraunces, serif; font-style: italic; margin: 0 0 0.5rem 0; }
-ul { list-style: none; padding: 0; margin: 1rem 0; }
-li {
-  padding: 0.75rem;
-  cursor: pointer;
-  border-radius: 6px;
-  border-left: 2px solid var(--color-primary, #6366f1);
-  margin-bottom: 0.5rem;
-  background: rgba(255, 255, 255, 0.02);
-}
-li:hover { background: var(--color-hover, rgba(255,255,255,0.05)); }
-.title { font-family: Fraunces, serif; font-style: italic; font-size: 1.05em; }
-.statement { font-size: 0.9em; opacity: 0.8; margin-top: 0.25rem; }
-.new-rule { cursor: pointer; }
-</style>

frontend/src/components/rules/RulebookDetailPane.vue

@@ -1,154 +0,0 @@
-<script setup lang="ts">
-import { ref, computed, onMounted, watch } from "vue";
-import { useRulebooksStore } from "@/stores/rulebooks";
-import { apiGet } from "@/api/client";
-import {
-  subscribeProject, unsubscribeProject, getProjectApplicableRules,
-} from "@/api/rulebooks";
-import type { RulebookTopic } from "@/api/rulebooks";
-
-const props = defineProps<{
-  rulebookId: number;
-  topics: RulebookTopic[];
-  selectedTopicId: number | null;
-}>();
-const emit = defineEmits<{ "select-topic": [id: number] }>();
-
-const store = useRulebooksStore();
-const isCreating = ref(false);
-const newTitle = ref("");
-
-const currentRulebook = computed(() =>
-  store.rulebooks.find((rb) => rb.id === props.rulebookId),
-);
-
-interface ProjectLite { id: number; title: string }
-const projects = ref<ProjectLite[]>([]);
-// Map<project_id, Set<rulebook_id>>
-const subscribedRulebookIds = ref<Map<number, Set<number>>>(new Map());
-
-async function loadProjects() {
-  const data = await apiGet<{ projects: ProjectLite[] }>("/api/projects");
-  projects.value = data.projects;
-  for (const p of projects.value) {
-    const result = await getProjectApplicableRules(p.id);
-    subscribedRulebookIds.value.set(
-      p.id,
-      new Set(result.subscribed_rulebooks.map((rb) => rb.id)),
-    );
-  }
-}
-
-function isSubscribed(projectId: number): boolean {
-  return subscribedRulebookIds.value.get(projectId)?.has(props.rulebookId) ?? false;
-}
-
-async function toggleSubscription(projectId: number, checked: boolean) {
-  if (checked) {
-    await subscribeProject(projectId, props.rulebookId);
-    const set = subscribedRulebookIds.value.get(projectId) || new Set<number>();
-    set.add(props.rulebookId);
-    subscribedRulebookIds.value.set(projectId, set);
-  } else {
-    await unsubscribeProject(projectId, props.rulebookId);
-    subscribedRulebookIds.value.get(projectId)?.delete(props.rulebookId);
-  }
-  // trigger reactivity on Map mutation
-  subscribedRulebookIds.value = new Map(subscribedRulebookIds.value);
-}
-
-async function submitNew() {
-  const title = newTitle.value.trim();
-  if (!title) return;
-  const topic = await store.createTopic(props.rulebookId, { title });
-  newTitle.value = "";
-  isCreating.value = false;
-  emit("select-topic", topic.id);
-}
-
-onMounted(loadProjects);
-watch(() => props.rulebookId, () => {/* re-render of isSubscribed from existing map */});
-</script>
-
-<template>
-  <section class="pane">
-    <header>
-      <h2>Topics</h2>
-      <label v-if="currentRulebook" class="always-on-toggle" title="When on, rules from this rulebook load at session start regardless of project context">
-        <input
-          type="checkbox"
-          :checked="currentRulebook.always_on"
-          @change="store.toggleAlwaysOn(currentRulebook.id)"
-        />
-        <span>Always on</span>
-      </label>
-    </header>
-    <ul>
-      <li
-        v-for="t in topics"
-        :key="t.id"
-        :class="{ active: t.id === selectedTopicId }"
-        @click="emit('select-topic', t.id)"
-      >
-        {{ t.title }}
-      </li>
-    </ul>
-    <div class="new-topic">
-      <button v-if="!isCreating" @click="isCreating = true">+ New topic</button>
-      <form v-else @submit.prevent="submitNew">
-        <input v-model="newTitle" autofocus placeholder="Topic title (e.g. git-workflow)" />
-        <div class="form-buttons">
-          <button type="submit">Create</button>
-          <button type="button" @click="isCreating = false">Cancel</button>
-        </div>
-      </form>
-    </div>
-    <div class="subscriptions">
-      <h3>Subscribers</h3>
-      <ul class="sub-list">
-        <li v-for="p in projects" :key="p.id">
-          <label>
-            <input
-              type="checkbox"
-              :checked="isSubscribed(p.id)"
-              @change="toggleSubscription(p.id, ($event.target as HTMLInputElement).checked)"
-            />
-            {{ p.title }}
-          </label>
-        </li>
-      </ul>
-    </div>
-  </section>
-</template>
-
-<style scoped>
-.pane { background: var(--color-surface, #18181b); padding: 1rem; overflow-y: auto; }
-header { display: flex; align-items: center; justify-content: space-between; gap: 1rem; }
-header h2 { font-family: Fraunces, serif; font-style: italic; margin: 0 0 0.5rem 0; }
-.always-on-toggle {
-  display: flex; align-items: center; gap: 0.4rem;
-  font-size: 0.85rem; opacity: 0.85; cursor: pointer;
-  user-select: none;
-}
-.always-on-toggle input { cursor: pointer; }
-ul { list-style: none; padding: 0; margin: 1rem 0; }
-li { padding: 0.5rem; cursor: pointer; border-radius: 6px; }
-li.active { background: var(--color-primary-bg, rgba(99,102,241,0.15)); }
-li:hover { background: var(--color-hover, rgba(255,255,255,0.05)); }
-.new-topic input {
-  width: 100%; margin-bottom: 0.5rem;
-  background: var(--color-bg, #111113); color: inherit;
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-  padding: 0.5rem;
-}
-.form-buttons { display: flex; gap: 0.5rem; }
-.subscriptions {
-  margin-top: 2rem;
-  border-top: 1px solid var(--color-border, #2a2a2e);
-  padding-top: 1rem;
-}
-.subscriptions h3 { font-size: 0.9em; opacity: 0.7; text-transform: uppercase; letter-spacing: 0.05em; }
-.sub-list li { cursor: default; }
-.sub-list label { display: flex; gap: 0.5rem; align-items: center; cursor: pointer; }
-button { cursor: pointer; }
-</style>

frontend/src/components/rules/RulebookListPane.vue

@@ -1,76 +0,0 @@
-<script setup lang="ts">
-import { ref } from "vue";
-import { useRulebooksStore } from "@/stores/rulebooks";
-import type { Rulebook } from "@/api/rulebooks";
-
-defineProps<{ rulebooks: Rulebook[]; selectedId: number | null }>();
-const emit = defineEmits<{ select: [id: number] }>();
-
-const store = useRulebooksStore();
-const isCreating = ref(false);
-const newTitle = ref("");
-
-async function submitNew() {
-  const title = newTitle.value.trim();
-  if (!title) return;
-  const rb = await store.createRulebook({ title });
-  newTitle.value = "";
-  isCreating.value = false;
-  emit("select", rb.id);
-}
-</script>
-
-<template>
-  <aside class="pane">
-    <header><h2>Rulebooks</h2></header>
-    <ul>
-      <li
-        v-for="rb in rulebooks"
-        :key="rb.id"
-        :class="{ active: rb.id === selectedId }"
-        @click="emit('select', rb.id)"
-      >
-        <span class="title">{{ rb.title }}</span>
-        <span v-if="rb.always_on" class="always-on-badge" title="Loaded at session start">always on</span>
-      </li>
-    </ul>
-    <div class="new-rulebook">
-      <button v-if="!isCreating" @click="isCreating = true">+ New rulebook</button>
-      <form v-else @submit.prevent="submitNew">
-        <input v-model="newTitle" autofocus placeholder="Rulebook title" />
-        <div class="form-buttons">
-          <button type="submit">Create</button>
-          <button type="button" @click="isCreating = false">Cancel</button>
-        </div>
-      </form>
-    </div>
-  </aside>
-</template>
-
-<style scoped>
-.pane { background: var(--color-surface, #18181b); padding: 1rem; overflow-y: auto; }
-header h2 { font-family: Fraunces, serif; font-style: italic; margin: 0 0 0.5rem 0; }
-ul { list-style: none; padding: 0; margin: 1rem 0; }
-li { padding: 0.5rem; cursor: pointer; border-radius: 6px; display: flex; align-items: center; gap: 0.5rem; }
-li.active { background: var(--color-primary-bg, rgba(99,102,241,0.15)); }
-li:hover { background: var(--color-hover, rgba(255,255,255,0.05)); }
-.always-on-badge {
-  font-size: 0.7rem;
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-  padding: 0.1rem 0.4rem;
-  border-radius: 3px;
-  background: var(--color-accent, rgba(91,74,138,0.25));
-  color: var(--color-accent-fg, inherit);
-  margin-left: auto;
-}
-.new-rulebook { margin-top: 1rem; }
-.new-rulebook input {
-  width: 100%; margin-bottom: 0.5rem;
-  background: var(--color-bg, #111113); color: inherit;
-  border: 1px solid var(--color-border, #2a2a2e); border-radius: 6px;
-  padding: 0.5rem;
-}
-.form-buttons { display: flex; gap: 0.5rem; }
-button { cursor: pointer; }
-</style>

frontend/src/composables/useStreamingTts.ts

@@ -0,0 +1,168 @@
+import { ref, watch, computed } from 'vue'
+import type { Ref, ComputedRef } from 'vue'
+import { synthesiseSpeech } from '@/api/client'
+import { useVoiceAudio } from '@/composables/useVoiceAudio'
+
+/** Minimum stripped character count to bother synthesizing. */
+const MIN_CHARS = 3
+
+/** Matches sentence-terminal punctuation followed by whitespace or end-of-string. */
+const SENTENCE_BOUNDARY = /[.!?]+(?=\s|$)/
+
+function stripMarkdown(text: string): string {
+  return text
+    .replace(/```[\s\S]*?```/g, '')
+    .replace(/`[^`]+`/g, (m) => m.slice(1, -1))
+    .replace(/#{1,6}\s+/g, '')
+    .replace(/\*\*([^*]+)\*\*/g, '$1')
+    .replace(/\*([^*]+)\*/g, '$1')
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+    .replace(/^\s*[-*+]\s+/gm, '')
+    .replace(/\n{2,}/g, ' ')
+    .trim()
+}
+
+/**
+ * Extract completed sentences from `text` using SENTENCE_BOUNDARY.
+ * Returns the sentences found and the unconsumed remainder.
+ */
+function extractSentences(text: string): { sentences: string[]; remainder: string } {
+  const sentences: string[] = []
+  let remaining = text
+  let match: RegExpExecArray | null
+
+  while ((match = SENTENCE_BOUNDARY.exec(remaining)) !== null) {
+    const boundary = match.index + match[0].length
+    const sentence = remaining.slice(0, boundary).trim()
+    if (sentence) sentences.push(sentence)
+    remaining = remaining.slice(boundary)
+  }
+
+  return { sentences, remainder: remaining }
+}
+
+export interface UseStreamingTtsOptions {
+  streamingContent: Ref<string> | ComputedRef<string>
+  streaming: Ref<boolean> | ComputedRef<boolean>
+  enabled: Ref<boolean> | ComputedRef<boolean>
+}
+
+export interface UseStreamingTtsReturn {
+  /** True while any synthesis request is in-flight or audio is playing. */
+  speaking: ComputedRef<boolean>
+  /** Cancel all in-flight synthesis/playback and clear the queue. */
+  stop: () => void
+  /** Speak a complete text through the same sentence-chunking pipeline. */
+  speak: (text: string) => void
+}
+
+export function useStreamingTts(options: UseStreamingTtsOptions): UseStreamingTtsReturn {
+  const { streamingContent, streaming, enabled } = options
+  const audio = useVoiceAudio()
+
+  let sentenceBuffer = ''
+  let lastSeenLength = 0
+  let abortId = 0
+  let playQueue: Promise<void> = Promise.resolve()
+  const pendingCount = ref(0)
+
+  const speaking = computed(() => pendingCount.value > 0 || audio.playing.value)
+
+  function stop(): void {
+    abortId++
+    sentenceBuffer = ''
+    lastSeenLength = 0
+    playQueue = Promise.resolve()
+    audio.stop()
+    pendingCount.value = 0
+  }
+
+  async function enqueueSentence(sentence: string, myAbortId: number): Promise<void> {
+    const stripped = stripMarkdown(sentence)
+    if (stripped.length < MIN_CHARS) return
+
+    pendingCount.value++
+    let blob: Blob | null = null
+    try {
+      blob = await synthesiseSpeech(stripped)
+    } catch (e) {
+      const errMsg = e instanceof Error ? e.message : String(e)
+      console.warn('[StreamingTTS] Synthesis failed, retrying', {
+        chars: stripped.length,
+        preview: stripped.slice(0, 80),
+        error: errMsg,
+      })
+      try {
+        blob = await synthesiseSpeech(stripped)
+      } catch (e2) {
+        const errMsg2 = e2 instanceof Error ? e2.message : String(e2)
+        console.warn('[StreamingTTS] Retry failed, sentence dropped', {
+          chars: stripped.length,
+          preview: stripped.slice(0, 80),
+          error: errMsg2,
+        })
+      }
+    } finally {
+      pendingCount.value--
+    }
+
+    if (!blob) return
+
+    // Capture blob for the closure — TS can't narrow after async gap
+    const resolvedBlob = blob
+    playQueue = playQueue.then(async () => {
+      if (abortId !== myAbortId) return
+      await audio.play(resolvedBlob)
+    })
+  }
+
+  function dispatchBuffer(flush: boolean): void {
+    if (!enabled.value) return
+    const myAbortId = abortId
+    const { sentences, remainder } = extractSentences(sentenceBuffer)
+    sentenceBuffer = flush ? '' : remainder
+    for (const sentence of sentences) {
+      enqueueSentence(sentence, myAbortId)
+    }
+    if (flush && remainder.trim().length >= MIN_CHARS) {
+      enqueueSentence(remainder.trim(), myAbortId)
+    }
+  }
+
+  // Watch accumulating content — extract new characters since last check
+  watch(streamingContent, (newContent) => {
+    if (!enabled.value) return
+    const delta = newContent.slice(lastSeenLength)
+    lastSeenLength = newContent.length
+    sentenceBuffer += delta
+    dispatchBuffer(false)
+  })
+
+  // Watch streaming flag — stop on new message start, flush on end
+  watch(streaming, (isStreaming) => {
+    if (!enabled.value) return
+    if (isStreaming) {
+      // New message starting — cancel previous response's audio
+      stop()
+    } else {
+      // Stream ended — flush any remaining fragment
+      dispatchBuffer(true)
+      lastSeenLength = 0
+    }
+  })
+
+  function speak(text: string): void {
+    stop()
+    if (!text.trim()) return
+    const myAbortId = abortId
+    const { sentences, remainder } = extractSentences(text)
+    for (const sentence of sentences) {
+      enqueueSentence(sentence, myAbortId)
+    }
+    if (remainder.trim().length >= MIN_CHARS) {
+      enqueueSentence(remainder.trim(), myAbortId)
+    }
+  }
+
+  return { speaking, stop, speak }
+}

frontend/src/composables/useVoiceAudio.ts

@@ -0,0 +1,72 @@
+import { ref, readonly } from 'vue'
+
+const VOLUME_KEY = 'fa_voice_volume'
+
+// Shared volume across all instances — persisted to localStorage per device
+const _volume = ref<number>(parseFloat(localStorage.getItem(VOLUME_KEY) ?? '1.0'))
+
+export function useVoiceAudio() {
+  const playing = ref(false)
+  const isSupported = typeof AudioContext !== 'undefined' || typeof (window as unknown as Record<string, unknown>).webkitAudioContext !== 'undefined'
+
+  let audioCtx: AudioContext | null = null
+  let currentSource: AudioBufferSourceNode | null = null
+
+  function _getCtx(): AudioContext {
+    if (!audioCtx || audioCtx.state === 'closed') {
+      const Ctx = window.AudioContext ?? (window as unknown as Record<string, typeof AudioContext>).webkitAudioContext
+      audioCtx = new Ctx()
+    }
+    return audioCtx
+  }
+
+  async function play(blob: Blob): Promise<void> {
+    stop()
+    const ctx = _getCtx()
+    if (ctx.state === 'suspended') await ctx.resume()
+
+    const arrayBuffer = await blob.arrayBuffer()
+    const audioBuffer = await ctx.decodeAudioData(arrayBuffer)
+
+    const source = ctx.createBufferSource()
+    source.buffer = audioBuffer
+
+    const gain = ctx.createGain()
+    gain.gain.value = _volume.value
+    source.connect(gain)
+    gain.connect(ctx.destination)
+
+    currentSource = source
+    playing.value = true
+
+    return new Promise<void>((resolve) => {
+      source.onended = () => {
+        playing.value = false
+        currentSource = null
+        resolve()
+      }
+      source.start(0)
+    })
+  }
+
+  function stop(): void {
+    if (currentSource) {
+      try { currentSource.stop() } catch { /* already stopped */ }
+      currentSource = null
+    }
+    playing.value = false
+  }
+
+  return {
+    playing: readonly(playing),
+    volume: _volume,
+    isSupported,
+    play,
+    stop,
+  }
+}
+
+export function setVoiceVolume(v: number) {
+  _volume.value = Math.max(0, Math.min(1, v))
+  localStorage.setItem(VOLUME_KEY, String(_volume.value))
+}

frontend/src/composables/useVoiceRecorder.ts

@@ -0,0 +1,93 @@
+import { ref, readonly, type Ref } from 'vue'
+
+/**
+ * Push-to-talk recorder wrapping the browser MediaRecorder API.
+ *
+ * Usage:
+ *   const { recording, error, isSupported, startRecording, stopRecording } = useVoiceRecorder()
+ *   await startRecording()
+ *   const blob = await stopRecording()   // resolves with the recorded audio Blob
+ */
+export function useVoiceRecorder() {
+  const recording = ref(false)
+  const error = ref<string | null>(null)
+  const isSupported = typeof MediaRecorder !== 'undefined' && !!navigator.mediaDevices?.getUserMedia
+
+  let mediaRecorder: MediaRecorder | null = null
+  let chunks: Blob[] = []
+  const streamRef = ref<MediaStream | null>(null)
+  let resolveStop: ((blob: Blob) => void) | null = null
+  let rejectStop: ((err: Error) => void) | null = null
+
+  async function startRecording(): Promise<void> {
+    error.value = null
+    if (!isSupported) {
+      error.value = 'Audio recording is not supported in this browser'
+      return
+    }
+    if (recording.value) return
+
+    try {
+      streamRef.value = await navigator.mediaDevices.getUserMedia({ audio: true })
+    } catch (e) {
+      error.value = 'Microphone access denied'
+      return
+    }
+
+    chunks = []
+    const mimeType = MediaRecorder.isTypeSupported('audio/webm;codecs=opus')
+      ? 'audio/webm;codecs=opus'
+      : MediaRecorder.isTypeSupported('audio/webm')
+        ? 'audio/webm'
+        : ''
+
+    mediaRecorder = mimeType ? new MediaRecorder(streamRef.value!, { mimeType }) : new MediaRecorder(streamRef.value!)
+
+    mediaRecorder.ondataavailable = (e) => {
+      if (e.data.size > 0) chunks.push(e.data)
+    }
+
+    mediaRecorder.onstop = () => {
+      const blob = new Blob(chunks, { type: mediaRecorder?.mimeType ?? 'audio/webm' })
+      chunks = []
+      streamRef.value?.getTracks().forEach((t) => t.stop())
+      streamRef.value = null
+      recording.value = false
+      resolveStop?.(blob)
+      resolveStop = null
+      rejectStop = null
+    }
+
+    mediaRecorder.onerror = () => {
+      recording.value = false
+      error.value = 'Recording error'
+      rejectStop?.(new Error('MediaRecorder error'))
+      resolveStop = null
+      rejectStop = null
+    }
+
+    mediaRecorder.start(100) // collect in 100ms chunks
+    recording.value = true
+  }
+
+  function stopRecording(): Promise<Blob> {
+    return new Promise((resolve, reject) => {
+      if (!mediaRecorder || !recording.value) {
+        reject(new Error('Not recording'))
+        return
+      }
+      resolveStop = resolve
+      rejectStop = reject
+      mediaRecorder.stop()
+    })
+  }
+
+  return {
+    recording: readonly(recording),
+    error: readonly(error),
+    isSupported,
+    startRecording,
+    stopRecording,
+    stream: readonly(streamRef) as Readonly<Ref<MediaStream | null>>,
+  }
+}

frontend/src/router/index.ts

@@ -5,15 +5,11 @@ const router = createRouter({
   history: createWebHistory(),
   routes: [
     {
-      // The dashboard ("what to work on") is the landing page; Knowledge
-      // remains as the exhaustive "Browse" surface.
+      // 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: "/",
-      redirect: "/dashboard",
-    },
-    {
-      path: "/dashboard",
-      name: "dashboard",
-      component: () => import("@/views/DashboardView.vue"),
+      redirect: "/journal",
     },
     {
       path: "/knowledge",
@@ -85,9 +81,9 @@ const router = createRouter({
       component: () => import("@/views/ProjectView.vue"),
     },
     {
-      path: "/rules",
-      name: "rules",
-      component: () => import("@/views/RulesView.vue"),
+      path: "/workspace/:projectId",
+      name: "workspace",
+      component: () => import("@/views/WorkspaceView.vue"),
     },
     {
       path: "/tasks",
@@ -103,6 +99,16 @@ const router = createRouter({
       name: "task-edit",
       component: () => import("@/views/TaskEditorView.vue"),
     },
+    {
+      path: "/chat",
+      name: "chat",
+      component: () => import("@/views/ChatView.vue"),
+    },
+    {
+      path: "/chat/:id",
+      name: "chat-conversation",
+      component: () => import("@/views/ChatView.vue"),
+    },
     {
       path: "/shared",
       name: "shared-with-me",
@@ -113,16 +119,16 @@ const router = createRouter({
       name: "calendar",
       component: () => import("@/views/CalendarView.vue"),
     },
+    {
+      path: "/journal",
+      name: "journal",
+      component: () => import("@/views/JournalView.vue"),
+    },
     {
       path: "/settings",
       name: "settings",
       component: () => import("@/views/SettingsView.vue"),
     },
-    {
-      path: "/trash",
-      name: "trash",
-      component: () => import("@/views/TrashView.vue"),
-    },
     { path: "/admin/users", redirect: "/settings" },
     { path: "/admin/logs", redirect: "/settings" },
   ],

frontend/src/stores/chat.ts

@@ -0,0 +1,640 @@
+import { ref, computed } from "vue";
+import { defineStore } from "pinia";
+import {
+  apiGet,
+  apiPost,
+  apiPatch,
+  apiDelete,
+  apiSSEStream,
+} from "@/api/client";
+import { useToastStore } from "@/stores/toast";
+import type {
+  Conversation,
+  ConversationDetail,
+  ContextMeta,
+  GenerationTiming,
+  Message,
+  OllamaStatus,
+  SendMessageResponse,
+  ToolCallRecord,
+  ToolPendingRecord,
+} from "@/types/chat";
+
+interface ConvStreamState {
+  streaming: boolean;
+  content: string;
+  thinking: string;
+  toolCalls: ToolCallRecord[];
+  status: string;
+  pendingTool: ToolPendingRecord | null;
+  contextMeta: ContextMeta | null;
+}
+
+interface QueuedMessage {
+  content: string;
+  contextNoteId?: number | null;
+  includeNoteIds?: number[];
+  think: boolean;
+  contextNoteTitle?: string;
+  excludeNoteIds?: number[];
+  ragProjectId?: number | null;
+  workspaceProjectId?: number | null;
+}
+
+export const useChatStore = defineStore("chat", () => {
+  const conversations = ref<Conversation[]>([]);
+  const currentConversation = ref<ConversationDetail | null>(null);
+  const total = ref(0);
+  const loading = ref(false);
+  const convStreams = ref<Record<number, ConvStreamState>>({});
+  const convQueues = ref<Record<number, QueuedMessage[]>>({});
+  const ollamaStatus = ref<"checking" | "available" | "unavailable">("checking");
+  const modelStatus = ref<"checking" | "loaded" | "cold" | "not_found">("checking");
+  const defaultModel = ref("");
+  let statusPollTimer: ReturnType<typeof setInterval> | null = null;
+
+  function _getOrInitStream(id: number): ConvStreamState {
+    if (!convStreams.value[id]) {
+      convStreams.value[id] = {
+        streaming: false, content: "", thinking: "", toolCalls: [],
+        status: "", pendingTool: null, contextMeta: null,
+      };
+    }
+    return convStreams.value[id];
+  }
+
+  // Per-conversation computed getters — same names as old refs, zero callers change
+  const streaming = computed(() => {
+    const id = currentConversation.value?.id;
+    return !!id && (convStreams.value[id]?.streaming ?? false);
+  });
+  const streamingContent = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.content ?? "");
+  const streamingThinking = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.thinking ?? "");
+  const streamingToolCalls = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.toolCalls ?? []);
+  const streamingStatus = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.status ?? "");
+  const streamingPendingTool = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.pendingTool ?? null);
+  const lastContextMeta = computed(() => convStreams.value[currentConversation.value?.id ?? 0]?.contextMeta ?? null);
+
+  const ragProjectId = computed<number | null>(
+    () => currentConversation.value?.rag_project_id ?? null
+  );
+
+  async function updateRagScope(convId: number, ragProjectId: number | null): Promise<void> {
+    await apiPatch(`/api/chat/conversations/${convId}`, { rag_project_id: ragProjectId });
+    if (currentConversation.value?.id === convId) {
+      currentConversation.value.rag_project_id = ragProjectId;
+    }
+  }
+
+  function isStreamingConv(id: number): boolean {
+    return convStreams.value[id]?.streaming ?? false;
+  }
+
+  const queuedCount = computed(() => {
+    const id = currentConversation.value?.id;
+    return id ? (convQueues.value[id]?.length ?? 0) : 0;
+  });
+
+  const queuedMessages = computed(() => {
+    const id = currentConversation.value?.id;
+    return id ? (convQueues.value[id] ?? []) : [];
+  });
+
+  function _saveQueue(convId: number) {
+    const q = convQueues.value[convId] ?? [];
+    if (q.length) {
+      localStorage.setItem(`fa_conv_queue_${convId}`, JSON.stringify(q));
+    } else {
+      localStorage.removeItem(`fa_conv_queue_${convId}`);
+    }
+  }
+
+  function _loadQueue(convId: number) {
+    try {
+      const raw = localStorage.getItem(`fa_conv_queue_${convId}`);
+      if (raw) {
+        convQueues.value[convId] = JSON.parse(raw) as QueuedMessage[];
+      }
+    } catch {
+      // ignore corrupt data
+    }
+  }
+
+  // Drain the next queued message for a conversation, if conditions are met.
+  // Called both at stream-end and after fetchConversation, so orphaned queue
+  // messages (e.g. from a navigation away mid-stream) are picked up on return.
+  function _tryDrainQueue(convId: number) {
+    const queue = convQueues.value[convId];
+    if (!queue?.length) return;
+    if (isStreamingConv(convId)) return; // stream-end will drain naturally
+    if (currentConversation.value?.id !== convId) return; // not our conversation
+    const next = queue.shift()!;
+    _saveQueue(convId);
+    setTimeout(() => sendMessage(
+      next.content,
+      next.contextNoteId,
+      next.includeNoteIds,
+      next.think,
+      next.contextNoteTitle,
+      next.excludeNoteIds,
+      next.ragProjectId,
+      next.workspaceProjectId,
+    ), 0);
+  }
+
+  function clearQueue() {
+    const id = currentConversation.value?.id;
+    if (id) {
+      convQueues.value[id] = [];
+      _saveQueue(id);
+    }
+  }
+
+  // Chat is usable when Ollama is up and model is at least installed (cold starts still work)
+  const chatReady = computed(
+    () => ollamaStatus.value === "available" && (modelStatus.value === "loaded" || modelStatus.value === "cold")
+  );
+
+  async function fetchConversations(limit = 50, offset = 0) {
+    loading.value = true;
+    try {
+      const data = await apiGet<{ conversations: Conversation[]; total: number }>(
+        `/api/chat/conversations?limit=${limit}&offset=${offset}`
+      );
+      conversations.value = data.conversations;
+      total.value = data.total;
+    } catch (e) {
+      useToastStore().show("Failed to load conversations", "error");
+      throw e;
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  async function createConversation(title = ""): Promise<Conversation> {
+    try {
+      const conv = await apiPost<Conversation>("/api/chat/conversations", {
+        title,
+      });
+      conversations.value.unshift(conv);
+      return conv;
+    } catch (e) {
+      useToastStore().show("Failed to create conversation", "error");
+      throw e;
+    }
+  }
+
+  async function fetchConversation(id: number) {
+    loading.value = true;
+    try {
+      currentConversation.value = await apiGet<ConversationDetail>(
+        `/api/chat/conversations/${id}`
+      );
+      _loadQueue(id);
+      // Drain any messages that were queued but never sent because the user
+      // navigated away before the previous stream finished.
+      _tryDrainQueue(id);
+    } catch (e) {
+      useToastStore().show("Failed to load conversation", "error");
+      throw e;
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  async function bulkDeleteConversations(ids: number[]) {
+    if (!ids.length) return;
+    await apiPost("/api/chat/conversations/bulk-delete", { ids });
+    const idSet = new Set(ids);
+    conversations.value = conversations.value.filter((c) => !idSet.has(c.id));
+    if (currentConversation.value && idSet.has(currentConversation.value.id)) {
+      currentConversation.value = null;
+    }
+    for (const id of ids) {
+      delete convStreams.value[id];
+      delete convQueues.value[id];
+      localStorage.removeItem(`fa_conv_queue_${id}`);
+    }
+  }
+
+  async function deleteConversation(id: number) {
+    try {
+      await apiDelete(`/api/chat/conversations/${id}`);
+      conversations.value = conversations.value.filter((c) => c.id !== id);
+      if (currentConversation.value?.id === id) {
+        currentConversation.value = null;
+      }
+      delete convStreams.value[id];
+      delete convQueues.value[id];
+      localStorage.removeItem(`fa_conv_queue_${id}`);
+    } catch (e) {
+      useToastStore().show("Failed to delete conversation", "error");
+      throw e;
+    }
+  }
+
+  async function updateTitle(id: number, title: string) {
+    try {
+      const updated = await apiPatch<Conversation>(
+        `/api/chat/conversations/${id}`,
+        { title }
+      );
+      const idx = conversations.value.findIndex((c) => c.id === id);
+      if (idx !== -1) {
+        conversations.value[idx] = { ...conversations.value[idx], ...updated };
+      }
+      if (currentConversation.value?.id === id) {
+        currentConversation.value.title = updated.title;
+      }
+    } catch (e) {
+      useToastStore().show("Failed to update title", "error");
+      throw e;
+    }
+  }
+
+  async function sendMessage(
+    content: string,
+    contextNoteId?: number | null,
+    includeNoteIds?: number[],
+    think = false,
+    contextNoteTitle?: string,
+    excludeNoteIds?: number[],
+    ragProjectId?: number | null,
+    workspaceProjectId?: number | null,
+  ) {
+    if (!currentConversation.value) return;
+
+    const convId = currentConversation.value.id;
+    const s = _getOrInitStream(convId);
+
+    // If already streaming, queue the message for after the current stream ends.
+    if (s.streaming) {
+      if (!convQueues.value[convId]) convQueues.value[convId] = [];
+      convQueues.value[convId].push({
+        content, contextNoteId, includeNoteIds, think, contextNoteTitle,
+        excludeNoteIds, ragProjectId, workspaceProjectId,
+      });
+      _saveQueue(convId);
+      return;
+    }
+
+    s.contextMeta = null;
+
+    // If a write tool is waiting for confirmation, intercept single-word yes/no
+    // responses rather than sending them as a new message.
+    if (s.pendingTool) {
+      const lower = content.trim().toLowerCase();
+      const YES = new Set(["yes", "y", "ok", "sure", "proceed", "accept", "confirm", "do it", "go ahead", "yeah", "yep"]);
+      const NO = new Set(["no", "n", "cancel", "decline", "stop", "nope", "abort", "don't"]);
+      if (YES.has(lower)) {
+        await confirmTool(true);
+        return;
+      }
+      if (NO.has(lower)) {
+        await confirmTool(false);
+        return;
+      }
+    }
+
+    // Add optimistic user message
+    const userMsg: Message = {
+      id: -Date.now(), // Temporary ID
+      conversation_id: convId,
+      role: "user",
+      content,
+      context_note_id: contextNoteId ?? null,
+      context_note_title: contextNoteTitle ?? null,
+      created_at: new Date().toISOString(),
+    };
+    currentConversation.value.messages.push(userMsg);
+
+    s.streaming = true;
+    s.content = "";
+
+    // Phase 1: POST to start generation
+    let assistantMessageId: number;
+    try {
+      const resp = await apiPost<SendMessageResponse>(
+        `/api/chat/conversations/${convId}/messages`,
+        {
+          content,
+          context_note_id: contextNoteId,
+          include_note_ids: includeNoteIds?.length ? includeNoteIds : undefined,
+          excluded_note_ids: excludeNoteIds?.length ? excludeNoteIds : undefined,
+          think,
+          rag_project_id: ragProjectId ?? undefined,
+          workspace_project_id: workspaceProjectId ?? undefined,
+          user_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        },
+      );
+      assistantMessageId = resp.assistant_message_id;
+    } catch (e) {
+      s.streaming = false;
+      s.content = "";
+      useToastStore().show("Failed to send message", "error");
+      return;
+    }
+
+    // Immediately commit the message count so cleanup watcher never sees it as empty
+    const convInList = conversations.value.find((c) => c.id === convId);
+    if (convInList) convInList.message_count += 2;
+
+    // Phase 2: Connect to SSE stream with reconnection
+    await _streamGeneration(convId, assistantMessageId);
+  }
+
+  async function _streamGeneration(
+    convId: number,
+    assistantMessageId: number,
+    initialLastEventId = -1,
+    attempt = 0,
+  ) {
+    const MAX_RETRIES = 5;
+    let lastEventId = initialLastEventId;
+    let gotDone = false;
+
+    const handle = apiSSEStream(
+      `/api/chat/conversations/${convId}/generation/stream` +
+        (lastEventId >= 0 ? `?last_event_id=${lastEventId}` : ""),
+      (event) => {
+        lastEventId = event.id;
+        const s = convStreams.value[convId];
+        if (!s) return;
+
+        switch (event.event) {
+          case "context":
+            s.contextMeta = event.data.context as ContextMeta;
+            break;
+          case "status":
+            s.status = event.data.status as string;
+            break;
+          case "thinking_chunk":
+            s.thinking += event.data.chunk as string;
+            break;
+          case "chunk":
+            s.content += event.data.chunk as string;
+            s.status = "";
+            break;
+          case "tool_pending":
+            s.pendingTool = event.data.tool_pending as ToolPendingRecord;
+            break;
+          case "tool_call":
+            // Receiving a tool_call clears the pending confirmation card
+            s.pendingTool = null;
+            s.toolCalls = [...s.toolCalls, event.data.tool_call as ToolCallRecord];
+            break;
+          case "done":
+            gotDone = true;
+            {
+              const assistantMsg: Message = {
+                id: event.data.message_id as number,
+                conversation_id: convId,
+                role: "assistant",
+                content: s.content,
+                context_note_id: null,
+                tool_calls: s.toolCalls.length ? [...s.toolCalls] : null,
+                created_at: new Date().toISOString(),
+                timing: event.data.timing as GenerationTiming | undefined,
+                thinking: s.thinking || undefined,
+              };
+              if (currentConversation.value?.id === convId) {
+                currentConversation.value.messages.push(assistantMsg);
+                // Update RAG scope if the model changed it mid-conversation
+                if (event.data.new_rag_scope !== undefined) {
+                  currentConversation.value.rag_project_id = event.data.new_rag_scope as number | null;
+                }
+              }
+              // Update updated_at only — message_count was already incremented at send time
+              const idx = conversations.value.findIndex((c) => c.id === convId);
+              if (idx !== -1) {
+                conversations.value[idx].updated_at = new Date().toISOString();
+              }
+              // Clear stream state
+              s.content = "";
+              s.thinking = "";
+              s.toolCalls = [];
+              s.status = "";
+              s.pendingTool = null;
+              s.streaming = false;
+            }
+            break;
+          case "error":
+            gotDone = true;
+            s.streaming = false;
+            s.content = "";
+            s.thinking = "";
+            s.toolCalls = [];
+            s.status = "";
+            s.pendingTool = null;
+            if (currentConversation.value?.id === convId) {
+              useToastStore().show(
+                "Chat error: " + (event.data.error as string),
+                "error",
+              );
+            }
+            break;
+        }
+      },
+    );
+
+    // Wait for the stream to close (events are processed via callback above)
+    await handle.done;
+
+    // If stream ended without done/error, attempt reconnection regardless of which
+    // conv is currently viewed — background streams retry independently
+    if (!gotDone && attempt < MAX_RETRIES) {
+      const delay = Math.min(1000 * 2 ** attempt, 10_000);
+      await new Promise((r) => setTimeout(r, delay));
+      return _streamGeneration(convId, assistantMessageId, lastEventId, attempt + 1);
+    }
+
+    // Recovery fallback: re-fetch conversation from DB only if currently viewing it
+    if (!gotDone && currentConversation.value?.id === convId) {
+      useToastStore().show(
+        "Connection lost — response may be incomplete",
+        "error",
+      );
+      try {
+        await fetchConversation(convId);
+      } catch {
+        // Re-fetch failed — partial content visible on next page load
+      }
+    }
+
+    // Final cleanup (guards against done/error not having fired)
+    const s = convStreams.value[convId];
+    if (s) {
+      s.streaming = false;
+      s.content = "";
+      s.thinking = "";
+      s.toolCalls = [];
+      s.status = "";
+      s.pendingTool = null;
+    }
+
+    // Process next queued message if this is still the active conversation.
+    // If the user has navigated away, _tryDrainQueue will fire on fetchConversation.
+    _tryDrainQueue(convId);
+  }
+
+  async function reconnectIfGenerating(convId: number): Promise<void> {
+    // Skip if a stream is already active for this conversation
+    if (isStreamingConv(convId)) return;
+
+    const conv = currentConversation.value;
+    if (!conv || conv.id !== convId) return;
+
+    // Find the last assistant message still in generating state
+    const lastMsg = [...conv.messages].reverse().find(
+      (m) => m.role === "assistant" && m.status === "generating"
+    );
+    if (!lastMsg) return;
+
+    // Remove the partial message — the done event will re-add the final version
+    conv.messages = conv.messages.filter((m) => m.id !== lastMsg.id);
+
+    const s = _getOrInitStream(convId);
+    s.streaming = true;
+    s.content = "";
+    s.thinking = "";
+    s.toolCalls = [];
+    s.status = "Reconnecting...";
+    s.pendingTool = null;
+    s.contextMeta = null;
+
+    // Reconnect from the beginning — the buffer replays all buffered events.
+    // If the buffer is gone (>60s stale), _streamGeneration will exhaust retries
+    // then fall back to fetchConversation to show the final saved content.
+    await _streamGeneration(convId, lastMsg.id);
+  }
+
+  async function confirmTool(confirmed: boolean) {
+    const convId = currentConversation.value?.id;
+    if (!convId) return;
+    // Optimistically clear so buttons disappear immediately
+    const s = convStreams.value[convId];
+    if (s) s.pendingTool = null;
+    try {
+      await apiPost(`/api/chat/conversations/${convId}/generation/confirm`, { confirmed });
+    } catch {
+      // Server will auto-decline on timeout — no action needed
+    }
+  }
+
+  async function cancelGeneration() {
+    if (!currentConversation.value) return;
+    try {
+      await apiPost(
+        `/api/chat/conversations/${currentConversation.value.id}/generation/cancel`,
+        {}
+      );
+    } catch {
+      // Generation may have already finished — ignore
+    }
+  }
+
+  async function saveMessageAsNote(messageId: number) {
+    return await apiPost<Record<string, unknown>>(
+      `/api/chat/messages/${messageId}/save-as-note`,
+      {}
+    );
+  }
+
+  async function summarizeAsNote(conversationId: number) {
+    return await apiPost<Record<string, unknown>>(
+      `/api/chat/conversations/${conversationId}/summarize`,
+      {}
+    );
+  }
+
+  async function fetchStatus() {
+    try {
+      const data = await apiGet<OllamaStatus>("/api/chat/status");
+      ollamaStatus.value = data.ollama;
+      modelStatus.value = data.model;
+      defaultModel.value = data.default_model;
+    } catch {
+      ollamaStatus.value = "unavailable";
+      modelStatus.value = "not_found";
+    }
+  }
+
+  function startStatusPolling() {
+    fetchStatus();
+    stopStatusPolling();
+    statusPollTimer = setInterval(fetchStatus, 30_000);
+  }
+
+  function stopStatusPolling() {
+    if (statusPollTimer !== null) {
+      clearInterval(statusPollTimer);
+      statusPollTimer = null;
+    }
+  }
+
+  async function warmModel(model: string) {
+    try {
+      await apiPost("/api/chat/warm", { model });
+      // Poll faster after a warm request so the indicator updates promptly
+      _pollUntilLoaded();
+    } catch {
+      // Warming is best-effort
+    }
+  }
+
+  function _pollUntilLoaded() {
+    let attempts = 0;
+    const MAX = 12; // up to ~60s of fast polling
+    const timer = setInterval(async () => {
+      try {
+        await fetchStatus();
+      } catch {
+        // best-effort polling
+      }
+      attempts++;
+      if (modelStatus.value === "loaded" || attempts >= MAX) {
+        clearInterval(timer);
+      }
+    }, 5_000);
+  }
+
+  return {
+    conversations,
+    currentConversation,
+    total,
+    loading,
+    streaming,
+    streamingContent,
+    streamingThinking,
+    streamingToolCalls,
+    streamingStatus,
+    streamingPendingTool,
+    lastContextMeta,
+    ragProjectId,
+    updateRagScope,
+    ollamaStatus,
+    modelStatus,
+    defaultModel,
+    chatReady,
+    isStreamingConv,
+    queuedCount,
+    queuedMessages,
+    clearQueue,
+    fetchConversations,
+    createConversation,
+    fetchConversation,
+    deleteConversation,
+    bulkDeleteConversations,
+    updateTitle,
+    sendMessage,
+    reconnectIfGenerating,
+    confirmTool,
+    cancelGeneration,
+    saveMessageAsNote,
+    summarizeAsNote,
+    warmModel,
+    fetchStatus,
+    startStatusPolling,
+    stopStatusPolling,
+  };
+});

frontend/src/stores/notes.ts

@@ -2,16 +2,66 @@ import { ref } from "vue";
 import { defineStore } from "pinia";
 import { apiGet, apiPost, apiPut, apiDelete } from "@/api/client";
 import { useToastStore } from "@/stores/toast";
-import type { Note } from "@/types/note";
+import type { Note, NoteListResponse } from "@/types/note";
 
-// Single-note + mutation surface. The list/filter/sort/pagination surface that
-// backed the removed /notes list view was dropped in the 2026-06-02 drift-audit
-// cleanup (no consumers — KnowledgeView and the editors use single-entity and
-// mutation methods only).
 export const useNotesStore = defineStore("notes", () => {
+  const notes = ref<Note[]>([]);
   const currentNote = ref<Note | null>(null);
+  const total = ref(0);
   const loading = ref(false);
 
+  // Filter / pagination / sort state
+  const activeTagFilters = ref<string[]>([]);
+  const limit = ref(20);
+  const offset = ref(0);
+  const sortField = ref("updated_at");
+  const sortOrder = ref<"asc" | "desc">("desc");
+  const searchQuery = ref("");
+
+  async function refresh() {
+    loading.value = true;
+    try {
+      const searchParams = new URLSearchParams();
+      if (searchQuery.value) searchParams.set("q", searchQuery.value);
+      for (const t of activeTagFilters.value) {
+        searchParams.append("tag", t);
+      }
+      searchParams.set("sort", sortField.value);
+      searchParams.set("order", sortOrder.value);
+      searchParams.set("limit", String(limit.value));
+      searchParams.set("offset", String(offset.value));
+
+      const qs = searchParams.toString();
+      const data = await apiGet<NoteListResponse>(
+        `/api/notes${qs ? `?${qs}` : ""}`
+      );
+      notes.value = data.notes;
+      total.value = data.total;
+    } catch (e) {
+      useToastStore().show("Failed to load notes", "error");
+      throw e;
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  async function fetchNotes(params?: {
+    q?: string;
+    tag?: string[];
+    sort?: string;
+    order?: string;
+    limit?: number;
+    offset?: number;
+  }) {
+    if (params?.q !== undefined) searchQuery.value = params.q || "";
+    if (params?.tag) activeTagFilters.value = params.tag;
+    if (params?.sort) sortField.value = params.sort;
+    if (params?.order) sortOrder.value = params.order as "asc" | "desc";
+    if (params?.limit) limit.value = params.limit;
+    if (params?.offset !== undefined) offset.value = params.offset;
+    await refresh();
+  }
+
   async function fetchNote(id: number) {
     loading.value = true;
     try {
@@ -60,6 +110,7 @@ export const useNotesStore = defineStore("notes", () => {
   async function deleteNote(id: number) {
     try {
       await apiDelete(`/api/notes/${id}`);
+      notes.value = notes.value.filter((n) => n.id !== id);
       if (currentNote.value?.id === id) {
         currentNote.value = null;
       }
@@ -69,6 +120,50 @@ export const useNotesStore = defineStore("notes", () => {
     }
   }
 
+  function addTagFilter(tag: string) {
+    if (!activeTagFilters.value.includes(tag)) {
+      activeTagFilters.value.push(tag);
+      offset.value = 0;
+      refresh();
+    }
+  }
+
+  function removeTagFilter(tag: string) {
+    activeTagFilters.value = activeTagFilters.value.filter((t) => t !== tag);
+    offset.value = 0;
+    refresh();
+  }
+
+  function clearTagFilters() {
+    activeTagFilters.value = [];
+    offset.value = 0;
+    refresh();
+  }
+
+  function setTagFilters(tags: string[]) {
+    activeTagFilters.value = [...tags];
+    offset.value = 0;
+    refresh();
+  }
+
+  function setSort(field: string, order: "asc" | "desc") {
+    sortField.value = field;
+    sortOrder.value = order;
+    offset.value = 0;
+    refresh();
+  }
+
+  function setOffset(newOffset: number) {
+    offset.value = newOffset;
+    refresh();
+  }
+
+  function setSearch(q: string) {
+    searchQuery.value = q;
+    offset.value = 0;
+    refresh();
+  }
+
   async function resolveTitle(title: string): Promise<Note> {
     return await apiPost<Note>("/api/notes/resolve-title", { title });
   }
@@ -121,12 +216,29 @@ export const useNotesStore = defineStore("notes", () => {
   }
 
   return {
+    notes,
     currentNote,
+    total,
     loading,
+    activeTagFilters,
+    limit,
+    offset,
+    sortField,
+    sortOrder,
+    searchQuery,
+    fetchNotes,
     fetchNote,
     createNote,
     updateNote,
     deleteNote,
+    addTagFilter,
+    removeTagFilter,
+    clearTagFilters,
+    setTagFilters,
+    setSort,
+    setOffset,
+    setSearch,
+    refresh,
     resolveTitle,
     convertToTask,
     convertToNote,

frontend/src/stores/push.ts

@@ -0,0 +1,109 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+
+function urlBase64ToUint8Array(base64String: string): Uint8Array<ArrayBuffer> {
+  const padding = '='.repeat((4 - (base64String.length % 4)) % 4)
+  const base64 = (base64String + padding).replace(/-/g, '+').replace(/_/g, '/')
+  const rawData = window.atob(base64)
+  const buf = new ArrayBuffer(rawData.length)
+  const outputArray = new Uint8Array<ArrayBuffer>(buf)
+  for (let i = 0; i < rawData.length; ++i) {
+    outputArray[i] = rawData.charCodeAt(i)
+  }
+  return outputArray
+}
+
+export const usePushStore = defineStore('push', () => {
+  const isSupported = ref(
+    'serviceWorker' in navigator && 'PushManager' in window && 'Notification' in window
+  )
+  const permission = ref<NotificationPermission>(
+    'Notification' in window ? Notification.permission : 'denied'
+  )
+  const isSubscribed = ref(false)
+  const loading = ref(false)
+  const error = ref<string | null>(null)
+
+  async function checkSubscription(): Promise<void> {
+    if (!isSupported.value) return
+    try {
+      const reg = await navigator.serviceWorker.ready
+      const sub = await reg.pushManager.getSubscription()
+      isSubscribed.value = !!sub
+    } catch {
+      isSubscribed.value = false
+    }
+  }
+
+  async function subscribe(): Promise<void> {
+    if (!isSupported.value) {
+      error.value = 'Push notifications not supported in this browser'
+      return
+    }
+    loading.value = true
+    error.value = null
+    try {
+      // Request permission
+      permission.value = await Notification.requestPermission()
+      if (permission.value !== 'granted') {
+        error.value = 'Notification permission denied'
+        return
+      }
+
+      // Fetch VAPID public key
+      const resp = await fetch('/api/push/vapid-public-key')
+      if (!resp.ok) {
+        error.value = 'Push notifications not configured on server'
+        return
+      }
+      const { publicKey } = await resp.json()
+
+      // Register service worker
+      const reg = await navigator.serviceWorker.register('/sw.js')
+      await navigator.serviceWorker.ready
+
+      // Subscribe
+      const sub = await reg.pushManager.subscribe({
+        userVisibleOnly: true,
+        applicationServerKey: urlBase64ToUint8Array(publicKey),
+      })
+
+      // Save to server
+      const saveResp = await fetch('/api/push/subscribe', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(sub.toJSON()),
+      })
+      if (!saveResp.ok) throw new Error('Failed to save subscription')
+      isSubscribed.value = true
+    } catch (e: unknown) {
+      error.value = e instanceof Error ? e.message : 'Failed to subscribe'
+    } finally {
+      loading.value = false
+    }
+  }
+
+  async function unsubscribe(): Promise<void> {
+    loading.value = true
+    error.value = null
+    try {
+      const reg = await navigator.serviceWorker.ready
+      const sub = await reg.pushManager.getSubscription()
+      if (sub) {
+        await fetch('/api/push/subscribe', {
+          method: 'DELETE',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ endpoint: sub.endpoint }),
+        })
+        await sub.unsubscribe()
+      }
+      isSubscribed.value = false
+    } catch (e: unknown) {
+      error.value = e instanceof Error ? e.message : 'Failed to unsubscribe'
+    } finally {
+      loading.value = false
+    }
+  }
+
+  return { isSupported, permission, isSubscribed, loading, error, checkSubscription, subscribe, unsubscribe }
+})

frontend/src/stores/rulebooks.ts

@@ -1,134 +0,0 @@
-import { ref } from "vue";
-import { defineStore } from "pinia";
-import * as api from "@/api/rulebooks";
-import type { Rulebook, RulebookTopic, Rule, RuleHeader } from "@/api/rulebooks";
-import { useToastStore } from "@/stores/toast";
-
-export const useRulebooksStore = defineStore("rulebooks", () => {
-  const rulebooks = ref<Rulebook[]>([]);
-  const topicsByRulebook = ref<Record<number, RulebookTopic[]>>({});
-  const rulesByTopic = ref<Record<number, RuleHeader[]>>({});
-  const currentRule = ref<Rule | null>(null);
-  const loading = ref(false);
-
-  async function fetchRulebooks() {
-    loading.value = true;
-    try {
-      rulebooks.value = await api.listRulebooks();
-    } catch (e) {
-      useToastStore().show("Failed to load rulebooks", "error");
-      throw e;
-    } finally {
-      loading.value = false;
-    }
-  }
-
-  async function fetchTopics(rulebookId: number) {
-    try {
-      topicsByRulebook.value[rulebookId] = await api.listTopics(rulebookId);
-    } catch (e) {
-      useToastStore().show("Failed to load topics", "error");
-      throw e;
-    }
-  }
-
-  async function fetchRules(topicId: number) {
-    try {
-      const rules = await api.listRules({ topic_id: topicId });
-      rulesByTopic.value[topicId] = rules.map((r) => ({
-        id: r.id, title: r.title, statement: r.statement, topic_id: r.topic_id,
-      }));
-    } catch (e) {
-      useToastStore().show("Failed to load rules", "error");
-      throw e;
-    }
-  }
-
-  async function fetchRule(id: number) {
-    currentRule.value = await api.getRule(id);
-  }
-
-  async function createRulebook(data: { title: string; description?: string }) {
-    const rb = await api.createRulebook(data);
-    rulebooks.value.push(rb);
-    return rb;
-  }
-
-  async function updateRulebook(id: number, data: Partial<Pick<Rulebook, "title" | "description" | "always_on">>) {
-    const rb = await api.updateRulebook(id, data);
-    const idx = rulebooks.value.findIndex((r) => r.id === id);
-    if (idx >= 0) rulebooks.value[idx] = rb;
-    return rb;
-  }
-
-  async function toggleAlwaysOn(id: number) {
-    const current = rulebooks.value.find((r) => r.id === id);
-    if (!current) return;
-    return updateRulebook(id, { always_on: !current.always_on });
-  }
-
-  async function deleteRulebook(id: number) {
-    await api.deleteRulebook(id);
-    rulebooks.value = rulebooks.value.filter((r) => r.id !== id);
-    delete topicsByRulebook.value[id];
-  }
-
-  async function createTopic(rulebookId: number, data: { title: string; description?: string }) {
-    const topic = await api.createTopic(rulebookId, data);
-    if (!topicsByRulebook.value[rulebookId]) topicsByRulebook.value[rulebookId] = [];
-    topicsByRulebook.value[rulebookId].push(topic);
-    return topic;
-  }
-
-  async function updateTopic(id: number, data: Partial<Pick<RulebookTopic, "title" | "description" | "order_index">>) {
-    const topic = await api.updateTopic(id, data);
-    for (const rbId of Object.keys(topicsByRulebook.value)) {
-      const list = topicsByRulebook.value[Number(rbId)];
-      const idx = list.findIndex((t) => t.id === id);
-      if (idx >= 0) list[idx] = topic;
-    }
-    return topic;
-  }
-
-  async function deleteTopic(id: number) {
-    await api.deleteTopic(id);
-    for (const rbId of Object.keys(topicsByRulebook.value)) {
-      topicsByRulebook.value[Number(rbId)] = topicsByRulebook.value[Number(rbId)].filter((t) => t.id !== id);
-    }
-    delete rulesByTopic.value[id];
-  }
-
-  async function createRule(topicId: number, data: { title: string; statement: string; why?: string; how_to_apply?: string }) {
-    const rule = await api.createRule(topicId, data);
-    if (!rulesByTopic.value[topicId]) rulesByTopic.value[topicId] = [];
-    rulesByTopic.value[topicId].push({ id: rule.id, title: rule.title, statement: rule.statement, topic_id: rule.topic_id });
-    return rule;
-  }
-
-  async function updateRule(id: number, data: Partial<Pick<Rule, "title" | "statement" | "why" | "how_to_apply" | "order_index">>) {
-    const rule = await api.updateRule(id, data);
-    if (currentRule.value?.id === id) currentRule.value = rule;
-    for (const tid of Object.keys(rulesByTopic.value)) {
-      const list = rulesByTopic.value[Number(tid)];
-      const idx = list.findIndex((r) => r.id === id);
-      if (idx >= 0) list[idx] = { id: rule.id, title: rule.title, statement: rule.statement, topic_id: rule.topic_id };
-    }
-    return rule;
-  }
-
-  async function deleteRule(id: number) {
-    await api.deleteRule(id);
-    if (currentRule.value?.id === id) currentRule.value = null;
-    for (const tid of Object.keys(rulesByTopic.value)) {
-      rulesByTopic.value[Number(tid)] = rulesByTopic.value[Number(tid)].filter((r) => r.id !== id);
-    }
-  }
-
-  return {
-    rulebooks, topicsByRulebook, rulesByTopic, currentRule, loading,
-    fetchRulebooks, fetchTopics, fetchRules, fetchRule,
-    createRulebook, updateRulebook, toggleAlwaysOn, deleteRulebook,
-    createTopic, updateTopic, deleteTopic,
-    createRule, updateRule, deleteRule,
-  };
-});

frontend/src/stores/settings.ts

@@ -1,6 +1,6 @@
-import { ref } from "vue";
+import { ref, computed } from "vue";
 import { defineStore } from "pinia";
-import { apiGet, apiPut } from "@/api/client";
+import { apiGet, apiPut, getVoiceStatus } from "@/api/client";
 import { useToastStore } from "@/stores/toast";
 import type { AppSettings } from "@/types/settings";
 
@@ -8,6 +8,32 @@ export const useSettingsStore = defineStore("settings", () => {
   const settings = ref<AppSettings>({});
   const loading = ref(false);
 
+  const assistantName = computed(
+    () => settings.value.assistant_name || "Fable"
+  );
+
+  const defaultModel = computed(
+    () => settings.value.default_model || ""
+  );
+
+  // Voice status — checked once on login, refreshable from Settings
+  const voiceEnabled = ref(false);
+  const voiceSttReady = ref(false);
+  const voiceTtsReady = ref(false);
+
+  async function checkVoiceStatus() {
+    try {
+      const s = await getVoiceStatus();
+      voiceEnabled.value = s.enabled;
+      voiceSttReady.value = s.enabled && s.stt;
+      voiceTtsReady.value = s.enabled && s.tts;
+    } catch {
+      voiceEnabled.value = false;
+      voiceSttReady.value = false;
+      voiceTtsReady.value = false;
+    }
+  }
+
   async function fetchSettings() {
     loading.value = true;
     try {
@@ -34,6 +60,12 @@ export const useSettingsStore = defineStore("settings", () => {
   return {
     settings,
     loading,
+    assistantName,
+    defaultModel,
+    voiceEnabled,
+    voiceSttReady,
+    voiceTtsReady,
+    checkVoiceStatus,
     fetchSettings,
     updateSettings,
   };

frontend/src/stores/tasks.ts

@@ -2,15 +2,53 @@ import { ref } from "vue";
 import { defineStore } from "pinia";
 import { apiGet, apiPost, apiPut, apiPatch, apiDelete } from "@/api/client";
 import { useToastStore } from "@/stores/toast";
-import type { Task, TaskStatus, TaskPriority, StartPlanningResult } from "@/types/task";
+import type { Task, TaskListResponse, TaskStatus, TaskPriority } from "@/types/task";
 
-// Single-task + mutation surface. The list/filter/sort/pagination surface that
-// backed the removed /tasks list view was dropped in the 2026-06-02 drift-audit
-// cleanup (no consumers — ProjectView's kanban keeps its own local task list).
 export const useTasksStore = defineStore("tasks", () => {
+  const tasks = ref<Task[]>([]);
   const currentTask = ref<Task | null>(null);
+  const total = ref(0);
   const loading = ref(false);
 
+  // Filter / pagination / sort state
+  const activeTagFilters = ref<string[]>([]);
+  const statusFilter = ref<TaskStatus[]>([]);
+  const priorityFilter = ref<TaskPriority[]>([]);
+  const limit = ref(20);
+  const offset = ref(0);
+  const sortField = ref("updated_at");
+  const sortOrder = ref<"asc" | "desc">("desc");
+  const searchQuery = ref("");
+
+  async function refresh() {
+    loading.value = true;
+    try {
+      const searchParams = new URLSearchParams();
+      if (searchQuery.value) searchParams.set("q", searchQuery.value);
+      for (const t of activeTagFilters.value) {
+        searchParams.append("tag", t);
+      }
+      for (const s of statusFilter.value) searchParams.append("status", s);
+      for (const p of priorityFilter.value) searchParams.append("priority", p);
+      searchParams.set("sort", sortField.value);
+      searchParams.set("order", sortOrder.value);
+      searchParams.set("limit", String(limit.value));
+      searchParams.set("offset", String(offset.value));
+
+      const qs = searchParams.toString();
+      const data = await apiGet<TaskListResponse>(
+        `/api/tasks${qs ? `?${qs}` : ""}`
+      );
+      tasks.value = data.tasks;
+      total.value = data.total;
+    } catch (e) {
+      useToastStore().show("Failed to load tasks", "error");
+      throw e;
+    } finally {
+      loading.value = false;
+    }
+  }
+
   async function fetchTask(id: number) {
     loading.value = true;
     try {
@@ -64,6 +102,10 @@ export const useTasksStore = defineStore("tasks", () => {
   async function patchStatus(id: number, status: TaskStatus): Promise<Task> {
     try {
       const task = await apiPatch<Task>(`/api/tasks/${id}/status`, { status });
+      const idx = tasks.value.findIndex((t) => t.id === id);
+      if (idx !== -1) {
+        tasks.value[idx] = task;
+      }
       if (currentTask.value?.id === id) {
         currentTask.value = task;
       }
@@ -77,6 +119,7 @@ export const useTasksStore = defineStore("tasks", () => {
   async function deleteTask(id: number) {
     try {
       await apiDelete(`/api/tasks/${id}`);
+      tasks.value = tasks.value.filter((t) => t.id !== id);
       if (currentTask.value?.id === id) {
         currentTask.value = null;
       }
@@ -86,29 +129,82 @@ export const useTasksStore = defineStore("tasks", () => {
     }
   }
 
-  async function startPlanning(
-    projectId: number,
-    title: string
-  ): Promise<StartPlanningResult> {
-    try {
-      return await apiPost<StartPlanningResult>("/api/tasks/planning", {
-        project_id: projectId,
-        title,
-      });
-    } catch (e) {
-      useToastStore().show("Failed to start planning", "error");
-      throw e;
+  function setStatusFilter(statuses: TaskStatus[]) {
+    statusFilter.value = statuses;
+    offset.value = 0;
+    refresh();
+  }
+
+  function setPriorityFilter(priorities: TaskPriority[]) {
+    priorityFilter.value = priorities;
+    offset.value = 0;
+    refresh();
+  }
+
+  function addTagFilter(tag: string) {
+    if (!activeTagFilters.value.includes(tag)) {
+      activeTagFilters.value.push(tag);
+      offset.value = 0;
+      refresh();
     }
   }
 
+  function removeTagFilter(tag: string) {
+    activeTagFilters.value = activeTagFilters.value.filter((t) => t !== tag);
+    offset.value = 0;
+    refresh();
+  }
+
+  function clearTagFilters() {
+    activeTagFilters.value = [];
+    offset.value = 0;
+    refresh();
+  }
+
+  function setSort(field: string, order: "asc" | "desc") {
+    sortField.value = field;
+    sortOrder.value = order;
+    offset.value = 0;
+    refresh();
+  }
+
+  function setOffset(newOffset: number) {
+    offset.value = newOffset;
+    refresh();
+  }
+
+  function setSearch(q: string) {
+    searchQuery.value = q;
+    offset.value = 0;
+    refresh();
+  }
+
   return {
+    tasks,
     currentTask,
+    total,
     loading,
+    activeTagFilters,
+    statusFilter,
+    priorityFilter,
+    limit,
+    offset,
+    sortField,
+    sortOrder,
+    searchQuery,
+    refresh,
     fetchTask,
     createTask,
     updateTask,
     patchStatus,
     deleteTask,
-    startPlanning,
+    setStatusFilter,
+    setPriorityFilter,
+    addTagFilter,
+    removeTagFilter,
+    clearTagFilters,
+    setSort,
+    setOffset,
+    setSearch,
   };
 });

frontend/src/stores/trash.ts

@@ -1,53 +0,0 @@
-import { ref } from "vue";
-import { defineStore } from "pinia";
-import * as api from "@/api/trash";
-import type { TrashBatch } from "@/api/trash";
-import { useToastStore } from "@/stores/toast";
-
-export const useTrashStore = defineStore("trash", () => {
-  const batches = ref<TrashBatch[]>([]);
-  const loading = ref(false);
-
-  async function fetchTrash() {
-    loading.value = true;
-    try {
-      batches.value = await api.listTrash();
-    } catch (e) {
-      useToastStore().show("Failed to load trash", "error");
-      throw e;
-    } finally {
-      loading.value = false;
-    }
-  }
-
-  async function restore(batchId: string) {
-    try {
-      await api.restoreBatch(batchId);
-      batches.value = batches.value.filter((b) => b.batch_id !== batchId);
-      useToastStore().show("Restored", "success");
-    } catch (e) {
-      useToastStore().show("Failed to restore", "error");
-      throw e;
-    }
-  }
-
-  async function purge(batchId: string) {
-    try {
-      await api.purgeBatch(batchId);
-      batches.value = batches.value.filter((b) => b.batch_id !== batchId);
-    } catch (e) {
-      useToastStore().show("Failed to delete permanently", "error");
-      throw e;
-    }
-  }
-
-  async function emptyTrash() {
-    const ids = batches.value.map((b) => b.batch_id);
-    for (const id of ids) {
-      await api.purgeBatch(id);
-    }
-    batches.value = [];
-  }
-
-  return { batches, loading, fetchTrash, restore, purge, emptyTrash };
-});

frontend/src/types/chat.ts

@@ -0,0 +1,67 @@
+export interface GenerationTiming {
+  total_ms: number;
+  intent_ms: number | null;
+  ttft_ms: number | null;
+  generation_ms: number | null;
+  tools: Array<{ name: string; ms: number }>;
+}
+
+export interface ToolCallRecord {
+  function: string;
+  arguments: Record<string, unknown>;
+  result: { success: boolean; type?: string; data?: Record<string, unknown>; error?: string; suggested_tags?: string[]; requires_confirmation?: boolean; similar_note?: { id: number; title: string } };
+  status: "running" | "success" | "error" | "declined";
+}
+
+export interface ToolPendingRecord {
+  function: string;
+  arguments: Record<string, unknown>;
+  label?: string;
+}
+
+export interface Message {
+  id: number;
+  conversation_id: number;
+  role: "system" | "user" | "assistant";
+  content: string;
+  status?: "complete" | "generating" | "error";
+  context_note_id: number | null;
+  context_note_title?: string | null;
+  tool_calls?: ToolCallRecord[] | null;
+  metadata?: Record<string, unknown> | null;
+  created_at: string;
+  timing?: GenerationTiming;
+  thinking?: string;
+}
+
+export interface SendMessageResponse {
+  assistant_message_id: number;
+  status: string;
+}
+
+export interface Conversation {
+  id: number;
+  title: string;
+  model: string;
+  message_count: number;
+  rag_project_id: number | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ConversationDetail extends Conversation {
+  messages: Message[];
+}
+
+export interface ContextMeta {
+  context_note_id: number | null;
+  context_note_title: string | null;
+  auto_notes: { id: number; title: string; score?: number | null; auto_injected?: boolean }[];
+  auto_injected_notes?: { id: number; title: string; score?: number | null }[];
+}
+
+export interface OllamaStatus {
+  ollama: "available" | "unavailable";
+  model: "loaded" | "cold" | "not_found";
+  default_model: string;
+}

frontend/src/types/note.ts

@@ -1,13 +1,11 @@
 export type TaskStatus = "todo" | "in_progress" | "done" | "cancelled";
 export type TaskPriority = "none" | "low" | "medium" | "high";
-export type NoteType = "note" | "person" | "place" | "list" | "process";
+export type NoteType = "note" | "person" | "place" | "list";
 
 export interface Note {
   id: number;
   title: string;
   body: string;
-  description: string | null;
-  consolidated_at: string | null;
   tags: string[];
   parent_id: number | null;
   parent_title?: string | null;
@@ -22,7 +20,6 @@ export interface Note {
   recurrence_next_spawn_at: string | null;
   is_task: boolean;
   note_type: NoteType;
-  task_kind?: "work" | "plan";
   metadata: Record<string, string>;
   created_at: string;
   updated_at: string;

frontend/src/types/settings.ts

@@ -1,6 +1,5 @@
-// Settings are free-form string key/value pairs keyed by setting name; the
-// backend has no fixed schema, so this is an open string map. (The former
-// assistant_name/default_model hints were dead after the Phase-8 chat removal.)
 export interface AppSettings {
+  assistant_name?: string;
+  default_model?: string;
   [key: string]: string | undefined;
 }