@diff-review-system/drs 1.1.2 → 2.0.0

package/dist/lib/describe-output-path.test.d.ts

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

package/dist/lib/describe-output-path.test.d.ts.map

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

package/dist/lib/describe-output-path.test.js

@@ -0,0 +1,51 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { mkdir, mkdtemp, readFile, rm, writeFile } from 'fs/promises';
+import { dirname, join } from 'path';
+import { tmpdir } from 'os';
+import { writeJsonOutput } from './write-json-output.js';
+import { parseDescribeOutput } from './describe-parser.js';
+import { OUTPUT_PATHS } from './output-paths.js';
+describe('describe output path integration', () => {
+    let workingDir;
+    beforeEach(async () => {
+        workingDir = await mkdtemp(join(tmpdir(), 'drs-describe-'));
+    });
+    afterEach(async () => {
+        await rm(workingDir, { recursive: true, force: true });
+    });
+    it('writes describe output to deterministic path and reads it', async () => {
+        const payload = {
+            type: 'feature',
+            title: 'Add deterministic output path usage',
+            summary: ['Ensures describe output writes to known location'],
+        };
+        const pointer = await writeJsonOutput({
+            outputType: 'describe_output',
+            payload,
+            pretty: false,
+            workingDir,
+        });
+        const expectedPath = join(workingDir, OUTPUT_PATHS.describe_output);
+        const fileContents = JSON.parse(await readFile(expectedPath, 'utf-8'));
+        expect(fileContents).toEqual(payload);
+        expect(pointer).toEqual({
+            outputType: 'describe_output',
+            outputPath: OUTPUT_PATHS.describe_output,
+        });
+        const parsed = await parseDescribeOutput(workingDir, false, JSON.stringify(pointer));
+        expect(parsed).toEqual(payload);
+    });
+    it('reads describe output from default path without pointer', async () => {
+        const payload = {
+            type: 'bugfix',
+            title: 'Read describe output from default path',
+            summary: ['Loads describe output without pointer metadata'],
+        };
+        const expectedPath = join(workingDir, OUTPUT_PATHS.describe_output);
+        await mkdir(dirname(expectedPath), { recursive: true });
+        await writeFile(expectedPath, JSON.stringify(payload), 'utf-8');
+        const parsed = await parseDescribeOutput(workingDir);
+        expect(parsed).toEqual(payload);
+    });
+});
+//# sourceMappingURL=describe-output-path.test.js.map

package/dist/lib/describe-output-path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-output-path.test.js","sourceRoot":"","sources":["../../src/lib/describe-output-path.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,IAAI,UAAkB,CAAC;IAEvB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,qCAAqC;YAC5C,OAAO,EAAE,CAAC,kDAAkD,CAAC;SAC9D,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;YACpC,UAAU,EAAE,iBAAiB;YAC7B,OAAO;YACP,MAAM,EAAE,KAAK;YACb,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,UAAU,EAAE,iBAAiB;YAC7B,UAAU,EAAE,YAAY,CAAC,eAAe;SACzC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,wCAAwC;YAC/C,OAAO,EAAE,CAAC,gDAAgD,CAAC;SAC5D,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;QACpE,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/describe-parser.d.ts

@@ -0,0 +1,3 @@
+export declare function parseJsonFromAgentOutput(raw: string): unknown;
+export declare function parseDescribeOutput(workingDir?: string, debug?: boolean, rawOutput?: string): Promise<unknown>;
+//# sourceMappingURL=describe-parser.d.ts.map

package/dist/lib/describe-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-parser.d.ts","sourceRoot":"","sources":["../../src/lib/describe-parser.ts"],"names":[],"mappings":"AA4IA,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiC7D;AAED,wBAAsB,mBAAmB,CACvC,UAAU,GAAE,MAAsB,EAClC,KAAK,UAAQ,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/dist/lib/describe-parser.js

@@ -0,0 +1,163 @@
+import { readFile } from 'fs/promises';
+import { resolve } from 'path';
+import { OUTPUT_PATHS } from './output-paths.js';
+const JSON_FENCE_REGEX = /```json\s*([\s\S]*?)\s*```/i;
+function isOutputPointer(value) {
+    return !!value && typeof value === 'object' && ('outputType' in value || 'outputPath' in value);
+}
+const DESCRIBE_OUTPUT_PATH = OUTPUT_PATHS.describe_output;
+function resolveWithinWorkingDir(workingDir, targetPath) {
+    const root = resolve(workingDir);
+    const fullPath = resolve(workingDir, targetPath);
+    const rootWithSlash = root.endsWith('/') ? root : `${root}/`;
+    if (fullPath !== root && !fullPath.startsWith(rootWithSlash)) {
+        throw new Error(`Refusing to read outside working directory: ${targetPath}`);
+    }
+    return fullPath;
+}
+async function readJsonIfExists(workingDir, targetPath) {
+    const resolvedPath = resolveWithinWorkingDir(workingDir, targetPath);
+    try {
+        const fileContents = await readFile(resolvedPath, 'utf-8');
+        return JSON.parse(fileContents);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+function resolveDescribeOutputPath(pointer) {
+    if (!pointer) {
+        return null;
+    }
+    if (pointer.outputType && pointer.outputType !== 'describe_output') {
+        throw new Error(`Unexpected output type for describe output: ${pointer.outputType}`);
+    }
+    if (pointer.outputPath) {
+        return pointer.outputPath;
+    }
+    if (pointer.outputType) {
+        return OUTPUT_PATHS[pointer.outputType];
+    }
+    return null;
+}
+function parseDescribeOutputPointer(raw, debug) {
+    try {
+        const parsed = parseJsonFromAgentOutput(raw);
+        if (isOutputPointer(parsed)) {
+            return parsed;
+        }
+        if (debug) {
+            console.log('Describe output pointer not found in agent output.');
+        }
+    }
+    catch (error) {
+        if (debug) {
+            console.log(`Describe output pointer parse failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return null;
+}
+function findJsonCandidates(text) {
+    const candidates = [];
+    for (let start = 0; start < text.length; start += 1) {
+        if (text[start] !== '{') {
+            continue;
+        }
+        let depth = 0;
+        let inString = false;
+        let escapeNext = false;
+        for (let index = start; index < text.length; index += 1) {
+            const char = text[index];
+            if (inString) {
+                if (escapeNext) {
+                    escapeNext = false;
+                    continue;
+                }
+                if (char === '\\') {
+                    escapeNext = true;
+                    continue;
+                }
+                if (char === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (char === '"') {
+                inString = true;
+                continue;
+            }
+            if (char === '{') {
+                depth += 1;
+                continue;
+            }
+            if (char === '}') {
+                depth -= 1;
+                if (depth === 0) {
+                    candidates.push(text.slice(start, index + 1));
+                    break;
+                }
+            }
+        }
+    }
+    return candidates;
+}
+export function parseJsonFromAgentOutput(raw) {
+    const errors = [];
+    const fencedMatch = raw.match(JSON_FENCE_REGEX);
+    if (fencedMatch?.[1]) {
+        try {
+            return JSON.parse(fencedMatch[1]);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    const candidates = findJsonCandidates(raw);
+    for (let index = candidates.length - 1; index >= 0; index -= 1) {
+        try {
+            return JSON.parse(candidates[index]);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        errors.push(error);
+    }
+    const lastError = errors[errors.length - 1];
+    if (lastError instanceof Error) {
+        throw lastError;
+    }
+    throw new Error('Failed to parse JSON output');
+}
+export async function parseDescribeOutput(workingDir = process.cwd(), debug = false, rawOutput) {
+    const pointer = rawOutput ? parseDescribeOutputPointer(rawOutput, debug) : null;
+    const pointerPath = resolveDescribeOutputPath(pointer);
+    if (pointerPath) {
+        const pointerOutput = await readJsonIfExists(workingDir, pointerPath);
+        if (pointerOutput) {
+            if (debug) {
+                console.log(`Describe output loaded from ${pointerPath}`);
+            }
+            return pointerOutput;
+        }
+        if (debug) {
+            console.log(`Describe output not found at ${pointerPath}, falling back to default path.`);
+        }
+    }
+    const defaultOutput = await readJsonIfExists(workingDir, DESCRIBE_OUTPUT_PATH);
+    if (defaultOutput) {
+        if (debug) {
+            console.log(`Describe output loaded from ${DESCRIBE_OUTPUT_PATH}`);
+        }
+        return defaultOutput;
+    }
+    throw new Error(`Describe output file not found at ${DESCRIBE_OUTPUT_PATH}`);
+}
+//# sourceMappingURL=describe-parser.js.map

package/dist/lib/describe-parser.js.map

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

package/dist/lib/describe-parser.test.d.ts

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

package/dist/lib/describe-parser.test.d.ts.map

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

package/dist/lib/describe-parser.test.js

@@ -0,0 +1,282 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { parseJsonFromAgentOutput, parseDescribeOutput } from './describe-parser.js';
+import { mkdir, writeFile, rm } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+describe('describe-parser', () => {
+    describe('parseJsonFromAgentOutput', () => {
+        it('should parse JSON from code fence', () => {
+            const raw = '```json\n{"type": "feature", "title": "Test"}\n```';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ type: 'feature', title: 'Test' });
+        });
+        it('should parse JSON from code fence with extra whitespace', () => {
+            const raw = '```json\n\n  {"type": "feature", "title": "Test"}  \n\n```';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ type: 'feature', title: 'Test' });
+        });
+        it('should parse JSON from code fence with case-insensitive marker', () => {
+            const raw = '```JSON\n{"type": "feature", "title": "Test"}\n```';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ type: 'feature', title: 'Test' });
+        });
+        it('should parse embedded JSON from mixed text', () => {
+            const raw = 'Here is the output: {"outputType":"describe_output","outputPath":".drs/describe-output.json"} Done!';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                outputType: 'describe_output',
+                outputPath: '.drs/describe-output.json',
+            });
+        });
+        it('should parse pure JSON string', () => {
+            const raw = '{"type": "feature", "title": "Test"}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ type: 'feature', title: 'Test' });
+        });
+        it('should handle nested JSON objects', () => {
+            const raw = `{"type": "feature", "title": "Test"}`;
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                type: 'feature',
+                title: 'Test',
+            });
+        });
+        it('should handle JSON with arrays', () => {
+            const raw = '{"items": [1, 2, 3]}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                items: [1, 2, 3],
+            });
+        });
+        it('should handle JSON with escaped quotes', () => {
+            const raw = '{"message": "This is a \\"quoted\\" string"}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                message: 'This is a "quoted" string',
+            });
+        });
+        it('should prefer last JSON candidate when multiple exist', () => {
+            const raw = 'First: {"id": 1} Second: {"id": 2}';
+            const result = parseJsonFromAgentOutput(raw);
+            // Should return the last valid JSON found
+            expect(result).toEqual({ id: 2 });
+        });
+        it('should prefer code fence over embedded JSON', () => {
+            const raw = `
+        {"id": 1}
+        \`\`\`json
+        {"id": 2}
+        \`\`\`
+      `;
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ id: 2 });
+        });
+        it('should throw error for invalid JSON', () => {
+            const raw = 'This is not JSON at all';
+            expect(() => parseJsonFromAgentOutput(raw)).toThrow();
+        });
+        it('should throw error for incomplete JSON', () => {
+            const raw = '{"type": "feature", "title":';
+            expect(() => parseJsonFromAgentOutput(raw)).toThrow();
+        });
+        it('should handle empty string', () => {
+            const raw = '';
+            expect(() => parseJsonFromAgentOutput(raw)).toThrow();
+        });
+        it('should handle JSON with null values', () => {
+            const raw = '{"value": null, "name": "test"}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ value: null, name: 'test' });
+        });
+        it('should handle JSON with boolean values', () => {
+            const raw = '{"enabled": true, "disabled": false}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ enabled: true, disabled: false });
+        });
+        it('should handle JSON with numbers', () => {
+            const raw = '{"integer": 42, "float": 3.14, "negative": -10}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({ integer: 42, float: 3.14, negative: -10 });
+        });
+        it('should handle markdown text with embedded JSON', () => {
+            const raw = `
+# Title
+
+Here is some explanation text.
+
+{"outputType":"describe_output","outputPath":".drs/output.json"}
+
+More text after.
+      `;
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                outputType: 'describe_output',
+                outputPath: '.drs/output.json',
+            });
+        });
+        it('should handle JSON with escaped characters', () => {
+            const raw = '{"pattern": "function() with \\"quotes\\""}';
+            const result = parseJsonFromAgentOutput(raw);
+            expect(result).toEqual({
+                pattern: 'function() with "quotes"',
+            });
+        });
+    });
+    describe('parseDescribeOutput', () => {
+        let testDir;
+        beforeEach(async () => {
+            // Create a unique temporary directory for each test
+            testDir = join(tmpdir(), `drs-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+            await mkdir(testDir, { recursive: true });
+            await mkdir(join(testDir, '.drs'), { recursive: true });
+        });
+        afterEach(async () => {
+            // Clean up test directory
+            try {
+                await rm(testDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        });
+        it('should read describe output from default path', async () => {
+            const describeData = {
+                type: 'feature',
+                title: 'Add new feature',
+                summary: ['Added authentication', 'Updated database schema'],
+            };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            const result = await parseDescribeOutput(testDir, false);
+            expect(result).toEqual(describeData);
+        });
+        it('should read describe output from pointer path', async () => {
+            const describeData = {
+                type: 'bugfix',
+                title: 'Fix authentication bug',
+                summary: ['Fixed login issue'],
+            };
+            await writeFile(join(testDir, '.drs/custom-output.json'), JSON.stringify(describeData));
+            const rawOutput = JSON.stringify({
+                outputType: 'describe_output',
+                outputPath: '.drs/custom-output.json',
+            });
+            const result = await parseDescribeOutput(testDir, false, rawOutput);
+            expect(result).toEqual(describeData);
+        });
+        it('should fall back to default path if pointer path not found', async () => {
+            const describeData = {
+                type: 'refactor',
+                title: 'Refactor code',
+                summary: ['Improved code quality'],
+            };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            const rawOutput = JSON.stringify({
+                outputType: 'describe_output',
+                outputPath: '.drs/nonexistent.json',
+            });
+            const result = await parseDescribeOutput(testDir, false, rawOutput);
+            expect(result).toEqual(describeData);
+        });
+        it('should throw error if no describe output found', async () => {
+            await expect(parseDescribeOutput(testDir, false)).rejects.toThrow('Describe output file not found');
+        });
+        it('should throw error for invalid output type in pointer', async () => {
+            const rawOutput = JSON.stringify({
+                outputType: 'invalid_type',
+                outputPath: '.drs/output.json',
+            });
+            await expect(parseDescribeOutput(testDir, false, rawOutput)).rejects.toThrow('Unexpected output type for describe output: invalid_type');
+        });
+        it('should handle pointer with only outputType field', async () => {
+            const describeData = {
+                type: 'docs',
+                title: 'Update documentation',
+            };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            const rawOutput = JSON.stringify({
+                outputType: 'describe_output',
+            });
+            const result = await parseDescribeOutput(testDir, false, rawOutput);
+            expect(result).toEqual(describeData);
+        });
+        it('should log debug messages when debug=true', async () => {
+            const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+            const describeData = { type: 'test' };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            await parseDescribeOutput(testDir, true);
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Describe output loaded from'));
+            logSpy.mockRestore();
+        });
+        it('should not log debug messages when debug=false', async () => {
+            const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+            const describeData = { type: 'test' };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            await parseDescribeOutput(testDir, false);
+            expect(logSpy).not.toHaveBeenCalled();
+            logSpy.mockRestore();
+        });
+        it('should refuse to read outside working directory', async () => {
+            const rawOutput = JSON.stringify({
+                outputType: 'describe_output',
+                outputPath: '../../../etc/passwd',
+            });
+            await expect(parseDescribeOutput(testDir, false, rawOutput)).rejects.toThrow('Refusing to read outside working directory');
+        });
+        it('should handle absolute paths within working directory', async () => {
+            const describeData = { type: 'feature' };
+            const outputPath = join(testDir, '.drs/describe-output.json');
+            await writeFile(outputPath, JSON.stringify(describeData));
+            const rawOutput = JSON.stringify({
+                outputType: 'describe_output',
+                outputPath: outputPath,
+            });
+            const result = await parseDescribeOutput(testDir, false, rawOutput);
+            expect(result).toEqual(describeData);
+        });
+        it('should handle invalid JSON in describe output file', async () => {
+            await writeFile(join(testDir, '.drs/describe-output.json'), 'not valid json');
+            await expect(parseDescribeOutput(testDir, false)).rejects.toThrow();
+        });
+        it('should use process.cwd() as default working directory', async () => {
+            // This test verifies the default parameter works
+            // We can't easily test the actual cwd behavior in isolation
+            const rawOutput = 'invalid pointer';
+            // Should attempt to use cwd and likely fail (unless file exists there)
+            await expect(parseDescribeOutput(undefined, false, rawOutput)).rejects.toThrow();
+        });
+        it('should handle pointer with invalid JSON format', async () => {
+            const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+            const describeData = { type: 'test' };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            const rawOutput = 'not valid json at all';
+            // Should fall back to default path since pointer parsing fails
+            const result = await parseDescribeOutput(testDir, true, rawOutput);
+            expect(result).toEqual(describeData);
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Describe output pointer parse failed'));
+            logSpy.mockRestore();
+        });
+        it('should handle complex describe output structure', async () => {
+            const describeData = {
+                type: 'feature',
+                title: 'Complex feature',
+                summary: ['Point 1', 'Point 2', 'Point 3'],
+                walkthrough: [
+                    {
+                        file: 'src/app.ts',
+                        changeType: 'modified',
+                        semanticLabel: 'feature',
+                        title: 'Added new function',
+                        changes: ['Added authentication', 'Updated routes'],
+                        significance: 'major',
+                    },
+                ],
+                labels: ['enhancement', 'security'],
+                recommendations: ['Add tests', 'Update docs'],
+            };
+            await writeFile(join(testDir, '.drs/describe-output.json'), JSON.stringify(describeData));
+            const result = await parseDescribeOutput(testDir, false);
+            expect(result).toEqual(describeData);
+        });
+    });
+});
+//# sourceMappingURL=describe-parser.test.js.map

package/dist/lib/describe-parser.test.js.map

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

package/dist/lib/description-executor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PR/MR description generation executor
+ *
+ * This module handles generating descriptions for pull requests and merge requests
+ * using the describe agent.
+ */
+import type { DRSConfig } from './config.js';
+import type { FileWithDiff } from './review-core.js';
+import type { PlatformClient, PullRequest } from './platform-client.js';
+import { type Description, type Platform } from './description-formatter.js';
+import type { OpencodeClient } from '../opencode/client.js';
+/**
+ * Detect platform type from PR/MR platform data
+ */
+export declare function detectPlatform(pr: PullRequest): Platform;
+/**
+ * Generate and optionally post a PR/MR description
+ *
+ * @returns The generated description, or null if description generation is disabled
+ */
+export declare function runDescribeIfEnabled(opencode: OpencodeClient, config: DRSConfig, platformClient: PlatformClient, projectId: string, pr: PullRequest, files: FileWithDiff[], shouldPostDescription: boolean, workingDir: string, debug?: boolean): Promise<Description | null>;
+//# sourceMappingURL=description-executor.d.ts.map

package/dist/lib/description-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-executor.d.ts","sourceRoot":"","sources":["../../src/lib/description-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,QAAQ,CAMxD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,YAAY,EAAE,EACrB,qBAAqB,EAAE,OAAO,EAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyD7B"}