Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/workflows/actions.lock
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ workflows:
'.github/workflows/slice.yml':
- 'actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1'
- 'actions/checkout@v7.0.1'
- 'dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec'
- 'dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8'
'.github/workflows/sonarqube.yml':
- 'actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1'
- 'actions/checkout@v7.0.1'
Expand Down Expand Up @@ -169,9 +169,9 @@ dependencies:
commit: 'sha1-25dd0e34f4fe68f24cc83900b1fe3fe149efef98'
owner_id: 27347476
repo_id: 371068214
'dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec':
ref: 'stable'
commit: 'sha1-b725eda525362e7cf34af9a7243cac1e3f01a7ec'
'dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8':
ref: 'master'
commit: 'sha1-683b588c487a69d01f6c6ddf40f036ff682cc2c8'
owner_id: 1940490
repo_id: 260749683
'editorconfig-checker/action-editorconfig-checker@51f63319f592f97930c73d9c46184d20bd206393':
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/hypatia-scan.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,4 +27,4 @@ permissions:

jobs:
scan:
uses: metadatastician/standards/.github/workflows/hypatia-scan-reusable.yml@7641c7fdb01420696b5420ab85d88f599f32f609
uses: metadatastician/standards/.github/workflows/hypatia-scan-reusable.yml@58362c24cf225694b388fc660b3525d8207b7c61
34 changes: 31 additions & 3 deletions .github/workflows/slice.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,14 @@ jobs:
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
repository: hyperpolymath/trope-checker
# One checker commit across the stack: haec and vocarium pin the same
# one. Until 2026-11-17 this step tracked the default branch.
ref: 0dceab68459d46b2cda22137c261023223c30e9a # main @ 2026-11-16
path: .trope-checker
persist-credentials: false

- name: Install Rust
uses: dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec # stable
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master 2026-08-04 (v1)
with:
toolchain: stable
components: rustfmt, clippy
Expand All @@ -52,14 +55,39 @@ jobs:
TC="$GITHUB_WORKSPACE/.trope-checker/src/rust/target/release/tropecheck-rs"
fail=0
# Every fixture must produce the verdict cases.json declares.
# Until 2026-11-17 this loop failed only on exit 2 or more, so a
# checker that answered p-sufficient where cases.json says
# p-insufficient passed. Exit 0 is p-sufficient and exit 1 is
# p-insufficient; anything else is a fault. A fixture with no
# expectation fails, and so does an empty corpus.
n=0
for ir in fixtures/*.ir.json; do
[ -e "$ir" ] || continue
n=$((n+1))
name=$(basename "$ir")
expect=$(jq -r --arg ir "$name" '.cases[] | select(.ir == $ir) | .expect' cases.json)
if [ -z "$expect" ]; then
echo "::error::$name has no expected verdict in cases.json"
fail=1
continue
fi
set +e; "$TC" "$ir" >/dev/null 2>&1; code=$?; set -e
if [ "$code" -ge 2 ]; then
echo "::error::$ir produced exit $code (validation/io fault)"
case "$code" in
0) got=p-sufficient ;;
1) got=p-insufficient ;;
*) got=fault ;;
esac
if [ "$got" != "$expect" ]; then
echo "::error::$name: the checker gave $got (exit $code), cases.json expects $expect"
fail=1
fi
done
if [ "$n" -eq 0 ]; then
echo "::error::no conformance fixture found: nothing was checked"
fail=1
fi
[ "$fail" -eq 0 ] || exit 1
echo "conformance corpus: $n fixtures, each gave the verdict cases.json declares"

- name: Format
run: cargo fmt --all -- --check
Expand Down
7 changes: 4 additions & 3 deletions ARCHITECTURE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,9 @@ Chain: `+Vocarium (store) → Hermeneia (voke)+`, and

=== The central rule

*Hermeneia does not implement the grade algebra.* That algebra is proved
in Idris2 inside `+trope-checker+`; a second implementation here would
*Hermeneia does not implement the grade algebra.* That algebra lives in
`+trope-checker+`, whose graded proof record is Agda; its Idris2 code is an
engineering restatement outside the grade ladder. A second implementation here would
fork the exact semantics the design exists to protect. Hermeneia emits
Trope IR v0.2 and reads back a verdict.

Expand Down Expand Up @@ -83,7 +84,7 @@ docs/SPEC.adoc the applied binding and integration contract

=== The store seam

Vocarium does not exist yet, so hermeneia ships a JSONL stub behind a
The adapter to Vocarium (its M2) does not exist yet, so hermeneia ships a JSONL stub behind a
narrow trait (`+StoreProvider+`) with the README’s own worked example as
the seed corpus. Vocarium substitutes in without the planner changing.
The trait is specified in link:docs/SPEC.adoc[`+docs/SPEC.adoc+`].
Expand Down
22 changes: 22 additions & 0 deletions CHANGELOG.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,28 @@ https://semver.org/spec/v2.0.0.html[Semantic Versioning].

==== Fixed

* *Three more places said Vocarium does not exist (2026-11-17).* What does not
exist is the adapter to it (Vocarium's M2). `+ARCHITECTURE.adoc+` and
`+docs/SPEC.adoc+` (two places) now say the adapter is missing, and the header
of `+src/hermeneia-store/src/lib.rs+` adds that Vocarium's store engine is
built and gated in its own repository. The same sentence in
`+.machine_readable/+` is the owner's (#88).
* *Two documents credited the grade algebra's proof to Idris2 (2026-11-17).*
`+docs/SPEC.adoc+` and `+ARCHITECTURE.adoc+` now say what
`+docs/status/STATE-OF-PLAY.adoc+` says: the graded proof record is Agda, and
the Idris2 code is an engineering restatement outside the grade ladder.
* *The conformance step did not compare verdicts (2026-11-17).* It failed only
when the checker exited 2 or more, so a wrong verdict passed. It now reads each
fixture's expected verdict from `+cases.json+` and fails on a mismatch, on a
fixture with no expectation, and on an empty corpus.
* *The slice workflow tracked trope-checker's default branch (2026-11-17).* It
now pins the commit haec and vocarium pin, `+0dceab6+`. Between the siblings'
previous pin and that commit, trope-checker's `+src/+`, `+schemas/+`, `+spec/+`
and conformance fixtures are unchanged.
* *The scan workflow pin installed an Erlang version that crashes the scanner
on some trees (2026-11-17).* It moves to the revision trope-checker uses, which
installs OTP 27.3.4.19 (hypatia#1061).

* *`+docs/status/PROOF-STATUS.adoc+` published a percentage, which PROOF-POLICY
forbids (2026-11-09).* The summary read `+*Overall*: 0% proven+`. §8.4 rule 7 is
explicit — "Never publish 'X% proved', an average grade, or a single confidence
Expand Down
17 changes: 11 additions & 6 deletions docs/SPEC.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -136,8 +136,11 @@ and the verdict is the single comparison `floor ⊑ acc(output)`.
====
*Hermeneia must not reimplement the grade algebra.*

The algebra is proved in Idris2 (with Lean and Agda artefacts alongside) inside
`trope-checker`. A fresh Rust reimplementation would fork the exact semantics
The algebra lives inside `trope-checker`, whose graded proof record is Agda,
with Lean developments alongside. Its Idris2 code is an engineering restatement
that PROOF-POLICY §8.1 keeps off the grade ladder
(link:status/STATE-OF-PLAY.adoc[`status/STATE-OF-PLAY.adoc`] has the detail). A
fresh Rust reimplementation would fork the exact semantics
the whole design exists to protect, and no test suite would reliably catch the
drift. This is ruled out permanently, not deferred.
====
Expand Down Expand Up @@ -225,9 +228,11 @@ state. `trope-checker` owns the grade algebra and nothing else.

== The store seam

No trope corpus exists anywhere yet — `vocarium` is scaffolding, as is `haec`.
Hermeneia therefore ships its own store behind a narrow trait, so that Vocarium
can be substituted without the planner changing.
Vocarium's store engine exists in its own repository, but the adapter that
would let Hermeneia drive it (Vocarium's M2) does not, and `haec` has no
compiler yet. Hermeneia therefore ships its own store, with a seed corpus,
behind a narrow trait, so that the adapter can be substituted without the
planner changing.

[source,rust]
----
Expand Down Expand Up @@ -341,7 +346,7 @@ Other surfaces:
* `show loss` — *refused*, not implemented. The checker CLI does not emit the
per-dimension vector, and fabricating one would be dishonest.
* `show warrant` / `show failure_points` — refused; they need the warrant graph.
* Nothing is Integrated. Vocarium does not exist yet; every result above is
* Nothing is Integrated. The adapter to Vocarium (its M2) does not exist yet; every result above is
against the JSONL stub and its seed corpus.

== Open questions
Expand Down
20 changes: 14 additions & 6 deletions docs/status/STATE-OF-PLAY.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
:toclevels: 2
:sectnums:

*As at:* 2026-07-29
*As at:* 2026-07-29 (two lines corrected 2026-11-16; see below)

[abstract]
What is actually built, what is deliberately not, and what is known to be
Expand Down Expand Up @@ -68,8 +68,10 @@ workflow.
| `revoke` | recognised, reports unimplemented | no | the refusal is tested | no
|===

*Nothing is Integrated.* Vocarium does not exist; every result above is against
the in-repo JSONL stub and its seed corpus.
*Nothing is Integrated.* Hermeneia does not depend on Vocarium: the repository
exists (`hyperpolymath/vocarium`) but is not yet usable as this store, so every
result above is against the in-repo JSONL stub and its seed corpus. (Corrected
2026-11-16; this line used to say Vocarium does not exist.)

Output surfaces:

Expand All @@ -96,9 +98,15 @@ fails if it regresses:

== Architecture in one rule

*Hermeneia does not implement the grade algebra.* It is proved in Idris2 inside
`trope-checker`; a second implementation here would fork the exact semantics the
design exists to protect. Hermeneia emits Trope IR v0.2 and delegates verdicts.
*Hermeneia does not implement the grade algebra.* It lives in
`trope-checker`, whose graded proof record is Agda. Most of its obligations are
graded `PWG-3` on the Agda leg alone; some have no gradeable theory leg yet
and are ungraded. Lean statements exist for many
results but do not count toward the grade (they are bridge-pending), and the
Idris2 code is an engineering restatement that PROOF-POLICY §8.1 keeps off the
ladder. trope-checker's `docs/status/PROOF-STATUS.adoc` gives the per-result
record. (Corrected 2026-11-16; this line used to credit Idris2 alone.) A second
implementation here would fork the exact semantics the design exists to protect. Hermeneia emits Trope IR v0.2 and delegates verdicts.

It is not a wrapper, though: only three of seven operations need a verdict at
all (`invoke`, `provoke`, `intervoke`). The rest are store traversal, path
Expand Down
14 changes: 6 additions & 8 deletions src/hermeneia-cli/tests/slice.rs
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,12 @@ fn checker() -> PathBuf {
}

fn hermeneia() -> PathBuf {
// The integration test binary lives in target/<profile>/deps/; the CLI is
// two levels up.
let mut p = std::env::current_exe().expect("test exe path");
p.pop();
if p.ends_with("deps") {
p.pop();
}
p.join("hermeneia")
// Cargo builds the `hermeneia` binary for this integration test and tells
// us where it put it. The earlier form walked up from the test executable,
// assuming target/<profile>/deps/. Newer cargo puts test executables under
// target/<profile>/build/<pkg>/<hash>/out/, so that guess pointed at a file
// that does not exist and every test here failed to spawn.
PathBuf::from(env!("CARGO_BIN_EXE_hermeneia"))
}

struct Run {
Expand Down
8 changes: 5 additions & 3 deletions src/hermeneia-store/src/lib.rs
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,11 @@
//
// The store seam.
//
// Vocarium does not exist yet. Hermeneia therefore ships its own JSONL store
// behind a narrow trait so that Vocarium can be substituted without the planner
// changing. See docs/SPEC.adoc §"The store seam".
// The adapter to Vocarium (its M2) does not exist yet. Vocarium itself does: its
// store engine `voc` is built and gated in its own repository. Hermeneia
// therefore ships its own JSONL store behind a narrow trait, so that the adapter
// can be substituted without the planner changing. See docs/SPEC.adoc
// §"The store seam".
//
// Note which side of the seam the grade algebra falls on: `neighbours` takes a
// bound in the retention order, so any implementation that supports it owns the
Expand Down
Loading