Skip to content

fix(hooks): remove stale refs to retired dev/scripts/git-hooks#58

Merged
WomB0ComB0 merged 1 commit intomasterfrom
fix/post-retirement-crates-cleanup
Apr 14, 2026
Merged

fix(hooks): remove stale refs to retired dev/scripts/git-hooks#58
WomB0ComB0 merged 1 commit intomasterfrom
fix/post-retirement-crates-cleanup

Conversation

@WomB0ComB0
Copy link
Copy Markdown
Member

Summary

Three stale references surfaced by an org-wide audit after the Phase 4 retirement landed in resq-software/dev#6:

  1. .github/workflows/hooks-sync.yml — the drift-check-dev job still fetched from resq-software/dev/main/scripts/git-hooks/. That path no longer exists, so the job would fail every run. Removed.

  2. AGENTS.md + CLAUDE.md — the Git hooks section pointed at the 404'd dev path and carried the obsolete qualifier "will converge once resq dev install-hooks can scaffold from embedded templates" (that shipped in feat(resq-cli): hooks subcommand + dev scaffold-local-hook #48). Rewrote to reflect the single-source-of-truth reality: this repo's crates/resq-cli/templates/git-hooks/ is canonical; the dev/ installer fetches from here.

Test plan

  • agent-sync.sh keeps AGENTS.md ↔ CLAUDE.md in sync
  • CI: hooks-sync workflow now runs with two jobs (lint + drift-check-local) instead of three; both should be green

🤖 Generated with Claude Code

- .github/workflows/hooks-sync.yml: drop `drift-check-dev` job. It
  fetched from resq-software/dev/main/scripts/git-hooks/ — which was
  retired in resq-software/dev#6 — so the job would fail every run.
  The remaining local drift-check between templates/ and .git-hooks/
  is now the whole check surface.

- AGENTS.md + CLAUDE.md: rewrite the Git hooks section to reflect the
  post-Phase-4 reality. This repo is the single source of truth; the
  old "will converge once resq dev install-hooks scaffolds from
  embedded templates" qualifier is obsolete (shipped in #48). The
  link to dev/tree/main/scripts/git-hooks no longer resolves;
  replaced with a forward link to the installer.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 14, 2026

Warning

Rate limit exceeded

@WomB0ComB0 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 51 minutes and 15 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 51 minutes and 15 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 63159914-9dab-4ef1-8adb-d3cc36dce2f3

📥 Commits

Reviewing files that changed from the base of the PR and between bb11197 and 14556e3.

📒 Files selected for processing (3)
  • .github/workflows/hooks-sync.yml
  • AGENTS.md
  • CLAUDE.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/post-retirement-crates-cleanup

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@WomB0ComB0 WomB0ComB0 merged commit 29414f0 into master Apr 14, 2026
11 of 13 checks passed
@WomB0ComB0 WomB0ComB0 deleted the fix/post-retirement-crates-cleanup branch April 14, 2026 20:27
@github-actions github-actions bot added C-Documentation Improvements or additions to documentation A-DevOps CI/CD and tooling size/M labels Apr 14, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates AGENTS.md and CLAUDE.md to establish this repository as the source of truth for canonical git-hook templates, detailing their storage location and installation process for sibling repositories. Feedback was provided to correct the branch name from master to main and to fix inconsistent link labels in the documentation.

Comment thread AGENTS.md
Canonical hooks are maintained in [`resq-software/dev`](https://github.com/resq-software/dev/tree/main/scripts/git-hooks) and delegate to `resq pre-commit` from this workspace. This repo's own `.git-hooks/` predates the canonical contract and builds `resq-cli` locally as a bootstrap — it will converge on the canonical shims once `resq dev install-hooks` can scaffold from embedded templates. See [resq-software/dev/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks).
This repo is the **source of truth** for canonical git-hook templates across the ResQ org. They live in [`crates/resq-cli/templates/git-hooks/`](crates/resq-cli/templates/git-hooks) and are embedded into the `resq` binary via `include_str!`, so `resq dev install-hooks` can scaffold them offline into any repo. The `.git-hooks/` copy in this repo's root is kept byte-identical by `hooks-sync.yml` CI.

Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `master` branch. See [resq/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The branch name master appears to be incorrect, as other references in this PR and the organization (e.g., the dev repository) use main. Additionally, the link label resq/AGENTS.md is inconsistent with the URL which points to the resq-software/dev repository.

Suggested change
Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `master` branch. See [resq/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.
Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `main` branch. See [resq-software/dev/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.

Comment thread CLAUDE.md
Canonical hooks are maintained in [`resq-software/dev`](https://github.com/resq-software/dev/tree/main/scripts/git-hooks) and delegate to `resq pre-commit` from this workspace. This repo's own `.git-hooks/` predates the canonical contract and builds `resq-cli` locally as a bootstrap — it will converge on the canonical shims once `resq dev install-hooks` can scaffold from embedded templates. See [resq-software/dev/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks).
This repo is the **source of truth** for canonical git-hook templates across the ResQ org. They live in [`crates/resq-cli/templates/git-hooks/`](crates/resq-cli/templates/git-hooks) and are embedded into the `resq` binary via `include_str!`, so `resq dev install-hooks` can scaffold them offline into any repo. The `.git-hooks/` copy in this repo's root is kept byte-identical by `hooks-sync.yml` CI.

Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `master` branch. See [resq/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The branch name master appears to be incorrect, as other references in this PR and the organization (e.g., the dev repository) use main. Additionally, the link label resq/AGENTS.md is inconsistent with the URL which points to the resq-software/dev repository.

Suggested change
Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `master` branch. See [resq/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.
Sibling repos install these via [`resq-software/dev/scripts/install-hooks.sh`](https://github.com/resq-software/dev/blob/main/scripts/install-hooks.sh), which prefers the offline `resq dev install-hooks` path when the binary is available and falls back to raw-fetching from this repo's `main` branch. See [resq-software/dev/AGENTS.md#git-hooks](https://github.com/resq-software/dev/blob/main/AGENTS.md#git-hooks) for the full contract.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-DevOps CI/CD and tooling C-Documentation Improvements or additions to documentation size/M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant