@oddington/cli 0.1.83 → 0.1.85

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 +11 -8
  2. package/dist/os.js +264 -264
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -627,19 +627,22 @@ as a member supplies `routinePublicationClient({ workspace, request })`
627
627
  with its authorized member transport. CLI publication commands supply the CLI's
628
628
  signed-in request themselves. Response modules export a `handlers` array and
629
629
  perform no publishing on import. Accepted answers durably queue managed handlers
630
- without a browser start request. Handlers use preserved View inputs and guarded
631
- shared record capabilities. Digests have personal Mark as read receipts.
630
+ without a browser start request. Handlers use the same Data API as routines,
631
+ with current hosted reads and direct field updates. Digests have personal
632
+ Mark as read receipts.
632
633
 
633
- Routines read Records through Data and prepare guarded Changes:
634
+ Routines and handlers can assign known fields without reading first:
634
635
 
635
636
  ```ts
636
637
  const repository = data.repository('general');
637
- const records = await repository.records.read(selectedRefs);
638
638
  const changes = repository.changes();
639
- changes.update(records[0], { status: 'ready' });
639
+ changes.update('invoices/one', { status: 'ready' });
640
640
  await changes.apply();
641
641
  ```
642
642
 
643
+ Read through `repository.records.read(refs)` when business logic needs current
644
+ values. Handlers use `await changes.publish()` to confirm shared changes in Git.
645
+
643
646
  Local Runs read current checkout Records and leave completed Data writes as
644
647
  ordinary uncommitted files for review. Hosted effects complete during the call.
645
648
 
@@ -735,8 +738,8 @@ For modern local execution, install the workspace separately with Bun 1.3.14.
735
738
  For a failed local Run, the terminal and JSON result identify its failed step
736
739
  and known SDK error. Device-local `~/.os/<workspace>/runs/<run-id>/execution.json`
737
740
  retains redacted exception messages, stacks, causes and failed OS operations.
738
- Those details are not returned through app summaries. Use SDK 0.1.36 and CLI
739
- 0.1.64 for this evidence; updating only the CLI does not replace the SDK frozen
741
+ Those details are not returned through app summaries. Use SDK 0.1.51 and CLI
742
+ 0.1.85 for this evidence; updating only the CLI does not replace the SDK frozen
740
743
  into a customer routine or an earlier saved Run.
741
744
 
742
745
  AI structured output is validated against the routine's requested schema.
@@ -773,7 +776,7 @@ there is no direct customer-item-to-call link in this slice. The [SDK example](h
773
776
  shows a typed catch. Shared summaries and ordinary command JSON exclude answer
774
777
  samples, prompts, reasoning and provider logs.
775
778
 
776
- Keep an exact stable `@oddington/sdk` 0.1.x patch through 0.1.43 in root
779
+ Keep an exact stable `@oddington/sdk` 0.1.x patch through 0.1.51 in root
777
780
  `devDependencies`, with its declaration, lock and installed package agreeing.
778
781
  Use compatible Node, the selected private ESM manifest and the shared frozen
779
782
  lock. OS verifies only the selected installed graph, stages its confined bytes