@diff-review-system/drs 2.2.0 → 3.0.0-rc.1

package/dist/lib/exit.js

@@ -0,0 +1,53 @@
+/**
+ * Process exit abstraction for testability.
+ *
+ * Library code should call `exitProcess(code)` instead of `process.exit(code)`.
+ * In tests the handler can be replaced with `setExitHandler()` to capture
+ * the exit code without terminating the process.
+ */
+let currentHandler = ((code) => {
+    process.exit(code);
+});
+/**
+ * Exit the process (or trigger the installed handler in tests).
+ */
+export function exitProcess(code) {
+    return currentHandler(code);
+}
+/**
+ * Replace the exit handler. Returns a restore function.
+ *
+ * ```ts
+ * const restore = setExitHandler((code) => { throw new ExitError(code); });
+ * try { ... } finally { restore(); }
+ * ```
+ */
+export function setExitHandler(handler) {
+    const previous = currentHandler;
+    currentHandler = handler;
+    return () => {
+        currentHandler = previous;
+    };
+}
+/**
+ * Error thrown by the test exit handler so callers can
+ * assert on the exit code.
+ */
+export class ExitError extends Error {
+    code;
+    constructor(code) {
+        super(`process.exit(${code})`);
+        this.code = code;
+        this.name = 'ExitError';
+    }
+}
+/**
+ * Install a test exit handler that throws `ExitError`.
+ * Returns a restore function.
+ */
+export function installTestExitHandler() {
+    return setExitHandler(((code) => {
+        throw new ExitError(code);
+    }));
+}
+//# sourceMappingURL=exit.js.map

package/dist/lib/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/lib/exit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,IAAI,cAAc,GAAgB,CAAC,CAAC,IAAY,EAAE,EAAE;IAClD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAgB,CAAC;AAElB;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAAoB;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC;IAChC,cAAc,GAAG,OAAO,CAAC;IACzB,OAAO,GAAG,EAAE;QACV,cAAc,GAAG,QAAQ,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACN;IAA5B,YAA4B,IAAY;QACtC,KAAK,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;QADL,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,cAAc,CAAC,CAAC,CAAC,IAAY,EAAE,EAAE;QACtC,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAgB,CAAC,CAAC;AACrB,CAAC"}

package/dist/lib/exit.test.d.ts

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

package/dist/lib/exit.test.d.ts.map

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

package/dist/lib/exit.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { exitProcess, setExitHandler, installTestExitHandler, ExitError } from './exit.js';
+describe('exit', () => {
+    let restore;
+    afterEach(() => {
+        restore?.();
+        restore = undefined;
+    });
+    describe('exitProcess', () => {
+        it('calls the installed handler with the exit code', () => {
+            let capturedCode;
+            restore = setExitHandler(((code) => {
+                capturedCode = code;
+            }));
+            try {
+                exitProcess(1);
+            }
+            catch {
+                // handler may not actually be `never` in test
+            }
+            expect(capturedCode).toBe(1);
+        });
+        it('passes exit code 0 for success', () => {
+            let capturedCode;
+            restore = setExitHandler(((code) => {
+                capturedCode = code;
+            }));
+            try {
+                exitProcess(0);
+            }
+            catch {
+                // handler may not actually be `never` in test
+            }
+            expect(capturedCode).toBe(0);
+        });
+    });
+    describe('setExitHandler', () => {
+        it('returns a restore function that reverts to previous handler', () => {
+            const codes = [];
+            const first = setExitHandler(((code) => {
+                codes.push(code);
+            }));
+            const second = setExitHandler(((code) => {
+                codes.push(code * 10);
+            }));
+            try {
+                exitProcess(1);
+            }
+            catch {
+                /* noop */
+            }
+            expect(codes).toEqual([10]); // second handler
+            second(); // restore to first
+            try {
+                exitProcess(2);
+            }
+            catch {
+                /* noop */
+            }
+            expect(codes).toEqual([10, 2]); // first handler
+            first(); // restore to original
+            restore = undefined; // already cleaned up
+        });
+    });
+    describe('installTestExitHandler', () => {
+        it('throws ExitError with the exit code', () => {
+            restore = installTestExitHandler();
+            expect(() => exitProcess(1)).toThrow(ExitError);
+            expect(() => exitProcess(1)).toThrow('process.exit(1)');
+        });
+        it('captures exit code 0', () => {
+            restore = installTestExitHandler();
+            try {
+                exitProcess(0);
+            }
+            catch (e) {
+                expect(e).toBeInstanceOf(ExitError);
+                expect(e.code).toBe(0);
+            }
+        });
+        it('restore function reverts the handler', () => {
+            const restoreFn = installTestExitHandler();
+            // Should throw while installed
+            expect(() => exitProcess(1)).toThrow(ExitError);
+            restoreFn();
+            restore = undefined;
+            // After restore, we can't easily test it calls process.exit
+            // without actually exiting. Just verify no ExitError.
+            let capturedCode;
+            restore = setExitHandler(((code) => {
+                capturedCode = code;
+            }));
+            try {
+                exitProcess(42);
+            }
+            catch {
+                /* noop */
+            }
+            expect(capturedCode).toBe(42);
+        });
+    });
+    describe('ExitError', () => {
+        it('has name ExitError', () => {
+            const err = new ExitError(1);
+            expect(err.name).toBe('ExitError');
+        });
+        it('has code property', () => {
+            expect(new ExitError(0).code).toBe(0);
+            expect(new ExitError(1).code).toBe(1);
+            expect(new ExitError(127).code).toBe(127);
+        });
+        it('has descriptive message', () => {
+            expect(new ExitError(1).message).toBe('process.exit(1)');
+        });
+        it('is instanceof Error', () => {
+            expect(new ExitError(1)).toBeInstanceOf(Error);
+        });
+    });
+});
+//# sourceMappingURL=exit.test.js.map

package/dist/lib/exit.test.js.map

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

package/dist/lib/format-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function formatCount(value: number): string;
+export declare function formatCost(value: number): string;
+//# sourceMappingURL=format-utils.d.ts.map

package/dist/lib/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../src/lib/format-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/lib/format-utils.js

@@ -0,0 +1,7 @@
+export function formatCount(value) {
+    return new Intl.NumberFormat('en-US').format(Math.round(value));
+}
+export function formatCost(value) {
+    return `$${value.toFixed(4)}`;
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/lib/format-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.js","sourceRoot":"","sources":["../../src/lib/format-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC"}

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

@@ -5,6 +5,7 @@
  * not posting comments or generating code quality reports.
  */
 import type { ReviewIssue, ReviewSummary } from './comment-formatter.js';
+import type { ReviewUsageSummary } from './review-usage.js';
 /**
  * JSON output structure for review results
  */
@@ -15,6 +16,8 @@ export interface ReviewJsonOutput {
     summary: ReviewSummary;
     /** All issues found */
     issues: ReviewIssue[];
+    /** Token usage and cost breakdown */
+    usage?: ReviewUsageSummary;
     /** Metadata about the review */
     metadata?: {
         /** Source of the review (PR number, MR iid, or local) */
@@ -31,7 +34,7 @@ export interface ReviewJsonOutput {
 /**
  * Format review results as JSON output
  */
-export declare function formatReviewJson(summary: ReviewSummary, issues: ReviewIssue[], metadata?: ReviewJsonOutput['metadata']): ReviewJsonOutput;
+export declare function formatReviewJson(summary: ReviewSummary, issues: ReviewIssue[], metadata?: ReviewJsonOutput['metadata'], usage?: ReviewUsageSummary): ReviewJsonOutput;
 /**
  * Write review results to a JSON file
  */

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

@@ -1 +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"}
+{"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;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;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,qCAAqC;IACrC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,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,EACvC,KAAK,CAAC,EAAE,kBAAkB,GACzB,gBAAgB,CAQlB;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

@@ -9,11 +9,12 @@ import { resolve } from 'path';
 /**
  * Format review results as JSON output
  */
-export function formatReviewJson(summary, issues, metadata) {
+export function formatReviewJson(summary, issues, metadata, usage) {
     return {
         timestamp: new Date().toISOString(),
         summary,
         issues,
+        usage,
         metadata,
     };
 }

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

@@ -1 +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"}
+{"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;AA8B/B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAsB,EACtB,MAAqB,EACrB,QAAuC,EACvC,KAA0B;IAE1B,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;QACP,MAAM;QACN,KAAK;QACL,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/json-output.test.d.ts

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

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

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

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

@@ -0,0 +1,135 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { writeFile, readFile, rm, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { formatReviewJson, writeReviewJson, printReviewJson } from './json-output.js';
+// ── Fixtures ─────────────────────────────────────────────────────
+const SUMMARY = {
+    filesReviewed: 5,
+    issuesFound: 2,
+    bySeverity: { CRITICAL: 0, HIGH: 1, MEDIUM: 1, LOW: 0 },
+    byCategory: { SECURITY: 1, QUALITY: 1, STYLE: 0, PERFORMANCE: 0, DOCUMENTATION: 0 },
+};
+const ISSUES = [
+    {
+        category: 'SECURITY',
+        severity: 'HIGH',
+        title: 'SQL Injection',
+        file: 'src/db.ts',
+        line: 42,
+        problem: 'Unsanitized query',
+        solution: 'Use parameterized queries',
+        agent: 'security',
+    },
+    {
+        category: 'QUALITY',
+        severity: 'MEDIUM',
+        title: 'Missing null check',
+        file: 'src/utils.ts',
+        problem: 'Possible null dereference',
+        solution: 'Add null guard',
+        agent: 'quality',
+    },
+];
+// ── formatReviewJson ─────────────────────────────────────────────
+describe('formatReviewJson', () => {
+    it('creates output with timestamp, summary, and issues', () => {
+        const result = formatReviewJson(SUMMARY, ISSUES);
+        expect(result.timestamp).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        expect(result.summary).toEqual(SUMMARY);
+        expect(result.issues).toEqual(ISSUES);
+        expect(result.usage).toBeUndefined();
+        expect(result.metadata).toBeUndefined();
+    });
+    it('includes metadata when provided', () => {
+        const metadata = {
+            source: 'MR !42',
+            project: 'org/repo',
+            branch: { source: 'feature', target: 'main' },
+        };
+        const result = formatReviewJson(SUMMARY, ISSUES, metadata);
+        expect(result.metadata).toEqual(metadata);
+    });
+    it('includes usage when provided', () => {
+        const usage = {
+            total: {
+                input: 1000,
+                output: 200,
+                cacheRead: 50,
+                cacheWrite: 10,
+                totalTokens: 1260,
+                cost: 0.005,
+            },
+            agents: [],
+        };
+        const result = formatReviewJson(SUMMARY, ISSUES, undefined, usage);
+        expect(result.usage).toEqual(usage);
+    });
+    it('handles empty issues array', () => {
+        const emptySummary = {
+            filesReviewed: 3,
+            issuesFound: 0,
+            bySeverity: { CRITICAL: 0, HIGH: 0, MEDIUM: 0, LOW: 0 },
+            byCategory: { SECURITY: 0, QUALITY: 0, STYLE: 0, PERFORMANCE: 0, DOCUMENTATION: 0 },
+        };
+        const result = formatReviewJson(emptySummary, []);
+        expect(result.issues).toEqual([]);
+        expect(result.summary.issuesFound).toBe(0);
+    });
+});
+// ── writeReviewJson ──────────────────────────────────────────────
+describe('writeReviewJson', () => {
+    let testDir;
+    afterEach(async () => {
+        if (testDir) {
+            await rm(testDir, { recursive: true, force: true });
+        }
+    });
+    it('writes formatted JSON to the specified path', async () => {
+        testDir = join(tmpdir(), `drs-json-output-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(testDir, { recursive: true });
+        const output = formatReviewJson(SUMMARY, ISSUES);
+        const outputPath = 'review.json';
+        await writeReviewJson(output, outputPath, testDir);
+        const content = await readFile(join(testDir, outputPath), 'utf-8');
+        const parsed = JSON.parse(content);
+        expect(parsed.summary.filesReviewed).toBe(5);
+        expect(parsed.issues).toHaveLength(2);
+        // Verify 2-space indent
+        expect(content).toContain('  "timestamp"');
+    });
+    it('overwrites existing file', async () => {
+        testDir = join(tmpdir(), `drs-json-output-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(testDir, { recursive: true });
+        const outputPath = 'review.json';
+        await writeFile(join(testDir, outputPath), '{"old": true}');
+        const output = formatReviewJson(SUMMARY, ISSUES);
+        await writeReviewJson(output, outputPath, testDir);
+        const content = await readFile(join(testDir, outputPath), 'utf-8');
+        const parsed = JSON.parse(content);
+        expect(parsed.old).toBeUndefined();
+        expect(parsed.issues).toHaveLength(2);
+    });
+});
+// ── printReviewJson ──────────────────────────────────────────────
+describe('printReviewJson', () => {
+    it('prints formatted JSON to console.log', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const output = formatReviewJson(SUMMARY, ISSUES);
+        printReviewJson(output);
+        expect(spy).toHaveBeenCalledTimes(1);
+        const printed = String(spy.mock.calls[0][0]);
+        const parsed = JSON.parse(printed);
+        expect(parsed.issues).toHaveLength(2);
+        spy.mockRestore();
+    });
+    it('output is valid JSON with 2-space indent', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        printReviewJson(formatReviewJson(SUMMARY, []));
+        const printed = String(spy.mock.calls[0][0]);
+        expect(printed).toContain('  "timestamp"');
+        expect(() => JSON.parse(printed)).not.toThrow();
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=json-output.test.js.map

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

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Structured logging utility for DRS
+ *
+ * Supports both human-readable (colored CLI) and JSON structured output.
+ * Provides log levels, context tracking, and consistent formatting.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogFormat = 'human' | 'json';
+export interface LogContext {
+    /** Agent type (e.g., 'security', 'unified-reviewer') */
+    agent?: string;
+    /** Tool name (e.g., 'write_json_output', 'read') */
+    tool?: string;
+    /** Skill name if applicable */
+    skill?: string;
+    /** Session ID */
+    sessionId?: string;
+    /** Additional metadata */
+    [key: string]: unknown;
+}
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: LogContext;
+    data?: unknown;
+}
+interface LoggerOptions {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Output format */
+    format: LogFormat;
+    /** Include timestamps in output */
+    timestamps: boolean;
+    /** Enable colored output (human format only) */
+    colors: boolean;
+}
+declare class Logger {
+    private options;
+    private defaultContext;
+    constructor(options?: Partial<LoggerOptions>);
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Set the output format
+     */
+    setFormat(format: LogFormat): void;
+    /**
+     * Enable or disable timestamps
+     */
+    setTimestamps(enabled: boolean): void;
+    /**
+     * Set default context that will be included in all log entries
+     */
+    setDefaultContext(context: LogContext): void;
+    /**
+     * Create a child logger with additional default context
+     */
+    child(context: LogContext): Logger;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Format and output a log entry
+     */
+    private log;
+    /**
+     * Output as JSON (structured logging)
+     */
+    private outputJson;
+    /**
+     * Output as human-readable (colored CLI)
+     */
+    private outputHuman;
+    /**
+     * Clip long multi-line content for readable logs.
+     */
+    private clipText;
+    debug(message: string, context?: LogContext, data?: unknown): void;
+    info(message: string, context?: LogContext, data?: unknown): void;
+    warn(message: string, context?: LogContext, data?: unknown): void;
+    error(message: string, context?: LogContext, data?: unknown): void;
+    /**
+     * Log skill activation details.
+     */
+    skillLoaded(skillName: string, agent: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Log a tool output
+     */
+    toolOutput(toolName: string, agent: string, output: string): void;
+    /**
+     * Log initial prompt/input sent to an agent.
+     */
+    agentInput(agent: string, content: string): void;
+    /**
+     * Log agent message
+     */
+    agentMessage(agent: string, content: string): void;
+    /**
+     * Log start of agent review
+     */
+    agentStart(agent: string): void;
+    /**
+     * Log end of agent review
+     */
+    agentComplete(agent: string, issueCount: number): void;
+    /**
+     * Log missing skill call warning
+     */
+    noSkillCalls(agent: string): void;
+}
+declare let defaultLogger: Logger;
+/**
+ * Configure the default logger
+ */
+export declare function configureLogger(options: Partial<LoggerOptions>): void;
+/**
+ * Get the default logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Create a new logger with specific options
+ */
+export declare function createLogger(options?: Partial<LoggerOptions>): Logger;
+export { Logger };
+export default defaultLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

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