@beacon-build/sdk 1.15.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# @beacon-build/sdk Changelog
+
+## 2.0.0 (2026-05-27)
+
+### Breaking Changes
+
+- Package renamed from `@beacon-build/client` to `@beacon-build/sdk`
+- New factory functions: `createAdminClient`, `createAgentClient`, `createOpsClient`
+- Old `SdkFactory.forAgent()` replaced by `createAgentClient` + `createOpsClient`
+
+### New Features
+
+- `createAdminClient` — User-JWT authenticated SDK with 17 domain clients
+- `createAgentClient` — Agent-JWT authenticated SDK (tasks + messaging)
+- `createOpsClient` — OPS_API_KEY authenticated SDK with 15 clients
+- `createAuthClient` — Auth flow helper (login, register, refresh, logout, me)
+- `MultipartClient` — Multipart upload transport (avatars, assets, storage)
+- `BinaryClient` — Binary download transport (storage proxy)
+- `SseClient` — Generic SSE stream reader (ops db/jobs/logs)
+- Full `RealtimeSdkClient` export (F141)
+- SDK endpoint manifest for OpenAPI coverage testing
+
+### Migration from `@beacon-build/client`
+
+Replace all imports:
+
+```typescript
+// Before
+import { SdkFactory, OpsApiClient } from '@beacon-build/client'
+
+// After
+import { createAgentClient, createOpsClient } from '@beacon-build/sdk'
+```
+
+Legacy class-based exports (`SdkFactory`, `AgentSdkClient`, etc.) remain available for
+backward compatibility but are deprecated. Migrate to factory functions for new code.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 beacon Platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/backlog.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * beacon-backlog — @beacon-build/sdk
+ *
+ * Generates a backlog.md from the tasks table in PostgreSQL.
+ * Supports arbitrary nesting: FeatureSet -> Feature/Task.
+ * Renders time totals per group from result.time_h.
+ *
+ * Usage:
+ *   beacon-backlog <project>           # print to stdout
+ *   beacon-backlog <project> --write   # write to <project>/docs/backlog.md
+ */
+export {};
+//# sourceMappingURL=backlog.d.ts.map

package/dist/cli/backlog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.d.ts","sourceRoot":"","sources":["../../src/cli/backlog.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/cli/backlog.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+/**
+ * beacon-backlog — @beacon-build/sdk
+ *
+ * Generates a backlog.md from the tasks table in PostgreSQL.
+ * Supports arbitrary nesting: FeatureSet -> Feature/Task.
+ * Renders time totals per group from result.time_h.
+ *
+ * Usage:
+ *   beacon-backlog <project>           # print to stdout
+ *   beacon-backlog <project> --write   # write to <project>/docs/backlog.md
+ */
+import { Pool } from 'pg';
+import { writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse } from 'yaml';
+import { getDatabaseUrl } from '../lib/db.js';
+import { createCliLogger } from '../lib/logger.js';
+const log = createCliLogger('backlog');
+// ─── CLI ────────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2).filter((a) => !a.startsWith('-'));
+const flags = process.argv.slice(2).filter((a) => a.startsWith('-'));
+const project = args[0];
+const doWrite = flags.includes('--write');
+if (!project) {
+    log.error('missing required argument', { usage: 'beacon-cli backlog <project> [--write]' });
+    process.exit(1);
+}
+// ─── Query ──────────────────────────────────────────────────────────────────
+const pool = new Pool({ connectionString: getDatabaseUrl() });
+const { rows: tasks } = await pool.query(`SELECT id, ref, title, description, type AS task_type, status, priority, size, parent_id, depends_on, result
+     FROM tasks
+     WHERE project = $1
+     ORDER BY ref ASC`, [project]);
+await pool.end();
+if (!tasks.length) {
+    log.warn('no tasks found', { project });
+    process.exit(1);
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+const taskById = new Map(tasks.map((t) => [t.id, t]));
+function sortByTaskId(list) {
+    return list.sort((a, b) => {
+        const na = parseInt((a.ref ?? '').replace(/\D+/g, ''), 10) || 0;
+        const nb = parseInt((b.ref ?? '').replace(/\D+/g, ''), 10) || 0;
+        return na - nb;
+    });
+}
+function sortByPrioDesc(list) {
+    return list.sort((a, b) => {
+        if (b.priority !== a.priority)
+            return b.priority - a.priority;
+        const na = parseInt((a.ref ?? '').replace(/\D+/g, ''), 10) || 0;
+        const nb = parseInt((b.ref ?? '').replace(/\D+/g, ''), 10) || 0;
+        return na - nb;
+    });
+}
+// ─── Build tree ─────────────────────────────────────────────────────────────
+const childrenByParent = new Map();
+for (const t of tasks) {
+    if (t.parent_id) {
+        if (!childrenByParent.has(t.parent_id))
+            childrenByParent.set(t.parent_id, []);
+        childrenByParent.get(t.parent_id).push(t);
+    }
+}
+const rootFeatureSets = sortByTaskId(tasks.filter((t) => !t.parent_id && t.task_type === 'featureSet'));
+const topLevel = sortByTaskId(tasks.filter((t) => !t.parent_id && t.task_type !== 'featureSet'));
+// ─── Recursive time sum ─────────────────────────────────────────────────────
+function sumTimeH(taskId) {
+    const children = childrenByParent.get(taskId) ?? [];
+    let total = 0;
+    for (const child of children) {
+        total += child.result?.time_h ?? 0;
+        if (child.task_type === 'featureSet') {
+            total += sumTimeH(child.id);
+        }
+    }
+    return total;
+}
+// ─── Format ─────────────────────────────────────────────────────────────────
+const STATUS_ICON = {
+    queued: '\u2B1A',
+    in_progress: '\u25B6',
+    done: '\u2713',
+    failed: '\u2717',
+    cancelled: '\u2014',
+};
+const PRIORITY_LABEL = {
+    0: '',
+    10: '\u2605',
+    20: '\u2605\u2605',
+    50: '\uD83D\uDD25',
+};
+function formatTask(t, indent = '') {
+    const icon = STATUS_ICON[t.status] ?? '?';
+    const prio = PRIORITY_LABEL[t.priority] ?? (t.priority > 0 ? `p${t.priority}` : '');
+    const size = t.size ? `[${t.size}]` : '';
+    const type = !['feature', 'featureSet'].includes(t.task_type) ? `(${t.task_type})` : '';
+    const depsArr = Array.isArray(t.depends_on)
+        ? t.depends_on
+        : typeof t.depends_on === 'string'
+            ? JSON.parse(t.depends_on)
+            : [];
+    const deps = depsArr.map((id) => taskById.get(id)?.ref ?? id.slice(0, 8)).join(', ');
+    const id = t.ref ?? t.id.slice(0, 8);
+    const parts = [`${indent}- [${icon}] **${id}** ${t.title}`];
+    if (size)
+        parts.push(size);
+    if (prio)
+        parts.push(prio);
+    if (type)
+        parts.push(type);
+    if (deps)
+        parts.push(`\u2190 ${deps}`);
+    return parts.join(' ');
+}
+// ─── Recursive renderer for featureSets ─────────────────────────────────────
+function renderFeatureSet(fs, depth = 0) {
+    const result = [];
+    const icon = STATUS_ICON[fs.status] ?? '?';
+    const headerPrefix = '#'.repeat(3 + depth);
+    const timeH = sumTimeH(fs.id);
+    const timeSuffix = timeH > 0 ? ` (${timeH.toFixed(1)}h)` : '';
+    result.push(`${headerPrefix} ${fs.ref}: ${fs.title} [${icon}]${timeSuffix}`);
+    if (fs.description)
+        result.push(`> ${fs.description}`);
+    result.push('');
+    const children = sortByTaskId(childrenByParent.get(fs.id) ?? []);
+    const childFeatureSets = children.filter((c) => c.task_type === 'featureSet');
+    const childTasks = children.filter((c) => c.task_type !== 'featureSet');
+    const indent = '  '.repeat(depth);
+    if (childTasks.length) {
+        for (const child of childTasks) {
+            result.push(formatTask(child, indent));
+        }
+        result.push('');
+    }
+    for (const childFs of childFeatureSets) {
+        result.push(...renderFeatureSet(childFs, depth + 1));
+    }
+    return result;
+}
+// ─── Collect all open items ─────────────────────────────────────────────────
+const allOpen = sortByPrioDesc(tasks.filter((t) => t.task_type !== 'featureSet' && (t.status === 'queued' || t.status === 'in_progress')));
+// ─── Build output ──────────────────────────────────────────────────────────
+const lines = [];
+lines.push(`# ${project} \u2014 Backlog`);
+lines.push('');
+lines.push(`> Generated from tasks DB on ${new Date().toISOString().slice(0, 10)}`);
+lines.push('');
+if (allOpen.length) {
+    lines.push('## Up Next');
+    lines.push('');
+    for (const t of allOpen) {
+        const parent = t.parent_id ? taskById.get(t.parent_id) : null;
+        const parentRef = parent ? ` \u00B7 ${parent.ref}` : '';
+        lines.push(formatTask(t) + parentRef);
+    }
+    lines.push('');
+}
+if (rootFeatureSets.length) {
+    lines.push('## Feature Sets');
+    lines.push('');
+    for (const fs of rootFeatureSets) {
+        lines.push(...renderFeatureSet(fs));
+    }
+}
+const queued = topLevel.filter((t) => t.status === 'queued' || t.status === 'in_progress');
+const done = topLevel.filter((t) => t.status === 'done');
+const rest = topLevel.filter((t) => !['queued', 'in_progress', 'done'].includes(t.status));
+if (queued.length) {
+    lines.push('## Open');
+    lines.push('');
+    for (const t of queued)
+        lines.push(formatTask(t));
+    lines.push('');
+}
+if (rest.length) {
+    lines.push('## Other');
+    lines.push('');
+    for (const t of rest)
+        lines.push(formatTask(t));
+    lines.push('');
+}
+if (done.length) {
+    lines.push('<details>');
+    lines.push('<summary>Done (' + done.length + ')</summary>');
+    lines.push('');
+    for (const t of done)
+        lines.push(formatTask(t));
+    lines.push('');
+    lines.push('</details>');
+    lines.push('');
+}
+// ─── Output ─────────────────────────────────────────────────────────────────
+const output = lines.join('\n');
+if (doWrite) {
+    let root = process.cwd();
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+    const candidates = [
+        resolve(home, '.beacon-platform', 'projects.yaml'),
+        resolve(process.cwd(), 'servers', 'beacon-agent', 'projects.yaml'),
+    ];
+    for (const yamlPath of candidates) {
+        if (!existsSync(yamlPath))
+            continue;
+        const doc = parse(readFileSync(yamlPath, 'utf-8'));
+        const entry = doc?.projects?.[project];
+        if (entry?.path) {
+            root = entry.path;
+            break;
+        }
+    }
+    const outPath = resolve(root, 'docs', 'backlog.md');
+    const newContent = output + '\n';
+    if (existsSync(outPath) && readFileSync(outPath, 'utf-8') === newContent) {
+        log.info('skipped (unchanged)', { path: outPath });
+    }
+    else {
+        writeFileSync(outPath, newContent);
+        log.info('written', { path: outPath });
+    }
+}
+else {
+    console.log(output);
+}
+//# sourceMappingURL=backlog.js.map

package/dist/cli/backlog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../../src/cli/backlog.ts"],"names":[],"mappings":"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"}

package/dist/cli/claude-md-check.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * beacon-claude-md-check — @beacon-build/sdk
+ *
+ * Validates CLAUDE.md auto-triggers against practice files.
+ * Checks that every practice doc in docs/constitution/practices/ has a
+ * corresponding entry in the CLAUDE.md auto-trigger table.
+ *
+ * Usage:
+ *   beacon-claude-md-check [project-root]   # defaults to cwd
+ *
+ * Exit codes:
+ *   0 — all checks passed
+ *   1 — gaps found
+ *   2 — CLAUDE.md or practices dir not found
+ */
+export {};
+//# sourceMappingURL=claude-md-check.d.ts.map

package/dist/cli/claude-md-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-check.d.ts","sourceRoot":"","sources":["../../src/cli/claude-md-check.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/cli/claude-md-check.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * beacon-claude-md-check — @beacon-build/sdk
+ *
+ * Validates CLAUDE.md auto-triggers against practice files.
+ * Checks that every practice doc in docs/constitution/practices/ has a
+ * corresponding entry in the CLAUDE.md auto-trigger table.
+ *
+ * Usage:
+ *   beacon-claude-md-check [project-root]   # defaults to cwd
+ *
+ * Exit codes:
+ *   0 — all checks passed
+ *   1 — gaps found
+ *   2 — CLAUDE.md or practices dir not found
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createCliLogger } from '../lib/logger.js';
+const log = createCliLogger('claude-md-check');
+const projectRoot = process.argv[2] ?? process.cwd();
+const claudeMd = join(projectRoot, 'CLAUDE.md');
+const practicesDir = join(projectRoot, 'docs', 'constitution', 'practices');
+if (!existsSync(claudeMd)) {
+    log.error('CLAUDE.md not found', { path: claudeMd });
+    process.exit(2);
+}
+if (!existsSync(practicesDir)) {
+    log.error('practices directory not found', { path: practicesDir });
+    process.exit(2);
+}
+const practiceFiles = readdirSync(practicesDir)
+    .filter((f) => f.endsWith('.md') && f !== 'README.md')
+    .map((f) => f.replace('.md', ''));
+const claudeContent = readFileSync(claudeMd, 'utf-8');
+const referencedPractices = new Set();
+const practiceRefPattern = /practices\/([a-z0-9_-]+)\.md/gi;
+let match;
+while ((match = practiceRefPattern.exec(claudeContent)) !== null) {
+    referencedPractices.add(match[1]);
+}
+const missing = practiceFiles.filter((p) => !referencedPractices.has(p));
+const stale = [...referencedPractices].filter((p) => !practiceFiles.includes(p));
+let hasErrors = false;
+if (missing.length > 0) {
+    log.error('practices missing from CLAUDE.md auto-triggers', { missing });
+    hasErrors = true;
+}
+if (stale.length > 0) {
+    log.warn('CLAUDE.md references practices that no longer exist', { stale });
+    hasErrors = true;
+}
+if (!hasErrors) {
+    log.info('all auto-triggers complete', { practices: practiceFiles.length });
+}
+process.exit(hasErrors ? 1 : 0);
+//# sourceMappingURL=claude-md-check.js.map

package/dist/cli/claude-md-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-check.js","sourceRoot":"","sources":["../../src/cli/claude-md-check.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * beacon-context — @beacon-build/sdk (F161)
+ *
+ * Generates context sections split across two files:
+ *   AGENTS.md — system-agnostic sections: worker, context, monorepo, code-repo
+ *   CLAUDE.md — Claude Code-specific: triggers; @AGENTS.md import
+ *
+ * Usage:
+ *   beacon-context <project>           # print to stdout
+ *   beacon-context <project> --write   # write both files
+ */
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}