sourcecode 1.30.30__tar.gz → 1.31.0__tar.gz

sourcecode-1.31.0/.continue-here.md

@@ -0,0 +1,101 @@
+# Continue Here — atlas-cli sesión 16
+
+**Paused:** 2026-05-20
+**Repo:** `/Users/user/Downloads/atlas-cli`
+**Branch:** master
+**Working tree:** CHANGELOG.md sin commitear (untracked)
+
+---
+
+## Trabajo de esta sesión (ya commiteado)
+
+**Commit:** `0e430c1 fix(cli+serializer): BUG-1..5 + IMP-1 — UTF-8 stdout, --exclude parsing, onboard fast scan, angular_version null, lazy_routes_count zero, test_gaps config filter`
+
+| ID | Fix | Archivo | Líneas clave |
+|---|---|---|---|
+| BUG-1 | `repo_ir_cmd` usa `stdout.buffer.write(encode("utf-8"))` en vez de `stdout.write()`. `main_entry` llama `stdout.reconfigure(encoding="utf-8")`. UnicodeEncodeError capturado con hint a `--output`. | `cli.py` | ~2367, ~2443 |
+| BUG-2 | `--exclude` añadido a `_OPTIONS_WITH_VALUE` → valor no consumido como repo path. Warning si valor es directorio existente. | `cli.py` | ~173, ~856 |
+| BUG-3 | `onboard --fast` siempre usa `AdaptiveScanner(base_depth=2)`; ya no usa git-index-only (que devolvía solo `.idea/vcs.xml`). | `prepare_context.py` | ~791 |
+| BUG-4 | `deps = {**(pkg.get("dependencies") or {}), ...}` para manejar `null` explícito en package.json. Añade `peerDependencies` como fallback. | `serializer.py` | ~1663 |
+| BUG-5 | Cuenta `loadChildren:` y `loadComponent:` (property syntax modern Angular) en vez del inexistente `loadChildren(`. | `serializer.py` | ~1644 |
+| IMP-1 | `test_gaps` excluye `.eslintrc*`, `karma.conf.js`, `tsconfig*`, `.claude/**`, etc. por defecto. Nuevo flag `--include-config` para override. | `prepare_context.py`, `cli.py` | ~1663, ~1806 |
+| IMP-2 | Stderr warning con workaround exacto cuando se detecta UnicodeEncodeError (BUG-1) o exclude value = directorio (BUG-2). | `cli.py` | ~2373, ~858 |
+
+**Tests:** `tests/test_bug_fixes_v2.py` — 14 tests, todos pasan.
+**Suite completa:** 1010 passed, 0 nuevos failures (3 pre-existentes sin tocar).
+
+---
+
+## Primera acción al retomar
+
+CHANGELOG.md quedó fuera del commit (untracked). Commitear:
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git add CHANGELOG.md
+git commit -m "docs: add CHANGELOG.md with BUG-1..5 and IMP-1 entries for v1.30.29
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Pendientes (heredados de sesión 15, siguen vigentes)
+
+1. **Spring bean wiring graph** — `_build_relations` emite `injects` edges para `@Autowired`. Falta: trazar `@Configuration → @Bean → @Autowired` completo, exponer como `wiring_graph`.
+
+2. **Smoke test en repo spring-boot real:**
+   ```bash
+   cd ~/Documents/workspace/spring-boot-realworld-example-app
+   sourcecode repo-ir . --since HEAD~1 2>/dev/null | python3 -c "
+   import json, sys; d=json.load(sys.stdin)
+   print('nodes:', len(d['graph']['nodes']))
+   print('route_surface:', d.get('route_surface', []))
+   print('reverse_graph keys:', len(d.get('reverse_graph', {})))
+   "
+   ```
+
+3. **Transaction boundary tracking** — `@Transactional` detectado. Falta: emitir `transactional_boundary` edges.
+
+4. **`_diff_routes` para `@RequestMapping` en clase** — class-level mapping change debería propagarse a todos los endpoints del controller.
+
+5. **Tests para el symptom fix (sesión 15)** — validar `--symptom "sesiones"` con mock commits produce ranking diferente al baseline. Cubrir en `tests/test_prepare_context_symptom.py`.
+
+6. **`_FRONTEND_SYMPTOM_MAP`** — añadir "sesiones"/"session" con backend terms `["httpsession", "sessionmanager", "sessionservice", "sessionrepository"]`.
+
+---
+
+## Estado de tests al pausar
+
+```
+1010 passed, 3 skipped (pre-existing)
+```
+
+Pre-existing failures (no tocar):
+- `tests/test_block2_coverage.py::TestDocAnalyzerLanguageCoverage::test_java_marked_unsupported` — `DocRecord.__init__()` unexpected kwarg `name`
+- `tests/test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile_keeps_declared_versions` — typer version mismatch
+- `tests/test_scoring_calibration.py` — varios score calibration tests
+
+---
+
+## Para retomar
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git log --oneline -3   # 0e430c1 debe estar arriba
+git status             # solo CHANGELOG.md untracked
+
+# 1. Commitear CHANGELOG.md (comando arriba)
+
+# 2. Verificar suite
+python3 -m pytest tests/ \
+  --ignore=tests/test_block2_coverage.py \
+  --ignore=tests/test_scoring_calibration.py \
+  --deselect=tests/test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile_keeps_declared_versions \
+  -q
+# Expected: 1010 passed, 3 skipped
+```
+
+---
+
+*Pausado 2026-05-20 — gsd:pause-work*

sourcecode-1.30.30/.sourcecode-cache/snapshot-85d4217-37df4554.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-37df4554.json

@@ -24,8 +24,8 @@
   ],
   "dependency_summary": {
     "requested": true,
-    "total_count": 10,
-    "direct": 10,
+    "total_count": 12,
+    "direct": 12,
     "sources": [
       "manifest"
     ]

sourcecode-1.30.30/.sourcecode-cache/snapshot-85d4217-e9801942.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-e9801942.json

@@ -33,7 +33,7 @@ stacks:
   - package_manager:pip
   - entry:src/sourcecode/cli.py
   - entry:run_cli.py
-  - extensions:138
+  - extensions:144
   produced_by: python
   language_version: null
   packaging: null
@@ -48,8 +48,9 @@ contracts:
   - config_cmd() -> None
   - 'main(ctx: typer.Context, format: str, output: Optional[Pa...'
   - main_entry() -> None
-  - 'prepare_context_cmd(task: Optional[str], path: Path, sinc...'
+  - mcp_serve() -> None
   exports:
+  - prepare_context_cmd
   - repo_ir_cmd
   - telemetry_disable
   - telemetry_enable
@@ -59,6 +60,20 @@ contracts:
   deps:
   - sourcecode
   - typer
+- path: src/sourcecode/mcp/server.py
+  role: entrypoint
+  fn:
+  - 'agent(path: str, git_context: bool) -> dict'
+  - 'compact(path: str, git_context: bool) -> dict'
+  - config() -> dict
+  - "prepare_context(task: Literal['delta', 'review-pr', 'fix-..."
+  - 'repo_ir(path: str) -> dict'
+  exports:
+  - telemetry
+  - version
+  deps:
+  - mcp
+  - sourcecode
 - path: src/sourcecode/context_scorer.py
   role: util
   exports:
@@ -173,29 +188,15 @@ contracts:
     - TaskContextBuilder
     - TaskOutput
     - TaskSpec
-- path: src/sourcecode/ranking_engine.py
-  role: util
-  fn:
-  - 'compute_impact_score(runtime_impact: float, dependency_ce...'
-  - 'resolve_framework_signal(category: str | None) -> float'
-  - 'resolve_runtime_impact(category: str | None) -> float'
-  exports:
-  - k: class
-    names:
-    - FileScore
-    - RankingEngine
-    - TaskWeights
-  deps:
-  - sourcecode
 contracts_meta:
   total: 15
   shown: 15
   truncated: false
 summary:
   files: 15
-  total: 67
+  total: 70
   methods:
-    ast: 67
+    ast: 70
 confidence:
   overall: high
   stack: high

sourcecode-1.30.30/.sourcecode-cache/snapshot-c6e9d39-ee60e0cd.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-ee60e0cd.json

@@ -42,7 +42,7 @@
         "package_manager:pip",
         "entry:src/sourcecode/cli.py",
         "entry:run_cli.py",
-        "extensions:137"
+        "extensions:144"
       ],
       "produced_by": "python",
       "language_version": null,
@@ -61,9 +61,10 @@
         "config_cmd() -> None",
         "main(ctx: typer.Context, format: str, output: Optional[Pa...",
         "main_entry() -> None",
-        "prepare_context_cmd(task: Optional[str], path: Path, sinc..."
+        "mcp_serve() -> None"
       ],
       "exports": [
+        "prepare_context_cmd",
         "repo_ir_cmd",
         "telemetry_disable",
         "telemetry_enable",
@@ -76,6 +77,25 @@
         "typer"
       ]
     },
+    {
+      "path": "src/sourcecode/mcp/server.py",
+      "role": "entrypoint",
+      "fn": [
+        "agent(path: str, git_context: bool) -> dict",
+        "compact(path: str, git_context: bool) -> dict",
+        "config() -> dict",
+        "prepare_context(task: Literal['delta', 'review-pr', 'fix-...",
+        "repo_ir(path: str) -> dict"
+      ],
+      "exports": [
+        "telemetry",
+        "version"
+      ],
+      "deps": [
+        "mcp",
+        "sourcecode"
+      ]
+    },
     {
       "path": "src/sourcecode/context_scorer.py",
       "role": "util",
@@ -262,28 +282,6 @@
           ]
         }
       ]
-    },
-    {
-      "path": "src/sourcecode/ranking_engine.py",
-      "role": "util",
-      "fn": [
-        "compute_impact_score(runtime_impact: float, dependency_ce...",
-        "resolve_framework_signal(category: str | None) -> float",
-        "resolve_runtime_impact(category: str | None) -> float"
-      ],
-      "exports": [
-        {
-          "k": "class",
-          "names": [
-            "FileScore",
-            "RankingEngine",
-            "TaskWeights"
-          ]
-        }
-      ],
-      "deps": [
-        "sourcecode"
-      ]
     }
   ],
   "contracts_meta": {
@@ -293,9 +291,9 @@
   },
   "summary": {
     "files": 15,
-    "total": 67,
+    "total": 70,
     "methods": {
-      "ast": 67
+      "ast": 70
     }
   },
   "confidence": {

{sourcecode-1.30.30 → sourcecode-1.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.30.30
+Version: 1.31.0
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -212,16 +212,19 @@ Requires-Dist: tree-sitter-javascript>=0.21; extra == 'ast'
 Requires-Dist: tree-sitter-typescript>=0.21; extra == 'ast'
 Requires-Dist: tree-sitter>=0.21; extra == 'ast'
 Provides-Extra: dev
+Requires-Dist: mcp>=1.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: ruff>=0.15; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # sourcecode
 
 **Deterministic, behavior-aware codebase context for AI agents and PR review.**
 
-![Version](https://img.shields.io/badge/version-1.30.30-blue)
+![Version](https://img.shields.io/badge/version-1.31.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -257,7 +260,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.30.30
+# sourcecode 1.31.0
 ```
 
 ---

{sourcecode-1.30.30 → sourcecode-1.31.0}/README.md

@@ -2,7 +2,7 @@
 
 **Deterministic, behavior-aware codebase context for AI agents and PR review.**
 
-![Version](https://img.shields.io/badge/version-1.30.30-blue)
+![Version](https://img.shields.io/badge/version-1.31.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -38,7 +38,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.30.30
+# sourcecode 1.31.0
 ```
 
 ---

{sourcecode-1.30.30 → sourcecode-1.31.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.30.30"
+version = "1.31.0"
 description = "Deterministic codebase context for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -39,12 +39,16 @@ dev = [
     "pytest>=8",
     "ruff>=0.15",
     "mypy>=1.10",
+    "mcp>=1.0.0",
 ]
 ast = [
     "tree-sitter>=0.21",
     "tree-sitter-typescript>=0.21",
     "tree-sitter-javascript>=0.21",
 ]
+mcp = [
+    "mcp>=1.0.0",
+]
 
 [[tool.mypy.overrides]]
 module = ["tree_sitter", "tree_sitter_typescript", "tree_sitter_javascript"]

{sourcecode-1.30.30 → sourcecode-1.31.0}/src/sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Deterministic codebase context maps for AI coding agents."""
 
-__version__ = "1.30.30"
+__version__ = "1.31.0"

{sourcecode-1.30.30 → sourcecode-1.31.0}/src/sourcecode/cli.py

@@ -154,6 +154,10 @@ Compressed AI-ready context for Java/Spring enterprise codebases.
 
 [bold]Subcommands:[/bold]
   prepare-context TASK [PATH]  [dim]# task-specific context (onboard, delta, fix-bug, ...)[/dim]
+  mcp init                     [dim]# setup MCP integration (Claude Desktop, Cursor)[/dim]
+  mcp status                   [dim]# show MCP integration status[/dim]
+  mcp remove                   [dim]# remove MCP integration safely[/dim]
+  mcp serve                    [dim]# start MCP server for AI agent integration[/dim]
   telemetry status|enable|disable
   version
 """
@@ -161,7 +165,7 @@ Compressed AI-ready context for Java/Spring enterprise codebases.
 # Known subcommand names — tokens matching these are routed as subcommands,
 # not consumed as a repository path.
 _SUBCOMMANDS: frozenset[str] = frozenset(
-    {"telemetry", "prepare-context", "version", "config", "analyze", "repo-ir"}
+    {"telemetry", "prepare-context", "version", "config", "analyze", "repo-ir", "mcp"}
 )
 
 # Mutable container holding the path extracted by _preprocess_argv().
@@ -300,6 +304,9 @@ except Exception:
 telemetry_app = typer.Typer(help="Manage anonymous telemetry (opt-in).", rich_markup_mode="rich")
 app.add_typer(telemetry_app, name="telemetry")
 
+mcp_app = typer.Typer(help="MCP integration: setup, status, serve, remove.", rich_markup_mode="rich")
+app.add_typer(mcp_app, name="mcp")
+
 
 def _maybe_ask_consent() -> None:
     """Show first-run consent prompt once, on interactive TTYs only."""
@@ -317,6 +324,26 @@ def _maybe_ask_consent() -> None:
         pass
 
 
+def _maybe_show_mcp_hint() -> None:
+    """Show MCP integration hint once after first install, on TTY only."""
+    import sys as _sys
+    try:
+        if not _sys.stderr.isatty():
+            return
+        from sourcecode.telemetry.config import _CONFIG_FILE, _load, _save
+        data = _load()
+        if data.get("mcp", {}).get("hint_shown"):
+            return
+        typer.echo("", err=True)
+        typer.echo("  MCP integration available:", err=True)
+        typer.echo("  → sourcecode mcp init", err=True)
+        typer.echo("", err=True)
+        data.setdefault("mcp", {})["hint_shown"] = True
+        _save(data)
+    except Exception:
+        pass
+
+
 def _active_flags(
     dependencies: bool, graph_modules: bool, docs: bool, full_metrics: bool,
     semantics: bool, architecture: bool, git_context: bool, env_map: bool,
@@ -616,6 +643,7 @@ def main(
     # First-run consent (skip for telemetry/version/config subcommands)
     if ctx.invoked_subcommand not in ("telemetry", "version", "config"):
         _maybe_ask_consent()
+        _maybe_show_mcp_hint()
 
     # When a subcommand is invoked, skip the main analysis.
     if ctx.invoked_subcommand is not None:
@@ -2432,6 +2460,249 @@ def analyze_cmd(
     raise typer.Exit(code=1)
 
 
+# ── MCP server ────────────────────────────────────────────────────────────────
+
+@mcp_app.command("serve")
+def mcp_serve() -> None:
+    """Start the MCP server on stdio for AI agent integration.
+
+    \b
+    Requires the 'mcp' extra:
+      pip install sourcecode[mcp]
+
+    \b
+    Configure in your MCP client (e.g. Claude Desktop):
+      {
+        "sourcecode": {
+          "command": "sourcecode",
+          "args": ["mcp", "serve"]
+        }
+      }
+    """
+    import logging
+    import sys as _sys
+
+    logging.basicConfig(
+        stream=_sys.stderr,
+        level=logging.INFO,
+        format="[sourcecode-mcp] %(levelname)s %(message)s",
+    )
+    try:
+        from sourcecode.mcp.server import mcp as _mcp
+    except ImportError:
+        typer.echo(
+            "MCP support not available. Install with:\n"
+            "  pip install sourcecode[mcp]",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    log = logging.getLogger(__name__)
+    log.info("sourcecode-mcp starting (stdio transport)")
+    try:
+        _mcp.run()
+    except KeyboardInterrupt:
+        log.info("sourcecode-mcp stopped")
+    except Exception as exc:
+        log.critical("sourcecode-mcp fatal error: %s", exc, exc_info=True)
+        raise typer.Exit(code=1)
+
+
+# ── MCP onboarding ────────────────────────────────────────────────────────────
+
+@mcp_app.command("init")
+def mcp_init(
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt."),
+) -> None:
+    """Setup MCP integration for Claude Desktop, Cursor, and other clients.
+
+    \b
+    Detects installed MCP clients, backs up their config files, and safely
+    inserts the sourcecode server entry. Fully idempotent — safe to re-run.
+    """
+    from sourcecode.mcp.onboarding.detector import detect_clients
+    from sourcecode.mcp.onboarding.planner import build_install_plan
+    from sourcecode.mcp.onboarding import backup, applier
+
+    typer.echo("Detecting MCP clients...")
+    typer.echo("")
+
+    clients = detect_clients()
+    if not clients:
+        typer.echo("No MCP clients found on this system.")
+        typer.echo("")
+        typer.echo("Manual setup — add to your MCP client config:")
+        typer.echo('  "sourcecode": {"command": "sourcecode", "args": ["mcp", "serve"]}')
+        raise typer.Exit(code=0)
+
+    # Show detection results
+    for client in clients:
+        mark = "✓" if client.app_installed else "○"
+        note = "" if client.app_installed else "  (not found)"
+        typer.echo(f"  {mark}  {client.name:<18} {client.config_path}{note}")
+    typer.echo("")
+
+    # Build plan
+    plan = build_install_plan(clients)
+    actionable = [a for a in plan if a.client.app_installed and not a.already_installed]
+    already_done = [a for a in plan if a.client.app_installed and a.already_installed]
+
+    if already_done and not actionable:
+        typer.echo("Already configured:")
+        for a in already_done:
+            typer.echo(f"  ✓  {a.client.name}   {a.client.config_path}")
+        typer.echo("")
+        typer.echo("Nothing to do. Remove: sourcecode mcp remove")
+        raise typer.Exit(code=0)
+
+    if already_done:
+        typer.echo("Already configured:")
+        for a in already_done:
+            typer.echo(f"  ✓  {a.client.name}   {a.client.config_path}")
+        typer.echo("")
+
+    # Show plan for actionable items
+    typer.echo("This will:")
+    for a in actionable:
+        verb = "Create " if a.will_create_file else "Modify "
+        typer.echo(f"  {verb}  {a.client.config_path}")
+    typer.echo(f"  Backup → ~/.config/sourcecode/mcp-backups/")
+    typer.echo("")
+
+    if not yes:
+        confirmed = typer.confirm("Proceed?", default=False)
+        if not confirmed:
+            typer.echo("Aborted.")
+            raise typer.Exit(code=0)
+        typer.echo("")
+
+    # Apply
+    errors: list[str] = []
+    for a in actionable:
+        try:
+            config = applier.read_config(a.client.config_path)
+            if a.client.config_path.exists():
+                bak = backup.create(a.client.config_path)
+                typer.echo(f"  ✓ Backup   {bak}")
+            updated = applier.apply_entry(config)
+            applier.write_config(a.client.config_path, updated)
+            if not applier.validate(a.client.config_path):
+                errors.append(f"{a.client.name}: JSON validation failed after write")
+                continue
+            typer.echo(f"  ✓ Updated  {a.client.config_path}")
+        except Exception as exc:
+            errors.append(f"{a.client.name}: {exc}")
+
+    typer.echo("")
+
+    if errors:
+        for err in errors:
+            typer.echo(f"  ✗ {err}", err=True)
+        raise typer.Exit(code=1)
+
+    typer.echo("MCP integration active.")
+    typer.echo("")
+
+    restart_needed = [a.client.name for a in actionable if not a.will_create_file]
+    if restart_needed:
+        typer.echo(f"  Restart {', '.join(restart_needed)} to apply changes.")
+    typer.echo("  Remove:  sourcecode mcp remove")
+
+
+@mcp_app.command("status")
+def mcp_status() -> None:
+    """Show MCP integration status for all detected clients."""
+    from sourcecode.mcp.onboarding.detector import detect_clients
+    from sourcecode.mcp.onboarding import applier
+
+    clients = detect_clients()
+    typer.echo("MCP Integration Status")
+    typer.echo("")
+
+    if not clients:
+        typer.echo("  No MCP clients detected on this system.")
+        raise typer.Exit(code=0)
+
+    for client in clients:
+        if not client.app_installed:
+            typer.echo(f"  ○  {client.name:<18} not found")
+            continue
+        config = applier.read_config(client.config_path)
+        if applier.is_installed(config):
+            typer.echo(f"  ✓  {client.name:<18} configured   {client.config_path}")
+        else:
+            typer.echo(f"  ✗  {client.name:<18} not configured")
+    typer.echo("")
+    typer.echo("  Setup:   sourcecode mcp init")
+    typer.echo("  Remove:  sourcecode mcp remove")
+
+
+@mcp_app.command("remove")
+def mcp_remove(
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt."),
+) -> None:
+    """Remove sourcecode MCP integration from all configured clients.
+
+    \b
+    Backs up config files before modifying. Restores from backup when available,
+    otherwise removes the sourcecode entry while preserving all other config.
+    """
+    from sourcecode.mcp.onboarding.detector import detect_clients
+    from sourcecode.mcp.onboarding.planner import build_remove_plan
+    from sourcecode.mcp.onboarding import backup, applier
+
+    clients = detect_clients()
+    plan = build_remove_plan(clients)
+    installed = [a for a in plan if a.already_installed]
+
+    if not installed:
+        typer.echo("sourcecode MCP integration not found in any client config.")
+        typer.echo("  Setup: sourcecode mcp init")
+        raise typer.Exit(code=0)
+
+    typer.echo("Remove sourcecode MCP integration from:")
+    typer.echo("")
+    for a in installed:
+        typer.echo(f"  {a.client.name}   {a.client.config_path}")
+        bak = backup.latest(a.client.config_path)
+        if bak:
+            typer.echo(f"    Backup available: {bak}")
+    typer.echo("")
+
+    if not yes:
+        confirmed = typer.confirm("Proceed?", default=False)
+        if not confirmed:
+            typer.echo("Aborted.")
+            raise typer.Exit(code=0)
+        typer.echo("")
+
+    errors: list[str] = []
+    for a in installed:
+        try:
+            bak = backup.create(a.client.config_path)
+            typer.echo(f"  ✓ Backup   {bak}")
+            config = applier.read_config(a.client.config_path)
+            updated = applier.remove_entry(config)
+            applier.write_config(a.client.config_path, updated)
+            if not applier.validate(a.client.config_path):
+                errors.append(f"{a.client.name}: JSON validation failed — restoring backup")
+                backup.restore(bak, a.client.config_path)
+                continue
+            typer.echo(f"  ✓ Updated  {a.client.config_path}")
+        except Exception as exc:
+            errors.append(f"{a.client.name}: {exc}")
+
+    typer.echo("")
+
+    if errors:
+        for err in errors:
+            typer.echo(f"  ✗ {err}", err=True)
+        raise typer.Exit(code=1)
+
+    typer.echo("MCP integration removed.")
+    typer.echo("  Re-add:  sourcecode mcp init")
+
+
 # ── Entry point ───────────────────────────────────────────────────────────────
 
 def main_entry() -> None:

sourcecode-1.31.0/src/sourcecode/mcp/__init__.py

@@ -0,0 +1,5 @@
+"""MCP server integration for sourcecode CLI.
+
+Exposes all CLI capabilities as MCP tools callable by AI agents.
+Install the 'mcp' extra to enable: pip install sourcecode[mcp]
+"""

sourcecode-1.31.0/src/sourcecode/mcp/onboarding/__init__.py

@@ -0,0 +1 @@
+"""MCP client onboarding: detect, plan, apply, backup, remove."""