@odla-ai/cli 0.42.0 → 0.42.2

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/dist/index.js CHANGED
@@ -56,7 +56,7 @@ import {
56
56
  startHostedSecurityJob,
57
57
  surfacePaths,
58
58
  validateInvocation
59
- } from "./chunk-74DXL2MT.js";
59
+ } from "./chunk-K6ATAKGR.js";
60
60
  import {
61
61
  exitCodeFor,
62
62
  redactSecrets
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@odla-ai/cli",
3
- "version": "0.42.0",
3
+ "version": "0.42.2",
4
4
  "description": "Agent-operable CLI for odla provisioning, calendar consent and connection lifecycle, System AI administration, Worker secrets, security jobs, and smoke checks.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://odla.ai/docs/packages/cli",
@@ -58,7 +58,7 @@
58
58
  "prepublishOnly": "npm run build"
59
59
  },
60
60
  "dependencies": {
61
- "@odla-ai/ai": "0.15.0",
61
+ "@odla-ai/ai": "0.16.0",
62
62
  "@odla-ai/apps": "0.12.0",
63
63
  "@odla-ai/brand": "0.7.0",
64
64
  "@odla-ai/db": "0.12.0",
@@ -235,12 +235,12 @@ several efforts, list without `--app` first, then scope every write to the exact
235
235
  project id.
236
236
 
237
237
  Before project-mutating work, confirm the request aligns to an open goal and
238
- propose/refine a **task** in Backlog. Ready is a planner handoff: an ordinary
239
- managed-agent grant has `pm.execute`, so a human owner or `pm.plan` agent must
240
- approve the Ready contract before an unattended executor claims work discovered
241
- through PM. A direct request from the user actively directing the coding
242
- session is already authority: record it, but do not stop and ask that user to
243
- repeat approval by moving the task to Ready.
238
+ propose/refine a **task** in Backlog. Any principal with app/project PM mutation
239
+ access may validate and mark its complete contract Ready; `pm.execute` carries
240
+ that ordinary PM-write authority. An unattended executor still claims work
241
+ discovered through PM before implementation. A direct request from the user
242
+ actively directing the coding session is already authority: record it, mark the
243
+ complete task Ready, and claim it without stopping for a duplicate Studio click.
244
244
  Record a **decision** the moment you make one (with what it rules out), and file
245
245
  a **bug** the moment you notice one. A decision you don't record is one the next
246
246
  agent re-litigates. Full command set, conventions, and recovery procedure:
@@ -95,9 +95,10 @@ Revoking a machine, permanently deleting an app, transferring ownership, and
95
95
  rotating credentials require a signed-in human in Studio. No machine credential
96
96
  performs them however wide its approval was, and no flag widens that.
97
97
 
98
- Ordinary reviewed access includes `pm.execute` but not `pm.plan`: re-read `pm
99
- next` and claim the current Ready task revision, leaving Ready approval to a
100
- human owner or explicit planner.
98
+ Ordinary reviewed access includes `pm.execute`, which carries app/project PM
99
+ mutation authority: it may validate and mark a complete task contract Ready,
100
+ then claim that exact revision. `pm.plan` remains an independent grant and is
101
+ not required for ordinary task lifecycle maintenance.
101
102
 
102
103
  ## Recovery and audit evidence
103
104
 
@@ -40,14 +40,13 @@ An agent must not create a convenient goal merely to authorize itself.
40
40
 
41
41
  ## 3. Refine Backlog work and mark it Ready
42
42
 
43
- Ready is a durable planner-to-executor handoff. A human project owner or an
44
- agent holding `pm.plan` may refine the task and mark it Ready. Ordinary managed
45
- agent handshakes receive `pm.execute`, not `pm.plan`: they may create a Backlog
46
- proposal or file a bug. Require the Ready transition only when PM/watch supplied
47
- the work or the agent is operating unattended. In an interactive coding session,
48
- the user's direct request is already execution authority; record it in PM and
49
- continue without asking the same user for a duplicate board click. Do not treat
50
- a 403 as a reason to widen the grant.
43
+ Ready is a durable reviewed-contract handoff. Any principal with app/project PM
44
+ mutation access may refine a complete task and mark it Ready; ordinary managed
45
+ agent `pm.execute` grants carry that PM-write authority. Require an existing
46
+ Ready transition when PM/watch supplied the work or the agent is operating
47
+ unattended. In an interactive coding session, the user's direct request is
48
+ already execution authority: record/refine the complete task, mark it Ready,
49
+ and claim it without asking the same user for a duplicate board click.
51
50
 
52
51
  Create/refine the task with one alignment source, an actionable description,
53
52
  acceptance criteria, and execution mode:
@@ -114,8 +113,8 @@ npx --yes @odla-ai/cli@latest pm task release <task-id> --expected-revision <rev
114
113
  ```
115
114
 
116
115
  Comment with the branch/worktree, last verified commit, unfinished step, and
117
- safe next action. An agent may release only its own claim; a human project
118
- operator may recover an abandoned claim. Claims do not yet have automatic
116
+ safe next action. Any authorized project PM writer may release an abandoned
117
+ claim; the event records who recovered it. Claims do not yet have automatic
119
118
  leases, so never leave one active as a substitute for a handoff.
120
119
 
121
120
  ## 7. Resume safely
@@ -97,14 +97,12 @@ npx --yes @odla-ai/cli@latest pm decision list --q "stripe"
97
97
  `task release` explicitly returns an active claim to Ready. A stale revision
98
98
  or concurrent claim is a conflict, so reload instead of overwriting it.
99
99
 
100
- Task authority has an intentional handshake boundary. `pm.plan` may refine,
101
- delete, or mark tasks Ready but cannot claim them. `pm.execute` may create
102
- Backlog proposals and findings, claim/release, and move its claimed work through
103
- Review and Done, but cannot approve Ready or change the task contract. Ordinary
104
- managed-agent approval includes `pm.execute`; it does not include `pm.plan`.
105
- Human project owners retain planning authority through ownership. Legacy
106
- `pm.write` grants remain executable so existing claims are not stranded, but do
107
- not gain planning authority.
100
+ Task lifecycle maintenance uses app/project PM mutation authority. `pm.plan`,
101
+ `pm.execute`, and legacy `pm.write` all carry ordinary PM-write access, so their
102
+ holders may refine a task, validate and mark its complete contract Ready, move
103
+ it through Review/Done, and recover a stale claim. Claim acquisition remains a
104
+ separate `pm.execute` action so exactly one executor starts a Ready revision;
105
+ `pm.plan` alone cannot claim it. Claims coordinate work and never own the row.
108
106
 
109
107
  This split coordinates unattended work; it is not an interactive approval
110
108
  gate. When a user directly requests work in the active coding session, record
@@ -139,9 +137,9 @@ goal links and comments rather than sharing a working tree or status document.
139
137
 
140
138
  **While you build:**
141
139
 
142
- - Propose work in Backlog. A human owner or `pm.plan` agent reviews/refines it,
143
- links it to an open same-project goal (or accepted alignment decision), adds
144
- an actionable description and acceptance criteria, then runs `pm task ready
140
+ - Propose work in Backlog. Any authorized project PM writer may review/refine
141
+ it, link it to an open same-project goal (or accepted alignment decision), add
142
+ an actionable description and acceptance criteria, then run `pm task ready
145
143
  <id> --expected-revision <n>`. The stored column is still `todo` for API
146
144
  compatibility, but every product surface calls it Ready.
147
145
  - An agent starts only with `pm task claim <id> --expected-revision <n>`. The