Skip to content

protocols.md

Latest commit

 

History

History
130 lines (93 loc) · 3.4 KB

protocols.md

File metadata and controls

130 lines (93 loc) · 3.4 KB

RUNTIME PROTOCOLS

This document defines the operational protocols that keep CIPHER deterministic.

1) AUTO_CLEAN_BOOTSTRAP

Purpose: Guarantee clean startup with one command.

Entry: cipher up

Sequence:

  1. Stop existing local daemon/MCP if present.
  2. Kill stale listeners if needed.
  3. Remove runtime artifacts (pid/state/log/lock).
  4. Probe LAN for authoritative host.
  5. If host found: enter JOIN mode and open host URL.
  6. If host not found: start fresh local host daemon.

Success criteria: Single active authoritative host target, no duplicate local daemons.

2) LAN_JOIN_FALLBACK

Purpose: Keep discovery resilient when mDNS is blocked.

Priority:

  1. cipher.local (best effort)
  2. direct host IP (http://<host-ip>:4040)

Contract: CIPHER must still be usable via IP when cipher.local fails.

3) THERMAL_DECAY

Purpose: Enforce real priority by expiration pressure.

Policy: Tasks older than 7 days are purged.

In Syndicate mode: Expiry causes integrity strike against shared squad pool.

4) SCORCHED_EARTH

Purpose: Exit condition by design, not endless engagement.

Triggers:

  • Mission completion pathway.
  • Manual burn pathway.
  • Global integrity collapse in Syndicate mode.

Effects:

  • Task wipe.
  • Mission debrief export.
  • Host termination sequence.

5) SYNDICATE_DELEGATION

Purpose: Cross-node task assignment with capacity constraints.

Mechanics:

  • @OPID payload delegation style.
  • Reject if target is at max capacity.
  • Target receives incoming directive modal.

6) TWO_KEY_TURN

Purpose: Prevent fake completion in collaborative mode.

State path: ACTIVE -> PENDING_VERIFICATION -> NEUTRALIZED

Rules:

  • Assignee can request verification.
  • Handler confirms or denies kill.

7) HOST_TERMINATION_BROADCAST

Purpose: Synchronize shutdown-aware UI behavior.

Event: host_terminating

Client response:

  • Enter destructed state path.
  • Clear local active state.
  • Continue mission-close UX.

8) AUTHORITATIVE_SYNC

Purpose: Prevent split-brain task timelines across devices.

Rules:

  1. Server sync_state is authoritative.
  2. Clients do not push full local state on initial connect.
  3. Mutations are locked when disconnected from authority.

9) MISSION_DEBRIEF

Purpose: Produce post-run artifact for human tracking.

Output: Downloadable .txt report with:

  • operator id
  • outcome reason
  • session task summary
  • cumulative telemetry stats

10) LOCAL_STATE_WIPE

Purpose: Avoid ghost identity/session leakage after terminal burn.

Behavior: Remove CIPHER-owned local storage keys on destructive exit path.

11) AUDIO_SIGNALING

Purpose: Make state changes legible under focus mode.

Engine: WebAudio procedural synthesis.

Signals include:

  • keystroke clicks
  • success ping
  • alarm/warning
  • purge static burst
  • incoming directive ringtone

12) LOCAL_LLM_INTERROGATION

Purpose: Keep motivational pressure local and private.

Transport: Ollama on 127.0.0.1:11434

Flow:

  1. Poll available models.
  2. Build contextual prompt from host/task telemetry.
  3. Emit handler message back to UI.

No cloud dependency required.

13) CROSS_DEVICE_RESUME

Purpose: Continue operations from another device without accounts.

Composition:

  • socket state sync
  • LAN discovery (cipher.local best effort)
  • mandatory manual IP fallback
  • browser-local persistence for reconnect continuity