Skip to content

docs: prescriptive edge ontology for story graphs#269

Merged
maximelb merged 1 commit into
masterfrom
story-edge-ontology
Jun 12, 2026
Merged

docs: prescriptive edge ontology for story graphs#269
maximelb merged 1 commit into
masterfrom
story-edge-ontology

Conversation

@maximelb

@maximelb maximelb commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Stories are rendered differently on every run because edge creation is left to LLM/human judgment. This PR makes the linking prescriptive — it is the spec for the story edge ontology; the assembler, RPC, and web app changes implementing it land separately.

  • Derived edges: the assembler computes most edges from the member records' own configuration (hive:// / lcr:// ARLs, extension request actions, fp cat matching). No tags needed; never stale.
  • Declared edges: links: tags are restricted to an allowed-pair matrix (new drop rule 3); pairs outside the matrix are silently dropped.
  • Canonical edge labels: one default label per pair; unlabeled declared edges get the default filled in, so unlabeled links render consistently.
  • origin field on every assembled edge: "derived" or "declared"; declared wins on dedup.
  • Worked examples updated to show the membership-is-curation / edges-are-facts split.

🤖 Generated with Claude Code

Stories previously left every linking decision to the tagger (human or
AI), so the same infrastructure produced different graphs on every run.
This defines the edge ontology: most edges are now derived by the
assembler from the member records' own configuration (ARLs, extension
requests, fp cat matching), and declared links: tags are restricted to
an allowed-pair matrix with canonical default labels. Edges gain an
origin field (derived|declared).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@maximelb maximelb requested a review from lcbill June 12, 2026 01:24
@maximelb maximelb marked this pull request as ready for review June 12, 2026 01:24
@maximelb maximelb merged commit b00e227 into master Jun 12, 2026
2 checks passed
@maximelb maximelb deleted the story-edge-ontology branch June 12, 2026 01:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant