Skip to content

docs(blog): add bilingual Log Is the Runtime - #4572

Open
likun666661 wants to merge 1 commit into
mainfrom
docs/blog-log-is-the-runtime-bilingual
Open

docs(blog): add bilingual Log Is the Runtime#4572
likun666661 wants to merge 1 commit into
mainfrom
docs/blog-log-is-the-runtime-bilingual

Conversation

@likun666661

@likun666661 likun666661 commented Sep 2, 2026

Copy link
Copy Markdown
Member

Summary

Add the Chinese and English versions of the Log Is the Runtime essay together in one pull request so the complete argument and translation can be reviewed as a unit.

Documents for review:

The essay connects log-centric database design to Maka RuntimeEvents, then explains append-only history, compaction as projection, KV-cache prefix reuse, and Tool Result offload. The documentation index links both language versions while keeping code and current contracts authoritative.

Review focus

  • technical accuracy of the log-centric database analogy
  • the boundary between canonical RuntimeEvents and model/UI projections
  • the description of compaction as a durable but lossy projection
  • Tool Result pruning as archive-backed, bounded, model-readable context offload
  • semantic parity and natural wording between the English and Chinese versions

Verification

  • git diff --exit-code 5f7670343bb837867fab23630acf1e849fcdf044 -- docs/README.md docs/blogs — the combined files match the previously merged bilingual state
  • git diff --cached --check
  • npm run check:asf-headers
  • Full tests were not run because this PR changes Markdown documentation only.

AI use

Select exactly one:

  • No generative tool made a substantive contribution
  • Generative tooling made a substantive contribution

Tool(s) and scope: OpenAI Codex drafted and translated the essay from the current Maka architecture and implementation, prepared the bilingual documentation set, and verified this PR.

Checklist

  • Tests cover the change and fail without it
  • Lint, format, typecheck and the affected suites pass locally

Does this PR entail a change in behavior?

  • Yes — described under Summary above
  • No

Generated-by: OpenAI Codex
@github-actions github-actions Bot added the effort/L Under 1000 readable lines label Sep 2, 2026

@MicroGery MicroGery left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One inline architecture-accuracy concern.


Reading a large file, searching an entire repository, running tests, fetching a web page, or waiting for a group of child agents can produce tens or hundreds of thousands of tokens. The model may need those details for one step, but repeatedly carrying the full Tool Result into every later inference is usually expensive and unnecessary.

Tool Result Prune does not answer “should this history still exist?” It answers “must this large object remain resident in the model's working memory?”

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] Keep the store topology aligned with the implementation

This introduces context offload correctly, but the following description says the complete result is written to a separate context-offload store. Tool-result archives currently use the generic ArtifactStore; a dedicated SQLite ContextOffloadStore is the planned migration in #4071. Please phrase this as the architectural role rather than current implementation (or explicitly state the current ArtifactStore backing and the planned migration), so the article does not turn a target topology into a present fact.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

effort/L Under 1000 readable lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants