@versdotsh/reef 0.1.4 → 0.1.6

package/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install
+
+      - run: bun test
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install
+
+      - run: npm publish --access public

package/.github/workflows/test.yml

@@ -1,4 +1,4 @@
-name: test & publish
+name: test
 
 on:
   push:
@@ -6,10 +6,6 @@ on:
   pull_request:
     branches: [main]
 
-permissions:
-  id-token: write
-  contents: read
-
 jobs:
   test:
     runs-on: ubuntu-latest
@@ -24,24 +20,3 @@ jobs:
       - run: bun install
 
       - run: bun test
-
-  publish:
-    needs: test
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          registry-url: "https://registry.npmjs.org"
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - run: bun install
-
-      - run: npm publish --access public

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.1.6
+
+- Remove board, feed, and ui from `services/` — they were shipping as defaults but belong in `examples/services/`
+- `services/` now only contains core infrastructure: agent, docs, installer, services
+
+## 0.1.5
+
+- Move updater service to `examples/services/` (not core infrastructure)
+- Split CI: tests run on every push to main, publish only triggers on `v*` tags
+- Trusted publishing via OIDC — no npm tokens in CI
+
 ## 0.1.4
 
 - Add updater service — auto-update reef from npm

package/{services → examples/services}/updater/index.ts

@@ -18,7 +18,7 @@ import { Hono } from "hono";
 import { execSync, spawn } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
-import type { ServiceModule, ServiceContext } from "../../src/core/types.js";
+import type { ServiceModule, ServiceContext } from "../src/core/types.js";
 
 interface UpdateRecord {
   from: string;

package/{services → examples/services}/updater/updater.test.ts

@@ -1,5 +1,5 @@
 import { describe, test, expect, afterAll } from "bun:test";
-import { createTestHarness, type TestHarness } from "../../src/core/testing.js";
+import { createTestHarness, type TestHarness } from "../../../src/core/testing.js";
 import updater from "./index.js";
 
 let t: TestHarness;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@versdotsh/reef",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Self-improving fleet infrastructure — the minimum kernel agents need to build their own tools",
   "type": "module",
   "scripts": {

package/services/board/index.ts

@@ -1,155 +0,0 @@
-/**
- * Board service module — shared task tracking for agent fleets.
- *
- * Emits server-side events:
- *   board:task_created  — { task }
- *   board:task_updated  — { task, changes }
- *   board:task_deleted  — { taskId }
- */
-
-import type { ServiceModule, ServiceContext, FleetClient } from "../src/core/types.js";
-import type { ServiceEventBus } from "../src/core/events.js";
-import { BoardStore } from "./store.js";
-import { createRoutes } from "./routes.js";
-import { registerTools } from "./tools.js";
-
-const store = new BoardStore();
-
-// Late-bound reference — filled by init(), used by routes
-let events: ServiceEventBus | null = null;
-export function getEvents(): ServiceEventBus | null { return events; }
-
-const board: ServiceModule = {
-  name: "board",
-  description: "Shared task tracking",
-  routes: createRoutes(store, () => events),
-  store,
-  registerTools,
-
-  init(ctx: ServiceContext) {
-    events = ctx.events;
-  },
-
-  routeDocs: {
-    "POST /tasks": {
-      summary: "Create a new task",
-      body: {
-        title: { type: "string", required: true, description: "Task title" },
-        description: { type: "string", description: "Detailed description" },
-        status: { type: "string", description: "Initial status: open | in_progress | in_review | blocked | done. Default: open" },
-        assignee: { type: "string", description: "Agent or user to assign to" },
-        tags: { type: "string[]", description: "Tags for categorization" },
-        dependencies: { type: "string[]", description: "IDs of tasks this depends on" },
-        createdBy: { type: "string", required: true, description: "Who created this task" },
-      },
-      response: "The created task with generated ID, timestamps, empty notes/artifacts, and score 0",
-    },
-    "GET /tasks": {
-      summary: "List tasks with optional filters",
-      query: {
-        status: { type: "string", description: "Filter by status: open | in_progress | in_review | blocked | done" },
-        assignee: { type: "string", description: "Filter by assignee" },
-        tag: { type: "string", description: "Filter by tag" },
-      },
-      response: "{ tasks: Task[], count: number }",
-    },
-    "GET /tasks/:id": {
-      summary: "Get a single task by ID",
-      params: { id: { type: "string", required: true, description: "Task ID (ULID)" } },
-      response: "The full task object including notes and artifacts",
-    },
-    "PATCH /tasks/:id": {
-      summary: "Update a task",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      body: {
-        title: { type: "string", description: "New title" },
-        description: { type: "string", description: "New description" },
-        status: { type: "string", description: "New status" },
-        assignee: { type: "string | null", description: "New assignee, or null to unassign" },
-        tags: { type: "string[]", description: "Replace tags" },
-      },
-      response: "The updated task object",
-    },
-    "DELETE /tasks/:id": {
-      summary: "Delete a task",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      response: "{ ok: true }",
-    },
-    "POST /tasks/:id/bump": {
-      summary: "Bump a task's priority score by 1",
-      detail: "Use to signal importance or upvote. Score is displayed in the dashboard.",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      response: "The updated task with incremented score",
-    },
-    "POST /tasks/:id/notes": {
-      summary: "Add a note to a task",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      body: {
-        author: { type: "string", required: true, description: "Who wrote the note" },
-        content: { type: "string", required: true, description: "Note content" },
-        type: { type: "string", required: true, description: "finding | blocker | question | update" },
-      },
-      response: "The created note with generated ID and timestamp",
-    },
-    "GET /tasks/:id/notes": {
-      summary: "Get all notes for a task",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      response: "{ notes: Note[] }",
-    },
-    "POST /tasks/:id/artifacts": {
-      summary: "Attach artifacts to a task",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      body: {
-        artifacts: { type: "Artifact[]", required: true, description: "Array of { type, url, label, addedBy? }. Type: branch | report | deploy | diff | file | url" },
-      },
-      response: "The updated task with new artifacts appended",
-    },
-    "POST /tasks/:id/review": {
-      summary: "Submit a task for review",
-      detail: "Sets status to in_review, adds a summary note, and optionally attaches artifacts.",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      body: {
-        summary: { type: "string", required: true, description: "Review summary describing what was done" },
-        reviewedBy: { type: "string", required: true, description: "Who is submitting for review" },
-        artifacts: { type: "Artifact[]", description: "Artifacts to attach" },
-      },
-      response: "The updated task in in_review status",
-    },
-    "POST /tasks/:id/approve": {
-      summary: "Approve a task in review",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      response: "The task moved to done status",
-    },
-    "POST /tasks/:id/reject": {
-      summary: "Reject a task in review, sending it back to in_progress",
-      params: { id: { type: "string", required: true, description: "Task ID" } },
-      body: {
-        reason: { type: "string", description: "Reason for rejection" },
-      },
-      response: "The task moved back to in_progress status",
-    },
-    "GET /review": {
-      summary: "List all tasks currently in review",
-      response: "{ tasks: Task[], count: number }",
-    },
-  },
-
-  widget: {
-    async getLines(client: FleetClient) {
-      try {
-        const res = await client.api<{ tasks: { status: string }[]; count: number }>(
-          "GET",
-          "/board/tasks",
-        );
-        const open = res.tasks.filter((t) => t.status === "open").length;
-        const inProgress = res.tasks.filter((t) => t.status === "in_progress").length;
-        const blocked = res.tasks.filter((t) => t.status === "blocked").length;
-        return [`Board: ${open} open, ${inProgress} in-progress, ${blocked} blocked`];
-      } catch {
-        return [];
-      }
-    },
-  },
-};
-
-export default board;

package/services/board/routes.ts

@@ -1,335 +0,0 @@
-/**
- * Board HTTP routes.
- *
- * Receives a store instance and a lazy event bus getter.
- * Emits board:task_created, board:task_updated, board:task_deleted.
- */
-
-import { Hono } from "hono";
-import type { BoardStore, TaskFilters, TaskStatus, AddArtifactInput } from "./store.js";
-import { NotFoundError, ValidationError } from "./store.js";
-import type { ServiceEventBus } from "../src/core/events.js";
-
-export function createRoutes(
-  store: BoardStore,
-  getEvents: () => ServiceEventBus | null = () => null,
-): Hono {
-  const routes = new Hono();
-
-  // Create a task
-  routes.post("/tasks", async (c) => {
-    try {
-      const body = await c.req.json();
-      const task = store.createTask(body);
-      getEvents()?.fire("board:task_created", { task });
-      return c.json(task, 201);
-    } catch (e) {
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // List tasks
-  routes.get("/tasks", (c) => {
-    const filters: TaskFilters = {};
-    const status = c.req.query("status");
-    const assignee = c.req.query("assignee");
-    const tag = c.req.query("tag");
-
-    if (status) filters.status = status as TaskStatus;
-    if (assignee) filters.assignee = assignee;
-    if (tag) filters.tag = tag;
-
-    const tasks = store.listTasks(filters);
-    return c.json({ tasks, count: tasks.length });
-  });
-
-  // Get a single task
-  routes.get("/tasks/:id", (c) => {
-    const task = store.getTask(c.req.param("id"));
-    if (!task) return c.json({ error: "task not found" }, 404);
-    return c.json(task);
-  });
-
-  // Update a task
-  routes.patch("/tasks/:id", async (c) => {
-    try {
-      const body = await c.req.json();
-      const task = store.updateTask(c.req.param("id"), body);
-      getEvents()?.fire("board:task_updated", { task, changes: body });
-      return c.json(task);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // Delete a task
-  routes.delete("/tasks/:id", (c) => {
-    const deleted = store.deleteTask(c.req.param("id"));
-    if (!deleted) return c.json({ error: "task not found" }, 404);
-    getEvents()?.fire("board:task_deleted", { taskId: c.req.param("id") });
-    return c.json({ deleted: true });
-  });
-
-  // Bump a task's score
-  routes.post("/tasks/:id/bump", (c) => {
-    try {
-      const task = store.bumpTask(c.req.param("id"));
-      return c.json(task);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      throw e;
-    }
-  });
-
-  // Add a note to a task
-  routes.post("/tasks/:id/notes", async (c) => {
-    try {
-      const body = await c.req.json();
-      const note = store.addNote(c.req.param("id"), body);
-      return c.json(note, 201);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // Get notes for a task
-  routes.get("/tasks/:id/notes", (c) => {
-    try {
-      const notes = store.getNotes(c.req.param("id"));
-      return c.json({ notes, count: notes.length });
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      throw e;
-    }
-  });
-
-  // Add artifacts to a task
-  routes.post("/tasks/:id/artifacts", async (c) => {
-    try {
-      const body = await c.req.json();
-      store.addArtifacts(c.req.param("id"), body.artifacts);
-      const task = store.getTask(c.req.param("id"));
-      return c.json(task, 201);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // Submit a task for review
-  routes.post("/tasks/:id/review", async (c) => {
-    try {
-      const body = await c.req.json();
-      const id = c.req.param("id");
-
-      if (!body.summary?.trim()) {
-        return c.json({ error: "summary is required" }, 400);
-      }
-
-      store.updateTask(id, { status: "in_review" });
-
-      const author = body.reviewedBy?.trim() || "unknown";
-      store.addNote(id, { author, content: body.summary.trim(), type: "update" });
-
-      if (body.artifacts?.length) {
-        const artifacts = body.artifacts.map((a: AddArtifactInput) => ({
-          ...a,
-          addedBy: a.addedBy || author,
-        }));
-        store.addArtifacts(id, artifacts);
-      }
-
-      const task = store.getTask(id);
-      getEvents()?.fire("board:task_updated", { task, changes: { status: "in_review" } });
-      return c.json(task);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // Approve a reviewed task
-  routes.post("/tasks/:id/approve", async (c) => {
-    try {
-      const body = await c.req.json();
-      const id = c.req.param("id");
-      const approvedBy = body.approvedBy?.trim() || "unknown";
-      const comment = body.comment?.trim() || "";
-
-      store.updateTask(id, { status: "done" });
-      store.addNote(id, {
-        author: approvedBy,
-        content: comment ? `Approved by ${approvedBy}: ${comment}` : `Approved by ${approvedBy}`,
-        type: "update",
-      });
-
-      const task = store.getTask(id);
-      getEvents()?.fire("board:task_updated", { task, changes: { status: "done" } });
-      return c.json(task);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // Reject a reviewed task
-  routes.post("/tasks/:id/reject", async (c) => {
-    try {
-      const body = await c.req.json();
-      const id = c.req.param("id");
-
-      if (!body.reason?.trim()) return c.json({ error: "reason is required" }, 400);
-
-      const rejectedBy = body.rejectedBy?.trim() || "unknown";
-      store.updateTask(id, { status: "open" });
-      store.addNote(id, {
-        author: rejectedBy,
-        content: `Rejected by ${rejectedBy}: ${body.reason.trim()}`,
-        type: "update",
-      });
-
-      const task = store.getTask(id);
-      getEvents()?.fire("board:task_updated", { task, changes: { status: "open" } });
-      return c.json(task);
-    } catch (e) {
-      if (e instanceof NotFoundError) return c.json({ error: e.message }, 404);
-      if (e instanceof ValidationError) return c.json({ error: e.message }, 400);
-      throw e;
-    }
-  });
-
-  // List tasks in review
-  routes.get("/review", (c) => {
-    const tasks = store.listTasks({ status: "in_review" });
-    tasks.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
-    return c.json({ tasks, count: tasks.length });
-  });
-
-  // ─── UI Panel ───
-
-  routes.get("/_panel", (c) => {
-    return c.html(`
-<style>
-.panel-board { padding: 8px; }
-.panel-board .status-group { margin-bottom: 12px; }
-.panel-board .status-label {
-  font-size: 10px; text-transform: uppercase; letter-spacing: 1px;
-  padding: 4px 8px; color: var(--text-dim, #666); display: flex; align-items: center; gap: 8px;
-}
-.panel-board .status-label .count {
-  background: var(--bg-card, #1a1a1a); padding: 1px 6px; border-radius: 3px; font-size: 10px;
-}
-.panel-board .task-card {
-  background: var(--bg-card, #1a1a1a); border: 1px solid var(--border, #2a2a2a);
-  border-radius: 4px; padding: 10px 12px; margin: 4px 0; cursor: pointer;
-  transition: border-color 0.15s;
-}
-.panel-board .task-card:hover { border-color: #444; }
-.panel-board .task-card .title { color: var(--text-bright, #eee); font-weight: 500; margin-bottom: 4px; }
-.panel-board .task-card .meta {
-  font-size: 11px; color: var(--text-dim, #666); display: flex; gap: 12px; flex-wrap: wrap;
-}
-.panel-board .task-card .tag {
-  background: #222; padding: 1px 6px; border-radius: 3px; font-size: 10px; color: var(--blue, #5af);
-}
-.panel-board .task-card .assignee { color: var(--purple, #a7f); }
-.panel-board .task-top { display: flex; justify-content: space-between; align-items: flex-start; gap: 8px; }
-.panel-board .bump-btn {
-  background: none; border: 1px solid var(--border, #2a2a2a); border-radius: 3px;
-  color: var(--text-dim, #666); cursor: pointer; font-size: 11px; padding: 2px 6px;
-  font-family: inherit; transition: all 0.15s;
-}
-.panel-board .bump-btn:hover { border-color: var(--accent, #4f9); color: var(--accent, #4f9); }
-.panel-board .score { font-weight: 700; color: var(--yellow, #fd0); }
-.panel-board .score.dim { color: var(--text-dim, #666); font-weight: 400; }
-.panel-board .notes { margin-top: 6px; padding-top: 6px; border-top: 1px solid var(--border, #2a2a2a); font-size: 11px; display: none; }
-.panel-board .task-card.expanded .notes { display: block; }
-.panel-board .note { padding: 2px 0; color: var(--text-dim, #666); }
-.panel-board .note-author { color: var(--purple, #a7f); }
-.panel-board .note-type { color: var(--orange, #f93); font-size: 10px; }
-.panel-board .status-open { border-left: 3px solid var(--blue, #5af); }
-.panel-board .status-in_progress { border-left: 3px solid var(--yellow, #fd0); }
-.panel-board .status-in_review { border-left: 3px solid var(--orange, #f93); }
-.panel-board .status-blocked { border-left: 3px solid var(--red, #f55); }
-.panel-board .status-done { border-left: 3px solid var(--accent, #4f9); opacity: 0.6; }
-.panel-board .empty { color: var(--text-dim, #666); font-style: italic; padding: 20px; text-align: center; }
-</style>
-
-<div class="panel-board" id="board-root">
-  <div class="empty">Loading board…</div>
-</div>
-
-<script>
-(function() {
-  const root = document.getElementById('board-root');
-  const API = typeof PANEL_API !== 'undefined' ? PANEL_API : '/ui/api';
-  const ORDER = ['open', 'in_progress', 'in_review', 'blocked', 'done'];
-
-  function esc(s) { const d = document.createElement('div'); d.textContent = s || ''; return d.innerHTML; }
-  function ago(iso) {
-    const ms = Date.now() - new Date(iso).getTime();
-    if (ms < 60000) return Math.floor(ms/1000) + 's ago';
-    if (ms < 3600000) return Math.floor(ms/60000) + 'm ago';
-    if (ms < 86400000) return Math.floor(ms/3600000) + 'h ago';
-    return Math.floor(ms/86400000) + 'd ago';
-  }
-
-  async function load() {
-    try {
-      const res = await fetch(API + '/board/tasks');
-      if (!res.ok) throw new Error(res.status);
-      const data = await res.json();
-      render(data.tasks || []);
-    } catch (e) {
-      root.innerHTML = '<div class="empty">Board unavailable: ' + esc(e.message) + '</div>';
-    }
-  }
-
-  function render(tasks) {
-    const grouped = {};
-    ORDER.forEach(s => grouped[s] = []);
-    tasks.forEach(t => (grouped[t.status] || grouped.open).push(t));
-
-    let html = '';
-    for (const status of ORDER) {
-      const items = grouped[status];
-      if (!items.length) continue;
-      html += '<div class="status-group"><div class="status-label">'
-        + status.replace(/_/g, ' ') + ' <span class="count">' + items.length + '</span></div>';
-      for (const t of items) {
-        const tags = (t.tags||[]).map(tag => '<span class="tag">' + esc(tag) + '</span>').join('');
-        const assignee = t.assignee ? '<span class="assignee">@' + esc(t.assignee) + '</span>' : '';
-        const notes = (t.notes||[]).map(n =>
-          '<div class="note"><span class="note-author">@' + esc(n.author) + '</span> <span class="note-type">' + esc(n.type) + '</span> ' + esc(n.content) + '</div>'
-        ).join('');
-        const score = t.score || 0;
-        html += '<div class="task-card status-' + status + '" onclick="this.classList.toggle(\\'expanded\\')">'
-          + '<div class="task-top"><div class="title">' + esc(t.title) + '</div>'
-          + '<button class="bump-btn" onclick="event.stopPropagation();fetch(\\'' + API + '/board/tasks/' + t.id + '/bump\\',{method:\\'POST\\'}).then(()=>window._boardLoad())"><span class="score' + (score ? '' : ' dim') + '">' + score + '</span></button></div>'
-          + '<div class="meta">' + assignee + tags + '<span>' + ago(t.createdAt) + '</span></div>'
-          + (notes ? '<div class="notes">' + notes + '</div>' : '')
-          + '</div>';
-      }
-      html += '</div>';
-    }
-    root.innerHTML = html || '<div class="empty">No tasks</div>';
-  }
-
-  window._boardLoad = load;
-  load();
-  setInterval(load, 10000);
-})();
-</script>
-`);
-  });
-
-  return routes;
-}