Citation evidence · FE-09C · NexusScholar.Network

Network

Immutable, corpus-bound direct-citation snapshots over stable scholarly identities, with every edge backed by exact evidence and only deterministic count and degree metrics.

Purpose and authority boundary

NexusScholar.Network owns the meaning and canonical identity of a direct-citation snapshot. It does not call a provider, discover citations, store a graph, or decide that a citation exists. An outward adapter must first produce an evidence reference whose digest can be verified; the domain then validates and snapshots the supplied relationship.

A graph relation is not evidence by itselfEvery edge cites CitationNetworkEvidenceRef. Provider rank, a mutable UI edge, an in-memory graph, or a database relationship cannot substitute for the referenced evidence and digest.

Snapshot model

verified corpus snapshot id + digest
  → resolved scholarly works with stable WorkIdSet identity
  → direct-citation edges with evidence id + digest
       resolved target → must name another snapshot node
       unresolved target → preserved explicitly, never invented
  → canonical ordering and duplicate-edge rejection
  → immutable CitationNetworkSnapshot digest
  → node count, edge count, isolated count, in/out degree

The snapshot schema is nexus.network.citation-snapshot/1.0.0. It binds the source corpus, direct-citation/1.0.0 algorithm identity, resolved nodes, unresolved targets, evidence-backed edges, and metrics in canonical JSON.

Key types

CitationNetworkNode is built from an identified ScholarlyWork. It requires at least one stable WorkId; the primary stable ID becomes the node ID.
CitationNetworkCitationTarget keeps resolved and unresolved targets distinct. A resolved target must parse as a stable work ID and must exist in the snapshot node set.
CitationNetworkEvidenceRef binds evidence kind, stable evidence ID, and valid content digest.
CitationNetworkEdge currently admits only the directed direct-citation kind.
CitationNetworkSnapshot validates the corpus binding, algorithm, node/edge consistency, evidence, and deterministic ordering before computing its digest.
CitationNetworkMetrics exposes node, edge, and isolated-node counts plus per-node in-degree and out-degree.

Source: NexusScholar.Network. Authority: ADR 0043 and FE-09C gate evidence.

Determinism and metric semantics

Input enumeration order does not affect the snapshot. Nodes sort by node ID, unresolved targets sort ordinally, and edges sort by a normalized source/kind/target key. Duplicate normalized edges fail instead of being silently coalesced.

Metric	Exact meaning	Not implied
Node count	Resolved stable works admitted to this corpus-bound snapshot.	Coverage of a field or provider.
Edge count	Distinct evidence-backed direct citations, including unresolved targets.	Complete bibliography reconstruction.
In-degree	Resolved snapshot nodes directly citing this node.	Impact, quality, or influence.
Out-degree	Evidence-backed direct citations leaving this node, resolved or unresolved.	Reference-list completeness.
Isolated count	Snapshot nodes with zero in-degree and zero out-degree.	Scientific irrelevance.

Failure and refusal behavior

Construction rejects an invalid corpus digest, unsupported algorithm/version, duplicate node identity, a node without a stable work ID, a missing citing node, a resolved target absent from the node set, missing or invalid edge evidence, duplicate normalized edges, and every edge kind except direct citation. Unresolved targets remain explicit rather than being dropped or guessed.

Dependency and integration boundary

The packable domain project depends only on Kernel and Shared. It has no HTTP, provider, storage, graph-library, UI, or application dependency. Provider-specific citation acquisition, workspace persistence, CLI commands, visualization, or export require outward adapters and successor gates.

Tests and explicit nonclaims

CitationNetworkSnapshotTests prove order-independent identity, count and degree behavior, unresolved-target preservation, and rejection of missing nodes, duplicate edges, invalid corpus digests, and unsupported edge kinds. The module participates in the 24-package reproducibility and local-source smoke gate.

No live citation provider, bibliographic coupling, co-citation, snowballing, shortest path, centrality, community detection, visualization, export, dissemination, PHP parity, scale, completeness, or impact interpretation is claimed.