owenloop 0.2.0 → 0.3.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 +65 -0
- package/README.md +94 -7
- package/bin/owenloop.mjs +2 -2
- package/dist/add.d.ts +412 -0
- package/dist/add.js +999 -0
- package/dist/cli.d.ts +47 -0
- package/dist/cli.js +1809 -19
- package/dist/defs.d.ts +33 -0
- package/dist/defs.js +171 -21
- package/dist/engine.d.ts +395 -40
- package/dist/engine.js +1118 -135
- package/dist/factory.d.ts +19 -0
- package/dist/factory.js +41 -5
- package/dist/hub.d.ts +290 -0
- package/dist/hub.js +408 -0
- package/dist/index.d.ts +3 -2
- package/dist/index.js +2 -1
- package/dist/model.d.ts +36 -0
- package/dist/model.js +20 -9
- package/dist/store.d.ts +14 -2
- package/dist/store.js +285 -35
- package/dist/types.d.ts +120 -0
- package/dist/untar.d.ts +47 -0
- package/dist/untar.js +164 -0
- package/dist/util.d.ts +76 -0
- package/dist/util.js +96 -0
- package/docs/authoring.md +118 -1
- package/docs/cli.md +446 -3
- package/docs/design.md +259 -32
- package/docs/embedding.md +81 -10
- package/examples/workflows/command-worker.yaml +56 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,71 @@ 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.3.1](https://github.com/typicalday/owenloop/compare/v0.3.0...v0.3.1) (2026-07-17)
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
### Bug Fixes
|
|
11
|
+
|
|
12
|
+
* **ci:** make pack manifest test robust to npm 12 pack --json schema ([#64](https://github.com/typicalday/owenloop/issues/64)) ([25f556d](https://github.com/typicalday/owenloop/commit/25f556df13260a487a182695b3bf38483faccb03))
|
|
13
|
+
|
|
14
|
+
## [0.3.0](https://github.com/typicalday/owenloop/compare/v0.2.1...v0.3.0) (2026-07-17)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Features
|
|
18
|
+
|
|
19
|
+
* **add:** offline crash-recovery via add --recover ([#63](https://github.com/typicalday/owenloop/issues/63)) ([17b1842](https://github.com/typicalday/owenloop/commit/17b1842cd1e2c079ffe6e832c6cbef21e935c5d5))
|
|
20
|
+
* CLI adopts hub parity — whoami-verified auth, server-truth push diff ([#27](https://github.com/typicalday/owenloop/issues/27)) ([e882c70](https://github.com/typicalday/owenloop/commit/e882c7065dcbd91647fce4cd508748fd6700967b))
|
|
21
|
+
* deep tick drives calls: children; surface child stalls on parent status ([#20](https://github.com/typicalday/owenloop/issues/20)) ([b1cc889](https://github.com/typicalday/owenloop/commit/b1cc88935be32429b73d6b1dd123aafab0490cf3))
|
|
22
|
+
* **defs:** auto-discover add-installed workflow defs by default ([#62](https://github.com/typicalday/owenloop/issues/62)) ([cd2d62b](https://github.com/typicalday/owenloop/commit/cd2d62b7b6319c3d51241d2ad488996da394d0ff))
|
|
23
|
+
* **hub:** transport + OAuth origin policy, strict push responses (SEC-2/4, REL-9/10) ([#33](https://github.com/typicalday/owenloop/issues/33)) ([2f5e999](https://github.com/typicalday/owenloop/commit/2f5e999d0a7eed9260b42e813681f9fcd855f3f7))
|
|
24
|
+
* owenloop add <owner>/<repo>[[@ref](https://github.com/ref)] -- install workflow defs from GitHub ([#23](https://github.com/typicalday/owenloop/issues/23)) ([a74ea1c](https://github.com/typicalday/owenloop/commit/a74ea1cc63f0563e3d6a78d7588251280d27e4cc))
|
|
25
|
+
* owenloop login/connect/push/logout — hub onboarding for the CLI ([#24](https://github.com/typicalday/owenloop/issues/24)) ([bedf856](https://github.com/typicalday/owenloop/commit/bedf856c7a5494ea6f16b3d6f39347790198c784))
|
|
26
|
+
* persist issued order packet at claim; add 'owenloop order' read verb ([#30](https://github.com/typicalday/owenloop/issues/30)) ([f77de53](https://github.com/typicalday/owenloop/commit/f77de539db7626f6df9bb5ea7b2a13cc0976a76b))
|
|
27
|
+
* re-home hashDefForHub into hub module, add core/hub boundary lint (0.3.0) ([#29](https://github.com/typicalday/owenloop/issues/29)) ([61f50bc](https://github.com/typicalday/owenloop/commit/61f50bc22adae57a966e0edcd9b33d88931d5010))
|
|
28
|
+
* retain immutable artifact history ([#32](https://github.com/typicalday/owenloop/issues/32)) ([e0dc624](https://github.com/typicalday/owenloop/commit/e0dc624ec79435fc87b2ba82b9fd549687fd5bb7))
|
|
29
|
+
* validate in-memory def sets + hard deep-tick call-depth bound (REL-4) ([#35](https://github.com/typicalday/owenloop/issues/35)) ([ad3564b](https://github.com/typicalday/owenloop/commit/ad3564bdc446d6e228e5ef083464997b9ad668b9))
|
|
30
|
+
* worker-label claim filter and per-step max-lease clamp ([#31](https://github.com/typicalday/owenloop/issues/31)) ([0345044](https://github.com/typicalday/owenloop/commit/034504407fa8b2182b5ada02a3860f6f791d9888))
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
### Bug Fixes
|
|
34
|
+
|
|
35
|
+
* **add:** atomic, collision-free, validated installs (REL-1/REL-2/REL-3) ([#40](https://github.com/typicalday/owenloop/issues/40)) ([7904446](https://github.com/typicalday/owenloop/commit/7904446c0175bba61a55ead6d52b1a0c725c4e38))
|
|
36
|
+
* **add:** correct recovery guidance in the park double-fault error message ([#57](https://github.com/typicalday/owenloop/issues/57)) ([571824e](https://github.com/typicalday/owenloop/commit/571824ef3b53abcd38ae6994923cc290a9f56e8c))
|
|
37
|
+
* **add:** crash-recovery journal so an interrupted install rolls forward or back to a consistent state ([#56](https://github.com/typicalday/owenloop/issues/56)) ([79aa875](https://github.com/typicalday/owenloop/commit/79aa8752fc024a6641cee35e50bf2d32947913fd))
|
|
38
|
+
* **add:** make directory commit + lockfile write one recoverable operation ([#46](https://github.com/typicalday/owenloop/issues/46)) ([7c43fef](https://github.com/typicalday/owenloop/commit/7c43fef6dc698a65b5e4f533dd42cf91f42d84fa))
|
|
39
|
+
* **add:** park old-name dir inside the rollback envelope; stop cleanup masking rename error ([#48](https://github.com/typicalday/owenloop/issues/48)) ([74bea2b](https://github.com/typicalday/owenloop/commit/74bea2b0ff2136d627c0e69a16b64a8b85d20b48))
|
|
40
|
+
* atomic child creation and transactional, order-checked store open (REL-5) ([#37](https://github.com/typicalday/owenloop/issues/37)) ([59119d2](https://github.com/typicalday/owenloop/commit/59119d276080946690182b0971e2f281d5783fa4))
|
|
41
|
+
* **calls:** atomic fresh-snapshot child provision (C2 creation-side isolation) ([#59](https://github.com/typicalday/owenloop/issues/59)) ([e6e951c](https://github.com/typicalday/owenloop/commit/e6e951ca5dc51730c0bc16abceef24560e602edf))
|
|
42
|
+
* CLI nits from PR [#25](https://github.com/typicalday/owenloop/issues/25) review — NaN flag guard, timeout message, stale comment ([#26](https://github.com/typicalday/owenloop/issues/26)) ([e438dcb](https://github.com/typicalday/owenloop/commit/e438dcb7b9709dcd31338565172caebeede5e5d9))
|
|
43
|
+
* **cli:** reject unknown options before any side effect ([#60](https://github.com/typicalday/owenloop/issues/60)) ([73fea0c](https://github.com/typicalday/owenloop/commit/73fea0cd485f0965b517dd12cdbd1ef3a793b3b6))
|
|
44
|
+
* credential backend authority, hub/auth deadlines, atomic symlink-refusing writes (REL-6/REL-7/SEC-3) ([#39](https://github.com/typicalday/owenloop/issues/39)) ([f71853b](https://github.com/typicalday/owenloop/commit/f71853b0893415c8d578b847262180a5b8d861b1))
|
|
45
|
+
* **engine:** atomic snapshot-and-commit for maintainCalls machine-green (cross-connection stale publish) ([#52](https://github.com/typicalday/owenloop/issues/52)) ([a496620](https://github.com/typicalday/owenloop/commit/a496620f1d79ae673327922f30a5c52062c9f439))
|
|
46
|
+
* **engine:** guard deep-tick calls: descent against cross-connection races ([#61](https://github.com/typicalday/owenloop/issues/61)) ([6867beb](https://github.com/typicalday/owenloop/commit/6867beb606c8c9a521c920e898384d67bdf0386f))
|
|
47
|
+
* **engine:** make max-lease cap opt-in; distinguish reap reasons (REL-8) ([#38](https://github.com/typicalday/owenloop/issues/38)) ([074fb5e](https://github.com/typicalday/owenloop/commit/074fb5e6a58248d172320fdf38f22418a13fe6b4))
|
|
48
|
+
* guard status child summary against unresolvable child def; test dueAt min-fold ([#22](https://github.com/typicalday/owenloop/issues/22)) ([cb7ccd2](https://github.com/typicalday/owenloop/commit/cb7ccd2404f7477ed38d596321ec032c2e3756b5))
|
|
49
|
+
* hub CLI hardening — portable push hash, boolean-flag parse, login timeout ([#25](https://github.com/typicalday/owenloop/issues/25)) ([c36e1b6](https://github.com/typicalday/owenloop/commit/c36e1b6d67a425c0af42b99b705e603f68aaad46))
|
|
50
|
+
* **security:** contain bodyFile resolution and bound archive extraction in add (SEC-1) ([#34](https://github.com/typicalday/owenloop/issues/34)) ([6d8ccfa](https://github.com/typicalday/owenloop/commit/6d8ccfac2cc92164fe6f0548a038423d983e2ca9))
|
|
51
|
+
* **security:** enforce response-size caps during download with a bounded streaming reader ([#54](https://github.com/typicalday/owenloop/issues/54)) ([47f8096](https://github.com/typicalday/owenloop/commit/47f8096cec701204094009421cde48ae4f3694e6))
|
|
52
|
+
* **security:** fail closed on uncorroborated add.journal crash recovery ([#58](https://github.com/typicalday/owenloop/issues/58)) ([d9a1890](https://github.com/typicalday/owenloop/commit/d9a1890d1933d274cf1b77c6f5e7f4e38f921c2a))
|
|
53
|
+
* **security:** ownership-token install lock with liveness-aware stale reclamation ([#55](https://github.com/typicalday/owenloop/issues/55)) ([647d008](https://github.com/typicalday/owenloop/commit/647d00893ef6f023c6d4126ce96ef230ea97b15f))
|
|
54
|
+
* **security:** refuse a symlinked .owenloop and default defs dir in add (SEC-3) ([#53](https://github.com/typicalday/owenloop/issues/53)) ([5bc96b1](https://github.com/typicalday/owenloop/commit/5bc96b17cf6fec6b771fbfc955af7443852afa79))
|
|
55
|
+
* **security:** refuse a symlinked default state.db and its SQLite sidecars (SEC-3 file-level) ([#49](https://github.com/typicalday/owenloop/issues/49)) ([0a54a2f](https://github.com/typicalday/owenloop/commit/0a54a2fa4eb153f9de7d05a21cf5211fba3b76a0))
|
|
56
|
+
* **security:** refuse a symlinked project .owenloop on state writes (SEC-3) ([#47](https://github.com/typicalday/owenloop/issues/47)) ([033bdef](https://github.com/typicalday/owenloop/commit/033bdef7c54b331aae28b0b0c47e5f4c6662dc0d))
|
|
57
|
+
* **security:** refuse HTTP redirects on all hub/auth requests ([#50](https://github.com/typicalday/owenloop/issues/50)) ([70617bc](https://github.com/typicalday/owenloop/commit/70617bc4e188339c39a12b5d1bc7df4c1cfcaea1))
|
|
58
|
+
* **security:** validate and contain installed.json paths before any filesystem operation ([#51](https://github.com/typicalday/owenloop/issues/51)) ([4496aa5](https://github.com/typicalday/owenloop/commit/4496aa5ea8573f6cec3277ffbc26f4b45e4dfbf9))
|
|
59
|
+
* **store:** deterministic legacy-child lookup + structural artifact change-detection ([#45](https://github.com/typicalday/owenloop/issues/45)) ([2350793](https://github.com/typicalday/owenloop/commit/235079347fc6d7cccc9c12da214ebdaab6cc36ae))
|
|
60
|
+
|
|
61
|
+
## [0.2.1](https://github.com/typicalday/owenloop/compare/v0.2.0...v0.2.1) (2026-07-04)
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
### Bug Fixes
|
|
65
|
+
|
|
66
|
+
* auto-skip submitted group siblings to prevent permanent wedge ([#15](https://github.com/typicalday/owenloop/issues/15)) ([484aea2](https://github.com/typicalday/owenloop/commit/484aea20d682196574b5c8c7da35bfd3e10619d3))
|
|
67
|
+
* catch child schema refusals as debts and version-pin the calls: mirror ([#16](https://github.com/typicalday/owenloop/issues/16)) ([500cce7](https://github.com/typicalday/owenloop/commit/500cce7152023391c19393ee5dcb18d802a6b2e8))
|
|
68
|
+
* close three commit-side verb guard gaps (F3, F5, F7) ([#11](https://github.com/typicalday/owenloop/issues/11)) ([fbcc777](https://github.com/typicalday/owenloop/commit/fbcc77700fefcf66f287e5e903ad7c03e9b59b64))
|
|
69
|
+
* refuse emit after the collection seal has greened (§11.1, F6) ([#17](https://github.com/typicalday/owenloop/issues/17)) ([cd963cf](https://github.com/typicalday/owenloop/commit/cd963cf9296504dc0278f9fa68d097a60e318c0f))
|
|
70
|
+
* ship src/ in the npm files allowlist ([#13](https://github.com/typicalday/owenloop/issues/13)) ([20ffcea](https://github.com/typicalday/owenloop/commit/20ffcea9132610203ef9da3cfa147990ad157ca9))
|
|
71
|
+
|
|
7
72
|
## [0.2.0](https://github.com/typicalday/owenloop/compare/v0.1.1...v0.2.0) (2026-07-04)
|
|
8
73
|
|
|
9
74
|
|
package/README.md
CHANGED
|
@@ -158,6 +158,10 @@ 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.** `worker:`/`command:` label which kind of
|
|
162
|
+
executor an order is for and carry a command string through untouched —
|
|
163
|
+
the engine never shells out, executes, or interprets it. Actually running
|
|
164
|
+
anything is always the dispatcher's job, on the other side of `tick`.
|
|
161
165
|
|
|
162
166
|
---
|
|
163
167
|
|
|
@@ -250,6 +254,20 @@ opt-in `strongest` tier is for, reserved for the rare step where nothing less
|
|
|
250
254
|
will do. See
|
|
251
255
|
[`docs/authoring.md`](docs/authoring.md#model--quality-tiers-not-vendor-ids).
|
|
252
256
|
|
|
257
|
+
### Worker dispatch
|
|
258
|
+
|
|
259
|
+
`worker: agent | command | …` declares which kind of executor a step's order
|
|
260
|
+
is for — the default (`agent`, silent when omitted) is unaffected; every
|
|
261
|
+
def written before this feature stays byte for byte the same. Opt a step
|
|
262
|
+
into `worker: command` and give it a `command:` string to switch it to a
|
|
263
|
+
deterministic executor instead of an LLM — the engine never runs it, only
|
|
264
|
+
carries it through on the order for your dispatcher to branch on. An
|
|
265
|
+
optional `spec:` map carries further opaque config (a timeout, a working
|
|
266
|
+
directory), and a judge entry accepts the same fields, so a quality gate can
|
|
267
|
+
be a script's exit code instead of a verdict. See
|
|
268
|
+
[`docs/authoring.md`](docs/authoring.md#worker--declaring-the-executor) and
|
|
269
|
+
[`command-worker.yaml`](examples/workflows/command-worker.yaml).
|
|
270
|
+
|
|
253
271
|
### Event subscription — for embedding
|
|
254
272
|
|
|
255
273
|
Driving the engine in-process doesn't require polling: `engine.subscribe(...)`
|
|
@@ -277,7 +295,9 @@ looks like:
|
|
|
277
295
|
- **Your own harness** — a `while` loop, a cron job, a CI stage: tick, run
|
|
278
296
|
each order with whatever executes your work (an agent CLI, an API call, a
|
|
279
297
|
script), report, repeat. Fully deterministic dispatch if you want it —
|
|
280
|
-
see [Embedding it](#embedding-it) for the in-process version.
|
|
298
|
+
see [Embedding it](#embedding-it) for the in-process version. A reference
|
|
299
|
+
dispatcher/conductor, owenwork, is available separately — the engine core
|
|
300
|
+
ships no host harness of its own.
|
|
281
301
|
- **An agent as the orchestrator** — point any tool-using agent (Claude Code,
|
|
282
302
|
Codex, Gemini CLI, anything that can run a shell command) at the CLI and
|
|
283
303
|
tell it to drive the instance to done. A slash command or skill that wraps
|
|
@@ -321,8 +341,8 @@ definition, then conducts the instance to done — dispatching each order to a
|
|
|
321
341
|
fresh subagent, relaying knock-backs, and escalating stalls to you. Already
|
|
322
342
|
have a def? *"Conduct the report workflow"* hands it to
|
|
323
343
|
[`owenloop-conduct`](skills/owenloop-conduct/SKILL.md). The engine itself
|
|
324
|
-
arrives via `npx owenloop` — no clone, no build, no
|
|
325
|
-
CLI verbs to memorize.
|
|
344
|
+
arrives via `npx owenloop` (Node ≥ 22.13 required) — no clone, no build, no
|
|
345
|
+
environment variables, no CLI verbs to memorize.
|
|
326
346
|
|
|
327
347
|
**Want to see or drive the machinery yourself?** Everything above goes
|
|
328
348
|
through the same small CLI (`create`, `tick`, `green`, `reject`, …).
|
|
@@ -336,13 +356,31 @@ collections-heavy research pipeline
|
|
|
336
356
|
[`docs/authoring.md`](docs/authoring.md). Driving it from your own code:
|
|
337
357
|
[Embedding it](#embedding-it).
|
|
338
358
|
|
|
359
|
+
Want someone else's workflow defs instead of writing your own?
|
|
360
|
+
`owenloop add <owner>/<repo>` fetches a public GitHub repo's `workflows/**`,
|
|
361
|
+
validates every def, and installs them locally with pinned provenance — see
|
|
362
|
+
the `add` entry in [`docs/cli.md`](docs/cli.md). An installed def's steps later
|
|
363
|
+
run with your workers' full privileges and owenloop never executes them itself,
|
|
364
|
+
so install only sources you trust, and pin a commit SHA (`@<sha>`) for anything
|
|
365
|
+
you re-add — the [trust model](docs/cli.md#add--installing-shared-workflow-defs-from-github)
|
|
366
|
+
is spelled out there.
|
|
367
|
+
|
|
368
|
+
Publishing your defs to a hosted hub instead? `owenloop login` authenticates
|
|
369
|
+
the CLI (loopback OAuth, or a pasted token via `--with-token`; the credential
|
|
370
|
+
goes into the macOS Keychain or a `0600` file, never the repo, and is verified
|
|
371
|
+
against the hub before it's ever stored), `owenloop connect` binds the project
|
|
372
|
+
to a hub, and `owenloop push` publishes your defs — idempotent against the
|
|
373
|
+
hub's own def hashes, so an unchanged re-push is a no-op. See the
|
|
374
|
+
[Hub](docs/cli.md#hub-login--connect--push--logout) section in `docs/cli.md`.
|
|
375
|
+
|
|
339
376
|
---
|
|
340
377
|
|
|
341
378
|
## Requirements
|
|
342
379
|
|
|
343
380
|
- **Node ≥ 22.13.** Storage is Node's built-in `node:sqlite`, which is available
|
|
344
381
|
unflagged from 22.13 onward (it still prints an experimental warning until it
|
|
345
|
-
stabilises in Node 24.15 / 25.7). owenloop is an ESM-only package.
|
|
382
|
+
stabilises in Node 24.15 / 25.7). owenloop is an ESM-only package. CI runs the
|
|
383
|
+
full check on Node 22 (active LTS) and 24 (current).
|
|
346
384
|
- **No native dependencies.** `node:sqlite` is built in, so there's nothing to
|
|
347
385
|
compile. The only runtime deps are `yaml` (parsing defs) and
|
|
348
386
|
`@cfworker/json-schema` (optional per-artifact schema validation).
|
|
@@ -357,6 +395,45 @@ import { createEngine } from 'owenloop'; // see "Embedding it" below
|
|
|
357
395
|
|
|
358
396
|
---
|
|
359
397
|
|
|
398
|
+
## Upgrading from 0.2.1
|
|
399
|
+
|
|
400
|
+
Upgrading a project from the 0.2.1 release pulls in everything that has landed
|
|
401
|
+
since. The changes that need operator or embedder attention:
|
|
402
|
+
|
|
403
|
+
- **Deep recursive ticking.** One `tick` now advances the whole `calls:` tree
|
|
404
|
+
by default, so a single call can drive many workflow instances at once and
|
|
405
|
+
their execution timing shifts. Embedders that key per-workflow logic —
|
|
406
|
+
checkpoints, transactions, counters — must key on `order.workflow`, not the
|
|
407
|
+
id passed to `tick` (`--shallow` / `{ deep: false }` is the single-instance
|
|
408
|
+
escape hatch). See
|
|
409
|
+
[Migrating from shallow ticking](docs/embedding.md#the-worker-step) and
|
|
410
|
+
[Deep tick and `order.workflow`](docs/cli.md#what-a-job-looks-like); the full
|
|
411
|
+
guidance lives there.
|
|
412
|
+
- **Node ≥ 22.13 required.** The `engines` field pins Node ≥ 22.13, and CI runs
|
|
413
|
+
the full check on Node 22 and 24 — see [Requirements](#requirements) just
|
|
414
|
+
above.
|
|
415
|
+
- **Database schema v9.** The first open by a new binary migrates the database
|
|
416
|
+
in a single transaction that rolls back on failure; a database whose stored
|
|
417
|
+
version is newer than the binary is refused rather than opened. Migrated
|
|
418
|
+
databases do **not** get backfilled artifact-history payload snapshots —
|
|
419
|
+
durable payload history begins after migration (legacy lifecycle reasons are
|
|
420
|
+
carried over exactly once). Copy the SQLite database (`.owenloop/state.db`
|
|
421
|
+
plus its `-wal`/`-shm` sidecars) before upgrading; downgrading means
|
|
422
|
+
restoring that copy, because an older binary refuses a v9 database.
|
|
423
|
+
- **New retained plaintext data.** Issued order packets and artifact history
|
|
424
|
+
now persist in the database, so rotating and disposing of that data is the
|
|
425
|
+
operator's job — see [Retention and disposal](#storage).
|
|
426
|
+
- **New network-facing commands and credential storage.** `owenloop login` /
|
|
427
|
+
`connect` / `push` (and `add`, for installing shared defs) reach the network
|
|
428
|
+
and store a credential in the macOS Keychain or a `0600` file — see the
|
|
429
|
+
[Hub](docs/cli.md#hub-login--connect--push--logout) section and the `add`
|
|
430
|
+
[trust model](docs/cli.md#add--installing-shared-workflow-defs-from-github).
|
|
431
|
+
- **Max-lease cap is now opt-in.** There is no default lease ceiling; anyone who
|
|
432
|
+
relied on the brief post-0.2.1 default cap must set `maxLeaseMs` (or a
|
|
433
|
+
per-step `maxLease`) explicitly.
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
360
437
|
## Embedding it
|
|
361
438
|
|
|
362
439
|
The CLI is a thin adapter: it maps `argv` to engine calls and prints JSON. The engine
|
|
@@ -431,6 +508,16 @@ is rejected ("born-rejected") if any of those inputs moved underneath it. Each a
|
|
|
431
508
|
carries a monotonic version, so the engine can always ask "is this green output still
|
|
432
509
|
resting on the inputs it was built from?".
|
|
433
510
|
|
|
511
|
+
**Retention and disposal.** That file is the system of record and it keeps
|
|
512
|
+
everything: every artifact version's value and every run's issued order packet —
|
|
513
|
+
including any sensitive values that flowed through an input — persist after a
|
|
514
|
+
workflow finishes. The default location is `.owenloop/state.db` (plus its WAL
|
|
515
|
+
`-wal`/`-shm` sidecar files), or wherever `--db` / `OWENLOOP_DB` / the `db:`
|
|
516
|
+
embed option points. Rotating or scrubbing that data is the operator's job:
|
|
517
|
+
`owenloop delete <wf>` removes an instance's rows, but SQLite frees those pages
|
|
518
|
+
without erasing or shrinking the file on disk, so for reliable disposal delete
|
|
519
|
+
the database file together with its `-wal`/`-shm` sidecars.
|
|
520
|
+
|
|
434
521
|
## Testing
|
|
435
522
|
|
|
436
523
|
```sh
|
|
@@ -440,19 +527,19 @@ npm run check # both
|
|
|
440
527
|
npm run build # compile src/ → dist/ (also runs automatically on npm pack/publish)
|
|
441
528
|
```
|
|
442
529
|
|
|
443
|
-
The suite
|
|
530
|
+
The suite spans unit tests (`paths`, `store`, `model`, `defs`, `schema`,
|
|
444
531
|
`util`, `cli`), engine integration tests (the cascade, the stall, schema validation,
|
|
445
532
|
the concurrency check, `judges:` sign-off/CAS/throttling in `test/judges.test.ts`),
|
|
446
533
|
and end-to-end tests that spawn the real `bin/owenloop.mjs` binary and drive the
|
|
447
534
|
example workflows through their full lifecycles.
|
|
448
535
|
|
|
449
536
|
Two e2e files carry most of the weight, by opposite intent.
|
|
450
|
-
[`test/edge.e2e.test.ts`](test/edge.e2e.test.ts) is
|
|
537
|
+
[`test/edge.e2e.test.ts`](test/edge.e2e.test.ts) is an edge battery aimed at the
|
|
451
538
|
corners the design is most particular about: cascade invalidation, terminal completion
|
|
452
539
|
surviving an upstream reject, empty / fully-retracted collections, the commit check,
|
|
453
540
|
cadence and daily-budget gating, the skip-cascade, and CLI robustness against malformed
|
|
454
541
|
input. [`test/scenarios.e2e.test.ts`](test/scenarios.e2e.test.ts) takes the opposite
|
|
455
|
-
tack —
|
|
542
|
+
tack — multi-step *positive* stories that confirm the documented behaviors hold
|
|
456
543
|
end to end: the map `parallel` cap, map and reduce firing as concurrent branches, the
|
|
457
544
|
reason thread riding the next job, stall → retry → re-stall, and the cascade re-firing on
|
|
458
545
|
a re-provided input while leaving a healthy graph and a terminal output untouched.
|
package/bin/owenloop.mjs
CHANGED
|
@@ -2,6 +2,6 @@
|
|
|
2
2
|
// Thin shim: all real logic lives in src/cli.ts (so it stays testable) and is
|
|
3
3
|
// shipped compiled to dist/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 { mainAsync } from '../dist/cli.js';
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
mainAsync(process.argv.slice(2)).then((code) => process.exit(code));
|