@awebai/oats 0.66.0 → 0.68.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/bin/oats.mjs +166 -17
- package/docs/capabilities.md +58 -9
- package/docs/capability-manifest.schema.json +5 -1
- package/docs/design/2026-10-22-module-upgrade.md +192 -0
- package/docs/design/README.md +4 -0
- package/docs/desktop-cli-api.md +463 -13
- package/docs/desktop.md +363 -67
- package/docs/first-team.md +5 -3
- package/docs/implementation.md +46 -6
- package/docs/integrations.md +16 -4
- package/docs/knowledge.md +44 -27
- package/docs/layers.md +2 -2
- package/docs/official-catalog.md +5 -5
- package/docs/packages.md +14 -14
- package/docs/release-lane.md +16 -0
- package/docs/release-notes/v0.67.0.md +366 -0
- package/docs/release-notes/v0.67.1.md +64 -0
- package/docs/release-notes/v0.68.0.md +504 -0
- package/docs/servers.md +8 -2
- package/docs/souls-and-instances.md +58 -6
- package/docs/tui.md +1033 -237
- package/docs/upgrading.md +164 -26
- package/docs/workspaces.md +2 -2
- package/lib/capability-contract.mjs +8 -7
- package/lib/core.mjs +331 -75
- package/lib/instance-color.mjs +58 -0
- package/lib/instance-events.mjs +1 -1
- package/lib/instance-inspect.mjs +107 -23
- package/lib/instance-lifecycle.mjs +21 -1
- package/lib/instance-naming.mjs +187 -0
- package/lib/instance-resolution.mjs +10 -6
- package/lib/instance-upgrade.mjs +1445 -0
- package/lib/materialize.mjs +287 -89
- package/lib/servers.mjs +24 -11
- package/lib/soul-composition.mjs +7 -3
- package/lib/upgrade-state.mjs +101 -0
- package/lib/workspace.mjs +4 -1
- package/lib/worktree.mjs +103 -12
- package/package-catalog.json +5 -4
- package/package.json +1 -1
- package/packages/client/cli-adapter.mjs +52 -6
- package/packages/client/cli-locator.mjs +2 -2
- package/packages/client/composed-gate.mjs +10 -2
- package/packages/client/deployment-data.mjs +5 -0
- package/packages/client/deployment-identity.mjs +40 -0
- package/packages/client/deployment-panel.mjs +9 -3
- package/packages/client/inspect-boundary.mjs +11 -7
- package/packages/client/inspect-cache.mjs +2 -2
- package/packages/client/instance-name.mjs +28 -0
- package/packages/client/instance-presentation.mjs +11 -0
- package/packages/client/keymap.mjs +133 -28
- package/packages/client/keys-file.mjs +126 -0
- package/packages/client/own-codes.mjs +4 -2
- package/packages/client/panel-views.mjs +78 -12
- package/packages/client/spawn-naming.mjs +32 -0
- package/packages/client/spawn-preview-cli.mjs +58 -7
- package/packages/client/spawn-preview-contract.mjs +59 -0
- package/packages/client/spawn-preview-facts.mjs +8 -4
- package/packages/client/spawn-preview.mjs +81 -3
- package/packages/client/team-members.mjs +4 -1
- package/packages/client/workspace-step.mjs +25 -0
- package/packages/tui/README.md +7 -7
- package/packages/tui/lib/actions.mjs +92 -25
- package/packages/tui/lib/client.mjs +9 -4
- package/packages/tui/lib/config.mjs +50 -9
- package/packages/tui/lib/main.mjs +65 -24
- package/packages/tui/lib/model.mjs +292 -75
- package/packages/tui/lib/read.mjs +53 -1
- package/packages/tui/lib/store.mjs +469 -100
- package/packages/tui/lib/term/keys.mjs +22 -6
- package/packages/tui/lib/term/kitty.mjs +54 -11
- package/packages/tui/lib/term/screen.mjs +15 -6
- package/packages/tui/lib/term/through.mjs +66 -28
- package/packages/tui/lib/views/frame.mjs +223 -165
- package/packages/tui/lib/views/help.mjs +134 -29
- package/packages/tui/lib/views/instances.mjs +63 -22
- package/packages/tui/lib/views/palette.mjs +14 -4
- package/packages/tui/lib/views/souls.mjs +2 -2
- package/packages/tui/lib/views/switcher.mjs +6 -1
- package/packages/tui/lib/views/workspaces.mjs +55 -0
- package/skills/oats-getting-started/SKILL.md +96 -42
|
@@ -0,0 +1,366 @@
|
|
|
1
|
+
# OATS 0.67.0
|
|
2
|
+
|
|
3
|
+
Unreleased
|
|
4
|
+
|
|
5
|
+
## Upgrade
|
|
6
|
+
|
|
7
|
+
- **Install the Desktop first and the CLI second,** as
|
|
8
|
+
[Upgrading](../upgrading.md) says: a 0.66 Desktop refuses a 0.67.0 CLI. The
|
|
9
|
+
0.67.0 Desktop accepts OATS CLIs `>=0.26.0 <0.68.0`.
|
|
10
|
+
|
|
11
|
+
- **Coming from 0.65 or earlier:** do 0.66.0's Upgrade steps too (`oats
|
|
12
|
+
tui`'s key file moves to `~/.oats/config/tui.json`, and `oats server
|
|
13
|
+
connect` needs `--dir`), and 0.62.0's when coming from 0.61 or earlier.
|
|
14
|
+
|
|
15
|
+
- **One package move:** the official catalog pins oats.framework 1.13.5
|
|
16
|
+
(Provider updates, below). A deployment that pins it takes it with `oats
|
|
17
|
+
sync`, and only new spawns use it. No floor changes.
|
|
18
|
+
|
|
19
|
+
- **The leader moves to Ctrl+X** in OATS Desktop and in `oats tui`, on every
|
|
20
|
+
platform (Changed, below). A Desktop rebind of the leader and an
|
|
21
|
+
`open.detachKey` in `tui.json` are kept. To keep Alt+O or ⌃\, bind it
|
|
22
|
+
again: `"open": {"detachKey": "M-o"}` (or `"C-\\"`) in `tui.json`, the
|
|
23
|
+
shortcuts editor in the Desktop. **A `tui.json` that gives `ctrl+x` to an
|
|
24
|
+
action and names no leader stops `oats tui` from starting:** its line on
|
|
25
|
+
stderr names the action; give that action another key, or name a leader
|
|
26
|
+
in `open.detachKey` ([Change the keys](../tui.md#change-the-keys-tuijson)).
|
|
27
|
+
|
|
28
|
+
- **The shortcuts move on Linux and Windows** (Changed, below): the shared
|
|
29
|
+
chords are Ctrl+Alt now, not Ctrl+Shift, in OATS Desktop as in `oats tui`.
|
|
30
|
+
A shortcut you rebound in 0.66 is kept. If your terminal passes Ctrl+Shift
|
|
31
|
+
apart from Ctrl (foot, Alacritty), choose the Ctrl+Shift option instead
|
|
32
|
+
(Added, below). The Alt+Shift arrows no longer reach an agent in its
|
|
33
|
+
terminal.
|
|
34
|
+
|
|
35
|
+
## Added
|
|
36
|
+
|
|
37
|
+
- **An instance has a colour** (feature `instance-color`, awebai/oats#1421).
|
|
38
|
+
`oats instance color <instance> (<colour> | --clear)` sets or clears it,
|
|
39
|
+
from the palette `sand`, `sage`, `slate`, `mauve`, `clay`, `olive`; it is
|
|
40
|
+
addressed as `oats instance stop` addresses an instance, and routed with
|
|
41
|
+
`--server`. The colour is presentation only: anyone may change it, and it
|
|
42
|
+
is never an address. It is kept in the home's own record,
|
|
43
|
+
`.oats-color.json`, which a start or restart never rewrites and a retire
|
|
44
|
+
does not count as a change to the home. `oats status --json` rows,
|
|
45
|
+
`oats server roster --json` rows and `oats inspect --home` carry `color`
|
|
46
|
+
([An instance's colour](../desktop-cli-api.md#an-instances-colour-oats-instance-color)).
|
|
47
|
+
|
|
48
|
+
- **`oats inspect --soul <soul> --composed-skills` lists every skill a spawn
|
|
49
|
+
of the soul gives its instance** (feature `soul-composed-skills`,
|
|
50
|
+
awebai/oats#1421): its own skills and each capability's, each with its
|
|
51
|
+
`source` (`soul` or `module:<capability>`) and each file's text, from the
|
|
52
|
+
same scratch composition as `--instructions`. A collision a spawn would
|
|
53
|
+
refuse makes the field `null` with spawn's own message. It is opt-in, takes
|
|
54
|
+
`--soul` only, and a routed host without the feature refuses it
|
|
55
|
+
([`oats inspect`](../desktop-cli-api.md#oats-inspect---home-----soul----dir----json--operationsapi-2)).
|
|
56
|
+
|
|
57
|
+
- **`oats spawn <soul> --preview --suggest-name` names the instance from its
|
|
58
|
+
task** (feature `spawn-suggest-name`, awebai/oats#1421). The soul's own
|
|
59
|
+
harness gives a few descriptive words in one call, and the preview answers
|
|
60
|
+
for `--name <descriptive>-<role>`, with the same decision an apply with
|
|
61
|
+
`--expect-decision` matches. The call starts none of the user's MCP
|
|
62
|
+
servers, hooks, plugins or extensions, and no tool on either harness: the
|
|
63
|
+
prompt goes on stdin, from an empty temporary directory, in its own process
|
|
64
|
+
group, within the preview's 20 s preflight budget, after its harness checks.
|
|
65
|
+
- **Supported harnesses: claude (model `haiku`) and pi (the instance's
|
|
66
|
+
model)**, proven on Linux with claude 2.1.288 and pi 1.3.0
|
|
67
|
+
(`scripts/naming-isolation-proof.mjs`).
|
|
68
|
+
- **Three stated exceptions:** Claude Code's own built-in plugins
|
|
69
|
+
(`cc-plugin-*@builtin`) load as they always do, `--bare` included; hooks
|
|
70
|
+
in the host's managed policy still apply; and pi runs its own credential
|
|
71
|
+
commands (`!command` keys and headers in models.json), as every pi launch
|
|
72
|
+
does. A claude login through `apiKeyHelper` is not read, so such a user
|
|
73
|
+
gets `harness-failed` and a numbered name.
|
|
74
|
+
- **codex is not supported yet:** a codex soul's preview is numbered, with
|
|
75
|
+
`naming.reason: "unsupported-harness"`.
|
|
76
|
+
- **A failure is never an error.** The preview numbers the instance as
|
|
77
|
+
before and says why in `naming.reason`: `no-task`, `unsupported-harness`,
|
|
78
|
+
`timeout`, `harness-failed` or `invalid-reply`.
|
|
79
|
+
- Routed with `--server`, the host must advertise the feature
|
|
80
|
+
([The suggested name](../desktop-cli-api.md#the-suggested-name-feature-spawn-suggest-name)).
|
|
81
|
+
|
|
82
|
+
- **One chord for each everyday action, the same in `oats tui` and OATS
|
|
83
|
+
Desktop, from every focus, an agent's terminal too, with no leader first**
|
|
84
|
+
([Chords](../tui.md#chords);
|
|
85
|
+
[desktop-keyboard.md](../../packages/desktop/docs/desktop-keyboard.md)).
|
|
86
|
+
On Linux and Windows:
|
|
87
|
+
- `Ctrl+Alt+O` opens the switcher.
|
|
88
|
+
- `Alt+Shift+Up` and `Alt+Shift+Down` open the terminal of the previous
|
|
89
|
+
or next instance.
|
|
90
|
+
- `Ctrl+Alt+1` to `Ctrl+Alt+8` show the first to eighth tab, and
|
|
91
|
+
`Ctrl+Alt+9` the last one.
|
|
92
|
+
- `Ctrl+Alt+Z` zooms the shown terminal.
|
|
93
|
+
- `Ctrl+Alt+A` goes to the other split group.
|
|
94
|
+
|
|
95
|
+
The Desktop's macOS chords are `⌘⌥O`, `⌘⌥↑`, `⌘⌥↓`, `⌘⌥1` to `⌘⌥9`, `⌘⌥Z`
|
|
96
|
+
and `⌘⌥A`. Help, the views, and stop, restart, start and retire stay on
|
|
97
|
+
the leader, which still works everywhere.
|
|
98
|
+
- **In `oats tui` the Ctrl+Alt chords need the kitty keyboard protocol,**
|
|
99
|
+
as the 0.66 chords did. The Alt+Shift arrows work in every terminal on
|
|
100
|
+
Linux and Windows, GNOME Terminal included. On macOS `oats tui` has no
|
|
101
|
+
chords: the leader does it all there.
|
|
102
|
+
- **While the terminal confirms the protocol, the help and the cheat sheet
|
|
103
|
+
lead with the chords,** each with its leader key beside it. The leader
|
|
104
|
+
keeps its own section.
|
|
105
|
+
- **A character typed with AltGr stays a character.** On Windows `AltGr`
|
|
106
|
+
is `Ctrl+Alt`: where it types a character (Spanish `€`, `@` and `#`,
|
|
107
|
+
Polish `ą`, `ę`, `ó` and `ż`), that key types it in both clients, and
|
|
108
|
+
the leader does what the chord would.
|
|
109
|
+
- **Windows Terminal takes `Ctrl+Alt+1` to `Ctrl+Alt+9`** for its own tabs,
|
|
110
|
+
and the Alt+Shift arrows while its panes are split.
|
|
111
|
+
[The matrix](../tui.md#which-terminals-let-the-chords-through) lists
|
|
112
|
+
what each terminal takes.
|
|
113
|
+
|
|
114
|
+
- **A Ctrl+Shift option for the shared chords, in `oats tui` and OATS
|
|
115
|
+
Desktop at once,** on Linux and Windows
|
|
116
|
+
([Switch to Ctrl+Shift](../tui.md#switch-to-ctrlshift);
|
|
117
|
+
[desktop-keyboard.md](../../packages/desktop/docs/desktop-keyboard.md)).
|
|
118
|
+
It is for a terminal that lets Ctrl+Shift letters through to `oats tui`:
|
|
119
|
+
foot and Alacritty
|
|
120
|
+
([Which family for my terminal](../tui.md#which-family-for-my-terminal)).
|
|
121
|
+
Ctrl+Alt stays the default.
|
|
122
|
+
- **Seven chords move:** `Ctrl+Shift+K` the palette, `Ctrl+Shift+P` a
|
|
123
|
+
spawn (the Desktop's Quick Open), `Ctrl+Shift+S` the switcher,
|
|
124
|
+
`Ctrl+Shift+M` zoom, `Ctrl+Shift+W` close the tab, `Ctrl+Shift+E` split
|
|
125
|
+
right and `Ctrl+Shift+D` split down.
|
|
126
|
+
- **The others keep their keys:** `Ctrl+Alt+A` the other group,
|
|
127
|
+
`Ctrl+Alt+F` the filter, the Alt+Shift arrows, `Ctrl+Alt+1` to
|
|
128
|
+
`Ctrl+Alt+9`, and in the Desktop `Ctrl+Alt+R`, an instance's name and
|
|
129
|
+
colour.
|
|
130
|
+
- **To switch,** choose **Ctrl+Shift (foot, Alacritty)** under
|
|
131
|
+
**Shortcut family, shared with oats tui** on the Desktop's Shortcuts page, or write
|
|
132
|
+
`{ "chords": "ctrl+shift" }` to `~/.oats/config/keys.json`
|
|
133
|
+
(`$OATS_HOME_DIR/config/keys.json` when that is set). The Desktop
|
|
134
|
+
switches at once; `oats tui` reads the file at its next start. A
|
|
135
|
+
missing or broken file means Ctrl+Alt, and the help says why.
|
|
136
|
+
- **The help names the family in force:** `?` in `oats tui`, the
|
|
137
|
+
Shortcuts page in the Desktop.
|
|
138
|
+
- **Your own keys still win, row by row:** `tui.json`'s `keys`, and the
|
|
139
|
+
Desktop's shortcuts editor, which shows a clash with a key the option
|
|
140
|
+
takes.
|
|
141
|
+
- **In `oats tui` it needs the kitty keyboard protocol;** the leader
|
|
142
|
+
works without it. With the option on, the seven are taken from an
|
|
143
|
+
agent's terminal too: pi's `Ctrl+Shift+P` (previous model) spawns
|
|
144
|
+
instead.
|
|
145
|
+
- macOS has no option.
|
|
146
|
+
|
|
147
|
+
- **Jump to the next or previous group in the palette,** in `oats tui` and
|
|
148
|
+
OATS Desktop ([The palette](../tui.md#the-palette);
|
|
149
|
+
[desktop-keyboard.md](../../packages/desktop/docs/desktop-keyboard.md)).
|
|
150
|
+
While the palette is open, `Alt+Shift+Down` moves the selection to the
|
|
151
|
+
first row of the next group, and `Alt+Shift+Up` to the previous one's;
|
|
152
|
+
both wrap. On macOS the Desktop's keys are `⌘N` and `⌥⌘N` (`⌘⇧N` stays
|
|
153
|
+
File → New Window).
|
|
154
|
+
- **The keys are the palette's while it is open.** There `⌘N` doesn't
|
|
155
|
+
choose a soul, and the Alt+Shift arrows don't open the next or previous
|
|
156
|
+
instance. With the palette closed, they do what they did before.
|
|
157
|
+
- **`oats tui`'s palette now groups its instances** as the sidebar and the
|
|
158
|
+
Desktop's palette do: by relation, with the group last used first. A dim
|
|
159
|
+
label names each group, and the selection skips it. The souls,
|
|
160
|
+
capabilities, views, acts and commands after them are a group each.
|
|
161
|
+
- Both palettes name the keys: the Desktop's in a line under the list,
|
|
162
|
+
`oats tui`'s in its cheat sheet. On macOS `oats tui` has no group key:
|
|
163
|
+
a terminal never passes ⌘.
|
|
164
|
+
|
|
165
|
+
- **Desktop: the soul page lists every skill an instance gets.** With OATS
|
|
166
|
+
0.67.0 or later, **Composed for an instance › Skills** lists the soul's own
|
|
167
|
+
skills and the ones its capabilities add, each saying where it comes from
|
|
168
|
+
(**From this soul** or **From** the capability), and the "newer OATS" note
|
|
169
|
+
goes. A capability's skill file opens under its place in the instance home,
|
|
170
|
+
with **Open capability** above it. For a soul on a server, the server's OATS
|
|
171
|
+
must list them too. ([Desktop](../desktop.md))
|
|
172
|
+
|
|
173
|
+
- **Desktop: an instance's colour.** Each instance's dot (the sidebar, its
|
|
174
|
+
terminal tab, the command palette, the overview) shows the colour set for
|
|
175
|
+
it: filled while running, a ring while stopped. **Instance: name and
|
|
176
|
+
colour…** in the command palette, or Ctrl+Alt+R (⌥⌘R on macOS), opens a
|
|
177
|
+
small dialog for the focused instance: its name, and **None** plus the six
|
|
178
|
+
palette colours, applied at once through `oats instance color`. Needs OATS
|
|
179
|
+
0.67.0 or later here, and on a server for its instances. The TUI leaves
|
|
180
|
+
Ctrl+Alt+R to the agent. ([Desktop](../desktop.md))
|
|
181
|
+
|
|
182
|
+
- **Desktop: an instance named from its task.** With an OATS that suggests
|
|
183
|
+
names (`spawn-suggest-name`), the spawn dialog asks for a name once the
|
|
184
|
+
Opening instruction holds three words and you pause typing. The soul's
|
|
185
|
+
harness replies with a short name for the work, and the role is added as
|
|
186
|
+
its suffix. It shows as the empty Name field's placeholder, "will be named
|
|
187
|
+
release-notes-manager", and in **What will be created**, and Spawn uses
|
|
188
|
+
it. Typing a name replaces it and stops suggestions for that dialog.
|
|
189
|
+
Spawning with Name empty and no suggestion yet shows **Naming…** and asks
|
|
190
|
+
once. When the instance can't be named from its task, it is numbered, and
|
|
191
|
+
a notification says why ("Named oats-desktop-expert-3: naming took longer
|
|
192
|
+
than 20 seconds."). Nothing is asked before you type, nor on a timer.
|
|
193
|
+
Spawns on a server keep their purpose. ([Desktop](../desktop.md))
|
|
194
|
+
|
|
195
|
+
- **The TUI draws an instance's mark in its colour**, its shape still saying
|
|
196
|
+
its state ([tui.md](../tui.md#what-it-shows)).
|
|
197
|
+
|
|
198
|
+
## Changed
|
|
199
|
+
|
|
200
|
+
- **The leader is Ctrl+X in both clients and on every platform**
|
|
201
|
+
(awebai/oats#1433), as Emacs' prefix key: it was Alt+O on Linux and
|
|
202
|
+
Windows and ⌃\ on macOS. The keys after it do not change. Without the
|
|
203
|
+
kitty keyboard protocol Ctrl+X is one byte, 0x18, in every terminal, so it
|
|
204
|
+
needs no protocol and no timing; under the protocol `oats tui` reads it
|
|
205
|
+
too, and Ctrl+Shift+X and Ctrl+Alt+X are not the leader
|
|
206
|
+
([The leader](../tui.md#the-leader)).
|
|
207
|
+
- **Ctrl+X twice sends Ctrl+X to the program,** as the leader twice
|
|
208
|
+
always has. The shell's Ctrl+X Ctrl+E is now Ctrl+X twice, then Ctrl+E,
|
|
209
|
+
and nano exits with Ctrl+X twice.
|
|
210
|
+
- **In the Desktop, Cut keeps Ctrl+X** in a text field (an input, a text
|
|
211
|
+
area, an editable region) that is not a terminal, on Linux and Windows.
|
|
212
|
+
On macOS Cut is ⌘X, so the leader works there too
|
|
213
|
+
([desktop-keyboard.md](../../packages/desktop/docs/desktop-keyboard.md#the-leader)).
|
|
214
|
+
- **Alt+O and ⌃\ go back to the programs:** on Linux and Windows an agent
|
|
215
|
+
gets Alt+O as Esc then `o` (on macOS Option+O types its character, `ø`
|
|
216
|
+
on a US layout, unless the terminal sends Option as Meta), and ⌃\ as it
|
|
217
|
+
is typed, unless you bind either as the leader again.
|
|
218
|
+
|
|
219
|
+
- **The shared chords move from Ctrl+Shift to Ctrl+Alt on Linux and
|
|
220
|
+
Windows,** in both clients. kitty, Ghostty, WezTerm, Konsole and Windows
|
|
221
|
+
Terminal take most Ctrl+Shift chords for themselves, so in `oats tui`
|
|
222
|
+
most of 0.66's chords never arrived. Old → new:
|
|
223
|
+
|
|
224
|
+
| Action | Was | Now |
|
|
225
|
+
|---|---|---|
|
|
226
|
+
| the palette | `Ctrl+Shift+K` | `Ctrl+Alt+K` |
|
|
227
|
+
| Quick Open in the Desktop, a spawn in `oats tui` | `Ctrl+Shift+P` | `Ctrl+Alt+P` |
|
|
228
|
+
| close the tab | `Ctrl+Shift+W` | `Ctrl+Alt+W` |
|
|
229
|
+
| the filter | `Ctrl+Shift+F` | `Ctrl+Alt+F` |
|
|
230
|
+
| split right | `Ctrl+Shift+E` | `Ctrl+Alt+E` |
|
|
231
|
+
| split down | `Ctrl+Shift+O` | `Ctrl+Alt+Shift+E` |
|
|
232
|
+
| next and previous tab in `oats tui` | `Ctrl+Tab`, `Ctrl+Shift+Tab` | `Alt+Shift+Right`, `Alt+Shift+Left` |
|
|
233
|
+
| the Desktop's second next and previous tab chords | `Ctrl+PgDn`, `Ctrl+PgUp` (outside a terminal) | `Alt+Shift+Right`, `Alt+Shift+Left` (everywhere) |
|
|
234
|
+
| the Desktop's go to tab 1–9 | `Alt+1` to `Alt+9` (outside a terminal) | `Ctrl+Alt+1` to `Ctrl+Alt+9` (everywhere) |
|
|
235
|
+
|
|
236
|
+
- **The Alt+Shift arrows no longer reach the agent in its terminal:** in
|
|
237
|
+
both clients they are the chords, there as everywhere else.
|
|
238
|
+
- The Desktop keeps `Ctrl+Tab` and `Ctrl+Shift+Tab`, and its other
|
|
239
|
+
Ctrl+Shift chords (sidebar, instance panel, spawn, theme picker, copy).
|
|
240
|
+
- On macOS the Desktop gains `⌘⌥→` and `⌘⌥←` for the next and previous
|
|
241
|
+
tab, beside `⌃Tab`.
|
|
242
|
+
- A binding you set yourself in the Desktop's shortcuts editor is kept,
|
|
243
|
+
a macOS ⌘⌥ one that 0.66 saved by the character ⌥ typed (`⌥⌘Ø`) too.
|
|
244
|
+
When it is a chord a default now takes, the editor shows the clash.
|
|
245
|
+
|
|
246
|
+
- **In OATS Desktop, a key you bound yourself now wins over a default on
|
|
247
|
+
every key two actions share,** not only on the seven keys of the
|
|
248
|
+
Ctrl+Shift option
|
|
249
|
+
([desktop-keyboard.md](../../packages/desktop/docs/desktop-keyboard.md)).
|
|
250
|
+
Before, a default of a narrower context (the tabs, the sidebar, a stage)
|
|
251
|
+
could win over a global key of yours. The shortcuts editor lists every
|
|
252
|
+
such clash, and now says which of the two runs: "Ctrl+Shift+K runs
|
|
253
|
+
“Sidebar: show or hide” (yours) where both apply; “Command palette” has
|
|
254
|
+
it by default."
|
|
255
|
+
|
|
256
|
+
- **`.oats-color` is a kernel-owned home name**: a capability's
|
|
257
|
+
`retirement.disposable.home` cannot declare it
|
|
258
|
+
([capabilities.md](../capabilities.md)).
|
|
259
|
+
|
|
260
|
+
- **Desktop: the soul page's Instructions has two sections.** **Defined in
|
|
261
|
+
this soul** holds the soul's own `AGENTS.md` and its skills. **Composed for
|
|
262
|
+
an instance** holds the composed `AGENTS.md` and the skills an instance
|
|
263
|
+
gets, each saying where it comes from (**From this soul**). Until OATS lists
|
|
264
|
+
the skills that capabilities add, a note says a newer OATS lists them. The
|
|
265
|
+
boundary is a named group for assistive technology too, and the tree is
|
|
266
|
+
still one tab stop. ([Desktop](../desktop.md))
|
|
267
|
+
|
|
268
|
+
- **Desktop: the spawn dialog's name is optional and its last field.**
|
|
269
|
+
**Name · optional** now comes last, before **Developer settings**. The soul-name
|
|
270
|
+
prefix and its **Prefix with the soul name** switch are gone. Left empty,
|
|
271
|
+
the kernel numbers the instance. The Desktop's spawn dialog adds the role
|
|
272
|
+
to a typed name (the last word of the soul's name) and uses the name in
|
|
273
|
+
lowercase: `desktop-improvements` for `oats-desktop-expert` spawns as
|
|
274
|
+
`desktop-improvements-expert`, and a name that already ends in the role
|
|
275
|
+
gets no second one. On a CLI without
|
|
276
|
+
`spawn-name`, and for a spawn on a server, a typed name is still a purpose
|
|
277
|
+
named `<soul>-<purpose>`. The dialog opens on the Opening instruction;
|
|
278
|
+
Ctrl+1 / ⌘1 still goes to Name. ([Desktop](../desktop.md),
|
|
279
|
+
[souls and instances](../souls-and-instances.md))
|
|
280
|
+
|
|
281
|
+
- **Desktop: the spawn dialog starts with the Opening instruction.** It is the
|
|
282
|
+
form's first field, and the dialog opens with the cursor in it, after a
|
|
283
|
+
restored instruction's text. In a narrow window, **What will be created** now comes after the form's last
|
|
284
|
+
field instead of above the form. ([Desktop](../desktop.md))
|
|
285
|
+
|
|
286
|
+
- **Desktop: the sidebar's footer no longer has a "commands" button.** The
|
|
287
|
+
leader's chord works as before. The keyboard shortcuts editor lists the
|
|
288
|
+
keys that follow it: open it from the footer's shortcuts button, with
|
|
289
|
+
Ctrl+, / ⌘, or from the palette.
|
|
290
|
+
|
|
291
|
+
- **Desktop: "Needs input" shows on an instance's second line.** The name
|
|
292
|
+
line keeps the whole name. The mark, or "N below" on a collapsed parent,
|
|
293
|
+
replaces the repository, pull request and branch, which stay in the hover
|
|
294
|
+
card. A home that is being retired or set up keeps its state on that line.
|
|
295
|
+
|
|
296
|
+
- **Desktop: the sidebar's dotted sibling links sit a little further from
|
|
297
|
+
the lines to children.**
|
|
298
|
+
|
|
299
|
+
- **`oats tui`'s switcher lists one row per workspace, whichever machines
|
|
300
|
+
it is on.** A deployment on this computer's list that the run has not
|
|
301
|
+
opened is read for its workspace (`oats status --dir <path> --json`, one at
|
|
302
|
+
a time, 30 seconds each and 60 in all, at the start and when the switcher
|
|
303
|
+
opens or is refreshed). It then joins its workspace's row instead of
|
|
304
|
+
standing apart under `On this machine, not opened`. Under each workspace a
|
|
305
|
+
dim line per deployment names its machine and, when it is not live, its
|
|
306
|
+
state (`not opened`, `not observed`, `not reached`, ...). `Enter` on a
|
|
307
|
+
workspace opens its deployments of this machine too, so the view holds
|
|
308
|
+
them and the other machines' at once. A read that fails or times out
|
|
309
|
+
leaves the deployment as its own row, saying why. The cheat sheet of the
|
|
310
|
+
list of instances names `w workspaces`.
|
|
311
|
+
([The switcher](../tui.md#the-switcher))
|
|
312
|
+
|
|
313
|
+
- **`oats tui`'s terminal panel has a tab bar like a terminal's.** Its top
|
|
314
|
+
row is always the tab bar, with one tab or many. Each tab is the agent's
|
|
315
|
+
name, with `· <machine>` for another machine's agent, and tabs are divided
|
|
316
|
+
by `│` (`|` in ASCII). The shown tab is bracketed, `[name]`, and bold, in
|
|
317
|
+
reverse video while the terminal has the focus. The other tabs are dim.
|
|
318
|
+
([Tabs](../tui.md#tabs))
|
|
319
|
+
|
|
320
|
+
- **`oats tui` marks a row that needs input with a tag in words.** Where it
|
|
321
|
+
drew a bare `!` at the right of the row, it now draws the Desktop's words
|
|
322
|
+
in reverse video in the waiting colour: `Needs input`, and on a folded row
|
|
323
|
+
with waiting instances under it, `3 below` (`99+ below` past 99). On the
|
|
324
|
+
selected row the tag is the waiting colour not reversed, so it stands
|
|
325
|
+
apart from the selection's bar, and under `NO_COLOR` the reverse video
|
|
326
|
+
alone carries it. On a row too narrow for the whole name beside the
|
|
327
|
+
words, the tag shrinks to `!` or the count alone, still reversed, and the
|
|
328
|
+
name keeps every cell it had. ([What it shows](../tui.md#what-it-shows))
|
|
329
|
+
|
|
330
|
+
- **The `oats-getting-started` skill covers two Linux snags from a rehearsal.**
|
|
331
|
+
With NodeSource's Node under `/usr`, it sets a per-user npm prefix and now
|
|
332
|
+
also puts `~/.local/bin` on PATH for its own later commands and asks the
|
|
333
|
+
person to add it to their shell's startup file. Without FUSE (Ubuntu 22.04
|
|
334
|
+
and later), it names `libfuse2` (`libfuse2t64` on Ubuntu 24.04) as the
|
|
335
|
+
install, beside the `--appimage-extract-and-run` fallback.
|
|
336
|
+
|
|
337
|
+
## Fixed
|
|
338
|
+
|
|
339
|
+
- **`oats spawn --preview` names each capability skill as the spawn copies
|
|
340
|
+
it.** A manifest whose `skills` entry is a directory of skills (the
|
|
341
|
+
documented `"skills": ["skills"]`) showed as one skill named `skills`, and
|
|
342
|
+
a manifest with no `skills` showed none of the `skills/` directories the
|
|
343
|
+
spawn copies. The preview now lists each of them, as `--composed-skills`
|
|
344
|
+
does ([The preview](../desktop-cli-api.md#the-preview)).
|
|
345
|
+
|
|
346
|
+
## Provider updates
|
|
347
|
+
|
|
348
|
+
- **oats.framework 1.13.5: oats.core 2.6.6, oats.support 1.0.1.** Text
|
|
349
|
+
only: neither floor (`compatibility.oats`) changes.
|
|
350
|
+
- **Instances are named for their work, with the soul's role last.**
|
|
351
|
+
`/oats-operate` and `/oats-souls` (oats.core) teach
|
|
352
|
+
`--name <descriptive>-<role>`, the role being the last word of the soul's
|
|
353
|
+
name: `--name desktop-improvements-expert` for an `oats-desktop-expert`,
|
|
354
|
+
not `oats-desktop-expert-desktop-improvements`. `--purpose` still derives
|
|
355
|
+
`<soul>-<purpose>`, for automations and scripts that know only the soul.
|
|
356
|
+
[Souls and instances](../souls-and-instances.md) states the convention
|
|
357
|
+
([#1421](https://github.com/awebai/oats/issues/1421)).
|
|
358
|
+
- **Agents set needs-input whenever they need anything from a human.** The
|
|
359
|
+
oats.core inject and `/oats-operate` make `oats instance attention`
|
|
360
|
+
mandatory, under an IMPORTANT lead, for any question, decision,
|
|
361
|
+
approval, credential or other input an instance waits on, not only when
|
|
362
|
+
it cannot go on without the answer, so the wait shows on `oats status`
|
|
363
|
+
and in the Desktop. It stays out of FYIs and progress reports.
|
|
364
|
+
oats.support's hand-off skill says the same, and `/oats-operate` says
|
|
365
|
+
which questions the Claude Code emitter already reports
|
|
366
|
+
([oats.core: needs input](../capabilities.md#oatscore-needs-input)).
|
|
@@ -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.
|