Skip to content

docs(architecture): ecosystem loose-coupling diagram (06) - #345

Closed
ywatanabe1989 wants to merge 2 commits into
developfrom
docs/ecosystem-loose-coupling
Closed

docs(architecture): ecosystem loose-coupling diagram (06)#345
ywatanabe1989 wants to merge 2 commits into
developfrom
docs/ecosystem-loose-coupling

Conversation

@ywatanabe1989

Copy link
Copy Markdown
Collaborator

Adds docs/architecture/06_ecosystem_loose_coupling.mmd — a mermaid diagram of how the SciTeX packages connect without importing each other.

The pattern: record → read → render. Every edge is a data contract — an optional hook, a neutral file, or a JSON export — never a code import, so any package can be swapped/removed and the rest still compile.

  • Producers (io, session, stats, figrecipe, scholar) record their outputs to neutral sinks.
  • clew reads those recordings → provenance DAG + claims + citations + source-gate → exports JSON (renderer-agnostic).
  • writer renders clew's JSON + owns the neutral Hints feed (manuscript-hints/1).
  • figrecipe is also a direct producer of figure-quality hints; scholar feeds citation data through clew.

Producer topology finalized 2026-07-04 across writer / clew / scholar / figrecipe. Follows the existing docs/architecture/*.mmd convention (01–05). Requested by the operator as the canonical home for the ecosystem diagram (spans all seven packages, so the umbrella fits better than any single package).

🤖 Generated with Claude Code

A mermaid diagram of how the SciTeX packages connect WITHOUT importing each
other — the record -> read -> render pattern where every link is a data
contract (optional hook / neutral file / JSON export), never a code import.

Producers (io, session, stats, figrecipe, scholar) record outputs; clew reads
them into the provenance DAG + exports JSON; writer renders + owns the neutral
Hints feed (manuscript-hints/1). figrecipe is also a direct producer of
figure-quality hints. Topology finalized 2026-07-04 across writer/clew/
scholar/figrecipe. Follows the docs/architecture/*.mmd convention.
@ywatanabe1989

Copy link
Copy Markdown
Collaborator Author

Closing as stale — fleet PR/Issue backlog sweep, 2026-08-11.

What this PR attempted: docs(architecture): ecosystem loose-coupling diagram (06)

Why it is being closed: BLOCKED, 38 days old with no green path.

Nothing is deleted. Branch docs/ecosystem-loose-coupling still holds every commit, and this PR can be reopened at any time. If the change is still wanted, a fresh PR against today's default branch is the faster path.

@github-actions github-actions Bot locked and limited conversation to collaborators Aug 11, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant