feat(process): publish v0.3 system-evidence bridge - #3
Merged
Conversation
Owner
Author
|
Semantic contract follow-up in
Validation: |
Owner
Author
|
Final delayed diff review completed after the release branch remained open for more than three days.
Evidence: GitHub CI passed all 48 tests. A separate clean clone passed all 20 process tests and reproduced the telemetry-lab v1.2 consumer path with 7 events, 1 window, 2 alerts, and the expected report artifacts. No unresolved reviewer or bot comments remain. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
linux-process-observe adaptpath forprocess_diff.jsonDesign decision
The adapter stays inside
linux-process-observebecause its source contract isstacknil.system-evidence.v1. It maps process and socket-link diffs into the existing telemetry-lab event boundary and identifies that mapping asstacknil.system-evidence.telemetry.v1. The CI workflow deliberately uses one Ubuntu job, one Python version, and four ordered test steps; cross-repository reproduction remains release evidence rather than a per-PR dependency.Main risk
Saved snapshot diffs are observation-time evidence, not live occurrence telemetry. Downstream consumers must honor
metadata.time_semantics = snapshot_diff_observed_atand must not infer causality, compromise, or authoritative identity from PID, executable, or socket context. The adapter now rejects malformed change shapes and inconsistent process identities instead of silently weakening attribution.Compatibility impact
Existing process snapshot, socket-link, diff, and report schemas are unchanged. The adapter is additive and preserves telemetry-lab's required
timestamp,event_type,source,target, andstatusfields. Existing mini-lab CLIs are unchanged except for the process lab's additiveadaptsubcommand. CI adds validation only; it does not add packaging or release automation.Rollback path
Revert the PR merge commit, or independently revert the adapter and CI commits. Existing snapshot/diff workflows require no data migration and remain usable without the bridge or workflow.
Validation
14 auth + 8 socket + 6 permission + 20 process)linux-process-observe20 passedv1.2consumer reproduction: 7 events, 1 window, 2 alerts, plus features, summary, manifest, and plot artifactssnapshot_diff_observed_aton all 7 eventsgit diff --checkand scoped privacy/secret pattern review passRelease gate
The PR has remained open for more than three days. The final diff review findings were resolved, remote CI is green, and clean-clone plus consumer release evidence is complete. After merge, wait for the
mainCI run, tagv0.3.0, publish the prepared release note, and freeze feature growth at four mini-labs.