Skip to content

fix: make main authoritative for HyperMeow - #35

Merged
purpshell merged 5 commits into
mainfrom
codex/docs-v0.1.0
Aug 11, 2026
Merged

fix: make main authoritative for HyperMeow#35
purpshell merged 5 commits into
mainfrom
codex/docs-v0.1.0

Conversation

@purpshell

@purpshell purpshell commented Aug 10, 2026

Copy link
Copy Markdown
Member

Summary

  • add a public changelog and evidence-linked README comparison with upstream WhatsMeow
  • remove the long module/package and duplicate-descriptor explanation from the README
  • retract accidental v0.1.0 and the required v0.1.1 retraction carrier
  • use @main for the newest reviewed pseudo-version; v0.0.0 remains the only selectable tag
  • keep dev as an integration branch that never publishes or indexes versions
  • consolidate all handwritten business-app features into business.go
  • move retained benchmark evidence into benchmark/barback/testdata/results
  • consolidate 30 root white-box test files into five themed files, retaining the external suite
  • preserve MPL-2.0 for upstream-derived content and license Polymorfa-authored files under Rajeh Taher MIT

Licensing boundary

  • files and source content inherited from tulir/whatsmeow history retain MPL-2.0
  • Polymorfa modifications inside inherited files remain MPL-2.0
  • all 43 Go files authored by Polymorfa carry the Rajeh Taher MIT header
  • every other commentable Polymorfa-authored file carries the same MIT notice
  • Docker syntax directives remain first, followed immediately by the MIT notice
  • generated, benchmark-data, and other non-commentable Polymorfa artifacts are covered by LICENSE-MIT and LICENSING.md
  • consolidated upstream-derived business.go retains Tulir Asokan copyright and MPL-2.0

Version correction

Go proxies cannot discover an untagged pseudo-version through @latest when every tagged version is retracted. After this PR is approved and merge-committed to main, create v0.1.1 on this exact reviewed PR head as the self-retracted correction carrier and create v0.0.0 on the reviewed main merge commit as the only selectable tag. Do not create a GitHub Release. @latest then resolves v0.0.0; @main resolves the newest reviewed main commit to its pseudo-version.

Preservation proofs

  • repository-wide Test/Benchmark/Fuzz/Example declaration inventory hash matches main
  • covered statements and total statements exactly match main (2,288 / 40,324)
  • exported Go documentation hash is unchanged by the business source consolidation
  • root test-file count is reduced from 31 to 6 without removing test behavior

Verification

  • pre-commit run --all-files
  • generated MEX check
  • go build ./...
  • go test ./...
  • go test -race ./...
  • coverage totals comparison
  • Barback default, benchmark_legacy, and race suites
  • shell syntax and Markdown local-link checks
  • Docker BuildKit checks for both benchmark Dockerfiles
  • full-history author, blob-lineage, and license-provenance audit

Merge policy

Draft until exact-head review is clean. Do not bypass the main ruleset. After required human approval and a merge commit, create only the v0.0.0 selectable tag and self-retracted v0.1.1 carrier described above, verify proxy resolution, then fast-forward dev to authoritative main.

@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head a10a208. Please verify that the test consolidation preserves every test and coverage, that moved benchmark links remain valid, and that the public README/changelog claims are supported by the retained evidence.

@purpshell
purpshell marked this pull request as draft August 10, 2026 23:43
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. What shall we delve into next?

Reviewed commit: a10a20802d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@purpshell purpshell changed the title docs: publish HyperMeow release guide fix: make main authoritative for HyperMeow Aug 10, 2026
@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head f646ee794e5614e3af70fecba54d6ee0f21f4e77. Verify the self-retraction strategy, main-only pseudo-version policy, README cleanup, unchanged test inventory/coverage, and benchmark artifact moves. Ignore prior-head verdicts.

@purpshell

Copy link
Copy Markdown
Member Author

Correction: review exact current head f646ee7. The prior comment mistyped the expansion; ignore it.

@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact current head f646ee7. Verify the retraction strategy, main-only pseudo-version policy, README cleanup, unchanged tests and coverage, and artifact moves. Ignore earlier SHA text.

@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact current head fc82e26. Verify retractions and main-only publication, the single business.go consolidation, unchanged exported API/tests/coverage totals, README cleanup, and artifact moves. Ignore prior-head verdicts.

@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact current head 09c6eb2. Final README footer now follows Polymorfa Cellar's support/sponsor/disclaimer structure, credits Tulir Asokan and Rajeh Taher, and removes repository-layout sections. Also verify prior retraction, business.go consolidation, API/test/coverage preservation, and artifact moves. Ignore prior heads.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 09c6eb29a9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread go.mod Outdated
@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head 9d9623c. Please audit the file-level license boundary: upstream/Tulir-derived files remain MPL-2.0; Polymorfa-added files use the Rajeh Taher MIT header and LICENSE-MIT. Also verify generated bindings, SQL migration parsing, retained tests, and README licensing claims.

@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head d5611d1. Ignore prior heads. Audit the corrected full-history licensing boundary: inherited upstream files remain MPL-2.0, including removed historical util/cbcutil/cbc_test.go; 42 Polymorfa-authored Go files and other commentable Polymorfa files use the Rajeh Taher MIT header. Verify LICENSE-MIT, LICENSING.md, generated bindings, SQL migrations, retained tests, and README claims.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d5611d1eac

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread LICENSING.md
Comment thread README.md Outdated
@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head 4f93059. Ignore every prior head. Verify the resolved findings: both benchmark Dockerfiles now carry Rajeh Taher MIT notices after their syntax directives; README preserves upstream file-level copyright years; installation uses @main; v0.0.0 is the sole planned selectable tag while v0.1.0/v0.1.1 remain retracted. Re-audit the complete MPL/MIT boundary and preservation proofs.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4f930592bf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread util/cbcutil/cbc_test.go Outdated
@purpshell

Copy link
Copy Markdown
Member Author

@codex review exact head 5bb05b3. Ignore prior heads. Re-audit the complete content-lineage MPL/MIT boundary. In particular, util/cbcutil/cbc_test.go is Rajeh-authored MIT: be55f11 introduced entirely new short-write tests after an unrelated upstream encrypt/decrypt test at that path had been deleted. Verify all prior versioning, Docker, README attribution, preservation, and licensing fixes remain correct.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 👍

Reviewed commit: 5bb05b3882

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@purpshell
purpshell marked this pull request as ready for review August 11, 2026 00:39

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5bb05b3882

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md
Comment on lines +67 to +69
go mod edit -dropreplace=go.mau.fi/whatsmeow
go get github.com/polymorfa/hypermeow@main
go mod tidy

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Verify the upstream module is absent after migration

When a transitive dependency still imports go.mau.fi/whatsmeow, these commands leave that module in the graph, so the resulting binary links both generated protobuf packages and panics during initialization when they register identical descriptor paths. The compatibility note in CHANGELOG.md lines 82–83 confirms that the modules cannot coexist; retain a graph check such as the previously documented go list -deps -test/go mod why -m step instead of presenting go mod tidy as a complete migration.

Useful? React with 👍 / 👎.

@purpshell
purpshell merged commit 930d77b into main Aug 11, 2026
5 checks passed
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