reflectt-node 0.1.0

package/dist/release.js.map

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

package/dist/request-tracker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lightweight request tracking for launch-day visibility.
+ * Tracks request counts per endpoint group and last N errors.
+ * No external dependencies — pure in-memory counters.
+ */
+interface ErrorEntry {
+    ts: number;
+    method: string;
+    url: string;
+    status: number;
+    message: string;
+    userAgent?: string;
+}
+/**
+ * Record a request. Call from Fastify onResponse hook.
+ */
+export declare function trackRequest(method: string, url: string, statusCode: number, userAgent?: string): void;
+/**
+ * Record a caught error (for non-HTTP errors like unhandled promise rejections).
+ */
+export declare function trackError(context: string, error: unknown): void;
+export declare function getRequestMetrics(): {
+    total: number;
+    errors: number;
+    uptimeMs: number;
+    byGroup: Record<string, {
+        requests: number;
+        errors: number;
+    }>;
+    recentErrors: ErrorEntry[];
+    rps: number;
+};
+/** Reset (for testing) */
+export declare function resetRequestMetrics(): void;
+export {};
+//# sourceMappingURL=request-tracker.d.ts.map

package/dist/request-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tracker.d.ts","sourceRoot":"","sources":["../src/request-tracker.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAIH,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAsCD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAuBtG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAahE;AAID,wBAAgB,iBAAiB,IAAI;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;CACZ,CA4BA;AAED,0BAA0B;AAC1B,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/request-tracker.js

@@ -0,0 +1,109 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+// ── Configuration ──────────────────────────────────────────────────────────
+const MAX_ERRORS = 20;
+const TRACKED_GROUPS = [
+    { pattern: /^\/health/, name: 'health' },
+    { pattern: /^\/bootstrap/, name: 'bootstrap' },
+    { pattern: /^\/tasks/, name: 'tasks' },
+    { pattern: /^\/api\/hosts/, name: 'cloud_hosts' },
+    { pattern: /^\/openclaw/, name: 'openclaw' },
+    { pattern: /^\/chat/, name: 'chat' },
+    { pattern: /^\/mcp/, name: 'mcp' },
+];
+// ── State ──────────────────────────────────────────────────────────────────
+const requestCounts = {};
+const errorCounts = {};
+const recentErrors = [];
+let totalRequests = 0;
+let totalErrors = 0;
+const startedAt = Date.now();
+// ── Core ───────────────────────────────────────────────────────────────────
+function classifyUrl(url) {
+    for (const group of TRACKED_GROUPS) {
+        if (group.pattern.test(url))
+            return group.name;
+    }
+    return 'other';
+}
+/**
+ * Record a request. Call from Fastify onResponse hook.
+ */
+export function trackRequest(method, url, statusCode, userAgent) {
+    totalRequests++;
+    const group = classifyUrl(url);
+    requestCounts[group] = (requestCounts[group] || 0) + 1;
+    if (statusCode >= 400) {
+        totalErrors++;
+        errorCounts[group] = (errorCounts[group] || 0) + 1;
+    }
+    if (statusCode >= 500) {
+        recentErrors.push({
+            ts: Date.now(),
+            method,
+            url: url.length > 200 ? url.slice(0, 200) + '…' : url,
+            status: statusCode,
+            message: `${method} ${url} → ${statusCode}`,
+            userAgent: userAgent?.slice(0, 100),
+        });
+        if (recentErrors.length > MAX_ERRORS) {
+            recentErrors.shift();
+        }
+    }
+}
+/**
+ * Record a caught error (for non-HTTP errors like unhandled promise rejections).
+ */
+export function trackError(context, error) {
+    totalErrors++;
+    const msg = error instanceof Error ? error.message : String(error);
+    recentErrors.push({
+        ts: Date.now(),
+        method: 'INTERNAL',
+        url: context,
+        status: 0,
+        message: msg.slice(0, 500),
+    });
+    if (recentErrors.length > MAX_ERRORS) {
+        recentErrors.shift();
+    }
+}
+// ── Metrics ────────────────────────────────────────────────────────────────
+export function getRequestMetrics() {
+    const uptimeMs = Date.now() - startedAt;
+    const uptimeSec = uptimeMs / 1000;
+    const rps = uptimeSec > 0 ? Math.round((totalRequests / uptimeSec) * 100) / 100 : 0;
+    const byGroup = {};
+    for (const group of TRACKED_GROUPS) {
+        const name = group.name;
+        byGroup[name] = {
+            requests: requestCounts[name] || 0,
+            errors: errorCounts[name] || 0,
+        };
+    }
+    if (requestCounts['other']) {
+        byGroup['other'] = {
+            requests: requestCounts['other'] || 0,
+            errors: errorCounts['other'] || 0,
+        };
+    }
+    return {
+        total: totalRequests,
+        errors: totalErrors,
+        uptimeMs,
+        byGroup,
+        recentErrors: [...recentErrors].reverse(), // Most recent first
+        rps,
+    };
+}
+/** Reset (for testing) */
+export function resetRequestMetrics() {
+    totalRequests = 0;
+    totalErrors = 0;
+    for (const key of Object.keys(requestCounts))
+        delete requestCounts[key];
+    for (const key of Object.keys(errorCounts))
+        delete errorCounts[key];
+    recentErrors.length = 0;
+}
+//# sourceMappingURL=request-tracker.js.map

package/dist/request-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tracker.js","sourceRoot":"","sources":["../src/request-tracker.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAwB5B,8EAA8E;AAE9E,MAAM,UAAU,GAAG,EAAE,CAAA;AACrB,MAAM,cAAc,GAAoB;IACtC,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9C,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;IACtC,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE;IACjD,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE;IAC5C,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;IACpC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;CACnC,CAAA;AAED,8EAA8E;AAE9E,MAAM,aAAa,GAA2B,EAAE,CAAA;AAChD,MAAM,WAAW,GAA2B,EAAE,CAAA;AAC9C,MAAM,YAAY,GAAiB,EAAE,CAAA;AACrC,IAAI,aAAa,GAAG,CAAC,CAAA;AACrB,IAAI,WAAW,GAAG,CAAC,CAAA;AACnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAE5B,8EAA8E;AAE9E,SAAS,WAAW,CAAC,GAAW;IAC9B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAA;IAChD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAW,EAAE,UAAkB,EAAE,SAAkB;IAC9F,aAAa,EAAE,CAAA;IACf,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC9B,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAEtD,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACtB,WAAW,EAAE,CAAA;QACb,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC;YAChB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM;YACN,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG;YACrD,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,GAAG,MAAM,IAAI,GAAG,MAAM,UAAU,EAAE;YAC3C,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACpC,CAAC,CAAA;QACF,IAAI,YAAY,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACrC,YAAY,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAc;IACxD,WAAW,EAAE,CAAA;IACb,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClE,YAAY,CAAC,IAAI,CAAC;QAChB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,OAAO;QACZ,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KAC3B,CAAC,CAAA;IACF,IAAI,YAAY,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QACrC,YAAY,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB;IAQ/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IACvC,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAA;IACjC,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnF,MAAM,OAAO,GAAyD,EAAE,CAAA;IACxE,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,GAAG;YACd,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAClC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/B,CAAA;IACH,CAAC;IACD,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,GAAG;YACjB,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;YACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,WAAW;QACnB,QAAQ;QACR,OAAO;QACP,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE,oBAAoB;QAC/D,GAAG;KACJ,CAAA;AACH,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,mBAAmB;IACjC,aAAa,GAAG,CAAC,CAAA;IACjB,WAAW,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAA;IACvE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;IACnE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;AACzB,CAAC"}

package/dist/research.d.ts

@@ -0,0 +1,75 @@
+export interface ResearchRequest {
+    id: string;
+    title: string;
+    question: string;
+    requestedBy: string;
+    owner?: string;
+    category?: 'market' | 'competitor' | 'customer' | 'other';
+    priority?: 'P0' | 'P1' | 'P2' | 'P3';
+    status: 'open' | 'in_progress' | 'answered' | 'archived';
+    taskId?: string;
+    dueAt?: number;
+    createdAt: number;
+    updatedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ResearchFinding {
+    id: string;
+    requestId: string;
+    title: string;
+    summary: string;
+    author: string;
+    confidence?: 'low' | 'medium' | 'high';
+    artifactUrl?: string;
+    highlights?: string[];
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+declare class ResearchManager {
+    private requests;
+    private findings;
+    private initialized;
+    constructor();
+    private load;
+    private ensureReady;
+    private persistRequests;
+    private persistFindings;
+    createRequest(data: {
+        title: string;
+        question: string;
+        requestedBy: string;
+        owner?: string;
+        category?: ResearchRequest['category'];
+        priority?: ResearchRequest['priority'];
+        status?: ResearchRequest['status'];
+        taskId?: string;
+        dueAt?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<ResearchRequest>;
+    updateRequest(id: string, updates: Partial<Omit<ResearchRequest, 'id' | 'createdAt'>>): Promise<ResearchRequest | undefined>;
+    getRequest(id: string): Promise<ResearchRequest | undefined>;
+    createFinding(data: {
+        requestId: string;
+        title: string;
+        summary: string;
+        author: string;
+        confidence?: ResearchFinding['confidence'];
+        artifactUrl?: string;
+        highlights?: string[];
+        metadata?: Record<string, unknown>;
+    }): Promise<ResearchFinding>;
+    listRequests(filters?: {
+        status?: ResearchRequest['status'];
+        owner?: string;
+        category?: ResearchRequest['category'];
+        limit?: number;
+    }): Promise<ResearchRequest[]>;
+    listFindings(filters?: {
+        requestId?: string;
+        author?: string;
+        limit?: number;
+    }): Promise<ResearchFinding[]>;
+}
+export declare const researchManager: ResearchManager;
+export {};
+//# sourceMappingURL=research.d.ts.map

package/dist/research.d.ts.map

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

package/dist/research.js

@@ -0,0 +1,171 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { DATA_DIR } from './config.js';
+const REQUESTS_FILE = join(DATA_DIR, 'research.requests.jsonl');
+const FINDINGS_FILE = join(DATA_DIR, 'research.findings.jsonl');
+class ResearchManager {
+    requests = new Map();
+    findings = [];
+    initialized = false;
+    constructor() {
+        this.load().catch(err => console.error('[Research] Failed to initialize:', err));
+    }
+    async load() {
+        try {
+            await fs.mkdir(DATA_DIR, { recursive: true });
+            try {
+                const raw = await fs.readFile(REQUESTS_FILE, 'utf-8');
+                for (const line of raw.split('\n').filter(Boolean)) {
+                    try {
+                        const item = JSON.parse(line);
+                        this.requests.set(item.id, item);
+                    }
+                    catch { }
+                }
+            }
+            catch (err) {
+                if (err?.code !== 'ENOENT')
+                    throw err;
+            }
+            try {
+                const raw = await fs.readFile(FINDINGS_FILE, 'utf-8');
+                for (const line of raw.split('\n').filter(Boolean)) {
+                    try {
+                        const item = JSON.parse(line);
+                        this.findings.push(item);
+                    }
+                    catch { }
+                }
+            }
+            catch (err) {
+                if (err?.code !== 'ENOENT')
+                    throw err;
+            }
+            this.findings.sort((a, b) => b.createdAt - a.createdAt);
+        }
+        finally {
+            this.initialized = true;
+        }
+    }
+    async ensureReady() {
+        if (this.initialized)
+            return;
+        await new Promise(resolve => setTimeout(resolve, 50));
+        if (!this.initialized)
+            await this.load();
+    }
+    async persistRequests() {
+        const lines = Array.from(this.requests.values())
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .map(item => JSON.stringify(item));
+        await fs.writeFile(REQUESTS_FILE, lines.join('\n') + (lines.length ? '\n' : ''), 'utf-8');
+    }
+    async persistFindings() {
+        const lines = this.findings
+            .slice()
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .map(item => JSON.stringify(item));
+        await fs.writeFile(FINDINGS_FILE, lines.join('\n') + (lines.length ? '\n' : ''), 'utf-8');
+    }
+    async createRequest(data) {
+        await this.ensureReady();
+        const now = Date.now();
+        const item = {
+            id: `rreq-${now}-${Math.random().toString(36).slice(2, 9)}`,
+            title: data.title,
+            question: data.question,
+            requestedBy: data.requestedBy,
+            owner: data.owner,
+            category: data.category,
+            priority: data.priority,
+            status: data.status || 'open',
+            taskId: data.taskId,
+            dueAt: data.dueAt,
+            metadata: data.metadata,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.requests.set(item.id, item);
+        await this.persistRequests();
+        return item;
+    }
+    async updateRequest(id, updates) {
+        await this.ensureReady();
+        const existing = this.requests.get(id);
+        if (!existing)
+            return undefined;
+        const updated = {
+            ...existing,
+            ...updates,
+            updatedAt: Date.now(),
+        };
+        this.requests.set(id, updated);
+        await this.persistRequests();
+        return updated;
+    }
+    async getRequest(id) {
+        await this.ensureReady();
+        return this.requests.get(id);
+    }
+    async createFinding(data) {
+        await this.ensureReady();
+        const request = this.requests.get(data.requestId);
+        if (!request) {
+            throw new Error('requestId not found');
+        }
+        const now = Date.now();
+        const finding = {
+            id: `rfind-${now}-${Math.random().toString(36).slice(2, 9)}`,
+            requestId: data.requestId,
+            title: data.title,
+            summary: data.summary,
+            author: data.author,
+            confidence: data.confidence,
+            artifactUrl: data.artifactUrl,
+            highlights: data.highlights,
+            metadata: data.metadata,
+            createdAt: now,
+        };
+        this.findings.unshift(finding);
+        await this.persistFindings();
+        if (request.status !== 'answered') {
+            await this.updateRequest(request.id, { status: 'answered' });
+        }
+        return finding;
+    }
+    async listRequests(filters) {
+        await this.ensureReady();
+        let rows = Array.from(this.requests.values());
+        if (filters?.status)
+            rows = rows.filter(r => r.status === filters.status);
+        if (filters?.owner)
+            rows = rows.filter(r => r.owner === filters.owner);
+        if (filters?.category)
+            rows = rows.filter(r => r.category === filters.category);
+        rows.sort((a, b) => {
+            const aDue = a.dueAt || Number.MAX_SAFE_INTEGER;
+            const bDue = b.dueAt || Number.MAX_SAFE_INTEGER;
+            if (aDue !== bDue)
+                return aDue - bDue;
+            return b.updatedAt - a.updatedAt;
+        });
+        if (filters?.limit && filters.limit > 0)
+            rows = rows.slice(0, filters.limit);
+        return rows;
+    }
+    async listFindings(filters) {
+        await this.ensureReady();
+        let rows = this.findings.slice();
+        if (filters?.requestId)
+            rows = rows.filter(f => f.requestId === filters.requestId);
+        if (filters?.author)
+            rows = rows.filter(f => f.author === filters.author);
+        if (filters?.limit && filters.limit > 0)
+            rows = rows.slice(0, filters.limit);
+        return rows;
+    }
+}
+export const researchManager = new ResearchManager();
+//# sourceMappingURL=research.js.map

package/dist/research.js.map

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

package/dist/routing-approvals.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Routing Approvals — explicit queue for router-fed assignment suggestions.
+ *
+ * Tasks enter this queue ONLY when explicitly marked with
+ * metadata.routing_approval=true (set by the routing system).
+ *
+ * This is NOT derived from "all todo tasks." Only router-suggested
+ * assignments appear here.
+ *
+ * Contract:
+ * - metadata.routing_approval: boolean — marks task as needing routing review
+ * - metadata.routing_suggestion: { suggestedAssignee, confidence, reason, alternatives? }
+ * - Approve: sets assignee, stamps approval metadata, clears routing_approval
+ * - Reject: stamps rejection metadata, clears routing_approval, adds rejection state
+ */
+import type { Task } from './types.js';
+export interface RoutingSuggestion {
+    suggestedAssignee: string;
+    confidence: number;
+    reason: string;
+    alternatives?: {
+        agent: string;
+        score: number;
+        reason: string;
+    }[];
+}
+export interface RoutingApprovalMeta {
+    routing_approval: true;
+    routing_suggestion: RoutingSuggestion;
+}
+export interface ApprovalDecision {
+    approvedBy: string;
+    approvedAt: string;
+    decision: 'approved';
+    assignee: string;
+    note?: string;
+}
+export interface RejectionDecision {
+    rejectedBy: string;
+    rejectedAt: string;
+    decision: 'rejected';
+    note?: string;
+}
+export type RoutingDecision = ApprovalDecision | RejectionDecision;
+/**
+ * Filter tasks to only those with explicit routing_approval=true.
+ * This is the ONLY way tasks enter the approvals queue.
+ */
+export declare function getRoutingApprovalQueue(tasks: Task[]): Task[];
+/**
+ * Check if a task is a routing approval candidate.
+ */
+export declare function isRoutingApproval(task: Task): boolean;
+/**
+ * Extract routing suggestion from task metadata.
+ */
+export declare function getRoutingSuggestion(task: Task): RoutingSuggestion | null;
+/**
+ * Build metadata patch for approving a routing suggestion.
+ * Clears routing_approval, stamps auditable approval metadata.
+ */
+export declare function buildApprovalPatch(actor: string, assignee: string, note?: string): Record<string, unknown>;
+/**
+ * Build metadata patch for rejecting a routing suggestion.
+ * Clears routing_approval, stamps auditable rejection, adds suppression flag.
+ */
+export declare function buildRejectionPatch(actor: string, note?: string): Record<string, unknown>;
+/**
+ * Build metadata patch for submitting a routing suggestion (creating an approval).
+ * Called by the routing system when it wants human review of an assignment.
+ */
+export declare function buildRoutingSuggestionPatch(suggestion: RoutingSuggestion): Record<string, unknown>;
+//# sourceMappingURL=routing-approvals.d.ts.map

package/dist/routing-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-approvals.d.ts","sourceRoot":"","sources":["../src/routing-approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAItC,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,IAAI,CAAA;IACtB,kBAAkB,EAAE,iBAAiB,CAAA;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,UAAU,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,UAAU,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAIlE;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAK7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAKzE;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,iBAAiB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/routing-approvals.js

@@ -0,0 +1,88 @@
+/**
+ * Routing Approvals — explicit queue for router-fed assignment suggestions.
+ *
+ * Tasks enter this queue ONLY when explicitly marked with
+ * metadata.routing_approval=true (set by the routing system).
+ *
+ * This is NOT derived from "all todo tasks." Only router-suggested
+ * assignments appear here.
+ *
+ * Contract:
+ * - metadata.routing_approval: boolean — marks task as needing routing review
+ * - metadata.routing_suggestion: { suggestedAssignee, confidence, reason, alternatives? }
+ * - Approve: sets assignee, stamps approval metadata, clears routing_approval
+ * - Reject: stamps rejection metadata, clears routing_approval, adds rejection state
+ */
+// ── Query ────────────────────────────────────────────────────────────
+/**
+ * Filter tasks to only those with explicit routing_approval=true.
+ * This is the ONLY way tasks enter the approvals queue.
+ */
+export function getRoutingApprovalQueue(tasks) {
+    return tasks.filter(t => {
+        const meta = t.metadata;
+        return meta?.routing_approval === true;
+    });
+}
+/**
+ * Check if a task is a routing approval candidate.
+ */
+export function isRoutingApproval(task) {
+    const meta = task.metadata;
+    return meta?.routing_approval === true;
+}
+/**
+ * Extract routing suggestion from task metadata.
+ */
+export function getRoutingSuggestion(task) {
+    const meta = task.metadata;
+    const suggestion = meta?.routing_suggestion;
+    if (!suggestion?.suggestedAssignee)
+        return null;
+    return suggestion;
+}
+// ── Mutations (return metadata patches) ──────────────────────────────
+/**
+ * Build metadata patch for approving a routing suggestion.
+ * Clears routing_approval, stamps auditable approval metadata.
+ */
+export function buildApprovalPatch(actor, assignee, note) {
+    return {
+        routing_approval: false,
+        routing_decision: {
+            approvedBy: actor,
+            approvedAt: new Date().toISOString(),
+            decision: 'approved',
+            assignee,
+            note: note || undefined,
+        },
+    };
+}
+/**
+ * Build metadata patch for rejecting a routing suggestion.
+ * Clears routing_approval, stamps auditable rejection, adds suppression flag.
+ */
+export function buildRejectionPatch(actor, note) {
+    return {
+        routing_approval: false,
+        routing_rejected: true, // suppression flag — prevents reappearance
+        routing_decision: {
+            rejectedBy: actor,
+            rejectedAt: new Date().toISOString(),
+            decision: 'rejected',
+            note: note || undefined,
+        },
+    };
+}
+/**
+ * Build metadata patch for submitting a routing suggestion (creating an approval).
+ * Called by the routing system when it wants human review of an assignment.
+ */
+export function buildRoutingSuggestionPatch(suggestion) {
+    return {
+        routing_approval: true,
+        routing_rejected: false,
+        routing_suggestion: suggestion,
+    };
+}
+//# sourceMappingURL=routing-approvals.js.map

package/dist/routing-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-approvals.js","sourceRoot":"","sources":["../src/routing-approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmCH,wEAAwE;AAExE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,QAA+C,CAAA;QAC9D,OAAO,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,QAA+C,CAAA;IACjE,OAAO,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAU;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,QAA+C,CAAA;IACjE,MAAM,UAAU,GAAG,IAAI,EAAE,kBAAmD,CAAA;IAC5E,IAAI,CAAC,UAAU,EAAE,iBAAiB;QAAE,OAAO,IAAI,CAAA;IAC/C,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,wEAAwE;AAExE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,QAAgB,EAChB,IAAa;IAEb,OAAO;QACL,gBAAgB,EAAE,KAAK;QACvB,gBAAgB,EAAE;YAChB,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,QAAQ,EAAE,UAAU;YACpB,QAAQ;YACR,IAAI,EAAE,IAAI,IAAI,SAAS;SACG;KAC7B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,IAAa;IAEb,OAAO;QACL,gBAAgB,EAAE,KAAK;QACvB,gBAAgB,EAAE,IAAI,EAAG,2CAA2C;QACpE,gBAAgB,EAAE;YAChB,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,IAAI,IAAI,SAAS;SACI;KAC9B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA6B;IAE7B,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,KAAK;QACvB,kBAAkB,EAAE,UAAU;KAC/B,CAAA;AACH,CAAC"}