@nuucognition/flint-cli 0.6.0-dev.21 → 0.6.0-dev.23

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.
@@ -41,10 +41,12 @@ Orbh is a meta-harness: a durable session layer that launches, tracks, supervise
41
41
 
42
42
  A session is an event-sourced Orb spool with a stable id, title and description, a free-form key/value interface (`session set/get`), and runs. Your run is one **turn**. Every turn ends with `return --finish` or `return --await`; `--finish` is the default. Await is a promise of further interaction. `return --await` still delivers this turn's result immediately, so your collector resolves now; awaiting only keeps you wakeable for a future turn, which ends with its own return. As a subagent, use `--await` only when your dispatcher granted or requested follow-up availability. Exiting without returning gets this turn re-prompted at most twice, then marks it `failed-unreturned` and leaves the session awaiting.
43
43
 
44
- The machine-wide Orbh orchestrator sweep owns unattended wake delivery across turns. During a live run, `{{commandPath}} page arm` is an optional one-shot surface for lowest-latency mid-run delivery. Re-arm after delivery when latency matters; otherwise durable events arrive at your next turn boundary. While awaiting, the orchestrator resumes the session for any page-worthy event with a coalesced digest.
44
+ The machine-wide Orbh orchestrator sweep owns unattended wake delivery across turns. During a live run, run `{{commandPath}} page status` first. If it prints `MODE managed`, the manager submits every Page to you through the harness connection: do not start a shell pager. If it prints another mode, `{{commandPath}} page arm` is an optional one-shot surface for lowest-latency mid-run delivery. Re-arm after delivery when latency matters; otherwise durable events arrive at your next turn boundary. While awaiting, the orchestrator resumes the session for any page-worthy event with a coalesced digest.
45
45
 
46
46
  If a counterparty you wait on (a `message request` target or a dispatched subagent) exits, fails to return, blocks on human input, or is killed, a typed NOTICES entry reaches you with a reason, trust grade, and guidance — follow it; `killed` means deliberately cancelled: do NOT re-send or spawn a replacement.
47
47
 
48
+ **Shared workspace.** Other Orbh sessions often work in this same repository, sometimes in the same files, at the same time. This is normal, not an incident. Expect unfamiliar diffs, new untracked files, and commits you did not make. Do not revert, stash, or repair another session's changes. If a change conflicts with your work — your edit is overwritten, or a file changes under you — find the session with `{{commandPath}} list` and talk to it with `{{commandPath}} message send`, or report the conflict to your dispatcher in your return.
49
+
48
50
  {{#if title}}Your title started as "{{title}}"{{#if description}} with description: "{{description}}"{{/if}}.{{else}}Register immediately so your parent's session view is legible:
49
51
  {{commandPath}} session register "<short title>" "<what you're doing>"{{/if}}
50
52