@oddessentials/odd-ai-reviewers 1.0.0

package/dist/cli/commands/local-review.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Local Review Command Module
+ *
+ * Orchestrates the local review flow:
+ * 1. Infer git context from path argument
+ * 2. Load configuration (with zero-config fallback)
+ * 3. Generate diff for local changes
+ * 4. Execute agent passes
+ * 5. Report findings to terminal
+ *
+ * This module is designed for dependency injection to enable testing.
+ *
+ * @module cli/commands/local-review
+ */
+import type { Config, Pass } from '../../config.js';
+import type { DiffSummary, PathFilter } from '../../diff.js';
+import type { GitContext, GitContextError } from '../git-context.js';
+import type { Result } from '../../types/result.js';
+import type { GenerateZeroConfigResult } from '../../config/zero-config.js';
+import type { ValidatedConfig } from '../../types/branded.js';
+import type { DependencyCheckSummary } from '../dependencies/types.js';
+import { parseLocalReviewOptions } from '../options/index.js';
+import { executeAllPasses } from '../../phases/execute.js';
+import { reportToTerminal } from '../../report/terminal.js';
+/**
+ * Dependencies for local review command
+ * All external dependencies are injected for testability
+ */
+export interface LocalReviewDependencies {
+    /** Environment variables */
+    env: Record<string, string | undefined>;
+    /** Exit handler (allows testing without process.exit) */
+    exitHandler: (code: number) => void;
+    /** Standard output writer */
+    stdout: {
+        write: (text: string) => void;
+        isTTY?: boolean;
+    };
+    /** Standard error writer */
+    stderr: {
+        write: (text: string) => void;
+    };
+    /** Override for git context inference (for testing) */
+    inferGitContext?: (cwd: string) => Result<GitContext, GitContextError>;
+    /** Override for config loading (for testing) */
+    loadConfig?: (repoRoot: string) => Promise<ValidatedConfig<Config>>;
+    /** Override for config loading from explicit path (for testing) */
+    loadConfigFromPath?: (configPath: string) => Promise<ValidatedConfig<Config>>;
+    /** Override for zero-config generation (for testing) */
+    generateZeroConfig?: (env: Record<string, string | undefined>) => GenerateZeroConfigResult;
+    /** Override for diff generation (for testing) */
+    getLocalDiff?: (repoPath: string, options: {
+        baseRef: string;
+        headRef?: string;
+        rangeOperator?: '..' | '...';
+        stagedOnly?: boolean;
+        uncommitted?: boolean;
+        pathFilter?: PathFilter;
+    }) => DiffSummary;
+    /** Override for agent execution (for testing) */
+    executeAllPasses?: typeof executeAllPasses;
+    /** Override for terminal reporting (for testing) */
+    reportToTerminal?: typeof reportToTerminal;
+    /** Override for dependency checking (for testing) */
+    checkDependenciesForPasses?: (passes: Pass[]) => DependencyCheckSummary;
+}
+/**
+ * Result from local review execution
+ */
+export interface LocalReviewResult {
+    /** Exit code (0=success, 1=failures or execution errors, 2=invalid args/config) */
+    exitCode: number;
+    /** Number of findings reported */
+    findingsCount: number;
+    /** Number of partial findings (from interrupted agents) */
+    partialFindingsCount: number;
+    /** Error message if execution failed */
+    error?: string;
+    /** Whether execution was interrupted */
+    interrupted?: boolean;
+}
+/**
+ * Dry run result
+ */
+export interface DryRunResult {
+    /** Git context information */
+    gitContext: GitContext;
+    /** Resolved base reference used for diff */
+    baseRef: string;
+    /** Config source (file or zero-config) */
+    configSource: 'file' | 'zero-config';
+    /** Config file path if from file */
+    configPath?: string;
+    /** Number of files that would be analyzed */
+    fileCount: number;
+    /** Total lines changed */
+    linesChanged: number;
+    /** List of files that would be analyzed */
+    files: string[];
+    /** Agents that would run */
+    agents: string[];
+}
+/**
+ * Cost estimate result
+ */
+export interface CostEstimateResult {
+    /** Estimated cost in USD */
+    estimatedCostUsd: number;
+    /** Estimated input tokens */
+    estimatedInputTokens: number;
+    /** Number of files */
+    fileCount: number;
+    /** Total lines changed */
+    linesChanged: number;
+    /** Whether budget allows execution */
+    budgetAllowed: boolean;
+}
+/**
+ * Create default dependencies using real implementations
+ */
+export declare function createDefaultDependencies(): LocalReviewDependencies;
+/**
+ * Exit codes per contracts/cli-interface.md
+ */
+export declare const ExitCode: {
+    /** Success (no findings, or findings below gating threshold) */
+    readonly SUCCESS: 0;
+    /** Failure (findings exceed gating threshold, or execution error) */
+    readonly FAILURE: 1;
+    /** Invalid arguments or configuration */
+    readonly INVALID_ARGS: 2;
+};
+/**
+ * Run local review command
+ *
+ * This is the main orchestration function that:
+ * 1. Parses and validates options
+ * 2. Infers git context
+ * 3. Loads configuration (with zero-config fallback)
+ * 4. Generates diff
+ * 5. Executes agent passes
+ * 6. Reports findings to terminal
+ *
+ * @param rawOptions - Raw CLI options from Commander
+ * @param deps - Injected dependencies (defaults to real implementations)
+ * @returns Result with exit code and finding counts
+ */
+export declare function runLocalReview(rawOptions: Parameters<typeof parseLocalReviewOptions>[0], deps?: LocalReviewDependencies): Promise<LocalReviewResult>;
+//# sourceMappingURL=local-review.d.ts.map

package/dist/cli/commands/local-review.d.ts.map

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