Skip to content

docs: replace stale repo-map references with repo-intel#20

Merged
avifenesh merged 3 commits intomainfrom
docs/fix-drift-repo-intel-scan
Apr 14, 2026
Merged

docs: replace stale repo-map references with repo-intel#20
avifenesh merged 3 commits intomainfrom
docs/fix-drift-repo-intel-scan

Conversation

@avifenesh
Copy link
Copy Markdown
Contributor

@avifenesh avifenesh commented Apr 14, 2026

Summary

  • Replace 4 stale repo-map references in README with repo-intel (plugin was renamed).
  • Replace 2 references in skills/sync-docs/SKILL.md (including the repo-map.json cache file name, now repo-intel.json).
  • Add npm test and npm run validate scripts so the pre-push hook and shared ci-node workflow have a smoke test to run (matches drift-detect and repo-intel).

Why

Detected during a workspace-wide repo-intel doc-drift scan.

Test plan

  • CI passes
  • Verify docs match code

Docs-only change (plus the small tooling fix needed to unblock the pre-push hook).


Note

Low Risk
Low risk: primarily documentation wording updates plus adding simple npm test/validate scripts that only require('./lib') and shouldn’t affect runtime behavior.

Overview
Updates docs to replace stale repo-map references with repo-intel (including CLI flag/help text, optional ast-grep integration notes, and related plugin links).

Adds npm test and validate scripts that run a lightweight Node require check (require('./lib')) to give CI/pre-push hooks a basic smoke test.

Reviewed by Cursor Bugbot for commit 2bdd09e. Configure here.

4 references in README and 2 in SKILL.md pointed at the renamed repo-map plugin / repo-map.json cache file. Updated to repo-intel / repo-intel.json.
Pre-push hook expects npm test, but package.json had no scripts. Mirror the smoke-test pattern used by drift-detect and repo-intel (require entry module). Matches the graceful fallback in the shared ci-node workflow.
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 renames references from repo-map to repo-intel across the documentation and adds basic test and validation scripts to package.json. A review comment points out a potential inconsistency in the documentation update for SKILL.md, noting that the underlying implementation may still be using repo-map.json as its primary cache file.

Comment thread skills/sync-docs/SKILL.md Outdated
The primary symbol cache loaded via ensureRepoMapSync in
lib/collectors/docs-patterns.js is repo-map.json. repo-intel.json
is the raw data source from agent-analyzer that gets converted
into repo-map.json. Step 5 should reference repo-map.json.

Step 6 correctly references repo-intel.json for the doc-drift
query that calls the agent-analyzer binary directly.
@avifenesh avifenesh merged commit e03850e into main Apr 14, 2026
5 checks passed
@avifenesh avifenesh deleted the docs/fix-drift-repo-intel-scan branch April 14, 2026 23:27
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