Skip to content

docs(DEN-1413): record shipped durable first-install contract - #27

Merged
ORESoftware merged 4 commits into
mainfrom
agent/den-1413-durable-docs-current-main
Aug 4, 2026
Merged

docs(DEN-1413): record shipped durable first-install contract#27
ORESoftware merged 4 commits into
mainfrom
agent/den-1413-durable-docs-current-main

Conversation

@ORESoftware

Copy link
Copy Markdown
Contributor

Scope

Replaces stale docs PR #21 with a semantic current-main integration for the completed durable first-install feature.

Current-main composition

Exact head:

f1be09c32724675a7766163d27682fd235da5805

The commit has two parents:

  1. current docs main at 55df86ec809cb03d48108d80694b8d71953e479a; and
  2. the fully reviewed original documentation head 9401a15a4a38fee173695abd5bc7cad369024966.

Current main already owns architecture numbers 24 through 26. The stale branch's docs/24-durable-first-install-manifests.md is therefore not copied over or allowed to replace the recursive-installs design. The document is semantically renumbered to 27, while every newer README row remains intact.

The final current-main delta is exactly two files:

  • README.md: one new doc-27 index row, marked implemented and independently certified;
  • docs/27-durable-first-install-manifests.md: the reviewed contract updated to the final shipped state.

Final evidence recorded

  • product PR zed-pkg/zed-cli#88;
  • validated product head fe4b4662fb252166b18c48f9c048f5888ec8df44;
  • product merge 436af9240c4a3808d4c22253a56710004189037b;
  • Node certification PR zed-pkg-test/zed-pkg-e2e#34, merge a19f22865d2967f04800062cc8157e5a2015ac9e;
  • Go/Python/Rust certification PR zed-pkg-test/zed-pkg-e2e#35, merge a0286ee1c9d0751cc88b29fed7490afd5b972e78;
  • all 13 product workflows and all nine independent E2E workflows green before merge.

The document also records the Linux transaction-recovery race found during current-main validation and the shipped fix: recovery takes the same kernel-backed store install lock as live project transactions before inspecting rollback journals.

Platform boundary

Node plus Go/Python/Rust are certified on Ubuntu 24.04 and macOS 15. Native Windows and WSL remain explicitly outside this certification result.

Refs DEN-1413, DEN-1574, DEN-567, DEN-772.

Preserve the reviewed durable-manifest documentation history while composing it onto current docs main.
Current main already owns architecture numbers 24 through 26, so renumber the stale document to 27 instead of overwriting the recursive-installs design. Retain every current README entry, mark the feature implemented, and replace in-review references with the exact zed-cli #88 and zed-pkg-e2e #34/#35 heads and merge SHAs.
Document the Linux transaction-recovery race found by current-main validation, the kernel-backed install-lock fix, the certified Node/Go/Python/Rust Linux/macOS boundary, and the explicit Windows/WSL non-certification scope.
@linear-code

Copy link
Copy Markdown

@ORESoftware
ORESoftware merged commit 945bede into mainAug 4, 2026
2 checks passed
Sign up for freeto 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

@ORESoftware