@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.
Files changed (3) hide show
  1. package/README.md +67 -1
  2. package/dist/os.js +459 -403
  3. 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 without printing a bootstrap secret.
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.