@kybernesis/brain-core 0.1.0

package/dist/sleep/steps/reasoning.js

@@ -0,0 +1,173 @@
+/**
+ * Reasoning step — port of KAD's sleep/steps/reasoning.ts.
+ *
+ * Two LLM passes per entity (only entities with ≥3 facts):
+ *   1. Deduction (confidence 0.80-0.95) — logically certain conclusions
+ *   2. Induction (confidence 0.60-0.75) — probable patterns from ≥3 data points
+ *
+ * Marks existing insights stale before generating new ones; saves new
+ * insights tagged 'inference' (deduction) or 'pattern' (induction).
+ */
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { callClaude } from '../../claude-call.js';
+import { getEntitiesForReasoning, markEntityReasoned, saveEntityInsight, markInsightsStale, getTypedRelationships, } from '../../entity-graph.js';
+import { getFactsForEntity } from '../../fact-store.js';
+const DEDUCTION_PROMPT = `Given these facts about "{name}" and connected entities, what can you LOGICALLY DERIVE that is CERTAINLY TRUE?
+
+Every conclusion must follow from 2+ existing facts. Only include things that are definitely true based on the evidence — no speculation.
+
+Facts about {name}:
+{facts}
+
+{connectedSection}
+
+Return a JSON array of insights. Each must have "insight" (the conclusion), "reasoning" (which facts support it), and "confidence" (0.80-0.95).
+Return [] if nothing can be logically derived.
+
+Example: [{"insight":"David leads a Darkstar portfolio company","reasoning":"David is CEO of Ohana + Ohana is a Darkstar portfolio company","confidence":0.85}]`;
+const INDUCTION_PROMPT = `Given these observations about "{name}", what PATTERNS do you detect? What is PROBABLY true?
+
+Require 3+ data points to propose a pattern. These are probable, not certain.
+
+Facts about {name}:
+{facts}
+
+Mention patterns:
+- Total mentions: {mentionCount}
+- First seen: {firstSeen}
+- Last seen: {lastSeen}
+{coOccurrences}
+
+Return a JSON array of pattern insights. Each must have "insight" (the pattern), "reasoning" (the evidence), and "confidence" (0.60-0.75).
+Return [] if no clear patterns.
+
+Example: [{"insight":"Nick is a regular in the AI meetup circuit","reasoning":"Appears at 6 different AI events over 3 months","confidence":0.70}]`;
+function parseInsights(response) {
+    const jsonMatch = (response ?? '').match(/\[[\s\S]*\]/);
+    if (!jsonMatch)
+        return [];
+    try {
+        const parsed = JSON.parse(jsonMatch[0]);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((item) => {
+            if (!item || typeof item !== 'object')
+                return false;
+            return (typeof item.insight === 'string' &&
+                item.insight.length > 5 &&
+                typeof item.reasoning === 'string' &&
+                typeof item.confidence === 'number');
+        });
+    }
+    catch {
+        return [];
+    }
+}
+export async function runReasoningStep(t, config) {
+    if (!config.enableReasoning)
+        return { count: 0, processed: 0 };
+    const maxPerRun = config.maxReasoningPerRun || 5;
+    let insightsCreated = 0;
+    let processed = 0;
+    const errors = [];
+    try {
+        const entities = await getEntitiesForReasoning(t, maxPerRun);
+        if (entities.length === 0)
+            return { count: 0, processed: 0 };
+        const db = getDb(t, 'entityGraph');
+        for (const entity of entities) {
+            processed++;
+            try {
+                const facts = await getFactsForEntity(t, entity.name, { latestOnly: true, limit: 20 });
+                if (facts.length < 3) {
+                    await markEntityReasoned(t, entity.id);
+                    continue;
+                }
+                const factList = facts.map(f => `- ${f.content} (${f.category}, confidence: ${f.confidence})`).join('\n');
+                let connectedSection = '';
+                try {
+                    const typedRels = await getTypedRelationships(t, entity.id);
+                    if (typedRels.length > 0) {
+                        const connectedParts = [];
+                        for (const rel of typedRels.slice(0, 5)) {
+                            const relFacts = await getFactsForEntity(t, rel.entity.name, { latestOnly: true, limit: 5 });
+                            if (relFacts.length > 0) {
+                                const relFactList = relFacts.map(f => `  - ${f.content}`).join('\n');
+                                connectedParts.push(`${rel.entity.name} (${rel.relationship}):\n${relFactList}`);
+                            }
+                        }
+                        if (connectedParts.length > 0) {
+                            connectedSection = `Connected entities:\n${connectedParts.join('\n\n')}`;
+                        }
+                    }
+                }
+                catch { /* non-fatal */ }
+                await markInsightsStale(t, entity.id);
+                // Pass 1: Deduction
+                try {
+                    const deductionPrompt = DEDUCTION_PROMPT
+                        .replace(/\{name\}/g, entity.name)
+                        .replace('{facts}', factList)
+                        .replace('{connectedSection}', connectedSection || 'No connected entities with known facts.');
+                    const response = await callClaude(deductionPrompt, { model: 'haiku', maxTokens: 512 });
+                    const deductions = parseInsights(response ?? '');
+                    for (const d of deductions) {
+                        const confidence = Math.max(0.80, Math.min(0.95, d.confidence));
+                        await saveEntityInsight(t, entity.id, 'inference', d.insight, d.reasoning, confidence);
+                        insightsCreated++;
+                    }
+                }
+                catch (err) {
+                    errors.push(`deduction ${entity.name}: ${String(err)}`);
+                }
+                // Pass 2: Induction
+                try {
+                    const entityRow = db.prepare('SELECT * FROM entities WHERE id = ?').get(entity.id);
+                    let coOccurrences = '';
+                    try {
+                        const coOccurring = db.prepare(`
+              SELECT e2.name, er.strength FROM entity_relations er
+              JOIN entities e2 ON e2.id = CASE WHEN er.source_id = ? THEN er.target_id ELSE er.source_id END
+              WHERE (er.source_id = ? OR er.target_id = ?) AND er.strength > 1
+              ORDER BY er.strength DESC LIMIT 10
+            `).all(entity.id, entity.id, entity.id);
+                        if (coOccurring.length > 0) {
+                            coOccurrences = 'Co-occurs with: ' + coOccurring.map(c => `${c.name} (${c.strength}x)`).join(', ');
+                        }
+                    }
+                    catch { /* non-fatal */ }
+                    const inductionPrompt = INDUCTION_PROMPT
+                        .replace(/\{name\}/g, entity.name)
+                        .replace('{facts}', factList)
+                        .replace('{mentionCount}', String(entityRow?.mention_count ?? 0))
+                        .replace('{firstSeen}', entityRow?.first_seen ?? 'unknown')
+                        .replace('{lastSeen}', entityRow?.last_seen ?? 'unknown')
+                        .replace('{coOccurrences}', coOccurrences || 'No significant co-occurrences.');
+                    const response = await callClaude(inductionPrompt, { model: 'haiku', maxTokens: 512 });
+                    const inductions = parseInsights(response ?? '');
+                    for (const ind of inductions) {
+                        const confidence = Math.max(0.60, Math.min(0.75, ind.confidence));
+                        await saveEntityInsight(t, entity.id, 'pattern', ind.insight, ind.reasoning, confidence);
+                        insightsCreated++;
+                    }
+                }
+                catch (err) {
+                    errors.push(`induction ${entity.name}: ${String(err)}`);
+                }
+                await markEntityReasoned(t, entity.id);
+            }
+            catch (err) {
+                errors.push(`reasoning ${entity.name}: ${String(err)}`);
+            }
+        }
+    }
+    catch (err) {
+        errors.push(`reasoning step: ${String(err)}`);
+    }
+    return {
+        count: insightsCreated,
+        processed,
+        errors: errors.length > 0 ? errors : undefined,
+    };
+}
+//# sourceMappingURL=reasoning.js.map

package/dist/sleep/steps/reasoning.js.map

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

package/dist/sleep/steps/summarize.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Summarize step — port of KAD's sleep/steps/summarize.ts.
+ *
+ * Two phases:
+ *   1. Tier-changed items from maintenance_queue (task=resummarize)
+ *   2. Items with missing/short/raw-content/over-long summaries, skipping
+ *      anything enriched in the last 3 days
+ *
+ * Tier-appropriate prompts: rich for hot (3-5 sentences), compressed for
+ * archive (1-2), normal for warm. Output is post-processed to strip common
+ * LLM preambles.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+import type { SleepConfig } from '../config.js';
+export interface SummarizeResult {
+    count: number;
+    durationMs?: number;
+    errors?: string[];
+}
+export declare function runSummarizeStep(t: TenantContext, config: SleepConfig): Promise<SummarizeResult>;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/sleep/steps/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/sleep/steps/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAgED,wBAAsB,gBAAgB,CACpC,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CA+I1B"}

package/dist/sleep/steps/summarize.js

@@ -0,0 +1,206 @@
+/**
+ * Summarize step — port of KAD's sleep/steps/summarize.ts.
+ *
+ * Two phases:
+ *   1. Tier-changed items from maintenance_queue (task=resummarize)
+ *   2. Items with missing/short/raw-content/over-long summaries, skipping
+ *      anything enriched in the last 3 days
+ *
+ * Tier-appropriate prompts: rich for hot (3-5 sentences), compressed for
+ * archive (1-2), normal for warm. Output is post-processed to strip common
+ * LLM preambles.
+ */
+import { promises as fs } from 'node:fs';
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { callClaude } from '../../claude-call.js';
+import { ensureSleepSchema } from '../db.js';
+function safeParseArray(json) {
+    if (!json)
+        return [];
+    try {
+        const parsed = JSON.parse(json);
+        if (Array.isArray(parsed))
+            return parsed;
+        if (typeof parsed === 'string')
+            return parsed.split(',').map(s => s.trim()).filter(Boolean);
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+function markProcessed(db, queueId) {
+    db.prepare(`UPDATE maintenance_queue SET processed_at = datetime('now') WHERE id = ?`).run(queueId);
+}
+function buildSummaryPrompt(content, tier, title, tags, entities, relatedTitles) {
+    const context = [];
+    if (title)
+        context.push(`Title: ${title}`);
+    if (tags.length > 0)
+        context.push(`Tags: ${tags.join(', ')}`);
+    if (entities.length > 0)
+        context.push(`People/entities mentioned: ${entities.join(', ')}`);
+    if (relatedTitles.length > 0)
+        context.push(`Related memories: ${relatedTitles.join(', ')}`);
+    const contextBlock = context.length > 0 ? `\nContext:\n${context.join('\n')}\n` : '';
+    if (tier === 'hot') {
+        return `Summarize this content for a personal knowledge system. This is a HIGH-PRIORITY memory that is frequently accessed. Write a rich, detailed summary (3-5 sentences) that captures:
+- The key topic and what was discussed/decided
+- Who was involved (if anyone mentioned)
+- Any action items, decisions, or insights
+- Why this matters (context/significance)
+
+Write in third person, past tense. Be specific and factual, not generic.
+${contextBlock}
+Content:
+${content}`;
+    }
+    if (tier === 'archive') {
+        return `Summarize this content for a personal knowledge system. This is an ARCHIVED memory (low priority, rarely accessed). Write a compressed summary (1-2 sentences) that captures only the core essence — what it was about and one key detail.
+
+Write in third person, past tense. Be ultra-concise.
+${contextBlock}
+Content:
+${content}`;
+    }
+    return `Summarize this content for a personal knowledge system. Write a clear summary (2-3 sentences) that captures:
+- The main topic
+- Key points or decisions
+- Who was involved (if relevant)
+
+Write in third person, past tense. Be specific and factual.
+${contextBlock}
+Content:
+${content}`;
+}
+export async function runSummarizeStep(t, config) {
+    const timeline = getDb(t, 'timeline');
+    const sleep = ensureSleepSchema(t);
+    let summarized = 0;
+    const errors = [];
+    const startTime = Date.now();
+    try {
+        const pendingItems = sleep.prepare(`
+      SELECT id as queue_id, item_id
+      FROM maintenance_queue
+      WHERE task = 'resummarize' AND processed_at IS NULL
+      ORDER BY priority DESC
+      LIMIT ?
+    `).all(config.maxSummariesPerRun);
+        const remaining = config.maxSummariesPerRun - pendingItems.length;
+        const needsSummary = remaining > 0 ? timeline.prepare(`
+      SELECT id FROM timeline_events
+      WHERE (summary IS NULL
+             OR length(summary) < 50
+             OR summary LIKE '{%'
+             OR summary LIKE '# %'
+             OR length(summary) > 500)
+        AND (last_enriched IS NULL OR last_enriched < datetime('now', '-3 days'))
+      ORDER BY priority DESC
+      LIMIT ?
+    `).all(remaining) : [];
+        const allItemIds = new Set();
+        const queueMap = new Map();
+        for (const p of pendingItems) {
+            allItemIds.add(p.item_id);
+            queueMap.set(p.item_id, p.queue_id);
+        }
+        for (const n of needsSummary) {
+            allItemIds.add(n.id.toString());
+        }
+        if (allItemIds.size === 0)
+            return { count: 0 };
+        for (const itemId of allItemIds) {
+            try {
+                const item = timeline.prepare(`
+          SELECT id, source_path, title, tier, summary, tags_json, entities_json
+          FROM timeline_events WHERE id = ?
+        `).get(parseInt(itemId));
+                if (!item) {
+                    if (queueMap.has(itemId))
+                        markProcessed(sleep, queueMap.get(itemId));
+                    continue;
+                }
+                let content = '';
+                if (item.source_path.startsWith('channel://')) {
+                    const parts = [];
+                    if (item.title)
+                        parts.push(item.title);
+                    if (item.summary && item.summary.length > 10)
+                        parts.push(item.summary);
+                    content = parts.join('\n\n').slice(0, 4000);
+                }
+                else {
+                    try {
+                        const raw = await fs.readFile(item.source_path, 'utf-8');
+                        content = raw.replace(/^---[\s\S]*?---\n*/m, '').slice(0, 4000);
+                    }
+                    catch {
+                        if (queueMap.has(itemId))
+                            markProcessed(sleep, queueMap.get(itemId));
+                        continue;
+                    }
+                }
+                if (content.length < 20) {
+                    if (queueMap.has(itemId))
+                        markProcessed(sleep, queueMap.get(itemId));
+                    continue;
+                }
+                const tags = safeParseArray(item.tags_json);
+                const entities = safeParseArray(item.entities_json);
+                const edges = sleep.prepare(`
+          SELECT
+            CASE WHEN from_path = ? THEN to_path ELSE from_path END as related_path,
+            shared_tags
+          FROM memory_edges
+          WHERE from_path = ? OR to_path = ?
+          LIMIT 3
+        `).all(item.source_path, item.source_path, item.source_path);
+                const relatedTitles = [];
+                for (const edge of edges) {
+                    const related = timeline.prepare(`SELECT title FROM timeline_events WHERE source_path = ?`).get(edge.related_path);
+                    if (related?.title)
+                        relatedTitles.push(related.title);
+                }
+                const prompt = buildSummaryPrompt(content, item.tier || 'warm', item.title, tags, entities, relatedTitles);
+                const responseText = await callClaude(prompt, { model: 'haiku', maxTokens: 300 });
+                const newSummary = (responseText ?? '')
+                    .replace(/^(Here's|Here is|Summary|Archived Memory Summary|Memory Archive|Summary for Personal Knowledge System)[:\s]*/i, '')
+                    .replace(/^(the |a )?(ultra-concise|concise|brief|compressed|detailed|rich)?,? ?(detailed )?summary[:\s]*(for (the )?personal knowledge system)?[:\s]*(in third person,? ?(past tense)?[.:\s]*)?/i, '')
+                    .replace(/^of\s+(?=[A-Z])/m, '')
+                    .replace(/^for Personal Knowledge System[:\s]*/i, '')
+                    .trim();
+                if (newSummary && newSummary.length > 20) {
+                    timeline.prepare(`
+            UPDATE timeline_events
+            SET summary = ?, last_enriched = datetime('now')
+            WHERE id = ?
+          `).run(newSummary, item.id);
+                    summarized++;
+                }
+                if (queueMap.has(itemId))
+                    markProcessed(sleep, queueMap.get(itemId));
+            }
+            catch (err) {
+                errors.push(`summarize ${itemId}: ${String(err)}`);
+                if (queueMap.has(itemId)) {
+                    sleep.prepare(`
+            UPDATE maintenance_queue
+            SET processed_at = datetime('now'), error_message = ?
+            WHERE id = ?
+          `).run(String(err), queueMap.get(itemId));
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[brain-core/sleep/summarize] step failed', { err: String(err) });
+        errors.push(`summarize step: ${String(err)}`);
+    }
+    return {
+        count: summarized,
+        durationMs: Date.now() - startTime,
+        errors: errors.length > 0 ? errors : undefined,
+    };
+}
+//# sourceMappingURL=summarize.js.map

package/dist/sleep/steps/summarize.js.map

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

package/dist/sleep/steps/tag.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tag step — port of KAD's sleep/steps/tag.ts.
+ *
+ * Refreshes stale/missing tags via Claude Haiku. Capped at maxTagsPerRun
+ * per cycle to control LLM cost. Pulls source content from disk when
+ * source_path resolves to a readable file, otherwise falls back to the
+ * stored summary/title.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+import type { SleepConfig } from '../config.js';
+export interface TagResult {
+    count: number;
+    errors?: string[];
+}
+export declare function runTagStep(t: TenantContext, config: SleepConfig): Promise<TagResult>;
+//# sourceMappingURL=tag.d.ts.map

package/dist/sleep/steps/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/sleep/steps/tag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,UAAU,CAC9B,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,SAAS,CAAC,CA+EpB"}

package/dist/sleep/steps/tag.js

@@ -0,0 +1,84 @@
+/**
+ * Tag step — port of KAD's sleep/steps/tag.ts.
+ *
+ * Refreshes stale/missing tags via Claude Haiku. Capped at maxTagsPerRun
+ * per cycle to control LLM cost. Pulls source content from disk when
+ * source_path resolves to a readable file, otherwise falls back to the
+ * stored summary/title.
+ */
+import { promises as fs } from 'node:fs';
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { callClaude } from '../../claude-call.js';
+export async function runTagStep(t, config) {
+    if (!config.enableTagging)
+        return { count: 0 };
+    const db = getDb(t, 'timeline');
+    const staleDate = new Date(Date.now() - config.tagStaleDays * 24 * 60 * 60 * 1000).toISOString();
+    let tagged = 0;
+    const errors = [];
+    try {
+        const items = db.prepare(`
+      SELECT id, source_path, title, summary, tags_json, topics_json
+      FROM timeline_events
+      WHERE (last_enriched IS NULL OR last_enriched < ?)
+         OR (tags_json IS NULL OR tags_json = '[]')
+      ORDER BY priority DESC
+      LIMIT ?
+    `).all(staleDate, config.maxTagsPerRun);
+        if (items.length === 0)
+            return { count: 0 };
+        for (const item of items) {
+            try {
+                let content = item.summary || item.title || '';
+                if (item.source_path && !item.source_path.startsWith('channel://')) {
+                    try {
+                        const fileContent = await fs.readFile(item.source_path, 'utf-8');
+                        content = fileContent.slice(0, 3000);
+                    }
+                    catch { /* fall back to summary */ }
+                }
+                if (!content || content.length < 50)
+                    continue;
+                const responseText = await callClaude(`Generate 3-7 relevant tags for this content. Return only a JSON array of lowercase strings, no explanation.
+
+Content:
+${content}
+
+Example response: ["meeting", "pricing", "strategy", "planning"]`, { model: 'haiku', maxTokens: 500 });
+                const jsonMatch = (responseText ?? '').match(/\[[\s\S]*?\]/);
+                if (!jsonMatch)
+                    continue;
+                let tags;
+                try {
+                    tags = JSON.parse(jsonMatch[0]);
+                }
+                catch {
+                    continue;
+                }
+                if (Array.isArray(tags) && tags.length > 0) {
+                    const rawTopics = JSON.parse(item.topics_json || '[]');
+                    const existingTopics = Array.isArray(rawTopics) ? rawTopics : [];
+                    const allTags = [...new Set([
+                            ...tags.filter((x) => typeof x === 'string').map(s => s.toLowerCase()),
+                            ...existingTopics.map(s => s.toLowerCase()),
+                        ])];
+                    db.prepare(`
+            UPDATE timeline_events
+            SET tags_json = ?, last_enriched = datetime('now')
+            WHERE id = ?
+          `).run(JSON.stringify(allTags), item.id);
+                    tagged++;
+                }
+            }
+            catch (err) {
+                errors.push(`tag item ${item.id}: ${String(err)}`);
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[brain-core/sleep/tag] step failed', { err: String(err) });
+        errors.push(`tag step: ${String(err)}`);
+    }
+    return { count: tagged, errors: errors.length > 0 ? errors : undefined };
+}
+//# sourceMappingURL=tag.js.map

package/dist/sleep/steps/tag.js.map

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

package/dist/sleep/steps/tier.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tier step — port of KAD's sleep/steps/tier.ts.
+ *
+ * Promotes/demotes timeline events between hot/warm/archive tiers.
+ *
+ * Bug B11A regression-watchpoint: hot promotion uses **OR across 5 signals**
+ * (priority threshold OR low decay OR recent access OR relationshipScore OR
+ * edgeCount). A v1 port had AND across these signals, which dropped most
+ * promotions — the port-faithful library carries KAD's OR shape verbatim.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+import type { SleepConfig } from '../config.js';
+export interface TierResult {
+    count: number;
+    errors?: string[];
+}
+export declare function runTierStep(t: TenantContext, config: SleepConfig): Promise<TierResult>;
+//# sourceMappingURL=tier.d.ts.map

package/dist/sleep/steps/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../../src/sleep/steps/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,CAAC,EAAE,aAAa,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CA6FrB"}