Skip to content

docs(fork): a machine-readable header on every carried-change file - #720

Merged
QuentinBisson merged 4 commits into
docs/ledger-20261019from
docs/ledger-header
Oct 19, 2026
Merged

QuentinBisson merged 4 commits into
docs/ledger-20261019from
docs/ledger-header

Conversation

@QuentinBisson

Copy link
Copy Markdown

Problem

The ledger files are prose tables, so nothing can read the Upstream cell of a carried change without a person, and the cells drift from GitHub between re-pins. #719 proposes a machine-readable header on every file.

Change

Every fork/carried/*.md gets a YAML front-matter (id, fork, theme, category, status, upstream outcome/refs/exit, depends_on, commit, verified) seeded from the table cell and reviewed by hand; commit is the carried commit's SHA on giantswarm, resolved from the subject. The table stays as it is until #719 settles whether the cell goes. Cross-line depends_on entries name the counterpart file in the Substrate and agentgateway ledgers. scripts/fork/carried.sh skips the front-matter; FORK.md describes the fields. Stacked on #718.

QuentinBisson and others added 4 commits October 19, 2026 13:13
Every file under fork/carried/ opens with the YAML front-matter proposed in #719, seeded from the row and the 2026-10-19 state board; scripts/fork/carried.sh skips the front-matter before checking the row; FORK.md names the fields.

Signed-off-by: QuentinBisson <[email protected]>
…ubstrate counterpart edges

Signed-off-by: QuentinBisson <[email protected]>
The fork-ledger check runs scripts/fork/ledger-header.sh on fork/carried next to carried.sh --check, with its --self-test fixtures, the same rules as fork-ledger validate (#719).

Signed-off-by: QuentinBisson <[email protected]>
@QuentinBisson
QuentinBisson marked this pull request as ready for review October 19, 2026 12:11
@QuentinBisson
QuentinBisson requested a review from a team as a code owner October 19, 2026 12:11
@QuentinBisson
QuentinBisson merged commit 4cf4a67 into docs/ledger-20261019 Oct 19, 2026
13 checks passed
@QuentinBisson
QuentinBisson deleted the docs/ledger-header branch October 19, 2026 12:13
QuentinBisson added a commit that referenced this pull request Oct 19, 2026
* docs(fork): ledger facts as of 2026-10-19

Signed-off-by: QuentinBisson <[email protected]>

* docs(fork): the compiled-skills carried row superseded by upstream kagent-dev#3203

Signed-off-by: QuentinBisson <[email protected]>

* docs(fork): a machine-readable header on every carried-change file (#720)

* docs(fork): a machine-readable header on every carried-change file

Every file under fork/carried/ opens with the YAML front-matter proposed in #719, seeded from the row and the 2026-10-19 state board; scripts/fork/carried.sh skips the front-matter before checking the row; FORK.md names the fields.

Signed-off-by: QuentinBisson <[email protected]>

* docs(fork): drop internal tracker numbers from the headers, add the Substrate counterpart edges

Signed-off-by: QuentinBisson <[email protected]>

* ci(fork): check the ledger header schema

The fork-ledger check runs scripts/fork/ledger-header.sh on fork/carried next to carried.sh --check, with its --self-test fixtures, the same rules as fork-ledger validate (#719).

Signed-off-by: QuentinBisson <[email protected]>

---------

Signed-off-by: QuentinBisson <[email protected]>

---------

Signed-off-by: QuentinBisson <[email protected]>
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