@timmeck/marketing-brain 0.2.0 → 0.2.1

package/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: timmeck

package/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+
+      - run: npm run build
+
+      - name: Run tests
+        run: npm test
+        if: ${{ hashFiles('vitest.config.*', 'src/**/*.test.ts', 'tests/**/*.test.ts') != '' }}

package/README.md

@@ -1,5 +1,10 @@
 # Marketing Brain
 
+[![npm version](https://img.shields.io/npm/v/@timmeck/marketing-brain)](https://www.npmjs.com/package/@timmeck/marketing-brain)
+[![npm downloads](https://img.shields.io/npm/dm/@timmeck/marketing-brain)](https://www.npmjs.com/package/@timmeck/marketing-brain)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/timmeck/marketing-brain)](https://github.com/timmeck/marketing-brain)
+
 **Self-Learning Marketing Intelligence System for Claude Code**
 
 Marketing Brain is an MCP server that gives Claude Code a persistent marketing memory. It tracks every post you publish, learns what works across platforms, and builds a Hebbian synapse network connecting posts, campaigns, strategies, templates, and insights. Over time, it learns your best-performing patterns and proactively suggests what to post, when, and where.
@@ -189,31 +194,31 @@ These tools are available to Claude Code when Marketing Brain is configured:
 
 ## REST API
 
-Marketing Brain includes a REST API on port 7780 (default).
+Marketing Brain includes a REST API on port 7781 (default).
 
 ```bash
 # Health check
-curl http://localhost:7780/api/v1/health
+curl http://localhost:7781/api/v1/health
 
 # List all available methods
-curl http://localhost:7780/api/v1/methods
+curl http://localhost:7781/api/v1/methods
 
 # Call any method via RPC
-curl -X POST http://localhost:7780/api/v1/rpc \
+curl -X POST http://localhost:7781/api/v1/rpc \
   -H "Content-Type: application/json" \
   -d '{"method": "analytics.summary", "params": {}}'
 ```
 
 ## Dashboard Server
 
-The daemon starts a live dashboard server on port 7782 (default).
+The daemon starts a live dashboard server on port 7783 (default).
 
 ```bash
 # Open the dashboard in your browser
 marketing dashboard
 
 # Or visit directly while the daemon is running
-open http://localhost:7782
+open http://localhost:7783
 ```
 
 Features:
@@ -235,7 +240,7 @@ Features:
          v                        v                        v
 +--------+---------+     +--------+---------+     +--------+---------+
 |   MCP Server     |     |    REST API      |     | Dashboard Server |
-|   (stdio)        |     |   (port 7780)    |     |   (port 7782)    |
+|   (stdio)        |     |   (port 7781)    |     |   (port 7783)    |
 +--------+---------+     +--------+---------+     +--------+---------+
          |                        |                        |
          +----------+-------------+----------+-------------+
@@ -312,7 +317,7 @@ marketing config delete learning.intervalMs
 |---|---|---|
 | `MARKETING_BRAIN_DATA_DIR` | `~/.marketing-brain` | Data directory |
 | `MARKETING_BRAIN_LOG_LEVEL` | `info` | Log level |
-| `MARKETING_BRAIN_API_PORT` | `7780` | REST API port |
+| `MARKETING_BRAIN_API_PORT` | `7781` | REST API port |
 | `MARKETING_BRAIN_API_KEY` | — | API authentication key |
 | `MARKETING_BRAIN_DB_PATH` | `~/.marketing-brain/marketing-brain.db` | Database path |
 
@@ -320,9 +325,9 @@ marketing config delete learning.intervalMs
 
 | Service | Default Port | Description |
 |---|---|---|
-| REST API | 7780 | JSON-RPC endpoint for integrations |
-| MCP HTTP | 7781 | MCP HTTP transport (optional) |
-| Dashboard | 7782 | Live dashboard with SSE |
+| REST API | 7781 | JSON-RPC endpoint for integrations |
+| MCP HTTP | 7782 | MCP HTTP transport (optional) |
+| Dashboard | 7783 | Live dashboard with SSE |
 
 ## Tech Stack
 
@@ -333,9 +338,19 @@ marketing config delete learning.intervalMs
 - **Chalk** — Colored terminal output
 - **Winston** — Structured logging
 
-## Related
+## Brain Ecosystem
+
+Marketing Brain is part of the **Brain Ecosystem** — a family of standalone MCP servers that give Claude Code persistent, self-learning memory.
+
+| Brain | Purpose | Ports |
+|-------|---------|-------|
+| [Brain](https://github.com/timmeck/brain) | Error memory & code intelligence | 7777 / 7778 |
+| [Trading Brain](https://github.com/timmeck/trading-brain) | Adaptive trading intelligence | 7779 / 7780 |
+| **Marketing Brain** | Content strategy & engagement | **7781** / 7782 / 7783 |
+| [Brain Core](https://github.com/timmeck/brain-core) | Shared infrastructure (optional) | — |
+| [Brain Hub](https://timmeck.github.io/brain-hub/) | Ecosystem landing page | — |
 
-- [Brain](https://github.com/timmeck/brain) — Adaptive error memory & code intelligence (same architecture, applied to debugging)
+Each brain is **fully standalone** — [Brain Core](https://www.npmjs.com/package/@timmeck/brain-core) is an optional shared dependency that eliminates code duplication across brains.
 
 ## License
 

package/dist/cli/commands/dashboard.js

@@ -15,7 +15,7 @@ export function dashboardCommand() {
         .option('-o, --output <path>', 'Output HTML file path')
         .option('--no-open', 'Generate HTML but do not open in browser')
         .option('-l, --live', 'Enable live mode (SSE updates from daemon)')
-        .option('-p, --port <n>', 'Dashboard server port for live mode', '7781')
+        .option('-p, --port <n>', 'Dashboard server port for live mode', '7783')
         .action(async (opts) => {
         await withIpc(async (client) => {
             console.log(`${icons.chart}  ${c.info('Generating dashboard...')}`);

package/dist/config.js

@@ -9,15 +9,15 @@ const defaults = {
         timeout: 5000,
     },
     api: {
-        port: 7780,
+        port: 7781,
         enabled: true,
     },
     mcpHttp: {
-        port: 7781,
+        port: 7782,
         enabled: true,
     },
     dashboard: {
-        port: 7782,
+        port: 7783,
         enabled: true,
     },
     learning: {

package/dist/ipc/__tests__/protocol.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ipc/__tests__/protocol.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from 'vitest';
+import { Buffer } from 'node:buffer';
+import { encodeMessage, MessageDecoder } from '../protocol.js';
+const makeMessage = (overrides = {}) => ({
+    id: '1',
+    type: 'request',
+    method: 'ping',
+    ...overrides,
+});
+describe('encodeMessage', () => {
+    it('returns a Buffer', () => {
+        const buf = encodeMessage(makeMessage());
+        expect(Buffer.isBuffer(buf)).toBe(true);
+    });
+    it('prefixes payload with 4-byte big-endian length', () => {
+        const msg = makeMessage();
+        const buf = encodeMessage(msg);
+        const payloadLength = buf.readUInt32BE(0);
+        expect(buf.length).toBe(4 + payloadLength);
+    });
+    it('contains the JSON payload after the length prefix', () => {
+        const msg = makeMessage({ id: 'test-42', method: 'hello' });
+        const buf = encodeMessage(msg);
+        const payloadLength = buf.readUInt32BE(0);
+        const json = buf.subarray(4, 4 + payloadLength).toString('utf8');
+        const parsed = JSON.parse(json);
+        expect(parsed.id).toBe('test-42');
+        expect(parsed.method).toBe('hello');
+        expect(parsed.type).toBe('request');
+    });
+});
+describe('MessageDecoder', () => {
+    it('decodes a single complete message', () => {
+        const decoder = new MessageDecoder();
+        const msg = makeMessage({ id: 'a' });
+        const encoded = encodeMessage(msg);
+        const messages = decoder.feed(encoded);
+        expect(messages).toHaveLength(1);
+        expect(messages[0].id).toBe('a');
+    });
+    it('decodes multiple messages fed at once', () => {
+        const decoder = new MessageDecoder();
+        const buf = Buffer.concat([
+            encodeMessage(makeMessage({ id: '1' })),
+            encodeMessage(makeMessage({ id: '2' })),
+            encodeMessage(makeMessage({ id: '3' })),
+        ]);
+        const messages = decoder.feed(buf);
+        expect(messages).toHaveLength(3);
+        expect(messages.map((m) => m.id)).toEqual(['1', '2', '3']);
+    });
+    it('handles partial messages across multiple feeds', () => {
+        const decoder = new MessageDecoder();
+        const encoded = encodeMessage(makeMessage({ id: 'split' }));
+        // Split in the middle of the payload
+        const mid = Math.floor(encoded.length / 2);
+        const part1 = encoded.subarray(0, mid);
+        const part2 = encoded.subarray(mid);
+        const first = decoder.feed(part1);
+        expect(first).toHaveLength(0);
+        const second = decoder.feed(part2);
+        expect(second).toHaveLength(1);
+        expect(second[0].id).toBe('split');
+    });
+    it('handles chunk split inside the 4-byte length header', () => {
+        const decoder = new MessageDecoder();
+        const encoded = encodeMessage(makeMessage({ id: 'header-split' }));
+        // Only send 2 bytes of the 4-byte header
+        const first = decoder.feed(encoded.subarray(0, 2));
+        expect(first).toHaveLength(0);
+        const second = decoder.feed(encoded.subarray(2));
+        expect(second).toHaveLength(1);
+        expect(second[0].id).toBe('header-split');
+    });
+    it('returns empty array when buffer has incomplete data', () => {
+        const decoder = new MessageDecoder();
+        // Just 3 bytes -- not even enough for the length header
+        const partial = Buffer.from([0x00, 0x00, 0x00]);
+        expect(decoder.feed(partial)).toHaveLength(0);
+    });
+    it('reset clears internal buffer', () => {
+        const decoder = new MessageDecoder();
+        const encoded = encodeMessage(makeMessage({ id: 'before-reset' }));
+        // Feed partial data, then reset
+        decoder.feed(encoded.subarray(0, 5));
+        decoder.reset();
+        // Now feed a fresh complete message
+        const messages = decoder.feed(encodeMessage(makeMessage({ id: 'after-reset' })));
+        expect(messages).toHaveLength(1);
+        expect(messages[0].id).toBe('after-reset');
+    });
+    it('preserves leftover bytes for next feed', () => {
+        const decoder = new MessageDecoder();
+        const msg1 = encodeMessage(makeMessage({ id: 'first' }));
+        const msg2 = encodeMessage(makeMessage({ id: 'second' }));
+        // Feed first message + partial second message
+        const combined = Buffer.concat([msg1, msg2.subarray(0, 6)]);
+        const first = decoder.feed(combined);
+        expect(first).toHaveLength(1);
+        expect(first[0].id).toBe('first');
+        // Feed rest of second message
+        const second = decoder.feed(msg2.subarray(6));
+        expect(second).toHaveLength(1);
+        expect(second[0].id).toBe('second');
+    });
+    it('round-trips all IpcMessage fields', () => {
+        const decoder = new MessageDecoder();
+        const msg = {
+            id: 'rt-1',
+            type: 'response',
+            result: { status: 'ok', data: [1, 2, 3] },
+        };
+        const messages = decoder.feed(encodeMessage(msg));
+        expect(messages).toHaveLength(1);
+        expect(messages[0]).toEqual(msg);
+    });
+    it('round-trips error messages', () => {
+        const decoder = new MessageDecoder();
+        const msg = {
+            id: 'err-1',
+            type: 'response',
+            error: { code: -1, message: 'something went wrong' },
+        };
+        const messages = decoder.feed(encodeMessage(msg));
+        expect(messages).toHaveLength(1);
+        expect(messages[0]).toEqual(msg);
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/ipc/__tests__/protocol.test.js.map

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

package/dist/utils/__tests__/hash.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/__tests__/hash.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { sha256 } from '../hash.js';
+describe('sha256', () => {
+    it('returns a 64-character hex string', () => {
+        const result = sha256('hello');
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[0-9a-f]{64}$/);
+    });
+    it('produces correct hash for known input', () => {
+        // SHA-256 of "hello" is well-known
+        expect(sha256('hello')).toBe('2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824');
+    });
+    it('produces different hashes for different inputs', () => {
+        expect(sha256('foo')).not.toBe(sha256('bar'));
+    });
+    it('produces the same hash for the same input', () => {
+        expect(sha256('deterministic')).toBe(sha256('deterministic'));
+    });
+    it('handles empty string', () => {
+        const result = sha256('');
+        expect(result).toHaveLength(64);
+        expect(result).toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855');
+    });
+    it('handles unicode input', () => {
+        const result = sha256('Hallo Welt! 🚀');
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[0-9a-f]{64}$/);
+    });
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/utils/__tests__/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/hash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,mCAAmC;QACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC1B,kEAAkE,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACjB,kEAAkE,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/__tests__/paths.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/__tests__/paths.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import path from 'node:path';
+import os from 'node:os';
+import { normalizePath, getDataDir, getPipeName } from '../paths.js';
+describe('normalizePath', () => {
+    it('converts backslashes to forward slashes', () => {
+        expect(normalizePath('C:\\Users\\test\\file.txt')).toBe('C:/Users/test/file.txt');
+    });
+    it('leaves forward slashes unchanged', () => {
+        expect(normalizePath('/home/user/file.txt')).toBe('/home/user/file.txt');
+    });
+    it('handles mixed separators', () => {
+        expect(normalizePath('src\\utils/hash.ts')).toBe('src/utils/hash.ts');
+    });
+    it('handles empty string', () => {
+        expect(normalizePath('')).toBe('');
+    });
+    it('handles path with no separators', () => {
+        expect(normalizePath('file.txt')).toBe('file.txt');
+    });
+});
+describe('getDataDir', () => {
+    const originalEnv = process.env['MARKETING_BRAIN_DATA_DIR'];
+    afterEach(() => {
+        if (originalEnv !== undefined) {
+            process.env['MARKETING_BRAIN_DATA_DIR'] = originalEnv;
+        }
+        else {
+            delete process.env['MARKETING_BRAIN_DATA_DIR'];
+        }
+    });
+    it('returns env-based directory when MARKETING_BRAIN_DATA_DIR is set', () => {
+        process.env['MARKETING_BRAIN_DATA_DIR'] = '/custom/data';
+        const result = getDataDir();
+        expect(result).toBe(path.resolve('/custom/data'));
+    });
+    it('returns homedir-based directory when env is not set', () => {
+        delete process.env['MARKETING_BRAIN_DATA_DIR'];
+        const result = getDataDir();
+        expect(result).toBe(path.join(os.homedir(), '.marketing-brain'));
+    });
+});
+describe('getPipeName', () => {
+    it('uses default name when no argument is given', () => {
+        const result = getPipeName();
+        if (process.platform === 'win32') {
+            expect(result).toBe('\\\\.\\pipe\\marketing-brain');
+        }
+        else {
+            expect(result).toBe(path.join(os.tmpdir(), 'marketing-brain.sock'));
+        }
+    });
+    it('uses custom name when provided', () => {
+        const result = getPipeName('my-app');
+        if (process.platform === 'win32') {
+            expect(result).toBe('\\\\.\\pipe\\my-app');
+        }
+        else {
+            expect(result).toBe(path.join(os.tmpdir(), 'my-app.sock'));
+        }
+    });
+});
+//# sourceMappingURL=paths.test.js.map

package/dist/utils/__tests__/paths.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/marketing-brain",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Self-learning marketing intelligence system with Hebbian synapse network",
   "type": "module",
   "main": "dist/index.js",

package/src/cli/commands/dashboard.ts

@@ -18,7 +18,7 @@ export function dashboardCommand(): Command {
     .option('-o, --output <path>', 'Output HTML file path')
     .option('--no-open', 'Generate HTML but do not open in browser')
     .option('-l, --live', 'Enable live mode (SSE updates from daemon)')
-    .option('-p, --port <n>', 'Dashboard server port for live mode', '7781')
+    .option('-p, --port <n>', 'Dashboard server port for live mode', '7783')
     .action(async (opts) => {
       await withIpc(async (client) => {
         console.log(`${icons.chart}  ${c.info('Generating dashboard...')}`);

package/src/config.ts

@@ -11,15 +11,15 @@ const defaults: MarketingBrainConfig = {
     timeout: 5000,
   },
   api: {
-    port: 7780,
+    port: 7781,
     enabled: true,
   },
   mcpHttp: {
-    port: 7781,
+    port: 7782,
     enabled: true,
   },
   dashboard: {
-    port: 7782,
+    port: 7783,
     enabled: true,
   },
   learning: {

package/src/ipc/__tests__/protocol.test.ts

@@ -0,0 +1,153 @@
+import { describe, it, expect } from 'vitest';
+import { Buffer } from 'node:buffer';
+import { encodeMessage, MessageDecoder } from '../protocol.js';
+import type { IpcMessage } from '../../types/ipc.types.js';
+
+const makeMessage = (overrides: Partial<IpcMessage> = {}): IpcMessage => ({
+  id: '1',
+  type: 'request',
+  method: 'ping',
+  ...overrides,
+});
+
+describe('encodeMessage', () => {
+  it('returns a Buffer', () => {
+    const buf = encodeMessage(makeMessage());
+    expect(Buffer.isBuffer(buf)).toBe(true);
+  });
+
+  it('prefixes payload with 4-byte big-endian length', () => {
+    const msg = makeMessage();
+    const buf = encodeMessage(msg);
+    const payloadLength = buf.readUInt32BE(0);
+    expect(buf.length).toBe(4 + payloadLength);
+  });
+
+  it('contains the JSON payload after the length prefix', () => {
+    const msg = makeMessage({ id: 'test-42', method: 'hello' });
+    const buf = encodeMessage(msg);
+    const payloadLength = buf.readUInt32BE(0);
+    const json = buf.subarray(4, 4 + payloadLength).toString('utf8');
+    const parsed = JSON.parse(json);
+    expect(parsed.id).toBe('test-42');
+    expect(parsed.method).toBe('hello');
+    expect(parsed.type).toBe('request');
+  });
+});
+
+describe('MessageDecoder', () => {
+  it('decodes a single complete message', () => {
+    const decoder = new MessageDecoder();
+    const msg = makeMessage({ id: 'a' });
+    const encoded = encodeMessage(msg);
+
+    const messages = decoder.feed(encoded);
+    expect(messages).toHaveLength(1);
+    expect(messages[0].id).toBe('a');
+  });
+
+  it('decodes multiple messages fed at once', () => {
+    const decoder = new MessageDecoder();
+    const buf = Buffer.concat([
+      encodeMessage(makeMessage({ id: '1' })),
+      encodeMessage(makeMessage({ id: '2' })),
+      encodeMessage(makeMessage({ id: '3' })),
+    ]);
+
+    const messages = decoder.feed(buf);
+    expect(messages).toHaveLength(3);
+    expect(messages.map((m) => m.id)).toEqual(['1', '2', '3']);
+  });
+
+  it('handles partial messages across multiple feeds', () => {
+    const decoder = new MessageDecoder();
+    const encoded = encodeMessage(makeMessage({ id: 'split' }));
+
+    // Split in the middle of the payload
+    const mid = Math.floor(encoded.length / 2);
+    const part1 = encoded.subarray(0, mid);
+    const part2 = encoded.subarray(mid);
+
+    const first = decoder.feed(part1);
+    expect(first).toHaveLength(0);
+
+    const second = decoder.feed(part2);
+    expect(second).toHaveLength(1);
+    expect(second[0].id).toBe('split');
+  });
+
+  it('handles chunk split inside the 4-byte length header', () => {
+    const decoder = new MessageDecoder();
+    const encoded = encodeMessage(makeMessage({ id: 'header-split' }));
+
+    // Only send 2 bytes of the 4-byte header
+    const first = decoder.feed(encoded.subarray(0, 2));
+    expect(first).toHaveLength(0);
+
+    const second = decoder.feed(encoded.subarray(2));
+    expect(second).toHaveLength(1);
+    expect(second[0].id).toBe('header-split');
+  });
+
+  it('returns empty array when buffer has incomplete data', () => {
+    const decoder = new MessageDecoder();
+    // Just 3 bytes -- not even enough for the length header
+    const partial = Buffer.from([0x00, 0x00, 0x00]);
+    expect(decoder.feed(partial)).toHaveLength(0);
+  });
+
+  it('reset clears internal buffer', () => {
+    const decoder = new MessageDecoder();
+    const encoded = encodeMessage(makeMessage({ id: 'before-reset' }));
+
+    // Feed partial data, then reset
+    decoder.feed(encoded.subarray(0, 5));
+    decoder.reset();
+
+    // Now feed a fresh complete message
+    const messages = decoder.feed(encodeMessage(makeMessage({ id: 'after-reset' })));
+    expect(messages).toHaveLength(1);
+    expect(messages[0].id).toBe('after-reset');
+  });
+
+  it('preserves leftover bytes for next feed', () => {
+    const decoder = new MessageDecoder();
+    const msg1 = encodeMessage(makeMessage({ id: 'first' }));
+    const msg2 = encodeMessage(makeMessage({ id: 'second' }));
+
+    // Feed first message + partial second message
+    const combined = Buffer.concat([msg1, msg2.subarray(0, 6)]);
+    const first = decoder.feed(combined);
+    expect(first).toHaveLength(1);
+    expect(first[0].id).toBe('first');
+
+    // Feed rest of second message
+    const second = decoder.feed(msg2.subarray(6));
+    expect(second).toHaveLength(1);
+    expect(second[0].id).toBe('second');
+  });
+
+  it('round-trips all IpcMessage fields', () => {
+    const decoder = new MessageDecoder();
+    const msg: IpcMessage = {
+      id: 'rt-1',
+      type: 'response',
+      result: { status: 'ok', data: [1, 2, 3] },
+    };
+    const messages = decoder.feed(encodeMessage(msg));
+    expect(messages).toHaveLength(1);
+    expect(messages[0]).toEqual(msg);
+  });
+
+  it('round-trips error messages', () => {
+    const decoder = new MessageDecoder();
+    const msg: IpcMessage = {
+      id: 'err-1',
+      type: 'response',
+      error: { code: -1, message: 'something went wrong' },
+    };
+    const messages = decoder.feed(encodeMessage(msg));
+    expect(messages).toHaveLength(1);
+    expect(messages[0]).toEqual(msg);
+  });
+});

package/src/utils/__tests__/hash.test.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { sha256 } from '../hash.js';
+
+describe('sha256', () => {
+  it('returns a 64-character hex string', () => {
+    const result = sha256('hello');
+    expect(result).toHaveLength(64);
+    expect(result).toMatch(/^[0-9a-f]{64}$/);
+  });
+
+  it('produces correct hash for known input', () => {
+    // SHA-256 of "hello" is well-known
+    expect(sha256('hello')).toBe(
+      '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+    );
+  });
+
+  it('produces different hashes for different inputs', () => {
+    expect(sha256('foo')).not.toBe(sha256('bar'));
+  });
+
+  it('produces the same hash for the same input', () => {
+    expect(sha256('deterministic')).toBe(sha256('deterministic'));
+  });
+
+  it('handles empty string', () => {
+    const result = sha256('');
+    expect(result).toHaveLength(64);
+    expect(result).toBe(
+      'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'
+    );
+  });
+
+  it('handles unicode input', () => {
+    const result = sha256('Hallo Welt! 🚀');
+    expect(result).toHaveLength(64);
+    expect(result).toMatch(/^[0-9a-f]{64}$/);
+  });
+});

package/src/utils/__tests__/paths.test.ts

@@ -0,0 +1,70 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import path from 'node:path';
+import os from 'node:os';
+import { normalizePath, getDataDir, getPipeName } from '../paths.js';
+
+describe('normalizePath', () => {
+  it('converts backslashes to forward slashes', () => {
+    expect(normalizePath('C:\\Users\\test\\file.txt')).toBe('C:/Users/test/file.txt');
+  });
+
+  it('leaves forward slashes unchanged', () => {
+    expect(normalizePath('/home/user/file.txt')).toBe('/home/user/file.txt');
+  });
+
+  it('handles mixed separators', () => {
+    expect(normalizePath('src\\utils/hash.ts')).toBe('src/utils/hash.ts');
+  });
+
+  it('handles empty string', () => {
+    expect(normalizePath('')).toBe('');
+  });
+
+  it('handles path with no separators', () => {
+    expect(normalizePath('file.txt')).toBe('file.txt');
+  });
+});
+
+describe('getDataDir', () => {
+  const originalEnv = process.env['MARKETING_BRAIN_DATA_DIR'];
+
+  afterEach(() => {
+    if (originalEnv !== undefined) {
+      process.env['MARKETING_BRAIN_DATA_DIR'] = originalEnv;
+    } else {
+      delete process.env['MARKETING_BRAIN_DATA_DIR'];
+    }
+  });
+
+  it('returns env-based directory when MARKETING_BRAIN_DATA_DIR is set', () => {
+    process.env['MARKETING_BRAIN_DATA_DIR'] = '/custom/data';
+    const result = getDataDir();
+    expect(result).toBe(path.resolve('/custom/data'));
+  });
+
+  it('returns homedir-based directory when env is not set', () => {
+    delete process.env['MARKETING_BRAIN_DATA_DIR'];
+    const result = getDataDir();
+    expect(result).toBe(path.join(os.homedir(), '.marketing-brain'));
+  });
+});
+
+describe('getPipeName', () => {
+  it('uses default name when no argument is given', () => {
+    const result = getPipeName();
+    if (process.platform === 'win32') {
+      expect(result).toBe('\\\\.\\pipe\\marketing-brain');
+    } else {
+      expect(result).toBe(path.join(os.tmpdir(), 'marketing-brain.sock'));
+    }
+  });
+
+  it('uses custom name when provided', () => {
+    const result = getPipeName('my-app');
+    if (process.platform === 'win32') {
+      expect(result).toBe('\\\\.\\pipe\\my-app');
+    } else {
+      expect(result).toBe(path.join(os.tmpdir(), 'my-app.sock'));
+    }
+  });
+});