Skip to content

docs(blog): add reviewed architecture diagrams to both languages - #4441

Merged
huangruiteng merged 2 commits into
mainfrom
codex/blog-control-plane-diagrams
Sep 15, 2026
Merged

huangruiteng merged 2 commits into
mainfrom
codex/blog-control-plane-diagrams

Conversation

@huangruiteng

@huangruiteng huangruiteng commented Sep 15, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Add the three owner-reviewed architecture diagrams to both language editions of the long-horizon blog:

  • Section 2: LoopX's position beside agents/harnesses and composable execution infrastructure.
  • Section 3: semantic control-plane components, validated transitions and feedback.
  • Section 6: controller routing for execution, waiting, user action, repair, replan, stop and terminal closure.

Use self-contained Chinese/English SVGs with translated labels. Replace the earlier simple stack and state overview, retire the ASCII loop and unused diagram-card styles. Dense diagrams have a full-size vector link and contained horizontal scrolling on narrow screens. Figures describe responsibilities and routes; they do not claim a single state store, a global transaction or a Goal lifecycle enum.

The storage-promotion illustration is excluded. Opening content and benchmark evidence are unchanged.

Validation

  • Tested revision: 52dfaffea3ad379cbc79ac8c1830f3533f637744
  • Run state: finished
  • Input classes: public_fixture
Check kind Result Evidence / limitation
static passed npm run build in apps/presentation/site: TypeScript check and Vite build.
real_entrypoint passed Chromium against the production output, both languages at 1440 and 390 px: all three assets load, article anchors resolve, no page-level overflow.
manual passed English SVGs inspected at full size; labels shortened to fit shapes without changing the routing contract. Narrow-screen scroll and full-size vector URLs verified.
regression_parity passed Opening HTML in both languages matches baseline 503991d; new styles are scoped to architecture figures.
static passed HTML/CSS public boundary scan and manual SVG resource/privacy inspection; git diff --check. No scripts, external assets or private review metadata in SVGs.
real_backend not_applicable Static article presentation only; no runtime/provider behavior changes.

No runtime suites are needed for this editorial scope. Future-facing pass replaces redundant figures and uses native browser links/scrolling rather than adding a renderer or zoom library.

Frontend / Visual Evidence

  • UI impact: changed, body only. Owner reviewed the three Chinese drawings before embedding.
  • Before: the original co-decision figure and superseded candidate appear in the earlier visual record.
  • After: final vector assets below, in Chinese and English. Desktop and mobile article rendering checked separately as described above.
  • Source data: public_fixture; no private document links or review material included.
System position — Chinese / English

System position (zh)

System position (en)

Control-plane components — Chinese / English

Control-plane components (zh)

Control-plane components (en)

Controller routing — Chinese / English

Controller routing (zh)

Controller routing (en)

Scope and boundaries

Documentation/presentation update; base main. RFC runtime fixture impact: N/A. Nine public blog paths only; no private state, credentials, internal links or build output. Both commits include DCO sign-off. No merge or deployment performed.

Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
@huangruiteng

Copy link
Copy Markdown
Collaborator Author

Visual evidence for f27b43e: public article content and synthetic proposals only. Desktop 1440 px; mobile 390 px. The first viewport is unchanged. Exact-scope LoopX change-quality verification: valid; site build and browser checks passed.

Before: co-decision ASCII loop loopx-blog-before-responsibilities
A: Host / control-plane responsibilities loopx-blog-architecture-responsibilities loopx-blog-mobile-architecture-responsibilities
B: authority source and projection loopx-blog-architecture-authority loopx-blog-mobile-architecture-authority
C: concurrent updates and receipt recovery loopx-blog-architecture-concurrency loopx-blog-mobile-architecture-concurrency

Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
@huangruiteng huangruiteng changed the title docs(blog): add current control-plane architecture diagrams docs(blog): add reviewed architecture diagrams to both languages Sep 15, 2026
@huangruiteng
huangruiteng merged commit c979cf1 into main Sep 15, 2026
17 of 18 checks passed
@huangruiteng
huangruiteng deleted the codex/blog-control-plane-diagrams branch September 15, 2026 10:31
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