Module queue 

Phase R (v0.5): a local queue of unsigned draft actions.

The Workbench writes here; vela queue sign walks the queue, signs each action with the caller’s Ed25519 key, and posts the signed action to a live vela serve (or applies it directly via the same proposals::*_at_path helpers the CLI uses).

This is the v0.5 doctrine for human review actions: signing is a deliberate human act on a terminal that holds the key. The browser never sees the key. Drafts queue here; the CLI is the only signer.

Structs

Queue

QueuedAction

A queued draft action. kind matches a write tool name (propose_review, propose_note, propose_revise_confidence, propose_retract, accept_proposal, reject_proposal); args is the tool-specific argument bundle without the signature field — vela queue sign constructs the signature at sign-time.

Constants

QUEUE_SCHEMA

Functions

append

Append a draft action to the queue file (creating it if absent).

clear

Remove all actions from the queue file. Idempotent.

default_queue_path

Resolve the queue file path. Defaults to ~/.vela/queue.json. Override with VELA_QUEUE_FILE for testing or alternate locations.

load

Load the queue from path. If the file does not exist, returns an empty queue (the queue is ephemeral; nonexistence is a normal state).

replace_actions

Replace the queue’s action list (used by sign after each successful signed-and-applied action to remove the signed entry).

save

Write the queue to path, creating parent directories as needed.