@awebai/oats 0.66.0 → 0.67.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.
Files changed (65) hide show
  1. package/bin/oats.mjs +66 -13
  2. package/docs/capabilities.md +4 -4
  3. package/docs/capability-manifest.schema.json +1 -1
  4. package/docs/desktop-cli-api.md +217 -6
  5. package/docs/desktop.md +101 -22
  6. package/docs/implementation.md +6 -5
  7. package/docs/official-catalog.md +1 -1
  8. package/docs/packages.md +5 -5
  9. package/docs/release-lane.md +16 -0
  10. package/docs/release-notes/v0.67.0.md +366 -0
  11. package/docs/release-notes/v0.67.1.md +64 -0
  12. package/docs/servers.md +3 -2
  13. package/docs/souls-and-instances.md +20 -3
  14. package/docs/tui.md +570 -176
  15. package/docs/upgrading.md +107 -25
  16. package/docs/workspaces.md +1 -1
  17. package/lib/capability-contract.mjs +2 -2
  18. package/lib/core.mjs +126 -54
  19. package/lib/instance-color.mjs +58 -0
  20. package/lib/instance-inspect.mjs +107 -23
  21. package/lib/instance-lifecycle.mjs +21 -1
  22. package/lib/instance-naming.mjs +187 -0
  23. package/lib/instance-resolution.mjs +5 -1
  24. package/lib/materialize.mjs +62 -11
  25. package/lib/servers.mjs +15 -6
  26. package/lib/soul-composition.mjs +7 -3
  27. package/package-catalog.json +1 -1
  28. package/package.json +1 -1
  29. package/packages/client/cli-adapter.mjs +37 -5
  30. package/packages/client/cli-locator.mjs +2 -2
  31. package/packages/client/composed-gate.mjs +10 -2
  32. package/packages/client/deployment-data.mjs +5 -0
  33. package/packages/client/deployment-identity.mjs +40 -0
  34. package/packages/client/deployment-panel.mjs +3 -1
  35. package/packages/client/inspect-boundary.mjs +11 -7
  36. package/packages/client/inspect-cache.mjs +2 -2
  37. package/packages/client/instance-name.mjs +28 -0
  38. package/packages/client/instance-presentation.mjs +11 -0
  39. package/packages/client/keymap.mjs +85 -24
  40. package/packages/client/keys-file.mjs +122 -0
  41. package/packages/client/own-codes.mjs +4 -2
  42. package/packages/client/panel-views.mjs +62 -9
  43. package/packages/client/spawn-naming.mjs +31 -0
  44. package/packages/client/spawn-preview-cli.mjs +22 -7
  45. package/packages/client/spawn-preview-contract.mjs +24 -0
  46. package/packages/client/spawn-preview-facts.mjs +8 -4
  47. package/packages/client/spawn-preview.mjs +47 -2
  48. package/packages/tui/README.md +3 -3
  49. package/packages/tui/lib/actions.mjs +57 -14
  50. package/packages/tui/lib/client.mjs +8 -4
  51. package/packages/tui/lib/config.mjs +50 -9
  52. package/packages/tui/lib/main.mjs +40 -13
  53. package/packages/tui/lib/model.mjs +167 -63
  54. package/packages/tui/lib/read.mjs +53 -1
  55. package/packages/tui/lib/store.mjs +148 -54
  56. package/packages/tui/lib/term/keys.mjs +19 -5
  57. package/packages/tui/lib/term/kitty.mjs +36 -11
  58. package/packages/tui/lib/term/through.mjs +61 -28
  59. package/packages/tui/lib/views/frame.mjs +158 -79
  60. package/packages/tui/lib/views/help.mjs +109 -26
  61. package/packages/tui/lib/views/instances.mjs +59 -20
  62. package/packages/tui/lib/views/palette.mjs +14 -4
  63. package/packages/tui/lib/views/souls.mjs +2 -2
  64. package/packages/tui/lib/views/switcher.mjs +6 -1
  65. package/skills/oats-getting-started/SKILL.md +13 -8
@@ -0,0 +1,64 @@
1
+ # OATS 0.67.1
2
+
3
+ Unreleased
4
+
5
+ **0.67.1 is the first published 0.67 release.** v0.67.0 was tagged but never
6
+ published: its release run stopped before npm and the Desktop Release, on
7
+ Desktop tests that failed on macOS (Fixed, below). Everything in
8
+ [0.67.0's notes](v0.67.0.md) ships in 0.67.1.
9
+
10
+ ## Upgrade
11
+
12
+ - **Do [0.67.0's Upgrade steps](v0.67.0.md#upgrade):** they are this
13
+ release's. Install the Desktop first and the CLI second: a 0.66 Desktop
14
+ refuses a 0.67.1 CLI. The 0.67.1 Desktop accepts OATS CLIs
15
+ `>=0.26.0 <0.68.0`. The leader moves to Ctrl+X, and the shortcuts on Linux
16
+ and Windows move to Ctrl+Alt; the official catalog pins oats.framework
17
+ 1.13.5.
18
+
19
+ - **Coming from 0.65 or earlier:** do 0.66.0's Upgrade steps too, and
20
+ 0.62.0's when coming from 0.61 or earlier.
21
+
22
+ ## Added
23
+
24
+ - **`/oats-upgrade`, an oats.setup skill for "upgrade OATS" and "update to
25
+ the latest".** It takes the latest version from
26
+ `npm view @awebai/oats version`, reads [Upgrading](../upgrading.md) and
27
+ the `## Upgrade` section of every release after the installed one at the
28
+ tag `v<latest>`, never the copy in the installed CLI, and walks the person
29
+ through each release's own steps, the Desktop, the CLI, the pi bridges in
30
+ every deployment and `oats doctor`, one step on each yes. On a tag whose page does not
31
+ open with the latest version yet (up to v0.67.0), it takes the order from
32
+ the page and the version and the Desktop's CLIs from the latest release's
33
+ notes. `/oats-setup-model` points at it instead of the installed copy. It
34
+ ships with the next oats.framework release
35
+ ([#1440](https://github.com/awebai/oats/issues/1440)).
36
+
37
+ ## Fixed
38
+
39
+ - **The spawn dialog's name suggestion refuses an oversized request before
40
+ it reads it.** The Desktop's spawn-preview proxy now refuses a body past
41
+ its limit before parsing it; a parsed body that is not a suggestion read
42
+ keeps a preview's 16 KiB limit
43
+ ([#1441](https://github.com/awebai/oats/pull/1441), follow-up to
44
+ [#1438](https://github.com/awebai/oats/pull/1438)).
45
+
46
+ - **Three Desktop keymap tests assumed the Linux keys,** so they failed on
47
+ macOS, and one of them kept `node --test` from ending; the v0.67.0 release
48
+ run stopped there. They now pin the platform they test. No shipped code
49
+ changes ([#1445](https://github.com/awebai/oats/pull/1445);
50
+ [#1433](https://github.com/awebai/oats/issues/1433)).
51
+
52
+ ## Documentation
53
+
54
+ - **[Upgrading](../upgrading.md) opens with "Upgrading to the latest
55
+ version":** the latest version, the CLIs its Desktop accepts and the
56
+ steps. What each older release asks of a host that comes from it is under
57
+ "Coming from an older version", one line per release, newest first, each
58
+ linking its notes; the capture service's release order is there too. The
59
+ page states only the latest Desktop's CLIs; the earlier ones stay in
60
+ their notes ([#1440](https://github.com/awebai/oats/issues/1440)).
61
+ - **The release-prep pull request updates that section with the notes**
62
+ ([Release lane](../release-lane.md#for-the-tag-owner)), and
63
+ `test/release-packaging.test.mjs` checks that it names the version the
64
+ manifests carry, and no other.
package/docs/servers.md CHANGED
@@ -235,7 +235,7 @@ sent as text or on stdin, never as paths.
235
235
 
236
236
  | Command | Where it runs | The server must advertise |
237
237
  |---|---|---|
238
- | `spawn` | registered workspace | the requested harness, backend and yolo option; `launch-config` for `--launch-config`; `schedule` for a wake schedule; `spawn-preview-2` for `--preview` |
238
+ | `spawn` | registered workspace | the requested harness, backend and yolo option; `launch-config` for `--launch-config`; `schedule` for a wake schedule; `spawn-preview-2` for `--preview`, and `spawn-suggest-name` for `--suggest-name` |
239
239
  | `status` | registered workspace | |
240
240
  | `retire` | the instance's home | `retire-home` to retire by exact home |
241
241
  | `session inspect`, `session attach` | the instance's home | `session`; `session-attach-detach-key` for `attach --detach-key` |
@@ -244,11 +244,12 @@ sent as text or on stdin, never as paths.
244
244
  | `okf harvest --instance <name>` | the saved home | `harvest` |
245
245
  | `schedule ...` | registered workspace | `schedule` |
246
246
  | `launch-config list\|set\|remove\|preview` | `--dir`, the instance's home, or the registered workspace | `launch-config` |
247
- | `inspect`, `operation run` | `--dir`, the instance's home, or the registered workspace | `operations`; `inspect --instructions` also `soul-composed-instructions`, `inspect --skills` also `soul-skills` |
247
+ | `inspect`, `operation run` | `--dir`, the instance's home, or the registered workspace | `operations`; `inspect --instructions` also `soul-composed-instructions`, `inspect --skills` also `soul-skills`, `inspect --composed-skills` also `soul-composed-skills` |
248
248
  | `readiness` | the instance's home, `--dir`, or the registered workspace | `readiness` (`readinessApi: 2`) |
249
249
  | `instance events` | the instance's home | `instance-events-2` (`eventsApi: 2`) |
250
250
  | `instance git`, `instance diff` | the instance's home; the Git runs there | `instance-git` (`instanceGitApi: 1`) |
251
251
  | `instance stop --plan\|--apply`, `retire --plan`, `retire --plan-revision … --idempotency-key …` | the instance's home | `lifecycle-plans` (`lifecycleApi: 1`) |
252
+ | `instance color` | the instance's home | `instance-color` |
252
253
 
253
254
  Before every routed command except `status`, the kernel reads the server's
254
255
  `oats version --json`. A remote OATS older than 0.22.1 is refused, and so is a
@@ -313,15 +313,32 @@ locally refused legacy instance selector. For preview confirmation and receipt
313
313
  replay, see the [spawn decision and apply contract](desktop-cli-api.md#the-decision).
314
314
 
315
315
  ```bash
316
- oats spawn release-manager --purpose cut-3.2 --task "…" # a soul of a confirmed member
316
+ oats spawn release-manager --name cut-3-2-manager --task "…" # a soul of a confirmed member
317
317
  oats spawn release-manager --preview --json # decide everything, create nothing
318
318
  oats spawn release-manager --provider oats.aweb identity.source=/abs/path/to/retained/.aw # instance-level payload
319
319
  ```
320
320
 
321
- An instance is named `<soul>-<purpose>` by default, or exactly `--name <slug>`.
321
+ An instance is named exactly `--name <slug>`, or `<soul>-<purpose>` with
322
+ `--purpose`; with neither, the kernel numbers it. The convention for a name a
323
+ person or an agent chooses is `<descriptive>-<role>` through `--name`: a few
324
+ words for the instance's work, then the soul's role, the last word of the
325
+ soul's name after any package qualifier (`--name desktop-improvements-expert`
326
+ for an `oats-desktop-expert`). `--purpose` derives the name from the soul, for
327
+ automations and scripts that know only the soul and a purpose.
322
328
  Names are unique per deployment (a workspace-model deployment has one agents
323
329
  root): a derived name in use gets `-2`, `-3`…; an explicit `--name` in use is
324
- refused (`E_INSTANCE_NAME_TAKEN`).
330
+ refused (`E_INSTANCE_NAME_TAKEN`). The Desktop's spawn dialog adds the role to
331
+ a typed name.
332
+ `oats spawn <soul> --preview --suggest-name --task-file <f>` asks the soul's
333
+ own harness for the descriptive words, from the task, in one call that starts
334
+ none of the user's MCP servers, hooks, plugins or extensions. Claude Code's
335
+ built-in plugins, the host's managed-policy hooks and pi's credential commands
336
+ are the stated exceptions; a claude login through `apiKeyHelper` is not read,
337
+ so that user's name stays numbered (`harness-failed`). The preview then answers for
338
+ `--name <descriptive>-<role>`, de-duplicated the same way. On claude and pi
339
+ only; any other harness, and any failure of the call, leaves the name numbered
340
+ and says why
341
+ ([The suggested name](desktop-cli-api.md#the-suggested-name-feature-spawn-suggest-name)).
325
342
 
326
343
  From a deployment (where `oats-local.yaml` is), a spawn: reads the local file →
327
344
  discovers the workspace over its remotes and confirms membership → finds the