@oddessentials/odd-ai-reviewers 1.0.0

package/dist/cli/dependencies/schemas.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for runtime validation of dependency check results.
+ * @module cli/dependencies/schemas
+ */
+import { z } from 'zod';
+/**
+ * Schema for supported platforms.
+ */
+export declare const PlatformSchema: z.ZodEnum<{
+    darwin: "darwin";
+    linux: "linux";
+    win32: "win32";
+}>;
+/**
+ * Schema for dependency check status.
+ */
+export declare const DependencyStatusSchema: z.ZodEnum<{
+    available: "available";
+    missing: "missing";
+    unhealthy: "unhealthy";
+    "version-mismatch": "version-mismatch";
+}>;
+/**
+ * Schema for a single dependency check result.
+ */
+export declare const DependencyCheckResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        available: "available";
+        missing: "missing";
+        unhealthy: "unhealthy";
+        "version-mismatch": "version-mismatch";
+    }>;
+    version: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for aggregated dependency check summary.
+ */
+export declare const DependencyCheckSummarySchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            available: "available";
+            missing: "missing";
+            unhealthy: "unhealthy";
+            "version-mismatch": "version-mismatch";
+        }>;
+        version: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    missingRequired: z.ZodArray<z.ZodString>;
+    missingOptional: z.ZodArray<z.ZodString>;
+    unhealthy: z.ZodArray<z.ZodString>;
+    versionWarnings: z.ZodArray<z.ZodString>;
+    hasBlockingIssues: z.ZodBoolean;
+    hasWarnings: z.ZodBoolean;
+    runnablePasses: z.ZodArray<z.ZodString>;
+    skippedPasses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PlatformFromSchema = z.infer<typeof PlatformSchema>;
+export type DependencyStatusFromSchema = z.infer<typeof DependencyStatusSchema>;
+export type DependencyCheckResultFromSchema = z.infer<typeof DependencyCheckResultSchema>;
+export type DependencyCheckSummaryFromSchema = z.infer<typeof DependencyCheckSummarySchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/cli/dependencies/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/cli/dependencies/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAAuC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;EAKjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;iBAUvC,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAChE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAChF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/cli/dependencies/schemas.js

@@ -0,0 +1,42 @@
+/**
+ * Zod schemas for runtime validation of dependency check results.
+ * @module cli/dependencies/schemas
+ */
+import { z } from 'zod';
+/**
+ * Schema for supported platforms.
+ */
+export const PlatformSchema = z.enum(['darwin', 'win32', 'linux']);
+/**
+ * Schema for dependency check status.
+ */
+export const DependencyStatusSchema = z.enum([
+    'available',
+    'missing',
+    'unhealthy',
+    'version-mismatch',
+]);
+/**
+ * Schema for a single dependency check result.
+ */
+export const DependencyCheckResultSchema = z.object({
+    name: z.string(),
+    status: DependencyStatusSchema,
+    version: z.string().nullable(),
+    error: z.string().nullable(),
+});
+/**
+ * Schema for aggregated dependency check summary.
+ */
+export const DependencyCheckSummarySchema = z.object({
+    results: z.array(DependencyCheckResultSchema),
+    missingRequired: z.array(z.string()),
+    missingOptional: z.array(z.string()),
+    unhealthy: z.array(z.string()),
+    versionWarnings: z.array(z.string()),
+    hasBlockingIssues: z.boolean(),
+    hasWarnings: z.boolean(),
+    runnablePasses: z.array(z.string()),
+    skippedPasses: z.array(z.string()),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/cli/dependencies/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/cli/dependencies/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,WAAW;IACX,SAAS;IACT,WAAW;IACX,kBAAkB;CACnB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;IAC7C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACxB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC"}

package/dist/cli/dependencies/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * TypeScript types and interfaces for CLI dependency detection.
+ * @module cli/dependencies/types
+ */
+/**
+ * Supported platforms for dependency detection.
+ */
+export type Platform = 'darwin' | 'win32' | 'linux';
+/**
+ * Status of a dependency check.
+ * - available: Tool works, version verified
+ * - missing: ENOENT - binary not found in PATH
+ * - unhealthy: Binary exists but --version failed or returned unparseable output
+ * - version-mismatch: Below minimum required version
+ */
+export type DependencyStatus = 'available' | 'missing' | 'unhealthy' | 'version-mismatch';
+/**
+ * Per-platform installation command mapping.
+ */
+export interface PlatformInstructions {
+    darwin: string;
+    win32: string;
+    linux: string;
+}
+/**
+ * Centralized catalog entry for a required external tool.
+ */
+export interface ExternalDependency {
+    /** Tool identifier (e.g., 'semgrep') */
+    name: string;
+    /** Human-readable name for error messages */
+    displayName: string;
+    /** Binary and args for version check (e.g., ['semgrep', ['--version']]) */
+    versionCommand: [string, string[]];
+    /** Pattern to extract version from output */
+    versionRegex: RegExp;
+    /** Minimum required version (semver), null if no minimum */
+    minVersion: string | null;
+    /** Official documentation URL */
+    docsUrl: string;
+    /** Per-platform install commands */
+    installInstructions: PlatformInstructions;
+}
+/**
+ * Result of checking a single dependency.
+ */
+export interface DependencyCheckResult {
+    /** Dependency name */
+    name: string;
+    /** Check result status */
+    status: DependencyStatus;
+    /** Detected version (null if missing/unparseable) */
+    version: string | null;
+    /** Error message (for unhealthy/missing states) */
+    error: string | null;
+}
+/**
+ * Aggregated result of checking all dependencies for a run.
+ */
+export interface DependencyCheckSummary {
+    /** Individual check results */
+    results: DependencyCheckResult[];
+    /** Dependencies missing for required passes */
+    missingRequired: string[];
+    /** Dependencies missing for optional passes */
+    missingOptional: string[];
+    /** Dependencies in unhealthy state */
+    unhealthy: string[];
+    /** Dependencies below recommended version */
+    versionWarnings: string[];
+    /** True if any required dependency unavailable */
+    hasBlockingIssues: boolean;
+    /** True if any non-blocking issues exist */
+    hasWarnings: boolean;
+    /** Names of passes that can run (all deps available) */
+    runnablePasses: string[];
+    /** Names of passes skipped due to missing/unhealthy deps */
+    skippedPasses: string[];
+}
+/**
+ * Information about a skipped pass and why it was skipped.
+ */
+export interface SkippedPassInfo {
+    /** Pass name */
+    name: string;
+    /** The missing dependency that caused the skip */
+    missingDep: string;
+    /** Reason for skip: missing or unhealthy */
+    reason: 'missing' | 'unhealthy';
+}
+/**
+ * Information about a pass and its required dependencies.
+ */
+export interface PassDependencyInfo {
+    /** Pass name from config */
+    passName: string;
+    /** Whether pass is marked as required */
+    required: boolean;
+    /** Agent IDs used by this pass */
+    agents: string[];
+    /** External tools needed (derived from agents) */
+    dependencies: string[];
+}
+/**
+ * Registry of all known external dependencies.
+ */
+export type DependencyCatalog = Record<string, ExternalDependency>;
+/**
+ * Mapping from agent IDs to their required external tools.
+ */
+export type AgentDependencyMap = Record<string, string[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/dependencies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/dependencies/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,mBAAmB,EAAE,oBAAoB,CAAC;CAC3C;AAID;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kDAAkD;IAClD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACjC;AAID;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC"}

package/dist/cli/dependencies/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript types and interfaces for CLI dependency detection.
+ * @module cli/dependencies/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/dependencies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/dependencies/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/cli/dependencies/version.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Version parsing and comparison utilities for dependency checking.
+ * @module cli/dependencies/version
+ */
+/**
+ * Parsed semantic version components.
+ */
+export interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    raw: string;
+}
+/**
+ * Parses a version string from command output.
+ *
+ * @param output - Raw output from --version command
+ * @param regex - Optional custom regex to extract version (must have capture groups for major.minor.patch or single group for full version)
+ * @returns Parsed version or null if parsing failed
+ *
+ * @example
+ * ```ts
+ * parseVersion('semgrep 1.56.0'); // { major: 1, minor: 56, patch: 0, raw: '1.56.0' }
+ * parseVersion('reviewdog version: 0.17.4'); // { major: 0, minor: 17, patch: 4, raw: '0.17.4' }
+ * parseVersion('invalid output'); // null
+ * ```
+ */
+export declare function parseVersion(output: string, regex?: RegExp): ParsedVersion | null;
+/**
+ * Compares two parsed versions.
+ *
+ * @param a - First version
+ * @param b - Second version
+ * @returns -1 if a < b, 0 if a == b, 1 if a > b
+ *
+ * @example
+ * ```ts
+ * compareVersions(v1_0_0, v1_0_1); // -1
+ * compareVersions(v1_0_0, v1_0_0); // 0
+ * compareVersions(v2_0_0, v1_9_9); // 1
+ * ```
+ */
+export declare function compareVersions(a: ParsedVersion, b: ParsedVersion): -1 | 0 | 1;
+/**
+ * Checks if an installed version meets the minimum required version.
+ *
+ * @param installed - The installed version
+ * @param minimum - The minimum required version string (e.g., "1.0.0")
+ * @returns true if installed >= minimum, false otherwise
+ *
+ * @example
+ * ```ts
+ * meetsMinimum({ major: 1, minor: 5, patch: 0, raw: '1.5.0' }, '1.0.0'); // true
+ * meetsMinimum({ major: 0, minor: 9, patch: 0, raw: '0.9.0' }, '1.0.0'); // false
+ * ```
+ */
+export declare function meetsMinimum(installed: ParsedVersion, minimum: string): boolean;
+/**
+ * Extracts version string from command output using a regex.
+ * Convenience function that returns just the raw version string.
+ *
+ * @param output - Raw output from --version command
+ * @param regex - Optional custom regex
+ * @returns Version string or null if parsing failed
+ */
+export declare function extractVersionString(output: string, regex?: RegExp): string | null;
+//# sourceMappingURL=version.d.ts.map

package/dist/cli/dependencies/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/dependencies/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkDjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAW9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS/E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlF"}

package/dist/cli/dependencies/version.js

@@ -0,0 +1,125 @@
+/**
+ * Version parsing and comparison utilities for dependency checking.
+ * @module cli/dependencies/version
+ */
+/**
+ * Default regex pattern to extract semver from version output.
+ * Matches patterns like "1.2.3", "v1.2.3", embedded in any text.
+ */
+const DEFAULT_VERSION_REGEX = /(\d+)\.(\d+)\.(\d+)/;
+/**
+ * Parses a version string from command output.
+ *
+ * @param output - Raw output from --version command
+ * @param regex - Optional custom regex to extract version (must have capture groups for major.minor.patch or single group for full version)
+ * @returns Parsed version or null if parsing failed
+ *
+ * @example
+ * ```ts
+ * parseVersion('semgrep 1.56.0'); // { major: 1, minor: 56, patch: 0, raw: '1.56.0' }
+ * parseVersion('reviewdog version: 0.17.4'); // { major: 0, minor: 17, patch: 4, raw: '0.17.4' }
+ * parseVersion('invalid output'); // null
+ * ```
+ */
+export function parseVersion(output, regex) {
+    const pattern = regex ?? DEFAULT_VERSION_REGEX;
+    const match = output.match(pattern);
+    if (!match) {
+        return null;
+    }
+    // If regex has 3+ capture groups, use them as major/minor/patch
+    if (match.length >= 4 && match[1] && match[2] && match[3]) {
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        const patch = parseInt(match[3], 10);
+        if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+            return null;
+        }
+        return {
+            major,
+            minor,
+            patch,
+            raw: `${major}.${minor}.${patch}`,
+        };
+    }
+    // If regex has single capture group, try to parse it as semver
+    if (match.length >= 2 && match[1]) {
+        const versionStr = match[1];
+        const parts = versionStr.split('.');
+        if (parts.length >= 3 && parts[0] && parts[1] && parts[2]) {
+            const major = parseInt(parts[0], 10);
+            const minor = parseInt(parts[1], 10);
+            const patch = parseInt(parts[2], 10);
+            if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+                return null;
+            }
+            return {
+                major,
+                minor,
+                patch,
+                raw: `${major}.${minor}.${patch}`,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Compares two parsed versions.
+ *
+ * @param a - First version
+ * @param b - Second version
+ * @returns -1 if a < b, 0 if a == b, 1 if a > b
+ *
+ * @example
+ * ```ts
+ * compareVersions(v1_0_0, v1_0_1); // -1
+ * compareVersions(v1_0_0, v1_0_0); // 0
+ * compareVersions(v2_0_0, v1_9_9); // 1
+ * ```
+ */
+export function compareVersions(a, b) {
+    if (a.major !== b.major) {
+        return a.major > b.major ? 1 : -1;
+    }
+    if (a.minor !== b.minor) {
+        return a.minor > b.minor ? 1 : -1;
+    }
+    if (a.patch !== b.patch) {
+        return a.patch > b.patch ? 1 : -1;
+    }
+    return 0;
+}
+/**
+ * Checks if an installed version meets the minimum required version.
+ *
+ * @param installed - The installed version
+ * @param minimum - The minimum required version string (e.g., "1.0.0")
+ * @returns true if installed >= minimum, false otherwise
+ *
+ * @example
+ * ```ts
+ * meetsMinimum({ major: 1, minor: 5, patch: 0, raw: '1.5.0' }, '1.0.0'); // true
+ * meetsMinimum({ major: 0, minor: 9, patch: 0, raw: '0.9.0' }, '1.0.0'); // false
+ * ```
+ */
+export function meetsMinimum(installed, minimum) {
+    const minVersion = parseVersion(minimum);
+    if (!minVersion) {
+        // If we can't parse the minimum, assume it's met (fail open)
+        return true;
+    }
+    return compareVersions(installed, minVersion) >= 0;
+}
+/**
+ * Extracts version string from command output using a regex.
+ * Convenience function that returns just the raw version string.
+ *
+ * @param output - Raw output from --version command
+ * @param regex - Optional custom regex
+ * @returns Version string or null if parsing failed
+ */
+export function extractVersionString(output, regex) {
+    const parsed = parseVersion(output, regex);
+    return parsed?.raw ?? null;
+}
+//# sourceMappingURL=version.js.map

package/dist/cli/dependencies/version.js.map

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

package/dist/cli/git-context.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Git Context Module
+ *
+ * Provides git repository detection and context inference for local review mode.
+ * Uses the path argument as working directory for all operations, enabling
+ * `ai-review /some/other/repo` from any directory.
+ *
+ * Security: All inputs validated via existing assertSafePath/assertSafeGitRef.
+ * All git commands use execFileSync with shell: false.
+ */
+import { type Result } from '../types/result.js';
+/**
+ * Normalize a path to use forward slashes.
+ *
+ * This is critical for Windows compatibility. The path validators reject
+ * backslashes as potential shell metacharacters, but Windows paths naturally
+ * use backslashes. Forward slashes work on all platforms including Windows.
+ *
+ * @param p - Path to normalize
+ * @returns Path with all backslashes converted to forward slashes
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Git context for local review operations
+ */
+export interface GitContext {
+    /** Absolute path to repository root (contains .git) */
+    repoRoot: string;
+    /** Current branch name (or 'HEAD' if detached) */
+    currentBranch: string;
+    /** Detected default branch (main/master/develop) */
+    defaultBase: string;
+    /** Whether working tree has uncommitted changes */
+    hasUncommitted: boolean;
+    /** Whether index has staged changes */
+    hasStaged: boolean;
+}
+/**
+ * Error codes for git context operations
+ * Values match the contract in contracts/git-context.md
+ */
+export declare const GitContextErrorCode: {
+    readonly NOT_GIT_REPO: "NOT_GIT_REPO";
+    readonly GIT_NOT_FOUND: "GIT_NOT_FOUND";
+    readonly INVALID_PATH: "INVALID_PATH";
+};
+export type GitContextErrorCode = (typeof GitContextErrorCode)[keyof typeof GitContextErrorCode];
+/**
+ * Error type for git context operations
+ */
+export interface GitContextError {
+    code: GitContextErrorCode;
+    message: string;
+    path?: string;
+}
+/**
+ * Find the root directory of a git repository by walking up the directory tree.
+ *
+ * @param cwd - Starting directory (must be absolute path)
+ * @returns Result with absolute path to repo root or error
+ */
+export declare function findGitRoot(cwd: string): Result<string, GitContextError>;
+/**
+ * Get the current branch name.
+ *
+ * @param repoPath - Path to repository root
+ * @returns Branch name or 'HEAD' if detached
+ */
+export declare function getCurrentBranch(repoPath: string): string;
+/**
+ * Detect the default/base branch for the repository.
+ *
+ * Priority order:
+ * 1. origin/HEAD target (e.g., "origin/main")
+ * 2. Local or remote 'main' branch
+ * 3. Local or remote 'master' branch
+ * 4. Local or remote 'develop' branch
+ * 5. First available branch
+ *
+ * @param repoPath - Path to repository root
+ * @returns Branch name (always returns something)
+ */
+export declare function detectDefaultBranch(repoPath: string): string;
+/**
+ * Check if the working tree has uncommitted changes.
+ *
+ * @param repoPath - Path to repository root
+ * @returns true if there are uncommitted changes (staged or unstaged)
+ */
+export declare function hasUncommittedChanges(repoPath: string): boolean;
+/**
+ * Check if the index has staged changes.
+ *
+ * @param repoPath - Path to repository root
+ * @returns true if there are staged changes
+ */
+export declare function hasStagedChanges(repoPath: string): boolean;
+/**
+ * Infer complete git context for local review.
+ *
+ * @param cwd - Starting directory (path argument from CLI)
+ * @returns Result with GitContext or error
+ */
+export declare function inferGitContext(cwd: string): Result<GitContext, GitContextError>;
+//# sourceMappingURL=git-context.d.ts.map

package/dist/cli/git-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../src/cli/git-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,oBAAoB,CAAC;AAM1D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAwCD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CA0DxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAczD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwE5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc/D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAmChF"}