vralphy 0.8.0

package/dist/lib/events/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * NDJSON Event Types for vralphy
+ *
+ * These events can be consumed via: tail -f .vralphy/events.ndjson | jq .
+ */
+import { EngineName } from '../engines/index.js';
+/**
+ * Common fields for all events
+ */
+export interface BaseEvent {
+    timestamp: string;
+    sessionId: string;
+    engine: EngineName;
+}
+/**
+ * Iteration lifecycle start event
+ */
+export interface IterationStartEvent extends BaseEvent {
+    type: 'iteration_start';
+    iteration: number;
+    command: 'build' | 'plan' | 'spec';
+}
+/**
+ * Iteration lifecycle end event
+ */
+export interface IterationEndEvent extends BaseEvent {
+    type: 'iteration_end';
+    iteration: number;
+    durationMs: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Tool usage event (Claude only - has structured data)
+ */
+export interface ToolEvent extends BaseEvent {
+    type: 'tool';
+    tool: string;
+    params: Record<string, unknown>;
+}
+/**
+ * File operation event (derived from tool events)
+ */
+export interface FileEvent extends BaseEvent {
+    type: 'file';
+    operation: 'read' | 'write' | 'edit' | 'delete';
+    path: string;
+}
+/**
+ * State change event (e.g., IMPLEMENTATION_PLAN.md updates)
+ */
+export interface StateChangeEvent extends BaseEvent {
+    type: 'state_change';
+    kind: 'task_status' | 'plan_update' | 'spec_update';
+    file: string;
+    description?: string;
+}
+/**
+ * Error event
+ */
+export interface ErrorEvent extends BaseEvent {
+    type: 'error';
+    message: string;
+    code?: string;
+    iteration?: number;
+}
+/**
+ * Session start event
+ */
+export interface SessionStartEvent extends BaseEvent {
+    type: 'session_start';
+    command: 'build' | 'plan' | 'spec';
+    planningModel: string;
+    executorModel: string;
+}
+/**
+ * Session end event
+ */
+export interface SessionEndEvent extends BaseEvent {
+    type: 'session_end';
+    totalIterations: number;
+    totalDurationMs: number;
+    success: boolean;
+}
+/**
+ * Union type of all events
+ */
+export type VralphyEvent = IterationStartEvent | IterationEndEvent | ToolEvent | FileEvent | StateChangeEvent | ErrorEvent | SessionStartEvent | SessionEndEvent;
+/**
+ * Event types for filtering
+ */
+export type EventType = VralphyEvent['type'];
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/events/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,aAAa,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,UAAU,GACV,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/events/types.js

@@ -0,0 +1,7 @@
+/**
+ * NDJSON Event Types for vralphy
+ *
+ * These events can be consumed via: tail -f .vralphy/events.ndjson | jq .
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/events/types.js.map

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

package/dist/lib/events/writer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * EventWriter - Non-blocking NDJSON event writer
+ *
+ * Appends events to .vralphy/events.ndjson for external consumption.
+ * Writes are fire-and-forget to never block or fail the main execution.
+ */
+import { EngineName } from '../engines/index.js';
+export declare class EventWriter {
+    private readonly engine;
+    private readonly sessionId;
+    private readonly eventsPath;
+    private readonly enabled;
+    private initialized;
+    constructor(engine: EngineName, enabled?: boolean);
+    /**
+     * Get the session ID for this writer
+     */
+    getSessionId(): string;
+    /**
+     * Ensure the events directory exists
+     */
+    private ensureDir;
+    /**
+     * Write an event to the NDJSON file (fire-and-forget)
+     */
+    private write;
+    /**
+     * Record session start
+     */
+    sessionStart(command: 'build' | 'plan' | 'spec', planningModel: string, executorModel: string): Promise<void>;
+    /**
+     * Record session end
+     */
+    sessionEnd(totalIterations: number, totalDurationMs: number, success: boolean): Promise<void>;
+    /**
+     * Record iteration start
+     */
+    iterationStart(iteration: number, command: 'build' | 'plan' | 'spec'): Promise<void>;
+    /**
+     * Record iteration end
+     */
+    iterationEnd(iteration: number, durationMs: number, success: boolean, error?: string): Promise<void>;
+    /**
+     * Record tool usage
+     */
+    tool(tool: string, params: Record<string, unknown>): Promise<void>;
+    /**
+     * Record file operation
+     */
+    file(operation: 'read' | 'write' | 'edit' | 'delete', path: string): Promise<void>;
+    /**
+     * Record state change
+     */
+    stateChange(kind: 'task_status' | 'plan_update' | 'spec_update', file: string, description?: string): Promise<void>;
+    /**
+     * Record error
+     */
+    error(message: string, code?: string, iteration?: number): Promise<void>;
+    /**
+     * Detect file operation from tool name
+     */
+    static getFileOperation(toolName: string): 'read' | 'write' | 'edit' | 'delete' | null;
+    /**
+     * Check if a file path indicates an IMPLEMENTATION_PLAN.md change
+     */
+    static isImplementationPlan(filePath: string | unknown): boolean;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/lib/events/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/lib/events/writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAgBjD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,OAAc;IAOvD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;YACW,SAAS;IAavB;;OAEG;YACW,KAAK;IAoBnB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAClC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASnG;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1F;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxF;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,aAAa,EACnD,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI;IAatF;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;CAIjE"}

package/dist/lib/events/writer.js

@@ -0,0 +1,178 @@
+/**
+ * EventWriter - Non-blocking NDJSON event writer
+ *
+ * Appends events to .vralphy/events.ndjson for external consumption.
+ * Writes are fire-and-forget to never block or fail the main execution.
+ */
+import { appendFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+const EVENTS_DIR = '.vralphy';
+const EVENTS_FILE = 'events.ndjson';
+export class EventWriter {
+    engine;
+    sessionId;
+    eventsPath;
+    enabled;
+    initialized = false;
+    constructor(engine, enabled = true) {
+        this.engine = engine;
+        this.sessionId = randomUUID();
+        this.eventsPath = join(EVENTS_DIR, EVENTS_FILE);
+        this.enabled = enabled;
+    }
+    /**
+     * Get the session ID for this writer
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Ensure the events directory exists
+     */
+    async ensureDir() {
+        if (this.initialized)
+            return;
+        try {
+            if (!existsSync(EVENTS_DIR)) {
+                await mkdir(EVENTS_DIR, { recursive: true });
+            }
+            this.initialized = true;
+        }
+        catch {
+            // Silently fail - non-blocking
+        }
+    }
+    /**
+     * Write an event to the NDJSON file (fire-and-forget)
+     */
+    async write(event) {
+        if (!this.enabled)
+            return;
+        try {
+            await this.ensureDir();
+            const fullEvent = {
+                ...event,
+                timestamp: new Date().toISOString(),
+                sessionId: this.sessionId,
+                engine: this.engine,
+            };
+            const line = JSON.stringify(fullEvent) + '\n';
+            await appendFile(this.eventsPath, line);
+        }
+        catch {
+            // Silently fail - non-blocking, never interrupts execution
+        }
+    }
+    /**
+     * Record session start
+     */
+    async sessionStart(command, planningModel, executorModel) {
+        await this.write({
+            type: 'session_start',
+            command,
+            planningModel,
+            executorModel,
+        });
+    }
+    /**
+     * Record session end
+     */
+    async sessionEnd(totalIterations, totalDurationMs, success) {
+        await this.write({
+            type: 'session_end',
+            totalIterations,
+            totalDurationMs,
+            success,
+        });
+    }
+    /**
+     * Record iteration start
+     */
+    async iterationStart(iteration, command) {
+        await this.write({
+            type: 'iteration_start',
+            iteration,
+            command,
+        });
+    }
+    /**
+     * Record iteration end
+     */
+    async iterationEnd(iteration, durationMs, success, error) {
+        await this.write({
+            type: 'iteration_end',
+            iteration,
+            durationMs,
+            success,
+            ...(error && { error }),
+        });
+    }
+    /**
+     * Record tool usage
+     */
+    async tool(tool, params) {
+        await this.write({
+            type: 'tool',
+            tool,
+            params,
+        });
+    }
+    /**
+     * Record file operation
+     */
+    async file(operation, path) {
+        await this.write({
+            type: 'file',
+            operation,
+            path,
+        });
+    }
+    /**
+     * Record state change
+     */
+    async stateChange(kind, file, description) {
+        await this.write({
+            type: 'state_change',
+            kind,
+            file,
+            ...(description && { description }),
+        });
+    }
+    /**
+     * Record error
+     */
+    async error(message, code, iteration) {
+        await this.write({
+            type: 'error',
+            message,
+            ...(code && { code }),
+            ...(iteration !== undefined && { iteration }),
+        });
+    }
+    /**
+     * Detect file operation from tool name
+     */
+    static getFileOperation(toolName) {
+        switch (toolName) {
+            case 'Read':
+                return 'read';
+            case 'Write':
+                return 'write';
+            case 'Edit':
+                return 'edit';
+            default:
+                return null;
+        }
+    }
+    /**
+     * Check if a file path indicates an IMPLEMENTATION_PLAN.md change
+     */
+    static isImplementationPlan(filePath) {
+        if (typeof filePath !== 'string')
+            return false;
+        return filePath.includes('IMPLEMENTATION_PLAN.md');
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/lib/events/writer.js.map

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

package/dist/lib/events.d.ts

@@ -0,0 +1,33 @@
+export type EventType = 'session.start' | 'session.end' | 'iteration.start' | 'iteration.end' | 'iteration.error' | 'plan.completed';
+export interface VralphyEvent {
+    type: EventType;
+    timestamp: string;
+    sessionId: string;
+    project: string;
+    [key: string]: unknown;
+}
+interface EventLoggerConfig {
+    maxFileSizeBytes: number;
+    maxRotatedFiles: number;
+}
+export declare function generateSessionId(): string;
+export declare class EventLogger {
+    private logPath;
+    private sessionId;
+    private project;
+    private config;
+    private initialized;
+    constructor(options: {
+        logDir?: string;
+        sessionId: string;
+        project: string;
+        config?: Partial<EventLoggerConfig>;
+    });
+    log(event: Omit<VralphyEvent, 'timestamp' | 'sessionId' | 'project'>): void;
+    private ensureInitialized;
+    private maybeRotate;
+}
+export declare function initEventLogger(sessionId: string, project: string): void;
+export declare function logEvent(event: Omit<VralphyEvent, 'timestamp' | 'sessionId' | 'project'>): void;
+export {};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAOD,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;KACrC;IAOD,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG,IAAI;IAkB3E,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,WAAW;CAoBpB;AAKD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG,IAAI,CAE/F"}

package/dist/lib/events.js

@@ -0,0 +1,81 @@
+import { appendFileSync, existsSync, mkdirSync, statSync, renameSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+const DEFAULT_CONFIG = {
+    maxFileSizeBytes: 5 * 1024 * 1024, // 5MB
+    maxRotatedFiles: 1,
+};
+export function generateSessionId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${timestamp}-${random}`;
+}
+export class EventLogger {
+    logPath;
+    sessionId;
+    project;
+    config;
+    initialized = false;
+    constructor(options) {
+        this.logPath = join(options.logDir ?? '.vralphy/logs', 'events.jsonl');
+        this.sessionId = options.sessionId;
+        this.project = options.project;
+        this.config = { ...DEFAULT_CONFIG, ...options.config };
+    }
+    log(event) {
+        try {
+            this.ensureInitialized();
+            this.maybeRotate();
+            const fullEvent = {
+                timestamp: new Date().toISOString(),
+                sessionId: this.sessionId,
+                project: this.project,
+                ...event,
+            };
+            appendFileSync(this.logPath, JSON.stringify(fullEvent) + '\n');
+        }
+        catch {
+            // Silent failure - logging should never break the CLI
+        }
+    }
+    ensureInitialized() {
+        if (this.initialized)
+            return;
+        const dir = dirname(this.logPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.initialized = true;
+    }
+    maybeRotate() {
+        try {
+            if (!existsSync(this.logPath))
+                return;
+            const stats = statSync(this.logPath);
+            if (stats.size < this.config.maxFileSizeBytes)
+                return;
+            // Delete oldest, shift others
+            for (let i = this.config.maxRotatedFiles; i >= 1; i--) {
+                const path = `${this.logPath}.${i}`;
+                if (i === this.config.maxRotatedFiles && existsSync(path)) {
+                    unlinkSync(path);
+                }
+                else if (existsSync(path)) {
+                    renameSync(path, `${this.logPath}.${i + 1}`);
+                }
+            }
+            renameSync(this.logPath, `${this.logPath}.1`);
+        }
+        catch {
+            // Ignore rotation errors
+        }
+    }
+}
+// Global logger instance
+let logger = null;
+export function initEventLogger(sessionId, project) {
+    logger = new EventLogger({ sessionId, project });
+}
+export function logEvent(event) {
+    logger?.log(event);
+}
+//# sourceMappingURL=events.js.map

package/dist/lib/events.js.map

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

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

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

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

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

package/dist/lib/events.test.js

@@ -0,0 +1,123 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync, readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { generateSessionId, EventLogger } from './events.js';
+const TEST_DIR = '.vralphy-test-events';
+const LOG_PATH = join(TEST_DIR, 'events.jsonl');
+describe('generateSessionId', () => {
+    it('returns unique IDs', () => {
+        const ids = new Set();
+        for (let i = 0; i < 100; i++) {
+            ids.add(generateSessionId());
+        }
+        expect(ids.size).toBe(100);
+    });
+    it('returns string with timestamp and random parts', () => {
+        const id = generateSessionId();
+        expect(id).toMatch(/^[a-z0-9]+-[a-z0-9]+$/);
+    });
+});
+describe('EventLogger', () => {
+    beforeEach(() => {
+        rmSync(TEST_DIR, { recursive: true, force: true });
+    });
+    afterEach(() => {
+        rmSync(TEST_DIR, { recursive: true, force: true });
+    });
+    it('creates directory and file on first log', () => {
+        const logger = new EventLogger({
+            logDir: TEST_DIR,
+            sessionId: 'test-session',
+            project: 'test-project',
+        });
+        logger.log({ type: 'session.start' });
+        expect(existsSync(LOG_PATH)).toBe(true);
+    });
+    it('logs valid JSON lines', () => {
+        const logger = new EventLogger({
+            logDir: TEST_DIR,
+            sessionId: 'test-session',
+            project: 'test-project',
+        });
+        logger.log({ type: 'session.start', command: 'build' });
+        logger.log({ type: 'iteration.end', iteration: 1 });
+        const content = readFileSync(LOG_PATH, 'utf-8');
+        const lines = content.trim().split('\n');
+        expect(lines.length).toBe(2);
+        const event1 = JSON.parse(lines[0]);
+        expect(event1.type).toBe('session.start');
+        expect(event1.sessionId).toBe('test-session');
+        expect(event1.project).toBe('test-project');
+        expect(event1.command).toBe('build');
+        expect(event1.timestamp).toBeDefined();
+        const event2 = JSON.parse(lines[1]);
+        expect(event2.type).toBe('iteration.end');
+        expect(event2.iteration).toBe(1);
+    });
+    it('includes all event properties', () => {
+        const logger = new EventLogger({
+            logDir: TEST_DIR,
+            sessionId: 'sess-123',
+            project: 'my-project',
+        });
+        logger.log({
+            type: 'session.start',
+            engine: 'claude',
+            maxIterations: 5,
+            nested: { key: 'value' },
+        });
+        const content = readFileSync(LOG_PATH, 'utf-8');
+        const event = JSON.parse(content.trim());
+        expect(event.type).toBe('session.start');
+        expect(event.sessionId).toBe('sess-123');
+        expect(event.project).toBe('my-project');
+        expect(event.engine).toBe('claude');
+        expect(event.maxIterations).toBe(5);
+        expect(event.nested).toEqual({ key: 'value' });
+    });
+    it('rotates at threshold', () => {
+        mkdirSync(TEST_DIR, { recursive: true });
+        // Create a file slightly under the threshold
+        const threshold = 1024; // 1KB for testing
+        const content = 'x'.repeat(threshold);
+        writeFileSync(LOG_PATH, content);
+        const logger = new EventLogger({
+            logDir: TEST_DIR,
+            sessionId: 'test',
+            project: 'test',
+            config: { maxFileSizeBytes: threshold, maxRotatedFiles: 1 },
+        });
+        logger.log({ type: 'session.start' });
+        expect(existsSync(`${LOG_PATH}.1`)).toBe(true);
+        expect(readFileSync(`${LOG_PATH}.1`, 'utf-8')).toBe(content);
+        const newContent = readFileSync(LOG_PATH, 'utf-8');
+        expect(newContent).toContain('session.start');
+    });
+    it('deletes oldest rotation when max reached', () => {
+        mkdirSync(TEST_DIR, { recursive: true });
+        const threshold = 100;
+        // Pre-create rotation files
+        writeFileSync(LOG_PATH, 'x'.repeat(threshold + 1));
+        writeFileSync(`${LOG_PATH}.1`, 'old-backup');
+        const logger = new EventLogger({
+            logDir: TEST_DIR,
+            sessionId: 'test',
+            project: 'test',
+            config: { maxFileSizeBytes: threshold, maxRotatedFiles: 1 },
+        });
+        logger.log({ type: 'session.start' });
+        // Old .1 should be gone, current should become .1
+        expect(readFileSync(`${LOG_PATH}.1`, 'utf-8')).toBe('x'.repeat(threshold + 1));
+        expect(existsSync(`${LOG_PATH}.2`)).toBe(false);
+    });
+    it('silently handles errors', () => {
+        const logger = new EventLogger({
+            logDir: '/nonexistent/path/that/should/fail',
+            sessionId: 'test',
+            project: 'test',
+        });
+        // Should not throw
+        expect(() => logger.log({ type: 'session.start' })).not.toThrow();
+    });
+});
+//# sourceMappingURL=events.test.js.map

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

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

package/dist/lib/file-injection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Utilities for marker-based content injection and removal in files
+ */
+export interface InjectionMarkers {
+    start: string;
+    end: string;
+}
+export interface InjectionResult {
+    success: boolean;
+    action: 'injected' | 'replaced' | 'removed' | 'skipped' | 'error';
+    message?: string;
+}
+/**
+ * Check if content already has injection markers
+ */
+export declare function hasMarkers(content: string, markers: InjectionMarkers): boolean;
+/**
+ * Check if content has incomplete markers (only start or end)
+ */
+export declare function hasIncompleteMarkers(content: string, markers: InjectionMarkers): boolean;
+/**
+ * Inject content into a file between markers
+ * If markers exist, replaces content between them
+ * If markers don't exist, appends to end of file
+ */
+export declare function injectContent(filePath: string, content: string, markers: InjectionMarkers): Promise<InjectionResult>;
+/**
+ * Remove injected content from a file
+ * Removes everything between and including the markers
+ */
+export declare function removeInjectedContent(filePath: string, markers: InjectionMarkers): Promise<InjectionResult>;
+//# sourceMappingURL=file-injection.d.ts.map