@idleware/ringi 0.8.0 → 0.8.1

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@idleware/ringi",
3
- "version": "0.8.0",
3
+ "version": "0.8.1",
4
4
  "description": "Distributed agent coordinator",
5
5
  "os": [
6
6
  "darwin",
@@ -9,7 +9,7 @@ export const briefing = (s) => {
9
9
  const r = Session.briefing(s);
10
10
  const auto = r.start.quorum !== null;
11
11
  out(`${s.agent} in ${s.room}; scope: ${scopeLine(s, auto)}`);
12
- out('agent commands: ringi agent inbox | reply <id> … | send … | tasks | proposals | whoami. A turn: inbox, your part, replies, end the turn. Never block on a peer.');
12
+ out('agent commands: ringi agent inbox | reply <id> … | send … | tasks | whoami. A turn: inbox, your part, replies, end the turn. Never block on a peer.');
13
13
  if (!r.start.started)
14
14
  return out(waiting(s.room, r.start));
15
15
  if (auto)
@@ -16,7 +16,7 @@ export const TABLE = [
16
16
  ['tasks [--all] | log [-n n] | read <msg> | thread <msg> | cat <msg> [<path>] | get <msg> [-o <dir>]', 'both', 'reading the room (agents: ringi agent …)'],
17
17
  ['signals [--all] [--repair]', 'both', 'what happened (signals) and where attention is (read and taken marks), each checked; --repair restores your missing signals'],
18
18
  ['profile', 'both', 'the room\'s profile: what a piece of work is, its states, who may move it'],
19
- ['heartbeats [--json] | heartbeats --published [--room <id>]', 'operator', 'each session\'s pulse on this machine, from its process and its tool\'s trace, without the model: working, waiting (for what) or gone; --published: the room\'s heartbeat tags as an orchestrator reads them'],
19
+ ['heartbeats [--json] | heartbeats --published [--room <id>]', 'operator', 'each session\'s pulse on this machine, from its process and its tool\'s trace, without the model: working, waiting (for what) or gone; --published: the room\'s telemetry as an orchestrator reads it'],
20
20
  ['pulse [--beat <s>] [--once]', 'operator', 'beat for every session here: sync its room, append its telemetry, naming the last pulled message of its room; join and continue start it (RINGI_PULSE=off: not)'],
21
21
  ['forget <room>/<log>', 'operator', 'after a changed-history alarm: accept a new baseline for that log'],
22
22
  ['skill install | uninstall', 'operator', 'the skill for Claude Code, Codex and Cursor'],
@@ -1,16 +1,16 @@
1
- // signals: explicit markers of what happens in a room, beside the messages that carry it. Every effective transition
2
- // (work opened, assigned, a state reached, a proposal, a counted stamp, the decision, a counted usage receipt) is also
3
- // a signal of its author on the message that made it: in a git store an annotated tag `<author>.<signal>.<message12>`
4
- // on that message's commit, with no text of its own, signed on a signed hub. The message's id keeps the name unique;
5
- // the name, target, author and time are the tag itself. Signals are visible and checkable with the store's own tools
6
- // (`git tag -v`, a forge's tag list and tag-push webhooks) and cheap to poll.
1
+ // signals: explicit markers of what happens in a room, beside the messages that carry it (signals-2). Every effective
2
+ // transition (work opened, assigned, a state reached) is also a signal of its author: a record of the author's own
3
+ // stream naming the room, the control it writes under, the message and the signal; in a git store a commit on
4
+ // `<author>/signals`, signed on a signed hub. The author, message and signal identify it, so writing it again adds
5
+ // nothing. Signals are visible with the store's own tools (`git log`, a forge's branches and push webhooks) and cheap
6
+ // to poll.
7
7
  //
8
8
  // The messages stay the truth. A signal is made only for a transition the fold actually counted (a State the author
9
- // had no right to makes none). A reader checks every signal against its message and pins the stored object it
10
- // accepted; a signal that disagrees, or an accepted one that changes or disappears, is an alarm. A signal missing
11
- // after a crash between message and tag changes nothing and is restored with `signals --repair`.
9
+ // had no right to makes none). A reader checks every signal against its message and pins each stream's accepted
10
+ // prefix; a signal that disagrees, or an accepted stream that changes or disappears, is an alarm. A signal missing
11
+ // after a crash between message and signal changes nothing and is restored with `signals --repair`.
12
12
  //
13
- // Marks are the second layer, in the same namespace: where attention is, not what was decided. `read` says a message
13
+ // Marks are the second layer, in the same stream: where attention is, not what was decided. `read` says a message
14
14
  // reached its reader (made on delivery); `taken` says a member took a piece of work. A mark changes no state
15
15
  // or assignment. It is checked only for being possible: its target is an accepted message of the room, its
16
16
  // actor a member; `read` only for a message addressed to the actor or to all, `taken` only for a message that opens