Skip to content

[PR] docs: backfill LIFECYCLE.md — register the 22 unledgered BILI_* env vars (fixes lifecycle-ledger-guard red) - #3995

Merged
ranxianglei merged 1 commit into
masterfrom
2026-10-20_lifecycle-ledger-backfill
Oct 20, 2026
Merged

ranxianglei merged 1 commit into
masterfrom
2026-10-20_lifecycle-ledger-backfill

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Fixes #3994

一句话

LIFECYCLE.md 台账随 #3249 落地时就比 src/ 少登记了 22 个环境变量,lifecycle-ledger-guard 上线即把所有跑完 CI 的 PR 判红;本 PR 把 22 条全部补登,守卫回绿。

根因(详见 #3994)

#3249 分支切出后 master 又合入了 mysql 存储、guardrails、网络预算、图像缩放、更新错峰、dsh authored compaction、snapshot shadow、pi inline 等改动,台账生来即缺。落地后 master 的 CI run 全被后续 push 取消,从未暴露;#3988 是第一批跑完的 pull_request CI。

改动

只动 LIFECYCLE.md(+25 行,零代码改动):

§1 过渡开关(3 条,有解除条件)

§2 常设面(19 条)

  • §2.3 网络:BILI_CA_FILE、BILI_RECEIVE_BODY_BYTES/BILI_DECODED_BODY_BYTES、BILI_OUTBOUND_BODY_BYTES、BILI_WS_OUTBOUND_BYTES
  • §2.4 存储:BILI_STORAGE_ARCHIVE_AFTER_DAYS、BILI_STORAGE_WAL_JOURNAL_SIZE_LIMIT_BYTES、BILI_MYSQL_DSN
  • §2.5 诊断:BILI_INVARIANT_JUDGE
  • §2.7 更新器:BILI_UPDATE_POLICY_URL、BILI_UPDATE_STAGGER_MIN_MS/MAX_MS
  • §2.8 图像:BILI_IMAGE_RESCALE/BILI_IMAGE_RESCALE_MAX_DIM
  • 新 §2.9(guardrails + forge):BILI_GUARDRAIL_BASH_TIMEOUT、BILI_GUARDRAIL_MAX_OUTPUT_BYTES、BILI_GUARDRAIL_REPETITION、BILI_GUARDRAIL_TEXT_RUN_THRESHOLD、BILI_AUTO_MODE_FORGE

§5 卫生记录:记一笔本次补登的来龙去脉。

每条一句话用途 + 出处 issue 号 + 默认值/逃生值,与既有行文一致;分类口径 = 有解除条件的盖子/实验 → §1,纯功能面 → §2。

验证

  • node scripts/lifecycle-ledger-guard.mjs → OK: every BILI_* env var read from src/ is registered in LIFECYCLE.md(148/148,exit 0)
  • 纯文档改动:typecheck/构建/测试不受影响(CI lanes 会再证一遍)

关联

…failing lifecycle-ledger-guard

The ledger landed via #3249 already 22 entries behind src/ (mysql storage,
guardrails, #3128 network budgets, #3400 image rescale, #3619 update stagger,
#3733 dsh authored compaction, #3756 snapshot shadow, #3278 pi inline).
Every completed CI run since hits the guard and fails. Backfill:
3 transition rows in §1 (SNAPSHOT_SHADOW, DSH_AUTHORED_COMPACTION,
PI_INLINE) + 19 permanent rows across §2.3/2.4/2.5/2.7/2.8 and new §2.9
(guardrails + auto-mode forge), plus a §5 hygiene record.

Local: node scripts/lifecycle-ledger-guard.mjs -> OK, exit 0 (148/148).
@ranxianglei ranxianglei changed the title docs: backfill LIFECYCLE.md — register the 22 unledgered BILI_* env vars (fixes lifecycle-ledger-guard red) [PR] docs: backfill LIFECYCLE.md — register the 22 unledgered BILI_* env vars (fixes lifecycle-ledger-guard red) Oct 20, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-20_lifecycle-ledger-backfill (e601716)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.4769-pr.3995.b16a18b

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Option B — Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr3995.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei
ranxianglei merged commit 979f883 into master Oct 20, 2026
36 of 41 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.686-master.979f883 (rolling master tag).

npm install -g billion-context@0.0.686-master.979f883  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

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

Labels

None yet

Projects

None yet

1 participant