@oddington/cli 0.1.77 → 0.1.79
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/README.md +67 -1
- package/dist/os.js +459 -403
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -41,6 +41,13 @@ Run `os --help` or add `--help` to any command for the full command list.
|
|
|
41
41
|
Commands print readable output by default. Add `--json` when another program
|
|
42
42
|
will consume the result.
|
|
43
43
|
|
|
44
|
+
`os app dev <name>` shows recent development-server output in your terminal if
|
|
45
|
+
startup fails or the server later stops. It distinguishes an exit from a startup
|
|
46
|
+
timeout and includes the app's retry command. This is output from your local dev
|
|
47
|
+
script; OS keeps only a bounded tail in memory and does not save or upload it.
|
|
48
|
+
Successful startup stays quiet apart from OS progress, and Vite handles ordinary
|
|
49
|
+
compilation errors through its browser overlay while you edit.
|
|
50
|
+
|
|
44
51
|
Dropbox connection setup uses an offline OAuth URL and hidden one-time code entry:
|
|
45
52
|
|
|
46
53
|
```sh
|
|
@@ -147,6 +154,20 @@ The shared declaration contains no package import. The worktree root needs no
|
|
|
147
154
|
package installation; each consuming project keeps its own compatible
|
|
148
155
|
`@oddington/sdk` dependency.
|
|
149
156
|
|
|
157
|
+
For unpublished schema changes in this checkout, run:
|
|
158
|
+
|
|
159
|
+
```sh
|
|
160
|
+
os data schema general --local
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
This reads only `_schema.yaml` files beneath `general/`, including uncommitted
|
|
164
|
+
and untracked schemas. It needs no login, network, remote or named branch.
|
|
165
|
+
It updates the same generated file and TypeScript settings and preserves other
|
|
166
|
+
repository aliases. The command reports whether it used local or published
|
|
167
|
+
schemas. Invalid local schemas stop generation without replacing your existing
|
|
168
|
+
types; there is no fallback to published schemas. Run it again after changing a
|
|
169
|
+
local schema. App development does not automatically regenerate types.
|
|
170
|
+
|
|
150
171
|
Keep importing `data` from `@oddington/sdk`. A known repository literal now gains
|
|
151
172
|
schema-aware `records.query`, `pages` and `all` queries and projected values.
|
|
152
173
|
No source import, app declaration, build or launch is needed. Other operations
|
|
@@ -181,6 +202,51 @@ From anywhere inside the app’s Git worktree, run:
|
|
|
181
202
|
os app launch <name>
|
|
182
203
|
```
|
|
183
204
|
|
|
205
|
+
While editing the interface, use `os app dev <name>` instead. It runs the app's
|
|
206
|
+
existing Vite-compatible `npm run dev` script and keeps one OS host and browser
|
|
207
|
+
origin alive while HMR updates the interface. There is no production build on
|
|
208
|
+
this path. Install development dependencies first. App declaration and routine
|
|
209
|
+
definition changes require a restart; normal interface edits do not.
|
|
210
|
+
|
|
211
|
+
For ordinary app development, that command uses your installed CLI and the app's
|
|
212
|
+
installed SDK. To test unreleased OS changes, first build the CLI and SDK in the
|
|
213
|
+
OS checkout:
|
|
214
|
+
|
|
215
|
+
```sh
|
|
216
|
+
cd /path/to/os
|
|
217
|
+
bun run --filter @oddington/cli build
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
Then run from the customer repository:
|
|
221
|
+
|
|
222
|
+
```sh
|
|
223
|
+
os app dev billing --local-os /path/to/os
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
This explicitly runs that checkout's built CLI and supplies its built browser
|
|
227
|
+
SDK to the app's Vite server. Both selected paths are shown on stderr. Missing
|
|
228
|
+
builds stop with build guidance; no package is installed or substituted. The
|
|
229
|
+
app's existing Vite config/plugins still run. A temporary config override and
|
|
230
|
+
separate dependency cache last only for this invocation; customer dependencies,
|
|
231
|
+
lockfiles and authored config are preserved. Existing login and backend services
|
|
232
|
+
are used normally. Interface edits keep HMR; OS CLI/SDK edits require rebuilding
|
|
233
|
+
OS and restarting this command. Stop and omit `--local-os` to return to ordinary
|
|
234
|
+
installed packages. This flag selects local packages, not a local backend.
|
|
235
|
+
|
|
236
|
+
Until your installed CLI supports this option, invoke the built CLI directly
|
|
237
|
+
from the customer repository:
|
|
238
|
+
|
|
239
|
+
```sh
|
|
240
|
+
node /path/to/os/apps/cli/dist/os.js app dev billing --local-os /path/to/os
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
Both commands print a clean local address you can open in multiple browsers
|
|
244
|
+
simultaneously, including a chat browser that can reach this machine. Starting
|
|
245
|
+
the host trusts this workstation's loopback, including other local processes
|
|
246
|
+
and OS users able to connect. CLI credentials remain server-side. Each browser
|
|
247
|
+
has independent connection proofs; renewal in one does not disconnect another.
|
|
248
|
+
Stopping the command or signing out of the local app ends host access for all.
|
|
249
|
+
|
|
184
250
|
Launch reads exactly `apps/<name>/app.json`, resolves one member workspace from
|
|
185
251
|
the worktree's stable source identity, runs the colocated package’s fixed `npm run build`, and
|
|
186
252
|
opens its confined public interface in your ordinary browser. Prepare the app’s
|
|
@@ -225,7 +291,7 @@ atomically replaces the affected index reader. Temporary background or renewal
|
|
|
225
291
|
failures preserve only current bounded access and never extend its deadline.
|
|
226
292
|
The SDK retries renewal independently of Data reads. Confirmed renewal denial and Host
|
|
227
293
|
shutdown end it immediately. An opener
|
|
228
|
-
failure stops the host
|
|
294
|
+
failure stops the host and its development server.
|
|
229
295
|
|
|
230
296
|
Launch supplies authenticated context and unchanged interface assets.
|
|
231
297
|
`app.listRoutines()` preserves declaration order, including unavailable entries.
|