Skip to content

Commit c9f5caa

Browse files
committed
Close v0.7.4 release SOW
1 parent 536224b commit c9f5caa

3 files changed

Lines changed: 84 additions & 34 deletions

File tree

.agents/sow/SOW-status.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,6 @@ Last updated: 2026-06-19
77
- SOW-0009 - Benchmark Profile Optimize: paused umbrella. Writer and reader
88
performance work is split into focused child SOWs; this file remains the
99
program index.
10-
- SOW-0120 - v0.7.4 Release And Netdata SOW Update: in progress. Preparing the
11-
next SDK patch release after Rust/Go changes landed beyond `v0.7.3`, then
12-
updating the active Netdata host-helper SOW to point at the latest release.
13-
1410
## Pending
1511

1612
- SOW-0048 - Netdata OTEL Writer SDK Integration: open. Component integration
@@ -41,6 +37,18 @@ Last updated: 2026-06-19
4137

4238
## Recently Closed Or Completed
4339

40+
- SOW-0120 - v0.7.4 Release And Netdata SOW Update: completed. Rust crates
41+
were published to crates.io at `0.7.4`, `master` was pushed through release
42+
commit `536224b531655d1f5ed80723b1e9de7882e01431`, and annotated tags
43+
`v0.7.4` plus `go/v0.7.4` were pushed; both peel to the same release
44+
commit. Go module lookup resolved
45+
`github.com/netdata/systemd-journal-sdk/go v0.7.4`, all eight Rust crates
46+
were visible through `cargo info`, and the Netdata host-helper SOW was
47+
updated to point at `0.7.4` / `go/v0.7.4` and the release commit. Validation
48+
passed Go tests, Rust workspace tests, wiki validation, verified examples,
49+
whitespace checks, SOW audit, Rust publish dry-runs, and the user-requested
50+
read-only Rust/Go reviewer gate with Claude, Codex, glm, minimax, kimi, mimo,
51+
deepseek, and qwen all voting `PRODUCTION GRADE: YES`.
4452
- SOW-0119 - Codacy Severe Findings Except Go Version: completed after
4553
regression repair. Codacy reanalysis after the repair reports 23 issue rows,
4654
all in `go/go.mod`; the 14 Critical/High rows are also all in `go/go.mod`.

.agents/sow/current/SOW-0120-20260619-v0-7-4-release-and-netdata-sow-update.md renamed to .agents/sow/done/SOW-0120-20260619-v0-7-4-release-and-netdata-sow-update.md

Lines changed: 64 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,11 @@
22

33
## Status
44

5-
Status: in-progress
5+
Status: completed
66

7-
Sub-state: release planning active; no irreversible publication action taken yet.
7+
Sub-state: `0.7.4` Rust crates are published, `v0.7.4` and `go/v0.7.4`
8+
tags are pushed, Go module lookup resolves, and the Netdata integration SOW
9+
points at the release commit.
810

911
## Requirements
1012

@@ -299,6 +301,23 @@ Failure handling:
299301
- Second full-scope external review round completed after the fix. Claude,
300302
Codex, glm, minimax, kimi, mimo, deepseek, and qwen all voted
301303
`PRODUCTION GRADE: YES`.
304+
- Committed the release gate as
305+
`536224b531655d1f5ed80723b1e9de7882e01431` and pushed `master`.
306+
- Published all eight Rust crates to crates.io at `0.7.4`:
307+
`systemd-journal-sdk-common`, `systemd-journal-sdk-registry`,
308+
`systemd-journal-sdk-core`, `systemd-journal-sdk-host`,
309+
`systemd-journal-sdk-log-writer`, `systemd-journal-sdk-index`,
310+
`systemd-journal-sdk-engine`, and `systemd-journal-sdk`.
311+
- Pushed annotated tags `v0.7.4` and `go/v0.7.4`; both peel to
312+
`536224b531655d1f5ed80723b1e9de7882e01431`.
313+
- Verified Go module lookup resolves
314+
`github.com/netdata/systemd-journal-sdk/go v0.7.4`.
315+
- Updated the Netdata worktree SOW from
316+
`.agents/sow/active/SOW-20260618-systemd-journal-sdk-0.7.3-host-helper.md`
317+
to
318+
`.agents/sow/active/SOW-20260618-systemd-journal-sdk-0.7.4-host-helper.md`,
319+
with SDK version references changed to `0.7.4` / `go/v0.7.4` and open-source
320+
evidence changed to the release commit above.
302321

303322
## Validation
304323

@@ -313,8 +332,21 @@ Acceptance criteria evidence:
313332
- `go/go.mod` remains unchanged and keeps its existing Go directive.
314333
- Pre-publication remote tag check with an explicit SSH config bypass returned
315334
no `v0.7.4` or `go/v0.7.4` tags.
316-
- The reviewer gate is satisfied. Rust crate publication, pushed tags, Go
317-
module lookup, and Netdata SOW update remain to be executed.
335+
- The reviewer gate is satisfied: Claude, Codex, glm, minimax, kimi, mimo,
336+
deepseek, and qwen all voted `PRODUCTION GRADE: YES`.
337+
- Rust crates are published to crates.io at `0.7.4`; `cargo info` showed
338+
`version: 0.7.4` for all eight packages.
339+
- Remote tag verification returned:
340+
- `refs/tags/v0.7.4^{}` ->
341+
`536224b531655d1f5ed80723b1e9de7882e01431`.
342+
- `refs/tags/go/v0.7.4^{}` ->
343+
`536224b531655d1f5ed80723b1e9de7882e01431`.
344+
- `go list -m github.com/netdata/systemd-journal-sdk/go@v0.7.4` returned
345+
`github.com/netdata/systemd-journal-sdk/go v0.7.4`.
346+
- Netdata SOW update evidence:
347+
`.agents/sow/active/SOW-20260618-systemd-journal-sdk-0.7.4-host-helper.md`
348+
now points at SDK `0.7.4`, Go tag `go/v0.7.4`, and release commit
349+
`536224b531655d1f5ed80723b1e9de7882e01431`.
318350

319351
Tests or equivalent validation:
320352

@@ -325,17 +357,15 @@ Tests or equivalent validation:
325357
- `python3 tests/docs/check_wiki_docs.py` validated 15 wiki markdown files.
326358
- `git diff --check` passed.
327359
- `.agents/sow/audit.sh` passed.
328-
- `cargo publish --manifest-path src/crates/journal-common/Cargo.toml
329-
--dry-run` passed for the first publishable Rust crate.
360+
- `cargo publish --dry-run` passed for each Rust crate before publication.
330361

331362
Real-use evidence:
332363

333-
- The first publishable Rust package dry-run verified packaging for
334-
`systemd-journal-sdk-common v0.7.4`.
335-
- Dependent Rust package dry-runs intentionally wait until their `0.7.4`
336-
dependencies are published and indexed.
337-
- `go list -m github.com/netdata/systemd-journal-sdk/go@v0.7.4` cannot resolve
338-
until the `go/v0.7.4` tag is pushed.
364+
- crates.io accepted and indexed all eight Rust packages at `0.7.4`.
365+
- GitHub accepted pushed annotated tags `v0.7.4` and `go/v0.7.4`.
366+
- Go module resolution succeeded through the pushed `go/v0.7.4` tag.
367+
- The Netdata SOW no longer contains stale `0.7.3`, `v0.7.3`, `go/v0.7.3`,
368+
or prior-release commit references.
339369

340370
Reviewer findings:
341371

@@ -359,22 +389,26 @@ Same-failure scan:
359389
- `rg -n "0\\.7\\.3|v0\\.7\\.3|go/v0\\.7\\.3" README.md rust/README.md docs
360390
.agents/sow/specs/product-scope.md rust/Cargo.toml rust/Cargo.lock`
361391
returned no live version-snippet matches after the fix.
392+
- The same stale-release search against the updated Netdata SOW returned no
393+
matches.
362394

363395
Sensitive data gate:
364396

365-
- Pre-publication audit passed. The active SOW cites the Netdata SOW by
366-
repository-relative path instead of recording workstation user-name paths.
397+
- Durable SDK artifacts and the Netdata SOW record only repository-relative
398+
paths, public package names, release tags, and commit hashes. No credentials,
399+
tokens, customer data, trap payloads, private endpoints, or workstation
400+
user-name paths were recorded.
367401

368402
Artifact maintenance gate:
369403

370-
- AGENTS.md: no workflow or responsibility change found so far.
371-
- Runtime project skills: no release-skill change needed so far.
404+
- AGENTS.md: no workflow or responsibility change needed.
405+
- Runtime project skills: no release-skill change needed.
372406
- Specs: product-scope version examples updated to `0.7.4`.
373407
- End-user/operator docs: SDK install snippets updated to `0.7.4`.
374-
- End-user/operator skills: no affected output/reference skills found so far.
375-
- SOW lifecycle: active SOW remains in progress until publication and Netdata
376-
SOW update complete.
377-
- SOW-status.md: active status updated.
408+
- End-user/operator skills: no affected output/reference skills found.
409+
- SOW lifecycle: this SOW is marked `completed` and moved to `done/` with the
410+
closure commit.
411+
- SOW-status.md: canonical and root ledgers updated for completion.
378412

379413
Specs update:
380414

@@ -400,20 +434,25 @@ Lessons:
400434

401435
Follow-up mapping:
402436

403-
- Publication, tag verification, Go module lookup, Netdata SOW update, and SOW
404-
close remain in this SOW after reviewer approval.
437+
- No deferred work remains in this SOW. Netdata dependency/code integration
438+
remains in the Netdata SOW that now points at `0.7.4`.
405439

406440
## Outcome
407441

408-
Pending.
442+
Completed. SDK release `0.7.4` is published for Rust and Go, both release tags
443+
peel to `536224b531655d1f5ed80723b1e9de7882e01431`, Go module lookup resolves,
444+
and the Netdata integration SOW points at the latest release.
409445

410446
## Lessons Extracted
411447

412-
Pending.
448+
- Version sweeps for release readiness must include root docs, language-specific
449+
READMEs, wiki docs, specs, workspace metadata, and lockfiles.
450+
- Push the release gate commit before publication/tagging so downstream evidence
451+
can cite a remote commit that already exists.
413452

414453
## Followup
415454

416-
None yet.
455+
None.
417456

418457
## Regression Log
419458

SOW-status.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,6 @@ is `.agents/sow/SOW-status.md`; if summaries differ, the canonical ledger wins.
88
## Current
99

1010
- `SOW-0009-20260523-benchmark-profile-optimize.md` - paused umbrella. Writer and reader performance work is split into focused child SOWs.
11-
- `SOW-0120-20260619-v0-7-4-release-and-netdata-sow-update.md` - in progress.
12-
Preparing the next SDK patch release after Rust/Go changes landed beyond
13-
`v0.7.3`, then updating the active Netdata host-helper SOW to point at the
14-
latest release.
15-
1611
## Pending
1712

1813
- `SOW-0115-20260616-portable-writer-identity-helpers.md` - open, blocked-on-user-decisions after repeat external review. Strict OS-agnostic writer contract where `_MACHINE_ID`, `_BOOT_ID`, and generated-entry `__MONOTONIC_TIMESTAMP` are mandatory caller-provided anchors, plus a separate optional Layer-3 helper API/package for local-host values on Linux/FreeBSD/macOS/Windows when that is the caller's intended identity source. User accepted FreeBSD locked state-backed boot-id synthesis under `/var/run` by default with caller path override, Rust/Go product scope after SOW-0116, and hard native-only/no-subprocess policy. Initial external review on 2026-06-16 returned 7/7 NOT READY TO IMPLEMENT votes; repeat review after SOW hardening returned 6/7 NOT READY TO IMPLEMENT votes and 1/7 READY vote before the language-scope reduction. The SOW must resolve non-Linux boot-id strategy, state-file locking/security, Rust helper relocation/clock semantics, and breaking-change migration before implementation.
@@ -26,6 +21,14 @@ is `.agents/sow/SOW-status.md`; if summaries differ, the canonical ledger wins.
2621

2722
## Done
2823

24+
- `SOW-0120-20260619-v0-7-4-release-and-netdata-sow-update.md` - completed.
25+
Rust crates were published to crates.io at `0.7.4`, `master` was pushed
26+
through release commit `536224b531655d1f5ed80723b1e9de7882e01431`, and
27+
annotated tags `v0.7.4` plus `go/v0.7.4` were pushed; both peel to the same
28+
release commit. Go module lookup resolved
29+
`github.com/netdata/systemd-journal-sdk/go v0.7.4`, all eight Rust crates
30+
were visible through `cargo info`, and the Netdata host-helper SOW was
31+
updated to point at the release.
2932
- `SOW-0119-20260618-codacy-severe-findings-except-go-version.md` - completed after regression repair. Codacy reanalysis after the repair reports 23 issue rows, all in `go/go.mod`; the 14 Critical/High rows are also all in `go/go.mod`. These are the accepted SCA cluster, and the Go directive remains `go 1.26`.
3033
- `SOW-0117-20260617-v0-7-2-release.md` - completed. Rust crates were published to crates.io at `0.7.2`, `master` was pushed through release commit `400bddde36d1e41a2b17943076752567a0826407`, and annotated tags `v0.7.2` plus `go/v0.7.2` were pushed; both peel to the same release commit. Full Rust/Go tests, wiki validation, verified examples, `git diff --check`, SOW audit, six read-only reviewer votes, crates.io search, and Go module lookup passed.
3134
- `SOW-0116-20260616-retire-python-node-targets.md` - completed. Python and Node.js tracked implementations were moved under `experiments/` as non-product retired experiments; active product docs, specs, CI, validation defaults, project skills, and pending/current SOW scope now target Rust and Go only. Validation included docs checks, verified examples, runtime purity, Netdata function tests, coverage script checks, SOW audit, `git diff --check`, and end-to-end interoperability matrices for query, compact, compression, mixed-directory, lock, verify, directory, binary, live, and byte identity paths. Final external review returned 6/7 `READY TO COMPLETE`; the remaining reviewer finding was explicit staging of new files, resolved during close.

0 commit comments

Comments
 (0)