@diff-review-system/drs 1.0.0 → 2.0.0

package/dist/lib/json-output-schema.test.js

@@ -0,0 +1,92 @@
+import { describe, expect, it } from 'vitest';
+import Ajv from 'ajv';
+import { describeOutputSchema, reviewOutputSchema } from './json-output-schema.js';
+const ajv = new Ajv({ allErrors: true });
+const validateDescribe = ajv.compile(describeOutputSchema);
+const validateReview = ajv.compile(reviewOutputSchema);
+describe('json-output schemas', () => {
+    it('validates describe output schema', () => {
+        const payload = {
+            type: 'feature',
+            title: 'Add describe output validation tooling',
+            summary: ['Adds schema validation for describe output'],
+            walkthrough: [
+                {
+                    file: 'src/lib/describe-core.ts',
+                    changeType: 'modified',
+                    semanticLabel: 'feature',
+                    title: 'Require tool-based output',
+                    changes: ['Adds write_json_output requirement'],
+                    significance: 'major',
+                },
+            ],
+            labels: ['feature', 'describe'],
+            recommendations: ['Add unit tests for schema validation'],
+        };
+        const isValid = validateDescribe(payload);
+        expect(isValid).toBe(true);
+        expect(validateDescribe.errors).toBeNull();
+    });
+    it('rejects describe output with invalid type', () => {
+        const payload = {
+            type: 'invalid',
+            title: 'Bad type',
+            summary: ['Invalid type'],
+        };
+        const isValid = validateDescribe(payload);
+        expect(isValid).toBe(false);
+    });
+    it('validates review output schema', () => {
+        const payload = {
+            timestamp: new Date().toISOString(),
+            summary: {
+                filesReviewed: 3,
+                issuesFound: 2,
+                bySeverity: {
+                    CRITICAL: 0,
+                    HIGH: 1,
+                    MEDIUM: 1,
+                    LOW: 0,
+                },
+                byCategory: {
+                    SECURITY: 1,
+                    QUALITY: 1,
+                    STYLE: 0,
+                    PERFORMANCE: 0,
+                    DOCUMENTATION: 0,
+                },
+            },
+            issues: [
+                {
+                    category: 'SECURITY',
+                    severity: 'HIGH',
+                    title: 'Avoid plaintext secrets',
+                    file: 'src/config.ts',
+                    problem: 'Secret is stored in code.',
+                    solution: 'Use environment variables.',
+                    agent: 'review/security',
+                },
+            ],
+            metadata: {
+                source: 'PR #123',
+                project: 'org/repo',
+                branch: {
+                    source: 'feature',
+                    target: 'main',
+                },
+            },
+        };
+        const isValid = validateReview(payload);
+        expect(isValid).toBe(true);
+        expect(validateReview.errors).toBeNull();
+    });
+    it('rejects review output with missing summary', () => {
+        const payload = {
+            timestamp: new Date().toISOString(),
+            issues: [],
+        };
+        const isValid = validateReview(payload);
+        expect(isValid).toBe(false);
+    });
+});
+//# sourceMappingURL=json-output-schema.test.js.map

package/dist/lib/json-output-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output-schema.test.js","sourceRoot":"","sources":["../../src/lib/json-output-schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAC3D,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEvD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,wCAAwC;YAC/C,OAAO,EAAE,CAAC,4CAA4C,CAAC;YACvD,WAAW,EAAE;gBACX;oBACE,IAAI,EAAE,0BAA0B;oBAChC,UAAU,EAAE,UAAU;oBACtB,aAAa,EAAE,SAAS;oBACxB,KAAK,EAAE,2BAA2B;oBAClC,OAAO,EAAE,CAAC,oCAAoC,CAAC;oBAC/C,YAAY,EAAE,OAAO;iBACtB;aACF;YACD,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;YAC/B,eAAe,EAAE,CAAC,sCAAsC,CAAC;SAC1D,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,CAAC,cAAc,CAAC;SAC1B,CAAC;QAEF,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE;gBACP,aAAa,EAAE,CAAC;gBAChB,WAAW,EAAE,CAAC;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,CAAC;oBACX,IAAI,EAAE,CAAC;oBACP,MAAM,EAAE,CAAC;oBACT,GAAG,EAAE,CAAC;iBACP;gBACD,UAAU,EAAE;oBACV,QAAQ,EAAE,CAAC;oBACX,OAAO,EAAE,CAAC;oBACV,KAAK,EAAE,CAAC;oBACR,WAAW,EAAE,CAAC;oBACd,aAAa,EAAE,CAAC;iBACjB;aACF;YACD,MAAM,EAAE;gBACN;oBACE,QAAQ,EAAE,UAAU;oBACpB,QAAQ,EAAE,MAAM;oBAChB,KAAK,EAAE,yBAAyB;oBAChC,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,2BAA2B;oBACpC,QAAQ,EAAE,4BAA4B;oBACtC,KAAK,EAAE,iBAAiB;iBACzB;aACF;YACD,QAAQ,EAAE;gBACR,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE;oBACN,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,MAAM;iBACf;aACF;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,EAAE;SACX,CAAC;QAEF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/json-output.d.ts

@@ -0,0 +1,43 @@
+/**
+ * JSON output formatting for review results
+ *
+ * Provides structured JSON output for review results when
+ * not posting comments or generating code quality reports.
+ */
+import type { ReviewIssue, ReviewSummary } from './comment-formatter.js';
+/**
+ * JSON output structure for review results
+ */
+export interface ReviewJsonOutput {
+    /** Timestamp of the review */
+    timestamp: string;
+    /** Review summary statistics */
+    summary: ReviewSummary;
+    /** All issues found */
+    issues: ReviewIssue[];
+    /** Metadata about the review */
+    metadata?: {
+        /** Source of the review (PR number, MR iid, or local) */
+        source?: string;
+        /** Project identifier */
+        project?: string;
+        /** Branch information */
+        branch?: {
+            source?: string;
+            target?: string;
+        };
+    };
+}
+/**
+ * Format review results as JSON output
+ */
+export declare function formatReviewJson(summary: ReviewSummary, issues: ReviewIssue[], metadata?: ReviewJsonOutput['metadata']): ReviewJsonOutput;
+/**
+ * Write review results to a JSON file
+ */
+export declare function writeReviewJson(output: ReviewJsonOutput, outputPath: string, workingDir?: string): Promise<void>;
+/**
+ * Print review results as JSON to console
+ */
+export declare function printReviewJson(output: ReviewJsonOutput): void;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/lib/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/lib/json-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,uBAAuB;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE;QACT,yDAAyD;QACzD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,yBAAyB;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,yBAAyB;QACzB,MAAM,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,WAAW,EAAE,EACrB,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACtC,gBAAgB,CAOlB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE9D"}

package/dist/lib/json-output.js

@@ -0,0 +1,34 @@
+/**
+ * JSON output formatting for review results
+ *
+ * Provides structured JSON output for review results when
+ * not posting comments or generating code quality reports.
+ */
+import { writeFile } from 'fs/promises';
+import { resolve } from 'path';
+/**
+ * Format review results as JSON output
+ */
+export function formatReviewJson(summary, issues, metadata) {
+    return {
+        timestamp: new Date().toISOString(),
+        summary,
+        issues,
+        metadata,
+    };
+}
+/**
+ * Write review results to a JSON file
+ */
+export async function writeReviewJson(output, outputPath, workingDir = process.cwd()) {
+    const fullPath = resolve(workingDir, outputPath);
+    const jsonContent = JSON.stringify(output, null, 2);
+    await writeFile(fullPath, jsonContent, 'utf-8');
+}
+/**
+ * Print review results as JSON to console
+ */
+export function printReviewJson(output) {
+    console.log(JSON.stringify(output, null, 2));
+}
+//# sourceMappingURL=json-output.js.map

package/dist/lib/json-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/lib/json-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AA2B/B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAsB,EACtB,MAAqB,EACrB,QAAuC;IAEvC,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;QACP,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,UAAkB,EAClB,aAAqB,OAAO,CAAC,GAAG,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/output-paths.d.ts

@@ -0,0 +1,6 @@
+export declare const OUTPUT_PATHS: {
+    readonly describe_output: ".drs/describe-output.json";
+    readonly review_output: ".drs/review-output.json";
+};
+export type OutputType = keyof typeof OUTPUT_PATHS;
+//# sourceMappingURL=output-paths.d.ts.map

package/dist/lib/output-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-paths.d.ts","sourceRoot":"","sources":["../../src/lib/output-paths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC"}

package/dist/lib/output-paths.js

@@ -0,0 +1,5 @@
+export const OUTPUT_PATHS = {
+    describe_output: '.drs/describe-output.json',
+    review_output: '.drs/review-output.json',
+};
+//# sourceMappingURL=output-paths.js.map

package/dist/lib/output-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-paths.js","sourceRoot":"","sources":["../../src/lib/output-paths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,eAAe,EAAE,2BAA2B;IAC5C,aAAa,EAAE,yBAAyB;CAChC,CAAC"}

package/dist/lib/platform-client.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Platform abstraction layer for GitHub and GitLab
+ *
+ * This module provides common interfaces for interacting with different
+ * code review platforms (GitHub, GitLab) in a unified way.
+ */
+/**
+ * Represents a file change in a pull/merge request
+ */
+export interface FileChange {
+    /** Path to the file */
+    filename: string;
+    /** Type of change */
+    status: 'added' | 'removed' | 'modified' | 'renamed' | 'copied' | 'changed' | 'unchanged';
+    /** Number of lines added */
+    additions: number;
+    /** Number of lines deleted */
+    deletions: number;
+    /** Unified diff patch */
+    patch?: string;
+    /** Previous filename (for renamed files) */
+    previousFilename?: string;
+}
+/**
+ * Represents a pull/merge request
+ */
+export interface PullRequest {
+    /** PR/MR number or ID */
+    number: number;
+    /** Title */
+    title: string;
+    /** Description/body */
+    description?: string;
+    /** Author username or name */
+    author: string;
+    /** Source branch */
+    sourceBranch: string;
+    /** Target branch */
+    targetBranch: string;
+    /** Head commit SHA */
+    headSha: string;
+    /** Additional platform-specific data */
+    platformData?: unknown;
+}
+/**
+ * Represents a comment on a PR/MR
+ */
+export interface Comment {
+    /** Comment ID */
+    id: number | string;
+    /** Comment body/content */
+    body: string;
+}
+/**
+ * Position data for inline comments
+ */
+export interface InlineCommentPosition {
+    /** File path */
+    path: string;
+    /** Line number in the new version */
+    line: number;
+    /** Commit SHA (GitHub) or diff refs (GitLab) */
+    commitSha?: string;
+    baseSha?: string;
+    headSha?: string;
+    startSha?: string;
+}
+/**
+ * Common interface for platform clients (GitHub, GitLab, etc.)
+ */
+export interface PlatformClient {
+    /**
+     * Get pull/merge request details
+     */
+    getPullRequest(projectId: string, prNumber: number): Promise<PullRequest>;
+    /**
+     * Get list of changed files in a PR/MR
+     */
+    getChangedFiles(projectId: string, prNumber: number): Promise<FileChange[]>;
+    /**
+     * Get existing comments on the PR/MR
+     */
+    getComments(projectId: string, prNumber: number): Promise<Comment[]>;
+    /**
+     * Get existing inline/review comments
+     */
+    getInlineComments(projectId: string, prNumber: number): Promise<Comment[]>;
+    /**
+     * Create a general comment on the PR/MR
+     */
+    createComment(projectId: string, prNumber: number, body: string): Promise<void>;
+    /**
+     * Update an existing comment
+     */
+    updateComment(projectId: string, prNumber: number, commentId: number | string, body: string): Promise<void>;
+    /**
+     * Create an inline comment at a specific line
+     */
+    createInlineComment(projectId: string, prNumber: number, body: string, position: InlineCommentPosition): Promise<void>;
+    /**
+     * Create multiple inline comments in bulk (if supported)
+     * Falls back to individual comments if not supported
+     */
+    createBulkInlineComments(projectId: string, prNumber: number, comments: Array<{
+        body: string;
+        position: InlineCommentPosition;
+    }>): Promise<void>;
+    /**
+     * Add labels to the PR/MR
+     */
+    addLabels(projectId: string, prNumber: number, labels: string[]): Promise<void>;
+    /**
+     * Check if PR/MR has a specific label
+     */
+    hasLabel(projectId: string, prNumber: number, label: string): Promise<boolean>;
+}
+/**
+ * Validator for checking if a line can be commented on
+ */
+export interface LineValidator {
+    /**
+     * Check if a line number is valid for commenting
+     */
+    isValidLine(file: string, line: number): boolean;
+}
+/**
+ * Factory function type for creating platform clients
+ */
+export type PlatformClientFactory = () => PlatformClient;
+//# sourceMappingURL=platform-client.d.ts.map

package/dist/lib/platform-client.d.ts.map

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

package/dist/lib/platform-client.js

@@ -0,0 +1,8 @@
+/**
+ * Platform abstraction layer for GitHub and GitLab
+ *
+ * This module provides common interfaces for interacting with different
+ * code review platforms (GitHub, GitLab) in a unified way.
+ */
+export {};
+//# sourceMappingURL=platform-client.js.map

package/dist/lib/platform-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client.js","sourceRoot":"","sources":["../../src/lib/platform-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/lib/position-validator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Position validation utilities for platform-specific inline comment requirements
+ */
+import type { InlineCommentPosition } from './platform-client.js';
+/**
+ * Result of position validation
+ */
+export interface PositionValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * Base interface for position validators
+ */
+export interface PositionValidator {
+    validate(position: InlineCommentPosition): PositionValidationResult;
+}
+/**
+ * GitHub position validator
+ * Requires: commitSha
+ */
+export declare class GitHubPositionValidator implements PositionValidator {
+    validate(position: InlineCommentPosition): PositionValidationResult;
+}
+/**
+ * GitLab position validator
+ * Requires: baseSha, headSha, startSha
+ */
+export declare class GitLabPositionValidator implements PositionValidator {
+    validate(position: InlineCommentPosition): PositionValidationResult;
+}
+/**
+ * Helper to validate and throw if invalid
+ */
+export declare function validatePositionOrThrow(position: InlineCommentPosition, validator: PositionValidator): void;
+//# sourceMappingURL=position-validator.d.ts.map

package/dist/lib/position-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-validator.d.ts","sourceRoot":"","sources":["../../src/lib/position-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,wBAAwB,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,wBAAwB;CASpE;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,wBAAwB;CASpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,qBAAqB,EAC/B,SAAS,EAAE,iBAAiB,GAC3B,IAAI,CAKN"}

package/dist/lib/position-validator.js

@@ -0,0 +1,43 @@
+/**
+ * Position validation utilities for platform-specific inline comment requirements
+ */
+/**
+ * GitHub position validator
+ * Requires: commitSha
+ */
+export class GitHubPositionValidator {
+    validate(position) {
+        if (!position.commitSha) {
+            return {
+                isValid: false,
+                error: 'GitHub requires commitSha for inline comments',
+            };
+        }
+        return { isValid: true };
+    }
+}
+/**
+ * GitLab position validator
+ * Requires: baseSha, headSha, startSha
+ */
+export class GitLabPositionValidator {
+    validate(position) {
+        if (!position.baseSha || !position.headSha || !position.startSha) {
+            return {
+                isValid: false,
+                error: 'GitLab requires baseSha, headSha, and startSha for inline comments',
+            };
+        }
+        return { isValid: true };
+    }
+}
+/**
+ * Helper to validate and throw if invalid
+ */
+export function validatePositionOrThrow(position, validator) {
+    const result = validator.validate(position);
+    if (!result.isValid) {
+        throw new Error(result.error);
+    }
+}
+//# sourceMappingURL=position-validator.js.map

package/dist/lib/position-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-validator.js","sourceRoot":"","sources":["../../src/lib/position-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAClC,QAAQ,CAAC,QAA+B;QACtC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,+CAA+C;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAClC,QAAQ,CAAC,QAA+B;QACtC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,oEAAoE;aAC5E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA+B,EAC/B,SAA4B;IAE5B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/lib/repository-validator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Repository validation utilities for PR/MR reviews
+ *
+ * This module handles repository and branch validation to ensure
+ * that reviews are run from the correct repository and branch.
+ */
+import type { PullRequest } from './platform-client.js';
+export interface RepoInfo {
+    host?: string;
+    repoPath?: string;
+    remoteUrl?: string;
+}
+export interface BaseBranchResolution {
+    baseBranch?: string;
+    resolvedBaseBranch?: string;
+    source?: string;
+}
+/**
+ * Normalize a repository path by removing leading slashes and .git suffix
+ */
+export declare function normalizeRepoPath(path: string): string;
+/**
+ * Parse a git remote URL to extract host and repository path
+ */
+export declare function parseRemoteUrl(remoteUrl: string): RepoInfo | null;
+/**
+ * Extract expected repository info from PR/MR platform data
+ */
+export declare function getExpectedRepoInfo(pr: {
+    platformData?: unknown;
+}, projectId: string): RepoInfo | null;
+/**
+ * Normalize a base branch name by adding origin/ prefix if needed
+ */
+export declare function normalizeBaseBranch(baseBranch?: string): string | undefined;
+/**
+ * Resolve the base branch from CLI, environment variables, or PR/MR data
+ */
+export declare function resolveBaseBranch(cliBaseBranch?: string, targetBranch?: string): BaseBranchResolution;
+/**
+ * Generate a canonical git diff command for documentation purposes
+ */
+export declare function getCanonicalDiffCommand(pr: PullRequest, baseBranchResolution: BaseBranchResolution): string;
+/**
+ * Enforce that the current working directory matches the PR/MR repository and branch
+ *
+ * This prevents accidentally reviewing the wrong repository or branch.
+ *
+ * @throws Error if repository or branch doesn't match
+ */
+export declare function enforceRepoBranchMatch(workingDir: string, projectId: string, pr: PullRequest): Promise<void>;
+//# sourceMappingURL=repository-validator.d.ts.map

package/dist/lib/repository-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-validator.d.ts","sourceRoot":"","sources":["../../src/lib/repository-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CA8BjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9B,SAAS,EAAE,MAAM,GAChB,QAAQ,GAAG,IAAI,CAyCjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,oBAAoB,CAoDtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,WAAW,EACf,oBAAoB,EAAE,oBAAoB,GACzC,MAAM,CA0BR;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,IAAI,CAAC,CAiEf"}