From c631e04294a18adee9faf840a133d846f70fb74e Mon Sep 17 00:00:00 2001 From: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> Date: Mon, 2 Nov 2026 14:39:54 +0530 Subject: [PATCH 1/2] docs(blog): embed bilingual v10 architecture and continuity diagrams in context-delivery article Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> --- .../public/blog/context-delivery/index.html | 4 +- .../context-delivery/context-cycle-v9-en.svg | 78 +++++++++++++ .../context-delivery/context-cycle-v9.svg | 78 +++++++++++++ .../context-native-path-v10-en.svg | 106 ++++++++++++++++++ .../context-native-path-v10.svg | 106 ++++++++++++++++++ .../blog/zh/context-delivery/index.html | 4 +- 6 files changed, 372 insertions(+), 4 deletions(-) create mode 100644 apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg create mode 100644 apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg create mode 100644 apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg create mode 100644 apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg diff --git a/apps/presentation/site/public/blog/context-delivery/index.html b/apps/presentation/site/public/blog/context-delivery/index.html index 1ba27c3367..7a72704e74 100644 --- a/apps/presentation/site/public/blog/context-delivery/index.html +++ b/apps/presentation/site/public/blog/context-delivery/index.html @@ -174,7 +174,7 @@

On the next continuation, deliver what changed

When enabled, the default output is a reading entrypoint

Connect these operations back to the currently supported native Codex quota path:

-

One capture, from saved source to reading

decision-<id>/
+
One capture, from saved source to reading
Default Mechanism Path with Context Delivery Enabled: projection.json, required-context.json, compact reference envelope, and progressive readback
decision-<id>/
 ├─ projection.json        source
 ├─ required-context.json  facts
 ├─ delivery.json          full/delta
@@ -201,7 +201,7 @@ 
Recover missing context while preserving the original work
Paged content: follow next_command with capture digest, selection digest and byte cursor; combine contiguous content in order. Selection EOF covers only that selection.
 
  • Unknown or inapplicable structures: retain complete content and original read obligations rather than guessing which prose can be hidden.
    • 
 
-
    Continuity and recovery
    One valid cycle: complete baseline → changed facts and delta → exact reconstruction.
    New cycle or known continuity loss: complete current source → read necessary facts again.
    An unfinished Turn retains its original capture, work and settlement identity. Reading recovery does not repeat external effects.
    
+
    Continuity and recovery
    Differential Delivery: Reuse Within an Epoch, Full Recovery on Break
    One valid cycle: complete baseline → changed facts and delta → exact reconstruction.
    New cycle or known continuity loss: complete current source → read necessary facts again.
    An unfinished Turn retains its original capture, work and settlement identity. Reading recovery does not repeat external effects.
    
 
    What the measurements establish
    
 
    The example separates three mechanisms: avoid repeatedly moving history not currently needed, combine reads that belong together, and avoid retransmitting unchanged verified structures. Complete sources, requirements and recovery connect them.
    
 
    Reader figures include actual CLI page metadata; local path length affects a small amount of framing. Projection figures compare capture bodies; the cycle table compares codec output. The reproduction script checks these distinct measurements and exact reconstruction.
    
diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg
new file mode 100644
index 0000000000..2c9c0de3b2
--- /dev/null
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9-en.svg
@@ -0,0 +1,78 @@
+
+  Differential Delivery: Reuse Within an Epoch, Full Recovery on Break
+  Within continuity epoch A, baseline is followed by verified delta 1 and delta 2. On compaction or continuity break, epoch B automatically resets with a fresh full baseline.
+  
+
+
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+  
+  
+    
+  
+
+
+  
+  Differential Delivery: Reuse Within an Epoch, Full Recovery on Break
+
+  
+  
+  Continuity Epoch A (Active Session with Verified Baseline)
+  
+  Full Baseline
+  Persisted with baseline_sha256
+  
+
+  
+  Verified Delta Δ1
+  Baseline hash matched → changed fields
+  
+
+  
+  Verified Delta Δ2
+  Tracks structural diffs & removals
+
+  
+  
+  Context Compaction / Session Switch / Hash Mismatch → Rejects Dangling Delta, Forces Full
+
+  
+  
+  Continuity Epoch B (Fresh Baseline After Compaction / Break)
+  
+  Full Baseline
+  Persisted with baseline_sha256
+  
+
+  
+  Verified Delta Δ1
+  Baseline hash matched → changed fields
+
+  Guarantees exact structural reconstruction at every turn: never floods unchanged blobs, never references a compacted baseline.
+
\ No newline at end of file
diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg
new file mode 100644
index 0000000000..18b3c19ca3
--- /dev/null
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-cycle-v9.svg
@@ -0,0 +1,78 @@
+
+  Differential：同一有效周期内复用，失效即完整恢复
+  在有效周期 A 内，完整基线后仅传递经哈希核验的 Δ1、Δ2；一旦发生上下文压缩或连续性失效，新周期 B 自动重置为完整来源。
+  
+
+
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+  
+  
+    
+  
+
+
+  
+  Differential：同一有效周期内复用，失效即完整恢复
+
+  
+  
+  有效周期 A (Continuity Epoch A · 同一会话连续轮次)
+  
+  完整来源 (Full Baseline)
+  落盘并记录 baseline_sha256
+  
+
+  
+  变化 Δ1 (Verified Delta 1)
+  核验上一轮基线 → 仅交付变更字段
+  
+
+  
+  变化 Δ2 (Verified Delta 2)
+  继续精确追踪结构差异与删除项
+
+  
+  
+  触发 Compaction / 会话切换 / 基线哈希不匹配 → 拒绝悬空增量，自动切换 Full
+
+  
+  
+  新周期 B (Continuity Epoch B · 压缩或跨会话后自动重建基线)
+  
+  完整来源 (Full Baseline)
+  落盘并记录 baseline_sha256
+  
+
+  
+  变化 Δ1 (Verified Delta 1)
+  核验上一轮基线 → 仅交付变更字段
+
+  保证模型在任何时候都能精确还原当前完整结构：既不把未变化大字段重复刷屏，也不在压缩后引用已丢失的旧基线。
+
\ No newline at end of file
diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg
new file mode 100644
index 0000000000..021ae661f8
--- /dev/null
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg
@@ -0,0 +1,106 @@
+
+  Default Mechanism Path with Context Delivery Enabled
+  Full raw capture is persisted first; progressive required-context view and verified differential reuse are built on disk; stdout receives a compact file reference with select_command and recovery_command.
+  
+
+
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+  
+  
+    
+  
+
+
+  
+  
+  LOOPX 2.2 · CONTEXT DELIVERY NATIVE PATH (V10)
+  Default Mechanism Path with Context Delivery Enabled
+  Illustrated on the native Codex quota path: lossless on-disk capture without flooding the active prompt window
+
+  
+  A. On-Disk Durable Artifacts
+  B. Default stdout Reference Envelope
+  C. Progressive Readback
+
+  
+  
+  1  projection.json (Full Raw Capture)
+  Complete source state written first (~34 KB)
+  Goals · Todos · Acceptance · Constraints · Revisions
+  
+
+  
+  
+  2  required-context.json (Required View)
+  Extracts active requirements & risks when applicable
+  Keeps pointers to raw evidence; falls back if larger
+  
+
+  
+  
+  3  full / delta (Verified Continuity Reuse)
+  Same continuity epoch: verified baseline → exact delta
+  No baseline / compacted / full shorter → auto full
+
+  
+  
+
+  
+  
+  4  Compact File Reference (~1.2 KB)
+  
+  path + sha256 + mode + byte_size
+  select_command + recovery_command
+  toc_sections: [goal, active_todo, ...]
+  TOC attached only when compact; never floods stdout
+  
+  stdout 负载对比 (Payload Size)
+  Full JSON:   ~34,200 B
+  Ref Envelope: ~1,180 B (-96%)
+  模型先把注意力留给当前任务决策
+
+  
+  
+
+  
+  
+  5  Targeted Selection by Question
+  
+  ① select_command → read active required sections
+  --section active_todo --section risks
+  
+  ② context_details[id] + Pointer → exact raw source
+  JSON Pointer → projection.json#/todos/0
+  
+  ③ recovery_command → bypass delta & read current full
+  --recover-full (zero-loss fallback)
+
+  Core Invariant: delta exposes changes directly while recovery reads current truth without replaying old baselines; saved on disk ≠ read by model.
+
\ No newline at end of file
diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg
new file mode 100644
index 0000000000..ad20830d3f
--- /dev/null
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg
@@ -0,0 +1,106 @@
+
+  Context Delivery 开启后的默认机制路径
+  完整原始捕获先落盘保存，适用时构建必要视图并在同一有效周期内精确复用 full/delta；模型默认收到小文件引用，按当前问题逐层选读并可沿指针回到原文。
+  
+
+
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+    
+  
+  
+    
+  
+  
+    
+  
+
+
+  
+  
+  LOOPX 2.2 · CONTEXT DELIVERY 原生交付路径 (V10)
+  Context Delivery 开启后的默认机制路径
+  以当前 Codex 原生 quota 入口为例：完整落盘不丢细节，默认引用不塞满上下文窗口
+
+  
+  A. 磁盘持久层 (On-Disk Durable Artifacts)
+  B. 默认标准输出 (Compact stdout Envelope)
+  C. 按需逐层选读 (Progressive Readback)
+
+  
+  
+  1  projection.json (完整原始捕获)
+  完整当前来源先落盘 (~34 KB)
+  目标 · 任务 · 验收 · 约束 · 来源修订
+  
+
+  
+  
+  2  required-context.json (必要视图)
+  适用时提取当前行动必填要求与风险 (~9.6 KB)
+  解释与证据保留原文入口；更贵则保留原视图
+  
+
+  
+  
+  3  full / delta (连续性核验与复用)
+  同一有效周期：核验基线哈希后精确输出 delta
+  无基线 / 压缩失效 / 全量更短 → 自动回退 full
+
+  
+  
+
+  
+  
+  4  小文件引用 (Default Reference)
+  
+  path + sha256 + mode + byte_size
+  select_command + recovery_command
+  toc_sections: [goal, active_todo, ...]
+  目录与短概览能放下才附；绝不默认铺满正文
+  
+  stdout 负载对比 (Payload Size)
+  Full JSON:   ~34,200 B
+  Ref Envelope: ~1,180 B (-96%)
+  模型先把注意力留给当前任务决策
+
+  
+  
+
+  
+  
+  5  按当前问题逐层选读
+  
+  ① select_command → 读取当前必要视图章节
+  --section active_todo --section risks
+  
+  ② context_details[id] + Pointer → 精确回到原文
+  JSON Pointer → projection.json#/todos/0
+  
+  ③ recovery_command → 跳过增量直接读取当前全量
+  --recover-full (zero-loss fallback)
+
+  核心不变量：delta 入口可读变化，recovery 可直接读当前事实，不必先通读旧基线；文件落盘 ≠ 模型已读。
+
\ No newline at end of file
diff --git a/apps/presentation/site/public/blog/zh/context-delivery/index.html b/apps/presentation/site/public/blog/zh/context-delivery/index.html
index 24bf2a4c46..8c96105945 100644
--- a/apps/presentation/site/public/blog/zh/context-delivery/index.html
+++ b/apps/presentation/site/public/blog/zh/context-delivery/index.html
@@ -174,7 +174,7 @@ 
    下一轮继续，交付这次改变了什么
    
 
    开启后，默认交付的是一个读取入口
    
 
    把前面的动作接回产品，当前支持的 Codex 原生 quota 路径是：
    
 
-
    同一次捕获，从保存到读取
    decision-<id>/
+
    同一次捕获，从保存到读取
    Context Delivery 开启后的默认机制路径：完整原始捕获 projection.json、必要视图 required-context.json、小文件引用与按问题逐层选读
    decision-<id>/
 ├─ projection.json        原始捕获
 ├─ required-context.json  必要视图
 ├─ delivery.json          full/delta
@@ -201,7 +201,7 @@ 
    压缩或读取失败，恢复上下文，也保留原工作长内容跨页： 按 next_command 接读，保留捕获摘要、选择摘要和字节游标，按连续偏移组合正文。某组选读的 EOF 只覆盖该选择。
 
  • 遇到未知结构或不适用的来源： 保留完整内容及原有读取义务，不猜哪些文字可以隐藏。
    • 
 
-
    连续性与恢复
    同一有效周期：完整基线 → 新事实与差分 → 完整还原。
    新周期或已知连续性丢失：当前完整来源 → 必要事实重新读取。
    未结束的 Turn 保留原捕获、原工作与结算身份。恢复读取不重新执行外部副作用。
    
+
    连续性与恢复
    Differential：同一有效周期内复用，失效即完整恢复
    同一有效周期：完整基线 → 新事实与差分 → 完整还原。
    新周期或已知连续性丢失：当前完整来源 → 必要事实重新读取。
    未结束的 Turn 保留原捕获、原工作与结算身份。恢复读取不重新执行外部副作用。
    
 
    这些数据说明了什么
    
 
    这组例子把三个收益来源分开了：少重复搬当前用不上的历史，少发本可合并的读取请求，少重复交付已经核验的不变结构。 完整来源、要求与恢复路径贯穿其中。
    
 
    上面的 reader 数字包含实际 CLI 响应中的分页元数据；本机路径长度会影响少量封装字节。原生投影数字比较捕获正文，周期表比较编码层，三种口径分别列出。示例脚本可复算这些值与完整还原结果。
    

From 3156223cbfc25c41adffd0a5e59624e06ff8600e Mon Sep 17 00:00:00 2001
From: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Date: Mon, 2 Nov 2026 18:14:56 +0530
Subject: [PATCH 2/2] fix(blog): align context-native-path-v10 diagram metrics
 and CLI flags with v2.2.0 article

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
---
 .../context-native-path-v10-en.svg            | 192 ++++++++++++------
 .../context-native-path-v10.svg               | 192 ++++++++++++------
 2 files changed, 252 insertions(+), 132 deletions(-)

diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg
index 021ae661f8..ca446750e1 100644
--- a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10-en.svg
@@ -1,6 +1,6 @@
-
-  Default Mechanism Path with Context Delivery Enabled
-  Full raw capture is persisted first; progressive required-context view and verified differential reuse are built on disk; stdout receives a compact file reference with select_command and recovery_command.
+
+  Context Delivery: Standard Path Tree & JSON Pointer Structure
+  Standard on-disk capture directory decision-<id>/, progressive JSON Pointer hierarchy in required-context.json, and context_capture_navigation_v1 envelope.
   
 
\ No newline at end of file
diff --git a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg
index ad20830d3f..d8b7fd524a 100644
--- a/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg
+++ b/apps/presentation/site/public/blog/images/context-delivery/context-native-path-v10.svg
@@ -1,6 +1,6 @@
-
-  Context Delivery 开启后的默认机制路径
-  完整原始捕获先落盘保存，适用时构建必要视图并在同一有效周期内精确复用 full/delta；模型默认收到小文件引用，按当前问题逐层选读并可沿指针回到原文。
+
+  Context Delivery 标准交付路径与 JSON Pointer 结构
+  展示 ~/.loopx/context-delivery/decision-<id>/ 标准目录树、required-context.json 内部 JSON Pointer 分层结构、以及 context_capture_navigation_v1 默认交付包络。
   
 
\ No newline at end of file