Skip to content

corpus: duplicate invariant entries for operator doctrine with conflicting quotes #635

Description

@ahuimanu

Observed

When attempting to recompose AGENTS.md renditions with gz content compose AGENTS.md --consumer claude, the command fails with invariant-floor violations. Multiple corpus entries for the same operator directive cannot coexist as invariant-tier entries with different quote styles.

Exit code 1 output:

Error: Invariant-floor violation: entry 'corpus-prime-directive-ownership-2026-06-13T12:34:39.169495+00:00' text not found verbatim in rendered text. Invariant-tier entries MUST appear unchanged at every setpoint.

Expected

Corpus append-only mechanism should prevent conflicting duplicate entries, OR old entries should be marked withdrawn, OR composition should handle superseded entries gracefully.

Canonical contradiction

Corpus entries marked tier: invariant must ALL appear verbatim in every rendition (ADR-0.0.37 rendition-floor-coherence rule). The corpus currently contains TWO invariant-tier entries for the same "Correction vs enhancement" directive with different quote styles, which makes the invariant rule unsatisfiable — only ONE version can appear in the rendition.

Class of failure

Duplicate corpus entries with different formatting for operator-verbatim canonical directives. The corpus append-only semantics do not prevent creating superseded/conflicting entries with the same textual content but different formatting. When both are marked invariant-tier, recomposition becomes impossible.

Evidence: Conflicting corpus entries

Entry 1 (older, 2026-06-13, with double quotes):

  • ID: corpus-prime-directive-ownership-2026-06-13T12:34:39.169495+00:00
  • Tier: invariant
  • Text: Correction vs enhancement (operator doctrine, verbatim): "discovering that more is needed to fulfill the intent of a feature is not an enhancement, it is a correction."...

Entry 2 (newer, 2026-06-19, with single quotes):

  • ID: corpus-operator-doctrine-verbatim-canon-2026-06-19T22:54:45.960384+00:00
  • Tier: invariant
  • Text: Correction vs enhancement (operator doctrine, verbatim): 'discovering that more is needed to fulfill the intent of a feature is not an enhancement, it is a correction.'...

The newer entry is the canonical version (single quotes), the older should be withdrawn or marked as superseded.

Scope hint (advisory, for routing)

  • Diff size: Likely small (corpus entry metadata fix)
  • Surfaces touched: .gzkit/corpus/AGENTS.md.jsonl, src/gzkit/ composition logic
  • In-flight vs. new feature: in-flight (blocking git-sync after corpus enrichment session 2026-06-19/20)

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    defectTracked defect discovered during implementation or governance worktech-debtQuality-of-implementation defect surfaced by gz-tech-debt-review or operator review

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions