@decibelsystems/tools 2.2.0-beta.0 → 3.1.0

package/dist/artifacts.js

@@ -0,0 +1,208 @@
+// ============================================================================
+// Artifacts — published pages registered into hq.artifacts for humans to find
+// ============================================================================
+// Daemon half of decibel-hq EPIC-0019 (the /artifacts library on HQ). Two ways
+// in, one write path:
+//   1. artifacts.register — an agent says "I just published this".
+//   2. chat harvest — an inbound /chat message carries a claude.ai artifact
+//      link (Ben approved this 2026-10-08; it moves chat-derived text into Core).
+// Both call hq.register_artifact() via SERVICE_ROLE, the same scoped exception
+// as presence. The RPC owns the overwrite rules: source, published_by,
+// project_id, meta and published_at are insert-only; 'agent' refreshes title
+// and description unless a human added the row; 'chat' never updates. Doing
+// this as one atomic RPC rather than a client-side two-step is the contract —
+// don't replace it with an upsert.
+//
+// Not project intel: nothing here is written to .decibel, and the
+// agent_commands queue / projector don't apply.
+//
+// Never throws into the daemon. Without Supabase credentials or DECIBEL_ORG_ID
+// it is a no-op that says why (ADR-0014: there is no default org).
+// ============================================================================
+import path from 'path';
+import { log } from './config.js';
+import { getOrgId } from './orgId.js';
+import { withRetryResult } from './supabaseRetry.js';
+import { serviceClient, resolveProjectId, resolveAgentId, deriveAgentName, resolveHost, sanitizeText, sanitizeMeta, } from './agentPresence.js';
+import { listProjects } from './projectRegistry.js';
+export const TITLE_MAX = 200;
+export const DESCRIPTION_MAX = 1000;
+export const URL_MAX = 2048;
+/**
+ * Mirrors decibel-hq src/lib/artifacts.ts extractArtifactLinks EXACTLY. If HQ
+ * changes its regex, change this one — tests/unit/artifacts.test.ts pins both
+ * to the same fixtures.
+ */
+export function extractArtifactLinks(text) {
+    const re = /https:\/\/claude\.ai\/(?:code\/)?artifact\/[A-Za-z0-9-]+/g;
+    return [...new Set(text.match(re) ?? [])];
+}
+// One log line per process when the RPC is missing, not one per call.
+let unavailableWarned = false;
+/** For tests. */
+export function _resetArtifacts() {
+    unavailableWarned = false;
+}
+function isWithin(child, parent) {
+    const p = parent.replace(/\/+$/, '');
+    return child === p || child.startsWith(p + '/');
+}
+/** The registered project root that contains `dir`, deepest match wins. */
+export function projectRootFor(dir) {
+    if (!dir)
+        return null;
+    let best = null;
+    for (const p of listProjects()) {
+        if (p.available === false || !p.path)
+            continue;
+        if (isWithin(dir, p.path) && (!best || p.path.length > best.length))
+            best = p.path;
+    }
+    return best;
+}
+/** Validate before the round trip so the caller gets a message, not a SQLSTATE. */
+export function validateUrl(url) {
+    if (typeof url !== 'string' || !url.trim())
+        return 'url is required';
+    const u = url.trim();
+    if (u.length > URL_MAX)
+        return `url is longer than ${URL_MAX} characters`;
+    let parsed;
+    try {
+        parsed = new URL(u);
+    }
+    catch {
+        return 'url is not a valid URL';
+    }
+    if (parsed.protocol !== 'https:')
+        return 'url must be https';
+    return null;
+}
+async function mapProject(client, project, root) {
+    try {
+        if (project) {
+            // A local registry id first (its path's basename is the HQ key, as with
+            // presence), then the string itself as an HQ key.
+            const entry = listProjects().find((p) => p.id === project || (p.aliases ?? []).includes(project));
+            const key = entry?.path ? entry.path : project;
+            const id = await resolveProjectId(client, key);
+            if (id)
+                return id;
+        }
+        return root ? await resolveProjectId(client, root) : null;
+    }
+    catch {
+        return null; // a lookup failure must not fail the registration
+    }
+}
+export async function registerArtifact(input, deps = {}) {
+    const urlErr = validateUrl(input.url);
+    if (urlErr)
+        return { ok: false, reason: 'invalid', message: urlErr };
+    const title = sanitizeText(input.title?.trim(), TITLE_MAX);
+    if (!title)
+        return { ok: false, reason: 'invalid', message: 'title is required (1-200 characters)' };
+    const client = deps.client === undefined ? serviceClient() : deps.client;
+    if (!client) {
+        return { ok: false, reason: 'unconfigured', message: 'HQ is not configured on this machine (SUPABASE_URL / SUPABASE_SERVICE_KEY unset)' };
+    }
+    let org;
+    try {
+        org = getOrgId();
+    }
+    catch (e) {
+        return { ok: false, reason: 'unconfigured', message: e instanceof Error ? e.message : String(e) };
+    }
+    if (!org) {
+        return { ok: false, reason: 'unconfigured', message: 'DECIBEL_ORG_ID is not set; there is no default org (ADR-0014)' };
+    }
+    const root = projectRootFor(input.cwd ?? null);
+    const project_id = await mapProject(client, input.project, root);
+    // published_by: only an agent registration has a publisher, and only when
+    // the call is made from inside a registered project. Derived from WHERE the
+    // caller is, never from a name it supplies (see deriveAgentName).
+    let published_by = null;
+    if (input.source === 'agent' && root) {
+        try {
+            const agentId = await resolveAgentId(client, deriveAgentName({ gitRoot: root, runtime: 'claude-code', host: resolveHost() }), 'claude-code');
+            if (agentId)
+                published_by = `agent:${agentId}`;
+        }
+        catch {
+            published_by = null;
+        }
+    }
+    const { data, error } = await withRetryResult(() => client.rpc('register_artifact', {
+        p_org: org,
+        p_url: input.url.trim(),
+        p_title: title,
+        p_source: input.source,
+        p_description: sanitizeText(input.description?.trim(), DESCRIPTION_MAX),
+        p_project: project_id,
+        p_published_by: published_by,
+        p_meta: sanitizeMeta(input.meta),
+    }), `artifacts.register ${input.source}`);
+    if (error) {
+        const code = error.code;
+        if (code === '22023' || code === '23514') {
+            return { ok: false, reason: 'invalid', message: error.message };
+        }
+        // Function or table absent: PostgREST reports PGRST202, Postgres 42883/42P01.
+        if (code === 'PGRST202' || code === '42883' || code === '42P01') {
+            if (!unavailableWarned) {
+                unavailableWarned = true;
+                log(`Artifacts: hq.register_artifact unavailable (${error.message}); registrations are off until the migration is applied.`);
+            }
+            return { ok: false, reason: 'unavailable', message: 'hq.register_artifact is not available on Core (migration hq_artifacts not applied?)' };
+        }
+        return { ok: false, reason: 'failed', message: error.message };
+    }
+    return { ok: true, id: String(data) };
+}
+/**
+ * A title from the text around the link. Chat text is untrusted data: it is
+ * only ever used as a display string, stripped of control characters and
+ * capped, and falls back to a fixed phrase when there is nothing usable.
+ */
+export function titleFromChat(text, project) {
+    const fallback = `Artifact from ${project || 'chat'}`;
+    const stripped = text
+        .replace(/https?:\/\/\S+/g, ' ')
+        .split('\n')
+        .map((l) => l.replace(/^[\s>*#\-•:]+/, '').replace(/[\s:–—-]+$/, '').replace(/\s+/g, ' ').trim())
+        .find((l) => /[A-Za-z0-9]/.test(l) && l.length >= 3);
+    if (!stripped)
+        return fallback;
+    return sanitizeText(stripped, TITLE_MAX) ?? fallback;
+}
+/** Register every artifact link in one inbound chat message. Never throws. */
+export async function harvestChatMessage(m, deps = {}) {
+    if (m.dir !== 'in')
+        return [];
+    const links = extractArtifactLinks(m.text || '');
+    if (!links.length)
+        return [];
+    const projectLabel = m.project_id || (m.cwd ? path.basename(m.cwd) : null);
+    const title = titleFromChat(m.text, projectLabel);
+    const out = [];
+    for (const url of links) {
+        try {
+            const result = await registerArtifact({
+                url,
+                title,
+                source: 'chat',
+                project: m.project_id ?? null,
+                cwd: m.cwd ?? null,
+                meta: { chat_id: m.id, ...(m.peer_id ? { peer_id: m.peer_id } : {}) },
+            }, deps);
+            if (!result.ok && result.reason === 'failed')
+                log(`Artifacts: chat harvest of ${url} failed: ${result.message}`);
+            out.push({ url, result });
+        }
+        catch (e) {
+            log(`Artifacts: chat harvest of ${url} threw: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/asks.d.ts

@@ -0,0 +1,93 @@
+import { type DbClient } from './agentPresence.js';
+export declare const QUESTION_MAX = 4000;
+export declare const CHOICES_MAX = 10;
+export declare const CHOICE_MAX = 200;
+export declare const CONTEXT_REF_MAX = 500;
+export type AskShape = {
+    kind: 'yes_no';
+} | {
+    kind: 'text';
+} | {
+    kind: 'options';
+    choices: string[];
+};
+export type AskStatus = 'draft' | 'open' | 'answered' | 'withdrawn' | 'expired';
+export interface AskRecord {
+    ask_id: string;
+    project_id: string;
+    project_key: string;
+    asker: string;
+    target: string;
+    question: string;
+    shape: AskShape;
+    context_ref?: string;
+    requires_approval: boolean;
+    status: AskStatus;
+    created_at: string;
+    expires_at?: string;
+    /** True once hq.asks holds this row. */
+    synced: boolean;
+    sync_error?: string;
+    answer?: boolean | string;
+    answered_by?: string;
+    on_behalf_of?: string;
+    answered_via?: string;
+    answered_at?: string;
+    superseded_answers?: unknown[];
+    /** When a live session in the project was told the outcome. */
+    notified_at?: string;
+}
+export declare class AskError extends Error {
+}
+/** ASK- plus a ULID: 10 chars of time, 16 of randomness. Sorts by creation. */
+export declare function mintAskId(now?: number): string;
+export declare function parseShape(raw: unknown): AskShape;
+/** A human who can answer: user:<uuid>, human:<name>, or guest:<grant uuid>. */
+export declare function parseTarget(raw: unknown): {
+    target: string;
+    guest: boolean;
+};
+export declare function readAsks(projectId: string): AskRecord[];
+export declare function readAsk(projectId: string, askId: string): AskRecord | null;
+/** The hq.asks row for a record. Never includes answer columns. */
+export declare function hqRow(rec: AskRecord, orgId: string): Record<string, unknown>;
+export interface CreateInput {
+    project_id?: string;
+    question: unknown;
+    target: unknown;
+    shape?: unknown;
+    context_ref?: unknown;
+    expires_at?: unknown;
+    requires_approval?: unknown;
+    /** Who is asking. Callers pass their agent name; defaults to the project's agent. */
+    asker?: string;
+}
+export interface CreateDeps {
+    client?: DbClient | null;
+    orgId?: () => string | null;
+    now?: () => Date;
+}
+export declare function createAsk(input: CreateInput, deps?: CreateDeps): Promise<AskRecord>;
+export interface PickupDeps {
+    client?: DbClient | null;
+    orgId?: () => string | null;
+    /** project_ids to scan; defaults to every registered project. */
+    projects?: () => string[];
+    /** Tell a live session in the project; true when someone received it. */
+    notify?: (projectId: string, text: string) => Promise<boolean>;
+    now?: () => Date;
+}
+export declare function outcomeText(rec: AskRecord): string;
+export interface PickupResult {
+    pushed: number;
+    resolved: number;
+    notified: number;
+    errors: string[];
+}
+export declare function pickupOnce(deps?: PickupDeps): Promise<PickupResult>;
+/** Notify live claude-peers sessions whose repo is the project's. */
+export declare function notifyProjectSessions(projectId: string, text: string): Promise<boolean>;
+export declare const PICKUP_MS = 30000;
+/** The daemon's 30 s loop (the Friday fallback for realtime; ISS-0213). */
+export declare function startAskPickup(intervalMs?: number): () => void;
+//# sourceMappingURL=asks.d.ts.map

package/dist/asks.d.ts.map

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