Add renovate.json

Fix the projects-page pool exhaustion, and cap milestone bars at 10 (#95 )
feat(projects): cap milestone bars at 10, open work first
2026-08-04 04:01:43 +00:00 · 2026-08-02 19:43:00 -04:00 · 2026-08-02 19:38:48 -04:00 · 2026-08-02 19:09:36 -04:00 · 2026-08-02 18:50:04 -04:00 · 2026-08-01 22:53:13 -04:00
487 changed files with 43657 additions and 43350 deletions
@@ -0,0 +1,12 @@
+{
+  "name": "scribe-plugin",
+  "owner": { "name": "Bryan Van Deusen" },
+  "description": "Scribe ships its own Claude Code plugin from this repo, versioned in lockstep with the app + the /api/plugin/context contract.",
+  "plugins": [
+    {
+      "name": "scribe",
+      "source": "./plugin",
+      "description": "Scribe second brain: MCP tools + session-start push channel + universal process-skills."
+    }
+  ]
+}
@@ -1,4 +1,4 @@
 POSTGRES_USER=fabled
 POSTGRES_PASSWORD=fabled
-POSTGRES_DB=fabledassistant
+POSTGRES_DB=scribe
 SECRET_KEY=dev-secret-change-me
@@ -1,12 +1,19 @@
 # CI runs first; build only proceeds if all checks pass.
 #
-# Push to dev:       typecheck + lint + test + build :dev + :<sha>
-# Tag v* (release):  typecheck + lint + test + build :latest + :<sha> + :<version>
+# 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>
 #
-# 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.
+# 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.
 #
 # To cut a release:
 #   Create a release via the Forgejo UI on main with a v* tag name.
@@ -16,11 +23,8 @@
 # gating on branch push is already enough.
 #
 # NOTE on the `if:` guards below: Forgejo Actions does not consistently
-# honor `on.push.branches` as a filter — merge commits landing on main
-# still trigger the workflow, producing redundant runs on the same SHA
-# that was already gated on dev. Every job therefore repeats the ref
-# check so main pushes trigger the workflow but every job skips
-# immediately (no runner time, no duplicate work).
+# honor `on.push.branches` as a filter, so every job repeats the ref check
+# explicitly — permitting dev, main, and v* tags, rejecting anything else.
 #
 # Required secrets (repo → Settings → Secrets → Actions):
 #   REGISTRY_USER   — your Forgejo username
@@ -29,19 +33,36 @@ name: CI & Build

 on:
  push:
-    branches: [dev]
+    branches: [dev, main]
    tags: ["v*"]
    paths:
      - "src/**"
      - "frontend/**"
      - "tests/**"
      - "pyproject.toml"
+      # The lock now determines what gets installed, so a lock-only change has
+      # to trigger a run — otherwise a dependency bump lands untested.
+      - "uv.lock"
      - "alembic/**"
      - "alembic.ini"
      - "Dockerfile"
      - "assets/**"
      - "fable-mcp/**"
+      # The plugin ships straight from this repo — installs fetch it via
+      # .claude-plugin/marketplace.json, NOT from the image. So a push here is
+      # the release, with no build step in between. Omitting these paths meant
+      # plugin changes triggered no workflow at all, which is how #2198's three
+      # broken hooks and then #2209's missing version bump both reached a live
+      # install. See the `plugin` job below.
+      - "plugin/**"
+      - ".claude-plugin/**"
+      - "scripts/check_plugin.py"
      - ".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
@@ -62,14 +83,21 @@ env:
 jobs:
  typecheck:
    name: TypeScript typecheck
-    # 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
+    # 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
    steps:
      - uses: actions/checkout@v6

      - name: Cache npm download cache
        uses: actions/cache@v4
+        # Non-fatal: a transient cache-backend hiccup must NOT fail the whole
+        # typecheck job (it was skipping install + type check and reporting red
+        # on backend-only pushes — see issue task #828). On cache miss/error the
+        # job just installs without the cache.
+        continue-on-error: true
        with:
          path: ~/.npm
          key: npm-cache-${{ hashFiles('frontend/package-lock.json') }}
@@ -83,22 +111,79 @@ jobs:
        run: npx vue-tsc --noEmit
        working-directory: frontend

+  # Guards the one part of this repo that ships to users without a build step.
+  # See scripts/check_plugin.py for what it checks and, as importantly, what it
+  # can't check yet (shellcheck and jq are absent from ci-python).
+  plugin:
+    name: Plugin hooks
+    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
+    steps:
+      # Bare `uses:`, no `with:` block. Adding one made this action fail to
+      # extract on the act_runner ("Cannot find module .../dist/index.js") while
+      # every bare checkout in the same run succeeded — see run 3027. Nothing
+      # here needs `fetch-depth: 0` anyway: the version check diffs two trees,
+      # and a tree diff needs both trees, not a common ancestor. A depth-1 fetch
+      # of main's tip is enough, and cheaper.
+      - uses: actions/checkout@v6
+
+      # Per-job, not in the image, per CI-runner's docs/process.md: "If only one
+      # project needs the dep, prefer that project installing it per-job in
+      # their workflow — at least until a second consumer arrives." Scribe is
+      # the only consumer today. Promotion into ci-python is filed as an issue
+      # on CI-runner rather than assumed here.
+      #
+      # jq is not optional for the smoke test: every hook exits at line 1
+      # without it, so the check would pass while exercising nothing.
+      - name: Install shell tooling
+        run: |
+          apt-get update -qq
+          apt-get install -y -qq --no-install-recommends jq shellcheck
+
+      # On main the comparison would be against itself, so only the syntax and
+      # pattern checks mean anything there.
+      - name: Check plugin hooks and manifest
+        run: |
+          if [ "${{ github.ref }}" = "refs/heads/main" ]; then
+            python3 scripts/check_plugin.py --no-version
+          else
+            git fetch --no-tags --depth=1 origin main:refs/remotes/origin/main
+            python3 scripts/check_plugin.py
+          fi
+
  lint:
    name: Python lint
-    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: ci-runner
+    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
    steps:
      - uses: actions/checkout@v6

-      # ruff is pre-installed in the ci-runner base image — no install
+      # ruff is pre-installed in the ci-python image — no install
      # step needed, lint runs in ~2s.
      - name: Lint
-        run: ruff check src/
+        run: ruff check src/ scripts/
+
+      # Design tokens: does the frontend's CSS agree with the stylesheet the
+      # design system generates? Fails only on an unresolvable var() reference —
+      # that count is at zero, so this is a ratchet rather than a backlog. The
+      # literal findings are printed, not gated; hundreds exist and a
+      # permanently-red job is one nobody reads.
+      #
+      # Stdlib only, no install, no network: the source of truth is theme.css,
+      # which is generated from the design system and committed.
+      - name: Design token check
+        run: python3 scripts/check_design_tokens.py --report-literals

  test:
    name: Python tests
-    if: github.ref == 'refs/heads/dev' || startsWith(github.ref, 'refs/tags/v')
-    runs-on: ci-runner
+    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
    steps:
      - uses: actions/checkout@v6

@@ -106,33 +191,118 @@ jobs:
        uses: actions/cache@v4
        with:
          path: ~/.cache/uv
-          key: uv-${{ hashFiles('pyproject.toml') }}
+          # Keyed on the LOCK, not pyproject: the lock is what determines the
+          # installed set now, and a pyproject edit that doesn't change
+          # resolution shouldn't throw the cache away.
+          key: uv-${{ hashFiles('uv.lock') }}
          restore-keys: uv-

-      - name: Create virtual environment
-        run: uv venv /opt/venv
-
-      - name: Install package with dev deps
-        run: |
-          # http-ece doesn't declare setuptools as a build dep, and uv
-          # creates bare venvs without it. Install setuptools first so
-          # --no-build-isolation can find it.
-          uv pip install --python /opt/venv/bin/python setuptools wheel
-          uv pip install --python /opt/venv/bin/python --no-build-isolation http-ece
-          uv pip install --python /opt/venv/bin/python -e ".[dev]"
+      # Installs exactly what uv.lock pins, and resolves nothing itself.
+      #
+      # This replaced `uv pip install -e ".[dev]"`, which resolved from the
+      # pyproject constraints and ignored the lock entirely. Every dependency
+      # floated: on 2026-07-28 mcp 2.0.0 shipped mid-session and turned `main`
+      # red with no repo change (issue #2194). Green CI has to mean "these exact
+      # versions passed", or it isn't evidence of anything.
+      #
+      # `--locked` also FAILS when uv.lock is stale against pyproject, so a
+      # dependency edit has to go through a deliberate `uv lock` — it can't
+      # arrive on its own. That check earned its place immediately: it caught
+      # that the lock had been missing `pgvector` entirely (added to pyproject,
+      # never re-locked), which the old install path had been silently papering
+      # over by resolving from pyproject instead.
+      - name: Install locked dependencies
+        env:
+          UV_PROJECT_ENVIRONMENT: /opt/venv
+        run: uv sync --locked --extra dev

      - name: Run tests
-        run: /opt/venv/bin/python -m pytest tests/ -q
+        # Integration tests (real Postgres) run in the `integration` job below.
+        run: /opt/venv/bin/python -m pytest tests/ -q -m "not integration"
+
+  # Real-Postgres lane (family rule 6). Exercises the async SQLAlchemy connection
+  # path the unit stubs can't reach — the un-awaited execution_options regression
+  # that made every VACUUM report 0/6 lived here. Like `test`, it runs for
+  # visibility and does NOT gate the build.
+  #
+  # Job key stays separator-free ("integration"): act_runner derives the service-
+  # container name from the (truncated) job display name and the discovery step
+  # filters `docker ps` by it. Service hostnames aren't routable on this runner,
+  # so the step resolves the Postgres container's bridge IP. No `name:` on purpose.
+  integration:
+    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
+    env:
+      # Config + the module engine read these at import time. DATABASE_URL itself
+      # is built from the discovered service IP in the run step.
+      SECRET_KEY: ci_integration_placeholder
+    services:
+      postgres:
+        # pgvector image so `alembic upgrade head` can run migration 0067
+        # (CREATE EXTENSION vector). PG17 — matches the prod/quickstart image.
+        image: pgvector/pgvector:pg17
+        env:
+          POSTGRES_USER: scribe
+          POSTGRES_PASSWORD: ci_integration
+          POSTGRES_DB: scribe_test
+        options: >-
+          --health-cmd "pg_isready -U scribe"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 10
+    steps:
+      - uses: actions/checkout@v6
+      # Same locked install as the unit lane — the two must agree on versions,
+      # or "unit green, integration red" stops being a signal about the code.
+      - name: Install locked dependencies
+        env:
+          UV_PROJECT_ENVIRONMENT: /opt/venv
+        run: uv sync --locked --extra dev
+      - name: Integration suite (resolve service IP, migrate, test)
+        run: |
+          set -eux
+          echo "=== container landscape (diagnostic for the name filter) ==="
+          docker ps -a --format '{{.ID}} {{.Image}} -> {{.Names}}'
+          PG=$(docker ps --filter "name=integration" --filter "ancestor=pgvector/pgvector:pg17" -q | head -n1)
+          test -n "$PG"
+          PG_IP=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$PG")
+          test -n "$PG_IP"
+          export DATABASE_URL="postgresql+asyncpg://scribe:ci_integration@${PG_IP}:5432/scribe_test"
+          # Wait for Postgres to accept connections (busybox sh — the runner
+          # default — has no bash /dev/tcp, so use Python).
+          /opt/venv/bin/python - "$PG_IP" <<'PY'
+          import socket, sys, time
+          for _ in range(30):
+              try:
+                  socket.create_connection((sys.argv[1], 5432), timeout=2).close()
+                  break
+              except OSError:
+                  time.sleep(1)
+          else:
+              sys.exit("postgres did not become reachable")
+          PY
+          # Real migrations build the schema; the maintenance tests then run
+          # VACUUM (ANALYZE) and read pg_stat_user_tables against it.
+          /opt/venv/bin/alembic upgrade head
+          /opt/venv/bin/python -m pytest tests/ -v -m integration

  build:
    name: Build & push image
+    # `plugin` is deliberately NOT in needs. The plugin isn't in the image —
+    # installs fetch it from git — so gating the server image on a hook lint
+    # would couple two things that don't ship together, and blocking the build
+    # wouldn't un-publish a bad hook anyway: the push already did that. A failed
+    # `plugin` job still turns the whole run red, which is the signal that
+    # matters.
    needs: [typecheck, lint, test]
-    # 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
+    # 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
    permissions:
      contents: read
      packages: write
@@ -141,15 +311,31 @@ 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"
-          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
+          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
          echo "value=$TAGS" >> $GITHUB_OUTPUT
          echo "build_version=$BUILD_VERSION" >> $GITHUB_OUTPUT

@@ -1 +1 @@
-3158517
+1425947
@@ -8,29 +8,33 @@ COPY frontend/ .
 RUN npm run build

 # Stage 2: Python runtime
-FROM python:3.12-slim AS runtime
+# Tracks CI image (ci-python:3.14) so test results stay representative.
+FROM python:3.14-slim AS runtime
 WORKDIR /app

-COPY pyproject.toml .
+# Installed from uv.lock, exactly like CI (issue #2194). This used to be
+# `COPY pyproject.toml .` + `pip install .`, which never even copied the lock:
+# the shipped image resolved its own dependency set, so CI could be green on one
+# set of versions while the published image ran another. On 2026-07-28 that
+# class of drift turned `main` red when mcp 2.0.0 shipped mid-session.
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install --no-cache-dir uv
+
+# Dependencies before source, so the expensive layer is cached on every build
+# that doesn't change the lock.
+COPY pyproject.toml uv.lock ./
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev --no-install-project
+
 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
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev

-# 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/
+# uv sync installs into a project venv rather than the system interpreter, so
+# alembic and hypercorn in CMD have to be found there.
+ENV PATH="/app/.venv/bin:$PATH"

-COPY --from=build-frontend /build/dist/ src/fabledassistant/static/
+COPY --from=build-frontend /build/dist/ src/scribe/static/
 COPY alembic.ini .
 COPY alembic/ alembic/

@@ -43,4 +47,4 @@ ARG BUILD_VERSION=dev
 ENV APP_VERSION=$BUILD_VERSION

 EXPOSE 5000
-CMD ["sh", "-c", "alembic upgrade head && hypercorn 'fabledassistant.app:create_app()' --bind 0.0.0.0:5000 --keep-alive 600"]
+CMD ["sh", "-c", "alembic upgrade head && hypercorn 'scribe.app:create_app()' --bind 0.0.0.0:5000 --keep-alive 600"]
@@ -1,14 +1,14 @@
 # Fabled Scribe

-A self-hosted second brain and project management application with integrated LLM capabilities. Write, organise, and act on your notes and tasks with the help of a local AI assistant — all running on your own hardware.
+A self-hosted work system-of-record for software projects, built to be driven by Claude Code. Notes, tasks, issues, projects, milestones, rules, and stored processes — reachable from Claude via a built-in MCP endpoint and a bundled Claude Code plugin, with a clean web UI for humans. No in-app LLM; Claude is the sole assistant.

 ## 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, an MCP server for external AI clients, and an Android companion app.
+Notes and tasks with a Markdown editor, sub-tasks, milestones, issues, and kanban project workspaces. Stored processes, an engineering rulebook system, and semantic search with proactive knowledge-injection into Claude's context. A knowledge graph, per-user/group sharing, and a built-in MCP server (`/mcp`) plus a bundled Claude Code plugin so Claude can record and recall your work directly.

 ## Quick Start

-**Prerequisites:** Docker and Docker Compose. 8 GB+ RAM recommended for LLM inference.
+**Prerequisites:** Docker and Docker Compose. No GPU or local model needed — Claude is the sole assistant, reached over MCP.

 Download [`docker-compose.quickstart.yml`](docker-compose.quickstart.yml) from this repo, then:

@@ -19,9 +19,7 @@ export SECRET_KEY=your-random-secret-here
 docker compose -f docker-compose.quickstart.yml up -d
 ```

-Open `http://localhost:5000`. The first user to register becomes admin. Go to **Settings → General** to pull an LLM model — `qwen3:8b` or `llama3.1:8b` are good starting points.
-
-> **GPU:** Ollama runs CPU-only by default. See the comments in `docker-compose.quickstart.yml` to enable NVIDIA GPU passthrough.
+Open `http://localhost:5000`. The first user to register becomes admin. To connect Claude, create an API key under **Settings → API Keys** and install the Claude Code plugin — see [API Keys & MCP](docs/api-keys-and-mcp.md).

 > **Development:** To build from source, see [Development](docs/development.md).

@@ -36,7 +34,6 @@ 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

@@ -4,8 +4,8 @@ from logging.config import fileConfig
 from alembic import context
 from sqlalchemy.ext.asyncio import create_async_engine

-from fabledassistant.config import Config
-from fabledassistant.models import Base
+from scribe.config import Config
+from scribe.models import Base

 config = context.config
 if config.config_file_name is not None:
@@ -0,0 +1,48 @@
+"""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")
@@ -0,0 +1,35 @@
+"""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")
@@ -0,0 +1,103 @@
+"""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")
@@ -0,0 +1,38 @@
+"""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
@@ -0,0 +1,47 @@
+"""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")
@@ -0,0 +1,36 @@
+"""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")
@@ -0,0 +1,27 @@
+"""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
@@ -0,0 +1,98 @@
+"""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")
@@ -0,0 +1,33 @@
+"""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")
@@ -0,0 +1,82 @@
+"""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."
+    )
@@ -0,0 +1,26 @@
+"""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."
+    )
@@ -0,0 +1,153 @@
+"""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")
@@ -0,0 +1,35 @@
+"""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")
@@ -0,0 +1,38 @@
+"""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")
@@ -0,0 +1,39 @@
+"""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")
@@ -0,0 +1,49 @@
+"""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")
@@ -0,0 +1,73 @@
+"""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")
@@ -0,0 +1,49 @@
+"""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"]
+    )
@@ -0,0 +1,41 @@
+"""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),
+    )
@@ -0,0 +1,34 @@
+"""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),
+    )
@@ -0,0 +1,58 @@
+"""repo -> project bindings
+
+Revision ID: 0064
+Revises: 0063
+Create Date: 2026-06-10
+
+Maps a git repository (by its normalized remote, `repo_key`) to the Scribe
+project it represents, so the SessionStart hook can resolve the active project
+from the working repo instead of a project id pinned in plugin config. FKs
+CASCADE so deleting a user or project removes the stale binding automatically.
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0064"
+down_revision = "0063"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "repo_bindings",
+        sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True),
+        sa.Column(
+            "user_id",
+            sa.BigInteger(),
+            sa.ForeignKey("users.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "project_id",
+            sa.BigInteger(),
+            sa.ForeignKey("projects.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("repo_key", sa.Text(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.UniqueConstraint("user_id", "repo_key", name="uq_repo_bindings_user_repo"),
+    )
+    op.create_index("ix_repo_bindings_user_id", "repo_bindings", ["user_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_repo_bindings_user_id", table_name="repo_bindings")
+    op.drop_table("repo_bindings")
@@ -0,0 +1,103 @@
+"""issues + systems: task_kind=issue, systems, record_systems, arose_from_id
+
+Revision ID: 0065
+Revises: 0064
+Create Date: 2026-06-14
+
+Adds the corrective-work 'issue' task_kind (same-change CHECK expand per the
+'new CHECK-enum values need a same-change migration' rule), a per-project
+self-describing System entity, a many-to-many record<->system join (any
+note/task/issue), and an issue->originating-task provenance FK.
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0065"
+down_revision = "0064"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # 1. task_kind gains 'issue' (corrective work). DROP+ADD the CHECK in the
+    #    same change that introduces the value.
+    op.drop_constraint("notes_task_kind_check", "notes", type_="check")
+    op.create_check_constraint(
+        "notes_task_kind_check", "notes", "task_kind IN ('work','plan','issue')",
+    )
+
+    # 2. Provenance: an issue can point back at the task/feature it arose from.
+    #    Distinct from parent_id (sub-task hierarchy).
+    op.add_column("notes", sa.Column("arose_from_id", sa.Integer(), nullable=True))
+    op.create_foreign_key(
+        "fk_notes_arose_from_id", "notes", "notes",
+        ["arose_from_id"], ["id"], ondelete="SET NULL",
+    )
+    op.create_index("ix_notes_arose_from_id", "notes", ["arose_from_id"])
+
+    # 3. systems: per-project, reusable, self-describing subsystem/area.
+    op.create_table(
+        "systems",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "user_id", sa.Integer(),
+            sa.ForeignKey("users.id", ondelete="CASCADE"), nullable=False,
+        ),
+        sa.Column(
+            "project_id", sa.Integer(),
+            sa.ForeignKey("projects.id", ondelete="CASCADE"), nullable=False,
+        ),
+        sa.Column("name", sa.Text(), nullable=False, server_default=""),
+        sa.Column("description", sa.Text(), nullable=True),
+        sa.Column("color", sa.Text(), nullable=True),
+        sa.Column("status", sa.Text(), nullable=False, server_default="active"),
+        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.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("deleted_batch_id", sa.Text(), nullable=True),
+    )
+    op.create_index("ix_systems_project_id", "systems", ["project_id"])
+    op.create_check_constraint(
+        "systems_status_check", "systems", "status IN ('active','archived')",
+    )
+
+    # 4. record_systems: M2M join — any note/task/issue <-> system.
+    op.create_table(
+        "record_systems",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "note_id", sa.Integer(),
+            sa.ForeignKey("notes.id", ondelete="CASCADE"), nullable=False,
+        ),
+        sa.Column(
+            "system_id", sa.Integer(),
+            sa.ForeignKey("systems.id", ondelete="CASCADE"), nullable=False,
+        ),
+        sa.Column(
+            "created_at", sa.DateTime(timezone=True), nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.UniqueConstraint("note_id", "system_id", name="uq_record_systems_note_system"),
+    )
+    op.create_index("ix_record_systems_note_id", "record_systems", ["note_id"])
+    op.create_index("ix_record_systems_system_id", "record_systems", ["system_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("record_systems")
+    op.drop_table("systems")
+    op.drop_index("ix_notes_arose_from_id", table_name="notes")
+    op.drop_constraint("fk_notes_arose_from_id", "notes", type_="foreignkey")
+    op.drop_column("notes", "arose_from_id")
+    op.drop_constraint("notes_task_kind_check", "notes", type_="check")
+    op.create_check_constraint(
+        "notes_task_kind_check", "notes", "task_kind IN ('work','plan')",
+    )
@@ -0,0 +1,32 @@
+"""milestone-as-plan-container: milestones.body holds the plan/design
+
+Revision ID: 0066
+Revises: 0065
+Create Date: 2026-06-14
+
+T3 of plan #819. The milestone becomes the plan container: its `body` holds
+the design/intent/purpose (markdown), `description` stays the one-liner, and
+individual steps live as first-class child tasks (milestone_id) instead of
+checkboxes crammed into a kind=plan task body. start_planning is reworked to
+create a milestone instead of a kind=plan task (hard retirement going forward;
+the 'plan' task_kind enum value stays valid so the historical plan-tasks are
+left readable in place — no body-shredding backfill).
+
+Schema change is just one nullable column; no data migration.
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0066"
+down_revision = "0065"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("milestones", sa.Column("body", sa.Text(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("milestones", "body")
@@ -0,0 +1,73 @@
+"""pgvector: note_embeddings.embedding JSONB -> vector(384) + HNSW index
+
+Revision ID: 0067
+Revises: 0066
+Create Date: 2026-06-22
+
+Moves semantic search off the full-table Python cosine scan onto a native
+pgvector column so ranking + top-k run as an indexed `ORDER BY embedding <=> :q
+LIMIT k` in Postgres (see services/embeddings.semantic_search_notes).
+
+Requires a Postgres image that bundles the `vector` extension — the stack moved
+from postgres:16-alpine to pgvector/pgvector:pg16 in the same change (compose +
+CI). `CREATE EXTENSION IF NOT EXISTS vector` below is the in-db half.
+
+Embeddings are DERIVED data (regenerated from note text by
+backfill_note_embeddings at startup), so this migration is free to drop any row
+it can't cleanly convert: only rows whose stored JSONB array is exactly 384-dim
+are carried over (guarding against stale vectors from an earlier model — the
+same mixed-dim hazard _cosine_similarity defended against). Dropped rows are
+re-embedded on next boot.
+"""
+from alembic import op
+
+
+revision = "0067"
+down_revision = "0066"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.execute("CREATE EXTENSION IF NOT EXISTS vector")
+
+    # New native-vector column, populated only from cleanly-convertible rows.
+    # A JSONB array like [0.1, 0.2, ...] renders to text that is exactly
+    # pgvector's input literal, so (embedding::text)::vector is a direct cast.
+    op.execute("ALTER TABLE note_embeddings ADD COLUMN embedding_vec vector(384)")
+    op.execute(
+        """
+        UPDATE note_embeddings
+           SET embedding_vec = (embedding::text)::vector
+         WHERE jsonb_array_length(embedding) = 384
+        """
+    )
+    # Stale-dim rows (couldn't convert) are derived data — drop and let the
+    # startup backfill regenerate them at the current dimension.
+    op.execute("DELETE FROM note_embeddings WHERE embedding_vec IS NULL")
+
+    op.execute("ALTER TABLE note_embeddings ALTER COLUMN embedding_vec SET NOT NULL")
+    op.execute("ALTER TABLE note_embeddings DROP COLUMN embedding")
+    op.execute("ALTER TABLE note_embeddings RENAME COLUMN embedding_vec TO embedding")
+
+    # HNSW index for cosine distance — matches Vector.cosine_distance (`<=>`).
+    op.execute(
+        """
+        CREATE INDEX ix_note_embeddings_embedding_hnsw
+            ON note_embeddings
+         USING hnsw (embedding vector_cosine_ops)
+        """
+    )
+
+
+def downgrade() -> None:
+    # Back to JSONB. pgvector renders a vector to a text literal that is a valid
+    # JSON array, so the reverse cast is symmetric. The `vector` extension is
+    # intentionally left installed (other objects may depend on it; dropping an
+    # extension is the riskier, rarely-wanted direction).
+    op.execute("DROP INDEX IF EXISTS ix_note_embeddings_embedding_hnsw")
+    op.execute("ALTER TABLE note_embeddings ADD COLUMN embedding_json jsonb")
+    op.execute("UPDATE note_embeddings SET embedding_json = (embedding::text)::jsonb")
+    op.execute("ALTER TABLE note_embeddings ALTER COLUMN embedding_json SET NOT NULL")
+    op.execute("ALTER TABLE note_embeddings DROP COLUMN embedding")
+    op.execute("ALTER TABLE note_embeddings RENAME COLUMN embedding_json TO embedding")
@@ -0,0 +1,60 @@
+"""retrieval_logs: per-call semantic-retrieval telemetry for KB-injection tuning
+
+Revision ID: 0068
+Revises: 0067
+Create Date: 2026-06-22
+
+One row per semantic-retrieval call (MCP search tool, REST search route, and —
+once it lands — the title-first auto-inject path). Captures the effective query
+params and the score distribution of the results so the similarity threshold
+and top-k can be tuned from real usage. FK-free on user_id (mirrors app_logs):
+telemetry should outlive the row it describes.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB
+
+
+revision = "0068"
+down_revision = "0067"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "retrieval_logs",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "created_at", sa.DateTime(timezone=True), nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column("user_id", sa.Integer(), nullable=True),
+        sa.Column("source", sa.Text(), nullable=False),
+        sa.Column("query", sa.Text(), nullable=True),
+        sa.Column("threshold", sa.Float(), nullable=True),
+        sa.Column("limit_n", sa.Integer(), nullable=True),
+        sa.Column("project_id", sa.Integer(), nullable=True),
+        sa.Column("is_task", sa.Boolean(), nullable=True),
+        sa.Column("result_count", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("top_score", sa.Float(), nullable=True),
+        sa.Column("min_score", sa.Float(), nullable=True),
+        sa.Column("result_ids", JSONB(), nullable=False, server_default=sa.text("'[]'::jsonb")),
+        sa.Column("duration_ms", sa.Float(), nullable=True),
+    )
+    op.create_index("ix_retrieval_logs_created_at", "retrieval_logs", ["created_at"])
+    op.create_index("ix_retrieval_logs_user_id", "retrieval_logs", ["user_id"])
+    op.create_index("ix_retrieval_logs_source", "retrieval_logs", ["source"])
+    op.create_index(
+        "ix_retrieval_logs_source_created_at",
+        "retrieval_logs",
+        ["source", sa.text("created_at DESC")],
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_retrieval_logs_source_created_at", table_name="retrieval_logs")
+    op.drop_index("ix_retrieval_logs_source", table_name="retrieval_logs")
+    op.drop_index("ix_retrieval_logs_user_id", table_name="retrieval_logs")
+    op.drop_index("ix_retrieval_logs_created_at", table_name="retrieval_logs")
+    op.drop_table("retrieval_logs")
@@ -0,0 +1,82 @@
+"""drop events table + notes.metadata column (retire calendar + entity surfaces)
+
+Revision ID: 0069
+Revises: 0068
+Create Date: 2026-07-19
+
+The personal-assistant surfaces (calendar/events + CalDAV, and the typed
+person/place/list entities that stored structured fields in notes.metadata)
+were removed when Scribe narrowed to a Claude-Code work system-of-record.
+This migration drops their storage:
+
+  - the `events` table (all calendar/CalDAV data)
+  - the `notes.metadata` (entity_meta) JSONB column — it only ever held
+    person/place/list structured fields. The `note_type` column STAYS: it
+    also distinguishes 'process' notes.
+  - orphan CalDAV settings rows (nothing reads them after the removal)
+
+Downgrade recreates the table + column structure at its pre-removal shape.
+The dropped data itself is not recoverable.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB
+
+
+revision = "0069"
+down_revision = "0068"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # Entity metadata column (person/place/list structured fields). The
+    # note_type column is intentionally kept — it also marks 'process' notes.
+    op.drop_column("notes", "metadata")
+
+    # Calendar / CalDAV storage. Dropping the table drops its indexes + the
+    # duration CHECK constraint with it.
+    op.drop_table("events")
+
+    # Orphan CalDAV integration settings — no code reads them post-removal.
+    op.execute("DELETE FROM settings WHERE key LIKE 'caldav%'")
+
+
+def downgrade() -> None:
+    # Recreate the events table at its pre-removal schema (empty — the data is
+    # gone). Mirrors the model as of 0037 (reminders) + 0043 (duration_minutes)
+    # + 0057 (soft-delete columns/index).
+    op.create_table(
+        "events",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("user_id", sa.Integer(),
+                  sa.ForeignKey("users.id", ondelete="CASCADE"), nullable=False),
+        sa.Column("project_id", sa.Integer(),
+                  sa.ForeignKey("projects.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("uid", sa.Text(), nullable=False),
+        sa.Column("title", sa.Text(), nullable=False, server_default=""),
+        sa.Column("start_dt", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("duration_minutes", sa.Integer(), nullable=True),
+        sa.Column("all_day", sa.Boolean(), nullable=False, server_default=sa.false()),
+        sa.Column("description", sa.Text(), nullable=False, server_default=""),
+        sa.Column("location", sa.Text(), nullable=False, server_default=""),
+        sa.Column("caldav_uid", sa.Text(), nullable=False, server_default=""),
+        sa.Column("color", sa.Text(), nullable=False, server_default=""),
+        sa.Column("recurrence", sa.Text(), nullable=True),
+        sa.Column("reminder_minutes", sa.Integer(), nullable=True),
+        sa.Column("reminder_sent_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("created_at", sa.DateTime(timezone=True),
+                  nullable=False, server_default=sa.func.now()),
+        sa.Column("updated_at", sa.DateTime(timezone=True),
+                  nullable=False, server_default=sa.func.now()),
+        sa.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("deleted_batch_id", sa.Text(), nullable=True),
+        sa.CheckConstraint(
+            "duration_minutes IS NULL OR duration_minutes >= 0",
+            name="events_duration_minutes_non_negative",
+        ),
+    )
+    op.create_index("ix_events_deleted_at", "events", ["deleted_at"])
+
+    # Re-add the entity metadata column.
+    op.add_column("notes", sa.Column("metadata", JSONB(), nullable=True))
@@ -0,0 +1,60 @@
+"""add notes.data JSONB — queryable structured fields for typed records
+
+Revision ID: 0070
+Revises: 0069
+Create Date: 2026-07-26
+
+Snippets (note_type='snippet') carry structured fields — name, language,
+signature, and a list of canonical locations (repo · path · symbol). Those were
+stored as a markdown body-convention, which reads well and feeds the embedding
+but cannot be QUERIED: answering "which snippets live in this file?" meant
+scanning every snippet and regexing its body.
+
+This adds a general `data` JSONB column plus a GIN index, so those fields become
+indexable. The body stays exactly as it was — it is still the human-readable
+form and still what gets embedded. `data` is a queryable mirror of the same
+facts, not a replacement, and the code itself is deliberately NOT copied into it
+(the body already holds it; duplicating a blob to index fields around it would
+be waste).
+
+Relationship to 0069: that migration DROPPED `notes.metadata`, a JSONB column
+which only ever held person/place/list entity fields, when those surfaces were
+removed. This is not a revival of it — different name, different purpose, and
+nothing reads the old shape. The column is named `data` rather than `metadata`
+because `metadata` collides with SQLAlchemy's declarative `Base.metadata`, which
+is why the old model had to map an awkward `entity_metadata` attribute onto it.
+
+Nullable with no backfill, deliberately: rows written before this migration keep
+working because the service falls back to parsing the body when `data` is
+absent. That means no migration deadline and no risk of a backfill mangling a
+hand-edited body.
+
+Downgrade drops the index and the column. Any structured fields it held remain
+recoverable from the body convention, which is the same source they mirror.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB
+
+
+revision = "0070"
+down_revision = "0069"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("notes", sa.Column("data", JSONB, nullable=True))
+    # GIN supports containment (`data @> '{"locations":[{"repo":"x"}]}'`), which
+    # covers exact repo/path/symbol and language lookups. Path PREFIX matching
+    # ("everything under frontend/src/") is not an index-served operation here
+    # and still filters after the fact — acceptable while snippet counts are
+    # small, and a generated column is the escape hatch if that changes.
+    op.create_index(
+        "ix_notes_data_gin", "notes", ["data"], postgresql_using="gin",
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_notes_data_gin", table_name="notes")
+    op.drop_column("notes", "data")
@@ -0,0 +1,72 @@
+"""add note_usage_events — did anyone actually open what we surfaced?
+
+Revision ID: 0071
+Revises: 0070
+Create Date: 2026-07-28
+
+`retrieval_logs` records what the ranker returned and with what scores, which is
+the right substrate for tuning a similarity threshold. It cannot answer the
+different question the snippet corpus needs: was a surfaced snippet ever pulled
+in full? A snippet nobody opens still competes for the injection budget on every
+turn, so the surfaced:pulled ratio is what makes dead weight visible.
+
+Two reasons this is its own table rather than columns on `notes` or rows in
+`retrieval_logs`:
+
+  - Counters on `notes` would answer "how many" but not "when, from where, and
+    by which arm" — and the place arm vs semantic arm comparison is precisely
+    what was missing (the write-path place arm surfaced snippets while leaving
+    no trace anywhere).
+  - Folding un-scored surfacing into `retrieval_logs` would corrupt the score
+    distribution that table exists to capture. Location hits have no score.
+
+Grain is one row per note per event, which is what the per-snippet readout needs
+and what `retrieval_logs.result_ids` (a JSONB array, one row per *call*) cannot
+be indexed at.
+
+FK-free on note_id and user_id, matching retrieval_logs and app_logs: telemetry
+should outlive what it describes. Deleting a note must not erase the evidence
+that it was surfaced forty times and opened none.
+
+Downgrade drops the table outright. The data is purely observational — nothing
+reads it for correctness, so losing it costs history and no behavior.
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0071"
+down_revision = "0070"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "note_usage_events",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            nullable=False,
+            server_default=sa.text("now()"),
+        ),
+        sa.Column("user_id", sa.Integer(), nullable=True),
+        sa.Column("note_id", sa.Integer(), nullable=False),
+        sa.Column("event", sa.Text(), nullable=False),
+        sa.Column("source", sa.Text(), nullable=False),
+    )
+    # Every readout is "these note ids, split by event", so the composite is the
+    # one that actually gets used; the others serve pruning and per-user views.
+    op.create_index(
+        "ix_note_usage_note_event", "note_usage_events", ["note_id", "event"]
+    )
+    op.create_index("ix_note_usage_created_at", "note_usage_events", ["created_at"])
+    op.create_index("ix_note_usage_user_id", "note_usage_events", ["user_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_note_usage_user_id", table_name="note_usage_events")
+    op.drop_index("ix_note_usage_created_at", table_name="note_usage_events")
+    op.drop_index("ix_note_usage_note_event", table_name="note_usage_events")
+    op.drop_table("note_usage_events")
@@ -0,0 +1,138 @@
+"""design systems + tokens, and the project pointer
+
+Revision ID: 0072
+Revises: 0071
+Create Date: 2026-07-30
+
+Makes the design system a first-class record instead of prose in a rulebook: a
+named set of tokens with an optional parent, so a family system holds the house
+style and an app system holds only what it changes.
+
+`design_systems.parent_id` is the whole model. It replaces both an `always_on`
+flag (a family system is one with no parent) and a subscription join table (a
+project points at ONE system, and the chain supplies the rest), which is less
+schema than the rulebook shape it mirrors.
+
+Two deliberate choices worth stating here rather than leaving to be re-derived:
+
+  - **`design_tokens.value_by_mode` is JSONB keyed by mode**, not `value_light` +
+    `value_dark` columns. In a child system an unset mode means "inherit"; in a
+    root it would mean "not mode-dependent", and as columns both are NULL and
+    indistinguishable. As a map, resolution is a dict merge at every level with
+    no special case for roots — and a third mode (high-contrast, print) is data
+    rather than a schema change. The cost is that a typo'd mode key is not
+    rejected by the database. Nothing filters tokens by value in SQL, so the
+    queryability the columns would have bought is for a query no caller makes.
+    (Named `value_by_mode` rather than `values`, which is reserved in SQL.)
+  - **`group_name` is free text, not a CHECK enum.** Groupings are each design
+    system's own vocabulary; a whitelist would bake one install's kit into the
+    schema. No CHECK is introduced anywhere in this migration.
+
+`parent_id` and `projects.design_system_id` are both ON DELETE SET NULL. Deleting
+a family system must orphan its children into roots that still hold their own
+overrides, not cascade away every app system that inherited from it; deleting a
+system a project points at must unstyle that project, not delete it.
+
+Downgrade drops both tables and the column. Any design system defined this way
+is lost — this is the migration that introduces the concept, so there is no
+earlier representation to fall back to.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB
+
+
+revision = "0072"
+down_revision = "0071"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "design_systems",
+        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(), nullable=True),
+        sa.Column(
+            "parent_id", sa.BigInteger(),
+            sa.ForeignKey("design_systems.id", ondelete="SET NULL"), nullable=True,
+        ),
+        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.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("deleted_batch_id", sa.Text(), nullable=True),
+    )
+    op.create_index(
+        "ix_design_systems_owner_user_id", "design_systems", ["owner_user_id"]
+    )
+    op.create_index("ix_design_systems_parent_id", "design_systems", ["parent_id"])
+
+    op.create_table(
+        "design_tokens",
+        sa.Column("id", sa.BigInteger(), primary_key=True),
+        sa.Column(
+            "design_system_id", sa.BigInteger(),
+            sa.ForeignKey("design_systems.id", ondelete="CASCADE"), nullable=False,
+        ),
+        sa.Column("name", sa.Text(), nullable=False),
+        # NOT NULL with a '{}' default: a nullable JSONB column has two empty
+        # states (SQL NULL and JSON null) and every reader has to test for both.
+        sa.Column(
+            "value_by_mode", JSONB,
+            nullable=False, server_default=sa.text("'{}'::jsonb"),
+        ),
+        sa.Column("group_name", sa.Text(), nullable=True),
+        sa.Column("purpose", sa.Text(), nullable=True),
+        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.Column("deleted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("deleted_batch_id", sa.Text(), nullable=True),
+    )
+    op.create_index(
+        "ix_design_tokens_design_system_id", "design_tokens", ["design_system_id"]
+    )
+    # Partial unique: a name is unique among LIVE tokens in a system. Two live
+    # rows with the same name are a duplicate definition and the cascade would
+    # pick between them arbitrarily; a trashed row must not block reusing its
+    # name.
+    op.create_index(
+        "uq_token_per_design_system", "design_tokens", ["design_system_id", "name"],
+        unique=True, postgresql_where=sa.text("deleted_at IS NULL"),
+    )
+
+    op.add_column(
+        "projects", sa.Column("design_system_id", sa.BigInteger(), nullable=True)
+    )
+    op.create_foreign_key(
+        "fk_projects_design_system_id", "projects", "design_systems",
+        ["design_system_id"], ["id"], ondelete="SET NULL",
+    )
+
+
+def downgrade() -> None:
+    op.drop_constraint("fk_projects_design_system_id", "projects", type_="foreignkey")
+    op.drop_column("projects", "design_system_id")
+    op.drop_index("uq_token_per_design_system", table_name="design_tokens")
+    op.drop_index("ix_design_tokens_design_system_id", table_name="design_tokens")
+    op.drop_table("design_tokens")
+    op.drop_index("ix_design_systems_parent_id", table_name="design_systems")
+    op.drop_index("ix_design_systems_owner_user_id", table_name="design_systems")
+    op.drop_table("design_systems")
@@ -0,0 +1,55 @@
+"""design_tokens.supersedes — the literals a token should be used instead of
+
+Revision ID: 0073
+Revises: 0072
+Create Date: 2026-07-30
+
+Records what a prohibition was actually trying to say.
+
+A design rulebook writes "pure white #FFFFFF is NEVER used as text color". That
+sentence has no row in a table of tokens, because a design system stores what
+things ARE — which looked like a gap in the model and was really a sentence
+written backwards. The positive fact is "text is Parchment", and the useful
+record is the mapping from the literal someone would otherwise write to the
+token they should write instead.
+
+So `supersedes` is a JSONB array of literal values, e.g. `["#fff", "#ffffff"]`
+on a text-on-action token. A finding built from it can say what to write, not
+merely what not to.
+
+It must be DECLARED rather than derived. `#fff` and Parchment `#E8E4D8` are
+different colours, so no value-matching rule could ever have connected them —
+which is exactly why the prohibition felt unrepresentable until it was turned
+around.
+
+Consumed by the source lint that reads component CSS, not by the drift panel:
+these literals are in the components, which the panel cannot see.
+
+NOT NULL with a `'[]'` default, matching `value_by_mode` — a nullable JSONB
+column has two empty states and every reader has to test for both.
+
+Downgrade drops the column; the declarations are lost, which costs the lint its
+input and nothing else.
+"""
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import JSONB
+
+
+revision = "0073"
+down_revision = "0072"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "design_tokens",
+        sa.Column(
+            "supersedes", JSONB, nullable=False, server_default=sa.text("'[]'::jsonb")
+        ),
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("design_tokens", "supersedes")
@@ -0,0 +1,44 @@
+"""central prose on a design system, and rationale on a token
+
+Revision ID: 0074
+Revises: 0073
+Create Date: 2026-07-31
+
+The operator's shape for #254: prose doesn't live as one-offs, it lives centrally
+on the system. Two fields rather than one per category:
+
+  design_systems.guidance   the narrative a token table cannot hold — aesthetic,
+                            voice and tone, what is deliberately out of scope.
+                            Markdown, free-form.
+  design_tokens.rationale   WHY this token is this value, which is a different
+                            question from `purpose` (what it is FOR). "Success
+                            equals Moss, aligned by design" is a rationale;
+                            "page bg, deepest surface" is a purpose.
+
+Free-form rather than a column per category on purpose. A schema with `voice`,
+`aesthetic` and `scope` columns would bake one rulebook's table of contents into
+every install (rule #115), and the next install's design system would have three
+empty columns and nowhere to put what it actually cares about.
+
+Both nullable: a design system with no prose at all is complete, not a draft.
+
+Downgrade drops both columns and the prose with them.
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "0074"
+down_revision = "0073"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("design_systems", sa.Column("guidance", sa.Text(), nullable=True))
+    op.add_column("design_tokens", sa.Column("rationale", sa.Text(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("design_tokens", "rationale")
+    op.drop_column("design_systems", "guidance")
@@ -0,0 +1,53 @@
+# 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 six jobs in `.forgejo/workflows/ci.yml`: typecheck (Vue/TS),
+plugin (hook checks), lint (ruff), test (pytest), integration (pytest +
+real Postgres), 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)
+- uv (test + integration jobs run `uv sync --locked`; installed in the
+  image since the ci-python Dockerfile started pip-installing it)
+- docker CLI + buildx (build job pushes the production image to the
+  Fabled-Git 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.
+
+- `jq` + `shellcheck` — apt-installed in the **plugin** job, which lints
+  the four Claude Code hook scripts and runs their fail-open smoke test.
+  Per `docs/process.md`'s decision checkpoint, single-consumer deps stay
+  per-job until a second consumer wants them; Scribe is the only one so
+  far. Both are small (jq ~1 MB, shellcheck ~20 MB) and would be
+  promotion candidates the moment another project lints shell.
+  **jq is load-bearing for the smoke test specifically**: every hook
+  starts with `command -v jq || exit 0`, so without it the test passes
+  while exercising nothing.
+
+## 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.
@@ -1,16 +1,14 @@
 services:
  app:
-    image: git.fabledsword.com/bvandeusen/fabledassistant:latest
+    image: git.fabledsword.com/bvandeusen/fabledscribe:latest
    environment:
-      DATABASE_URL: "postgresql+asyncpg://fabled:${DB_PASSWORD}@db:5432/fabledassistant"
+      DATABASE_URL: "postgresql+asyncpg://scribe:${DB_PASSWORD}@db:5432/scribe"
      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:
-      - fabledassistant_backend
+      - scribe_backend
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/api/health')"]
      interval: 30s
@@ -23,59 +21,39 @@ services:
        max_attempts: 5

  db:
-    image: postgres:16-alpine
+    # pgvector image (Debian/glibc, PG17) — bundles the `vector` extension that
+    # migration 0067 enables. Moved off postgres:16-alpine via logical
+    # dump/restore (which doubles as the PG16->PG17 major upgrade); see the
+    # TRANSITION runbook in the PR.
+    image: pgvector/pgvector:pg17
+    stop_grace_period: 120s
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
-      POSTGRES_USER: fabled
+      POSTGRES_USER: scribe
      POSTGRES_PASSWORD: "${DB_PASSWORD}"
-      POSTGRES_DB: fabledassistant
+      POSTGRES_DB: scribe
    networks:
-      - fabledassistant_backend
+      - 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.
    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U fabled"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-    deploy:
-      restart_policy:
-        condition: on-failure
-        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"]
+      test: ["CMD-SHELL", "pg_isready -U scribe"]
      interval: 30s
      timeout: 10s
-      retries: 5
-      start_period: 30s
+      retries: 10
+      start_period: 180s
    deploy:
-      placement:
-        constraints:
-          - node.role == worker
-      resources:
-        reservations:
-          devices:
-            - driver: nvidia
-              count: all
-              capabilities: [gpu]
      restart_policy:
        condition: on-failure
-        max_attempts: 5
+        delay: 10s
+        max_attempts: 0
+        window: 120s

 volumes:
  pgdata:
-  ollama_models:

 networks:
-  fabledassistant_backend:
+  scribe_backend:
    driver: overlay
@@ -6,7 +6,8 @@
 #   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 → General to pull an LLM model (qwen3:8b or llama3.1:8b are good starting points)
+#   4. Go to Settings → MCP Access and connect Claude (Code or Desktop) via the
+#      bearer-token URL shown there.
 #
 # Set SECRET_KEY via environment variable or a .env file alongside this file:
 #   SECRET_KEY=your-random-secret-here
@@ -17,18 +18,14 @@ services:
    ports:
      - "5000:5000"
    environment:
-      DATABASE_URL: "postgresql+asyncpg://fabled:fabled@db:5432/fabledassistant"
+      DATABASE_URL: "postgresql+asyncpg://scribe:scribe@db:5432/scribe"
      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')"]
@@ -38,45 +35,25 @@ services:
      start_period: 30s

  db:
-    image: postgres:16-alpine
+    # pgvector image (PG17) — bundles the `vector` extension (migration 0067).
+    image: pgvector/pgvector:pg17
+    stop_grace_period: 120s
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
-      POSTGRES_USER: fabled
-      POSTGRES_PASSWORD: fabled
-      POSTGRES_DB: fabledassistant
+      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.
    healthcheck:
-      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"]
+      test: ["CMD-SHELL", "pg_isready -U scribe"]
      interval: 30s
      timeout: 10s
-      retries: 5
-      start_period: 15s
+      retries: 10
+      start_period: 180s
    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:
@@ -6,25 +6,16 @@ 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:-fabled}:${POSTGRES_PASSWORD:-fabled}@db:5432/${POSTGRES_DB:-fabledassistant}"
-      OLLAMA_URL: "http://ollama:11434"
-      OLLAMA_MODEL: "${OLLAMA_MODEL:-qwen3:8B}"
+      DATABASE_URL: "postgresql+asyncpg://${POSTGRES_USER:-scribe}:${POSTGRES_PASSWORD:-scribe}@db:5432/${POSTGRES_DB:-scribe}"
      SECRET_KEY: "${SECRET_KEY:-dev-secret-change-me}"
-      # Uncomment and set to enable web research and image search via SearXNG:
+      # Uncomment if you have a SearXNG instance you want to surface in the
+      # Integrations tab as a configured web-search backend:
      # 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
@@ -34,37 +25,23 @@ services:

  db:
    image: postgres:16-alpine
+    stop_grace_period: 120s
+    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
-      POSTGRES_USER: ${POSTGRES_USER:-fabled}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-fabled}
-      POSTGRES_DB: ${POSTGRES_DB:-fabledassistant}
+      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.
    healthcheck:
-      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]
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-scribe}"]
+      interval: 30s
+      timeout: 10s
+      retries: 10
+      start_period: 180s

 volumes:
  pgdata:
-  ollama_models:
  app_data:
@@ -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 `fabledassistant` project to support bearer token authentication
+1. **Fable API Key Feature** — additions to the main `scribe` 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 `fabledassistant`. 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 `scribe`. 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 `fabledassistant/fable-mcp/`
+1. Implement and test within `scribe/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

@@ -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 `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.
+**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.

 **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/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 |
+| 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 |
 | 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/fabledassistant/models/api_key.py`
+- Create: `src/scribe/models/api_key.py`
 - Create: `alembic/versions/0027_add_api_keys.py`
- Modify: `src/fabledassistant/models/__init__.py`
+- Modify: `src/scribe/models/__init__.py`

 - [ ] **Step 1: Write the model**

-Create `src/fabledassistant/models/api_key.py`:
+Create `src/scribe/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 fabledassistant.models import Base
-from fabledassistant.models.base import CreatedAtMixin
+from scribe.models import Base
+from scribe.models.base import CreatedAtMixin


 class ApiKey(Base, CreatedAtMixin):
@@ -97,10 +97,10 @@ class ApiKey(Base, CreatedAtMixin):

 - [ ] **Step 2: Export from models __init__**

-In `src/fabledassistant/models/__init__.py`, add after the last import line:
+In `src/scribe/models/__init__.py`, add after the last import line:

 ```python
-from fabledassistant.models.api_key import ApiKey  # noqa: E402, F401
+from scribe.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/fabledassistant/models/api_key.py \
-        src/fabledassistant/models/__init__.py \
+git add src/scribe/models/api_key.py \
+        src/scribe/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/fabledassistant/services/api_keys.py`
+- Create: `src/scribe/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 fabledassistant.services.api_keys import (
+from scribe.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 fabledassistant.services.api_keys import _key_prefix
+    from scribe.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("fabledassistant.services.api_keys.async_session") as mock_session_ctx:
+    with patch("scribe.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("fabledassistant.services.api_keys.async_session") as mock_session_ctx:
+    with patch("scribe.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/fabledassistant/services/api_keys.py`:
+Create `src/scribe/services/api_keys.py`:

 ```python
 import hashlib
@@ -271,8 +271,8 @@ from datetime import datetime, timezone

 from sqlalchemy import select

-from fabledassistant.models import async_session
-from fabledassistant.models.api_key import ApiKey
+from scribe.models import async_session
+from scribe.models.api_key import ApiKey


 def generate_key() -> str:
@@ -365,7 +365,7 @@ Expected: all tests pass
 - [ ] **Step 5: Commit**

 ```bash
-git add src/fabledassistant/services/api_keys.py tests/test_api_keys.py
+git add src/scribe/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/fabledassistant/auth.py`
+- Modify: `src/scribe/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 fabledassistant.auth import _check_auth
+    from scribe.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("fabledassistant.auth.lookup_key", AsyncMock(return_value=fake_key))
-    monkeypatch.setattr("fabledassistant.auth.get_user_by_id", AsyncMock(return_value=fake_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))

    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 fabledassistant.auth as auth_module
+        import scribe.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 fabledassistant.auth import _check_auth
+    from scribe.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("fabledassistant.auth.lookup_key", AsyncMock(return_value=fake_key)), \
-             patch("fabledassistant.auth.get_user_by_id", AsyncMock(return_value=fake_user)):
+        with patch("scribe.auth.lookup_key", AsyncMock(return_value=fake_key)), \
+             patch("scribe.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/fabledassistant/auth.py` with:
+Replace `src/scribe/auth.py` with:

 ```python
 import functools

 from quart import g, jsonify, request, session

-from fabledassistant.services.auth import get_user_by_id
-from fabledassistant.services.api_keys import lookup_key
+from scribe.services.auth import get_user_by_id
+from scribe.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/fabledassistant/auth.py tests/test_api_keys.py
+git add src/scribe/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/fabledassistant/routes/api_keys.py`
- Modify: `src/fabledassistant/app.py`
+- Create: `src/scribe/routes/api_keys.py`
+- Modify: `src/scribe/app.py`

 - [ ] **Step 1: Write the routes**

-Create `src/fabledassistant/routes/api_keys.py`:
+Create `src/scribe/routes/api_keys.py`:

 ```python
 from quart import Blueprint, jsonify, request

-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
+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

 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/fabledassistant/app.py`, add the import alongside the other route imports:
+In `src/scribe/app.py`, add the import alongside the other route imports:

 ```python
-from fabledassistant.routes.api_keys import api_keys_bp
+from scribe.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/fabledassistant/routes/api_keys.py src/fabledassistant/app.py
+git add src/scribe/routes/api_keys.py src/scribe/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/fabledassistant/services/chat.py` (lines 17-30 and 123-135)
- Modify: `src/fabledassistant/routes/chat.py` (lines 73-79)
+- Modify: `src/scribe/services/chat.py` (lines 17-30 and 123-135)
+- Modify: `src/scribe/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/fabledassistant/services/chat.py`, change the function signature at line 17:
+In `src/scribe/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/fabledassistant/services/chat.py`, update the WHERE clause at line 130:
+In `src/scribe/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/fabledassistant/routes/chat.py`, update `create_conversation_route` (around line 73):
+In `src/scribe/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/fabledassistant/services/chat.py src/fabledassistant/routes/chat.py
+git add src/scribe/services/chat.py src/scribe/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/fabledassistant/routes/search.py`
- Modify: `src/fabledassistant/app.py`
+- Create: `src/scribe/routes/search.py`
+- Modify: `src/scribe/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 fabledassistant.routes.search import _content_type_to_is_task
+    from scribe.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/fabledassistant/routes/search.py`:
+Create `src/scribe/routes/search.py`:

 ```python
 from quart import Blueprint, jsonify, request

-from fabledassistant.auth import login_required, get_current_user_id
-from fabledassistant.services.embeddings import semantic_search_notes
+from scribe.auth import login_required, get_current_user_id
+from scribe.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/fabledassistant/app.py`:
+Add to imports in `src/scribe/app.py`:
 ```python
-from fabledassistant.routes.search import search_bp
+from scribe.routes.search import search_bp
 ```

 Add registration:
@@ -855,8 +855,8 @@ Expected: all tests pass
 - [ ] **Step 6: Commit**

 ```bash
-git add src/fabledassistant/routes/search.py \
-        src/fabledassistant/app.py \
+git add src/scribe/routes/search.py \
+        src/scribe/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/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.
+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.

 - [ ] **Step 4: Run tests**

@@ -39,20 +39,20 @@

 ## New Backend Files

-### `src/fabledassistant/services/stt.py`
+### `src/scribe/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/fabledassistant/services/tts.py`
+### `src/scribe/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/fabledassistant/routes/voice.py`
+### `src/scribe/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/fabledassistant/app.py`
+### `src/scribe/app.py`
 - Register `voice_bp` blueprint
 - In `startup()`: `asyncio.create_task(load_stt_model())` + `asyncio.create_task(load_tts_model())` when `VOICE_ENABLED`

-### `src/fabledassistant/config.py`
+### `src/scribe/config.py`
 - Add 4 new env var attributes
 - Add validation in `validate()`

-### `src/fabledassistant/services/llm.py`
+### `src/scribe/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/fabledassistant/services/generation_task.py`
+### `src/scribe/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/fabledassistant/routes/chat.py`
+### `src/scribe/routes/chat.py`
 - Allow `"voice"` in `conversation_type` whitelist

-### `src/fabledassistant/services/chat.py`
+### `src/scribe/services/chat.py`
 - Exclude `conversation_type == "voice"` from auto-cleanup retention

 ---
@@ -1,73 +0,0 @@
-# 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.
@@ -1,4 +1,4 @@
-# API Keys and Fable MCP
+# API Keys and Scribe MCP

 ## API Keys

@@ -19,11 +19,10 @@ Admin-level operations (log access, user management) require a `write`-scoped ke
 2. Enter a name (e.g. "Claude MCP", "Home Server")
 3. Choose scope
 4. Click **Generate Key**
-5. Copy the key immediately — it is shown only once
+5. Copy the key immediately — it is shown only once (the token is `fmcp_`-prefixed)

-After creation you can download:
- **`.env` file** — `FABLE_URL` + `FABLE_API_KEY` ready to paste
- **Claude config JSON** — `mcpServers` block ready to merge into `~/.claude.json`
+Paste the key into the `Authorization: Bearer <key>` header of your MCP client
+config (see **Scribe MCP Server** below).

 ### Revoking a Key

@@ -31,73 +30,35 @@ Click **Revoke** next to the key in the API Keys table and confirm. Revoked keys

 ---

-## Fable MCP Server
+## Scribe MCP Server

-The Fable MCP server (`fable-mcp`) exposes Fable as a set of MCP tools that Claude (and other MCP clients) can use to read and write your notes, tasks, projects, and more.
+Scribe exposes itself as a set of MCP tools that Claude (and other MCP clients)
+can use to read and write your notes, tasks, projects, rulebooks, and more. The
+server is **built into the app** — it is mounted as a streamable-HTTP endpoint
+at **`/mcp`** on the running Scribe instance (`src/scribe/mcp/server.py`). There
+is nothing to install: no wheel, no separate package, no CLI. You connect a
+client straight to the URL with a Bearer token.

-### Download
+### Authentication

-The wheel is bundled into the Docker image at build time and available for download from **Settings → API Keys → Fable MCP** when you are logged in.
-
-You can also download it directly:
-```
-GET /api/fable-mcp/download
-```
-(Requires login — authenticated browser session or API key in `Authorization: Bearer <key>` header.)
-
-### Installation
-
-```bash
-# Install the wheel
-pip install fable_mcp-*.whl
-
-# Verify
-fable-mcp --help
-```
-
-### Configuration
-
-The server reads two environment variables:
-
-| Variable | Description |
-|----------|-------------|
-| `FABLE_URL` | Base URL of your Fable instance (e.g. `https://notes.example.com`) |
-| `FABLE_API_KEY` | API key generated from Settings → API Keys |
-
-Create a `.env` file in your working directory, or set them in your shell / MCP config.
-
-### Claude Code (Global)
-
-Add to `~/.claude.json`:
-
-```json
-{
-  "mcpServers": {
-    "fable": {
-      "type": "stdio",
-      "command": "fable-mcp",
-      "env": {
-        "FABLE_URL": "https://your-fable-instance.example.com",
-        "FABLE_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
+Authenticate with an API key generated from **Settings → API Keys** (see above),
+sent as `Authorization: Bearer fmcp_<key>`. A `read`-scoped key may call only the
+read tools (`get_*`, `list_*`, `search`, `enter_project`); any write/delete tool
+is rejected with `403`. A `write`-scoped key may call everything.

 ### Claude Code (Project-scoped)

-Add a `.mcp.json` at the project root (same format as the global config). Project-scoped config takes precedence over global when the same server name is defined in both. This is useful for using a dev instance or admin key within a specific project.
+Add a `.mcp.json` at the project root. The server `type` is `http` and the URL is
+your instance's `/mcp` endpoint:

 ```json
 {
  "mcpServers": {
-    "fable": {
-      "type": "stdio",
-      "command": "fable-mcp",
-      "env": {
-        "FABLE_URL": "http://localhost:5000",
-        "FABLE_API_KEY": "your-dev-api-key"
+    "scribe": {
+      "type": "http",
+      "url": "https://your-scribe-instance.example.com/mcp",
+      "headers": {
+        "Authorization": "Bearer fmcp_your-api-key"
      }
    }
  }
@@ -106,39 +67,32 @@ Add a `.mcp.json` at the project root (same format as the global config). Projec

 Note: `.mcp.json` contains an API key and should be added to `.gitignore`.

+### Claude Code (Global)
+
+The same `mcpServers` block can live in `~/.claude.json` to make the server
+available across all projects. A project-scoped `.mcp.json` takes precedence over
+the global entry when both define the same server name — useful for pointing a
+specific project at a dev instance or an admin key.
+
 ### Available Tools

-| Tool | Description |
-|------|-------------|
-| `fable_list_notes` | List notes, filter by tag or search text |
-| `fable_get_note` | Fetch a note by ID |
-| `fable_create_note` | Create a new note |
-| `fable_update_note` | Update a note |
-| `fable_delete_note` | Delete a note |
-| `fable_list_tasks` | List tasks, filter by status or project |
-| `fable_get_task` | Fetch a task by ID |
-| `fable_create_task` | Create a new task |
-| `fable_update_task` | Update a task |
-| `fable_add_task_log` | Append a work log entry to a task |
-| `fable_list_projects` | List all projects |
-| `fable_get_project` | Fetch a project with milestone summary |
-| `fable_create_project` | Create a project |
-| `fable_update_project` | Update a project |
-| `fable_list_milestones` | List milestones for a project |
-| `fable_create_milestone` | Create a milestone |
-| `fable_update_milestone` | Update a milestone |
-| `fable_search` | Semantic search over notes and tasks |
-| `fable_list_conversations` | List MCP chat conversations |
-| `fable_send_message` | Send a message to Fable's LLM |
-| `fable_get_app_logs` | Fetch application logs (admin key required) |
+The tool surface is large (~70 tools) and evolves with the app, so the live
+registration in **`src/scribe/mcp/tools/`** is the source of truth rather than a
+table here. The tools are grouped by family:

-### Development Notes
+| Family | Examples | Purpose |
+|--------|----------|---------|
+| Notes | `create_note`, `get_note`, `update_note`, `delete_note`, `list_notes` | Free-form knowledge |
+| Tasks | `create_task`, `update_task`, `add_task_log`, `start_planning` | Actionable work + plans |
+| Projects / Milestones | `enter_project`, `get_project`, `create_milestone`, … | Containers and outcomes |
+| Search / Recall | `search`, `get_recent`, `list_tags` | Semantic + structured recall |
+| Systems | `create_system`, `list_systems`, `list_system_records` | Reusable per-project subsystems/areas |
+| Rulebooks | `list_always_on_rules`, `list_rules`, `create_rule`, `create_project_rule`, `subscribe_project_to_rulebook`, … | Engineering/workflow rules |
+| Processes | `list_processes`, `get_process`, `create_process` | Saved prompts/workflows |
+| Trash | `list_trash`, `restore`, `purge_trash` | Recoverable deletes |
+| Admin | `get_app_logs` (write/admin key) | Diagnostics |

-The `fable-mcp` package lives in `fable-mcp/` in this repository. The Docker build compiles it into a wheel at `/app/dist/` so it can be served for download without requiring the source tree at runtime.
-
-To build the wheel locally:
-```bash
-cd fable-mcp
-pip install build hatchling
-python -m build --wheel .
-```
+Server-level usage guidance — when to reach for each entity, the
+recall-before-acting reflex, and the rulebook conventions — is delivered to the
+client automatically via the MCP server's `instructions` block (defined in
+`src/scribe/mcp/server.py`).
@@ -1,243 +1,206 @@
 # API Reference

-All endpoints require login (session cookie or `Authorization: Bearer <api-key>`) unless marked **(public)**.
+All endpoints are JSON over HTTP under `/api`, and require login unless marked
+**(public)**. Browser sessions authenticate with a cookie; programmatic clients use an
+`fmcp_` API key as `Authorization: Bearer <key>` (see
+[API Keys & MCP](api-keys-and-mcp.md)). Claude reaches the same data through the MCP
+endpoint at `/mcp`, not these REST routes.

 ## Health

 | Method | Path | Description |
 |--------|------|-------------|
 | GET | `/api/health` | Health check **(public)** |
+| GET | `/api/version` | App version **(public)** |

 ## Auth

 | Method | Path | Description |
 |--------|------|-------------|
 | GET | `/api/auth/status` | `{has_users, registration_open, oauth_enabled, local_auth_enabled}` **(public)** |
-| POST | `/api/auth/register` | Register new user (first user becomes admin; 403 if registration closed or local auth disabled) |
-| POST | `/api/auth/login` | Login with username/password (403 if local auth disabled) |
+| POST | `/api/auth/register` | Register (first user becomes admin) |
+| POST | `/api/auth/login` | Login with username/password |
 | POST | `/api/auth/logout` | Clear session |
-| GET | `/api/auth/me` | Current user info (includes `has_password: bool`) |
-| PUT | `/api/auth/password` | Change password `{current_password, new_password}` |
-| PUT | `/api/auth/email` | Change email `{email, password?}` (password required only for local-auth users) |
-| POST | `/api/auth/invalidate-sessions` | Bump `session_version` — evicts all other sessions, keeps current alive |
-| POST | `/api/auth/forgot-password` | Send password reset email `{email}` |
-| POST | `/api/auth/reset-password` | Reset password with token `{token, new_password}` |
-| GET | `/api/auth/oauth/login` | Initiate OIDC PKCE flow → redirect to provider |
-| GET | `/api/auth/oauth/callback` | OIDC callback — exchange code, find/create user, redirect to `/` |
-| GET | `/api/auth/invitation/:token` | Validate invitation token **(public)** |
-| POST | `/api/auth/register-with-invite` | Register with token `{token, username, password}` **(public)** |
+| GET | `/api/auth/me` | Current user info |
+| PUT | `/api/auth/password` | Change password |
+| PUT | `/api/auth/email` | Change email |
+| POST | `/api/auth/invalidate-sessions` | Evict all other sessions |
+| POST | `/api/auth/forgot-password` | Send password-reset email |
+| POST | `/api/auth/reset-password` | Reset password with token |
+| GET | `/api/auth/oauth/login` | Begin OIDC (PKCE) flow |
+| GET | `/api/auth/oauth/callback` | OIDC callback |
+| GET | `/api/auth/invitation/:token` | Validate an invite **(public)** |
+| POST | `/api/auth/register-with-invite` | Register with a token **(public)** |

 ## Notes

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/notes` | List notes. Params: `q`, `tag`, `sort`, `order`, `limit`, `offset`, `project_id`, `milestone_id`, `parent_id`, `type` (`note`/`task`/`all`) |
-| POST | `/api/notes` | Create note `{title, body, tags?, status?, priority?, due_date?, project_id?, milestone_id?, parent_id?}` |
-| GET | `/api/notes/tags` | All tags (param: `q` for filter) |
-| POST | `/api/notes/suggest-tags` | LLM tag suggestions `{title, body, current_tags?}` → `{suggested_tags}` |
-| POST | `/api/notes/link-suggestions` | Detect note titles as plain text in body `{body, project_id, exclude_note_id}` → `[{note_id, title, count}]` |
-| GET | `/api/notes/by-title` | Resolve note by exact title (param: `title`) |
-| POST | `/api/notes/resolve-title` | Get-or-create note by title `{title}` (wikilink click) |
-| GET | `/api/notes/:id` | Get single note |
-| PUT | `/api/notes/:id` | Full update |
-| PATCH | `/api/notes/:id` | Partial update (same fields as PUT) |
-| DELETE | `/api/notes/:id` | Delete note |
-| POST | `/api/notes/:id/convert-to-task` | Set `status='todo'`, `priority='none'` |
-| POST | `/api/notes/:id/convert-to-note` | Clear `status`, `priority`, `due_date` |
-| POST | `/api/notes/:id/append-tag` | Add tag `{tag}` → updated note |
+| GET | `/api/notes` | List notes (params: `q`, `tag`, `sort`, `order`, `limit`, `offset`, `project_id`, `milestone_id`, `parent_id`) |
+| POST | `/api/notes` | Create note |
+| GET | `/api/notes/tags` | All tags (param: `q`) |
+| POST | `/api/notes/:id/append-tag` | Add a tag `{tag}` |
+| POST | `/api/notes/link-suggestions` | Detect note titles as plain text → wikilink candidates |
+| GET | `/api/notes/by-title` | Resolve note by exact title |
+| POST | `/api/notes/resolve-title` | Get-or-create by title (wikilink click) |
+| GET / PUT / PATCH / DELETE | `/api/notes/:id` | Read / replace / patch / delete |
+| POST | `/api/notes/:id/convert-to-task` | Note → task |
+| POST | `/api/notes/:id/convert-to-note` | Task → note |
 | GET | `/api/notes/:id/backlinks` | Notes/tasks with `[[Title]]` references to this note |
-| GET | `/api/notes/:id/versions` | List note version history |
-| GET | `/api/notes/:id/versions/:vid` | Get a specific version |
-| GET | `/api/notes/:id/draft` | Get current AI draft |
-| PUT | `/api/notes/:id/draft` | Save AI draft |
-| DELETE | `/api/notes/:id/draft` | Delete AI draft |
-| POST | `/api/notes/assist` | Launch AI assist generation → 202 `{body, target_section?, instruction, whole_doc?}` |
-| GET | `/api/notes/assist/stream` | SSE stream for assist (Last-Event-ID reconnect; events: `chunk`, `done`, `error`) |
+| GET | `/api/notes/:id/versions` | Version history |
+| GET | `/api/notes/:id/versions/:vid` | A specific version |
+| POST | `/api/notes/:id/versions/:vid/pin` | Pin a version |
+| GET / PUT / DELETE | `/api/notes/:id/draft` | Unsaved-edit draft (restore across page loads) |
+| GET | `/api/notes/graph` | Knowledge-graph nodes/edges |

 ## Tasks

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/tasks` | List tasks. Params: `q`, `tag`, `status`, `priority`, `due_before`, `due_after`, `sort`, `order`, `limit`, `offset` |
-| POST | `/api/tasks` | Create task (accepts `project` name string → resolved to `project_id`) |
-| GET | `/api/tasks/:id` | Get task (includes `parent_title`) |
-| PUT | `/api/tasks/:id` | Full update |
+| GET | `/api/tasks` | List tasks (params: `q`, `tag`, `status`, `priority`, `overdue`, `sort`, `order`, `limit`, `offset`) |
+| POST | `/api/tasks` | Create task (accepts a `project` name string → resolved to `project_id`) |
+| POST | `/api/tasks/planning` | Start a plan (milestone + steps) |
+| GET / PUT / PATCH / DELETE | `/api/tasks/:id` | Read / update / delete |
 | PATCH | `/api/tasks/:id/status` | Quick status update `{status}` |
-| DELETE | `/api/tasks/:id` | Delete task |
-| GET | `/api/tasks/:id/logs` | List work logs |
-| POST | `/api/tasks/:id/logs` | Create log `{content, duration_minutes?}` |
-| PATCH | `/api/tasks/:id/logs/:log_id` | Update log |
-| DELETE | `/api/tasks/:id/logs/:log_id` | Delete log |
+| GET | `/api/tasks/:id/recurrence-preview` | Preview next recurrence occurrences |

-## Projects & Milestones
+**Task work logs**

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/projects` | List projects (owned + shared) |
-| POST | `/api/projects` | Create project |
-| GET | `/api/projects/:id` | Get project with `milestone_summary` |
-| PATCH | `/api/projects/:id` | Update project |
-| DELETE | `/api/projects/:id` | Delete project |
+| GET / POST | `/api/tasks/:id/logs` | List / append a work log `{content, duration_minutes?}` |
+| PATCH / DELETE | `/api/tasks/:id/logs/:log_id` | Update / delete a log |
+
+## Projects, Milestones, Systems, Issues
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET / POST | `/api/projects` | List (owned + shared) / create |
+| GET / PATCH / DELETE | `/api/projects/:id` | Read (with `milestone_summary`) / update / delete |
 | GET | `/api/projects/:id/notes` | Notes + tasks in this project |
-| GET | `/api/projects/:id/milestones` | List milestones |
-| POST | `/api/projects/:id/milestones` | Create milestone |
-| PATCH | `/api/projects/:id/milestones/:mid` | Update milestone |
-| DELETE | `/api/projects/:id/milestones/:mid` | Delete milestone |
+| GET / POST | `/api/projects/:id/milestones` | List / create milestones |
+| GET / PATCH / DELETE | `/api/projects/:id/milestones/:mid` | Read / update / delete |
+| GET | `/api/projects/:id/milestones/:mid/tasks` | Tasks in a milestone |
+| GET / POST | `/api/projects/:id/systems` | List / create systems |
+| GET / PATCH / DELETE | `/api/projects/:id/systems/:sid` | Read / update / delete |
+| GET | `/api/projects/:id/systems/:sid/records` | Records linked to a system |
+| GET | `/api/projects/:id/issues` | Project issues |
+
+## Knowledge browse
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/knowledge` | Unified note/task/plan/process feed (params: `type`, `tags`, `sort`, `q`, `limit`, `offset`) |
+| GET | `/api/knowledge/ids` | ID-only page (two-tier pagination) |
+| GET | `/api/knowledge/batch` | Fetch items by id |
+| GET | `/api/knowledge/tags` | Tags in scope |
+| GET | `/api/knowledge/counts` | Per-type counts |
+
+## Search
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/search` | Semantic + keyword search over notes/tasks (params: `q`, `type`, `limit`) |
+
+## Rulebooks and rules
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET / POST | `/api/rulebooks` | List / create rulebooks |
+| GET / PATCH / DELETE | `/api/rulebooks/:id` | Read / update / delete |
+| GET / POST | `/api/rulebooks/:id/topics` | List / create topics |
+| PATCH / DELETE | `/api/rulebook-topics/:tid` | Edit / delete a topic |
+| GET | `/api/rules` | List rules |
+| POST | `/api/rulebook-topics/:tid/rules` | Add a rule to a topic |
+| GET / PATCH / DELETE | `/api/rules/:id` | Read / update / delete a rule |
+| POST | `/api/projects/:id/rulebook-subscriptions` | Subscribe a project to a rulebook |
+| GET | `/api/projects/:id/rules` | Applicable rules for a project |
+| POST | `/api/projects/:id/rules` | Create a project-scoped rule |
+| POST / DELETE | `/api/projects/:id/suppressions/rules/:rid` | Suppress / unsuppress a rule |
+| POST / DELETE | `/api/projects/:id/suppressions/topics/:tid` | Suppress / unsuppress a topic |

 ## Sharing

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/projects/:id/shares` | List project shares |
-| POST | `/api/projects/:id/shares` | Create project share `{user_id?, group_id?, permission}` |
-| PATCH | `/api/projects/:id/shares/:sid` | Update permission |
-| DELETE | `/api/projects/:id/shares/:sid` | Remove share |
-| GET | `/api/notes/:id/shares` | List note shares |
-| POST | `/api/notes/:id/shares` | Create note share |
-| PATCH | `/api/notes/:id/shares/:sid` | Update permission |
-| DELETE | `/api/notes/:id/shares/:sid` | Remove share |
+| GET / POST | `/api/projects/:id/shares` | List / add project shares `{user_id?, group_id?, permission}` |
+| PATCH / DELETE | `/api/projects/:id/shares/:sid` | Update permission / remove |
+| GET / POST | `/api/notes/:id/shares` | List / add note shares |
+| PATCH / DELETE | `/api/notes/:id/shares/:sid` | Update permission / remove |
 | GET | `/api/shared-with-me` | All resources shared with the current user |

 ## Groups

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/groups` | List all groups (admin only) |
-| POST | `/api/groups` | Create group `{name, description?}` |
-| PATCH | `/api/groups/:id` | Update group |
-| DELETE | `/api/groups/:id` | Delete group |
-| GET | `/api/groups/:id/members` | List members |
-| POST | `/api/groups/:id/members` | Add member `{user_id, role}` |
-| PATCH | `/api/groups/:id/members/:uid` | Update member role |
-| DELETE | `/api/groups/:id/members/:uid` | Remove member |
-
-## Chat
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/chat/conversations` | List conversations (params: `limit`, `offset`) |
-| POST | `/api/chat/conversations` | Create conversation `{title?, model?}` |
-| POST | `/api/chat/conversations/bulk-delete` | Delete multiple conversations `{ids: number[]}` |
-| GET | `/api/chat/conversations/:id` | Get conversation with all messages |
-| PATCH | `/api/chat/conversations/:id` | Update title or model |
-| DELETE | `/api/chat/conversations/:id` | Delete conversation (cascades to messages) |
-| POST | `/api/chat/conversations/:id/messages` | Start generation → 202. Body: `{content, context_note_id?, include_note_ids?, rag_project_id?, workspace_project_id?, think?}` |
-| GET | `/api/chat/conversations/:id/generation/stream` | SSE stream (Last-Event-ID reconnect; events: `context`, `chunk`, `tool_call`, `status`, `done`, `error`) |
-| POST | `/api/chat/conversations/:id/generation/cancel` | Cancel active generation |
-| POST | `/api/chat/messages/:id/save-as-note` | Save assistant message as note |
-| POST | `/api/chat/conversations/:id/summarize` | Summarize conversation → note |
-| GET | `/api/chat/status` | Ollama availability + model state `{ollama, model, default_model}` |
-| GET | `/api/chat/models` | List installed Ollama models (includes `loaded: bool`, `modified_at`) |
-| POST | `/api/chat/models/pull` | Pull model (SSE NDJSON progress) `{model}` |
-| POST | `/api/chat/models/delete` | Delete model `{model}` |
-| GET | `/api/chat/ps` | Currently loaded (hot) models |
-| POST | `/api/chat/warm` | Pre-load model into VRAM `{model}` → 202 |
-
-## Quick Capture
-
-| Method | Path | Description |
-|--------|------|-------------|
-| POST | `/api/quick-capture` | Classify + create item from natural language `{text}` → `{success, type, message, data}` |
-
-## Search
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/search` | Semantic + keyword search across notes and tasks. Params: `q`, `type` (`note`/`task`/`all`), `limit` |
-
-## Journal
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/journal/config` | Get journal configuration (locations, temp_unit, prep schedule) |
-| PUT | `/api/journal/config` | Save journal configuration; live-reschedules the prep job |
-| GET | `/api/journal/today` | Get/create today's journal conversation + messages |
-| GET | `/api/journal/day/:iso` | Get a specific day's journal conversation (read-only) |
-| GET | `/api/journal/days` | List dates with journal content, newest first |
-| POST | `/api/journal/trigger-prep` | Force-regenerate today's prep (or `{date}` for a specific day) |
-| GET | `/api/journal/weather` | Cached weather rows; auto-refreshes stale rows in the background |
-| GET | `/api/journal/weather/current` | Live current conditions for the primary configured location |
-| POST | `/api/journal/weather/refresh` | Manual refresh of all configured locations |
-| POST | `/api/journal/weather/geocode` | Geocode place name `{query}` → `{lat, lon, label}` |
-| POST | `/api/journal/moments/:id/update` | Update a recorded moment |
-| DELETE | `/api/journal/moments/:id` | Delete a moment |
-
-## Settings
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/settings` | All settings as `{key: value}` |
-| PUT | `/api/settings` | Update settings `{key: value, ...}` |
-| GET | `/api/settings/models` | Installed models + defaults |
-| GET | `/api/settings/search` | Proxy SearXNG search (params: `q`) |
-
-## API Keys
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/api-keys` | List user's API keys |
-| POST | `/api/api-keys` | Create key `{name, scope}` → `{key, ...}` (key shown once) |
-| DELETE | `/api/api-keys/:id` | Revoke key |
-
-## Fable MCP Distribution
-
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/fable-mcp/info` | `{available: bool, filename: string\|null}` |
-| GET | `/api/fable-mcp/download` | Download wheel file |
+| GET / POST | `/api/groups` | List / create groups |
+| GET / PATCH / DELETE | `/api/groups/:id` | Read / update / delete |
+| GET / POST | `/api/groups/:id/members` | List / add members `{user_id, role}` |
+| PATCH / DELETE | `/api/groups/:id/members/:uid` | Update role / remove |

 ## Notifications

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/notifications` | List notifications |
+| GET | `/api/notifications` | List in-app notifications |
 | GET | `/api/notifications/count` | Unread count |
-| POST | `/api/notifications/:id/read` | Mark read |
+| POST | `/api/notifications/:id/read` | Mark one read |
 | POST | `/api/notifications/read-all` | Mark all read |

-## Push
+## Profile and Settings

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/push/vapid-public-key` | VAPID public key for subscription |
-| POST | `/api/push/subscribe` | Register push subscription |
-| DELETE | `/api/push/subscribe` | Unregister push subscription |
+| GET / PUT | `/api/profile` | Read / update the per-user profile |
+| GET / PUT | `/api/settings` | Read / update key-value settings |
+| GET | `/api/settings/search` | SearXNG configuration status |

-## Images
+## API keys

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/images/:id` | Serve cached image **(no auth required — IDs are opaque SHA-256)** |
+| GET / POST | `/api/api-keys` | List / create `fmcp_` keys (key shown once) |
+| DELETE | `/api/api-keys/:id` | Revoke a key |

-## Users
+## Plugin (Claude Code)

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/users/search` | Search users by username/email prefix (param: `q`, min 2 chars, excludes self) |
+| GET | `/api/plugin/context` | SessionStart context payload (rules + active-project) |
+| GET | `/api/plugin/retrieve` | Title-first knowledge-injection candidates |
+| GET | `/api/plugin/processes` | Stored Processes for skill-stub sync |
+| GET / PUT | `/api/plugin/marketplace-url` | Read / set the plugin marketplace URL |

-## Export
+## Dashboard, Export, Trash, Users

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/export` | Export data. Params: `format=markdown` (ZIP with `.md` + YAML frontmatter) or `format=json` |
+| GET | `/api/dashboard` | Home dashboard payload |
+| GET | `/api/export` | Personal export (`format=markdown` ZIP or `format=json`) |
+| GET | `/api/trash` | List trashed items, grouped by delete batch |
+| POST | `/api/trash/:batch/restore` | Restore a batch |
+| DELETE | `/api/trash/:batch` | Purge a batch (irreversible) |
+| GET | `/api/users/search` | Search users by prefix (for sharing) |

 ## Admin

 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/api/admin/backup` | Export backup (`?scope=user` for own data; full requires admin) |
-| POST | `/api/admin/restore` | Restore from JSON backup |
-| GET | `/api/admin/users` | List all users |
-| DELETE | `/api/admin/users/:id` | Delete user (cannot delete self) |
-| GET | `/api/admin/registration` | Get registration open/closed state |
-| PUT | `/api/admin/registration` | Toggle registration `{open: bool}` |
-| POST | `/api/admin/invitations` | Create invitation `{email}` → sends email |
-| GET | `/api/admin/invitations` | List pending invitations |
-| DELETE | `/api/admin/invitations/:id` | Revoke invitation |
-| GET | `/api/admin/logs` | Log entries. Params: `category`, `user_id`, `search`, `date_from`, `date_to`, `limit`, `offset` |
-| GET | `/api/admin/logs/stats` | Log category counts |
-| GET | `/api/admin/base-url` | Get base URL setting |
-| PUT | `/api/admin/base-url` | Set base URL `{base_url}` |
-| GET | `/api/admin/smtp` | Get SMTP config (password masked) |
-| PUT | `/api/admin/smtp` | Save SMTP config |
-| POST | `/api/admin/smtp/test` | Send test email `{recipient}` |
+| GET | `/api/admin/backup` | Export backup (format v4; `?scope=user` for own data) |
+| POST | `/api/admin/restore` | Restore from a backup |
+| GET / DELETE | `/api/admin/users` · `/api/admin/users/:id` | List / delete users |
+| GET / PUT | `/api/admin/registration` | Get / toggle registration |
+| GET / PUT | `/api/admin/smtp` · POST `/api/admin/smtp/test` | SMTP config + test email |
+| GET | `/api/admin/logs` · `/api/admin/logs/stats` | Log entries + category counts |
+| GET / PUT | `/api/admin/base-url` | Get / set the public base URL |
+| GET / PUT | `/api/admin/db-maintenance` (+ `/health`, POST `/run`) | VACUUM schedule, health, manual run |
+| POST / GET / DELETE | `/api/admin/invitations` (+ `/:id`) | Create / list / revoke invite links |
+
+## Scribe MCP
+
+Claude clients connect to the built-in MCP server at `POST /mcp` (streamable HTTP,
+Bearer auth with an `fmcp_` key), served by `src/scribe/mcp/`. It is not a REST
+surface — it exposes the same data as typed tools (`create_note`, `create_task`,
+`start_planning`, `search`, `enter_project`, `list_always_on_rules`, …) with
+server-level usage guidance delivered in the MCP `instructions` block. See
+[API Keys & MCP](api-keys-and-mcp.md).
@@ -20,7 +20,7 @@
 │              Docker Compose                  │
 │                                              │
 │  ┌──────────────────────┐   ┌────────────┐  │
-│  │  fabledassistant     │   │  ollama    │  │
+│  │  scribe     │   │  ollama    │  │
 │  │  ┌────────────────┐  │   │            │  │
 │  │  │  Quart Server  │  │   │  LLM API   │  │
 │  │  │  ┌──────────┐  │  │   │            │  │
@@ -43,22 +43,20 @@
 ## Project Structure

 ```
-fabledassistant/
+scribe/
 ├── docker-compose.yml           # Development stack
 ├── docker-compose.prod.yml      # Production stack (Docker Swarm)
 ├── Dockerfile                   # Multi-stage build (Node → Python)
 ├── alembic/                     # Database migrations
 │   └── versions/                # Migration files (idempotent raw SQL)
-├── fable-mcp/                   # Fable MCP server package
-│   └── fable_mcp/
-│       ├── server.py            # FastMCP tool registrations
-│       ├── client.py            # FableClient (httpx wrapper)
-│       └── tools/               # Tool modules (notes, tasks, projects, …)
-├── src/fabledassistant/
+├── src/scribe/
 │   ├── app.py                   # Quart app factory + blueprint registration
 │   ├── config.py                # Config class (reads env vars)
 │   ├── auth.py                  # login_required decorator, session checks
 │   ├── models/                  # SQLAlchemy models
+│   ├── mcp/                      # In-app MCP server (FastMCP, mounted at /mcp)
+│   │   ├── server.py            # FastMCP instance + instructions + Quart mount
+│   │   └── tools/               # Tool modules (notes, tasks, projects, rulebooks, …)
 │   ├── routes/                  # API blueprints (one file per resource)
 │   ├── services/                # Business logic (access, llm, tools, sharing, …)
 │   └── static/                  # Built Vue SPA (generated at Docker build time)
@@ -169,7 +167,7 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi

 ## Detailed File Reference

-### Backend (`src/fabledassistant/`)
+### Backend (`src/scribe/`)

 | File | Responsibility |
 |------|---------------|
@@ -202,7 +200,7 @@ Permission resolution is centralised in `services/access.py`. `get_project_permi
 | `routes/images.py` | Serve cached images at `/api/images/<id>` |
 | `routes/export.py` | `GET /api/export` — personal Markdown ZIP or JSON array download |
 | `routes/api_keys.py` | API key CRUD (`GET/POST/DELETE /api/api-keys`) |
-| `routes/fable_mcp_dist.py` | `GET /api/fable-mcp/info` + `GET /api/fable-mcp/download` — package distribution |
+| `mcp/server.py` | Mounts the in-app FastMCP server at `/mcp` (streamable HTTP, Bearer auth) |
 | `routes/quick_capture.py` | `POST /api/quick-capture` — single-shot natural language item creation |
 | `routes/search.py` | `GET /api/search` — semantic + keyword hybrid search |
 | `services/auth.py` | `create_user`, `authenticate`, user lookups, password reset tokens, invitation tokens |
@@ -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/fabledassistant` | PostgreSQL async connection string |
+| `DATABASE_URL` | `postgresql+asyncpg://fabled:fabled@db/scribe` | 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`) |
@@ -58,12 +58,6 @@ See [sso-oauth.md](sso-oauth.md) for provider-specific setup.
 | `LOG_RETENTION_DAYS` | `90` | Days to keep app logs before automatic pruning |
 | `DATA_DIR` | `/data` | Root directory for persistent data (VAPID keys, backups) |

-### Fable MCP Distribution
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `FABLE_MCP_DIST_DIR` | `/app/dist` | Directory where the bundled `fable-mcp` wheel is placed at build time |
-
 ## Docker Compose Setup

 ### Development (`docker-compose.yml`)
@@ -91,7 +85,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/fabledassistant" | docker secret create fabled_db_url -
+echo "postgresql+asyncpg://fabled:strongpassword@db/scribe" | docker secret create fabled_db_url -

 # Deploy
 docker stack deploy -c docker-compose.prod.yml fabled
@@ -568,17 +568,6 @@ 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.*
@@ -57,7 +57,9 @@ Migration conventions:

 ### Pipeline

-CI runs on Forgejo Actions with a custom runner base image (`py3.12-node22`):
+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):

 | Trigger | Jobs | Docker tags pushed |
 |---------|------|--------------------|
@@ -77,17 +79,21 @@ CI runs on Forgejo Actions with a custom runner base image (`py3.12-node22`):
   git checkout dev && git merge main && git push origin dev
   ```

-### Custom Runner
+### Runner

-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`.
+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.

-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.
+`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.

 ### Docker Registry

-Images pushed to: `git.fabledsword.com/bvandeusen/fabledassistant`
+Images pushed to: `git.fabledsword.com/bvandeusen/scribe`
 Cache tag: `:cache` (reduces build time ~80%)

 Required secrets (repo → Settings → Secrets → Actions):
@@ -134,8 +140,8 @@ Current migration sequence (all idempotent raw SQL):

 ### Backend

- Services: `async with async_session() as session:` — import from `fabledassistant.models`
- No `fabledassistant.database` module
+- Services: `async with async_session() as session:` — import from `scribe.models`
+- No `scribe.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
@@ -158,7 +164,7 @@ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 ```

 Types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`
-Scopes: feature area (e.g. `chat`, `briefing`, `fable-mcp`, `notes`)
+Scopes: feature area (e.g. `chat`, `journal`, `mcp`, `notes`)

 ## Testing

@@ -1,157 +1,168 @@
 # Features

+Scribe is a self-hosted work system-of-record for software projects, built to be
+driven by Claude Code. There is **no in-app LLM** — Claude is the sole assistant,
+reaching Scribe through a built-in MCP endpoint and a bundled Claude Code plugin. The
+web UI is a clean surface for humans to read and edit the same data.
+
 ## Notes

-Write in Markdown with a live-preview editor (Tiptap/ProseMirror). Headings, bold, italic, lists, code blocks, and task checklists render inline. A slash-command menu (`/`) inserts common blocks.
+Write in Markdown with a live-preview editor (Tiptap/ProseMirror). Headings, bold,
+italic, lists, code blocks, and task checklists render inline. A slash-command menu
+(`/`) inserts common blocks.

-**Wikilinks** — Link notes with `[[Title]]` or `[[Title|Display Text]]` syntax. Clicking a wikilink navigates to (or auto-creates) the referenced note. The editor suggests existing note titles as candidate links while typing `[[`. Backlinks appear in the note viewer sidebar.
+- **Wikilinks** — Link notes with `[[Title]]` or `[[Title|Display Text]]`. Clicking
+  navigates to (or auto-creates) the referenced note; the editor suggests existing
+  titles while you type `[[`. Backlinks appear in the note viewer sidebar.
+- **Tags** — First-class `ARRAY[text]` column with autocomplete. Hierarchical tags
+  (`area/backend`) supported — filtering by `area` matches all `area/*` children.
+- **Version history** — Every body edit snapshots a version (up to 20 per note).
+  Browse, diff, and restore from the editor's History panel.
+- **Draft recovery** — In-progress edits persist across page loads and are restored
+  when you reopen a note.
+- **Convert freely** — Turn a note into a task (sets `status=todo`) or back again.

-**Tags** — First-class `ARRAY[text]` column. Tag autocomplete in the editor sidebar suggests existing tags. Hierarchical tags (`project/webapp`) supported — filtering by `project` matches all `project/*` children. Tags are browsable via the knowledge graph.
+## Tasks and Issues

-**Version history** — Every body edit snapshots a version (up to 20 per note). Browse and restore from the editor's History panel. Diff view shows changes against the current body.
+Tasks carry status (`todo` → `in_progress` → `done`/`cancelled`), priority
+(`none`/`low`/`medium`/`high`), due date, milestone assignment, and a parent task
+(sub-tasks). Notes and tasks share one model — a task is a note with a status.

-**AI writing assist** — Select a passage or work on the full document. Give an instruction ("make this more concise", "add examples"). The assistant streams a proposal; a diff view shows changes to accept or reject. Drafts persist across page loads.
-
-**Link suggestions** — The editor detects note titles appearing as plain text in the body and suggests converting them to wikilinks.
-
-## Tasks
-
-Tasks carry status (`todo` → `in_progress` → `done`), priority (`none`/`low`/`medium`/`high`), due date, milestone assignment, and a parent task (sub-tasks).
-
-**Task work logs** — Append progress log entries to a task with optional duration. Time tracking is visible in the task editor sidebar.
-
-**Sub-tasks** — Any task can have child tasks via `parent_id`. The task viewer shows sub-tasks inline.
-
-**Convert freely** — Convert a note to a task (sets `status=todo`) or a task back to a note from the viewer toolbar.
+- **Work logs** — Append timestamped progress entries (with optional duration) to a
+  task without rewriting its body; shown chronologically in the task view.
+- **Issues** — A task whose `kind` is corrective: a problem you fixed or are fixing,
+  with symptom → root cause → fix in the body. An issue can link the task it arose
+  from and the System(s) it touches.
+- **Recurring tasks** — An interval or calendar recurrence rule spawns the next
+  occurrence when a task is completed (a background job drains due spawns).
+- **Sub-tasks** — Any task can have children via `parent_id`; the viewer shows them
+  inline.

 ## Projects and Milestones

-**Projects** — Group related notes and tasks. Each project has a title, description, goal, status (`active`/`completed`/`archived`), and a colour.
+- **Projects** — Group related notes and tasks. Title, description, goal, status
+  (`active`/`paused`/`completed`/`archived`), and a colour.
+- **Milestones** — Ordered stages within a project. A milestone is also the home of a
+  **plan** — its body holds the design (Goal/Approach/Verification) and its child
+  tasks are the steps. Completion percentage is shown on the project page.
+- **Kanban view** — `/projects/:id` groups tasks by milestone in a column layout with
+  status-advance buttons on the cards.

-**Milestones** — Ordered stages within a project. Tasks are assigned to milestones. Milestone completion percentage shown on the project page.
+## Systems

-**Kanban view** — `/projects/:id` groups tasks by milestone in a kanban-style column layout with status-advance buttons directly on cards (→ advance, ✓ complete).
+A **System** is a per-project, reusable, self-describing subsystem or area (e.g.
+"auth", "billing"). Associate any note, task, or issue with a System so research,
+build-work, and fixes for the same area line up and recurring problem-spots surface.

-**Project Workspace** — `/workspace/:projectId` opens a three-panel environment (tasks / chat / notes) locked to a project. The AI assistant creates and updates content directly in the workspace; new notes auto-load in the editor and the task list refreshes automatically after tool calls.
+## Rules and Rulebooks
+
+Scribe stores the operator's engineering and workflow **rules** so Claude follows them
+across sessions.
+
+- **Rulebooks → topics → rules** — Rules are grouped by topic inside a rulebook.
+- **Always-on rules** — A rulebook can be flagged always-on; its rules load at the
+  start of every session through the plugin's push channel.
+- **Per-project scope** — A project subscribes to rulebooks, and can add
+  project-scoped rules or suppress individual inherited rules/topics.
+
+## Stored Processes
+
+Reusable saved prompts (a note with `note_type=process`) — e.g. a drift-audit or a
+DRY pass. The bundled plugin syncs each Process into a local Claude Code skill stub
+(`/scribe:sync`) that auto-surfaces by relevance and fetches the live procedure on
+demand.
+
+## Search and Knowledge Injection
+
+- **Semantic search** — pgvector-backed similarity search over notes and tasks
+  (in-process `fastembed` embeddings; no external model).
+- **Proactive knowledge-injection** — the plugin's `UserPromptSubmit` hook surfaces a
+  short, high-confidence menu of maybe-relevant note *titles* into Claude's context
+  each turn; Claude pulls a full body only when it judges it relevant. Gated so it
+  stays quiet on most turns and never repeats within a session.

 ## Knowledge Graph

-`/graph` renders all notes, tasks, and tags as a D3 force-directed graph. Tag nodes cluster notes that share tags; invisible project hub nodes attract project members. Physics controls: repulsion, link distance, link strength, hub pull, gravity. Click any node to open a slide-in peek panel. Click a tag node to filter the notes list.
+`/graph` renders notes, tasks, and tags as a D3 force-directed graph. Tag nodes
+cluster notes that share tags; invisible project hubs attract project members. Physics
+controls (repulsion, link distance/strength, hub pull, gravity); click a node to peek,
+click a tag to filter.

-## AI Chat
+## Claude via MCP and the plugin

-Full conversation history with SSE streaming. Features:
- **RAG** — Semantically relevant notes (≥ 0.60 cosine similarity) auto-injected as context. Notes 0.45–0.60 shown in sidebar as "Suggested."
- **Attach notes** — Paperclip icon to include specific notes in context.
- **RAG scope chip** — Pill above the input bar shows the current note scope. Click to switch: "Orphan notes only" (default — project notes stay out of general chat), any active project, or "All notes." Scope is persisted per conversation. The AI can also call `search_projects` and `set_rag_scope` mid-conversation to switch scope automatically; the chip pulses when this happens.
- **Tool calls** — The assistant can create/update notes, tasks, projects, milestones, search the web, check weather, read RSS, query calendar events, and more. Tool calls display inline with confirm/deny for creates.
- **Thinking mode** — Toggle extended reasoning for complex questions.
- **Abort** — Stop button cancels in-flight generation.
- **Message queue** — Messages sent while generation is in progress are queued and drained sequentially.
- **Save to note** — Save any assistant reply directly as a note.
- **Bulk delete** — Select and delete multiple conversations.
- **Retention** — Conversations auto-pruned after configurable days (default 90).
+The whole store is reachable by Claude through a built-in **MCP endpoint at `/mcp`**
+(Bearer-auth with an API key). The **Scribe Claude Code plugin** (shipped in this
+repo) wires it up:

-## Daily Journal
+- a `SessionStart` hook that injects the operator's always-on rules + active-project
+  context so Scribe surfaces without being asked (fail-open if Scribe is unreachable);
+- universal process-skills — writing-plans, systematic-debugging, verification,
+  brainstorming — that route their output into Scribe;
+- your saved Processes auto-surfaced as skills.

-`/journal` is a conversational daily surface — each day is a chat-style conversation seeded with an LLM-generated daily prep as the first assistant message. The prep pulls together today's tasks, calendar events, weather, recent moments, and active projects in flowing prose, then invites the user to continue the conversation throughout the day.
-
-**Schedule** — Daily prep generates at a configurable time (default 5:00am). The "day rollover hour" controls when the journal switches to a new day (default 4am — late-night entries 1–3am still count as the previous day). Scheduler catches up missed runs on startup.
-
-**Right rail** — The journal view shows current weather conditions and upcoming events for the next two weeks alongside the conversation. Both surfaces draw from the same data the prep references.
-
-**Configuration** — Settings → Profile:
- *Locations* section: home and work place-name inputs (geocoded on blur via Nominatim) and a temperature unit toggle (C/F)
- *Journal* section: prep auto-generate toggle, prep generation time, day rollover hour
- *About You* / *Interests* / *Work Schedule* / *Response Preferences* feed personalization into the prep's system prompt
-
-**Weather** — Location-based forecast via Open-Meteo. Up to two named locations (home, work). Cached rows auto-refresh in the background when the journal page loads.
-
-**What the assistant has learned** — The assistant maintains a per-user observation log + consolidated summary, generated from journal and chat conversations. The summary is included in the journal's system prompt so the daily prep can reference what it knows about you over time.
-
-## Web Research
-
-The assistant can search the web (SearXNG) and fetch pages, synthesising findings into a structured multi-note research output: an index note with an executive summary and links to focused section notes. Each section covers a distinct aspect of the topic with cited sources. Falls back to a single note when outline generation fails. A lightweight `search_web` tool answers quick questions inline without saving. Requires `SEARXNG_URL` to be configured.
-
-## Calendar
-
-`/calendar` shows a full FullCalendar view (month, week, day). Click an empty slot to create an event; click an existing event to edit or delete it via a slide-over panel.
-
-**Internal events store** — Events are stored in the app database (`events` table), making them available without any external calendar. Fields: title, description, start/end datetime, all-day toggle, location, colour.
-
-**AI tools** — `create_event`, `list_events`, `search_events`, `update_event`, `delete_event` all operate on the internal store. Tool-call result cards in chat are clickable and open the same EventSlideOver for editing.
-
-**HomeView widget** — The dashboard shows today's and the next 7 days' events as clickable cards above the hero project.
-
-**CalDAV sync (optional)** — Connect an external CalDAV server (Nextcloud, Radicale, etc.) in Settings → Integrations. Events sync bidirectionally via a `caldav_uid` field.
+See [API Keys & MCP](api-keys-and-mcp.md).

 ## Sharing and Collaboration

-**Share** — Share any project or note/task with users or groups at `viewer`/`editor`/`admin` permission levels. Share button in the viewer/project toolbar opens a dialog.
+- **Share** — Share any project, note, or task with users or groups at
+  `viewer`/`editor`/`admin` levels from the viewer/project toolbar.
+- **Groups** — Admins create platform-wide groups and assign `member`/`owner` roles;
+  share a resource with a group in one action.
+- **Shared with me** — `/shared` lists incoming shares with permission badges.
+- **Notifications** — An in-app bell (unread count, polled) fires when a project or
+  note is shared with you or you're added to a group.

-**Groups** — Admins create platform-wide groups and assign users `member`/`owner` roles. Share a resource with a group in one action.
-
-**Shared with me** — `/shared` lists all incoming shared projects and notes with permission badges.
-
-**Notifications** — Bell icon in nav shows unread count (60s polling). Notifications generated for: project shared, note shared, added to group. Click navigates to the resource.
-
-**Push notifications** — Web Push (VAPID) notifies when AI generation completes, even in another tab. Works over HTTPS only. Configurable per-user.
-
-## Quick Capture
-
-Quick capture from the Android app routes to the intent classifier. It creates notes, tasks, or projects based on content — using the user's configured model, not the hardcoded default.
+Every read and mutation is scoped by owner + direct shares + group shares.

 ## Data Export and Backup

- **Personal export** — Settings → Data: download all notes/tasks as a Markdown ZIP (with YAML frontmatter) or JSON array.
- **Admin backup** — Full application backup (version 2): includes projects, milestones, task logs, AI drafts, note versions, push subscriptions. ID remapping on restore for cross-instance migration.
+- **Personal export** — download all your notes/tasks as a Markdown ZIP (YAML
+  frontmatter) or a JSON array.
+- **Admin backup** — full application backup/restore (format v4) with ID remapping on
+  restore for cross-instance migration.

-## PWA
+## Progressive Web App

-Installable as a desktop or mobile app. Service worker caches the shell; push notifications are suppressed when the relevant tab is already focused. Works over HTTPS only in Firefox.
+Installable as a desktop or mobile app; a service worker caches the shell.
+
+## Authentication
+
+Native email + password, plus optional **OIDC** sign-in (Authentik, Keycloak, etc.)
+that links to a matching local account. Invite links, a registration toggle, password
+reset, and session invalidation are included. See [SSO / OAuth](sso-oauth.md).

 ## Settings

-Settings are tabbed:
-
 | Tab | Contents |
 |-----|----------|
-| General | Assistant name, default model, model management (pull/delete) |
+| General | Instance preferences (key/value) |
 | Account | Email change, password change, session invalidation |
-| Notifications | Push notification subscription, journal prep push toggle |
-| Profile | About you, response preferences, interests, work schedule, locations + temperature unit, journal prep schedule, learned observations |
-| Integrations | CalDAV configuration, SearXNG status |
-| Data | Personal export, backup/restore (admin) |
-| API Keys | Create/revoke API keys, Fable MCP download and install |
-| Config (admin) | Base URL, SMTP, OIDC settings |
+| Profile | Per-user profile fields |
+| Integrations | SearXNG status |
+| Data | Personal export; backup / restore (admin) |
+| API Keys | Create/revoke `fmcp_` keys for the MCP endpoint |
+| Config (admin) | Base URL, SMTP, DB-maintenance schedule |
 | Users (admin) | User list, invite links, registration toggle |
 | Logs (admin) | Error, audit, and usage logs with search |
 | Groups (admin) | Create/manage groups and membership |

-## Roadmap
-
- 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

 | Key | Action |
 |-----|--------|
-| `g` + `h` | Go to Home |
-| `g` + `n` | Go to Notes |
-| `g` + `t` | Go to Tasks |
-| `g` + `p` | Go to Projects |
-| `g` + `c` | Go to Chat |
-| `g` (bare) | Go to Graph |
+| `g` + `h` | Home (dashboard) |
+| `g` + `n` | Notes |
+| `g` + `t` | Knowledge (tasks) |
+| `g` + `p` | Projects |
+| `g` + `r` | Rulebooks |
+| `g` (bare) | Graph |
+| `g` + `x` | Trash |
 | `n` | New note |
 | `t` | New task |
-| `c` | Focus chat input |
-| `e` | Edit current item |
-| `/` | Search |
+| `/` | Focus search |
 | `?` | Show shortcuts panel |
 | `j` / `k` | Navigate list items |
 | `Enter` | Open selected item |
-| `Escape` | Close panel / blur / go home (progressive) |
+| `e` | Edit current item |
+| `Esc` | Close panel / blur / go home (progressive) |
 | `Ctrl+S` | Save in editor |
@@ -1,594 +0,0 @@
-# Streaming TTS Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Start playing TTS audio during LLM generation by splitting responses into sentences and synthesizing each sentence as it completes, rather than waiting for the full response.
-
-**Architecture:** A new `useStreamingTts` composable watches `streamingContent` for sentence boundaries, fires per-sentence `synthesiseSpeech` requests concurrently, and plays audio in strict insertion order using `useVoiceAudio`. ChatView, BriefingView, and WorkspaceView all use this composable, replacing their current post-stream speak logic.
-
-**Tech Stack:** Vue 3 Composition API, TypeScript, `useVoiceAudio` (existing), `synthesiseSpeech` from `api/client.ts` (existing), no backend changes.
-
---
-
-## File Map
-
-| Action | File | Responsibility |
-|--------|------|----------------|
-| **Create** | `frontend/src/composables/useStreamingTts.ts` | All streaming TTS logic: sentence splitting, TTS queuing, ordered playback |
-| **Modify** | `frontend/src/views/ChatView.vue` | Replace `speakLastAssistantMessage` + old watch with `useStreamingTts` |
-| **Modify** | `frontend/src/views/BriefingView.vue` | Replace `speakText` + `listenToLatest` + old watch with `useStreamingTts` |
-| **Modify** | `frontend/src/views/WorkspaceView.vue` | Add listen mode toggle button + `useStreamingTts` |
-
---
-
-## Task 1: Create `useStreamingTts` composable
-
-**Files:**
- Create: `frontend/src/composables/useStreamingTts.ts`
-
- [ ] **Step 1: Create the composable**
-
-Create `frontend/src/composables/useStreamingTts.ts` with the full implementation:
-
-```typescript
-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
-}
-
-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) {
-      console.warn('[StreamingTTS] Synthesis failed, retrying sentence', { sentence: stripped, error: e })
-      try {
-        blob = await synthesiseSpeech(stripped)
-      } catch (e2) {
-        console.warn('[StreamingTTS] Retry also failed, skipping sentence', { sentence: stripped, error: e2 })
-      }
-    } 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
-    }
-  })
-
-  return { speaking, stop }
-}
-```
-
- [ ] **Step 2: TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant/frontend
-npx vue-tsc --noEmit 2>&1 | head -40
-```
-
-Expected: no errors mentioning `useStreamingTts.ts`.
-
- [ ] **Step 3: Commit**
-
-```bash
-git add frontend/src/composables/useStreamingTts.ts
-git commit -m "feat(tts): add useStreamingTts composable for sentence-level streaming"
-```
-
---
-
-## Task 2: Update ChatView
-
-**Files:**
- Modify: `frontend/src/views/ChatView.vue`
-
-Current TTS code to remove (lines ~35–66):
-
-```typescript
-// REMOVE these:
-const synthesising = ref(false);
-
-async function speakLastAssistantMessage() { ... }  // entire function
-
-watch(() => store.streaming, async (streaming) => {
-  if (!streaming && listenMode.value && voiceTtsEnabled.value) {
-    await new Promise((r) => setTimeout(r, 200));
-    await speakLastAssistantMessage();
-  }
-});
-```
-
-Also remove the `synthesiseSpeech` import from `@/api/client` (it is no longer called directly in this file).
-
- [ ] **Step 1: Add import and replace TTS logic**
-
-In `frontend/src/views/ChatView.vue`:
-
-1. Add to imports at the top of `<script setup>`:
-```typescript
-import { useStreamingTts } from "@/composables/useStreamingTts";
-```
-
-2. Remove `synthesiseSpeech` from the `@/api/client` import line (keep other imports like `apiGet`, `transcribeAudio`).
-
-3. Remove `const synthesising = ref(false);` (line ~35).
-
-4. Remove the entire `speakLastAssistantMessage` function (lines ~38–59).
-
-5. Remove the `watch(() => store.streaming, ...)` block that called `speakLastAssistantMessage` (lines ~61–66).
-
-6. Add after `const listenMode = useListenMode();`:
-```typescript
-const tts = useStreamingTts({
-  streamingContent: computed(() => store.streamingContent),
-  streaming: computed(() => store.streaming),
-  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
-});
-```
-
- [ ] **Step 2: Update template references**
-
-In the ChatView template, replace every occurrence of `synthesising` with `tts.speaking.value`:
-
-Find (line ~919):
-```html
-:class="{ 'btn-listen--active': listenMode, 'btn-listen--busy': synthesising || audio.playing.value }"
-```
-Replace with:
-```html
-:class="{ 'btn-listen--active': listenMode, 'btn-listen--busy': tts.speaking.value }"
-```
-
-Find (line ~920):
-```html
-@click="listenMode = !listenMode; if (listenMode) speakLastAssistantMessage()"
-```
-Replace with:
-```html
-@click="listenMode = !listenMode; if (!listenMode) tts.stop()"
-```
-
-Find (line ~924):
-```html
-<svg v-if="!synthesising && !audio.playing.value" ...>
-```
-Replace with:
-```html
-<svg v-if="!tts.speaking.value" ...>
-```
-
-Note: the `audio` variable (`useVoiceAudio()`) is still used for the volume slider and PTT stop — do NOT remove it.
-
- [ ] **Step 3: TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant/frontend
-npx vue-tsc --noEmit 2>&1 | head -40
-```
-
-Expected: no errors.
-
- [ ] **Step 4: Commit**
-
-```bash
-git add frontend/src/views/ChatView.vue
-git commit -m "feat(tts): wire useStreamingTts into ChatView"
-```
-
---
-
-## Task 3: Update BriefingView
-
-**Files:**
- Modify: `frontend/src/views/BriefingView.vue`
-
-Current TTS code to remove:
-
-```typescript
-// REMOVE:
-const synthesising = ref(false)
-
-async function speakText(text: string) { ... }       // entire function
-async function listenToLatest() { ... }              // entire function
-
-// REMOVE this watch block (the TTS one — keep the other streaming watch):
-watch(() => chatStore.streaming, async (streaming) => {
-  if (!streaming && listenMode.value && voiceTtsEnabled.value) {
-    await new Promise((r) => setTimeout(r, 200))
-    await listenToLatest()
-  }
-})
-```
-
-Note: BriefingView has **two** `watch(() => chatStore.streaming, ...)` blocks. Keep the first one (lines ~152–156, which refreshes messages). Remove only the TTS one (lines ~327–332).
-
-Also remove the `synthesiseSpeech` import from `@/api/client`.
-
- [ ] **Step 1: Add import and replace TTS logic**
-
-In `frontend/src/views/BriefingView.vue`:
-
-1. Add to imports:
-```typescript
-import { useStreamingTts } from '@/composables/useStreamingTts'
-```
-
-2. Remove `synthesiseSpeech` from the `@/api/client` import line.
-
-3. Remove `const synthesising = ref(false)`.
-
-4. Remove the entire `speakText` function.
-
-5. Remove the entire `listenToLatest` function.
-
-6. Remove the TTS `watch(() => chatStore.streaming, ...)` block (the one that calls `listenToLatest`).
-
-7. Add after `const listenMode = useListenMode()`:
-```typescript
-const tts = useStreamingTts({
-  streamingContent: computed(() => chatStore.streamingContent),
-  streaming: computed(() => chatStore.streaming),
-  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
-})
-```
-
- [ ] **Step 2: Update template references**
-
-Find the listen toggle button in the template. Replace `synthesising` references:
-
-```html
-<!-- Before -->
-:class="{ 'btn-icon-active': listenMode, 'btn-icon-busy': synthesising || audio.playing.value }"
-@click="listenMode ? (listenMode = false) : (listenMode = true, listenToLatest())"
-
-<!-- After -->
-:class="{ 'btn-icon-active': listenMode, 'btn-icon-busy': tts.speaking.value }"
-@click="listenMode = !listenMode; if (!listenMode) tts.stop()"
-```
-
-Find the stop button:
-```html
-<!-- Before -->
-v-if="voiceTtsEnabled && (synthesising || audio.playing.value)"
-@click="audio.stop(); synthesising = false"
-
-<!-- After -->
-v-if="voiceTtsEnabled && tts.speaking.value"
-@click="tts.stop()"
-```
-
-Find the spinner SVG condition:
-```html
-<!-- Before -->
-<svg v-if="!synthesising && !audio.playing.value" ...>
-
-<!-- After -->
-<svg v-if="!tts.speaking.value" ...>
-```
-
- [ ] **Step 3: TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant/frontend
-npx vue-tsc --noEmit 2>&1 | head -40
-```
-
-Expected: no errors.
-
- [ ] **Step 4: Commit**
-
-```bash
-git add frontend/src/views/BriefingView.vue
-git commit -m "feat(tts): wire useStreamingTts into BriefingView"
-```
-
---
-
-## Task 4: Add streaming TTS to WorkspaceView
-
-**Files:**
- Modify: `frontend/src/views/WorkspaceView.vue`
-
-WorkspaceView has no TTS today. We add: listen mode toggle, `useStreamingTts`, and the listen button in the chat input toolbar.
-
- [ ] **Step 1: Add imports and composable**
-
-In `frontend/src/views/WorkspaceView.vue`, add to the import block at the top of `<script setup>`:
-
-```typescript
-import { useListenMode } from '@/composables/useListenMode'
-import { useStreamingTts } from '@/composables/useStreamingTts'
-import { useVoiceAudio } from '@/composables/useVoiceAudio'
-```
-
-After the existing store setup code (after `const settingsStore = useSettingsStore()`), add:
-
-```typescript
-const listenMode = useListenMode()
-const voiceTtsEnabled = computed(() => settingsStore.voiceTtsReady)
-const audio = useVoiceAudio()
-const tts = useStreamingTts({
-  streamingContent: computed(() => chatStore.streamingContent),
-  streaming: computed(() => chatStore.streaming),
-  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
-})
-```
-
- [ ] **Step 2: Add listen mode button to template**
-
-In the `<div class="chat-input-area">` section (around line 365), add the listen button before the abort/send button:
-
-```html
-<div class="chat-input-area">
-  <textarea
-    ref="inputEl"
-    v-model="messageInput"
-    class="chat-input"
-    :placeholder="chatStore.streaming ? 'Type to queue next message… (Enter to queue)' : 'Message the agent… (Enter to send)'"
-    rows="1"
-    @keydown="onInputKeydown"
-    @input="autoResize"
-  ></textarea>
-  <!-- Listen mode toggle (TTS) -->
-  <button
-    v-if="voiceTtsEnabled"
-    class="btn-listen-ws"
-    :class="{ 'btn-listen-ws--active': listenMode, 'btn-listen-ws--busy': tts.speaking.value }"
-    :title="listenMode ? 'Stop auto-read' : 'Read responses aloud'"
-    aria-label="Toggle listen mode"
-    @click="listenMode = !listenMode; if (!listenMode) tts.stop()"
-  >
-    <svg v-if="!tts.speaking.value" width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
-      <path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.85-5 6.71v2.06c4.01-.91 7-4.49 7-8.77s-2.99-7.86-7-8.77z"/>
-    </svg>
-    <svg v-else width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
-      <path d="M18 12c0-1.77-1.02-3.29-2.5-4.03v2.21l2.45 2.45c.03-.2.05-.41.05-.63zm2.5 0c0 .94-.2 1.82-.54 2.64l1.51 1.51C21.8 14.82 22 13.43 22 12c0-4.28-2.99-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71zM4.27 3L3 4.27 7.73 9H3v6h4l5 5v-6.73l4.25 4.25c-.67.52-1.42.93-2.25 1.18v2.06c1.38-.31 2.63-.95 3.69-1.81L19.73 21 21 19.73l-9-9L4.27 3zM12 4L9.91 6.09 12 8.18V4z"/>
-    </svg>
-  </button>
-  <button
-    v-if="chatStore.streaming"
-    class="btn-abort"
-    title="Stop generation"
-    @click="chatStore.cancelGeneration()"
-  >
-    ■ Stop
-  </button>
-  <button
-    v-else
-    class="btn-send"
-    :disabled="!messageInput.trim()"
-    @click="sendMessage"
-  >
-    Send
-  </button>
-</div>
-```
-
- [ ] **Step 3: Add CSS for the listen button**
-
-In the `<style>` block, add:
-
-```css
-.btn-listen-ws {
-  flex-shrink: 0;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  width: 2rem;
-  height: 2rem;
-  border: 1px solid var(--color-border);
-  border-radius: var(--radius-md);
-  background: transparent;
-  color: var(--color-text-muted);
-  cursor: pointer;
-  transition: color 0.15s, background 0.15s, border-color 0.15s;
-}
-.btn-listen-ws:hover {
-  color: var(--color-text);
-  border-color: var(--color-primary);
-}
-.btn-listen-ws--active {
-  color: var(--color-primary);
-  border-color: var(--color-primary);
-  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
-}
-.btn-listen-ws--busy {
-  color: var(--color-primary);
-  animation: pulse 1.2s ease-in-out infinite;
-}
-```
-
- [ ] **Step 4: TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant/frontend
-npx vue-tsc --noEmit 2>&1 | head -40
-```
-
-Expected: no errors.
-
- [ ] **Step 5: Commit**
-
-```bash
-git add frontend/src/views/WorkspaceView.vue
-git commit -m "feat(tts): add streaming TTS listen mode to WorkspaceView"
-```
-
---
-
-## Task 5: Final integration check and push
-
- [ ] **Step 1: Full TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant/frontend
-npx vue-tsc --noEmit 2>&1
-```
-
-Expected: zero errors.
-
- [ ] **Step 2: Verify no dead imports remain**
-
-```bash
-grep -n "synthesiseSpeech\|speakLastAssistantMessage\|speakText\|listenToLatest\|synthesising" \
-  frontend/src/views/ChatView.vue \
-  frontend/src/views/BriefingView.vue \
-  frontend/src/views/WorkspaceView.vue
-```
-
-Expected: no matches (all replaced).
-
- [ ] **Step 3: Manual smoke test**
-
-1. Enable voice in Admin → Config
-2. Open Chat, enable listen mode (speaker icon)
-3. Send a message and watch: audio should begin playing the first sentence while the LLM is still streaming the response
-4. Send another message mid-playback — previous audio should stop immediately
-5. Toggle listen mode off mid-response — audio stops, `tts.stop()` called
-6. Repeat in `/briefing` and `/workspace/:id`
-
- [ ] **Step 4: Push**
-
-```bash
-git push origin dev
-```
-
---
-
-## Self-Review
-
-**Spec coverage check:**
- ✅ Starts playing during generation (sentence-level queue, fires on each boundary)
- ✅ Automatic when listen mode on (enabled computed = listenMode && voiceTtsEnabled)
- ✅ ChatView updated
- ✅ BriefingView updated
- ✅ WorkspaceView added
- ✅ One retry before skipping on failure
- ✅ Failures logged via `console.warn` with sentence text and error
- ✅ `stop()` on new message start (watch streaming → true)
- ✅ Flush remaining buffer on stream end (watch streaming → false)
- ✅ Fragments < 3 chars skipped
- ✅ `abortId` prevents stale playback after stop
-
-**Type consistency:**
- `tts.speaking` is `ComputedRef<boolean>` — accessed as `tts.speaking.value` in templates ✅
- `tts.stop()` called consistently across all three views ✅
- `useStreamingTts` options match usage in all three call sites ✅
- `audio` variable kept in ChatView (used by volume slider) — not removed ✅
@@ -1,695 +0,0 @@
-# Article Reading Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Add a `read_article` tool so the LLM can fetch any URL, fix the history builder so tool context survives follow-up turns, redesign the Discuss button to inject article content as a persisted tool exchange, and remove the RSS content character cap.
-
-**Architecture:** Four independent changes executed in dependency order: (1) content cap removal, (2) `read_article` tool, (3) history builder fix (prerequisite for everything persisting across follow-ups), (4) Discuss endpoint + frontend. Each task is independently committable.
-
-**Tech Stack:** Python/Quart, SQLAlchemy async, trafilatura (already installed), httpx (already installed), Vue 3 + TypeScript frontend.
-
---
-
-## File map
-
-| Action | Path | Responsibility |
-|---|---|---|
-| Modify | `src/fabledassistant/services/rss.py` | Remove `CONTENT_MAX_CHARS` truncation |
-| Modify | `src/fabledassistant/services/tools.py` | Add `_URL_TOOLS` list, add `read_article` to `get_tools_for_user`, add handler in `execute_tool` |
-| Modify | `src/fabledassistant/routes/chat.py` | Fix history builder to replay tool_calls |
-| Modify | `src/fabledassistant/services/chat.py` | Add `tool_calls` parameter to `add_message` |
-| Modify | `src/fabledassistant/routes/briefing.py` | Add `POST /api/briefing/articles/<item_id>/discuss` endpoint |
-| Modify | `frontend/src/views/BriefingView.vue` | Replace `discussArticle()` to call new endpoint |
-| Modify | `tests/test_rss_service.py` | Update truncation test, add no-truncation test |
-| Create | `tests/test_article_reading.py` | Tests for `read_article` tool and history builder |
-
---
-
-## Task 1: Remove RSS content cap
-
-**Files:**
- Modify: `src/fabledassistant/services/rss.py:17-18,83,213`
- Modify: `tests/test_rss_service.py:19-26`
-
-The `CONTENT_MAX_CHARS = 50_000` constant and all uses of `[:CONTENT_MAX_CHARS]` are removed.
-Trafilatura extracts only article body text, so content is naturally bounded.
-
- [ ] **Step 1: Update the truncation test to assert no truncation**
-
-In `tests/test_rss_service.py`, replace the existing `test_extract_item_truncates_content` test:
-
-```python
-def test_extract_item_does_not_truncate_content():
-    """extract_item() should store content without truncation."""
-    from fabledassistant.services.rss import extract_item
-    long_text = "x" * 100_000
-    entry = MagicMock()
-    entry.get = lambda k, d="": {"summary": long_text, "title": "", "link": "", "id": "g"}.get(k, d)
-    entry.content = []
-    entry.published_parsed = None
-    item = extract_item(entry)
-    assert len(item["content"]) == 100_000
-```
-
- [ ] **Step 2: Run the test to confirm it fails**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant
-make test ARGS="tests/test_rss_service.py::test_extract_item_does_not_truncate_content -v"
-```
-
-Expected: FAIL (current code truncates to 50_000).
-
- [ ] **Step 3: Remove CONTENT_MAX_CHARS from rss.py**
-
-In `src/fabledassistant/services/rss.py`:
-
-Remove lines 17–18:
-```python
-# Safety cap on stored content — effectively unlimited for typical articles
-CONTENT_MAX_CHARS = 50_000
-```
-
-Change line 83 from:
-```python
-    content = _html_to_text(content)[:CONTENT_MAX_CHARS]
-```
-to:
-```python
-    content = _html_to_text(content)
-```
-
-Change line 213 from:
-```python
-                            item.content = full_text[:CONTENT_MAX_CHARS]
-```
-to:
-```python
-                            item.content = full_text
-```
-
- [ ] **Step 4: Run all rss tests**
-
-```bash
-make test ARGS="tests/test_rss_service.py -v"
-```
-
-Expected: all pass. The `test_extract_item_truncates_content` test name no longer exists (replaced in Step 1).
-
- [ ] **Step 5: Commit**
-
-```bash
-git add src/fabledassistant/services/rss.py tests/test_rss_service.py
-git commit -m "feat(rss): remove article content character cap"
-```
-
---
-
-## Task 2: Add `read_article` tool
-
-**Files:**
- Modify: `src/fabledassistant/services/tools.py`
- Create: `tests/test_article_reading.py`
-
-The tool uses `_fetch_full_article` from `rss.py` (lazy import inside `execute_tool` to avoid circular dependencies). Added unconditionally to all users via a new `_URL_TOOLS` list.
-
- [ ] **Step 1: Write failing tests**
-
-Create `tests/test_article_reading.py`:
-
-```python
-import json
-import pytest
-from unittest.mock import AsyncMock, patch
-
-
-@pytest.mark.asyncio
-async def test_read_article_success():
-    """read_article tool returns article content on success."""
-    from fabledassistant.services.tools import execute_tool
-    with patch(
-        "fabledassistant.services.rss._fetch_full_article",
-        new=AsyncMock(return_value="Article text here."),
-    ):
-        result = await execute_tool(
-            user_id=1,
-            tool_name="read_article",
-            arguments={"url": "https://example.com/article"},
-        )
-    assert result["success"] is True
-    assert result["type"] == "article_content"
-    assert result["url"] == "https://example.com/article"
-    assert result["content"] == "Article text here."
-    assert result["truncated"] is False
-
-
-@pytest.mark.asyncio
-async def test_read_article_fetch_failure():
-    """read_article tool returns success=False when fetch returns None."""
-    from fabledassistant.services.tools import execute_tool
-    with patch(
-        "fabledassistant.services.rss._fetch_full_article",
-        new=AsyncMock(return_value=None),
-    ):
-        result = await execute_tool(
-            user_id=1,
-            tool_name="read_article",
-            arguments={"url": "https://example.com/bad"},
-        )
-    assert result["success"] is False
-    assert "Could not fetch" in result["error"]
-
-
-@pytest.mark.asyncio
-async def test_read_article_truncates_at_40k():
-    """read_article tool truncates content at 40_000 chars and sets truncated=True."""
-    from fabledassistant.services.tools import execute_tool
-    long_content = "x" * 50_000
-    with patch(
-        "fabledassistant.services.rss._fetch_full_article",
-        new=AsyncMock(return_value=long_content),
-    ):
-        result = await execute_tool(
-            user_id=1,
-            tool_name="read_article",
-            arguments={"url": "https://example.com/long"},
-        )
-    assert result["success"] is True
-    assert len(result["content"]) == 40_000
-    assert result["truncated"] is True
-
-
-@pytest.mark.asyncio
-async def test_read_article_empty_url():
-    """read_article tool returns success=False when url is empty."""
-    from fabledassistant.services.tools import execute_tool
-    result = await execute_tool(
-        user_id=1,
-        tool_name="read_article",
-        arguments={"url": ""},
-    )
-    assert result["success"] is False
-```
-
- [ ] **Step 2: Run tests to confirm they fail**
-
-```bash
-make test ARGS="tests/test_article_reading.py -v"
-```
-
-Expected: all 4 fail with "read_article not handled" or AttributeError.
-
- [ ] **Step 3: Add `_URL_TOOLS` list and register it in `get_tools_for_user`**
-
-In `src/fabledassistant/services/tools.py`, add the `_URL_TOOLS` list immediately after the `_SEARCH_TOOLS` block (around line 836):
-
-```python
-_URL_TOOLS = [
-    {
-        "type": "function",
-        "function": {
-            "name": "read_article",
-            "description": (
-                "Fetch and read the full text of a web page or article from a URL. "
-                "Use when the user shares a URL and wants you to read it, or to get "
-                "the full content of a linked page. "
-                "Do NOT use search_web for URLs — use this tool instead."
-            ),
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "url": {"type": "string", "description": "The URL to fetch and read"}
-                },
-                "required": ["url"],
-            },
-        },
-    }
-]
-```
-
-In `get_tools_for_user` (around line 1034), add `_URL_TOOLS` unconditionally after `_CORE_TOOLS`:
-
-```python
-async def get_tools_for_user(user_id: int) -> list[dict]:
-    """Build the tool list for a user based on their configured integrations."""
-    tools = list(_CORE_TOOLS)
-    tools.extend(_URL_TOOLS)
-    tools.extend(_RAG_TOOLS)
-    tools.extend(_ENTITY_TOOLS)
-    if await is_caldav_configured(user_id):
-        tools.extend(_CALDAV_TOOLS)
-    if Config.searxng_enabled():
-        tools.extend(_SEARCH_TOOLS)
-        tools.extend(_RESEARCH_TOOLS)
-        tools.extend(_IMAGE_TOOLS)
-    logger.debug("User %d: %d tools available", user_id, len(tools))
-    return tools
-```
-
- [ ] **Step 4: Add `read_article` handler in `execute_tool`**
-
-In `src/fabledassistant/services/tools.py`, in the `execute_tool` function, find the `elif tool_name == "search_web":` block (around line 1771). Add the new handler immediately before it:
-
-```python
-        elif tool_name == "read_article":
-            from fabledassistant.services.rss import _fetch_full_article
-            url = arguments.get("url", "").strip()
-            if not url:
-                return {"success": False, "error": "No URL provided"}
-            content = await _fetch_full_article(url)
-            if not content:
-                return {"success": False, "error": f"Could not fetch article content from {url}"}
-            _TOOL_CONTENT_CAP = 40_000
-            truncated = len(content) > _TOOL_CONTENT_CAP
-            return {
-                "success": True,
-                "type": "article_content",
-                "url": url,
-                "content": content[:_TOOL_CONTENT_CAP],
-                "truncated": truncated,
-            }
-
-```
-
- [ ] **Step 5: Run the tests**
-
-```bash
-make test ARGS="tests/test_article_reading.py -v"
-```
-
-Expected: all 4 pass.
-
- [ ] **Step 6: Run full test suite**
-
-```bash
-make test
-```
-
-Expected: all pass.
-
- [ ] **Step 7: Commit**
-
-```bash
-git add src/fabledassistant/services/tools.py tests/test_article_reading.py
-git commit -m "feat(tools): add read_article tool using trafilatura extraction"
-```
-
---
-
-## Task 3: Fix history builder
-
-**Files:**
- Modify: `src/fabledassistant/routes/chat.py:162-166`
- Modify: `tests/test_article_reading.py` (add history builder tests)
-
-The loop that builds `history` for `run_generation` currently drops `tool_calls`. This fix replays the full tool exchange so the LLM sees prior tool results on follow-up turns.
-
- [ ] **Step 1: Add history builder tests**
-
-Append to `tests/test_article_reading.py`:
-
-```python
-def test_history_builder_plain_messages():
-    """Messages without tool_calls are added as {role, content} unchanged."""
-    import json
-    messages = [
-        type("M", (), {"role": "system", "content": "sys", "tool_calls": None})(),
-        type("M", (), {"role": "user", "content": "hello", "tool_calls": None})(),
-        type("M", (), {"role": "assistant", "content": "hi", "tool_calls": None})(),
-    ]
-    history = _build_history(messages)
-    assert history == [
-        {"role": "user", "content": "hello"},
-        {"role": "assistant", "content": "hi"},
-    ]
-
-
-def test_history_builder_with_tool_calls():
-    """Messages with tool_calls emit an assistant entry + tool result entries."""
-    import json
-    tool_calls_data = [
-        {
-            "function": "read_article",
-            "arguments": {"url": "https://example.com"},
-            "result": {"success": True, "content": "Article text"},
-        }
-    ]
-    messages = [
-        type("M", (), {"role": "user", "content": "read this", "tool_calls": None})(),
-        type("M", (), {
-            "role": "assistant",
-            "content": "",
-            "tool_calls": tool_calls_data,
-        })(),
-        type("M", (), {"role": "user", "content": "follow up", "tool_calls": None})(),
-    ]
-    history = _build_history(messages)
-    assert history[0] == {"role": "user", "content": "read this"}
-    assert history[1]["role"] == "assistant"
-    assert history[1]["tool_calls"] == [
-        {"function": {"name": "read_article", "arguments": {"url": "https://example.com"}}}
-    ]
-    assert history[2] == {"role": "tool", "content": json.dumps({"success": True, "content": "Article text"})}
-    assert history[3] == {"role": "user", "content": "follow up"}
-
-
-def _build_history(messages):
-    """Inline copy of the fixed history builder for testing."""
-    import json
-    history = []
-    for msg in messages:
-        if msg.role == "system":
-            continue
-        msg_dict = {"role": msg.role, "content": msg.content or ""}
-        if msg.tool_calls:
-            msg_dict["tool_calls"] = [
-                {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-                for tc in msg.tool_calls
-            ]
-            history.append(msg_dict)
-            for tc in msg.tool_calls:
-                history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-        else:
-            history.append(msg_dict)
-    return history
-```
-
- [ ] **Step 2: Run the tests to confirm they pass**
-
-(These tests use `_build_history` defined inline — they test the logic directly, not the route. They should pass immediately.)
-
-```bash
-make test ARGS="tests/test_article_reading.py::test_history_builder_plain_messages tests/test_article_reading.py::test_history_builder_with_tool_calls -v"
-```
-
-Expected: both pass.
-
- [ ] **Step 3: Apply the fix to `chat.py`**
-
-In `src/fabledassistant/routes/chat.py`, replace lines 162–166:
-
-```python
-    # Build history from existing messages (excluding system and the placeholder)
-    history = []
-    for msg in conv.messages:
-        if msg.role != "system":
-            history.append({"role": msg.role, "content": msg.content})
-```
-
-with:
-
-```python
-    # Build history from existing messages (excluding system and the placeholder).
-    # Tool calls from prior turns are replayed as assistant tool_call + tool result
-    # messages so the LLM retains tool context on follow-up turns.
-    history = []
-    for msg in conv.messages:
-        if msg.role == "system":
-            continue
-        msg_dict = {"role": msg.role, "content": msg.content or ""}
-        if msg.tool_calls:
-            msg_dict["tool_calls"] = [
-                {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-                for tc in msg.tool_calls
-            ]
-            history.append(msg_dict)
-            for tc in msg.tool_calls:
-                history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-        else:
-            history.append(msg_dict)
-```
-
-`json` is already imported at the top of `chat.py`.
-
- [ ] **Step 4: Run full test suite**
-
-```bash
-make test
-```
-
-Expected: all pass.
-
- [ ] **Step 5: Commit**
-
-```bash
-git add src/fabledassistant/routes/chat.py tests/test_article_reading.py
-git commit -m "fix(chat): replay tool_calls in history so tool context survives follow-up turns"
-```
-
---
-
-## Task 4: Extend `add_message` to accept `tool_calls`
-
-**Files:**
- Modify: `src/fabledassistant/services/chat.py:183-207`
-
-The Discuss endpoint (Task 5) needs to store a synthetic assistant message with `tool_calls`. The existing `add_message` doesn't support this parameter.
-
- [ ] **Step 1: Update `add_message` signature and body**
-
-In `src/fabledassistant/services/chat.py`, replace the `add_message` function (lines 183–207):
-
-```python
-async def add_message(
-    conversation_id: int,
-    role: str,
-    content: str,
-    context_note_id: int | None = None,
-    status: str | None = None,
-    tool_calls: list | None = None,
-) -> Message:
-    async with async_session() as session:
-        kwargs: dict = dict(
-            conversation_id=conversation_id,
-            role=role,
-            content=content,
-            context_note_id=context_note_id,
-        )
-        if status is not None:
-            kwargs["status"] = status
-        if tool_calls is not None:
-            kwargs["tool_calls"] = tool_calls
-        msg = Message(**kwargs)
-        session.add(msg)
-        # Touch conversation updated_at
-        conv = await session.get(Conversation, conversation_id)
-        if conv:
-            conv.updated_at = datetime.now(timezone.utc)
-        await session.commit()
-        await session.refresh(msg)
-        return msg
-```
-
- [ ] **Step 2: Run full test suite**
-
-```bash
-make test
-```
-
-Expected: all pass (existing callers only use positional/keyword args that are unchanged).
-
- [ ] **Step 3: Commit**
-
-```bash
-git add src/fabledassistant/services/chat.py
-git commit -m "feat(chat): add tool_calls parameter to add_message"
-```
-
---
-
-## Task 5: Add Discuss endpoint and update frontend
-
-**Files:**
- Modify: `src/fabledassistant/routes/briefing.py`
- Modify: `frontend/src/views/BriefingView.vue`
-
-New route: `POST /api/briefing/articles/<item_id>/discuss`. Fetches stored article from DB, stores a synthetic `read_article` tool exchange plus the user message, then triggers generation. Frontend replaces the inline-content approach with a call to this endpoint.
-
- [ ] **Step 1: Add the discuss endpoint to briefing.py**
-
-At the top of `src/fabledassistant/routes/briefing.py`, add these imports (after the existing imports):
-
-```python
-from fabledassistant.models.rss_feed import RssItem, RssFeed
-from fabledassistant.services.chat import add_message, get_conversation
-from fabledassistant.services.generation_buffer import GenerationState, create_buffer, get_buffer
-from fabledassistant.services.generation_task import run_generation
-from fabledassistant.services.settings import get_setting
-```
-
-Note: `get_setting` and `asyncio` are already imported. Add only what is missing.
-
-Then add the new route at the end of `briefing.py` (before any final lines), after the `list_news` route:
-
-```python
-@briefing_bp.route("/articles/<int:item_id>/discuss", methods=["POST"])
-@_REQUIRE
-async def discuss_article(item_id: int):
-    """Pre-load a briefing article as a read_article tool exchange and trigger generation."""
-    uid = g.user.id
-    data = await request.get_json() or {}
-    conv_id = data.get("conv_id")
-    if not conv_id:
-        return jsonify({"error": "conv_id is required"}), 400
-
-    # Verify article belongs to this user (via feed ownership)
-    async with async_session() as session:
-        result = await session.execute(
-            select(RssItem).join(RssFeed, RssItem.feed_id == RssFeed.id)
-            .where(RssItem.id == item_id, RssFeed.user_id == uid)
-        )
-        item = result.scalar_one_or_none()
-    if item is None:
-        return jsonify({"error": "Article not found"}), 404
-
-    # Verify conversation belongs to this user
-    conv = await get_conversation(uid, conv_id)
-    if conv is None:
-        return jsonify({"error": "Conversation not found"}), 404
-
-    # Reject if generation already running
-    existing = get_buffer(conv_id)
-    if existing and existing.state == GenerationState.RUNNING:
-        return jsonify({"error": "Generation already in progress"}), 409
-
-    article_content = item.content or ""
-
-    # Store synthetic assistant message: read_article was already called with stored content
-    synthetic_tool_calls = [
-        {
-            "function": "read_article",
-            "arguments": {"url": item.url},
-            "result": {
-                "success": True,
-                "type": "article_content",
-                "url": item.url,
-                "content": article_content,
-                "truncated": False,
-            },
-        }
-    ]
-    await add_message(conv_id, "assistant", "", status="complete", tool_calls=synthetic_tool_calls)
-
-    # Store user message
-    await add_message(conv_id, "user", "Please summarize and discuss this article.")
-
-    # Reload conversation so history includes the two new messages
-    conv = await get_conversation(uid, conv_id)
-
-    # Build history (using the fixed builder from chat.py logic — duplicated here)
-    history = []
-    for msg in conv.messages:
-        if msg.role == "system":
-            continue
-        msg_dict = {"role": msg.role, "content": msg.content or ""}
-        if msg.tool_calls:
-            msg_dict["tool_calls"] = [
-                {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-                for tc in msg.tool_calls
-            ]
-            history.append(msg_dict)
-            for tc in msg.tool_calls:
-                history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-        else:
-            history.append(msg_dict)
-
-    model = await get_setting(uid, "default_model", "") or ""
-    from fabledassistant.config import Config as _Config
-    if not model:
-        model = _Config.OLLAMA_MODEL
-
-    # Create placeholder assistant message and generation buffer
-    assistant_msg = await add_message(conv_id, "assistant", "", status="generating")
-    try:
-        buf = create_buffer(conv_id, assistant_msg.id)
-    except RuntimeError:
-        return jsonify({"error": "Generation already in progress"}), 409
-
-    asyncio.create_task(run_generation(
-        buf, history, model,
-        uid, conv_id, conv.title,
-        "Please summarize and discuss this article.",
-        think=True,
-    ))
-
-    return jsonify({"assistant_message_id": assistant_msg.id, "status": "generating"}), 202
-```
-
- [ ] **Step 2: Run full test suite**
-
-```bash
-make test
-```
-
-Expected: all pass.
-
- [ ] **Step 3: Update `discussArticle` in BriefingView.vue**
-
-In `frontend/src/views/BriefingView.vue`, replace the `discussArticle` function:
-
-```typescript
-async function discussArticle(item: NewsItem) {
-  if (!todayConvId.value || chatStore.streaming) return
-  if (!isToday.value) selectedConvId.value = todayConvId.value
-  await nextTick(() => {
-    document.querySelector('.briefing-center')?.scrollIntoView({ behavior: 'smooth', block: 'nearest' })
-  })
-  try {
-    await apiPost<{ assistant_message_id: number }>(
-      `/api/briefing/articles/${item.id}/discuss`,
-      { conv_id: todayConvId.value },
-    )
-  } catch {
-    return
-  }
-  // Reload conversation so the new messages appear (including the generating placeholder),
-  // then reconnect to the SSE stream using the existing reconnectIfGenerating helper.
-  await chatStore.fetchConversation(todayConvId.value)
-  await chatStore.reconnectIfGenerating(todayConvId.value)
-}
-```
-
-`reconnectIfGenerating` is already exported from `useChatStore`. It finds the assistant message in `status="generating"` state and connects to the SSE stream automatically. No changes to `chat.ts` are needed.
-
- [ ] **Step 4: TypeScript check**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant
-npm --prefix frontend run type-check
-```
-
-Expected: no errors.
-
- [ ] **Step 5: Commit**
-
-```bash
-git add src/fabledassistant/routes/briefing.py frontend/src/views/BriefingView.vue frontend/src/stores/chat.ts
-git commit -m "feat(briefing): add discuss endpoint and update frontend to use persisted article context"
-```
-
---
-
-## Task 6: Final verification
-
- [ ] **Step 1: Run full test suite**
-
-```bash
-cd /home/bvandeusen/Nextcloud/Projects/fabledassistant
-make test
-```
-
-Expected: all tests pass.
-
- [ ] **Step 2: TypeScript check**
-
-```bash
-npm --prefix frontend run type-check
-```
-
-Expected: no errors.
-
- [ ] **Step 3: Push**
-
-```bash
-git push origin dev
-```
@@ -1,479 +0,0 @@
-# Web Voice Overlay Polish — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Ship the dormant `VoiceOverlay` component by mounting it in `App.vue`, wiring the Space bar shortcut, and replacing push-to-talk with click-to-toggle silence detection backed by a new `useSilenceDetector` composable.
-
-**Architecture:** A new `useSilenceDetector` composable uses `AudioContext` + `AnalyserNode` to monitor amplitude from a live `MediaStream` and fires a callback after sustained silence. `VoiceOverlay` coordinates recording and silence detection, switching from hold-to-record to click-to-toggle. `App.vue` mounts the overlay and adds a Space bar handler that dispatches the existing `voice:ptt-toggle` custom event.
-
-**Tech Stack:** Vue 3 Composition API, TypeScript, Web Audio API (`AudioContext`, `AnalyserNode`), existing `useVoiceRecorder` / `useVoiceAudio` composables.
-
---
-
-## File Map
-
-| Action | Path |
-|--------|------|
-| Create | `frontend/src/composables/useSilenceDetector.ts` |
-| Modify | `frontend/src/composables/useVoiceRecorder.ts` |
-| Modify | `frontend/src/components/VoiceOverlay.vue` |
-| Modify | `frontend/src/App.vue` |
-
---
-
-### Task 1: `useSilenceDetector` composable
-
-**Files:**
- Create: `frontend/src/composables/useSilenceDetector.ts`
-
-**Context:** The Web Audio API lets us pipe a `MediaStream` into an `AnalyserNode` and read frequency data as a byte array every 100 ms. RMS amplitude of that array gives a 0–1 loudness value; converting to dB lets us use the same `-40 dB` threshold as the Android app. The composable must be safe to call `stop()` on multiple times and must reset amplitude to 0 after stopping so the animated bars collapse.
-
- [ ] **Step 1: Create the file with full implementation**
-
-`frontend/src/composables/useSilenceDetector.ts`:
-
-```ts
-import { ref, readonly } from 'vue'
-
-export interface SilenceDetectorOptions {
-  thresholdDb?: number       // default -40
-  silenceDurationMs?: number // default 1500
-  minRecordingMs?: number    // default 500
-}
-
-export function useSilenceDetector(options: SilenceDetectorOptions = {}) {
-  const {
-    thresholdDb = -40,
-    silenceDurationMs = 1500,
-    minRecordingMs = 500,
-  } = options
-
-  const amplitude = ref(0)
-  let audioCtx: AudioContext | null = null
-  let intervalId: ReturnType<typeof setInterval> | null = null
-  let silenceMs = 0
-  let startedAt = 0
-
-  function start(stream: MediaStream, onSilence: () => void): void {
-    stop()
-    audioCtx = new AudioContext()
-    const source = audioCtx.createMediaStreamSource(stream)
-    const analyser = audioCtx.createAnalyser()
-    analyser.fftSize = 256
-    source.connect(analyser)
-
-    const data = new Uint8Array(analyser.frequencyBinCount)
-    silenceMs = 0
-    startedAt = Date.now()
-
-    intervalId = setInterval(() => {
-      analyser.getByteFrequencyData(data)
-      const rms = Math.sqrt(data.reduce((s, v) => s + v * v, 0) / data.length) / 255
-      amplitude.value = rms
-
-      const db = rms > 0 ? 20 * Math.log10(rms) : -100
-      if (db < thresholdDb) {
-        silenceMs += 100
-        if (silenceMs >= silenceDurationMs && Date.now() - startedAt >= minRecordingMs) {
-          stop()
-          onSilence()
-        }
-      } else {
-        silenceMs = 0
-      }
-    }, 100)
-  }
-
-  function stop(): void {
-    if (intervalId !== null) {
-      clearInterval(intervalId)
-      intervalId = null
-    }
-    if (audioCtx) {
-      audioCtx.close().catch(() => {})
-      audioCtx = null
-    }
-    amplitude.value = 0
-    silenceMs = 0
-  }
-
-  return { amplitude: readonly(amplitude), start, stop }
-}
-```
-
- [ ] **Step 2: Verify TypeScript compiles**
-
-```bash
-cd /path/to/fabledassistant/frontend
-npx tsc --noEmit
-```
-
-Expected: no errors.
-
- [ ] **Step 3: Commit**
-
-```bash
-git add frontend/src/composables/useSilenceDetector.ts
-git commit -m "feat: add useSilenceDetector composable with Web Audio API amplitude monitoring"
-```
-
---
-
-### Task 2: Expose `stream` ref from `useVoiceRecorder`
-
-**Files:**
- Modify: `frontend/src/composables/useVoiceRecorder.ts`
-
-**Context:** Currently `stream` is a plain `let` variable inside the closure. `VoiceOverlay` needs to pass the live `MediaStream` to `useSilenceDetector.start()` after recording begins. Exposing it as a readonly `Ref<MediaStream | null>` is the minimal change — no other callers are broken because they don't currently read `stream` from the return value.
-
-The current file is at `frontend/src/composables/useVoiceRecorder.ts`. Read it before editing — the key lines to change are:
-
-1. Top of function body: `let stream: MediaStream | null = null` → `const streamRef = ref<MediaStream | null>(null)`
-2. In `startRecording()`: `stream = await navigator.mediaDevices.getUserMedia({ audio: true })` → `streamRef.value = await navigator.mediaDevices.getUserMedia({ audio: true })`
-3. In `startRecording()` catch block: `stream = null` if present — replace with `streamRef.value = null` (if the catch sets stream to null; if not, skip)
-4. In `mediaRecorder.onstop`: `stream?.getTracks().forEach((t) => t.stop())` → `streamRef.value?.getTracks().forEach((t) => t.stop())` then `streamRef.value = null`
-5. Return object: add `stream: readonly(streamRef)`
-
- [ ] **Step 1: Add the `ref` import if not already present**
-
-The file already imports `{ ref, readonly }` from `'vue'` — confirm this. If `ref` is missing from the import, add it.
-
- [ ] **Step 2: Replace the `stream` variable declaration**
-
-Find:
-```ts
-let stream: MediaStream | null = null
-```
-Replace with:
-```ts
-const streamRef = ref<MediaStream | null>(null)
-```
-
- [ ] **Step 3: Update all usages of `stream` in `startRecording`**
-
-Find:
-```ts
-      stream = await navigator.mediaDevices.getUserMedia({ audio: true })
-```
-Replace with:
-```ts
-      streamRef.value = await navigator.mediaDevices.getUserMedia({ audio: true })
-```
-
- [ ] **Step 4: Update `onstop` handler**
-
-Find:
-```ts
-      stream?.getTracks().forEach((t) => t.stop())
-      stream = null
-```
-Replace with:
-```ts
-      streamRef.value?.getTracks().forEach((t) => t.stop())
-      streamRef.value = null
-```
-
- [ ] **Step 5: Add `stream` to the return object**
-
-Find the return statement and add `stream: readonly(streamRef)`:
-```ts
-  return {
-    recording: readonly(recording),
-    error: readonly(error),
-    isSupported,
-    startRecording,
-    stopRecording,
-    stream: readonly(streamRef),
-  }
-```
-
- [ ] **Step 6: Verify TypeScript compiles**
-
-```bash
-npx tsc --noEmit
-```
-
-Expected: no errors.
-
- [ ] **Step 7: Commit**
-
-```bash
-git add frontend/src/composables/useVoiceRecorder.ts
-git commit -m "feat: expose live stream ref from useVoiceRecorder"
-```
-
---
-
-### Task 3: Update `VoiceOverlay` — silence detection, click-to-toggle, amplitude bars
-
-**Files:**
- Modify: `frontend/src/components/VoiceOverlay.vue`
-
-**Context:** `VoiceOverlay.vue` is a complete floating voice UI that was never mounted. It currently uses `@mousedown`/`@mouseup` for push-to-talk. This task switches it to click-to-toggle with automatic silence detection and adds animated amplitude bars during recording. Read the full file before making changes — the existing structure and style blocks must be preserved.
-
-#### Script changes
-
- [ ] **Step 1: Import `useSilenceDetector`**
-
-At the top of `<script setup>`, after the existing imports, add:
-```ts
-import { useSilenceDetector } from '@/composables/useSilenceDetector'
-```
-
- [ ] **Step 2: Instantiate the composable**
-
-After `const audio = useVoiceAudio()`, add:
-```ts
-const silenceDetector = useSilenceDetector()
-```
-
- [ ] **Step 3: Update `startPtt` to start silence detection**
-
-Find the `startPtt` function. After `phase.value = 'recording'`, add:
-```ts
-  if (recorder.stream.value) {
-    silenceDetector.start(recorder.stream.value, stopPtt)
-  }
-```
-
-The complete `startPtt` after the change:
-```ts
-async function startPtt() {
-  if (!voiceEnabled.value || isBusy.value) return
-  audio.stop()
-  errorMsg.value = ''
-  open.value = true
-  await recorder.startRecording()
-  if (recorder.error.value) {
-    phase.value = 'error'
-    errorMsg.value = recorder.error.value
-    return
-  }
-  phase.value = 'recording'
-  if (recorder.stream.value) {
-    silenceDetector.start(recorder.stream.value, stopPtt)
-  }
-}
-```
-
- [ ] **Step 4: Update `stopPtt` to stop silence detection**
-
-Add `silenceDetector.stop()` as the very first line of `stopPtt`:
-```ts
-async function stopPtt() {
-  silenceDetector.stop()
-  if (phase.value !== 'recording') return
-  // ... rest unchanged
-```
-
- [ ] **Step 5: Update `cancelAll` to stop silence detection**
-
-Add `silenceDetector.stop()` after `recorder.stopRecording().catch(() => {})`:
-```ts
-function cancelAll() {
-  silenceDetector.stop()
-  recorder.stopRecording().catch(() => {})
-  audio.stop()
-  phase.value = 'idle'
-  streamContent.value = ''
-  errorMsg.value = ''
-}
-```
-
- [ ] **Step 6: Add `onBtnClick` function**
-
-Add this function after `cancelAll`:
-```ts
-function onBtnClick() {
-  if (phase.value === 'error') { phase.value = 'idle'; return }
-  if (phase.value === 'recording') { stopPtt(); return }
-  if (phase.value === 'idle') { startPtt() }
-}
-```
-
-#### Template changes
-
- [ ] **Step 7: Replace PTT mouse/touch handlers with `@click`**
-
-On `.voice-ptt-btn`, replace:
-```html
-@mousedown.prevent="startPtt"
-@mouseup.prevent="stopPtt"
-@touchstart.prevent="startPtt"
-@touchend.prevent="stopPtt"
-@click.prevent="phase === 'error' ? (phase = 'idle') : undefined"
-```
-with:
-```html
-@click.prevent="onBtnClick"
-```
-
- [ ] **Step 8: Update aria-label and title on the button**
-
-Replace:
-```html
-:aria-label="phase === 'recording' ? 'Release to send' : 'Hold to speak'"
-:title="phase === 'recording' ? 'Release to send' : 'Hold Space or tap to speak'"
-```
-with:
-```html
-:aria-label="phase === 'recording' ? 'Click to stop' : 'Click to speak'"
-:title="phase === 'recording' ? 'Click to stop or wait for silence' : 'Click or press Space to speak'"
-```
-
- [ ] **Step 9: Replace the static recording icon with amplitude bars**
-
-Find:
-```html
-          <!-- Recording: waveform / stop icon -->
-          <svg v-else-if="phase === 'recording'" width="22" height="22" viewBox="0 0 24 24" fill="currentColor">
-            <path d="M6 19h4V5H6v14zm8-14v14h4V5h-4z"/>
-          </svg>
-```
-Replace with:
-```html
-          <!-- Recording: amplitude bars -->
-          <span v-else-if="phase === 'recording'" class="voice-amp-bars">
-            <span
-              v-for="n in 3"
-              :key="n"
-              class="voice-amp-bar"
-              :style="{ transform: `scaleY(${0.3 + silenceDetector.amplitude.value * (0.4 + n * 0.15)})` }"
-            ></span>
-          </span>
-```
-
- [ ] **Step 10: Update the idle hint label**
-
-Find:
-```html
-          Hold <kbd>Space</kbd> or tap
-```
-Replace with:
-```html
-          Tap or press <kbd>Space</kbd>
-```
-
-#### Style changes
-
- [ ] **Step 11: Add amplitude bar styles to `<style scoped>`**
-
-Append inside the `<style scoped>` block:
-```css
-/* ─── Amplitude bars (recording state) ──────────────────────────────────── */
-.voice-amp-bars {
-  display: flex;
-  gap: 3px;
-  align-items: center;
-  height: 22px;
-}
-.voice-amp-bar {
-  width: 4px;
-  height: 18px;
-  background: #fff;
-  border-radius: 2px;
-  transform-origin: center;
-  transition: transform 0.08s ease;
-}
-```
-
- [ ] **Step 12: Verify TypeScript compiles**
-
-```bash
-npx tsc --noEmit
-```
-
-Expected: no errors.
-
- [ ] **Step 13: Commit**
-
-```bash
-git add frontend/src/components/VoiceOverlay.vue
-git commit -m "feat: click-to-toggle silence detection and amplitude bars in VoiceOverlay"
-```
-
---
-
-### Task 4: Mount `VoiceOverlay` and wire Space bar in `App.vue`
-
-**Files:**
- Modify: `frontend/src/App.vue`
-
-**Context:** `App.vue` has a full `onGlobalKeydown` handler and a shortcuts overlay. The Space bar is already documented there as "Hold to speak (voice, when enabled)" but the handler was never added to `onGlobalKeydown`. `VoiceOverlay` uses `Teleport to="body"` so it renders at the document root regardless of where it's placed in the template — just needs to be inside the authenticated block.
-
-#### Script changes
-
- [ ] **Step 1: Add `VoiceOverlay` import**
-
-In `<script setup>`, after the existing component imports (after `ToastNotification`), add:
-```ts
-import VoiceOverlay from '@/components/VoiceOverlay.vue'
-```
-
- [ ] **Step 2: Add Space bar case to `onGlobalKeydown`**
-
-The existing handler has a `switch (e.key)` block. The guard `if (isInputActive() || e.ctrlKey || e.metaKey || e.altKey) return` already runs before the switch, so the Space case only fires when the user isn't typing.
-
-Inside the `switch (e.key)` block, add this case after the existing `'c'` case:
-```ts
-    case ' ':
-      e.preventDefault()
-      document.dispatchEvent(new CustomEvent('voice:ptt-toggle'))
-      break
-```
-
-#### Template changes
-
- [ ] **Step 3: Mount `VoiceOverlay` in the authenticated template**
-
-Find `<ToastNotification />` near the bottom of the authenticated template block and add `<VoiceOverlay />` directly above it:
-```html
-    <VoiceOverlay />
-    <ToastNotification />
-```
-
- [ ] **Step 4: Update Space bar description in shortcuts panel**
-
-Find:
-```html
-                <span class="shortcut-desc">Hold to speak (voice, when enabled)</span>
-```
-Replace with:
-```html
-                <span class="shortcut-desc">Tap to speak (voice, when enabled)</span>
-```
-
- [ ] **Step 5: Verify TypeScript compiles**
-
-```bash
-npx tsc --noEmit
-```
-
-Expected: no errors.
-
- [ ] **Step 6: Verify full build succeeds**
-
-```bash
-npm run build
-```
-
-Expected: build completes with no errors.
-
- [ ] **Step 7: Manual smoke test**
-
-1. Start the dev server: `npm run dev`
-2. Log in — confirm the floating mic button appears in the bottom-right corner
-3. Ensure voice is enabled in Settings → Voice
-4. Click the mic button — confirm it turns red with animated amplitude bars
-5. Speak — bars should animate with your voice
-6. Stop speaking — after ~1.5 s of silence, the button should switch to purple (transcribing), then green (speaking) as it plays back the response
-7. Click the mic while recording — confirm it stops immediately
-8. Press Space (not in an input field) — confirm it starts/stops recording
-9. Press Space in the chat input — confirm it does NOT trigger voice
-
- [ ] **Step 8: Commit**
-
-```bash
-git add frontend/src/App.vue
-git commit -m "feat: mount VoiceOverlay and wire Space bar shortcut in App.vue"
-```
@@ -1,746 +0,0 @@
-# Knowledge View Task Consolidation — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Consolidate tasks into the Knowledge view as a fifth card type, deprecate `/notes` and `/tasks` list routes, and simplify navigation down to a single Knowledge hub.
-
-**Architecture:** The backend knowledge service (`services/knowledge.py`) stops excluding tasks from queries and adds `type=task` filtering via the `is_task` property (`Note.status IS NOT NULL`). The knowledge route validation gains `"task"` as a valid type. The frontend KnowledgeView gains task card rendering with status/priority/due-date badges. Router redirects replace the deleted list views.
-
-**Tech Stack:** Python/Quart backend (SQLAlchemy), Vue 3 + TypeScript frontend, Pinia stores, Vue Router.
-
---
-
-## File Map
-
-| Action | Path |
-|--------|------|
-| Modify | `src/fabledassistant/services/knowledge.py` |
-| Modify | `src/fabledassistant/routes/knowledge.py` |
-| Modify | `frontend/src/views/KnowledgeView.vue` |
-| Modify | `frontend/src/router/index.ts` |
-| Modify | `frontend/src/components/AppHeader.vue` |
-| Modify | `frontend/src/App.vue` |
-| Delete | `frontend/src/views/NotesListView.vue` |
-| Delete | `frontend/src/views/TasksListView.vue` |
-
---
-
-### Task 1: Backend — Include tasks in knowledge queries
-
-**Files:**
- Modify: `src/fabledassistant/services/knowledge.py`
- Modify: `src/fabledassistant/routes/knowledge.py`
-
-**Context:** The knowledge service currently excludes tasks by filtering `Note.status.is_(None)`. Every query function (`query_knowledge`, `query_knowledge_ids`, `_semantic_knowledge_search`, `get_knowledge_tags`, `get_knowledge_counts`) has this exclusion. Adding task support means: (1) removing the task exclusion from the "all types" queries, (2) adding `type=task` as a filter option that maps to `Note.status.isnot(None)`, (3) enriching `_note_to_item` with task-specific fields, (4) updating counts to include tasks.
-
- [ ] **Step 1: Add `"task"` to `_VALID_TYPES` in the route file**
-
-In `src/fabledassistant/routes/knowledge.py`, change:
-
-```python
-_VALID_TYPES = {"note", "person", "place", "list"}
-```
-
-to:
-
-```python
-_VALID_TYPES = {"note", "person", "place", "list", "task"}
-```
-
- [ ] **Step 2: Update `_note_to_item` to include task fields**
-
-In `src/fabledassistant/services/knowledge.py`, the `_note_to_item` function builds the item dict. After the existing `elif note.entity_type == "list":` block (which ends around line 48), add a task branch. Find:
-
-```python
-    elif note.entity_type == "list":
-        # Parse markdown task list syntax into structured items
-        body = note.body or ""
-        list_items = []
-        for line in body.split("\n"):
-            stripped = line.strip()
-            if stripped.startswith("- [ ] ") or stripped.startswith("- [x] ") or stripped.startswith("- [X] "):
-                checked_item = not stripped.startswith("- [ ] ")
-                list_items.append({"text": stripped[6:], "checked": checked_item})
-        item["list_items"] = list_items
-        item["item_count"] = len(list_items)
-        item["checked_count"] = sum(1 for i in list_items if i["checked"])
-        item["body"] = body
-    return item
-```
-
-Replace with:
-
-```python
-    elif note.entity_type == "list":
-        # Parse markdown task list syntax into structured items
-        body = note.body or ""
-        list_items = []
-        for line in body.split("\n"):
-            stripped = line.strip()
-            if stripped.startswith("- [ ] ") or stripped.startswith("- [x] ") or stripped.startswith("- [X] "):
-                checked_item = not stripped.startswith("- [ ] ")
-                list_items.append({"text": stripped[6:], "checked": checked_item})
-        item["list_items"] = list_items
-        item["item_count"] = len(list_items)
-        item["checked_count"] = sum(1 for i in list_items if i["checked"])
-        item["body"] = body
-
-    # Task fields — included for all items but only meaningful when is_task
-    if note.is_task:
-        item["note_type"] = "task"
-        item["status"] = note.status
-        item["priority"] = note.priority
-        item["due_date"] = note.due_date.isoformat() if note.due_date else None
-
-    return item
-```
-
-This overrides `note_type` to `"task"` for task items (since `entity_type` returns the `note_type` column which is `"note"` for tasks) and adds status/priority/due_date fields.
-
- [ ] **Step 3: Update `query_knowledge` to include tasks**
-
-In the `query_knowledge` function, the "all types" filter currently excludes tasks. Change the base query and the `else` branch.
-
-Find:
-
-```python
-        base = (
-            select(Note)
-            .where(Note.user_id == user_id)
-            .where(Note.status.is_(None))  # exclude tasks
-        )
-
-        if note_type:
-            base = base.where(Note.note_type == note_type)
-        else:
-            # Exclude tasks — already done above; also exclude any legacy nulls
-            base = base.where(Note.note_type.in_(["note", "person", "place", "list"]))
-```
-
-Replace with:
-
-```python
-        base = select(Note).where(Note.user_id == user_id)
-
-        if note_type == "task":
-            base = base.where(Note.status.isnot(None))
-        elif note_type:
-            base = base.where(Note.note_type == note_type).where(Note.status.is_(None))
-        else:
-            # All types including tasks
-            pass
-```
-
- [ ] **Step 4: Update `_semantic_knowledge_search` to include tasks**
-
-Find:
-
-```python
-        candidates = await semantic_search_notes(
-            user_id=user_id,
-            query=q,
-            limit=min(200, limit * 8),
-            threshold=0.3,
-            is_task=False,
-        )
-```
-
-Replace with:
-
-```python
-        is_task_filter = True if note_type == "task" else (False if note_type else None)
-        candidates = await semantic_search_notes(
-            user_id=user_id,
-            query=q,
-            limit=min(200, limit * 8),
-            threshold=0.3,
-            is_task=is_task_filter,
-        )
-```
-
-Also update the type matching in the filter loop — find:
-
-```python
-    for _score, note in candidates:
-        if note_type and note.entity_type != note_type:
-            continue
-```
-
-Replace with:
-
-```python
-    for _score, note in candidates:
-        if note_type == "task" and not note.is_task:
-            continue
-        elif note_type and note_type != "task" and note.entity_type != note_type:
-            continue
-```
-
- [ ] **Step 5: Update `query_knowledge_ids` to include tasks**
-
-Find:
-
-```python
-        base = (
-            select(Note.id)
-            .where(Note.user_id == user_id)
-            .where(Note.status.is_(None))
-        )
-        if note_type:
-            base = base.where(Note.note_type == note_type)
-        else:
-            base = base.where(Note.note_type.in_(["note", "person", "place", "list"]))
-```
-
-Replace with:
-
-```python
-        base = select(Note.id).where(Note.user_id == user_id)
-
-        if note_type == "task":
-            base = base.where(Note.status.isnot(None))
-        elif note_type:
-            base = base.where(Note.note_type == note_type).where(Note.status.is_(None))
-        else:
-            pass
-```
-
- [ ] **Step 6: Update `get_knowledge_tags` to include task tags**
-
-Find:
-
-```python
-        base = (
-            select(func.unnest(Note.tags).label("tag"))
-            .where(Note.user_id == user_id)
-            .where(Note.status.is_(None))
-        )
-        if note_type:
-            base = base.where(Note.note_type == note_type)
-        else:
-            base = base.where(Note.note_type.in_(["note", "person", "place", "list"]))
-```
-
-Replace with:
-
-```python
-        base = (
-            select(func.unnest(Note.tags).label("tag"))
-            .where(Note.user_id == user_id)
-        )
-        if note_type == "task":
-            base = base.where(Note.status.isnot(None))
-        elif note_type:
-            base = base.where(Note.note_type == note_type).where(Note.status.is_(None))
-        else:
-            pass
-```
-
- [ ] **Step 7: Update `get_knowledge_counts` to include tasks**
-
-Find:
-
-```python
-    async with async_session() as session:
-        stmt = (
-            select(Note.note_type, func.count(Note.id))
-            .where(Note.user_id == user_id)
-            .where(Note.status.is_(None))
-            .where(Note.note_type.in_(["note", "person", "place", "list"]))
-            .group_by(Note.note_type)
-        )
-        if tags:
-            for tag in tags:
-                stmt = stmt.where(Note.tags.contains([tag]))
-        rows = list((await session.execute(stmt)).all())
-    counts = {row[0]: row[1] for row in rows}
-    # Ensure all types present even if zero
-    for t in ("note", "person", "place", "list"):
-        counts.setdefault(t, 0)
-    counts["total"] = sum(counts[t] for t in ("note", "person", "place", "list"))
-    return counts
-```
-
-Replace with:
-
-```python
-    async with async_session() as session:
-        # Count non-task types
-        stmt = (
-            select(Note.note_type, func.count(Note.id))
-            .where(Note.user_id == user_id)
-            .where(Note.status.is_(None))
-            .where(Note.note_type.in_(["note", "person", "place", "list"]))
-            .group_by(Note.note_type)
-        )
-        if tags:
-            for tag in tags:
-                stmt = stmt.where(Note.tags.contains([tag]))
-        rows = list((await session.execute(stmt)).all())
-        counts = {row[0]: row[1] for row in rows}
-
-        # Count tasks separately (is_task = status IS NOT NULL)
-        task_stmt = (
-            select(func.count(Note.id))
-            .where(Note.user_id == user_id)
-            .where(Note.status.isnot(None))
-        )
-        if tags:
-            for tag in tags:
-                task_stmt = task_stmt.where(Note.tags.contains([tag]))
-        task_count: int = (await session.execute(task_stmt)).scalar_one()
-        counts["task"] = task_count
-
-    for t in ("note", "person", "place", "list", "task"):
-        counts.setdefault(t, 0)
-    counts["total"] = sum(counts[t] for t in ("note", "person", "place", "list", "task"))
-    return counts
-```
-
- [ ] **Step 8: Verify backend changes**
-
-```bash
-cd /path/to/fabledassistant
-make typecheck
-make test
-```
-
-Expected: no errors.
-
- [ ] **Step 9: Commit**
-
-```bash
-git add src/fabledassistant/services/knowledge.py src/fabledassistant/routes/knowledge.py
-git commit -m "feat(knowledge): include tasks in knowledge queries and counts"
-```
-
---
-
-### Task 2: Frontend — Task card rendering in KnowledgeView
-
-**Files:**
- Modify: `frontend/src/views/KnowledgeView.vue`
-
-**Context:** `KnowledgeView.vue` has a `KnowledgeItem` interface and renders cards in a grid. Each card type has type-specific content (person shows relationship/email, list shows checkboxes, etc.). Task cards need status, priority, and due date display. The `activeType` ref controls filtering; it needs `"task"` as a valid value. The type filter sidebar needs a "Tasks" button. The new-note button interaction changes from split-button to toggle.
-
- [ ] **Step 1: Add `"task"` to the KnowledgeItem interface and filter type**
-
-In the `<script setup>` section, find the `KnowledgeItem` interface and add task fields:
-
-```ts
-interface KnowledgeItem {
-  id: number;
-  note_type: "note" | "person" | "place" | "list";
-  // ... existing fields
-```
-
-Change to:
-
-```ts
-interface KnowledgeItem {
-  id: number;
-  note_type: "note" | "person" | "place" | "list" | "task";
-  // ... existing fields
-```
-
-Also add the task-specific fields at the end of the interface (before the closing `}`):
-
-```ts
-  // Task-specific
-  status?: string;
-  priority?: string;
-  due_date?: string;
-```
-
-Update the `activeType` ref type:
-
-```ts
-const activeType = ref<"" | "note" | "person" | "place" | "list">(""); 
-```
-
-Change to:
-
-```ts
-const activeType = ref<"" | "note" | "person" | "place" | "list" | "task">("");
-```
-
- [ ] **Step 2: Add "Tasks" to the type filter sidebar**
-
-Find the type filter `v-for` in the template:
-
-```html
-          <button
-            v-for="[val, label, key] in ([['note','Notes','note'],['person','People','person'],['place','Places','place'],['list','Lists','list']] as [string,string,string][])"
-```
-
-Replace with:
-
-```html
-          <button
-            v-for="[val, label, key] in ([['note','Notes','note'],['task','Tasks','task'],['person','People','person'],['place','Places','place'],['list','Lists','list']] as [string,string,string][])"
-```
-
-Update the type cast on the click handler. Find:
-
-```html
-            @click="activeType = (val as '' | 'note' | 'person' | 'place' | 'list')"
-```
-
-Replace with:
-
-```html
-            @click="activeType = (val as '' | 'note' | 'person' | 'place' | 'list' | 'task')"
-```
-
- [ ] **Step 3: Add task card content in the template**
-
-In the card grid, find the note snippet section:
-
-```html
-              <!-- Note snippet -->
-              <p v-else-if="item.snippet" class="k-card-snippet">{{ item.snippet }}</p>
-```
-
-Add a task-specific section above it:
-
-```html
-              <!-- Task specifics -->
-              <div v-else-if="item.note_type === 'task'" class="k-card-task">
-                <div class="task-badges">
-                  <span class="status-badge" :class="`status--${item.status}`">
-                    {{ item.status === 'in_progress' ? 'in progress' : item.status }}
-                  </span>
-                  <span
-                    v-if="item.priority && item.priority !== 'none'"
-                    class="priority-badge"
-                    :class="`priority--${item.priority}`"
-                  >{{ item.priority }}</span>
-                </div>
-                <span
-                  v-if="item.due_date"
-                  class="task-due"
-                  :class="{ 'task-overdue': isOverdue(item) }"
-                >{{ formatDate(item.due_date) }}</span>
-                <p v-if="item.snippet" class="k-card-snippet">{{ item.snippet }}</p>
-              </div>
-
-              <!-- Note snippet -->
-              <p v-else-if="item.snippet" class="k-card-snippet">{{ item.snippet }}</p>
-```
-
- [ ] **Step 4: Add `isOverdue` helper and update `openItem` for tasks**
-
-In the `<script setup>`, add after the `formatDate` function:
-
-```ts
-function isOverdue(item: KnowledgeItem): boolean {
-  if (!item.due_date || item.status === 'done' || item.status === 'cancelled') return false;
-  return new Date(item.due_date) < new Date(new Date().toDateString());
-}
-```
-
-Update `openItem` to route tasks to their editor:
-
-```ts
-function openItem(item: KnowledgeItem) {
-  if (item.note_type === 'task') {
-    router.push(`/tasks/${item.id}`);
-  } else {
-    router.push(`/notes/${item.id}`);
-  }
-}
-```
-
- [ ] **Step 5: Update the "New note" button to toggle interaction**
-
-Find the current new-note button markup:
-
-```html
-        <div class="new-note-wrap">
-          <button class="btn-new-note" @click="createNew('note')">+ New note</button>
-          <button class="btn-new-chevron" @click="newNoteMenuOpen = !newNoteMenuOpen" :class="{ open: newNoteMenuOpen }" title="Create specific type">▾</button>
-          <div v-if="newNoteMenuOpen" class="new-note-menu">
-            <button @click="createNew('note')">Note</button>
-            <button @click="createNew('person')">Person</button>
-            <button @click="createNew('place')">Place</button>
-            <button @click="createNew('list')">List</button>
-          </div>
-        </div>
-```
-
-Replace with:
-
-```html
-        <div class="new-note-wrap">
-          <button class="btn-new-note" @click="newNoteMenuOpen ? createNew('note') : (newNoteMenuOpen = true)">+ New note</button>
-          <div v-if="newNoteMenuOpen" class="new-note-menu">
-            <button @click="createNew('task')">Task</button>
-            <button @click="createNew('person')">Person</button>
-            <button @click="createNew('place')">Place</button>
-            <button @click="createNew('list')">List</button>
-          </div>
-        </div>
-```
-
-Add a click-outside handler. In the `<script setup>`, add after the `createNew` function:
-
-```ts
-function onClickOutsideNewNote(e: MouseEvent) {
-  const wrap = document.querySelector('.new-note-wrap');
-  if (wrap && !wrap.contains(e.target as Node)) {
-    newNoteMenuOpen.value = false;
-  }
-}
-```
-
-In `onMounted`, add:
-
-```ts
-document.addEventListener('click', onClickOutsideNewNote);
-```
-
-In `onUnmounted`, add:
-
-```ts
-document.removeEventListener('click', onClickOutsideNewNote);
-```
-
- [ ] **Step 6: Add task card CSS**
-
-Append to the `<style scoped>` block:
-
-```css
-/* ── Task card ──────────────────────────────────────────── */
-.k-card--task { border-left: 3px solid #a78bfa; }
-
-.k-card-task {
-  display: flex;
-  flex-direction: column;
-  gap: 6px;
-}
-.task-badges {
-  display: flex;
-  gap: 5px;
-  flex-wrap: wrap;
-}
-.status-badge {
-  font-size: 0.7rem;
-  padding: 1px 7px;
-  border-radius: 8px;
-  font-weight: 600;
-}
-.status--todo { background: var(--color-status-todo-bg); color: var(--color-status-todo); }
-.status--in_progress { background: var(--color-status-in-progress-bg); color: var(--color-status-in-progress); }
-.status--done { background: var(--color-status-done-bg); color: var(--color-status-done); }
-.status--cancelled { background: var(--color-status-todo-bg); color: var(--color-status-todo); text-decoration: line-through; }
-
-.priority-badge {
-  font-size: 0.7rem;
-  padding: 1px 7px;
-  border-radius: 8px;
-  font-weight: 600;
-}
-.priority--low { background: var(--color-priority-low-bg); color: var(--color-priority-low); }
-.priority--normal { background: var(--color-priority-medium-bg); color: var(--color-priority-medium); }
-.priority--high { background: var(--color-priority-high-bg); color: var(--color-priority-high); }
-
-.task-due {
-  font-size: 0.78rem;
-  color: var(--color-text-muted);
-}
-.task-overdue {
-  color: var(--color-overdue);
-  font-weight: 500;
-}
-```
-
-Also add the task type badge color. Find:
-
-```css
-.badge--list   { background: rgba(56,189,248,0.15); color: #7dd3fc; }
-```
-
-Add after it:
-
-```css
-.badge--task   { background: rgba(167,139,250,0.15); color: #a78bfa; }
-```
-
- [ ] **Step 7: Remove the chevron button CSS**
-
-Find and delete:
-
-```css
-.btn-new-chevron {
-  padding: 7px 9px;
-  border-radius: 0 8px 8px 0;
-  border: 1px solid rgba(99, 102, 241, 0.4);
-  background: rgba(99, 102, 241, 0.12);
-  color: var(--color-primary, #818cf8);
-  cursor: pointer;
-  font-size: 0.78rem;
-  line-height: 1;
-  transition: background 0.15s, transform 0.15s;
-}
-.btn-new-chevron:hover { background: rgba(99, 102, 241, 0.2); }
-.btn-new-chevron.open { transform: scaleY(-1); }
-```
-
-Update `.btn-new-note` to have full border-radius now that the chevron is gone:
-
-```css
-.btn-new-note {
-  flex: 1;
-  padding: 7px 10px;
-  border-radius: 8px;
-  border: 1px solid rgba(99, 102, 241, 0.4);
-  background: rgba(99, 102, 241, 0.12);
-  color: var(--color-primary, #818cf8);
-  cursor: pointer;
-  font-size: 0.85rem;
-  font-weight: 500;
-  text-align: left;
-  transition: background 0.15s;
-}
-```
-
- [ ] **Step 8: Verify TypeScript compiles**
-
-```bash
-cd /path/to/fabledassistant/frontend
-npx tsc --noEmit
-```
-
-Expected: no new errors (pre-existing TipTap errors are fine).
-
- [ ] **Step 9: Commit**
-
-```bash
-git add frontend/src/views/KnowledgeView.vue
-git commit -m "feat(knowledge): add task cards with status/priority/due-date display"
-```
-
---
-
-### Task 3: Route redirects, navigation cleanup, dead code removal
-
-**Files:**
- Modify: `frontend/src/router/index.ts`
- Modify: `frontend/src/components/AppHeader.vue`
- Modify: `frontend/src/App.vue`
- Delete: `frontend/src/views/NotesListView.vue`
- Delete: `frontend/src/views/TasksListView.vue`
-
-**Context:** The router currently has `/notes` and `/tasks` pointing to list view components. These become redirects to `/`. The AppHeader has "Tasks" in both desktop and mobile nav. The `g+t` keyboard shortcut navigates to `/tasks` which should change to `/`. The stores (`notes.ts`, `tasks.ts`) are used by other views so they stay.
-
- [ ] **Step 1: Replace list view routes with redirects**
-
-In `frontend/src/router/index.ts`, find:
-
-```ts
-    {
-      path: "/notes",
-      name: "notes",
-      component: () => import("@/views/NotesListView.vue"),
-    },
-```
-
-Replace with:
-
-```ts
-    {
-      path: "/notes",
-      redirect: "/",
-    },
-```
-
-Find:
-
-```ts
-    {
-      path: "/tasks",
-      name: "tasks",
-      component: () => import("@/views/TasksListView.vue"),
-    },
-```
-
-Replace with:
-
-```ts
-    {
-      path: "/tasks",
-      redirect: "/",
-    },
-```
-
- [ ] **Step 2: Remove "Tasks" from AppHeader navigation**
-
-In `frontend/src/components/AppHeader.vue`, find in the desktop nav-center:
-
-```html
-        <router-link to="/tasks" class="nav-link">Tasks</router-link>
-```
-
-Delete this line.
-
-Find in the mobile dropdown menu:
-
-```html
-      <router-link to="/tasks" class="nav-link">Tasks</router-link>
-```
-
-Delete this line.
-
- [ ] **Step 3: Update `g+t` keyboard shortcut in App.vue**
-
-In `frontend/src/App.vue`, find in the `onGlobalKeydown` function, inside the `if (pendingPrefix === "g")` block:
-
-```ts
-      case "t": router.push("/tasks"); break;
-```
-
-Replace with:
-
-```ts
-      case "t": router.push("/"); break;
-```
-
- [ ] **Step 4: Update shortcuts overlay text**
-
-In `frontend/src/App.vue`, find in the shortcuts overlay template:
-
-```html
-                <kbd class="shortcut-key">t</kbd>
-                <span class="shortcut-desc">Tasks</span>
-```
-
-Replace the description:
-
-```html
-                <kbd class="shortcut-key">t</kbd>
-                <span class="shortcut-desc">Knowledge (tasks)</span>
-```
-
- [ ] **Step 5: Delete the deprecated list view files**
-
-```bash
-rm frontend/src/views/NotesListView.vue
-rm frontend/src/views/TasksListView.vue
-```
-
- [ ] **Step 6: Verify build**
-
-```bash
-cd /path/to/fabledassistant/frontend
-npx tsc --noEmit
-```
-
-Expected: no new errors. The deleted files were only imported via lazy `() => import(...)` in the router, which we already replaced with redirects.
-
- [ ] **Step 7: Commit**
-
-```bash
-git add -A frontend/src/views/NotesListView.vue frontend/src/views/TasksListView.vue \
-  frontend/src/router/index.ts frontend/src/components/AppHeader.vue frontend/src/App.vue
-git commit -m "feat: deprecate /notes and /tasks routes; redirect to Knowledge view"
-```
@@ -1,786 +0,0 @@
-# Specialized Note Type Editors — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Replace the generic note editor with type-specialized form-first views for Person, Place, and List, and fix tab navigation so focus flows logically from title through content fields, skipping the formatting toolbar.
-
-**Architecture:** `NoteEditorView.vue` gains type-conditional template sections. When `noteType` is `person` or `place`, the main editor area renders a structured form with the TipTap editor in a secondary "Notes" section. When `noteType` is `list`, a dedicated list builder replaces TipTap as the primary interface. `MarkdownToolbar.vue` gets `tabindex="-1"` on buttons. Backend `_note_to_item` gains new person/place fields.
-
-**Tech Stack:** Vue 3 Composition API, TipTap editor, TypeScript, scoped CSS.
-
---
-
-## File Map
-
-| Action | Path |
-|--------|------|
-| Modify | `frontend/src/views/NoteEditorView.vue` |
-| Modify | `frontend/src/components/MarkdownToolbar.vue` |
-| Modify | `frontend/src/views/KnowledgeView.vue` |
-| Modify | `src/fabledassistant/services/knowledge.py` |
-
---
-
-### Task 1: Tab navigation fix — toolbar tabindex + auto-focus
-
-**Files:**
- Modify: `frontend/src/components/MarkdownToolbar.vue`
- Modify: `frontend/src/views/NoteEditorView.vue`
-
-**Context:** The MarkdownToolbar renders buttons via `v-for` in a single `<button>` element. Adding `tabindex="-1"` removes them from tab order while keeping them clickable. The NoteEditorView already has a `titleRef` — auto-focus on mount needs to call `.focus()` on it. The title placeholder should vary by note type.
-
- [ ] **Step 1: Add tabindex="-1" to toolbar buttons**
-
-In `frontend/src/components/MarkdownToolbar.vue`, find:
-
-```html
-        <button
-          v-for="btn in group"
-          :key="btn.id"
-          :class="['md-btn', { active: btn.isActive() }]"
-          :title="btn.title"
-          type="button"
-          @mousedown.prevent="btn.command()"
-        >
-```
-
-Replace with:
-
-```html
-        <button
-          v-for="btn in group"
-          :key="btn.id"
-          :class="['md-btn', { active: btn.isActive() }]"
-          :title="btn.title"
-          type="button"
-          tabindex="-1"
-          @mousedown.prevent="btn.command()"
-        >
-```
-
- [ ] **Step 2: Add auto-focus on mount and type-dependent placeholder**
-
-In `frontend/src/views/NoteEditorView.vue`, find the title input:
-
-```html
-      <input
-        ref="titleRef"
-        v-model="title"
-        type="text"
-        placeholder="Title"
-        class="title-input"
-```
-
-Replace with:
-
-```html
-      <input
-        ref="titleRef"
-        v-model="title"
-        type="text"
-        :placeholder="titlePlaceholder"
-        class="title-input"
-```
-
-Add the computed property in the `<script setup>` section, after the `isEditing` computed:
-
-```ts
-const titlePlaceholder = computed(() => {
-  switch (noteType.value) {
-    case 'person': return 'Name';
-    case 'place': return 'Place name';
-    case 'list': return 'List title';
-    default: return 'Title';
-  }
-});
-```
-
- [ ] **Step 3: Auto-focus title on mount**
-
-In the `onMounted` callback, after all the data loading logic (after the draft restore try/catch block), add:
-
-```ts
-  await nextTick();
-  titleRef.value?.focus();
-```
-
- [ ] **Step 4: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 5: Commit**
-
-```bash
-git add frontend/src/components/MarkdownToolbar.vue frontend/src/views/NoteEditorView.vue
-git commit -m "feat(editor): skip toolbar in tab order; auto-focus title; type-dependent placeholders"
-```
-
---
-
-### Task 2: Person editor — form-first layout
-
-**Files:**
- Modify: `frontend/src/views/NoteEditorView.vue`
-
-**Context:** When `noteType === 'person'`, the main content area should render a contact card form instead of the TipTap-first editor. The person metadata fields (currently in the sidebar) move to the main area, and new fields (birthday, organization, address) are added. The TipTap editor becomes a collapsible "Notes" section below. The sidebar keeps project/tags/type/etc but loses the person-specific fields.
-
- [ ] **Step 1: Add the person form template**
-
-In the template, find the `<!-- ── Main column ──` section. The current structure is:
-
-```html
-      <div class="note-main" @keydown.ctrl.e.prevent="tiptapEditor?.commands.focus()">
-        <div class="body-tabs-row">
-          ...
-        </div>
-        <!-- Streaming/Review/Normal editor templates -->
-      </div>
-```
-
-Wrap the existing main column content in a `v-if="noteType === 'note'"` (and also show it for any type not person/place/list), and add a person form block. Replace the opening of the main column content:
-
-Find the `<div class="note-main"` line and the content inside it up to `</div>` that closes `.note-main`. Wrap all existing content inside:
-
-```html
-      <div class="note-main">
-        <!-- ── Person form ──────────────────────────────────────── -->
-        <template v-if="noteType === 'person'">
-          <div class="entity-form">
-            <div class="ef-field">
-              <label class="ef-label">Relationship</label>
-              <input class="ef-input" v-model="entityMeta.relationship" placeholder="e.g. Friend, Colleague, Family" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Birthday</label>
-              <input class="ef-input" type="date" v-model="entityMeta.birthday" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Email</label>
-              <input class="ef-input" type="email" v-model="entityMeta.email" placeholder="email@example.com" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Phone</label>
-              <input class="ef-input" type="tel" v-model="entityMeta.phone" placeholder="+1 555 000 0000" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Organization</label>
-              <input class="ef-input" v-model="entityMeta.organization" placeholder="Company or organization" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Address</label>
-              <input class="ef-input" v-model="entityMeta.address" placeholder="Street, City, State" @input="markDirty" />
-            </div>
-          </div>
-          <div class="notes-section">
-            <button class="notes-toggle" @click="notesExpanded = !notesExpanded">
-              {{ notesExpanded ? '▾' : '▸' }} Notes
-            </button>
-            <div v-if="notesExpanded" class="notes-editor-wrap">
-              <MarkdownToolbar v-show="!showPreview" :editor="tiptapEditor" />
-              <TiptapEditor
-                ref="editorRef"
-                :modelValue="body"
-                placeholder="Additional notes, wikilinks, context..."
-                @update:modelValue="onBodyUpdate"
-                @escape="titleRef?.focus()"
-              />
-            </div>
-          </div>
-        </template>
-
-        <!-- ── Generic note editor (existing) ───────────────────── -->
-        <template v-else-if="noteType === 'note'">
-          <!-- ... existing TipTap-first editor content stays here ... -->
-        </template>
-      </div>
-```
-
-IMPORTANT: Do NOT duplicate the existing editor content. Wrap the existing content in `<template v-else-if="noteType === 'note'">` and place the person form as a sibling `<template>` above it. The place and list forms will be added in subsequent tasks.
-
- [ ] **Step 2: Add `notesExpanded` ref**
-
-In the `<script setup>`, after the `sidebarOpen` ref, add:
-
-```ts
-const notesExpanded = ref(false);
-```
-
-Also initialize it based on whether the note has body content, in the onMounted data-loading section. After `Object.assign(entityMeta, store.currentNote.metadata || {});` add:
-
-```ts
-      notesExpanded.value = !!(store.currentNote.body || '').trim();
-```
-
- [ ] **Step 3: Remove person fields from sidebar**
-
-In the sidebar template, find:
-
-```html
-          <!-- Person metadata -->
-          <template v-if="noteType === 'person'">
-            <div class="sb-field">
-              <label class="sb-label">Relationship</label>
-              <input class="sb-input" v-model="entityMeta.relationship" placeholder="e.g. Friend, Colleague" @input="markDirty" />
-            </div>
-            <div class="sb-field">
-              <label class="sb-label">Email</label>
-              <input class="sb-input" v-model="entityMeta.email" type="email" placeholder="email@example.com" @input="markDirty" />
-            </div>
-            <div class="sb-field">
-              <label class="sb-label">Phone</label>
-              <input class="sb-input" v-model="entityMeta.phone" type="tel" placeholder="+1 555 000 0000" @input="markDirty" />
-            </div>
-          </template>
-```
-
-Delete this entire block.
-
- [ ] **Step 4: Add entity form CSS**
-
-Add to the `<style scoped>` block:
-
-```css
-/* ── Entity form (Person / Place) ───────────────────────── */
-.entity-form {
-  display: flex;
-  flex-direction: column;
-  gap: 12px;
-  padding: 16px 0;
-}
-.ef-field {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-}
-.ef-label {
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  font-size: 0.78rem;
-  color: var(--color-primary);
-}
-.ef-input {
-  padding: 8px 12px;
-  border: 1px solid var(--color-border);
-  border-radius: 8px;
-  background: var(--color-surface);
-  color: var(--color-text);
-  font-size: 0.9rem;
-  font-family: inherit;
-  outline: none;
-  transition: border-color 0.15s;
-}
-.ef-input:focus {
-  border-color: var(--color-primary);
-  box-shadow: var(--focus-ring);
-}
-.ef-input::placeholder {
-  color: var(--color-text-muted);
-}
-
-/* ── Notes section (collapsible TipTap) ─────────────────── */
-.notes-section {
-  margin-top: 16px;
-  border-top: 1px solid var(--color-border);
-  padding-top: 12px;
-}
-.notes-toggle {
-  background: none;
-  border: none;
-  color: var(--color-primary);
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  font-size: 0.85rem;
-  cursor: pointer;
-  padding: 4px 0;
-}
-.notes-toggle:hover {
-  color: var(--color-text);
-}
-.notes-editor-wrap {
-  margin-top: 8px;
-}
-```
-
- [ ] **Step 5: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 6: Commit**
-
-```bash
-git add frontend/src/views/NoteEditorView.vue
-git commit -m "feat(editor): person form-first layout with structured fields and collapsible notes"
-```
-
---
-
-### Task 3: Place editor + List builder
-
-**Files:**
- Modify: `frontend/src/views/NoteEditorView.vue`
-
-**Context:** Place uses the same entity form pattern as Person with different fields. List uses a dedicated checklist builder with Enter-to-add and Backspace-to-delete behavior. Both are additional `<template>` branches in the main column.
-
- [ ] **Step 1: Add place form template**
-
-In the `note-main` div, after the person `</template>` and before the generic note `<template v-else-if="noteType === 'note'">`, add:
-
-```html
-        <!-- ── Place form ───────────────────────────────────────── -->
-        <template v-else-if="noteType === 'place'">
-          <div class="entity-form">
-            <div class="ef-field">
-              <label class="ef-label">Address</label>
-              <input class="ef-input" v-model="entityMeta.address" placeholder="Street, City, State" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Phone</label>
-              <input class="ef-input" type="tel" v-model="entityMeta.phone" placeholder="+1 555 000 0000" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Hours</label>
-              <input class="ef-input" v-model="entityMeta.hours" placeholder="e.g. Mon–Fri 9am–5pm" @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Website</label>
-              <input class="ef-input" type="url" v-model="entityMeta.website" placeholder="https://..." @input="markDirty" />
-            </div>
-            <div class="ef-field">
-              <label class="ef-label">Category</label>
-              <input class="ef-input" v-model="entityMeta.category" placeholder="e.g. Restaurant, Office, Doctor" @input="markDirty" />
-            </div>
-          </div>
-          <div class="notes-section">
-            <button class="notes-toggle" @click="notesExpanded = !notesExpanded">
-              {{ notesExpanded ? '▾' : '▸' }} Notes
-            </button>
-            <div v-if="notesExpanded" class="notes-editor-wrap">
-              <MarkdownToolbar v-show="!showPreview" :editor="tiptapEditor" />
-              <TiptapEditor
-                ref="editorRef"
-                :modelValue="body"
-                placeholder="Additional notes, wikilinks, context..."
-                @update:modelValue="onBodyUpdate"
-                @escape="titleRef?.focus()"
-              />
-            </div>
-          </div>
-        </template>
-```
-
- [ ] **Step 2: Remove place fields from sidebar**
-
-Find and delete:
-
-```html
-          <!-- Place metadata -->
-          <template v-if="noteType === 'place'">
-            <div class="sb-field">
-              <label class="sb-label">Address</label>
-              <input class="sb-input" v-model="entityMeta.address" placeholder="Street, City" @input="markDirty" />
-            </div>
-            <div class="sb-field">
-              <label class="sb-label">Phone</label>
-              <input class="sb-input" v-model="entityMeta.phone" type="tel" placeholder="+1 555 000 0000" @input="markDirty" />
-            </div>
-            <div class="sb-field">
-              <label class="sb-label">Hours</label>
-              <input class="sb-input" v-model="entityMeta.hours" placeholder="e.g. Mon–Fri 9–5" @input="markDirty" />
-            </div>
-          </template>
-```
-
- [ ] **Step 3: Add list item types and state**
-
-In the `<script setup>`, after the `notesExpanded` ref, add:
-
-```ts
-// ── List builder ─────────────────────────────────────────────────────────────
-interface ListItem {
-  text: string;
-  checked: boolean;
-}
-const listItems = ref<ListItem[]>([]);
-const listItemRefs = ref<(HTMLInputElement | null)[]>([]);
-
-function parseListFromBody(bodyText: string): { items: ListItem[]; extra: string } {
-  const lines = bodyText.split('\n');
-  const items: ListItem[] = [];
-  const extraLines: string[] = [];
-  let pastList = false;
-  for (const line of lines) {
-    const stripped = line.trimStart();
-    if (!pastList && (stripped.startsWith('- [ ] ') || stripped.startsWith('- [x] ') || stripped.startsWith('- [X] '))) {
-      items.push({ text: stripped.slice(6), checked: !stripped.startsWith('- [ ] ') });
-    } else if (!pastList && stripped === '' && items.length > 0) {
-      pastList = true;
-    } else {
-      pastList = true;
-      extraLines.push(line);
-    }
-  }
-  return { items, extra: extraLines.join('\n').trim() };
-}
-
-function serializeListToBody(): string {
-  const listPart = listItems.value
-    .map(item => `- [${item.checked ? 'x' : ' '}] ${item.text}`)
-    .join('\n');
-  const extraPart = body.value.trim();
-  return extraPart ? `${listPart}\n\n${extraPart}` : listPart;
-}
-
-function addListItem(afterIndex?: number) {
-  const idx = afterIndex !== undefined ? afterIndex + 1 : listItems.value.length;
-  listItems.value.splice(idx, 0, { text: '', checked: false });
-  markDirty();
-  nextTick(() => {
-    listItemRefs.value[idx]?.focus();
-  });
-}
-
-function removeListItem(index: number) {
-  if (listItems.value.length <= 1) return;
-  listItems.value.splice(index, 1);
-  markDirty();
-  nextTick(() => {
-    const focusIdx = Math.max(0, index - 1);
-    listItemRefs.value[focusIdx]?.focus();
-  });
-}
-
-function onListItemKeydown(e: KeyboardEvent, index: number) {
-  if (e.key === 'Enter') {
-    e.preventDefault();
-    addListItem(index);
-  } else if (e.key === 'Backspace' && listItems.value[index].text === '') {
-    e.preventDefault();
-    removeListItem(index);
-  }
-}
-
-function onListItemInput(index: number) {
-  markDirty();
-}
-
-function toggleListItemCheck(index: number) {
-  listItems.value[index].checked = !listItems.value[index].checked;
-  markDirty();
-}
-```
-
- [ ] **Step 4: Initialize list items on mount**
-
-In the onMounted data-loading section, after `notesExpanded.value = !!(store.currentNote.body || '').trim();`, add:
-
-```ts
-      if (noteType.value === 'list') {
-        const parsed = parseListFromBody(body.value);
-        listItems.value = parsed.items.length > 0 ? parsed.items : [{ text: '', checked: false }];
-        body.value = parsed.extra;
-        notesExpanded.value = !!parsed.extra;
-      }
-```
-
-And in the new-note branch (the `else` block after loading), after `noteType.value = qt as NoteType;`, add:
-
-```ts
-    if (noteType.value === 'list') {
-      listItems.value = [{ text: '', checked: false }];
-    }
-```
-
- [ ] **Step 5: Update save to serialize list**
-
-In the `save` function, find where the body is prepared for the API call. Before the `apiPost` or `apiPatch` call that sends the note data, add list serialization. Find the save function's data construction. Add before the API call:
-
-```ts
-  const finalBody = noteType.value === 'list' ? serializeListToBody() : body.value;
-```
-
-Then use `finalBody` instead of `body.value` in the API payload. Find all occurrences of `body: body.value` in the save function and replace with `body: finalBody`.
-
- [ ] **Step 6: Add list builder template**
-
-In the `note-main` div, after the place `</template>` and before the generic note `<template v-else-if="noteType === 'note'">`, add:
-
-```html
-        <!-- ── List builder ─────────────────────────────────────── -->
-        <template v-else-if="noteType === 'list'">
-          <div class="list-builder">
-            <div
-              v-for="(item, idx) in listItems"
-              :key="idx"
-              class="lb-item"
-            >
-              <input
-                type="checkbox"
-                :checked="item.checked"
-                @change="toggleListItemCheck(idx)"
-                class="lb-check"
-                tabindex="-1"
-              />
-              <input
-                :ref="(el) => { listItemRefs[idx] = el as HTMLInputElement | null }"
-                v-model="item.text"
-                class="lb-text"
-                placeholder="List item..."
-                @keydown="onListItemKeydown($event, idx)"
-                @input="onListItemInput(idx)"
-              />
-              <button class="lb-delete" tabindex="-1" @click="removeListItem(idx)" title="Remove item">&times;</button>
-            </div>
-            <button class="lb-add" @click="addListItem()">+ Add item</button>
-          </div>
-          <div class="notes-section">
-            <button class="notes-toggle" @click="notesExpanded = !notesExpanded">
-              {{ notesExpanded ? '▾' : '▸' }} Notes
-            </button>
-            <div v-if="notesExpanded" class="notes-editor-wrap">
-              <MarkdownToolbar v-show="!showPreview" :editor="tiptapEditor" />
-              <TiptapEditor
-                ref="editorRef"
-                :modelValue="body"
-                placeholder="Additional notes, context..."
-                @update:modelValue="onBodyUpdate"
-                @escape="titleRef?.focus()"
-              />
-            </div>
-          </div>
-        </template>
-```
-
- [ ] **Step 7: Add list builder CSS**
-
-Add to the `<style scoped>` block:
-
-```css
-/* ── List builder ───────────────────────────────────────── */
-.list-builder {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-  padding: 12px 0;
-}
-.lb-item {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-}
-.lb-check {
-  flex-shrink: 0;
-  width: 18px;
-  height: 18px;
-  accent-color: var(--color-primary);
-  cursor: pointer;
-}
-.lb-text {
-  flex: 1;
-  padding: 7px 10px;
-  border: 1px solid var(--color-border);
-  border-radius: 8px;
-  background: var(--color-surface);
-  color: var(--color-text);
-  font-size: 0.9rem;
-  font-family: inherit;
-  outline: none;
-  transition: border-color 0.15s;
-}
-.lb-text:focus {
-  border-color: var(--color-primary);
-  box-shadow: var(--focus-ring);
-}
-.lb-text::placeholder {
-  color: var(--color-text-muted);
-}
-.lb-delete {
-  background: none;
-  border: none;
-  color: var(--color-text-muted);
-  font-size: 1.1rem;
-  cursor: pointer;
-  padding: 0 4px;
-  line-height: 1;
-  opacity: 0;
-  transition: opacity 0.12s, color 0.12s;
-}
-.lb-item:hover .lb-delete,
-.lb-text:focus ~ .lb-delete {
-  opacity: 1;
-}
-.lb-delete:hover {
-  color: var(--color-danger);
-}
-.lb-add {
-  background: none;
-  border: 1px dashed var(--color-border);
-  border-radius: 8px;
-  padding: 7px 12px;
-  color: var(--color-text-muted);
-  font-size: 0.85rem;
-  cursor: pointer;
-  margin-top: 4px;
-  transition: border-color 0.15s, color 0.15s;
-}
-.lb-add:hover {
-  border-color: var(--color-primary);
-  color: var(--color-primary);
-}
-```
-
- [ ] **Step 8: Handle the generic note template wrapper**
-
-Make sure the existing TipTap-first editor content is wrapped in `<template v-else>` (not `v-else-if="noteType === 'note'"`) so it serves as the default for any unrecognized type.
-
-The final structure in `.note-main` should be:
-
-```
-<template v-if="noteType === 'person'"> ... </template>
-<template v-else-if="noteType === 'place'"> ... </template>
-<template v-else-if="noteType === 'list'"> ... </template>
-<template v-else> ... existing TipTap editor ... </template>
-```
-
- [ ] **Step 9: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 10: Commit**
-
-```bash
-git add frontend/src/views/NoteEditorView.vue
-git commit -m "feat(editor): place form-first layout and list builder with Enter-to-add"
-```
-
---
-
-### Task 4: Backend — new person/place fields in knowledge cards
-
-**Files:**
- Modify: `src/fabledassistant/services/knowledge.py`
- Modify: `frontend/src/views/KnowledgeView.vue`
-
-**Context:** The knowledge card display should show the new fields (birthday, organization for person; website, category for place). The backend `_note_to_item` needs to include them. The frontend card rendering needs to display the useful ones.
-
- [ ] **Step 1: Update `_note_to_item` for person**
-
-In `src/fabledassistant/services/knowledge.py`, find:
-
-```python
-    if note.entity_type == "person":
-        item["relationship"] = meta.get("relationship", "")
-        item["email"] = meta.get("email", "")
-        item["phone"] = meta.get("phone", "")
-```
-
-Replace with:
-
-```python
-    if note.entity_type == "person":
-        item["relationship"] = meta.get("relationship", "")
-        item["email"] = meta.get("email", "")
-        item["phone"] = meta.get("phone", "")
-        item["birthday"] = meta.get("birthday", "")
-        item["organization"] = meta.get("organization", "")
-        item["address"] = meta.get("address", "")
-```
-
- [ ] **Step 2: Update `_note_to_item` for place**
-
-Find:
-
-```python
-    elif note.entity_type == "place":
-        item["address"] = meta.get("address", "")
-        item["phone"] = meta.get("phone", "")
-        item["hours"] = meta.get("hours", "")
-```
-
-Replace with:
-
-```python
-    elif note.entity_type == "place":
-        item["address"] = meta.get("address", "")
-        item["phone"] = meta.get("phone", "")
-        item["hours"] = meta.get("hours", "")
-        item["website"] = meta.get("website", "")
-        item["category"] = meta.get("category", "")
-```
-
- [ ] **Step 3: Update KnowledgeItem interface**
-
-In `frontend/src/views/KnowledgeView.vue`, find the `KnowledgeItem` interface and add the new fields:
-
-After `phone?: string;` add:
-```ts
-  birthday?: string;
-  organization?: string;
-```
-
-After `hours?: string;` add:
-```ts
-  website?: string;
-  category?: string;
-```
-
- [ ] **Step 4: Update person card display**
-
-In the template, find the person card specifics:
-
-```html
-              <div v-if="item.note_type === 'person'" class="k-card-meta">
-                <span v-if="item.relationship" class="meta-chip">{{ item.relationship }}</span>
-                <span v-if="item.phone" class="meta-muted">{{ item.phone }}</span>
-              </div>
-```
-
-Replace with:
-
-```html
-              <div v-if="item.note_type === 'person'" class="k-card-meta">
-                <span v-if="item.relationship" class="meta-chip">{{ item.relationship }}</span>
-                <span v-if="item.organization" class="meta-muted">{{ item.organization }}</span>
-                <span v-if="item.phone" class="meta-muted">{{ item.phone }}</span>
-              </div>
-```
-
- [ ] **Step 5: Update place card display**
-
-Find:
-
-```html
-              <div v-else-if="item.note_type === 'place'" class="k-card-meta">
-                <span v-if="item.address" class="meta-muted">{{ item.address }}</span>
-                <span v-if="item.hours" class="meta-muted">{{ item.hours }}</span>
-              </div>
-```
-
-Replace with:
-
-```html
-              <div v-else-if="item.note_type === 'place'" class="k-card-meta">
-                <span v-if="item.category" class="meta-chip">{{ item.category }}</span>
-                <span v-if="item.address" class="meta-muted">{{ item.address }}</span>
-                <span v-if="item.hours" class="meta-muted">{{ item.hours }}</span>
-              </div>
-```
-
- [ ] **Step 6: Verify TypeScript compiles and backend syntax**
-
-```bash
-cd frontend && npx tsc --noEmit
-python -c "import ast; ast.parse(open('src/fabledassistant/services/knowledge.py').read()); print('OK')"
-```
-
- [ ] **Step 7: Commit**
-
-```bash
-git add src/fabledassistant/services/knowledge.py frontend/src/views/KnowledgeView.vue
-git commit -m "feat(knowledge): show organization/birthday for person cards, category for place cards"
-```
@@ -1,785 +0,0 @@
-# Modern Fable Visual Identity — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Replace the generic indigo dark-mode palette with a distinctive "Modern Fable" visual identity — deep violet + muted gold, signature card types, pill nav, Fraunces-as-narrator typography, and living micro-details.
-
-**Architecture:** Pure frontend changes across theme CSS, AppHeader, AppLogo, KnowledgeView, ChatPanel, BriefingView, and CalendarView. No backend changes. Each task is independently deployable — palette first, then cards, then nav, then typography, then details.
-
-**Tech Stack:** Vue 3 SFC (scoped CSS), CSS custom properties, Fraunces font (already loaded).
-
---
-
-## File Map
-
-| Action | Path |
-|--------|------|
-| Modify | `frontend/src/assets/theme.css` |
-| Modify | `frontend/src/components/AppLogo.vue` |
-| Modify | `frontend/src/components/AppHeader.vue` |
-| Modify | `frontend/src/views/KnowledgeView.vue` |
-| Modify | `frontend/src/components/ChatPanel.vue` |
-| Modify | `frontend/src/views/BriefingView.vue` |
-| Modify | `frontend/src/views/CalendarView.vue` |
-| Modify | `frontend/src/App.vue` |
-
---
-
-### Task 1: Color palette update + logo + scrollbar
-
-**Files:**
- Modify: `frontend/src/assets/theme.css`
- Modify: `frontend/src/components/AppLogo.vue`
-
- [ ] **Step 1: Update the dark theme palette in theme.css**
-
-In `frontend/src/assets/theme.css`, find the `[data-theme="dark"]` block and replace these values:
-
-```css
-[data-theme="dark"] {
-  --color-bg: #0f0f14;
-  --color-bg-secondary: #16161f;
-  --color-bg-card: #1a1a24;
-  --color-surface: #16161f;
-  --color-text: #e4e4f0;
-  --color-text-secondary: #8888a8;
-  --color-text-muted: #52526a;
-  --color-border: rgba(124, 58, 237, 0.12);
-  --color-input-border: rgba(124, 58, 237, 0.22);
-  --color-primary: #a78bfa;
-  --color-danger: #f44336;
-  --color-tag-bg: #2a2a45;
-  --color-tag-text: #c4b5fd;
-  --color-shadow: rgba(0, 0, 0, 0.4);
-  --color-toast-success: #4caf50;
-  --color-toast-error: #f44336;
-  --color-status-todo: #9aa0a6;
-  --color-status-todo-bg: #2a2a35;
-  --color-status-in-progress: #a78bfa;
-  --color-status-in-progress-bg: #2a2a45;
-  --color-status-done: #4caf50;
-  --color-status-done-bg: #1b3a20;
-  --color-priority-low: #80cbc4;
-  --color-priority-low-bg: #1a3a38;
-  --color-priority-medium: #fdd835;
-  --color-priority-medium-bg: #3a3520;
-  --color-priority-high: #f44336;
-  --color-priority-high-bg: #3a1a1a;
-  --color-wikilink: #c4b5fd;
-  --color-wikilink-bg: #2a1a45;
-  --color-overdue: #f44336;
-  --color-code-bg: #12121a;
-  --color-code-inline-bg: #1a1a2a;
-  --color-table-stripe: #14141e;
-  --color-success: #4ade80;
-  --color-warning: #facc15;
-  --color-input-bar-bg: #1a1a24;
-  --color-input-bar-text: #e4e4f0;
-  --color-input-bar-placeholder: rgba(228, 228, 240, 0.35);
-  --color-overlay: rgba(0, 0, 0, 0.65);
-  --color-bubble-user-bg: rgba(255, 255, 255, 0.04);
-  --color-bubble-user-border: rgba(255, 255, 255, 0.10);
-  --color-bubble-user-text: #b0b0c8;
-  --color-bubble-asst-shadow: 0 4px 28px rgba(124, 58, 237, 0.14), 0 2px 8px rgba(0, 0, 0, 0.4);
-  --color-accent-warm: #d4a017;
-  --color-accent-warm-light: #e8c45a;
-  --color-primary-solid: #7c3aed;
-  --color-primary-deep: #5b21b6;
-}
-```
-
-Note: `--color-accent-warm`, `--color-accent-warm-light`, `--color-primary-solid`, and `--color-primary-deep` are new variables.
-
- [ ] **Step 2: Update the light theme palette**
-
-In the `:root` block, update these values:
-
-```css
-:root {
-  --color-bg: #f5f5fb;
-  --color-bg-secondary: #ededf5;
-  --color-bg-card: #ffffff;
-  --color-surface: #f0f0f8;
-  --color-text: #1a1a1a;
-  --color-text-secondary: #666666;
-  --color-text-muted: #999999;
-  --color-border: #dddde8;
-  --color-input-border: #c8c8d8;
-  --color-primary: #7c3aed;
-  --color-danger: #d93025;
-  --color-tag-bg: #ede5ff;
-  --color-tag-text: #6d28d9;
-  --color-shadow: rgba(0, 0, 0, 0.08);
-  --color-toast-success: #34a853;
-  --color-toast-error: #d93025;
-  --color-status-todo: #5f6368;
-  --color-status-todo-bg: #e8eaed;
-  --color-status-in-progress: #7c3aed;
-  --color-status-in-progress-bg: #ede5ff;
-  --color-status-done: #34a853;
-  --color-status-done-bg: #e6f4ea;
-  --color-priority-low: #5f9ea0;
-  --color-priority-low-bg: #e0f2f1;
-  --color-priority-medium: #f9a825;
-  --color-priority-medium-bg: #fff8e1;
-  --color-priority-high: #d93025;
-  --color-priority-high-bg: #fce8e6;
-  --color-wikilink: #7b1fa2;
-  --color-wikilink-bg: #f3e5f5;
-  --color-overdue: #d93025;
-  --color-code-bg: #f0f0f8;
-  --color-code-inline-bg: #eaeaf4;
-  --color-table-stripe: #f4f4fb;
-  --color-success: #22c55e;
-  --color-warning: #eab308;
-  --color-input-bar-bg: #eaeaf3;
-  --color-input-bar-text: #1a1a1a;
-  --color-input-bar-placeholder: rgba(0, 0, 0, 0.4);
-  --color-overlay: rgba(0, 0, 0, 0.45);
-  --color-bubble-user-bg: rgba(0, 0, 0, 0.04);
-  --color-bubble-user-border: rgba(0, 0, 0, 0.10);
-  --color-bubble-user-text: #3a3a4a;
-  --color-bubble-asst-shadow: 0 2px 16px rgba(124, 58, 237, 0.10), 0 1px 4px rgba(0, 0, 0, 0.06);
-  --radius-sm: 6px;
-  --radius-md: 12px;
-  --radius-lg: 18px;
-  --radius-pill: 9999px;
-  --focus-ring: 0 0 0 2px rgba(124, 58, 237, 0.4);
-  /* Layout */
-  --page-max-width: 1200px;
-  --page-padding-x: 1rem;
-  --sidebar-width: 260px;
-  /* New brand variables */
-  --color-accent-warm: #b8860b;
-  --color-accent-warm-light: #d4a017;
-  --color-primary-solid: #7c3aed;
-  --color-primary-deep: #5b21b6;
-}
-```
-
- [ ] **Step 3: Update scrollbar color**
-
-Find:
-```css
-::-webkit-scrollbar-thumb {
-  background: rgba(99, 102, 241, 0.25);
-}
-::-webkit-scrollbar-thumb:hover {
-  background: rgba(99, 102, 241, 0.45);
-}
-```
-
-Replace with:
-```css
-::-webkit-scrollbar-thumb {
-  background: rgba(124, 58, 237, 0.25);
-}
-::-webkit-scrollbar-thumb:hover {
-  background: rgba(124, 58, 237, 0.45);
-}
-```
-
- [ ] **Step 4: Update focus ring**
-
-Find:
-```css
-  --focus-ring: 0 0 0 2px color-mix(in srgb, var(--color-primary) 40%, transparent);
-```
-
-Replace with:
-```css
-  --focus-ring: 0 0 0 2px rgba(124, 58, 237, 0.4);
-```
-
- [ ] **Step 5: Update AppLogo gradient**
-
-In `frontend/src/components/AppLogo.vue`, the logo uses `var(--color-primary)` which will automatically pick up the new violet value. No code change needed — the CSS variable update handles it.
-
-However, add a gradient `<defs>` for the book fill to use the deep gradient instead of a flat color. Find the `<style scoped>` block:
-
-```css
-.logo-book {
-  fill: var(--color-primary);
-  stroke: color-mix(in srgb, var(--color-primary) 70%, transparent);
-}
-```
-
-Replace with:
-```css
-.logo-book {
-  fill: url(#logo-gradient);
-  stroke: color-mix(in srgb, var(--color-primary) 70%, transparent);
-}
-```
-
-And add a gradient definition inside the `<svg>` element, before the `<!-- Book body -->` comment:
-
-```html
-    <defs>
-      <linearGradient id="logo-gradient" x1="0" y1="0" x2="1" y2="1">
-        <stop offset="0%" stop-color="var(--color-primary-solid)" />
-        <stop offset="100%" stop-color="var(--color-primary-deep)" />
-      </linearGradient>
-    </defs>
-```
-
- [ ] **Step 6: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 7: Commit**
-
-```bash
-git add frontend/src/assets/theme.css frontend/src/components/AppLogo.vue
-git commit -m "feat(theme): shift palette from indigo to deep violet + muted gold"
-```
-
---
-
-### Task 2: Signature header — pill nav + brand shortening + status pulse
-
-**Files:**
- Modify: `frontend/src/components/AppHeader.vue`
-
- [ ] **Step 1: Update brand text in header**
-
-Find:
-```html
-        Fabled Assistant
-```
-
-Replace with:
-```html
-        <span class="brand-text">Fabled</span>
-```
-
- [ ] **Step 2: Wrap nav-center links in a pill container**
-
-Find the `nav-center` div:
-```html
-      <div class="nav-center">
-        <router-link to="/" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
-        <router-link to="/chat" :class="['nav-link', { 'router-link-active': isChatActive }]">Chat</router-link>
-        <router-link to="/briefing" class="nav-link">Briefing</router-link>
-        <router-link to="/calendar" class="nav-link">Calendar</router-link>
-        <router-link to="/news" class="nav-link">News</router-link>
-        <router-link to="/projects" class="nav-link">Projects</router-link>
-      </div>
-```
-
-Replace with:
-```html
-      <div class="nav-center">
-        <div class="nav-pill-bar">
-          <router-link to="/" class="nav-link" :class="{ 'router-link-active': isKnowledgeActive }">Knowledge</router-link>
-          <router-link to="/chat" :class="['nav-link', { 'router-link-active': isChatActive }]">Chat</router-link>
-          <router-link to="/briefing" class="nav-link">Briefing</router-link>
-          <router-link to="/calendar" class="nav-link">Calendar</router-link>
-          <router-link to="/news" class="nav-link">News</router-link>
-          <router-link to="/projects" class="nav-link">Projects</router-link>
-        </div>
-      </div>
-```
-
- [ ] **Step 3: Replace header and nav CSS**
-
-Replace the entire `<style scoped>` from `.app-header` through `.nav-link.router-link-active` with:
-
-```css
-.app-header {
-  background: linear-gradient(180deg, var(--color-surface), var(--color-bg));
-  border-bottom: 1px solid rgba(124, 58, 237, 0.08);
-  position: relative;
-}
-.nav {
-  padding: 0.6rem 1.5rem;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  position: relative;
-}
-
-/* Left — brand */
-.nav-brand {
-  display: flex;
-  align-items: center;
-  gap: 0.45rem;
-  text-decoration: none;
-  flex-shrink: 0;
-}
-.brand-text {
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  font-optical-sizing: auto;
-  font-weight: 600;
-  font-size: 1rem;
-  letter-spacing: -0.01em;
-  color: #c4b0f0;
-}
-
-/* Center — pill bar */
-.nav-center {
-  position: absolute;
-  left: 50%;
-  transform: translateX(-50%);
-  display: flex;
-  align-items: center;
-}
-.nav-pill-bar {
-  display: flex;
-  align-items: center;
-  gap: 2px;
-  background: rgba(124, 58, 237, 0.06);
-  border-radius: 10px;
-  padding: 3px;
-}
-
-/* Right */
-.nav-right {
-  display: flex;
-  align-items: center;
-  gap: 0.25rem;
-  flex-shrink: 0;
-}
-
-.nav-link {
-  color: var(--color-text-muted);
-  text-decoration: none;
-  font-size: 0.82rem;
-  padding: 0.3rem 0.75rem;
-  border-radius: 8px;
-  transition: background 0.15s, color 0.15s;
-}
-.nav-link:hover {
-  color: var(--color-text-secondary);
-  background: rgba(124, 58, 237, 0.08);
-}
-.nav-link.router-link-active {
-  color: #c4b5fd;
-  font-weight: 600;
-  background: rgba(124, 58, 237, 0.2);
-  box-shadow: 0 0 12px rgba(124, 58, 237, 0.2);
-}
-```
-
- [ ] **Step 4: Add status dot pulse animation for loaded state**
-
-Find:
-```css
-.status-green .status-dot  { background: var(--color-success, #2ecc71); }
-```
-
-Replace with:
-```css
-.status-green .status-dot  { background: var(--color-success, #2ecc71); animation: status-pulse 2.5s ease-in-out infinite; }
-```
-
-Find:
-```css
-@keyframes pulse-dot {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.3; }
-}
-```
-
-Add after it:
-```css
-@keyframes status-pulse {
-  0%, 100% { box-shadow: 0 0 4px rgba(74, 222, 128, 0.4); }
-  50% { box-shadow: 0 0 10px rgba(74, 222, 128, 0.6); }
-}
-```
-
- [ ] **Step 5: Update mobile menu active styling**
-
-Find:
-```css
-  .mobile-menu .nav-link {
-    padding: 0.5rem 0.75rem;
-    min-height: 44px;
-    display: flex;
-    align-items: center;
-  }
-```
-
-Replace with:
-```css
-  .mobile-menu .nav-link {
-    padding: 0.5rem 0.75rem;
-    min-height: 44px;
-    display: flex;
-    align-items: center;
-    border-radius: 8px;
-  }
-  .mobile-menu .nav-link.router-link-active {
-    background: rgba(124, 58, 237, 0.15);
-    box-shadow: none;
-  }
-```
-
- [ ] **Step 6: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 7: Commit**
-
-```bash
-git add frontend/src/components/AppHeader.vue
-git commit -m "feat(header): pill nav bar, brand shortening, status pulse, header gradient"
-```
-
---
-
-### Task 3: Card type DNA — gradient bars, corner accents, hover bloom
-
-**Files:**
- Modify: `frontend/src/views/KnowledgeView.vue`
-
-**Context:** The cards currently have a left accent strip per type. The new design replaces this with top gradient bars (notes, tasks, lists) and corner accents (person, place), plus a unified violet hover bloom.
-
- [ ] **Step 1: Replace card accent strips with type-specific top bars and borders**
-
-Find in the `<style scoped>`:
-```css
-/* Type accent strip */
-.k-card--person { border-left: 3px solid #10b981; }
-.k-card--place  { border-left: 3px solid #f59e0b; }
-.k-card--list   { border-left: 3px solid #38bdf8; }
-.k-card--note   { border-left: 3px solid #6366f1; }
-.k-card--task   { border-left: 3px solid #a78bfa; }
-```
-
-Replace with:
-```css
-/* Type-specific card DNA */
-.k-card--note   { border-color: rgba(124, 58, 237, 0.12); }
-.k-card--task   { border-color: rgba(212, 160, 23, 0.10); }
-.k-card--person { border-color: rgba(16, 185, 129, 0.10); }
-.k-card--place  { border-color: rgba(245, 158, 11, 0.10); }
-.k-card--list   { border-color: rgba(56, 189, 248, 0.10); }
-
-/* Top gradient bars */
-.k-card--note::before,
-.k-card--task::before,
-.k-card--list::before {
-  content: '';
-  position: absolute;
-  top: 0;
-  left: 0;
-  height: 3px;
-  border-radius: 14px 14px 0 0;
-}
-.k-card--note::before {
-  right: 0;
-  background: linear-gradient(90deg, #7c3aed, #a78bfa);
-}
-.k-card--task::before {
-  width: 50%;
-  background: linear-gradient(90deg, #d4a017, transparent);
-}
-.k-card--list::before {
-  right: 0;
-  background: linear-gradient(90deg, #38bdf8, #7dd3fc);
-}
-
-/* Corner accents for entity types */
-.k-card--person::after,
-.k-card--place::after {
-  content: '';
-  position: absolute;
-  top: 0;
-  right: 0;
-  width: 60px;
-  height: 60px;
-  border-radius: 0 14px 0 60px;
-  pointer-events: none;
-}
-.k-card--person::after { background: rgba(16, 185, 129, 0.06); }
-.k-card--place::after  { background: rgba(245, 158, 11, 0.06); }
-```
-
- [ ] **Step 2: Update card hover to violet bloom**
-
-Find:
-```css
-.k-card:hover {
-  border-color: rgba(255,255,255,0.14);
-  transform: translateY(-1px);
-  box-shadow: 0 4px 16px rgba(0,0,0,0.2);
-}
-```
-
-Replace with:
-```css
-.k-card:hover {
-  transform: translateY(-2px);
-  box-shadow: 0 8px 24px rgba(124, 58, 237, 0.15), 0 2px 8px rgba(0, 0, 0, 0.3);
-  border-color: rgba(124, 58, 237, 0.2);
-}
-```
-
- [ ] **Step 3: Add sidebar section dividers**
-
-Find:
-```css
-.filter-section { margin-bottom: 20px; }
-```
-
-Replace with:
-```css
-.filter-section { margin-bottom: 20px; }
-.filter-section + .filter-section::before {
-  content: '· · ·';
-  display: block;
-  text-align: center;
-  color: rgba(124, 58, 237, 0.3);
-  font-size: 0.9rem;
-  letter-spacing: 0.4em;
-  padding: 4px 0 12px;
-}
-```
-
- [ ] **Step 4: Add scroll fade to card grid**
-
-Find:
-```css
-.card-grid {
-  flex: 1;
-  overflow-y: auto;
-  padding: 16px 20px;
-```
-
-Replace with:
-```css
-.card-grid {
-  flex: 1;
-  overflow-y: auto;
-  padding: 16px 20px;
-  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);
-```
-
- [ ] **Step 5: Update task card dates to use amber**
-
-Find in the task card CSS:
-```css
-.task-due {
-  font-size: 0.78rem;
-  color: var(--color-text-muted);
-}
-```
-
-Replace with:
-```css
-.task-due {
-  font-size: 0.78rem;
-  color: var(--color-accent-warm);
-}
-```
-
- [ ] **Step 6: Add Fraunces view title and update sidebar labels**
-
-Find the filter panel label CSS:
-```css
-.filter-label {
-  font-size: 0.7rem;
-  text-transform: uppercase;
-  letter-spacing: 0.08em;
-  color: var(--color-muted);
-  margin-bottom: 6px;
-  padding: 0 4px;
-}
-```
-
-Replace with:
-```css
-.filter-label {
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  font-size: 0.72rem;
-  letter-spacing: 0.02em;
-  color: var(--color-primary);
-  margin-bottom: 6px;
-  padding: 0 4px;
-}
-```
-
- [ ] **Step 7: Update empty state with Fraunces narrator voice**
-
-Find:
-```html
-        <div v-else-if="!loading && items.length === 0" class="knowledge-empty">
-          <p>Nothing here yet.</p>
-          <p v-if="activeType || activeTag || searchQuery" class="empty-hint">Try clearing the filters.</p>
-          <p v-else class="empty-hint">Start by creating a note, saving a person or place, or making a list.</p>
-        </div>
-```
-
-Replace with:
-```html
-        <div v-else-if="!loading && items.length === 0" class="knowledge-empty">
-          <p v-if="activeType || activeTag || searchQuery" class="empty-hint">No matches. Try clearing the filters.</p>
-          <p v-else class="empty-narrator">Your story is unwritten. Create your first note to begin.</p>
-        </div>
-```
-
-Add CSS:
-```css
-.empty-narrator {
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  font-size: 1rem;
-  color: var(--color-accent-warm);
-  opacity: 0.85;
-}
-```
-
- [ ] **Step 8: Update card date stamps to amber**
-
-Find:
-```css
-.k-card-date { font-size: 0.72rem; color: var(--color-muted); white-space: nowrap; }
-```
-
-Replace with:
-```css
-.k-card-date { font-size: 0.72rem; color: var(--color-accent-warm); white-space: nowrap; opacity: 0.7; }
-```
-
- [ ] **Step 9: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 10: Commit**
-
-```bash
-git add frontend/src/views/KnowledgeView.vue
-git commit -m "feat(knowledge): card type DNA, violet hover bloom, amber timestamps, narrator empty states"
-```
-
---
-
-### Task 4: ChatPanel + BriefingView + CalendarView — empty states + glow buttons
-
-**Files:**
- Modify: `frontend/src/components/ChatPanel.vue`
- Modify: `frontend/src/views/BriefingView.vue`
- Modify: `frontend/src/views/CalendarView.vue`
- Modify: `frontend/src/App.vue`
-
- [ ] **Step 1: Update ChatPanel empty state**
-
-In `frontend/src/components/ChatPanel.vue`, find:
-```html
-          >Send a message to start the conversation.</p>
-```
-
-Replace with:
-```html
-          >Start a conversation.</p>
-```
-
-Find the `.empty-msg` CSS:
-```css
-.empty-msg {
-```
-
-Add these properties (find the existing block and add to it):
-```css
-  font-family: 'Fraunces', Georgia, serif;
-  font-style: italic;
-  color: var(--color-accent-warm, #d4a017);
-```
-
- [ ] **Step 2: Add scroll fade to ChatPanel messages**
-
-Find the `.messages-container` CSS in ChatPanel.vue. Add:
-```css
-  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);
-```
-
- [ ] **Step 3: Update CalendarView empty state**
-
-In `frontend/src/views/CalendarView.vue`, find:
-```html
-      return ListView(
-        children: const [
-          SizedBox(height: 80),
-          Center(child: Text('No events')),
-        ],
-      );
-```
-
-Wait — that's the Flutter file. In the web CalendarView, there's no dedicated empty state text to update since it's a FullCalendar component. Skip this for the web CalendarView — it doesn't have a custom empty state.
-
- [ ] **Step 4: Add glow to primary action buttons in App.vue global styles**
-
-In `frontend/src/App.vue`, find the `<style>` block (the global unscoped one). The `btn-send` styles are in `ChatInputBar.vue` which is scoped. Instead, add a global hover glow rule. Find the existing `.app-footer` style and add after it:
-
-No — the glow should be on the specific button components. The `btn-send` in `ChatInputBar.vue` already has a hover shadow. Let me update it there.
-
-In `frontend/src/components/ChatInputBar.vue`, find:
-```css
-.btn-send:hover { box-shadow: 0 0 12px rgba(99, 102, 241, 0.5); }
-```
-
-Replace with:
-```css
-.btn-send:hover { box-shadow: 0 0 16px rgba(124, 58, 237, 0.35); }
-```
-
- [ ] **Step 5: Update KnowledgeView new-note button glow**
-
-In `frontend/src/views/KnowledgeView.vue`, find:
-```css
-.btn-new-note:hover { background: rgba(99, 102, 241, 0.2); }
-```
-
-Replace with:
-```css
-.btn-new-note:hover { background: rgba(124, 58, 237, 0.2); box-shadow: 0 0 12px rgba(124, 58, 237, 0.25); }
-```
-
- [ ] **Step 6: Update any remaining hardcoded indigo references in KnowledgeView**
-
-Search for `99, 102, 241` in KnowledgeView.vue and replace with `124, 58, 237`. This covers all the rgba references in filter buttons, borders, today bar chips, etc.
-
-Use find-and-replace across the file: `99, 102, 241` → `124, 58, 237`
-
- [ ] **Step 7: Update hardcoded indigo in BriefingView**
-
-Search for `99, 102, 241` in BriefingView.vue and replace with `124, 58, 237`.
-
-Search for `6366f1` in BriefingView.vue and replace with `7c3aed`.
-
- [ ] **Step 8: Update hardcoded indigo in AppHeader**
-
-Search for `99, 102, 241` in AppHeader.vue and replace with `124, 58, 237` (for any remaining references not covered by Task 2).
-
- [ ] **Step 9: Update hardcoded indigo in App.vue shortcuts overlay**
-
-Search for `99, 102, 241` in App.vue and replace with `124, 58, 237`.
-
-Search for `6366f1` in App.vue and replace with `7c3aed`.
-
- [ ] **Step 10: Verify TypeScript compiles**
-
-```bash
-cd frontend && npx tsc --noEmit
-```
-
- [ ] **Step 11: Commit**
-
-```bash
-git add frontend/src/components/ChatPanel.vue frontend/src/components/ChatInputBar.vue \
-  frontend/src/views/KnowledgeView.vue frontend/src/views/BriefingView.vue \
-  frontend/src/components/AppHeader.vue frontend/src/App.vue
-git commit -m "feat: narrator empty states, scroll fades, glow buttons, violet color sweep"
-```
@@ -1,782 +0,0 @@
-# Unified Lookup Tool & Wikipedia Integration — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Replace `search_web` with a unified `lookup` tool (Wikipedia-first, SearXNG fallback) and add Wikipedia as a source in the research pipeline.
-
-**Architecture:** New `wikipedia.py` service with `wiki_summary` and `wiki_search`. `lookup` tool in `web.py` replaces `search_web`. Research pipeline in `research.py` gains Wikipedia sources alongside SearXNG. All `search_web` references across the codebase are updated.
-
-**Tech Stack:** Python 3.12, httpx, pytest, asyncio
-
---
-
-### Task 1: Wikipedia Service Module
-
-**Files:**
- Create: `src/fabledassistant/services/wikipedia.py`
- Create: `tests/test_wikipedia.py`
-
- [ ] **Step 1: Write failing tests for `wiki_summary`**
-
-```python
-# tests/test_wikipedia.py
-import pytest
-from unittest.mock import AsyncMock, patch, MagicMock
-import httpx
-
-
-@pytest.mark.asyncio
-async def test_wiki_summary_returns_extract():
-    from fabledassistant.services.wikipedia import wiki_summary
-
-    mock_response = MagicMock()
-    mock_response.status_code = 200
-    mock_response.json.return_value = {
-        "type": "standard",
-        "title": "Python (programming language)",
-        "extract": "Python is a high-level programming language.",
-        "content_urls": {
-            "desktop": {"page": "https://en.wikipedia.org/wiki/Python_(programming_language)"}
-        },
-    }
-    mock_response.raise_for_status = MagicMock()
-
-    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
-        mock_client = AsyncMock()
-        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
-        mock_client.__aexit__ = AsyncMock(return_value=False)
-        mock_client.get = AsyncMock(return_value=mock_response)
-        mock_client_cls.return_value = mock_client
-
-        result = await wiki_summary("Python programming language")
-
-    assert result is not None
-    assert result["title"] == "Python (programming language)"
-    assert "high-level" in result["extract"]
-    assert "wikipedia.org" in result["url"]
-
-
-@pytest.mark.asyncio
-async def test_wiki_summary_returns_none_on_404():
-    from fabledassistant.services.wikipedia import wiki_summary
-
-    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
-        mock_client = AsyncMock()
-        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
-        mock_client.__aexit__ = AsyncMock(return_value=False)
-        mock_client.get = AsyncMock(side_effect=httpx.HTTPStatusError(
-            "Not Found", request=MagicMock(), response=MagicMock(status_code=404)
-        ))
-        mock_client_cls.return_value = mock_client
-
-        result = await wiki_summary("xyznonexistenttopic123")
-
-    assert result is None
-
-
-@pytest.mark.asyncio
-async def test_wiki_summary_returns_none_on_disambiguation():
-    from fabledassistant.services.wikipedia import wiki_summary
-
-    mock_response = MagicMock()
-    mock_response.status_code = 200
-    mock_response.json.return_value = {
-        "type": "disambiguation",
-        "title": "Python",
-        "extract": "Python may refer to...",
-    }
-    mock_response.raise_for_status = MagicMock()
-
-    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
-        mock_client = AsyncMock()
-        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
-        mock_client.__aexit__ = AsyncMock(return_value=False)
-        mock_client.get = AsyncMock(return_value=mock_response)
-        mock_client_cls.return_value = mock_client
-
-        result = await wiki_summary("Python")
-
-    assert result is None
-```
-
- [ ] **Step 2: Run tests to verify they fail**
-
-Run: `uv run pytest tests/test_wikipedia.py -v`
-Expected: FAIL with `ModuleNotFoundError: No module named 'fabledassistant.services.wikipedia'`
-
- [ ] **Step 3: Implement `wiki_summary`**
-
-```python
-# src/fabledassistant/services/wikipedia.py
-"""Wikipedia API: lightweight topic lookups and article search."""
-
-import logging
-from urllib.parse import quote as url_quote
-
-import httpx
-
-logger = logging.getLogger(__name__)
-
-_SUMMARY_URL = "https://en.wikipedia.org/api/rest_v1/page/summary"
-_SEARCH_URL = "https://en.wikipedia.org/w/api.php"
-_TIMEOUT = 5.0
-_USER_AGENT = "FabledAssistant/1.0 (https://fabledsword.com)"
-
-
-async def wiki_summary(query: str) -> dict | None:
-    """Look up a topic by title via the Wikipedia REST summary endpoint.
-
-    Returns {"title", "extract", "url"} on hit, None on miss.
-    """
-    encoded = url_quote(query.replace(" ", "_"), safe="")
-    try:
-        async with httpx.AsyncClient(
-            timeout=_TIMEOUT, headers={"User-Agent": _USER_AGENT}
-        ) as client:
-            resp = await client.get(f"{_SUMMARY_URL}/{encoded}", follow_redirects=True)
-            resp.raise_for_status()
-            data = resp.json()
-    except Exception:
-        logger.debug("Wikipedia summary lookup failed for %r", query, exc_info=True)
-        return None
-
-    if data.get("type") == "disambiguation":
-        return None
-
-    extract = data.get("extract", "").strip()
-    if not extract:
-        return None
-
-    url = (
-        data.get("content_urls", {}).get("desktop", {}).get("page")
-        or f"https://en.wikipedia.org/wiki/{encoded}"
-    )
-    return {"title": data.get("title", query), "extract": extract, "url": url}
-```
-
- [ ] **Step 4: Run tests to verify they pass**
-
-Run: `uv run pytest tests/test_wikipedia.py -v`
-Expected: 3 passed
-
- [ ] **Step 5: Write failing tests for `wiki_search`**
-
-Add to `tests/test_wikipedia.py`:
-
-```python
-@pytest.mark.asyncio
-async def test_wiki_search_returns_results():
-    from fabledassistant.services.wikipedia import wiki_search
-
-    search_response = MagicMock()
-    search_response.status_code = 200
-    search_response.json.return_value = {
-        "query": {
-            "search": [
-                {"title": "QUIC"},
-                {"title": "HTTP/3"},
-            ]
-        }
-    }
-    search_response.raise_for_status = MagicMock()
-
-    summary_response = MagicMock()
-    summary_response.status_code = 200
-    summary_response.json.return_value = {
-        "type": "standard",
-        "title": "QUIC",
-        "extract": "QUIC is a transport layer protocol.",
-        "content_urls": {"desktop": {"page": "https://en.wikipedia.org/wiki/QUIC"}},
-    }
-    summary_response.raise_for_status = MagicMock()
-
-    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
-        mock_client = AsyncMock()
-        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
-        mock_client.__aexit__ = AsyncMock(return_value=False)
-        mock_client.get = AsyncMock(side_effect=[search_response, summary_response, summary_response])
-        mock_client_cls.return_value = mock_client
-
-        results = await wiki_search("QUIC protocol", limit=2)
-
-    assert len(results) >= 1
-    assert results[0]["title"] == "QUIC"
-    assert "transport" in results[0]["extract"]
-
-
-@pytest.mark.asyncio
-async def test_wiki_search_returns_empty_on_failure():
-    from fabledassistant.services.wikipedia import wiki_search
-
-    with patch("fabledassistant.services.wikipedia.httpx.AsyncClient") as mock_client_cls:
-        mock_client = AsyncMock()
-        mock_client.__aenter__ = AsyncMock(return_value=mock_client)
-        mock_client.__aexit__ = AsyncMock(return_value=False)
-        mock_client.get = AsyncMock(side_effect=httpx.ConnectError("connection failed"))
-        mock_client_cls.return_value = mock_client
-
-        results = await wiki_search("anything")
-
-    assert results == []
-```
-
- [ ] **Step 6: Implement `wiki_search`**
-
-Add to `src/fabledassistant/services/wikipedia.py`:
-
-```python
-async def wiki_search(query: str, limit: int = 3) -> list[dict]:
-    """Search Wikipedia for articles matching a query.
-
-    Returns [{"title", "extract", "url"}, ...] (may be empty).
-    """
-    try:
-        async with httpx.AsyncClient(
-            timeout=_TIMEOUT, headers={"User-Agent": _USER_AGENT}
-        ) as client:
-            resp = await client.get(_SEARCH_URL, params={
-                "action": "query",
-                "list": "search",
-                "srsearch": query,
-                "srlimit": str(limit),
-                "format": "json",
-            })
-            resp.raise_for_status()
-            hits = resp.json().get("query", {}).get("search", [])
-            if not hits:
-                return []
-
-            results: list[dict] = []
-            for hit in hits:
-                title = hit.get("title", "")
-                if not title:
-                    continue
-                encoded = url_quote(title.replace(" ", "_"), safe="")
-                try:
-                    summary_resp = await client.get(
-                        f"{_SUMMARY_URL}/{encoded}", follow_redirects=True,
-                    )
-                    summary_resp.raise_for_status()
-                    data = summary_resp.json()
-                except Exception:
-                    continue
-                if data.get("type") == "disambiguation":
-                    continue
-                extract = data.get("extract", "").strip()
-                if not extract:
-                    continue
-                url = (
-                    data.get("content_urls", {}).get("desktop", {}).get("page")
-                    or f"https://en.wikipedia.org/wiki/{encoded}"
-                )
-                results.append({"title": data.get("title", title), "extract": extract, "url": url})
-            return results
-    except Exception:
-        logger.debug("Wikipedia search failed for %r", query, exc_info=True)
-        return []
-```
-
- [ ] **Step 7: Run all wikipedia tests**
-
-Run: `uv run pytest tests/test_wikipedia.py -v`
-Expected: 5 passed
-
- [ ] **Step 8: Commit**
-
-```bash
-git add src/fabledassistant/services/wikipedia.py tests/test_wikipedia.py
-git commit -m "feat: add wikipedia service with summary lookup and search"
-```
-
---
-
-### Task 2: Lookup Tool (replaces search_web)
-
-**Files:**
- Modify: `src/fabledassistant/services/tools/web.py`
- Create: `tests/test_lookup_tool.py`
-
- [ ] **Step 1: Write failing tests for `lookup`**
-
-```python
-# tests/test_lookup_tool.py
-import pytest
-from unittest.mock import AsyncMock, patch, MagicMock
-
-
-@pytest.mark.asyncio
-async def test_lookup_wikipedia_hit():
-    """lookup returns wikipedia source when wiki_summary succeeds."""
-    wiki_data = {
-        "title": "QUIC",
-        "extract": "QUIC is a transport layer protocol.",
-        "url": "https://en.wikipedia.org/wiki/QUIC",
-    }
-
-    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=wiki_data):
-        from fabledassistant.services.tools.web import lookup_tool
-        result = await lookup_tool(user_id=1, arguments={"query": "QUIC"})
-
-    assert result["success"] is True
-    assert result["type"] == "lookup"
-    assert result["source"] == "wikipedia"
-    assert result["data"]["title"] == "QUIC"
-    assert "transport" in result["data"]["extract"]
-
-
-@pytest.mark.asyncio
-async def test_lookup_wikipedia_miss_searxng_fallback():
-    """lookup falls back to SearXNG + article fetch when Wikipedia misses."""
-    searxng_results = [
-        {"url": "https://example.com/quic", "title": "QUIC Explained", "snippet": "An overview..."},
-    ]
-
-    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=None), \
-         patch("fabledassistant.services.tools.web.Config") as mock_config, \
-         patch("fabledassistant.services.tools.web._search_searxng", new_callable=AsyncMock, return_value=searxng_results), \
-         patch("fabledassistant.services.tools.web._fetch_full_article", new_callable=AsyncMock, return_value="Full article about QUIC..."):
-        mock_config.searxng_enabled.return_value = True
-        from fabledassistant.services.tools.web import lookup_tool
-        result = await lookup_tool(user_id=1, arguments={"query": "QUIC"})
-
-    assert result["success"] is True
-    assert result["type"] == "lookup"
-    assert result["source"] == "web"
-    assert result["data"]["results"]
-
-
-@pytest.mark.asyncio
-async def test_lookup_wikipedia_miss_no_searxng():
-    """lookup returns no-results when Wikipedia misses and SearXNG is not configured."""
-    with patch("fabledassistant.services.tools.web.wiki_summary", new_callable=AsyncMock, return_value=None), \
-         patch("fabledassistant.services.tools.web.Config") as mock_config:
-        mock_config.searxng_enabled.return_value = False
-        from fabledassistant.services.tools.web import lookup_tool
-        result = await lookup_tool(user_id=1, arguments={"query": "xyznonexistent"})
-
-    assert result["success"] is True
-    assert result["source"] == "none"
-
-
-@pytest.mark.asyncio
-async def test_lookup_always_available():
-    """lookup tool must appear in get_tools_for_user regardless of SearXNG config."""
-    with patch("fabledassistant.services.tools._registry.is_caldav_configured", new_callable=AsyncMock, return_value=False), \
-         patch("fabledassistant.services.settings.get_setting", new_callable=AsyncMock, return_value="false"):
-        from fabledassistant.services.tools import get_tools_for_user
-        tools = await get_tools_for_user(user_id=1)
-        tool_names = {t["function"]["name"] for t in tools}
-        assert "lookup" in tool_names
-```
-
- [ ] **Step 2: Run tests to verify they fail**
-
-Run: `uv run pytest tests/test_lookup_tool.py -v`
-Expected: FAIL (no `lookup_tool` function)
-
- [ ] **Step 3: Replace `search_web` with `lookup` in `web.py`**
-
-Replace the `search_web_tool` function (lines 12–36 of `src/fabledassistant/services/tools/web.py`) with:
-
-```python
-@tool(
-    name="lookup",
-    description=(
-        "Look up a topic, concept, or factual question. Returns a concise answer from "
-        "Wikipedia or web sources. Use for definitions, explanations, 'what is X', "
-        "'how does Y work', current events, or version numbers. No note is saved. "
-        "For comprehensive written reports saved as notes, use research_topic instead."
-    ),
-    parameters={
-        "query": {"type": "string", "description": "The topic or question to look up"},
-    },
-    required=["query"],
-)
-async def lookup_tool(*, user_id, arguments, **_ctx):
-    from fabledassistant.config import Config
-    from fabledassistant.services.wikipedia import wiki_summary
-
-    query = arguments.get("query", "")
-
-    # 1. Try Wikipedia first
-    wiki = await wiki_summary(query)
-    if wiki:
-        return {
-            "success": True,
-            "type": "lookup",
-            "source": "wikipedia",
-            "data": wiki,
-        }
-
-    # 2. Fall back to SearXNG + article fetch
-    if Config.searxng_enabled():
-        from fabledassistant.services.research import _search_searxng
-        from fabledassistant.services.rss import _fetch_full_article
-
-        results = await _search_searxng(query)
-        if results:
-            articles: list[dict] = []
-            for r in results[:2]:
-                url = r.get("url", "")
-                if not url:
-                    continue
-                content = await _fetch_full_article(url)
-                articles.append({
-                    "url": url,
-                    "title": r.get("title", url),
-                    "snippet": r.get("snippet", ""),
-                    "content": (content or "")[:4000],
-                })
-            if articles:
-                return {
-                    "success": True,
-                    "type": "lookup",
-                    "source": "web",
-                    "data": {"query": query, "results": articles},
-                }
-
-    # 3. No sources available
-    return {
-        "success": True,
-        "type": "lookup",
-        "source": "none",
-        "data": {
-            "query": query,
-            "message": "No results found. You can answer from your own knowledge.",
-        },
-    }
-```
-
- [ ] **Step 4: Run lookup tests to verify they pass**
-
-Run: `uv run pytest tests/test_lookup_tool.py -v`
-Expected: 4 passed
-
- [ ] **Step 5: Commit**
-
-```bash
-git add src/fabledassistant/services/tools/web.py tests/test_lookup_tool.py
-git commit -m "feat: replace search_web with unified lookup tool (Wikipedia + SearXNG fallback)"
-```
-
---
-
-### Task 3: Update All `search_web` References
-
-**Files:**
- Modify: `src/fabledassistant/services/tools/web.py:45` (research_topic description)
- Modify: `src/fabledassistant/services/tools/web.py:67` (search_images description)
- Modify: `src/fabledassistant/services/tools/rss.py:75` (read_article description)
- Modify: `src/fabledassistant/services/generation_task.py:133` (status label map)
- Modify: `src/fabledassistant/services/llm.py:608` (action list)
-
- [ ] **Step 1: Update `research_topic` description**
-
-In `src/fabledassistant/services/tools/web.py`, change the `research_topic` description from:
-
-```python
-        "For a quick factual answer without saving a note, use search_web."
-```
-
-to:
-
-```python
-        "For a quick factual answer without saving a note, use lookup."
-```
-
- [ ] **Step 2: Update `search_images` description**
-
-In `src/fabledassistant/services/tools/web.py`, change the `search_images` description from:
-
-```python
-    description="Search and display images inline. Use ONLY when the user explicitly asks to see, show, or find an image or photo. Not for factual questions — use search_web for those.",
-```
-
-to:
-
-```python
-    description="Search and display images inline. Use ONLY when the user explicitly asks to see, show, or find an image or photo. Not for factual questions — use lookup for those.",
-```
-
- [ ] **Step 3: Update `read_article` description**
-
-In `src/fabledassistant/services/tools/rss.py`, change:
-
-```python
-        "Do NOT use search_web for URLs — use this tool instead."
-```
-
-to:
-
-```python
-        "Do NOT use lookup for URLs — use this tool instead."
-```
-
- [ ] **Step 4: Update status label map in `generation_task.py`**
-
-In `src/fabledassistant/services/generation_task.py`, line 133, change:
-
-```python
-    "search_web": "Searching the web",
-```
-
-to:
-
-```python
-    "lookup": "Looking up information",
-```
-
- [ ] **Step 5: Update action list in `llm.py`**
-
-In `src/fabledassistant/services/llm.py`, line 608, change:
-
-```python
-        actions.extend(["search_web", "research_topic", "search_images"])
-```
-
-to:
-
-```python
-        actions.extend(["lookup", "research_topic", "search_images"])
-```
-
- [ ] **Step 6: Run full test suite to check for regressions**
-
-Run: `uv run pytest tests/ -v`
-Expected: All tests pass (no test references `search_web` by name in assertions)
-
- [ ] **Step 7: Commit**
-
-```bash
-git add src/fabledassistant/services/tools/web.py src/fabledassistant/services/tools/rss.py src/fabledassistant/services/generation_task.py src/fabledassistant/services/llm.py
-git commit -m "refactor: update all search_web references to lookup"
-```
-
---
-
-### Task 4: Add Wikipedia Sources to Research Pipeline
-
-**Files:**
- Modify: `src/fabledassistant/services/research.py`
- Modify: `tests/test_research_pipeline.py`
-
- [ ] **Step 1: Write failing test for Wikipedia in research pipeline**
-
-Add to `tests/test_research_pipeline.py`:
-
-```python
-@pytest.mark.asyncio
-async def test_pipeline_includes_wikipedia_sources():
-    """run_research_pipeline should merge Wikipedia results into the source pool."""
-    from unittest.mock import MagicMock
-
-    wiki_results = [{"title": "Wiki Article", "extract": "Wikipedia content about the topic.", "url": "https://en.wikipedia.org/wiki/Topic"}]
-
-    outline = [
-        {"title": "Section A", "focus": "Focus A"},
-        {"title": "Section B", "focus": "Focus B"},
-    ]
-
-    note_id_counter = iter(range(30, 40))
-
-    def _make_note(user_id, title, body, tags, project_id=None, parent_id=None):
-        n = MagicMock()
-        n.id = next(note_id_counter)
-        n.title = title
-        return n
-
-    with patch("fabledassistant.services.research._generate_sub_queries", new_callable=AsyncMock, return_value=["q1"]), \
-         patch("fabledassistant.services.research._search_searxng", new_callable=AsyncMock, return_value=[{"url": "http://x.com", "title": "X", "snippet": "s"}]), \
-         patch("fabledassistant.services.research.wiki_search", new_callable=AsyncMock, return_value=wiki_results), \
-         patch("fabledassistant.services.research.fetch_url_content", new_callable=AsyncMock, return_value="content"), \
-         patch("fabledassistant.services.research._generate_outline", new_callable=AsyncMock, return_value=outline) as mock_outline, \
-         patch("fabledassistant.services.research._synthesize_section", new_callable=AsyncMock, side_effect=lambda t, f, s, m: (t, f"Body for {t}")), \
-         patch("fabledassistant.services.research._generate_executive_summary", new_callable=AsyncMock, return_value="Summary."), \
-         patch("fabledassistant.services.research.create_note", new_callable=AsyncMock, side_effect=_make_note), \
-         patch("fabledassistant.services.research.update_note", new_callable=AsyncMock):
-
-        from fabledassistant.services.research import run_research_pipeline
-        await run_research_pipeline("test topic", user_id=1, model="test-model")
-
-    # The sources passed to _generate_outline should include the Wikipedia article
-    sources_arg = mock_outline.call_args[0][1]  # second positional arg
-    source_urls = [s["url"] for s in sources_arg]
-    assert "https://en.wikipedia.org/wiki/Topic" in source_urls
-```
-
- [ ] **Step 2: Run test to verify it fails**
-
-Run: `uv run pytest tests/test_research_pipeline.py::test_pipeline_includes_wikipedia_sources -v`
-Expected: FAIL (no `wiki_search` import in research.py)
-
- [ ] **Step 3: Add Wikipedia sources to the research pipeline**
-
-In `src/fabledassistant/services/research.py`, add the import at the top (after existing imports):
-
-```python
-from fabledassistant.services.wikipedia import wiki_search
-```
-
-Then modify Step 2 (the parallel search section, around lines 208–246). Replace:
-
-```python
-    # Step 2: Search all queries in parallel (200 ms stagger to avoid hammering SearXNG)
-    async def _search_with_stagger(i: int, query: str) -> tuple[str, list[dict]]:
-        if i > 0:
-            await asyncio.sleep(0.2 * i)
-        _status(f"Searching: {query}...")
-        results = await _search_searxng(query)
-        logger.info("Research: query '%s' → %d results", query, len(results))
-        return query, results
-
-    search_results = await asyncio.gather(
-        *[_search_with_stagger(i, q) for i, q in enumerate(queries)]
-    )
-
-    # Deduplicate URLs across all queries
-    seen_urls: set[str] = set()
-    url_tasks: list[tuple[str, dict, str]] = []  # (url, result_dict, query)
-    for query, results in search_results:
-        for result in results[:PAGES_PER_QUERY]:
-            url = result.get("url", "")
-            if url and url not in seen_urls:
-                seen_urls.add(url)
-                url_tasks.append((url, result, query))
-
-    # Fetch all unique URLs in parallel
-    async def _fetch_source(url: str, result: dict, query: str) -> dict:
-        title = result.get("title", url)
-        _status(f"Reading: {title[:60]}...")
-        content = await fetch_url_content(url)
-        return {
-            "url": url,
-            "title": title,
-            "query": query,
-            "snippet": result.get("snippet", ""),
-            "content": content,
-        }
-
-    all_sources: list[dict] = list(await asyncio.gather(
-        *[_fetch_source(url, result, query) for url, result, query in url_tasks]
-    ))
-```
-
-with:
-
-```python
-    # Step 2: Search all queries in parallel (SearXNG + Wikipedia)
-    async def _search_with_stagger(i: int, query: str) -> tuple[str, list[dict]]:
-        if i > 0:
-            await asyncio.sleep(0.2 * i)
-        _status(f"Searching: {query}...")
-        results = await _search_searxng(query)
-        logger.info("Research: query '%s' → %d results", query, len(results))
-        return query, results
-
-    async def _wiki_for_query(query: str) -> list[dict]:
-        return await wiki_search(query, limit=1)
-
-    searxng_task = asyncio.gather(
-        *[_search_with_stagger(i, q) for i, q in enumerate(queries)]
-    )
-    wiki_task = asyncio.gather(
-        *[_wiki_for_query(q) for q in queries]
-    )
-    search_results, wiki_results = await asyncio.gather(searxng_task, wiki_task)
-
-    # Deduplicate URLs across all queries
-    seen_urls: set[str] = set()
-    url_tasks: list[tuple[str, dict, str]] = []  # (url, result_dict, query)
-    wiki_sources: list[dict] = []  # Wikipedia articles (already have content)
-
-    for query, results in search_results:
-        for result in results[:PAGES_PER_QUERY]:
-            url = result.get("url", "")
-            if url and url not in seen_urls:
-                seen_urls.add(url)
-                url_tasks.append((url, result, query))
-
-    # Add Wikipedia results (they already have content via extract)
-    for query, wiki_hits in zip(queries, wiki_results):
-        for hit in wiki_hits:
-            url = hit.get("url", "")
-            if url and url not in seen_urls:
-                seen_urls.add(url)
-                wiki_sources.append({
-                    "url": url,
-                    "title": hit["title"],
-                    "query": query,
-                    "snippet": hit["extract"][:200],
-                    "content": hit["extract"],
-                })
-
-    # Fetch all unique SearXNG URLs in parallel
-    async def _fetch_source(url: str, result: dict, query: str) -> dict:
-        title = result.get("title", url)
-        _status(f"Reading: {title[:60]}...")
-        content = await fetch_url_content(url)
-        return {
-            "url": url,
-            "title": title,
-            "query": query,
-            "snippet": result.get("snippet", ""),
-            "content": content,
-        }
-
-    fetched_sources: list[dict] = list(await asyncio.gather(
-        *[_fetch_source(url, result, query) for url, result, query in url_tasks]
-    ))
-
-    all_sources = wiki_sources + fetched_sources
-```
-
- [ ] **Step 4: Run the new test to verify it passes**
-
-Run: `uv run pytest tests/test_research_pipeline.py::test_pipeline_includes_wikipedia_sources -v`
-Expected: PASS
-
- [ ] **Step 5: Run the full research test suite for regressions**
-
-Run: `uv run pytest tests/test_research_pipeline.py -v`
-Expected: All tests pass
-
- [ ] **Step 6: Run full test suite**
-
-Run: `uv run pytest tests/ -v`
-Expected: All tests pass
-
- [ ] **Step 7: Commit**
-
-```bash
-git add src/fabledassistant/services/research.py tests/test_research_pipeline.py
-git commit -m "feat: add Wikipedia as research pipeline source alongside SearXNG"
-```
-
---
-
-### Task 5: Lint, Typecheck, Final Verification
-
-**Files:**
- All modified files
-
- [ ] **Step 1: Run ruff lint**
-
-Run: `uv run ruff check src/fabledassistant/services/wikipedia.py src/fabledassistant/services/tools/web.py src/fabledassistant/services/research.py tests/test_wikipedia.py tests/test_lookup_tool.py`
-Expected: All checks passed (fix any issues if not)
-
- [ ] **Step 2: Run typecheck**
-
-Run: `cd frontend && npx vue-tsc --noEmit` (frontend unchanged, but verify nothing broke)
-Expected: Clean
-
- [ ] **Step 3: Run full test suite one last time**
-
-Run: `uv run pytest tests/ -v`
-Expected: All tests pass
-
- [ ] **Step 4: Commit any lint fixes if needed**
-
-```bash
-git add -u
-git commit -m "fix: lint cleanup for lookup/wikipedia changes"
-```
@@ -1,216 +0,0 @@
-# ChatPanel Unification Design
-
-**Date:** 2026-04-03
-
-## Goal
-
-Replace the four divergent chat surfaces (ChatView, BriefingView, WorkspaceView, HomeView widget) with a single `ChatPanel` component that encapsulates all chat behaviour — streaming, TTS, PTT, tool calls, thinking blocks, abort — so that fixes and features automatically apply to every context.
-
---
-
-## Background
-
-The app currently has four independent chat implementations that have drifted significantly:
-
-| Surface | File | Gap |
-|---|---|---|
-| Main chat | `ChatView.vue` | Canonical reference |
-| Briefing | `BriefingView.vue` | Had separate TTS impl (now fixed), no PTT, streaming race bug |
-| Workspace | `WorkspaceView.vue` | TTS missing until recently, different input wiring |
-| Dashboard widget | `HomeView.vue` + `DashboardChatInput.vue` | Separate input component, response rendered manually in parent, no TTS, no PTT |
-
-Every fix to chat has required touching 3–4 files. This design makes chat a first-class component.
-
---
-
-## Architecture
-
-### Component: `ChatPanel.vue`
-
-A single Vue 3 component that owns the entire chat interaction loop for a given conversation context. Two variants controlled by a `variant` prop:
-
- **`full`** — full-height chat: message history, streaming bubble, input bar, all controls
- **`widget`** — compact embedded chat: input bar + compact response area, no history scroll
-
-Both variants share identical internals: same composables, same store reads, same TTS/PTT/abort logic.
-
-### Extracted Sub-components
-
-| Component | Responsibility |
-|---|---|
-| `ChatInputBar.vue` | Unified input bar: textarea, note picker, PTT mic, send button, abort button |
-| `ChatMessageList.vue` | Scrollable message history with auto-scroll, bulk-select (full variant only) |
-| `ChatStreamingBubble.vue` | Live streaming content display + thinking block |
-| `ChatToolCallList.vue` | Tool call cards, collapsed/expanded state |
-
-### State Ownership
-
-`ChatPanel` reads from `useChatStore` directly — it does not accept messages or streaming state as props. This mirrors how all current views work and avoids prop-drilling re-implementation.
-
-The conversation being displayed is controlled via a `convId` prop. When `convId` is undefined, `ChatPanel` uses `chatStore.currentConversationId`. The parent view sets up the conversation (creates it if needed) and passes the ID down.
-
---
-
-## Props & Emits Interface
-
-```typescript
-interface ChatPanelProps {
-  variant: 'full' | 'widget'
-  convId?: number                  // which conversation to display; undefined = store current
-  projectId?: number               // workspace: pins RAG scope, passed to sendMessage
-  briefingMode?: boolean           // briefing: hides RAG scope chip, enables briefing-specific send path
-  placeholder?: string             // input placeholder text
-  autoFocus?: boolean              // focus input on mount
-}
-
-interface ChatPanelEmits {
-  // Emitted when a new conversation is started from the widget (so parent can track convId)
-  (e: 'conversation-started', convId: number): void
-}
-```
-
-All other behaviour (TTS, PTT, thinking, tool calls, streaming indicator, abort) is always on — not gated by props. The intentional differences between views are expressed only through the props above.
-
---
-
-## Variant Behaviour
-
-### `variant="full"` (ChatView, BriefingView, WorkspaceView)
-
-Layout (top to bottom):
-```
-┌────────────────────────────────────────┐
-│ [RAG scope chip / briefing header]     │  ← shown unless briefingMode or projectId set
-│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
-│ ChatMessageList                        │
-│   user bubble                          │
-│   assistant bubble + tool calls        │
-│   thinking block (always shown)        │
-│   ...                                  │
-│ ChatStreamingBubble (while streaming)  │
-│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
-│ ChatInputBar                           │
-│   [textarea] [note-picker] [mic] [▶]  │
-│   [listen toggle] [abort]              │
-└────────────────────────────────────────┘
-```
-
-### `variant="widget"` (HomeView dashboard)
-
-Layout (top to bottom, compact):
-```
-┌────────────────────────────────────────┐
-│ ChatInputBar (pill style)              │
-│   [textarea] [mic] [▶]                │
-├────────────────────────────────────────┤
-│ [query text]              (after send) │
-│ [streaming / final response text]      │
-│ [tool call chips]                      │
-│ [Continue in Chat →]                  │
-└────────────────────────────────────────┘
-```
-
-The widget variant does NOT show full message history. It shows only the most recent exchange. Once a new conversation is started or the user navigates to `/chat/:id`, the full history is available.
-
-The `.dashboard-response` section currently in `HomeView.vue` moves inside `ChatPanel` and is rendered when `variant="widget"` and a conversation exists.
-
---
-
-## TTS / PTT Wiring
-
-`ChatPanel` instantiates `useStreamingTts` and `useListenMode` internally. These are not passed as props.
-
-```typescript
-// Inside ChatPanel setup()
-const listenMode = useListenMode()
-const voiceTtsEnabled = computed(() => /* same check as current views */)
-const tts = useStreamingTts({
-  streamingContent: computed(() => chatStore.streamingContent),
-  streaming: computed(() => !!chatStore.streaming),
-  enabled: computed(() => listenMode.value && voiceTtsEnabled.value),
-})
-```
-
-PTT is handled inside `ChatInputBar` via the existing `useVoiceRecorder` composable (already used in `DashboardChatInput`). On recording stop, the transcribed text is placed in the textarea and auto-submitted.
-
---
-
-## Per-View Migration
-
-### ChatView → `<ChatPanel variant="full">`
- Remove: all TTS/PTT/streaming/abort logic, scroll management, input bar template
- Keep: route wiring, conversation list sidebar, bulk-delete UI (sidebar stays in ChatView)
- ChatPanel replaces only the right-hand panel
-
-### BriefingView → `<ChatPanel variant="full" briefingMode />`
- Remove: streaming watch, TTS, manual scroll, input bar, response persistence workaround
- Keep: history dropdown (today / past briefings), date header
- `briefingMode` hides the RAG scope chip
-
-### WorkspaceView → `<ChatPanel variant="full" :projectId="projectId">`
- Remove: inline chat input, streaming watch, TTS wiring
- Keep: 3-panel grid layout, task panel, note editor panel
- ChatPanel takes the centre column
-
-### HomeView → `<ChatPanel variant="widget">`
- Remove: `DashboardChatInput` import + usage, `.dashboard-response` section, all manual store wiring (`dashboardConvId`, `dashboardQuery`, `dashboardFinalContent`, `dashboardFinalToolCalls`, `onChatSubmit`)
- Keep: dashboard layout, projects/tasks/events sections
- `DashboardChatInput.vue` deleted
-
---
-
-## Data Flow
-
-```
-Parent view
-  └─ <ChatPanel :convId="convId" variant="full|widget">
-       ├─ reads: useChatStore (messages, streaming, streamingContent, currentConversation)
-       ├─ ChatMessageList — renders history from store
-       ├─ ChatStreamingBubble — renders chatStore.streamingContent while streaming
-       ├─ ChatToolCallList — renders tool calls from streaming + finalized messages
-       ├─ ChatInputBar
-       │    ├─ usePtt (mic → textarea → auto-send)
-       │    └─ emits: submit(content, contextNoteId)
-       ├─ useStreamingTts (sentence-chunk TTS during streaming)
-       └─ useListenMode (shared global toggle)
-```
-
---
-
-## Files Created / Modified
-
-**Created:**
- `frontend/src/components/ChatPanel.vue`
- `frontend/src/components/ChatInputBar.vue`
- `frontend/src/components/ChatMessageList.vue`
- `frontend/src/components/ChatStreamingBubble.vue`
- (no new composable needed — PTT uses existing `useVoiceRecorder.ts`)
-
-**Modified:**
- `frontend/src/views/ChatView.vue` — use ChatPanel for the chat area
- `frontend/src/views/BriefingView.vue` — replace chat section with ChatPanel
- `frontend/src/views/WorkspaceView.vue` — replace inline chat with ChatPanel
- `frontend/src/views/HomeView.vue` — replace DashboardChatInput + response section with ChatPanel widget
-
-**Deleted:**
- `frontend/src/components/DashboardChatInput.vue`
-
---
-
-## CSS / Styling
-
- `ChatPanel` carries its own scoped CSS for both variants
- `ChatInputBar` replicates the pill style currently in `DashboardChatInput` and the flat style in `ChatView` — variant is controlled by a `pill` boolean prop (default false; widget sets it true)
- All existing UI design language tokens (`--color-primary`, `--radius-lg`, Fraunces labels, gradient send button) are preserved
-
---
-
-## What Does NOT Change
-
- Chat store (`useChatStore`) — unchanged
- API client (`client.ts`) — unchanged
- Backend routes — unchanged
- WorkspaceTaskPanel and WorkspaceNoteEditor — unchanged
- Briefing history dropdown and date header — unchanged
- ChatView conversation sidebar and bulk-delete — unchanged
- RAG scope chip logic — moved inside ChatPanel, behaviour identical
@@ -1,101 +0,0 @@
-# Streaming TTS Design
-
-**Date:** 2026-04-03  
-**Status:** Approved
-
-## Goal
-
-Start playing TTS audio during LLM generation rather than waiting for the full response to finish. When listen mode is on, the first sentence plays as soon as Kokoro finishes synthesizing it — while the LLM is still streaming the rest of the response.
-
-## Approach
-
-Client-side sentence queuing composable. The frontend accumulates streaming tokens, detects sentence boundaries, fires per-sentence synthesis requests concurrently, and plays audio in strict insertion order. The existing `/api/voice/synthesise` backend endpoint is unchanged.
-
-## Architecture
-
-### `useStreamingTts` composable
-
-**File:** `frontend/src/composables/useStreamingTts.ts`
-
-**Inputs:**
- `streamingContent: Ref<string>` — the growing accumulated response text (e.g. `store.streamingContent`)
- `streaming: Ref<boolean>` — whether the LLM is currently generating
- `enabled: Ref<boolean>` — `true` when listen mode is on AND TTS is available
-
-**Exports:**
- `speaking: Ref<boolean>` — `true` while any synthesis is in-flight or audio is playing
- `stop()` — cancels all pending synthesis/playback and clears the queue
-
-**Internal state:**
- `sentenceBuffer: string` — accumulates characters since the last dispatched sentence
- `lastSeenLength: number` — tracks how far into `streamingContent` we've processed
- `abortId: number` — incremented on `stop()`; each queued promise checks the current id and bails if stale
- `playQueue: Promise<void>` — a chained promise that serializes audio playback in insertion order
-
-**Sentence detection:**
- Regex: `/[.!?]+(?=\s|$)/` — handles `...`, `?!`, multi-punctuation
- Triggered on every `streamingContent` change and on `streaming` flipping `false` (flush)
- Fragments < 3 characters after markdown stripping are skipped
-
-**Per-sentence pipeline:**
-1. Strip markdown (same logic as current `speakLastAssistantMessage`)
-2. Fire `synthesiseSpeech(sentence)` immediately — runs concurrently with other sentences
-3. On failure: one immediate retry. If retry also fails, skip silently and advance the queue
-4. Resolved blob is inserted into the playback queue at its original position
-5. Playback queue plays blobs strictly in insertion order via `useVoiceAudio`
-
-**Stream-end flush:**
- When `streaming` flips `false`, any remaining `sentenceBuffer` content (fragment without terminal punctuation) is dispatched as a final sentence — covers responses that end without a period
-
-**Automatic reset:**
- When `streaming` flips `true` (new message starting), `stop()` is called automatically to cancel any in-flight audio from the previous response before starting fresh
-
-### Views updated
-
-| View | Change |
-|------|--------|
-| `ChatView.vue` | Replace `speakLastAssistantMessage()` + `watch(streaming)` + `synthesising` ref with `useStreamingTts` |
-| `BriefingView.vue` | Replace `speakText()` + `watch(streaming)` + `synthesising` ref with `useStreamingTts` |
-| `WorkspaceView.vue` | Add listen mode toggle button (same UI pattern as ChatView) + `useStreamingTts` wired to workspace chat stream |
-
-In all three views: the `speaking` export from `useStreamingTts` replaces the old `synthesising || audio.playing.value` checks for button busy state.
-
-### Backend
-
-No changes. `/api/voice/synthesise` accepts shorter sentence-length strings without issue.
-
-## Error Handling
-
-| Scenario | Behavior |
-|----------|----------|
-| Synthesis fails for a sentence | One immediate retry; if retry fails, sentence is skipped, queue advances, and a `console.warn` is emitted with the sentence index and error |
-| `stop()` called mid-queue | `abortId` incremented; all in-flight promises check id and discard their result |
-| New message starts while audio playing | `watch(streaming, true → ...)` calls `stop()` before starting new queue |
-| TTS unavailable or listen mode off | Composable is inert — watchers do nothing, no requests fired |
-| Fragment < 3 chars after stripping | Skipped without a TTS request |
-| Response ends without terminal punctuation | Remaining buffer flushed as final sentence on stream-end |
-
-## Data Flow
-
-```
-LLM SSE chunks → store.streamingContent (grows)
-                         ↓
-              useStreamingTts watcher
-                         ↓
-              sentenceBuffer accumulation
-                         ↓
-         sentence boundary detected? → synthesiseSpeech(sentence) [concurrent]
-                         ↓                        ↓ (fail → 1 retry → skip)
-              playQueue.then(play blob)    resolved blob
-                         ↓
-              useVoiceAudio.play() [sequential]
-                         ↓
-                    audio output
-```
-
-## Files Changed
-
- **New:** `frontend/src/composables/useStreamingTts.ts`
- **Modified:** `frontend/src/views/ChatView.vue` — swap TTS logic for composable
- **Modified:** `frontend/src/views/BriefingView.vue` — swap TTS logic for composable
- **Modified:** `frontend/src/views/WorkspaceView.vue` — add listen mode + composable
@@ -1,227 +0,0 @@
-# Article Reading Design
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Allow the LLM to fetch and read the full text of any URL on demand, fix conversation history so tool context survives follow-up turns, and make the briefing Discuss button inject article content as a persisted tool exchange rather than raw user-message text.
-
-**Architecture:** Four self-contained changes — history reconstruction fix (prerequisite), `read_article` tool, Discuss endpoint, and content cap removal.
-
-**Tech Stack:** Python/Quart backend, trafilatura (already installed), SQLAlchemy async, Vue 3 frontend.
-
---
-
-## Problem summary
-
-Three interrelated issues observed in briefing conversations:
-
-1. **Missing `read_article` tool** — when a user pastes a URL, the LLM calls `search_web` (a SearXNG text search), which returns generic site descriptions instead of article content.
-2. **History reconstruction bug** — `routes/chat.py:166` builds the `history` list with only `role` + `content`, silently dropping all `tool_calls` and their results from prior turns. Tool context is lost on every follow-up.
-3. **Discuss button UX** — inlines raw article text into the user message bubble. Feels clumsy, and the model sometimes searches notes on follow-ups anyway because the article isn't clearly marked as "loaded" context.
-
---
-
-## Components
-
-### 1. History reconstruction fix
-**File:** `src/fabledassistant/routes/chat.py`
-
-The loop at line ~164 that builds `history` must be updated to replay tool exchanges:
-
-```python
-history = []
-for msg in conv.messages:
-    if msg.role == "system":
-        continue
-    msg_dict = {"role": msg.role, "content": msg.content or ""}
-    if msg.tool_calls:
-        msg_dict["tool_calls"] = [
-            {"function": {"name": tc["function"], "arguments": tc["arguments"]}}
-            for tc in msg.tool_calls
-        ]
-        history.append(msg_dict)
-        for tc in msg.tool_calls:
-            history.append({"role": "tool", "content": json.dumps(tc.get("result", {}))})
-    else:
-        history.append(msg_dict)
-```
-
-The `tool_calls` JSONB column already stores `[{function, arguments, result}]` per call. No schema change needed.
-
-### 2. `read_article` tool
-**Files:** `src/fabledassistant/services/research.py`, `src/fabledassistant/services/tools.py`, `src/fabledassistant/services/rss.py`
-
-Move `_fetch_full_article` from `rss.py` to `research.py` (imported back into `rss.py` to avoid breaking existing calls). This makes it available to `execute_tool` without a circular import.
-
-Tool definition added to `_TOOLS` in `tools.py`:
-
-```python
-{
-    "type": "function",
-    "function": {
-        "name": "read_article",
-        "description": (
-            "Fetch and read the full text of a web page or article from a URL. "
-            "Use when the user shares a URL and wants you to read it, "
-            "or to get the full content of a linked page. "
-            "Do not use search_web for URLs — use this tool instead."
-        ),
-        "parameters": {
-            "type": "object",
-            "properties": {
-                "url": {"type": "string", "description": "The URL to fetch"}
-            },
-            "required": ["url"],
-        },
-    },
-}
-```
-
-`execute_tool` handler:
-
-```python
-elif tool_name == "read_article":
-    from fabledassistant.services.research import _fetch_full_article
-    url = arguments.get("url", "").strip()
-    if not url:
-        return {"success": False, "error": "No URL provided"}
-    content = await _fetch_full_article(url)
-    if not content:
-        return {"success": False, "error": f"Could not fetch article content from {url}"}
-    TOOL_CONTENT_CAP = 40_000
-    truncated = len(content) > TOOL_CONTENT_CAP
-    return {
-        "success": True,
-        "type": "article_content",
-        "url": url,
-        "content": content[:TOOL_CONTENT_CAP],
-        "truncated": truncated,
-    }
-```
-
-### 3. `add_message` — add `tool_calls` parameter
-**File:** `src/fabledassistant/services/chat.py`
-
-`add_message` needs to accept and store `tool_calls` so the Discuss endpoint can create synthetic messages:
-
-```python
-async def add_message(
-    conversation_id: int,
-    role: str,
-    content: str,
-    context_note_id: int | None = None,
-    status: str | None = None,
-    tool_calls: list | None = None,
-) -> Message:
-```
-
-Set `msg.tool_calls = tool_calls` when provided.
-
-### 4. Discuss endpoint
-**File:** `src/fabledassistant/routes/briefing.py`
-
-New route: `POST /api/briefing/articles/<int:item_id>/discuss`
-
-Request body: `{"conv_id": <int>}`
-
-Steps:
-1. Look up `rss_items` row by `item_id` — verify it belongs to the user via feed ownership. Return 404 if not found.
-2. Look up conversation by `conv_id` — verify it belongs to the user. Return 404 if not found.
-3. If generation already running for `conv_id` → return 409.
-4. Fetch stored content: `article_content = item.content or item.snippet or ""`
-5. Store synthetic assistant message (status=`"complete"`, role=`"assistant"`, content=`""`, tool_calls as below):
-   ```python
-   synthetic_tool_calls = [{
-       "function": "read_article",
-       "arguments": {"url": item.url},
-       "result": {
-           "success": True,
-           "type": "article_content",
-           "url": item.url,
-           "content": article_content,
-           "truncated": False,
-       },
-   }]
-   await add_message(conv_id, "assistant", "", status="complete", tool_calls=synthetic_tool_calls)
-   ```
-6. Store user message: `await add_message(conv_id, "user", "Please summarize and discuss this article.")`
-7. Build `history` from `conv.messages` (using the fixed builder above).
-8. Create assistant placeholder, create buffer, launch `run_generation` as normal.
-9. Return `{"assistant_message_id": ..., "status": "generating"}` 202.
-
-### 5. Frontend: BriefingView.vue
-**File:** `frontend/src/views/BriefingView.vue`
-
-Replace `discussArticle()`:
-
-```typescript
-async function discussArticle(item: NewsItem) {
-  if (!todayConvId.value) return
-  if (!isToday.value) selectedConvId.value = todayConvId.value
-  await nextTick(() => {
-    document.querySelector('.briefing-center')?.scrollIntoView({ behavior: 'smooth', block: 'nearest' })
-  })
-  await apiClient.post(`/api/briefing/articles/${item.id}/discuss`, {
-    conv_id: todayConvId.value,
-  })
-  // Re-fetch conversation so the new messages appear, then start SSE streaming.
-  // The existing chatStore.fetchConversation + startStreaming pattern handles this.
-  await chatStore.fetchConversation(todayConvId.value)
-  chatStore.startStreaming(todayConvId.value)
-}
-```
-
-The exact method names (`fetchConversation`, `startStreaming`) should match what `BriefingView.vue` already uses for the reply flow — confirm during implementation.
-
-The article no longer appears as wall-of-text in the user bubble. The chat UI shows it as a `read_article` tool call card (already handled by `ToolCallCard.vue`).
-
-### 6. Content cap removal
-**File:** `src/fabledassistant/services/rss.py`
-
-Remove `[:CONTENT_MAX_CHARS]` from:
- `content = _html_to_text(content)[:CONTENT_MAX_CHARS]` in `extract_item()`
- `item.content = full_text[:CONTENT_MAX_CHARS]` in the enrichment task
-
-The `CONTENT_MAX_CHARS` constant can be removed entirely. Trafilatura extracts only article body text (typically 2K–15K chars for news articles), so content is naturally bounded.
-
---
-
-## Data flow
-
-### User pastes a URL in chat
-1. User sends message with a URL
-2. LLM calls `read_article(url)`
-3. `execute_tool` calls `_fetch_full_article(url)` → trafilatura extracts clean text
-4. Tool result appended in-memory as `{role: "tool", content: json}`
-5. LLM responds based on article content
-6. Generation saves assistant message with `tool_calls=[{function:"read_article", arguments, result}]`
-7. Follow-up turns: history builder replays tool_call + tool result → article stays in context
-
-### User clicks Discuss on a briefing article
-1. Frontend calls `POST /api/briefing/articles/{item_id}/discuss` with `{conv_id}`
-2. Backend fetches stored article text from DB (no network request)
-3. Backend stores synthetic assistant message with `read_article` tool result
-4. Backend stores user message `"Please summarize and discuss this article."`
-5. Generation runs — LLM sees pre-loaded article in history
-6. Follow-ups retain context via fixed history builder
-
---
-
-## Error handling
-
-| Scenario | Behaviour |
-|---|---|
-| `_fetch_full_article` returns `None` (network/extraction failure) | Tool returns `{success: False, error: "Could not fetch article content from [url]"}` — LLM reports conversationally |
-| Discuss: `item_id` not found or wrong user | 404 |
-| Discuss: `conv_id` not found or wrong user | 404 |
-| Discuss: article has no stored content | Falls back to empty string — LLM works with what it has |
-| Discuss: generation already running | 409 |
-| Messages with `tool_calls = None` | History builder unchanged — no regression for existing conversations |
-
---
-
-## Tests
-
- **Unit:** `_fetch_full_article` returns `None` → `read_article` tool result has `success: False`
- **Unit:** History builder with a stored message that has `tool_calls` → output includes assistant tool_call dict + a `{role: "tool"}` dict
- **Unit:** History builder with messages where `tool_calls = None` → output unchanged from current behaviour
- **Integration:** `POST /api/briefing/articles/{item_id}/discuss` → two messages stored (synthetic assistant + user message), generation triggered, returns 202
@@ -1,162 +0,0 @@
-# Research Pipeline — Multi-Note Redesign
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Replace the single monolithic research note with a set of focused, topic-driven notes plus an index note that links them — making research output browsable, TTS-friendly, and well-organized.
-
-**Architecture:** Two new LLM calls (outline generation + N parallel section syntheses) replace the single large synthesis call. Public API unchanged — callers receive the index note. Fallback to single-note behavior on any outline failure.
-
-**Tech Stack:** Python/Quart backend, existing `research.py` service, asyncio.gather for parallelism.
-
---
-
-## Problem
-
-The current pipeline synthesizes one note with a minimum of 2500 words and 6 sections. This creates:
- Notes too large to read or listen to comfortably
- No way to navigate directly to a specific sub-topic
- TTS failures on long prose (8000-char route limit, unbounded sentence buffers)
-
---
-
-## Pipeline Flow
-
-Public signature unchanged:
-```python
-async def run_research_pipeline(
-    topic: str,
-    user_id: int,
-    model: str,
-    buf=None,
-    project_id: int | None = None,
-) -> Note:  # returns the index note
-```
-
-Execution order:
-
-```
-1. Generate sub-queries           (unchanged)
-2. Search + fetch sources         (unchanged)
-3. Generate topic outline         (NEW — one LLM call → 3–7 section dicts)
-4. Synthesize each section note   (NEW — parallelized via asyncio.gather)
-5. Create all section notes in DB (sequential, tagged ["research"], same project_id)
-6. Create index note              (NEW — links all sections)
-7. Return index note
-```
-
-Status messages via `buf.append_event("status", ...)`:
- `"Generating outline…"`
- `"Writing: [Section Title]…"` (one per section, emitted before synthesis starts)
- `"Saving [N] notes…"`
-
-No note content is streamed into chat. After the tool call resolves, the LLM writes a brief conversational summary citing the index note title and section count.
-
---
-
-## Outline Generation
-
-New function: `_generate_outline(topic, sources, model) -> list[dict]`
-
-Sends all fetched sources to the model with a prompt requesting a JSON array:
-
-```json
-[
-  {"title": "Quantum Entanglement: Mechanisms", "focus": "How entanglement works at the physical level"},
-  {"title": "Quantum Computing Hardware", "focus": "Ion traps, superconducting qubits, photonic approaches"}
-]
-```
-
-**Prompt requirements:**
- Produce 3–7 sections covering distinct aspects of the topic
- Titles must work as standalone note titles (no "Overview" or "Introduction" generics)
- No overlap between sections
- `focus` is one sentence describing what this section should specifically cover
-
-**Guardrails:**
- Fewer than 3 sections parsed → fall back to single-note synthesis
- JSON parse failure → fall back to single-note synthesis
- More than 8 sections → truncate to 8
-
-**Model params:** `max_tokens=400, num_ctx=16384` (outline is short)
-
---
-
-## Section Synthesis
-
-New function: `_synthesize_section(section_title, section_focus, sources, model) -> tuple[str, str]`
-
-Returns `(title, body_markdown)`.
-
-All sections receive all fetched sources. The `section_focus` field in the prompt directs the model to draw only what's relevant to that section's scope.
-
-**Prompt requirements:**
- 300–600 words of substantive prose
- Do NOT include a `# Title` heading (title is set separately)
- End with a brief `## Sources` list of relevant URLs from the provided sources
- Focus strictly on `section_focus` — ignore source material outside that scope
-
-**Model params:** `num_predict=2048, num_ctx=16384` (reduced from 8192 — sufficient for 600 words, prevents rambling)
-
-**Parallelism:** All section synthesis calls run via `asyncio.gather`. Wall-clock time stays close to a single synthesis call despite producing N notes.
-
---
-
-## Note Creation and Index Note
-
-**Section notes:**
- Tags: `["research"]`
- `project_id`: same as passed to pipeline (or None)
- Title: from outline `title` field
- Created sequentially (avoids DB contention)
-
-**Index note:**
- Tags: `["research", "research-index"]`
- `project_id`: same as section notes
- Title: `"Research: [topic]"`
- Created last (after all section notes exist)
-
-**Index note body format:**
-```markdown
-Research overview for **[topic]** — [YYYY-MM-DD]
-
-Generated from [N] web sources across [M] sections.
-
-## Sections
-
- **[Section 1 Title]** — [focus sentence]
- **[Section 2 Title]** — [focus sentence]
-...
-
-*Search for any section title to read it.*
-```
-
-The index note is what `run_research_pipeline` returns. The existing `research_topic` tool handler uses `note.id` and `note.title` — both remain valid with the index note.
-
---
-
-## Error Handling
-
-| Scenario | Behaviour |
-|---|---|
-| Outline generation raises | Fall back to single-note synthesis (current behaviour) |
-| Outline JSON unparseable | Fall back to single-note synthesis |
-| Outline returns < 3 sections | Fall back to single-note synthesis |
-| Outline returns > 8 sections | Truncate to 8, continue |
-| A section synthesis raises | Log warning, skip that section; continue with remaining |
-| All section syntheses fail | Fall back to single-note synthesis |
-| A section note DB save fails | Log warning, skip from index; index note still created |
-| No sources fetched | Raise `ValueError` as today — unchanged |
-
-The fallback in every case is the current single-note pipeline. Research never silently produces nothing.
-
---
-
-## What Is NOT Changing
-
- Public function signature of `run_research_pipeline`
- Sub-query generation (`_generate_sub_queries`)
- SearXNG search and URL fetching
- `_search_searxng`, `_search_searxng_images`, `fetch_url_content`
- The `research_topic` tool definition and handler in `tools.py`
- The `quick_capture` research path
- Any frontend component
@@ -1,204 +0,0 @@
-# Settings Consistency Pass — Design
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Fix five interrelated gaps in the settings UI — missing timezone field, SSO-unaware account tab, duplicated work schedule, ignored slot toggles, and timezone changes not propagating to the briefing scheduler.
-
-**Architecture:** Primarily frontend cleanup with two focused backend hooks: settings PUT route gains a timezone→scheduler bridge; briefing scheduler gains slot-gating and work-day awareness.
-
-**Tech Stack:** Vue 3 + TypeScript frontend; Python/Quart backend; APScheduler; `zoneinfo`.
-
---
-
-## Problem summary
-
-1. **No timezone field** — `user_timezone` is read by the scheduler and the chat pipeline but is never exposed in the UI. The briefing tab displays the browser's detected timezone but never persists it. Scheduler falls back to UTC.
-
-2. **Account tab ignores SSO** — "Email Address" and "Change Password" sections are shown to SSO users (`has_password = false`) even though they cannot change credentials here.
-
-3. **Work schedule duplicated** — Profile tab has the canonical work schedule (days + start/end time, stored in `profile.work_schedule`). Briefing tab has a redundant "Office Days" section (`briefing_config.work_days`) that the backend never reads.
-
-4. **Slot toggles are decorative** — The briefing tab's four slot checkboxes are saved to `briefing_config.slots` but `_add_user_jobs` schedules all four slots unconditionally.
-
-5. **Timezone setting not propagated** — `PUT /api/settings` saves `user_timezone` to the DB but does not call `update_user_schedule`, so the in-memory scheduler keeps the stale timezone until restart or briefing config re-save.
-
---
-
-## Components
-
-### 1. General tab — Timezone field
-
-**File:** `frontend/src/views/SettingsView.vue`
-
-New section in the General tab (after the Assistant section, before Model Management):
-
-```html
-<section class="settings-section full-width">
-  <h2>Timezone</h2>
-  <p class="section-desc">Used to schedule briefings and format times in chat.</p>
-  <div class="field">
-    <label for="user-timezone">Your timezone</label>
-    <div style="display:flex; gap:0.5rem; align-items:center">
-      <input id="user-timezone" v-model="userTimezone" type="text"
-             class="input" placeholder="e.g. America/New_York" />
-      <button class="btn-secondary" type="button" @click="detectTimezone">Detect</button>
-    </div>
-    <p class="field-hint">IANA timezone name (e.g. America/Chicago, Europe/London).</p>
-  </div>
-  <div class="actions">
-    <button class="btn-save" @click="saveTimezone" :disabled="savingTimezone">
-      {{ savingTimezone ? 'Saving…' : 'Save' }}
-    </button>
-    <span v-if="timezoneSaved" class="saved-msg">Saved!</span>
-  </div>
-</section>
-```
-
- `detectTimezone()` sets `userTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone`
- `saveTimezone()` calls `PUT /api/settings` with `{ user_timezone: userTimezone }`
- Loaded in `onMounted` / general settings load alongside `assistantName`, `defaultModel`
-
-The briefing tab's "Firing in timezone" hint changes from the live Intl API to reading the stored `user_timezone` value:
-```
-Firing in timezone: <strong>{{ userTimezone || 'UTC (not set)' }}</strong>
-```
-
-### 2. Account tab — SSO guard
-
-**File:** `frontend/src/views/SettingsView.vue`
-
-Wrap the Email and Password sections:
-
-```html
-<!-- SSO info banner (shown when no local password) -->
-<section v-if="!authStore.user?.has_password" class="settings-section">
-  <h2>Account</h2>
-  <p class="section-desc">
-    Your account is managed by an external identity provider.
-    Email and password changes are made through your provider, not here.
-  </p>
-</section>
-
-<!-- Local-auth sections (hidden for SSO) -->
-<template v-if="authStore.user?.has_password">
-  <section class="settings-section"> <!-- Email Address --> </section>
-  <section class="settings-section"> <!-- Change Password --> </section>
-</template>
-
-<!-- Active Sessions — always shown -->
-<section class="settings-section"> ... </section>
-```
-
-No backend change needed — the API already rejects email/password changes for SSO accounts.
-
-### 3. Briefing tab — Remove Office Days
-
-**File:** `frontend/src/views/SettingsView.vue`
-
-Delete the "Office Days" `<section>` (lines ~2068–2082). The `briefing_config.work_days` field can remain in the config object for backwards compatibility but the UI stops writing it.
-
-The slot toggles section stays — it now actually drives scheduling (see §5).
-
-### 4. Backend — settings PUT propagates timezone to scheduler
-
-**File:** `src/fabledassistant/routes/settings.py`
-
-After `set_settings_batch`, add:
-
-```python
-if "user_timezone" in to_save:
-    import json
-    from fabledassistant.services.briefing_scheduler import update_user_schedule
-    config_raw = await get_setting(uid, "briefing_config", "{}")
-    try:
-        config = json.loads(config_raw) if isinstance(config_raw, str) else {}
-    except Exception:
-        config = {}
-    if config.get("enabled"):
-        update_user_schedule(uid, config, tz_override=to_save["user_timezone"] or None)
-```
-
-### 5. Backend — scheduler respects slot toggles and work days
-
-**File:** `src/fabledassistant/services/briefing_scheduler.py`
-
-**5a. `_add_user_jobs` — only schedule enabled slots**
-
-Change signature to accept `config: dict`:
-
-```python
-def _add_user_jobs(user_id: int, tz: str, config: dict | None = None) -> None:
-    enabled_slots = (config or {}).get("slots", {})
-    for slot_name, hour, minute in SLOTS:
-        # Default True for compilation (always run); others respect toggle
-        if slot_name != "compilation" and not enabled_slots.get(slot_name, True):
-            jid = _job_id(user_id, slot_name)
-            if _scheduler and _scheduler.get_job(jid):
-                _scheduler.remove_job(jid)
-            continue
-        _scheduler.add_job(
-            _run_user_slot_sync,
-            CronTrigger(hour=hour, minute=minute, timezone=tz),
-            args=[user_id, slot_name],
-            id=_job_id(user_id, slot_name),
-            replace_existing=True,
-            misfire_grace_time=3600,
-        )
-```
-
-Update callers:
- `update_user_schedule(user_id, config, tz_override)` → pass `config` to `_add_user_jobs`
- `start_briefing_scheduler` startup loop → fetch full config to pass through
-
-**5b. `_run_slot_for_user` — skip morning on non-work days**
-
-For the `morning` slot, check today against `profile.work_schedule.days`:
-
-```python
-if slot == "morning":
-    from fabledassistant.services.user_profile import get_profile
-    from datetime import datetime
-    tz_str = await get_setting(user_id, "user_timezone") or "UTC"
-    try:
-        user_tz = ZoneInfo(tz_str)
-    except Exception:
-        user_tz = ZoneInfo("UTC")
-    today_abbr = datetime.now(user_tz).strftime("%a")  # 'Mon', 'Tue', …
-    profile = await get_profile(user_id)
-    work_days = (profile.work_schedule or {}).get("days", ["Mon","Tue","Wed","Thu","Fri"])
-    if today_abbr not in work_days:
-        logger.info("Skipping morning slot for user %d — %s not a work day", user_id, today_abbr)
-        return
-```
-
-Note: `get_profile` must be importable from `user_profile.py` — confirm signature during implementation.
-
---
-
-## Data flow
-
-1. User opens Settings → General tab loads, reads `user_timezone` from `GET /api/settings`, populates the field
-2. User clicks Detect → browser timezone fills the field
-3. User clicks Save → `PUT /api/settings {user_timezone: "America/New_York"}` → backend saves and immediately calls `update_user_schedule` if briefing enabled
-4. Briefing tab "Firing in timezone" now shows stored value instead of live browser API
-5. Next 8am job: scheduler checks if `morning` is enabled in `briefing_config.slots`, then checks if today is in `profile.work_schedule.days` before running
-
---
-
-## Error handling
-
-| Scenario | Behaviour |
-|---|---|
-| `user_timezone` saved as empty string | `update_user_schedule` called with `tz_override=None` → falls back to `briefing_config.timezone` or UTC |
-| Invalid IANA string saved | `_resolve_timezone` already falls back to UTC with a warning log |
-| `profile.work_schedule` is None | `morning` slot defaults to Mon–Fri |
-| Slot toggles key missing from config | All non-compilation slots default to enabled (`True`) — no regression for existing users |
-| SSO user visits Account tab | Sees info banner; email/password forms hidden; no API calls attempted |
-
---
-
-## What is NOT changing
-
- Profile "Interests" and Briefing "News Preferences" remain separate — they serve different purposes (system-prompt personalisation vs RSS topic filtering)
- `briefing_config.work_days` field is not deleted from existing configs — just stops being written by the UI
- No migration needed — `profile.work_schedule.days` already exists; scheduler change is additive
@@ -1,278 +0,0 @@
-# Web Voice Overlay Polish — Implementation Spec
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Ship the dormant `VoiceOverlay` component by mounting it, wiring the Space bar shortcut, and replacing push-to-talk with click-to-toggle silence detection.
-
-**Architecture:** A new `useSilenceDetector` composable wraps the Web Audio API `AnalyserNode` and fires a callback when sustained silence is detected. `VoiceOverlay` coordinates `useVoiceRecorder` and `useSilenceDetector`, switching from hold-to-record to click-to-toggle. `App.vue` mounts the overlay and adds the Space bar handler.
-
-**Tech Stack:** Vue 3 Composition API, Web Audio API (`AnalyserNode`), existing `useVoiceRecorder` / `useVoiceAudio` composables, TypeScript.
-
---
-
-## File Map
-
-| Action | Path |
-|--------|------|
-| Create | `frontend/src/composables/useSilenceDetector.ts` |
-| Modify | `frontend/src/composables/useVoiceRecorder.ts` |
-| Modify | `frontend/src/components/VoiceOverlay.vue` |
-| Modify | `frontend/src/App.vue` |
-
---
-
-## Task 1: `useSilenceDetector` composable
-
-**Files:**
- Create: `frontend/src/composables/useSilenceDetector.ts`
-
-### Interface
-
-```ts
-export interface SilenceDetectorOptions {
-  thresholdDb?: number       // default -40
-  silenceDurationMs?: number // default 1500
-  minRecordingMs?: number    // default 500
-}
-
-export function useSilenceDetector(options?: SilenceDetectorOptions): {
-  amplitude: Readonly<Ref<number>>   // 0–1, for visualization
-  start(stream: MediaStream, onSilence: () => void): void
-  stop(): void
-}
-```
-
-### Behaviour
-
- `start(stream, onSilence)`:
-  1. Creates `AudioContext`
-  2. `createMediaStreamSource(stream)` → connects to `AnalyserNode` (fftSize 256)
-  3. Records `startedAt = Date.now()`
-  4. Starts a `setInterval` at 100ms that:
-     - Calls `analyser.getByteFrequencyData(dataArray)`
-     - Computes RMS amplitude → maps to 0–1 range for `amplitude.value`
-     - Converts to approximate dB: `db = 20 * log10(rms)` (clamp to -100 when rms === 0)
-     - If `db < thresholdDb`: increments `silenceMs += 100`; else resets `silenceMs = 0`
-     - If `silenceMs >= silenceDurationMs` AND `Date.now() - startedAt >= minRecordingMs`: clears interval, fires `onSilence()`
- `stop()`: clears interval, closes `AudioContext`, resets `amplitude.value = 0`
- Safe to call `stop()` multiple times (guard with null check)
- `amplitude` resets to 0 after `stop()`
-
-### Full implementation
-
-```ts
-import { ref, readonly } from 'vue'
-
-export interface SilenceDetectorOptions {
-  thresholdDb?: number
-  silenceDurationMs?: number
-  minRecordingMs?: number
-}
-
-export function useSilenceDetector(options: SilenceDetectorOptions = {}) {
-  const {
-    thresholdDb = -40,
-    silenceDurationMs = 1500,
-    minRecordingMs = 500,
-  } = options
-
-  const amplitude = ref(0)
-  let audioCtx: AudioContext | null = null
-  let intervalId: ReturnType<typeof setInterval> | null = null
-  let silenceMs = 0
-  let startedAt = 0
-
-  function start(stream: MediaStream, onSilence: () => void) {
-    stop()
-    audioCtx = new AudioContext()
-    const source = audioCtx.createMediaStreamSource(stream)
-    const analyser = audioCtx.createAnalyser()
-    analyser.fftSize = 256
-    source.connect(analyser)
-
-    const data = new Uint8Array(analyser.frequencyBinCount)
-    silenceMs = 0
-    startedAt = Date.now()
-
-    intervalId = setInterval(() => {
-      analyser.getByteFrequencyData(data)
-      const rms = Math.sqrt(data.reduce((s, v) => s + v * v, 0) / data.length) / 255
-      amplitude.value = rms
-
-      const db = rms > 0 ? 20 * Math.log10(rms) : -100
-      if (db < thresholdDb) {
-        silenceMs += 100
-        if (silenceMs >= silenceDurationMs && Date.now() - startedAt >= minRecordingMs) {
-          stop()
-          onSilence()
-        }
-      } else {
-        silenceMs = 0
-      }
-    }, 100)
-  }
-
-  function stop() {
-    if (intervalId !== null) {
-      clearInterval(intervalId)
-      intervalId = null
-    }
-    if (audioCtx) {
-      audioCtx.close().catch(() => {})
-      audioCtx = null
-    }
-    amplitude.value = 0
-    silenceMs = 0
-  }
-
-  return { amplitude: readonly(amplitude), start, stop }
-}
-```
-
- [ ] Write the file exactly as above
- [ ] Verify TypeScript compiles: `cd frontend && npx tsc --noEmit`
- [ ] Commit: `git add frontend/src/composables/useSilenceDetector.ts && git commit -m "feat: add useSilenceDetector composable"`
-
---
-
-## Task 2: Expose `stream` from `useVoiceRecorder`
-
-**Files:**
- Modify: `frontend/src/composables/useVoiceRecorder.ts`
-
-Change the `stream` local variable to a `Ref<MediaStream | null>` and export it as readonly.
-
- [ ] Change `let stream: MediaStream | null = null` to `const streamRef = ref<MediaStream | null>(null)`
- [ ] Replace all `stream` assignments with `streamRef.value`:
-  - `stream = await navigator.mediaDevices.getUserMedia(...)` → `streamRef.value = await ...`
-  - `stream?.getTracks().forEach(...)` → `streamRef.value?.getTracks().forEach(...)`
-  - `stream = null` → `streamRef.value = null`
- [ ] Add `stream: readonly(streamRef)` to the return object
- [ ] Verify TypeScript: `npx tsc --noEmit`
- [ ] Commit: `git add frontend/src/composables/useVoiceRecorder.ts && git commit -m "feat: expose stream ref from useVoiceRecorder"`
-
---
-
-## Task 3: Wire `VoiceOverlay` — silence detection + click-to-toggle
-
-**Files:**
- Modify: `frontend/src/components/VoiceOverlay.vue`
-
-### Script changes
-
- [ ] Import `useSilenceDetector` at the top of `<script setup>`
- [ ] Add `const silenceDetector = useSilenceDetector()` after the existing composable instantiations
- [ ] In `startPtt()`: after `phase.value = 'recording'`, add:
-  ```ts
-  if (recorder.stream.value) {
-    silenceDetector.start(recorder.stream.value, stopPtt)
-  }
-  ```
- [ ] In `stopPtt()`: add `silenceDetector.stop()` as the first line (before the guard check)
- [ ] In `cancelAll()`: add `silenceDetector.stop()` after `recorder.stopRecording().catch(() => {})`
-
-### Button: click-to-toggle
-
-Replace the PTT mouse/touch handlers on `.voice-ptt-btn` with click-to-toggle logic:
-
- [ ] Remove `@mousedown.prevent="startPtt"` and `@mouseup.prevent="stopPtt"`
- [ ] Remove `@touchstart.prevent="startPtt"` and `@touchend.prevent="stopPtt"`
- [ ] Replace `@click.prevent="phase === 'error' ? (phase = 'idle') : undefined"` with:
-  ```html
-  @click.prevent="onBtnClick"
-  ```
- [ ] Add `onBtnClick` function in script:
-  ```ts
-  function onBtnClick() {
-    if (phase.value === 'error') { phase.value = 'idle'; return }
-    if (phase.value === 'recording') { stopPtt(); return }
-    if (phase.value === 'idle') { startPtt() }
-  }
-  ```
- [ ] Update `aria-label` and `title` on the button:
-  - `aria-label`: `phase === 'recording' ? 'Click to stop' : 'Click to speak'`
-  - `title`: `phase === 'recording' ? 'Click to stop or wait for silence' : 'Click or press Space to speak'`
-
-### Amplitude visualization during recording
-
-Inside the button, when `phase === 'recording'`, replace the static stop icon with animated amplitude bars:
-
- [ ] Replace the recording SVG block:
-  ```html
-  <svg v-else-if="phase === 'recording'" ...>...</svg>
-  ```
-  with:
-  ```html
-  <span v-else-if="phase === 'recording'" class="voice-amp-bars">
-    <span
-      v-for="n in 3"
-      :key="n"
-      class="voice-amp-bar"
-      :style="{ transform: `scaleY(${0.3 + silenceDetector.amplitude.value * (0.4 + n * 0.15)})` }"
-    ></span>
-  </span>
-  ```
-
-### Hint label
-
- [ ] Change the idle hint from `Hold <kbd>Space</kbd> or tap` to `Tap or press <kbd>Space</kbd>`
-
-### CSS for amplitude bars
-
- [ ] Add to `<style scoped>`:
-  ```css
-  .voice-amp-bars {
-    display: flex;
-    gap: 3px;
-    align-items: center;
-    height: 22px;
-  }
-  .voice-amp-bar {
-    width: 4px;
-    height: 18px;
-    background: #fff;
-    border-radius: 2px;
-    transform-origin: center;
-    transition: transform 0.08s ease;
-  }
-  ```
-
- [ ] Verify TypeScript: `npx tsc --noEmit`
- [ ] Commit: `git add frontend/src/components/VoiceOverlay.vue && git commit -m "feat: click-to-toggle silence detection in VoiceOverlay"`
-
---
-
-## Task 4: Mount overlay and wire Space bar in `App.vue`
-
-**Files:**
- Modify: `frontend/src/App.vue`
-
-### Mount VoiceOverlay
-
- [ ] Add import at top of `<script setup>`:
-  ```ts
-  import VoiceOverlay from '@/components/VoiceOverlay.vue'
-  ```
- [ ] Add `<VoiceOverlay />` inside the `<template v-if="authStore.isAuthenticated">` block, just before `<ToastNotification />`:
-  ```html
-  <VoiceOverlay />
-  <ToastNotification />
-  ```
-
-### Space bar handler
-
- [ ] In `onGlobalKeydown`, add a `Space` case inside the `switch (e.key)` block (after the existing cases), only fires when `!isInputActive()`:
-  ```ts
-  case ' ':
-    e.preventDefault()
-    document.dispatchEvent(new CustomEvent('voice:ptt-toggle'))
-    break
-  ```
-
-### Shortcuts panel label
-
- [ ] Update the Space shortcut description from `Hold to speak (voice, when enabled)` to `Tap to speak (voice, when enabled)`
-
- [ ] Verify TypeScript: `npx tsc --noEmit`
- [ ] Verify full build: `npm run build`
- [ ] Commit: `git add frontend/src/App.vue && git commit -m "feat: mount VoiceOverlay and wire Space bar shortcut"`
@@ -1,144 +0,0 @@
-# Knowledge View Task Consolidation — Design Spec
-
-## Goal
-
-Consolidate tasks into the Knowledge view as a card type, deprecate the standalone `/notes` and `/tasks` list views, and simplify navigation. The Knowledge view becomes the single hub for all content types: notes, tasks, people, places, and lists.
-
-## Architecture
-
-The Knowledge view already renders notes, people, places, and lists as typed cards in a filterable grid with a sidebar. Tasks are added as a fifth card type using the same two-tier pagination system (ID pre-fetch → content batch). The backend knowledge endpoints (`/api/knowledge/ids`, `/api/knowledge/batch`, `/api/knowledge/counts`) are extended to include tasks. No changes to the note/task CRUD API.
-
-## Task Cards
-
-Task cards follow the same layout as other knowledge cards:
-
- **Left accent strip**: distinct color for tasks (e.g. `#a78bfa` purple to differentiate from note indigo)
- **Type badge**: "Task" in top-right corner
- **Card body**:
-  - Title (2-line clamp)
-  - Status badge: `todo` / `in_progress` / `done` / `cancelled` — styled with existing status colors from theme (`--color-status-*`)
-  - Priority indicator: shown only when priority is not `none` — uses existing priority colors (`--color-priority-*`)
-  - Due date: shown when set, with overdue styling (`--color-overdue`) when past and status is not `done`/`cancelled`
- **Card footer**: tags (up to 3) + last-modified date — identical to other card types
-
-Clicking a task card navigates to `/tasks/:id/edit` (same as today).
-
-## Filter Sidebar Changes
-
-The type filter section gains a "Tasks" button:
-
-```
-Type
-──────────
-[All]           127
-[Notes]          84
-[Tasks]          22
-[People]          8
-[Places]          5
-[Lists]           8
-```
-
-The filter value for tasks is `type=task`. The backend already stores tasks as notes with `is_task=True`; the knowledge endpoints need to map the `type=task` filter to `is_task=True`.
-
-## New Note Button Interaction
-
-Current: click "New note" to create a note; chevron expands a dropdown with Note/Person/Place/List.
-
-New behavior:
-
-1. **Click "New note"** (when collapsed) → expands to reveal type options: Task, Person, Place, List. The main button label does not change.
-2. **Click "New note"** again (when expanded) → navigates to `/notes/new` (generic note).
-3. **Click any type option** → navigates to `/notes/new?type=<type>` (for task: `/notes/new?type=task`, which is equivalent to `/tasks/new`).
-4. **Click outside** → collapses the dropdown.
-
-This replaces the current chevron split-button pattern with a simpler toggle. The dropdown items are: Task, Person, Place, List (no "Note" item in the dropdown — clicking the button itself creates a note).
-
-## Route Changes
-
-### Redirects
-
-| Old route | New behavior |
-|-----------|-------------|
-| `/notes` | 302 redirect → `/` (Knowledge view) |
-| `/tasks` | 302 redirect → `/` (Knowledge view) |
-
-### Preserved routes (no change)
-
-| Route | Purpose |
-|-------|---------|
-| `/notes/:id` | Note viewer |
-| `/notes/:id/edit` | Note editor |
-| `/notes/new` | New note (with optional `?type=` param) |
-| `/tasks/:id/edit` | Task editor |
-| `/tasks/new` | New task |
-
-### Router implementation
-
-Add redirect entries in the router config:
-
-```ts
-{ path: '/notes', redirect: '/' },
-{ path: '/tasks', redirect: '/' },
-```
-
-### Navigation
-
-Remove from `AppHeader.vue`:
- "Tasks" nav link (`<router-link to="/tasks">`)
- The `/tasks` entry in both desktop nav-center and mobile menu
-
-Remove from `AppHeader.vue` (already done — `/notes` was removed in a prior change, but verify).
-
-### Deleted files
-
- `frontend/src/views/NotesListView.vue`
- `frontend/src/views/TasksListView.vue`
- `frontend/src/stores/notes.ts` (if only used by NotesListView)
- `frontend/src/stores/tasks.ts` (if only used by TasksListView)
-
-Verify no other components import from these before deleting. The note/task viewer and editor screens import from `api/client.ts` directly, not from the list stores.
-
-## Backend Changes
-
-### `/api/knowledge/ids`
-
-Accept `type=task` as a valid filter. When `type=task`, query `notes` table with `is_task = True`. When `type` is not set (all), include tasks in results alongside notes/people/places/lists.
-
-### `/api/knowledge/batch`
-
-Return task-specific fields for items where `is_task = True`:
- `status`: todo / in_progress / done / cancelled
- `priority`: none / low / normal / high
- `due_date`: ISO date string or null
-
-These are already columns on the `Note` model — just include them in the batch response when the item is a task.
-
-### `/api/knowledge/counts`
-
-Add `task` to the counts response:
-
-```json
-{ "note": 84, "task": 22, "person": 8, "place": 5, "list": 8, "total": 127 }
-```
-
-### `/api/knowledge/tags`
-
-No change — tasks already have tags on the same `Note` model.
-
-## Keyboard Shortcuts
-
-Remove from `App.vue` `onGlobalKeydown`:
- `case "t": router.push("/tasks/new")` — keep this, it still works
- `case "g"` sequence `case "t": router.push("/tasks")` — change to `router.push("/")` (direct navigation, don't rely on redirect)
-
-Update shortcuts overlay panel text if it references "Tasks list".
-
-## No API Endpoint Changes
-
-All existing REST endpoints remain:
- `GET/POST /api/notes` — notes CRUD
- `GET/POST /api/tasks` — tasks CRUD  
- `PATCH /api/notes/:id`, `PATCH /api/tasks/:id`
- `DELETE /api/notes/:id`, `DELETE /api/tasks/:id`
-
-MCP tools (`fable_create_task`, `fable_list_tasks`, etc.) are unaffected.
@@ -1,204 +0,0 @@
-# Specialized Note Type Editors — Design Spec
-
-## Goal
-
-Replace the one-size-fits-all note editor with type-specialized views for Person, Place, and List. Each type gets a form-first layout where structured fields are the main content, with a secondary notes area for free text. Fix tab navigation across all note types so focus flows logically from title through fields to body, skipping the formatting toolbar.
-
-## Architecture
-
-The existing `NoteEditorView.vue` remains the single editor component but renders different layouts based on `noteType`. When `noteType` is `person`, `place`, or `list`, the main editor area switches from TipTap-first to form-first. The TipTap editor moves to a secondary "Notes" section below the form fields. The sidebar metadata fields for person/place move into the main content area. The `note_type` field, entity metadata storage, and API contract are unchanged.
-
-## Person Editor
-
-When `noteType === 'person'`, the main content area renders a contact card form instead of the TipTap editor.
-
-### Fields (in order, all in main content area)
-
-| Field | Type | Placeholder | Source |
-|-------|------|-------------|--------|
-| Name | text input (title) | "Name" | `title` |
-| Relationship | text input | "e.g. Friend, Colleague, Family" | `entityMeta.relationship` |
-| Birthday | date input | — | `entityMeta.birthday` (new field) |
-| Email | email input | "email@example.com" | `entityMeta.email` |
-| Phone | tel input | "+1 555 000 0000" | `entityMeta.phone` |
-| Organization | text input | "Company or organization" | `entityMeta.organization` (new field) |
-| Address | text input | "Street, City, State" | `entityMeta.address` (new field for person) |
-
-### Notes section
-
-Below the form fields, a collapsible "Notes" section with the TipTap editor for free-text content. This is where wikilinks, tags, and general context go. The section starts expanded if the note already has body content, collapsed if empty on a new note.
-
-### Layout
-
-```
-┌──────────────────────────────────────────┐
-│ [← Knowledge]  [Save]  [Delete]          │
-│                                          │
-│ Name: [________________________________] │
-│                                          │
-│ Relationship: [________________________] │
-│ Birthday:     [____date picker________]  │
-│ Email:        [________________________] │
-│ Phone:        [________________________] │
-│ Organization: [________________________] │
-│ Address:      [________________________] │
-│                                          │
-│ ▾ Notes                                  │
-│ ┌──────────────────────────────────────┐ │
-│ │ TipTap editor (markdown body)       │ │
-│ └──────────────────────────────────────┘ │
-│                                          │
-│           [sidebar: project/tags/etc]    │
-└──────────────────────────────────────────┘
-```
-
-### Data migration
-
-Existing person notes may have structured data written as plain text in the body (e.g. "Relationship: daughter Birthday: 2013-12-13"). No automatic migration — the body content stays as-is in the Notes section. Users can move data to the structured fields manually.
-
-## Place Editor
-
-When `noteType === 'place'`, same form-first pattern.
-
-### Fields
-
-| Field | Type | Placeholder | Source |
-|-------|------|-------------|--------|
-| Name | text input (title) | "Place name" | `title` |
-| Address | text input | "Street, City, State" | `entityMeta.address` |
-| Phone | tel input | "+1 555 000 0000" | `entityMeta.phone` |
-| Hours | text input | "e.g. Mon–Fri 9am–5pm" | `entityMeta.hours` |
-| Website | url input | "https://..." | `entityMeta.website` (new field) |
-| Category | text input | "e.g. Restaurant, Office, Doctor" | `entityMeta.category` (new field) |
-
-### Notes section
-
-Same as Person — collapsible TipTap editor below the form.
-
-## List Editor
-
-When `noteType === 'list'`, the main content area renders a checklist builder instead of the TipTap editor.
-
-### List builder
-
-Each list item is a row with:
- Checkbox (toggle checked state)
- Text input (item text, fills available width)
- Delete button (× icon, right side)
-
-Below the items: an "Add item" button.
-
-### Behavior
-
- **Enter** in any item input: creates a new item below and focuses it
- **Backspace** on an empty item: deletes the item and focuses the previous one
- **Checkbox toggle**: updates the item's checked state
- **Delete button**: removes the item
-
-### Serialization
-
-On save, list items are serialized to markdown checkbox format in the body:
-```markdown
- [ ] Buy groceries
- [x] Call dentist
- [ ] Pick up prescription
-```
-
-On load, the body is parsed back into structured items (same parser already exists in `knowledge.py` and `KnowledgeView.vue`).
-
-### Notes section
-
-Same collapsible TipTap "Notes" section below the list builder, for additional context that isn't a list item.
-
-### Layout
-
-```
-┌──────────────────────────────────────────┐
-│ [← Knowledge]  [Save]  [Delete]          │
-│                                          │
-│ List title: [____________________________│
-│                                          │
-│ [ ] Buy groceries                    [×] │
-│ [x] Call dentist                     [×] │
-│ [ ] Pick up prescription            [×] │
-│                                          │
-│ [+ Add item]                             │
-│                                          │
-│ ▾ Notes                                  │
-│ ┌──────────────────────────────────────┐ │
-│ │ TipTap editor (additional context)  │ │
-│ └──────────────────────────────────────┘ │
-│                                          │
-│           [sidebar: project/tags/etc]    │
-└──────────────────────────────────────────┘
-```
-
-## Tab Navigation & Auto-Focus
-
-### All note types
-
-1. **On page load**: focus the title/name input automatically
-2. **Tab from title**: skip the formatting toolbar entirely, go to the first content field:
-   - Note: TipTap editor body
-   - Person: Relationship field
-   - Place: Address field
-   - List: first list item (or "Add item" button if empty)
-3. **Tab through fields**: natural order through all form fields
-4. **Tab from last form field**: enter the Notes section (TipTap editor)
-
-### Implementation
-
-Set `tabindex="-1"` on all MarkdownToolbar buttons so they are clickable but not in the tab order. The toolbar remains fully functional via mouse/touch — it's just skipped when tabbing.
-
-### Title placeholder by type
-
-| Type | Placeholder |
-|------|-------------|
-| Note | "Title" |
-| Person | "Name" |
-| Place | "Place name" |
-| List | "List title" |
-| Task | "Title" (unchanged, task editor is separate) |
-
-## Sidebar changes
-
-When editing a Person or Place, the type-specific metadata fields (Relationship, Email, Phone, etc.) **move from the sidebar to the main content area**. The sidebar keeps: Project, Milestone, Tags, Suggest Tags, Type selector, Link Suggestions, Writing Assistant, Version History.
-
-The Type selector remains in the sidebar so users can change the type if needed. Changing type switches the layout.
-
-## Backend changes
-
-### New entity metadata fields
-
-The `entity_meta` JSON column on the Note model already stores arbitrary key-value pairs. No schema migration needed — just store the new keys:
-
- Person: `birthday`, `organization`, `address` (new; `relationship`, `email`, `phone` existing)
- Place: `website`, `category` (new; `address`, `phone`, `hours` existing)
-
-### Knowledge service
-
-Update `_note_to_item` in `services/knowledge.py` to include the new fields in the response for person and place cards:
-
- Person: add `birthday`, `organization`, `address`
- Place: add `website`, `category`
-
-### Knowledge card display
-
-Update `KnowledgeView.vue` card rendering to show the new fields where useful (e.g. organization on person cards, category on place cards).
-
-## Files changed
-
-| File | Change |
-|------|--------|
-| `frontend/src/views/NoteEditorView.vue` | Type-conditional layouts, form fields, list builder, tab navigation, auto-focus, title placeholders |
-| `frontend/src/views/KnowledgeView.vue` | Card display for new person/place fields |
-| `frontend/src/components/MarkdownToolbar.vue` | `tabindex="-1"` on all buttons |
-| `src/fabledassistant/services/knowledge.py` | New fields in `_note_to_item` for person/place |
-
-## What does NOT change
-
- Note model / database schema (entity_meta is already a JSON column)
- API endpoints (same CRUD)
- Task editor (`TaskEditorView.vue`) — separate component, unchanged
- Generic note editing — TipTap-first layout stays for `noteType === 'note'`
- Backend storage format — entity_meta key-value pairs
@@ -1,249 +0,0 @@
-# Modern Fable — Visual Identity Design Spec
-
-## Goal
-
-Replace the generic "competent dark-mode Vue app" aesthetic with a distinctive visual identity that is unmistakably Fabled Assistant. The design language evolves from "Illuminated Transcript" to "Modern Fable" — keeping the scholarly DNA but adding personality through color, typography, interaction, and card design that no other app has.
-
-## Color Palette
-
-Shift from indigo (`#6366f1`) to deep violet + muted gold.
-
-### Dark theme
-
-| Role | Old | New | Usage |
-|------|-----|-----|-------|
-| Primary | `#818cf8` | `#a78bfa` | Text accents, active states, tags, links |
-| Primary solid | `#6366f1` | `#7c3aed` | Buttons, gradients, accent strips |
-| Primary deep | `#4f46e5` | `#5b21b6` | Gradient endpoints, hover states |
-| Accent (warm) | — | `#d4a017` | Due dates, event times, counts, temporal data |
-| Accent light | — | `#e8c45a` | Amber hover states |
-| Background | `#111113` | `#0f0f14` | Slightly deeper, more dramatic |
-| Surface | `#1a1b22` | `#16161f` | Cards, panels |
-| Card bg | `#1e1e27` | `#1a1a24` | Card interiors |
-| Border | `rgba(99,102,241,0.10)` | `rgba(124,58,237,0.12)` | Violet-tinted borders |
-| Text | `#e4e4f0` | `#e4e4f0` | Unchanged |
-| Text muted | `#52526a` | `#52526a` | Unchanged |
-
-### Light theme
-
-| Role | Old | New |
-|------|-----|-----|
-| Primary | `#6366f1` | `#7c3aed` |
-| Primary text | `#4f46e5` | `#5b21b6` |
-| Accent | — | `#b8860b` (darker gold for light bg) |
-| Tag bg | `#ede9fe` | `#ede5ff` |
-| Tag text | `#4f46e5` | `#6d28d9` |
-
-### Semantic color rules
-
- **Violet = structural** — navigation, type badges, status indicators, card accents, CTA buttons
- **Amber/gold = temporal** — due dates, event times, countdown values, "overdue" states, calendar dot, relative timestamps
- This duality is a core brand principle: violet organizes, amber marks time
-
-### Logo update
-
-Update `AppLogo.vue` SVG fill to use the new violet gradient (`#7c3aed` → `#5b21b6`) instead of the current indigo values.
-
-## Card Design — Type DNA
-
-Each content type gets a distinct visual signature recognizable at a glance without reading the badge.
-
-### Shared card structure
-
- Background: `var(--color-surface)`
- Border: `1px solid` with type-tinted color at low opacity
- Border-radius: `var(--radius-lg)` (14px)
- Padding: 14px
- Hover: translateY(-2px) + violet shadow bloom (`0 8px 24px rgba(124,58,237,0.15)`)
-
-### Type-specific signatures
-
-**Note** (`note`)
- Top edge: full-width 3px gradient bar (`#7c3aed` → `#a78bfa`)
- Border tint: `rgba(124,58,237,0.12)`
- Badge color: `#a78bfa`
-
-**Task** (`task`)
- Top edge: half-width 3px gradient bar (`#d4a017` → transparent`), left-aligned — partial bar suggests "in progress"
- Border tint: `rgba(212,160,23,0.10)`
- Badge color: `#d4a017`
- Status badge inline with type badge row
- Due date in amber; overdue in `--color-overdue` (red)
-
-**Person** (`person`)
- Top edge: none
- Corner accent: subtle 60px quarter-circle in top-right (`rgba(16,185,129,0.06)`)
- Border tint: `rgba(16,185,129,0.10)`
- Badge color: `#34d399`
-
-**Place** (`place`)
- Top edge: none
- Corner accent: subtle 60px quarter-circle in top-right (`rgba(245,158,11,0.06)`)
- Border tint: `rgba(245,158,11,0.10)`
- Badge color: `#fbbf24`
-
-**List** (`list`)
- Top edge: full-width 3px gradient bar (`#38bdf8` → `#7dd3fc`)
- Border tint: `rgba(56,189,248,0.10)`
- Badge color: `#7dd3fc`
- Progress bar beneath checkboxes
-
-### Card hover state
-
-All cards share the same hover treatment:
-```css
-.k-card:hover {
-  transform: translateY(-2px);
-  box-shadow: 0 8px 24px rgba(124,58,237,0.15), 0 2px 8px rgba(0,0,0,0.3);
-  border-color: rgba(124,58,237,0.2);
-}
-```
-
-## Navigation — Signature Header
-
-Replace the flat nav links with a pill-grouped tab bar.
-
-### Structure
-
-```
-[Logo + "Fabled"]  [  Knowledge | Chat | Briefing | Calendar | News | Projects  ]  [status · ? · ☀ · ⚙ · user]
-```
-
-### Brand in header
-
- Logo: `AppLogo` SVG at 28px with new violet gradient
- Text: "Fabled" only (not "Fabled Assistant") — Fraunces italic, `#c4b0f0`, 15px
- The full name "Fabled Assistant" appears on the login page and Settings; the header uses the short form
-
-### Tab bar
-
- Container: `rgba(124,58,237,0.06)` background, `border-radius: 10px`, 3px padding
- Inactive tabs: transparent background, `color: var(--color-text-muted)`
- Active tab: `rgba(124,58,237,0.2)` background, `border-radius: 8px`, `color: #c4b5fd`, soft box-shadow glow `0 0 12px rgba(124,58,237,0.2)`
- Hover (inactive): `rgba(124,58,237,0.08)` background
- Transition: background 0.15s, color 0.15s
-
-### Header background
-
-Subtle gradient: `linear-gradient(180deg, var(--color-surface), var(--color-bg))` with a bottom border of `rgba(124,58,237,0.08)`. Creates depth without being heavy.
-
-### Mobile
-
-On mobile (< 768px), the pill bar collapses into the existing hamburger dropdown menu. The dropdown gets the same violet active styling.
-
-## Typography — Fraunces as Narrator
-
-Fraunces italic becomes the "narrator's voice" of the application — the assistant speaking through the UI. System UI font remains for body text and interactive elements.
-
-### Where Fraunces is used
-
-| Element | Style | Example |
-|---------|-------|---------|
-| View titles | Fraunces italic, 20-24px, `#c4b0f0` | *Knowledge*, *Chat*, *Briefing* |
-| Sidebar section labels | Fraunces italic, 11px, `var(--color-primary)` | *Filter*, *Tags*, *Sort* |
-| Empty states | Fraunces italic, 13-15px, `#d4a017` | *"Every story starts with a blank page."* |
-| Card headings (h1/h2/h3) | Fraunces, non-italic, 600 weight | Existing behavior, unchanged |
-| Briefing greeting | Fraunces italic, 16px | *"Good morning, Bryan"* |
-
-### Where Fraunces is NOT used
-
- Navigation tab labels (system font, 12-13px)
- Buttons and form labels
- Card body text, snippets, metadata
- Toast messages, error text
-
-### Empty state voice
-
-Each major view gets a distinctive empty state message in Fraunces italic, amber color:
- Knowledge: *"Your story is unwritten. Create your first note to begin."*
- Chat: *"Start a conversation."*
- Calendar: *"No events ahead. A quiet chapter."*
- Briefing (no briefing yet): *"Your daily briefing will appear here each morning."*
-
-## Living Details
-
-Small touches that accumulate into a distinctive feel.
-
-### Glow interactions
-
- **Buttons**: Primary buttons (`btn-send`, `btn-new-note`, CTAs) get a violet glow on hover: `box-shadow: 0 0 16px rgba(124,58,237,0.35)`
- **Focus ring**: Change from current `color-mix` to a violet glow: `0 0 0 2px rgba(124,58,237,0.4)`
- **Active nav tab**: Soft glow behind the active pill (see Navigation section)
-
-### Amber for temporal data
-
-Consistently use `#d4a017` (dark theme) for all time-related information:
- Due dates on task cards
- Event times on calendar chips
- "3d ago" timestamps on cards
- Overdue badge in the today bar
- Countdown/relative time in briefing
-
-This creates a visual language: when you see amber, it's about *when*.
-
-### Card hover bloom
-
-Cards lift and emit a violet shadow on hover (see Card Design section). The shadow color matches the card's type accent at very low opacity for a subtle differentiation.
-
-### Status dot pulse
-
-The Ollama status indicator in the header gains a CSS pulse animation when the model is loaded:
-```css
-@keyframes status-pulse {
-  0%, 100% { box-shadow: 0 0 4px rgba(74,222,128,0.4); }
-  50% { box-shadow: 0 0 10px rgba(74,222,128,0.6); }
-}
-```
-Pulse only when status is "loaded" (green). Offline (red) and loading (amber) are static.
-
-### Scroll edge fades
-
-Top and bottom edges of scrollable areas (card grid, chat messages, sidebar tag list) get a gradient mask that fades content into the background. 20px height, using `mask-image: linear-gradient(...)`.
-
-### Sidebar section dividers
-
-Replace flat `border-bottom` between filter sections with a centered ornamental divider:
-```css
-.filter-section + .filter-section::before {
-  content: '·';
-  display: block;
-  text-align: center;
-  color: rgba(124,58,237,0.3);
-  font-size: 1.2rem;
-  letter-spacing: 0.5em;
-  padding: 8px 0;
-}
-```
-Three centered dots (` · · · `) in faint violet. Subtle but distinctive.
-
-### Scrollbar
-
-Keep the current thin scrollbar but update the color from indigo to violet:
-```css
-::-webkit-scrollbar-thumb {
-  background: rgba(124,58,237,0.25);
-}
-```
-
-## Files Changed
-
-| File | Change |
-|------|--------|
-| `frontend/src/assets/theme.css` | Full palette update (both light and dark), scrollbar color |
-| `frontend/src/components/AppLogo.vue` | SVG fill gradient update |
-| `frontend/src/components/AppHeader.vue` | Pill-grouped nav tabs, brand shortening, header gradient, status pulse |
-| `frontend/src/views/KnowledgeView.vue` | Card type DNA (gradient bars, corner accents), hover bloom, section dividers, empty state text, scroll fades, Fraunces view title |
-| `frontend/src/components/ChatPanel.vue` | Scroll fade on messages, empty state text |
-| `frontend/src/views/CalendarView.vue` | Empty state text, amber event times |
-| `frontend/src/views/BriefingView.vue` | Empty state text, Fraunces greeting |
-| `frontend/src/views/ChatView.vue` | (uses ChatPanel — inherits changes) |
-| `frontend/src/App.vue` | Update any global styles referencing old indigo values |
-
-## What Does NOT Change
-
- Overall layout structure (sidebar + content + optional graph panel)
- Chat bubble design (user transparent, assistant border-left + shadow)
- TipTap editor styling
- Settings view layout
- Backend — zero changes
- Mobile layout patterns
@@ -1,119 +0,0 @@
-# Unified Lookup Tool & Wikipedia Integration
-
-## Goal
-
-Replace the fragmented `search_web` tool with a single `lookup` tool that checks Wikipedia first and falls back to SearXNG web search. Add Wikipedia as an additional source in the research pipeline. Result: one lightweight tool for factual questions (always available, no config required), and richer research output.
-
-## Architecture
-
-Two changes to the search/knowledge stack:
-
-1. **New `lookup` tool** replaces `search_web`. Tries Wikipedia REST API summary endpoint first (~200ms, reliable, no config). Falls back to SearXNG + trafilatura article fetch when Wikipedia misses and SearXNG is configured. Always available (no `requires` field).
-
-2. **Wikipedia sources in research pipeline.** During sub-query execution, `wiki_search` runs alongside `_search_searxng`. Wikipedia articles merge into the source pool and get deduplicated by URL.
-
-Shared Wikipedia logic lives in a new `wikipedia.py` service module.
-
-## Components
-
-### `src/fabledassistant/services/wikipedia.py` (new)
-
-Two async functions:
-
-**`wiki_summary(query: str) -> dict | None`**
- Direct title lookup via `https://en.wikipedia.org/api/rest_v1/page/summary/{title}`
- Returns `{"title": str, "extract": str, "url": str}` on hit
- Returns `None` on 404, disambiguation pages (`"type": "disambiguation"`), network errors, or empty extracts
- 5-second timeout
- User-Agent: `"FabledAssistant/1.0 (https://fabledsword.com)"`
-
-**`wiki_search(query: str, limit: int = 3) -> list[dict]`**
- Search via `https://en.wikipedia.org/w/api.php?action=query&list=search&srsearch={query}&srlimit={limit}&format=json`
- For each search result, fetch its summary via the summary endpoint to get the extract
- Returns `[{"title": str, "extract": str, "url": str}, ...]`
- Returns `[]` on any failure
- Same timeout and User-Agent as above
-
-### `src/fabledassistant/services/tools/web.py` (modified)
-
-**Remove:** `search_web_tool`
-
-**Add:** `lookup_tool`
-
-```
-@tool(
-    name="lookup",
-    description="Look up a topic, concept, or factual question. Returns a concise
-                 answer from Wikipedia or web sources. Use for definitions,
-                 explanations, 'what is X', 'how does Y work'. For comprehensive
-                 written reports saved as notes, use research_topic instead.",
-    parameters={
-        "query": {"type": "string", "description": "The topic or question to look up"},
-    },
-    required=["query"],
-)
-```
-
-No `requires` field — always available.
-
-**Logic:**
-1. Call `wiki_summary(query)`
-2. If Wikipedia returns a result: return `{"success": True, "type": "lookup", "source": "wikipedia", "data": {"title": ..., "extract": ..., "url": ...}}`
-3. If Wikipedia misses and `Config.searxng_enabled()`:
-   - Call `_search_searxng(query)` to get search results
-   - Fetch top 1-2 result URLs via `_fetch_full_article` (from `rss.py`, trafilatura-based)
-   - Return `{"success": True, "type": "lookup", "source": "web", "data": {"query": ..., "results": [...], "content": ...}}`
-4. If Wikipedia misses and no SearXNG: return `{"success": True, "type": "lookup", "source": "none", "data": {"query": ..., "message": "No results found. You can answer from your own knowledge."}}`
-
-### `src/fabledassistant/services/research.py` (modified)
-
-**In Step 2 (parallel search):**
- For each sub-query, run `wiki_search(query, limit=1)` concurrently with `_search_searxng(query)`
- Merge Wikipedia results into the per-query result list
-
-**In Step 3 (deduplication):**
- When deduplicating URLs, Wikipedia URLs (`wikipedia.org`) are checked against SearXNG results
- If a Wikipedia article URL already appears in SearXNG results, skip the duplicate
-
-**Wikipedia article content for synthesis:**
- The `extract` from `wiki_search` is used as the source content (no additional fetch needed, unlike SearXNG URLs which require `fetch_url_content`)
- This means Wikipedia sources are available immediately without an HTTP fetch step
-
-## Error Handling
-
- All Wikipedia API failures (network, timeout, malformed JSON) return `None`/`[]` silently
- `lookup` never raises — always returns a response the model can work with
- In the research pipeline, Wikipedia is purely additive; its failure never degrades existing SearXNG-based research
- Disambiguation pages are detected via `"type": "disambiguation"` in the summary response and treated as a miss
-
-## Testing
-
-### `tests/test_wikipedia.py` (new)
-
- `test_wiki_summary_returns_extract` — mock successful summary response, verify return shape
- `test_wiki_summary_returns_none_on_404` — mock 404, verify `None`
- `test_wiki_summary_returns_none_on_disambiguation` — mock disambiguation response, verify `None`
- `test_wiki_search_returns_results` — mock search API + summary fetches, verify list
- `test_wiki_search_returns_empty_on_failure` — mock network error, verify `[]`
-
-### `tests/test_lookup_tool.py` (new)
-
- `test_lookup_wikipedia_hit` — mock `wiki_summary` returning data, verify tool returns wikipedia source
- `test_lookup_wikipedia_miss_searxng_fallback` — mock `wiki_summary` returning None, SearXNG returning results + article fetch, verify web source
- `test_lookup_wikipedia_miss_no_searxng` — mock both missing, verify graceful "no results" response
- `test_lookup_always_available` — verify the tool appears in `get_tools_for_user` regardless of SearXNG config
-
-### `tests/test_research_pipeline.py` (add to existing)
-
- `test_research_includes_wikipedia_sources` — mock `wiki_search` alongside SearXNG, verify Wikipedia results appear in source pool
-
-All tests mock HTTP calls — no live API hits.
-
-## What Doesn't Change
-
- `read_article` tool — stays as-is (explicit URL fetch, different purpose)
- `research_topic` tool definition — stays as-is (same name, description, parameters)
- `generation_task.py` research interception — stays as-is
- `search_images` tool — stays as-is
- `_search_searxng` and `_search_searxng_images` — stay as-is
- `_fetch_full_article` in `rss.py` — stays as-is, reused by `lookup` for SearXNG fallback
@@ -1,2 +0,0 @@
-FABLE_URL=http://localhost:5000
-FABLE_API_KEY=fmcp_your_key_here
@@ -1,126 +0,0 @@
-"""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
@@ -1,757 +0,0 @@
-"""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()
@@ -1,20 +0,0 @@
-"""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)
@@ -1,95 +0,0 @@
-"""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,
-    }
@@ -1,96 +0,0 @@
-"""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}")
@@ -1,53 +0,0 @@
-"""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
-    )
@@ -1,72 +0,0 @@
-"""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}")
@@ -1,59 +0,0 @@
-"""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)
@@ -1,30 +0,0 @@
-"""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)
@@ -1,93 +0,0 @@
-"""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})
@@ -1,24 +0,0 @@
-[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"]
@@ -1,12 +0,0 @@
-"""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
@@ -1,142 +0,0 @@
-"""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
@@ -1,58 +0,0 @@
-"""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]
@@ -1,35 +0,0 @@
-"""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
@@ -1,56 +0,0 @@
-"""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")
@@ -1,42 +0,0 @@
-"""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]
@@ -1,54 +0,0 @@
-"""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"
@@ -1,771 +0,0 @@
-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.3.0"
-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" },
-]
@@ -1,11 +1,11 @@
 {
-  "name": "fabledassistant-frontend",
+  "name": "scribe-frontend",
  "version": "0.1.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
-      "name": "fabledassistant-frontend",
+      "name": "scribe-frontend",
      "version": "0.1.0",
      "dependencies": {
        "@fullcalendar/core": "^6.1.20",
@@ -1,5 +1,5 @@
 {
-  "name": "fabledassistant-frontend",
+  "name": "scribe-frontend",
  "private": true,
  "version": "0.1.0",
  "type": "module",
@@ -1,45 +1,11 @@
-// 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 || '/';
+// 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.

-  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 => {
+self.addEventListener('fetch', () => {
  // Pass-through — no offline caching in v1
 });
@@ -5,43 +5,26 @@ 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() {
-  chatStore.stopStatusPolling();
+  // no-op for now; kept as a hook for future per-session teardown
 }

 function isInputActive(): boolean {
@@ -96,9 +79,9 @@ function onGlobalKeydown(e: KeyboardEvent) {
      case "n": router.push("/notes"); break;
      case "t": router.push("/"); break;
      case "p": router.push("/projects"); break;
-      case "c": router.push("/chat"); break;
+      case "r": router.push("/rules"); break;
      case "g": router.push("/graph"); break;
-      case "l": router.push("/calendar"); break;
+      case "x": router.push("/trash"); break;
    }
    return;
  }
@@ -126,13 +109,6 @@ 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;
  }
 }

@@ -163,7 +139,6 @@ watch(

 onUnmounted(() => {
  document.removeEventListener("keydown", onGlobalKeydown);
-  document.removeEventListener("visibilitychange", onVisibilityChange);
  stopAppServices();
 });
 </script>
@@ -217,14 +192,8 @@ onUnmounted(() => {
              <div class="shortcut-row">
                <kbd class="shortcut-key">g</kbd>
                <span class="shortcut-key-sep">+</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">l</kbd>
-                <span class="shortcut-desc">Calendar</span>
+                <kbd class="shortcut-key">x</kbd>
+                <span class="shortcut-desc">Trash</span>
              </div>
              <div class="shortcut-row">
                <kbd class="shortcut-key">Esc</kbd>
@@ -267,23 +236,6 @@ 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>
@@ -303,7 +255,7 @@ onUnmounted(() => {
  z-index: 9999;
  padding: 0.4rem 0.75rem;
  background: var(--color-primary);
-  color: #fff;
+  color: var(--fs-text-on-action);
  border-radius: 0 0 4px 4px;
  font-size: 0.875rem;
  text-decoration: none;
@@ -328,8 +280,6 @@ onUnmounted(() => {
  min-height: 0;
  overflow-y: auto;
 }
-.app-content:has(.workspace-root),
-.app-content:has(.chat-page),
 .app-content:has(.knowledge-root) {
  overflow: hidden;
 }
@@ -299,136 +299,6 @@ 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;
-  closeout_enabled?: boolean;
-  // 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,
@@ -504,72 +374,6 @@ export async function apiStreamPost(
  }
 }

-// ---------------------------------------------------------------------------
-// Calendar events
-// ---------------------------------------------------------------------------
-
-export interface EventEntry {
-  id: number;
-  uid: string;
-  title: string;
-  start_dt: string;
-  end_dt: string | null;
-  all_day: boolean;
-  description: string;
-  location: string;
-  color: string;
-  recurrence: string | null;
-  caldav_uid: string;
-  project_id: number | null;
-  user_id: number;
-  created_at: string | null;
-  updated_at: string | null;
-}
-
-export interface EventCreatePayload {
-  title: string;
-  start_dt: string;
-  end_dt?: string;
-  all_day?: boolean;
-  description?: string;
-  location?: string;
-  color?: string;
-  recurrence?: string;
-  project_id?: number;
-}
-
-export interface EventUpdatePayload {
-  title?: string;
-  start_dt?: string;
-  end_dt?: string;
-  all_day?: boolean;
-  description?: string;
-  location?: string;
-  color?: string;
-  recurrence?: string | null;
-  project_id?: number;
-}
-
-export async function listEvents(from: string, to: string): Promise<EventEntry[]> {
-  return apiGet<EventEntry[]>(`/api/events?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}`);
-}
-
-export async function createEvent(payload: EventCreatePayload): Promise<EventEntry> {
-  return apiPost<EventEntry>('/api/events', payload);
-}
-
-export async function getEvent(id: number): Promise<EventEntry> {
-  return apiGet<EventEntry>(`/api/events/${id}`);
-}
-
-export async function updateEvent(id: number, payload: EventUpdatePayload): Promise<EventEntry> {
-  return apiPatch<EventEntry>(`/api/events/${id}`, payload);
-}
-
-export async function deleteEvent(id: number): Promise<void> {
-  return apiDelete(`/api/events/${id}`);
-}
-
 // ─── API Keys ─────────────────────────────────────────────────────────────────

 export interface ApiKeyEntry {
@@ -588,93 +392,6 @@ 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 {
@@ -686,22 +403,26 @@ 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)
-export const consolidateProfile = () =>
-  apiPost<{ status: string; learned_summary: string }>('/api/profile/consolidate', {})
-export const clearProfileObservations = () => apiDelete('/api/profile/observations')

-export interface ProfileObservationEntry {
-  date: string
-  bullets: string
-}

-export const listProfileObservations = () =>
-  apiGet<{ observations: ProfileObservationEntry[] }>('/api/profile/observations')
+// ── 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`)
@@ -0,0 +1,9 @@
+import { apiGet } from "@/api/client";
+import type { ExpectationResponse } from "@/utils/designDrift";
+
+/** Checkable claims from the rulebook this install designated as its design system.
+ *
+ *  `rulebook_id: null` means none has been designated — the normal state for a
+ *  fresh install, not an error. The caller shows an explanatory empty state. */
+export const fetchDesignExpectations = () =>
+  apiGet<ExpectationResponse>("/api/design/expectations");
@@ -0,0 +1,188 @@
+/**
+ * Design systems — the stylesheet held as records (milestone #254).
+ *
+ * A design system is a named set of tokens with an optional parent. A system
+ * with no parent is a "family"; one with a parent holds ONLY what it changes,
+ * so "what does this app alter?" is a plain list rather than a diff.
+ */
+import { apiDelete, apiGet, apiPatch, apiPost, apiPut } from "@/api/client";
+
+export interface DesignSystem {
+  id: number;
+  owner_user_id: number;
+  title: string;
+  description: string;
+  /** Narrative a token table cannot hold: aesthetic, voice, what's out of scope. */
+  guidance: string;
+  parent_id: number | null;
+  created_at: string | null;
+  updated_at: string | null;
+}
+
+/** A token as STORED — one system's own row for it. */
+export interface DesignToken {
+  id: number;
+  design_system_id: number;
+  name: string;
+  /** Values keyed by mode. `base` applies when no mode is more specific. */
+  value_by_mode: Record<string, string>;
+  group_name: string | null;
+  purpose: string | null;
+  /** WHY it is this value — distinct from `purpose`, which is what it is FOR. */
+  rationale: string | null;
+  /** Literal values this token should be used INSTEAD OF, e.g. ["#fff"].
+   *
+   *  How a design system records what a prohibition was trying to say: not
+   *  "white is banned" but "write this token instead". Declared rather than
+   *  inferred, because a superseded literal and the token's own value are
+   *  usually different values and nothing could connect them by matching. */
+  supersedes: string[];
+  order_index: number;
+}
+
+export interface Contribution {
+  system_id: number;
+  value: string;
+}
+
+/**
+ * A token after the cascade.
+ *
+ * `contributions` is every system that offered a value, per mode, DEEPEST
+ * FIRST — entry 0 won and the rest were shadowed. `value_by_mode` and
+ * `origin_by_mode` are the winners, provided so the client never has to derive
+ * them (and so it cannot derive them differently).
+ *
+ * Provenance is per MODE because overriding is: a system can own `base` and
+ * inherit `dark` at the same time.
+ */
+export interface ResolvedToken {
+  name: string;
+  group_name: string | null;
+  purpose: string | null;
+  rationale: string | null;
+  supersedes: string[];
+  order_index: number;
+  value_by_mode: Record<string, string>;
+  origin_by_mode: Record<string, number>;
+  contributions: Record<string, Contribution[]>;
+}
+
+export const fetchDesignSystems = () =>
+  apiGet<{ design_systems: DesignSystem[] }>("/api/design-systems");
+
+export const fetchDesignSystem = (id: number) =>
+  apiGet<DesignSystem>(`/api/design-systems/${id}`);
+
+export const createDesignSystem = (body: {
+  title: string;
+  description?: string;
+  guidance?: string;
+  parent_id?: number | null;
+}) => apiPost<DesignSystem>("/api/design-systems", body);
+
+/** Omit `parent_id` to leave it alone; send `null` to make the system a family. */
+export const updateDesignSystem = (
+  id: number,
+  body: {
+    title?: string;
+    description?: string;
+    guidance?: string;
+    parent_id?: number | null;
+  },
+) => apiPatch<DesignSystem>(`/api/design-systems/${id}`, body);
+
+export const deleteDesignSystem = (id: number) =>
+  apiDelete(`/api/design-systems/${id}`);
+
+/** The EFFECTIVE set: everything inherited, with this system's on top. */
+export const fetchResolvedTokens = (id: number) =>
+  apiGet<{ design_system_id: number; tokens: ResolvedToken[] }>(
+    `/api/design-systems/${id}/resolved`,
+  );
+
+/** This system's OWN tokens — its override set. */
+export const fetchDesignTokens = (id: number) =>
+  apiGet<{ tokens: DesignToken[] }>(`/api/design-systems/${id}/tokens`);
+
+export const createDesignToken = (
+  designSystemId: number,
+  body: {
+    name: string;
+    value_by_mode?: Record<string, string>;
+    group_name?: string | null;
+    purpose?: string | null;
+    rationale?: string | null;
+    supersedes?: string[];
+    order_index?: number;
+  },
+) => apiPost<DesignToken>(`/api/design-systems/${designSystemId}/tokens`, body);
+
+export const updateDesignToken = (
+  tokenId: number,
+  body: Partial<Omit<DesignToken, "id" | "design_system_id">>,
+) => apiPatch<DesignToken>(`/api/design-tokens/${tokenId}`, body);
+
+export const deleteDesignToken = (tokenId: number) =>
+  apiDelete(`/api/design-tokens/${tokenId}`);
+
+/** Point a project at a design system. `null` clears it. */
+export const setProjectDesignSystem = (
+  projectId: number,
+  designSystemId: number | null,
+) =>
+  apiPut<{ project_id: number; design_system_id: number | null }>(
+    `/api/projects/${projectId}/design-system`,
+    { design_system_id: designSystemId },
+  );
+
+export interface StylesheetResult {
+  design_system_id: number;
+  /** The master sheet: purpose tokens only, no element or class rules. */
+  css: string;
+  token_count: number;
+  /** Tokens the system names but has no value for yet. */
+  valueless: string[];
+  /** Values declared under more than one name — alias, or one idea twice. */
+  duplicates: Record<string, string[]>;
+  derivation: {
+    /** Tokens computed from others, mapped to what they're computed from. */
+    derived: Record<string, string[]>;
+    /** Formulas pointing at tokens that don't exist — the browser drops these. */
+    unknown_refs: Record<string, string[]>;
+    /** Derivation loops, which resolve to nothing for the same reason. */
+    cycles: string[][];
+  };
+}
+
+/** The master CSS sheet a design system generates.
+ *
+ *  Purpose tokens only. Components (buttons, tables, input schemes) are
+ *  snippets that reference these names, so a value is stated once and reused
+ *  rather than restated per element. */
+export const fetchStylesheet = (id: number) =>
+  apiGet<StylesheetResult>(`/api/design-systems/${id}/stylesheet`);
+
+export interface SnippetFinding {
+  snippet_id: number;
+  title: string;
+  /** References that resolve against the sheet. */
+  used: string[];
+  /** `var(--x)` where the system has no `--x` — renders as nothing at all. */
+  unknown: string[];
+  /** Literals the sheet says to stop writing, paired with what to write. */
+  superseded_literals: { literal: string; use_instead: string }[];
+  /** Custom properties the snippet mints for itself instead of reusing. */
+  local_definitions: string[];
+}
+
+export interface SnippetCheck {
+  design_system_id: number;
+  checked: number;
+  /** Only snippets with something to act on; clean ones are omitted. */
+  findings: SnippetFinding[];
+}
+
+/** Which recorded snippets disagree with this design system's sheet. */
+export const checkSnippets = (id: number) =>
+  apiGet<SnippetCheck>(`/api/design-systems/${id}/snippet-check`);
@@ -0,0 +1,183 @@
+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}`);
+}
@@ -0,0 +1,212 @@
+import { apiGet, apiPost, apiPatch, apiDelete } from "@/api/client";
+
+/** One canonical location of a reusable thing. A snippet that unifies several
+ *  one-offs carries several — one per call site. */
+export interface SnippetLocation {
+  repo: string;
+  path: string;
+  symbol: string;
+}
+
+/** Structured fields parsed out of a snippet note (mirrors the backend
+ *  `parse_snippet_fields` — see services/snippets.py). `repo`/`path`/`symbol`
+ *  mirror the first location for back-compat; `locations` is the full list. */
+export interface SnippetFields {
+  name: string;
+  when_to_use: string;
+  signature: string;
+  language: string;
+  repo: string;
+  path: string;
+  symbol: string;
+  locations: SnippetLocation[];
+  /** The snippets folded into this one by merge, oldest first. Read-only: merge
+   *  is the only thing that adds to it, and an edit carries it forward.
+   *
+   *  Each entry records what THAT source contributed — never what the survivor
+   *  already had — which is what lets un-merge subtract exactly. An entry with
+   *  no `locations`/`tags` predates that attribution and cannot be un-merged. */
+  merged_from: { id: number; locations?: SnippetLocation[]; tags?: string[] }[];
+  code: string;
+}
+
+/** A full snippet record: the note dict plus the parsed `snippet` sub-object,
+ *  as returned by the backend `snippet_to_dict`. */
+export interface Snippet {
+  id: number;
+  title: string;
+  body: string;
+  tags: string[];
+  note_type: string;
+  project_id: number | null;
+  permission?: string;
+  created_at: string;
+  updated_at: string;
+  snippet: SnippetFields;
+  systems?: { id: number; name: string }[];
+  /** Set when another user owns this record; `owner` is their username and
+   *  `permission` your access level on it. */
+  shared?: boolean;
+  owner?: string | null;
+}
+
+/** How often a record was put in front of an agent versus actually opened.
+ *  A high `surfaced_count` with `pull_count: 0` is dead weight — it occupies a
+ *  slot in every future auto-inject menu while never being used. */
+export interface SnippetUsage {
+  surfaced_count: number;
+  pull_count: number;
+  last_surfaced_at: string | null;
+  last_pulled_at: string | null;
+}
+
+/** Result of the last drift check — does the recorded location and code still
+ *  match source? The check runs agent-side (Scribe has no checkout); this is the
+ *  remembered verdict. `current` is false once the snippet has been edited since
+ *  the check, at which point the verdict describes code that's no longer there. */
+export interface SnippetVerification {
+  status: "ok" | "missing" | "moved" | "changed" | "unverified";
+  current: boolean;
+  checked_at: string | null;
+  detail?: string | null;
+  path?: string | null;
+  needs_attention?: boolean;
+}
+
+/** Lightweight list item from the knowledge preview feed. Note: the `snippet`
+ *  field here is a truncated *body preview* (the knowledge feed's naming), not
+ *  the parsed fields above. */
+export interface SnippetListItem {
+  id: number;
+  title: string;
+  tags: string[];
+  note_type: string;
+  snippet: string;
+  created_at: string;
+  updated_at: string;
+  /** Present only when the record belongs to someone else — a suggestion from
+   *  them, not one of your own. Absent means it's yours. */
+  shared?: boolean;
+  owner?: string | null;
+  /** The recorded language, when one was given. Projected from the `data`
+   *  mirror so lists can show it without parsing the body — and so a prior-art
+   *  hit can be flagged as being in a DIFFERENT language than the file being
+   *  written, which is a shape to adapt rather than code to paste. */
+  language?: string;
+  /** Always present from the backend, zero-filled for records with no events. */
+  usage?: SnippetUsage;
+  /** Present on the detail record; the list feed carries it when a check has
+   *  been recorded. */
+  verification?: SnippetVerification;
+}
+
+/** Create/update payload — discrete fields the backend serializes into the
+ *  note (title/body/tags). Empty strings are applied; omitted keys are left
+ *  unchanged on update. */
+export interface SnippetInput {
+  name: string;
+  code: string;
+  language?: string;
+  signature?: string;
+  when_to_use?: string;
+  locations?: SnippetLocation[];
+  tags?: string[];
+  project_id?: number | null;
+  system_ids?: number[];
+  /** Create only: record it even though a near-duplicate already exists. */
+  force?: boolean;
+}
+
+/** `repo`/`path`/`symbol` are the reverse lookup — "what already lives here?"
+ *  They must all match the same recorded location; `path` also matches anything
+ *  beneath it. Combinable with `q`. */
+export async function listSnippets(
+  params: {
+    q?: string;
+    tag?: string;
+    projectId?: number | null;
+    repo?: string;
+    path?: string;
+    symbol?: string;
+    /** Drift check: "attention" | "ok" | "unverified" | "drifted" | a status. */
+    verification?: string;
+  } = {},
+): Promise<{ snippets: SnippetListItem[]; total: number }> {
+  const qs = new URLSearchParams();
+  if (params.q) qs.set("q", params.q);
+  if (params.tag) qs.set("tag", params.tag);
+  if (params.projectId) qs.set("project_id", String(params.projectId));
+  if (params.repo) qs.set("repo", params.repo);
+  if (params.path) qs.set("path", params.path);
+  if (params.symbol) qs.set("symbol", params.symbol);
+  if (params.verification) qs.set("verification", params.verification);
+  const query = qs.toString();
+  return apiGet(`/api/snippets${query ? `?${query}` : ""}`);
+}
+
+export async function getSnippet(id: number): Promise<Snippet> {
+  return apiGet(`/api/snippets/${id}`);
+}
+
+export async function createSnippet(data: SnippetInput): Promise<Snippet> {
+  return apiPost("/api/snippets", data);
+}
+
+export async function updateSnippet(
+  id: number,
+  data: Partial<SnippetInput>,
+): Promise<Snippet> {
+  return apiPatch(`/api/snippets/${id}`, data);
+}
+
+export async function deleteSnippet(id: number): Promise<void> {
+  return apiDelete(`/api/snippets/${id}`);
+}
+
+/** A set of snippets that resemble each other closely enough to be worth
+ *  merging. Grouping is transitive, so a set can hold members that don't
+ *  directly resemble each other — read it as a proposal, not a verdict. */
+export interface DuplicateGroup {
+  note_ids: number[];
+  snippets: { id: number; title: string }[];
+  /** The strongest resemblance within the set — how confident the suggestion is. */
+  top_score: number;
+}
+
+/** Near-duplicates already in the record. The create gate prevents new ones and
+ *  merge cures the ones you point it at; this is what finds them. */
+export async function findDuplicateSnippets(
+  threshold?: number,
+): Promise<{ groups: DuplicateGroup[]; threshold: number }> {
+  const qs = threshold ? `?threshold=${threshold}` : "";
+  return apiGet(`/api/snippets/duplicates${qs}`);
+}
+
+/** Record a drift-check verdict. The check itself runs where the code is — an
+ *  agent with the working tree — since Scribe has no checkout. This stores what
+ *  was found, and is how the UI clears a stale marker after a manual fix. */
+export async function verifySnippet(
+  id: number,
+  verdict: { status: string; detail?: string; path?: string },
+): Promise<Snippet> {
+  return apiPost(`/api/snippets/${id}/verify`, verdict);
+}
+
+/** Pull one source back out of a merged survivor: restores it and strips exactly
+ *  what it contributed. Also repairs a half-undone merge — a source restored
+ *  from the trash by hand leaves the survivor still claiming its call sites. */
+export async function unmergeSnippet(
+  survivorId: number,
+  sourceId: number,
+): Promise<{ survivor: Snippet; restored: Snippet | null }> {
+  return apiPost(`/api/snippets/${survivorId}/unmerge`, { source_id: sourceId });
+}
+
+/** Unify `sourceIds` into the canonical snippet `targetId`. Returns the merged
+ *  survivor plus `merged_ids` — the sources actually folded in and trashed. */
+export async function mergeSnippets(
+  targetId: number,
+  sourceIds: number[],
+): Promise<Snippet & { merged_ids: number[] }> {
+  return apiPost(`/api/snippets/${targetId}/merge`, { source_ids: sourceIds });
+}
--- a/Show More
+++ b/Show More