reflectt-node 0.1.0 → 0.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reflectt-node",
-  "version": "0.1.0",
-  "description": "Coordinate your AI agent team. Shared tasks, memory, reflections, and presence. Self-host for free.",
+  "version": "0.1.1",
+  "description": "Local node server for agent-to-agent communication via OpenClaw",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -31,13 +31,14 @@
     "hooks:install": "bash scripts/install-hooks.sh"
   },
   "keywords": [
+    "reflectt",
+    "openclaw",
     "ai-agents",
     "agent-coordination",
     "task-management",
-    "openclaw",
     "self-hosted",
-    "ai",
-    "developer-tools"
+    "team-health",
+    "task-board"
   ],
   "author": "Team Reflectt",
   "license": "Apache-2.0",
@@ -47,7 +48,6 @@
     "@fastify/websocket": "^11.0.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@supabase/supabase-js": "^2.95.3",
-    "@xenova/transformers": "^2.17.2",
     "better-sqlite3": "^12.6.2",
     "commander": "^14.0.3",
     "dotenv": "^16.4.7",
@@ -75,13 +75,17 @@
     "url": "https://github.com/reflectt/reflectt-node/issues"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=20"
   },
   "files": [
     "dist/",
     "public/",
-    "plugins/",
-    "README.md",
-    "LICENSE"
-  ]
+    "templates/",
+    "defaults/",
+    "LICENSE",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@xenova/transformers": "^2.17.2"
+  }
 }

package/public/dashboard.js

@@ -66,6 +66,20 @@ let focusModeActive = false;
 
 const TASK_ID_PATTERN = /\b(task-[a-z0-9-]+)\b/gi;
 
+// First-boot banner: show on empty installs, hide once tasks exist or user dismisses
+function updateFirstBootBanner() {
+  const el = document.getElementById('first-boot-banner');
+  if (!el) return;
+  const dismissed = localStorage.getItem('reflectt-first-boot-dismissed');
+  const hasTasks = allTasks.length > 0;
+  el.hidden = dismissed === '1' || hasTasks;
+}
+function dismissFirstBootBanner() {
+  localStorage.setItem('reflectt-first-boot-dismissed', '1');
+  const el = document.getElementById('first-boot-banner');
+  if (el) el.hidden = true;
+}
+
 // Delta cursors for lower payload refreshes
 let lastTaskSync = 0;
 let lastChatSync = 0;
@@ -694,6 +708,7 @@ async function loadTasks(forceFull = false) {
   // Update sidebar badge
   const navTaskBadge = document.getElementById('nav-task-count');
   if (navTaskBadge) navTaskBadge.textContent = allTasks.length;
+  updateFirstBootBanner();
 }
 
 function renderProjectTabs() {

package/templates/README.md

@@ -0,0 +1,11 @@
+# Starter templates
+
+These templates are copied into `~/.reflectt/templates/` by `reflectt init`.
+
+Files:
+- `task-template.md`
+- `review-packet.md`
+- `incident-template.md`
+
+Notes:
+- `reflectt init` will **not** overwrite existing templates unless `--force` is used.

package/templates/incident-template.md

@@ -0,0 +1,38 @@
+# Incident template
+
+## Summary
+<what happened in one sentence>
+
+## Impact
+- Who/what was affected:
+- Severity:
+- Duration:
+
+## Timeline (PT)
+- <time> — 
+- <time> — 
+
+## Detection
+- How we found out:
+- Signals/alerts involved:
+
+## Root cause
+- Primary cause:
+- Contributing factors:
+
+## Resolution
+- What fixed it:
+- What we changed:
+
+## Prevention
+- What we’ll do to prevent recurrence:
+
+## Action items
+| Item | Owner | ETA | Status |
+|---|---|---:|---|
+|  |  |  |  |
+
+## Links
+- PRs:
+- Logs:
+- Dashboard:

package/templates/review-packet.md

@@ -0,0 +1,35 @@
+# Review packet
+
+## What is this
+A reviewer-friendly packet that makes it possible to approve without context-switching.
+
+## Metadata
+- Task: <task-id>
+- Owner: <@>
+- Reviewer: <@>
+- PR: <https://github.com/...>
+- Commit: <sha>
+- Changed files:
+  - 
+
+## Summary (1–3 bullets)
+- 
+- 
+
+## How to verify
+- Checks run:
+  - [ ] <e.g. npm test>
+  - [ ] <e.g. npm run build>
+- Manual QA steps:
+  1. 
+  2. 
+
+## Screenshots / proof
+- 
+
+## Caveats / known risks
+- none
+
+## Rollout / follow-up
+- Rollout notes:
+- Follow-ups (if any):

package/templates/task-template.md

@@ -0,0 +1,40 @@
+# Task template
+
+## Title
+<short, specific, verifiable>
+
+## Context
+- Why this matters:
+- Current behavior:
+- Desired behavior:
+
+## Scope
+- In scope:
+- Out of scope:
+
+## Done criteria (verifiable)
+- [ ] 
+- [ ] 
+- [ ] 
+
+## Plan (smallest shippable slice first)
+1. 
+2. 
+3. 
+
+## Artifacts
+- PR: <link>
+- Process artifact(s): <process/...>
+- Screenshots/logs: <link or path>
+
+## Review ask
+- Review type: blocking-only | full
+- What to focus on:
+
+## Risks / caveats
+- 
+
+## Owners + ETA
+- Owner: <@>
+- Reviewer: <@>
+- ETA: <e.g. ~2h>

package/plugins/reflectt-channel/README.md

@@ -1,96 +0,0 @@
-# reflectt-channel
-
-OpenClaw channel plugin that connects agents to reflectt-node via SSE (Server-Sent Events).
-
-## What it does
-
-1. Connects to reflectt-node's `/events` SSE endpoint
-2. Listens for chat messages with @mentions
-3. Routes mentioned agents through OpenClaw's inbound pipeline
-4. Posts agent responses back to reflectt-node via `POST /chat/messages`
-
-## Install
-
-From the reflectt-node repo root:
-
-```bash
-openclaw plugins install ./plugins/reflectt-channel
-```
-
-Or from anywhere:
-
-```bash
-openclaw plugins install /path/to/reflectt-node/plugins/reflectt-channel
-```
-
-## Configure
-
-Add to `~/.openclaw/openclaw.json`. Two config paths are supported:
-
-**Option 1 — `channels.reflectt` (recommended):**
-
-```json
-{
-  "channels": {
-    "reflectt": {
-      "enabled": true,
-      "url": "http://127.0.0.1:4445"
-    }
-  }
-}
-```
-
-**Option 2 — `plugins.entries` (general plugin convention):**
-
-```json
-{
-  "plugins": {
-    "entries": {
-      "reflectt-channel": {
-        "config": {
-          "url": "http://127.0.0.1:4445"
-        }
-      }
-    }
-  }
-}
-```
-
-> **Precedence:** `channels.reflectt` takes priority over `plugins.entries`. If both are set, `channels.reflectt.url` wins.
-
-> **Default:** If neither is configured, the plugin falls back to `http://127.0.0.1:4445` and logs a warning with the exact config keys to set.
-
-Or use the CLI shorthand:
-
-```bash
-openclaw config set channels.reflectt.enabled true
-openclaw config set channels.reflectt.url "http://127.0.0.1:4445"
-```
-
-Then restart the gateway:
-
-```bash
-openclaw gateway restart
-```
-
-## Verify
-
-```bash
-openclaw plugins list          # Should show reflectt-channel
-openclaw plugins info reflectt-channel
-```
-
-## Message flow
-
-```
-reflectt-node (SSE /events)
-  → reflectt-channel plugin detects @mention
-  → OpenClaw routes to agent session
-  → Agent responds
-  → Plugin POSTs to reflectt-node /chat/messages
-```
-
-## Requirements
-
-- OpenClaw gateway running
-- reflectt-node running at the configured URL