minovative-mind-cli 2.11.4 → 2.12.0

package/dist/services/swebench/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * SWE-bench Evaluation Types and Interfaces
+ *
+ * Defines data contracts for SWE-bench Lite instances, predictions,
+ * configuration options, execution progress, and evaluation results.
+ */
+export interface SWEBenchInstance {
+    instance_id: string;
+    repo: string;
+    base_commit: string;
+    problem_statement: string;
+    hints_text?: string;
+    created_at?: string;
+    test_patch?: string;
+    version?: string;
+    environment_setup_commit?: string;
+    FAIL_TO_PASS?: string[] | string;
+    PASS_TO_PASS?: string[] | string;
+    [key: string]: unknown;
+}
+export interface SWEBenchPrediction {
+    instance_id: string;
+    model_patch: string;
+    model_name_or_path: string;
+}
+export interface SWEBenchProgress {
+    completed: number;
+    total: number;
+    currentInstanceId: string;
+    status: 'running' | 'success' | 'error' | 'skipped';
+    elapsedMs: number;
+    error?: string;
+}
+export interface SWEBenchInstanceTokens {
+    inputTokens: number;
+    outputTokens: number;
+    cachedTokens: number;
+    totalTokens: number;
+}
+export interface SWEBenchRepoMetrics {
+    total: number;
+    succeeded: number;
+    failed: number;
+    passRatePercent: number;
+    averageDurationMs: number;
+}
+export interface SWEBenchInstanceRecoveryMetrics {
+    circuitBreakerTrips: number;
+    prunedLines: number;
+    prunedChars: number;
+}
+export interface SWEBenchEvaluationRecoveryMetrics {
+    totalCircuitBreakerTrips: number;
+    totalPrunedLines: number;
+    totalPrunedChars: number;
+}
+export interface SWEBenchEvaluationMetrics {
+    totalTokens: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCachedTokens: number;
+    cacheHitRatePercent: number;
+    averageDurationMs: number;
+    minDurationMs: number;
+    maxDurationMs: number;
+    totalDiffCharacters: number;
+    averageDiffCharacters: number;
+    recoveryMetrics?: SWEBenchEvaluationRecoveryMetrics;
+    repoBreakdown: Record<string, SWEBenchRepoMetrics>;
+    environment: {
+        platform: string;
+        architecture: string;
+        nodeVersion: string;
+        modelName: string;
+        timestamp: string;
+    };
+}
+export interface SWEBenchInstanceResult {
+    instance_id: string;
+    repo: string;
+    base_commit: string;
+    prediction: SWEBenchPrediction;
+    success: boolean;
+    executionTimeMs: number;
+    diffSizeChars: number;
+    turnCount?: number;
+    tokens?: SWEBenchInstanceTokens;
+    recoveryMetrics?: SWEBenchInstanceRecoveryMetrics;
+    error?: string;
+    logs?: string[];
+}
+export interface SWEBenchEvaluationSummary {
+    total: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    durationMs: number;
+    predictionsFilePath?: string;
+    reportFilePath?: string;
+    metrics?: SWEBenchEvaluationMetrics;
+    results: SWEBenchInstanceResult[];
+}
+export interface InstanceFilterOptions {
+    instanceIds?: string[];
+    repo?: string;
+    limit?: number;
+    offset?: number;
+    shuffle?: boolean;
+    seed?: number;
+}
+export interface AgentExecutorResult {
+    tokens?: SWEBenchInstanceTokens;
+    recoveryMetrics?: SWEBenchInstanceRecoveryMetrics;
+}
+export interface AgentExecutorParams {
+    instance: SWEBenchInstance;
+    workspaceDir: string;
+    prompt: string;
+    abortSignal?: AbortSignal;
+    onLog?: (message: string) => void;
+}
+export interface RunInstanceOptions {
+    workspaceDir?: string;
+    modelName?: string;
+    maxTurns?: number;
+    timeoutMs?: number;
+    resetWorkspace?: boolean;
+    autoCommitUntracked?: boolean;
+    autoCloneRepos?: boolean;
+    dryRun?: boolean;
+    verbose?: boolean;
+    customSystemPrompt?: string;
+    agentExecutor?: (params: AgentExecutorParams) => Promise<void | AgentExecutorResult>;
+    onLog?: (message: string) => void;
+    abortSignal?: AbortSignal;
+}
+export interface SWEBenchEvaluationOptions {
+    instances?: SWEBenchInstance[];
+    instancesPath?: string;
+    instanceIds?: string[];
+    repo?: string;
+    limit?: number;
+    offset?: number;
+    shuffle?: boolean;
+    seed?: number;
+    workspacesBaseDir?: string;
+    workspaceDirMap?: Record<string, string>;
+    outputPredictionsPath?: string;
+    reportPath?: string;
+    modelName?: string;
+    maxTurns?: number;
+    timeoutMsPerInstance?: number;
+    concurrency?: number;
+    resetWorkspaceBeforeRun?: boolean;
+    autoCloneRepos?: boolean;
+    dryRun?: boolean;
+    verbose?: boolean;
+    agentExecutor?: (params: AgentExecutorParams) => Promise<void | AgentExecutorResult>;
+    onProgress?: (progress: SWEBenchProgress) => void;
+    onInstanceComplete?: (result: SWEBenchInstanceResult) => void;
+    logger?: {
+        info?: (msg: string) => void;
+        warn?: (msg: string) => void;
+        error?: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+}

package/dist/services/swebench/types.js

@@ -0,0 +1,7 @@
+/**
+ * SWE-bench Evaluation Types and Interfaces
+ *
+ * Defines data contracts for SWE-bench Lite instances, predictions,
+ * configuration options, execution progress, and evaluation results.
+ */
+export {};

package/dist/services/verificationService.js

@@ -236,6 +236,9 @@ Please fix these errors using the modify_file tool.`;
 }
 import { auditFilePerformance, formatAuditForModel, formatAuditForTerminal, isAuditableFile, } from '../utils/performanceAuditor.js';
 export async function verifyChangedFiles(workspaceRoot, filePaths, abortSignal) {
+    if (process.env.MMCLI_SKIP_VERIFICATION === 'true' || process.env.SKIP_VERIFICATION === '1') {
+        return { errors: null, warnings: null };
+    }
     const errors = [];
     const perfAudits = [];
     // Determine the effective verification root

package/dist/services/workspaceRegistry.d.ts

@@ -24,15 +24,27 @@ export interface Profile {
  * Result of resolving an `@alias/relative/path` string against the workspace registry.
  */
 export interface ResolvedWorkspacePath {
-    /** The alias that was matched (e.g., "backend"). */
-    alias: string;
-    /** The absolute root directory of the matched registered workspace. */
+    /** The alias that was matched (e.g., "backend"), or null for primary workspace. */
+    alias: string | null;
+    /** The absolute root directory of the matched registered workspace or primary workspace. */
     workspaceRoot: string;
     /** The relative path within that workspace (e.g., "src/routes.ts"). */
     relativePath: string;
     /** The fully resolved absolute path to the target file or directory. */
     absolutePath: string;
+    /** Whether the path was resolved via primary sub-path auto-focusing. */
+    isAutoFocused?: boolean;
 }
+/**
+ * Returns the global configuration directory for Minovative Mind CLI.
+ * During automated tests, returns an isolated temporary directory to prevent test runs
+ * from modifying the developer's live workspace configurations.
+ */
+export declare function getGlobalConfigDir(): string;
+/**
+ * Returns the active path to the workspace registry JSON file.
+ */
+export declare function getRegistryFile(): string;
 /**
  * Service that manages a global registry of external workspace roots.
  *
@@ -54,11 +66,16 @@ declare class WorkspaceRegistry {
     private profiles;
     /** Whether the registry has been loaded from disk. */
     private initialized;
+    private primarySubPath;
     /**
      * Initializes the registry by loading persisted workspace entries from disk.
      * Safe to call multiple times — subsequent calls are no-ops.
      */
     init(): void;
+    /**
+     * Internal guard to guarantee the registry is loaded before any read or write operation.
+     */
+    private ensureInitialized;
     /**
      * Registers a new external workspace root with the given alias under a profile.
      *
@@ -124,15 +141,71 @@ declare class WorkspaceRegistry {
         root: string;
     }>;
     /**
-     * Resolves an `@alias/relative/path` string into its constituent parts.
+     * Sets the active primary sub-path for auto-focusing relative file queries.
+     *
+     * @param subPath - The relative directory path within the primary workspace (e.g., "src/services"), or null to clear.
+     */
+    setPrimarySubPath(subPath: string | null): void;
+    /**
+     * Returns the currently active primary sub-path, or null if none is set.
+     */
+    getPrimarySubPath(): string | null;
+    /**
+     * Returns whether a primary sub-path is currently active.
+     */
+    hasPrimarySubPath(): boolean;
+    /**
+     * Clears the active primary sub-path.
+     */
+    clearPrimarySubPath(): void;
+    /**
+     * Gets the focused root directory for the given primary workspace root.
+     * If a primary sub-path is active, returns the resolved sub-path directory;
+     * otherwise returns the primary root.
+     *
+     * @param primaryRoot - The base primary workspace root directory.
+     */
+    getFocusedRoot(primaryRoot: string): string;
+    /**
+     * Checks whether a target path is securely contained within a given boundary root.
+     *
+     * @param targetPath - The absolute or relative target path.
+     * @param boundaryRoot - The boundary root directory.
+     */
+    isPathWithinBoundary(targetPath: string, boundaryRoot: string): boolean;
+    /**
+     * Finds a registered workspace that contains the given file or directory path.
+     *
+     * @param targetPath - The file or directory path to check.
+     * @returns The matching `RegisteredWorkspace` or null if not found.
+     */
+    findWorkspaceForPath(targetPath: string): RegisteredWorkspace | null;
+    /**
+     * Checks whether a path resides inside the primary workspace or any registered workspace.
+     *
+     * @param targetPath - The file or directory path to inspect.
+     * @param primaryRoot - Optional primary workspace root.
+     */
+    isInsideRegisteredWorkspace(targetPath: string, primaryRoot?: string): boolean;
+    /**
+     * Resolves an `@alias/relative/path` string or primary workspace path into constituent parts.
      *
      * @param filePath - A file path that may or may not start with `@alias/`.
-     * @returns A `ResolvedWorkspacePath` if the path has a valid `@alias/` prefix
-     *   and the alias is registered, or `null` if the path is a standard
-     *   workspace-relative path (no `@` prefix or unrecognized alias).
+     * @param options - Optional resolution options including primaryRoot and autoFocusSubPath.
+     * @returns A `ResolvedWorkspacePath` if resolved, or `null` if the path cannot be resolved.
      * @throws Error if the path has an `@` prefix but the alias is not registered.
      */
-    resolve(filePath: string): ResolvedWorkspacePath | null;
+    resolve(filePath: string, options?: {
+        primaryRoot?: string;
+        autoFocusSubPath?: boolean;
+    }): ResolvedWorkspacePath | null;
+    /**
+     * Resolves a relative path against the primary root with automatic sub-path focusing.
+     *
+     * @param primaryRoot - The base primary workspace root directory.
+     * @param relativePath - The target relative path to resolve.
+     */
+    resolveWithAutoFocus(primaryRoot: string, relativePath: string): ResolvedWorkspacePath;
     /**
      * Checks if a given file path uses the `@alias/` prefix syntax.
      *