Skip to content

r3-publish batch: retire r2 vocabulary & references (on-v3-release)#130

Draft
isolomatov-gd wants to merge 24 commits into
mainfrom
on-v3-release
Draft

r3-publish batch: retire r2 vocabulary & references (on-v3-release)#130
isolomatov-gd wants to merge 24 commits into
mainfrom
on-v3-release

Conversation

@isolomatov-gd

@isolomatov-gd isolomatov-gd commented Jul 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

What

The publish-gated r3 batch from docs/stories/reduce-bootstrap.md (§ r3-publish batch). These surfaces serve the live r2 product today — merge only at v3 release/publish. Kept as draft until then.

Batch checklist

  • docs/web/** — synced to the closed alias set + mcp-files-mode.md (links/tables/prose, MUST USE FLOW form, load-project-context, JetBrains steps for r3 zips). architecture.md ACQUIRE sites kept — they document the generated-shell mechanism.
  • docs/PATTERNS/** — occurrence claims scoped to generated shells + mcp-files-mode.md bindings; mechanism docs keep ACQUIRE.
  • docs/reviews/** — ruling: dated review records, left verbatim.
  • rosettify-plugins — bootstrap.md → mcp-files-mode.md in doc-comment examples; runtime excludes unchanged (r2 exclude still guards r2 generation).
  • Default plugin release r2 → r3 — cli.ts --release default, FR-CLI-0010 (+ CHANGES.md entry), README examples; flag-less pre_commit.py plugin sync now generates r3. 444 tests pass.
  • tool_prompts.py — closed vocabulary (SEARCH/ABOUT/QUERY/STORE dropped, LIST <path> self-teaching alias, load-project-context); ACQUIRE FROM KB mapping kept (shell mechanism).
  • DEVELOPER_GUIDE.md — MUST USE FLOW …; r2 → r3 path.
  • MCP architecture extracted & demoted (both surfaces) — primary docs/MCP-ARCHITECTURE.md + website docs/web/docs/mcp-architecture.md (+ sidebar); architecture docs open MCP with "secondary delivery mode — plugins are primary" + keyword-dense pointer; Command Aliases + Bootstrap Flow stay (mode-agnostic contract, promoted to H2, anchors preserved, inbound links + REVIEW.md↔web mirror synced). State-only content — no removal meta-commentary.
  • Retired write-data MCP tools fully removed — 5 tools + entire dependency graph, then the zero-caller leftovers (can_write/can_create, write_policy, allowed_scopes/parse_scopes, invite_emails, plan_ttl_days; Authorizer = read path only, team policy + _ragflow_team_api kept live). ~4,750 lines removed; package-wide greps: zero mentions.
  • Root venv/ rule stated explicitly in both architecture docs (one venv for ALL Python in the repo).
  • Plugin regeneration — r3, deterministic-hooks=false, all 6 targets, via merged FR-CLI-0012 override; pre_commit.py plugin sync pinned to the same flags. Publish itself still on request.
  • agents/TEMP/old-gen-r2/** — N/A: gitignored, never in repo; local parity baseline kept.

Validation

  • rosettify 447 · rosettify-plugins 444 · ims-mcp-server 327 passed (root venv/), compileall/import/ruff clean.
  • validation/verify_mcp.py run LIVE (root .env, VERSION=r2) after each removal pass: ALL CHECKS PASSED, live tool surface = exactly 3 tools.
  • Post-sweep greps: zero stale vocabulary outside decided mechanism exceptions; zero mentions of removed tools/config package-wide.

Open before merge

  • Publish (npm/PyPI/release zips) — on request.
  • JetBrains install steps in installation.md — re-validate against actual regenerated r3 zips.

Notes

  • Story of record: docs/stories/reduce-bootstrap.md.

🤖 Generated with Claude Code

@isolomatov-gd @claude
Start on-v3-release: publish-gated r3 batch tracking branch
dc201e9 
Empty seed commit — work lands here per docs/stories/reduce-bootstrap.md
(r3-publish batch section).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
isolomatov-gd added a commit that referenced this pull request Jul 13, 2026
@isolomatov-gd @claude
Story sync: on-v3-release branch + draft PR #130 created
9b53fcb 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
isolomatov-gd and others added 23 commits July 13, 2026 12:28
@isolomatov-gd
Merge main (story sync)
e17dd35
@isolomatov-gd @claude
MCP tool prompts: closed alias vocabulary
4fed796 
Drop SEARCH/ABOUT/QUERY/STORE alias teachings; LIST alias to canonical
'LIST <path>' form matching mcp-files-mode.md binding; load-context ->
load-project-context. ACQUIRE mapping kept (generated-shell mechanism).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
rosettify-plugins: bootstrap.md -> mcp-files-mode.md in doc-comment e…
8118c29 
…xamples

Runtime excludes unchanged: engine stays content-agnostic, r2 entry
still guards r2 generation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
DEVELOPER_GUIDE: canonical USE FLOW form for MCP prompt authoring; r2…
b46a685 
… -> r3 path

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
docs/web: sync to r3 vocabulary and mcp-files-mode.md
3fe56f7 
Download links/tables/prose: bootstrap.md -> mcp-files-mode.md (r3 path);
USE FLOW form in developer-guide; load-project-context skill naming;
hitl/orchestration skill naming in FAQ; JetBrains steps updated for r3
plugin output (mode files excluded from zips, single bootstrap-alwayson).
architecture.md ACQUIRE sites kept — they document the generated-shell
mechanism (decided exception).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
docs/PATTERNS: ACQUIRE occurrence claims scoped to generated shells +…
306989c 
… mode-file bindings

Mechanism docs (shell-proxy, tag-based-retrieval, document-bundling)
keep ACQUIRE — it IS the shell mechanism. docs/reviews left verbatim
(dated review records).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Story: collapse r3-publish batch to done-nudge (PR #130)
066087e 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd
Integrate checklists
43dfe7e 
Signed-off-by: isolomatov-gd <isolomatov@griddynamics.com>
@isolomatov-gd @claude
Extract MCP internals into MCP-ARCHITECTURE docs; MCP declared second…
f91c883 
…ary to plugins

Primary docs/MCP-ARCHITECTURE.md (full: transports, OAuth modes, Redis
migrations, VFS/tags, tools, bundler, listings, overflow prevention) +
website docs/web/docs/mcp-architecture.md (lighter, same seam).
Architecture docs keep the mode-agnostic contract (Command Aliases,
Bootstrap Flow promoted to top level) plus a keyword-dense pointer.
Inbound anchors updated (OVERVIEW/REVIEW + web overview/review/context/
deployment; REVIEW.md and web review.md synced as source/mirror pair).
Sidebar link added. MCP tool tables reflect retired write-data tools.
Also: restore MUST USE FLOW emphasis (both developer guides), verbose
LIST placeholder teaching in tool_prompts.py, 'loads' verb in FAQ.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
ims-mcp-server: remove retired write-data MCP tools (dead code)
cda50b2 
Drop the 5 tools whose @mcp.tool registration was commented out
(submit_feedback, query_project_context, store_project_context,
discover_projects, plan_manager) plus their full dependency graph:
tools/plan_manager|projects|feedback, services/plan_store|feedback|
invite, dead prompts/constants/validators, single-purpose tests,
README tool sections. Kept shared infra with live callers
(_ragflow_team_api via authorizer, tools/validation shared fns,
Redis store/migrations). Also: LIST alias placeholder made
self-teaching in tool_prompts.py.

337 tests pass; compileall + import + ruff clean. verify_mcp.py
imports cleanly (live-server run needs RAGFlow credentials).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
MCP docs: state-only tool list, no removal meta-commentary
174f547 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
ims-mcp-server: purge all remnants of removed write-data tools
b3cc2a9 
verify_mcp.py: delete commented-out verification blocks, disabled
docstring items (renumbered), Redis/plan-store setup notes, dead
imports. Neutralize example scope strings in generic config tests.
Package-wide grep for the removed tool names: zero matches.

Validated LIVE: validation/verify_mcp.py against the real endpoint
(VERSION=r2) — ALL CHECKS PASSED; live tool surface = exactly 3 tools.
pytest 337 passed; compileall/import/ruff clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Story: record MCP architecture split + write-data tool removal
cbd3134 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Architecture docs: root venv/ is mandatory for ALL Python in the repo
c6e9334 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd
Version bump
dd01d28 
Signed-off-by: isolomatov-gd <isolomatov@griddynamics.com>
@isolomatov-gd @claude
rosettify-plugins: default release r3 (FR-CLI-0010 updated)
24cb609 
Plugin sync (pre_commit.py, no --release flag) now generates r3 by
default; r2 remains selectable. Requirement + change log + README
examples updated. 444 tests pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
ims-mcp-server: remove zero-caller write/scope/invite/plan-ttl config
c3ea253 
Authorizer reduced to read path (can_read + team policy, still backed
by _ragflow_team_api); drop write_policy/allowed_scopes/parse_scopes/
invite_emails/plan_ttl_days + env constants, README rows, and their
tests (read-path coverage kept, pending-invite read test added).
Package-wide grep for removed names: zero matches.

Root venv used throughout. 327 tests pass; verify_mcp.py run LIVE:
ALL CHECKS PASSED.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Story: record zero-caller removal + r3 default release fix
a1933a6 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd
Merge remote-tracking branch 'origin/main' into on-v3-release
ad65062
@isolomatov-gd @claude
Regenerate plugins: r3, deterministic-hooks=false; pin flags in pre_c…
8df1c5b 
…ommit

Full r3 plugin set for all 6 targets (was r2-generated). plugin sync in
pre_commit.py now passes --release r3 --deterministic-hooks false.
447 rosettify-plugins tests pass post-merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Story: plugins regenerated r3 (deterministic-hooks=false)
33b7f10 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Add vocabulary-migration pattern; JetBrains steps validated against r…
4a5a6a2 
…3 output

JetBrains plugin install: delete list = hooks.json + hooks/ (r3 zips
carry no .mcp.json/templates); closing tag is namespaced
</rosetta:plugin_files_mode>; workflows live in commands/<flow>.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@isolomatov-gd @claude
Story: batch fully landed; only publish remains
2d33778 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@kkhristenko51 kkhristenko51 Awaiting requested review from kkhristenko51 kkhristenko51 will be requested when the pull request is marked ready for review kkhristenko51 is a code owner
@omaiesh omaiesh Awaiting requested review from omaiesh omaiesh will be requested when the pull request is marked ready for review omaiesh is a code owner
@ElizaVetaFomka ElizaVetaFomka Awaiting requested review from ElizaVetaFomka ElizaVetaFomka will be requested when the pull request is marked ready for review ElizaVetaFomka is a code owner
@YevheniiaLementova YevheniiaLementova Awaiting requested review from YevheniiaLementova YevheniiaLementova will be requested when the pull request is marked ready for review YevheniiaLementova is a code owner

At least 2 approving reviews are required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@isolomatov-gd