@fixy/claude-adapter 0.0.0

package/dist/__tests__/adapter.test.d.ts

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

package/dist/__tests__/adapter.test.d.ts.map

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

package/dist/__tests__/adapter.test.js

@@ -0,0 +1,156 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createClaudeAdapter } from '../index.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+let tmpDir;
+let originalPath;
+beforeAll(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'fixy-claude-test-'));
+    originalPath = process.env.PATH ?? '';
+    const mockClaude = path.join(tmpDir, 'claude');
+    fs.writeFileSync(mockClaude, `#!/bin/bash
+if [[ "$1" == "--version" ]]; then
+  echo "claude-code 1.0.42"
+  exit 0
+fi
+
+if [[ "$1" == "--print" ]]; then
+  RESUME_ID=""
+  prev=""
+  for arg in "$@"; do
+    if [[ "$prev" == "--resume" ]]; then
+      RESUME_ID="$arg"
+    fi
+    prev="$arg"
+  done
+
+  STDIN_CONTENT=$(cat)
+  SESSION_ID=\${RESUME_ID:-"new-session-id-001"}
+
+  echo '{"type":"system","subtype":"init","session_id":"'"$SESSION_ID"'","model":"claude-sonnet-4-6"}'
+  echo '{"type":"assistant","session_id":"'"$SESSION_ID"'","message":{"content":[{"type":"text","text":"I received: '"$STDIN_CONTENT"'"}]}}'
+  echo '{"type":"result","session_id":"'"$SESSION_ID"'","result":"Mock response to prompt","usage":{"input_tokens":10,"output_tokens":20},"total_cost_usd":0.001}'
+  exit 0
+fi
+
+echo "Unknown command" >&2
+exit 1
+`, { mode: 0o755 });
+    process.env.PATH = tmpDir + ':' + originalPath;
+});
+afterAll(() => {
+    process.env.PATH = originalPath;
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+function makeCtx(overrides = {}) {
+    return {
+        runId: 'test-run-001',
+        agent: { id: 'claude', name: 'Claude Code' },
+        threadContext: {
+            threadId: 'thread-001',
+            projectRoot: tmpDir,
+            worktreePath: tmpDir,
+            repoRef: null,
+        },
+        messages: [],
+        prompt: 'Hello Claude',
+        session: null,
+        onLog: () => { },
+        onMeta: () => { },
+        onSpawn: () => { },
+        signal: AbortSignal.timeout(30_000),
+        ...overrides,
+    };
+}
+describe('ClaudeAdapter.probe()', () => {
+    it('finds the mock claude binary and reports available=true', async () => {
+        const adapter = createClaudeAdapter();
+        const result = await adapter.probe();
+        expect(result.available).toBe(true);
+        expect(result.version).toContain('1.0.42');
+    });
+    it('reports available=false when claude is not on PATH', async () => {
+        const adapter = createClaudeAdapter();
+        const savedPath = process.env.PATH;
+        process.env.PATH = '/nonexistent-dir-fixy-test';
+        try {
+            const result = await adapter.probe();
+            expect(result.available).toBe(false);
+        }
+        finally {
+            process.env.PATH = savedPath;
+        }
+    });
+});
+describe('ClaudeAdapter.execute()', () => {
+    it('executes with mock claude and returns expected result', async () => {
+        const adapter = createClaudeAdapter();
+        const logs = [];
+        let metaCalled = false;
+        let spawnPid = null;
+        const ctx = makeCtx({
+            onLog: (stream, chunk) => {
+                logs.push({ stream, chunk });
+            },
+            onMeta: (_meta) => {
+                metaCalled = true;
+            },
+            onSpawn: (pid) => {
+                spawnPid = pid;
+            },
+        });
+        const result = await adapter.execute(ctx);
+        expect(result.summary).toContain('Mock response to prompt');
+        expect(result.session).not.toBeNull();
+        expect(result.session?.sessionId).toBe('new-session-id-001');
+        expect(result.exitCode).toBe(0);
+        expect(result.timedOut).toBe(false);
+        expect(result.patches).toEqual([]);
+        expect(metaCalled).toBe(true);
+        expect(typeof spawnPid).toBe('number');
+        expect(spawnPid).toBeGreaterThan(0);
+    });
+    it('resumes a session by passing --resume with the session id', async () => {
+        const adapter = createClaudeAdapter();
+        const ctx = makeCtx({
+            session: { sessionId: 'resume-sess-42', params: {} },
+        });
+        const result = await adapter.execute(ctx);
+        expect(result.session).not.toBeNull();
+        expect(result.session?.sessionId).toBe('resume-sess-42');
+    });
+    it('inherits HOME without redaction (HOME does not match sensitive key regex)', async () => {
+        const adapter = createClaudeAdapter();
+        let metaEnv = {};
+        const ctx = makeCtx({
+            onMeta: (meta) => {
+                metaEnv = meta.env;
+            },
+        });
+        await adapter.execute(ctx);
+        // HOME does not match /(key|token|secret|password|passwd|authorization|cookie)/i
+        // so it must NOT be redacted
+        expect(metaEnv['HOME']).not.toBe('***REDACTED***');
+        expect(typeof metaEnv['HOME']).toBe('string');
+    });
+    it('redacts env keys matching the sensitive key pattern', async () => {
+        const adapter = createClaudeAdapter();
+        let metaEnv = {};
+        process.env['MY_SECRET_TOKEN'] = 'super-secret';
+        const ctx = makeCtx({
+            onMeta: (meta) => {
+                metaEnv = meta.env;
+            },
+        });
+        try {
+            await adapter.execute(ctx);
+            // "TOKEN" matches /(key|token|secret|password|passwd|authorization|cookie)/i
+            expect(metaEnv['MY_SECRET_TOKEN']).toBe('***REDACTED***');
+        }
+        finally {
+            delete process.env['MY_SECRET_TOKEN'];
+        }
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

package/dist/__tests__/adapter.test.js.map

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

package/dist/__tests__/parse.test.d.ts

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

package/dist/__tests__/parse.test.d.ts.map

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

package/dist/__tests__/parse.test.js

@@ -0,0 +1,80 @@
+import { describe, it, expect } from 'vitest';
+import { parseClaudeStreamJson } from '../parse.js';
+describe('parseClaudeStreamJson', () => {
+    it('extracts sessionId and summary from a result line', () => {
+        const input = [
+            JSON.stringify({
+                type: 'system',
+                subtype: 'init',
+                session_id: 'sess-abc-123',
+                model: 'claude-sonnet-4-6',
+            }),
+            JSON.stringify({
+                type: 'assistant',
+                session_id: 'sess-abc-123',
+                message: { content: [{ type: 'text', text: 'Hello there!' }] },
+            }),
+            JSON.stringify({
+                type: 'result',
+                session_id: 'sess-abc-123',
+                result: 'Final answer here',
+                usage: { input_tokens: 100, output_tokens: 50 },
+                total_cost_usd: 0.01,
+            }),
+        ].join('\n');
+        const result = parseClaudeStreamJson(input);
+        expect(result.sessionId).toBe('sess-abc-123');
+        expect(result.summary).toBe('Final answer here');
+    });
+    it('falls back to concatenated assistant content when there is no result line', () => {
+        const input = [
+            JSON.stringify({ type: 'system', subtype: 'init', session_id: 'sess-no-result' }),
+            JSON.stringify({
+                type: 'assistant',
+                session_id: 'sess-no-result',
+                message: { content: [{ type: 'text', text: 'Part 1' }] },
+            }),
+            JSON.stringify({
+                type: 'assistant',
+                session_id: 'sess-no-result',
+                message: { content: [{ type: 'text', text: 'Part 2' }] },
+            }),
+        ].join('\n');
+        const result = parseClaudeStreamJson(input);
+        expect(result.sessionId).toBe('sess-no-result');
+        expect(result.summary).toContain('Part 1');
+        expect(result.summary).toContain('Part 2');
+    });
+    it('falls back to raw stdout for completely invalid (non-JSON) output', () => {
+        const input = 'This is not JSON at all\nJust random text\n';
+        const result = parseClaudeStreamJson(input);
+        expect(result.sessionId).toBeNull();
+        // summary should be the raw input (the fallback path in parseClaudeStreamJson)
+        expect(result.summary).toBe(input);
+    });
+    it('returns null sessionId and empty summary for an empty string', () => {
+        const result = parseClaudeStreamJson('');
+        expect(result.sessionId).toBeNull();
+        expect(result.summary).toBe('');
+    });
+    it('uses assistant content as summary when result line has no result field', () => {
+        const input = [
+            JSON.stringify({ type: 'system', subtype: 'init', session_id: 'sess-empty-result' }),
+            JSON.stringify({
+                type: 'assistant',
+                session_id: 'sess-empty-result',
+                message: { content: [{ type: 'text', text: 'Assistant text fallback' }] },
+            }),
+            // result line exists but has no "result" field
+            JSON.stringify({
+                type: 'result',
+                session_id: 'sess-empty-result',
+                usage: { input_tokens: 5, output_tokens: 5 },
+            }),
+        ].join('\n');
+        const result = parseClaudeStreamJson(input);
+        expect(result.sessionId).toBe('sess-empty-result');
+        expect(result.summary).toBe('Assistant text fallback');
+    });
+});
+//# sourceMappingURL=parse.test.js.map

package/dist/__tests__/parse.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { FixyAdapter } from '@fixy/core';
+export declare function createClaudeAdapter(): FixyAdapter;
+export { parseClaudeStreamJson } from './parse.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,YAAY,CAAC;AA+GpB,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,98 @@
+// packages/claude-adapter/src/index.ts
+import { buildInheritedEnv, redactEnvForLogs, resolveCommand, runChildProcess, } from '@fixy/adapter-utils';
+import { parseClaudeStreamJson } from './parse.js';
+class ClaudeAdapter {
+    id = 'claude';
+    name = 'Claude Code';
+    async probe() {
+        let resolvedCommand;
+        try {
+            resolvedCommand = await resolveCommand('claude');
+        }
+        catch {
+            return {
+                available: false,
+                version: null,
+                authStatus: 'unknown',
+                detail: 'claude CLI not found in PATH',
+            };
+        }
+        try {
+            const result = await runChildProcess({
+                command: resolvedCommand,
+                args: ['--version'],
+                cwd: process.cwd(),
+                env: buildInheritedEnv(),
+                timeoutMs: 10_000,
+            });
+            const version = result.stdout.trim() || null;
+            return {
+                available: true,
+                version,
+                authStatus: 'unknown',
+                detail: null,
+            };
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            return {
+                available: false,
+                version: null,
+                authStatus: 'unknown',
+                detail,
+            };
+        }
+    }
+    async execute(ctx) {
+        const args = ['--print', '--output-format', 'stream-json', '--verbose'];
+        if (ctx.session) {
+            args.push('--resume', ctx.session.sessionId);
+        }
+        const env = buildInheritedEnv({});
+        const resolvedCommand = await resolveCommand('claude');
+        ctx.onMeta({
+            resolvedCommand,
+            args,
+            cwd: ctx.threadContext.worktreePath,
+            env: redactEnvForLogs(env),
+        });
+        const result = await runChildProcess({
+            command: resolvedCommand,
+            args,
+            cwd: ctx.threadContext.worktreePath,
+            env,
+            stdin: ctx.prompt,
+            signal: ctx.signal,
+            onLog: ctx.onLog,
+            onSpawn: ctx.onSpawn,
+        });
+        const parsed = parseClaudeStreamJson(result.stdout);
+        const warnings = [];
+        if (result.stderr && result.stderr.trim().length > 0) {
+            warnings.push(result.stderr.trim());
+        }
+        let errorMessage = null;
+        if (result.exitCode !== 0 && !result.timedOut) {
+            const stderrMsg = result.stderr.trim();
+            errorMessage =
+                stderrMsg.length > 0
+                    ? `claude exited with code ${result.exitCode}: ${stderrMsg}`
+                    : `claude exited with code ${result.exitCode}`;
+        }
+        return {
+            exitCode: result.exitCode,
+            signal: result.signal,
+            timedOut: result.timedOut,
+            summary: parsed.summary,
+            session: parsed.sessionId ? { sessionId: parsed.sessionId, params: {} } : null,
+            patches: [],
+            warnings,
+            errorMessage,
+        };
+    }
+}
+export function createClaudeAdapter() {
+    return new ClaudeAdapter();
+}
+export { parseClaudeStreamJson } from './parse.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,6 @@
+export interface ClaudeStreamResult {
+    sessionId: string | null;
+    summary: string;
+}
+export declare function parseClaudeStreamJson(stdout: string): ClaudeStreamResult;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAsExE"}

package/dist/parse.js

@@ -0,0 +1,85 @@
+function tryParseJson(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function asString(value, fallback) {
+    return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+export function parseClaudeStreamJson(stdout) {
+    if (stdout.length === 0) {
+        return { sessionId: null, summary: '' };
+    }
+    let sessionId = null;
+    const assistantTexts = [];
+    let finalResult = null;
+    const lines = stdout.split('\n');
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            continue;
+        const obj = tryParseJson(line);
+        if (obj === null)
+            continue;
+        const type = obj['type'];
+        if (type === 'system') {
+            if (obj['subtype'] === 'init') {
+                sessionId = asString(obj['session_id'], sessionId ?? '');
+                if (sessionId === '')
+                    sessionId = null;
+            }
+        }
+        else if (type === 'assistant') {
+            const sid = asString(obj['session_id'], '');
+            if (sid !== '')
+                sessionId = sid;
+            const message = obj['message'];
+            if (typeof message === 'object' && message !== null && !Array.isArray(message)) {
+                const msg = message;
+                const content = msg['content'];
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (typeof block === 'object' && block !== null && !Array.isArray(block)) {
+                            const b = block;
+                            if (b['type'] === 'text') {
+                                const text = asString(b['text'], '');
+                                if (text !== '') {
+                                    assistantTexts.push(text);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        else if (type === 'result') {
+            finalResult = obj;
+            const sid = asString(obj['session_id'], '');
+            if (sid !== '')
+                sessionId = sid;
+        }
+    }
+    let summary;
+    if (finalResult !== null) {
+        const resultText = asString(finalResult['result'], '');
+        summary = resultText !== '' ? resultText : assistantTexts.join('\n\n').trim();
+        const sid = asString(finalResult['session_id'], '');
+        if (sid !== '')
+            sessionId = sid;
+    }
+    else {
+        summary = assistantTexts.join('\n\n').trim();
+    }
+    if (summary === '' && sessionId === null) {
+        return { sessionId: null, summary: stdout };
+    }
+    return { sessionId, summary };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,WAAW,GAAmC,IAAI,CAAC;IAEvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAE3B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC9B,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;gBACzD,IAAI,SAAS,KAAK,EAAE;oBAAE,SAAS,GAAG,IAAI,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,EAAE;gBAAE,SAAS,GAAG,GAAG,CAAC;YAEhC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,GAAG,GAAG,OAAkC,CAAC;gBAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;wBAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;4BACzE,MAAM,CAAC,GAAG,KAAgC,CAAC;4BAC3C,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;gCACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gCACrC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;oCAChB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gCAC5B,CAAC;4BACH,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,WAAW,GAAG,GAAG,CAAC;YAClB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,EAAE;gBAAE,SAAS,GAAG,GAAG,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,OAAe,CAAC;IAEpB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,GAAG,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS,GAAG,GAAG,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,KAAK,EAAE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@fixy/claude-adapter",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@fixy/adapter-utils": "workspace:*",
+    "@fixy/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  },
+  "license": "MIT"
+}

package/src/__tests__/adapter.test.ts

@@ -0,0 +1,184 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { createClaudeAdapter } from '../index.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import type { FixyExecutionContext, FixyInvocationMeta } from '@fixy/core';
+
+let tmpDir: string;
+let originalPath: string;
+
+beforeAll(() => {
+  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'fixy-claude-test-'));
+  originalPath = process.env.PATH ?? '';
+
+  const mockClaude = path.join(tmpDir, 'claude');
+  fs.writeFileSync(
+    mockClaude,
+    `#!/bin/bash
+if [[ "$1" == "--version" ]]; then
+  echo "claude-code 1.0.42"
+  exit 0
+fi
+
+if [[ "$1" == "--print" ]]; then
+  RESUME_ID=""
+  prev=""
+  for arg in "$@"; do
+    if [[ "$prev" == "--resume" ]]; then
+      RESUME_ID="$arg"
+    fi
+    prev="$arg"
+  done
+
+  STDIN_CONTENT=$(cat)
+  SESSION_ID=\${RESUME_ID:-"new-session-id-001"}
+
+  echo '{"type":"system","subtype":"init","session_id":"'"$SESSION_ID"'","model":"claude-sonnet-4-6"}'
+  echo '{"type":"assistant","session_id":"'"$SESSION_ID"'","message":{"content":[{"type":"text","text":"I received: '"$STDIN_CONTENT"'"}]}}'
+  echo '{"type":"result","session_id":"'"$SESSION_ID"'","result":"Mock response to prompt","usage":{"input_tokens":10,"output_tokens":20},"total_cost_usd":0.001}'
+  exit 0
+fi
+
+echo "Unknown command" >&2
+exit 1
+`,
+    { mode: 0o755 },
+  );
+
+  process.env.PATH = tmpDir + ':' + originalPath;
+});
+
+afterAll(() => {
+  process.env.PATH = originalPath;
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+
+function makeCtx(overrides: Partial<FixyExecutionContext> = {}): FixyExecutionContext {
+  return {
+    runId: 'test-run-001',
+    agent: { id: 'claude', name: 'Claude Code' },
+    threadContext: {
+      threadId: 'thread-001',
+      projectRoot: tmpDir,
+      worktreePath: tmpDir,
+      repoRef: null,
+    },
+    messages: [],
+    prompt: 'Hello Claude',
+    session: null,
+    onLog: () => {},
+    onMeta: () => {},
+    onSpawn: () => {},
+    signal: AbortSignal.timeout(30_000),
+    ...overrides,
+  } as unknown as FixyExecutionContext;
+}
+
+describe('ClaudeAdapter.probe()', () => {
+  it('finds the mock claude binary and reports available=true', async () => {
+    const adapter = createClaudeAdapter();
+    const result = await adapter.probe();
+
+    expect(result.available).toBe(true);
+    expect(result.version).toContain('1.0.42');
+  });
+
+  it('reports available=false when claude is not on PATH', async () => {
+    const adapter = createClaudeAdapter();
+    const savedPath = process.env.PATH;
+    process.env.PATH = '/nonexistent-dir-fixy-test';
+
+    try {
+      const result = await adapter.probe();
+      expect(result.available).toBe(false);
+    } finally {
+      process.env.PATH = savedPath;
+    }
+  });
+});
+
+describe('ClaudeAdapter.execute()', () => {
+  it('executes with mock claude and returns expected result', async () => {
+    const adapter = createClaudeAdapter();
+    const logs: Array<{ stream: string; chunk: string }> = [];
+    let metaCalled = false;
+    let spawnPid: number | null = null;
+
+    const ctx = makeCtx({
+      onLog: (stream, chunk) => {
+        logs.push({ stream, chunk });
+      },
+      onMeta: (_meta: FixyInvocationMeta) => {
+        metaCalled = true;
+      },
+      onSpawn: (pid: number) => {
+        spawnPid = pid;
+      },
+    });
+
+    const result = await adapter.execute(ctx);
+
+    expect(result.summary).toContain('Mock response to prompt');
+    expect(result.session).not.toBeNull();
+    expect(result.session?.sessionId).toBe('new-session-id-001');
+    expect(result.exitCode).toBe(0);
+    expect(result.timedOut).toBe(false);
+    expect(result.patches).toEqual([]);
+    expect(metaCalled).toBe(true);
+    expect(typeof spawnPid).toBe('number');
+    expect(spawnPid).toBeGreaterThan(0);
+  });
+
+  it('resumes a session by passing --resume with the session id', async () => {
+    const adapter = createClaudeAdapter();
+
+    const ctx = makeCtx({
+      session: { sessionId: 'resume-sess-42', params: {} },
+    });
+
+    const result = await adapter.execute(ctx);
+
+    expect(result.session).not.toBeNull();
+    expect(result.session?.sessionId).toBe('resume-sess-42');
+  });
+
+  it('inherits HOME without redaction (HOME does not match sensitive key regex)', async () => {
+    const adapter = createClaudeAdapter();
+    let metaEnv: Record<string, string> = {};
+
+    const ctx = makeCtx({
+      onMeta: (meta: FixyInvocationMeta) => {
+        metaEnv = meta.env;
+      },
+    });
+
+    await adapter.execute(ctx);
+
+    // HOME does not match /(key|token|secret|password|passwd|authorization|cookie)/i
+    // so it must NOT be redacted
+    expect(metaEnv['HOME']).not.toBe('***REDACTED***');
+    expect(typeof metaEnv['HOME']).toBe('string');
+  });
+
+  it('redacts env keys matching the sensitive key pattern', async () => {
+    const adapter = createClaudeAdapter();
+    let metaEnv: Record<string, string> = {};
+
+    process.env['MY_SECRET_TOKEN'] = 'super-secret';
+
+    const ctx = makeCtx({
+      onMeta: (meta: FixyInvocationMeta) => {
+        metaEnv = meta.env;
+      },
+    });
+
+    try {
+      await adapter.execute(ctx);
+      // "TOKEN" matches /(key|token|secret|password|passwd|authorization|cookie)/i
+      expect(metaEnv['MY_SECRET_TOKEN']).toBe('***REDACTED***');
+    } finally {
+      delete process.env['MY_SECRET_TOKEN'];
+    }
+  });
+});

package/src/__tests__/parse.test.ts

@@ -0,0 +1,93 @@
+import { describe, it, expect } from 'vitest';
+import { parseClaudeStreamJson } from '../parse.js';
+
+describe('parseClaudeStreamJson', () => {
+  it('extracts sessionId and summary from a result line', () => {
+    const input = [
+      JSON.stringify({
+        type: 'system',
+        subtype: 'init',
+        session_id: 'sess-abc-123',
+        model: 'claude-sonnet-4-6',
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        session_id: 'sess-abc-123',
+        message: { content: [{ type: 'text', text: 'Hello there!' }] },
+      }),
+      JSON.stringify({
+        type: 'result',
+        session_id: 'sess-abc-123',
+        result: 'Final answer here',
+        usage: { input_tokens: 100, output_tokens: 50 },
+        total_cost_usd: 0.01,
+      }),
+    ].join('\n');
+
+    const result = parseClaudeStreamJson(input);
+
+    expect(result.sessionId).toBe('sess-abc-123');
+    expect(result.summary).toBe('Final answer here');
+  });
+
+  it('falls back to concatenated assistant content when there is no result line', () => {
+    const input = [
+      JSON.stringify({ type: 'system', subtype: 'init', session_id: 'sess-no-result' }),
+      JSON.stringify({
+        type: 'assistant',
+        session_id: 'sess-no-result',
+        message: { content: [{ type: 'text', text: 'Part 1' }] },
+      }),
+      JSON.stringify({
+        type: 'assistant',
+        session_id: 'sess-no-result',
+        message: { content: [{ type: 'text', text: 'Part 2' }] },
+      }),
+    ].join('\n');
+
+    const result = parseClaudeStreamJson(input);
+
+    expect(result.sessionId).toBe('sess-no-result');
+    expect(result.summary).toContain('Part 1');
+    expect(result.summary).toContain('Part 2');
+  });
+
+  it('falls back to raw stdout for completely invalid (non-JSON) output', () => {
+    const input = 'This is not JSON at all\nJust random text\n';
+
+    const result = parseClaudeStreamJson(input);
+
+    expect(result.sessionId).toBeNull();
+    // summary should be the raw input (the fallback path in parseClaudeStreamJson)
+    expect(result.summary).toBe(input);
+  });
+
+  it('returns null sessionId and empty summary for an empty string', () => {
+    const result = parseClaudeStreamJson('');
+
+    expect(result.sessionId).toBeNull();
+    expect(result.summary).toBe('');
+  });
+
+  it('uses assistant content as summary when result line has no result field', () => {
+    const input = [
+      JSON.stringify({ type: 'system', subtype: 'init', session_id: 'sess-empty-result' }),
+      JSON.stringify({
+        type: 'assistant',
+        session_id: 'sess-empty-result',
+        message: { content: [{ type: 'text', text: 'Assistant text fallback' }] },
+      }),
+      // result line exists but has no "result" field
+      JSON.stringify({
+        type: 'result',
+        session_id: 'sess-empty-result',
+        usage: { input_tokens: 5, output_tokens: 5 },
+      }),
+    ].join('\n');
+
+    const result = parseClaudeStreamJson(input);
+
+    expect(result.sessionId).toBe('sess-empty-result');
+    expect(result.summary).toBe('Assistant text fallback');
+  });
+});

package/src/index.ts

@@ -0,0 +1,123 @@
+// packages/claude-adapter/src/index.ts
+
+import type {
+  FixyAdapter,
+  FixyProbeResult,
+  FixyExecutionContext,
+  FixyExecutionResult,
+} from '@fixy/core';
+
+import {
+  buildInheritedEnv,
+  redactEnvForLogs,
+  resolveCommand,
+  runChildProcess,
+} from '@fixy/adapter-utils';
+
+import { parseClaudeStreamJson } from './parse.js';
+
+class ClaudeAdapter implements FixyAdapter {
+  readonly id = 'claude';
+  readonly name = 'Claude Code';
+
+  async probe(): Promise<FixyProbeResult> {
+    let resolvedCommand: string;
+    try {
+      resolvedCommand = await resolveCommand('claude');
+    } catch {
+      return {
+        available: false,
+        version: null,
+        authStatus: 'unknown',
+        detail: 'claude CLI not found in PATH',
+      };
+    }
+
+    try {
+      const result = await runChildProcess({
+        command: resolvedCommand,
+        args: ['--version'],
+        cwd: process.cwd(),
+        env: buildInheritedEnv(),
+        timeoutMs: 10_000,
+      });
+      const version = result.stdout.trim() || null;
+      return {
+        available: true,
+        version,
+        authStatus: 'unknown',
+        detail: null,
+      };
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      return {
+        available: false,
+        version: null,
+        authStatus: 'unknown',
+        detail,
+      };
+    }
+  }
+
+  async execute(ctx: FixyExecutionContext): Promise<FixyExecutionResult> {
+    const args: string[] = ['--print', '--output-format', 'stream-json', '--verbose'];
+
+    if (ctx.session) {
+      args.push('--resume', ctx.session.sessionId);
+    }
+
+    const env = buildInheritedEnv({});
+    const resolvedCommand = await resolveCommand('claude');
+
+    ctx.onMeta({
+      resolvedCommand,
+      args,
+      cwd: ctx.threadContext.worktreePath,
+      env: redactEnvForLogs(env),
+    });
+
+    const result = await runChildProcess({
+      command: resolvedCommand,
+      args,
+      cwd: ctx.threadContext.worktreePath,
+      env,
+      stdin: ctx.prompt,
+      signal: ctx.signal,
+      onLog: ctx.onLog,
+      onSpawn: ctx.onSpawn,
+    });
+
+    const parsed = parseClaudeStreamJson(result.stdout);
+
+    const warnings: string[] = [];
+    if (result.stderr && result.stderr.trim().length > 0) {
+      warnings.push(result.stderr.trim());
+    }
+
+    let errorMessage: string | null = null;
+    if (result.exitCode !== 0 && !result.timedOut) {
+      const stderrMsg = result.stderr.trim();
+      errorMessage =
+        stderrMsg.length > 0
+          ? `claude exited with code ${result.exitCode}: ${stderrMsg}`
+          : `claude exited with code ${result.exitCode}`;
+    }
+
+    return {
+      exitCode: result.exitCode,
+      signal: result.signal,
+      timedOut: result.timedOut,
+      summary: parsed.summary,
+      session: parsed.sessionId ? { sessionId: parsed.sessionId, params: {} } : null,
+      patches: [],
+      warnings,
+      errorMessage,
+    };
+  }
+}
+
+export function createClaudeAdapter(): FixyAdapter {
+  return new ClaudeAdapter();
+}
+
+export { parseClaudeStreamJson } from './parse.js';

package/src/parse.ts

@@ -0,0 +1,92 @@
+export interface ClaudeStreamResult {
+  sessionId: string | null;
+  summary: string;
+}
+
+function tryParseJson(line: string): Record<string, unknown> | null {
+  try {
+    const parsed = JSON.parse(line);
+    if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+      return parsed as Record<string, unknown>;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function asString(value: unknown, fallback: string): string {
+  return typeof value === 'string' && value.length > 0 ? value : fallback;
+}
+
+export function parseClaudeStreamJson(stdout: string): ClaudeStreamResult {
+  if (stdout.length === 0) {
+    return { sessionId: null, summary: '' };
+  }
+
+  let sessionId: string | null = null;
+  const assistantTexts: string[] = [];
+  let finalResult: Record<string, unknown> | null = null;
+
+  const lines = stdout.split('\n');
+
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (line.length === 0) continue;
+
+    const obj = tryParseJson(line);
+    if (obj === null) continue;
+
+    const type = obj['type'];
+
+    if (type === 'system') {
+      if (obj['subtype'] === 'init') {
+        sessionId = asString(obj['session_id'], sessionId ?? '');
+        if (sessionId === '') sessionId = null;
+      }
+    } else if (type === 'assistant') {
+      const sid = asString(obj['session_id'], '');
+      if (sid !== '') sessionId = sid;
+
+      const message = obj['message'];
+      if (typeof message === 'object' && message !== null && !Array.isArray(message)) {
+        const msg = message as Record<string, unknown>;
+        const content = msg['content'];
+        if (Array.isArray(content)) {
+          for (const block of content) {
+            if (typeof block === 'object' && block !== null && !Array.isArray(block)) {
+              const b = block as Record<string, unknown>;
+              if (b['type'] === 'text') {
+                const text = asString(b['text'], '');
+                if (text !== '') {
+                  assistantTexts.push(text);
+                }
+              }
+            }
+          }
+        }
+      }
+    } else if (type === 'result') {
+      finalResult = obj;
+      const sid = asString(obj['session_id'], '');
+      if (sid !== '') sessionId = sid;
+    }
+  }
+
+  let summary: string;
+
+  if (finalResult !== null) {
+    const resultText = asString(finalResult['result'], '');
+    summary = resultText !== '' ? resultText : assistantTexts.join('\n\n').trim();
+    const sid = asString(finalResult['session_id'], '');
+    if (sid !== '') sessionId = sid;
+  } else {
+    summary = assistantTexts.join('\n\n').trim();
+  }
+
+  if (summary === '' && sessionId === null) {
+    return { sessionId: null, summary: stdout };
+  }
+
+  return { sessionId, summary };
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"]
+  },
+  "include": ["src"]
+}