devharness 0.8.0

package/build/issue-tracker.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fsp } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { setWorkingDirOverride } from './helpers/paths.js';
+import { __resetForTests, addIssue, getIssue, getIssues, addIssueComment, getIssueItemsDir, } from './issue-tracker.js';
+let tempDir;
+beforeEach(async () => {
+    tempDir = await fsp.mkdtemp(join(tmpdir(), 'cdp-tools-issue-test-'));
+    setWorkingDirOverride(tempDir);
+    __resetForTests();
+});
+afterEach(async () => {
+    __resetForTests();
+    await fsp.rm(tempDir, { recursive: true, force: true });
+});
+describe('issue-tracker', () => {
+    it('round-trips title/body/labels through frontmatter, including special characters', async () => {
+        const created = await addIssue({
+            type: 'bug',
+            title: 'Bug: submit fails "hard" & breaks',
+            body: '## Steps\n1. Click submit\n2. Watch it fail',
+            labels: ['ui', 'checkout'],
+        });
+        // Drop the in-memory index and re-read straight from disk to actually
+        // exercise the serialize -> file -> parse round trip.
+        __resetForTests();
+        const reloaded = await getIssue(created.id);
+        expect(reloaded).toBeDefined();
+        expect(reloaded.title).toBe('Bug: submit fails "hard" & breaks');
+        expect(reloaded.body).toBe('## Steps\n1. Click submit\n2. Watch it fail');
+        expect(reloaded.labels).toEqual(['ui', 'checkout']);
+        expect(reloaded.type).toBe('bug');
+        expect(reloaded.status).toBe('pending');
+    });
+    it('round-trips multiple comments, preserving order and markdown content', async () => {
+        const issue = await addIssue({ type: 'feature', title: 'Add dark mode' });
+        await addIssueComment(issue.id, 'First: tried on Chrome, works.');
+        await addIssueComment(issue.id, '```js\nconsole.log("ok")\n```\nFixed in commit abc123.');
+        __resetForTests();
+        const reloaded = await getIssue(issue.id);
+        expect(reloaded.comments).toHaveLength(2);
+        expect(reloaded.comments[0].text).toBe('First: tried on Chrome, works.');
+        expect(reloaded.comments[1].text).toBe('```js\nconsole.log("ok")\n```\nFixed in commit abc123.');
+        expect(reloaded.comments[0].timestamp.getTime()).toBeLessThanOrEqual(reloaded.comments[1].timestamp.getTime());
+    });
+    it('migrates a legacy issues.csv into one .md file per row and renames it to .bak', async () => {
+        const issuesDir = join(tempDir, '.cdp-tools', 'issues');
+        await fsp.mkdir(issuesDir, { recursive: true });
+        const csvHeader = 'id,type,status,description,sequence_file,start_url,reported_at,acknowledged_at,started_at,resolved_at,recording_name';
+        const csvRow = '1,bug,pending,"Login button, does ""nothing""",,http://localhost:3000,2026-01-01T00:00:00.000Z,,,,manual';
+        await fsp.writeFile(join(issuesDir, 'issues.csv'), `${csvHeader}\n${csvRow}\n`, 'utf-8');
+        const issues = await getIssues({ includeCompleted: true });
+        expect(issues).toHaveLength(1);
+        expect(issues[0].title).toBe('Login button, does "nothing"');
+        expect(issues[0].body).toBe('');
+        expect(issues[0].type).toBe('bug');
+        expect(issues[0].status).toBe('pending');
+        const items = await fsp.readdir(join(issuesDir, 'items'));
+        expect(items.filter(f => f.endsWith('.md'))).toHaveLength(1);
+        await expect(fsp.access(join(issuesDir, 'issues.csv.bak'))).resolves.toBeUndefined();
+        await expect(fsp.access(join(issuesDir, 'issues.csv'))).rejects.toThrow();
+    });
+    it('picks up an externally-written issue file after the debounce window', async () => {
+        // Prime the index/watcher with an initial (empty) load.
+        await getIssues();
+        const itemsDir = getIssueItemsDir();
+        await fsp.mkdir(itemsDir, { recursive: true });
+        const externalFile = [
+            '---',
+            'id: 42',
+            'type: feature',
+            'status: pending',
+            'title: "Externally added issue"',
+            'reportedAt: 2026-01-01T00:00:00.000Z',
+            '---',
+            '',
+            'Added directly to disk, not through addIssue().',
+            '',
+        ].join('\n');
+        await fsp.writeFile(join(itemsDir, 'feature-042-externally-added-issue.md'), externalFile, 'utf-8');
+        // Wait past the debounce window for the watcher's rescan to land.
+        await new Promise(resolve => setTimeout(resolve, 500));
+        const issues = await getIssues();
+        expect(issues.some(i => i.id === 42 && i.title === 'Externally added issue')).toBe(true);
+    });
+});
+//# sourceMappingURL=issue-tracker.test.js.map

package/build/issue-tracker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-tracker.test.js","sourceRoot":"","sources":["../src/issue-tracker.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACrE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,eAAe,EAAE,CAAC;IAClB,MAAM,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;YAC7B,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,mCAAmC;YAC1C,IAAI,EAAE,6CAA6C;YACnD,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;SAC3B,CAAC,CAAC;QAEH,sEAAsE;QACtE,sDAAsD;QACtD,eAAe,EAAE,CAAC;QAElB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAClE,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC3E,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAC1E,MAAM,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,gCAAgC,CAAC,CAAC;QAClE,MAAM,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,wDAAwD,CAAC,CAAC;QAE1F,eAAe,EAAE,CAAC;QAElB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC1E,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QAClG,MAAM,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,mBAAmB,CACnE,QAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,sHAAsH,CAAC;QACzI,MAAM,MAAM,GAAG,0GAA0G,CAAC;QAC1H,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,SAAS,KAAK,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE7D,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACrF,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,wDAAwD;QACxD,MAAM,SAAS,EAAE,CAAC;QAElB,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG;YACnB,KAAK;YACL,QAAQ;YACR,eAAe;YACf,iBAAiB;YACjB,iCAAiC;YACjC,sCAAsC;YACtC,KAAK;YACL,EAAE;YACF,iDAAiD;YACjD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,uCAAuC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAEpG,kEAAkE;QAClE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/launch-chrome-port.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Regression tests for bug-005: launchChrome silently discarded an explicit
+ * `port` when `forceNewInstance` was set, and skipped the reference-reuse
+ * check so two Chrome instances could share one reference.
+ *
+ * The handler lives in src/index.ts, which calls main() on import and so can
+ * never be imported by a unit test. These tests used to work around that by
+ * grepping the handler SOURCE for fragments like `'if (explicitPort !== undefined)'`
+ * - which asserted nothing about behaviour and would have passed under any
+ * logic bug that kept the tokens. The decision is now a pure exported function
+ * (resolveLaunchPort) that the handler delegates to, and these tests execute it.
+ */
+export {};
+//# sourceMappingURL=launch-chrome-port.test.d.ts.map

package/build/launch-chrome-port.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-chrome-port.test.d.ts","sourceRoot":"","sources":["../src/launch-chrome-port.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/build/launch-chrome-port.test.js

@@ -0,0 +1,97 @@
+/**
+ * Regression tests for bug-005: launchChrome silently discarded an explicit
+ * `port` when `forceNewInstance` was set, and skipped the reference-reuse
+ * check so two Chrome instances could share one reference.
+ *
+ * The handler lives in src/index.ts, which calls main() on import and so can
+ * never be imported by a unit test. These tests used to work around that by
+ * grepping the handler SOURCE for fragments like `'if (explicitPort !== undefined)'`
+ * - which asserted nothing about behaviour and would have passed under any
+ * logic bug that kept the tokens. The decision is now a pure exported function
+ * (resolveLaunchPort) that the handler delegates to, and these tests execute it.
+ */
+import { describe, it, expect } from 'vitest';
+import { resolveLaunchPort } from './chrome-launcher.js';
+import { getErrorMessage, getMessageCode } from './messages.js';
+/** resolveLaunchPort input with recording stubs; override per test. */
+function makeRequest(overrides = {}) {
+    const calls = { occupancyChecks: [], freePortLookups: 0 };
+    const req = {
+        reservedPort: 9222,
+        isPortOccupied: async (port) => {
+            calls.occupancyChecks.push(port);
+            return false;
+        },
+        findFreePort: async () => {
+            calls.freePortLookups++;
+            return 9333;
+        },
+        ...overrides,
+    };
+    return { req, calls };
+}
+describe('resolveLaunchPort (bug-005)', () => {
+    it('uses this session\'s reserved port when no port was given', async () => {
+        const { req, calls } = makeRequest();
+        expect(await resolveLaunchPort(req)).toEqual({ decision: 'use', port: 9222 });
+        expect(calls.freePortLookups).toBe(0);
+        expect(calls.occupancyChecks).toEqual([]);
+    });
+    it('honours an explicit port without probing it when not forcing', async () => {
+        const { req, calls } = makeRequest({ explicitPort: 9555 });
+        expect(await resolveLaunchPort(req)).toEqual({ decision: 'use', port: 9555 });
+        // Reusing whatever is on that port is the point when not forcing a new one
+        expect(calls.occupancyChecks).toEqual([]);
+    });
+    it('picks a free port for forceNewInstance without an explicit port', async () => {
+        const { req, calls } = makeRequest({ forceNewInstance: true });
+        expect(await resolveLaunchPort(req)).toEqual({ decision: 'use', port: 9333 });
+        expect(calls.freePortLookups).toBe(1);
+    });
+    it('honours a free explicit port under forceNewInstance instead of relocating', async () => {
+        const { req, calls } = makeRequest({ explicitPort: 9555, forceNewInstance: true });
+        expect(await resolveLaunchPort(req)).toEqual({ decision: 'use', port: 9555 });
+        expect(calls.occupancyChecks).toEqual([9555]);
+        // The bug: it fell back to auto-selection and launched somewhere else
+        expect(calls.freePortLookups).toBe(0);
+    });
+    it('errors instead of relocating when the forced explicit port is taken', async () => {
+        const { req, calls } = makeRequest({
+            explicitPort: 9555,
+            forceNewInstance: true,
+            isPortOccupied: async () => true,
+        });
+        expect(await resolveLaunchPort(req)).toEqual({ decision: 'forced-port-in-use', port: 9555 });
+        expect(calls.freePortLookups).toBe(0);
+    });
+    it('never silently substitutes another port for an explicit one', async () => {
+        for (const forceNewInstance of [false, true]) {
+            for (const occupied of [false, true]) {
+                const { req } = makeRequest({
+                    explicitPort: 9555,
+                    forceNewInstance,
+                    isPortOccupied: async () => occupied,
+                });
+                const result = await resolveLaunchPort(req);
+                expect(result.port).toBe(9555);
+            }
+        }
+    });
+});
+describe('bug-005 error templates', () => {
+    it('renders CHROME_FORCED_PORT_IN_USE with the requested port', () => {
+        const message = getErrorMessage('CHROME_FORCED_PORT_IN_USE', { port: '9223' });
+        expect(message).not.toContain('Message not found');
+        expect(message).toContain('9223');
+        expect(message).not.toContain('{{');
+        expect(getMessageCode('CHROME_FORCED_PORT_IN_USE')).toBe('PORT_IN_USE');
+    });
+    it('renders CHROME_REFERENCE_ALREADY_BOUND with the reference name', () => {
+        const message = getErrorMessage('CHROME_REFERENCE_ALREADY_BOUND', { reference: 'device a one' });
+        expect(message).not.toContain('Message not found');
+        expect(message).toContain('device a one');
+        expect(message).not.toContain('{{');
+        expect(getMessageCode('CHROME_REFERENCE_ALREADY_BOUND')).toBe('REFERENCE_IN_USE');
+    });
+});
+//# sourceMappingURL=launch-chrome-port.test.js.map

package/build/launch-chrome-port.test.js.map

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

package/build/log-processor/orchestrator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Log-processor Orchestrator — STUB.
+ *
+ * The real implementation was never committed to the repo: post-v0.4.1 commits
+ * wired it into `index.ts` (and the dashboard hub) but the `src/log-processor/`
+ * directory and `src/tools/plugin-tools.ts` were never `git add`ed. This stub
+ * reproduces the *interface* inferred from those call sites so the project builds
+ * and runs with the log-processor feature inert. Replace with the real engine —
+ * a config-driven pipeline of classifiers / extractors / state-machines over live
+ * MCP session logs, loaded from `.cdp-tools/config/{classifiers,extractors,
+ * state-machines,dashboard}/` — to restore it.
+ */
+import type { SessionDetector } from '../session-detector.js';
+export interface OrchestratorSource {
+    /** Where logs come from. Only 'live' (via a SessionDetector) is wired today. */
+    mode: 'live';
+    sessionDetector: SessionDetector;
+}
+export interface OrchestratorOptions {
+    source: OrchestratorSource;
+    /** Root config dir (`.cdp-tools/config`) holding the plugin subdirectories. */
+    configDir: string;
+}
+export declare class Orchestrator {
+    private readonly options;
+    constructor(options: OrchestratorOptions);
+    /** Begin processing logs from the configured source. No-op in the stub. */
+    start(): Promise<void>;
+    /** Stop processing. No-op in the stub. */
+    stop(): void;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/build/log-processor/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/log-processor/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEzD,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,0CAA0C;IAC1C,IAAI,IAAI,IAAI;CAGb"}

package/build/log-processor/orchestrator.js

@@ -0,0 +1,27 @@
+/**
+ * Log-processor Orchestrator — STUB.
+ *
+ * The real implementation was never committed to the repo: post-v0.4.1 commits
+ * wired it into `index.ts` (and the dashboard hub) but the `src/log-processor/`
+ * directory and `src/tools/plugin-tools.ts` were never `git add`ed. This stub
+ * reproduces the *interface* inferred from those call sites so the project builds
+ * and runs with the log-processor feature inert. Replace with the real engine —
+ * a config-driven pipeline of classifiers / extractors / state-machines over live
+ * MCP session logs, loaded from `.cdp-tools/config/{classifiers,extractors,
+ * state-machines,dashboard}/` — to restore it.
+ */
+export class Orchestrator {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Begin processing logs from the configured source. No-op in the stub. */
+    async start() {
+        // intentionally inert — see file header
+    }
+    /** Stop processing. No-op in the stub. */
+    stop() {
+        // intentionally inert — see file header
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/build/log-processor/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/log-processor/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAE7D,2EAA2E;IAC3E,KAAK,CAAC,KAAK;QACT,wCAAwC;IAC1C,CAAC;IAED,0CAA0C;IAC1C,IAAI;QACF,wCAAwC;IAC1C,CAAC;CACF"}

package/build/logpoint-execution-tracker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Logpoint Execution Tracker
+ * Monitors logpoint executions and enforces execution limits
+ */
+import type { StoredConsoleMessage } from './console-monitor.js';
+export interface LogpointMetadata {
+    breakpointId: string;
+    url: string;
+    lineNumber: number;
+    logMessage: string;
+    maxExecutions: number;
+    executionCount: number;
+    logs: StoredConsoleMessage[];
+}
+export type LimitExceededCallback = (metadata: LogpointMetadata) => void;
+export declare class LogpointExecutionTracker {
+    private logpoints;
+    private onLimitExceeded;
+    /**
+     * Register a new logpoint for tracking
+     */
+    registerLogpoint(breakpointId: string, url: string, lineNumber: number, logMessage: string, maxExecutions: number): void;
+    /**
+     * Unregister a logpoint
+     */
+    unregisterLogpoint(breakpointId: string): void;
+    /**
+     * Reset the execution counter for a logpoint
+     */
+    resetCounter(breakpointId: string): void;
+    /**
+     * Get metadata for a specific logpoint
+     */
+    getLogpoint(breakpointId: string): LogpointMetadata | undefined;
+    /**
+     * Get all registered logpoints
+     */
+    getAllLogpoints(): LogpointMetadata[];
+    /**
+     * Set the callback to invoke when a logpoint exceeds its limit
+     */
+    setLimitExceededCallback(callback: LimitExceededCallback): void;
+    /**
+     * Handle a console message - check if it's from a logpoint
+     * This should be called by ConsoleMonitor when a message is added
+     */
+    handleConsoleMessage(message: StoredConsoleMessage): void;
+    /**
+     * Helper to match URLs (handle file:// vs http:// and normalization)
+     */
+    private urlsMatch;
+    /**
+     * Clear all tracked logpoints
+     */
+    clear(): void;
+}
+//# sourceMappingURL=logpoint-execution-tracker.d.ts.map

package/build/logpoint-execution-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logpoint-execution-tracker.d.ts","sourceRoot":"","sources":["../src/logpoint-execution-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEzE,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,eAAe,CAAsC;IAE7D;;OAEG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,IAAI;IAYP;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI9C;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/D;;OAEG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAIrC;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAI/D;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IA2CzD;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/build/logpoint-execution-tracker.js

@@ -0,0 +1,112 @@
+/**
+ * Logpoint Execution Tracker
+ * Monitors logpoint executions and enforces execution limits
+ */
+export class LogpointExecutionTracker {
+    logpoints = new Map();
+    onLimitExceeded = null;
+    /**
+     * Register a new logpoint for tracking
+     */
+    registerLogpoint(breakpointId, url, lineNumber, logMessage, maxExecutions) {
+        this.logpoints.set(breakpointId, {
+            breakpointId,
+            url,
+            lineNumber,
+            logMessage,
+            maxExecutions,
+            executionCount: 0,
+            logs: [],
+        });
+    }
+    /**
+     * Unregister a logpoint
+     */
+    unregisterLogpoint(breakpointId) {
+        this.logpoints.delete(breakpointId);
+    }
+    /**
+     * Reset the execution counter for a logpoint
+     */
+    resetCounter(breakpointId) {
+        const metadata = this.logpoints.get(breakpointId);
+        if (metadata) {
+            metadata.executionCount = 0;
+            metadata.logs = [];
+        }
+    }
+    /**
+     * Get metadata for a specific logpoint
+     */
+    getLogpoint(breakpointId) {
+        return this.logpoints.get(breakpointId);
+    }
+    /**
+     * Get all registered logpoints
+     */
+    getAllLogpoints() {
+        return Array.from(this.logpoints.values());
+    }
+    /**
+     * Set the callback to invoke when a logpoint exceeds its limit
+     */
+    setLimitExceededCallback(callback) {
+        this.onLimitExceeded = callback;
+    }
+    /**
+     * Handle a console message - check if it's from a logpoint
+     * This should be called by ConsoleMonitor when a message is added
+     */
+    handleConsoleMessage(message) {
+        // Check if this is a logpoint message
+        if (!message.text.startsWith('[Logpoint]')) {
+            return;
+        }
+        // Parse location from message text since console messages from breakpoint conditions
+        // don't preserve the original source location
+        // Format: "[Logpoint] file:///path/to/file.js:12:auto: message..."
+        const locationMatch = message.text.match(/\[Logpoint\]\s+(.+?):(\d+)(?::(?:auto|\d+))?:/);
+        if (!locationMatch) {
+            return;
+        }
+        const messageUrl = locationMatch[1];
+        const messageLine = parseInt(locationMatch[2], 10);
+        // Find the logpoint that matches this location
+        for (const metadata of this.logpoints.values()) {
+            // Compare URL and line number
+            if (this.urlsMatch(messageUrl, metadata.url) &&
+                messageLine === metadata.lineNumber) {
+                // Increment execution count
+                metadata.executionCount++;
+                // Store the log message
+                metadata.logs.push(message);
+                // Check if limit exceeded
+                if (metadata.executionCount >= metadata.maxExecutions) {
+                    // Invoke callback if set
+                    if (this.onLimitExceeded) {
+                        this.onLimitExceeded(metadata);
+                    }
+                }
+                break; // Only match to one logpoint
+            }
+        }
+    }
+    /**
+     * Helper to match URLs (handle file:// vs http:// and normalization)
+     */
+    urlsMatch(url1, url2) {
+        // Normalize URLs for comparison
+        const normalize = (url) => {
+            // Remove trailing slashes
+            return url.replace(/\/$/, '');
+        };
+        return normalize(url1) === normalize(url2);
+    }
+    /**
+     * Clear all tracked logpoints
+     */
+    clear() {
+        this.logpoints.clear();
+    }
+}
+//# sourceMappingURL=logpoint-execution-tracker.js.map

package/build/logpoint-execution-tracker.js.map

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

package/build/mcp-supervisor.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-supervisor.d.ts.map

package/build/mcp-supervisor.d.ts.map

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