@beacon-build/sdk 2.4.3 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @beacon-build/sdk Changelog
 
+## 2.4.4
+
+### Patch Changes
+
+- 68ad6f7: fix(ide-portal): resolve ops key from ambient OPS_API_KEY in the container for non-local envs, and make Argus JWT boot-mint failures degrade non-fatally instead of exiting the process (B904)
+- 6d90fc4: Cockpit: every tool interaction (call + result) is now expandable per turn. Amends INV-IDE-3 — tool output text is now captured, redacted, size-capped, and threaded end-to-end instead of being discarded (only byte size survived before).
+- 7330b8d: Fix B911: repair red integration CI and the F336 alert-lifecycle defects it masked. The missing F336 migration meant alert inserts always 400'd, hiding four real bugs in the feature:
+    - Migration widening `tasks_status_check` (F336 statuses open/acknowledged/resolved) and `tasks_type_check` (F336 type alert) to match the code enums.
+    - Register the four raw-HTTP seams the INV-3 route-contract surfaced (F624 `GET /ops/alert-config`; F336 `POST /tasks/alerts`, `/tasks/{id}/ack`, `/tasks/{id}/resolve`) in the SDK negative list.
+    - Derive a new task's initial status from its type state machine (`typeStateMachines[type].initialStatus`) instead of hardcoding `queued`, so an `alert` starts `open` (byte-identical `queued` for every other type).
+    - Persist `alertKey` on both task create paths so `alertRaise`'s open-alert dedup works.
+    - Expose `severity`/`alertKey`/`acknowledgedAt` on the task DTO so alert responses carry them.
+    - Map a terminal-state ack/resolve (e.g. a second resolve of a resolved alert) to HTTP 422 instead of 500.
+
+- Updated dependencies [a731e8c]
+- Updated dependencies [1b251c2]
+- Updated dependencies [6d90fc4]
+- Updated dependencies [1ef9bc3]
+- Updated dependencies [06c9e95]
+- Updated dependencies [e5a6d21]
+- Updated dependencies [7330b8d]
+    - @beacon-build/core@2.5.0
+
 ## 2.4.3
 
 ### Patch Changes

package/dist/auth/argus-jwt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * F437/C958 — Shared Argus-JWT minting + rotation helper.
+ *
+ * Extracted from the duplicated `apps/ide/src/argus-jwt.ts` and
+ * `apps/ide-portal/src/engine/argus-jwt.ts` implementations into
+ * `@beacon-build/sdk` so every consumer (sidecar, portal, janitor, MCP agent)
+ * uses the SAME shape.
+ *
+ * `createRotatingArgusJwt` is a thin wrapper around `createRotatingJwtProvider`
+ * that supplies the Argus-specific mint call (`resolveSystemAgentAndMintToken`).
+ * The caller provides a `RotatingJwtLog` — `sdk` has no dependency on
+ * `@beacon-build/logger`, and every caller's real logger already satisfies this
+ * minimal shape.
+ */
+import { type RotatingJwtLog } from './rotating-jwt-provider.js';
+/**
+ * Resolve Argus's agent id, then mint an agent-JWT via the mint boundary
+ * (`POST /v1/agent-token`, `OPS_API_KEY`-gated, system-role `agentId` path).
+ */
+export declare function doMintArgusJwt(apiUrl: string, apiKey: string): Promise<{
+    agentId: string;
+    token: string;
+}>;
+/**
+ * Mint an Argus agent-JWT at boot (fail-fast), then keep the token rotating for
+ * the life of a long-running daemon via the shared `createRotatingJwtProvider`.
+ * Returns a PROVIDER — re-read per request — never a captured string.
+ */
+export declare function createRotatingArgusJwt(apiUrl: string, apiKey: string, log: RotatingJwtLog): Promise<() => string>;
+//# sourceMappingURL=argus-jwt.d.ts.map

package/dist/auth/argus-jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argus-jwt.d.ts","sourceRoot":"","sources":["../../src/auth/argus-jwt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAS3F;;;GAGG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAG7C;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,MAAM,CAAC,CAQvB"}

package/dist/auth/argus-jwt.js

@@ -0,0 +1,41 @@
+/**
+ * F437/C958 — Shared Argus-JWT minting + rotation helper.
+ *
+ * Extracted from the duplicated `apps/ide/src/argus-jwt.ts` and
+ * `apps/ide-portal/src/engine/argus-jwt.ts` implementations into
+ * `@beacon-build/sdk` so every consumer (sidecar, portal, janitor, MCP agent)
+ * uses the SAME shape.
+ *
+ * `createRotatingArgusJwt` is a thin wrapper around `createRotatingJwtProvider`
+ * that supplies the Argus-specific mint call (`resolveSystemAgentAndMintToken`).
+ * The caller provides a `RotatingJwtLog` — `sdk` has no dependency on
+ * `@beacon-build/logger`, and every caller's real logger already satisfies this
+ * minimal shape.
+ */
+import { AgentsOpsClient, OpsApiClient } from '../index.js';
+import { createRotatingJwtProvider } from './rotating-jwt-provider.js';
+// F437/D1: Argus's project/alias — matches every other automation consumer.
+const ARGUS_PROJECT = 'beacon-platform';
+const ARGUS_ALIAS = 'Argus';
+// B468: the API expires an agent-JWT after 8h — refresh at half that.
+const ARGUS_JWT_REFRESH_MS = 4 * 60 * 60 * 1000;
+/**
+ * Resolve Argus's agent id, then mint an agent-JWT via the mint boundary
+ * (`POST /v1/agent-token`, `OPS_API_KEY`-gated, system-role `agentId` path).
+ */
+export async function doMintArgusJwt(apiUrl, apiKey) {
+    const opsClient = new AgentsOpsClient(new OpsApiClient({ baseUrl: apiUrl, apiKey }));
+    return opsClient.resolveSystemAgentAndMintToken(ARGUS_ALIAS, ARGUS_PROJECT);
+}
+/**
+ * Mint an Argus agent-JWT at boot (fail-fast), then keep the token rotating for
+ * the life of a long-running daemon via the shared `createRotatingJwtProvider`.
+ * Returns a PROVIDER — re-read per request — never a captured string.
+ */
+export async function createRotatingArgusJwt(apiUrl, apiKey, log) {
+    return createRotatingJwtProvider(async () => {
+        const { agentId, token } = await doMintArgusJwt(apiUrl, apiKey);
+        return { token, logContext: { agentId } };
+    }, { refreshMs: ARGUS_JWT_REFRESH_MS, log });
+}
+//# sourceMappingURL=argus-jwt.js.map

package/dist/auth/argus-jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argus-jwt.js","sourceRoot":"","sources":["../../src/auth/argus-jwt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,yBAAyB,EAAuB,MAAM,4BAA4B,CAAA;AAE3F,4EAA4E;AAC5E,MAAM,aAAa,GAAG,iBAAiB,CAAA;AACvC,MAAM,WAAW,GAAG,OAAO,CAAA;AAE3B,sEAAsE;AACtE,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAc,EACd,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACpF,OAAO,SAAS,CAAC,8BAA8B,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,MAAc,EACd,MAAc,EACd,GAAmB;IAEnB,OAAO,yBAAyB,CAC5B,KAAK,IAAI,EAAE;QACP,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;IAC7C,CAAC,EACD,EAAE,SAAS,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAC3C,CAAA;AACL,CAAC"}

package/dist/auth/rotating-jwt-provider.d.ts

@@ -66,11 +66,22 @@ export interface RotatingJwtProviderOptions {
      *  keep-current handling as any other mint error). Defaults to
      *  `DEFAULT_MINT_TIMEOUT_MS`. */
     timeoutMs?: number;
+    /** B904: what a FAILED boot mint does. `'exit'` (default) preserves the original
+     *  fail-fast contract this module's doc comment describes — the right behavior for a
+     *  daemon whose caller does NOT already handle a rejected boot (MCP servers via B710's
+     *  `register()`/`connect()` gate, the janitor, the retired host sidecar). `'throw'` is
+     *  for a caller that DOES already degrade non-fatally on a rejected promise (e.g. the
+     *  ide-portal's `engine-runtime.ts`, whose lazy `ensureEngineRuntime` already wraps
+     *  construction in a `.catch()` that logs a WARN and returns `null` instead of crashing)
+     *  — there, `process.exit(1)` mid-construction is strictly worse than the SAME degrade
+     *  path an ordinary resolution failure already takes, because it bypasses that `.catch()`
+     *  entirely and kills the whole process instead of just disabling one feature. */
+    onBootMintFailure?: 'exit' | 'throw';
 }
 /**
  * Mint `mintFn` once at boot (fail-fast on failure — exits the process), then keep the
  * token rotating for the life of a long-running daemon on an unref'd timer. Returns a
  * PROVIDER — re-read per request — never a captured string.
  */
-export declare function createRotatingJwtProvider(mintFn: () => Promise<JwtMintResult>, { refreshMs, log, timeoutMs }: RotatingJwtProviderOptions): Promise<() => string>;
+export declare function createRotatingJwtProvider(mintFn: () => Promise<JwtMintResult>, { refreshMs, log, timeoutMs, onBootMintFailure, }: RotatingJwtProviderOptions): Promise<() => string>;
 //# sourceMappingURL=rotating-jwt-provider.d.ts.map

package/dist/auth/rotating-jwt-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rotating-jwt-provider.d.ts","sourceRoot":"","sources":["../../src/auth/rotating-jwt-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;iFAEiF;AACjF,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;kEAEkE;AAClE,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C,MAAM,WAAW,0BAA0B;IACvC;;mEAE+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;IACnB;;;qCAGiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AA+CD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC3C,MAAM,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EACpC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAmC,EAAE,EAAE,0BAA0B,GACpF,OAAO,CAAC,MAAM,MAAM,CAAC,CAsBvB"}
+{"version":3,"file":"rotating-jwt-provider.d.ts","sourceRoot":"","sources":["../../src/auth/rotating-jwt-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;iFAEiF;AACjF,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;kEAEkE;AAClE,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C,MAAM,WAAW,0BAA0B;IACvC;;mEAE+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;IACnB;;;qCAGiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;;sFASkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACvC;AAsDD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC3C,MAAM,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EACpC,EACI,SAAS,EACT,GAAG,EACH,SAAmC,EACnC,iBAA0B,GAC7B,EAAE,0BAA0B,GAC9B,OAAO,CAAC,MAAM,MAAM,CAAC,CAsBvB"}

package/dist/auth/rotating-jwt-provider.js

@@ -65,7 +65,7 @@ function withMintTimeout(mintFn, timeoutMs) {
         });
     });
 }
-async function mintAtBoot(mintFn, log, timeoutMs) {
+async function mintAtBoot(mintFn, log, timeoutMs, onBootMintFailure) {
     try {
         const { token, logContext } = await withMintTimeout(mintFn, timeoutMs);
         log.info('minted rotating JWT at boot', logContext);
@@ -75,6 +75,12 @@ async function mintAtBoot(mintFn, log, timeoutMs) {
         log.error('rotating JWT boot mint failed', {
             error: err instanceof Error ? err.message : String(err),
         });
+        // B904: 'throw' lets a caller that already degrades non-fatally on a rejected
+        // promise (see RotatingJwtProviderOptions.onBootMintFailure doc) catch this instead
+        // of the whole process dying. 'exit' (default) is the original fail-fast contract.
+        if (onBootMintFailure === 'throw') {
+            throw err instanceof Error ? err : new Error(String(err));
+        }
         process.exit(1);
     }
 }
@@ -83,8 +89,8 @@ async function mintAtBoot(mintFn, log, timeoutMs) {
  * token rotating for the life of a long-running daemon on an unref'd timer. Returns a
  * PROVIDER — re-read per request — never a captured string.
  */
-export async function createRotatingJwtProvider(mintFn, { refreshMs, log, timeoutMs = DEFAULT_MINT_TIMEOUT_MS }) {
-    let current = await mintAtBoot(mintFn, log, timeoutMs);
+export async function createRotatingJwtProvider(mintFn, { refreshMs, log, timeoutMs = DEFAULT_MINT_TIMEOUT_MS, onBootMintFailure = 'exit', }) {
+    let current = await mintAtBoot(mintFn, log, timeoutMs, onBootMintFailure);
     const timer = setInterval(() => {
         void (async () => {
             try {

package/dist/auth/rotating-jwt-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"rotating-jwt-provider.js","sourceRoot":"","sources":["../../src/auth/rotating-jwt-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAeH;;kEAEkE;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAe7C;;;;;GAKG;AACH,SAAS,eAAe,CACpB,MAAoC,EACpC,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,SAAS,IAAI,CAAC,CAAC,CAAA;QAChE,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,MAAM,EAAE,CAAC,IAAI,CACT,CAAC,MAAM,EAAE,EAAE;YACP,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,MAAM,CAAC,CAAA;QACnB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,CAAC,GAAG,CAAC,CAAA;QACf,CAAC,CACJ,CAAA;IACL,CAAC,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,UAAU,CACrB,MAAoC,EACpC,GAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACtE,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,UAAU,CAAC,CAAA;QACnD,OAAO,KAAK,CAAA;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE;YACvC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC3C,MAAoC,EACpC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,uBAAuB,EAA8B;IAEnF,IAAI,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAA;IAEtD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC3B,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,IAAI,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;gBACtE,OAAO,GAAG,KAAK,CAAA;gBACf,GAAG,CAAC,IAAI,CAAC,oCAAoC,EAAE,UAAU,CAAC,CAAA;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,uEAAuE;gBACvE,0EAA0E;gBAC1E,mDAAmD;gBACnD,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE;oBACvD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAA;YACN,CAAC;QACL,CAAC,CAAC,EAAE,CAAA;IACR,CAAC,EAAE,SAAS,CAAC,CAAA;IACb,KAAK,CAAC,KAAK,EAAE,CAAA;IAEb,OAAO,GAAG,EAAE,CAAC,OAAO,CAAA;AACxB,CAAC"}
+{"version":3,"file":"rotating-jwt-provider.js","sourceRoot":"","sources":["../../src/auth/rotating-jwt-provider.ts"],"names":[],"mappings":"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"}

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"}