Skip to content

feat(hooks): refresh the index through husky, and README community conventions - #213

Merged
jb-thery merged 3 commits into
developfrom
feature/husky-hooks-and-readme-community
Oct 27, 2026
Merged

jb-thery merged 3 commits into
developfrom
feature/husky-hooks-and-readme-community

Conversation

@jb-thery

Copy link
Copy Markdown
Member

Why

Upgrading two real projects to Ragmir 6.2 surfaced two library gaps, and the README needed a measured check against successful open-source projects.

  • husky: WorkoutGen uses husky 9 (core.hooksPath = .husky/_). rgr hooks install refused it as a tracked hooks folder, and rgr hooks status called the ignored .husky/_ shims tracked. husky regenerates those shims on every install; hooks belong in the .husky/<hook> scripts.
  • Allowed roots message: Pac's base sets mcpAllowedRoots: ["."], and the refusal told agents it served "workspaces under .".
  • READMEs: compared with eight successful READMEs (Vite, Zod, tRPC, Biome, Orama, Context7, mem0, Chroma), ours lacked three conventions most of them share: a stars or community badge (7 of 8), a community link (8 of 8), and code within the first 60 lines (5 of 8). The npm README also lacked the centered logo header (7 of 8).

Changes

  • git-hooks.ts: husky 9 (.husky/_ with its h runner) and husky 8 (.husky with _/husky.sh) are recognized; the block goes into .husky/<hook>, reports carry manager, and the CLI asks to commit the changed scripts. Other tracked folders still need --force.
  • mcp-scope.ts: the refusal names the resolved folders the check uses.
  • READMEs: downloads and stars badges, a three-line quick start right after the pitch, a community section, and a centered npm header.
  • CLI reference: husky behavior.

Verification

  • Core suite with coverage: 56 files, 542 tests, including husky 9 and husky 8 cases; Biome, types, API check, and public surface smoke pass.
  • Convention check after the change: both READMEs now carry every convention that at least half of the eight reference READMEs share.

husky 9 points core.hooksPath at .husky/_, whose shims it regenerates on every install, and husky 8
at .husky itself. `rgr hooks install` refused both as a tracked hooks folder. It now recognizes
husky, writes the Ragmir block into the .husky/<hook> scripts husky runs, reports manager=husky,
and asks to commit those scripts. Other tracked hooks folders still need --force.
The refusal printed the raw mcpAllowedRoots values, so an umbrella base configured with "." told
agents it served "workspaces under .". It now prints the resolved folders the check uses.
…DMEs

Compared with eight successful open-source READMEs (Vite, Zod, tRPC, Biome, Orama, Context7, mem0,
Chroma), every convention most of them share is now present: the GitHub README shows a three-line
quick start in its first lines and a community section, and both READMEs carry downloads and stars
badges; the npm README gains the centered logo header.
@jb-thery
jb-thery merged commit 195fb21 into develop Oct 27, 2026
12 checks passed
@jb-thery
jb-thery deleted the feature/husky-hooks-and-readme-community branch October 27, 2026 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant