reflectt-node 0.1.16 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflectt-node",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Coordinate your AI agent team. Shared tasks, memory, reflections, and presence. Self-host for free.",
   "main": "dist/index.js",
   "type": "module",
@@ -94,4 +94,4 @@
   "overrides": {
     "sharp": "^0.34.0"
   }
-}
+}

package/public/docs.md

@@ -841,8 +841,11 @@ Autonomous work-continuity system. Monitors agent queue floors and auto-replenis
 | GET | `/pr-automerge/status` | PR auto-merge attempt log: recent merge/close attempts with summary counts (attempted, success, failed, skipped, auto-close, close-gate-fail). |
 | GET | `/drift-report` | Task/PR drift report: tasks with merged PRs still in validating, orphan PRs, state mismatches. |
 | POST | `/activation/event` | Record activation funnel event. Body: `{ type, userId, metadata? }`. Events: signup_completed, host_preflight_passed, host_preflight_failed, workspace_ready, first_task_started, first_task_completed, first_team_message_sent, day2_return_action. |
+| GET | `/activation/doctor-gate` | Check whether the BYOH onboarding doctor-gate has been passed for a user. Query: `?userId=...`. Returns `{ passed: boolean, events: ActivationEvent[] }`. Used by cloud onboarding to gate progression to workspace-ready step. |
 | GET | `/activation/funnel` | Get funnel state. Query: `?userId=...` for single user, no params for aggregate summary. `?raw=true` includes internal/infrastructure users for debugging. |
 | GET | `/activation/dashboard` | Full onboarding telemetry dashboard: conversion funnel, failure distribution, weekly trends. Query: `?weeks=12`, `?raw=true`. |
+| GET | `/activation/ghost-signups` | List users who signed up but never passed preflight. Query: `?minAgeHours=2` (default 2). Returns `{ candidates: [{ userId, signupAt, hoursSinceSignup, preflightAttempted }] }`. |
+| POST | `/activation/ghost-signup-nudge` | Send re-engagement email to a ghost signup user. Body: `{ userId, email, nudgeTier?: '2h' \| '24h' }`. Idempotent — won't re-send if already nudged at same tier. |
 | GET | `/activation/funnel/conversions` | Step-by-step conversion rates with per-step reach count, conversion rate, and median step timing. Query: `?raw=true` includes internal users. |
 | GET | `/activation/funnel/failures` | Failure-reason distribution per step. Shows where users drop off and why (from event metadata). |
 | GET | `/activation/funnel/weekly` | Weekly trend snapshots for planning. Query: `?weeks=12`. Exportable JSON with per-week step counts, new users, completion rate. |
@@ -1172,7 +1175,7 @@ Auth-gated endpoints for managing a reflectt-node instance remotely. Provide `RE
 | POST | `/canvas/victory` | **The Victory** — whole team acknowledges a PR merge. Fires `canvas_expression { _victory: true }` (gold flash + celebration + resolve sound) then a `_victoryWave` per active agent staggered 350ms apart. Body: `{ prUrl, agentId, prTitle?, prNumber?, intensity? }`. Returns: `{ success, prNumber, intensity, wave: [{ agentId, delay }] }`. |
 | GET | `/canvas/flow-score` | **Team flow metric** — real-time 0–1 composite score. Factors: active agents (30%), state distribution (35%), expression velocity last 5m (25%), time of day (10%). Labels: surge/flow/grinding/quiet/idle. <50ms. Returns: `{ score, label, factors, activeAgents, expressionsLast5m }`. |
 | POST | `/canvas/briefing` | **The Briefing** — triggers a staggered team introduction on canvas mount. Fires one `canvas_expression` per active agent, 700ms apart. Each includes identity color, current task, state, and an LLM-generated one-line voice (template fallback). Idempotent: 30s cooldown per requesterId. Body: `{ requesterId? }`. Returns: `{ success, agents: [{ agentId, queued }], totalMs }`. |
-| POST | `/canvas/query` | **Human asks the canvas a question; agent responds with a typed visual card.** Body: `{ query: string, agentId?: string }`. Returns `{ success, card: { type, data, agentId, agentColor } }` and emits `canvas_message` event on the pulse SSE stream. Card types: `tasks` (team status), `info` (LLM prose answer), `revenue` (MRR/ARR), `onboarding` (setup steps). No polling needed — response appears in real-time via pulse stream. |
+| POST | `/canvas/query` | **Human asks the canvas a question; agent responds with a typed visual card.** Accepts JSON body `{ query: string, agentId?: string, sessionId?: string, attachments?: [{ name, type, data (base64) }] }` OR multipart/form-data with fields `query`/`text`, `agentId?`, `sessionId?` and file parts (max 5 files, 10MB each). Returns `{ success, card: { type, data, agentId, agentColor } }` and emits `canvas_message` event on the pulse SSE stream. Card types: `tasks` (team status), `info` (LLM prose answer), `revenue` (MRR/ARR), `onboarding` (setup steps). No polling needed — response appears in real-time via pulse stream. |
 | POST | `/canvas/gaze` | **Presence noticing presence** — fire after user holds cursor/gaze on an agent orb for ≥3 seconds. Agent generates a one-line response in their voice + fires `canvas_expression { _gaze: true }`. Body: `{ agentId, watcherId?, durationMs? }`. Returns `{ success, agentId, line, expressionId }`. When an LLM is configured: generates contextually; template fallback always available. |
 | GET | `/canvas/session/mode` | Inferred presence mode for the current session. Mode is derived from time of day + active canvas states + team rhythm — never manually selected. Returns: `{ mode: 'ambient'\|'conversational'\|'operational'\|'immersive', reason, narrative (one-line live caption), context }`. |
 | GET | `/canvas/session/snapshot` | Cross-device continuity: resumable session snapshot for the active agent. Params: `agentId?` (defaults to most-recently-updated non-floor agent). Returns: `{ snapshot: { agent_id, canvas_state, active_task?, active_decision?, content_snapshot?, handoff: { summary, stream_in_progress, sensor_consent_transferred } } \| null, generated_at }`. |
@@ -1216,6 +1219,7 @@ Auth-gated endpoints for managing a reflectt-node instance remotely. Provide `RE
 | POST | `/webhooks/purge` | Delete old processed payloads. Body: `{ maxAgeDays? }` (default 30). |
 | GET | `/trust-events` | List trust-collapse signals. Params: `agentId?`, `eventType?` (false_assertion\|stale_status_claim\|self_review_violation\|missing_acceptance_criteria_block\|escalation_bypass), `since?` (epoch ms), `limit?`. |
 | POST | `/agents/:agent/waiting` | Set agent to waiting state (blocked on human). Body: `{ reason (required), waitingFor?, taskId?, expiresAt? }`. Heartbeat emits `agent.status="waiting"` + `waitingFor` + `waitingTaskId`. Canvas maps to `state="needs-attention"` (amber pulse). |
+| POST | `/agents/:name/thought` | Agent posts a current thought/expression. Body: `{ text: string }` (max 200 chars). Attached to presence entry and emitted as canvas_expression. Flows to cloud heartbeat → canvas pulse. Client renders with 8s TTL. |
 | DELETE | `/agents/:agent/waiting` | Clear waiting state — agent is unblocked. Canvas state returns to normal. |
 | GET | `/approval-queue` | Unified approval queue — everything needing human decision. Params: `agentId?`, `category?` (review\|agent_action), `includeExpired?` (true), `limit?`. Returns: items[], count, hasExpired. Each item: id, category, title, description, urgency, owner, expiresAt, autoAction, isExpired. |
 | POST | `/approval-queue/:approvalId/decide` | Resolve an approval. Body: `{ decision: "approve"\|"reject"\|"defer", actor (required), comment? }`. Emits canvas_input SSE event. |