fix: make install copy, counts, manifests and release notes tell one story

[TMHSDigital]

Summary

Docs, site and release copy now agree with the tree, and new gates stop them drifting again.

• docs: repo description and landing/README copy show stale counts again (16 skills, 27 snippets, 'five to fifty lines'); check_counts can't see them #448: README snippet row (27 to 29) and Skills row (now all 18 domains), AGENTS.md tree (27/64 to 29/66), landing "five to fifty lines" to "five to seventy-five lines". tests/check_counts.py now:
  • scans ROADMAP (history sections skipped), site.json, scripts/site/*.j2, all four manifests and the plugin-dist README in build_plugin_dist.py
  • allows up to two words between number and noun; words like "new", "check-only" or "rendered" mark a subset and are not checked
  • checks the README layer table (| **Snippets** | N)
  • checks any snippet "N to M lines" phrase against the 5 to 75 cap
  • asserts ROADMAP's last shipped theme row equals the counts
• site: landing hero copy button gives Claude Code users only step 1 of 2 (marketplace add, no install) #449: heroCommand takes a list. The hero shows both Claude Code commands as numbered lines, and the copy button copies both, newline-separated.
• docs: README and landing still tell plugin users to clone main or copy rules by hand (#335/#371 incomplete) #450:
  • README Quick start no longer opens with a clone of main; that moved to "Run the examples or contribute".
  • Overview now says "installed as a plugin or read from a checkout".
  • The Cursor rules section says the plugin covers the rules, with copying as the per-project alternative.
  • Landing heading is "Install it in your agent."
  • The "Other agents" step clones the slim plugin-dist build.
• docs: ROADMAP theme table stops at 16 skills, modal operators still Upcoming, dangling references, and no upcoming skill/rule work is visible (#369 incomplete) #451: ROADMAP gets:
  • a "Next for agents" section near the top, linking feature: porting-to-blender-5 skill that indexes every 4.x to 5.x break the pack covers #466 feature: gpu-drawing skill and a no-bgl rule (bgl is gone in Blender 5.x; agents still write it) #465 skills: 12 examples prove API contracts no skill teaches (Grease Pencil v3, 5.x compositor, constraints, image pixels...), so plugin users never get them #456 skills: document the full Principled BSDF v2 socket rename table in procedural-materials #382 rules: add a rule for the mesh-normals APIs removed in 4.1 (use_auto_smooth, calc_normals_split, free_normals_split) #379 examples: add runnable check-only examples for operators, ui-panels, addon-scaffolding and bl-info-migration #378 feature: skill <-> example index and a single machine-readable examples manifest with version support #377 testing: the 29 shipped snippets and 125 SKILL.md code blocks never execute in CI; smoke tests frozen copies #447 ci: add a weekly non-gating smoke against Blender daily builds (next version) to catch API breaks before release #457 feature: first-class support for other agents (Codex, Copilot, Windsurf, Gemini) via .agents/skills and an AGENTS.md rules export #376
  • v0.146 and v0.147 theme rows
  • the Upcoming row reduced to USD pipelines and mathutils
  • the stale modal-operators candidate removed
  • the dangling "item above" reference made self-contained
    ISSUE_TEMPLATE/config.yml now says shipped items are removed (see CHANGELOG).
• site: landing "What's new" only considers gallery renders, so new skills (v0.146, v0.147) never appear #452: What's new also dates skills, rules, snippets and check-only examples by first-add commit. They render as text cards with a kind badge and link to the GitHub path. The heading is now "Recently shipped." pages.yml also triggers on snippets/**.
• site: "66 examples" in the hero vs "56" in the gallery is never explained; check-only examples are invisible to visitors #453: the landing examples panel says "66 examples: 56 rendered · 10 check-only (data contracts with nothing to see)" and links gallery/#check-only. The gallery header has a collapsible list of the 10, generated from examples/index.json; visiting #check-only opens it.
• distribution: Cursor manifest kept the old generic description and no logo; manifest homepages and site license strings disagree #454:
  • Both plugin.json files and both marketplace entries share the value-led description, and the site is the homepage in both.
  • The Cursor manifest gets "logo": "assets/favicon.svg". logo is in Cursor's allowed-key set in validate-manifest, and build_plugin_dist.py now ships that file.
  • The gallery footer reads the license from the Cursor manifest, which the landing footer already uses (both now CC-BY-NC-ND-4.0 AND MIT).
  • New tests/check_manifest_meta.py runs in the Validate plugin manifest job.
  • The Claude Code manifest has no logo: I don't know of a logo field in its schema.
• release: 200+ releases with raw commit-subject notes bury user-facing changes; separate maintenance from content #455: release_notes.py lists plugin-content commits (skills/ rules/ snippets/ templates/ claude/) first under "For agents and users". Everything else goes in a collapsed <details> Maintenance block, and a maintenance-only release says so in one line. AGENTS.md documents the commit-type policy (ci:/test:/docs: rather than fix(ci) for maintenance). tests/test_release_notes.py is updated.

Partially addresses #392: the SECURITY.md pinning sentence now explains that plugin-dist installs cannot be pinned to a tag. The contact channels are unchanged (the maintainer's decision).

Closes #448
Closes #449
Closes #450
Closes #451
Closes #452
Closes #453
Closes #454
Closes #455

Evidence

Live runs (local, no Blender needed):

• python scripts/site/build_site.py --repo-root . --out docs, python scripts/build_gallery.py and python tests/check_site_links.py passed: 135 pages, 7115 internal references, 0 failures.

• python tests/run_all.py after commit: 32 passed, 0 failed.

• I read the generated HTML for every part I changed:

  • hero <pre> and its data-copy (two lines, newline-separated)
  • the lede note
  • the install heading and steps
  • the snippet heading
  • both footers
  • the gallery #check-only block (10 entries; dotted API paths like Object.evaluated_get stay intact in the summaries)

• Falsification, run on a temporary copy of the repo:

  Reintroduced	Result from check_counts
  "27 small standalone"	README.md:56 says "| **Snippets** | 27"
  "five to fifty lines"	template.html.j2:544 error
  AGENTS "27 standalone Python snippets"	error
  ROADMAP v0.147 row removed	last shipped theme row is (17, 9, 3, 28) ... repo has (18, 9, 3, 29)
  "16 skills" in site.json	error

• check_manifest_meta.py failed on the stale gallery footer before regeneration (docs/gallery/index.html footer does not show the license 'CC-BY-NC-ND-4.0 AND MIT') and passes after.

• release_notes.py rendered against v0.145.0..HEAD: the two skill features lead, and the deps bump sits in the collapsed Maintenance block.

• What's new: the local clone is shallow, so the normal build hides the strip, as designed. A probe that fakes only the history check rendered six text cards: the timers and extension-runtime skills, their snippets and their check-only examples, each "added 2026-10-04" (commit date).

Inspection only:

• Layout at desktop and mobile width (no screenshots taken).
• Cursor's rendering of logo.
• The real CI release-notes output on the next release.

🤖 Generated with Claude Code