Skip to content

docs: fix post-rebrand doc drift (dead gittensory-mcp/gittensory-engine references) #5809

Description

@JSONbored

Context

The gittensoryloopover rebrand (epic #5705, closed completed 2026-07-14) renamed the CLI binaries, npm package directories, and Cloudflare Worker resource names, but four contributor-facing doc files still cite the pre-rename names/paths — none of these were mentioned in #5705's own status-update comments, so they slipped through:

  1. CONTRIBUTING.md (lines ~251-263, "Cloudflare/deploy" section) still calls the production Workers gittensory-ui and gittensory-api. The actual "name" fields are now "loopover-ui" (apps/loopover-ui/wrangler.jsonc) and "loopover-api" (root wrangler.jsonc). A contributor looking up the Worker in the Cloudflare dashboard by the name CONTRIBUTING.md gives them won't find it.
  2. CONTRIBUTING.md line ~272 tells contributors to run gittensory-mcp init-client --print. That binary no longer exists — the package's actual bin entry (packages/loopover-mcp/package.json) is loopover-mcp.
  3. packages/loopover-miner/README.md has two broken relative markdown links that point at directories that no longer exist:
    • line ~212: [cli-subprocess-driver.ts](../gittensory-engine/src/miner/cli-subprocess-driver.ts) — should be ../loopover-engine/...
    • line ~262: [@loopover/mcp README](../gittensory-mcp/README.md#client-config) — should be ../loopover-mcp/README.md#client-config
      (packages/gittensory-engine and packages/gittensory-mcp were both renamed to packages/loopover-engine / packages/loopover-mcp; verified via git ls-tree -r origin/main -- packages/ — no packages/gittensory-* path exists.)
  4. .claude/skills/contributing-to-loopover/SKILL.md (lines ~100-102, ~276) and .claude/skills/contributing-to-loopover/reference.md (lines ~147-149) give contributors (and AI coding agents, including the one reading this very skill to write PRs) copy-pasteable commands using the dead gittensory-mcp binary name (gittensory-mcp login, gittensory-mcp init-client --print codex, etc.), and SKILL.md:276 still says "gittensory-ui is a dark-mode-only..." for the visual-review guidance.

None of these are speculative — every renamed target (loopover-mcp bin, loopover-ui/loopover-api Worker names, packages/loopover-engine/packages/loopover-mcp directories) already exists and is live on main; only the doc text lags.

Requirements

  • Update CONTRIBUTING.md's Cloudflare/deploy section to say loopover-ui and loopover-api (Worker names, deploy-command references, and any surrounding sentence that reads awkwardly after the substitution).
  • Fix the gittensory-mcp init-client --print command in CONTRIBUTING.md to loopover-mcp init-client --print.
  • Fix both broken relative links in packages/loopover-miner/README.md to point at the real packages/loopover-engine/... and packages/loopover-mcp/README.md#client-config paths.
  • Fix every gittensory-mcp command example in .claude/skills/contributing-to-loopover/SKILL.md and reference.md to loopover-mcp, and fix the gittensory-ui mention in SKILL.md's visual-review section to loopover-ui.
  • Grep the four files above for any other stray gittensory- string once these are fixed, to make sure nothing was missed in the same pass.

Deliverables

  • CONTRIBUTING.md: gittensory-ui/gittensory-apiloopover-ui/loopover-api; gittensory-mcploopover-mcp
  • packages/loopover-miner/README.md: both relative links fixed to packages/loopover-engine / packages/loopover-mcp
  • .claude/skills/contributing-to-loopover/SKILL.md: gittensory-mcp commands → loopover-mcp; gittensory-uiloopover-ui
  • .claude/skills/contributing-to-loopover/reference.md: gittensory-mcp commands → loopover-mcp

Test Coverage Requirements

Docs-only change (*.md files) — outside coverage.include (see codecov.yml: coverage is collected only over src/**, packages/loopover-engine/src/**, and packages/loopover-miner/lib/**). Codecov's patch/project gates will not fire on this PR; that's expected, not a sign anything was skipped.

Expected Outcome

A contributor following CONTRIBUTING.md or the contributing-to-loopover skill can copy-paste every CLI command and it actually runs; every relative link in the miner README resolves; no doc references a Worker or package name that no longer exists.

Links & Resources

Metadata

Metadata

Assignees

No one assigned

    Labels

    gittensor:bugGittensor-scored bug fix — scores a 0.05x multiplier.help wantedExtra attention is needed

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions