feat!: scope attune-gui to Living Docs (drop ai.* commands)

BREAKING: removes the 14 ai.* commands and the [ai] optional extra.
attune-gui no longer imports or depends on attune-ai. Use attune-ai's
own CLI / plugin / MCP entry points for AI dev workflows.

Why: attune-gui and attune-ai had grown into two distinct products
sharing one install graph. attune-ai pinning attune-help<0.8 was
blocking the docs-side packages from co-installing cleanly. Splitting
makes the value prop legible and dissolves the pin conflict. Future
attune-ai dashboard will live in a separate package that may reuse
this sidecar/UI chassis.

Changes:
- Delete sidecar/attune_gui/routes/ai.py
- Delete the 14 ai.* command specs and executors from commands.py
  (24 commands → 10)
- Drop ai router include + import from app.py
- Drop [ai] optional extra from pyproject.toml; remove deferred-pin
  comment about attune-ai
- Rewrite README "What it does" to lead with Living Docs; add a
  redirect note pointing AI-workflow seekers to attune-ai
- Bump 0.1.1 → 0.2.0 (minor breaking change — capability removal)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: silversurfer562

README.md

@@ -1,22 +1,28 @@
 # attune-gui
 
-Unified local GUI that drives the `attune-*` Python libraries (`attune-ai`,
-`attune-rag`, `attune-author`, `attune-help`) through a FastAPI sidecar and a
-React + Vite UI. Designed so you don't have to remember CLI flags, MCP tool
-names, or sub-command paths to run common developer-workflow tasks.
+Local **Living Docs** dashboard for the `attune-*` documentation family
+(`attune-rag`, `attune-help`, `attune-author`). FastAPI sidecar +
+React + Vite UI. Designed so you don't have to remember CLI flags or
+sub-command paths to author, query, and maintain your project's docs.
 
 ## What it does
 
-- **Commands mode** — run any of the 24 registered commands (RAG queries,
-  doc generation, security audits, code reviews, memory recall/capture,
-  release prep, …) from a 3-column form-driven UI. Async jobs with live
+- **Commands mode** — run the 10 registered commands (RAG queries,
+  template generation, staleness checks, doc maintenance, help lookup
+  / search, …) from a 3-column form-driven UI. Async jobs with live
   status, structured results, and re-run with one click.
-- **Living Docs mode** — proactively tracks documentation quality across
-  three consumer personas (End User, Developer, Support). Scans your
-  workspace, surfaces stale or low-quality docs, and gates releases on
-  RAG faithfulness / accuracy thresholds.
-- **Profiles** — Developer, Author, or Support. Each filters the command
-  list to what's relevant for that role.
+- **Living Docs mode** — proactively tracks documentation quality
+  across three consumer personas (End User, Developer, Support).
+  Scans your workspace, surfaces stale or low-quality docs, and gates
+  releases on RAG faithfulness / accuracy thresholds.
+- **Profiles** — Developer, Author, or Support. Each filters the
+  command list to what's relevant for that role.
+
+> Looking for AI dev workflows (code review, security audits, refactor
+> planning, multi-agent orchestration)? Those live in
+> [`attune-ai`](https://pypi.org/project/attune-ai/) — a separate
+> product with its own CLI/plugin/MCP entry points. attune-gui is
+> deliberately scoped to the documentation lifecycle.
 
 ## Quickstart
 
@@ -54,15 +60,15 @@ cd ui && npm install && cd ..
 │  ├─ commands.py registry │
 │  ├─ jobs.py              │
 │  └─ routes/              │
-│     rag, ai, author,     │
-│     help, profile,       │
+│     rag, help, author,   │
+│     profile, jobs,       │
 │     living_docs          │
 └──────────┬───────────────┘
            │
 ┌──────────▼───────────────┐
-│  attune-rag, attune-ai,  │
-│  attune-author,          │
-│  attune-help             │
+│  attune-rag,             │
+│  attune-help,            │
+│  attune-author           │
 └──────────────────────────┘
 ```
 
@@ -81,7 +87,7 @@ deployment, not hardened against a motivated attacker on the same machine.
 - [`attune-rag`](https://pypi.org/project/attune-rag/) — RAG pipeline
 - [`attune-help`](https://pypi.org/project/attune-help/) — help runtime
 - [`attune-author`](https://pypi.org/project/attune-author/) — doc authoring
-- `attune-ai` — workflow engine (install via `attune-gui[ai]`)
+- [`attune-ai`](https://pypi.org/project/attune-ai/) — separate AI dev workflow product (not used by attune-gui)
 
 ## License
 

pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "attune-gui"
-version = "0.1.1"
-description = "Unified local GUI that drives attune-ai, attune-rag, and attune-author Python libraries via a FastAPI sidecar."
+version = "0.2.0"
+description = "Local Living Docs dashboard for the attune-rag / attune-help / attune-author family. FastAPI sidecar + React UI."
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "Apache-2.0"}
@@ -32,15 +32,9 @@ dependencies = [
     "attune-rag>=0.1.8,<0.2",
     "attune-author>=0.5.0,<0.6",
     "attune-help>=0.9.0,<1.0",
-    # attune-ai is intentionally deferred to M3 — M1 and M2 don't
-    # import it. Add it to the install pin set once M3 lands so
-    # the per-release cap is reviewed at that time rather than now.
 ]
 
 [project.optional-dependencies]
-ai = [
-    "attune-ai>=6.4.0,<7.0",
-]
 dev = [
     "pytest>=8.0,<10.0",
     "pytest-asyncio>=0.23,<2.0",

sidecar/attune_gui/app.py

@@ -11,7 +11,7 @@
 from fastapi.staticfiles import StaticFiles
 
 from attune_gui import __version__
-from attune_gui.routes import ai, help, jobs, living_docs, profile, rag, system  # noqa: F401
+from attune_gui.routes import help, jobs, living_docs, profile, rag, system  # noqa: F401
 from attune_gui.security import origin_guard
 
 logger = logging.getLogger(__name__)
@@ -25,7 +25,7 @@ def create_app() -> FastAPI:
     app = FastAPI(
         title="attune-gui sidecar",
         version=__version__,
-        description="Local FastAPI bridge to attune-rag / attune-author / attune-ai.",
+        description="Local FastAPI bridge to attune-rag / attune-author / attune-help (Living Docs).",
         dependencies=[Depends(origin_guard)],
     )
 
@@ -40,7 +40,6 @@ def create_app() -> FastAPI:
     app.include_router(system.router)
     app.include_router(rag.router)
     app.include_router(jobs.router)
-    app.include_router(ai.router)
     app.include_router(help.router)
     app.include_router(profile.router)
     app.include_router(living_docs.router)