@cmdctrl/claude-code 0.1.0

package/dist/session-watcher.test.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Tests for SessionWatcher file change detection
+ *
+ * This test verifies that the SessionWatcher reliably detects
+ * file changes when an external process appends to a JSONL file
+ * (simulating Claude CLI writing to session files).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const session_watcher_1 = require("./session-watcher");
+describe('SessionWatcher', () => {
+    let tempDir;
+    let tempFile;
+    let watcher;
+    let events;
+    beforeEach(() => {
+        // Create a temp directory and file for each test
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'session-watcher-test-'));
+        tempFile = path.join(tempDir, 'test-session.jsonl');
+        // Write initial content with uuid (required for processing)
+        fs.writeFileSync(tempFile, '{"uuid":"init-1","type":"user","message":{"content":"initial message"}}\n');
+        events = [];
+        watcher = new session_watcher_1.SessionWatcher((event) => {
+            events.push(event);
+        });
+    });
+    afterEach(() => {
+        watcher.unwatchAll();
+        // Clean up temp files
+        if (fs.existsSync(tempFile)) {
+            fs.unlinkSync(tempFile);
+        }
+        if (fs.existsSync(tempDir)) {
+            fs.rmdirSync(tempDir);
+        }
+    });
+    it('should detect file changes when external process appends content', async () => {
+        // Start watching the file
+        watcher.watchSession('test-session-123', tempFile);
+        // Wait for watcher to initialize
+        await sleep(100);
+        // Simulate external process (Claude CLI) appending to file
+        // This mimics how the CLI incrementally writes JSONL lines
+        fs.appendFileSync(tempFile, '{"uuid":"resp-1","type":"assistant","message":{"content":[{"type":"text","text":"response 1"}]}}\n');
+        // Wait for the watcher to detect the change
+        // Using 2 seconds as a reasonable timeout - if fs.watch works, it should be much faster
+        // If using polling at 500ms, we need at least that long plus processing time
+        await sleep(2000);
+        // The watcher should have detected the change and fired the callback
+        expect(events.length).toBeGreaterThan(0);
+        expect(events[0].sessionId).toBe('test-session-123');
+        expect(events[0].type).toBe('AGENT_RESPONSE');
+        expect(events[0].content).toBe('response 1');
+    });
+    it('should detect multiple sequential appends', async () => {
+        watcher.watchSession('test-session-456', tempFile);
+        await sleep(100);
+        // Simulate multiple rapid appends (like Claude streaming output)
+        fs.appendFileSync(tempFile, '{"uuid":"line-1","type":"assistant","message":{"content":[{"type":"text","text":"line 1"}]}}\n');
+        await sleep(100);
+        fs.appendFileSync(tempFile, '{"uuid":"line-2","type":"assistant","message":{"content":[{"type":"text","text":"line 2"}]}}\n');
+        await sleep(100);
+        fs.appendFileSync(tempFile, '{"uuid":"line-3","type":"assistant","message":{"content":[{"type":"text","text":"line 3"}]}}\n');
+        // Wait for detection (accounting for polling interval)
+        await sleep(2000);
+        // Should have detected all events
+        expect(events.length).toBe(3);
+        expect(events.map(e => e.content)).toEqual(['line 1', 'line 2', 'line 3']);
+    });
+    it('should detect file changes from external process (simulates Claude CLI)', async () => {
+        // This is the critical test - external processes appending to files
+        // is exactly how the Claude CLI writes to session JSONL files.
+        // fs.watch() on macOS often fails to detect these changes.
+        watcher.watchSession('test-session-external', tempFile);
+        await sleep(100);
+        // Use shell to append - this is an external process, just like Claude CLI
+        const jsonLine = '{"uuid":"ext-1","type":"assistant","message":{"content":[{"type":"text","text":"external append"}]}}';
+        (0, child_process_1.execSync)(`echo '${jsonLine}' >> "${tempFile}"`);
+        // Wait for detection
+        await sleep(2000);
+        // The watcher MUST detect changes from external processes
+        expect(events.length).toBeGreaterThan(0);
+        expect(events[0].sessionId).toBe('test-session-external');
+        expect(events[0].type).toBe('AGENT_RESPONSE');
+    });
+    it('should emit VERBOSE for tool_use entries', async () => {
+        watcher.watchSession('test-session-tool', tempFile);
+        await sleep(100);
+        // Append a tool_use entry
+        const toolEntry = '{"uuid":"tool-1","type":"assistant","message":{"content":[{"type":"tool_use","name":"Read","input":{"file_path":"/test/file.ts"}}]}}';
+        fs.appendFileSync(tempFile, toolEntry + '\n');
+        await sleep(2000);
+        expect(events.length).toBe(1);
+        expect(events[0].type).toBe('VERBOSE');
+        expect(events[0].content).toContain('Reading');
+    });
+    it('should emit USER_MESSAGE for user entries', async () => {
+        watcher.watchSession('test-session-user', tempFile);
+        await sleep(100);
+        // Append a user message entry
+        const userEntry = '{"uuid":"user-1","type":"user","message":{"content":"hello agent"}}';
+        fs.appendFileSync(tempFile, userEntry + '\n');
+        await sleep(2000);
+        expect(events.length).toBe(1);
+        expect(events[0].type).toBe('USER_MESSAGE');
+        expect(events[0].content).toBe('hello agent');
+    });
+});
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=session-watcher.test.js.map

package/dist/session-watcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-watcher.test.js","sourceRoot":"","sources":["../src/session-watcher.test.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,iDAAyC;AACzC,uDAAiE;AAEjE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,OAAe,CAAC;IACpB,IAAI,QAAgB,CAAC;IACrB,IAAI,OAAuB,CAAC;IAC5B,IAAI,MAAsB,CAAC;IAE3B,UAAU,CAAC,GAAG,EAAE;QACd,iDAAiD;QACjD,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC1E,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAEpD,4DAA4D;QAC5D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,2EAA2E,CAAC,CAAC;QAExG,MAAM,GAAG,EAAE,CAAC;QACZ,OAAO,GAAG,IAAI,gCAAc,CAAC,CAAC,KAAK,EAAE,EAAE;YACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,sBAAsB;QACtB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,0BAA0B;QAC1B,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAEnD,iCAAiC;QACjC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,2DAA2D;QAC3D,2DAA2D;QAC3D,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,oGAAoG,CAAC,CAAC;QAElI,4CAA4C;QAC5C,wFAAwF;QACxF,6EAA6E;QAC7E,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,qEAAqE;QACrE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,iEAAiE;QACjE,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,gGAAgG,CAAC,CAAC;QAC9H,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,gGAAgG,CAAC,CAAC;QAC9H,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,gGAAgG,CAAC,CAAC;QAE9H,uDAAuD;QACvD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,kCAAkC;QAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,oEAAoE;QACpE,+DAA+D;QAC/D,2DAA2D;QAC3D,OAAO,CAAC,YAAY,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,sGAAsG,CAAC;QACxH,IAAA,wBAAQ,EAAC,SAAS,QAAQ,SAAS,QAAQ,GAAG,CAAC,CAAC;QAEhD,qBAAqB;QACrB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,0DAA0D;QAC1D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,OAAO,CAAC,YAAY,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,0BAA0B;QAC1B,MAAM,SAAS,GAAG,sIAAsI,CAAC;QACzJ,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;QAE9C,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,OAAO,CAAC,YAAY,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjB,8BAA8B;QAC9B,MAAM,SAAS,GAAG,qEAAqE,CAAC;QACxF,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;QAE9C,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAElB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/jest.config.js

@@ -0,0 +1,8 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js'],
+  testTimeout: 10000, // 10 seconds for file watcher tests
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cmdctrl/claude-code",
+  "version": "0.1.0",
+  "description": "CmdCtrl daemon for Claude Code - connects your workstation to the CmdCtrl orchestration server",
+  "main": "./dist/index.js",
+  "bin": {
+    "cmdctrl-claude-code": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist",
+    "test": "jest"
+  },
+  "keywords": [
+    "cmdctrl",
+    "daemon",
+    "claude",
+    "ai",
+    "orchestration"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.2",
+    "@types/ws": "^8.5.13",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.2",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}