Sync Yield from Intelligence Flow @ fdedaebd22e9 (#21)

Co-authored-by: operator-stack-publisher[bot] <operator-stack-publisher[bot]@users.noreply.github.com>

Author: operator-stack-publisher[bot]

README.md

@@ -24,29 +24,35 @@ normal code owns the repeatable control flow.
 
 ## Install
 
-Choose one language package. It includes the SDK and the matching `yskill`
-runtime.
+Choose one language package. TypeScript and Python include a package-local
+runtime. Go and Rust install the matching runtime under `.yield/bin` in the
+repository. Generated adapters never use a global `yskill` from `PATH`.
 
 ```bash
 # TypeScript
-npm install @operatorstack/yield --registry=https://get.operatorstack.systems/npm/
+npm install --save-exact @operatorstack/yield@0.1.23 --registry=https://get.operatorstack.systems/npm/
 npm exec -- yskill --version
 
-# Python
-python -m pip install yieldskill --index-url https://get.operatorstack.systems/pip/simple/
+# Python, after creating and activating .venv
+python -m pip install yieldskill==0.1.23 --index-url https://get.operatorstack.systems/pip/simple/
 python -m yieldskill --version
 
-# Go
-GOPROXY=https://get.operatorstack.systems/go,direct \
-  go install github.com/operatorstack/yield/cmd/yskill@latest
-yskill --version
+# Go, from the repository root
+mkdir -p .yield/bin
+GOBIN="$PWD/.yield/bin" GOPROXY=https://get.operatorstack.systems/go,direct \
+  go install github.com/operatorstack/yield/cmd/yskill@v0.1.23
+.yield/bin/yskill --version
 
-# Rust
-cargo install yieldskill \
+# Rust, from the repository root
+cargo install yieldskill@0.1.23 --root .yield \
   --index sparse+https://get.operatorstack.systems/cargo/index/ --locked
-yskill --version
+.yield/bin/yskill --version
 ```
 
+Yield creates `.yield/.gitignore` when it registers a Go or Rust workflow, so
+the local runtime and run state stay out of Git.
+On Windows, run the local binary as `.\.yield\bin\yskill.exe`.
+
 ## Create and register a skill workflow
 
 Keep the canonical workflow beside the language dependencies it uses. Yield writes
@@ -139,6 +145,8 @@ the documentation for your job:
 - [examples](docs/examples.md) — working programs in all four languages;
 - [coding-agent setup](docs/agent-setup.md) — register one skill workflow with the
   agents used by the project;
+- [test workflow effects](docs/testing-fixtures.md) — deterministic fixture
+  setup, response effects, standard-input JSON, and cleanup;
 - [evaluations](evals/README.md) — first-party workflow conformance and runtime
   invariant results, including the exact claim boundary;
 - [convert an existing skill](docs/convert-existing-skill.md) — move

UPSTREAM.json

@@ -2,18 +2,18 @@
   "files": {
     ".gitignore": "803c5f79d6da7f2c5a1dc0ce27c53b8e5c059309b165782831c4c472af058a4c",
     "LICENSE": "fff261ce507eabd57666c283a621f33e183a3aedebda04c4ecbc6309a62f5edf",
-    "README.md": "6f6c0266295ee7c60fadb134896af498917395b846eb71fda7b104fe2599a536",
-    "cmd/yskill/agents.go": "386b04a9eefd3ee4d0e30dc1398abefd1b3d8f3fb129bb3fc389794a062967a1",
-    "cmd/yskill/agents_test.go": "144d91a1b0dff4eb1d523c49a8e9f4e300a1864c493835c549cd16c6b3be8caa",
+    "README.md": "ad3d31327720cfaa382211fa13bc3df20134299d54222190307769890915ad23",
+    "cmd/yskill/agents.go": "dd85ee2c0722505ec235efb26d5fbfed44f270a1b252bda2dc05b91f9bfe04ed",
+    "cmd/yskill/agents_test.go": "b4ca45106dbb4700ad379ff7f568703960a67ef4549293a7bdf2f57fb5b1b1de",
     "cmd/yskill/main.go": "5eefea8fdd3e040a940bde80aac793fb97c61c18586bd993dab0395f57e5a81f",
-    "cmd/yskill/main_test.go": "c0eb629add322c920834af069d22698466884333bde3b6467219230211cb065f",
+    "cmd/yskill/main_test.go": "12a73231e0723fd4e1cee432a08eaa11950401c68a6d59887bac382fb2e5a19a",
     "cmd/yskill/registry/README.md": "fab385921ee7972f76deb94a3b7ae41184735598ea4145c9d8ccdde2c2b876c4",
     "cmd/yskill/registry/VERCEL_SKILLS_LICENSE": "779258e329008bdb9330e6c1daad644ff867f164d11c4cc4404350479f3e92ee",
     "cmd/yskill/registry/agents.json": "6edfee31cdc0390516adbb107fc97fc3531eb02e1a28b9d62b5b86fdccaed7c1",
-    "cmd/yskill/scaffold.go": "3841fb9c769b0be024355cdf4063c068b4cc8dd918bc2bbef10a7ff7bcbf786e",
+    "cmd/yskill/scaffold.go": "fe79b27930673b2810f405474dae50ab494767e75e70821f21e153bd6972829f",
     "cmd/yskill/skillmeta.go": "12b0c25689bf825d676404af7b3fb74fb92db3d9e222d4e553d8800d86aea45e",
     "docs/README.md": "b4103bc38ca5b3b313d6cc7eae5f11276c03a8bd6123cfa101cb7372ff43fa72",
-    "docs/agent-setup.md": "d34804f3ab6cab940e6f1e9de0c01086b8ec34acb52fe090b7f78bcb3952d91c",
+    "docs/agent-setup.md": "0f73c8322f15a799beb9ad4a88079d8343254c18fe01c59634f4da036d4c5744",
     "docs/convert-existing-skill.md": "0dd538e908a1f2d3a1958e4b2cc1efede2a8e7a73341e32c1a75fec69a9acb8a",
     "docs/examples.md": "f6ef194f1d321692873b5cf35751f369d8215084c5a754b4a6725480ab9b2e37",
     "docs/locus-conformance.md": "a71fd5a72678dcad344afc71cd7a788090ef008a8e5e82d925da5a3db41af6a0",
@@ -37,12 +37,13 @@
     "docs/primitives/outcomes.md": "a584976fada6af3772894736e686f5deb466d3cc8fd1ecacf49f6b9042d6a232",
     "docs/primitives/require.md": "1ea8c3a9ea11aa61e2baee01cf83fca8c872e846a47d7ef230cf6b76d04c90d8",
     "docs/primitives/run-command.md": "af9bcc617f90fd2ee0086aeabb5c98854542efe81636a020699c2f688f8b3b8c",
-    "docs/quickstart.md": "b16fd9933b8edec8765fee3b47e63393345ea439a4f5c3d1f8d7202fd13a70e1",
-    "docs/reference/cli.md": "ab3ed6eb9de3469d41af27a721018c111cb9767f8c500a667d560155572af425",
+    "docs/quickstart.md": "98d1f4771d9ee9bab06a811aed8098531478d76b26291ddeb8e5ed443a7fc768",
+    "docs/reference/cli.md": "a36189229ebadf0c6b298f56b03013cb23720448bbe2f8c85297933111ef06ea",
     "docs/reference/execution-model.md": "58365a7870a081f4ed9e9ba144aae77aa5a1d8676d2bbf6979483be4a06eca80",
     "docs/reference/guarantees.md": "fce2006ad46a83c4ae34d221a83d68bc06a776e7c4f54d938bdcdac91977aa50",
     "docs/reference/sdk-parity.md": "b8c3d6d6efad246b9212db760bb72cba7182b04da321cfd667783000ae75f733",
     "docs/skill-workflows.md": "c0049f6b7db00fc45f15d649e56e381962ddf637dd5d20309a4f79801a28d80d",
+    "docs/testing-fixtures.md": "9f809ced072cc9a55dada36019a552cc7da2eac76fef85fc289e1c3e8e0dc6d1",
     "docs/tutorials/README.md": "f35641cab5aa9739b22a7f9c75a5fe7966b26f492879a70545c4cb6a780129b3",
     "docs/tutorials/approval.md": "d0144288e12488627fce085d3053b1c9b79cc1dac2d45157c214062de3375a9c",
     "docs/tutorials/bounded-debugging.md": "903b876fb13fa5bff6789c500f56c1b97c5ae1bc0059147d845a8f327d553340",
@@ -67,12 +68,12 @@
     "evals/package.json": "84ac7bd7d1c0d1db2233dab54754296195b267e5e907d9f6c402d0d44d569adb",
     "evals/results/README.md": "65b74bfab83dfc51fc5b8a3a4824c37b722fb3a358a5dcfb217dc2af199f4801",
     "evals/results/latest-agent.json": "1484174819ae29bbcffeb615036fa165518669525e6d664123f6a38ca3614b69",
-    "evals/results/latest.json": "4a62df2905d90a948c62b4dc0711a0d22e6b4448787f3f8be86c4f006421b531",
+    "evals/results/latest.json": "31574cb9c77823f9dc60152482623fea667f4797c55d58fde8f8ef495e9dbbac",
     "evals/scripts/run.mjs": "17a62cd0f7fda73d84a9bfa21c9c3253ba52a4a23eece09523cfea244e3f9940",
     "evals/scripts/validate.mjs": "42d51ea75f9418e45dd1797d1fe02cbc046752d3e3c37d41bc8d3a47d5865d4d",
     "examples/convert-skill/SKILL.md": "e6376f34365d4ac030d316db55e91f0c606a501668099f4ecf1e27d43ec806a2",
     "examples/convert-skill/fixtures/responses.json": "5b5f27b0ae5962360ac7b0e779992f430c655f352a38da37debb3505c32cd60a",
-    "examples/convert-skill/main.go": "eb987ed1ce9139e6d0d40a2fae20c532c2fba3b27357e31555db2f0f52db4e39",
+    "examples/convert-skill/main.go": "d8b3ab134bb19066a1c137c0e226a071be19e8eaa7b9c8c6553622554bb03c7e",
     "examples/convert-skill/skill.json": "cd9f5e46c623597dad1224735a03d1363b8a426f541bd00321752d1cf7d9b116",
     "examples/data-migration/Cargo.lock": "e1bd35afbfdf0119c4accc8de657241b027c12b029f5117147349063ccb0d6c7",
     "examples/data-migration/Cargo.toml": "f578e4084a0457c4027100bc99c7698c388356d8e893f9d12b8e49491fdb9705",
@@ -116,14 +117,14 @@
     "examples/library/go/review-branch/skill.json": "9208838fdc88dec59a3ea02deb8151ea24439e5a2d9950d6ca0bfdd7e92dcbb7",
     "examples/library/go/src/audit-security/main.go": "ebb7d56f941e7405c492e681027b198ce0d9f91ec8372ce9010ae2179ef2ced1",
     "examples/library/go/src/investigate-failure/main.go": "7dc17697a7e6fbc77534fcc71f33dd9ff05d16268eca2f92f46d6b8a7421c1cb",
-    "examples/library/go/src/migrate-database/main.go": "5e5792a300a7ef5d32804add6fb14902840e05fcd59486fa1f196d43a1b0970d",
-    "examples/library/go/src/publish-ios/main.go": "acad66f53edb4be3e811d60e25495b201c99e8f2052a9f24b6e3899679e34922",
+    "examples/library/go/src/migrate-database/main.go": "f58de18f95e904ea156e3daddd38003340752c43de8b00f2c8b0cb0bfc4ad594",
+    "examples/library/go/src/publish-ios/main.go": "c60ede26985e5b81cc24ef78ca5a9c20dc90a62fd20bb4af366749d12101880d",
     "examples/library/go/src/qa-web-change/main.go": "eb450d2b89668cde5c0d0d280ed1d367fa09eaf71a4eb150889f14ff750b77ca",
-    "examples/library/go/src/release-package/main.go": "06426523262d87b426cb249f046855d3620f0d63936d2be5ad526720ae8f6edd",
+    "examples/library/go/src/release-package/main.go": "2c02a99d03fe8c1211a2ec8f0fa000c14c880f0cc72bddfce272890e255501fd",
     "examples/library/go/src/repair-ci/main.go": "2f837aeecc34d71f1d5af17926db2712368aac80f8a668562a02156fd3950fbd",
     "examples/library/go/src/review-branch/main.go": "8776396cee5b3651f38306a1815a2570dda7f02f6d0edd8c681f4ad41f0d5b2b",
     "examples/library/go/src/triage-issue/main.go": "8fe3933d2454e8272ca0dcd11b8283e33c355dd32c453d8a99ca3135502af6f4",
-    "examples/library/go/src/upgrade-dependency/main.go": "6ef20ce2bccf92cdbed59a26a075101a858e630b8cc05f34b0b843972b8dcfd6",
+    "examples/library/go/src/upgrade-dependency/main.go": "d5d25e271ce68efdff70b295d149d51e6e0dbc41f1f27825afacf90108d4632d",
     "examples/library/go/triage-issue/SKILL.md": "a3a0c383196cd981e64c1fd311e608cb50facfe55409981d4f92d28a4b346862",
     "examples/library/go/triage-issue/fixtures/responses.json": "68f36fb5a7723a5d2a5477bed3e8a245908e6157a7eeb9205a604a05c9e3998f",
     "examples/library/go/triage-issue/skill.json": "7117c9c44ebc29cfa4c667da3787504ee20c14a09251f111ed4c55b43a6d6a21",
@@ -212,7 +213,7 @@
     "examples/library/rust/upgrade-dependency/SKILL.md": "11b6b4258640ff60af1446b97d907ea15d819a714de2736eda16621f5adbf186",
     "examples/library/rust/upgrade-dependency/fixtures/responses.json": "17eeef53bb7a4cc9ad70f0b24d50305db8266b4edb8c911570da7141830f2b9d",
     "examples/library/rust/upgrade-dependency/skill.json": "4d1a107ed7fb56c1ff125d13cc5d755d0faaaf33334a76d3a4f478c157209bff",
-    "examples/library/scripts/generate.mjs": "c03024bc4c978c004fdc6db93876d87cf73c07f2585ad2c83ed71871a6a1990a",
+    "examples/library/scripts/generate.mjs": "76df7c0bacd3f60345acbfa46d193abf19b2a4431d9c4857667183cedc0c48ce",
     "examples/library/test-all.sh": "62ff63221fd6cfa87e31ec3145016410746ddc78e6210140d5c0217d8e1b838f",
     "examples/library/typescript/audit-security/SKILL.md": "3ca2a8ffdb4504854cc45879e4c8bb795fc073560c1994eaf20f3d42d00d62f1",
     "examples/library/typescript/audit-security/fixtures/responses.json": "d738404c2e2912705de936c5948c4520ae4145bae0068d478f7689aae9aaedaa",
@@ -261,7 +262,7 @@
     "go.mod": "8e0a98ce35395a77a04190655556f3f9c19e13dcad31ed061d114435ad5e38f3",
     "go.sum": "fc6d8a3de7b2f1ef51759974e48940328d8c10951833bcf4d6309daba3110b98",
     "internal/conformance/conformance_test.go": "8dd828b3df9a4b0f6cd47a16db40619346a1476c1a85ee62950689d32e892603",
-    "internal/conformance/testdata/skill-go/main.go": "b50d0ae8f978ce9a83f9cec6d3a939b544d8361c519cdf8dd994ddf5adf99ec0",
+    "internal/conformance/testdata/skill-go/main.go": "43631848a4d10f1e6faa555c288c38688ced70ccbf02219d3918367c708f4a24",
     "internal/conformance/testdata/skill-py/main.py": "f34b3315491d0725bce17e8d77cd0b8eb218d2896b51d8c10a660dc658f1cc24",
     "internal/conformance/testdata/skill-py/skill.json": "5207b98487b29a9914f3621d40daf8da3d1626a90a8fc0173ca0c7ee114b9764",
     "internal/conformance/testdata/skill-rs/Cargo.lock": "69aa4e64c45fdc25526b1661e4964de1202afa70893689a02d5f558e3019492d",
@@ -307,12 +308,13 @@
     "release-notes/2026-08-02-cross-agent-registration.md": "8f4296fae36468bda08370bad8d13b7fc1e893b682f8c73015311ab01ace853f",
     "release-notes/2026-08-02-dx-hardening.md": "801d85ad760545140415000a95cbd6a681c32462f0578c1ac1ce802893bee303",
     "release-notes/2026-08-02-skill-workflows.md": "8cd0cded1922387ef8e81b3e084c12e440f729aa778672f9ec91ffa153df5297",
-    "sdk/python/README.md": "a40fb44353cfa2633b7307280c501d490a815aa00c4ba5d8b86c5a6e778742f4",
+    "release-notes/2026-08-02-v0-1-23-dx.md": "538aaf62beeb15e132cfde35f47217edce7d1e4ef5c4036fd00ed96f8362b2b7",
+    "sdk/python/README.md": "aeff405ce89928814e93704ad593f9ee976d400c227804343947f09ca8ad3062",
     "sdk/python/pyproject.toml": "0a36d0a22a29da6b8c42e3a5a91aed1b6f6d0813712a9e582ab08e8ce4290de6",
-    "sdk/python/test_cli.py": "b7a2fe9a72299aa86f6012129e00f9c2dc0f6e5c29241373fb956321fae5f0b4",
+    "sdk/python/test_cli.py": "ed1d17ffa4190dd3733cc3042cf49a66710ca5ff6303d1202330a2d53cd12fac",
     "sdk/python/yieldskill/__init__.py": "c43dbb2a25ed7e8537521561a16e2e5fc7921d60f913b22ac298255bd44fe60e",
     "sdk/python/yieldskill/__main__.py": "2f2978db2ba5bf8034466902e0c0f5fa61d0961b262d776598ba0d9bb47d6b62",
-    "sdk/python/yieldskill/_cli.py": "ab8978c5c053ba3007ba38ae22038a869cb0a5222762edd0fbea749623024b66",
+    "sdk/python/yieldskill/_cli.py": "70efa4d505117bf83e0aeaf9dd729b62864cdb0ff360cfc24390932305093310",
     "sdk/rust/Cargo.toml": "da29a554401a316f6a0e7ba53d166f4c3741ac9aefe1e3f2d66af1bfa3a2d88a",
     "sdk/rust/src/lib.rs": "581882dca50cf4e27a8f2e05b013b2bc091802b6a20d89d58ffbcdf5c23372a7",
     "sdk/typescript/bin/runtime.mjs": "909da102e8ed8ccc917cd17d88acc65869a0a2bdb6f875f76d763383999a2b57",
@@ -321,12 +323,13 @@
     "sdk/typescript/package.json": "b8805c31ce1bbf4b063efa5f69cfad8e1b0ec402607d7afceea6398057d95a6e",
     "sdk/typescript/scripts/build.mjs": "1ba086bbdddb61226f3b6363e1fda0ffdd129ce90ea9da28ba71ecfb0f478e6d",
     "sdk/typescript/src/index.ts": "bc91d43b8f6698a3139fd482077942a22beab950db74164d94422ecb38631a0b",
-    "sdk/yield/yield.go": "c9b4c7ab9a36b28f383e141fc084bd8b3b693c63c5a22722d8ae7ef3253f76ff"
+    "sdk/yield/public_api_test.go": "30a94201355001d9fec04bd7d05c5745880cc5b8cf381301a3388c48a2dc0f3c",
+    "sdk/yield/yield.go": "0fde5e1370e7292f855087245690c36db76b85a675789b1a5864e8b3f489fd30"
   },
   "generator": "operatorstack/yield:project",
   "schema_version": 1,
   "source": {
-    "commit": "43b26da2291cfb8d8d3bb3cef8e3e45b4cc70270",
+    "commit": "fdedaebd22e925a0d014105d837ad243c20f5987",
     "path": "labs/22-yield",
     "repository": "operatorstack/intelligence-flow"
   }