Repository navigation
docs(examples): add a deterministic Node.js/npm stable-v1 integration recipe (#122) - #189
Open
wufangyong973 wants to merge 1 commit into
Open
wufangyong973 wants to merge 1 commit into
wufangyong973 wants to merge 1 commit into
Conversation
… recipe (AETHERXGLOBAL#122) Mirror the preserved Python/pytest recipe as examples/node-npm, but on the current stable ExecSurface v1.0.0 instead of the historical Alpha.5 pin. The recipe is a reproducible demonstration, not independent external validation. What changed: - examples/node-npm/fixture/{test.js,fixture.json,package.json}: a one-file, zero-dependency Node fixture that asserts a sum invariant and only writes a harmless drift.txt when the public write_extra flag is true. - examples/node-npm/run.js: a Node: built-ins-only runner that learns and checks the same real node test.js command, retaining unchanged PASS (exit 0) and deliberate-write REVIEW (exit 10) evidence plus native command receipts, baseline immutability and verdict JSON. It targets the stable 1.0.0 binary (asserting execsurface --version) and the unchanged built-in review policy. - examples/node-npm/README.md: copy/paste walkthrough, expected exit codes, the controlled drift, and the current Linux x86_64 native-ptrace support boundary. - examples/README.md: register the Node.js/npm recipe in the example-selection table as a current v1 entry. No changes to observer, normalization, baseline, lockfile, policy, verdict or GitHub Action semantics. The fixture is private to this repo and requires no network during the measured run. Closes AETHERXGLOBAL#122.
This branch has not been deployed
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.
Closes #122
Mirrors the preserved Python/pytest recipe as
examples/node-npm, but on the current stable ExecSurface v1.0.0 rather than the historical Alpha.5 pin. The recipe is a reproducible integration demonstration, not independent external validation or a safety certification.What changed
examples/node-npm/fixture/{test.js,fixture.json,package.json}: a one-file, zero-dependency Node fixture that asserts a sum invariant and only writes a harmlessdrift.txtwhen the publicwrite_extraflag is true.examples/node-npm/run.js: anode:-built-ins-only runner that learns and checks the same realnode test.jscommand, retaining an unchanged PASS (exit 0) and a deliberate-write REVIEW (exit 10) plus native command receipts, baseline immutability and verdict JSON. It targets the stable1.0.0binary (assertsexecsurface --version) and the unchanged built-in review policy.examples/node-npm/README.md: copy/paste walkthrough, expected exit codes, the controlled drift, and the current Linux x86_64 native-ptracesupport boundary.examples/README.md: registers the Node.js/npm recipe in the example-selection table as a current-v1 entry.No changes to observer, normalization, baseline, lockfile, policy, verdict or GitHub Action semantics. The fixture is private to this repo and needs no network during the measured run.
Local verification
node --check examples/node-npm/run.jspasses.left + right = 5invariant holds.node test.jswithwrite_extra:falseexits 0 and writes nodrift.txt.node test.jswithwrite_extra:trueexits 0 and writesdrift.txtwith the documentedcontrolled fixture driftcontent.Full end-to-end
learn/checkassertions require the stable v1 Linux x86_64execsurfacebinary with nativeptrace; the runner encodes the expected verdict JSON shape (target.exit_code/target.signal/policy.source/verdict/findings[].change/effect_kind/evidence.effect.target.value) verbatim against the v1 schema incrates/execsurface-policy/src/lib.rs.