falaw 0.0.2__tar.gz

falaw-0.0.2/.claude/skills/falaw/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: falaw
+description: >-
+  Generate and manage AI media (images, video, audio) via fal.ai. Use this
+  skill whenever the user wants to generate, edit, upscale, or compose media,
+  or asks about fal.ai or fal-client. The skill exposes Python tools that
+  wrap fal-client with smart model selection, result handling, and a journal
+  for self-improvement across sessions.
+---
+
+# falaw
+
+Use the `falaw` Python package as your primary interface to fal.ai.
+
+## Read the journal first
+
+Before doing anything novel, glance at recent journal entries --- past
+sessions may have left notes, gotchas, or suggestions that save you time:
+
+```python
+from falaw import journal
+for e in journal.recent(20):
+    print(e.kind, '-', e.text[:120])
+```
+
+## Leave a journal entry when something surprises you
+
+Whenever a model behaved oddly, an error was confusing, or you had to work
+around something, leave a note. This is how the next session learns:
+
+```python
+from falaw import journal
+journal.issue("FLUX dev returned NSFW=True for a benign prompt",
+              suggestion="Document an example that triggers it",
+              tags=("flux", "safety"))
+journal.improvement("Add an `upscale_image` tool that wraps clarity-upscaler",
+                    tags=("backlog",))
+journal.note("schnell quality=fast returns 1024x1024 by default")
+```
+
+## Pick a model without memorizing IDs
+
+```python
+from falaw import list_models, pick_model
+[m.id for m in list_models(category='video')]
+pick_model(category='image', quality_tier='ultra').id
+```
+
+## Tools
+
+The functions below are also registered tools; bridges (MCP server, HTTP
+service, UI) derive their surfaces from the same registry.
+
+
+### `falaw.generate_image`
+
+Generate an image from a text prompt. Picks a sensible FLUX model based on the requested quality tier ('fast', 'balanced', 'high', 'ultra'). Returns a falaw.Result whose .first asset has a URL you can .download(to=...).
+
+Examples:
+  - `falaw.generate_image(**{'prompt': 'A red panda eating bamboo', 'quality': 'fast'})`
+  - `falaw.generate_image(**{'prompt': 'Cinematic portrait, 35mm film', 'quality': 'ultra'})`
+
+
+### `falaw.text_to_speech`
+
+Synthesize speech from text. Picks a TTS model by quality tier; pass `voice` and `extra` for model-specific knobs. Returns a falaw.Result whose .first asset is the audio URL.
+
+Examples:
+  - `falaw.text_to_speech(**{'text': 'Hello world', 'quality': 'balanced'})`
+  - `falaw.text_to_speech(**{'text': 'Bonjour le monde', 'quality': 'high', 'voice': 'fr-FR-female-1'})`
+
+
+### `falaw.refresh_llms`
+
+Refresh `llms.txt` and `llms-full.txt` from fal.ai using conditional GETs (ETag-based). Cheap: returns immediately if nothing changed. On change, snapshots the previous version and journals the diff. Returns a summary dict like {'llms': {'changed': False}, ...}.
+
+
+### `falaw.refresh_full_docs`
+
+Re-crawl every per-page .md endpoint listed in `fal_ai_docs_index.md` with conditional GETs, then reassemble `fal_ai_docs_full.md`. Heavy. Gated on `is_stale(llms-full)` by default --- pass `force=True` to skip the gate. Pages that 304 are skipped; only changed pages re-download. Logs a single journal entry summarizing the run.
+
+
+## Models known to falaw
+
+The model registry lives at `falaw/data/models.json`. Refresh it from
+`misc/docs/fal_ai_docs_full.md` when fal ships new models. Quick view:
+
+```
+  avatar               balanced   fal-ai/ai-avatar
+  background_removal   high       fal-ai/birefnet/v2
+  image                balanced   fal-ai/flux/dev
+  image                fast       fal-ai/flux/schnell
+  image                high       fal-ai/flux-pro/v1.1
+  image                ultra      fal-ai/flux-pro/v1.1-ultra
+  image_edit           ultra      fal-ai/flux-pro/kontext/max
+  lipsync              high       fal-ai/sync-lipsync/v2
+  llm                  balanced   fal-ai/any-llm
+  music                balanced   fal-ai/diffrhythm
+  music                high       fal-ai/lyria2
+  tts                  balanced   fal-ai/playai/tts/v3
+  tts                  high       fal-ai/minimax/speech-02-hd
+  tts                  high       fal-ai/elevenlabs/tts/multilingual-v2
+  upscale              high       fal-ai/clarity-upscaler
+  video                balanced   fal-ai/minimax/hailuo-02/pro/image-to-video
+  video                high       fal-ai/kling-video/v2.1/master/image-to-video
+  video                ultra      fal-ai/veo3
+  voice_clone          high       fal-ai/minimax/voice-clone
+```
+
+## When you can't find what you need
+
+* Check `falaw/misc/docs/llms-full.txt` for a structured fal.ai overview.
+* Check `falaw/misc/docs/fal_ai_docs_full.md` for the full corpus (~3MB).
+* Drop into `falaw.call_fal(application, arguments)` for any model not
+  yet wrapped --- this is the escape hatch. Then leave a `journal.improvement`
+  asking for a proper tool wrapper.

falaw-0.0.2/.gitattributes

@@ -0,0 +1 @@
+*.ipynb linguist-documentation

falaw-0.0.2/.github/workflows/ci.yml

@@ -0,0 +1,207 @@
+name: Continuous Integration (uv)
+on: [push, pull_request]
+
+# Note: Environment variables (PROJECT_NAME and vars from [tool.wads.ci.env])
+# are set by the read-ci-config action in the setup job and made available
+# to all subsequent jobs via GITHUB_ENV
+
+jobs:
+  # First job: Read configuration from pyproject.toml
+  setup:
+    name: Read Configuration
+    runs-on: ubuntu-latest
+    outputs:
+      project-name: ${{ steps.config.outputs.project-name }}
+      python-versions: ${{ steps.config.outputs.python-versions }}
+      pytest-args: ${{ steps.config.outputs.pytest-args }}
+      coverage-enabled: ${{ steps.config.outputs.coverage-enabled }}
+      exclude-paths: ${{ steps.config.outputs.exclude-paths }}
+      test-on-windows: ${{ steps.config.outputs.test-on-windows }}
+      build-sdist: ${{ steps.config.outputs.build-sdist }}
+      build-wheel: ${{ steps.config.outputs.build-wheel }}
+      metrics-enabled: ${{ steps.config.outputs.metrics-enabled }}
+      metrics-config-path: ${{ steps.config.outputs.metrics-config-path }}
+      metrics-storage-branch: ${{ steps.config.outputs.metrics-storage-branch }}
+      metrics-python-version: ${{ steps.config.outputs.metrics-python-version }}
+      metrics-force-run: ${{ steps.config.outputs.metrics-force-run }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Read CI Config
+        id: config
+        uses: i2mint/wads/actions/read-ci-config@master
+        with:
+          pyproject-path: .
+
+  # Second job: Validation using the config
+  validation:
+    name: Validation
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    needs: setup
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ${{ fromJson(needs.setup.outputs.python-versions) }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install System Dependencies
+        uses: i2mint/wads/actions/install-system-deps@master
+        with:
+          pyproject-path: .
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps-uv@master
+
+      - name: Format Source Code
+        run: uvx ruff format .
+
+      - name: Lint Validation
+        run: uvx ruff check --output-format=github ${{ needs.setup.outputs.project-name }}
+
+      - name: Run Tests
+        uses: i2mint/wads/actions/run-tests-uv@master
+        with:
+          root-dir: ${{ needs.setup.outputs.project-name }}
+          pytest-args: ${{ needs.setup.outputs.pytest-args }}
+          exclude-paths: ${{ needs.setup.outputs.exclude-paths }}
+          coverage: ${{ needs.setup.outputs.coverage-enabled }}
+
+      - name: Track Code Metrics
+        if: needs.setup.outputs.metrics-enabled == 'true'
+        uses: i2mint/umpyre/actions/track-metrics@master
+        continue-on-error: true
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          config-path: ${{ needs.setup.outputs.metrics-config-path }}
+          storage-branch: ${{ needs.setup.outputs.metrics-storage-branch }}
+          python-version: ${{ needs.setup.outputs.metrics-python-version }}
+          force-run: ${{ needs.setup.outputs.metrics-force-run }}
+
+  # Optional Windows testing (if enabled in config)
+  windows-validation:
+    name: Windows Tests
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && needs.setup.outputs.test-on-windows == 'true'"
+    needs: setup
+    runs-on: windows-latest
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ fromJson(needs.setup.outputs.python-versions)[0] }}
+
+      - name: Install System Dependencies
+        uses: i2mint/wads/actions/install-system-deps@master
+        with:
+          pyproject-path: .
+
+      - name: Install Dependencies
+        uses: i2mint/wads/actions/install-deps-uv@master
+
+      - name: Run Tests
+        uses: i2mint/wads/actions/run-tests-uv@master
+        with:
+          root-dir: ${{ needs.setup.outputs.project-name }}
+
+  # Publishing job
+  publish:
+    name: Publish
+    permissions:
+      contents: write
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main')"
+    needs: [setup, validation]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: i2mint/wads/actions/setup-python-uv@master
+        with:
+          python-version: ${{ fromJson(needs.setup.outputs.python-versions)[0] }}
+          create-venv: "false"
+
+      - name: Format Source Code
+        run: uvx ruff format .
+
+      - name: Update Version Number
+        id: version
+        uses: i2mint/isee/actions/bump-version-number@master
+
+      - name: Build Distribution
+        uses: i2mint/wads/actions/build-dist-uv@master
+        with:
+          sdist: ${{ needs.setup.outputs.build-sdist }}
+          wheel: ${{ needs.setup.outputs.build-wheel }}
+
+      - name: Publish to PyPI
+        uses: i2mint/wads/actions/pypi-publish-uv@master
+        with:
+          pypi-token: ${{ secrets.PYPI_PASSWORD }}
+
+      - name: Force SSH for git remote
+        run: git remote set-url origin git@github.com:${{ github.repository }}.git
+
+      - name: Commit Changes
+        uses: i2mint/wads/actions/git-commit@master
+        with:
+          commit-message: "**CI** Formatted code + Updated version to ${{ env.VERSION }} [skip ci]"
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+          push: true
+
+      - name: Tag Repository
+        uses: i2mint/wads/actions/git-tag@master
+        with:
+          tag: ${{ env.VERSION }}
+          message: "Release version ${{ env.VERSION }}"
+          push: true
+
+  # Optional GitHub Pages
+  github-pages:
+    name: Publish GitHub Pages
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+    if: "!contains(github.event.head_commit.message, '[skip ci]') && github.ref == format('refs/heads/{0}', github.event.repository.default_branch)"
+    needs: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: i2mint/epythet/actions/publish-github-pages@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          ignore: "tests/,scrap/,examples/"

falaw-0.0.2/.gitignore

@@ -0,0 +1,117 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+
+.DS_Store
+# C extensions
+*.so
+
+# TLS certificates
+## Ignore all PEM files anywhere
+*.pem
+## Also ignore any certs directory
+certs/
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+_build
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/*
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# PyCharm
+.idea

falaw-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thor Whalen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

falaw-0.0.2/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: falaw
+Version: 0.0.2
+Summary: Agent-friendly Python facade over fal.ai for generating and managing AI media (images, video, audio).
+Project-URL: Homepage, https://github.com/thorwhalen/falaw
+Project-URL: Repository, https://github.com/thorwhalen/falaw
+Project-URL: Documentation, https://thorwhalen.github.io/falaw
+Author: Thor Whalen
+License: mit
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: fal-client>=0.5
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == 'docs'
+Requires-Dist: sphinx>=6.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# falaw
+
+Agent-friendly Python facade over fal.ai for generating and managing AI media (images, video, audio).
+
+```python
+from falaw import generate_image, list_models, journal
+
+r = generate_image("a tiger eye, macro, 35mm", quality="fast")
+r.first.download(to="./tiger.png")
+
+[m.id for m in list_models(category="video")]
+journal.note("schnell at quality='fast' defaults to 1024x1024")
+```
+
+## Why
+
+`fal-client` already gives you 100+ models behind a uniform call. What
+agents (and humans) still struggle with is *which* model to use, *what*
+parameters it takes, and *what to do with* the URL it returns. `falaw`
+adds:
+
+- Task-level verbs (`generate_image`, `text_to_speech`, ...) with smart model selection by quality tier.
+- A queryable model registry --- no more grepping docs for IDs.
+- `Result` / `Asset` objects that download, name, and organize outputs.
+- A journal so each session leaves notes for the next one.
+- A Claude skill, plus stub bridges for MCP and HTTP services --- all derived from the same tool registry.
+
+## Install
+
+```bash
+pip install -e .
+export FAL_KEY="your-fal-api-key"
+```
+
+## Core surface
+
+| Function | Purpose |
+| --- | --- |
+| `generate_image(prompt, *, quality, image_size, model_id, extra)` | Text-to-image, picks FLUX by quality tier. |
+| `text_to_speech(text, *, quality, voice, model_id, extra)` | TTS, picks a voice model by tier. |
+| `list_models(*, category, quality_tier)` | Browse the catalog. |
+| `pick_model(*, category, quality_tier)` | Pick a sensible default. |
+| `call_fal(application, arguments)` | Escape hatch to any fal model. Auto-journals on error. |
+| `journal.note / issue / improvement(...)` | Leave a trace for future sessions. |
+| `Session(output_dir=...)` | Optional stateful controller. |
+
+## Architecture
+
+Single source of truth: a `ToolSpec` dataclass per tool. From it we derive every external surface:
+
+```
+falaw.registry  ──► bridges/skill.py    ──►  .claude/skills/falaw/SKILL.md
+                ──► bridges/mcp.py      ──►  MCP server          (planned)
+                ──► bridges/service.py  ──►  qh HTTP service     (planned)
+                ──► (UI)                                          (planned)
+```
+
+Adding a new surface is a new bridge module, never a re-implementation of the operations.
+
+## Self-improvement loop
+
+Every session can read and write the agent journal at `~/.config/falaw/journal/`. The Claude skill instructs Claude to:
+
+1. Read recent entries before novel work.
+2. Write a note / issue / improvement when something surprises it.
+
+`call_fal` auto-journals failures with the application id and arguments, so the next session recognizes the trap.
+
+## Layout
+
+```
+falaw/
+  base.py            ToolSpec, ModelRecord
+  core.py            call_fal: subscribe + auto-journal
+  registry.py        register_tool, list/get/pick model
+  results.py         Asset, Result, parse_response
+  session.py         Session
+  journal.py         file-backed journal
+  operations/
+    images.py        generate_image
+    audio.py         text_to_speech
+  bridges/
+    skill.py         render Claude SKILL.md from registry
+    mcp.py           (stub)
+    service.py       (stub)
+  data/
+    models.json      seed catalog
+    skills/falaw/    generated skill files (shipped with package)
+misc/
+  docs/              aggregated fal.ai docs (3MB md, llms.txt, llms-full.txt)
+  regenerate_skill.py
+tests/
+```
+
+## Regenerate the skill after adding a tool
+
+```bash
+python misc/regenerate_skill.py
+```
+
+Writes `falaw/data/skills/falaw/SKILL.md` and `.claude/skills/falaw/SKILL.md`.
+
+## Status
+
+v0 --- functional core, real Claude skill, stubs for MCP and HTTP service. The bridges share the same registry, so filling in the stubs is additive.

falaw-0.0.2/README.md

@@ -0,0 +1,105 @@
+# falaw
+
+Agent-friendly Python facade over fal.ai for generating and managing AI media (images, video, audio).
+
+```python
+from falaw import generate_image, list_models, journal
+
+r = generate_image("a tiger eye, macro, 35mm", quality="fast")
+r.first.download(to="./tiger.png")
+
+[m.id for m in list_models(category="video")]
+journal.note("schnell at quality='fast' defaults to 1024x1024")
+```
+
+## Why
+
+`fal-client` already gives you 100+ models behind a uniform call. What
+agents (and humans) still struggle with is *which* model to use, *what*
+parameters it takes, and *what to do with* the URL it returns. `falaw`
+adds:
+
+- Task-level verbs (`generate_image`, `text_to_speech`, ...) with smart model selection by quality tier.
+- A queryable model registry --- no more grepping docs for IDs.
+- `Result` / `Asset` objects that download, name, and organize outputs.
+- A journal so each session leaves notes for the next one.
+- A Claude skill, plus stub bridges for MCP and HTTP services --- all derived from the same tool registry.
+
+## Install
+
+```bash
+pip install -e .
+export FAL_KEY="your-fal-api-key"
+```
+
+## Core surface
+
+| Function | Purpose |
+| --- | --- |
+| `generate_image(prompt, *, quality, image_size, model_id, extra)` | Text-to-image, picks FLUX by quality tier. |
+| `text_to_speech(text, *, quality, voice, model_id, extra)` | TTS, picks a voice model by tier. |
+| `list_models(*, category, quality_tier)` | Browse the catalog. |
+| `pick_model(*, category, quality_tier)` | Pick a sensible default. |
+| `call_fal(application, arguments)` | Escape hatch to any fal model. Auto-journals on error. |
+| `journal.note / issue / improvement(...)` | Leave a trace for future sessions. |
+| `Session(output_dir=...)` | Optional stateful controller. |
+
+## Architecture
+
+Single source of truth: a `ToolSpec` dataclass per tool. From it we derive every external surface:
+
+```
+falaw.registry  ──► bridges/skill.py    ──►  .claude/skills/falaw/SKILL.md
+                ──► bridges/mcp.py      ──►  MCP server          (planned)
+                ──► bridges/service.py  ──►  qh HTTP service     (planned)
+                ──► (UI)                                          (planned)
+```
+
+Adding a new surface is a new bridge module, never a re-implementation of the operations.
+
+## Self-improvement loop
+
+Every session can read and write the agent journal at `~/.config/falaw/journal/`. The Claude skill instructs Claude to:
+
+1. Read recent entries before novel work.
+2. Write a note / issue / improvement when something surprises it.
+
+`call_fal` auto-journals failures with the application id and arguments, so the next session recognizes the trap.
+
+## Layout
+
+```
+falaw/
+  base.py            ToolSpec, ModelRecord
+  core.py            call_fal: subscribe + auto-journal
+  registry.py        register_tool, list/get/pick model
+  results.py         Asset, Result, parse_response
+  session.py         Session
+  journal.py         file-backed journal
+  operations/
+    images.py        generate_image
+    audio.py         text_to_speech
+  bridges/
+    skill.py         render Claude SKILL.md from registry
+    mcp.py           (stub)
+    service.py       (stub)
+  data/
+    models.json      seed catalog
+    skills/falaw/    generated skill files (shipped with package)
+misc/
+  docs/              aggregated fal.ai docs (3MB md, llms.txt, llms-full.txt)
+  regenerate_skill.py
+tests/
+```
+
+## Regenerate the skill after adding a tool
+
+```bash
+python misc/regenerate_skill.py
+```
+
+Writes `falaw/data/skills/falaw/SKILL.md` and `.claude/skills/falaw/SKILL.md`.
+
+## Status
+
+v0 --- functional core, real Claude skill, stubs for MCP and HTTP service. The bridges share the same registry, so filling in the stubs is additive.