@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/multimodal-vision.d.ts

@@ -0,0 +1,38 @@
+export interface VisionEntity {
+    id: string;
+    sourcePath: string;
+    hash: string;
+    capturedAt: string;
+    description: string;
+    ocr?: string;
+    tags: string[];
+    project: string;
+    embedding?: number[];
+}
+export declare class MultimodalVision {
+    private ollamaModel;
+    private ollamaBaseUrl;
+    private initialized;
+    init(): Promise<void>;
+    /** Ingest an image file. Returns the persisted VisionEntity. */
+    ingestImage(filePath: string, opts?: {
+        project?: string;
+        tags?: string[];
+        prompt?: string;
+    }): Promise<VisionEntity>;
+    /** Semantic search across stored image descriptions. */
+    search(query: string, topK?: number, project?: string): Promise<VisionEntity[]>;
+    /** Recent ingests, newest first. */
+    recent(limit?: number, project?: string): Promise<VisionEntity[]>;
+    /** True if a vision model was detected. */
+    hasVisionModel(): boolean;
+    private describe;
+    private appendIndex;
+    private loadAll;
+}
+/** OCR stub. TODO: wire up tesseract.js or system tesseract for real OCR.
+ *  Returns null today; vision model + description handles text most of the time. */
+export declare function ocrExtract(_filePath: string): Promise<string | null>;
+export declare function getMultimodalVision(): MultimodalVision;
+export declare function resetMultimodalVisionForTests(): void;
+//# sourceMappingURL=multimodal-vision.d.ts.map

package/dist/brain/multimodal-vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal-vision.d.ts","sourceRoot":"","sources":["../../src/brain/multimodal-vision.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAOD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,gEAAgE;IAC1D,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,YAAY,CAAC;IAoDxB,wDAAwD;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuBjF,oCAAoC;IAC9B,MAAM,CAAC,KAAK,SAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAOnE,2CAA2C;IAC3C,cAAc,IAAI,OAAO;YAIX,QAAQ;IA4BtB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,OAAO;CAyBhB;AAED;oFACoF;AACpF,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI1E;AAkBD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AACD,wBAAgB,6BAA6B,IAAI,IAAI,CAAsB"}

package/dist/brain/multimodal-vision.js

@@ -0,0 +1,257 @@
+// src/brain/multimodal-vision.ts — Image ingestion via Ollama llava
+// v6.0.2 — Multimodal Edition
+//
+// Adds image understanding to the brain. Uses Ollama llava (or llava-llama3 /
+// bakllava — probed in priority order). Falls through gracefully if no
+// vision model is available: the image is registered but undescribed.
+//
+// Storage layout:
+//   ~/.shadow-brain/vision/<project>/<hash>.json   — metadata (path + desc)
+//   ~/.shadow-brain/vision/<project>/index.json    — flat index for search
+//
+// The actual image is NOT copied — it stays at sourcePath. The brain holds
+// only the path, hash, description, and (optional) embedding.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getEmbeddings } from './embeddings.js';
+import { getModelRegistry } from './model-registry.js';
+const VISION_DIR = path.join(os.homedir(), '.shadow-brain', 'vision');
+const PREFERRED_MODELS = ['llava', 'llava-llama3', 'bakllava'];
+const DEFAULT_PROMPT = 'Describe this image in detail. Focus on UI elements, text, code, ' +
+    'diagrams. Use plain factual language.';
+export class MultimodalVision {
+    constructor() {
+        this.ollamaModel = null;
+        this.ollamaBaseUrl = 'http://127.0.0.1:11434';
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(VISION_DIR, { recursive: true });
+        try {
+            const reg = getModelRegistry();
+            await reg.init();
+            const ollama = reg.getProvider('ollama');
+            if (ollama?.enabled) {
+                this.ollamaBaseUrl = ollama.baseUrl;
+                const res = await fetch(this.ollamaBaseUrl + '/api/tags', {
+                    signal: AbortSignal.timeout(2000),
+                });
+                if (res.ok) {
+                    const json = (await res.json());
+                    for (const pref of PREFERRED_MODELS) {
+                        const match = json.models?.find(m => m.name.startsWith(pref));
+                        if (match) {
+                            this.ollamaModel = match.name;
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        catch { /* no ollama — graceful */ }
+        this.initialized = true;
+    }
+    /** Ingest an image file. Returns the persisted VisionEntity. */
+    async ingestImage(filePath, opts) {
+        await this.init();
+        const absPath = path.resolve(filePath);
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`Image file not found: ${absPath}`);
+        }
+        const buf = fs.readFileSync(absPath);
+        const hash = crypto.createHash('sha256').update(buf).digest('hex').slice(0, 16);
+        const project = (opts?.project || 'default').replace(/[^a-zA-Z0-9._-]/g, '_');
+        const projectDir = path.join(VISION_DIR, project);
+        fs.mkdirSync(projectDir, { recursive: true });
+        // De-dupe by hash within project
+        const metaPath = path.join(projectDir, `${hash}.json`);
+        if (fs.existsSync(metaPath)) {
+            try {
+                return JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            }
+            catch { /* re-ingest */ }
+        }
+        const prompt = opts?.prompt || DEFAULT_PROMPT;
+        const description = await this.describe(buf, prompt);
+        const ocr = await ocrExtract(absPath);
+        const tags = (opts?.tags || []).slice(0, 32);
+        let embedding;
+        try {
+            const e = getEmbeddings();
+            embedding = await e.embed(description + ' ' + (ocr || '') + ' ' + tags.join(' '));
+        }
+        catch { /* embedding optional */ }
+        const entity = {
+            id: `vision_${hash}`,
+            sourcePath: absPath,
+            hash,
+            capturedAt: new Date().toISOString(),
+            description,
+            ocr: ocr || undefined,
+            tags,
+            project,
+            embedding,
+        };
+        try {
+            fs.writeFileSync(metaPath, JSON.stringify(entity, null, 2));
+            this.appendIndex(projectDir, entity);
+        }
+        catch { /* non-fatal */ }
+        return entity;
+    }
+    /** Semantic search across stored image descriptions. */
+    async search(query, topK = 10, project) {
+        await this.init();
+        const all = this.loadAll(project);
+        if (all.length === 0)
+            return [];
+        try {
+            const e = getEmbeddings();
+            const qVec = await e.embed(query);
+            const scored = all.map(ent => {
+                const v = ent.embedding;
+                const score = v ? cosine(qVec, v) : keywordScore(ent, query);
+                return { ent, score };
+            });
+            scored.sort((a, b) => b.score - a.score);
+            return scored.slice(0, topK).map(s => s.ent);
+        }
+        catch {
+            // Fallback to keyword scoring on description + tags + ocr
+            const scored = all.map(ent => ({ ent, score: keywordScore(ent, query) }));
+            scored.sort((a, b) => b.score - a.score);
+            return scored.slice(0, topK).map(s => s.ent);
+        }
+    }
+    /** Recent ingests, newest first. */
+    async recent(limit = 20, project) {
+        await this.init();
+        const all = this.loadAll(project);
+        all.sort((a, b) => b.capturedAt.localeCompare(a.capturedAt));
+        return all.slice(0, limit);
+    }
+    /** True if a vision model was detected. */
+    hasVisionModel() { return this.ollamaModel !== null; }
+    // ── Internals ────────────────────────────────────────────────────────
+    async describe(imageBuf, prompt) {
+        if (!this.ollamaModel) {
+            return '[vision model not available — image registered but undescribed]';
+        }
+        try {
+            const b64 = imageBuf.toString('base64');
+            const res = await fetch(this.ollamaBaseUrl + '/api/generate', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.ollamaModel,
+                    prompt,
+                    images: [b64],
+                    stream: false,
+                }),
+                signal: AbortSignal.timeout(120000),
+            });
+            if (!res.ok) {
+                return '[vision model error — image registered but undescribed]';
+            }
+            const json = (await res.json());
+            const text = (json.response || '').trim();
+            return text || '[vision model returned empty description]';
+        }
+        catch {
+            return '[vision model unreachable — image registered but undescribed]';
+        }
+    }
+    appendIndex(projectDir, entity) {
+        const indexPath = path.join(projectDir, 'index.json');
+        let idx = { schemaVersion: 1, entries: [] };
+        if (fs.existsSync(indexPath)) {
+            try {
+                idx = JSON.parse(fs.readFileSync(indexPath, 'utf-8'));
+            }
+            catch { /* reset */ }
+        }
+        if (!idx.entries.some(e => e.hash === entity.hash)) {
+            idx.entries.push({
+                id: entity.id,
+                hash: entity.hash,
+                capturedAt: entity.capturedAt,
+                tags: entity.tags,
+            });
+        }
+        const tmp = indexPath + '.tmp';
+        fs.writeFileSync(tmp, JSON.stringify(idx, null, 2));
+        fs.renameSync(tmp, indexPath);
+    }
+    loadAll(project) {
+        if (!fs.existsSync(VISION_DIR))
+            return [];
+        const projects = project
+            ? [project.replace(/[^a-zA-Z0-9._-]/g, '_')]
+            : fs.readdirSync(VISION_DIR).filter(d => {
+                try {
+                    return fs.statSync(path.join(VISION_DIR, d)).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            });
+        const out = [];
+        for (const p of projects) {
+            const dir = path.join(VISION_DIR, p);
+            if (!fs.existsSync(dir))
+                continue;
+            let files = [];
+            try {
+                files = fs.readdirSync(dir);
+            }
+            catch {
+                continue;
+            }
+            for (const f of files) {
+                if (!f.endsWith('.json') || f === 'index.json')
+                    continue;
+                try {
+                    const raw = fs.readFileSync(path.join(dir, f), 'utf-8');
+                    out.push(JSON.parse(raw));
+                }
+                catch { /* skip */ }
+            }
+        }
+        return out;
+    }
+}
+/** OCR stub. TODO: wire up tesseract.js or system tesseract for real OCR.
+ *  Returns null today; vision model + description handles text most of the time. */
+export async function ocrExtract(_filePath) {
+    // TODO: integrate tesseract.js (pure JS) or shell out to `tesseract` CLI
+    // when available. Kept as a stub to avoid pulling a heavy dependency.
+    return null;
+}
+function cosine(a, b) {
+    let dot = 0;
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i++)
+        dot += a[i] * b[i];
+    return dot;
+}
+function keywordScore(ent, query) {
+    const q = query.toLowerCase().split(/\s+/).filter(t => t.length > 1);
+    const hay = (ent.description + ' ' + (ent.ocr || '') + ' ' + ent.tags.join(' ')).toLowerCase();
+    let score = 0;
+    for (const t of q)
+        if (hay.includes(t))
+            score += 1;
+    return score / Math.max(q.length, 1);
+}
+let _instance = null;
+export function getMultimodalVision() {
+    if (!_instance)
+        _instance = new MultimodalVision();
+    return _instance;
+}
+export function resetMultimodalVisionForTests() { _instance = null; }
+//# sourceMappingURL=multimodal-vision.js.map

package/dist/brain/multimodal-vision.js.map

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

package/dist/brain/orchestrator.js

@@ -780,7 +780,7 @@ export class Orchestrator extends EventEmitter {
     getStatus() {
         return {
             running: this.running,
-            version: '5.1.1',
+            version: '6.0.0',
             agents: this.adapters.map(a => `${a.displayName} (${a.name})`),
             insightsGenerated: this.currentSession?.insights.length || 0,
             filesReviewed: this.currentSession?.filesReviewed || 0,

package/dist/brain/otel-lite.d.ts

@@ -0,0 +1,71 @@
+export type SpanStatusCode = 'UNSET' | 'OK' | 'ERROR';
+export interface SpanEvent {
+    name: string;
+    time_ns: number;
+    attributes?: Record<string, unknown>;
+}
+export interface TraceLine {
+    trace_id: string;
+    span_id: string;
+    parent_span_id?: string;
+    name: string;
+    tracer_name: string;
+    start_ns: number;
+    end_ns: number;
+    attributes: Record<string, unknown>;
+    events: SpanEvent[];
+    status: {
+        code: SpanStatusCode;
+        message?: string;
+    };
+}
+export interface SpanOptions {
+    attributes?: Record<string, unknown>;
+    parent?: Span;
+}
+export declare class Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly name: string;
+    readonly tracerName: string;
+    readonly startNs: number;
+    private endNs;
+    private ended;
+    private attrs;
+    private events;
+    private status;
+    private tracer;
+    constructor(tracer: Tracer, name: string, opts?: SpanOptions);
+    setAttribute(key: string, value: unknown): this;
+    addEvent(name: string, attributes?: Record<string, unknown>): this;
+    recordException(err: unknown): this;
+    setStatus(code: SpanStatusCode, message?: string): this;
+    end(): void;
+    private toLine;
+}
+export declare class Tracer {
+    readonly name: string;
+    private sampleRate;
+    private lastRotation;
+    constructor(name: string);
+    startSpan(name: string, opts?: SpanOptions): Span;
+    /** Auto begin/end around an async function. */
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, opts?: SpanOptions): Promise<T>;
+    /** Set sample rate 0-1. 1 = emit all spans, 0 = drop all. */
+    sample(rate: number): void;
+    /** Internal: write a line. Sampling + rotation handled here. */
+    emitSpan(line: TraceLine): void;
+    private cleanupOldFiles;
+}
+export declare function trace(name: string): Tracer;
+export declare const OtelLite: {
+    trace: typeof trace;
+    /** Read the tail of today's trace file. Returns parsed TraceLines, newest last. */
+    tail(lines?: number): Promise<TraceLine[]>;
+    /** Path of today's trace file (whether or not it exists yet). */
+    todayFilePath(): string;
+    /** Manually trigger retention cleanup. */
+    cleanup(): void;
+};
+//# sourceMappingURL=otel-lite.d.ts.map

package/dist/brain/otel-lite.d.ts.map

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

package/dist/brain/otel-lite.js

@@ -0,0 +1,232 @@
+// src/brain/otel-lite.ts — Zero-dep OpenTelemetry-compatible JSONL tracer
+// v6.0.2 — Multimodal Edition
+//
+// Stand-in for real OpenTelemetry. Emits JSONL spans that match OTel's
+// "Compatible JSONL exporter" shape so users can pipe the file into a real
+// OTel collector later. Zero dependencies.
+//
+// Storage:
+//   ~/.shadow-brain/traces/<YYYY-MM-DD>.jsonl
+//   Daily rotation, retains last 14 days, drops older silently.
+//
+// Usage:
+//   const tracer = trace('shadow-brain');
+//   const span = tracer.startSpan('brain.recall', { attributes: { project } });
+//   span.setAttribute('query', q); span.addEvent('cache.miss');
+//   try { ... } catch (e) { span.recordException(e); throw e; }
+//   span.end();
+//
+//   await tracer.withSpan('embed', async () => { ... }); // auto begin/end
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+const TRACE_DIR = path.join(os.homedir(), '.shadow-brain', 'traces');
+const RETENTION_DAYS = 14;
+export class Span {
+    constructor(tracer, name, opts) {
+        this.endNs = 0;
+        this.ended = false;
+        this.attrs = {};
+        this.events = [];
+        this.status = { code: 'UNSET' };
+        this.tracer = tracer;
+        this.name = name;
+        this.tracerName = tracer.name;
+        this.traceId = opts?.parent?.traceId || randomHex(32);
+        this.spanId = randomHex(16);
+        this.parentSpanId = opts?.parent?.spanId;
+        this.startNs = nowNs();
+        if (opts?.attributes)
+            for (const [k, v] of Object.entries(opts.attributes))
+                this.attrs[k] = v;
+    }
+    setAttribute(key, value) {
+        if (!this.ended)
+            this.attrs[key] = value;
+        return this;
+    }
+    addEvent(name, attributes) {
+        if (!this.ended)
+            this.events.push({ name, time_ns: nowNs(), attributes });
+        return this;
+    }
+    recordException(err) {
+        if (this.ended)
+            return this;
+        const e = err instanceof Error ? err : new Error(String(err));
+        this.events.push({
+            name: 'exception',
+            time_ns: nowNs(),
+            attributes: {
+                'exception.type': e.name,
+                'exception.message': e.message,
+                'exception.stacktrace': e.stack || '',
+            },
+        });
+        this.status = { code: 'ERROR', message: e.message };
+        return this;
+    }
+    setStatus(code, message) {
+        if (!this.ended)
+            this.status = { code, message };
+        return this;
+    }
+    end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        this.endNs = nowNs();
+        try {
+            this.tracer.emitSpan(this.toLine());
+        }
+        catch { /* never throw */ }
+    }
+    toLine() {
+        return {
+            trace_id: this.traceId,
+            span_id: this.spanId,
+            parent_span_id: this.parentSpanId,
+            name: this.name,
+            tracer_name: this.tracerName,
+            start_ns: this.startNs,
+            end_ns: this.endNs,
+            attributes: this.attrs,
+            events: this.events,
+            status: this.status,
+        };
+    }
+}
+export class Tracer {
+    constructor(name) {
+        this.sampleRate = 1.0;
+        this.lastRotation = '';
+        this.name = name;
+    }
+    startSpan(name, opts) {
+        return new Span(this, name, opts);
+    }
+    /** Auto begin/end around an async function. */
+    async withSpan(name, fn, opts) {
+        const span = this.startSpan(name, opts);
+        try {
+            const result = await fn(span);
+            if (span['status'].code === 'UNSET')
+                span.setStatus('OK');
+            return result;
+        }
+        catch (err) {
+            span.recordException(err);
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    }
+    /** Set sample rate 0-1. 1 = emit all spans, 0 = drop all. */
+    sample(rate) {
+        if (!Number.isFinite(rate))
+            return;
+        this.sampleRate = Math.max(0, Math.min(1, rate));
+    }
+    /** Internal: write a line. Sampling + rotation handled here. */
+    emitSpan(line) {
+        if (this.sampleRate < 1.0 && Math.random() > this.sampleRate)
+            return;
+        try {
+            fs.mkdirSync(TRACE_DIR, { recursive: true });
+            const today = todayStamp();
+            if (today !== this.lastRotation) {
+                this.cleanupOldFiles();
+                this.lastRotation = today;
+            }
+            const file = path.join(TRACE_DIR, `${today}.jsonl`);
+            fs.appendFileSync(file, JSON.stringify(line) + '\n');
+        }
+        catch { /* never throw from tracing */ }
+    }
+    cleanupOldFiles() {
+        try {
+            if (!fs.existsSync(TRACE_DIR))
+                return;
+            const files = fs.readdirSync(TRACE_DIR).filter(f => f.endsWith('.jsonl'));
+            const cutoff = Date.now() - RETENTION_DAYS * 86400000;
+            for (const f of files) {
+                const stamp = f.replace('.jsonl', '');
+                const t = Date.parse(stamp + 'T00:00:00Z');
+                if (Number.isFinite(t) && t < cutoff) {
+                    try {
+                        fs.unlinkSync(path.join(TRACE_DIR, f));
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+}
+// ── Public API ───────────────────────────────────────────────────────────
+const _tracers = new Map();
+export function trace(name) {
+    let t = _tracers.get(name);
+    if (!t) {
+        t = new Tracer(name);
+        _tracers.set(name, t);
+    }
+    return t;
+}
+export const OtelLite = {
+    trace,
+    /** Read the tail of today's trace file. Returns parsed TraceLines, newest last. */
+    async tail(lines = 100) {
+        try {
+            const file = path.join(TRACE_DIR, `${todayStamp()}.jsonl`);
+            if (!fs.existsSync(file))
+                return [];
+            const raw = fs.readFileSync(file, 'utf-8');
+            const split = raw.split('\n').filter(l => l.length > 0);
+            const slice = split.slice(Math.max(0, split.length - lines));
+            const out = [];
+            for (const line of slice) {
+                try {
+                    out.push(JSON.parse(line));
+                }
+                catch { /* skip bad line */ }
+            }
+            return out;
+        }
+        catch {
+            return [];
+        }
+    },
+    /** Path of today's trace file (whether or not it exists yet). */
+    todayFilePath() {
+        return path.join(TRACE_DIR, `${todayStamp()}.jsonl`);
+    },
+    /** Manually trigger retention cleanup. */
+    cleanup() {
+        const t = trace('_internal_');
+        // emitSpan triggers cleanup; do a noop pass with sampling 0 so no line is written
+        const prev = t['sampleRate'];
+        t.sample(0);
+        t['cleanupOldFiles']();
+        t.sample(prev);
+    },
+};
+// ── helpers ──────────────────────────────────────────────────────────────
+function nowNs() {
+    // Node high-res; convert ms → ns. process.hrtime.bigint is exact ns but
+    // not wall-clock. Use Date.now * 1e6 so timestamps align with logs.
+    return Date.now() * 1000000;
+}
+function todayStamp() {
+    const d = new Date();
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+function randomHex(chars) {
+    return crypto.randomBytes(Math.ceil(chars / 2)).toString('hex').slice(0, chars);
+}
+//# sourceMappingURL=otel-lite.js.map

package/dist/brain/otel-lite.js.map

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

package/dist/brain/pr-auto-review.d.ts

@@ -0,0 +1,17 @@
+import { PRReviewComment } from '../types.js';
+export interface PRReviewInput {
+    repo: string;
+    prNumber: number;
+    projectDir: string;
+    diffSummary: string;
+    changedFiles: string[];
+}
+export declare class PRAutoReview {
+    private brain;
+    constructor();
+    generate(input: PRReviewInput): Promise<PRReviewComment>;
+    private extractTerms;
+}
+export declare function getPRAutoReview(): PRAutoReview;
+export declare function resetPRAutoReviewForTests(): void;
+//# sourceMappingURL=pr-auto-review.d.ts.map