dino-spec 13.6.0 → 14.0.1

package/dist/core/context/__tests__/output-persistence.test.js

@@ -0,0 +1,246 @@
+/**
+ * Output Persistence Tests - v14.0.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { join } from 'path';
+import { mkdir, rm, writeFile } from 'fs/promises';
+import { OUTPUT_SIZE_THRESHOLD, OUTPUT_DIR, OUTPUT_RETENTION_DAYS, shouldPersist, persistOutput, readPersistedOutput, listPersistedOutputs, cleanupExpiredOutputs, getPersistedOutputsStats, generateContentHash, generateOutputFilename, createFileReference, parseFileReference, formatPersistenceResult, } from '../output-persistence.js';
+describe('Output Persistence', () => {
+    const testDir = join(process.cwd(), 'test-output-persistence-temp');
+    beforeEach(async () => {
+        // Create fresh test directory
+        await mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        // Clean up test directory
+        try {
+            await rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore errors
+        }
+    });
+    describe('Constants', () => {
+        it('should have correct size threshold', () => {
+            expect(OUTPUT_SIZE_THRESHOLD).toBe(30_000);
+        });
+        it('should have correct output directory', () => {
+            expect(OUTPUT_DIR).toBe('.dino/outputs');
+        });
+        it('should have correct retention days', () => {
+            expect(OUTPUT_RETENTION_DAYS).toBe(7);
+        });
+    });
+    describe('generateContentHash', () => {
+        it('should generate 8-character hash', () => {
+            const hash = generateContentHash('test content');
+            expect(hash.length).toBe(8);
+        });
+        it('should generate consistent hash for same content', () => {
+            const hash1 = generateContentHash('test content');
+            const hash2 = generateContentHash('test content');
+            expect(hash1).toBe(hash2);
+        });
+        it('should generate different hash for different content', () => {
+            const hash1 = generateContentHash('content 1');
+            const hash2 = generateContentHash('content 2');
+            expect(hash1).not.toBe(hash2);
+        });
+    });
+    describe('generateOutputFilename', () => {
+        it('should generate filename with timestamp and hash', () => {
+            const filename = generateOutputFilename('test content');
+            expect(filename).toMatch(/^\d{4}-\d{2}-\d{2}T.*-[a-f0-9]{8}\.txt$/);
+        });
+        it('should generate unique filenames', () => {
+            const filename1 = generateOutputFilename('content 1');
+            const filename2 = generateOutputFilename('content 2');
+            expect(filename1).not.toBe(filename2);
+        });
+    });
+    describe('shouldPersist', () => {
+        it('should return false for small content', () => {
+            const smallContent = 'a'.repeat(1000);
+            expect(shouldPersist(smallContent)).toBe(false);
+        });
+        it('should return true for large content', () => {
+            const largeContent = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 1);
+            expect(shouldPersist(largeContent)).toBe(true);
+        });
+        it('should return false for content exactly at threshold', () => {
+            const exactContent = 'a'.repeat(OUTPUT_SIZE_THRESHOLD);
+            expect(shouldPersist(exactContent)).toBe(false);
+        });
+        it('should respect custom threshold', () => {
+            const content = 'a'.repeat(500);
+            expect(shouldPersist(content, { threshold: 100 })).toBe(true);
+        });
+        it('should persist when forced', () => {
+            const smallContent = 'a'.repeat(100);
+            expect(shouldPersist(smallContent, { force: true })).toBe(true);
+        });
+    });
+    describe('createFileReference', () => {
+        it('should create properly formatted reference', () => {
+            const ref = createFileReference('.dino/outputs/test.txt', 50000);
+            expect(ref).toContain('[Output persisted to:');
+            expect(ref).toContain('.dino/outputs/test.txt');
+            expect(ref).toContain('50,000 chars');
+            expect(ref).toContain('tokens');
+        });
+    });
+    describe('parseFileReference', () => {
+        it('should parse valid file reference', () => {
+            const ref = '[Output persisted to: .dino/outputs/test.txt (50,000 chars, ~12,500 tokens)]';
+            expect(parseFileReference(ref)).toBe('.dino/outputs/test.txt');
+        });
+        it('should return null for invalid reference', () => {
+            expect(parseFileReference('not a reference')).toBeNull();
+        });
+        it('should return null for empty string', () => {
+            expect(parseFileReference('')).toBeNull();
+        });
+    });
+    describe('persistOutput', () => {
+        it('should not persist small content', async () => {
+            const smallContent = 'small content';
+            const result = await persistOutput(smallContent, testDir);
+            expect(result.persisted).toBe(false);
+            expect(result.reference).toBe(smallContent);
+            expect(result.tokensSaved).toBe(0);
+        });
+        it('should persist large content', async () => {
+            const largeContent = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 1000);
+            const result = await persistOutput(largeContent, testDir);
+            expect(result.persisted).toBe(true);
+            expect(result.reference).toContain('[Output persisted to:');
+            expect(result.originalSize).toBe(largeContent.length);
+            expect(result.tokensSaved).toBeGreaterThan(0);
+        });
+        it('should create output file', async () => {
+            const largeContent = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 1000);
+            const result = await persistOutput(largeContent, testDir);
+            // Extract path from reference
+            const path = parseFileReference(result.reference);
+            expect(path).not.toBeNull();
+            // Verify file exists
+            const content = await readPersistedOutput(path, testDir);
+            expect(content).toBe(largeContent);
+        });
+        it('should create metadata file', async () => {
+            const largeContent = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 1000);
+            await persistOutput(largeContent, testDir, { source: 'test-tool' });
+            const outputs = await listPersistedOutputs(testDir);
+            expect(outputs.length).toBe(1);
+            expect(outputs[0].source).toBe('test-tool');
+            expect(outputs[0].sizeChars).toBe(largeContent.length);
+        });
+    });
+    describe('readPersistedOutput', () => {
+        it('should read existing output', async () => {
+            const content = 'test content for reading';
+            const outputDir = join(testDir, OUTPUT_DIR);
+            await mkdir(outputDir, { recursive: true });
+            const filePath = join(outputDir, 'test-read.txt');
+            await writeFile(filePath, content);
+            const result = await readPersistedOutput(join(OUTPUT_DIR, 'test-read.txt'), testDir);
+            expect(result).toBe(content);
+        });
+        it('should return null for non-existent file', async () => {
+            const result = await readPersistedOutput('.dino/outputs/nonexistent.txt', testDir);
+            expect(result).toBeNull();
+        });
+    });
+    describe('listPersistedOutputs', () => {
+        it('should return empty array when no outputs', async () => {
+            const outputs = await listPersistedOutputs(testDir);
+            expect(outputs).toEqual([]);
+        });
+        it('should list all outputs', async () => {
+            // Create multiple outputs
+            const content1 = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 100);
+            const content2 = 'b'.repeat(OUTPUT_SIZE_THRESHOLD + 200);
+            await persistOutput(content1, testDir, { source: 'tool1' });
+            await persistOutput(content2, testDir, { source: 'tool2' });
+            const outputs = await listPersistedOutputs(testDir);
+            expect(outputs.length).toBe(2);
+        });
+    });
+    describe('cleanupExpiredOutputs', () => {
+        it('should clean up expired outputs', async () => {
+            // Create an expired output manually
+            const outputDir = join(testDir, OUTPUT_DIR);
+            await mkdir(outputDir, { recursive: true });
+            const expiredMeta = {
+                path: join(OUTPUT_DIR, 'expired.txt'),
+                hash: 'abc12345',
+                sizeChars: 1000,
+                createdAt: new Date(Date.now() - 10 * 24 * 60 * 60 * 1000).toISOString(), // 10 days ago
+                expiresAt: new Date(Date.now() - 3 * 24 * 60 * 60 * 1000).toISOString(), // 3 days ago (expired)
+            };
+            await writeFile(join(outputDir, 'expired.txt'), 'expired content');
+            await writeFile(join(outputDir, 'expired.meta.json'), JSON.stringify(expiredMeta));
+            const cleaned = await cleanupExpiredOutputs(testDir);
+            expect(cleaned).toBe(1);
+            // Verify file is gone
+            const outputs = await listPersistedOutputs(testDir);
+            expect(outputs.length).toBe(0);
+        });
+        it('should not clean up non-expired outputs', async () => {
+            const content = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 100);
+            await persistOutput(content, testDir);
+            const cleaned = await cleanupExpiredOutputs(testDir);
+            expect(cleaned).toBe(0);
+            const outputs = await listPersistedOutputs(testDir);
+            expect(outputs.length).toBe(1);
+        });
+    });
+    describe('getPersistedOutputsStats', () => {
+        it('should return empty stats when no outputs', async () => {
+            const stats = await getPersistedOutputsStats(testDir);
+            expect(stats.count).toBe(0);
+            expect(stats.totalChars).toBe(0);
+            expect(stats.estimatedTokensSaved).toBe(0);
+        });
+        it('should calculate correct stats', async () => {
+            const content1 = 'a'.repeat(OUTPUT_SIZE_THRESHOLD + 100);
+            const content2 = 'b'.repeat(OUTPUT_SIZE_THRESHOLD + 200);
+            await persistOutput(content1, testDir);
+            await persistOutput(content2, testDir);
+            const stats = await getPersistedOutputsStats(testDir);
+            expect(stats.count).toBe(2);
+            expect(stats.totalChars).toBe(content1.length + content2.length);
+            expect(stats.estimatedTokensSaved).toBeGreaterThan(0);
+            expect(stats.oldestOutput).not.toBeNull();
+            expect(stats.newestOutput).not.toBeNull();
+        });
+    });
+    describe('formatPersistenceResult', () => {
+        it('should format non-persisted result', () => {
+            const result = {
+                persisted: false,
+                reference: 'original content',
+                originalSize: 15,
+                estimatedTokens: 4,
+                tokensSaved: 0,
+            };
+            const formatted = formatPersistenceResult(result);
+            expect(formatted).toContain('not persisted');
+            expect(formatted).toContain('below threshold');
+        });
+        it('should format persisted result', () => {
+            const result = {
+                persisted: true,
+                reference: '[Output persisted to: .dino/outputs/test.txt (50,000 chars, ~12,500 tokens)]',
+                originalSize: 50000,
+                estimatedTokens: 12500,
+                tokensSaved: 12450,
+            };
+            const formatted = formatPersistenceResult(result);
+            expect(formatted).toContain('successfully');
+            expect(formatted).toContain('50,000 chars');
+            expect(formatted).toContain('Tokens saved');
+        });
+    });
+});
+//# sourceMappingURL=output-persistence.test.js.map

package/dist/core/context/__tests__/output-persistence.test.js.map

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

package/dist/core/context/budget-thresholds.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Budget Thresholds - v14.0.0
+ *
+ * Configurable context budget thresholds with safety margins.
+ * Optimized for Claude 4.5's extended context window (200K tokens).
+ *
+ * Key improvements over v13.x:
+ * - Raised thresholds from 80/90/95% to 85/95/98%
+ * - Safety margin calculation for reliable headroom
+ * - Config-driven thresholds via .dino/config.json
+ * - Backwards compatible with existing budget tracking
+ *
+ * Reference: Anthropic context engineering best practices
+ */
+/**
+ * Default budget thresholds (v14.0.0)
+ *
+ * These thresholds are optimized for safe context utilization
+ * while maximizing available token budget.
+ */
+export declare const OPTIMIZED_BUDGET_THRESHOLDS: {
+    /** Start monitoring - context filling up */
+    readonly WARNING: 0.85;
+    /** High usage - recommend compaction */
+    readonly HIGH: 0.95;
+    /** Critical - force compaction recommendation */
+    readonly CRITICAL: 0.98;
+};
+/**
+ * Legacy thresholds for backwards compatibility
+ */
+export declare const LEGACY_BUDGET_THRESHOLDS: {
+    readonly WARNING: 0.8;
+    readonly HIGH: 0.9;
+    readonly CRITICAL: 0.95;
+};
+/**
+ * Default safety margin in tokens
+ *
+ * Reserved buffer to prevent context overflow.
+ * Provides headroom for system messages and unexpected content.
+ */
+export declare const DEFAULT_SAFETY_MARGIN = 2000;
+/**
+ * Threshold configuration interface
+ */
+export interface ThresholdConfig {
+    /** Warning threshold (0-1) */
+    warning: number;
+    /** High threshold (0-1) */
+    high: number;
+    /** Critical threshold (0-1) */
+    critical: number;
+    /** Safety margin in tokens */
+    safetyMargin: number;
+}
+/**
+ * Threshold level type
+ */
+export type ThresholdLevel = 'safe' | 'warning' | 'high' | 'critical';
+/**
+ * Threshold result with remaining capacity
+ */
+export interface ThresholdResult {
+    /** Current threshold level */
+    level: ThresholdLevel;
+    /** Remaining tokens before limit */
+    remaining: number;
+    /** Safe remaining after subtracting safety margin */
+    safeRemaining: number;
+    /** Current usage percentage (0-100) */
+    percentage: number;
+    /** Whether compaction is recommended */
+    shouldCompact: boolean;
+    /** Whether compaction is urgent */
+    forceCompact: boolean;
+}
+/**
+ * Default threshold configuration
+ */
+export declare const DEFAULT_THRESHOLD_CONFIG: ThresholdConfig;
+/**
+ * Get threshold level from usage percentage
+ *
+ * @param usage - Current token usage
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration (optional)
+ * @returns ThresholdLevel
+ */
+export declare function getThresholdLevel(usage: number, limit: number, config?: ThresholdConfig): ThresholdLevel;
+/**
+ * Calculate threshold result with safety margin
+ *
+ * @param usage - Current token usage
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration (optional)
+ * @returns ThresholdResult with remaining capacity
+ */
+export declare function calculateThresholdResult(usage: number, limit: number, config?: ThresholdConfig): ThresholdResult;
+/**
+ * Load threshold configuration from config.json
+ *
+ * Configuration can be customized via .dino/config.json:
+ * ```json
+ * {
+ *   "custom": {
+ *     "budgetThresholds": {
+ *       "warning": 0.85,
+ *       "high": 0.95,
+ *       "critical": 0.98,
+ *       "safetyMargin": 2000
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * Falls back to optimized thresholds if not configured.
+ *
+ * @param projectDir - Project directory
+ * @returns ThresholdConfig
+ */
+export declare function loadThresholdConfig(projectDir?: string): Promise<ThresholdConfig>;
+/**
+ * Check if using legacy thresholds
+ *
+ * Returns true if config has legacy threshold values.
+ * Useful for migration warnings.
+ *
+ * @param config - Threshold configuration
+ * @returns boolean
+ */
+export declare function isLegacyThresholds(config: ThresholdConfig): boolean;
+/**
+ * Get recommendations for threshold level
+ *
+ * @param level - Current threshold level
+ * @returns Array of recommended actions
+ */
+export declare function getThresholdRecommendations(level: ThresholdLevel): string[];
+/**
+ * Format threshold result for display
+ *
+ * @param result - Threshold result
+ * @returns Formatted string
+ */
+export declare function formatThresholdResult(result: ThresholdResult): string;
+/**
+ * Calculate safe capacity at a threshold
+ *
+ * Returns the amount of tokens that can be safely used
+ * before hitting the specified threshold.
+ *
+ * @param limit - Context limit in tokens
+ * @param threshold - Threshold percentage (0-1)
+ * @param safetyMargin - Safety margin in tokens
+ * @returns Safe capacity in tokens
+ */
+export declare function calculateSafeCapacity(limit: number, threshold: number, safetyMargin?: number): number;
+/**
+ * Get effective limit accounting for safety margin
+ *
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration
+ * @returns Effective limit with safety margin applied
+ */
+export declare function getEffectiveLimit(limit: number, config?: ThresholdConfig): number;
+//# sourceMappingURL=budget-thresholds.d.ts.map

package/dist/core/context/budget-thresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-thresholds.d.ts","sourceRoot":"","sources":["../../../src/core/context/budget-thresholds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;IACtC,4CAA4C;;IAE5C,wCAAwC;;IAExC,iDAAiD;;CAEzC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAKtC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,eAA0C,GACjD,cAAc,CAahB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,eAA0C,GACjD,eAAe,CAcjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CA0B3E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAsBrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAA8B,GAC3C,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,eAA0C,GACjD,MAAM,CAGR"}

package/dist/core/context/budget-thresholds.js

@@ -0,0 +1,234 @@
+/**
+ * Budget Thresholds - v14.0.0
+ *
+ * Configurable context budget thresholds with safety margins.
+ * Optimized for Claude 4.5's extended context window (200K tokens).
+ *
+ * Key improvements over v13.x:
+ * - Raised thresholds from 80/90/95% to 85/95/98%
+ * - Safety margin calculation for reliable headroom
+ * - Config-driven thresholds via .dino/config.json
+ * - Backwards compatible with existing budget tracking
+ *
+ * Reference: Anthropic context engineering best practices
+ */
+import { loadConfig } from '../config/feature-flags.js';
+/**
+ * Default budget thresholds (v14.0.0)
+ *
+ * These thresholds are optimized for safe context utilization
+ * while maximizing available token budget.
+ */
+export const OPTIMIZED_BUDGET_THRESHOLDS = {
+    /** Start monitoring - context filling up */
+    WARNING: 0.85, // was 0.80
+    /** High usage - recommend compaction */
+    HIGH: 0.95, // was 0.90
+    /** Critical - force compaction recommendation */
+    CRITICAL: 0.98, // was 0.95
+};
+/**
+ * Legacy thresholds for backwards compatibility
+ */
+export const LEGACY_BUDGET_THRESHOLDS = {
+    WARNING: 0.80,
+    HIGH: 0.90,
+    CRITICAL: 0.95,
+};
+/**
+ * Default safety margin in tokens
+ *
+ * Reserved buffer to prevent context overflow.
+ * Provides headroom for system messages and unexpected content.
+ */
+export const DEFAULT_SAFETY_MARGIN = 2000;
+/**
+ * Default threshold configuration
+ */
+export const DEFAULT_THRESHOLD_CONFIG = {
+    warning: OPTIMIZED_BUDGET_THRESHOLDS.WARNING,
+    high: OPTIMIZED_BUDGET_THRESHOLDS.HIGH,
+    critical: OPTIMIZED_BUDGET_THRESHOLDS.CRITICAL,
+    safetyMargin: DEFAULT_SAFETY_MARGIN,
+};
+/**
+ * Get threshold level from usage percentage
+ *
+ * @param usage - Current token usage
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration (optional)
+ * @returns ThresholdLevel
+ */
+export function getThresholdLevel(usage, limit, config = DEFAULT_THRESHOLD_CONFIG) {
+    const percentage = usage / limit;
+    if (percentage >= config.critical) {
+        return 'critical';
+    }
+    if (percentage >= config.high) {
+        return 'high';
+    }
+    if (percentage >= config.warning) {
+        return 'warning';
+    }
+    return 'safe';
+}
+/**
+ * Calculate threshold result with safety margin
+ *
+ * @param usage - Current token usage
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration (optional)
+ * @returns ThresholdResult with remaining capacity
+ */
+export function calculateThresholdResult(usage, limit, config = DEFAULT_THRESHOLD_CONFIG) {
+    const level = getThresholdLevel(usage, limit, config);
+    const remaining = Math.max(0, limit - usage);
+    const safeRemaining = Math.max(0, remaining - config.safetyMargin);
+    const percentage = Math.round((usage / limit) * 100);
+    return {
+        level,
+        remaining,
+        safeRemaining,
+        percentage,
+        shouldCompact: level === 'high' || level === 'critical',
+        forceCompact: level === 'critical',
+    };
+}
+/**
+ * Load threshold configuration from config.json
+ *
+ * Configuration can be customized via .dino/config.json:
+ * ```json
+ * {
+ *   "custom": {
+ *     "budgetThresholds": {
+ *       "warning": 0.85,
+ *       "high": 0.95,
+ *       "critical": 0.98,
+ *       "safetyMargin": 2000
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * Falls back to optimized thresholds if not configured.
+ *
+ * @param projectDir - Project directory
+ * @returns ThresholdConfig
+ */
+export async function loadThresholdConfig(projectDir = process.cwd()) {
+    try {
+        const config = await loadConfig(projectDir);
+        const customThresholds = config.custom?.budgetThresholds;
+        if (customThresholds) {
+            return {
+                warning: customThresholds.warning ?? DEFAULT_THRESHOLD_CONFIG.warning,
+                high: customThresholds.high ?? DEFAULT_THRESHOLD_CONFIG.high,
+                critical: customThresholds.critical ?? DEFAULT_THRESHOLD_CONFIG.critical,
+                safetyMargin: customThresholds.safetyMargin ?? DEFAULT_THRESHOLD_CONFIG.safetyMargin,
+            };
+        }
+    }
+    catch {
+        // Fall back to defaults on any error
+    }
+    return DEFAULT_THRESHOLD_CONFIG;
+}
+/**
+ * Check if using legacy thresholds
+ *
+ * Returns true if config has legacy threshold values.
+ * Useful for migration warnings.
+ *
+ * @param config - Threshold configuration
+ * @returns boolean
+ */
+export function isLegacyThresholds(config) {
+    return (config.warning === LEGACY_BUDGET_THRESHOLDS.WARNING &&
+        config.high === LEGACY_BUDGET_THRESHOLDS.HIGH &&
+        config.critical === LEGACY_BUDGET_THRESHOLDS.CRITICAL);
+}
+/**
+ * Get recommendations for threshold level
+ *
+ * @param level - Current threshold level
+ * @returns Array of recommended actions
+ */
+export function getThresholdRecommendations(level) {
+    switch (level) {
+        case 'critical':
+            return [
+                'CRITICAL: Context at 98%+. Immediate compaction required.',
+                'Run: dino compact --force',
+                'Or start a new conversation with /dino.handoff',
+                'Consider using /dino.fossil to archive completed work.',
+            ];
+        case 'high':
+            return [
+                'HIGH: Context at 95%+. Compaction recommended.',
+                'Run: dino compact',
+                'Avoid loading large files. Use targeted searches.',
+                'Checkpoint progress for potential handoff.',
+            ];
+        case 'warning':
+            return [
+                'WARNING: Context at 85%+. Monitor usage.',
+                'Prefer grep/glob over full file reads.',
+                'Consider deferring non-essential file reads.',
+            ];
+        case 'safe':
+        default:
+            return [];
+    }
+}
+/**
+ * Format threshold result for display
+ *
+ * @param result - Threshold result
+ * @returns Formatted string
+ */
+export function formatThresholdResult(result) {
+    const indicator = result.level === 'critical' ? '[!!!]'
+        : result.level === 'high' ? '[!!]'
+            : result.level === 'warning' ? '[!]'
+                : '[OK]';
+    const lines = [];
+    lines.push(`## Budget Status ${indicator}`);
+    lines.push('');
+    lines.push(`**Level:** ${result.level.toUpperCase()} (${result.percentage}% used)`);
+    lines.push(`**Remaining:** ${Math.round(result.remaining / 1000)}K tokens`);
+    lines.push(`**Safe Remaining:** ${Math.round(result.safeRemaining / 1000)}K tokens`);
+    const recommendations = getThresholdRecommendations(result.level);
+    if (recommendations.length > 0) {
+        lines.push('');
+        lines.push('### Recommendations:');
+        recommendations.forEach((rec) => lines.push(`- ${rec}`));
+    }
+    return lines.join('\n');
+}
+/**
+ * Calculate safe capacity at a threshold
+ *
+ * Returns the amount of tokens that can be safely used
+ * before hitting the specified threshold.
+ *
+ * @param limit - Context limit in tokens
+ * @param threshold - Threshold percentage (0-1)
+ * @param safetyMargin - Safety margin in tokens
+ * @returns Safe capacity in tokens
+ */
+export function calculateSafeCapacity(limit, threshold, safetyMargin = DEFAULT_SAFETY_MARGIN) {
+    return Math.max(0, Math.floor(limit * threshold) - safetyMargin);
+}
+/**
+ * Get effective limit accounting for safety margin
+ *
+ * @param limit - Context limit in tokens
+ * @param config - Threshold configuration
+ * @returns Effective limit with safety margin applied
+ */
+export function getEffectiveLimit(limit, config = DEFAULT_THRESHOLD_CONFIG) {
+    // Use high threshold as the practical limit
+    return calculateSafeCapacity(limit, config.high, config.safetyMargin);
+}
+//# sourceMappingURL=budget-thresholds.js.map