Skip to content

Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check.

merge main: keep the example in the README, the case histories in the rules index

FABIOTESS061bc1d5d68d
diff --cc docs/decisions/README.md
index 846d50a2,00000000..dcdac3f9
mode 100644,000000..100644
--- a/docs/decisions/README.md
+++ b/docs/decisions/README.md
@@@ -1,44 -1,0 +1,50 @@@
+# The rules, and what they have caught
+
+One file per rule. Each names the failure it exists to prevent, because a rule whose cost is visible
+and whose benefit is not gets dropped the first time it is inconvenient.
+
+| | Rule | The failure it prevents |
+| --- | --- | --- |
+| [0001](0001-an-inference-is-not-an-assertion.md) | An inference is not an assertion | A materialised conclusion becoming the next run's premise, so the engine cites itself |
+| [0002](0002-an-inference-carries-a-certificate.md) | An inference carries a certificate, and the certificate has a proof | Trusting the engine's report of its own work |
+| [0003](0003-a-rule-is-data-and-an-assumption-is-not-a-fact.md) | A rule is data, and an assumption is not a fact | A user-supplied rule table earning the word reserved for the checked one |
+| [0005](0005-a-prover-is-an-oracle-and-a-translation-is-a-theorem.md) | A prover is an oracle, and a translation is a theorem | Reading a theorem prover's confident answer as evidence |
+| [0006](0006-a-model-is-a-certificate-and-a-refutation-is-not.md) | A model is a certificate, and a refutation is not | Treating an exhausted bounded search as unsatisfiability |
+| [0007](0007-a-slice-preserves-a-conclusion-or-it-does-not.md) | A slice preserves a conclusion, or it does not | A retrieval slice quietly dropping the conclusion it was asked about |
+| [0008](0008-a-binding-is-data-and-evidence-admits-one-reading.md) | A binding is data, and evidence admits one reading | A certificate format admitting two readings, so two checkers disagree |
+
+There is no 0004. The decision now numbered 0006 was drafted as 0004 on a branch that never merged,
+so the number never reached `main`. It is left as a hole rather than reused, because a reused number
+makes an old citation silently come to mean something else.
+
+## What this discipline has caught
+
+In one week of running it against this engine.
+
+**Five description-logic false cleans.** Each an inconsistent ontology reported consistent, with full
+confidence.
+
+**A rule that could conclude a triple no serialiser can write**, reachable from ordinary OWL, which
+left the store non-deterministic: three runs of one input kept 40, 9 and 24 inferences.
+
+**Two independently verified kernels disagreeing on the same certificates**, always in the safe
+direction, tracing to a gap in the format that neither proof could see. It did not say what a
+repeated binding key meant, so one kernel refused the shape and the other answered from whatever its
+lookup happened to do. The sharper fact came out of the second implementation rather than the first:
+a key bound twice to different values is satisfied by no substitution at all, so there were never two
+readings, only two ways of discarding half the certificate. Closed by
- [decision 0008](0008-a-binding-is-data-and-evidence-admits-one-reading.md), and the differential now
- reports zero divergent rows over a corpus four times deeper in the property its induction rests on.
++[decision 0008](0008-a-binding-is-data-and-evidence-admits-one-reading.md), and the two kernels now
++return the same answer on every row of a corpus of 2,075 certificates, 484 of which exercise the
++ordering property both inductions rest on, against 123 before that corpus was deepened.
++
++That agreement was, until 15 September 2026, checked by nothing. No workflow installed the second
++kernel, so the test requiring zero divergence skipped, and a skipped test reports `ok`. CI runs both
++kernels over the whole corpus on every pull request now, and [docs/ci-gates.md](../ci-gates.md) is
++the table of which other gates do and do not fire.
+
+Every one of those had passed every test that existed before.
+
+A single formalisation, however careful, cannot see a defect in the format it formalises. That is the
+argument for the second kernel, and it is the only argument for it that survived contact with the
+work: two proof assistants agreeing does not mean what a casual reader assumes, and the value came
+from independence of the specification reading rather than from quantity.