Skip to content

docs(adr): record storage format exceptions - #1030

Merged
DecisionNerd merged 1 commit into
mainfrom
docs/1022-format-exceptions-adr
Aug 30, 2026
Merged

docs(adr): record storage format exceptions#1030
DecisionNerd merged 1 commit into
mainfrom
docs/1022-format-exceptions-adr

Conversation

@DecisionNerd

@DecisionNerd DecisionNerd commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add ADR 0024 defining GFDR as a permanent, authoritative, versioned graph-format exception
  • record the exact GFDR magic, run/record/schema v1 markers, JSON GraphDeltaPayload, typed IrLiteral encoding, and migration debt
  • define compiled ontology Parquet as checksum-bound derived runtime persistence, with CURRENT-selected canonical ontology JSON as durable authority
  • align storage and project-compatibility documentation, including the exact eight persisted runtime tables
  • publish the ADR through both indexes and the docs-site sync/sidebar

Verification

  • node docs-site/scripts/test-extension-docs.mjs
  • node docs-site/scripts/sync-content.mjs (107 pages)
  • generated ADR title/body assertions
  • git diff --cached --check

A full Astro build could not run in this executor because its local package store lacks Astro/Prettier and registry access is restricted; CI has the configured docs dependency install.

Closes #1022


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

@coderabbitai

coderabbitai Bot commented Aug 30, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5ee08942-54ff-4b20-b1af-1712f245cf88

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Warning

Billing warning: we have not been able to collect payment for this subscription for more than 72 hours. Please update the payment method or pay any pending invoices in Billing to avoid service interruption.


Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added documentation Improvements or additions to documentation release:none No release note or version impact labels Aug 30, 2026
@DecisionNerd
DecisionNerd enabled auto-merge (squash) August 30, 2026 21:05
@DecisionNerd
DecisionNerd force-pushed the docs/1022-format-exceptions-adr branch from e8fc4dc to c675f18 Compare August 30, 2026 21:18
@DecisionNerd
DecisionNerd merged commit 0916cd2 into main Aug 30, 2026
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation release:none No release note or version impact

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(adr): record format exceptions (delta journal encoding, compiled ontology persistence)

1 participant