Skip to content

chore: delete parity harness#172

Merged
aksOps merged 1 commit into
mainfrom
chore/delete-parity-harness
May 14, 2026
Merged

chore: delete parity harness#172
aksOps merged 1 commit into
mainfrom
chore/delete-parity-harness

Conversation

@aksOps
Copy link
Copy Markdown
Contributor

@aksOps aksOps commented May 14, 2026

Summary

Remove the `parity/` package (Java→Go cross-binary diff tool from the v0.3.0 cutover era; idle since Phase 6 removed the Java side).

Deleted

File Notes
`parity/cmd/parity-normalize/main.go` CLI used to dump SQLite cache for comparison
`parity/java-normalize.jq` jq filter for Java-side parity dumps
`parity/kuzu_dump.go` + `_test.go` Kuzu → normalized JSON dump
`parity/normalize.go` + `_test.go` Shared normalization
`parity/open_ro.go` Read-only Kuzu helper (build tag `parity`)
`parity/parity_test.go` Full cross-binary diff test (build tag `parity`)

8 files / 621 LoC / 84 KB.

Doc updates (9 files)

File Change
`CLAUDE.md` Removed `parity/` row from the package-layout tree
`README.md` Removed `parity/` row + status-table row; bumped status footer v0.4.1 → v0.4.2
`docs/00-project-overview.md` Removed parity bullet from "Experimental / partial" + status row
`docs/03-code-map.md` Removed intro mention + tree row + dedicated section
`docs/05-configuration.md` Removed "Parity harness" row from feature-flags table
`docs/08-testing.md` Removed parity row from test-counts table
`docs/10-known-risks-and-todos.md` Removed debt row + follow-up bullet
`docs/11-agent-handoff.md` Removed 20-line summary item + unfinished-work row + recommended-next-task
`docs/adr/0001-current-architecture.md` Removed open-follow-up bullet

Preserved (not the harness)

Two unrelated uses of the word "parity" stay:

  1. MCP consolidated-tool parity tests (`internal/mcp/tools_consolidated_parity_test.go`) — different concept; locks down arg-name mapping between the 6 consolidated mode-driven tools and the narrow handlers they delegate to. Caught the PR fix(mcp): correct dispatch arg names in 7 consolidated modes #149 dispatch-mismatch bug.
  2. `cache_meta` reserved-word workaround note — about byte-identical parity dumps with the (now-deleted) Java H2 side. Historical context worth keeping.

Test plan

  • `grep -rn "github.com/randomcodespace/codeiq/parity"` — zero non-self references.
  • `CGO_ENABLED=1 go build ./...` — clean.
  • `CGO_ENABLED=1 go test ./... -count=1` — clean; one fewer package than before.
  • All remaining "parity" mentions in docs are MCP-parity-test or H2-parity-dump contexts (verified by selective grep).

🤖 Generated with Claude Code

Remove the `parity/` package and update every doc reference to it.

Background: the parity harness was a Java→Go cross-binary diff tool
used heavily during the v0.3.0 cutover. Phase 6 deleted the Java side
months ago; the harness has been idle since. It compiled into the
default `go test ./...` run (~0.15s overhead) but produced no
verification anyone consumed.

Deleted (8 files / 621 LoC):
  parity/cmd/parity-normalize/main.go
  parity/java-normalize.jq
  parity/kuzu_dump.go
  parity/kuzu_dump_test.go
  parity/normalize.go
  parity/normalize_test.go
  parity/open_ro.go
  parity/parity_test.go

Doc updates (9 files):
  CLAUDE.md                              ── layout tree
  README.md                              ── tree + status table; v0.4.1 → v0.4.2
  docs/00-project-overview.md            ── drop parity bullet + status row
  docs/03-code-map.md                    ── intro line + tree + dedicated section
  docs/05-configuration.md               ── feature-flags table row
  docs/08-testing.md                     ── test-counts table row
  docs/10-known-risks-and-todos.md       ── debt table row + follow-up bullet
  docs/11-agent-handoff.md               ── 20-line summary + unfinished work
                                            + follow-ups
  docs/adr/0001-current-architecture.md ── open-follow-up bullet

Verification:
  * Zero non-self references to github.com/randomcodespace/codeiq/parity
    in the rest of the codebase.
  * `CGO_ENABLED=1 go build ./...` clean.
  * `CGO_ENABLED=1 go test ./... -count=1` clean (one fewer package).

References to "parity" that are NOT the harness are preserved:
  * MCP consolidated-tool parity tests (different concept — covers
    arg-name mapping between consolidated modes and their narrow
    handlers).
  * The "Java H2 parity" reserved-word workaround note in the cache
    schema doc — it's about byte-for-byte parity-dump compatibility,
    not the harness.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@aksOps aksOps merged commit 08ddadc into main May 14, 2026
13 checks passed
@aksOps aksOps deleted the chore/delete-parity-harness branch May 14, 2026 18:21
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