crewly 1.0.0

package/dist/backend/backend/src/controllers/monitoring/file-watcher.controller.js

@@ -0,0 +1,392 @@
+/**
+ * File Watcher Controller
+ *
+ * Handles file watching and git integration endpoints for project monitoring.
+ * Includes path traversal protection to prevent unauthorized filesystem access.
+ *
+ * @module file-watcher-controller
+ */
+import { FileWatcherService, GitIntegrationService, LoggerService, StorageService } from '../../services/index.js';
+import { validateProjectPath } from '../../utils/security.js';
+/**
+ * Controller for file watching and git integration operations.
+ * All methods that accept file paths validate them for path traversal attacks.
+ */
+export class FileWatcherController {
+    fileWatcher;
+    gitIntegration;
+    logger;
+    storage;
+    constructor() {
+        this.fileWatcher = new FileWatcherService();
+        this.gitIntegration = new GitIntegrationService();
+        this.logger = LoggerService.getInstance();
+        this.storage = StorageService.getInstance();
+    }
+    /**
+     * Start watching a project for file changes.
+     *
+     * @param req - Express request with projectId param and projectPath in body
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     *
+     * @example
+     * POST /api/monitoring/watch/:projectId
+     * Body: { projectPath: "/home/user/projects/myapp" }
+     */
+    async startWatching(req, res) {
+        try {
+            const { projectId } = req.params;
+            const { projectPath } = req.body;
+            if (!projectId || !projectPath) {
+                res.status(400).json({ error: 'Project ID and path are required' });
+                return;
+            }
+            // Validate path for traversal attacks
+            const pathValidation = validateProjectPath(projectPath);
+            if (!pathValidation.isValid) {
+                this.logger.warn('Path traversal attempt detected in startWatching', {
+                    projectId,
+                    projectPath,
+                    error: pathValidation.error,
+                });
+                res.status(400).json({
+                    error: 'Invalid project path',
+                    details: pathValidation.error,
+                });
+                return;
+            }
+            await this.fileWatcher.watchProject(projectId, pathValidation.normalizedPath);
+            res.json({
+                success: true,
+                message: `Started watching project ${projectId}`,
+                stats: this.fileWatcher.getStats()
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to start watching project:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to start watching project',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Stop watching a project for file changes.
+     *
+     * @param req - Express request with projectId param
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     */
+    async stopWatching(req, res) {
+        try {
+            const { projectId } = req.params;
+            if (!projectId) {
+                res.status(400).json({ error: 'Project ID is required' });
+                return;
+            }
+            await this.fileWatcher.stopWatchingProject(projectId);
+            res.json({
+                success: true,
+                message: `Stopped watching project ${projectId}`,
+                stats: this.fileWatcher.getStats()
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to stop watching project:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to stop watching project',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Get file watcher statistics.
+     *
+     * @param req - Express request object
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     */
+    async getStats(req, res) {
+        try {
+            const stats = this.fileWatcher.getStats();
+            res.json({
+                success: true,
+                data: stats
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to get watcher stats:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to get watcher stats',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Get list of watched projects.
+     *
+     * @param req - Express request object
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     */
+    async getWatchedProjects(req, res) {
+        try {
+            const watchedProjects = this.fileWatcher.getWatchedProjects();
+            res.json({
+                success: true,
+                data: watchedProjects
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to get watched projects:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to get watched projects',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Start watching all active projects.
+     *
+     * @param req - Express request object
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     */
+    async startWatchingAll(req, res) {
+        try {
+            await this.fileWatcher.watchAllProjects();
+            res.json({
+                success: true,
+                message: 'Started watching all active projects',
+                stats: this.fileWatcher.getStats()
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to start watching all projects:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to start watching all projects',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Get git status for a project.
+     *
+     * @param req - Express request with projectPath in body
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     *
+     * @example
+     * POST /api/monitoring/git/status
+     * Body: { projectPath: "/home/user/projects/myapp" }
+     */
+    async getGitStatus(req, res) {
+        try {
+            const { projectPath } = req.body;
+            if (!projectPath) {
+                res.status(400).json({ error: 'Project path is required' });
+                return;
+            }
+            // Validate path for traversal attacks
+            const pathValidation = validateProjectPath(projectPath);
+            if (!pathValidation.isValid) {
+                this.logger.warn('Path traversal attempt detected in getGitStatus', {
+                    projectPath,
+                    error: pathValidation.error,
+                });
+                res.status(400).json({
+                    error: 'Invalid project path',
+                    details: pathValidation.error,
+                });
+                return;
+            }
+            const gitStatus = await this.gitIntegration.getGitStatus(pathValidation.normalizedPath);
+            res.json({
+                success: true,
+                data: gitStatus
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to get git status:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to get git status',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Commit changes for a project.
+     *
+     * @param req - Express request with projectPath, message, autoGenerate, and author in body
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     *
+     * @example
+     * POST /api/monitoring/git/commit
+     * Body: { projectPath: "/home/user/projects/myapp", message: "feat: add feature" }
+     */
+    async commitChanges(req, res) {
+        try {
+            const { projectPath, message, autoGenerate, author } = req.body;
+            if (!projectPath) {
+                res.status(400).json({ error: 'Project path is required' });
+                return;
+            }
+            // Validate path for traversal attacks
+            const pathValidation = validateProjectPath(projectPath);
+            if (!pathValidation.isValid) {
+                this.logger.warn('Path traversal attempt detected in commitChanges', {
+                    projectPath,
+                    error: pathValidation.error,
+                });
+                res.status(400).json({
+                    error: 'Invalid project path',
+                    details: pathValidation.error,
+                });
+                return;
+            }
+            const commitResult = await this.gitIntegration.commitChanges(pathValidation.normalizedPath, {
+                message,
+                autoGenerate,
+                author
+            });
+            res.json({
+                success: true,
+                message: commitResult === 'no-changes' ? 'No changes to commit' : 'Changes committed successfully',
+                data: { commitResult }
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to commit changes:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to commit changes',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Start scheduled commits for a project.
+     *
+     * @param req - Express request with projectPath and scheduling options in body
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     *
+     * @example
+     * POST /api/monitoring/git/schedule/start
+     * Body: { projectPath: "/home/user/projects/myapp", intervalMinutes: 30 }
+     */
+    async startScheduledCommits(req, res) {
+        try {
+            const { projectPath, intervalMinutes, enabled, autoMessage, branchStrategy } = req.body;
+            if (!projectPath) {
+                res.status(400).json({ error: 'Project path is required' });
+                return;
+            }
+            // Validate path for traversal attacks
+            const pathValidation = validateProjectPath(projectPath);
+            if (!pathValidation.isValid) {
+                this.logger.warn('Path traversal attempt detected in startScheduledCommits', {
+                    projectPath,
+                    error: pathValidation.error,
+                });
+                res.status(400).json({
+                    error: 'Invalid project path',
+                    details: pathValidation.error,
+                });
+                return;
+            }
+            await this.gitIntegration.startScheduledCommits(pathValidation.normalizedPath, {
+                enabled: enabled !== undefined ? enabled : true,
+                intervalMinutes: intervalMinutes || 30,
+                autoMessage: autoMessage !== undefined ? autoMessage : true,
+                branchStrategy: branchStrategy || 'feature'
+            });
+            res.json({
+                success: true,
+                message: `Started scheduled commits for project`,
+                data: {
+                    projectPath: pathValidation.normalizedPath,
+                    intervalMinutes: intervalMinutes || 30
+                }
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to start scheduled commits:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to start scheduled commits',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Stop scheduled commits for a project.
+     *
+     * @param req - Express request with projectPath in body
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     *
+     * @example
+     * POST /api/monitoring/git/schedule/stop
+     * Body: { projectPath: "/home/user/projects/myapp" }
+     */
+    async stopScheduledCommits(req, res) {
+        try {
+            const { projectPath } = req.body;
+            if (!projectPath) {
+                res.status(400).json({ error: 'Project path is required' });
+                return;
+            }
+            // Validate path for traversal attacks
+            const pathValidation = validateProjectPath(projectPath);
+            if (!pathValidation.isValid) {
+                this.logger.warn('Path traversal attempt detected in stopScheduledCommits', {
+                    projectPath,
+                    error: pathValidation.error,
+                });
+                res.status(400).json({
+                    error: 'Invalid project path',
+                    details: pathValidation.error,
+                });
+                return;
+            }
+            this.gitIntegration.stopScheduledCommits(pathValidation.normalizedPath);
+            res.json({
+                success: true,
+                message: `Stopped scheduled commits for project`,
+                data: { projectPath: pathValidation.normalizedPath }
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to stop scheduled commits:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to stop scheduled commits',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+    /**
+     * Get projects with scheduled commits.
+     *
+     * @param req - Express request object
+     * @param res - Express response object
+     * @returns Promise that resolves when response is sent
+     */
+    async getScheduledProjects(req, res) {
+        try {
+            const scheduledProjects = this.gitIntegration.getScheduledProjects();
+            res.json({
+                success: true,
+                data: scheduledProjects
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to get scheduled projects:', { error: error instanceof Error ? error.message : String(error) });
+            res.status(500).json({
+                error: 'Failed to get scheduled projects',
+                details: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    }
+}
+//# sourceMappingURL=file-watcher.controller.js.map

package/dist/backend/backend/src/controllers/monitoring/file-watcher.controller.js.map

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

package/dist/backend/backend/src/controllers/monitoring/monitoring.routes.d.ts

@@ -0,0 +1,9 @@
+import { Router } from 'express';
+import type { ApiContext } from '../types.js';
+/**
+ * Creates monitoring router with all monitoring-related endpoints
+ * @param context - API context with services
+ * @returns Express router configured with monitoring routes
+ */
+export declare function createMonitoringRouter(context: ApiContext): Router;
+//# sourceMappingURL=monitoring.routes.d.ts.map

package/dist/backend/backend/src/controllers/monitoring/monitoring.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/monitoring/monitoring.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CASlE"}

package/dist/backend/backend/src/controllers/monitoring/monitoring.routes.js

@@ -0,0 +1,15 @@
+import { Router } from 'express';
+/**
+ * Creates monitoring router with all monitoring-related endpoints
+ * @param context - API context with services
+ * @returns Express router configured with monitoring routes
+ */
+export function createMonitoringRouter(context) {
+    const router = Router();
+    // File watcher endpoints (if needed, can be added later)
+    // router.get('/file-changes', getFileChanges.bind(context));
+    // router.post('/watch-file', startWatchingFile.bind(context));
+    // router.delete('/watch-file', stopWatchingFile.bind(context));
+    return router;
+}
+//# sourceMappingURL=monitoring.routes.js.map

package/dist/backend/backend/src/controllers/monitoring/monitoring.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/monitoring/monitoring.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACxD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,yDAAyD;IACzD,6DAA6D;IAC7D,+DAA+D;IAC/D,gEAAgE;IAEhE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/backend/backend/src/controllers/monitoring/terminal.controller.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Terminal Controller
+ *
+ * Handles terminal session management endpoints for the API.
+ * Uses ISessionBackend for PTY-based session operations.
+ *
+ * @module terminal-controller
+ */
+import { Request, Response } from 'express';
+import type { ApiContext } from '../types.js';
+/**
+ * List all active terminal sessions.
+ *
+ * @param req - Express request object
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * GET /api/terminal/sessions
+ * Response: { success: true, data: { sessions: ["session1", "session2"] } }
+ */
+export declare function listTerminalSessions(req: Request, res: Response): Promise<void>;
+/**
+ * Check if a terminal session exists.
+ *
+ * @param req - Express request object with sessionName param
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * GET /api/terminal/my-session/exists
+ * Response: { success: true, data: { exists: true, sessionName: "my-session" } }
+ */
+export declare function sessionExists(req: Request, res: Response): Promise<void>;
+/**
+ * Capture terminal output from a session.
+ *
+ * @param req - Express request object with sessionName param and lines query
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * GET /api/terminal/my-session/output?lines=50
+ * Response: { success: true, data: { output: "...", sessionName: "my-session", lines: 50, truncated: false } }
+ */
+export declare function captureTerminal(req: Request, res: Response): Promise<void>;
+/**
+ * Write data to a terminal session.
+ *
+ * @param req - Express request object with sessionName param and data in body
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * POST /api/terminal/my-session/write
+ * Body: { data: "hello\r" }
+ * Response: { success: true, message: "Data written successfully" }
+ */
+export declare function writeToSession(req: Request, res: Response): Promise<void>;
+/**
+ * Send terminal input to a session (legacy endpoint).
+ *
+ * @param req - Express request object with sessionName param and input in body
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * POST /api/terminal/my-session/input
+ * Body: { input: "echo hello" }
+ * Response: { success: true, message: "Input sent successfully" }
+ */
+export declare function sendTerminalInput(req: Request, res: Response): Promise<void>;
+/**
+ * Send a special key to a terminal session.
+ *
+ * @param req - Express request object with sessionName param and key in body
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * POST /api/terminal/my-session/key
+ * Body: { key: "Enter" }
+ * Response: { success: true, message: "Key sent successfully" }
+ */
+export declare function sendTerminalKey(req: Request, res: Response): Promise<void>;
+/**
+ * Kill a terminal session.
+ *
+ * @param req - Express request object with sessionName param
+ * @param res - Express response object
+ * @returns Promise that resolves when response is sent
+ *
+ * @example
+ * DELETE /api/terminal/my-session
+ * Response: { success: true, message: "Session killed successfully" }
+ */
+export declare function killSession(req: Request, res: Response): Promise<void>;
+/**
+ * Deliver a message to an agent session with reliable retry and verification.
+ *
+ * Uses AgentRegistrationService.sendMessageToAgent() — the same battle-tested
+ * delivery path that chat-to-orchestrator uses (prompt check + 3-attempt retry
+ * + stuck detection). This replaces the fire-and-forget `/write` endpoint for
+ * sub-agent message delivery from skill scripts.
+ *
+ * Must be called with `.call(apiController, req, res)` so `this` is an ApiContext.
+ *
+ * @param req - Express request with sessionName param and message in body
+ * @param res - Express response object
+ *
+ * @example
+ * POST /api/terminal/my-agent/deliver
+ * Body: { message: "Hello agent", waitForReady: true }
+ * Response: { success: true, verified: true }
+ */
+export declare function deliverMessage(this: ApiContext, req: Request, res: Response): Promise<void>;
+//# sourceMappingURL=terminal.controller.d.ts.map

package/dist/backend/backend/src/controllers/monitoring/terminal.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/monitoring/terminal.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAa5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA0J/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD5E;AAiCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+FjG"}