Blog

Public essays from the shared graph.

Narrative posts explain the motivation, design judgment, and developer-facing tradeoffs behind GraphReFly. Internal decisions and package APIs stay as provenance or delegated docs, not copied post bodies.

2026-07-04 · post

Shared Story, Package-Owned Syntax

packagesdocsboundaries

Summary

The shared site explains the common model; TypeScript, Python, and Rust own their APIs, runnable examples, generated references, and release material.

Frame

A public blog can describe why the packages belong together without flattening them into one hand-maintained API mirror. The shared narrative should make readers confident that the behavior model is common and the syntax is package-owned.

This post is the boundary marker for future migrations: archive content can inspire essays, but exact imports, demos, and release notes stay with the implementation package that owns them.

Outline

  • Explain why the shared site teaches concepts and guarantees.
  • Name each language package as self-contained and idiomatic.
  • Give migration authors a bright line: no copied generated API docs or stale archive snippets.

Draft Policy

write fresh; do not migrate old package API or release copy wholesale

2026-07-04 · post

The Protocol Is a Public Promise

protocolcorrectnessdesign

Summary

A GraphReFly graph is not just callbacks in a trench coat: update waves have public guarantees so joins, boundaries, and effects can be reasoned about across languages.

Frame

This post should teach why the wave protocol exists without becoming an authority mirror. The public story is about what developers can rely on when a cause fans out, settles, and rejoins.

Use compact provenance in metadata, but keep the essay focused on examples, tradeoffs, and the debugging relief that comes from a named update protocol.

Outline

  • Start with a stale join or half-updated view that ordinary callback code makes hard to explain.
  • Show the protocol as a shared promise about ordering and completion, not a table dump.
  • End by routing exact runtime behavior to conformance-backed reference pages and package docs.

Draft Policy

extract durable concept; rewrite stale message/API details against current clean-slate guarantees

3 archive sources marked for editorial rewrite.

2026-07-04 · post

Why GraphReFly Exists

originspositioningreactive-graphs

Summary

GraphReFly is a reactive reduction layer for systems where many changing facts must settle into fewer decisions, views, or effects without hiding the causal graph.

Frame

Most reactive tools make one part of the problem pleasant: local UI state, event streams, or async orchestration. GraphReFly starts from the shared shape underneath them: facts change, reductions combine them, and effects happen at the boundary.

The blog version of the origin story should explain that bet in product language, then point readers to package docs only when exact syntax matters.

Outline

  • Open with the fan-in/fan-out problem instead of project internals.
  • Introduce the graph as the inspectable reduction surface.
  • Close with language packages as entry points, not competing implementations.

Draft Policy

use as historical material only; rewrite for clean-slate public narrative

2 archive sources marked for editorial rewrite.