vimonkey 0.2.0 → 0.2.2

package/dist/plugin.d.ts

@@ -1,74 +0,0 @@
-/**
- * @todo Planned vitest plugin — stub only. Implement config injection and
- *       custom CLI mode interception (vitest fuzz, vitest ai, vitest doc).
- *
- * Vitest plugin for vimonkey
- *
- * @example
- * ```typescript
- * // vitest.config.ts
- * import { defineConfig } from 'vitest/config'
- * import { viMonkey } from 'vimonkey/plugin'
- *
- * export default defineConfig({
- *   plugins: [
- *     viMonkey({
- *       fuzz: { iterations: 100 },
- *       ai: { model: 'claude-sonnet' },
- *       doc: { pattern: '**\/*.test.md' },
- *     })
- *   ]
- * })
- * ```
- */
-/** Minimal Vite plugin interface — avoids requiring vite as a dependency */
-interface Plugin {
-    name: string;
-    config?(): void;
-    configureServer?(server: unknown): void;
-}
-export interface ViMonkeyFuzzOptions {
-    /** Number of actions per test run (default: 100) */
-    iterations?: number;
-    /** Seed source: 'env' reads FUZZ_SEED, 'random' generates new (default: 'env') */
-    seed?: "env" | "random";
-    /** Stop after first failure (default: true) */
-    failFast?: boolean;
-    /** Shrinking settings */
-    shrink?: {
-        enabled?: boolean;
-        maxAttempts?: number;
-    };
-}
-export interface ViMonkeyAiOptions {
-    /** Model identifier (Vercel AI SDK format) */
-    model?: string;
-    /** Temperature for LLM (0 = deterministic) */
-    temperature?: number;
-    /** Maximum actions per exploration */
-    maxSteps?: number;
-    /** Token budget per file */
-    maxTokens?: number;
-    /** Directory to save discovered tests */
-    saveDir?: string;
-    /** Use Claude Code provider */
-    provider?: "openai" | "anthropic" | "claude-code";
-}
-export interface ViMonkeyDocOptions {
-    /** Glob pattern for mdtest files */
-    pattern?: string;
-}
-export interface ViMonkeyOptions {
-    /** Fuzz mode configuration */
-    fuzz?: ViMonkeyFuzzOptions;
-    /** AI mode configuration */
-    ai?: ViMonkeyAiOptions;
-    /** Doc mode configuration (mdtest) */
-    doc?: ViMonkeyDocOptions;
-}
-/**
- * Creates the vimonkey plugin for Vitest
- */
-export declare function viMonkey(options?: ViMonkeyOptions): Plugin;
-export default viMonkey;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,4EAA4E;AAC5E,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,IAAI,IAAI,CAAA;IACf,eAAe,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yBAAyB;IACzB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAA;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,4BAA4B;IAC5B,EAAE,CAAC,EAAE,iBAAiB,CAAA;IACtB,sCAAsC;IACtC,GAAG,CAAC,EAAE,kBAAkB,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAgB9D;AAED,eAAe,QAAQ,CAAA"}

package/dist/plugin.js

@@ -1,41 +0,0 @@
-/**
- * @todo Planned vitest plugin — stub only. Implement config injection and
- *       custom CLI mode interception (vitest fuzz, vitest ai, vitest doc).
- *
- * Vitest plugin for vimonkey
- *
- * @example
- * ```typescript
- * // vitest.config.ts
- * import { defineConfig } from 'vitest/config'
- * import { viMonkey } from 'vimonkey/plugin'
- *
- * export default defineConfig({
- *   plugins: [
- *     viMonkey({
- *       fuzz: { iterations: 100 },
- *       ai: { model: 'claude-sonnet' },
- *       doc: { pattern: '**\/*.test.md' },
- *     })
- *   ]
- * })
- * ```
- */
-/**
- * Creates the vimonkey plugin for Vitest
- */
-export function viMonkey(options = {}) {
-    const { fuzz = {}, ai = {}, doc = {} } = options;
-    return {
-        name: "vimonkey",
-        config() {
-            // Configure vitest for custom modes
-            // Returns void for now - will be populated as modes are implemented
-        },
-        configureServer(server) {
-            // Handle custom CLI modes: vitest fuzz, vitest ai, vitest doc
-            // Implementation will intercept vitest CLI commands
-        },
-    };
-}
-export default viMonkey;

package/dist/random.d.ts

@@ -1,66 +0,0 @@
-/**
- * Seeded random number generator
- *
- * Uses a Linear Congruential Generator (LCG) for reproducible random sequences.
- * Ported from km's chaos testing infrastructure.
- */
-export interface SeededRandom {
-    /** Get the current seed */
-    seed: number;
-    /** Generate a random integer in [min, max] inclusive */
-    int(min: number, max: number): number;
-    /** Generate a random float in [0, 1) */
-    float(): number;
-    /** Pick a random element from an array */
-    pick<T>(array: readonly T[]): T;
-    /** Pick a random element with weights */
-    weightedPick<T extends string>(items: readonly T[], weights: Partial<Record<T, number>>): T;
-    /** Shuffle an array (returns new array) */
-    shuffle<T>(array: readonly T[]): T[];
-    /** Generate a random array */
-    array<T>(length: number, generator: () => T): T[];
-    /** Generate a random boolean with given probability of true */
-    bool(probability?: number): boolean;
-    /** Fork the RNG (create independent stream) */
-    fork(): SeededRandom;
-}
-/**
- * Pick a random element from weighted tuples using a pre-generated random float.
- *
- * @param tuples - Array of [weight, value] pairs
- * @param rand - Random float in [0, 1)
- * @returns The selected value
- */
-export declare function weightedPickFromTuples<T>(tuples: readonly (readonly [number, T])[], rand: number): T;
-/**
- * Create a seeded random number generator
- *
- * @param seed - Initial seed (uses Date.now() if not provided)
- * @returns Seeded random number generator
- *
- * @example
- * ```typescript
- * const random = createSeededRandom(12345)
- *
- * // Same seed = same sequence
- * random.int(0, 100)  // always 47 with seed 12345
- * random.pick(['a', 'b', 'c'])  // always 'b' with seed 12345
- * ```
- */
-export declare function createSeededRandom(seed?: number): SeededRandom;
-/**
- * Parse seed from environment or generate random
- */
-export declare function parseSeed(source?: "env" | "random"): number;
-/**
- * Parse FUZZ_REPEATS from environment (default: 1)
- *
- * Controls how many times each test.fuzz() test runs with different seeds.
- * Use FUZZ_REPEATS=10000 for CI nightly runs.
- */
-export declare function parseRepeats(): number;
-/**
- * Derive N unique seeds from a base seed using LCG
- */
-export declare function deriveSeeds(baseSeed: number, count: number): number[];
-//# sourceMappingURL=random.d.ts.map

package/dist/random.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IAEZ,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IAErC,wCAAwC;IACxC,KAAK,IAAI,MAAM,CAAA;IAEf,0CAA0C;IAC1C,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAA;IAE/B,yCAAyC;IACzC,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;IAE3F,2CAA2C;IAC3C,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;IAEpC,8BAA8B;IAC9B,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;IAEjD,+DAA+D;IAC/D,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAEnC,+CAA+C;IAC/C,IAAI,IAAI,YAAY,CAAA;CACrB;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CASpG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAyD9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,KAAK,GAAG,QAAgB,GAAG,MAAM,CAYlE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAUrC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrE"}

package/dist/random.js

@@ -1,137 +0,0 @@
-/**
- * Seeded random number generator
- *
- * Uses a Linear Congruential Generator (LCG) for reproducible random sequences.
- * Ported from km's chaos testing infrastructure.
- */
-// Linear Congruential Generator constants (same as glibc's rand()).
-// Full period of 2^31. See Numerical Recipes §7.1 or Knuth TAOCP Vol 2 §3.2.1.
-const LCG_A = 1103515245; // multiplier
-const LCG_C = 12345; // increment
-const LCG_M = 2 ** 31; // modulus (2^31)
-/**
- * Pick a random element from weighted tuples using a pre-generated random float.
- *
- * @param tuples - Array of [weight, value] pairs
- * @param rand - Random float in [0, 1)
- * @returns The selected value
- */
-export function weightedPickFromTuples(tuples, rand) {
-    let total = 0;
-    for (const [w] of tuples)
-        total += w;
-    let r = rand * total;
-    for (const [weight, value] of tuples) {
-        r -= weight;
-        if (r <= 0)
-            return value;
-    }
-    return tuples[tuples.length - 1][1];
-}
-/**
- * Create a seeded random number generator
- *
- * @param seed - Initial seed (uses Date.now() if not provided)
- * @returns Seeded random number generator
- *
- * @example
- * ```typescript
- * const random = createSeededRandom(12345)
- *
- * // Same seed = same sequence
- * random.int(0, 100)  // always 47 with seed 12345
- * random.pick(['a', 'b', 'c'])  // always 'b' with seed 12345
- * ```
- */
-export function createSeededRandom(seed) {
-    let state = seed ?? Date.now();
-    function next() {
-        state = (LCG_A * state + LCG_C) % LCG_M;
-        return state;
-    }
-    const random = {
-        get seed() {
-            return state;
-        },
-        float() {
-            return next() / LCG_M;
-        },
-        int(min, max) {
-            return Math.floor(random.float() * (max - min + 1)) + min;
-        },
-        pick(array) {
-            if (array.length === 0) {
-                throw new Error("Cannot pick from empty array");
-            }
-            return array[random.int(0, array.length - 1)];
-        },
-        weightedPick(items, weights) {
-            const tuples = items.map((item) => [weights[item] ?? 1, item]);
-            return weightedPickFromTuples(tuples, random.float());
-        },
-        shuffle(array) {
-            const result = [...array];
-            for (let i = result.length - 1; i > 0; i--) {
-                const j = random.int(0, i);
-                [result[i], result[j]] = [result[j], result[i]];
-            }
-            return result;
-        },
-        array(length, generator) {
-            return Array.from({ length }, generator);
-        },
-        bool(probability = 0.5) {
-            return random.float() < probability;
-        },
-        fork() {
-            // Use current state to seed new generator
-            return createSeededRandom(next());
-        },
-    };
-    return random;
-}
-/**
- * Parse seed from environment or generate random
- */
-export function parseSeed(source = "env") {
-    if (source === "env") {
-        const envSeed = process.env.FUZZ_SEED;
-        if (envSeed) {
-            const parsed = parseInt(envSeed, 10);
-            if (!isNaN(parsed)) {
-                return parsed;
-            }
-            console.warn(`Invalid FUZZ_SEED: "${envSeed}", using random seed`);
-        }
-    }
-    return Date.now();
-}
-/**
- * Parse FUZZ_REPEATS from environment (default: 1)
- *
- * Controls how many times each test.fuzz() test runs with different seeds.
- * Use FUZZ_REPEATS=10000 for CI nightly runs.
- */
-export function parseRepeats() {
-    const env = process.env.FUZZ_REPEATS;
-    if (env) {
-        const parsed = parseInt(env, 10);
-        if (!isNaN(parsed) && parsed > 0) {
-            return parsed;
-        }
-        console.warn(`Invalid FUZZ_REPEATS: "${env}", using 1`);
-    }
-    return 1;
-}
-/**
- * Derive N unique seeds from a base seed using LCG
- */
-export function deriveSeeds(baseSeed, count) {
-    const seeds = [];
-    let state = baseSeed;
-    for (let i = 0; i < count; i++) {
-        state = (LCG_A * state + LCG_C) % LCG_M;
-        seeds.push(state);
-    }
-    return seeds;
-}