From 6c2d5d305f9b2ad66bb10d647e1fae8b4ee52b00 Mon Sep 17 00:00:00 2001
From: data-engineer <data-engineer@gradata.ai>
Date: Wed, 20 May 2026 09:38:31 -0700
Subject: [PATCH] chore(plugin): retire .claude-plugin/ references (GRA-1249 /
 epic GRA-1198)

The .claude-plugin/ directory itself was already removed in a prior cleanup
(see CHANGELOG: 'Remove orphaned gradata-plugin/ subdir (#54)'). What
remained were stale string references in docs and examples now that the
SDK ships all subcommands directly (PRs #208/#209/#210/#211 + #213).

Changes:
- .dockerignore: removed dead .claude-plugin exclude line
- examples/with_claude_code.py: replaced '/plugin install gradata' language
  with the canonical 'gradata install --agent claude-code'
- examples/README.md: fix broken link to .claude-plugin/README.md
- CHANGELOG.md: BREAKING entry under Unreleased documenting the retirement

This closes out the kill-the-plugin epic (GRA-1198 / GH #206) from the
references side. Anyone who installed via /plugin marketplace before
2026-05-20 must migrate to the SDK install path.

Verified:
- pip install /home/olive/work/gradata-sdk/Gradata in a fresh venv succeeds
- gradata install --agent claude-code --brain /tmp/test-brain --help works
- pytest tests/ -x -q passes (816 tests, 7 skipped, 1 known-skip on
  test_byo_key_provider for missing httpx in dev env unrelated to this)
- ruff check clean on touched files
- grep for 'claude-plugin|gradata-plugin' on src/ + docs/ shows only the
  intentional CHANGELOG entries (current BREAKING note + historical refs)

Branch authored by delegate_task subagent (hit max_iterations on PR-open);
parent agent verified + extracted clean diff + opened PR.
---
 Gradata/.dockerignore                |  1 -
 Gradata/CHANGELOG.md                 |  7 +++++++
 Gradata/examples/README.md           |  3 ++-
 Gradata/examples/with_claude_code.py | 10 +++++-----
 4 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/Gradata/.dockerignore b/Gradata/.dockerignore
index 7ca294e0..4efa4d82 100644
--- a/Gradata/.dockerignore
+++ b/Gradata/.dockerignore
@@ -2,7 +2,6 @@
 .git
 .github
 .claude
-.claude-plugin
 .tmp
 .venv
 venv
diff --git a/Gradata/CHANGELOG.md b/Gradata/CHANGELOG.md
index 8450eb18..8ca151ef 100644
--- a/Gradata/CHANGELOG.md
+++ b/Gradata/CHANGELOG.md
@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+### Breaking
+
+- **Plugin marketplace install path retired.** The `.claude-plugin/` directory
+  and `/plugin install gradata` flow are gone; use
+  `gradata install --agent claude-code` instead. See PR #211 for the README
+  guide. (GRA-1249, epic GRA-1198)
+
 ### Changed
 
 - Renamed the deterministic anchor-preserving prompt injection module to
diff --git a/Gradata/examples/README.md b/Gradata/examples/README.md
index 63317e6d..211f8a29 100644
--- a/Gradata/examples/README.md
+++ b/Gradata/examples/README.md
@@ -33,4 +33,5 @@ pip install gradata
 python examples/with_claude_code.py
 ```
 
-For the zero-code install, see [.claude-plugin/README.md](../.claude-plugin/README.md).
+For the zero-code install, run `gradata install --agent claude-code` — see the
+top-level [README](../README.md#install-for-claude-code) for details.
diff --git a/Gradata/examples/with_claude_code.py b/Gradata/examples/with_claude_code.py
index 7fded4a2..55068fe7 100644
--- a/Gradata/examples/with_claude_code.py
+++ b/Gradata/examples/with_claude_code.py
@@ -1,9 +1,8 @@
 """Using Gradata alongside Claude Code.
 
-With the Claude Code plugin installed (`/plugin install gradata`),
-corrections on `Edit` / `Write` tool calls are captured automatically and
-graduated rules are injected into every session. No code is needed in the
-hot path.
+With `gradata install --agent claude-code` run once, corrections on `Edit` /
+`Write` tool calls are captured automatically and graduated rules are
+injected into every session. No code is needed in the hot path.
 
 This example is the manual equivalent: the same `Brain` API the hooks use,
 run directly so you can inspect what gets stored and what would be injected.
@@ -11,7 +10,8 @@
 Run:
     python examples/with_claude_code.py
 
-See also: .claude-plugin/README.md for the zero-code install flow.
+See also: the README's "Install for Claude Code" section for the zero-code
+install flow.
 """
 
 from pathlib import Path