Skip to content

docs(derived-contract): binding claims hash the rows their action selects (F13) - #148

Open
djessyczaplicki-genomcore wants to merge 3 commits into
release/2026-11-19from
docs/binding-claims-hash-rows
Open

djessyczaplicki-genomcore wants to merge 3 commits into
release/2026-11-19from
docs/binding-claims-hash-rows

Conversation

@djessyczaplicki-genomcore

@djessyczaplicki-genomcore djessyczaplicki-genomcore commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Updates _references/derived-contract.md § Binding claims to describe what the Factory derives from Genomcore/inspire-factory#204 (INSPIRE F13, FB2-small-change-scope). Each binding claim now hashes only the ## Bindings rows its action selects: the route rows of its verb (or * / * with id), the plural row of its entity (or *) and its guard rows, plus its input names and roles. The prose and links of the section are never hashed, so rewording it moves no fingerprint.

The section also says what a moved binding fingerprint now costs on the Factory side:

  • it is not a rebuild: the Factory first checks whether the test that cites the claim still proves it, and changes code only when it does not;
  • when an action's binding/route moves, the built screens that call that action check their calls too;
  • each Factory run re-stamps, before it plans and with no agent, the old whole-section fingerprints whose selected rows did not change.

This is documentation only; no claim hashes derived-contract.md.

The sentence in inspire-code-nestjs/SKILL.md ("editing this section moves every action's binding fingerprints") stays as it is, on purpose. It sits inside ## Bindings, and the published Factory 0.22.1 still hashes that whole section, so editing it would cause F13 again for anyone who upgrades INSPIRE before the Factory. It can go once every project runs a Factory with #204.

Release notes: needs a Factory with Genomcore/inspire-factory#204. Nothing to run after upgrading: the Factory re-stamps the old citations itself.

Tests: bash plugin/test/run.sh — 113/0 files, 2188/0/1 assertions, after merging release/2026-11-19.

🤖 Generated with Claude Code

…ects

The Factory's binding claims no longer hash the whole ## Bindings text: each
hashes the route, plural and guard rows its action selects, so rewording the
section moves no fingerprint. The reference states the selection.
@github-actions
github-actions Bot changed the base branch from release/2026-11-18 to release/2026-11-19 November 19, 2026 09:09
@github-actions

Copy link
Copy Markdown
Contributor

Reapuntada de release/2026-11-18 a release/2026-11-19, la release abierta. A main solo se llega desde release/, hotfix/ o docs/.

…, and the run re-stamps the old ones

Follows Genomcore/inspire-factory#204: a stale claim is checked against its citing test
before any code changes, screens that call an action whose route moved check their calls,
and each Factory run re-stamps the whole-section fingerprints whose rows did not change.

This branch has not been deployed

No deployments
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