maestro-flow 0.1.0

package/dist/core/manifest.js

@@ -0,0 +1,139 @@
+// ---------------------------------------------------------------------------
+// Installation Manifest
+// Tracks installed files for clean reinstall and uninstall.
+// Manifests stored at ~/.maestro/manifests/{id}.json
+// ---------------------------------------------------------------------------
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync, rmSync, } from 'node:fs';
+import { paths } from '../config/paths.js';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const MANIFESTS_DIR = join(paths.home, 'manifests');
+function ensureDir() {
+    if (!existsSync(MANIFESTS_DIR)) {
+        mkdirSync(MANIFESTS_DIR, { recursive: true });
+    }
+}
+function manifestFile(id) {
+    return join(MANIFESTS_DIR, `${id}.json`);
+}
+// ---------------------------------------------------------------------------
+// CRUD
+// ---------------------------------------------------------------------------
+export function createManifest(scope, targetPath) {
+    const ts = new Date().toISOString().replace(/[-:]/g, '').replace('T', '-').split('.')[0];
+    return {
+        id: `${scope}-${ts}`,
+        version: '1.0',
+        scope,
+        targetPath,
+        installedAt: new Date().toISOString(),
+        entries: [],
+    };
+}
+export function addFile(manifest, filePath) {
+    manifest.entries.push({ path: filePath, type: 'file' });
+}
+export function addDir(manifest, dirPath) {
+    manifest.entries.push({ path: dirPath, type: 'dir' });
+}
+export function saveManifest(manifest) {
+    ensureDir();
+    // Remove old manifests for same scope+path
+    removeOld(manifest.scope, manifest.targetPath);
+    const fp = manifestFile(manifest.id);
+    writeFileSync(fp, JSON.stringify(manifest, null, 2), 'utf-8');
+    return fp;
+}
+function removeOld(scope, targetPath) {
+    if (!existsSync(MANIFESTS_DIR))
+        return;
+    const norm = targetPath.toLowerCase().replace(/[\\/]+$/, '');
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            const m = JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8'));
+            if (m.scope === scope && m.targetPath.toLowerCase().replace(/[\\/]+$/, '') === norm) {
+                unlinkSync(join(MANIFESTS_DIR, f));
+            }
+        }
+        catch { /* skip */ }
+    }
+}
+export function findManifest(scope, targetPath) {
+    if (!existsSync(MANIFESTS_DIR))
+        return null;
+    const norm = targetPath.toLowerCase().replace(/[\\/]+$/, '');
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            const m = JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8'));
+            if (m.scope === scope && m.targetPath.toLowerCase().replace(/[\\/]+$/, '') === norm) {
+                return m;
+            }
+        }
+        catch { /* skip */ }
+    }
+    return null;
+}
+export function getAllManifests() {
+    if (!existsSync(MANIFESTS_DIR))
+        return [];
+    const results = [];
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            results.push(JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8')));
+        }
+        catch { /* skip */ }
+    }
+    return results.sort((a, b) => b.installedAt.localeCompare(a.installedAt));
+}
+export function deleteManifest(manifest) {
+    const fp = manifestFile(manifest.id);
+    if (existsSync(fp))
+        unlinkSync(fp);
+}
+// ---------------------------------------------------------------------------
+// Cleanup — remove files recorded in a manifest
+// ---------------------------------------------------------------------------
+/** Files to preserve even during cleanup. */
+const PRESERVE = new Set(['settings.json', 'settings.local.json']);
+export function cleanManifestFiles(manifest) {
+    let removed = 0;
+    let skipped = 0;
+    // Remove files first (deepest paths first)
+    const files = manifest.entries
+        .filter(e => e.type === 'file')
+        .sort((a, b) => b.path.length - a.path.length);
+    for (const entry of files) {
+        const name = entry.path.split(/[\\/]/).pop() ?? '';
+        if (PRESERVE.has(name)) {
+            skipped++;
+            continue;
+        }
+        try {
+            if (existsSync(entry.path)) {
+                unlinkSync(entry.path);
+                removed++;
+            }
+        }
+        catch { /* skip */ }
+    }
+    // Remove empty directories (deepest first)
+    const dirs = manifest.entries
+        .filter(e => e.type === 'dir')
+        .sort((a, b) => b.path.length - a.path.length);
+    for (const entry of dirs) {
+        try {
+            if (existsSync(entry.path)) {
+                const contents = readdirSync(entry.path);
+                if (contents.length === 0) {
+                    rmSync(entry.path, { recursive: true });
+                    removed++;
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return { removed, skipped };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

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

package/dist/core/mcp-tool-registry.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-tool-registry.integration.test.d.ts.map

package/dist/core/mcp-tool-registry.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-registry.integration.test.d.ts","sourceRoot":"","sources":["../../src/core/mcp-tool-registry.integration.test.ts"],"names":[],"mappings":""}

package/dist/core/mcp-tool-registry.integration.test.js

@@ -0,0 +1,220 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ToolRegistry } from './tool-registry.js';
+// ---------------------------------------------------------------------------
+// L2 Integration: ToolRegistry <-> Tool handlers <-> MCP-style call patterns
+// Tests real module interaction: register tools → list/filter → execute handlers
+// This mirrors the MCP server's use of ToolRegistry (src/mcp/server.ts)
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Test tool factories
+// ---------------------------------------------------------------------------
+function makeEchoTool() {
+    return {
+        name: 'echo',
+        description: 'Echoes input text',
+        inputSchema: {
+            type: 'object',
+            properties: { text: { type: 'string' } },
+            required: ['text'],
+        },
+        handler: async (input) => ({
+            content: [{ type: 'text', text: `Echo: ${input.text}` }],
+        }),
+    };
+}
+function makeCountTool() {
+    return {
+        name: 'count-words',
+        description: 'Counts words in text',
+        inputSchema: {
+            type: 'object',
+            properties: { text: { type: 'string' } },
+            required: ['text'],
+        },
+        handler: async (input) => {
+            const words = (input.text || '').split(/\s+/).filter(Boolean);
+            return {
+                content: [{ type: 'text', text: String(words.length) }],
+            };
+        },
+    };
+}
+function makeErrorTool() {
+    return {
+        name: 'always-fail',
+        description: 'Always throws an error',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+            throw new Error('Intentional failure');
+        },
+    };
+}
+function makeStatefulTool() {
+    let callCount = 0;
+    return {
+        name: 'stateful',
+        description: 'Tracks call count',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+            callCount++;
+            return {
+                content: [{ type: 'text', text: `Call #${callCount}` }],
+            };
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Registry + tool handler integration
+// ---------------------------------------------------------------------------
+describe('ToolRegistry + Tool handler integration', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new ToolRegistry();
+    });
+    it('registers and lists multiple tools', () => {
+        registry.register(makeEchoTool());
+        registry.register(makeCountTool());
+        const tools = registry.list();
+        expect(tools).toHaveLength(2);
+        const names = tools.map((t) => t.name).sort();
+        expect(names).toEqual(['count-words', 'echo']);
+    });
+    it('executes registered tool handler and returns result', async () => {
+        registry.register(makeEchoTool());
+        const result = await registry.execute('echo', { text: 'hello world' });
+        expect(result.isError).toBeUndefined();
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].text).toBe('Echo: hello world');
+    });
+    it('returns error result for unknown tool name', async () => {
+        const result = await registry.execute('nonexistent', {});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('Unknown tool');
+    });
+    it('prevents duplicate tool registration', () => {
+        registry.register(makeEchoTool());
+        expect(() => registry.register(makeEchoTool())).toThrow('already registered');
+    });
+    it('unregisters tool and subsequent execute returns error', async () => {
+        registry.register(makeEchoTool());
+        expect(registry.get('echo')).toBeDefined();
+        const removed = registry.unregister('echo');
+        expect(removed).toBe(true);
+        expect(registry.get('echo')).toBeUndefined();
+        const result = await registry.execute('echo', { text: 'test' });
+        expect(result.isError).toBe(true);
+    });
+    it('executes multiple tools in sequence (simulates MCP CallTool pattern)', async () => {
+        registry.register(makeEchoTool());
+        registry.register(makeCountTool());
+        // Simulate MCP server handling multiple CallTool requests
+        const r1 = await registry.execute('echo', { text: 'hello' });
+        const r2 = await registry.execute('count-words', { text: 'one two three four' });
+        expect(r1.content[0].text).toBe('Echo: hello');
+        expect(r2.content[0].text).toBe('4');
+    });
+    it('tool handler maintains state across calls', async () => {
+        registry.register(makeStatefulTool());
+        const r1 = await registry.execute('stateful', {});
+        const r2 = await registry.execute('stateful', {});
+        const r3 = await registry.execute('stateful', {});
+        expect(r1.content[0].text).toBe('Call #1');
+        expect(r2.content[0].text).toBe('Call #2');
+        expect(r3.content[0].text).toBe('Call #3');
+    });
+});
+// ---------------------------------------------------------------------------
+// MCP ListTools simulation: registry.list() → filter by enabled
+// ---------------------------------------------------------------------------
+describe('MCP ListTools simulation', () => {
+    it('filters tools by enabled list (simulates MCP server logic)', () => {
+        const registry = new ToolRegistry();
+        registry.register(makeEchoTool());
+        registry.register(makeCountTool());
+        registry.register(makeStatefulTool());
+        const allTools = registry.list();
+        const enabledTools = ['echo', 'stateful'];
+        // Simulate MCP server filtering logic from src/mcp/server.ts
+        const filtered = enabledTools.includes('all')
+            ? allTools
+            : allTools.filter((t) => enabledTools.includes(t.name));
+        expect(filtered).toHaveLength(2);
+        expect(filtered.map((t) => t.name).sort()).toEqual(['echo', 'stateful']);
+    });
+    it('returns all tools when "all" is in enabled list', () => {
+        const registry = new ToolRegistry();
+        registry.register(makeEchoTool());
+        registry.register(makeCountTool());
+        const allTools = registry.list();
+        const enabledTools = ['all'];
+        const filtered = enabledTools.includes('all')
+            ? allTools
+            : allTools.filter((t) => enabledTools.includes(t.name));
+        expect(filtered).toHaveLength(2);
+    });
+    it('maps tools to MCP schema format', () => {
+        const registry = new ToolRegistry();
+        registry.register(makeEchoTool());
+        const tools = registry.list();
+        // Simulate the MCP server response mapping
+        const mcpTools = tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+        expect(mcpTools).toHaveLength(1);
+        expect(mcpTools[0]).toEqual({
+            name: 'echo',
+            description: 'Echoes input text',
+            inputSchema: {
+                type: 'object',
+                properties: { text: { type: 'string' } },
+                required: ['text'],
+            },
+        });
+        // Handler should NOT be in the mapped output
+        expect(mcpTools[0]['handler']).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// MCP CallTool simulation: registry.execute() → handler dispatch
+// ---------------------------------------------------------------------------
+describe('MCP CallTool simulation', () => {
+    it('dispatches tool call and returns structured result', async () => {
+        const registry = new ToolRegistry();
+        registry.register(makeEchoTool());
+        registry.register(makeCountTool());
+        // Simulate MCP CallTool request
+        const req = { name: 'count-words', arguments: { text: 'the quick brown fox' } };
+        const result = await registry.execute(req.name, (req.arguments ?? {}));
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0].type).toBe('text');
+        expect(result.content[0].text).toBe('4');
+    });
+    it('handles null arguments gracefully', async () => {
+        const registry = new ToolRegistry();
+        registry.register(makeCountTool());
+        // MCP spec allows null arguments
+        const result = await registry.execute('count-words', {});
+        expect(result.content[0].text).toBe('0');
+    });
+    it('register → execute → unregister → re-register works', async () => {
+        const registry = new ToolRegistry();
+        registry.register(makeEchoTool());
+        const r1 = await registry.execute('echo', { text: 'first' });
+        expect(r1.content[0].text).toBe('Echo: first');
+        registry.unregister('echo');
+        const r2 = await registry.execute('echo', { text: 'gone' });
+        expect(r2.isError).toBe(true);
+        // Re-register with different handler
+        registry.register({
+            ...makeEchoTool(),
+            handler: async (input) => ({
+                content: [{ type: 'text', text: `V2: ${input.text}` }],
+            }),
+        });
+        const r3 = await registry.execute('echo', { text: 'back' });
+        expect(r3.content[0].text).toBe('V2: back');
+    });
+});
+//# sourceMappingURL=mcp-tool-registry.integration.test.js.map

package/dist/core/mcp-tool-registry.integration.test.js.map

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

package/dist/core/tool-registry.d.ts

@@ -0,0 +1,10 @@
+import type { Tool, ToolResult } from '../types/index.js';
+export declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    unregister(name: string): boolean;
+    get(name: string): Tool | undefined;
+    list(): Tool[];
+    execute(name: string, input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/core/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/core/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2B;IAExC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,IAAI,IAAI,IAAI,EAAE;IAIR,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAUjF"}

package/dist/core/tool-registry.js

@@ -0,0 +1,29 @@
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    unregister(name) {
+        return this.tools.delete(name);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.values());
+    }
+    async execute(name, input) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        return tool.handler(input);
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/core/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/core/tool-registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAExC,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAA8B;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/core/tool-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-registry.test.d.ts.map

package/dist/core/tool-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.d.ts","sourceRoot":"","sources":["../../src/core/tool-registry.test.ts"],"names":[],"mappings":""}

package/dist/core/tool-registry.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ToolRegistry } from './tool-registry.js';
+function makeTool(name, handler) {
+    return {
+        name,
+        description: `Test tool: ${name}`,
+        inputSchema: {},
+        handler: handler ?? (async () => ({
+            content: [{ type: 'text', text: `${name} result` }],
+        })),
+    };
+}
+describe('ToolRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new ToolRegistry();
+    });
+    describe('register', () => {
+        it('registers a tool', () => {
+            const tool = makeTool('test-tool');
+            registry.register(tool);
+            expect(registry.get('test-tool')).toBe(tool);
+        });
+        it('throws on duplicate registration', () => {
+            registry.register(makeTool('dup'));
+            expect(() => registry.register(makeTool('dup'))).toThrow('Tool "dup" is already registered');
+        });
+    });
+    describe('unregister', () => {
+        it('removes a registered tool', () => {
+            registry.register(makeTool('rm'));
+            expect(registry.unregister('rm')).toBe(true);
+            expect(registry.get('rm')).toBeUndefined();
+        });
+        it('returns false for non-existent tool', () => {
+            expect(registry.unregister('nope')).toBe(false);
+        });
+    });
+    describe('get', () => {
+        it('returns undefined for unknown tool', () => {
+            expect(registry.get('unknown')).toBeUndefined();
+        });
+        it('returns the registered tool', () => {
+            const tool = makeTool('findme');
+            registry.register(tool);
+            expect(registry.get('findme')).toBe(tool);
+        });
+    });
+    describe('list', () => {
+        it('returns empty array when no tools registered', () => {
+            expect(registry.list()).toEqual([]);
+        });
+        it('returns all registered tools', () => {
+            registry.register(makeTool('a'));
+            registry.register(makeTool('b'));
+            const names = registry.list().map((t) => t.name);
+            expect(names).toContain('a');
+            expect(names).toContain('b');
+            expect(names).toHaveLength(2);
+        });
+    });
+    describe('execute', () => {
+        it('executes a registered tool handler', async () => {
+            registry.register(makeTool('exec', async (input) => ({
+                content: [{ type: 'text', text: `got: ${JSON.stringify(input)}` }],
+            })));
+            const result = await registry.execute('exec', { key: 'value' });
+            expect(result.isError).toBeUndefined();
+            expect(result.content[0].text).toContain('key');
+        });
+        it('returns error for unknown tool', async () => {
+            const result = await registry.execute('missing', {});
+            expect(result.isError).toBe(true);
+            expect(result.content[0].text).toContain('Unknown tool: missing');
+        });
+    });
+});
+//# sourceMappingURL=tool-registry.test.js.map

package/dist/core/tool-registry.test.js.map

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

package/dist/hooks/constants.d.ts

@@ -0,0 +1,38 @@
+/** Remaining context % at which WARNING is emitted */
+export declare const WARNING_THRESHOLD = 35;
+/** Remaining context % at which CRITICAL is emitted */
+export declare const CRITICAL_THRESHOLD = 25;
+/** Ignore bridge metrics older than this (seconds) */
+export declare const STALE_SECONDS = 60;
+/** Minimum tool uses between repeated warnings */
+export declare const DEBOUNCE_CALLS = 5;
+/** Claude Code reserves ~16.5% for autocompact buffer */
+export declare const AUTO_COMPACT_BUFFER_PCT = 16.5;
+/** Bridge file prefix in os.tmpdir() */
+export declare const BRIDGE_PREFIX = "maestro-ctx-";
+/** Max ms to wait for stdin before exiting (Windows pipe safety) */
+export declare const STDIN_TIMEOUT_MS = 3000;
+/**
+ * ASCII faces by severity level.
+ *
+ *   ^_^  — plenty of context (used < 50%)
+ *   -_-  — getting used      (used 50–65%)
+ *   O_O  — running low       (used 65–80%)
+ *   X_X  — critical          (used >= 80%)
+ */
+export declare const FACES: {
+    readonly happy: "^_^";
+    readonly neutral: "-_-";
+    readonly alert: "O_O";
+    readonly critical: "X_X";
+};
+export type FaceLevel = keyof typeof FACES;
+/** Map used% to face level */
+export declare function getFaceLevel(usedPct: number): FaceLevel;
+/** ANSI color codes by face level */
+export declare const FACE_COLORS: Record<FaceLevel, string>;
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ANSI_DIM = "\u001B[2m";
+export declare const ANSI_BOLD = "\u001B[1m";
+export declare const ANSI_CYAN = "\u001B[36m";
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/hooks/constants.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,sDAAsD;AACtD,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,kDAAkD;AAClD,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wCAAwC;AACxC,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;;;;;CAKR,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAE3C,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAKvD;AAED,qCAAqC;AACrC,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKjD,CAAC;AAEF,eAAO,MAAM,UAAU,cAAY,CAAC;AACpC,eAAO,MAAM,QAAQ,cAAY,CAAC;AAClC,eAAO,MAAM,SAAS,cAAY,CAAC;AACnC,eAAO,MAAM,SAAS,eAAa,CAAC"}

package/dist/hooks/constants.js

@@ -0,0 +1,51 @@
+// Shared constants for maestro hooks
+/** Remaining context % at which WARNING is emitted */
+export const WARNING_THRESHOLD = 35;
+/** Remaining context % at which CRITICAL is emitted */
+export const CRITICAL_THRESHOLD = 25;
+/** Ignore bridge metrics older than this (seconds) */
+export const STALE_SECONDS = 60;
+/** Minimum tool uses between repeated warnings */
+export const DEBOUNCE_CALLS = 5;
+/** Claude Code reserves ~16.5% for autocompact buffer */
+export const AUTO_COMPACT_BUFFER_PCT = 16.5;
+/** Bridge file prefix in os.tmpdir() */
+export const BRIDGE_PREFIX = 'maestro-ctx-';
+/** Max ms to wait for stdin before exiting (Windows pipe safety) */
+export const STDIN_TIMEOUT_MS = 3000;
+/**
+ * ASCII faces by severity level.
+ *
+ *   ^_^  — plenty of context (used < 50%)
+ *   -_-  — getting used      (used 50–65%)
+ *   O_O  — running low       (used 65–80%)
+ *   X_X  — critical          (used >= 80%)
+ */
+export const FACES = {
+    happy: '^_^',
+    neutral: '-_-',
+    alert: 'O_O',
+    critical: 'X_X',
+};
+/** Map used% to face level */
+export function getFaceLevel(usedPct) {
+    if (usedPct < 50)
+        return 'happy';
+    if (usedPct < 65)
+        return 'neutral';
+    if (usedPct < 80)
+        return 'alert';
+    return 'critical';
+}
+/** ANSI color codes by face level */
+export const FACE_COLORS = {
+    happy: '\x1b[32m', // green
+    neutral: '\x1b[33m', // yellow
+    alert: '\x1b[38;5;208m', // orange
+    critical: '\x1b[5;31m', // blinking red
+};
+export const ANSI_RESET = '\x1b[0m';
+export const ANSI_DIM = '\x1b[2m';
+export const ANSI_BOLD = '\x1b[1m';
+export const ANSI_CYAN = '\x1b[36m';
+//# sourceMappingURL=constants.js.map

package/dist/hooks/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/hooks/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAK,KAAK;IACf,OAAO,EAAG,KAAK;IACf,KAAK,EAAK,KAAK;IACf,QAAQ,EAAE,KAAK;CACP,CAAC;AAIX,8BAA8B;AAC9B,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,KAAK,EAAK,UAAU,EAAQ,QAAQ;IACpC,OAAO,EAAG,UAAU,EAAQ,SAAS;IACrC,KAAK,EAAK,gBAAgB,EAAE,SAAS;IACrC,QAAQ,EAAE,YAAY,EAAM,eAAe;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC"}