@workser/cli 0.6.11 → 0.6.13

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@workser/cli",
3
- "version": "0.6.11",
3
+ "version": "0.6.13",
4
4
  "description": "Workser CLI — give your local AI agent native DevOps & infrastructure on Workser. The agent runs `workser …` to provision, deploy, and manage real apps.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -30,7 +30,7 @@ load.
30
30
  | Build an automation, or use Gmail/Slack/Stripe/Sheets | `workflow …`, `app …` | `workser help automation` |
31
31
  | Generate an image | `image …` | `workser help images` |
32
32
  | Hand a subtask to another agent | `agent …` | `workser help roles` |
33
- | Remember or recall something across conversations | `memory …` | `workser help memory` |
33
+ | Recall across conversations; leave this task's team a fact | `memory …`, `workser note` | `workser help memory` |
34
34
  | Record finished output, or ask the user a question | `artifact …`, `ask` | `workser help deliverables` |
35
35
  | Control this machine — files, shell, screen, browser | `tool …` | `workser help computer-use` |
36
36
 
@@ -43,7 +43,7 @@ come from the CLI itself, so they match the version you are running.
43
43
  workser status # connection + pinned project + latest deploy
44
44
  workser whoami # who am I / which workspace
45
45
  workser project show # the project pinned to this directory
46
- workser project list # the workspace's projects (read)
46
+ workser project list # your organization's projects
47
47
  workser verify # run typecheck/lint/build — gate "done" on this
48
48
  workser doctor # resolved endpoint, mode, token presence, project
49
49
  workser login # authenticate outside Orbit (CI/standalone)
@@ -52,24 +52,26 @@ workser logout # clear a saved standalone session
52
52
 
53
53
  ## Scope (read this)
54
54
 
55
- You operate on **one project's own infrastructure**. You *can* provision and use it:
55
+ You operate on **a project's own infrastructure**. You *can* provision and use it:
56
56
  create the Neon database, read its connection string, browse its tables / rows / run
57
57
  SQL, provision the bucket + auth, deploy, set env vars, manage files. Sensitive
58
- actions are **gated** the daemon may return `error.code = "awaiting_approval"`
59
- (exit 5); say so, stop, don't loop (rule 5).
58
+ actions are **gated** (`awaiting_approval`, exit 5) see rule 5.
60
59
 
61
60
  What you **cannot** do is administer the project set or destroy config:
62
61
  `project create` · `project use` · `env rm` · `domain set` return
63
62
  `error.code = "owner_only"` (exit 6). Tell the user it's an owner action to do in
64
- Orbit, then continue with what you can. The project is already selected; you don't
65
- pick or switch it.
63
+ Orbit, then continue.
64
+
65
+ **One organization.** The folder (or the project open in Workser) sets it. You
66
+ may move between its projects — `--project <id>`, or `cd`. Another org
67
+ returns `error.code = "out_of_scope"` (exit 7) and runs nothing.
66
68
 
67
69
  ## Golden rules
68
70
 
69
71
  1. **Always pass `--json`.** Output is then a single stable line:
70
72
  `{"ok":true,"data":...}` or `{"ok":false,"error":{"code","message",...}}`. Parse it.
71
73
  2. **Orient first.** Run `workser status --json` to see the connection, the pinned
72
- project, and the latest deploy before acting. You don't pick or switch projects.
74
+ project, and the latest deploy before acting.
73
75
  For anything beyond a trivial edit, also read what the project already knows:
74
76
  `workser decision list --json` (what was already decided, so you don't quietly
75
77
  reverse it), and `workser design show --json` before writing UI. This project
@@ -80,10 +82,10 @@ pick or switch it.
80
82
  `doc create`, plus `decision create` for a real tradeoff. A plan in your
81
83
  reply alone is gone when the conversation scrolls. How to correct a wrong
82
84
  row, and what not to link: `workser help sdlc-entities`.
83
- 4. **Stay in your lane.** `error.code = "owner_only"` (exit 6) means the action is
84
- reserved for the owner in Orbit. Don't retry or look for a workaround — tell the
85
- user, then continue. Provisioning the *pinned project's own* db / bucket / auth is
86
- allowed (it may be approval-gated, not owner-only).
85
+ 4. **Stay in your lane.** On `owner_only` (exit 6) or `out_of_scope` (exit 7),
86
+ don't retry or look for a workaround — tell the user, then continue.
87
+ Provisioning the *pinned project's own* db / bucket / auth is allowed (it may
88
+ be approval-gated, not owner-only).
87
89
  5. **Approvals are normal — likely unattended, nobody watching.** An action may
88
90
  return `{"error":{"code":"awaiting_approval"}}` (exit 5). Say so, **stop this
89
91
  turn** — never a retry loop or sleep-and-recheck, it just times out. Works next