@colony2/c2j 0.0.54 → 0.0.57
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/README.md +34 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -18,6 +18,12 @@ For execution requirements, actual allocation inputs, compatibility filtering,
|
|
|
18
18
|
job status, progress, handoffs, and child-job lineage, see the
|
|
19
19
|
[execution tracking user guide](GUIDE-Execution-Tracking.md).
|
|
20
20
|
|
|
21
|
+
For schema-driven human input and document review using existing artifact
|
|
22
|
+
attachments, see the [recipe author's guide](GUIDE-Review-Recipe-Authors.md)
|
|
23
|
+
and [application integration guide](GUIDE-Structured-Input-And-Review.md).
|
|
24
|
+
Reviews use one `input` op with `form.kind: review`, ordinary questions, and
|
|
25
|
+
stored document references. No review extension or preparation recipe is needed.
|
|
26
|
+
|
|
21
27
|
Recipes can declare an `execution` block for CPU, memory, scratch, platform,
|
|
22
28
|
and image. Node-level `execution_needs` adds templatable, scoped overrides that
|
|
23
29
|
inherit within a job and restore the parent on exit. Completed tasks replay
|
|
@@ -46,6 +52,7 @@ c2j version
|
|
|
46
52
|
c2j submit
|
|
47
53
|
c2j run
|
|
48
54
|
c2j run one
|
|
55
|
+
c2j run with-lease
|
|
49
56
|
c2j run any
|
|
50
57
|
c2j run loop
|
|
51
58
|
c2j ready
|
|
@@ -477,6 +484,29 @@ Important behavior:
|
|
|
477
484
|
- when input is pending, interactive terminals default to prompting
|
|
478
485
|
- in CI or non-terminal mode, input handling defaults to `ops`
|
|
479
486
|
|
|
487
|
+
### Execute a dispatched lease
|
|
488
|
+
|
|
489
|
+
When a dispatcher has already claimed work, use its protected capability file:
|
|
490
|
+
|
|
491
|
+
```bash
|
|
492
|
+
c2j run with-lease --jobdb https://jobdb.example.com/tenant --job-id JOB_ID --lease-file /run/secrets/job-lease.json
|
|
493
|
+
```
|
|
494
|
+
|
|
495
|
+
Use `--lease-file -` for redirected stdin. The command validates and renews the
|
|
496
|
+
supplied lease, runs the usual execution lifecycle, and exits on completion,
|
|
497
|
+
rescheduling, or lease loss without claiming another lease. The file must be
|
|
498
|
+
owned by the worker user with no group/other permissions. See the
|
|
499
|
+
[supplied-lease guide](GUIDE-Run-With-Lease.md) for dispatcher/library integration,
|
|
500
|
+
exit behavior, and the JobDB v0.0.22 server requirement.
|
|
501
|
+
|
|
502
|
+
### Recipe timeouts and recovery
|
|
503
|
+
|
|
504
|
+
Recipe and nested execution timeouts retain their original scope budget across
|
|
505
|
+
worker recovery. Cached completed tasks remain replayable; new work does not
|
|
506
|
+
receive a fresh budget merely because execution resumed. See
|
|
507
|
+
[timeout recovery](TIMEOUT_RECOVERY.md) for timing semantics, deployment
|
|
508
|
+
compatibility, and the remaining upstream JobDB timeout limitations.
|
|
509
|
+
|
|
480
510
|
### Input handling
|
|
481
511
|
|
|
482
512
|
`--input-mode` controls what happens when a job is blocked on user input:
|
|
@@ -736,3 +766,7 @@ c2j submit "Run the requested task" \
|
|
|
736
766
|
- command entrypoint: [main.go](main.go)
|
|
737
767
|
- embedded runtime notes: [embed-swf-mode-spec.md](embed-swf-mode-spec.md)
|
|
738
768
|
- recipe authoring docs: [RECIPE_AUTHORING_GUIDE.md](../../recipes/guides/RECIPE_AUTHORING_GUIDE.md)
|
|
769
|
+
|
|
770
|
+
## Op object checkpoints
|
|
771
|
+
|
|
772
|
+
Ops can publish immutable typed objects containing metadata and files, then accept an explicit reference to any earlier checkpoint. Each consumer receives a fresh writable copy. See [the API and Codex migration guide](GUIDE-Op-Object-Checkpoints.md) for recipe routing, extension manifests, native APIs, and compatibility details.
|