@a5c-ai/babysitter-breakpoints 0.1.3 → 0.1.5

package/README.md

@@ -2,17 +2,21 @@
 
 Lightweight breakpoint manager with API, queue worker, and web UI.
 
+This package now lives at `packages/breakpoints`.
+
 ## Requirements
 - Node.js 18+
 
 ## Setup
 ```bash
+cd packages/breakpoints
 npm install
 npm run init:db
 ```
 
 ## Run (dev)
 ```bash
+cd packages/breakpoints
 npm run dev
 ```
 
@@ -27,12 +31,38 @@ npm run start:api
 npm run start:worker
 ```
 
+## CLI Examples
+Start the full system (API + web UI + worker):
+```bash
+breakpoints start
+```
+
+Create a breakpoint (agent):
+```bash
+breakpoints breakpoint create --question "Need approval?" --title "Approval"
+```
+
+Check status:
+```bash
+breakpoints breakpoint status <id>
+```
+
+Wait for release:
+```bash
+breakpoints breakpoint wait <id> --interval 3
+```
+
+Install the babysitter-breakpoint skill:
+```bash
+breakpoints install-skill --target codex --scope global
+```
+
 ## Configuration
 Environment variables:
 - `PORT` (default 3185)
 - `WEB_PORT` (default 3184)
 - `DB_PATH` (default `~/.a5c/breakpoints/db/breakpoints.db`)
-- `REPO_ROOT` (default repo root)
+- `REPO_ROOT` (default package root / current working directory)
 - `AGENT_TOKEN` (optional)
 - `HUMAN_TOKEN` (optional)
 - `WORKER_POLL_MS` (default 2000)
@@ -41,7 +71,7 @@ Environment variables:
 ## API Examples
 Create breakpoint (agent):
 ```bash
-curl -X POST http://localhost:3000/api/breakpoints \
+curl -X POST http://localhost:3185/api/breakpoints \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer $AGENT_TOKEN" \
   -d '{"agentId":"agent-1","title":"Need review","payload":{"summary":"check this"},"tags":["review"],"ttlSeconds":3600}'
@@ -49,12 +79,12 @@ curl -X POST http://localhost:3000/api/breakpoints \
 
 Check status:
 ```bash
-curl http://localhost:3000/api/breakpoints/<id>/status
+curl http://localhost:3185/api/breakpoints/<id>/status
 ```
 
 Release with feedback (human):
 ```bash
-curl -X POST http://localhost:3000/api/breakpoints/<id>/feedback \
+curl -X POST http://localhost:3185/api/breakpoints/<id>/feedback \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer $HUMAN_TOKEN" \
   -d '{"author":"reviewer","comment":"Looks good","release":true}'
@@ -83,7 +113,7 @@ Only allowlisted extensions are served, and the file must be listed in the
 breakpoint payload.
 
 ## Web UI
-Open `http://localhost:3000` and provide the human token in the UI.
+Open `http://localhost:3184` and provide the human token in the UI.
 
 ## Install the babysitter-breakpoint skill
 ```bash
@@ -98,7 +128,7 @@ breakpoints install-skill --target claude --scope local
 breakpoints install-skill --target cursor --scope global
 breakpoints install-skill --target cursor --scope local
 ```
-Global targets use `CODEX_HOME` or `~/.codex` for Codex, and `~/.claude` or `~/.cursor` for Claude/Cursor. Local installs write to `.codex/skills`, `.claude/skills`, or `.cursor/skills` under the repo root. Restart the app after install.
+Global targets use `CODEX_HOME` or `~/.codex` for Codex, and `~/.claude` or `~/.cursor` for Claude/Cursor. Local installs write to `.codex/skills`, `.claude/skills`, or `.cursor/skills` under the package root. Restart the app after install.
 
 When installed from npm, the skill is bundled at `.codex/skills/babysitter-breakpoint/` inside the package and copied to the target location by `breakpoints install-skill`.
 

package/api/db.js

@@ -10,7 +10,32 @@ function defaultDbPath() {
   return path.join(home, ".a5c", "breakpoints", "db", "breakpoints.db");
 }
 
-const DB_PATH = process.env.DB_PATH || defaultDbPath();
+function expandHome(value) {
+  if (!value) return value;
+  if (value === "~") return os.homedir();
+  if (value.startsWith(`~${path.sep}`)) {
+    return path.join(os.homedir(), value.slice(2));
+  }
+  if (value.startsWith("~/")) {
+    return path.join(os.homedir(), value.slice(2));
+  }
+  return value;
+}
+
+function resolveDbPath(value) {
+  const expanded = expandHome(value);
+  if (!expanded) return expanded;
+  const normalized = path.normalize(expanded);
+  if (normalized.endsWith(path.sep)) {
+    return path.join(normalized, "breakpoints.db");
+  }
+  if (!path.extname(normalized)) {
+    return path.join(normalized, "breakpoints.db");
+  }
+  return normalized;
+}
+
+const DB_PATH = resolveDbPath(process.env.DB_PATH || defaultDbPath());
 
 function openDb() {
   fs.mkdirSync(path.dirname(DB_PATH), { recursive: true });

package/api/server.js

@@ -8,6 +8,18 @@ const app = express();
 const port = process.env.PORT || 3185;
 
 app.use(express.json({ limit: "1mb" }));
+app.use((req, res, next) => {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader(
+    "Access-Control-Allow-Headers",
+    "Content-Type, Authorization"
+  );
+  res.setHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
+  if (req.method === "OPTIONS") {
+    return res.sendStatus(204);
+  }
+  return next();
+});
 app.use("/api", routes);
 app.use("/", express.static(path.join(__dirname, "..", "web")));
 

package/bin/breakpoints.js

@@ -30,7 +30,7 @@ function runCommand(command, args, options = {}) {
 }
 
 function apiBase() {
-  return process.env.BREAKPOINT_API_URL || "http://localhost:3000";
+  return process.env.BREAKPOINT_API_URL || "http://localhost:3185";
 }
 
 async function httpJson(method, url, body) {
@@ -164,6 +164,7 @@ function runSystem() {
       ),
     PORT: process.env.PORT || "3185",
     WEB_PORT: process.env.WEB_PORT || "3184",
+    REPO_ROOT: process.env.REPO_ROOT || process.cwd(),
   };
   runCommand("node", [runner], { cwd: repoRoot, env });
 }

package/db/migrations/001_init.sql

@@ -0,0 +1,56 @@
+-- Initial migration
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS breakpoints (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  run_id TEXT,
+  title TEXT,
+  payload TEXT NOT NULL,
+  tags TEXT,
+  ttl_seconds INTEGER,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  released_at TEXT,
+  expired_at TEXT,
+  cancelled_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS feedback (
+  id TEXT PRIMARY KEY,
+  breakpoint_id TEXT NOT NULL,
+  author TEXT NOT NULL,
+  comment TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (breakpoint_id) REFERENCES breakpoints(id)
+);
+
+CREATE TABLE IF NOT EXISTS events (
+  id TEXT PRIMARY KEY,
+  breakpoint_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  actor TEXT NOT NULL,
+  timestamp TEXT NOT NULL,
+  metadata TEXT,
+  FOREIGN KEY (breakpoint_id) REFERENCES breakpoints(id)
+);
+
+CREATE TABLE IF NOT EXISTS jobs (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  status TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  run_at TEXT NOT NULL,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  last_error TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_breakpoints_status ON breakpoints(status);
+CREATE INDEX IF NOT EXISTS idx_breakpoints_agent ON breakpoints(agent_id);
+CREATE INDEX IF NOT EXISTS idx_jobs_status_run_at ON jobs(status, run_at);
+
+COMMIT;

package/db/migrations/002_extensions.sql

@@ -0,0 +1,13 @@
+-- Extensions config table
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS extensions_config (
+  name TEXT PRIMARY KEY,
+  enabled INTEGER NOT NULL DEFAULT 0,
+  config_json TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+COMMIT;

package/db/schema.sql

@@ -0,0 +1,60 @@
+-- SQLite schema for breakpoint manager
+
+CREATE TABLE IF NOT EXISTS breakpoints (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  run_id TEXT,
+  title TEXT,
+  payload TEXT NOT NULL,
+  tags TEXT,
+  ttl_seconds INTEGER,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  released_at TEXT,
+  expired_at TEXT,
+  cancelled_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS feedback (
+  id TEXT PRIMARY KEY,
+  breakpoint_id TEXT NOT NULL,
+  author TEXT NOT NULL,
+  comment TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (breakpoint_id) REFERENCES breakpoints(id)
+);
+
+CREATE TABLE IF NOT EXISTS events (
+  id TEXT PRIMARY KEY,
+  breakpoint_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  actor TEXT NOT NULL,
+  timestamp TEXT NOT NULL,
+  metadata TEXT,
+  FOREIGN KEY (breakpoint_id) REFERENCES breakpoints(id)
+);
+
+CREATE TABLE IF NOT EXISTS jobs (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  status TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  run_at TEXT NOT NULL,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  last_error TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS extensions_config (
+  name TEXT PRIMARY KEY,
+  enabled INTEGER NOT NULL DEFAULT 0,
+  config_json TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_breakpoints_status ON breakpoints(status);
+CREATE INDEX IF NOT EXISTS idx_breakpoints_agent ON breakpoints(agent_id);
+CREATE INDEX IF NOT EXISTS idx_jobs_status_run_at ON jobs(status, run_at);

package/package.json

@@ -1,26 +1,29 @@
-{
-  "name": "@a5c-ai/babysitter-breakpoints",
-  "version": "0.1.3",
-  "private": false,
-  "type": "commonjs",
-  "bin": {
-    "breakpoints": "bin/breakpoints.js"
-  },
-  "files": [
-    "bin/",
-    "api/",
-    "worker/",
-    "extensions/",
-    ".codex/skills/babysitter-breakpoint/"
-  ],
-  "scripts": {
-    "start:api": "node api/server.js",
-    "start:worker": "node worker/worker.js",
-    "dev": "node scripts/dev-runner.js",
-    "init:db": "node scripts/init-db.js"
-  },
-  "dependencies": {
-    "express": "^4.19.2",
-    "sqlite3": "^5.1.7"
-  }
-}
+{
+  "name": "@a5c-ai/babysitter-breakpoints",
+  "version": "0.1.5",
+  "private": false,
+  "type": "commonjs",
+  "bin": {
+    "breakpoints": "bin/breakpoints.js"
+  },
+  "files": [
+    "bin/",
+    "api/",
+    "db/",
+    "worker/",
+    "extensions/",
+    "scripts/",
+    "web/",
+    ".codex/skills/babysitter-breakpoint/"
+  ],
+  "scripts": {
+    "start:api": "node api/server.js",
+    "start:worker": "node worker/worker.js",
+    "dev": "node scripts/dev-runner.js",
+    "init:db": "node scripts/init-db.js"
+  },
+  "dependencies": {
+    "express": "^4.19.2",
+    "sqlite3": "^5.1.7"
+  }
+}

package/scripts/dev-runner.js

@@ -0,0 +1,41 @@
+"use strict";
+
+const { spawn } = require("child_process");
+const path = require("path");
+
+const repoRoot = path.join(__dirname, "..");
+const defaultEnv = {
+  DB_PATH:
+    process.env.DB_PATH ||
+    path.join(
+      require("os").homedir(),
+      ".a5c",
+      "breakpoints",
+      "db",
+      "breakpoints.db"
+    ),
+  PORT: process.env.PORT || "3185",
+  WEB_PORT: process.env.WEB_PORT || "3184",
+  REPO_ROOT: process.env.REPO_ROOT || process.cwd(),
+};
+
+function run(label, command, args) {
+  const proc = spawn(command, args, {
+    stdio: "inherit",
+    env: { ...process.env, ...defaultEnv },
+    shell: true,
+    cwd: repoRoot,
+  });
+  proc.on("exit", (code) => {
+    if (code) {
+      // eslint-disable-next-line no-console
+      console.error(`${label} exited with code ${code}`);
+      process.exitCode = code;
+    }
+  });
+  return proc;
+}
+
+run("api", "node", [path.join(repoRoot, "api", "server.js")]);
+run("web", "node", [path.join(repoRoot, "web", "server.js")]);
+run("worker", "node", [path.join(repoRoot, "worker", "worker.js")]);

package/scripts/dev.ps1

@@ -0,0 +1,10 @@
+$ErrorActionPreference = "Stop"
+
+$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot ".."))
+
+Write-Host "Starting API and worker..."
+Start-Process -FilePath "node" -ArgumentList (Join-Path $repoRoot "api/server.js") -NoNewWindow
+Start-Process -FilePath "node" -ArgumentList (Join-Path $repoRoot "worker/worker.js") -NoNewWindow
+
+Write-Host "API: http://localhost:3185"
+Write-Host "Use Ctrl+C to stop."

package/scripts/dev.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+set -e
+
+script_dir="$(cd "$(dirname "$0")" && pwd)"
+repo_root="$(cd "$script_dir/.." && pwd)"
+
+echo "Starting API and worker..."
+node "$repo_root/api/server.js" &
+node "$repo_root/worker/worker.js" &
+
+echo "API: http://localhost:3185"
+echo "Press Ctrl+C to stop."
+wait

package/scripts/init-db.js

@@ -0,0 +1,20 @@
+"use strict";
+
+const { openDb, initDb, DB_PATH } = require("../api/db");
+
+async function main() {
+  const db = openDb();
+  try {
+    await initDb(db);
+    // eslint-disable-next-line no-console
+    console.log(`Database initialized at ${DB_PATH}`);
+  } finally {
+    db.close();
+  }
+}
+
+main().catch((err) => {
+  // eslint-disable-next-line no-console
+  console.error(err);
+  process.exitCode = 1;
+});