# What does this project link say?

A focused Solway relationship-reading exercise at `apps/project-relationship-reader/`. It complements the larger `apps/website/projects/solway-tunnel/` graph rather than duplicating its data or promising synchronization.

## Source and preservation

Refactored from [Gimmer App21](https://github.com/lawrencerowland/gimmer-crag/blob/17bc405d5f14174bfa9f473c6d200d5d675269d4/apps/gimmer-crag-shed-ontology-explorer/index.html), `apps/gimmer-crag-shed-ontology-explorer/index.html`, retained source revision `17bc405d5f14174bfa9f473c6d200d5d675269d4`. Original source SHA-256: `0d8f9629a297e0068a23c4abfe9d57101c0ef74f79f863760c816c0534a96e47`. The exact HTML is saved at `provenance/gimmer-app21-original.html` for source archaeology; the publication list excludes it.

Retained mechanisms: graph/Turtle views; selected-item description, incoming/outgoing relationships and subject snippets; fit and re-layout; drag, pan and zoom. The source's small force-layout idea continues in the native SVG graph. The new item menu and focusable nodes add keyboard access; pointer events add touch/pen dragging. Graph positions and selection survive a view switch.

The old mountain dataset is preserved in the exact source, not relabelled as a tunnel. The new fictional service-bay model separates two fans, their assembly, planned work, shared temporary means, an agent, a criterion and intended information. Local example terms replace unverified claims about third-party vocabulary. No mountain emergency advice, dimensional engineering values, completion, approval or acceptance claim is carried into the new scenario.

## Source of truth and checks

`scenario.ttl` is authoritative. Run `node apps/project-relationship-reader/compile.mjs` after changing it, or append `--check` to verify that `data.js` is current. N3 parses all statements and writes complete subject snippets. The browser uses that checked projection and does not contain a partial Turtle parser. Different predicates between the same two entities remain different relationships.

Run `node --test tests/project-relationship-reader.cjs`. Tests independently parse the Turtle with N3, compare the complete graph and snippets, verify the preserved source hash, exercise view state, keyboard selection, relation navigation, layout, fit, zoom, pointer dragging and fallback, and check relative local links. These checks establish model/display correspondence and browser behavior, not engineering validity or user benefit.

`method.html` is the readable companion. It states the local vocabulary, projection boundary and limitations. `scripts/build-all.js` publishes an explicit list of app files; compiler, tests and historical source stay in Git.
