Fleet Schemas ↑↓ move within a pane · ←→ move between panes · Enter opens · Esc backs out
Need 29 fields

www-needs/Need

id non-empty string
YYMMDD-HHmm-4hex in JST; unique and the record filename.
required
createdAt string
ISO timestamp the agent registered the need.
required
pane object
The asking agent: which host, pane, location, session, and cwd.
required
host non-empty string
Short fleet host name the asking pane runs on.
required
paneId string matching /^%\d+$/
tmux pane id, unique only within its host.
required
loc non-empty string
The pane session:window at registration time.
required
sessionId string
The asking agent session UUID; empty when unresolved.
required
cwd non-empty string
The pane working directory, for the inbox row.
required
stampedAt string
When this pane last re-stamped its own identity on the record; absent or empty on records written before the stamp existed.
kind one of: edit | schema | choice | spend | irreversible | credential | quota | constraint
Selects the evidence rule the CLI enforces and who may rule; forced upward by the CLI from the evidence.
required
level one of: blocking | optional
Whether the asking leg stops, or proceeds with default at decideBy.
required
title non-empty string
One-line ask shown as the inbox row, at most 80 characters.
required
why non-empty string
Why the decision matters, at most 3 sentences.
required
reversible boolean
Whether the proposed change can be undone; derived by the CLI from the evidence, never typed by the agent.
required
impact one of: low | medium | high
Blast radius derived by the CLI from measured facts; ranks the inbox and feeds the level rule.
required
options list of object
The choices offered; at least two for every kind but credential.
required
key non-empty string
Short token the inbox keys press and rulings reference.
required
label non-empty string
What choosing this option does, in the reader voice.
required
consequence non-empty string
What follows if the user picks it.
required
recommendation string
Option key the agent argues for; empty only for credential.
required
default string
Option key taken at decideBy; empty for blocking needs.
required
decideBy string
ISO time an optional need defaults; empty for blocking needs.
required
evidence object
What the agent read before asking; the CLI refuses an ask that omits it.
required
files list of object
Files with the edit itself; required for edit and schema needs.
required
path non-empty string
Absolute path the diff patches.
required
diff string
Unified hunks whose context matched the file bytes at add time.
required
note string
Kind-specific evidence: the amount, blast radius, or human step.
required
seenAt string
When the agent last acknowledged the ruling; empty until then.
required
withdrawnAt string
When the agent closed its own ask; empty while open.
required

Checks

  • needLevelRule
  • needEvidenceRule

Defects

No defects in the 17 records checked.

Where it lives

Bound bywww-needs
Declared in~/mnt/mdr/skills/www-needs/assets/schemas/need.ts
BindingneedDataStore
Directory~/mnt/data/www-needs/needs
Files*.yaml
Referenced asneed