docs(law): ADR-018 generator declarations law (flext-0in0k.1) - #256
Merged
Merged
Conversation
…ext-0in0k.1) Operator law 2026-09-20: generators emit only what is declared. Fourteen points (letter owner = declaring module; init propagates; tiers detected and inherited by MRO; derive over list; one nested class; hack permissions die with the hack; exceptions only by explicit operator authorization; strict compliance as the dedup mechanism). Rule owner: ~/agents/rules/flext/generator-declarations.md. Phased under epic flext-0in0k (20 beads); supersedes flext-exbwv, flext-crd1y, flext-b3xmn, flext-szjre, flext-fdoah, flext-s9bxq. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S2Sdb2nKZBjqJk3sxqAgET
…s (red base adopted) conflict-markers gate on PR #256 fails on the base itself: docs/projects/ flext-target-oracle-oic.md, docs/projects/flext-target-oracle-wms.md and docs/scripts/gate-contract.md carry `<<<<<<< Updated upstream` / `>>>>>>> Stashed changes` markers committed by d2b10ae and carried by caf8f86 (gate-contract.md was additionally reflowed by the formatter). Resolved from code reality: oic target.py holds FlextTargetOracleOicBaseSink + per-stream sinks; wms client.py holds CatalogManager/StreamProcessor/Target and helpers.py WMSTableManager + transformers; the gate-contract flag tables are rebuilt once each. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S2Sdb2nKZBjqJk3sxqAgET
marlon-costa-dc
marked this pull request as ready for review
September 21, 2026 01:11
…olumn markdown limit (rumdl MD013) Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S2Sdb2nKZBjqJk3sxqAgET
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ADR-018 — Generator Declarations Law (flext-0in0k.1)
Operator law 2026-09-20, negotiated point by point: FLEXT generators emit only what is declared — nothing inferred, listed by hand, or accommodated.
docs/architecture/adr/018-generator-declarations.md— decision, context (the hacks and the fleetgenbreaka43dcf547), consequences, verification contractdocs/architecture/adr/README.md— index entry.agents/skills/flext-law/SKILL.md— routing bullet to the rule owner~/agents/rules/flext/generator-declarations.md(agents PR opened separately)Epic
flext-0in0kcarries the 20 phased beads; each later phase is its own session and lane. Docs-only; the docs gate runs in CI for this lane.🤖 Generated with Claude Code
https://claude.ai/code/session_01S2Sdb2nKZBjqJk3sxqAgET
Summary by cubic
Adds ADR-018, establishing that FLEXT generators emit only what is declared — nothing inferred, listed by hand, or accommodated. The law supersedes the filename→letter tables, closed folder lists, and advisory-gate lists whose undeclared export discovery broke the fleet
make genon 2026-09-20. Also resolves the stash conflict markers committed intodocs/projects/flext-target-oracle-oic.md,docs/projects/flext-target-oracle-wms.md, anddocs/scripts/gate-contract.md, which failed the conflict-markers gate.Details
flext-0in0k(20 bead phases).Written for commit 83631fd. Summary will update on new commits.