@odla-ai/cli 0.46.11 → 0.48.0
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 +33 -0
- package/dist/bin.cjs +615 -347
- package/dist/bin.cjs.map +1 -1
- package/dist/bin.js +1 -1
- package/dist/{chunk-J6GIGX6T.js → chunk-BD5KIG63.js} +578 -327
- package/dist/chunk-BD5KIG63.js.map +1 -0
- package/dist/{cli-BI26ENP4.js → cli-MXYYOFBR.js} +2 -2
- package/dist/index.cjs +580 -329
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +10 -2
- package/dist/index.d.ts +10 -2
- package/dist/index.js +1 -1
- package/package.json +3 -3
- package/skills/odla/references/sdks.md +5 -0
- package/dist/chunk-J6GIGX6T.js.map +0 -1
- /package/dist/{cli-BI26ENP4.js.map → cli-MXYYOFBR.js.map} +0 -0
package/README.md
CHANGED
|
@@ -39,6 +39,39 @@ npx --yes @odla-ai/cli@latest runbook list
|
|
|
39
39
|
Reading works for any signed-in developer and needs no `odla.config.mjs` — the
|
|
40
40
|
advice is most useful before there is a project.
|
|
41
41
|
|
|
42
|
+
## Selective release planning and approval
|
|
43
|
+
|
|
44
|
+
Promotion plans are exact, read-only review artifacts. An agent supplies the
|
|
45
|
+
validated source bundles, target snapshots, mappings, and provider-readiness
|
|
46
|
+
evidence; Registry returns one immutable digest and target-set digest without
|
|
47
|
+
changing any target:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
npx --yes @odla-ai/cli@latest promotion plan --file promotion-plan.json --env dev --json
|
|
51
|
+
npx --yes @odla-ai/cli@latest promotion inspect <plan-id> --env dev --json
|
|
52
|
+
npx --yes @odla-ai/cli@latest promotion status <plan-id> --env dev --json
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Studio shows the exact before/after values, exclusions, mappings, blockers, and
|
|
56
|
+
provider evidence. A signed-in human approves one `apply` or `rollback` action.
|
|
57
|
+
An enrolled device can then queue or resume that exact operation; a stable
|
|
58
|
+
default idempotency key makes an interrupted retry return the same intent:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npx --yes @odla-ai/cli@latest promotion apply <plan-id> --approval <approval-id> --env dev --json
|
|
62
|
+
npx --yes @odla-ai/cli@latest promotion rollback <plan-id> --approval <approval-id> --env dev --json
|
|
63
|
+
npx --yes @odla-ai/cli@latest promotion next <plan-id> <operation-id> --env dev --json
|
|
64
|
+
npx --yes @odla-ai/cli@latest promotion record <plan-id> <operation-id> <step-id> --file receipt.json --env dev --json
|
|
65
|
+
npx --yes @odla-ai/cli@latest promotion cancel <plan-id> <operation-id> --env dev --json
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Approval never floats to a newer plan. A changed source, mapping, readiness
|
|
69
|
+
check, target lifetime, target set, action, digest, or expiry fails closed. A
|
|
70
|
+
follower leases one target-local step with `next`, records exact evidence with
|
|
71
|
+
`record`, and may safely reclaim an expired lease after a process exit. Content
|
|
72
|
+
activation is always last. `cancel` stops work only before activation; afterward
|
|
73
|
+
an approved rollback publishes a higher audited revision.
|
|
74
|
+
|
|
42
75
|
## Operator context from any directory
|
|
43
76
|
|
|
44
77
|
Before an agent reads PM, Discussions, o11y, runbooks, or identity from a fresh
|