Skip to content

feat(effort-graph): add Citation + Blob with optional blob cites#225

Draft
tonyketcham wants to merge 1 commit into
toeknee/citeable-blob-payload-989dfrom
toeknee/blob-collection-cites-1b07
Draft

feat(effort-graph): add Citation + Blob with optional blob cites#225
tonyketcham wants to merge 1 commit into
toeknee/citeable-blob-payload-989dfrom
toeknee/blob-collection-cites-1b07

Conversation

@tonyketcham

Copy link
Copy Markdown
Collaborator

Summary

Implements the Blob collection issue from #224 by adding Citation as the homogeneous cites target (keeps Flatbread core refs strength) and Blob as an optional longform payload behind a Citation.

Model

Finding.cites → Citation (body may be a URL alone)
                  └─ blob? → Blob (optional longform)
  • WriteCitation / WriteBlob mutations (15 total)
  • Optional cites: Citation[] on all epistemic creates
  • Bounded digests omit Blob bodies; effort get zooms in
  • Dogfood Finding + accepted Decision; Issue resolved

Decision: dec-ship-citation-collection-with-optional-blob--fyga3x876n7rcnmn
Issue: iss-implement-blob-collection-and-crumb-graph-cites--g2c7m6j39we5xy3z (resolved)

Checklist

  • Doc comments / skill glossary + reference updated
  • Tests for Citation URL-only, optional blob, cites validation, Blob digest omission
  • No new console errors locally

Backwards compatible?

  • Additive collections/mutations/refs (cites → Citation). Consumers must use the updated effortGraphContent() preset (includes citations/ + blobs/).
Open in Web Open in Cursor 

Resolve the Blob collection issue by shipping Citation as the homogeneous
`cites` target (Flatbread refs-safe). Citation body alone is valid (e.g. a
URL); optional `blob` attaches longform payloads. Epistemic writes gain
optional `cites`; digests omit Blob bodies by default.

Decision: dec-ship-citation-collection-with-optional-blob--fyga3x876n7rcnmn
Issue: iss-implement-blob-collection-and-crumb-graph-cites--g2c7m6j39we5xy3z
Change-Id: Id73687f3c3224ca3eb77b4fc870815811ebd754d
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.

2 participants