@bluefly/openstandardagents 0.4.0 → 0.4.1

package/dist/services/dev-server/dev-server.service.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Development Server Service
+ *
+ * Orchestrates file watching, validation, and WebSocket updates
+ *
+ * Features:
+ * - Hot reload on manifest changes
+ * - Real-time validation
+ * - WebSocket updates to clients
+ * - HTTP server with test UI
+ *
+ * SOLID: Single Responsibility - Dev server orchestration
+ */
+import { type ValidationResult } from './live-validator.js';
+export interface DevServerOptions {
+    /**
+     * File or directory to watch
+     */
+    watch: string;
+    /**
+     * HTTP server port
+     * @default 3000
+     */
+    port?: number;
+    /**
+     * Auto-open browser
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Debounce delay for file changes (ms)
+     * @default 300
+     */
+    debounceMs?: number;
+    /**
+     * Enable verbose logging
+     * @default false
+     */
+    verbose?: boolean;
+}
+export interface DevServerStats {
+    /**
+     * Server start time
+     */
+    startTime: Date;
+    /**
+     * Number of watched files
+     */
+    watchedFiles: number;
+    /**
+     * Number of connected clients
+     */
+    connectedClients: number;
+    /**
+     * Total file changes detected
+     */
+    fileChanges: number;
+    /**
+     * Total validations performed
+     */
+    validations: number;
+    /**
+     * Latest validation result
+     */
+    latestValidation?: ValidationResult;
+}
+/**
+ * Development Server
+ *
+ * Provides hot reload and live validation for OSSA manifests
+ */
+export declare class DevServer {
+    private fileWatcher?;
+    private validator;
+    private wsServer;
+    private httpServer?;
+    private options;
+    private stats;
+    constructor(options: DevServerOptions);
+    /**
+     * Start development server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop development server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current server statistics
+     */
+    getStats(): DevServerStats;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Validate a file
+     */
+    private validateFile;
+    /**
+     * Handle HTTP requests
+     */
+    private handleRequest;
+    /**
+     * Serve test UI HTML
+     */
+    private serveTestUI;
+    /**
+     * Generate inline test UI (fallback)
+     */
+    private generateInlineTestUI;
+    /**
+     * Print server status
+     */
+    private printStatus;
+    /**
+     * Open browser
+     */
+    private openBrowser;
+}
+//# sourceMappingURL=dev-server.service.d.ts.map

package/dist/services/dev-server/dev-server.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.service.d.ts","sourceRoot":"","sources":["../../../src/services/dev-server/dev-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAO3E,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAiB;gBAElB,OAAO,EAAE,gBAAgB;IA4BrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACH,QAAQ,IAAI,cAAc;IAO1B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,YAAY;IAqC1B;;OAEG;YACW,aAAa;IAoB3B;;OAEG;YACW,WAAW;IAezB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0C5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;YACW,WAAW;CAK1B"}

package/dist/services/dev-server/dev-server.service.js

@@ -0,0 +1,290 @@
+/**
+ * Development Server Service
+ *
+ * Orchestrates file watching, validation, and WebSocket updates
+ *
+ * Features:
+ * - Hot reload on manifest changes
+ * - Real-time validation
+ * - WebSocket updates to clients
+ * - HTTP server with test UI
+ *
+ * SOLID: Single Responsibility - Dev server orchestration
+ */
+import { createServer } from 'http';
+import { readFile } from 'fs/promises';
+import path from 'path';
+import { FileWatcher } from './file-watcher.js';
+import { LiveValidator } from './live-validator.js';
+import { DevWebSocketServer } from './websocket-server.js';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Development Server
+ *
+ * Provides hot reload and live validation for OSSA manifests
+ */
+export class DevServer {
+    fileWatcher;
+    validator;
+    wsServer;
+    httpServer;
+    options;
+    stats;
+    constructor(options) {
+        this.options = {
+            port: 3000,
+            open: false,
+            debounceMs: 300,
+            verbose: false,
+            ...options,
+        };
+        this.validator = new LiveValidator({
+            semanticValidation: true,
+            bestPractices: true,
+            caching: true,
+        });
+        this.wsServer = new DevWebSocketServer({
+            path: '/ws',
+        });
+        this.stats = {
+            startTime: new Date(),
+            watchedFiles: 0,
+            connectedClients: 0,
+            fileChanges: 0,
+            validations: 0,
+        };
+    }
+    /**
+     * Start development server
+     */
+    async start() {
+        console.log('🚀 Starting OSSA Development Server...\n');
+        // Create HTTP server
+        this.httpServer = createServer(this.handleRequest.bind(this));
+        // Start WebSocket server (attached to HTTP server)
+        this.wsServer = new DevWebSocketServer({
+            server: this.httpServer,
+            path: '/ws',
+        });
+        await this.wsServer.start();
+        // Start file watcher
+        this.fileWatcher = new FileWatcher({
+            paths: [this.options.watch],
+            debounceMs: this.options.debounceMs,
+        });
+        this.fileWatcher.onChange(this.handleFileChange.bind(this));
+        await this.fileWatcher.start();
+        // Update stats
+        this.stats.watchedFiles = this.fileWatcher.getWatchedFiles().length;
+        // Start HTTP server
+        await new Promise((resolve) => {
+            this.httpServer.listen(this.options.port, () => {
+                resolve();
+            });
+        });
+        // Print status
+        this.printStatus();
+        // Open browser if requested
+        if (this.options.open) {
+            await this.openBrowser();
+        }
+    }
+    /**
+     * Stop development server
+     */
+    async stop() {
+        console.log('\n🛑 Stopping OSSA Development Server...');
+        if (this.fileWatcher) {
+            await this.fileWatcher.stop();
+        }
+        if (this.wsServer) {
+            await this.wsServer.stop();
+        }
+        if (this.httpServer) {
+            await new Promise((resolve, reject) => {
+                this.httpServer.close((error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+        }
+        console.log('✅ Server stopped');
+    }
+    /**
+     * Get current server statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            connectedClients: this.wsServer.getClientCount(),
+        };
+    }
+    /**
+     * Handle file change event
+     */
+    async handleFileChange(event) {
+        this.stats.fileChanges++;
+        if (this.options.verbose) {
+            console.log(`\n📝 File ${event.type}: ${path.basename(event.path)}`);
+        }
+        // Broadcast file change
+        this.wsServer.broadcastFileChange(event);
+        // Validate file
+        if (event.type !== 'unlink') {
+            await this.validateFile(event.path);
+        }
+        // Trigger reload
+        this.wsServer.broadcastReload(event.path, `File ${event.type}`);
+    }
+    /**
+     * Validate a file
+     */
+    async validateFile(filePath) {
+        this.stats.validations++;
+        try {
+            const result = await this.validator.validate(filePath);
+            this.stats.latestValidation = result;
+            // Log validation result
+            if (result.valid) {
+                if (this.options.verbose) {
+                    console.log(`✅ Validation passed (${result.duration}ms)`);
+                }
+            }
+            else {
+                console.log(`\n❌ Validation failed for ${path.basename(filePath)}:`);
+                for (const error of result.errors) {
+                    const location = error.line ? ` (line ${error.line})` : '';
+                    console.log(`   • ${error.message}${location}`);
+                }
+            }
+            if (result.warnings.length > 0 && this.options.verbose) {
+                console.log(`\n⚠️  Warnings:`);
+                for (const warning of result.warnings) {
+                    console.log(`   • ${warning.message}`);
+                }
+            }
+            // Broadcast validation result
+            this.wsServer.broadcastValidation(result);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`Error validating ${filePath}:`, errorMessage);
+            this.wsServer.broadcastError(`Validation error: ${errorMessage}`);
+        }
+    }
+    /**
+     * Handle HTTP requests
+     */
+    async handleRequest(req, res) {
+        const url = req.url || '/';
+        if (url === '/' || url === '/index.html') {
+            // Serve test UI
+            await this.serveTestUI(res);
+        }
+        else if (url === '/stats') {
+            // Serve stats as JSON
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(this.getStats(), null, 2));
+        }
+        else {
+            // 404
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+        }
+    }
+    /**
+     * Serve test UI HTML
+     */
+    async serveTestUI(res) {
+        try {
+            const htmlPath = path.join(__dirname, 'test-ui.html');
+            const html = await readFile(htmlPath, 'utf-8');
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(html);
+        }
+        catch (_error) {
+            // Generate inline HTML if file not found
+            const inlineHtml = this.generateInlineTestUI();
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(inlineHtml);
+        }
+    }
+    /**
+     * Generate inline test UI (fallback)
+     */
+    generateInlineTestUI() {
+        return `<!DOCTYPE html>
+<html>
+<head>
+  <title>OSSA Dev Server</title>
+  <style>
+    body { font-family: system-ui, sans-serif; margin: 0; padding: 20px; background: #1e1e1e; color: #d4d4d4; }
+    h1 { color: #4ec9b0; }
+    pre { background: #2d2d2d; padding: 15px; border-radius: 5px; overflow-x: auto; }
+    .status { padding: 10px; margin: 10px 0; border-radius: 5px; }
+    .success { background: #1e3a1e; border-left: 4px solid #4ec9b0; }
+    .error { background: #3a1e1e; border-left: 4px solid #f48771; }
+    .warning { background: #3a351e; border-left: 4px solid #dcdcaa; }
+  </style>
+</head>
+<body>
+  <h1>🚀 OSSA Development Server</h1>
+  <p>WebSocket connected. Watching for changes...</p>
+  <div id="output"></div>
+  <script>
+    const ws = new WebSocket('ws://' + window.location.host + '/ws');
+    const output = document.getElementById('output');
+
+    ws.onmessage = (event) => {
+      const msg = JSON.parse(event.data);
+      const div = document.createElement('div');
+      div.className = 'status';
+
+      if (msg.type === 'validation') {
+        div.className += msg.data.result.valid ? ' success' : ' error';
+        div.innerHTML = '<pre>' + JSON.stringify(msg.data.result, null, 2) + '</pre>';
+      } else {
+        div.innerHTML = '<pre>' + JSON.stringify(msg, null, 2) + '</pre>';
+      }
+
+      output.insertBefore(div, output.firstChild);
+    };
+  </script>
+</body>
+</html>`;
+    }
+    /**
+     * Print server status
+     */
+    printStatus() {
+        const watchedFiles = this.fileWatcher?.getWatchedFiles() || [];
+        console.log('✅ Server started successfully!\n');
+        console.log(`📡 HTTP Server:  http://localhost:${this.options.port}`);
+        console.log(`🔌 WebSocket:    ws://localhost:${this.options.port}/ws`);
+        console.log(`📂 Watching:     ${this.options.watch}`);
+        console.log(`📄 Files:        ${watchedFiles.length} manifest(s)`);
+        if (this.options.verbose && watchedFiles.length > 0) {
+            console.log('\nWatched files:');
+            for (const file of watchedFiles.slice(0, 5)) {
+                console.log(`   • ${path.basename(file)}`);
+            }
+            if (watchedFiles.length > 5) {
+                console.log(`   ... and ${watchedFiles.length - 5} more`);
+            }
+        }
+        console.log('\n👀 Watching for changes (Ctrl+C to stop)...\n');
+    }
+    /**
+     * Open browser
+     */
+    async openBrowser() {
+        const url = `http://localhost:${this.options.port}`;
+        const { default: open } = await import('open');
+        await open(url);
+    }
+}
+//# sourceMappingURL=dev-server.service.js.map

package/dist/services/dev-server/dev-server.service.js.map

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

package/dist/services/dev-server/file-watcher.d.ts

@@ -0,0 +1,101 @@
+/**
+ * File Watcher Service
+ *
+ * Watches OSSA manifest files for changes and triggers callbacks
+ *
+ * Features:
+ * - Watch specific files or directories
+ * - Debounced change detection
+ * - File type filtering (*.ossa.yaml, *.ossa.yml)
+ * - Graceful error handling
+ *
+ * SOLID: Single Responsibility - File watching only
+ */
+export interface FileWatcherOptions {
+    /**
+     * Paths to watch (files or directories)
+     */
+    paths: string[];
+    /**
+     * Debounce delay in milliseconds
+     * @default 300
+     */
+    debounceMs?: number;
+    /**
+     * File patterns to watch
+     * @default ['**\/*.ossa.{yaml,yml}']
+     */
+    patterns?: string[];
+    /**
+     * Patterns to ignore
+     * @default ['**\/node_modules\/**', '**\/.git\/**']
+     */
+    ignored?: string[];
+}
+export interface FileChangeEvent {
+    /**
+     * Type of change
+     */
+    type: 'add' | 'change' | 'unlink';
+    /**
+     * Absolute path to changed file
+     */
+    path: string;
+    /**
+     * Timestamp of change
+     */
+    timestamp: Date;
+    /**
+     * File stats (if available)
+     */
+    stats?: {
+        size: number;
+        modified: Date;
+    };
+}
+export type FileChangeCallback = (event: FileChangeEvent) => void | Promise<void>;
+/**
+ * File Watcher Service
+ *
+ * Watches OSSA manifest files and triggers callbacks on changes
+ */
+export declare class FileWatcher {
+    private watcher?;
+    private callbacks;
+    private debounceTimers;
+    private options;
+    constructor(options: FileWatcherOptions);
+    /**
+     * Start watching files
+     */
+    start(): Promise<void>;
+    /**
+     * Stop watching files
+     */
+    stop(): Promise<void>;
+    /**
+     * Register callback for file changes
+     */
+    onChange(callback: FileChangeCallback): void;
+    /**
+     * Remove callback
+     */
+    offChange(callback: FileChangeCallback): void;
+    /**
+     * Get list of watched files
+     */
+    getWatchedFiles(): string[];
+    /**
+     * Check if file should be watched based on patterns
+     */
+    private shouldWatch;
+    /**
+     * Handle file change with debouncing
+     */
+    private handleChange;
+    /**
+     * Trigger all registered callbacks
+     */
+    private triggerCallbacks;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/services/dev-server/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/services/dev-server/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAElC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC;KAChB,CAAC;CACH;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,eAAe,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,EAAE,kBAAkB;IAcvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI5C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAO7C;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAoB3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoCpB;;OAEG;YACW,gBAAgB;CAS/B"}