reflectt-node 0.1.0

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAExF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE;QACR,MAAM,EAAE,mBAAmB,CAAA;QAC3B,MAAM,EAAE,mBAAmB,CAAA;QAC3B,SAAS,EAAE,mBAAmB,CAAA;QAC9B,MAAM,EAAE,mBAAmB,CAAA;QAC3B,UAAU,EAAE,mBAAmB,CAAA;QAC/B,SAAS,EAAE,mBAAmB,CAAA;KAC/B,CAAA;IACD,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAwCD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsCxB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiF9D"}

package/dist/doctor.js

@@ -0,0 +1,159 @@
+// SPDX-License-Identifier: Apache-2.0
+// Doctor CLI support — collect onboarding diagnostics via HTTP endpoints.
+async function getJson(fetchFn, baseUrl, path, timeoutMs) {
+    const started = Date.now();
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchFn(`${baseUrl}${path}`, {
+            method: 'GET',
+            headers: { accept: 'application/json' },
+            signal: controller.signal,
+        });
+        const ms = Date.now() - started;
+        const json = await res.json().catch(() => null);
+        if (!res.ok) {
+            const errMsg = (json && (json.error || json.message))
+                ? String(json.error || json.message)
+                : `HTTP ${res.status}`;
+            return {
+                ok: false,
+                status: res.status,
+                ms,
+                error: errMsg,
+                data: json,
+            };
+        }
+        return { ok: true, status: res.status, ms, data: json };
+    }
+    catch (err) {
+        const ms = Date.now() - started;
+        return { ok: false, ms, error: err?.name === 'AbortError' ? `timeout after ${timeoutMs}ms` : String(err?.message || err) };
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+export async function collectDoctorReport(input) {
+    const baseUrl = input.baseUrl.replace(/\/+$/, '');
+    const timeoutMs = input.timeoutMs ?? 4000;
+    const fetchFn = input.fetchFn ?? fetch;
+    const [health, system, execution, policy, teamDoctor, preflight] = await Promise.all([
+        getJson(fetchFn, baseUrl, '/health', timeoutMs),
+        getJson(fetchFn, baseUrl, '/health/system', timeoutMs),
+        getJson(fetchFn, baseUrl, '/execution-health', timeoutMs),
+        getJson(fetchFn, baseUrl, '/policy', timeoutMs),
+        getJson(fetchFn, baseUrl, '/health/team/doctor', timeoutMs),
+        getJson(fetchFn, baseUrl, '/preflight', timeoutMs),
+    ]);
+    const sections = { health, system, execution, policy, teamDoctor, preflight };
+    const teamOverall = teamDoctor.ok ? teamDoctor.data?.overall : undefined;
+    const hardFail = Object.values(sections).some(s => !s.ok) || teamOverall === 'fail';
+    const hasWarn = !hardFail && teamOverall === 'warn';
+    const overall = hardFail ? 'fail' : hasWarn ? 'warn' : 'pass';
+    const ok = overall !== 'fail';
+    const hints = [];
+    if (!health.ok)
+        hints.push('Server not reachable: ensure reflectt-node is running (try `reflectt start`), and check host/port in ~/.reflectt/config.json');
+    if (teamDoctor.ok && teamOverall === 'fail')
+        hints.push('Team doctor reports failures — fix the first failing check and re-run `reflectt doctor`');
+    if (teamDoctor.ok && teamOverall === 'warn')
+        hints.push('Team doctor reports warnings — fix warnings to improve reliability and re-run `reflectt doctor`');
+    if (execution.ok && execution.data?.sweeper?.running === false)
+        hints.push('Execution sweeper is not running — validating queue may not be enforced');
+    if (preflight.ok && preflight.data?.allPassed === false)
+        hints.push('Preflight checks failing — run `curl -s /preflight | jq` and fix failing checks before onboarding users');
+    return {
+        baseUrl,
+        timestamp: Date.now(),
+        overall,
+        ok,
+        sections,
+        hints,
+    };
+}
+export function formatDoctorHuman(report) {
+    const lines = [];
+    const label = report.overall === 'pass' ? 'PASS' : report.overall === 'warn' ? 'WARN' : 'FAIL';
+    lines.push(`reflectt doctor — ${label}`);
+    lines.push(`baseUrl: ${report.baseUrl}`);
+    lines.push(`timestamp: ${new Date(report.timestamp).toISOString()}`);
+    lines.push('');
+    function section(name, title, pick) {
+        const s = report.sections[name];
+        const head = `${s.ok ? '✅' : '❌'} ${title}${s.status ? ` (HTTP ${s.status})` : ''}${typeof s.ms === 'number' ? ` — ${s.ms}ms` : ''}`;
+        lines.push(head);
+        if (!s.ok) {
+            if (s.error)
+                lines.push(`   error: ${s.error}`);
+            return;
+        }
+        try {
+            const detail = pick ? pick(s.data) : '';
+            if (detail)
+                lines.push(`   ${detail}`);
+        }
+        catch {
+            // ignore formatting errors
+        }
+    }
+    section('health', '/health', (d) => `status=${d?.status ?? 'unknown'} version=${d?.version ?? 'n/a'} commit=${d?.commit ?? 'n/a'}`);
+    section('system', '/health/system', (d) => {
+        const uptimeH = d?.uptimeHours ?? d?.uptime_hours;
+        const req = d?.requestCount ?? d?.request_count;
+        const errRate = d?.errorRate ?? d?.error_rate;
+        return `uptimeHours=${uptimeH ?? 'n/a'} requestCount=${req ?? 'n/a'} errorRate=${errRate ?? 'n/a'}%`;
+    });
+    section('execution', '/execution-health', (d) => {
+        const running = d?.sweeper?.running;
+        const last = d?.sweeper?.lastSweepAt;
+        const v = Array.isArray(d?.current?.violations) ? d.current.violations.length : 'n/a';
+        return `sweeper.running=${String(running)} lastSweepAt=${last ?? 'n/a'} violations=${v}`;
+    });
+    section('policy', '/policy', (d) => {
+        const qh = d?.policy?.quietHours;
+        const enabled = qh?.enabled;
+        const window = (qh && typeof qh.startHour === 'number' && typeof qh.endHour === 'number') ? `${qh.startHour}-${qh.endHour}` : 'n/a';
+        return `quietHours.enabled=${String(enabled)} window=${window}`;
+    });
+    section('teamDoctor', '/health/team/doctor', (d) => {
+        const overall = d?.overall;
+        const fails = Array.isArray(d?.checks) ? d.checks.filter((c) => c?.status === 'fail').map((c) => c?.name).filter(Boolean) : [];
+        const warns = Array.isArray(d?.checks) ? d.checks.filter((c) => c?.status === 'warn').map((c) => c?.name).filter(Boolean) : [];
+        const parts = [`overall=${overall ?? 'n/a'}`];
+        if (fails.length)
+            parts.push(`fails=${fails.join(',')}`);
+        if (warns.length)
+            parts.push(`warns=${warns.join(',')}`);
+        return parts.join(' ');
+    });
+    section('preflight', '/preflight', (d) => {
+        // /preflight returns { success, allPassed, results[] }
+        const allPassed = d?.allPassed;
+        const results = Array.isArray(d?.results) ? d.results : [];
+        const failing = results.filter((r) => r && r.passed === false);
+        const failCount = failing.length;
+        const failIds = failing.map((r) => r?.check?.id).filter(Boolean);
+        const parts = [`allPassed=${String(allPassed)}`];
+        parts.push(`failCount=${failCount}`);
+        if (failIds.length)
+            parts.push(`fails=${failIds.join(',')}`);
+        return parts.join(' ');
+    });
+    if (report.hints.length) {
+        lines.push('');
+        lines.push('Hints:');
+        for (const h of report.hints)
+            lines.push(`- ${h}`);
+    }
+    lines.push('');
+    lines.push('Copy/paste support bundle:');
+    lines.push(`curl -s ${report.baseUrl}/health | jq`);
+    lines.push(`curl -s ${report.baseUrl}/health/system | jq`);
+    lines.push(`curl -s ${report.baseUrl}/execution-health | jq`);
+    lines.push(`curl -s ${report.baseUrl}/policy | jq`);
+    lines.push(`curl -s ${report.baseUrl}/health/team/doctor | jq`);
+    lines.push(`curl -s ${report.baseUrl}/preflight | jq`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/duplicateClosureGuard.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Duplicate-closure canonical reference enforcement.
+ *
+ * Why: Auto-close writers (sweeper/automerge/server) can close tasks without
+ * going through interactive precheck flows. If a task is closed as a
+ * "duplicate" without canonical refs, reviewers get churny N/A proof packets.
+ */
+export type DuplicateClosureMeta = Record<string, unknown>;
+export declare function isDuplicateClosure(meta: DuplicateClosureMeta | null | undefined): boolean;
+/**
+ * Throws if a task is being closed as a duplicate without canonical proof.
+ *
+ * Intended acceptance rule (2026-02-26):
+ * - metadata.duplicate_of must be a canonical task id (must start with "task-")
+ * - metadata.duplicate_proof (or duplicate_of.proof) must be present and not "N/A"
+ * - AND at least one of:
+ *   - metadata.canonical_pr (GitHub PR URL) OR
+ *   - metadata.canonical_commit (>=7 hex)
+ *
+ * Fallbacks allowed:
+ * - PR/commit may also come from metadata.review_handoff.{pr_url,commit_sha} or metadata.pr_url
+ *
+ * Note: we do NOT require both PR+commit.
+ */
+export declare function assertDuplicateClosureHasCanonicalRefs(meta: DuplicateClosureMeta | null | undefined): void;
+/**
+ * Convenience helper for auto-close writers: returns a human-readable reason
+ * when canonical refs are missing for a duplicate closure.
+ */
+export declare function getDuplicateClosureCanonicalRefError(meta: DuplicateClosureMeta | null | undefined): string | null;
+//# sourceMappingURL=duplicateClosureGuard.d.ts.map

package/dist/duplicateClosureGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateClosureGuard.d.ts","sourceRoot":"","sources":["../src/duplicateClosureGuard.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAqBzF;AAaD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CA0C1G;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOjH"}

package/dist/duplicateClosureGuard.js

@@ -0,0 +1,83 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+export function isDuplicateClosure(meta) {
+    if (!meta)
+        return false;
+    const autoCloseReason = meta.auto_close_reason;
+    const hasDupeReason = typeof autoCloseReason === 'string' && autoCloseReason.toLowerCase().includes('duplicate');
+    const hasDupeOf = Boolean(meta.duplicate_of);
+    const lane = meta.qa_bundle?.lane;
+    const hasDupeLane = typeof lane === 'string' && lane === 'duplicate-closure';
+    // Some older flows only record duplicates in artifacts (e.g., "duplicate:task-...")
+    const artifacts = meta.artifacts;
+    const hasDupeArtifact = Array.isArray(artifacts) && artifacts.some(a => typeof a === 'string' && a.startsWith('duplicate:'));
+    // Future-proof: allow explicit resolution/outcome flags.
+    const outcome = meta.outcome;
+    const resolution = meta.resolution;
+    const hasDupeOutcome = outcome === 'duplicate' || resolution === 'duplicate';
+    return hasDupeReason || hasDupeOf || hasDupeLane || hasDupeArtifact || hasDupeOutcome;
+}
+function firstString(...candidates) {
+    for (const c of candidates) {
+        if (typeof c === 'string' && c.trim().length > 0)
+            return c.trim();
+    }
+    return null;
+}
+function isHttpUrl(s) {
+    return typeof s === 'string' && (s.startsWith('http://') || s.startsWith('https://'));
+}
+/**
+ * Throws if a task is being closed as a duplicate without canonical proof.
+ *
+ * Intended acceptance rule (2026-02-26):
+ * - metadata.duplicate_of must be a canonical task id (must start with "task-")
+ * - metadata.duplicate_proof (or duplicate_of.proof) must be present and not "N/A"
+ * - AND at least one of:
+ *   - metadata.canonical_pr (GitHub PR URL) OR
+ *   - metadata.canonical_commit (>=7 hex)
+ *
+ * Fallbacks allowed:
+ * - PR/commit may also come from metadata.review_handoff.{pr_url,commit_sha} or metadata.pr_url
+ *
+ * Note: we do NOT require both PR+commit.
+ */
+export function assertDuplicateClosureHasCanonicalRefs(meta) {
+    if (!isDuplicateClosure(meta))
+        return;
+    const m = (meta || {});
+    const dupeOfId = firstString(m.duplicate_of, m.duplicateOf, m.duplicate_of?.task_id, m.duplicateOf?.task_id);
+    if (!dupeOfId) {
+        throw new Error('Duplicate closure requires metadata.duplicate_of (canonical task id)');
+    }
+    if (!/^task-/.test(dupeOfId)) {
+        throw new Error('Duplicate closure requires metadata.duplicate_of to be a canonical task id (must start with "task-")');
+    }
+    const proof = firstString(m.duplicate_proof, m.duplicateProof, m.duplicate_of?.proof, m.duplicateOf?.proof, m.duplicate_of_proof);
+    if (!proof || /^n\/?a$/i.test(proof.trim())) {
+        throw new Error('Duplicate closure requires metadata.duplicate_proof (non-empty, not "N/A")');
+    }
+    const canonicalPr = firstString(m.canonical_pr, m.canonicalPr, m.review_handoff?.pr_url, m.pr_url);
+    const canonicalCommit = firstString(m.canonical_commit, m.canonicalCommit, m.review_handoff?.commit_sha);
+    const hasPr = isHttpUrl(canonicalPr);
+    const hasCommit = typeof canonicalCommit === 'string'
+        && canonicalCommit.length >= 7
+        && /^[0-9a-f]+$/i.test(canonicalCommit);
+    if (!hasPr && !hasCommit) {
+        throw new Error('Duplicate closure requires canonical_pr (PR URL) or canonical_commit (>=7 hex)');
+    }
+}
+/**
+ * Convenience helper for auto-close writers: returns a human-readable reason
+ * when canonical refs are missing for a duplicate closure.
+ */
+export function getDuplicateClosureCanonicalRefError(meta) {
+    try {
+        assertDuplicateClosureHasCanonicalRefs(meta);
+        return null;
+    }
+    catch (err) {
+        return err?.message || 'Duplicate closure missing canonical refs';
+    }
+}
+//# sourceMappingURL=duplicateClosureGuard.js.map

package/dist/duplicateClosureGuard.js.map

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

package/dist/embeddings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Embed a single text into a normalized float32 vector.
+ * Model is lazily downloaded/loaded on first call.
+ */
+export declare function embed(text: string): Promise<Float32Array>;
+/**
+ * Embed a batch of texts into normalized float32 vectors.
+ * Preserves input order.
+ */
+export declare function embedBatch(texts: string[]): Promise<Float32Array[]>;
+export declare function embeddingModelId(): string;
+export declare function resetEmbeddingCacheForTests(): void;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AA0CA;;;GAGG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ/D;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwBzE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/embeddings.js

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+import { pipeline } from '@xenova/transformers';
+const DEFAULT_MODEL = process.env.REFLECTT_EMBED_MODEL || 'Xenova/all-MiniLM-L6-v2';
+let extractorPromise = null;
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+async function getExtractor() {
+    if (!extractorPromise) {
+        extractorPromise = pipeline('feature-extraction', DEFAULT_MODEL);
+    }
+    return extractorPromise;
+}
+function toFloat32Array(value) {
+    if (value instanceof Float32Array)
+        return value;
+    if (Array.isArray(value)) {
+        // Handle [[...]] or [...] cases
+        if (value.length > 0 && Array.isArray(value[0])) {
+            return new Float32Array(value[0].map(Number));
+        }
+        return new Float32Array(value.map(Number));
+    }
+    if (value && typeof value === 'object') {
+        const maybeData = value.data;
+        if (maybeData instanceof Float32Array)
+            return maybeData;
+        if (Array.isArray(maybeData))
+            return new Float32Array(maybeData.map(Number));
+    }
+    throw new Error('Unexpected embedding output shape');
+}
+/**
+ * Embed a single text into a normalized float32 vector.
+ * Model is lazily downloaded/loaded on first call.
+ */
+export async function embed(text) {
+    if (!isNonEmptyString(text)) {
+        throw new Error('embed(text): text is required');
+    }
+    const extractor = await getExtractor();
+    const out = await extractor(text, { pooling: 'mean', normalize: true });
+    return toFloat32Array(out);
+}
+/**
+ * Embed a batch of texts into normalized float32 vectors.
+ * Preserves input order.
+ */
+export async function embedBatch(texts) {
+    if (!Array.isArray(texts) || texts.length === 0)
+        return [];
+    if (texts.some((t) => !isNonEmptyString(t))) {
+        throw new Error('embedBatch(texts): all texts must be non-empty strings');
+    }
+    const extractor = await getExtractor();
+    const out = await extractor(texts, { pooling: 'mean', normalize: true });
+    if (Array.isArray(out)) {
+        return out.map(toFloat32Array);
+    }
+    // Some runtimes may return a tensor-like object with nested lists in `tolist`
+    const maybeToList = out?.tolist;
+    if (typeof maybeToList === 'function') {
+        const asList = maybeToList.call(out);
+        if (Array.isArray(asList)) {
+            return asList.map((row) => toFloat32Array(row));
+        }
+    }
+    // Fallback: if a single tensor comes back for one item, normalize to batch shape.
+    return [toFloat32Array(out)];
+}
+export function embeddingModelId() {
+    return DEFAULT_MODEL;
+}
+export function resetEmbeddingCacheForTests() {
+    extractorPromise = null;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

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

package/dist/escalation.d.ts

@@ -0,0 +1,80 @@
+import { type SupportTier } from './feedback.js';
+export type EscalationLevel = 'owner_alert' | 'ack_missed' | 'manager_escalation' | 'exec_escalation';
+export type EscalationStatus = 'active' | 'acknowledged' | 'resolved' | 'escalated';
+export interface EscalationRecord {
+    id: string;
+    feedbackId: string;
+    priority: string;
+    tier: SupportTier;
+    status: EscalationStatus;
+    /** Who should own this incident */
+    owner: string;
+    /** Current escalation level */
+    level: EscalationLevel;
+    /** When the escalation was created */
+    createdAt: number;
+    /** When owner acknowledged (undefined = not yet) */
+    acknowledgedAt?: number;
+    /** Ack deadline (createdAt + ackWindowMs) */
+    ackDeadlineAt: number;
+    /** Alert history */
+    alerts: EscalationAlert[];
+    /** Last time we checked/ticked this escalation */
+    lastTickAt: number;
+}
+export interface EscalationAlert {
+    level: EscalationLevel;
+    target: string;
+    message: string;
+    sentAt: number;
+}
+/** Ack window by priority — how long before escalating on no-ack */
+declare const ACK_WINDOW_MS: Record<string, number>;
+/** Escalation chain: level → next level */
+declare const ESCALATION_CHAIN: Record<EscalationLevel, EscalationLevel | null>;
+/** Time between escalation levels (after missed ack) */
+declare const ESCALATION_INTERVAL_MS: Record<string, number>;
+/** Default escalation targets by level */
+declare const DEFAULT_TARGETS: Record<EscalationLevel, string>;
+/**
+ * Set the alert delivery function. Called whenever an alert fires.
+ * Default is no-op (logs silently). Wire this to chatManager, webhooks, etc.
+ * Wraps the sink with alert-preflight guard.
+ */
+export declare function setAlertSink(sink: (alert: EscalationAlert, record: EscalationRecord) => void): void;
+/**
+ * Create a new escalation for a P0/P1 feedback item.
+ * Returns null if priority is not P0/P1 or escalation already exists.
+ */
+export declare function createEscalation(feedbackId: string, priority: string, tier: SupportTier, owner?: string): EscalationRecord | null;
+/**
+ * Acknowledge an escalation. Stops the ack timer.
+ */
+export declare function acknowledgeEscalation(escalationId: string, actor?: string): EscalationRecord | null;
+/**
+ * Resolve an escalation (incident handled).
+ */
+export declare function resolveEscalation(escalationId: string): EscalationRecord | null;
+/**
+ * Tick all active escalations — checks ack timers and triggers escalation chain.
+ * Call this periodically (e.g. every 60s from a watchdog/sweeper).
+ */
+export declare function tickEscalations(now?: number): EscalationTickResult;
+export interface EscalationTickResult {
+    checked: number;
+    escalated: number;
+    alerts: EscalationAlert[];
+}
+export declare function getEscalation(id: string): EscalationRecord | undefined;
+export declare function getEscalationByFeedback(feedbackId: string): EscalationRecord | undefined;
+export interface EscalationSummary {
+    active: number;
+    acknowledged: number;
+    escalated: number;
+    resolved: number;
+    items: EscalationRecord[];
+}
+export declare function listEscalations(status?: EscalationStatus): EscalationSummary;
+export declare function _clearEscalationStore(): void;
+export { ACK_WINDOW_MS, ESCALATION_CHAIN, ESCALATION_INTERVAL_MS, DEFAULT_TARGETS };
+//# sourceMappingURL=escalation.d.ts.map

package/dist/escalation.d.ts.map

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