Skip to content

docs: 凍結注記・ファイル目録現況化・live-e2e 対訳と索引(Bolt 4 freeze-and-parity — 260805-docs-impl-sync) - #2314

Merged
j5ik2o merged 4 commits into
bolt/docs-sync-divergence-fixesfrom
bolt/docs-sync-freeze-parity
Aug 5, 2026
Merged

docs: 凍結注記・ファイル目録現況化・live-e2e 対訳と索引(Bolt 4 freeze-and-parity — 260805-docs-impl-sync)#2314
j5ik2o merged 4 commits into
bolt/docs-sync-divergence-fixesfrom
bolt/docs-sync-freeze-parity

Conversation

@j5ik2o

@j5ik2o j5ik2o commented Aug 5, 2026

Copy link
Copy Markdown
Member

概要

intent 260805-docs-impl-sync の Bolt 4(最終)— 凍結記録の注記・ファイル目録の現況更新・対訳/索引の欠落充足(FR-4 裁定 Q3=B + FR-5 の F-8/F-9/F-10)。Bolt 1-3 を包含する #2302 に積んだ stacked PR(base = bolt/docs-sync-divergence-fixes)。Bolt 3 の squash 着地に伴い rebase --onto で transplant 済み(patch-id 旧新一致を機械確認)。

変更(4 コミット、docs のみ)

  1. 凍結注記(FR-4 / NFR-4): docs/research/upstream-sync/reports/v2.2.0-to-v2.3.0-plan.md 冒頭へ凍結 3 要素注記(凍結スナップショット宣言・ピン留めリビジョン参照・現況非反映)を純挿入 5 行で追記 — 注記以外の内容バイト不変(git diff で確認)
  2. docs/amadeus-files.md + .ja.md の現況更新(D-6/F-10): 出典行を実測 ref へ更新、hooks 3 / sensors 2 / tools-data 3 / otel・vendor・rules の欠落追加、陳腐化した「26本」を count-free 化、退役成果物名 2 件を現行名(build-test-results.md / load-test-results.md)へ
  3. docs/harness-engineering/live-e2e.ja.md 新規作成(F-8): EN の忠実訳、H2 5 節一致。生成マトリクスは複製せず EN を参照(project-matrix.ts:9 の対象が EN のみのため、複製は無音ドリフト面になる)
  4. 索引リンク(F-9/F-10): docs/README.{md,ja.md} から amadeus-files と live-e2e へ(純増 2 行)

機械的派生変更(申告): live-e2e.ja 追加に伴い t174 が要求する > Languages: 行を EN 側へ 1 行追加。

対象範囲の判断(申告)

FR-4 の名指しパスは docs/research/upstream-sync/**(対訳なし・md 1 件)。パス外の docs/research/upstream-ai-dlc-v2.2.0-…differences.{md,ja.md} は RE 乖離目録に載っていないため触っていない(必要なら別途)。

検証(ローカルを正 — docs-only、#2278 参照)

検証 結果
t174(unit) exit 0 — 5 pass
t287 + t291 + t-pi-docs(integration) exit 0 — 9 pass / 166 assertions
project-matrix.ts check exit 0
FR-4(1) 凍結注記 grep + 注記のみ diff 成立
FR-4(2) amadeus-files 実測一致 + README リンク 成立
F-8 H2 一致 5 = 5
F-9 自己言及除く被リンク ≥1
transplant 完遂確認 ancestor exit 0 / ahead 4 / patch-id 一致 / status clean

Refs: #2302(base)、intent record amadeus/spaces/default/intents/260805-docs-impl-sync/


Note

Low Risk
Markdown-only changes to documentation and navigation; no runtime, auth, or distribution code is modified.

Overview
Documentation-only PR that refreshes maintainer-facing references so they match the current dist/ layout and stage metadata, and fills gaps in bilingual coverage and navigation.

docs/amadeus-files.md / .ja.md — Bumps the pinned source commit, documents bun run dist as the measured tree source, switches stage artifact naming from outputs: to produces:, and expands the harness engine trees (Codex .agents/rules, extra hooks, sensors, tools/data files, otel/ / vendor/). Retired artifact filenames are corrected (build-test-results.md, load-test-results.md).

Live E2E — Adds live-e2e.ja.md as the Japanese counterpart to the English runbook (matrix stays EN-only by design). English live-e2e.md gains the standard > Languages: line for t174.

Index & processdocs/README.md / .ja.md link to the file inventory and live-e2e guides, and tell maintainers to run opt-in local live journeys before shipping harness distribution changes.

Researchv2.2.0-to-v2.3.0-plan.md gets a short frozen record banner so readers know it is a historical snapshot, not living guidance.

Reviewed by Cursor Bugbot for commit eec4f57. Configure here.

j5ik2o added 4 commits August 6, 2026 01:35
The report is a point-in-time investigation pinned to the revisions in its
Compared revisions table. Readers reached it without any signal that it is
not maintained, so state the freeze, point at the pinned revisions, and say
it does not reflect current state.
The inventory was pinned to commit 9b77786 (2026-07) and had drifted: the
hook, sensor and tools/data listings were short, otel/ and vendor/ were
absent, .agents/ omitted rules/, the tools count was stale, and two stage
outputs used retired artifact names (test-results rather than
build-test-results and load-test-results). Re-measure from bun run dist and
the produces: frontmatter, and index the page from docs/README.
The runbook was English-only while every other harness-engineering page ships
a translation. Add the Japanese rendering and the language switch links the
docs gate requires once the pair exists. The generated matrix block stays in
the English page alone, since project-matrix.ts writes only that file and a
duplicated block would drift silently.
Both pages were unreachable from the documentation map. Add one link line
each, keeping the additions purely additive so parallel edits to this file
do not conflict.
@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)
  • main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: d9c08236-0b55-4d03-a803-384b687c5c86

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

@j5ik2o
j5ik2o merged commit d48c094 into bolt/docs-sync-divergence-fixes Aug 5, 2026
16 checks passed
@j5ik2o
j5ik2o deleted the bolt/docs-sync-freeze-parity branch August 5, 2026 21:58
j5ik2o added a commit that referenced this pull request Aug 6, 2026
…2302)

* docs: reconcile scope and runner count words with the shipped catalog

The framework ships fifteen scopes, not ten. Update the count words that sit
next to an inline enumeration to the measured value and extend the enumeration
with installer-distribution and the four self-* scopes; rewrite the prose count
words that have no adjacent enumeration to a count-free form so they cannot go
stale again. Drop the '37 runner descriptions' figure from the Codex CLI page
for the same reason.

* docs: cover all eight shipped sensor manifests and fix their source path

The sensor reference exemplified only four of the eight shipped manifests and
pointed at the generated dist/ tree as their home. List every manifest in the
matches and timeout tables, add the missing event-registry-drift row to the
harness-engineering inventory, and repoint the authoring and example paths at
the canonical packages/framework/core/sensors/ source (the compile resolver
walks the installed .claude/sensors/ tree, so that reference stays runtime-side).

* docs: bring the harness roster and version facts up to date

Add the Kimi Code and Pi Coding Agent badges, list pi/ in the harness and dist
trees, add pi to the installer wizard roster, and enumerate all eight harnesses
in the docs landing page. Correct the Kimi Code floor to 0.29.0 to match
MIN_KIMI_VERSION, and resync the Japanese README version badge to 0.1.7.

* docs: list the intent, space, codekb-path, and plugin verbs in the CLI reference

The Quick Reference table omitted seven verbs that the utility CLI's own help
output advertises. Transcribe them from that output.

* docs: port the loop monitor and quality repair event section to Japanese

The Japanese state-machine reference was missing the whole '### Loop monitor and
quality repair' section, so five audit events had no Japanese counterpart. Port
the heading, lead paragraph, and all five rows, keeping event names and emitter
paths verbatim so the t48 forward check still matches.

Scope declaration: the authorized change was the two events AUTO_DECISION_REVIEWED
and INTENT_COMPLETION_TRANSACTION_COMMITTED. Porting only those two was not
realizable because the containing section was absent entirely; election E-DIS-CG1
(choice 1, 2-0) authorized widening this to the whole section.

* docs: correct the scope count and roster in the architecture reference

Same defect as the count words already fixed in the skills and scopes chapters:
the architecture summary claimed ten named scopes next to an inline enumeration.
Update to the measured fifteen and extend the enumeration with
installer-distribution and the four self-* scopes.

* docs: self-* スコープのユーザーガイド新設(Bolt 2 self-scopes — 260805-docs-impl-sync) (#2306)

* docs: document the self-* scopes and the installer-distribution scope

The scope guide described ten scopes while the framework ships fifteen.
Split the catalogue into the eleven general scopes and a dedicated
section for the four self-development scopes, and add the previously
undocumented installer-distribution scope.

The new section explains what each self-* scope is for, why none of them
is auto-detected, and why self-fix and self-refactor keep Comprehensive
verification at Minimal depth. Depth, test strategy, and EXECUTE counts
are transcribed from the compiled scope grid; the prose is derived from
the scope files under packages/framework/core/scopes/.

Extend the routing and test-strategy-default tables to all fifteen
scopes, point the skills guide at the section from the scope-runner
discussion, and cross-link it from the harness-engineering naming note.

* docs: drop the stale scope count from the Japanese scopes chapter

The Japanese chapter promised a catalogue of ten scopes while the
framework ships fifteen, and its English counterpart was already
count-free. Match the English wording so the sentence no longer has to
be resynchronised whenever a scope is added.

* docs: 未記載ツール群の文書補完と Intent autonomy 新章(Bolt 3 tool-docs — 260805-docs-impl-sync) (#2310)

* docs: document the TLA+ authoring CLI and evidence store

* docs: document the plugin import-closure guard

* docs: add the Intent autonomy, review, and completion reference chapter

* docs: document the advisory choice acceptance paths

* docs: correct the packaged harness face count and roster for the pi face

* docs: use a stage runner in the Codex stage-runner example

The sentence introduces stage runners, but one of its two examples was
$amadeus-fix — a scope runner. Swap it for $amadeus-code-generation so both
examples match the runner kind the sentence describes.

Addresses coderabbit review on #2302.

* docs: 凍結注記・ファイル目録現況化・live-e2e 対訳と索引(Bolt 4 freeze-and-parity — 260805-docs-impl-sync) (#2314)

* docs: mark the upstream sync report as a frozen snapshot

The report is a point-in-time investigation pinned to the revisions in its
Compared revisions table. Readers reached it without any signal that it is
not maintained, so state the freeze, point at the pinned revisions, and say
it does not reflect current state.

* docs: refresh the generated file inventory against the current tree

The inventory was pinned to commit 9b77786 (2026-07) and had drifted: the
hook, sensor and tools/data listings were short, otel/ and vendor/ were
absent, .agents/ omitted rules/, the tools count was stale, and two stage
outputs used retired artifact names (test-results rather than
build-test-results and load-test-results). Re-measure from bun run dist and
the produces: frontmatter, and index the page from docs/README.

* docs: add the Japanese live harness end-to-end runbook

The runbook was English-only while every other harness-engineering page ships
a translation. Add the Japanese rendering and the language switch links the
docs gate requires once the pair exists. The generated matrix block stays in
the English page alone, since project-matrix.ts writes only that file and a
duplicated block would drift silently.

* docs: index the file inventory and live e2e runbook from the docs map

Both pages were unreachable from the documentation map. Add one link line
each, keeping the additions purely additive so parallel edits to this file
do not conflict.
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