owenloop 0.4.1 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +71 -0
- package/README.md +182 -53
- package/bin/owenloop.mjs +50 -2
- package/dist/packages/work/src/agent/brief.d.ts +176 -0
- package/dist/packages/work/src/agent/brief.js +197 -0
- package/dist/packages/work/src/agent/loop.d.ts +141 -0
- package/dist/packages/work/src/agent/loop.js +669 -0
- package/dist/packages/work/src/agent/model-policy.d.ts +49 -0
- package/dist/packages/work/src/agent/model-policy.js +138 -0
- package/dist/packages/work/src/agent/workdir.d.ts +210 -0
- package/dist/packages/work/src/agent/workdir.js +319 -0
- package/dist/packages/work/src/bundle/cache.d.ts +92 -0
- package/dist/packages/work/src/bundle/cache.js +338 -0
- package/dist/packages/work/src/bundle/fetch.d.ts +87 -0
- package/dist/packages/work/src/bundle/fetch.js +345 -0
- package/dist/packages/work/src/bundle/types.d.ts +164 -0
- package/dist/packages/work/src/bundle/types.js +1 -0
- package/dist/packages/work/src/consumed-verifier.d.ts +45 -0
- package/dist/packages/work/src/consumed-verifier.js +205 -0
- package/dist/packages/work/src/credentials/owenloop.d.ts +11 -0
- package/dist/packages/work/src/credentials/owenloop.js +28 -0
- package/dist/packages/work/src/credentials/reader.d.ts +36 -0
- package/dist/packages/work/src/credentials/reader.js +32 -0
- package/dist/packages/work/src/credentials/resolve.d.ts +19 -0
- package/dist/packages/work/src/credentials/resolve.js +56 -0
- package/dist/packages/work/src/exec/instructions.d.ts +99 -0
- package/dist/packages/work/src/exec/instructions.js +323 -0
- package/dist/packages/work/src/exec/loop.d.ts +40 -0
- package/dist/packages/work/src/exec/loop.js +332 -0
- package/dist/packages/work/src/exec/payload.d.ts +29 -0
- package/dist/packages/work/src/exec/payload.js +54 -0
- package/dist/packages/work/src/exec/receipt.d.ts +41 -0
- package/dist/packages/work/src/exec/receipt.js +32 -0
- package/dist/packages/work/src/exec/runner.d.ts +71 -0
- package/dist/packages/work/src/exec/runner.js +256 -0
- package/dist/packages/work/src/harness/child-env.d.ts +100 -0
- package/dist/packages/work/src/harness/child-env.js +134 -0
- package/dist/packages/work/src/harness/claude.d.ts +140 -0
- package/dist/packages/work/src/harness/claude.js +837 -0
- package/dist/packages/work/src/harness/codex.d.ts +111 -0
- package/dist/packages/work/src/harness/codex.js +1024 -0
- package/dist/packages/work/src/harness/contract.d.ts +308 -0
- package/dist/packages/work/src/harness/contract.js +32 -0
- package/dist/packages/work/src/harness/fake.d.ts +59 -0
- package/dist/packages/work/src/harness/fake.js +91 -0
- package/dist/packages/work/src/harness/jsonrpc-stdio.d.ts +108 -0
- package/dist/packages/work/src/harness/jsonrpc-stdio.js +351 -0
- package/dist/packages/work/src/harness/permissions.d.ts +75 -0
- package/dist/packages/work/src/harness/permissions.js +182 -0
- package/dist/packages/work/src/harness/registry.d.ts +47 -0
- package/dist/packages/work/src/harness/registry.js +45 -0
- package/dist/packages/work/src/harness/session-store.d.ts +181 -0
- package/dist/packages/work/src/harness/session-store.js +523 -0
- package/dist/packages/work/src/harness/types.d.ts +29 -0
- package/dist/packages/work/src/harness/types.js +14 -0
- package/dist/packages/work/src/harnesses.d.ts +38 -0
- package/dist/packages/work/src/harnesses.js +38 -0
- package/dist/packages/work/src/hold/loop.d.ts +36 -0
- package/dist/packages/work/src/hold/loop.js +23 -0
- package/dist/packages/work/src/hold/mcp.d.ts +75 -0
- package/dist/packages/work/src/hold/mcp.js +264 -0
- package/dist/packages/work/src/hub/client.d.ts +23 -0
- package/dist/packages/work/src/hub/client.js +91 -0
- package/dist/packages/work/src/hub/types.d.ts +326 -0
- package/dist/packages/work/src/hub/types.js +26 -0
- package/dist/packages/work/src/lease/loop.d.ts +94 -0
- package/dist/packages/work/src/lease/loop.js +277 -0
- package/dist/packages/work/src/main.d.ts +1 -0
- package/dist/packages/work/src/main.js +48 -0
- package/dist/packages/work/src/mcp/server.d.ts +125 -0
- package/dist/packages/work/src/mcp/server.js +320 -0
- package/dist/packages/work/src/owenloop-bin.d.ts +1 -0
- package/dist/packages/work/src/owenloop-bin.js +18 -0
- package/dist/packages/work/src/roles/agent-run.d.ts +124 -0
- package/dist/packages/work/src/roles/agent-run.js +529 -0
- package/dist/packages/work/src/roles/exec.d.ts +48 -0
- package/dist/packages/work/src/roles/exec.js +228 -0
- package/dist/packages/work/src/roles/hold.d.ts +72 -0
- package/dist/packages/work/src/roles/hold.js +363 -0
- package/dist/packages/work/src/roles/join.d.ts +18 -0
- package/dist/packages/work/src/roles/join.js +204 -0
- package/dist/packages/work/src/roles/lint.d.ts +58 -0
- package/dist/packages/work/src/roles/lint.js +234 -0
- package/dist/packages/work/src/roles/prepare.d.ts +1 -0
- package/dist/packages/work/src/roles/prepare.js +249 -0
- package/dist/packages/work/src/roles/release.d.ts +48 -0
- package/dist/packages/work/src/roles/release.js +137 -0
- package/dist/packages/work/src/roles/sessions.d.ts +61 -0
- package/dist/packages/work/src/roles/sessions.js +180 -0
- package/dist/packages/work/src/roles/settings.d.ts +6 -0
- package/dist/packages/work/src/roles/settings.js +71 -0
- package/dist/packages/work/src/roles/shift.d.ts +13 -0
- package/dist/packages/work/src/roles/shift.js +250 -0
- package/dist/packages/work/src/roles/signals.d.ts +55 -0
- package/dist/packages/work/src/roles/signals.js +62 -0
- package/dist/packages/work/src/settings/provision.d.ts +21 -0
- package/dist/packages/work/src/settings/provision.js +47 -0
- package/dist/packages/work/src/settings/settings.d.ts +136 -0
- package/dist/packages/work/src/settings/settings.js +155 -0
- package/dist/packages/work/src/shift/client.d.ts +24 -0
- package/dist/packages/work/src/shift/client.js +124 -0
- package/dist/packages/work/src/shift/loop.d.ts +131 -0
- package/dist/packages/work/src/shift/loop.js +751 -0
- package/dist/packages/work/src/shift/protocol.d.ts +95 -0
- package/dist/packages/work/src/shift/protocol.js +24 -0
- package/dist/packages/work/src/shift/routing.d.ts +35 -0
- package/dist/packages/work/src/shift/routing.js +50 -0
- package/dist/packages/work/src/shift/runtime.d.ts +45 -0
- package/dist/packages/work/src/shift/runtime.js +337 -0
- package/dist/packages/work/src/shift/server.d.ts +23 -0
- package/dist/packages/work/src/shift/server.js +716 -0
- package/dist/packages/work/src/shift/spawn.d.ts +109 -0
- package/dist/packages/work/src/shift/spawn.js +158 -0
- package/dist/packages/work/src/shift/state.d.ts +79 -0
- package/dist/packages/work/src/shift/state.js +385 -0
- package/dist/packages/work/src/submit-proof.d.ts +36 -0
- package/dist/packages/work/src/submit-proof.js +93 -0
- package/dist/packages/work/src/usage.d.ts +6 -0
- package/dist/packages/work/src/usage.js +175 -0
- package/dist/src/add.d.ts +189 -0
- package/dist/src/add.js +300 -0
- package/dist/src/archive.d.ts +97 -0
- package/dist/src/archive.js +591 -0
- package/dist/src/bundle/index.d.ts +64 -0
- package/dist/src/bundle/index.js +508 -0
- package/dist/src/bundle/manifest.d.ts +50 -0
- package/dist/src/bundle/manifest.js +435 -0
- package/dist/src/bundle/runtime.d.ts +26 -0
- package/dist/src/bundle/runtime.js +64 -0
- package/dist/src/bundle/tar.d.ts +62 -0
- package/dist/src/bundle/tar.js +238 -0
- package/dist/src/bundle/types.d.ts +105 -0
- package/dist/src/bundle/types.js +21 -0
- package/dist/{cli.d.ts → src/cli.d.ts} +92 -7
- package/dist/src/cli.js +5968 -0
- package/dist/{credentials.d.ts → src/credentials.d.ts} +22 -15
- package/dist/{credentials.js → src/credentials.js} +35 -31
- package/dist/src/crypto/allowed-signers.d.ts +68 -0
- package/dist/src/crypto/allowed-signers.js +307 -0
- package/dist/src/crypto/canonical.d.ts +8 -0
- package/dist/src/crypto/canonical.js +92 -0
- package/dist/src/crypto/chain.d.ts +65 -0
- package/dist/src/crypto/chain.js +377 -0
- package/dist/src/crypto/dsse.d.ts +209 -0
- package/dist/src/crypto/dsse.js +282 -0
- package/dist/src/crypto/enrollment.d.ts +78 -0
- package/dist/src/crypto/enrollment.js +186 -0
- package/dist/src/crypto/index.d.ts +48 -0
- package/dist/src/crypto/index.js +44 -0
- package/dist/src/crypto/keys.d.ts +258 -0
- package/dist/src/crypto/keys.js +908 -0
- package/dist/src/crypto/org-root.d.ts +33 -0
- package/dist/src/crypto/org-root.js +78 -0
- package/dist/src/crypto/origin-rules.d.ts +56 -0
- package/dist/src/crypto/origin-rules.js +143 -0
- package/dist/src/crypto/policy-floor.d.ts +98 -0
- package/dist/src/crypto/policy-floor.js +353 -0
- package/dist/src/crypto/records.d.ts +316 -0
- package/dist/src/crypto/records.js +157 -0
- package/dist/src/crypto/scope.d.ts +49 -0
- package/dist/src/crypto/scope.js +83 -0
- package/dist/src/crypto/ssh.d.ts +171 -0
- package/dist/src/crypto/ssh.js +396 -0
- package/dist/src/crypto/submission.d.ts +33 -0
- package/dist/src/crypto/submission.js +47 -0
- package/dist/src/crypto/trust-roots.d.ts +29 -0
- package/dist/src/crypto/trust-roots.js +39 -0
- package/dist/src/crypto/verify-consumed.d.ts +67 -0
- package/dist/src/crypto/verify-consumed.js +259 -0
- package/dist/src/crypto/verify-origin.d.ts +50 -0
- package/dist/src/crypto/verify-origin.js +151 -0
- package/dist/src/crypto/verify-publication.d.ts +60 -0
- package/dist/src/crypto/verify-publication.js +150 -0
- package/dist/{defs.d.ts → src/defs.d.ts} +24 -1
- package/dist/{defs.js → src/defs.js} +181 -61
- package/dist/{engine.d.ts → src/engine.d.ts} +105 -9
- package/dist/{engine.js → src/engine.js} +251 -47
- package/dist/{factory.d.ts → src/factory.d.ts} +16 -0
- package/dist/{factory.js → src/factory.js} +16 -4
- package/dist/src/global-config.d.ts +59 -0
- package/dist/src/global-config.js +84 -0
- package/dist/{hub.d.ts → src/hub.d.ts} +280 -31
- package/dist/{hub.js → src/hub.js} +493 -52
- package/dist/src/index.d.ts +47 -0
- package/dist/src/index.js +41 -0
- package/dist/src/install.d.ts +538 -0
- package/dist/src/install.js +1981 -0
- package/dist/src/lock.d.ts +38 -0
- package/dist/src/lock.js +325 -0
- package/dist/src/mcp/serve.d.ts +109 -0
- package/dist/{mcp → src/mcp}/serve.js +335 -75
- package/dist/{mcp → src/mcp}/server.d.ts +6 -9
- package/dist/{mcp → src/mcp}/server.js +18 -10
- package/dist/{model.d.ts → src/model.d.ts} +15 -0
- package/dist/{model.js → src/model.js} +112 -2
- package/dist/src/order-resolver.d.ts +184 -0
- package/dist/src/order-resolver.js +252 -0
- package/dist/src/package-version.d.ts +10 -0
- package/dist/src/package-version.js +42 -0
- package/dist/{paths.d.ts → src/paths.d.ts} +14 -1
- package/dist/{paths.js → src/paths.js} +18 -0
- package/dist/src/schemas/enrollment-grant.v1.schema.json +90 -0
- package/dist/src/schemas/index.d.ts +1416 -0
- package/dist/src/schemas/index.js +31 -0
- package/dist/src/schemas/order.v1.schema.json +106 -0
- package/dist/src/schemas/origin.v1.schema.json +68 -0
- package/dist/src/schemas/policy-floor.v1.schema.json +29 -0
- package/dist/src/schemas/publication.v1.schema.json +31 -0
- package/dist/src/schemas/revocation.v1.schema.json +39 -0
- package/dist/src/schemas/submission.v1.schema.json +61 -0
- package/dist/src/store/def-source.d.ts +52 -0
- package/dist/src/store/def-source.js +335 -0
- package/dist/src/store/index-file.d.ts +69 -0
- package/dist/src/store/index-file.js +151 -0
- package/dist/src/store/index.d.ts +27 -0
- package/dist/src/store/index.js +22 -0
- package/dist/src/store/ingestor.d.ts +43 -0
- package/dist/src/store/ingestor.js +211 -0
- package/dist/src/store/install.d.ts +228 -0
- package/dist/src/store/install.js +555 -0
- package/dist/src/store/instruction-source.d.ts +49 -0
- package/dist/src/store/instruction-source.js +298 -0
- package/dist/src/store/origin-evidence.d.ts +21 -0
- package/dist/src/store/origin-evidence.js +66 -0
- package/dist/src/store/pre-commit-verifier.d.ts +68 -0
- package/dist/src/store/pre-commit-verifier.js +418 -0
- package/dist/src/store/resolve.d.ts +138 -0
- package/dist/src/store/resolve.js +363 -0
- package/dist/src/store/types.d.ts +288 -0
- package/dist/src/store/types.js +356 -0
- package/dist/{types.d.ts → src/types.d.ts} +58 -24
- package/dist/{untar.d.ts → src/untar.d.ts} +8 -23
- package/dist/src/untar.js +38 -0
- package/dist/{util.d.ts → src/util.d.ts} +3 -2
- package/dist/{util.js → src/util.js} +3 -2
- package/dist/{owenwork.d.ts → src/work-settings.d.ts} +22 -22
- package/dist/{owenwork.js → src/work-settings.js} +27 -27
- package/docs/agent-runner.md +86 -0
- package/docs/authoring.md +150 -59
- package/docs/bundles.md +250 -0
- package/docs/cli.md +1758 -163
- package/docs/crypto.md +816 -0
- package/docs/design.md +374 -52
- package/docs/embedding.md +135 -27
- package/docs/wire-contracts.md +380 -0
- package/examples/workflows/{command-worker.yaml → command-executor.yaml} +15 -15
- package/examples/workflows/compile-dev-playbook.yaml +338 -0
- package/examples/workflows/judges/gate-sharpness.md +39 -0
- package/examples/workflows/judges/security.md +34 -0
- package/package.json +22 -8
- package/plugins/claude-code/.claude-plugin/marketplace.json +14 -0
- package/plugins/claude-code/plugin/.claude-plugin/plugin.json +8 -0
- package/plugins/claude-code/plugin/.mcp.json +14 -0
- package/plugins/claude-code/plugin/hooks/hooks.json +26 -0
- package/plugins/claude-code/plugin/hooks/session-end.sh +40 -0
- package/plugins/claude-code/plugin/hooks/session-start.sh +52 -0
- package/plugins/claude-code/plugin/skills/author/SKILL.md +181 -0
- package/plugins/claude-code/plugin/skills/conduct/SKILL.md +106 -0
- package/plugins/claude-code/plugin/skills/shift/SKILL.md +105 -0
- package/plugins/codex/.agents/plugins/marketplace.json +21 -0
- package/plugins/codex/plugins/owenloop/.codex-plugin/plugin.json +7 -0
- package/plugins/codex/plugins/owenloop/.mcp.json +20 -0
- package/plugins/codex/plugins/owenloop/hooks/hooks.json +26 -0
- package/plugins/codex/plugins/owenloop/hooks/session-end.sh +40 -0
- package/plugins/codex/plugins/owenloop/hooks/session-start.sh +52 -0
- package/plugins/codex/plugins/owenloop/skills/author/SKILL.md +181 -0
- package/plugins/codex/plugins/owenloop/skills/conduct/SKILL.md +106 -0
- package/plugins/codex/plugins/owenloop/skills/shift/SKILL.md +105 -0
- package/dist/add.d.ts +0 -384
- package/dist/add.js +0 -834
- package/dist/cli.js +0 -3270
- package/dist/index.d.ts +0 -32
- package/dist/index.js +0 -23
- package/dist/lock.d.ts +0 -80
- package/dist/lock.js +0 -217
- package/dist/mcp/serve.d.ts +0 -84
- package/dist/untar.js +0 -164
- /package/dist/{schema.d.ts → src/schema.d.ts} +0 -0
- /package/dist/{schema.js → src/schema.js} +0 -0
- /package/dist/{store.d.ts → src/store.d.ts} +0 -0
- /package/dist/{store.js → src/store.js} +0 -0
- /package/dist/{types.js → src/types.js} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,77 @@ All notable changes to this project are documented here. The format is based on
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
|
|
5
5
|
adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
|
7
|
+
## [0.5.1](https://github.com/typicalday/owenloop/compare/v0.5.0...v0.5.1) (2026-08-12)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
### Features
|
|
11
|
+
|
|
12
|
+
* add bundle runtime compatibility requirements ([#137](https://github.com/typicalday/owenloop/issues/137)) ([6a241a3](https://github.com/typicalday/owenloop/commit/6a241a34f516da820e1dda5fd6953c28993ea1f5))
|
|
13
|
+
* add CLI/plugin compatibility checks ([#109](https://github.com/typicalday/owenloop/issues/109)) ([8f0b0b9](https://github.com/typicalday/owenloop/commit/8f0b0b9c2f8179ac316772fcbf61d5efe4fa9019))
|
|
14
|
+
* add command payload and judge reject transport ([#126](https://github.com/typicalday/owenloop/issues/126)) ([847a1fa](https://github.com/typicalday/owenloop/commit/847a1fabdd41ba7a021b967ba0c55e5f25526bb5))
|
|
15
|
+
* add deterministic workflow bundles ([#106](https://github.com/typicalday/owenloop/issues/106)) ([dfc598b](https://github.com/typicalday/owenloop/commit/dfc598b1ecf040d4c635cdb52443bdb0191f398b))
|
|
16
|
+
* add enrollment chain validation, attenuation, and revocation ([#117](https://github.com/typicalday/owenloop/issues/117)) ([2bc10c8](https://github.com/typicalday/owenloop/commit/2bc10c8226fe4960e9655e3672ebd0a17a7ed512))
|
|
17
|
+
* add signed origin records for published bundles ([#119](https://github.com/typicalday/owenloop/issues/119)) ([a5fbd8f](https://github.com/typicalday/owenloop/commit/a5fbd8fd5b5cec199e3028e8784a13662dcae58e))
|
|
18
|
+
* add signed submission records ([#121](https://github.com/typicalday/owenloop/issues/121)) ([f171227](https://github.com/typicalday/owenloop/commit/f171227a8ca1bf4f4f0c84edecf482c245ab203e))
|
|
19
|
+
* add signed workflow bundle publication ([#112](https://github.com/typicalday/owenloop/issues/112)) ([224f7a8](https://github.com/typicalday/owenloop/commit/224f7a834c747d954d1cf77316f0066e5252f09e))
|
|
20
|
+
* add SSHSIG signing, DSSE envelopes, and principal keys ([#102](https://github.com/typicalday/owenloop/issues/102)) ([5125545](https://github.com/typicalday/owenloop/commit/51255459ac21012365b6984d444efc0ae51dfa15))
|
|
21
|
+
* add v2 multi-workflow delivery bundles ([#127](https://github.com/typicalday/owenloop/issues/127)) ([26a59d7](https://github.com/typicalday/owenloop/commit/26a59d7bb9728fd4936d8d4eb2b2bb158983ff89))
|
|
22
|
+
* converge Claude Code and Codex plugins ([#113](https://github.com/typicalday/owenloop/issues/113)) ([1c6623d](https://github.com/typicalday/owenloop/commit/1c6623dff9649a4311382fa34c4bc6ac489a4f9f))
|
|
23
|
+
* enforce harness policy ([4f8796f](https://github.com/typicalday/owenloop/commit/4f8796f6415a486aad92725eec842d8a22e504f8))
|
|
24
|
+
* enforce local workflow instruction resolution ([#111](https://github.com/typicalday/owenloop/issues/111)) ([c5827d7](https://github.com/typicalday/owenloop/commit/c5827d7dd248ebc49a3a199dd8f1231249f280b5))
|
|
25
|
+
* enforce workflow origin policy at install and execution ([#122](https://github.com/typicalday/owenloop/issues/122)) ([d91e881](https://github.com/typicalday/owenloop/commit/d91e881583efabbe1efe3427d3fc69fd20f1d6fc))
|
|
26
|
+
* enforce workflow publication trust at install and execution ([#114](https://github.com/typicalday/owenloop/issues/114)) ([3b0d931](https://github.com/typicalday/owenloop/commit/3b0d931f6b37ca48b6c50a5b33a8b461e3410b8b))
|
|
27
|
+
* expose installed bundle assets to workers ([#125](https://github.com/typicalday/owenloop/issues/125)) ([2c8b498](https://github.com/typicalday/owenloop/commit/2c8b4981c1a395b78205c8b076893ac3efa4416f))
|
|
28
|
+
* expose run identity to command children ([#131](https://github.com/typicalday/owenloop/issues/131)) ([e7e18c1](https://github.com/typicalday/owenloop/commit/e7e18c1a84ce772fac80dfb493f267d7fbd8cde2))
|
|
29
|
+
* freeze launch wire contracts ([#110](https://github.com/typicalday/owenloop/issues/110)) ([571a8f9](https://github.com/typicalday/owenloop/commit/571a8f90532d90e3db786890885d31d3446edf21))
|
|
30
|
+
* reference-mode orders — instructions resolve by defDigest (WP-B1) ([#101](https://github.com/typicalday/owenloop/issues/101)) ([5e4071e](https://github.com/typicalday/owenloop/commit/5e4071ee5e56753cbcc330ac3c0b749518355ffc))
|
|
31
|
+
* register signed machine enrollments ([#116](https://github.com/typicalday/owenloop/issues/116)) ([25ef244](https://github.com/typicalday/owenloop/commit/25ef2442de6277001c24b9e375513bfcb20a0ef1))
|
|
32
|
+
* resolve agent model tiers and retry escalation ([#128](https://github.com/typicalday/owenloop/issues/128)) ([3098494](https://github.com/typicalday/owenloop/commit/3098494f2d34c3abdbe7ae2adee0deb73156f9b8))
|
|
33
|
+
* resolve CAS bundle workflows through calls: ([#130](https://github.com/typicalday/owenloop/issues/130)) ([444b868](https://github.com/typicalday/owenloop/commit/444b868f50b37e2e377976a935bf17ea60fe6190))
|
|
34
|
+
* ship Claude Code plugin pack ([#104](https://github.com/typicalday/owenloop/issues/104)) ([a76bea7](https://github.com/typicalday/owenloop/commit/a76bea789eaa78599b8ed23f590f5f559b907279))
|
|
35
|
+
* ship the Codex plugin tree and launch the plugin MCP server from PATH ([#107](https://github.com/typicalday/owenloop/issues/107)) ([d165d28](https://github.com/typicalday/owenloop/commit/d165d284d125304321b3c5d10a304cc3d606e0e3))
|
|
36
|
+
* support dynamic workdirs from consumed artifacts ([#129](https://github.com/typicalday/owenloop/issues/129)) ([6c4ada1](https://github.com/typicalday/owenloop/commit/6c4ada1478e4a2c1468c1565a6542ae3936ac383))
|
|
37
|
+
* two-level content-addressed workflow store with .wnlp bundle installs ([#103](https://github.com/typicalday/owenloop/issues/103)) ([029d06c](https://github.com/typicalday/owenloop/commit/029d06cfebcad2aeff20350a0f9c83402ede1b3a))
|
|
38
|
+
* verify admin-signed org policy floors and merge them as a strictness floor ([#120](https://github.com/typicalday/owenloop/issues/120)) ([da381b3](https://github.com/typicalday/owenloop/commit/da381b36d160de02a967926da71a6da6c19b21b8))
|
|
39
|
+
* verify consumed artifact values and producer enrollment at the driver boundary ([#123](https://github.com/typicalday/owenloop/issues/123)) ([9629d14](https://github.com/typicalday/owenloop/commit/9629d1444e5576629336dfbc31dcc3d1b0297a4c))
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
### Bug Fixes
|
|
43
|
+
|
|
44
|
+
* allow packaged plugins through npm publish gate ([#139](https://github.com/typicalday/owenloop/issues/139)) ([ef83b67](https://github.com/typicalday/owenloop/commit/ef83b67c5f491783c9d88b2f3fa0fa0c4ef2c582))
|
|
45
|
+
* inherit producer policy in native judges ([152eee1](https://github.com/typicalday/owenloop/commit/152eee148b1d269b45f5bb2ef4fae92efe830007))
|
|
46
|
+
* lock plugin manifest versions to package ([#108](https://github.com/typicalday/owenloop/issues/108)) ([8c2a93e](https://github.com/typicalday/owenloop/commit/8c2a93ea9f92293ac06c578d54384c381dd52f42))
|
|
47
|
+
* make hosted Shift delivery reliable ([#132](https://github.com/typicalday/owenloop/issues/132)) ([a8e3fc3](https://github.com/typicalday/owenloop/commit/a8e3fc318d581cb858b81d627d6b237ae8c9c757))
|
|
48
|
+
* resolve publishing hubs without project bindings ([#133](https://github.com/typicalday/owenloop/issues/133)) ([15795fd](https://github.com/typicalday/owenloop/commit/15795fda0f3c4835aacaeb0e905bfb1495ac2783))
|
|
49
|
+
* resolve the MCP hub origin from config instead of enumerating the credential store ([#118](https://github.com/typicalday/owenloop/issues/118)) ([07c140d](https://github.com/typicalday/owenloop/commit/07c140db6ba7169cba68eb09034dc23c70fdba28))
|
|
50
|
+
* select workflow versions deterministically ([#138](https://github.com/typicalday/owenloop/issues/138)) ([85e17c1](https://github.com/typicalday/owenloop/commit/85e17c149a1181ba745fd701d6a46be9dfcf5d05))
|
|
51
|
+
|
|
52
|
+
## [0.5.0](https://github.com/typicalday/owenloop/compare/v0.4.1...v0.5.0) (2026-08-04)
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
### ⚠ BREAKING CHANGES
|
|
56
|
+
|
|
57
|
+
* **cli:** fold owenwork execution CLI into owenloop work ([#91](https://github.com/typicalday/owenloop/issues/91))
|
|
58
|
+
* **cli:** `owenloop binding rm` now requires a `<pool>` argument (`owenloop binding rm <label> <pool>`), and both `binding new` and `binding rm` print new stdout shapes. `binding new` no longer reports `previousPool`; scripts that read it must use `alreadyBound` / `boundPoolCount` instead. The CLI now requires a hub serving `add_label_binding` and `remove_label_binding`.
|
|
59
|
+
|
|
60
|
+
### Features
|
|
61
|
+
|
|
62
|
+
* add durable shift daemon ([#92](https://github.com/typicalday/owenloop/issues/92)) ([2c68808](https://github.com/typicalday/owenloop/commit/2c6880891d904067071904a3cfda8461ffc2587d))
|
|
63
|
+
* **cli,mcp:** selectable scopes for agent-identity minting ([#83](https://github.com/typicalday/owenloop/issues/83)) ([f9b7a55](https://github.com/typicalday/owenloop/commit/f9b7a559e9ab8f27bdaf15cf26dd6dcc8968c6a4))
|
|
64
|
+
* **cli:** fold owenwork execution CLI into owenloop work ([#91](https://github.com/typicalday/owenloop/issues/91)) ([1ed865a](https://github.com/typicalday/owenloop/commit/1ed865ae6d03cbb176d81e26f2ecce60a5cebd1c))
|
|
65
|
+
* **cli:** migrate binding commands to many-to-many label bindings ([6ba3cc2](https://github.com/typicalday/owenloop/commit/6ba3cc254f8874f8cb734d596b1b6d267c4b5946))
|
|
66
|
+
* **cli:** owenloop binding new|rm|list — label→pool bindings + author docs ([#85](https://github.com/typicalday/owenloop/issues/85)) ([c561861](https://github.com/typicalday/owenloop/commit/c561861c208d96d576997939e33063db8de1670b))
|
|
67
|
+
* **cli:** owenloop pool new|rm|list, pool member add|rm ([#88](https://github.com/typicalday/owenloop/issues/88)) ([8ad5fab](https://github.com/typicalday/owenloop/commit/8ad5fabc454650fed6f006b8b3b55d001d102d85))
|
|
68
|
+
* **mcp:** add pool tools (list_pools/create_pool/add_pool_member/remove_pool_member) ([#89](https://github.com/typicalday/owenloop/issues/89)) ([be2d667](https://github.com/typicalday/owenloop/commit/be2d6678d7da6de14bdb1a90f99c5077f1b95c86))
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
### Bug Fixes
|
|
72
|
+
|
|
73
|
+
* **cli:** unify add/push/check's definite-defect predicate via shared helper ([#81](https://github.com/typicalday/owenloop/issues/81)) ([0a43b99](https://github.com/typicalday/owenloop/commit/0a43b99bf3f7b615d74fe4f3780b775adf8c12a8))
|
|
74
|
+
* correct three vocabulary defects found in post-merge audit ([b43f5f6](https://github.com/typicalday/owenloop/commit/b43f5f696d74e35244ed7a355dcf106ad386f53b))
|
|
75
|
+
* **mcp:** sync presence_ping/list_conductors doc-text with hub behavior (W9.4) ([#87](https://github.com/typicalday/owenloop/issues/87)) ([72fc488](https://github.com/typicalday/owenloop/commit/72fc488c2fab055e64951482ff625483bdb927f1))
|
|
76
|
+
* repair and promote compile-dev-playbook, drop stray FUNDING.yml ([#99](https://github.com/typicalday/owenloop/issues/99)) ([7c78094](https://github.com/typicalday/owenloop/commit/7c780945841eb41467d508cac864b3262d5a8f38))
|
|
77
|
+
|
|
7
78
|
## [0.4.1](https://github.com/typicalday/owenloop/compare/v0.4.0...v0.4.1) (2026-07-22)
|
|
8
79
|
|
|
9
80
|
|
package/README.md
CHANGED
|
@@ -48,11 +48,11 @@ steps:
|
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
You don't drive this by hand. An orchestrator — an agent skill, a plain
|
|
51
|
-
`while` loop, your own code — ticks the engine, hands each job to
|
|
51
|
+
`while` loop, your own code — ticks the engine, hands each job to a Step Agent,
|
|
52
52
|
and reports results back. Here's what the engine enforces as that loop runs:
|
|
53
53
|
|
|
54
54
|
1. **The writer cannot start early.** The first tick emits exactly one order —
|
|
55
|
-
the researcher's. There is no writer job to hand out, so no eager
|
|
55
|
+
the researcher's. There is no writer job to hand out, so no eager Step Agent can
|
|
56
56
|
write a report from findings that don't exist. The hope version is a
|
|
57
57
|
prompt: *"wait until research is complete before writing."*
|
|
58
58
|
|
|
@@ -63,7 +63,7 @@ and reports results back. Here's what the engine enforces as that loop runs:
|
|
|
63
63
|
|
|
64
64
|
3. **The report can't approve itself.** When the writer commits `report`, it
|
|
65
65
|
lands in `submitted`, not done. The reviewer is a separate order to a
|
|
66
|
-
separate
|
|
66
|
+
separate Step Agent — one that never saw the writer's reasoning. A rejection
|
|
67
67
|
re-arms the writer with the reviewer's reasons attached to its next job.
|
|
68
68
|
The hope version: *"review your work before finishing"* — the fox
|
|
69
69
|
auditing the henhouse.
|
|
@@ -140,7 +140,7 @@ Two things make this more than running steps in dependency order:
|
|
|
140
140
|
the inputs it was built from are still green and unchanged. Re-run an early step and
|
|
141
141
|
everything built on it quietly falls back to a debt — no code required to invalidate it.
|
|
142
142
|
- **Rejections carry reasons.** When a reviewer rejects an output, the text rides along.
|
|
143
|
-
The next job for the producer shows *why* it's being asked again, so the
|
|
143
|
+
The next job for the producer shows *why* it's being asked again, so the Step Agent has
|
|
144
144
|
the feedback in hand. (Three flavors: a reviewer's **judgment**, the engine's own
|
|
145
145
|
**schema** refusal of a malformed value, and **structural** knock-backs from a
|
|
146
146
|
change cascading downstream.)
|
|
@@ -158,10 +158,11 @@ Two things make this more than running steps in dependency order:
|
|
|
158
158
|
*width* — a producer can emit any number of elements — but the wiring graph
|
|
159
159
|
itself (which steps exist, what each consumes and produces) is fixed when
|
|
160
160
|
the definition loads, not mutable while an instance runs.
|
|
161
|
-
- **Not a command runner.** `
|
|
162
|
-
|
|
163
|
-
the engine never shells out, executes, or interprets
|
|
164
|
-
anything is always the dispatcher's job, on the other
|
|
161
|
+
- **Not a command runner.** `executor:`/`command:` declare which kind of
|
|
162
|
+
worker an order is for (`Order.worker`) and what command text a worker
|
|
163
|
+
resolves for it — the engine never shells out, executes, or interprets
|
|
164
|
+
it. Actually running anything is always the dispatcher's job, on the other
|
|
165
|
+
side of `tick`.
|
|
165
166
|
|
|
166
167
|
---
|
|
167
168
|
|
|
@@ -247,7 +248,7 @@ to a human, or run a compensating step instead of silently re-firing. See
|
|
|
247
248
|
|
|
248
249
|
`model: fast | standard | strong | strongest` declares intent, not a vendor
|
|
249
250
|
id — the engine passes it through untouched to whatever dispatches your
|
|
250
|
-
|
|
251
|
+
Step Agents. A portable workflow says "this step needs strong judgment"; the
|
|
251
252
|
host binds that to whatever model it runs on. `strong` is a high-capability
|
|
252
253
|
workhorse tier, not the host's single most capable model — that's what the
|
|
253
254
|
opt-in `strongest` tier is for, reserved for the rare step where nothing less
|
|
@@ -256,17 +257,22 @@ will do. See
|
|
|
256
257
|
|
|
257
258
|
### Worker dispatch
|
|
258
259
|
|
|
259
|
-
`
|
|
260
|
-
is for — the
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
260
|
+
`executor: agent | command | …` declares which kind of worker a step's order
|
|
261
|
+
is for — the authored value lands on the order as `Order.worker`, and the
|
|
262
|
+
default (`agent`, silent when omitted) is unaffected; every def written
|
|
263
|
+
before this feature stays byte for byte the same. Opt a step into
|
|
264
|
+
`executor: command` and give it a `command:` string to switch it to a
|
|
265
|
+
deterministic worker instead of an LLM — the engine never runs it; your
|
|
266
|
+
dispatcher branches on `order.worker` and resolves the authored command text
|
|
267
|
+
from the local workflow store through the order's `defDigest` at the
|
|
268
|
+
`(defDigest, step, key)` boundary. The packet itself carries no command text:
|
|
269
|
+
a command worker must refuse when the digest or command cannot be resolved and
|
|
270
|
+
must never spawn from transport-supplied text. An optional `spec:` map carries
|
|
271
|
+
further opaque config (a timeout, a working directory), and a judge entry
|
|
272
|
+
accepts the same fields, so a quality gate can be a script's exit code instead
|
|
273
|
+
of a verdict. See
|
|
274
|
+
[`docs/authoring.md`](docs/authoring.md#executor--declaring-the-executor) and
|
|
275
|
+
[`command-executor.yaml`](examples/workflows/command-executor.yaml).
|
|
270
276
|
|
|
271
277
|
### Event subscription — for embedding
|
|
272
278
|
|
|
@@ -275,6 +281,51 @@ pushes a typed event the instant a mutation commits, so a host can react
|
|
|
275
281
|
instead of ticking on a timer. See [Embedding it](#embedding-it) and
|
|
276
282
|
[`docs/embedding.md`](docs/embedding.md).
|
|
277
283
|
|
|
284
|
+
### Shared workflows — the content-addressed store
|
|
285
|
+
|
|
286
|
+
Workflow definitions are shared, not hand-copied. Two install routes land
|
|
287
|
+
them in the tree, both all-or-nothing with crash recovery:
|
|
288
|
+
|
|
289
|
+
- **GitHub repos** — `owenloop add <owner>/<repo>[@ref]` fetches a public
|
|
290
|
+
repo's `workflows/**`, validates every def with the engine's strict pass,
|
|
291
|
+
and installs it under `<defsDir>/<owner>-<repo>-<hash>/`, recording
|
|
292
|
+
provenance (resolved commit sha) in `.owenloop/installed.json`.
|
|
293
|
+
- **Workflow bundles** — `owenloop add widget.wnlp [--global]` (a local
|
|
294
|
+
`.wnlp` file or an `https://` URL) installs into a **content-addressed
|
|
295
|
+
store**: the project store lives under the defs dir, `--global` installs
|
|
296
|
+
into `<home>/.owenloop/workflows`. Each store holds an `index.json` mapping
|
|
297
|
+
`namespace/name@version` coordinates to content digests, plus immutable
|
|
298
|
+
objects at `objects/sha256/<digest>/` — identical content deduplicates to
|
|
299
|
+
one object, and an object's identity is its digest alone (never its name
|
|
300
|
+
or source). Objects are hardened read-only in place, and every resolution
|
|
301
|
+
re-verifies the bytes before returning a path. Execution workers resolve
|
|
302
|
+
static prompt and command text from those verified local objects by the
|
|
303
|
+
order's `defDigest`; a remote packet cannot substitute instruction text.
|
|
304
|
+
|
|
305
|
+
The bundle route derives `<home>` from the first non-blank caller-injected
|
|
306
|
+
`HOME` or `USERPROFILE` value (`HOME` wins), and uses that home for the default
|
|
307
|
+
recovery-marker directory. A bundle install refuses when neither variable is
|
|
308
|
+
supplied rather than falling back to the process user's ambient home.
|
|
309
|
+
|
|
310
|
+
Bundle installs fail closed without their two required adapters (bundle
|
|
311
|
+
ingestion and pre-commit verification). The default CLI binds the real
|
|
312
|
+
bundle ingestor, so a `.wnlp` produced by `packBundle` reaches the normal
|
|
313
|
+
entrypoint-aware install validation; the pre-commit verifier remains unbound,
|
|
314
|
+
so the CLI still fails closed rather than accepting an unverified bundle. There
|
|
315
|
+
is no default accepting signature verifier; the `add` route does not consume
|
|
316
|
+
publication sidecars or verify a bundle's signature. Use `owenloop publish` to
|
|
317
|
+
create the `.wnlp` bundle plus a signed publication sidecar and optional signed
|
|
318
|
+
origin sidecar, or an explicitly unsigned marker.
|
|
319
|
+
`--global` applies only to `.wnlp` bundle sources; a GitHub source with `--global`
|
|
320
|
+
is refused before any network request. Resolution is
|
|
321
|
+
deliberately split: execution resolves by **digest only** (project first,
|
|
322
|
+
fall-through to global only when the project object is absent — a corrupt
|
|
323
|
+
project object is a hard error, never masked by a global copy), while
|
|
324
|
+
human-facing lookups resolve by **coordinate** and surface a structured
|
|
325
|
+
ambiguity error when the two levels disagree — never a silent project-first
|
|
326
|
+
pick. Full semantics:
|
|
327
|
+
[`docs/cli.md`](docs/cli.md#add-with-bundles--the-content-addressed-workflow-store).
|
|
328
|
+
|
|
278
329
|
---
|
|
279
330
|
|
|
280
331
|
## Driving it with a loop
|
|
@@ -295,14 +346,12 @@ looks like:
|
|
|
295
346
|
- **Your own harness** — a `while` loop, a cron job, a CI stage: tick, run
|
|
296
347
|
each order with whatever executes your work (an agent CLI, an API call, a
|
|
297
348
|
script), report, repeat. Fully deterministic dispatch if you want it —
|
|
298
|
-
see [Embedding it](#embedding-it) for the in-process version.
|
|
299
|
-
|
|
300
|
-
ships no host harness of its own.
|
|
301
|
-
- **An agent as the orchestrator** — point any tool-using agent (Claude Code,
|
|
349
|
+
see [Embedding it](#embedding-it) for the in-process version. The root `owenloop shift` command is the standing Shift runtime — the engine core still ships no host harness of its own.
|
|
350
|
+
- **A Prime Agent as the orchestrator** — point any tool-using agent (Claude Code,
|
|
302
351
|
Codex, Gemini CLI, anything that can run a shell command) at the CLI and
|
|
303
352
|
tell it to drive the instance to done. A slash command or skill that wraps
|
|
304
353
|
this turns "run the release workflow" into one line.
|
|
305
|
-
- **
|
|
354
|
+
- **A Prime Agent structuring its own work, inline** — mid-task, the Prime Agent authors
|
|
306
355
|
a throwaway workflow, drives itself through it, and deletes it: the engine
|
|
307
356
|
as scratch discipline rather than standing infrastructure.
|
|
308
357
|
|
|
@@ -323,14 +372,14 @@ patterns ready-made:
|
|
|
323
372
|
|
|
324
373
|
## Quick start
|
|
325
374
|
|
|
326
|
-
Install the owenloop skills for whatever
|
|
375
|
+
Install the owenloop skills for whatever Prime Agent you use — Claude Code, Codex,
|
|
327
376
|
Cursor, and most others:
|
|
328
377
|
|
|
329
378
|
```sh
|
|
330
379
|
npx skills add typicalday/owenloop
|
|
331
380
|
```
|
|
332
381
|
|
|
333
|
-
Then ask your
|
|
382
|
+
Then ask your Prime Agent for what you want:
|
|
334
383
|
|
|
335
384
|
> Use owenloop-author to build me a workflow that researches a topic, writes
|
|
336
385
|
> a report, and doesn't accept it until an independent reviewer signs off —
|
|
@@ -340,19 +389,72 @@ The skill interviews you for anything missing, writes and validates the YAML
|
|
|
340
389
|
definition, then conducts the instance to done — dispatching each order to a
|
|
341
390
|
fresh subagent, relaying knock-backs, and escalating stalls to you. Already
|
|
342
391
|
have a def? *"Conduct the report workflow"* hands it to
|
|
343
|
-
[`owenloop-conduct`](skills/owenloop-conduct/SKILL.md). The engine itself
|
|
344
|
-
|
|
345
|
-
|
|
392
|
+
[`owenloop-conduct`](skills/owenloop-conduct/SKILL.md). The engine itself is the
|
|
393
|
+
`owenloop` CLI (Node ≥ 22.13 required). Install the package so `owenloop` is on
|
|
394
|
+
`PATH`; the shipped Claude Code and Codex plugins launch that same command as
|
|
395
|
+
`owenloop mcp`, rather than using a separate npx-pinned server. The plugins
|
|
396
|
+
check the installed CLI/plugin version pair at session start when their hooks
|
|
397
|
+
are enabled, and the MCP server reports a readable mismatch error on tool calls; run `owenloop setup` when the versions differ. For one-off shell
|
|
398
|
+
use, `npx owenloop` still works — no clone, no build, no environment
|
|
399
|
+
variables, no CLI verbs to memorize. The same package also includes the
|
|
400
|
+
execution-side companion; use `owenloop work <subcommand>` for lower-level
|
|
401
|
+
execution tasks. There is no separate `owenwork` package or binary.
|
|
402
|
+
|
|
403
|
+
### Deterministic workflow bundles
|
|
404
|
+
|
|
405
|
+
A workflow and its referenced regular files can be packaged as one deterministic
|
|
406
|
+
`.wnlp` file. The package format uses a canonical POSIX/PAX tar stream wrapped
|
|
407
|
+
in gzip; the package digest is SHA-256 over the exact uncompressed canonical
|
|
408
|
+
tar, not over the gzip bytes. `bundle.yaml` carries package identity, platform
|
|
409
|
+
selectors, requested capabilities, generated per-file SHA-256 values, and
|
|
410
|
+
namespace-qualified, digest-pinned `calls:` references. `workflow.yaml` remains
|
|
411
|
+
the only execution definition.
|
|
412
|
+
|
|
413
|
+
```sh
|
|
414
|
+
owenloop bundle pack ./report --output ./report-1.2.0.wnlp
|
|
415
|
+
owenloop bundle inspect ./report-1.2.0.wnlp
|
|
416
|
+
owenloop bundle digest ./report-1.2.0.wnlp
|
|
417
|
+
owenloop bundle unpack ./report-1.2.0.wnlp ./unpacked-report
|
|
418
|
+
```
|
|
419
|
+
|
|
420
|
+
Bundle commands are filesystem-only: they do not open or create the local
|
|
421
|
+
`.owenloop/state.db` and do not contact a remote service. Packing never edits
|
|
422
|
+
the source manifest. Inspection and unpacking reject unsafe paths, symlinks,
|
|
423
|
+
unsupported archive entry types, malformed canonical headers, duplicate files,
|
|
424
|
+
invalid manifests, workflow/manifest name mismatches, missing lock entries, and
|
|
425
|
+
integrity mismatches before files are written. See the [bundle format
|
|
426
|
+
reference](docs/bundles.md) and the [CLI bundle commands](docs/cli.md#bundles).
|
|
427
|
+
|
|
428
|
+
For a foreground local shift, start the daemon in one terminal. Run the client
|
|
429
|
+
commands from another terminal:
|
|
430
|
+
|
|
431
|
+
```sh
|
|
432
|
+
# Terminal 1: foreground daemon
|
|
433
|
+
owenloop shift start alpha
|
|
434
|
+
|
|
435
|
+
# Terminal 2: client calls
|
|
436
|
+
owenloop shift next
|
|
437
|
+
owenloop shift status
|
|
438
|
+
owenloop shift end
|
|
439
|
+
```
|
|
440
|
+
|
|
441
|
+
`shift start` requires at least one named crew unless you pass `--all`
|
|
442
|
+
explicitly; `--all` serves all Crews for the Scoped Identity. `shift next` waits
|
|
443
|
+
up to 90 seconds by default. For flags, JSON output, daemon behavior, and exit
|
|
444
|
+
codes, see the [`shift` reference](docs/cli.md#shift--foreground-daemon-and-client).
|
|
346
445
|
|
|
347
446
|
**Want to see or drive the machinery yourself?** Everything above goes
|
|
348
447
|
through the same small CLI (`create`, `tick`, `green`, `reject`, …).
|
|
349
448
|
[`docs/cli.md`](docs/cli.md) has the full command reference and a hand-driven
|
|
350
449
|
walkthrough of a pipeline — including a rejection knock-back and a stall —
|
|
351
|
-
and [`examples/workflows`](examples/workflows) has
|
|
450
|
+
and [`examples/workflows`](examples/workflows) has seventeen runnable defs, from a
|
|
352
451
|
minimal review loop ([`delivery`](examples/workflows/delivery.yaml)) to a
|
|
353
|
-
full production line ([`ship`](examples/workflows/ship.yaml))
|
|
452
|
+
full production line ([`ship`](examples/workflows/ship.yaml)), a
|
|
354
453
|
collections-heavy research pipeline
|
|
355
|
-
([`research`](examples/workflows/research.yaml))
|
|
454
|
+
([`research`](examples/workflows/research.yaml)), and a compiler that turns
|
|
455
|
+
live vendor docs into a new gate-checked def
|
|
456
|
+
([`compile-dev-playbook`](examples/workflows/compile-dev-playbook.yaml)).
|
|
457
|
+
Full YAML grammar:
|
|
356
458
|
[`docs/authoring.md`](docs/authoring.md). Driving it from your own code:
|
|
357
459
|
[Embedding it](#embedding-it).
|
|
358
460
|
|
|
@@ -360,7 +462,7 @@ Want someone else's workflow defs instead of writing your own?
|
|
|
360
462
|
`owenloop add <owner>/<repo>` fetches a public GitHub repo's `workflows/**`,
|
|
361
463
|
validates every def, and installs them locally with pinned provenance — see
|
|
362
464
|
the `add` entry in [`docs/cli.md`](docs/cli.md). An installed def's steps later
|
|
363
|
-
run with your
|
|
465
|
+
run with your Step Agents' full privileges and owenloop never executes them itself,
|
|
364
466
|
so install only sources you trust, and pin a commit SHA (`@<sha>`) for anything
|
|
365
467
|
you re-add — the [trust model](docs/cli.md#add--installing-shared-workflow-defs-from-github)
|
|
366
468
|
is spelled out there.
|
|
@@ -369,18 +471,28 @@ Publishing your defs to a hosted hub instead? `owenloop login` authenticates
|
|
|
369
471
|
the CLI (loopback OAuth, or a pasted token via `--with-token`; the credential
|
|
370
472
|
goes into the macOS Keychain or a `0600` file, never the repo, and is verified
|
|
371
473
|
against the hub before it's ever stored), `owenloop connect` binds the project
|
|
372
|
-
to a hub, and `owenloop push` publishes your defs
|
|
373
|
-
|
|
374
|
-
|
|
474
|
+
to a hub, and `owenloop push` publishes your defs. Use `owenloop push --bundle
|
|
475
|
+
<bundle.wnlp>` after `owenloop publish` when execution must be pinned to the
|
|
476
|
+
exact signed bundle digest; plain YAML pushes remain idempotent against the
|
|
477
|
+
hub's own def hashes. `owenloop agent new
|
|
478
|
+
<name>` mints a Scoped Identity on the hub and stores its token in slot
|
|
375
479
|
`agent:<name>` without ever printing it. See the
|
|
376
480
|
[Hub](docs/cli.md#hub-login--connect--push--logout) section in `docs/cli.md`.
|
|
377
481
|
|
|
378
|
-
Setting up a machine from scratch? `owenloop setup`
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
482
|
+
Setting up a machine from scratch? `owenloop setup` may sign you in as a human
|
|
483
|
+
and, when needed, mint or rekey and store a Scoped Identity. Setup writes only
|
|
484
|
+
`hubOrigin` into the execution settings file, preserving the other keys. The
|
|
485
|
+
file is `$XDG_CONFIG_HOME/owenloop/settings.json` when `XDG_CONFIG_HOME` is
|
|
486
|
+
set to a non-blank value; otherwise `$HOME/.config/owenloop/settings.json`. For
|
|
487
|
+
a non-default account,
|
|
488
|
+
setup only prints the `OWENLOOP_ACCOUNT=<name>` instruction. Setup probes and,
|
|
489
|
+
when needed, converges the bundled `owenloop` plugins for Claude Code and Codex.
|
|
490
|
+
Plugin convergence is non-fatal; a missing harness or failed plugin command does
|
|
491
|
+
not fail setup. A second run with the expected plugin version already installed
|
|
492
|
+
performs no plugin writes. `owenloop doctor` is the read-only counterpart: it
|
|
493
|
+
checks both harness plugin states, reports version skew, and prints a `✓`/`✗`
|
|
494
|
+
line with the remedy. See
|
|
495
|
+
[`setup`](docs/cli.md#setup--onboard-a-machine) and
|
|
384
496
|
[`doctor`](docs/cli.md#doctor--check-a-machines-install) in `docs/cli.md`.
|
|
385
497
|
|
|
386
498
|
Driving the hub from an MCP host instead? `owenloop mcp` serves the hub control
|
|
@@ -400,6 +512,13 @@ never surfacing a token to the model. See the
|
|
|
400
512
|
- **No native dependencies.** `node:sqlite` is built in, so there's nothing to
|
|
401
513
|
compile. The only runtime deps are `yaml` (parsing defs) and
|
|
402
514
|
`@cfworker/json-schema` (optional per-artifact schema validation).
|
|
515
|
+
- **OpenSSH `ssh-keygen` with `-Y` support** (OpenSSH 8.1+) for the signing
|
|
516
|
+
features. `owenloop setup` automatically ensures an Ed25519 signing key for
|
|
517
|
+
each of the three local principals — human, machine, agent — and signs /
|
|
518
|
+
verifies records with stock SSHSIG (`ssh-keygen -Y`). Keys land in the macOS
|
|
519
|
+
Keychain, Linux libsecret (`secret-tool`), or a `0700`/`0600` file store
|
|
520
|
+
under `$HOME/.owenloop/keys/`; one backend is chosen once and never
|
|
521
|
+
error-fallback. See [Signing and key storage](docs/crypto.md).
|
|
403
522
|
|
|
404
523
|
```sh
|
|
405
524
|
npm install owenloop
|
|
@@ -473,7 +592,7 @@ is an ordinary class, so you can drive it **in-process** and get typed objects b
|
|
|
473
592
|
```ts
|
|
474
593
|
import { createEngine } from 'owenloop';
|
|
475
594
|
|
|
476
|
-
const { engine, store } = createEngine({
|
|
595
|
+
const { engine, store, resolver } = createEngine({
|
|
477
596
|
db: '.owenloop/state.db', // or ':memory:' for an ephemeral instance
|
|
478
597
|
defsDir: 'workflows', // load YAML defs from a dir … or pass `defs: [myDef]`
|
|
479
598
|
});
|
|
@@ -483,12 +602,16 @@ const wf = engine.createInstance('delivery', {
|
|
|
483
602
|
provide: { proposal: { text: 'add dark mode' } },
|
|
484
603
|
});
|
|
485
604
|
|
|
486
|
-
// the
|
|
605
|
+
// the Step Agent loop: tick → resolve → run → report
|
|
487
606
|
const { orders } = engine.tick(wf);
|
|
488
607
|
for (const order of orders) {
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
608
|
+
// orders are reference packets: routing + dynamic data + a defDigest, never
|
|
609
|
+
// authored prompt/command text. Resolve before dispatch — same boundary the
|
|
610
|
+
// CLI uses; an unknown digest throws UnknownDefDigestError here.
|
|
611
|
+
const instructions = resolver.resolveOrder(order); // { prompt?, command? }
|
|
612
|
+
const result = await runYourAgent(order, instructions); // ← your domain
|
|
613
|
+
engine.green(order.workflow, order.run, order.outputs[0], result); // typed CommitResult back
|
|
614
|
+
engine.close(order.workflow, order.run);
|
|
492
615
|
}
|
|
493
616
|
|
|
494
617
|
engine.status(wf); // typed WorkflowStatus: done / debts / eligible / blocked
|
|
@@ -519,7 +642,9 @@ owenloop is small and split along a pure-core / imperative-shell line:
|
|
|
519
642
|
| [`src/defs.ts`](src/defs.ts) | load YAML → validated `WorkflowDef` (the static wiring checks) |
|
|
520
643
|
| [`src/schema.ts`](src/schema.ts) | JSON Schema validation of artifact values, via `@cfworker/json-schema` |
|
|
521
644
|
| [`src/model.ts`](src/model.ts) | the pure core: what's eligible, the cascade, status, stall detection |
|
|
522
|
-
| [`src/store.ts`](src/store.ts) | `node:sqlite` persistence; transactions; the commit check |
|
|
645
|
+
| [`src/store.ts`](src/store.ts) | the SQLite **runtime** store — `node:sqlite` persistence; transactions; the commit check (instance/artifact state) |
|
|
646
|
+
| [`src/install.ts`](src/install.ts) | the host-neutral install transaction: safe staging, atomic swap with a retained backup, two-phase journal, lock, recovery |
|
|
647
|
+
| [`src/store/`](src/store/) | the content-addressed **workflow** store — digest-addressed definition objects, the two-level coordinate index, `.wnlp` bundle install, fail-closed resolution (immutable defs; distinct from the runtime store) |
|
|
523
648
|
| [`src/engine.ts`](src/engine.ts) | the imperative shell: `tick`/`green`/`reject`/… → mutate → `settle()` |
|
|
524
649
|
| [`src/cli.ts`](src/cli.ts) | argv → engine calls, JSON on stdout |
|
|
525
650
|
|
|
@@ -539,9 +664,12 @@ carries a monotonic version, so the engine can always ask "is this green output
|
|
|
539
664
|
resting on the inputs it was built from?".
|
|
540
665
|
|
|
541
666
|
**Retention and disposal.** That file is the system of record and it keeps
|
|
542
|
-
everything: every artifact version's value and every run's issued order
|
|
667
|
+
everything: every artifact version's value and every run's issued order
|
|
668
|
+
packet — the dynamic input values it consumed and its rejection reasons,
|
|
543
669
|
including any sensitive values that flowed through an input — persist after a
|
|
544
|
-
workflow finishes.
|
|
670
|
+
workflow finishes. Authored prompt and command text are not in the packet
|
|
671
|
+
(orders are reference packets that carry a `defDigest` instead), so
|
|
672
|
+
instruction text is retained once, in the definition, not per firing. The default location is `.owenloop/state.db` (plus its WAL
|
|
545
673
|
`-wal`/`-shm` sidecar files), or wherever `--db` / `OWENLOOP_DB` / the `db:`
|
|
546
674
|
embed option points. Rotating or scrubbing that data is the operator's job:
|
|
547
675
|
`owenloop delete <wf>` removes an instance's rows, but SQLite frees those pages
|
|
@@ -607,8 +735,9 @@ owenloop is a faithful, decoupled implementation of a dataflow-engine spec.
|
|
|
607
735
|
[`docs/design.md`](docs/design.md) is a self-contained walkthrough — the lifecycle,
|
|
608
736
|
firing rule, forward cascade, the reject kinds, the liveness rules, and the concurrency
|
|
609
737
|
model — cross-referenced from the source. [`docs/cli.md`](docs/cli.md) has the full
|
|
610
|
-
command reference,
|
|
611
|
-
grammar.
|
|
738
|
+
command reference, [`docs/authoring.md`](docs/authoring.md) has the full YAML
|
|
739
|
+
grammar, and [`docs/wire-contracts.md`](docs/wire-contracts.md) defines the
|
|
740
|
+
versioned trust-boundary records.
|
|
612
741
|
|
|
613
742
|
---
|
|
614
743
|
|
package/bin/owenloop.mjs
CHANGED
|
@@ -1,7 +1,55 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// Thin shim: all real logic lives in src/cli.ts (so it stays testable) and is
|
|
3
|
-
// shipped compiled to dist/cli.js. Node cannot type-strip files under
|
|
3
|
+
// shipped compiled to dist/src/cli.js. Node cannot type-strip files under
|
|
4
4
|
// node_modules, so the published package runs plain JS, not TypeScript source.
|
|
5
|
-
import {
|
|
5
|
+
import { readFile, rm } from 'node:fs/promises';
|
|
6
|
+
import { performance } from 'node:perf_hooks';
|
|
7
|
+
import { setTimeout as sleep } from 'node:timers/promises';
|
|
6
8
|
|
|
9
|
+
const START_GATE_TIMEOUT_MS = 2 * 60_000;
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* A Shift-spawned worker cannot import or execute the CLI until the parent has
|
|
13
|
+
* durably replaced its reservation with a PID-bearing record. Missing,
|
|
14
|
+
* cancelled, or expired gates fail closed before any role can contact the hub.
|
|
15
|
+
*/
|
|
16
|
+
async function waitForStartGate(path) {
|
|
17
|
+
const deadline = performance.now() + START_GATE_TIMEOUT_MS;
|
|
18
|
+
for (;;) {
|
|
19
|
+
let signal;
|
|
20
|
+
try {
|
|
21
|
+
signal = (await readFile(path, 'utf8')).trim();
|
|
22
|
+
} catch (error) {
|
|
23
|
+
if (error?.code === 'ENOENT') return false;
|
|
24
|
+
throw error;
|
|
25
|
+
}
|
|
26
|
+
if (signal === 'start') {
|
|
27
|
+
await rm(path, { force: true });
|
|
28
|
+
return true;
|
|
29
|
+
}
|
|
30
|
+
if (signal === 'cancel') {
|
|
31
|
+
await rm(path, { force: true });
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
if (performance.now() >= deadline) {
|
|
35
|
+
await rm(path, { force: true });
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
await sleep(25);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
const gatePath = process.env.OWENLOOP_START_GATE;
|
|
43
|
+
if (gatePath !== undefined && gatePath !== '') {
|
|
44
|
+
let allowed = false;
|
|
45
|
+
try {
|
|
46
|
+
allowed = await waitForStartGate(gatePath);
|
|
47
|
+
} catch (error) {
|
|
48
|
+
process.stderr.write(`owenloop: start gate failed: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
49
|
+
}
|
|
50
|
+
if (!allowed) process.exit(75);
|
|
51
|
+
delete process.env.OWENLOOP_START_GATE;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const { mainAsync } = await import('../dist/src/cli.js');
|
|
7
55
|
mainAsync(process.argv.slice(2)).then((code) => process.exit(code));
|