[ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/Head", "@graph": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA", "http://www.nanopub.org/nschema#hasAssertion": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/assertion" } ], "http://www.nanopub.org/nschema#hasProvenance": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/provenance" } ], "http://www.nanopub.org/nschema#hasPublicationInfo": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/pubinfo" } ], "@type": [ "http://www.nanopub.org/nschema#Nanopublication" ] } ] }, { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/assertion", "@graph": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/get-view-displays-unresolved", "http://purl.org/dc/terms/description": [ { "@value": "Variant of get-view-displays (ref-scoped) that returns view references UNRESOLVED: the ?view column carries the version IRI the display/preset actually references (or, for space-governed pins, the governed resolution), and resolving a referenced version to the current supersedes-head is the CALLER's job (Nanodash: per-view latest-version lookups through ApiCache, forced refresh on own publishes). This removes the former run-once repo-wide resolution sub-select -- the query's dominant and fragility-prone cost, linear in the total view count -- leaving only bound point lookups; see nanopub-query doc/design-view-head-materialization.md for the measurements. Same inputs as get-view-displays-ref-scoped (resource = space IRI, root_np = the ref's root nanopub; authority gate scoped to that ref) and the same columns, plus ?governedBySpace: when bound, the row's ?view is the space-governed resolution (newest member+-signed version of its (kind, space) pair, kind validated as maintained resource; nanodash docs/views-and-presets-as-maintained-resources.md) and the caller must NOT apply supersedes-head resolution on top of it; when unbound, the caller resolves ?view to its latest version. ?viewKind is taken from the referenced version's own dct:isVersionOf (version-stable, hence equal to the head's kind), falling back to ?view itself for kind-less legacy views. Federation footprint (2026-08-20): the query now runs on the repo/full endpoint, so the former SERVICE hops to repo/full (preset branch) and to the ResourceView type repo (view lookups, governed candidates) are plain local patterns; only the two lookups of materialized space state (authority gate, governed-signer validation) remain federated, to repo/spaces. The previous 5-SERVICE layout was the main amplifier of a connection-pool deadlock in the query service's loopback federation (an outer query holds a pooled connection while each SERVICE hop -- one per binding under a nested-loop join -- requests another from the same pool): a thread dump during a production wedge showed all 60 route connections held by result streamers of exactly these hops. Validated byte-for-byte identical to the previous version across resources covering standalone displays, preset assignments, governed views, an agent's own page, and rival space refs. Preset-assignment identity (nanodash issue #607): rows contributed by a preset assignment now also carry ?presetKind, the assigned preset's stable kind (dct:isVersionOf, falling back to the version IRI), so the client can keep only the newest assignment per (preset kind, resource) -- the same identity view displays already have via view kind -- and views that a newer preset version no longer carries drop out with the older assignment. Purely additive: every pre-existing column is unchanged. Performance rewrite (2026-09-25, rows identical across 35 space/root pairs): (1) the authority gate is materialized once as a single row of the allowed key hashes (?authKeys) by a sub-select sharing no variable with the rest of the query, and checked with contains(?authKeys, ?pubkey) after the two branches -- joining the gate's ?pubkey rows directly let rdf4j start the display and preset lookups from the signing keys, i.e. walk every nanopub those keys ever signed; (2) the governed winners of all (kind, space) pairs are computed once as a single '|kind>space>winner|' string and looked up per pin, instead of a winner sub-select (with its SERVICE) joined on ?pinKind/?pinSpace inside an OPTIONAL, which rdf4j re-ran per row." } ], "http://purl.org/dc/terms/license": [ { "@id": "http://www.apache.org/licenses/LICENSE-2.0" } ], "@type": [ "https://w3id.org/kpxl/grlc/grlc-query" ], "http://www.w3.org/2000/01/rdf-schema#label": [ { "@value": "Get view displays (unresolved versions)" } ], "https://w3id.org/kpxl/grlc/endpoint": [ { "@id": "https://w3id.org/np/l/nanopub-query-1.1/repo/full" } ], "https://w3id.org/kpxl/grlc/sparql": [ { "@value": "prefix rdfs: \nprefix dct: \nprefix np: \nprefix npa: \nprefix npx: \nprefix gen: \n\nselect distinct ?display ?view (coalesce(?pinKind, ?view) as ?viewKind) ?governedBySpace ?presetKind\n ?label ?displayType ?displayMode ?np ?pubkey ?date where {\n values ?_resource_multi_iri {}\n # Governed winners of all (kind, space) pairs, computed once as a single row\n # (see the space-governed resolution below).\n {\n select (concat(\"|\", group_concat(concat(str(?wKind), \">\", str(?wSpace), \">\", str(?wLatest)); separator=\"|\"), \"|\") as ?govWinners) where {\n select ?wKind ?wSpace (iri(strafter(max(concat(str(?cDate), \">\", str(?cver))), \">\")) as ?wLatest) where {\n # Candidate versions. The sub-select wrapper is LOAD-BEARING, not stylistic: on\n # rdf4j 6.0.0, bindings produced by raw statement patterns are silently NOT joined\n # into a subsequent SERVICE clause (empirically: identical bindings via VALUES join\n # fine, via bare patterns yield zero rows, and any projecting sub-select restores\n # the join -- reproduced on two instances, 2026-08-20).\n { select ?wKind ?wSpace ?cver ?cpk ?cDate where {\n graph npa:graph {\n ?cnp dct:created ?cDate ; npa:hasValidSignatureForPublicKeyHash ?cpk ; npx:embeds ?cver ; np:hasAssertion ?ca .\n filter not exists { ?ci npx:invalidates ?cnp ; npa:hasValidSignatureForPublicKeyHash ?cpk . }\n }\n graph ?ca { ?cver dct:isVersionOf ?wKind ; gen:governedBy ?wSpace . }\n } }\n service {\n graph npa:graph { npa:hasCurrentSpaceState ?gsg . }\n graph ?gsg {\n ?wKind npa:isMaintainedBy ?wSpace ; npa:hasGoverningSpaceRef ?gref .\n ?gri a gen:RoleInstantiation ; npa:forSpace ?wSpace ; npa:forSpaceRef ?gref ; npa:hasRoleType ?gtier ; npa:forAgent ?gag .\n filter(?gtier = gen:AdminRole || ?gtier = gen:MaintainerRole || ?gtier = gen:MemberRole)\n ?gacct a npa:AccountState ; npa:agent ?gag ; npa:pubkey ?cpk .\n }\n }\n } group by ?wKind ?wSpace\n }\n }\n # Authority gate, materialized ONCE as a single row (?authKeys: the space-separated\n # key hashes allowed to declare displays here) by a sub-select sharing no variable with\n # the rest of the query. Joining the gate's ?pubkey rows directly made rdf4j start the\n # display/preset lookups from the signing keys -- i.e. walk every nanopub those keys\n # ever signed -- instead of from the few displays of this resource. The keys are\n # checked with contains() after the two branches instead.\n {\n select ?authKeys where {\n service {\n select (group_concat(distinct ?pubkey; separator=\" \") as ?authKeys) where {\n values ?_resource_multi_iri {}\n values ?_root_np_multi_iri {}\n graph npa:graph { npa:thisRepo npa:hasCurrentSpaceState ?stateG . }\n graph npa:spacesGraph { ?passedRef npa:rootNanopub ?_root_np_multi_iri . }\n {\n # Authority gate (issue #130 / nanodash#510): a single mandatory hop through the\n # governing space ref, which covers both a maintained resource and a space itself\n # (the reflexive self-edge), keyed on the role tier materialized on the\n # RoleInstantiation since #125. Replaces the old bare-IRI isMaintainedBy? hop and the\n # dead RoleDeclaration maintainer join. Ref variant: the governing ref is pinned to\n # ?passedRef (resolved from root_np), so authority cannot bleed across rival refs\n # claiming the same space IRI.\n graph ?stateG {\n ?_resource_multi_iri npa:hasGoverningSpaceRef ?passedRef .\n ?ri a gen:RoleInstantiation ; npa:forSpaceRef ?passedRef ; npa:hasRoleType ?roleType ; npa:forAgent ?authAgent .\n filter(?roleType = gen:AdminRole || ?roleType = gen:MaintainerRole)\n ?authAcct a npa:AccountState ; npa:agent ?authAgent ; npa:pubkey ?pubkey .\n }\n } union {\n graph ?stateG { ?selfAcct a npa:AccountState ; npa:agent ?_resource_multi_iri ; npa:pubkey ?pubkey . }\n }\n }\n }\n }\n }\n {\n # branch (a): standalone view displays — LOCAL pattern on the endpoint repo\n graph npa:graph {\n ?np npx:hasNanopubType gen:ViewDisplay .\n ?np npa:hasValidSignatureForPublicKeyHash ?pubkey .\n filter not exists { ?npx npx:invalidates ?np ; npa:hasValidSignatureForPublicKeyHash ?pubkey . }\n ?np dct:created ?date .\n ?np npx:embeds ?display .\n ?np np:hasAssertion ?a .\n optional { ?np rdfs:label ?label }\n }\n graph ?a {\n ?display gen:isDisplayOfView ?refView .\n ?display gen:isDisplayFor ?_resource_multi_iri .\n optional { values ?displayType { gen:PartLevelViewDisplay gen:TopLevelViewDisplay } ?display a ?displayType . }\n optional { values ?displayMode { gen:ActivatedViewDisplay gen:DeactivatedViewDisplay } ?display a ?displayMode . }\n }\n }\n union\n {\n # branch (b): preset-supplied views — LOCAL since the endpoint moved to\n # repo/full (the connection-pinning SERVICE hop this replaced was the main\n # amplifier of the federation deadlock, eclipse-rdf4j/rdf4j federation +\n # nanopub-query loopback route). Kept wrapped in a sub-SELECT so its\n # bindings cannot collapse branch (a). ?display stays unbound.\n select ?refView ?label ?displayType ?displayMode ?np ?pubkey ?date ?_resource_multi_iri ?presetKind {\n { # was: service repo/full — now local on the repo/full endpoint\n graph npa:graph {\n ?np npx:hasNanopubType gen:PresetAssignment .\n ?np npa:hasValidSignatureForPublicKeyHash ?pubkey .\n filter not exists { ?npx npx:invalidates ?np ; npa:hasValidSignatureForPublicKeyHash ?pubkey . }\n ?np dct:created ?date .\n ?np npx:embeds ?assignment .\n ?np np:hasAssertion ?a .\n optional { ?np rdfs:label ?label }\n }\n graph ?a {\n ?assignment gen:isAssignmentFor ?_resource_multi_iri .\n ?assignment gen:isAssignmentOfPreset ?presetRef .\n optional { values ?displayMode { gen:ActivatedPresetAssignment gen:DeactivatedPresetAssignment } ?assignment a ?displayMode . }\n }\n graph npa:graph { ?presetNp npx:embeds ?presetRef ; np:hasAssertion ?pa . }\n graph ?pa {\n ?presetRef a gen:Preset .\n optional { ?presetRef dct:isVersionOf ?presetKindOptional . }\n { ?presetRef gen:hasTopLevelView ?refView . bind(gen:TopLevelViewDisplay as ?displayType) }\n union { ?presetRef gen:hasView ?refView . bind(gen:PartLevelViewDisplay as ?displayType) }\n }\n # A preset assignment is identified by the preset's stable KIND and the resource\n # (nanodash issue #607), so the client keeps only the newest assignment per kind\n # and an older version's views drop out when a newer version is assigned. A\n # version declaring no kind keys on itself.\n bind(coalesce(?presetKindOptional, ?presetRef) as ?presetKind)\n }\n }\n }\n filter(contains(?authKeys, ?pubkey))\n # Pin metadata of the referenced version (kind + optional governing space).\n # ?refView is bound by branch (a)/(b) at this point, so these are bound point\n # lookups for the handful of referenced views — now LOCAL joins (endpoint =\n # repo/full), where previously each was its own SERVICE round-trip: evaluated\n # under a nested-loop join, that fired one loopback HTTP request per\n # referenced view while the outer query held its own pooled connection — the\n # per-binding amplification at the heart of the federation deadlock. NOT\n # wrapped in a sub-select, deliberately: a run-once sub-select could not see\n # outer bindings and would have to enumerate every view in the repository\n # (the measured dominant cost of the former resolution variant;\n # supersedes-head resolution itself happens caller-side, per view, cached).\n optional {\n { # was: service repo/type/ec6722… (ResourceView shard) — now local on the repo/full endpoint\n graph npa:graph { ?rnp npx:embeds ?refView ; np:hasAssertion ?ra . }\n graph ?ra { ?refView a gen:ResourceView . }\n optional { graph ?ra { ?refView dct:isVersionOf ?pinKind . } }\n optional { graph ?ra { ?refView gen:governedBy ?pinSpace . } }\n }\n }\n # Space-governed resolution (gen:governedBy; nanodash docs/views-and-presets-as-\n # maintained-resources.md): a pinned version declaring a governing space resolves to\n # the newest member+-signed version of its (kind, space) pair instead of the\n # supersedes head; no valid candidate -> the pin stands. The winners of ALL governed\n # (kind, space) pairs are computed once, as a single \"|kind>space>winner|...\" string\n # (?govWinners, top of the query), and looked up per pin by string: the former winner\n # sub-select joined on ?pinKind/?pinSpace inside an OPTIONAL was re-run -- SERVICE\n # included -- once per row. '>' and '|' cannot occur in IRIs. The lookup is inlined\n # into coalesce(): on rdf4j, a variable whose BIND expression failed (iri(\"\") when\n # there is no winner) tests as unbound with bound(), yet coalesce() over it still\n # yields nothing instead of falling through.\n bind(if(bound(?pinSpace),\n coalesce(iri(strbefore(strafter(?govWinners, concat(\"|\", str(?pinKind), \">\", str(?pinSpace), \">\")), \"|\")), ?refView),\n ?refView) as ?view)\n bind(if(bound(?pinSpace), ?pinSpace, ?undef_) as ?governedBySpace)\n}\norder by desc(?date)" } ] } ] }, { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/provenance", "@graph": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/assertion", "http://www.w3.org/ns/prov#wasAttributedTo": [ { "@id": "https://orcid.org/0000-0002-1267-0234" } ] } ] }, { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/pubinfo", "@graph": [ { "@id": "https://orcid.org/0000-0002-1267-0234", "http://xmlns.com/foaf/0.1/name": [ { "@value": "Tobias Kuhn" } ] }, { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA", "http://purl.org/dc/terms/created": [ { "@value": "2026-09-25T08:29:52Z", "@type": "http://www.w3.org/2001/XMLSchema#dateTime" } ], "http://purl.org/dc/terms/creator": [ { "@id": "https://orcid.org/0000-0002-1267-0234" } ], "http://purl.org/dc/terms/license": [ { "@id": "https://creativecommons.org/licenses/by/4.0/" } ], "http://purl.org/nanopub/x/embeds": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/get-view-displays-unresolved" } ], "http://purl.org/nanopub/x/supersedes": [ { "@id": "https://w3id.org/np/RAt7dfZOYAqtuR_7o0Q1ogzLtnvuvmzMRfnzOT_nq8r6I" } ], "http://www.w3.org/2000/01/rdf-schema#label": [ { "@value": "Get view displays (unresolved versions)" } ], "https://w3id.org/np/o/ntemplate/wasCreatedFromProvenanceTemplate": [ { "@id": "https://w3id.org/np/RA7lSq6MuK_TIC6JMSHvLtee3lpLoZDOqLJCLXevnrPoU" } ], "https://w3id.org/np/o/ntemplate/wasCreatedFromPubinfoTemplate": [ { "@id": "https://w3id.org/np/RA0J4vUn_dekg-U1kK3AOEt02p9mT2WO03uGxLDec1jLw" }, { "@id": "https://w3id.org/np/RAoTD7udB2KtUuOuAe74tJi1t3VzK0DyWS7rYVAq1GRvw" }, { "@id": "https://w3id.org/np/RAukAcWHRDlkqxk7H2XNSegc1WnHI569INvNr-xdptDGI" } ], "https://w3id.org/np/o/ntemplate/wasCreatedFromTemplate": [ { "@id": "https://w3id.org/np/RAEFAt-QcFK0ZhqfvlsmS10BnzGJA0xwOICZXkO-ai87k" } ] }, { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA/sig", "http://purl.org/nanopub/x/hasAlgorithm": [ { "@value": "RSA" } ], "http://purl.org/nanopub/x/hasPublicKey": [ { "@value": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCwUtewGCpT5vIfXYE1bmf/Uqu1ojqnWdYxv+ySO80ul8Gu7m8KoyPAwuvaPj0lvPtHrg000qMmkxzKhYknEjq8v7EerxZNYp5B3/3+5ZpuWOYAs78UnQVjbHSmDdmryr4D4VvvNIiUmd0yxci47dTFUj4DvfHnGd6hVe5+goqdcwIDAQAB" } ], "http://purl.org/nanopub/x/hasSignature": [ { "@value": "CGKpQvqwuxO+cz5r2ZKesFzjs9O++SzKGDcvVbWFUBcu+fxQYRRZpW9NPTNZJMbFbYfkMhAKHgZAHiw8pcWqd6Go8ZF4eUqCf1PhPzoWB7E7/Q35nqAFdDhfWQetdq2Vxkb4goG72zziT9ADs+tiScP87WEFeZP20GBSJRbzbKk=" } ], "http://purl.org/nanopub/x/hasSignatureTarget": [ { "@id": "https://w3id.org/np/RA1Pm-iKXwZRA0Hl9eDXHts2JBhseuZQJDci9VvixqylA" } ], "http://purl.org/nanopub/x/signedBy": [ { "@id": "https://orcid.org/0000-0002-1267-0234" } ] } ] } ]