Skip to content

chore: drop Homebrew + delete stale Java-era docs (CLI + MCP only)#138

Merged
aksOps merged 2 commits into
mainfrom
chore/drop-homebrew-and-stale-docs
May 13, 2026
Merged

chore: drop Homebrew + delete stale Java-era docs (CLI + MCP only)#138
aksOps merged 2 commits into
mainfrom
chore/drop-homebrew-and-stale-docs

Conversation

@aksOps
Copy link
Copy Markdown
Contributor

@aksOps aksOps commented May 13, 2026

Summary

Three changes per the post-v0.3.0 cleanup goal:

  1. Homebrew dropped — `.goreleaser.yml` `brews:` block + HOMEBREW_* envs in release-go.yml + install section in README + runbook section all gone. Pre-built signed binaries cover the install surface.

  2. Stale `docs/project/` deleted — architecture.md, conventions.md, data-model.md, flows.md, ui.md, build-and-run.md all referenced Spring Boot, REST controllers, the React SPA, Jacoco — all deleted in Phase 6 cutover. Content was wrong, not just stale. CLAUDE.md is now the single source of truth.

  3. `serve` subcommand decisively out of scope — CLAUDE.md previously said "deferred — not ported in v0.3.0". Now states the position: codeiq has no REST API and no web UI; the Java `codeiq serve` will not be reintroduced. Consumers use the CLI or the stdio MCP server.

Net diff: 13 files, +13 / -1433.

Already done out-of-band

Branch protection updated:

```
gh api -X POST .../branches/main/protection/required_status_checks/contexts \
-f 'contexts[]=vet / test / staticcheck / gosec / govulncheck' \
-f 'contexts[]=index perf gate (fixture-multi-lang)'
```

→ `go-ci` and `perf-gate` now block merge on main alongside the 6 security checks.

Test plan

  • yaml-lint on `.goreleaser.yml` and `release-go.yml` passes
  • `go mod tidy` — JWT stays (transitive via MCP SDK auth, verified with `go mod why`)
  • CI green on this PR (all 8 required checks)

🤖 Generated with Claude Code

aksOps and others added 2 commits May 13, 2026 08:57
Three changes per the post-v0.3.0 cleanup goal:

## 1. Homebrew dropped

- .goreleaser.yml: remove `brews:` block.
- release-go.yml: remove HOMEBREW_TAP_OWNER/REPO/GITHUB_TOKEN env.
- README.md: remove the `### Homebrew` install section.
- shared/runbooks/release-go.md: remove `## Homebrew tap` section and
  related cross-references.
- CHANGELOG.md / CLAUDE.md: scrub Homebrew mentions.

Not pursuing a tap — pre-built binaries from Releases + Cosign-verified
checksums cover the install surface. Saves repo creation + PAT churn.

## 2. Stale Java-era docs deleted

The entire `docs/project/` tree (architecture.md, conventions.md,
data-model.md, flows.md, ui.md, build-and-run.md) referenced Spring
Boot, application.yml, REST controllers, the React SPA, Jacoco, etc.
— all deleted in Phase 6 cutover. The content was wrong, not just
stale. CLAUDE.md is the single source of truth.

Updated PROJECT_SUMMARY.md links to point at CLAUDE.md instead.

## 3. `serve` subcommand decisively out of scope

CLAUDE.md previously said `serve: (deferred — not ported in v0.3.0)`.
Updated to state the position: codeiq has no REST API and no web UI.
Consumers use the CLI or the stdio MCP server. Java's `codeiq serve`
will not be reintroduced.

The `golang-jwt/jwt/v5` dep is transitive via the MCP SDK's auth
package (verified with `go mod why`) — not a serve-mode leftover.
CLAUDE.md note corrected.

Also drove (out-of-band) the branch-protection update:

    $ gh api -X POST .../branches/main/protection/required_status_checks/contexts \
        -f 'contexts[]=vet / test / staticcheck / gosec / govulncheck' \
        -f 'contexts[]=index perf gate (fixture-multi-lang)'

→ both Go gates now block merge on main.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
PR #138 deleted docs/project/ and the brews: block, but missed:

- README.md linked to docs/project/architecture.md + conventions.md
- PROJECT_SUMMARY.md listed HOMEBREW_TAP_GITHUB_TOKEN as a runtime env
- shared/runbooks/release-go.md still had "Homebrew tap PR fails" recovery
- release-go.yml + .goreleaser.yml carried stale "darwin/arm64 deferred"
  comments after release-darwin.yml landed (#137)

Pure docs/comments fix; no code or workflow behavior changes.
@aksOps aksOps merged commit ecb5ede into main May 13, 2026
13 checks passed
@aksOps aksOps deleted the chore/drop-homebrew-and-stale-docs branch May 13, 2026 09:07
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