reflectt-node 0.1.3 → 0.1.5

package/public/docs.md

@@ -41,6 +41,16 @@ Returns `text/html`. No parameters.
 open http://localhost:4445/ui-kit
 ```
 
+### `GET /dashboard`
+
+Main `reflectt-node` dashboard UI.
+
+Returns `text/html`.
+
+Internal/cockpit controls are hidden by default. To enable them (for operators debugging their own host), start the server with `REFLECTT_INTERNAL_UI=1` **and** open:
+
+- `http://localhost:4445/dashboard?internal=1`
+
 ---
 
 ## Error Envelope (all endpoints)
@@ -102,6 +112,7 @@ Remote hosts (multi-host installs) phone-home via a lightweight heartbeat so the
 | GET | `/health/team` | Team health metrics with compliance + `staleDoing` snapshot. Per-agent rows include `activeTaskTitle` and `activeTaskPrLink` when an agent has a doing task with PR evidence. Flagged agents also include `actionable_reason` (last comment age, last transition, last mention age, suggested action). |
 | GET | `/health/agents` | Per-agent health summary (`last_seen`, `active_task`, `heartbeat_age_ms`, `last_shipped_at`, `stale_reason`, state) |
 | GET | `/health/compliance` | Compliance check results |
+| GET | `/compliance/violations` | State-read-before-assertion compliance violations. Query: `agent`, `severity`, `limit` (max 1000), `since` (epoch ms). Returns `{ violations, count, summary, query }`. |
 | GET | `/health/backlog` | Backlog readiness health by lane (ready counts, floor compliance, breach status, blocked/todo/doing/validating rollups). Query: `include_test=1` to include test-harness tasks. |
 | GET | `/health/system` | System + loop/timer health (quiet-hours suppression, sweeper status, watchdog tick timestamps, uptime/memory) |
 | GET | `/health/build` | Build/runtime identity (version, git SHA, branch, build timestamp, PID, uptime) |
@@ -109,9 +120,11 @@ Remote hosts (multi-host installs) phone-home via a lightweight heartbeat so the
 | GET | `/health/team/summary` | Compact team health summary |
 | GET | `/health/team/history` | Historical team health data |
 | GET | `/health/workflow` | Unified per-agent workflow state: doing-task age, last shipped timestamp, blocker flag, artifact path, and linked PR state. Query: `include_test=1` to include test-harness tasks. |
-| GET | `/health/reflection-pipeline` | Reflection→Insight→Promotion health signal. Returns recent reflection/insight/promotion counts, status (`healthy`\|`at_risk`\|`broken`), and alert timestamps. Triggers alert when reflections flow but insights remain zero past threshold. |
+| GET | `/health/reflection-pipeline` | Reflection→Insight→Promotion health signal. Returns recent reflection/insight/promotion counts, status (`idle`\|`healthy`\|`at_risk`\|`broken`), and alert timestamps. Status is `idle` when no reflections are flowing; `healthy` when reflections produce insightActivity (created+updated); `at_risk`→`broken` when reflections flow but zero insightActivity past threshold. |
 | GET | `/health/backlog` | Backlog readiness snapshot by lane/agent with ready-floor breach detection and stale-validating summary. Query: `include_test=1` to include test-harness tasks. |
 | GET | `/health/alert-preflight` | Alert-preflight guard metrics: total checked, canary-flagged, suppressed, false-positive rate, mode (canary/enforce/off). |
+| GET | `/health/alert-preflight/history` | Daily alert-preflight snapshots for observation window tracking. Returns per-day metrics + current session. |
+| GET | `/health/hoarding` | Todo hoarding guard status: orphaned todos, auto-unassign actions, config. Query: `dry_run=0` to run live (default: dry run). |
 | GET | `/health/mention-ack` | Mention-ack lifecycle metrics (pending, timeout, latency counters) |
 | GET | `/health/mention-ack/recent` | Recent mention-ack entries for debugging. Query: `limit` (max 100) |
 | GET | `/health/mention-ack/:agent` | Pending mention-ack entries for one agent |
@@ -179,7 +192,7 @@ If your deployment needs quiet-hours behavior today, enforce it in scheduler/gat
 | POST | `/tasks` | Create task. Required: `title`, `createdBy`, `assignee`, `reviewer`, `done_criteria` (string[]), `eta`. Optional: `description`, `priority` (P0-P3), `status`, `tags`, `metadata`. **Reflection-origin invariant:** `metadata.source_reflection` or `metadata.source_insight` required (or `metadata.reflection_exempt=true` with `reflection_exempt_reason`). Status contract: `validating` also requires `metadata.artifact_path` under `process/`. |
 | PATCH | `/tasks/:id` | Update task (partial). Any task field, plus optional `actor` for history attribution. Status contract: `doing` requires reviewer + `metadata.eta`; `validating` requires `metadata.artifact_path` under `process/` (workspace-agnostic). |
 | DELETE | `/tasks/:id` | Delete task |
-| GET | `/tasks/next` | Pull-based assignment. Query: `agent`, `compact` |
+| GET | `/tasks/next` | Pull-based assignment. Query: `agent`, `compact`, `claim=1` (auto-transitions todo→doing on pull) |
 | GET | `/tasks/active` | Get active (doing) task for agent. Query: `agent`, `compact`. Returns null if no doing tasks. |
 | GET | `/heartbeat/:agent` | Single compact heartbeat payload (~200 tokens). Returns active task, next task, slim inbox, queue counts, and suggested action. Replaces 3 separate API calls. |
 | GET | `/bootstrap/heartbeat/:agent` | Generate optimal HEARTBEAT.md content for agent. References best endpoints. Includes version stamp and content hash for change detection. |
@@ -202,6 +215,7 @@ If your deployment needs quiet-hours behavior today, enforce it in scheduler/gat
 | GET | `/tasks/board-health` | Board-level health metrics for backlog replenishment. Returns per-agent breakdown (doing, validating, todo, active counts), `needsWork`/`lowWatermark` flags, and `replenishNeeded` trigger (fires when 2+ agents idle or <3 backlog tasks). Query: `include_test=1` to include test-harness tasks. |
 | GET | `/agents/roles` | Agent role registry with live WIP status. Returns all agents with `name`, `displayName`, `role`, `affinityTags`, `protectedDomains`, `wipCap`, `wipCount`, `overCap`. |
 | POST | `/config/identity` | Set an agent's display name. Body: `{ "agent": "agent-1", "displayName": "Juniper" }`. Persists to TEAM-ROLES.yaml, hot-reloads. Dashboard and mentions use display name. |
+| PUT | `/config/team-roles` | Write TEAM-ROLES.yaml. Body: `{ "yaml": "agents:\n  - name: link\n    role: engineer..." }`. Hot-reloads on save. Used by bootstrap agent to configure team from user intent. |
 | GET | `/resolve/mention/:mention` | Resolve a mention string (name, displayName, or alias) to canonical agent ID. Returns `{ agent, displayName, role }`. |
 | POST | `/tasks/suggest-assignee` | Suggest best assignee for a task. Body: `{ "title": "...", "tags": [...], "done_criteria": [...] }`. Returns `suggested` agent name, `scores` array with affinity/WIP/throughput breakdown, and `protectedMatch` if a protected domain applies. |
 | GET | `/team/manifest` | Serve TEAM.md from `~/.reflectt/` (falls back to defaults). Returns `manifest` object with `raw_markdown`, parsed `sections` array, `version` (SHA-256 hash), `updated_at`, `path`, and `source`. |
@@ -479,6 +493,7 @@ Preflight checks reconcile live task state (status, assignee, reviewer, recent c
 | Method | Path | Description |
 |--------|------|-------------|
 | GET | `/cloud/status` | Cloud connection state (registered, heartbeat age, sync status). Only active when `REFLECTT_HOST_TOKEN` is set. |
+| GET | `/cloud/events` | Connection lifecycle events (connect, disconnect, heartbeat failures/recoveries). Query: `?limit=N` (max 100). |
 | POST | `/cloud/reload` | Hot-reload cloud config from `~/.reflectt/config.json` without server restart. Updates env vars and restarts heartbeat/sync loops. Used by CLI after `host connect` enrollment. |
 | GET | `/provisioning/status` | Host provisioning state: phase, enrollment, config/secrets pull status, webhook routes. Dashboard-safe (no credentials). |
 | POST | `/provisioning/provision` | Full provisioning flow: enroll with cloud (join token or API key), pull config + secrets, configure webhooks. Body: `{ cloudUrl, hostName, joinToken?, apiKey?, capabilities? }`. |

package/public/intensity-mock.html

@@ -0,0 +1,413 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Agent Intensity Toggle — Design Mock</title>
+<style>
+  /* === Reflectt Node Tokens (subset) === */
+  :root {
+    --bg: #0a0e14;
+    --surface: #141920;
+    --surface-raised: #1a2028;
+    --border: #252d38;
+    --border-subtle: #1e2530;
+    --text: #d4dae3;
+    --text-bright: #eef1f5;
+    --text-muted: #6b7a8d;
+    --accent: #4da6ff;
+    --accent-dim: rgba(77, 166, 255, 0.12);
+    --yellow: #d4a017;
+    --yellow-dim: rgba(212, 160, 23, 0.12);
+    --orange: #e08a20;
+    --orange-dim: rgba(224, 138, 32, 0.12);
+    --green: #3fb950;
+    --green-dim: rgba(63, 185, 80, 0.12);
+    --red: #f85149;
+    --radius-sm: 6px;
+    --radius-md: 8px;
+    --space-2: 8px;
+    --space-3: 12px;
+    --space-4: 16px;
+    --space-5: 20px;
+    --text-xs: 10px;
+    --text-sm: 11px;
+    --text-base: 13px;
+    --text-md: 14px;
+    --font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+    --font-weight-normal: 400;
+    --font-weight-medium: 500;
+    --font-weight-semibold: 600;
+    --focus-ring: 0 0 0 2px rgba(77, 166, 255, 0.5);
+  }
+
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+
+  body {
+    font-family: var(--font-family);
+    background: var(--bg);
+    color: var(--text);
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    padding: 40px 20px;
+    -webkit-font-smoothing: antialiased;
+  }
+
+  h1 {
+    font-size: 18px;
+    font-weight: 700;
+    color: var(--text-bright);
+    margin-bottom: 8px;
+  }
+  .subtitle {
+    font-size: var(--text-base);
+    color: var(--text-muted);
+    margin-bottom: 32px;
+  }
+
+  /* === Mock Dashboard Panel === */
+  .panel {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md);
+    width: 100%;
+    max-width: 480px;
+    overflow: hidden;
+  }
+  .panel-header {
+    padding: var(--space-3) var(--space-4);
+    border-bottom: 1px solid var(--border);
+    font-size: var(--text-md);
+    font-weight: var(--font-weight-semibold);
+    color: var(--text-bright);
+    display: flex;
+    align-items: center;
+    gap: 8px;
+  }
+  .panel-body {
+    padding: var(--space-4) var(--space-5);
+  }
+
+  /* === Runtime Stats (mock) === */
+  .runtime-stats {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: var(--space-3);
+    margin-bottom: 0;
+  }
+  .stat {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+  .stat-label {
+    font-size: var(--text-xs);
+    color: var(--text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+  }
+  .stat-value {
+    font-size: var(--text-md);
+    font-weight: var(--font-weight-semibold);
+    color: var(--text);
+  }
+  .stat-value.online { color: var(--green); }
+
+  /* === Intensity Control === */
+  .intensity-control {
+    margin-top: var(--space-4);
+    padding-top: var(--space-4);
+    border-top: 1px solid var(--border);
+  }
+  .intensity-label {
+    font-size: var(--text-sm);
+    font-weight: var(--font-weight-semibold);
+    color: var(--text);
+    margin-bottom: var(--space-2);
+  }
+  .intensity-segments {
+    display: flex;
+    gap: 2px;
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md);
+    padding: 3px;
+  }
+  .intensity-seg {
+    flex: 1;
+    padding: 8px 12px;
+    border: 1px solid transparent;
+    border-radius: var(--radius-sm);
+    background: transparent;
+    color: var(--text-muted);
+    font-size: var(--text-sm);
+    font-weight: var(--font-weight-medium);
+    cursor: pointer;
+    transition: all 150ms ease;
+    min-height: 44px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 4px;
+    font-family: inherit;
+  }
+  .intensity-seg:focus-visible {
+    outline: none;
+    box-shadow: var(--focus-ring);
+  }
+  .intensity-seg:hover:not(.active) {
+    color: var(--text);
+    background: rgba(255,255,255,0.03);
+  }
+
+  /* Active states — color-coded by level */
+  .intensity-seg.active[data-level="low"] {
+    background: var(--yellow-dim);
+    color: var(--yellow);
+    border-color: var(--yellow);
+    font-weight: var(--font-weight-semibold);
+  }
+  .intensity-seg.active[data-level="normal"] {
+    background: var(--accent-dim);
+    color: var(--accent);
+    border-color: var(--accent);
+    font-weight: var(--font-weight-semibold);
+  }
+  .intensity-seg.active[data-level="high"] {
+    background: var(--orange-dim);
+    color: var(--orange);
+    border-color: var(--orange);
+    font-weight: var(--font-weight-semibold);
+  }
+
+  .intensity-desc {
+    font-size: var(--text-xs);
+    color: var(--text-muted);
+    margin-top: var(--space-2);
+    line-height: 1.5;
+    min-height: 30px;
+  }
+
+  /* === Toast === */
+  .toast {
+    position: fixed;
+    bottom: 24px;
+    left: 50%;
+    transform: translateX(-50%) translateY(80px);
+    background: var(--surface-raised);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md);
+    padding: 10px 20px;
+    font-size: var(--text-sm);
+    color: var(--text);
+    opacity: 0;
+    transition: all 300ms ease;
+    pointer-events: none;
+    white-space: nowrap;
+  }
+  .toast.show {
+    transform: translateX(-50%) translateY(0);
+    opacity: 1;
+  }
+
+  /* === Mapping Table === */
+  .mapping-section {
+    margin-top: 40px;
+    width: 100%;
+    max-width: 640px;
+  }
+  .mapping-section h2 {
+    font-size: 15px;
+    font-weight: 700;
+    color: var(--text-bright);
+    margin-bottom: 12px;
+  }
+  table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: var(--text-sm);
+  }
+  th, td {
+    padding: 8px 12px;
+    text-align: left;
+    border-bottom: 1px solid var(--border);
+  }
+  th {
+    color: var(--text-muted);
+    font-weight: var(--font-weight-semibold);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    font-size: var(--text-xs);
+  }
+  td { color: var(--text); }
+  td.highlight { color: var(--accent); font-weight: var(--font-weight-medium); }
+
+  /* === Footer === */
+  .mock-footer {
+    margin-top: 40px;
+    font-size: var(--text-xs);
+    color: var(--text-muted);
+    text-align: center;
+  }
+
+  @media (hover: hover) and (pointer: fine) {
+    .intensity-seg:hover:not(.active) {
+      color: var(--text);
+      background: rgba(255,255,255,0.03);
+    }
+  }
+  @media not all and (hover: hover) {
+    .intensity-seg:hover:not(.active) {
+      color: var(--text-muted);
+      background: transparent;
+    }
+  }
+</style>
+</head>
+<body>
+
+  <h1>Agent Intensity Toggle</h1>
+  <p class="subtitle">Design mock — where it lives in the dashboard</p>
+
+  <!-- Mock Runtime Truth Card panel -->
+  <div class="panel">
+    <div class="panel-header">🧭 Runtime Truth Card</div>
+    <div class="panel-body">
+
+      <!-- Existing runtime stats (mock) -->
+      <div class="runtime-stats">
+        <div class="stat">
+          <span class="stat-label">Agents</span>
+          <span class="stat-value online">6 online</span>
+        </div>
+        <div class="stat">
+          <span class="stat-label">Tasks</span>
+          <span class="stat-value">3 active</span>
+        </div>
+        <div class="stat">
+          <span class="stat-label">Heartbeat</span>
+          <span class="stat-value">30s</span>
+        </div>
+        <div class="stat">
+          <span class="stat-label">Uptime</span>
+          <span class="stat-value">4h 22m</span>
+        </div>
+      </div>
+
+      <!-- ✨ NEW: Intensity Control -->
+      <div class="intensity-control" role="radiogroup" aria-label="Agent intensity">
+        <div class="intensity-label">⚡ Agent Intensity</div>
+        <div class="intensity-segments">
+          <button role="radio" aria-checked="false" data-level="low" class="intensity-seg" onclick="setIntensity('low')">
+            🐢 Low
+          </button>
+          <button role="radio" aria-checked="true" data-level="normal" class="intensity-seg active" onclick="setIntensity('normal')">
+            ⚡ Normal
+          </button>
+          <button role="radio" aria-checked="false" data-level="high" class="intensity-seg" onclick="setIntensity('high')">
+            🔥 High
+          </button>
+        </div>
+        <div class="intensity-desc" id="intensity-desc">
+          Agents work at standard pace. Tasks processed each heartbeat.
+        </div>
+      </div>
+
+    </div>
+  </div>
+
+  <!-- Mapping reference table -->
+  <div class="mapping-section">
+    <h2>What each level changes</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>Setting</th>
+          <th>🐢 Low</th>
+          <th>⚡ Normal</th>
+          <th>🔥 High</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>Heartbeat</td>
+          <td>2× slower</td>
+          <td class="highlight">Default</td>
+          <td>2× faster</td>
+        </tr>
+        <tr>
+          <td>Tasks / cycle</td>
+          <td>Max 1</td>
+          <td class="highlight">Config default</td>
+          <td>Unlimited</td>
+        </tr>
+        <tr>
+          <td>Approval</td>
+          <td>All manual</td>
+          <td class="highlight">Routine auto</td>
+          <td>All auto (except close)</td>
+        </tr>
+        <tr>
+          <td>Parallel tasks</td>
+          <td>No</td>
+          <td class="highlight">No</td>
+          <td>Yes</td>
+        </tr>
+      </tbody>
+    </table>
+  </div>
+
+  <!-- Toast -->
+  <div class="toast" id="toast"></div>
+
+  <div class="mock-footer">
+    Design mock by pixel 🎨 · task-1772244618727-695h6hdsk · reflectt-node
+  </div>
+
+<script>
+const COPY = {
+  low:    'Agents check in less often. Tasks batch up.',
+  normal: 'Agents work at standard pace. Tasks processed each heartbeat.',
+  high:   'Agents move fast. Parallel tasks enabled.',
+};
+
+const TOAST_MSG = {
+  low:    '🐢 Intensity → Low — agents will slow down',
+  normal: '⚡ Intensity → Normal — standard pace',
+  high:   '🔥 Intensity → High — agents moving fast',
+};
+
+function setIntensity(level) {
+  document.querySelectorAll('.intensity-seg').forEach(btn => {
+    const active = btn.dataset.level === level;
+    btn.classList.toggle('active', active);
+    btn.setAttribute('aria-checked', active);
+  });
+  document.getElementById('intensity-desc').textContent = COPY[level];
+  showToast(TOAST_MSG[level]);
+}
+
+let toastTimer;
+function showToast(msg) {
+  const el = document.getElementById('toast');
+  el.textContent = msg;
+  el.classList.add('show');
+  clearTimeout(toastTimer);
+  toastTimer = setTimeout(() => el.classList.remove('show'), 2500);
+}
+
+// Keyboard nav for radiogroup
+document.querySelector('.intensity-segments').addEventListener('keydown', e => {
+  const btns = [...document.querySelectorAll('.intensity-seg')];
+  const idx = btns.indexOf(document.activeElement);
+  if (idx < 0) return;
+  let next;
+  if (e.key === 'ArrowRight' || e.key === 'ArrowDown') next = btns[(idx + 1) % btns.length];
+  if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') next = btns[(idx - 1 + btns.length) % btns.length];
+  if (next) { e.preventDefault(); next.focus(); next.click(); }
+});
+</script>
+</body>
+</html>