@odla-ai/cli 0.41.1 → 0.42.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/bin/odla-ai.js +2 -3
- package/bin/workspace-build.d.ts +1 -0
- package/bin/workspace-build.js +8 -0
- package/dist/bin.cjs +40 -28
- package/dist/bin.cjs.map +1 -1
- package/dist/bin.js +1 -1
- package/dist/{chunk-6RGM4W73.js → chunk-FWPQSTNF.js} +40 -28
- package/dist/chunk-FWPQSTNF.js.map +1 -0
- package/dist/{cli-N5PASRYU.js → cli-K5SBFFAY.js} +2 -2
- package/dist/index.cjs +39 -27
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/skills/odla/SKILL.md +6 -6
- package/skills/odla/references/agent-identity.md +4 -3
- package/skills/odla/references/pm-work-intake.md +9 -10
- package/skills/odla/references/pm.md +9 -11
- package/dist/chunk-6RGM4W73.js.map +0 -1
- /package/dist/{cli-N5PASRYU.js.map → cli-K5SBFFAY.js.map} +0 -0
package/dist/index.d.cts
CHANGED
|
@@ -92,7 +92,7 @@ interface CodeHostCapabilities {
|
|
|
92
92
|
};
|
|
93
93
|
}
|
|
94
94
|
type Output$1 = Pick<typeof console, "log" | "error">;
|
|
95
|
-
/** Inputs for enrolling the current checkout and running its foreground
|
|
95
|
+
/** Inputs for enrolling the current checkout and running its foreground Theseus host. */
|
|
96
96
|
interface CodeConnectOptions {
|
|
97
97
|
configPath: string;
|
|
98
98
|
/** Repository root. Defaults to the current directory. */
|
|
@@ -139,11 +139,11 @@ interface CodeRuntimeInput {
|
|
|
139
139
|
sourceDir: string;
|
|
140
140
|
};
|
|
141
141
|
}
|
|
142
|
-
/** Enroll this machine from an odla project and keep the
|
|
142
|
+
/** Enroll this machine from an odla project and keep the Theseus runtime
|
|
143
143
|
* online. Both the approval grant and host credential hashes are stored in
|
|
144
144
|
* odla-ai/db; plaintext host authority exists only in this running process. */
|
|
145
145
|
declare function codeConnect(options: CodeConnectOptions): Promise<void>;
|
|
146
|
-
/** Run outbound presence and fenced
|
|
146
|
+
/** Run outbound presence and fenced Theseus commands without opening a listener. */
|
|
147
147
|
declare function runCodeRuntime(input: CodeRuntimeInput): Promise<void>;
|
|
148
148
|
|
|
149
149
|
interface RunResult {
|
package/dist/index.d.ts
CHANGED
|
@@ -92,7 +92,7 @@ interface CodeHostCapabilities {
|
|
|
92
92
|
};
|
|
93
93
|
}
|
|
94
94
|
type Output$1 = Pick<typeof console, "log" | "error">;
|
|
95
|
-
/** Inputs for enrolling the current checkout and running its foreground
|
|
95
|
+
/** Inputs for enrolling the current checkout and running its foreground Theseus host. */
|
|
96
96
|
interface CodeConnectOptions {
|
|
97
97
|
configPath: string;
|
|
98
98
|
/** Repository root. Defaults to the current directory. */
|
|
@@ -139,11 +139,11 @@ interface CodeRuntimeInput {
|
|
|
139
139
|
sourceDir: string;
|
|
140
140
|
};
|
|
141
141
|
}
|
|
142
|
-
/** Enroll this machine from an odla project and keep the
|
|
142
|
+
/** Enroll this machine from an odla project and keep the Theseus runtime
|
|
143
143
|
* online. Both the approval grant and host credential hashes are stored in
|
|
144
144
|
* odla-ai/db; plaintext host authority exists only in this running process. */
|
|
145
145
|
declare function codeConnect(options: CodeConnectOptions): Promise<void>;
|
|
146
|
-
/** Run outbound presence and fenced
|
|
146
|
+
/** Run outbound presence and fenced Theseus commands without opening a listener. */
|
|
147
147
|
declare function runCodeRuntime(input: CodeRuntimeInput): Promise<void>;
|
|
148
148
|
|
|
149
149
|
interface RunResult {
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@odla-ai/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.42.1",
|
|
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",
|
package/skills/odla/SKILL.md
CHANGED
|
@@ -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.
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
through PM. A direct request from the user
|
|
242
|
-
session is already authority: record it,
|
|
243
|
-
|
|
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
|
|
99
|
-
|
|
100
|
-
|
|
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
|
|
44
|
-
|
|
45
|
-
agent
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
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.
|
|
118
|
-
|
|
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
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
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.
|
|
143
|
-
|
|
144
|
-
an actionable description and acceptance criteria, then
|
|
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
|