@diff-review-system/drs 1.0.0 → 2.0.0

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"}

package/dist/lib/description-executor.js

@@ -0,0 +1,72 @@
+/**
+ * PR/MR description generation executor
+ *
+ * This module handles generating descriptions for pull requests and merge requests
+ * using the describe agent.
+ */
+import chalk from 'chalk';
+import { buildDescribeInstructions } from './describe-core.js';
+import { compressFilesWithDiffs, formatCompressionSummary } from './context-compression.js';
+import { displayDescription, normalizeDescription, postDescription, } from './description-formatter.js';
+import { parseDescribeOutput } from './describe-parser.js';
+/**
+ * Detect platform type from PR/MR platform data
+ */
+export function detectPlatform(pr) {
+    const platformData = pr.platformData;
+    if (platformData && ('iid' in platformData || 'diff_refs' in platformData)) {
+        return 'MR';
+    }
+    return 'PR';
+}
+/**
+ * Generate and optionally post a PR/MR description
+ *
+ * @returns The generated description, or null if description generation is disabled
+ */
+export async function runDescribeIfEnabled(opencode, config, platformClient, projectId, pr, files, shouldPostDescription, workingDir, debug) {
+    console.log(chalk.bold.blue('\n🔍 Generating PR/MR Description\n'));
+    const label = `${detectPlatform(pr)} #${pr.number}`;
+    const compression = compressFilesWithDiffs(files, config.contextCompression);
+    const compressionSummary = formatCompressionSummary(compression);
+    if (compressionSummary) {
+        console.log(chalk.yellow('⚠ Diff content trimmed to fit token budget.\n'));
+    }
+    const instructions = buildDescribeInstructions(label, compression.files, compressionSummary);
+    if (debug) {
+        console.log(chalk.yellow('\n=== Describe Agent Instructions ==='));
+        console.log(instructions);
+        console.log(chalk.yellow('=== End Instructions ===\n'));
+    }
+    // Run describe agent
+    const session = await opencode.createSession({
+        agent: 'describe/pr-describer',
+        message: instructions,
+    });
+    let fullResponse = '';
+    for await (const message of opencode.streamMessages(session.id)) {
+        if (message.role === 'assistant') {
+            fullResponse += message.content;
+        }
+    }
+    // Parse agent output
+    let descriptionPayload;
+    try {
+        descriptionPayload = (await parseDescribeOutput(workingDir, debug, fullResponse));
+    }
+    catch (parseError) {
+        console.error(chalk.red('Failed to parse agent output as JSON'));
+        console.log(chalk.dim('Agent output:'), fullResponse);
+        const reason = parseError instanceof Error ? `: ${parseError.message}` : '';
+        throw new Error(`Describe agent did not return valid JSON output${reason}`);
+    }
+    // Display and optionally post description
+    const description = normalizeDescription(descriptionPayload);
+    const platform = detectPlatform(pr);
+    displayDescription(description, platform);
+    if (shouldPostDescription) {
+        await postDescription(platformClient, projectId, pr.number, description, platform);
+    }
+    return description;
+}
+//# sourceMappingURL=description-executor.js.map

package/dist/lib/description-executor.js.map

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

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

@@ -0,0 +1,37 @@
+import type { PlatformClient } from './platform-client.js';
+export interface DescriptionWalkthroughEntry {
+    file: string;
+    changeType: string;
+    semanticLabel: string;
+    title: string;
+    changes?: string[];
+    significance?: string;
+}
+export interface Description {
+    type: string;
+    title: string;
+    summary: string[];
+    walkthrough?: DescriptionWalkthroughEntry[];
+    labels?: string[];
+    recommendations?: string[];
+}
+export declare function normalizeDescription(description: unknown): Description;
+export type Platform = 'PR' | 'MR';
+/**
+ * Display description to console
+ */
+export declare function displayDescription(description: Description, platform?: Platform): void;
+/**
+ * Get colored terminal icon for change type
+ */
+export declare function getChangeIcon(changeType: string): string;
+/**
+ * Get markdown emoji icon for change type
+ */
+export declare function getMarkdownChangeIcon(changeType: string): string;
+export declare function formatDescriptionAsMarkdown(description: Description, platform?: Platform): string;
+/**
+ * Post description to PR/MR as comment
+ */
+export declare function postDescription(platformAdapter: PlatformClient, projectId: string, prNumber: number, description: Description, platform?: Platform): Promise<void>;
+//# sourceMappingURL=description-formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"description-formatter.d.ts","sourceRoot":"","sources":["../../src/lib/description-formatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAsBD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,CAwEtE;AAED,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAe,QAmDrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAahE;AAeD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,QAAQ,GAAE,QAAe,GACxB,MAAM,CA+CR;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,eAAe,EAAE,cAAc,EAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,GAAE,QAAe,iBAe1B"}