bitjaru / bitjaru/styleseed

Counted claims on the demo site are still unguarded

Open
#56 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
955
Forks
87
Avg merge
2d 17h
Merged PRs (30d)
33

Description

Follow-up to #55, which bound the READMEs' 31 counted claims to version.json.

The same numbers appear 26 more times outside the READMEs and nothing checks them:

File Claims
demo-pricing/app/page.tsx rules, grammars, skills, palettes, skins
demo-pricing/app/faq/page.tsx grammars, adapters, skills, skins (×4)
demo-pricing/app/why/comparison.tsx rules (×3)
demo-pricing/app/gallery/page.tsx skins
demo-pricing/app/codex-ui-design/page.tsx skills
demo-pricing/app/guides/[domain]/page.tsx, screens/[type]/page.tsx, showcase/_renderers/notes.tsx rules
docs/WINDOWS-INSTALL.md, docs/NEXT-RUNTIME-*.md skills, grammars, adapters, recipes, palettes

All 26 currently agree with version.json. The gap is that nothing keeps them agreeing.

Why #55 stopped at the READMEs

Running #55's patterns over the site finds two matches that are correct English but not claims, so extending the check as written would fail the build on valid copy:

  • demo-pricing/app/gallery/page.tsx:55Button under 3 skins. A live preview that shows three of the seven, not a count of what ships.
  • docs/NEXT-RUNTIME-IMPLEMENTATION-PLAN.md:488 recipes inside a validate-palettes transcript, where recipes means palette recipes.

Both are shapes, not one-offs: a count scoped to a page's own sample, and a keyword whose meaning depends on surrounding context. Any extension has to handle them rather than special-case these two lines.

Suggested direction

  • Read the counts from version.json in the site components instead of typing them, which removes the class of drift rather than detecting it. The value is already published at /version.json and the site already reads that file.
  • Where prose has to stay prose, mark it — an explicit opt-out comment beats an allowlist keyed to line numbers, which rots on the next edit.
  • Keep the docs transcripts out of scope. They record what a command printed on a date, and rewriting them to match a later count would make them false.

Not urgent: everything agrees today, and the README surface that evaluators read first is now gated.

🤖 Generated with Claude Code

https://claude.ai/code/session_016b5vcXw4iawXAZo4rHuuEf

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the existing README checks from #55 and the site's /version.json reader, then inspect the listed demo-pricing/app pages and docs files for the remaining claims. Determine which site counts can read published values and how explicit opt-outs should work; keep dated docs transcripts unchanged. Done means the listed live claims stay synchronized without false positives for sample counts or transcript text.

Written by the indexing model from the issue text.

Assessment

Tech stack
nextjs, react, typescript
Domain
documentation, frontend
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.