Skip to content

[codex] Cover stale term parent semantic references#169

Merged
adamziel merged 1 commit into
trunkfrom
codex/term-parent-semantic-validator
May 16, 2026
Merged

[codex] Cover stale term parent semantic references#169
adamziel merged 1 commit into
trunkfrom
codex/term-parent-semantic-validator

Conversation

@adamziel
Copy link
Copy Markdown
Contributor

What it does

Adds a focused WordPress semantic validator regression for hierarchical taxonomy parent references. The fixture covers a source branch deleting a parent category while the target edits the child term and child taxonomy row that still point at that parent.

Rationale

wp_term_taxonomy.parent stores a WordPress term relationship, not just a scalar value. A row-level merge can preserve the target child edits and apply the source parent delete, but the resulting taxonomy graph is incoherent unless a semantic validator reports the stale parent reference for review.

Implementation

The new discovered validator scans wp_term_taxonomy rows with parent > 0, verifies that the parent term still has taxonomy for the same taxonomy name, and emits plugin-wp-term-parent-missing-reference findings. The test asserts that the source parent term/taxonomy deletion remains staged, target child edits remain visible, and plugin audit output identifies the missing parent term, child taxonomy row, and stale parent field.

The merge reliability matrix now records term-parent reference coverage alongside existing term relationship coverage.

Testing instructions

php -l tests/cow/wp_semantic_validator.php
make test-cow-wp-semantic-validator
make test-cow-semantic-fast
npm run check
git diff --check

@adamziel adamziel merged commit f60bbcc into trunk May 16, 2026
5 checks passed
@adamziel adamziel deleted the codex/term-parent-semantic-validator branch May 16, 2026 13:46
@adamziel adamziel mentioned this pull request May 16, 2026
adamziel added a commit that referenced this pull request May 16, 2026
## Release `v0.1.22`

Version bump and release metadata update for `v0.1.22`.

**Changelog draft:**
* Document v0.1.21 release gate evidence
([#162](#162))
* Cover taxonomy menu reference validation
([#163](#163))
* Cover navigation block reference validation
([#164](#164))
* Cover media filesize drift validation
([#165](#165))
* Cover generated media filesize drift validation
([#166](#166))
* Cover missing media metadata validation
([#167](#167))
* Cover stale post_parent semantic references
([#168](#168))
* Cover stale term parent semantic references
([#169](#169))
* Cover stale post author semantic references
([#170](#170))
* Cover stale menu parent semantic references
([#171](#171))
* Cover stale usermeta semantic references
([#172](#172))
* Cover stale postmeta semantic references
([#173](#173))
* Cover stale termmeta semantic references
([#174](#174))
* Cover stale term taxonomy semantic references
([#175](#175))

**Full changelog:**
v0.1.21...release/v0.1.22

## Next steps

1. **Review** the changes in this pull request.
2. **Push** any additional edits to this branch (`release/v0.1.22`).
3. **Merge** this pull request to publish `v0.1.22`.

Merging will automatically build ForkPress binaries, create a GitHub
release, and update the Homebrew formula.
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